NetBSD-Docs archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

boot(8), kprintf(9), boothowto and code comments

Hi list,

While browsing through boot code (for Xen), I did not find any man page talking about the boothowto variable and boot flags which control the aprint_*() functions' verbosity. After looking for them for maybe 10 min, I did not see anything.

Just to fix it, anyone would be so kind to comment the attached diff, and see if we could find some way to commit this info?

Please cc me on reply.


Jean-Yves Migeon

Index: share/man/man8/boot.8
RCS file: /pub/NetBSD-CVS/src/share/man/man8/boot.8,v
retrieving revision 1.6
diff -u -r1.6 boot.8
--- share/man/man8/boot.8       14 Dec 2007 12:03:53 -0000      1.6
+++ share/man/man8/boot.8       13 Jul 2008 20:52:34 -0000
@@ -103,6 +103,14 @@
 .Pa onetbsd.gz .
 Alternate system images can be loaded by just specifying the name of the image.
+Some options control the verbosity of
+.Fn aprint_*
+functions by setting different flags in the
+.Dq boothowto
+variable. See
+.Xr kprintf 9
+for more details.
 Options are:
 .Bl -tag -width xxx
 .It Fl a
@@ -118,15 +126,31 @@
 Here it waits for a kernel debugger connect; see
 .Xr ddb 4 .
 .It Fl q
-Boot the system in quiet mode.
+Boot the system in quiet mode (set
+flag in
+.Dq boothowto
 .It Fl s
 Bring the system up in single-user mode.
 .It Fl v
-Boot the system in verbose mode.
+Boot the system in verbose mode (set
+flag in
+.Dq boothowto
 .It Fl x
-Boot the system with debug messages enabled.
+Boot the system with debug messages enabled (set
+flag in
+.Dq boothowto
 .It Fl z
-Boot the system in silent mode.
+Boot the system in silent mode (set
+.Dq boothowto
 .It Ic consdev Va dev
 Immediately switch the console to the specified device
@@ -198,7 +222,8 @@
 .Xr halt 8 ,
 .Xr installboot 8 ,
 .Xr reboot 8 ,
-.Xr shutdown 8
+.Xr shutdown 8 ,
+.Xr kprintf 9
 .Ar filename
Index: share/man/man9/kprintf.9
RCS file: /pub/NetBSD-CVS/src/share/man/man9/kprintf.9,v
retrieving revision 1.23
diff -u -r1.23 kprintf.9
--- share/man/man9/kprintf.9    30 Apr 2008 13:10:58 -0000      1.23
+++ share/man/man9/kprintf.9    13 Jul 2008 20:52:15 -0000
@@ -141,7 +141,10 @@
 are intended to be used to print autoconfiguration messages, and change
 their behavior based on flags in the
 .Dq boothowto
+variable; see
+.Sx Interactive mode
+.Xr boot 8 :
 .Bl -tag -width "aprint_verbose()"
 .It Fn aprint_normal
 Sends to the console unless
@@ -216,6 +219,7 @@
 .Xr printf 1 ,
 .Xr printf 3 ,
+.Xr boot 8 ,
 .Xr bitmask_snprintf 9
 .Pa sys/kern/subr_prf.c

Home | Main Index | Thread Index | Old Index