From owner-freebsd-doc@FreeBSD.ORG Fri Jul 16 12:50:03 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 82A591065674 for ; Fri, 16 Jul 2010 12:50:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 616EB8FC1C for ; Fri, 16 Jul 2010 12:50:03 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o6GCo3i1026233 for ; Fri, 16 Jul 2010 12:50:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o6GCo3UJ026226; Fri, 16 Jul 2010 12:50:03 GMT (envelope-from gnats) Resent-Date: Fri, 16 Jul 2010 12:50:03 GMT Resent-Message-Id: <201007161250.o6GCo3UJ026226@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Galimov Albert Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 746F0106564A for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/148680: [sysctl][patch] Document some sys/kern sysctls X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Jul 2010 12:50:03 -0000 >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: >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: >Unformatted: