Wed Nov 21 17:18:11 2012 UTC ()
document change in {,v}snprintf() behavior.


(christos)
diff -r1.31 -r1.32 src/share/man/man9/kprintf.9
cvs diff -r1.31 -r1.32 src/share/man/man9/kprintf.9 (expand / switch to unified diff)

--- src/share/man/man9/kprintf.9 2011/07/17 20:54:35 1.31
+++ src/share/man/man9/kprintf.9 2012/11/21 17:18:11 1.32
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: kprintf.9,v 1.31 2011/07/17 20:54:35 joerg Exp $ 1.\" $NetBSD: kprintf.9,v 1.32 2012/11/21 17:18:11 christos Exp $
2.\" 2.\"
3.\" Copyright (c) 1998, 2002, 2007, 2011 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1998, 2002, 2007, 2011 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jeremy Cooper and by Jason R. Thorpe. 7.\" by Jeremy Cooper and by Jason R. Thorpe.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -17,27 +17,27 @@ @@ -17,27 +17,27 @@
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd January 21, 2011 30.Dd November 21, 2012
31.Dt KPRINTF 9 31.Dt KPRINTF 9
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm device_printf , 34.Nm device_printf ,
35.Nm printf , 35.Nm printf ,
36.Nm snprintf , 36.Nm snprintf ,
37.Nm vprintf , 37.Nm vprintf ,
38.Nm vsnprintf , 38.Nm vsnprintf ,
39.Nm uprintf , 39.Nm uprintf ,
40.Nm ttyprintf , 40.Nm ttyprintf ,
41.Nm tprintf , 41.Nm tprintf ,
42.Nm aprint 42.Nm aprint
43.Nd kernel formatted output conversion 43.Nd kernel formatted output conversion
@@ -240,29 +240,33 @@ If @@ -240,29 +240,33 @@ If
240is set, none of the autoconfiguration message printing routines send output 240is set, none of the autoconfiguration message printing routines send output
241to the console. 241to the console.
242The 242The
243.Dv AB_VERBOSE 243.Dv AB_VERBOSE
244and 244and
245.Dv AB_DEBUG 245.Dv AB_DEBUG
246flags override 246flags override
247.Dv AB_SILENT . 247.Dv AB_SILENT .
248.Sh RETURN VALUES 248.Sh RETURN VALUES
249The 249The
250.Fn snprintf 250.Fn snprintf
251and 251and
252.Fn vsnprintf 252.Fn vsnprintf
253functions return the number of characters placed in the buffer 253functions return the number of characters that would have been placed
 254in the buffer
254.Fa buf . 255.Fa buf .
255This is different to the user-space functions of the same name. 256if there was enough space in the buffer, not including the trailing
 257.Dv NUL
 258character used to terminate output strings like the user-space functions
 259of the same name.
256.Pp 260.Pp
257The 261The
258.Fn tprintf_open 262.Fn tprintf_open
259function returns 263function returns
260.Dv NULL 264.Dv NULL
261if no terminal handle could be acquired. 265if no terminal handle could be acquired.
262.Sh SEE ALSO 266.Sh SEE ALSO
263.Xr printf 1 , 267.Xr printf 1 ,
264.Xr printf 3 , 268.Xr printf 3 ,
265.Xr snprintb 3 , 269.Xr snprintb 3 ,
266.Xr boot 8 , 270.Xr boot 8 ,
267.Xr autoconf 9 , 271.Xr autoconf 9 ,
268.Xr boothowto 9 272.Xr boothowto 9