From 615a6a246a8cac15992a2778449e45acc555bf7b Mon Sep 17 00:00:00 2001 From: ru Date: Thu, 1 Jul 2004 18:20:57 +0000 Subject: Markup, grammar, punctuation. --- lib/libgeom/libgeom.3 | 72 +++++++++++++++++------------- lib/libkvm/kvm_getprocs.3 | 28 ++++++------ lib/libpam/modules/pam_radius/pam_radius.8 | 4 +- lib/libpam/modules/pam_self/pam_self.8 | 2 +- lib/libugidfw/bsde_get_rule.3 | 4 +- lib/libugidfw/libugidfw.3 | 2 +- lib/msun/man/fabs.3 | 8 ++-- lib/msun/man/hypot.3 | 10 ++--- lib/msun/man/ieee.3 | 2 + 9 files changed, 73 insertions(+), 59 deletions(-) (limited to 'lib') diff --git a/lib/libgeom/libgeom.3 b/lib/libgeom/libgeom.3 index e141345..0c142ed 100644 --- a/lib/libgeom/libgeom.3 +++ b/lib/libgeom/libgeom.3 @@ -27,7 +27,7 @@ .\" .\" $FreeBSD$ .\" -.Dd February 8, 2003 +.Dd March 7, 2004 .Dt LIBGEOM 3 .Os .Sh NAME @@ -151,12 +151,13 @@ if there are no more items in the snapshot. .Ss "Control Functions" The .Fn gctl_* -functions are used to send requests to GEOM classes. In order for a GEOM +functions are used to send requests to GEOM classes. +In order for a GEOM class to actually be able to receive these requests, it must have defined a "ctlreq" method. .Pp A -.Ar struct gctl_req * , +.Vt "struct gctl_req *" , obtained with .Fn gctl_get_handle , can hold any number of parameters, which must be added to it with @@ -170,56 +171,69 @@ Both and .Fn gctl_rw_param take a string -.Ar name , +.Fa name , which is used to identify the parameter, and a -.Ar value , -which contains - in the read-only case - the data to be passed to the -GEOM class, or - in the read/write case - a pointer to preallocated memory -that the GEOM class should fill with the desired data. If -.Ar len +.Fa value , +which contains, in the read-only case, the data to be passed to the +GEOM class, or, in the read/write case, a pointer to preallocated memory +that the GEOM class should fill with the desired data. +If +.Fa len is negative, it is assumed that -.Ar value -is an ASCII string and the actual length is taken from the string length of -.Ar value ; +.Fa value +is an +.Tn ASCII +string and the actual length is taken from the string length of +.Fa value ; otherwise it must hold the size of -.Ar value . +.Fa value . .Pp A parameter with a -.Ar name -containing the string "class" is mandatory for each request, and the +.Fa name +containing the string +.Qq Li class +is mandatory for each request, and the corresponding -.Ar value +.Fa value must hold the name of the GEOM class where the request should be sent to. .Pp Also mandatory for each request is a parameter with a -.Ar name -called "verb", and the corresponding -.Ar value +.Fa name +called +.Qq Li verb , +and the corresponding +.Fa value needs to hold the command string that the GEOM class should react upon. .Pp Once all desired parameters are filled in, the request must be sent to the GEOM subsystem with .Fn gctl_issue , -which returns NULL on success, or a string containing the error message +which returns +.Dv NULL +on success, or a string containing the error message on failure. .Pp After the request is finished, the allocated memory should be released with .Fn gctl_free . .Pp +The .Fn gctl_dump +function can be used to format the contents of -.Ar req +.Fa req to the open file handle pointed to by -.Ar f +.Fa f , for debugging purposes. .Pp Error handling for the control functions is postponed until the call -to -.Fn gctl_issue -which returns NULL on success or an error message corresponding to the +to +.Fn gctl_issue , +which returns +.Dv NULL +on success, or an error message corresponding to the first error which happened. .Sh EXAMPLES -Create a request that is to be sent to the CCD class and tell +Create a request that is to be sent to the CCD class, and tell it to destroy a specific geom: .Bd -literal -offset indent H = gctl_get_handle(); @@ -229,13 +243,11 @@ sprintf(buf, "ccd%d", ccd); gctl_ro_param(H, "geom", -1, buf); errstr = gctl_issue(H); if (errstr != NULL) - err(1, "Could not destroy ccd: %s", errstr); + err(1, "could not destroy ccd: %s", errstr); gctl_free(H); .Ed .Sh SEE ALSO -.Rs -http://ezine.daemonnews.org/200308/blueprints.html -.Re +.Pa http://ezine.daemonnews.org/200308/blueprints.html .Sh HISTORY The .Nm geom diff --git a/lib/libkvm/kvm_getprocs.3 b/lib/libkvm/kvm_getprocs.3 index 50b1aa9..b2703a1 100644 --- a/lib/libkvm/kvm_getprocs.3 +++ b/lib/libkvm/kvm_getprocs.3 @@ -73,31 +73,31 @@ returned. The value of describes the filtering predicate as follows: .Pp .Bl -tag -width 20n -offset indent -compact -.It Sy KERN_PROC_ALL +.It Dv KERN_PROC_ALL all processes and kernel visible threads -.It Sy KERN_PROC_PROC +.It Dv KERN_PROC_PROC all processes, without threads -.It Sy KERN_PROC_PID -processes with process id +.It Dv KERN_PROC_PID +processes with process ID .Fa arg -.It Sy KERN_PROC_PGRP +.It Dv KERN_PROC_PGRP processes with process group .Fa arg -.It Sy KERN_PROC_SESSION +.It Dv KERN_PROC_SESSION processes with session .Fa arg -.It Sy KERN_PROC_TTY -processes with tty +.It Dv KERN_PROC_TTY +processes with TTY .Fa arg -.It Sy KERN_PROC_UID -processes with effective user id +.It Dv KERN_PROC_UID +processes with effective user ID .Fa arg -.It Sy KERN_PROC_RUID -processes with real user id +.It Dv KERN_PROC_RUID +processes with real user ID .Fa arg -.It Sy KERN_PROC_INC_THREAD +.It Dv KERN_PROC_INC_THREAD modifier to return all kernel visible threads when filtering -by process id, process group, tty, user id, and real user id +by process ID, process group, TTY, user ID, and real user ID .El .Pp The number of processes found is returned in the reference parameter diff --git a/lib/libpam/modules/pam_radius/pam_radius.8 b/lib/libpam/modules/pam_radius/pam_radius.8 index 519f07e..27ec9f6 100644 --- a/lib/libpam/modules/pam_radius/pam_radius.8 +++ b/lib/libpam/modules/pam_radius/pam_radius.8 @@ -81,9 +81,9 @@ prompts for a password. specifies a non-standard location for the RADIUS client configuration file (normally located in .Pa /etc/radius.conf ) . -.It Cm nas_id Ns No = Ns Ar identifier +.It Cm nas_id Ns = Ns Ar identifier specifies a NAS identifier to send instead of the hostname. -.It Cm template_user Ns No = Ns Ar username +.It Cm template_user Ns = Ns Ar username specifies a user whose .Xr passwd 5 entry will be used as a template to create the session environment diff --git a/lib/libpam/modules/pam_self/pam_self.8 b/lib/libpam/modules/pam_self/pam_self.8 index 5bcc0ab..2c0bab0 100644 --- a/lib/libpam/modules/pam_self/pam_self.8 +++ b/lib/libpam/modules/pam_self/pam_self.8 @@ -61,7 +61,7 @@ The Self authentication component .Pq Fn pam_sm_authenticate , returns success if and only if the target user's user ID is identical with the current real user ID. -If the current real user ID is zero authentication will fail, +If the current real user ID is zero, authentication will fail, unless the .Cm allow_root option was specified. diff --git a/lib/libugidfw/bsde_get_rule.3 b/lib/libugidfw/bsde_get_rule.3 index 10bbb7c..6998753 100644 --- a/lib/libugidfw/bsde_get_rule.3 +++ b/lib/libugidfw/bsde_get_rule.3 @@ -79,7 +79,9 @@ characters, including the terminating .Dv NUL ) . If successful and .Fa rulenum -is non-NULL, the rule number used will be returned in +is +.No non- Ns Dv NULL , +the rule number used will be returned in .Fa *rulenum . .Pp The diff --git a/lib/libugidfw/libugidfw.3 b/lib/libugidfw/libugidfw.3 index c5a3c7e..9b04a3e 100644 --- a/lib/libugidfw/libugidfw.3 +++ b/lib/libugidfw/libugidfw.3 @@ -30,7 +30,7 @@ .\" .\" $FreeBSD$ .\" -.Dd January 5, 2003 +.Dd February 25, 2004 .Os .Dt LIBUGIDFW 3 .Sh NAME diff --git a/lib/msun/man/fabs.3 b/lib/msun/man/fabs.3 index 4b8cb08..9d93484 100644 --- a/lib/msun/man/fabs.3 +++ b/lib/msun/man/fabs.3 @@ -54,18 +54,16 @@ .Sh DESCRIPTION The .Fn fabs , -the .Fn fabsf -and the +and .Fn fabsl functions compute the absolute value of a floating-point number .Fa x . .Sh RETURN VALUES The .Fn fabs , -the .Fn fabsf -and the +and .Fn fabsl functions return the absolute value of .Fa x . @@ -83,7 +81,7 @@ function conforms to .St -isoC . The .Fn fabsf -and the +and .Fn fabsl functions conform to .St -isoC-99 . diff --git a/lib/msun/man/hypot.3 b/lib/msun/man/hypot.3 index b866940..3124578 100644 --- a/lib/msun/man/hypot.3 +++ b/lib/msun/man/hypot.3 @@ -69,13 +69,13 @@ The and .Fn cabsf functions compute the complex absolute value of -.Ar z . +.Fa z . .Pp .Fn hypot "\*(If" "v" = .Fn hypot "v" "\*(If" = +\*(If for all -.Ar v , +.Fa v , including \*(Na. .Sh ERROR (due to Roundoff, etc.) Below 0.97 @@ -98,7 +98,7 @@ and .Fn hypot "\*(Na" "v" are \*(Na for all .Em finite -.Ar v ; +.Fa v ; with "reserved operand" in place of "\*(Na", the same is true on a .Tn VAX . @@ -113,12 +113,12 @@ This is intentional; it happens because = +\*(If for .Em all -.Ar v , +.Fa v , finite or infinite. Hence .Fn hypot "\*(If" "v" is independent of -.Ar v . +.Fa v . Unlike the reserved operand fault on a .Tn VAX , the diff --git a/lib/msun/man/ieee.3 b/lib/msun/man/ieee.3 index 9cd9e94..7b9f0ac 100644 --- a/lib/msun/man/ieee.3 +++ b/lib/msun/man/ieee.3 @@ -90,10 +90,12 @@ These functions are required or recommended by .St -ieee754 . .Pp +The .Fn copysign , .Fn copysignf and .Fn copysignl +functions return .Fa x with its sign changed to -- cgit v1.1