diff options
| author | Philip Guenthe <guenther@cvs.openbsd.org> | 2010-01-14 22:25:06 +0000 |
|---|---|---|
| committer | Philip Guenthe <guenther@cvs.openbsd.org> | 2010-01-14 22:25:06 +0000 |
| commit | 4fae72fbe227311eae86baa97678fa0d8047ba20 (patch) | |
| tree | 76b7690bb643a4c791de33e3fd4376a8f469b1ca /lib/libc | |
| parent | 8f69c960bcd7dc2f71af6ec2327d311faf603455 (diff) | |
Document hw.ncpufound and HW_NCPUFOUND.
Document the interpretation of the third and fourth levels of KERN_FILE2.
Document that KERN_FILE and KERN_PROC are deprecated in favor of
KERN_FILE2 and KERN_PROC2.
ok and tweaks jmc@
Diffstat (limited to 'lib/libc')
| -rw-r--r-- | lib/libc/gen/sysctl.3 | 25 |
1 files changed, 22 insertions, 3 deletions
diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3 index 143de821d58..0ccccc9d63b 100644 --- a/lib/libc/gen/sysctl.3 +++ b/lib/libc/gen/sysctl.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sysctl.3,v 1.191 2010/01/03 16:43:45 schwarze Exp $ +.\" $OpenBSD: sysctl.3,v 1.192 2010/01/14 22:25:05 guenther Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: January 3 2010 $ +.Dd $Mdocdate: January 14 2010 $ .Dt SYSCTL 3 .Os .Sh NAME @@ -298,6 +298,7 @@ privileges may change the value. .It Dv HW_MACHINE No " string no" .It Dv HW_MODEL No " string no" .It Dv HW_NCPU No " integer no" +.It Dv HW_NCPUFOUND No " integer no" .It Dv HW_PAGESIZE No " integer no" .It Dv HW_PHYSMEM No " integer no" .It Dv HW_PHYSMEM64 No " int64_t no" @@ -330,7 +331,9 @@ The machine class. .It Dv HW_MODEL The machine model. .It Dv HW_NCPU -The number of CPUs. +The number of CPUs being used. +.It Dv HW_NCPUFOUND +The number of CPUs found. .It Dv HW_PAGESIZE The software page size. .It Dv HW_PHYSMEM @@ -548,6 +551,10 @@ Note that using this interface exposes duplicate entries which are consolidated by the userland frontend. .It Dv KERN_FILE Return the entire file table. +This name is deprecated, as the layout of the returned structures +is not a stable ABI; use +.Dv KERN_FILE2 +instead. The returned data consists of a single .Li struct filehead followed by an array of @@ -559,6 +566,14 @@ Like but an array of .Li struct kinfo_file2 structures is returned. +The third and fourth level names are as follows: +.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent +.It Sy Third level name Fourth level is: +.It Dv KERN_FILE_BYFILE No " Zero" +.It Dv KERN_FILE_BYPID No " A process ID" +.It Dv KERN_FILE_BYUID No " A user ID" +.El +.Pp The fifth level name is the size of the .Li struct kinfo_file2 and the sixth level name is the number of structures to return. @@ -685,6 +700,10 @@ The version of ISO/IEC 9945 (POSIX 1003.1) with which the system attempts to comply. .It Dv KERN_PROC Return the entire process table, or a subset of it. +This name is deprecated, as the layout of the returned structures +is not a stable ABI; use +.Dv KERN_PROC2 +instead. An array of .Li struct kinfo_proc structures is returned, |