Assorted markup fixes.

Approved by:	re
This commit is contained in:
Ruslan Ermilov 2005-06-15 19:04:04 +00:00
parent 88a2c1983d
commit f789cb8293
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=147402
17 changed files with 91 additions and 57 deletions

View File

@ -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.

View File

@ -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 {

View File

@ -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

View File

@ -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.

View File

@ -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 .

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -75,7 +75,7 @@
.Ft int
.Fn fedisableexcept "int excepts"
.Ft int
.Fn fegetexcept "void"
.Fn fegetexcept void
.Sh DESCRIPTION
The
.In fenv.h

View File

@ -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 .

View File

@ -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

View File

@ -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