mdoc(7) police: formatting nits.

Approved by:	re
This commit is contained in:
ru 2002-11-29 15:57:50 +00:00
parent 8bfe544f0a
commit 3f859aa2ab
19 changed files with 94 additions and 64 deletions

View File

@ -64,7 +64,7 @@
The
.Nm
functions are provided for traversing
.Tn UNIX
.Ux
file hierarchies.
A simple overview is that the
.Fn fts_open

View File

@ -117,7 +117,7 @@ in
The control process will return diagnostic
output from the command (unit 2) on this channel, and will also
accept bytes on this channel as being
.Tn UNIX
.Ux
signal numbers, to be
forwarded to the process group of the command.
If

View File

@ -166,7 +166,7 @@ object may be a complex object
and these routines may be the only way to portably reposition a text stream.
.Pp
If the stream is a wide character stream (see
.Xr fwide 3 Ns No ),
.Xr fwide 3 ) ,
the position specified by the combination of
.Fa offset
and

View File

@ -66,7 +66,8 @@ These functions must not call
if it should be necessary to terminate the process while in such a
function, the
.Xr _exit 2
function should be used. (Alternatively, the function may cause abnormal
function should be used.
(Alternatively, the function may cause abnormal
process termination, for example by calling
.Xr abort 3 . )
.Pp

View File

@ -47,19 +47,34 @@
.Sh SYNOPSIS
.In stdlib.h
.Ft void
.Fn qsort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Fo qsort
.Fa "void *base"
.Fa "size_t nmemb"
.Fa "size_t size"
.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
.Fc
.Ft void
.Fo qsort_r
.Fa "void *base"
.Fa "size_t nmemb"
.Fa "size_t size"
.Fa "void *thunk"
.Fa "int (*compar)(void *, const void *, const void *)"
.Fa "int \*[lp]*compar\*[rp]\*[lp]void *, const void *, const void *\*[rp]"
.Fc
.Ft int
.Fn heapsort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Fo heapsort
.Fa "void *base"
.Fa "size_t nmemb"
.Fa "size_t size"
.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
.Fc
.Ft int
.Fn mergesort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Fo mergesort
.Fa "void *base"
.Fa "size_t nmemb"
.Fa "size_t size"
.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
.Fc
.Sh DESCRIPTION
The
.Fn qsort
@ -111,7 +126,7 @@ except that it takes an additional argument,
which is passed unchanged as the first argument to function pointed to
.Fa compar .
This allows the comparison function to access additional
data without using global variables, and thus
data without using global variables, and thus
.Fn qsort_r
is suitable for use in functions which must be reentrant.
.Pp
@ -132,7 +147,9 @@ The
.Fn qsort
and
.Fn qsort_r
functions are an implementation of C.A.R. Hoare's ``quicksort'' algorithm,
functions are an implementation of C.A.R. Hoare's
.Dq quicksort
algorithm,
a variant of partition-exchange sorting; in particular, see D.E. Knuth's
Algorithm Q.
.Sy Quicksort
@ -142,7 +159,9 @@ O N**2 worst-case behavior.
.Pp
The
.Fn heapsort
function is an implementation of J.W.J. William's ``heapsort'' algorithm,
function is an implementation of J.W.J. William's
.Dq heapsort
algorithm,
a variant of selection sorting; in particular, see D.E. Knuth's Algorithm H.
.Sy Heapsort
takes O N lg N worst-case time.

View File

@ -49,7 +49,7 @@ bytes are placed into the array.
.Pp
The format string is composed of zero or more directives:
ordinary characters (not
.Cm % Ns ),
.Cm % ) ,
which are copied unchanged to the output stream; and conversion
specifications, each of which results in fetching zero or more subsequent
arguments.
@ -75,9 +75,9 @@ Do not use grouping characters, regardless of the current locale default.
Represent positive values by prefixing them with a positive sign,
and negative values by prefixing them with a negative sign.
This is the default.
.It Cm (
.It Cm \&(
Enclose negative values in parentheses.
.It Cm !
.It Cm \&!
Do not include a currency symbol in the output.
.It Cm \-
Left justify the result.
@ -124,7 +124,7 @@ returns the number of bytes placed into the array pointed to by
not including the terminating
.Dv NULL
byte.
Otherwise, -1 is returned,
Otherwise, \-1 is returned,
the contents of the array are indeterminate,
and
.Va errno

View File

@ -99,7 +99,7 @@ return
.Fa dst .
The
.Fn stpcpy
function returns a pointer to the terminating
function returns a pointer to the terminating
.Ql \e0
character of
.Fa dst .

View File

@ -65,7 +65,9 @@ The original value of
.Fa *stringp
is returned.
.Pp
An ``empty'' field (i.e., a character in the string
An
.Dq empty
field (i.e., a character in the string
.Fa delim
occurs as the first character of
.Fa *stringp )

View File

@ -456,7 +456,6 @@ The specified extended attribute does not exist.
.It Er 88 EDOOFUS Em "Programming error" .
A function or API is being abused in a way which could only be detected
at run-time.
.El
.Sh DEFINITIONS
.Bl -tag -width Ds

View File

@ -469,7 +469,7 @@ and
.Va tm_sticks
are time counters for user mode and kernel mode execution, respectively.
These counters count ticks of the statistics clock (see
.Xr clocks 7) .
.Xr clocks 7 ) .
While any thread is actively executing in the kernel, the corresponding
.Va tm_sticks
counter is incremented.

View File

@ -106,7 +106,7 @@ otherwise 0.
Returns 1 if synchronised I/O is supported for this file, otherwise 0.
.It Li _PC_ALLOC_SIZE_MIN
Minimum number of bytes of storage allocated for any portion of a file.
.Ar path .
.Fa path .
.It Li _PC_FILESIZEBITS
Number of bits needed to represented the maximum file size.
.It Li _PC_REC_INCR_XFER_SIZE

View File

@ -56,8 +56,11 @@ struct sigaction {
#define sa_sigaction __sigaction_u.__sa_sigaction
.Ed
.Ft int
.Fn sigaction "int sig" "const struct sigaction * restrict act" \
"struct sigaction * restrict oact"
.Fo sigaction
.Fa "int sig"
.Fa "const struct sigaction * restrict act"
.Fa "struct sigaction * restrict oact"
.Fc
.Sh DESCRIPTION
The system defines a set of signals that may be delivered to a process.
Signal delivery resembles the occurrence of a hardware interrupt:

View File

@ -43,8 +43,11 @@
.Sh SYNOPSIS
.In signal.h
.Ft int
.Fn sigprocmask "int how" "const sigset_t * restrict set" \
"sigset_t * restrict oset"
.Fo sigprocmask
.Fa "int how"
.Fa "const sigset_t * restrict set"
.Fa "sigset_t * restrict oset"
.Fc
.Sh DESCRIPTION
The
.Fn sigprocmask

View File

@ -86,7 +86,7 @@ process address space.
.Xr write 2
.Sh BUGS
This call is currently implemented only for the
.Tn UNIX
.Ux
domain.
.Sh HISTORY
The

View File

@ -75,22 +75,21 @@ struct uuid {
uint8_t node[_UUID_NODE_LEN];
};
.Ed
.Pp
.Bl -tag -width _clock_seq_hi_and_reserved_
.It time_low
.Bl -tag -width ".Va clock_seq_hi_and_reserved"
.It Va time_low
The least significant 32 bits of a 60-bit timestamp.
This field is stored in the native byte-order.
.It time_mid
.It Va time_mid
The least significant 16 bits of the most significant 28 bits of the 60-bit
timestamp.
This field is stored in the native byte-order.
.It time_hi_and_reserved
.It Va time_hi_and_reserved
The most significant 12 bits of the 60-bit timestamp multiplexed with a 4-bit
version number.
The version number is stored in the most significant 4 bits of the 16-bit
field.
This field is stored in the native byte-order.
.It clock_seq_hi_and_reserved
.It Va clock_seq_hi_and_reserved
The most significant 6 bits of a 14-bit sequence number multiplexed with a
2-bit variant value.
Note that the width of the variant value is determined by the variant itself.
@ -98,9 +97,9 @@ Identifiers generated by the
.Nm
system call have variant value 10b.
the variant value is stored in the most significant bits of the field.
.It clock_seq_low
.It Va clock_seq_low
The least significant 8 bits of a 14-bit sequence number.
.It node
.It Va node
The 6-byte IEEE 802 (MAC) address of one of the interfaces of the node.
If no such interface exists, a random multi-cast address is used instead.
.El

View File

@ -99,7 +99,7 @@ in
The control process will return diagnostic
output from the command (unit 2) on this channel, and will also
accept bytes on this channel as being
.Tn UNIX
.Ux
signal numbers, to be
forwarded to the process group of the command. The diagnostic
information returned does not include remote authorization failure,

View File

@ -77,7 +77,7 @@ prompts for one as usual.
causes echoing to be left on if
.Nm
prompts for a password.
.It Cm conf Ns No = Ns Ar pathname
.It Cm conf Ns = Ns Ar pathname
specifies a non-standard location for the RADIUS client configuration file
(normally located in
.Pa /etc/radius.conf ) .

View File

@ -108,9 +108,12 @@ return
.Dv PAM_IGNORE
if the specified group (default group of
.Dq Li wheel )
is empty, providing traditional BSD
is empty, providing traditional
.Bx
.Xr su 8
semantics permitting any user to su if the wheel group is empty.
semantics permitting any user to
.Dq su
if the wheel group is empty.
.El
.Sh SEE ALSO
.Xr getlogin 2 ,

View File

@ -114,7 +114,7 @@ in which case the standard configuration file
.Pa /etc/tacplus.conf
is used.
.Fn tac_config
returns 0 on success, or -1 if an error occurs.
returns 0 on success, or \-1 if an error occurs.
.Pp
The library can also be configured programmatically by calls to
.Fn tac_add_server .
@ -148,7 +148,7 @@ confused if the client attempts to negotiate it.
.El
.Pp
.Fn tac_add_server
returns 0 on success, or -1 if an error occurs.
returns 0 on success, or \-1 if an error occurs.
.Pp
.Fn tac_add_server
may be called multiple times, and it may be used together with
@ -168,7 +168,7 @@ and
.Va service
arguments must be set to appropriate values as defined in the
TACACS+ protocol specification. The
.Aq taclib.h
.Aq Pa taclib.h
header file contains symbolic constants for these values.
.Sh CREATING A TACACS+ AUTHORIZATION REQUEST
To begin constructing a new authorization request, call
@ -180,7 +180,7 @@ and
.Va service
arguments must be set to appropriate values as defined in the
TACACS+ protocol specification. The
.Aq taclib.h
.Aq Pa taclib.h
header file contains symbolic constants for these values.
.Sh SETTING OPTIONAL PARAMETERS ON A REQUEST
After creating a request,
@ -199,13 +199,13 @@ privilege level, which defaults to
.Ql USER
privilege.
.Pp
.Fn tac_set_av
.Fn tac_set_av
only applies to the context of an authorization request. The format
for an attribute value pair is defined in the TACACS+ protocol
specification. The index specified can be any value between 0 and
255 inclusive and indicates the position in the list to place the
attribute value pair. Calling
.Fn tac_set_av
attribute value pair. Calling
.Fn tac_set_av
with same index twice effectively replaces the value at that position.
Use
.Fn tac_clear_avs
@ -217,12 +217,12 @@ sent by means of
This function connects to a server if not already connected, sends
the request, and waits for a reply. On failure,
.Fn tac_send_authen
returns -1. Otherwise, it returns the TACACS+ status code and flags,
returns \-1. Otherwise, it returns the TACACS+ status code and flags,
packed into an integer value. The status can be extracted using the
macro
.Fn TAC_AUTHEN_STATUS .
Possible status codes, defined in
.Aq taclib.h ,
.Aq Pa taclib.h ,
include:
.Pp
.Bl -item -compact -offset indent
@ -294,7 +294,7 @@ initial authentication request.
.Pp
When it receives the CONTINUE packet, the server may again request
more information by returning
.Dv TAC_AUTHEN_STATUS_GETDATA ,
.Dv TAC_AUTHEN_STATUS_GETDATA ,
.Dv TAC_AUTHEN_STATUS_GETUSER ,
or
.Dv TAC_AUTHEN_STATUS_GETPASS .
@ -307,12 +307,12 @@ is sent by means of
This function connects to a server if not already connected, sends
the request, and waits for a reply. On failure,
.Fn tac_send_author
returns -1. Otherwise, it returns the TACACS+ status code and
number of attribute value (AV) pairs received packed into an
returns \-1. Otherwise, it returns the TACACS+ status code and
number of attribute value (AV) pairs received packed into an
integer value. The status can be extracted using the macro
.Fn TAC_AUTHOR_STATUS .
Possible status codes, defined in
.Aq taclib.h ,
.Aq Pa taclib.h ,
include:
.Pp
.Bl -item -compact -offset indent
@ -326,10 +326,10 @@ include:
.Dv TAC_AUTHOR_STATUS_ERROR
.El
.Pp
The number of AV pairs received is obtained using
The number of AV pairs received is obtained using
.Fn TAC_AUTHEN_AV_COUNT .
.Sh EXTRACTING INFORMATION FROM THE SERVER'S AUTHORIZATION RESPONSE
Like an authentication response packet, an authorization
Like an authentication response packet, an authorization
response packet from the
server may contain a server message, a data string, or both. Refer
to EXTRACTING INFORMATION FROM THE SERVER'S AUTHENTICATION RESPONSE
@ -341,16 +341,16 @@ attribute value (AV) pairs. To extract these, use
or
.Fn tac_get_av_value .
.Fn tac_get_av
takes the index of the AV pair as it is positioned in the list.
The indexes start at 0 (use
takes the index of the AV pair as it is positioned in the list.
The indexes start at 0 (use
.Fn TAC_AUTHEN_AV_COUNT
on the return value of
.Fn tac_send_author
on the return value of
.Fn tac_send_author
to get the total number of items in this list).
Alternatively,
.Fn tac_get_av_value
can be used.
.Fn tac_get_av_value
Alternatively,
.Fn tac_get_av_value
can be used.
.Fn tac_get_av_value
takes the attribute name and returns the
corresponding value only, not the AV pair. These functions return
dynamically-allocated copies of the information from the packet.
@ -365,18 +365,18 @@ can be retrieved by calling
.Fn tac_strerror .
The message text is overwritten on each new error for the given
.Va struct tac_handle * .
Thus the message must be copied if it is to be preserved through
Thus the message must be copied if it is to be preserved through
subsequent library calls using the same handle.
.Sh CLEANUP
To free the resources used by the TACACS+ library, call
.Fn tac_close .
.Sh RETURN VALUES
The following functions return a non-negative value on success. If
they detect an error, they return -1 and record an error message
they detect an error, they return \-1 and record an error message
which can be retrieved using
.Fn tac_strerror .
.Pp
.Bl -item -offset indent -compact
.Bl -item -offset indent -compact
.It
.Fn tac_add_server
.It
@ -446,8 +446,9 @@ without recording an error message.
.%O draft-grant-tacacs-02.txt (Internet Draft)
.Re
.Sh AUTHORS
.An -nosplit
This software was written by
.An John Polstra ,
.An John Polstra
and
.An Paul Fraley ,
and donated to the