mdoc(7) police: formatting nits.
Approved by: re
This commit is contained in:
parent
b7c8a7976f
commit
1798791d24
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=107387
@ -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
|
||||
|
@ -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
|
||||
|
@ -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
|
||||
|
@ -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
|
||||
|
@ -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.
|
||||
|
@ -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
|
||||
|
@ -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 .
|
||||
|
@ -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 )
|
||||
|
@ -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
|
||||
|
@ -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.
|
||||
|
@ -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
|
||||
|
@ -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:
|
||||
|
@ -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
|
||||
|
@ -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
|
||||
|
@ -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
|
||||
|
@ -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,
|
||||
|
@ -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 ) .
|
||||
|
@ -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 ,
|
||||
|
@ -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
|
||||
|
Loading…
Reference in New Issue
Block a user