[src/trunk]: src/share/man/man9 Remove more references to the old sysctl infr...

[atatat <atatat%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/b91e4a7edb82
branches:  trunk
changeset: 557398:b91e4a7edb82
user:      atatat <atatat%NetBSD.org@localhost>
date:      Wed Jan 07 21:58:27 2004 +0000

description:
Remove more references to the old sysctl infrastructure.

diffstat:

 share/man/man9/uvm.9 |  195 +++++++++++++++++++++++++-------------------------
 1 files changed, 97 insertions(+), 98 deletions(-)

diffs (229 lines):

diff -r aeeb5fa847c9 -r b91e4a7edb82 share/man/man9/uvm.9
--- a/share/man/man9/uvm.9      Wed Jan 07 21:25:14 2004 +0000
+++ b/share/man/man9/uvm.9      Wed Jan 07 21:58:27 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: uvm.9,v 1.52 2003/12/19 09:09:27 pk Exp $
+.\"    $NetBSD: uvm.9,v 1.53 2004/01/07 21:58:27 atatat Exp $
 .\"
 .\" Copyright (c) 1998 Matthew R. Green
 .\" All rights reserved.
@@ -907,10 +907,6 @@
 .br
 .Fn uvm_meter "void" ;
 .Pp
-.Ft int
-.br
-.Fn uvm_sysctl "int *name" "u_int namelen" "void *oldp" "size_t *oldlenp" "void *newp " "size_t newlen" "struct proc *p" ;
-.Pp
 .Ft void
 .br
 .Fn uvm_fork "struct proc *p1" "struct proc *p2" "boolean_t shared" ;
@@ -988,21 +984,108 @@
 .Fn uvm_meter
 calculates the load average and wakes up the swapper if necessary.
 .Pp
-.Fn uvm_sysctl
-provides support for the
+.Fn uvm_fork
+forks a virtual address space for process' (old)
+.Fa p1
+and (new)
+.Fa p2 .
+If the
+.Fa shared
+argument is non zero, p1 shares its address space with p2,
+otherwise a new address space is created.
+This function currently has no return value, and thus cannot fail.
+In the future, this function will be changed to allow it to
+fail in low memory conditions.
+.Pp
+.Fn uvm_grow
+increases the stack segment of process
+.Fa p
+to include
+.Fa sp .
+.Pp
+.Fn uvm_coredump
+generates a coredump on vnode
+.Fa vp
+for process
+.Fa p
+with credentials
+.Fa cred
+and core header description in
+.Fa chdr .
+.Pp
+.Fn uvn_findpages
+looks up or creates pages in
+.Fa uobj
+at offset
+.Fa offset ,
+marks them busy and returns them in the
+.Fa pps
+array.
+Currently
+.Fa uobj
+must be a vnode object.
+The number of pages requested is pointed to by
+.Fa npagesp ,
+and this value is updated with the actual number of pages returned.
+The flags can be
+.Bd -literal
+#define UFP_ALL         0x00    /* return all pages requested */
+#define UFP_NOWAIT      0x01    /* don't sleep */
+#define UFP_NOALLOC     0x02    /* don't allocate new pages */
+#define UFP_NOCACHE     0x04    /* don't return pages which already exist */
+#define UFP_NORDONLY    0x08    /* don't return PG_READONLY pages */
+.Ed
+.Pp
+.Dv UFP_ALL
+is a pseudo-flag meaning all requested pages should be returned.
+.Dv UFP_NOWAIT
+means that we must not sleep.
+.Dv UFP_NOALLOC
+causes any pages which do not already exist to be skipped.
+.Dv UFP_NOCACHE
+causes any pages which do already exist to be skipped.
+.Dv UFP_NORDONLY
+causes any pages which are marked PG_READONLY to be skipped.
+.Pp
+.Fn uvm_swap_stats
+implements the
+.Dv SWAP_STATS
+and
+.Dv SWAP_OSTATS
+operation of the
+.Xr swapctl 2
+system call.
+.Fa cmd
+is the requested command,
+.Dv SWAP_STATS
+or
+.Dv SWAP_OSTATS .
+The function will copy no more than
+.Fa sec
+entries in the array pointed by
+.Fa sep .
+On return,
+.Fa retval
+holds the actual number of entries copied in the array.
+.Sh SYSCTL
+.Pp
+UVM provides support for the
 .Dv CTL_VM
 domain of the
 .Xr sysctl 3
 hierarchy.
-.Fn uvm_sysctl
-handles the
+It handles the
 .Dv VM_LOADAVG ,
-.Dv VM_METER
+.Dv VM_METER ,
+.Dv VM_UVMEXP ,
 and
-.Dv VM_UVMEXP
-calls, which return the current load averages, calculates current VM
-totals, and returns the uvmexp structure respectively.
-The load averages are accessed from userland using the
+.Dv VM_UVMEXP2
+nodes, which return the current load averages, calculates current VM
+totals, returns the uvmexp structure, and a kernel version independent
+view of the uvmexp structure, respectively.
+It also exports a number of tunables that control how much VM space is
+allowed to be consumed by various tasks.
+The load averages are typically accessed from userland using the
 .Xr getloadavg 3
 function.
 The uvmexp structure has all global state of the UVM system,
@@ -1088,90 +1171,6 @@
 int pdpending;  /* number of times daemon got a pending pageout */
 int pddeact;    /* number of pages daemon deactivates */
 .Ed
-.Pp
-.Fn uvm_fork
-forks a virtual address space for process' (old)
-.Fa p1
-and (new)
-.Fa p2 .
-If the
-.Fa shared
-argument is non zero, p1 shares its address space with p2,
-otherwise a new address space is created.
-This function currently has no return value, and thus cannot fail.
-In the future, this function will be changed to allow it to
-fail in low memory conditions.
-.Pp
-.Fn uvm_grow
-increases the stack segment of process
-.Fa p
-to include
-.Fa sp .
-.Pp
-.Fn uvm_coredump
-generates a coredump on vnode
-.Fa vp
-for process
-.Fa p
-with credentials
-.Fa cred
-and core header description in
-.Fa chdr .
-.Pp
-.Fn uvn_findpages
-looks up or creates pages in
-.Fa uobj
-at offset
-.Fa offset ,
-marks them busy and returns them in the
-.Fa pps
-array.
-Currently
-.Fa uobj
-must be a vnode object.
-The number of pages requested is pointed to by
-.Fa npagesp ,
-and this value is updated with the actual number of pages returned.
-The flags can be
-.Bd -literal
-#define UFP_ALL         0x00    /* return all pages requested */
-#define UFP_NOWAIT      0x01    /* don't sleep */
-#define UFP_NOALLOC     0x02    /* don't allocate new pages */
-#define UFP_NOCACHE     0x04    /* don't return pages which already exist */
-#define UFP_NORDONLY    0x08    /* don't return PG_READONLY pages */
-.Ed
-.Pp
-.Dv UFP_ALL
-is a pseudo-flag meaning all requested pages should be returned.
-.Dv UFP_NOWAIT
-means that we must not sleep.
-.Dv UFP_NOALLOC
-causes any pages which do not already exist to be skipped.
-.Dv UFP_NOCACHE
-causes any pages which do already exist to be skipped.
-.Dv UFP_NORDONLY
-causes any pages which are marked PG_READONLY to be skipped.
-.Pp
-.Fn uvm_swap_stats
-implements the
-.Dv SWAP_STATS
-and
-.Dv SWAP_OSTATS
-operation of the
-.Xr swapctl 2
-system call.
-.Fa cmd
-is the requested command,
-.Dv SWAP_STATS
-or
-.Dv SWAP_OSTATS .
-The function will copy no more than
-.Fa sec
-entries in the array pointed by
-.Fa sep .
-On return,
-.Fa retval
-holds the actual number of entries copied in the array.
 .Sh NOTES
 .Fn uvm_chgkprot
 is only available if the kernel has been compiled with options