2 * Copyright (c) 2000-2006 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
33 * Mach Operating System
34 * Copyright (c) 1991,1990,1989,1988 Carnegie Mellon University
35 * All Rights Reserved.
37 * Permission to use, copy, modify and distribute this software and its
38 * documentation is hereby granted, provided that both the copyright
39 * notice and this permission notice appear in all copies of the
40 * software, derivative works or modified versions, and any portions
41 * thereof, and that both notices appear in supporting documentation.
43 * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
44 * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
45 * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
47 * Carnegie Mellon requests users of this software to return to
49 * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
50 * School of Computer Science
51 * Carnegie Mellon University
52 * Pittsburgh PA 15213-3890
54 * any improvements or extensions that they make and grant Carnegie Mellon
55 * the rights to redistribute these changes.
59 * Common code for printf et al.
61 * The calling routine typically takes a variable number of arguments,
62 * and passes the address of the first one. This implementation
63 * assumes a straightforward, stack implementation, aligned to the
64 * machine's wordsize. Increasing addresses are assumed to point to
65 * successive arguments (left-to-right), as is the case for a machine
66 * with a downward-growing stack with arguments pushed right-to-left.
68 * To write, for example, fprintf() using this routine, the code
70 * fprintf(fd, format, args)
74 * _doprnt(format, &args, fd);
77 * would suffice. (This example does not handle the fprintf's "return
78 * value" correctly, but who looks at the return value of fprintf
81 * This version implements the following printf features:
83 * %d decimal conversion
84 * %u unsigned conversion
85 * %x hexadecimal conversion
86 * %X hexadecimal conversion with capital letters
87 * %D hexdump, ptr & separator string ("%6D", ptr, ":") -> XX:XX:XX:XX:XX:XX
88 * if you use, "%*D" then there's a length, the data ptr and then the separator
92 * %m.n field width, precision
93 * %-m.n left adjustment
95 * %*.* width and precision taken from arguments
97 * This version does not implement %f, %e, or %g.
99 * As mentioned, this version does not return any reasonable value.
101 * Permission is granted to use, modify, or propagate this code as
102 * long as this notice is incorporated.
104 * Steve Summit 3/25/87
106 * Tweaked for long long support and extended to support the hexdump %D
107 * specifier by dbg 05/02/02.
111 * Added formats for decoding device registers:
113 * printf("reg = %b", regval, "<base><arg>*")
115 * where <base> is the output base expressed as a control character:
116 * i.e. '\10' gives octal, '\20' gives hex. Each <arg> is a sequence of
117 * characters, the first of which gives the bit number to be inspected
118 * (origin 1), and the rest (up to a control character (<= 32)) give the
119 * name of the register. Thus
120 * printf("reg = %b\n", 3, "\10\2BITTWO\1BITONE")
122 * reg = 3<BITTWO,BITONE>
124 * If the second character in <arg> is also a control character, it
125 * indicates the last bit of a bit field. In this case, printf will extract
126 * bits <1> to <2> and print it. Characters following the second control
127 * character are printed before the bit field.
128 * printf("reg = %b\n", 0xb, "\10\4\3FIELD1=\2BITTWO\1BITONE")
130 * reg = b<FIELD1=2,BITONE>
132 * The %B format is like %b but the bits are numbered from the most
133 * significant (the bit weighted 31), which is called 1, to the least
134 * significant, called 32.
137 * Added for general use:
138 * # prefix for alternate format:
140 * leading 0 for octal
141 * + print '+' if positive
142 * blank print ' ' if positive
144 * z signed hexadecimal
146 * n unsigned, 'radix'
148 * D,U,O,Z same as corresponding lower-case versions
152 * Added support for print long long (64-bit) integers.
153 * Use %lld, %Ld or %qd to print a 64-bit int. Other
154 * output bases such as x, X, u, U, o, and O also work.
158 #include <mach_kdp.h>
159 #include <mach/boolean.h>
160 #include <kern/cpu_number.h>
161 #include <kern/thread.h>
162 #include <kern/sched_prim.h>
163 #include <kern/misc_protos.h>
166 #include <mach_assert.h>
168 #include <sys/msgbuf.h>
170 #include <console/serial_protos.h>
171 #include <os/log_private.h>
173 #define isdigit(d) ((d) >= '0' && (d) <= '9')
174 #define Ctod(c) ((c) - '0')
176 #define MAXBUF (sizeof(long long int) * 8) /* enough for binary */
177 static char digs
[] = "0123456789abcdef";
179 #if CONFIG_NO_PRINTF_STRINGS
180 /* Prevent CPP from breaking the definition below */
184 int _consume_printf_args(int a __unused
, ...)
188 void _consume_kprintf_args(int a __unused
, ...)
194 unsigned long long int u
, /* number to print */
196 void (*putc
)(int, void *),
199 char buf
[MAXBUF
]; /* build number here */
200 char * p
= &buf
[MAXBUF
-1];
204 *p
-- = digs
[u
% base
];
208 while (++p
!= &buf
[MAXBUF
]) {
216 boolean_t _doprnt_truncates
= FALSE
;
218 #if (DEVELOPMENT || DEBUG)
219 boolean_t doprnt_hide_pointers
= FALSE
;
221 boolean_t doprnt_hide_pointers
= TRUE
;
228 /* character output routine */
229 void (*putc
)(int, void *arg
),
231 int radix
, /* default radix - for '%r' */
239 unsigned long long u
;
242 boolean_t altfmt
, truncate
;
249 while ((c
= *fmt
) != '\0') {
295 length
= 10 * length
+ Ctod(c
);
300 length
= va_arg(argp
, int);
313 prec
= 10 * prec
+ Ctod(c
);
318 prec
= va_arg(argp
, int);
324 c
= *++fmt
; /* need it if sizeof(int) < sizeof(long) */
325 if (sizeof(int)<sizeof(long))
331 } else if (c
== 'q' || c
== 'L') {
337 capitals
=0; /* Assume lower case printing */
348 u
= va_arg(argp
, unsigned long long);
350 u
= va_arg(argp
, unsigned int);
352 p
= va_arg(argp
, char *);
354 nprinted
+= printnum(u
, base
, putc
, arg
);
360 while ((i
= *p
++) != '\0') {
378 for (; (c
= *p
) > 32; p
++) {
382 nprinted
+= printnum((unsigned)( (u
>>(j
-1)) & ((2<<(i
-j
))-1)),
385 else if (u
& (1<<(i
-1))) {
393 for (; (c
= *p
) > 32; p
++) {
411 c
= va_arg(argp
, int);
422 prec
= 0x7fffffff; /* MAXINT */
424 p
= va_arg(argp
, char *);
429 if (length
> 0 && !ladjust
) {
433 for (; *p
!= '\0' && n
< prec
; p
++)
447 while ((n
< prec
) && (!(length
> 0 && n
>= length
))) {
456 if (n
< length
&& ladjust
) {
468 truncate
= _doprnt_truncates
;
477 up
= (unsigned char *)va_arg(argp
, unsigned char *);
478 p
= (char *)va_arg(argp
, char *);
482 (*putc
)(digs
[(*up
>> 4)], arg
);
483 (*putc
)(digs
[(*up
& 0x0f)], arg
);
497 truncate
= _doprnt_truncates
;
502 truncate
= _doprnt_truncates
;
509 if (sizeof(int)<sizeof(void *)) {
513 truncate
= _doprnt_truncates
;
519 capitals
=16; /* Print in upper case */
523 truncate
= _doprnt_truncates
;
529 capitals
=16; /* Print in upper case */
533 truncate
= _doprnt_truncates
;
539 truncate
= _doprnt_truncates
;
546 n
= va_arg(argp
, long long);
548 n
= va_arg(argp
, int);
552 sign_char
= plus_sign
;
562 u
= va_arg(argp
, unsigned long long);
564 u
= va_arg(argp
, unsigned int);
570 char buf
[MAXBUF
]; /* build number here */
571 char * p
= &buf
[MAXBUF
-1];
572 static char digits
[] = "0123456789abcdef0123456789ABCDEF";
573 const char *prefix
= NULL
;
575 if (truncate
) u
= (long long)((int)(u
));
577 if (doprnt_hide_pointers
&& is_log
) {
578 const char str
[] = "<ptr>";
579 const char* strp
= str
;
580 int strl
= sizeof(str
) - 1;
582 if (u
>= VM_MIN_KERNEL_AND_KEXT_ADDRESS
&& u
<= VM_MAX_KERNEL_ADDRESS
) {
583 while(*strp
!= '\0') {
592 if (u
!= 0 && altfmt
) {
600 /* Print in the correct case */
601 *p
-- = digits
[(u
% base
)+capitals
];
605 length
-= (int)(&buf
[MAXBUF
-1] - p
);
609 length
-= (int)strlen(prefix
);
611 if (padc
== ' ' && !ladjust
) {
612 /* blank padding goes before prefix */
613 while (--length
>= 0) {
619 (*putc
)(sign_char
, arg
);
624 (*putc
)(*prefix
++, arg
);
629 /* zero padding goes after sign and prefix */
630 while (--length
>= 0) {
635 while (++p
!= &buf
[MAXBUF
]) {
641 while (--length
>= 0) {
664 dummy_putc(int ch
, void *arg
)
666 void (*real_putc
)(char) = arg
;
675 /* character output routine */
677 int radix
) /* default radix - for '%r' */
679 __doprnt(fmt
, *argp
, dummy_putc
, putc
, radix
, FALSE
);
686 /* character output routine */
688 int radix
) /* default radix - for '%r' */
690 __doprnt(fmt
, *argp
, dummy_putc
, putc
, radix
, TRUE
);
694 boolean_t new_printf_cpu_number
= FALSE
;
695 #endif /* MP_PRINTF */
697 decl_simple_lock_data(,printf_lock
)
698 decl_simple_lock_data(,bsd_log_spinlock
)
701 * Defined here to allow lock group to be statically allocated.
703 static lck_grp_t oslog_stream_lock_grp
;
704 decl_lck_spin_data(,oslog_stream_lock
)
705 void oslog_lock_init(void);
707 extern void bsd_log_init(void);
708 void bsd_log_lock(void);
709 void bsd_log_unlock(void);
716 * Lock is only really needed after the first thread is created.
718 simple_lock_init(&printf_lock
, 0);
719 simple_lock_init(&bsd_log_spinlock
, 0);
726 simple_lock(&bsd_log_spinlock
);
732 simple_unlock(&bsd_log_spinlock
);
736 oslog_lock_init(void)
738 lck_grp_init(&oslog_stream_lock_grp
, "oslog stream", LCK_GRP_ATTR_NULL
);
739 lck_spin_init(&oslog_stream_lock
, &oslog_stream_lock_grp
, LCK_ATTR_NULL
);
742 /* derived from boot_gets */
750 char *strmax
= str
+ maxlen
- 1; /* allow space for trailing 0 */
778 if (c
>= ' ' && c
< '\177') {
784 printf("%c", '\007'); /* beep */
791 extern int disableConsoleOutput
;
797 if ((debug_mode
&& !disable_debug_output
) || !disableConsoleOutput
)
810 if ((debug_mode
&& !disable_debug_output
) || !disableConsoleOutput
)
815 vprintf_internal(const char *fmt
, va_list ap_in
, void *caller
)
821 disable_preemption();
822 _doprnt_log(fmt
, &ap
, cons_putc_locked
, 16);
827 if (debug_mode
== 0) {
828 os_log_with_args(OS_LOG_DEFAULT
, OS_LOG_TYPE_DEFAULT
, fmt
, ap_in
, caller
);
834 __attribute__((noinline
,not_tail_called
))
836 printf(const char *fmt
, ...)
842 ret
= vprintf_internal(fmt
, ap
, __builtin_return_address(0));
848 __attribute__((noinline
,not_tail_called
))
850 vprintf(const char *fmt
, va_list ap
)
852 return vprintf_internal(fmt
, ap
, __builtin_return_address(0));
856 consdebug_putc(char c
)
858 if ((debug_mode
&& !disable_debug_output
) || !disableConsoleOutput
)
863 if (!console_is_serial())
864 if (!disable_serial_output
)
869 consdebug_putc_unbuffered(char c
)
871 if ((debug_mode
&& !disable_debug_output
) || !disableConsoleOutput
)
872 cnputc_unbuffered(c
);
876 if (!console_is_serial())
877 if (!disable_serial_output
)
882 consdebug_log(char c
)
888 kdb_printf(const char *fmt
, ...)
892 va_start(listp
, fmt
);
893 _doprnt_log(fmt
, &listp
, consdebug_putc
, 16);
899 kdb_log(const char *fmt
, ...)
903 va_start(listp
, fmt
);
904 _doprnt(fmt
, &listp
, consdebug_log
, 16);
910 kdb_printf_unbuffered(const char *fmt
, ...)
914 va_start(listp
, fmt
);
915 _doprnt(fmt
, &listp
, consdebug_putc_unbuffered
, 16);
922 copybyte(int c
, void *arg
)
925 * arg is a pointer (outside pointer) to the pointer
926 * (inside pointer) which points to the character.
927 * We pass a double pointer, so that we can increment
928 * the inside pointer.
930 char** p
= arg
; /* cast outside pointer */
931 **p
= c
; /* store character */
932 (*p
)++; /* increment inside pointer */
936 * Deprecation Warning:
937 * sprintf() is being deprecated. Please use snprintf() instead.
940 sprintf(char *buf
, const char *fmt
, ...)
945 va_start(listp
, fmt
);
947 __doprnt(fmt
, listp
, copybyte
, ©byte_str
, 16, FALSE
);
949 *copybyte_str
= '\0';
950 return (int)strlen(buf
);