Date: Sat, 12 Mar 2011 14:43:29 GMT From: Galimov Albert <wtfcrap@mail.ru> To: freebsd-gnats-submit@FreeBSD.org Subject: kern/155490: [sysctl][patch] Document some sys/vm sysctls Message-ID: <201103121443.p2CEhTrk099545@red.freebsd.org> Resent-Message-ID: <201103121450.p2CEoBpX045647@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201103121443.p2CEhTrk099545>