mirror of
https://git.FreeBSD.org/src.git
synced 2025-01-13 14:40:22 +00:00
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
|
||||
.Ss ISO9660 format
|
||||
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.
|
||||
It also avoids security and complexity issues that come with
|
||||
virtual mounts and loopback devices.
|
||||
|
@ -191,7 +191,7 @@ This format is often called the
|
||||
format, after the magic value used
|
||||
in the header.
|
||||
(The name is an acronym for
|
||||
.Dq Unix Standard TAR. )
|
||||
.Dq Unix Standard TAR . )
|
||||
It extends the historic format with new fields:
|
||||
.Bd -literal -offset indent
|
||||
struct header_posix_ustar {
|
||||
|
@ -180,7 +180,8 @@ return the offset request associated with the request
|
||||
(used for readdir request)
|
||||
.It Fn autoreq_getxid
|
||||
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.
|
||||
.El
|
||||
.Pp
|
||||
@ -197,11 +198,14 @@ this is typically unused.
|
||||
.It Fn autoreq_seterrno
|
||||
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
|
||||
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.
|
||||
.It Fn autoreq_setaux
|
||||
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.
|
||||
.It Fn autoreq_seteof
|
||||
used to set the eof flag for readdir requests (default is not eof.)
|
||||
@ -217,11 +221,13 @@ directory via
|
||||
.Fa path
|
||||
and
|
||||
.Fa fd
|
||||
respectively. The
|
||||
respectively.
|
||||
The
|
||||
.Fa pid
|
||||
argument should be set to the pid of the process serving
|
||||
.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
|
||||
.It Fa AUTO_MOUNTER
|
||||
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
|
||||
are read into userland.
|
||||
.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
|
||||
.Fa pid .
|
||||
.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
|
||||
.Fa pid .
|
||||
.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"
|
||||
.El
|
||||
.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
|
||||
follow each other.
|
||||
The total size of array is returned.
|
||||
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.
|
||||
For KERN_PROC_PATHNAME, a process ID of
|
||||
.Li -1
|
||||
For
|
||||
.Dv KERN_PROC_PATHNAME ,
|
||||
a process ID of
|
||||
.Li \-1
|
||||
implies the current process.
|
||||
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
|
||||
.It Sy "Third level name Fourth level is:"
|
||||
.It "KERN_PROC_ARGS A process ID"
|
||||
.It "KERN_PROC_PATHNAME A process ID"
|
||||
.It Dv KERN_PROC_ARGS Ta "A process ID"
|
||||
.It Dv KERN_PROC_PATHNAME Ta "A process ID"
|
||||
.El
|
||||
.It Li KERN_PROF
|
||||
Return profiling information about the kernel.
|
||||
|
@ -85,10 +85,14 @@ a file descriptor for which
|
||||
.Fn isatty
|
||||
is true.
|
||||
.Pp
|
||||
The
|
||||
.Fn ttyname
|
||||
function
|
||||
returns the name stored in a static buffer which will be overwritten
|
||||
on subsequent calls.
|
||||
The
|
||||
.Fn ttyname_r
|
||||
function
|
||||
takes a buffer and length as arguments to avoid this problem.
|
||||
.Pp
|
||||
The
|
||||
@ -109,40 +113,49 @@ a
|
||||
pointer is returned.
|
||||
The
|
||||
.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
|
||||
The
|
||||
.Fn ttyslot
|
||||
function
|
||||
returns the unit number of the device file if found; otherwise
|
||||
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
|
||||
.Bl -tag -width /etc/ttys -compact
|
||||
.Bl -tag -width ".Pa /etc/ttys" -compact
|
||||
.It Pa /dev/\(**
|
||||
.It Pa /etc/ttys
|
||||
.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
|
||||
.Xr ioctl 2 ,
|
||||
.Xr ttys 5
|
||||
.Sh HISTORY
|
||||
A
|
||||
The
|
||||
.Fn isatty ,
|
||||
.Fn ttyname ,
|
||||
and
|
||||
.Fn ttyslot
|
||||
function
|
||||
functions
|
||||
appeared in
|
||||
.At v7 .
|
||||
The
|
||||
.Fn ttyname_r
|
||||
function
|
||||
appeared in
|
||||
.Fx 6.0 .
|
||||
|
@ -30,8 +30,10 @@
|
||||
.Fd #include <sys/socket.h>
|
||||
.Fd #include <netdb.h>
|
||||
.Ft int
|
||||
.Fn getaddrinfo "const char *hostname" "const char *servname" \
|
||||
"const struct addrinfo *hints" "struct addrinfo **res"
|
||||
.Fo getaddrinfo
|
||||
.Fa "const char *hostname" "const char *servname"
|
||||
.Fa "const struct addrinfo *hints" "struct addrinfo **res"
|
||||
.Fc
|
||||
.Ft void
|
||||
.Fn freeaddrinfo "struct addrinfo *ai"
|
||||
.Sh DESCRIPTION
|
||||
|
@ -29,8 +29,10 @@
|
||||
.Fd #include <sys/socket.h>
|
||||
.Fd #include <netdb.h>
|
||||
.Ft int
|
||||
.Fn getnameinfo "const struct sockaddr *sa" "socklen_t salen" "char *host" \
|
||||
"size_t hostlen" "char *serv" "size_t servlen" "int flags"
|
||||
.Fo getnameinfo
|
||||
.Fa "const struct sockaddr *sa" "socklen_t salen" "char *host"
|
||||
.Fa "size_t hostlen" "char *serv" "size_t servlen" "int flags"
|
||||
.Fc
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn getnameinfo
|
||||
|
@ -167,7 +167,7 @@ functions appeared in
|
||||
.Bx 4.2 .
|
||||
.Sh BUGS
|
||||
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.
|
||||
Only Internet network
|
||||
numbers are currently understood.
|
||||
|
@ -61,7 +61,7 @@
|
||||
The IPv6 Advanced API, RFC 3542, defines the functions that an
|
||||
application calls to build and examine IPv6 Routing headers.
|
||||
Routing headers are used to perform source routing in IPv6 networks.
|
||||
The RFC uses the word
|
||||
The RFC uses the word
|
||||
.Dq segments
|
||||
to describe addresses and that is the term used here as well.
|
||||
All of the functions are defined in the
|
||||
@ -82,14 +82,14 @@ The
|
||||
.Fn inet6_rth_space
|
||||
function returns the number of bytes required to hold a Routing Header
|
||||
of the type, specified in the
|
||||
.Fa type
|
||||
.Fa type
|
||||
argument and containing the number of addresses specified in the
|
||||
.Fa segments
|
||||
argumment.
|
||||
When the type is
|
||||
When the type is
|
||||
.Dv IPV6_RTHDR_TYPE_0
|
||||
the number of segments must be from 0 through 127.
|
||||
Routing headers of type
|
||||
Routing headers of type
|
||||
.Dv IPV6_RTHDR_TYPE_2
|
||||
contain only one segment, and are only used with Mobile IPv6.
|
||||
The return value from this function is the number of bytes required to
|
||||
@ -166,20 +166,25 @@ The
|
||||
.Fa index
|
||||
is the location in the routing header from which the application wants
|
||||
to retrieve an address.
|
||||
The
|
||||
.Fa index
|
||||
The
|
||||
.Fa index
|
||||
parameter must have a value between 0 and one less than the number of
|
||||
segments present in the routing header.
|
||||
The
|
||||
.Fn inet6_rth_segments
|
||||
.Fn inet6_rth_segments
|
||||
function, described in the last section, should be used to determine
|
||||
the total number of segments in the routing header.
|
||||
The
|
||||
.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
|
||||
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
|
||||
The
|
||||
.Fn inet6_rth_space
|
||||
@ -198,11 +203,6 @@ and
|
||||
.Fn inet6_rth_reverse
|
||||
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
|
||||
.Rs
|
||||
.%A W. Stevens
|
||||
|
@ -63,7 +63,7 @@ otherwise it returns
|
||||
.It Bq Er EBADF
|
||||
The
|
||||
.Fa catd
|
||||
argument is not valid message catalog descriptor.
|
||||
argument is not a valid message catalog descriptor.
|
||||
.It Bq Er EBADMSG
|
||||
The message identified by
|
||||
.Fa set_id
|
||||
|
@ -137,7 +137,9 @@ protocol family, and is used to implement Transaction
|
||||
.Dv MSG_DONTROUTE
|
||||
is usually used only by diagnostic or routing programs.
|
||||
.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.
|
||||
.Pp
|
||||
See
|
||||
|
@ -60,8 +60,8 @@ variables:
|
||||
and
|
||||
.Ev PAM_USER .
|
||||
.Sh SEE ALSO
|
||||
.Xr pam.conf 5 ,
|
||||
.Xr pam_get_item 3 ,
|
||||
.Xr pam.conf 5 ,
|
||||
.Xr pam 8
|
||||
.Sh AUTHORS
|
||||
The
|
||||
|
@ -25,7 +25,7 @@
|
||||
.\" $Id: sdp.3,v 1.1 2003/09/07 20:34:19 max Exp $
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd September 7, 2003
|
||||
.Dd May 27, 2005
|
||||
.Dt SDP 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
|
@ -75,7 +75,7 @@
|
||||
.Ft int
|
||||
.Fn fedisableexcept "int excepts"
|
||||
.Ft int
|
||||
.Fn fegetexcept "void"
|
||||
.Fn fegetexcept void
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.In fenv.h
|
||||
|
@ -101,12 +101,12 @@ functions conform to
|
||||
.St -isoC-99 .
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Ft float
|
||||
.Vt float
|
||||
and
|
||||
.Ft double
|
||||
.Vt double
|
||||
versions of these routines first appeared in
|
||||
.Fx 5.4 .
|
||||
The
|
||||
.Ft long double
|
||||
.Vt "long double"
|
||||
versions appeared in
|
||||
.Fx 6.0 .
|
||||
|
@ -40,7 +40,7 @@
|
||||
.Fn round "double x"
|
||||
.Ft float
|
||||
.Fn roundf "float x"
|
||||
.Ft long double
|
||||
.Ft "long double"
|
||||
.Fn roundl "long double x"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
|
@ -40,7 +40,7 @@
|
||||
.Fn trunc "double x"
|
||||
.Ft float
|
||||
.Fn truncf "float x"
|
||||
.Ft long double
|
||||
.Ft "long double"
|
||||
.Fn truncl "long double x"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
|
Loading…
Reference in New Issue
Block a user