diff --git a/lib/libarchive/libarchive-formats.5 b/lib/libarchive/libarchive-formats.5 index 196d94e39d95..0b32c7bf61b8 100644 --- a/lib/libarchive/libarchive-formats.5 +++ b/lib/libarchive/libarchive-formats.5 @@ -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. diff --git a/lib/libarchive/tar.5 b/lib/libarchive/tar.5 index 3c08fceebe33..c8879311ca0b 100644 --- a/lib/libarchive/tar.5 +++ b/lib/libarchive/tar.5 @@ -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 { diff --git a/lib/libautofs/libautofs.3 b/lib/libautofs/libautofs.3 index f45017589bac..16b9f4c642a7 100644 --- a/lib/libautofs/libautofs.3 +++ b/lib/libautofs/libautofs.3 @@ -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 diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3 index 5fe33dc60658..9ac8cee87af3 100644 --- a/lib/libc/gen/sysctl.3 +++ b/lib/libc/gen/sysctl.3 @@ -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. diff --git a/lib/libc/gen/ttyname.3 b/lib/libc/gen/ttyname.3 index db67314cf096..5f427fba8ccf 100644 --- a/lib/libc/gen/ttyname.3 +++ b/lib/libc/gen/ttyname.3 @@ -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 . diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3 index 3982bfeab355..9c5a8b6254cd 100644 --- a/lib/libc/net/getaddrinfo.3 +++ b/lib/libc/net/getaddrinfo.3 @@ -30,8 +30,10 @@ .Fd #include .Fd #include .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 diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3 index 54dce3907710..61479cf7b505 100644 --- a/lib/libc/net/getnameinfo.3 +++ b/lib/libc/net/getnameinfo.3 @@ -29,8 +29,10 @@ .Fd #include .Fd #include .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 diff --git a/lib/libc/net/getnetent.3 b/lib/libc/net/getnetent.3 index 978b25bd5ddc..3c329a610d34 100644 --- a/lib/libc/net/getnetent.3 +++ b/lib/libc/net/getnetent.3 @@ -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. diff --git a/lib/libc/net/inet6_rth_space.3 b/lib/libc/net/inet6_rth_space.3 index b8110e167a21..390348582a8f 100644 --- a/lib/libc/net/inet6_rth_space.3 +++ b/lib/libc/net/inet6_rth_space.3 @@ -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 diff --git a/lib/libc/nls/catgets.3 b/lib/libc/nls/catgets.3 index fe78211188d2..38e92ba23c30 100644 --- a/lib/libc/nls/catgets.3 +++ b/lib/libc/nls/catgets.3 @@ -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 diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2 index 7434db284f53..20e005bb8774 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -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 diff --git a/lib/libpam/modules/pam_exec/pam_exec.8 b/lib/libpam/modules/pam_exec/pam_exec.8 index d7e53084d529..311d64c492a9 100644 --- a/lib/libpam/modules/pam_exec/pam_exec.8 +++ b/lib/libpam/modules/pam_exec/pam_exec.8 @@ -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 diff --git a/lib/libsdp/sdp.3 b/lib/libsdp/sdp.3 index e80d0ac9ccba..c51b6f9e2e60 100644 --- a/lib/libsdp/sdp.3 +++ b/lib/libsdp/sdp.3 @@ -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 diff --git a/lib/msun/man/fenv.3 b/lib/msun/man/fenv.3 index 1ae017788fa1..3450153b13d4 100644 --- a/lib/msun/man/fenv.3 +++ b/lib/msun/man/fenv.3 @@ -75,7 +75,7 @@ .Ft int .Fn fedisableexcept "int excepts" .Ft int -.Fn fegetexcept "void" +.Fn fegetexcept void .Sh DESCRIPTION The .In fenv.h diff --git a/lib/msun/man/lround.3 b/lib/msun/man/lround.3 index f2c4a3f9c1a9..a98229dbb3b4 100644 --- a/lib/msun/man/lround.3 +++ b/lib/msun/man/lround.3 @@ -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 . diff --git a/lib/msun/man/round.3 b/lib/msun/man/round.3 index 262cf0ffa929..24b3970c8245 100644 --- a/lib/msun/man/round.3 +++ b/lib/msun/man/round.3 @@ -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 diff --git a/lib/msun/man/trunc.3 b/lib/msun/man/trunc.3 index c510095c5c96..7d9e82882ae6 100644 --- a/lib/msun/man/trunc.3 +++ b/lib/msun/man/trunc.3 @@ -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