xref: /netbsd/lib/libc/gen/fmtmsg.c (revision bf9ec67e)
1 /*	$NetBSD: fmtmsg.c,v 1.2 1999/09/13 18:36:02 kleink 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 1999/09/13 18:36:02 kleink 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 	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 < nseverities)
138 		result = severities[severity];
139 	else
140 		result = NULL;
141 
142 	return (result);
143 }
144 
145 /*
146  * Format and write the message to the given stream, selecting those
147  * components displayed from msgverb, returning the number of characters
148  * written, or a negative value in case of an error.
149  */
150 static int
151 writeit(stream, which, label, sevstr, text, action, tag)
152 	FILE *stream;
153 	unsigned int which;
154 	const char *label;
155 	const char *sevstr;
156 	const char *text;
157 	const char *action;
158 	const char *tag;
159 {
160 	int nwritten;
161 
162 	nwritten = fprintf(stream, "%s%s%s%s%s%s%s%s%s%s%s",
163 	    ((which & MM_VERBLABEL) && label != MM_NULLLBL) ?
164 	    label : "",
165 	    ((which & MM_VERBLABEL) && label != MM_NULLLBL) ?
166 	    ": " : "",
167 	    (which & MM_VERBSEVERITY) ?
168 	    sevstr : "",
169 	    (which & MM_VERBSEVERITY) ?
170 	    ": " : "",
171 	    ((which & MM_VERBTEXT) && text != MM_NULLTXT) ?
172 	    text : "",
173 	    ((which & MM_VERBLABEL) && label != MM_NULLLBL) ||
174 	    ((which & MM_VERBSEVERITY)) ||
175 	    ((which & MM_VERBTEXT) && text != MM_NULLTXT) ?
176 	    "\n" : "",
177 	    ((which & MM_VERBACTION) && action != MM_NULLACT) ?
178 	    "TO FIX: " : "",
179 	    ((which & MM_VERBACTION) && action != MM_NULLACT) ?
180 	    action : "",
181 	    ((which & MM_VERBACTION) && label != MM_NULLACT) ?
182 	    " " : "",
183 	    ((which & MM_VERBTAG) && tag != MM_NULLTAG) ?
184 	    tag : "",
185 	    ((which & MM_VERBACTION) && action != MM_NULLACT) ||
186 	    ((which & MM_VERBTAG) && tag != MM_NULLTAG) ?
187 	    "\n" : "");
188 
189 	return (nwritten);
190 }
191 
192 int
193 fmtmsg(classification, label, severity, text, action, tag)
194 	long classification;
195 	const char *label;
196 	int severity;
197 	const char *text;
198 	const char *action;
199 	const char *tag;
200 {
201 	FILE *console;
202 	const char *p, *sevstr;
203 	int result;
204 
205 	/* Validate label constraints, if not null. */
206 	if (label != MM_NULLLBL) {
207 		/*
208 		 * Two fields, separated by a colon.  The first field is up to
209 		 * 10 bytes, the second is up to 14 bytes.
210 		 */
211 		p = strchr(label, ':');
212 		if (p ==  NULL || p - label > 10 || strlen(p + 1) > 14)
213 			return (MM_NOTOK);
214 	}
215 	/* Validate severity argument. */
216 	if ((sevstr = severity2str(severity)) == NULL)
217 		return (MM_NOTOK);
218 
219 	/*
220 	 * Fact in search for a better place: XSH5 does not define any
221 	 * functionality for `classification' bits other than the display
222 	 * subclassification.
223 	 */
224 
225 	result = 0;
226 
227 	if (classification & MM_PRINT) {
228 		if (writeit(stderr, msgverb(getenv("MSGVERB")),
229 		    label, sevstr, text, action, tag) < 0)
230 			result |= MM_NOMSG;
231 	}
232 	/* Similar to MM_PRINT but ignoring $MSGVERB. */
233 	if (classification & MM_CONSOLE) {
234 		if ((console = fopen(_PATH_CONSOLE, "w")) != NULL) {
235 			if (writeit(console, MM_VERBALL,
236 			    label, sevstr, text, action, tag) < 0)
237 				result |= MM_NOCON;
238 			/*
239 			 * Ignore result: does not constitute ``generate a
240 			 * console message.''
241 			 */
242 			(void)fclose(console);
243 		} else {
244 			result |= MM_NOCON;
245 		}
246 	}
247 
248 	if (result == (MM_NOMSG | MM_NOCON))
249 		result = MM_NOTOK;
250 
251 	return (result == 0 ? MM_OK : result);
252 }
253