From nobody@FreeBSD.org  Fri Jul 16 12:41:59 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 746F0106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 16 Jul 2010 12:41:59 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 64B008FC18
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 16 Jul 2010 12:41:59 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o6GCfwS3041647
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 16 Jul 2010 12:41:58 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o6GCfwXR041646;
	Fri, 16 Jul 2010 12:41:58 GMT
	(envelope-from nobody)
Message-Id: <201007161241.o6GCfwXR041646@www.freebsd.org>
Date: Fri, 16 Jul 2010 12:41:58 GMT
From: Galimov Albert <wtfcrap@mail.ru>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [sysctl][patch] Document some sys/kern sysctls
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         148680
>Category:       docs
>Synopsis:       [sysctl][patch] Document some sys/kern sysctls
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 16 12:50:02 UTC 2010
>Closed-Date:    
>Last-Modified:  Sat Aug  7 19:50:03 UTC 2010
>Originator:     Galimov Albert
>Release:        HEAD
>Organization:
>Environment:
>Description:
Document for sysctl variables
diff sys/kern/subr_log.c sys/kern/kern_thread.c sys/kern/kern_shutdown.c sys/kern/vfs_syscalls.c
>How-To-Repeat:

>Fix:
Patch

Patch attached with submission follows:

Index: sys/kern/subr_log.c
===================================================================
--- sys/kern/subr_log.c	(revision 210019)
+++ sys/kern/subr_log.c	(working copy)
@@ -87,7 +87,7 @@
 /* Times per second to check for a pending syslog wakeup. */
 static int	log_wakeups_per_second = 5;
 SYSCTL_INT(_kern, OID_AUTO, log_wakeups_per_second, CTLFLAG_RW,
-    &log_wakeups_per_second, 0, "");
+    &log_wakeups_per_second, 0, "Times per second to check for a pending syslog wakeup");
 
 /*ARGSUSED*/
 static	int
Index: sys/kern/kern_thread.c
===================================================================
--- sys/kern/kern_thread.c	(revision 210019)
+++ sys/kern/kern_thread.c	(working copy)
@@ -72,7 +72,7 @@
 
 int max_threads_hits;
 SYSCTL_INT(_kern_threads, OID_AUTO, max_threads_hits, CTLFLAG_RD,
-	&max_threads_hits, 0, "");
+	&max_threads_hits, 0, "max_threads_per_proc rearched counter");
 
 TAILQ_HEAD(, thread) zombie_threads = TAILQ_HEAD_INITIALIZER(zombie_threads);
 static struct mtx zombie_lock;
Index: sys/kern/kern_shutdown.c
===================================================================
--- sys/kern/kern_shutdown.c	(revision 210019)
+++ sys/kern/kern_shutdown.c	(working copy)
@@ -603,7 +603,7 @@
 static int poweroff_delay = POWEROFF_DELAY;
 
 SYSCTL_INT(_kern_shutdown, OID_AUTO, poweroff_delay, CTLFLAG_RW,
-	&poweroff_delay, 0, "");
+	&poweroff_delay, 0, "Delay before poweroff to write disks caches (usecs)");
 
 static void
 poweroff_wait(void *junk, int howto)
@@ -623,7 +623,7 @@
  */
 static int kproc_shutdown_wait = 60;
 SYSCTL_INT(_kern_shutdown, OID_AUTO, kproc_shutdown_wait, CTLFLAG_RW,
-    &kproc_shutdown_wait, 0, "");
+    &kproc_shutdown_wait, 0, "Shutdown wait for system procs and threads");
 
 void
 kproc_shutdown(void *arg, int howto)
Index: sys/kern/vfs_syscalls.c
===================================================================
--- sys/kern/vfs_syscalls.c	(revision 210019)
+++ sys/kern/vfs_syscalls.c	(working copy)
@@ -878,7 +878,11 @@
 static int chroot_allow_open_directories = 1;
 
 SYSCTL_INT(_kern, OID_AUTO, chroot_allow_open_directories, CTLFLAG_RW,
-     &chroot_allow_open_directories, 0, "");
+     &chroot_allow_open_directories, 0, "This sysctl determines if we will allow a process to chroot(2) if it\n"
+	"has a directory open:\n"
+	"0: disallowed for all processes\n"
+	"1: allowed for processes that were not already chroot(2)'ed\n"
+	"2: allowed for all processes");
 
 /*
  * Change notion of root (``/'') directory.


>Release-Note:
>Audit-Trail:

From: Chip Camden <sterling@camdensoftware.com>
To: bug-followup@FreeBSD.org, wtfcrap@mail.ru
Cc:  
Subject: Re: docs/148680: [sysctl][patch] Document some sys/kern sysctls
Date: Sat, 7 Aug 2010 12:48:40 -0700

 --pWyiEgJYm5f9v55/
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 (Bugathon)
 
 Patch applies cleanly to 8.1-STABLE and works.
 
 --=20
 Sterling (Chip) Camden    | sterling@camdensoftware.com | 2048D/3A978E4F
 http://camdensoftware.com | http://chipstips.com        | http://chipsquips=
 .com
 
 --pWyiEgJYm5f9v55/
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.10 (FreeBSD)
 
 iQEcBAEBAgAGBQJMXbiYAAoJEIpckszW26+RLOwIAMZaQYkIu87cWa8AnuSVLu67
 mlq/onKMh9pbLEqrmCAVQNB+S/Rmi6v1apWfEI0uvJp4W4S4RDGh88H6/pkrafKk
 YAlDmH3aXRPxb9abJm6c6lCdfkrubG30am+2OAA0aQ6NWRM3qc5sTtT6dLjx+zUx
 RMWGCyjjxy5dTIZzR6kd94rrHkkOt59iHv8qHi9Qv3fj1cnJjzc2rwEd2umNZn6A
 XRQyCna6NPmLZBBmXvbTTIGG9L1m3darSx/0L/l+iNb+gT44UaORNMXazTlXMCyI
 HWO68EDvIcm/bIMXZw2qnJOwpp36i9+q0/A8Elt0EHg1ExA01c5u0t7Elt7awWE=
 =uGoX
 -----END PGP SIGNATURE-----
 
 --pWyiEgJYm5f9v55/--
>Unformatted:
