2 * Copyright (c) 1986, 1988, 1991, 1993
3 * The Regents of the University of California. All rights reserved.
4 * (c) UNIX System Laboratories, Inc.
5 * All or some portions of this file are derived from material licensed
6 * to the University of California by American Telephone and Telegraph
7 * Co. or Unix System Laboratories, Inc. and are reproduced herein with
8 * the permission of UNIX System Laboratories, Inc.
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
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. Neither the name of the University nor the names of its contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 * @(#)subr_prf.c 8.3 (Berkeley) 1/21/94
37 #include <sys/cdefs.h>
38 __FBSDID("$FreeBSD$");
41 * Standaloneified version of the FreeBSD kernel printf family.
44 #include <sys/types.h>
45 #include <sys/stddef.h>
46 #include <sys/stdint.h>
52 * Note that stdarg.h and the ANSI style va_start macro is used for both
53 * ANSI and traditional C compilers.
55 #include <machine/stdarg.h>
57 #define MAXNBUF (sizeof(intmax_t) * CHAR_BIT + 1)
59 typedef void (kvprintf_fn_t)(int, void *);
61 static char *ksprintn (char *buf, uintmax_t num, int base, int *len, int upper);
62 static int kvprintf(char const *fmt, kvprintf_fn_t *func, void *arg, int radix, va_list ap);
65 putchar_wrapper(int cc, void *arg)
72 printf(const char *fmt, ...)
78 retval = kvprintf(fmt, putchar_wrapper, NULL, 10, ap);
84 vprintf(const char *fmt, va_list ap)
87 return (kvprintf(fmt, putchar_wrapper, NULL, 10, ap));
91 sprintf(char *buf, const char *cfmt, ...)
97 retval = kvprintf(cfmt, NULL, (void *)buf, 10, ap);
109 snprint_func(int ch, void *arg)
111 struct print_buf *pbuf = arg;
113 if (pbuf->size < 2) {
115 * Reserve last buffer position for the terminating
125 asprintf(char **buf, const char *cfmt, ...)
128 struct print_buf arg;
133 retval = kvprintf(cfmt, NULL, NULL, 10, ap);
138 arg.size = retval + 1;
139 arg.buf = *buf = malloc(arg.size);
144 retval = kvprintf(cfmt, &snprint_func, &arg, 10, ap);
153 snprintf(char *buf, size_t size, const char *cfmt, ...)
157 struct print_buf arg;
163 retval = kvprintf(cfmt, &snprint_func, &arg, 10, ap);
172 vsnprintf(char *buf, size_t size, const char *cfmt, va_list ap)
174 struct print_buf arg;
180 retval = kvprintf(cfmt, &snprint_func, &arg, 10, ap);
189 vsprintf(char *buf, const char *cfmt, va_list ap)
193 retval = kvprintf(cfmt, NULL, (void *)buf, 10, ap);
200 * Put a NUL-terminated ASCII number (base <= 36) in a buffer in reverse
201 * order; return an optional length and a pointer to the last character
202 * written in the buffer (i.e., the first character of the string).
203 * The buffer pointed to by `nbuf' must have length >= MAXNBUF.
206 ksprintn(char *nbuf, uintmax_t num, int base, int *lenp, int upper)
213 c = hex2ascii(num % base);
214 *++p = upper ? toupper(c) : c;
215 } while (num /= base);
222 * Scaled down version of printf(3).
224 * Two additional formats:
226 * The format %b is supported to decode error registers.
229 * printf("reg=%b\n", regval, "<base><arg>*");
231 * where <base> is the output base expressed as a control character, e.g.
232 * \10 gives octal; \20 gives hex. Each arg is a sequence of characters,
233 * the first of which gives the bit number to be inspected (origin 1), and
234 * the next characters (up to a control character, i.e. a character <= 32),
235 * give the name of the register. Thus:
237 * kvprintf("reg=%b\n", 3, "\10\2BITTWO\1BITONE");
239 * would produce output:
241 * reg=3<BITTWO,BITONE>
243 * XXX: %D -- Hexdump, takes pointer and separator string:
244 * ("%6D", ptr, ":") -> XX:XX:XX:XX:XX:XX
245 * ("%*D", len, ptr, " " -> XX XX XX XX ...
248 kvprintf(char const *fmt, kvprintf_fn_t *func, void *arg, int radix, va_list ap)
250 #define PCHAR(c) {int cc=(c); if (func) (*func)(cc, arg); else *d++ = cc; retval++; }
253 const char *p, *percent, *q;
258 int base, lflag, qflag, tmp, width, ladjust, sharpflag, neg, sign, dot;
259 int cflag, hflag, jflag, tflag, zflag;
262 int stop = 0, retval = 0;
271 fmt = "(fmt null)\n";
273 if (radix < 2 || radix > 36)
279 while ((ch = (u_char)*fmt++) != '%' || stop) {
285 qflag = 0; lflag = 0; ladjust = 0; sharpflag = 0; neg = 0;
286 sign = 0; dot = 0; dwidth = 0; upper = 0;
287 cflag = 0; hflag = 0; jflag = 0; tflag = 0; zflag = 0;
288 reswitch: switch (ch = (u_char)*fmt++) {
306 width = va_arg(ap, int);
312 dwidth = va_arg(ap, int);
320 case '1': case '2': case '3': case '4':
321 case '5': case '6': case '7': case '8': case '9':
322 for (n = 0;; ++fmt) {
323 n = n * 10 + ch - '0';
325 if (ch < '0' || ch > '9')
334 num = (u_int)va_arg(ap, int);
335 p = va_arg(ap, char *);
336 for (q = ksprintn(nbuf, num, *p++, NULL, 0); *q;)
344 if (num & (1 << (n - 1))) {
345 PCHAR(tmp ? ',' : '<');
346 for (; (n = *p) > ' '; ++p)
350 for (; *p > ' '; ++p)
357 PCHAR(va_arg(ap, int));
360 up = va_arg(ap, u_char *);
361 p = va_arg(ap, char *);
365 PCHAR(hex2ascii(*up >> 4));
366 PCHAR(hex2ascii(*up & 0x0f));
397 *(va_arg(ap, intmax_t *)) = retval;
399 *(va_arg(ap, quad_t *)) = retval;
401 *(va_arg(ap, long *)) = retval;
403 *(va_arg(ap, size_t *)) = retval;
405 *(va_arg(ap, short *)) = retval;
407 *(va_arg(ap, char *)) = retval;
409 *(va_arg(ap, int *)) = retval;
416 sharpflag = (width == 0);
418 num = (uintptr_t)va_arg(ap, void *);
429 p = va_arg(ap, char *);
435 for (n = 0; n < dwidth && p[n]; n++)
440 if (!ladjust && width > 0)
445 if (ladjust && width > 0)
449 case 'S': /* Assume console can cope with wide chars */
450 for (S = va_arg(ap, uint16_t *); *S != 0; S++)
474 num = va_arg(ap, uintmax_t);
476 num = va_arg(ap, u_quad_t);
478 num = va_arg(ap, ptrdiff_t);
480 num = va_arg(ap, u_long);
482 num = va_arg(ap, size_t);
484 num = (u_short)va_arg(ap, int);
486 num = (u_char)va_arg(ap, int);
488 num = va_arg(ap, u_int);
492 num = va_arg(ap, intmax_t);
494 num = va_arg(ap, quad_t);
496 num = va_arg(ap, ptrdiff_t);
498 num = va_arg(ap, long);
500 num = va_arg(ap, ssize_t);
502 num = (short)va_arg(ap, int);
504 num = (char)va_arg(ap, int);
506 num = va_arg(ap, int);
508 if (sign && (intmax_t)num < 0) {
510 num = -(intmax_t)num;
512 p = ksprintn(nbuf, num, base, &n, upper);
514 if (sharpflag && num != 0) {
523 if (!ladjust && padc == '0')
524 dwidth = width - tmp;
525 width -= tmp + imax(dwidth, n);
532 if (sharpflag && num != 0) {
535 } else if (base == 16) {
552 while (percent < fmt)
555 * Since we ignore a formatting argument it is no
556 * longer safe to obey the remaining formatting
557 * arguments as the arguments will no longer match