diff options
32 files changed, 69 insertions, 64 deletions
diff --git a/lib/libc/compat-43/sigvec.2 b/lib/libc/compat-43/sigvec.2 index 7288d00..a37c988 100644 --- a/lib/libc/compat-43/sigvec.2 +++ b/lib/libc/compat-43/sigvec.2 @@ -102,9 +102,9 @@ must arrange to restore the previous context itself. When a signal is delivered to a process a new signal mask is installed for the duration of the process' signal handler (or until a -.Xr sigblock +.Xr sigblock 2 or -.Xr sigsetmask +.Xr sigsetmask 2 call is made). This mask is formed by taking the current signal mask, adding the signal to be delivered, and diff --git a/lib/libc/gen/crypt.3 b/lib/libc/gen/crypt.3 index d95f704..28b5112 100644 --- a/lib/libc/gen/crypt.3 +++ b/lib/libc/gen/crypt.3 @@ -54,7 +54,7 @@ .Fn des_cipher "const char *in" "char *out" "long salt" "int count" .Sh DESCRIPTION The -.Xr crypt +.Fn crypt function performs password encryption. It is derived from the diff --git a/lib/libc/gen/ctermid.3 b/lib/libc/gen/ctermid.3 index ff92420..2e3e9e6 100644 --- a/lib/libc/gen/ctermid.3 +++ b/lib/libc/gen/ctermid.3 @@ -80,7 +80,7 @@ The current implementation detects no error conditions. .Xr ttyname 3 .Sh STANDARDS The -.Xr ctermid +.Fn ctermid function conforms to .St -p1003.1-88 . .Sh BUGS diff --git a/lib/libc/gen/exec.3 b/lib/libc/gen/exec.3 index 5c74ada..bda6e9e 100644 --- a/lib/libc/gen/exec.3 +++ b/lib/libc/gen/exec.3 @@ -65,7 +65,7 @@ new process image. The functions described in this manual page are front-ends for the function .Xr execve 2 . (See the manual page for -.Xr execve +.Xr execve 2 for detailed information about the replacement of the current process.) .Pp The initial argument for these functions is the pathname of a file which @@ -148,7 +148,7 @@ used. In addition, certain errors are treated specially. .Pp If permission is denied for a file (the attempted -.Xr execve +.Fn execve returned .Er EACCES ) , these functions will continue searching the rest of @@ -159,7 +159,7 @@ set to .Er EACCES . .Pp If the header of a file isn't recognized (the attempted -.Xr execve +.Fn execve returned .Er ENOEXEC ) , these functions will execute the shell with the path of @@ -167,7 +167,7 @@ the file as its first argument. (If this attempt fails, no further searching is done.) .Pp If the file is currently busy (the attempted -.Xr execve +.Fn execve returned .Er ETXTBUSY ) , these functions will sleep for several seconds, @@ -179,7 +179,7 @@ executes a file with the program tracing facilities enabled (see .Xr ptrace 2 ) . .Sh RETURN VALUES If any of the -.Xr exec +.Fn exec functions returns, an error will have occurred. The return value is \-1, and the global variable .Va errno diff --git a/lib/libc/gen/getmntinfo.3 b/lib/libc/gen/getmntinfo.3 index 9a28b2e..da1d5ad 100644 --- a/lib/libc/gen/getmntinfo.3 +++ b/lib/libc/gen/getmntinfo.3 @@ -48,7 +48,7 @@ The .Fn getmntinfo function returns an array of -.Xr statfs +.Fn statfs structures describing each currently mounted file system (see .Xr statfs 2 ) . .Pp diff --git a/lib/libc/gen/getpagesize.3 b/lib/libc/gen/getpagesize.3 index 1a26297..ea7f587 100644 --- a/lib/libc/gen/getpagesize.3 +++ b/lib/libc/gen/getpagesize.3 @@ -47,8 +47,7 @@ returns the number of bytes in a page. Page granularity is the granularity of many of the memory management calls. .Pp -The page size is a -.Xr system +The page size is a system page size and may not be the same as the underlying hardware page size. .Sh SEE ALSO diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3 index f28bc2a..65c5674 100644 --- a/lib/libc/gen/glob.3 +++ b/lib/libc/gen/glob.3 @@ -220,7 +220,8 @@ to provide globbing from directories stored on tape. Pre-process the pattern string to expand .Ql {pat,pat,...} strings like -.Xr csh 1. The pattern +.Xr csh 1 . +The pattern .Ql {} is left unexpanded for historical reasons .Xr (Csh 1 diff --git a/lib/libc/gen/popen.3 b/lib/libc/gen/popen.3 index 6f89a5c..db4adfa 100644 --- a/lib/libc/gen/popen.3 +++ b/lib/libc/gen/popen.3 @@ -170,9 +170,9 @@ The .Fn popen argument always calls -.Xr sh , +.Xr sh 1 , never calls -.Xr csh . +.Xr csh 1 . .Sh HISTORY A .Fn popen diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3 index 37ad60b..3fd52d8 100644 --- a/lib/libc/gen/signal.3 +++ b/lib/libc/gen/signal.3 @@ -193,7 +193,7 @@ Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Xr Signal +.Fn Signal will fail and no action will take place if one of the following occur: .Bl -tag -width [EINVAL] diff --git a/lib/libc/gen/sleep.3 b/lib/libc/gen/sleep.3 index 9e3c797..a56a80e 100644 --- a/lib/libc/gen/sleep.3 +++ b/lib/libc/gen/sleep.3 @@ -70,7 +70,7 @@ A similar but less compatible function can be obtained with a single .Xr select 2 ; such a function would not restart after signals, but would not interfere with other uses of -.Xr setitimer . +.Xr setitimer 2 . .Sh RETURN VALUES .Sh SEE ALSO .Xr setitimer 2 , diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index 8a46d05..832fd9c 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -139,12 +139,12 @@ one or more of the following values: If .Fn syslog cannot pass the message to -.Xr syslogd +.Xr syslogd 8 it will attempt to write the message to the console .Pq Dq Pa /dev/console. .It Dv LOG_NDELAY Open the connection to -.Xr syslogd +.Xr syslogd 8 immediately. Normally the open is delayed until the first message is logged. Useful for programs that need to manage the order in which file diff --git a/lib/libc/gen/unvis.3 b/lib/libc/gen/unvis.3 index 807a851..c65024d 100644 --- a/lib/libc/gen/unvis.3 +++ b/lib/libc/gen/unvis.3 @@ -100,7 +100,7 @@ to zero. Call with each successive byte, along with a pointer to this integer, and a pointer to a destination character. The -.Xr unvis +.Fn unvis function has several return codes that must be handled properly. They are: .Bl -tag -width UNVIS_VALIDPUSH diff --git a/lib/libc/locale/isupper.3 b/lib/libc/locale/isupper.3 index 6035f09..f8fb413 100644 --- a/lib/libc/locale/isupper.3 +++ b/lib/libc/locale/isupper.3 @@ -69,6 +69,6 @@ returns non-zero if the character tests true. .Xr ascii 7 .Sh STANDARDS The -.Xr isupper +.Fn isupper function conforms to .St -ansiC . diff --git a/lib/libc/stdio/fopen.3 b/lib/libc/stdio/fopen.3 index 23d790c..87bb049 100644 --- a/lib/libc/stdio/fopen.3 +++ b/lib/libc/stdio/fopen.3 @@ -142,7 +142,7 @@ The original stream (if it exists) is closed. The .Fa mode argument is used just as in the -.Xr fopen +.Fn fopen function. The primary use of the .Fn freopen diff --git a/lib/libc/stdio/scanf.3 b/lib/libc/stdio/scanf.3 index 377a602..dbfff88 100644 --- a/lib/libc/stdio/scanf.3 +++ b/lib/libc/stdio/scanf.3 @@ -200,7 +200,7 @@ the next pointer must be a pointer to .Em int . .It Cm D Equivalent to -.Xr ld ; +.Cm ld ; this exists only for backwards compatibility. .It Cm i Matches an optionally signed integer; @@ -221,7 +221,7 @@ the next pointer must be a pointer to .Em unsigned int . .It Cm O Equivalent to -.Xr lo ; +.Cm lo ; this exists for backwards compatibility. .It Cm u Matches an optionally signed decimal integer; diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3 index 09d7e36..7ebc782 100644 --- a/lib/libc/stdio/stdio.3 +++ b/lib/libc/stdio/stdio.3 @@ -151,7 +151,7 @@ function. The .Nm stdio library is a part of the library -.Xr libc +.Nm libc and routines are automatically loaded as needed by the compilers .Xr cc 1 and @@ -192,15 +192,15 @@ without first removing their current definitions with .Dv stdin , .Dv stdout . Function versions of the macro functions -.Xr feof , -.Xr ferror , -.Xr clearerr , -.Xr fileno , -.Xr getc , -.Xr getchar , -.Xr putc , +.Fn feof , +.Fn ferror , +.Fn clearerr , +.Fn fileno , +.Fn getc , +.Fn getchar , +.Fn putc , and -.Xr putchar +.Fn putchar exist and will be used if the macros definitions are explicitly removed. .Sh SEE ALSO @@ -211,9 +211,9 @@ definitions are explicitly removed. .Sh BUGS The standard buffered functions do not interact well with certain other library and system functions, especially -.Xr vfork +.Xr vfork 2 and -.Xr abort . +.Xr abort 3 . .Sh STANDARDS The .Nm stdio diff --git a/lib/libc/stdio/tmpnam.3 b/lib/libc/stdio/tmpnam.3 index 3b053ee..d7e0326 100644 --- a/lib/libc/stdio/tmpnam.3 +++ b/lib/libc/stdio/tmpnam.3 @@ -201,7 +201,7 @@ Second, most historic implementations provide only a limited number of possible temporary file names (usually 26) before file names will start being recycled. Third, the System V implementations of these functions (and of -.Xr mktemp ) +.Xr mktemp 3 ) use the .Xr access 2 function to determine whether or not the temporary file may be created. diff --git a/lib/libc/stdlib/random.3 b/lib/libc/stdlib/random.3 index 84680e2..d1b8208 100644 --- a/lib/libc/stdlib/random.3 +++ b/lib/libc/stdlib/random.3 @@ -64,11 +64,16 @@ The period of this random number generator is very large, approximately .if n 16*((2**31)\(mi1). .Pp The -.Fn random Ns / Fn srandom -have (almost) the same calling sequence and initialization properties as -.Xr rand 3 Ns / Xr srand 3 . +.Fn random +and +.Fn srandom +functions have (almost) the same calling sequence and initialization properties as the +.Xr rand 3 +and +.Xr srand 3 +functions. The difference is that -.Xr rand +.Xr rand 3 produces a much less random sequence \(em in fact, the low dozen bits generated by rand go through a cyclic pattern. All the bits generated by .Fn random diff --git a/lib/libc/stdtime/ctime.3 b/lib/libc/stdtime/ctime.3 index ff6a8ef..1a6ba5a 100644 --- a/lib/libc/stdtime/ctime.3 +++ b/lib/libc/stdtime/ctime.3 @@ -89,9 +89,9 @@ environmental variable (see The function .Fn localtime uses -.Xr tzset +.Xr tzset 3 to initialize time conversion information if -.Xr tzset +.Xr tzset 3 has not already been called by the process. .Pp After filling in the tm structure, diff --git a/lib/libc/sys/_exit.2 b/lib/libc/sys/_exit.2 index 73e6062..12a5f7e 100644 --- a/lib/libc/sys/_exit.2 +++ b/lib/libc/sys/_exit.2 @@ -53,7 +53,7 @@ This may entail delays, for example, waiting for output to drain; a process in this state may not be killed, as it is already dying. .It If the parent process of the calling process has an outstanding -.Xr wait +.Xr wait 2 call or catches the .Dv SIGCHLD diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2 index 7580f38..0cfca78 100644 --- a/lib/libc/sys/brk.2 +++ b/lib/libc/sys/brk.2 @@ -94,7 +94,7 @@ it will not be possible to set the break beyond the .Em rlim_max value returned from a call to -.Xr getrlimit , +.Xr getrlimit 2 , e.g. .Dq qetext + rlp\(->rlim_max. (see @@ -114,7 +114,7 @@ otherwise -1 with .Va errno set to indicate why the allocation failed. .Sh ERRORS -.Xr Sbrk +.Fn Sbrk will fail and no additional memory will be allocated if one of the following are true: .Bl -tag -width [ENOMEM] @@ -139,7 +139,7 @@ Setting the break may fail due to a temporary lack of swap space. It is not possible to distinguish this from a failure caused by exceeding the maximum size of the data segment without consulting -.Xr getrlimit . +.Xr getrlimit 2 . .Sh HISTORY A .Nm diff --git a/lib/libc/sys/close.2 b/lib/libc/sys/close.2 index 3cb3d51..3a64dac 100644 --- a/lib/libc/sys/close.2 +++ b/lib/libc/sys/close.2 @@ -78,7 +78,7 @@ of the descriptors can be rearranged with or deleted with .Fn close before the -.Xr execve +.Xr execve 2 is attempted, but if some of these descriptors will still be needed if the execve fails, it is necessary to arrange for them to be closed if the execve succeeds. diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2 index 37fbb34..87b97f0 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -128,9 +128,9 @@ flags are as follows: .Bl -tag -width O_NONBLOCKX .It Dv O_NONBLOCK Non-blocking I/O; if no data is available to a -.Xr read +.Xr read 2 call, or if a -.Xr write +.Xr write 2 operation would block, the read or write call returns -1 with the error .Er EAGAIN . diff --git a/lib/libc/sys/fork.2 b/lib/libc/sys/fork.2 index 0c290f6..b8d465a 100644 --- a/lib/libc/sys/fork.2 +++ b/lib/libc/sys/fork.2 @@ -59,9 +59,9 @@ for instance, file pointers in file objects are shared between the child and the parent, so that an .Xr lseek 2 on a descriptor in the child process can affect a subsequent -.Xr read +.Xr read 2 or -.Xr write +.Xr write 2 by the parent. This descriptor copying is also used by the shell to establish standard input and output for newly created processes diff --git a/lib/libc/sys/getrlimit.2 b/lib/libc/sys/getrlimit.2 index 33c3ddd..42b9028 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -60,7 +60,7 @@ parameter is one of the following: .Bl -tag -width RLIMIT_FSIZEAA .It Li RLIMIT_CORE The largest size (in bytes) -.Xr core +.Xr core 5 file that may be created. .It Li RLIMIT_CPU The maximum amount of cpu time (in seconds) to be used by diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index ee0ab72..55098bc 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)getsockopt.2 8.3 (Berkeley) 4/19/94 -.\" $Id: getsockopt.2,v 1.3 1996/01/22 00:01:59 julian Exp $ +.\" $Id: getsockopt.2,v 1.4 1996/02/11 22:34:21 mpp Exp $ .\" .Dd November 3, 1995 .Dt GETSOCKOPT 2 @@ -190,7 +190,7 @@ is performed. If the socket promises reliable delivery of data and .Dv SO_LINGER is set, the system will block the process on the -.Xr close +.Xr close 2 attempt until it is able to transmit the data or until it decides it is unable to deliver the information (a timeout period, termed the linger interval, is specified in the @@ -201,7 +201,7 @@ is requested). If .Dv SO_LINGER is disabled and a -.Xr close +.Xr close 2 is issued, the system will process the close in a manner that allows the process to continue as quickly as possible. .Pp @@ -215,9 +215,9 @@ With protocols that support out-of-band data, the option requests that out-of-band data be placed in the normal data input queue as received; it will then be accessible with -.Xr recv +.Xr recv 2 or -.Xr read +.Xr read 2 calls without the .Dv MSG_OOB flag. diff --git a/lib/libc/sys/intro.2 b/lib/libc/sys/intro.2 index 070e497..79aad8a 100644 --- a/lib/libc/sys/intro.2 +++ b/lib/libc/sys/intro.2 @@ -497,7 +497,7 @@ as the group, but is in a different process group. Note that when a process exits, the parent process for its children is changed to be -.Xr init , +.Nm init , which is in a separate session. Not all members of an orphaned process group are necessarily orphaned processes (those whose creating process has exited). diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index 479a209..bb75262 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -136,7 +136,7 @@ When a new file is created it is given the group of the directory which contains it. .Pp The new descriptor is set to remain open across -.Xr execve +.Xr execve 2 system calls; see .Xr close 2 and diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2 index 6158f51..9a86371 100644 --- a/lib/libc/sys/rfork.2 +++ b/lib/libc/sys/rfork.2 @@ -82,7 +82,7 @@ will sleep, if necessary, until required process resources are available. .Pp .Fn Fork can be implemented as a call to -.Xr rfork "RFFDG|RFPROC" +.Fn rfork "RFFDG|RFPROC" but isn't for backwards compatibility. .Sh ERRORS .Fn Rfork diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index 27bc183..51a5b2e 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -256,7 +256,7 @@ depend on the time stamps being contiguous (in calls to .Xr symlink 7 .Sh BUGS Applying -.Xr fstat +.Fn fstat to a socket (and thus to a pipe) returns a zeroed buffer, except for the blocksize field, diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2 index 1ebeb37..125b619 100644 --- a/lib/libc/sys/utimes.2 +++ b/lib/libc/sys/utimes.2 @@ -82,7 +82,7 @@ and the effective user ID of the process does not match the owner of the file, and is not the super-user, and write access is denied. .It Bq Er EFAULT -.Xr File +.Fa File or .Fa times points outside the process's allocated address space. diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2 index b708bde..0d0dbf0 100644 --- a/lib/libc/sys/vfork.2 +++ b/lib/libc/sys/vfork.2 @@ -57,7 +57,7 @@ control until a call to .Xr execve 2 or an exit (either by a call to .Xr exit 3 -or abnormally.) +or abnormally). The parent process is suspended while the child is using its resources. .Pp .Fn Vfork @@ -66,7 +66,7 @@ the parent's context. .Pp .Fn Vfork can normally be used just like -.Xr fork . +.Xr fork 2 . It does not work, however, to return while running in the childs context from the procedure that called .Fn vfork |