kern/155490: [sysctl][patch] Document some sys/vm sysctls
Galimov Albert
wtfcrap at mail.ru
Sat Mar 12 14:50:12 UTC 2011
>Number: 155490
>Category: kern
>Synopsis: [sysctl][patch] Document some sys/vm sysctls
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-bugs
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sat Mar 12 14:50:11 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator: Galimov Albert
>Release: FreeBSD 9.0-CURRENT #0 r219510
>Organization:
>Environment:
>Description:
Working on documenting sysctls
>How-To-Repeat:
>Fix:
Patch included
Patch attached with submission follows:
Index: sys/vm/vm_meter.c
===================================================================
--- sys/vm/vm_meter.c (revision 219510)
+++ sys/vm/vm_meter.c (working copy)
@@ -55,21 +55,21 @@
struct vmmeter cnt;
SYSCTL_UINT(_vm, VM_V_FREE_MIN, v_free_min,
- CTLFLAG_RW, &cnt.v_free_min, 0, "");
+ CTLFLAG_RW, &cnt.v_free_min, 0, "minimum low-free-pages threshold");
SYSCTL_UINT(_vm, VM_V_FREE_TARGET, v_free_target,
- CTLFLAG_RW, &cnt.v_free_target, 0, "");
+ CTLFLAG_RW, &cnt.v_free_target, 0, "pages desired free");
SYSCTL_UINT(_vm, VM_V_FREE_RESERVED, v_free_reserved,
- CTLFLAG_RW, &cnt.v_free_reserved, 0, "");
+ CTLFLAG_RW, &cnt.v_free_reserved, 0, "pages reserved for deadlock");
SYSCTL_UINT(_vm, VM_V_INACTIVE_TARGET, v_inactive_target,
- CTLFLAG_RW, &cnt.v_inactive_target, 0, "");
+ CTLFLAG_RW, &cnt.v_inactive_target, 0, "pages desired inactive");
SYSCTL_UINT(_vm, VM_V_CACHE_MIN, v_cache_min,
- CTLFLAG_RW, &cnt.v_cache_min, 0, "");
+ CTLFLAG_RW, &cnt.v_cache_min, 0, "min pages desired on cache queue");
SYSCTL_UINT(_vm, VM_V_CACHE_MAX, v_cache_max,
- CTLFLAG_RW, &cnt.v_cache_max, 0, "");
+ CTLFLAG_RW, &cnt.v_cache_max, 0, "max pages in cached obj");
SYSCTL_UINT(_vm, VM_V_PAGEOUT_FREE_MIN, v_pageout_free_min,
- CTLFLAG_RW, &cnt.v_pageout_free_min, 0, "");
+ CTLFLAG_RW, &cnt.v_pageout_free_min, 0, "min pages reserved for kernel");
SYSCTL_UINT(_vm, OID_AUTO, v_free_severe,
- CTLFLAG_RW, &cnt.v_free_severe, 0, "");
+ CTLFLAG_RW, &cnt.v_free_severe, 0, "severe page depletion point");
static int
sysctl_vm_loadavg(SYSCTL_HANDLER_ARGS)
@@ -320,41 +320,41 @@
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_tcached, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
&cnt.v_tcached, 0, vcnt, "IU", "Total pages cached");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_dfree, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_dfree, 0, vcnt, "IU", "");
+ &cnt.v_dfree, 0, vcnt, "IU", "pages freed by daemon");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_pfree, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_pfree, 0, vcnt, "IU", "");
+ &cnt.v_pfree, 0, vcnt, "IU", "pages freed by exiting processes");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_tfree, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_tfree, 0, vcnt, "IU", "");
+ &cnt.v_tfree, 0, vcnt, "IU", "total pages freed");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_page_size, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_page_size, 0, vcnt, "IU", "");
+ &cnt.v_page_size, 0, vcnt, "IU", "page size in bytes");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_page_count, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_page_count, 0, vcnt, "IU", "");
+ &cnt.v_page_count, 0, vcnt, "IU", "total number of pages in system");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_free_reserved, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_free_reserved, 0, vcnt, "IU", "");
+ &cnt.v_free_reserved, 0, vcnt, "IU", "pages reserved for deadlock");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_free_target, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_free_target, 0, vcnt, "IU", "");
+ &cnt.v_free_target, 0, vcnt, "IU", "pages desired free");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_free_min, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_free_min, 0, vcnt, "IU", "");
+ &cnt.v_free_min, 0, vcnt, "IU", "minimum low-free-pages threshold");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_free_count, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_free_count, 0, vcnt, "IU", "");
+ &cnt.v_free_count, 0, vcnt, "IU", "pages free");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_wire_count, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_wire_count, 0, vcnt, "IU", "");
+ &cnt.v_wire_count, 0, vcnt, "IU", "pages wired down");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_active_count, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_active_count, 0, vcnt, "IU", "");
+ &cnt.v_active_count, 0, vcnt, "IU", "pages active");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_inactive_target, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_inactive_target, 0, vcnt, "IU", "");
+ &cnt.v_inactive_target, 0, vcnt, "IU", "pages desired inactive");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_inactive_count, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_inactive_count, 0, vcnt, "IU", "");
+ &cnt.v_inactive_count, 0, vcnt, "IU", "pages inactive");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_cache_count, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_cache_count, 0, vcnt, "IU", "");
+ &cnt.v_cache_count, 0, vcnt, "IU", "pages on cache queue");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_cache_min, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_cache_min, 0, vcnt, "IU", "");
+ &cnt.v_cache_min, 0, vcnt, "IU", "min pages desired on cache queue");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_cache_max, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_cache_max, 0, vcnt, "IU", "");
+ &cnt.v_cache_max, 0, vcnt, "IU", "max pages in cached obj");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_pageout_free_min, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_pageout_free_min, 0, vcnt, "IU", "");
+ &cnt.v_pageout_free_min, 0, vcnt, "IU", "min pages reserved for kernel");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_interrupt_free_min, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
- &cnt.v_interrupt_free_min, 0, vcnt, "IU", "");
+ &cnt.v_interrupt_free_min, 0, vcnt, "IU", "reserved pages for interrupt code");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_forks, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
&cnt.v_forks, 0, vcnt, "IU", "Number of fork() calls");
SYSCTL_PROC(_vm_stats_vm, OID_AUTO, v_vforks, CTLTYPE_UINT|CTLFLAG_RD|CTLFLAG_MPSAFE,
@@ -373,4 +373,4 @@
&cnt.v_kthreadpages, 0, vcnt, "IU", "VM pages affected by fork() by kernel");
SYSCTL_INT(_vm_stats_misc, OID_AUTO,
- zero_page_count, CTLFLAG_RD, &vm_page_zero_count, 0, "");
+ zero_page_count, CTLFLAG_RD, &vm_page_zero_count, 0, "Number of zero-ed free pages");
>Release-Note:
>Audit-Trail:
>Unformatted:
More information about the freebsd-bugs
mailing list