diff options
author | asmodai <asmodai@FreeBSD.org> | 2000-10-30 13:23:19 +0000 |
---|---|---|
committer | asmodai <asmodai@FreeBSD.org> | 2000-10-30 13:23:19 +0000 |
commit | 5e2215e426e657107c92f91ad1a9a1438dcf1f6a (patch) | |
tree | 7ab0e5964b243a778c4f22e43eeca2070254eaaa /lib/libc | |
parent | 390de194cd65ae4f4284ca22f4b0c0bf48c41b04 (diff) | |
download | FreeBSD-src-5e2215e426e657107c92f91ad1a9a1438dcf1f6a.zip FreeBSD-src-5e2215e426e657107c92f91ad1a9a1438dcf1f6a.tar.gz |
Whitespace only change: trim trailing whitespace.
Diffstat (limited to 'lib/libc')
54 files changed, 186 insertions, 186 deletions
diff --git a/lib/libc/gen/alarm.3 b/lib/libc/gen/alarm.3 index 572110b..9f81377 100644 --- a/lib/libc/gen/alarm.3 +++ b/lib/libc/gen/alarm.3 @@ -52,11 +52,11 @@ This interface is made obsolete by setitimer(2). The .Fn alarm function sets a timer to deliver the signal -.Dv SIGALRM +.Dv SIGALRM to the calling process after the specified number of .Fa seconds . If an alarm has already been set with -.Fn alarm +.Fn alarm but has not been delivered, another call to .Fn alarm will supersede the prior call. @@ -72,7 +72,7 @@ restriction the maximum number of allowed is 100000000. .Sh RETURN VALUES .Pp -The return value of +The return value of .Fn alarm is the amount of time left on the timer from a previous call to .Fn alarm . @@ -89,10 +89,10 @@ If no alarm is currently set, the return value is 0. .\" .Sh STANDARDS .\" The .\" .Fn alarm -.\" function conforms to +.\" function conforms to .\" .St -p1003.1-90 . .Sh HISTORY An .Fn alarm -function appeared in +function appeared in .At v7 . diff --git a/lib/libc/gen/arc4random.3 b/lib/libc/gen/arc4random.3 index a3c54b8..5d3afdb 100644 --- a/lib/libc/gen/arc4random.3 +++ b/lib/libc/gen/arc4random.3 @@ -50,23 +50,23 @@ .Fn arc4random_addrandom "unsigned char *dat" "int datlen" .Sh DESCRIPTION The -.Fn arc4random +.Fn arc4random function uses the key stream generator employed by the arc4 cipher, which uses 8*8 8 bit S-Boxes. The S-Boxes -can be in about +can be in about .if t 2\u\s71700\s10\d .if n (2**1700) states. .Pp The .Fn arc4random_stir -function reads data from +function reads data from .Pa /dev/urandom and uses it to permute the S-Boxes via .Fn arc4random_addrandom . .Pp -There is no need to call +There is no need to call .Fn arc4random_stir before using .Fn arc4random , @@ -78,12 +78,12 @@ automatically initializes itself. .Xr random 3 , .Xr srandomdev 3 .Sh HISTORY -.Pa RC4 +.Pa RC4 has been designed by RSA Data Security, Inc. It was posted anonymously to the USENET and was confirmed to be equivalent by several sources who had access to the original cipher. -Since +Since .Pa RC4 -used to be a trade secret, the cipher is now referred to as +used to be a trade secret, the cipher is now referred to as .Pa ARC4 . diff --git a/lib/libc/gen/confstr.3 b/lib/libc/gen/confstr.3 index 6530f16..02f2746 100644 --- a/lib/libc/gen/confstr.3 +++ b/lib/libc/gen/confstr.3 @@ -73,7 +73,7 @@ is a non-null pointer, and .Fa name has a value, up to .Fa len -\- 1 bytes of the value are copied into the buffer +\- 1 bytes of the value are copied into the buffer .Fa buf . The copied value is always null terminated. .Pp diff --git a/lib/libc/gen/ctermid.3 b/lib/libc/gen/ctermid.3 index 69632e0..84c69c0 100644 --- a/lib/libc/gen/ctermid.3 +++ b/lib/libc/gen/ctermid.3 @@ -73,9 +73,9 @@ provides the same functionality as .Fn ctermid except that if .Ar buf -is a +is a .Dv NULL -pointer, +pointer, .Dv NULL is returned. .Pp diff --git a/lib/libc/gen/daemon.3 b/lib/libc/gen/daemon.3 index c220f22..0b90dab 100644 --- a/lib/libc/gen/daemon.3 +++ b/lib/libc/gen/daemon.3 @@ -70,7 +70,7 @@ returns -1 and sets the global variable .Va errno to any of the errors specified for the library functions .Xr fork 2 -and +and .Xr setsid 2 . .Sh SEE ALSO .Xr fork 2 , diff --git a/lib/libc/gen/directory.3 b/lib/libc/gen/directory.3 index 02033cd..27907af 100644 --- a/lib/libc/gen/directory.3 +++ b/lib/libc/gen/directory.3 @@ -100,7 +100,7 @@ provides the same functionality as .Fn readdir , but the caller must provide a directory .Fa entry -buffer to store the results in. If the read succeeds, +buffer to store the results in. If the read succeeds, .Fa result is pointed at the .Fa entry ; @@ -122,7 +122,7 @@ are good only for the lifetime of the .Dv DIR pointer, .Fa dirp , -from which they are derived. If the directory is closed and then +from which they are derived. If the directory is closed and then reopened, prior values returned by .Fn telldir will no longer be valid. @@ -138,7 +138,7 @@ The new position reverts to the one associated with the .Em directory stream when the .Fn telldir -operation was performed. +operation was performed. .Pp The .Fn rewinddir diff --git a/lib/libc/gen/dllockinit.3 b/lib/libc/gen/dllockinit.3 index ca3c837..93fce2b 100644 --- a/lib/libc/gen/dllockinit.3 +++ b/lib/libc/gen/dllockinit.3 @@ -99,7 +99,7 @@ and signals. This is sufficient for many application level threads packages, which typically use one of these signals to implement preemption. An application which has registered its own locking -methods with +methods with .Nm can restore the default locking by calling .Nm diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3 index 8385068..242d5f4 100644 --- a/lib/libc/gen/dlopen.3 +++ b/lib/libc/gen/dlopen.3 @@ -14,9 +14,9 @@ .\" NO EVENT SHALL SUN MICROSYSTEMS, INC. BE LIABLE FOR ANY SPECIAL, INDIRECT, .\" INCIDENTAL, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING .\" FROM USE OF SUCH SOURCE CODE, REGARDLESS OF THE THEORY OF LIABILITY. -.\" +.\" .\" This source code is provided with no support and without any obligation on -.\" the part of Sun Microsystems, Inc. to assist in its use, correction, +.\" the part of Sun Microsystems, Inc. to assist in its use, correction, .\" modification or enhancement. .\" .\" SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE @@ -59,10 +59,10 @@ defined by such objects, and to remove such objects when their use is no longer required. .Pp .Fn dlopen -provides access to the shared object in +provides access to the shared object in .Fa path , returning a descriptor that can be used for later -references to the object in calls to +references to the object in calls to .Fn dlsym and .Fn dlclose . @@ -78,13 +78,13 @@ if any, is called by the dynamic linker. If .Fa path has already been placed in the address space in a previous call to -.Fn dlopen , -it is not added a second time, although a reference count of +.Fn dlopen , +it is not added a second time, although a reference count of .Fn dlopen operations on .Fa path is maintained. -A null pointer supplied for +A null pointer supplied for .Fa path is interpreted as a reference to the main executable of the process. @@ -125,7 +125,7 @@ in the same DAG. This is the default, but it may be specified explicitly with this flag. .El .Pp -If +If .Fn dlopen fails, it returns a null pointer, and sets an error condition which may be interrogated with @@ -137,7 +137,7 @@ character string .Fa symbol , as it occurs in the shared object identified by .Fa handle . -The symbols exported by objects added to the address space by +The symbols exported by objects added to the address space by .Fn dlopen can be accessed only through calls to .Fn dlsym . @@ -242,14 +242,14 @@ Just before removing a shared object in this way, the dynamic linker calls the object's .Fn _fini function, if such a function is defined by the object. -If +If .Fn dlclose is successful, it returns a value of 0. Otherwise it returns -1, and sets an error condition that can be interrogated with .Fn dlerror . .Pp -The object-intrinsic functions +The object-intrinsic functions .Fn _init and .Fn _fini @@ -260,7 +260,7 @@ using the .Fl export-dynamic option to .Xr ld 1 -for symbols defined in the executable to become visible to +for symbols defined in the executable to become visible to .Fn dlsym . .Pp In previous implementations, it was necessary to prepend an underscore diff --git a/lib/libc/gen/exec.3 b/lib/libc/gen/exec.3 index 11717ef..3399d42 100644 --- a/lib/libc/gen/exec.3 +++ b/lib/libc/gen/exec.3 @@ -155,7 +155,7 @@ errors except .Er ENOEXEC as being ambiguous here, although only the critical error .Er EACCES -is really ambiguous), +is really ambiguous), then these functions will act as if they stat the file to determine whether the file exists and has suitable execute permissions. If it does, they will return immediately with the global variable @@ -260,7 +260,7 @@ upon which they returned. They now return for .Er ETXTBSY , and determine existence and executability more carefully. -In particular, +In particular, .Er EACCES for inaccessible directories in the path prefix is no longer confused with diff --git a/lib/libc/gen/fnmatch.3 b/lib/libc/gen/fnmatch.3 index 0f49e13..f55e477 100644 --- a/lib/libc/gen/fnmatch.3 +++ b/lib/libc/gen/fnmatch.3 @@ -112,12 +112,12 @@ if it immediately follows a slash. Ignore .Nm /* rest after successful -.Fa pattern +.Fa pattern matching. .It Dv FNM_CASEFOLD -Ignore case distinctions in both the -.Fa pattern -and the +Ignore case distinctions in both the +.Fa pattern +and the .Fa string . .El .Sh RETURN VALUES @@ -141,7 +141,7 @@ function conforms to .Sh HISTORY The .Fn fnmatch -function first appeared in +function first appeared in .Bx 4.4 . .Sh BUGS The pattern diff --git a/lib/libc/gen/frexp.3 b/lib/libc/gen/frexp.3 index 3b71079..959df84 100644 --- a/lib/libc/gen/frexp.3 +++ b/lib/libc/gen/frexp.3 @@ -64,7 +64,7 @@ function returns the value .Em x , such that .Em x -is a +is a .Em double with magnitude in the interval .Bq 1/2 , 1 @@ -76,7 +76,7 @@ times 2 raised to the power .Fa *exp . If .Fa value -is zero, both parts of the result are zero. +is zero, both parts of the result are zero. .Sh SEE ALSO .Xr ldexp 3 , .Xr math 3 , diff --git a/lib/libc/gen/fts.3 b/lib/libc/gen/fts.3 index 9cac951..2128354 100644 --- a/lib/libc/gen/fts.3 +++ b/lib/libc/gen/fts.3 @@ -246,7 +246,7 @@ or .Fn fts_read functions, with its .Fa fts_info -field set to +field set to .Dv FTS_DNR , .Dv FTS_ERR or @@ -478,7 +478,7 @@ fields of the structures may .Em never be used in this comparison. -If the +If the .Fa fts_info field is set to .Dv FTS_NS diff --git a/lib/libc/gen/getcap.3 b/lib/libc/gen/getcap.3 index 8431a22..304b801 100644 --- a/lib/libc/gen/getcap.3 +++ b/lib/libc/gen/getcap.3 @@ -36,7 +36,7 @@ .\" $FreeBSD$ .\" .Dd May 13, 1994 -.Dt GETCAP 3 +.Dt GETCAP 3 .Os .Sh NAME .Nm cgetent , @@ -86,13 +86,13 @@ terminated file array and returns a pointer to a .Xr malloc Ns \&'d copy of it in -.Fa buf . +.Fa buf . The .Fn cgetent -function will first look for files ending in -.Nm .db +function will first look for files ending in +.Nm .db (see -.Xr cap_mkdb 1 ) +.Xr cap_mkdb 1 ) before accessing the ASCII file. .Fa Buf must be retained through all subsequent calls to @@ -105,42 +105,42 @@ and but may then be .Xr free 3 Ns \&'d. On success 0 is returned, 1 if the returned -record contains an unresolved -.Nm tc +record contains an unresolved +.Nm tc expansion, \-1 if the requested record couldn't be found, \-2 if a system error was encountered (couldn't open/read a file, etc.) also setting -.Va errno , +.Va errno , and \-3 if a potential reference loop is detected (see .Ic tc= comments below). .Pp The -.Fn cgetset +.Fn cgetset function enables the addition of a character buffer containing a single capability record entry -to the capability database. +to the capability database. Conceptually, the entry is added as the first ``file'' in the database, and -is therefore searched first on the call to +is therefore searched first on the call to .Fn cgetent . -The entry is passed in +The entry is passed in .Fa ent . -If -.Fa ent +If +.Fa ent is .Dv NULL , -the current entry is removed from the database. +the current entry is removed from the database. A call to -.Fn cgetset -must precede the database traversal. It must be called before the -.Fn cgetent +.Fn cgetset +must precede the database traversal. It must be called before the +.Fn cgetent call. If a sequential access is being performed (see below), it must be called before the first sequential access call ( .Fn cgetfirst or .Fn cgetnext -), or be directly preceded by a +), or be directly preceded by a .Fn cgetclose call. On success 0 is returned and \-1 on failure. @@ -213,55 +213,55 @@ failure). .Pp The .Fn cgetustr -function is identical to -.Fn cgetstr +function is identical to +.Fn cgetstr except that it does not expand special characters, but rather returns each character of the capability string literally. .Pp The .Fn cgetfirst and -.Fn cgetnext +.Fn cgetnext functions comprise a function group that provides for sequential access of the .Dv NULL pointer terminated array of file names, .Fa db_array . The -.Fn cgetfirst +.Fn cgetfirst function returns the first record in the database and resets the access to the first record. The -.Fn cgetnext +.Fn cgetnext function returns the next record in the database with respect to the record returned by the previous .Fn cgetfirst or -.Fn cgetnext +.Fn cgetnext call. If there is no such previous call, the first record in the database is returned. Each record is returned in a -.Xr malloc Ns \&'d -copy pointed to by -.Fa buf . +.Xr malloc Ns \&'d +copy pointed to by +.Fa buf . .Ic Tc expansion is done (see -.Ic tc= +.Ic tc= comments below). Upon completion of the database 0 is returned, 1 is returned upon successful -return of record with possibly more remaining (we haven't reached the end of +return of record with possibly more remaining (we haven't reached the end of the database yet), 2 is returned if the record contains an unresolved -.Nm tc +.Nm tc expansion, \-1 is returned if an system error occurred, and \-2 -is returned if a potential reference loop is detected (see +is returned if a potential reference loop is detected (see .Ic tc= comments below). Upon completion of database (0 return) the database is closed. .Pp The -.Fn cgetclose -function closes the sequential access and frees any memory and file descriptors -being used. Note that it does not erase the buffer pushed by a call to +.Fn cgetclose +function closes the sequential access and frees any memory and file descriptors +being used. Note that it does not erase the buffer pushed by a call to .Fn cgetset . .Sh CAPABILITY DATABASE SYNTAX Capability databases are normally @@ -320,7 +320,7 @@ distinguished by their .Fa types . The .Fn cgetcap -function will return a pointer to a value of a name given the capability +function will return a pointer to a value of a name given the capability name and the type of the value. .Pp The types `#' and `=' are conventionally used to denote numeric and @@ -422,7 +422,7 @@ has value .Em number .It Em name No = Em string Ta "string capability" .Em name -has value +has value .Em string .It Em name No \&#@ Ta "the numeric capability" .Em name @@ -494,15 +494,15 @@ on failure. .Pp The .Fn cgetent , -and +and .Fn cgetseq -functions may fail and set +functions may fail and set .Va errno for any of the errors specified for the library functions: -.Xr fopen 3 , +.Xr fopen 3 , .Xr fclose 3 , .Xr open 2 , -and +and .Xr close 2 . .Pp The @@ -510,10 +510,10 @@ The .Fn cgetset , .Fn cgetstr , and -.Fn cgetustr +.Fn cgetustr functions -may fail and set -.Va errno +may fail and set +.Va errno as follows: .Bl -tag -width Er .It Bq Er ENOMEM @@ -530,6 +530,6 @@ There are no checks for loops in .Fn cgetent . .Pp -The buffer added to the database by a call to -.Fn cgetset +The buffer added to the database by a call to +.Fn cgetset is not unique to the database but is rather prepended to any database used. diff --git a/lib/libc/gen/getcwd.3 b/lib/libc/gen/getcwd.3 index 5f40193..27d37e6 100644 --- a/lib/libc/gen/getcwd.3 +++ b/lib/libc/gen/getcwd.3 @@ -147,7 +147,7 @@ allocate memory as necessary is an extension. .Sh HISTORY The .Fn getwd -function appeared in +function appeared in .Bx 4.0 . .Sh BUGS The diff --git a/lib/libc/gen/getdiskbyname.3 b/lib/libc/gen/getdiskbyname.3 index 62036f3..b6b8666 100644 --- a/lib/libc/gen/getdiskbyname.3 +++ b/lib/libc/gen/getdiskbyname.3 @@ -53,7 +53,7 @@ takes a disk name (e.g. and returns a prototype disk label describing its geometry information and the standard disk partition tables. All information is obtained from -the +the .Xr disktab 5 file. .Sh SEE ALSO @@ -63,5 +63,5 @@ file. .Sh HISTORY The .Fn getdiskbyname -function appeared in +function appeared in .Bx 4.3 . diff --git a/lib/libc/gen/getdomainname.3 b/lib/libc/gen/getdomainname.3 index a58dc2e..60f1f26 100644 --- a/lib/libc/gen/getdomainname.3 +++ b/lib/libc/gen/getdomainname.3 @@ -54,7 +54,7 @@ previously set by .Fn setdomainname . The parameter .Fa namelen -specifies the size of the +specifies the size of the .Fa name array. The returned name is null-terminated unless insufficient space is provided. diff --git a/lib/libc/gen/getfsent.3 b/lib/libc/gen/getfsent.3 index 75e3596..82d1ef6 100644 --- a/lib/libc/gen/getfsent.3 +++ b/lib/libc/gen/getfsent.3 @@ -137,13 +137,13 @@ returns nothing. .Sh HISTORY The .Fn getfsent -function appeared in +function appeared in .Bx 4.0 ; the .Fn endfsent , .Fn getfsfile , .Fn getfsspec , -and +and .Fn setfsent functions appeared in .Bx 4.3 . diff --git a/lib/libc/gen/getgrouplist.3 b/lib/libc/gen/getgrouplist.3 index ae5b28a..e9eadde 100644 --- a/lib/libc/gen/getgrouplist.3 +++ b/lib/libc/gen/getgrouplist.3 @@ -58,7 +58,7 @@ the group number from the password file. .Pp The resulting group list is returned in the integer array pointed to by .Fa groups . -The caller specifies the size of the +The caller specifies the size of the .Fa groups array in the integer pointed to by .Fa ngroups ; diff --git a/lib/libc/gen/gethostname.3 b/lib/libc/gen/gethostname.3 index f8ff974..8596a2d 100644 --- a/lib/libc/gen/gethostname.3 +++ b/lib/libc/gen/gethostname.3 @@ -54,7 +54,7 @@ previously set by .Fn sethostname . The parameter .Fa namelen -specifies the size of the +specifies the size of the .Fa name array. The returned name is null-terminated unless insufficient space is provided. diff --git a/lib/libc/gen/getmntinfo.3 b/lib/libc/gen/getmntinfo.3 index 16abf62..01cd55d 100644 --- a/lib/libc/gen/getmntinfo.3 +++ b/lib/libc/gen/getmntinfo.3 @@ -72,19 +72,19 @@ The pointer to the array is stored into If an error occurs, zero is returned and the external variable .Va errno is set to indicate the error. -Although the pointer +Although the pointer .Fa mntbufp -will be unmodified, any information previously returned by +will be unmodified, any information previously returned by .Fn getmntinfo will be lost. .Sh ERRORS The .Fn getmntinfo function -may fail and set errno for any of the errors specified for the library +may fail and set errno for any of the errors specified for the library routines .Xr getfsstat 2 -or +or .Xr malloc 3 . .Sh SEE ALSO .Xr getfsstat 2 , diff --git a/lib/libc/gen/getobjformat.3 b/lib/libc/gen/getobjformat.3 index 4d6c595..1d7c800 100644 --- a/lib/libc/gen/getobjformat.3 +++ b/lib/libc/gen/getobjformat.3 @@ -122,5 +122,5 @@ If present, specifies the object file format to use. Syntax is .Sh HISTORY The .Fn getobjformat -function first appeared in +function first appeared in .Fx 3.0 . diff --git a/lib/libc/gen/getpwent.3 b/lib/libc/gen/getpwent.3 index b606b44..45bd818 100644 --- a/lib/libc/gen/getpwent.3 +++ b/lib/libc/gen/getpwent.3 @@ -53,7 +53,7 @@ .Ft struct passwd * .Fn getpwnam "const char *login" .Ft struct passwd * -.Fn getpwuid "uid_t uid" +.Fn getpwuid "uid_t uid" .Ft int .Fn setpassent "int stayopen" .Ft void diff --git a/lib/libc/gen/getusershell.3 b/lib/libc/gen/getusershell.3 index d4924fa..c61a38a 100644 --- a/lib/libc/gen/getusershell.3 +++ b/lib/libc/gen/getusershell.3 @@ -91,7 +91,7 @@ returns a null pointer (0) on .Sh HISTORY The .Fn getusershell -function appeared in +function appeared in .Bx 4.3 . .Sh BUGS The diff --git a/lib/libc/gen/getvfsent.3 b/lib/libc/gen/getvfsent.3 index 67862b5..8be54c7 100644 --- a/lib/libc/gen/getvfsent.3 +++ b/lib/libc/gen/getvfsent.3 @@ -80,7 +80,7 @@ The .Fn vfsisloadable function returns a non-zero value if a later call to .Fn vfsload name -is likely to succeed. We say +is likely to succeed. We say .Dq likely because .Fn vfsisloadable diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3 index 954dba2..11606f8 100644 --- a/lib/libc/gen/glob.3 +++ b/lib/libc/gen/glob.3 @@ -47,7 +47,7 @@ .Fd #include <glob.h> .Ft int .Fn glob "const char *pattern" "int flags" "int (*errfunc)(const char *, int)" "glob_t *pglob" -.Ft void +.Ft void .Fn globfree "glob_t *pglob" .Sh DESCRIPTION The @@ -99,7 +99,7 @@ field, and a pointer to a list of pointers to pathnames into the .Fa gl_pathv field. The first pointer after the last pathname is -.Dv NULL . +.Dv NULL . If the pattern does not match any pathnames, the returned number of matched paths is set to zero. .Pp @@ -220,33 +220,33 @@ This extension is provided to allow programs such as .Xr restore 8 to provide globbing from directories stored on tape. .It Dv GLOB_BRACE -Pre-process the pattern string to expand -.Ql {pat,pat,...} -strings like +Pre-process the pattern string to expand +.Ql {pat,pat,...} +strings like .Xr csh 1 . -The pattern +The pattern .Ql {} is left unexpanded for historical reasons (and -.Xr csh 1 -does the same thing to +.Xr csh 1 +does the same thing to ease typing -of -.Xr find 1 +of +.Xr find 1 patterns). .It Dv GLOB_MAGCHAR Set by the .Fn glob function if the pattern included globbing characters. -See the description of the usage of the +See the description of the usage of the .Fa gl_matchc structure member for more details. .It Dv GLOB_NOMAGIC -Is the same as -.Dv GLOB_NOCHECK +Is the same as +.Dv GLOB_NOCHECK but it only appends the .Fa pattern if it does not contain any of the special characters ``*'', ``?'' or ``[''. -.Dv GLOB_NOMAGIC +.Dv GLOB_NOMAGIC is provided to simplify implementing the historic .Xr csh 1 globbing behavior and should probably not be used anywhere else. @@ -266,7 +266,7 @@ If, during the search, a directory is encountered that cannot be opened or read and .Fa errfunc is -.Pf non- Dv NULL , +.Pf non- Dv NULL , .Fn glob calls .Fa (*errfunc)(path, errno) . @@ -283,7 +283,7 @@ call to The error routine can suppress this action by testing for .Dv ENOENT and -.Dv ENOTDIR ; +.Dv ENOTDIR ; however, the .Dv GLOB_ERR flag will still cause an immediate @@ -333,16 +333,16 @@ contain the values described below: .Bl -tag -width GLOB_NOCHECK .It Fa gl_pathc contains the total number of matched pathnames so far. -This includes other matches from previous invocations of +This includes other matches from previous invocations of .Fn glob -if +if .Dv GLOB_APPEND was specified. .It Fa gl_matchc contains the number of matched pathnames in the current invocation of .Fn glob . .It Fa gl_flags -contains a copy of the +contains a copy of the .Fa flags parameter with the bit .Dv GLOB_MAGCHAR @@ -352,7 +352,7 @@ contained any of the special characters ``*'', ``?'' or ``['', cleared if not. .It Fa gl_pathv contains a pointer to a -.Dv NULL Ns -terminated +.Dv NULL Ns -terminated list of matched pathnames. However, if .Fa gl_pathc @@ -416,9 +416,9 @@ that the flags .Dv GLOB_QUOTE, and .Dv GLOB_TILDE, -and the fields +and the fields .Fa gl_matchc -and +and .Fa gl_flags should not be used by applications striving for strict .Tn POSIX diff --git a/lib/libc/gen/initgroups.3 b/lib/libc/gen/initgroups.3 index f48548e..27155fa 100644 --- a/lib/libc/gen/initgroups.3 +++ b/lib/libc/gen/initgroups.3 @@ -71,7 +71,7 @@ returns \-1 if it was not invoked by the super-user. .Sh HISTORY The .Fn initgroups -function appeared in +function appeared in .Bx 4.2 . .Sh BUGS The diff --git a/lib/libc/gen/isinf.3 b/lib/libc/gen/isinf.3 index ee7558a..3fdc582 100644 --- a/lib/libc/gen/isinf.3 +++ b/lib/libc/gen/isinf.3 @@ -43,9 +43,9 @@ .Sh LIBRARY .Lb libc .Sh SYNOPSIS -.Ft int +.Ft int .Fn isinf double -.Ft int +.Ft int .Fn isnan double .Ft int .Fn isnanf float diff --git a/lib/libc/gen/modf.3 b/lib/libc/gen/modf.3 index e1a8117..f403315 100644 --- a/lib/libc/gen/modf.3 +++ b/lib/libc/gen/modf.3 @@ -55,7 +55,7 @@ function breaks the argument .Fa value into integral and fractional parts, each of which has the same sign as the argument. -It stores the integral part as a +It stores the integral part as a .Em double in the object pointed to by .Fa iptr . diff --git a/lib/libc/gen/msgctl.3 b/lib/libc/gen/msgctl.3 index 9e446fa..7f948f2 100644 --- a/lib/libc/gen/msgctl.3 +++ b/lib/libc/gen/msgctl.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: msgctl.2,v 1.1 1995/10/16 23:49:15 jtc Exp $ +.\" $NetBSD: msgctl.2,v 1.1 1995/10/16 23:49:15 jtc Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden .\" All rights reserved. @@ -126,7 +126,7 @@ The values are taken from the corresponding fields in the structure pointed to by .Fa buf . This operation can only be executed by the super-user, or a process that -has an effective user id equal to either +has an effective user id equal to either .Va msg_perm.cuid or .Va msg_perm.uid @@ -145,7 +145,7 @@ Remove the message queue specified by .Fa msqid and destroy the data associated with it. Only the super-user or a process -with an effective uid equal to the +with an effective uid equal to the .Va msg_perm.cuid or .Va msg_perm.uid diff --git a/lib/libc/gen/msgget.3 b/lib/libc/gen/msgget.3 index 20e7401..91a61e0 100644 --- a/lib/libc/gen/msgget.3 +++ b/lib/libc/gen/msgget.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: msgget.2,v 1.1 1995/10/16 23:49:19 jtc Exp $ +.\" $NetBSD: msgget.2,v 1.1 1995/10/16 23:49:19 jtc Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden .\" All rights reserved. @@ -68,7 +68,7 @@ structure, see .Xr msgctl 3 ) is initialized as follows: .Bl -bullet -.It +.It .Va msg_perm.cuid and .Va msg_perm.uid @@ -88,7 +88,7 @@ is set to the lower 9 bits of .Va msg_lspid , .Va msg_lrpid , .Va msg_rtime , -and +and .Va msg_stime are set to 0. .It diff --git a/lib/libc/gen/msgrcv.3 b/lib/libc/gen/msgrcv.3 index 21c9c3e..39a4340 100644 --- a/lib/libc/gen/msgrcv.3 +++ b/lib/libc/gen/msgrcv.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: msgrcv.2,v 1.1 1995/10/16 23:49:20 jtc Exp $ +.\" $NetBSD: msgrcv.2,v 1.1 1995/10/16 23:49:20 jtc Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden .\" All rights reserved. @@ -46,7 +46,7 @@ .Ft int .Fn msgrcv "int msqid" "void *msgp" "size_t msgsz" "long msgtyp" "int msgflg" .Sh DESCRIPTION -The +The .Fn msgrcv function receives a message from the message queue specified in .Fa msqid , diff --git a/lib/libc/gen/msgsnd.3 b/lib/libc/gen/msgsnd.3 index 9d445d5..e022ec0 100644 --- a/lib/libc/gen/msgsnd.3 +++ b/lib/libc/gen/msgsnd.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: msgsnd.2,v 1.1 1995/10/16 23:49:24 jtc Exp $ +.\" $NetBSD: msgsnd.2,v 1.1 1995/10/16 23:49:24 jtc Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden .\" All rights reserved. @@ -46,7 +46,7 @@ .Ft int .Fn msgsnd "int msqid" "void *msgp" "size_t msgsz" "int msgflg" .Sh DESCRIPTION -The +The .Fn msgsnd function sends a message to the message queue specified in .Fa msqid . @@ -62,7 +62,7 @@ consist of the following members: .Va mtype is an integer greater than 0 that can be used for selecting messages (see .Xr msgrcv 3 ) , -.Va mtext +.Va mtext is an array of bytes, with a size up to that of the system limit .Pf ( Dv MSGMAX ) . .Pp diff --git a/lib/libc/gen/nice.3 b/lib/libc/gen/nice.3 index d464a4d..df1291f 100644 --- a/lib/libc/gen/nice.3 +++ b/lib/libc/gen/nice.3 @@ -68,5 +68,5 @@ Children inherit the priority of their parent processes via .Sh HISTORY A .Fn nice -syscall appeared in +syscall appeared in .At v6 . diff --git a/lib/libc/gen/pause.3 b/lib/libc/gen/pause.3 index b9d2031..80d1f9f 100644 --- a/lib/libc/gen/pause.3 +++ b/lib/libc/gen/pause.3 @@ -82,5 +82,5 @@ The call was interrupted. A .Fn pause syscall -appeared in +appeared in .At v6 . diff --git a/lib/libc/gen/psignal.3 b/lib/libc/gen/psignal.3 index 3867a32..ad033e3 100644 --- a/lib/libc/gen/psignal.3 +++ b/lib/libc/gen/psignal.3 @@ -109,5 +109,5 @@ and .Sh HISTORY The .Fn psignal -function appeared in +function appeared in .Bx 4.2 . diff --git a/lib/libc/gen/pwcache.3 b/lib/libc/gen/pwcache.3 index 7c20d94..00e0295 100644 --- a/lib/libc/gen/pwcache.3 +++ b/lib/libc/gen/pwcache.3 @@ -53,7 +53,7 @@ The function returns the user name associated with the argument .Fa uid . The user name is cached so that multiple calls with the same -.Fa uid +.Fa uid do not require additional calls to .Xr getpwuid 3 . If there is no user associated with the diff --git a/lib/libc/gen/rand48.3 b/lib/libc/gen/rand48.3 index b7ba681..0a9990b7 100644 --- a/lib/libc/gen/rand48.3 +++ b/lib/libc/gen/rand48.3 @@ -30,7 +30,7 @@ .Lb libc .Sh SYNOPSIS .Fd #include <stdlib.h> -.Ft double +.Ft double .Fn drand48 void .Ft double .Fn erand48 "unsigned short xseed[3]" diff --git a/lib/libc/gen/scandir.3 b/lib/libc/gen/scandir.3 index db74d3b..3f69078 100644 --- a/lib/libc/gen/scandir.3 +++ b/lib/libc/gen/scandir.3 @@ -105,5 +105,5 @@ The .Fn scandir and .Fn alphasort -functions appeared in +functions appeared in .Bx 4.2 . diff --git a/lib/libc/gen/setmode.3 b/lib/libc/gen/setmode.3 index 2ea5d80..548f02e 100644 --- a/lib/libc/gen/setmode.3 +++ b/lib/libc/gen/setmode.3 @@ -87,16 +87,16 @@ If the mode passed to is invalid or if memory cannot be allocated for the return value, .Fn setmode returns -.Dv NULL . +.Dv NULL . .Pp -The value returned from -.Fn setmode -is obtained from -.Fn malloc +The value returned from +.Fn setmode +is obtained from +.Fn malloc and should be returned to the system with -.Fn free -when the program is done with it, generally after a call to -.Fn getmode . +.Fn free +when the program is done with it, generally after a call to +.Fn getmode . .Sh ERRORS The .Fn setmode diff --git a/lib/libc/gen/shm_open.3 b/lib/libc/gen/shm_open.3 index d8af879..1c71772 100644 --- a/lib/libc/gen/shm_open.3 +++ b/lib/libc/gen/shm_open.3 @@ -130,7 +130,7 @@ or on a shared memory object, or on the descriptor returned by .Fn shm_open , is undefined. -It is also undefined whether the shared memory object itself, or its +It is also undefined whether the shared memory object itself, or its contents, persist across reboots. .Sh RETURN VALUES If successful, diff --git a/lib/libc/gen/siginterrupt.3 b/lib/libc/gen/siginterrupt.3 index 4c38732..b6d385d 100644 --- a/lib/libc/gen/siginterrupt.3 +++ b/lib/libc/gen/siginterrupt.3 @@ -67,7 +67,7 @@ and no data has been transferred, the system call will return \-1 with the global variable .Va errno set to -.Dv EINTR . +.Dv EINTR . Interrupted system calls that have started transferring data will return the amount of data actually transferred. System call interrupt is the signal behavior found on @@ -110,5 +110,5 @@ A \-1 value indicates that an invalid signal number has been supplied. .Sh HISTORY The .Fn siginterrupt -function appeared in +function appeared in .Bx 4.3 . diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3 index e0dc9e6..4435573 100644 --- a/lib/libc/gen/signal.3 +++ b/lib/libc/gen/signal.3 @@ -49,7 +49,7 @@ or in FreeBSD's equivalent but easier to read typedef'd version: .Ft typedef "void \*(lp*sig_t\*(rp \*(lpint\*(rp" -.Ft sig_t +.Ft sig_t .Fn signal "int sig" "sig_t func" .Sh DESCRIPTION This @@ -231,5 +231,5 @@ or .Sh HISTORY This .Nm signal -facility appeared in +facility appeared in .Bx 4.0 . diff --git a/lib/libc/gen/stringlist.3 b/lib/libc/gen/stringlist.3 index e42706b..bd5e070 100644 --- a/lib/libc/gen/stringlist.3 +++ b/lib/libc/gen/stringlist.3 @@ -95,7 +95,7 @@ Returns a pointer to a .It Fn sl_free Releases memory occupied by .Ar sl -and the +and the .Ar sl->sl_str array. If diff --git a/lib/libc/gen/strtofflags.3 b/lib/libc/gen/strtofflags.3 index 10f86c9..529bd80 100644 --- a/lib/libc/gen/strtofflags.3 +++ b/lib/libc/gen/strtofflags.3 @@ -57,14 +57,14 @@ If no flags are set a zero length string is returned. If memory cannot be allocated for the return value, .Fn fflagstostr returns -.Dv NULL . +.Dv NULL . .Pp -The value returned from +The value returned from .Fn fflagstostr -is obtained from -.Fn malloc +is obtained from +.Fn malloc and should be returned to the system with -.Fn free +.Fn free when the program is done with it. .Pp The diff --git a/lib/libc/gen/sysconf.3 b/lib/libc/gen/sysconf.3 index 102a3e3..dd4e427 100644 --- a/lib/libc/gen/sysconf.3 +++ b/lib/libc/gen/sysconf.3 @@ -122,7 +122,7 @@ The maximum number of repeated occurrences of a regular expression permitted when using interval notation. .It Li _SC_2_VERSION The version of POSIX 1003.2 with which the system attempts to comply. -.It Li _SC_2_C_BIND +.It Li _SC_2_C_BIND Return 1 if the system's C-language development facilities support the C-Language Bindings Option, otherwise \-1. .It Li _SC_2_C_DEV diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3 index 5ed1261..2752042 100644 --- a/lib/libc/gen/sysctl.3 +++ b/lib/libc/gen/sysctl.3 @@ -57,7 +57,7 @@ The information available from .Fn sysctl consists of integers, strings, and tables. Information may be retrieved and set from the command interface -using the +using the .Xr sysctl 8 utility. .Pp @@ -102,7 +102,7 @@ and .Fa oldlenp should be set to NULL. .Pp -The size of the available data can be determined by calling +The size of the available data can be determined by calling .Fn sysctl with a NULL parameter for .Fa oldp . @@ -177,9 +177,9 @@ Each time it runs, .Fn sysctl gets the list of debugging variables from the kernel and displays their current values. -The system defines twenty +The system defines twenty .Ns ( Va struct ctldebug ) -variables named +variables named .Nm debug0 through .Nm debug19 . @@ -382,7 +382,7 @@ Return profiling information about the kernel. If the kernel is not compiled for profiling, attempts to retrieve any of the KERN_PROF values will fail with EOPNOTSUPP. -The third level names for the string and integer profiling information +The third level names for the string and integer profiling information is detailed below. The changeable column shows whether a process with appropriate privilege may change the value. @@ -495,7 +495,7 @@ The currently defined protocols and names are: The variables are as follows: .Bl -tag -width "123456" .It Li icmp.bmcastecho -Returns 1 if an ICMP echo request to a broadcast or multicast address is +Returns 1 if an ICMP echo request to a broadcast or multicast address is to be answered. .It Li icmp.maskrepl Returns 1 if ICMP network mask requests are to be answered. @@ -642,7 +642,7 @@ privilege may change the value. .It VM\_V\_FREE\_RESERVED integer yes .It VM\_V\_FREE\_TARGET integer yes .It VM\_V\_INACTIVE\_TARGET integer yes -.It VM\_V\_PAGEOUT\_FREE\_MIN integer yes +.It VM\_V\_PAGEOUT\_FREE\_MIN integer yes .El .Pp .Bl -tag -width "123456" diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index 13d1d19..093811b 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -147,7 +147,7 @@ cannot pass the message to .Xr syslogd 8 it will attempt to write the message to the console .Pq Dq Pa /dev/console. -.It Dv LOG_NDELAY +.It Dv LOG_NDELAY Open the connection to .Xr syslogd 8 immediately. @@ -218,7 +218,7 @@ Similarly for .Dv LOG_LOCAL1 through .Dv LOG_LOCAL7 . -.El +.El .Pp The .Fn closelog @@ -274,5 +274,5 @@ syslog(LOG_INFO|LOG_LOCAL2, "foobar error: %m"); .Xr syslogd 8 .Sh HISTORY These -functions appeared in +functions appeared in .Bx 4.2 . diff --git a/lib/libc/gen/times.3 b/lib/libc/gen/times.3 index 12bd830..85a33f7 100644 --- a/lib/libc/gen/times.3 +++ b/lib/libc/gen/times.3 @@ -42,7 +42,7 @@ .Lb libc .Sh SYNOPSIS .Fd #include <sys/times.h> -.Ft clock_t +.Ft clock_t .Fn times "struct tms *tp" .Sh DESCRIPTION .Bf -symbolic diff --git a/lib/libc/gen/ttyname.3 b/lib/libc/gen/ttyname.3 index e09bd6a..5648c30 100644 --- a/lib/libc/gen/ttyname.3 +++ b/lib/libc/gen/ttyname.3 @@ -94,7 +94,7 @@ The function returns the null terminated name if the device is found and .Fn isatty -is true; otherwise +is true; otherwise a .Dv NULL pointer is returned. diff --git a/lib/libc/gen/ualarm.3 b/lib/libc/gen/ualarm.3 index b42021e..1fac904 100644 --- a/lib/libc/gen/ualarm.3 +++ b/lib/libc/gen/ualarm.3 @@ -42,7 +42,7 @@ .Lb libc .Sh SYNOPSIS .Fd #include <unistd.h> -.Ft u_int +.Ft u_int .Fn ualarm "u_int microseconds" "u_int interval" .Sh DESCRIPTION .Bf -symbolic @@ -97,5 +97,5 @@ A microsecond is 0.000001 seconds. .Sh HISTORY The .Fn ualarm -function appeared in +function appeared in .Bx 4.3 . diff --git a/lib/libc/gen/usleep.3 b/lib/libc/gen/usleep.3 index 51e1bf2..7a27d80 100644 --- a/lib/libc/gen/usleep.3 +++ b/lib/libc/gen/usleep.3 @@ -79,5 +79,5 @@ action was to invoke a signal-catching function. .Sh HISTORY The .Fn usleep -function appeared in +function appeared in .Bx 4.3 . diff --git a/lib/libc/gen/utime.3 b/lib/libc/gen/utime.3 index bee33be..e503898 100644 --- a/lib/libc/gen/utime.3 +++ b/lib/libc/gen/utime.3 @@ -81,7 +81,7 @@ for any of the errors specified for the library function .Sh HISTORY A .Fn utime -function appeared in +function appeared in .At v7 . .Sh STANDARDS The diff --git a/lib/libc/gen/valloc.3 b/lib/libc/gen/valloc.3 index 25ce131..a7af23f 100644 --- a/lib/libc/gen/valloc.3 +++ b/lib/libc/gen/valloc.3 @@ -69,7 +69,7 @@ a null pointer is returned .Sh HISTORY The .Fn valloc -function appeared in +function appeared in .Bx 3.0 . .Sh BUGS A diff --git a/lib/libc/sys/shm_open.2 b/lib/libc/sys/shm_open.2 index d8af879..1c71772 100644 --- a/lib/libc/sys/shm_open.2 +++ b/lib/libc/sys/shm_open.2 @@ -130,7 +130,7 @@ or on a shared memory object, or on the descriptor returned by .Fn shm_open , is undefined. -It is also undefined whether the shared memory object itself, or its +It is also undefined whether the shared memory object itself, or its contents, persist across reboots. .Sh RETURN VALUES If successful, |