Home | History | Annotate | Line # | Download | only in gen
fmtmsg.c revision 1.2.10.1
      1 /*	$NetBSD: fmtmsg.c,v 1.2.10.1 2002/11/11 22:22:08 nathanw Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 1999 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Klaus Klein.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  * 3. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *        This product includes software developed by the NetBSD
     21  *        Foundation, Inc. and its contributors.
     22  * 4. Neither the name of The NetBSD Foundation nor the names of its
     23  *    contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     36  * POSSIBILITY OF SUCH DAMAGE.
     37  */
     38 
     39 #include <sys/cdefs.h>
     40 #if defined(LIBC_SCCS) && !defined(lint)
     41 __RCSID("$NetBSD: fmtmsg.c,v 1.2.10.1 2002/11/11 22:22:08 nathanw Exp $");
     42 #endif /* LIBC_SCCS and not lint */
     43 
     44 #include <fmtmsg.h>
     45 #include <paths.h>
     46 #include <stdio.h>
     47 #include <stdlib.h>
     48 #include <string.h>
     49 
     50 static unsigned int	msgverb __P((const char *));
     51 static const char *	severity2str __P((int));
     52 static int		writeit __P((FILE *, unsigned int, const char *,
     53 			    const char *, const char *, const char *,
     54 			    const char *));
     55 
     56 #define MM_VERBLABEL		0x01U
     57 #define MM_VERBSEVERITY		0x02U
     58 #define MM_VERBTEXT		0x04U
     59 #define MM_VERBACTION		0x08U
     60 #define MM_VERBTAG		0x10U
     61 #define MM_VERBALL	\
     62     (MM_VERBLABEL | MM_VERBSEVERITY | MM_VERBTEXT | MM_VERBACTION | \
     63      MM_VERBTAG)
     64 
     65 static const struct keyword {
     66 	size_t			len;	/* strlen(keyword) */
     67 	const char * const	keyword;
     68 } keywords[] = {
     69 	{ 5,	"label"		},	/* log2(MM_VERBLABEL) */
     70 	{ 8,	"severity"	},	/* ... */
     71 	{ 4,	"text"		},
     72 	{ 6,	"action"	},
     73 	{ 3,	"tag"		}	/* log2(MM_VERBTAG) */
     74 };
     75 
     76 static const size_t nkeywords = sizeof (keywords) / sizeof (keywords[0]);
     77 
     78 /*
     79  * Convert a colon-separated list of known keywords to a set of MM_VERB*
     80  * flags, defaulting to `all' if not set, empty, or in presence of unknown
     81  * keywords.
     82  */
     83 static unsigned int
     84 msgverb(str)
     85 	const char *str;
     86 {
     87 	u_int i;
     88 	unsigned int result;
     89 
     90 	if (str == NULL)
     91 		return (MM_VERBALL);
     92 
     93 	result = 0;
     94 	while (*str != '\0') {
     95 		for (i = 0; i < nkeywords; i++) {
     96 			if (memcmp(str, keywords[i].keyword, keywords[i].len)
     97 			    == 0 &&
     98 			    (*(str + keywords[i].len) == ':' ||
     99 			     *(str + keywords[i].len) == '\0'))
    100 				break;
    101 		}
    102 		if (i == nkeywords) {
    103 			result = MM_VERBALL;
    104 			break;
    105 		}
    106 
    107 		result |= (1 << i);
    108 		if (*(str += keywords[i].len) == ':')
    109 			str++;	/* Advance */
    110 	}
    111 	if (result == 0)
    112 		result = MM_VERBALL;
    113 
    114 	return (result);
    115 }
    116 
    117 static const char * const severities[] = {
    118 	"",		/* MM_NONE */
    119 	"HALT",
    120 	"ERROR",
    121 	"WARNING",
    122 	"INFO"
    123 };
    124 
    125 static const size_t nseverities = sizeof (severities) / sizeof (severities[0]);
    126 
    127 /*
    128  * Returns the string representation associated with the numerical severity
    129  * value, defaulting to NULL for an unknown value.
    130  */
    131 static const char *
    132 severity2str(severity)
    133 	int severity;
    134 {
    135 	const char *result;
    136 
    137 	if (severity >= 0 &&
    138 	    (u_int) severity < nseverities)
    139 		result = severities[severity];
    140 	else
    141 		result = NULL;
    142 
    143 	return (result);
    144 }
    145 
    146 /*
    147  * Format and write the message to the given stream, selecting those
    148  * components displayed from msgverb, returning the number of characters
    149  * written, or a negative value in case of an error.
    150  */
    151 static int
    152 writeit(stream, which, label, sevstr, text, action, tag)
    153 	FILE *stream;
    154 	unsigned int which;
    155 	const char *label;
    156 	const char *sevstr;
    157 	const char *text;
    158 	const char *action;
    159 	const char *tag;
    160 {
    161 	int nwritten;
    162 
    163 	nwritten = fprintf(stream, "%s%s%s%s%s%s%s%s%s%s%s",
    164 	    ((which & MM_VERBLABEL) && label != MM_NULLLBL) ?
    165 	    label : "",
    166 	    ((which & MM_VERBLABEL) && label != MM_NULLLBL) ?
    167 	    ": " : "",
    168 	    (which & MM_VERBSEVERITY) ?
    169 	    sevstr : "",
    170 	    (which & MM_VERBSEVERITY) ?
    171 	    ": " : "",
    172 	    ((which & MM_VERBTEXT) && text != MM_NULLTXT) ?
    173 	    text : "",
    174 	    ((which & MM_VERBLABEL) && label != MM_NULLLBL) ||
    175 	    ((which & MM_VERBSEVERITY)) ||
    176 	    ((which & MM_VERBTEXT) && text != MM_NULLTXT) ?
    177 	    "\n" : "",
    178 	    ((which & MM_VERBACTION) && action != MM_NULLACT) ?
    179 	    "TO FIX: " : "",
    180 	    ((which & MM_VERBACTION) && action != MM_NULLACT) ?
    181 	    action : "",
    182 	    ((which & MM_VERBACTION) && label != MM_NULLACT) ?
    183 	    " " : "",
    184 	    ((which & MM_VERBTAG) && tag != MM_NULLTAG) ?
    185 	    tag : "",
    186 	    ((which & MM_VERBACTION) && action != MM_NULLACT) ||
    187 	    ((which & MM_VERBTAG) && tag != MM_NULLTAG) ?
    188 	    "\n" : "");
    189 
    190 	return (nwritten);
    191 }
    192 
    193 int
    194 fmtmsg(classification, label, severity, text, action, tag)
    195 	long classification;
    196 	const char *label;
    197 	int severity;
    198 	const char *text;
    199 	const char *action;
    200 	const char *tag;
    201 {
    202 	FILE *console;
    203 	const char *p, *sevstr;
    204 	int result;
    205 
    206 	/* Validate label constraints, if not null. */
    207 	if (label != MM_NULLLBL) {
    208 		/*
    209 		 * Two fields, separated by a colon.  The first field is up to
    210 		 * 10 bytes, the second is up to 14 bytes.
    211 		 */
    212 		p = strchr(label, ':');
    213 		if (p ==  NULL || p - label > 10 || strlen(p + 1) > 14)
    214 			return (MM_NOTOK);
    215 	}
    216 	/* Validate severity argument. */
    217 	if ((sevstr = severity2str(severity)) == NULL)
    218 		return (MM_NOTOK);
    219 
    220 	/*
    221 	 * Fact in search for a better place: XSH5 does not define any
    222 	 * functionality for `classification' bits other than the display
    223 	 * subclassification.
    224 	 */
    225 
    226 	result = 0;
    227 
    228 	if (classification & MM_PRINT) {
    229 		if (writeit(stderr, msgverb(getenv("MSGVERB")),
    230 		    label, sevstr, text, action, tag) < 0)
    231 			result |= MM_NOMSG;
    232 	}
    233 	/* Similar to MM_PRINT but ignoring $MSGVERB. */
    234 	if (classification & MM_CONSOLE) {
    235 		if ((console = fopen(_PATH_CONSOLE, "w")) != NULL) {
    236 			if (writeit(console, MM_VERBALL,
    237 			    label, sevstr, text, action, tag) < 0)
    238 				result |= MM_NOCON;
    239 			/*
    240 			 * Ignore result: does not constitute ``generate a
    241 			 * console message.''
    242 			 */
    243 			(void)fclose(console);
    244 		} else {
    245 			result |= MM_NOCON;
    246 		}
    247 	}
    248 
    249 	if (result == (MM_NOMSG | MM_NOCON))
    250 		result = MM_NOTOK;
    251 
    252 	return (result == 0 ? MM_OK : result);
    253 }
    254