Module Name: src
Committed By: christos
Date: Sun Sep 15 01:03:24 UTC 2019
Modified Files:
src/lib/libc/gen: sysctl.3
Log Message:
fix wrong names and add markup
To generate a diff of this commit:
cvs rdiff -u -r1.204 -r1.205 src/lib/libc/gen/sysctl.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/gen/sysctl.3
diff -u src/lib/libc/gen/sysctl.3:1.204 src/lib/libc/gen/sysctl.3:1.205
--- src/lib/libc/gen/sysctl.3:1.204 Thu Sep 6 05:28:00 2018
+++ src/lib/libc/gen/sysctl.3 Sat Sep 14 21:03:23 2019
@@ -1,4 +1,4 @@
-.\" $NetBSD: sysctl.3,v 1.204 2018/09/06 09:28:00 maxv Exp $
+.\" $NetBSD: sysctl.3,v 1.205 2019/09/15 01:03:23 christos Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)sysctl.3 8.4 (Berkeley) 5/9/95
.\"
-.Dd September 6, 2018
+.Dd September 14, 2019
.Dt SYSCTL 3
.Os
.Sh NAME
@@ -330,7 +330,8 @@ Querying the tree to discover the name t
dynamic discovery of all the data that the tree currently has
instrumented.
For example, to discover all the nodes below the
-CTL_VFS node:
+.Dv CTL_VFS
+node:
.Pp
.Bd -literal -offset indent -compact
struct sysctlnode query, vfs[128];
@@ -356,7 +357,11 @@ version be explicitly specified.
.Pp
Creation and destruction of nodes works by constructing part of a new
node description (or a description of the existing node) and invoking
-CTL_CREATE (or CTL_CREATESYM) or CTL_DESTROY at the parent of the new
+.Dv CTL_CREATE
+(or
+.Dv CTL_CREATESYM ) or
+.Dv CTL_DESTROY
+at the parent of the new
node, with a pointer to the new node passed via the
.Fa new
and
@@ -374,7 +379,11 @@ The minimum requirements for creating a
.Fa sysctl_flags
to indicate the new node's type,
.Fa sysctl_num
-to either the new node's number (or CTL_CREATE or CTL_CREATESYM if a
+to either the new node's number (or
+.Dv CTL_CREATE
+or
+.Dv CTL_CREATESYM
+if a
dynamically allocated MIB number is acceptable),
.Fa sysctl_size
to the size of the data to be instrumented (which must agree with the
@@ -389,7 +398,9 @@ will vary depending on what is to be ins
If existing kernel data is to be covered by this new node, its address
should be given in
.Fa sysctl_data
-or, if CTL_CREATESYM is used,
+or, if
+.Dv CTL_CREATESYM
+is used,
.Fa sysctl_data
should be set to a string containing its name from the kernel's symbol
table.
@@ -398,10 +409,13 @@ the new integer or quad type data should
.Fa sysctl_idata
or
.Fa sysctl_qdata ,
-respectively, along with the SYSCTL_IMMEDIATE flag being set, or
+respectively, along with the
+.Dv CTLFLAG_IMMEDIATE
+flag being set, or
.Fa sysctl_data
should be set to point to a copy of the new data, and the
-SYSCTL_OWNDATA flag must be set.
+.Dv CTLFLAG_OWNDATA
+flag must be set.
This latter method is the only way that new string and struct type
nodes can be initialized.
Invalid kernel addresses are accepted, but any attempt to access those
