From dbc7cd5ae92f3f2be03dce659ade7aecb6878079 Mon Sep 17 00:00:00 2001 From: gavin Date: Mon, 9 Aug 2010 14:48:31 +0000 Subject: [PATCH] Add descriptions to a handful of sysctl nodes. PR: kern/148580 Submitted by: Galimov Albert MFC after: 1 week --- sys/kern/init_main.c | 9 ++++++--- sys/kern/kern_cons.c | 8 +++++--- sys/kern/kern_ktrace.c | 3 ++- 3 files changed, 13 insertions(+), 7 deletions(-) diff --git a/sys/kern/init_main.c b/sys/kern/init_main.c index e4d84196b45e..de35a52d71e3 100644 --- a/sys/kern/init_main.c +++ b/sys/kern/init_main.c @@ -100,9 +100,11 @@ struct vmspace vmspace0; struct proc *initproc; int boothowto = 0; /* initialized so that it can be patched */ -SYSCTL_INT(_debug, OID_AUTO, boothowto, CTLFLAG_RD, &boothowto, 0, ""); +SYSCTL_INT(_debug, OID_AUTO, boothowto, CTLFLAG_RD, &boothowto, 0, + "Boot control flags, passed from loader"); int bootverbose; -SYSCTL_INT(_debug, OID_AUTO, bootverbose, CTLFLAG_RW, &bootverbose, 0, ""); +SYSCTL_INT(_debug, OID_AUTO, bootverbose, CTLFLAG_RW, &bootverbose, 0, + "Control the output of verbose kernel messages"); /* * This ensures that there is at least one entry so that the sysinit_set @@ -647,7 +649,8 @@ SYSCTL_STRING(_kern, OID_AUTO, init_path, CTLFLAG_RD, init_path, 0, #endif static int init_shutdown_timeout = INIT_SHUTDOWN_TIMEOUT; SYSCTL_INT(_kern, OID_AUTO, init_shutdown_timeout, - CTLFLAG_RW, &init_shutdown_timeout, 0, ""); + CTLFLAG_RW, &init_shutdown_timeout, 0, "Shutdown timeout of init(8). " + "Unused within kernel, but used to control init(8)"); /* * Start the initial user process; try exec'ing each pathname in init_path. diff --git a/sys/kern/kern_cons.c b/sys/kern/kern_cons.c index 2b9854f17308..42b98cf57250 100644 --- a/sys/kern/kern_cons.c +++ b/sys/kern/kern_cons.c @@ -341,7 +341,8 @@ sysctl_kern_consmute(SYSCTL_HANDLER_ARGS) } SYSCTL_PROC(_kern, OID_AUTO, consmute, CTLTYPE_INT|CTLFLAG_RW, - 0, sizeof(cn_mute), sysctl_kern_consmute, "I", ""); + 0, sizeof(cn_mute), sysctl_kern_consmute, "I", + "State of the console muting"); /* * Low level console routines. @@ -429,7 +430,7 @@ cnputs(char *p) static int consmsgbuf_size = 8192; SYSCTL_INT(_kern, OID_AUTO, consmsgbuf_size, CTLFLAG_RW, &consmsgbuf_size, 0, - ""); + "Console tty buffer size"); /* * Redirect console output to a tty. @@ -471,7 +472,8 @@ constty_clear(void) /* Times per second to check for pending console tty messages. */ static int constty_wakeups_per_second = 5; SYSCTL_INT(_kern, OID_AUTO, constty_wakeups_per_second, CTLFLAG_RW, - &constty_wakeups_per_second, 0, ""); + &constty_wakeups_per_second, 0, + "Times per second to check for pending console tty messages"); static void constty_timeout(void *arg) diff --git a/sys/kern/kern_ktrace.c b/sys/kern/kern_ktrace.c index e843da470a14..d5eb4e1cb5a5 100644 --- a/sys/kern/kern_ktrace.c +++ b/sys/kern/kern_ktrace.c @@ -218,7 +218,8 @@ sysctl_kern_ktrace_request_pool(SYSCTL_HANDLER_ARGS) return (0); } SYSCTL_PROC(_kern_ktrace, OID_AUTO, request_pool, CTLTYPE_UINT|CTLFLAG_RW, - &ktr_requestpool, 0, sysctl_kern_ktrace_request_pool, "IU", ""); + &ktr_requestpool, 0, sysctl_kern_ktrace_request_pool, "IU", + "Pool buffer size for ktrace(1)"); static u_int ktrace_resize_pool(u_int newsize)