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

View File

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

View File

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

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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