Assorted markup fixes.
Approved by: re
This commit is contained in:
parent
88a2c1983d
commit
f789cb8293
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=147402
@ -222,7 +222,8 @@ shardump archives less portable than plain shar archives.
|
|||||||
.El
|
.El
|
||||||
.Ss ISO9660 format
|
.Ss ISO9660 format
|
||||||
Libarchive can read and extract from files containing ISO9660-compliant
|
Libarchive can read and extract from files containing ISO9660-compliant
|
||||||
CDROM images. It also has partial support for Rockridge extensions.
|
CDROM images.
|
||||||
|
It also has partial support for Rockridge extensions.
|
||||||
In many cases, this can remove the need to burn a physical CDROM.
|
In many cases, this can remove the need to burn a physical CDROM.
|
||||||
It also avoids security and complexity issues that come with
|
It also avoids security and complexity issues that come with
|
||||||
virtual mounts and loopback devices.
|
virtual mounts and loopback devices.
|
||||||
|
@ -191,7 +191,7 @@ This format is often called the
|
|||||||
format, after the magic value used
|
format, after the magic value used
|
||||||
in the header.
|
in the header.
|
||||||
(The name is an acronym for
|
(The name is an acronym for
|
||||||
.Dq Unix Standard TAR. )
|
.Dq Unix Standard TAR . )
|
||||||
It extends the historic format with new fields:
|
It extends the historic format with new fields:
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
struct header_posix_ustar {
|
struct header_posix_ustar {
|
||||||
|
@ -180,7 +180,8 @@ return the offset request associated with the request
|
|||||||
(used for readdir request)
|
(used for readdir request)
|
||||||
.It Fn autoreq_getxid
|
.It Fn autoreq_getxid
|
||||||
return the transaction id associated with an autofs request, these
|
return the transaction id associated with an autofs request, these
|
||||||
are unique per mount point, but not system wide. They can be used
|
are unique per mount point, but not system wide.
|
||||||
|
They can be used
|
||||||
for debugging to ensure requests are being accepted by the kernel.
|
for debugging to ensure requests are being accepted by the kernel.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
@ -197,11 +198,14 @@ this is typically unused.
|
|||||||
.It Fn autoreq_seterrno
|
.It Fn autoreq_seterrno
|
||||||
set the error returned to the application sending the request, typically
|
set the error returned to the application sending the request, typically
|
||||||
this is left alone, or set to ENOENT if the request is for a non-existant
|
this is left alone, or set to ENOENT if the request is for a non-existant
|
||||||
name. The default error is no error. Meaning the application will see
|
name.
|
||||||
|
The default error is no error.
|
||||||
|
Meaning the application will see
|
||||||
a successful return.
|
a successful return.
|
||||||
.It Fn autoreq_setaux
|
.It Fn autoreq_setaux
|
||||||
used to set the auxilliray data for a request, currently used to set
|
used to set the auxilliray data for a request, currently used to set
|
||||||
the dirent structures for serving a readdir request. Default is no
|
the dirent structures for serving a readdir request.
|
||||||
|
Default is no
|
||||||
auxilliary data.
|
auxilliary data.
|
||||||
.It Fn autoreq_seteof
|
.It Fn autoreq_seteof
|
||||||
used to set the eof flag for readdir requests (default is not eof.)
|
used to set the eof flag for readdir requests (default is not eof.)
|
||||||
@ -217,11 +221,13 @@ directory via
|
|||||||
.Fa path
|
.Fa path
|
||||||
and
|
and
|
||||||
.Fa fd
|
.Fa fd
|
||||||
respectively. The
|
respectively.
|
||||||
|
The
|
||||||
.Fa pid
|
.Fa pid
|
||||||
argument should be set to the pid of the process serving
|
argument should be set to the pid of the process serving
|
||||||
.Xr autofs 9
|
.Xr autofs 9
|
||||||
requests, or -1 to disable the option. The options are
|
requests, or -1 to disable the option.
|
||||||
|
The options are
|
||||||
.Bl -tag -width AUTO_INDIRECT
|
.Bl -tag -width AUTO_INDIRECT
|
||||||
.It Fa AUTO_MOUNTER
|
.It Fa AUTO_MOUNTER
|
||||||
set this process as the one responsible for the
|
set this process as the one responsible for the
|
||||||
@ -237,11 +243,13 @@ and
|
|||||||
will be routed to userland after the current actual directory contents
|
will be routed to userland after the current actual directory contents
|
||||||
are read into userland.
|
are read into userland.
|
||||||
.It Fa AUTO_DIRECT
|
.It Fa AUTO_DIRECT
|
||||||
Set the directory as a mount trigger. Any request to enter the directory
|
Set the directory as a mount trigger.
|
||||||
|
Any request to enter the directory
|
||||||
will trigger a callback into the process
|
will trigger a callback into the process
|
||||||
.Fa pid .
|
.Fa pid .
|
||||||
.It Fa AUTO_INDIRECT
|
.It Fa AUTO_INDIRECT
|
||||||
Set the directory as an indirect trigger. Any request for an entry inside
|
Set the directory as an indirect trigger.
|
||||||
|
Any request for an entry inside
|
||||||
the directory will be routed to the process identified by
|
the directory will be routed to the process identified by
|
||||||
.Fa pid .
|
.Fa pid .
|
||||||
.El
|
.El
|
||||||
|
@ -454,20 +454,26 @@ whose size depends on the current number of such objects in the system.
|
|||||||
.It "KERN_PROC_RUID A real user ID"
|
.It "KERN_PROC_RUID A real user ID"
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
If the third level name is KERN_PROC_ARGS then the command line argument
|
If the third level name is
|
||||||
|
.Dv KERN_PROC_ARGS
|
||||||
|
then the command line argument
|
||||||
array is returned in a flattened form, i.e., zero-terminated arguments
|
array is returned in a flattened form, i.e., zero-terminated arguments
|
||||||
follow each other.
|
follow each other.
|
||||||
The total size of array is returned.
|
The total size of array is returned.
|
||||||
It is also possible for a process to set its own process title this way.
|
It is also possible for a process to set its own process title this way.
|
||||||
If the third level name is KERN_PROC_PATHNAME, the path of the
|
If the third level name is
|
||||||
|
.Dv KERN_PROC_PATHNAME ,
|
||||||
|
the path of the
|
||||||
process' text file is stored.
|
process' text file is stored.
|
||||||
For KERN_PROC_PATHNAME, a process ID of
|
For
|
||||||
.Li -1
|
.Dv KERN_PROC_PATHNAME ,
|
||||||
|
a process ID of
|
||||||
|
.Li \-1
|
||||||
implies the current process.
|
implies the current process.
|
||||||
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
|
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
|
||||||
.It Sy "Third level name Fourth level is:"
|
.It Sy "Third level name Fourth level is:"
|
||||||
.It "KERN_PROC_ARGS A process ID"
|
.It Dv KERN_PROC_ARGS Ta "A process ID"
|
||||||
.It "KERN_PROC_PATHNAME A process ID"
|
.It Dv KERN_PROC_PATHNAME Ta "A process ID"
|
||||||
.El
|
.El
|
||||||
.It Li KERN_PROF
|
.It Li KERN_PROF
|
||||||
Return profiling information about the kernel.
|
Return profiling information about the kernel.
|
||||||
|
@ -85,10 +85,14 @@ a file descriptor for which
|
|||||||
.Fn isatty
|
.Fn isatty
|
||||||
is true.
|
is true.
|
||||||
.Pp
|
.Pp
|
||||||
|
The
|
||||||
.Fn ttyname
|
.Fn ttyname
|
||||||
|
function
|
||||||
returns the name stored in a static buffer which will be overwritten
|
returns the name stored in a static buffer which will be overwritten
|
||||||
on subsequent calls.
|
on subsequent calls.
|
||||||
|
The
|
||||||
.Fn ttyname_r
|
.Fn ttyname_r
|
||||||
|
function
|
||||||
takes a buffer and length as arguments to avoid this problem.
|
takes a buffer and length as arguments to avoid this problem.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -109,40 +113,49 @@ a
|
|||||||
pointer is returned.
|
pointer is returned.
|
||||||
The
|
The
|
||||||
.Fn ttyname_r
|
.Fn ttyname_r
|
||||||
function returns 0 if successful. Otherwise an error number is returned.
|
function returns 0 if successful.
|
||||||
|
Otherwise an error number is returned.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn ttyslot
|
.Fn ttyslot
|
||||||
function
|
function
|
||||||
returns the unit number of the device file if found; otherwise
|
returns the unit number of the device file if found; otherwise
|
||||||
the value zero is returned.
|
the value zero is returned.
|
||||||
.Sh ERRORS
|
|
||||||
.Fn ttyname_r
|
|
||||||
may return the following error codes:
|
|
||||||
.Bl -tag -width Er
|
|
||||||
.It Bq Er ENOTTY
|
|
||||||
.Fa fd
|
|
||||||
is not a valid file descriptor.
|
|
||||||
.It Bq Er ERANGE
|
|
||||||
.Fa bufsize
|
|
||||||
is smaller than the length of the string to be returned.
|
|
||||||
.Sh FILES
|
.Sh FILES
|
||||||
.Bl -tag -width /etc/ttys -compact
|
.Bl -tag -width ".Pa /etc/ttys" -compact
|
||||||
.It Pa /dev/\(**
|
.It Pa /dev/\(**
|
||||||
.It Pa /etc/ttys
|
.It Pa /etc/ttys
|
||||||
.El
|
.El
|
||||||
|
.Sh ERRORS
|
||||||
|
The
|
||||||
|
.Fn ttyname_r
|
||||||
|
may fail and return the following error codes:
|
||||||
|
.Bl -tag -width Er
|
||||||
|
.It Bq Er ENOTTY
|
||||||
|
The
|
||||||
|
.Fa fd
|
||||||
|
argument
|
||||||
|
is not a valid file descriptor.
|
||||||
|
.It Bq Er ERANGE
|
||||||
|
The
|
||||||
|
.Fa bufsize
|
||||||
|
argument
|
||||||
|
is smaller than the length of the string to be returned.
|
||||||
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr ioctl 2 ,
|
.Xr ioctl 2 ,
|
||||||
.Xr ttys 5
|
.Xr ttys 5
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
A
|
The
|
||||||
.Fn isatty ,
|
.Fn isatty ,
|
||||||
.Fn ttyname ,
|
.Fn ttyname ,
|
||||||
and
|
and
|
||||||
.Fn ttyslot
|
.Fn ttyslot
|
||||||
function
|
functions
|
||||||
appeared in
|
appeared in
|
||||||
.At v7 .
|
.At v7 .
|
||||||
|
The
|
||||||
.Fn ttyname_r
|
.Fn ttyname_r
|
||||||
|
function
|
||||||
appeared in
|
appeared in
|
||||||
.Fx 6.0 .
|
.Fx 6.0 .
|
||||||
|
@ -30,8 +30,10 @@
|
|||||||
.Fd #include <sys/socket.h>
|
.Fd #include <sys/socket.h>
|
||||||
.Fd #include <netdb.h>
|
.Fd #include <netdb.h>
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn getaddrinfo "const char *hostname" "const char *servname" \
|
.Fo getaddrinfo
|
||||||
"const struct addrinfo *hints" "struct addrinfo **res"
|
.Fa "const char *hostname" "const char *servname"
|
||||||
|
.Fa "const struct addrinfo *hints" "struct addrinfo **res"
|
||||||
|
.Fc
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn freeaddrinfo "struct addrinfo *ai"
|
.Fn freeaddrinfo "struct addrinfo *ai"
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
|
@ -29,8 +29,10 @@
|
|||||||
.Fd #include <sys/socket.h>
|
.Fd #include <sys/socket.h>
|
||||||
.Fd #include <netdb.h>
|
.Fd #include <netdb.h>
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn getnameinfo "const struct sockaddr *sa" "socklen_t salen" "char *host" \
|
.Fo getnameinfo
|
||||||
"size_t hostlen" "char *serv" "size_t servlen" "int flags"
|
.Fa "const struct sockaddr *sa" "socklen_t salen" "char *host"
|
||||||
|
.Fa "size_t hostlen" "char *serv" "size_t servlen" "int flags"
|
||||||
|
.Fc
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Fn getnameinfo
|
.Fn getnameinfo
|
||||||
|
@ -167,7 +167,7 @@ functions appeared in
|
|||||||
.Bx 4.2 .
|
.Bx 4.2 .
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
The data space used by
|
The data space used by
|
||||||
these functions is a thread-specific; if future use requires the data, it should be
|
these functions is thread-specific; if future use requires the data, it should be
|
||||||
copied before any subsequent calls to these functions overwrite it.
|
copied before any subsequent calls to these functions overwrite it.
|
||||||
Only Internet network
|
Only Internet network
|
||||||
numbers are currently understood.
|
numbers are currently understood.
|
||||||
|
@ -61,7 +61,7 @@
|
|||||||
The IPv6 Advanced API, RFC 3542, defines the functions that an
|
The IPv6 Advanced API, RFC 3542, defines the functions that an
|
||||||
application calls to build and examine IPv6 Routing headers.
|
application calls to build and examine IPv6 Routing headers.
|
||||||
Routing headers are used to perform source routing in IPv6 networks.
|
Routing headers are used to perform source routing in IPv6 networks.
|
||||||
The RFC uses the word
|
The RFC uses the word
|
||||||
.Dq segments
|
.Dq segments
|
||||||
to describe addresses and that is the term used here as well.
|
to describe addresses and that is the term used here as well.
|
||||||
All of the functions are defined in the
|
All of the functions are defined in the
|
||||||
@ -82,14 +82,14 @@ The
|
|||||||
.Fn inet6_rth_space
|
.Fn inet6_rth_space
|
||||||
function returns the number of bytes required to hold a Routing Header
|
function returns the number of bytes required to hold a Routing Header
|
||||||
of the type, specified in the
|
of the type, specified in the
|
||||||
.Fa type
|
.Fa type
|
||||||
argument and containing the number of addresses specified in the
|
argument and containing the number of addresses specified in the
|
||||||
.Fa segments
|
.Fa segments
|
||||||
argumment.
|
argumment.
|
||||||
When the type is
|
When the type is
|
||||||
.Dv IPV6_RTHDR_TYPE_0
|
.Dv IPV6_RTHDR_TYPE_0
|
||||||
the number of segments must be from 0 through 127.
|
the number of segments must be from 0 through 127.
|
||||||
Routing headers of type
|
Routing headers of type
|
||||||
.Dv IPV6_RTHDR_TYPE_2
|
.Dv IPV6_RTHDR_TYPE_2
|
||||||
contain only one segment, and are only used with Mobile IPv6.
|
contain only one segment, and are only used with Mobile IPv6.
|
||||||
The return value from this function is the number of bytes required to
|
The return value from this function is the number of bytes required to
|
||||||
@ -166,20 +166,25 @@ The
|
|||||||
.Fa index
|
.Fa index
|
||||||
is the location in the routing header from which the application wants
|
is the location in the routing header from which the application wants
|
||||||
to retrieve an address.
|
to retrieve an address.
|
||||||
The
|
The
|
||||||
.Fa index
|
.Fa index
|
||||||
parameter must have a value between 0 and one less than the number of
|
parameter must have a value between 0 and one less than the number of
|
||||||
segments present in the routing header.
|
segments present in the routing header.
|
||||||
The
|
The
|
||||||
.Fn inet6_rth_segments
|
.Fn inet6_rth_segments
|
||||||
function, described in the last section, should be used to determine
|
function, described in the last section, should be used to determine
|
||||||
the total number of segments in the routing header.
|
the total number of segments in the routing header.
|
||||||
The
|
The
|
||||||
.Fn inet6_rth_getaddr
|
.Fn inet6_rth_getaddr
|
||||||
function returns a pointer to an IPv6 address on success or
|
function returns a pointer to an IPv6 address on success or
|
||||||
.Dv NULL
|
.Dv NULL
|
||||||
when an error has occurred.
|
when an error has occurred.
|
||||||
.\"
|
.\"
|
||||||
|
.Sh EXAMPLES
|
||||||
|
RFC 3542 gives extensive examples in Section 21, Appendix B.
|
||||||
|
.Pp
|
||||||
|
KAME also provides examples in the advapitest directory of its kit.
|
||||||
|
.\"
|
||||||
.Sh DIAGNOSTICS
|
.Sh DIAGNOSTICS
|
||||||
The
|
The
|
||||||
.Fn inet6_rth_space
|
.Fn inet6_rth_space
|
||||||
@ -198,11 +203,6 @@ and
|
|||||||
.Fn inet6_rth_reverse
|
.Fn inet6_rth_reverse
|
||||||
functions return 0 on success, or \-1 upon an error.
|
functions return 0 on success, or \-1 upon an error.
|
||||||
.\"
|
.\"
|
||||||
.Sh EXAMPLES
|
|
||||||
RFC 3542 gives extensive examples in Section 21, Appendix B.
|
|
||||||
.Pp
|
|
||||||
KAME also provides examples in the advapitest directory of its kit.
|
|
||||||
.\"
|
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Rs
|
.Rs
|
||||||
.%A W. Stevens
|
.%A W. Stevens
|
||||||
|
@ -63,7 +63,7 @@ otherwise it returns
|
|||||||
.It Bq Er EBADF
|
.It Bq Er EBADF
|
||||||
The
|
The
|
||||||
.Fa catd
|
.Fa catd
|
||||||
argument is not valid message catalog descriptor.
|
argument is not a valid message catalog descriptor.
|
||||||
.It Bq Er EBADMSG
|
.It Bq Er EBADMSG
|
||||||
The message identified by
|
The message identified by
|
||||||
.Fa set_id
|
.Fa set_id
|
||||||
|
@ -137,7 +137,9 @@ protocol family, and is used to implement Transaction
|
|||||||
.Dv MSG_DONTROUTE
|
.Dv MSG_DONTROUTE
|
||||||
is usually used only by diagnostic or routing programs.
|
is usually used only by diagnostic or routing programs.
|
||||||
.Dv MSG_NOSIGNAL
|
.Dv MSG_NOSIGNAL
|
||||||
is used to prevent SIGPIPE generation when writing a socket that
|
is used to prevent
|
||||||
|
.Dv SIGPIPE
|
||||||
|
generation when writing a socket that
|
||||||
may be closed.
|
may be closed.
|
||||||
.Pp
|
.Pp
|
||||||
See
|
See
|
||||||
|
@ -60,8 +60,8 @@ variables:
|
|||||||
and
|
and
|
||||||
.Ev PAM_USER .
|
.Ev PAM_USER .
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr pam.conf 5 ,
|
|
||||||
.Xr pam_get_item 3 ,
|
.Xr pam_get_item 3 ,
|
||||||
|
.Xr pam.conf 5 ,
|
||||||
.Xr pam 8
|
.Xr pam 8
|
||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
The
|
The
|
||||||
|
@ -25,7 +25,7 @@
|
|||||||
.\" $Id: sdp.3,v 1.1 2003/09/07 20:34:19 max Exp $
|
.\" $Id: sdp.3,v 1.1 2003/09/07 20:34:19 max Exp $
|
||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd September 7, 2003
|
.Dd May 27, 2005
|
||||||
.Dt SDP 3
|
.Dt SDP 3
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
|
@ -75,7 +75,7 @@
|
|||||||
.Ft int
|
.Ft int
|
||||||
.Fn fedisableexcept "int excepts"
|
.Fn fedisableexcept "int excepts"
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn fegetexcept "void"
|
.Fn fegetexcept void
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.In fenv.h
|
.In fenv.h
|
||||||
|
@ -101,12 +101,12 @@ functions conform to
|
|||||||
.St -isoC-99 .
|
.St -isoC-99 .
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
The
|
The
|
||||||
.Ft float
|
.Vt float
|
||||||
and
|
and
|
||||||
.Ft double
|
.Vt double
|
||||||
versions of these routines first appeared in
|
versions of these routines first appeared in
|
||||||
.Fx 5.4 .
|
.Fx 5.4 .
|
||||||
The
|
The
|
||||||
.Ft long double
|
.Vt "long double"
|
||||||
versions appeared in
|
versions appeared in
|
||||||
.Fx 6.0 .
|
.Fx 6.0 .
|
||||||
|
@ -40,7 +40,7 @@
|
|||||||
.Fn round "double x"
|
.Fn round "double x"
|
||||||
.Ft float
|
.Ft float
|
||||||
.Fn roundf "float x"
|
.Fn roundf "float x"
|
||||||
.Ft long double
|
.Ft "long double"
|
||||||
.Fn roundl "long double x"
|
.Fn roundl "long double x"
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
|
@ -40,7 +40,7 @@
|
|||||||
.Fn trunc "double x"
|
.Fn trunc "double x"
|
||||||
.Ft float
|
.Ft float
|
||||||
.Fn truncf "float x"
|
.Fn truncf "float x"
|
||||||
.Ft long double
|
.Ft "long double"
|
||||||
.Fn truncl "long double x"
|
.Fn truncl "long double x"
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
|
Loading…
Reference in New Issue
Block a user