diff options
| author | Ruslan Ermilov <ru@FreeBSD.org> | 2001-08-17 15:43:08 +0000 |
|---|---|---|
| committer | Ruslan Ermilov <ru@FreeBSD.org> | 2001-08-17 15:43:08 +0000 |
| commit | a8510bf414fba1220ac5eaee5b652a5813ca34ec (patch) | |
| tree | ef163d34be4ccad56680ff5d91213c75f0a6d031 /lib | |
| parent | 5b18d15e79836756585ab7bebd017dbe7e4c2a4d (diff) | |
Notes
Diffstat (limited to 'lib')
342 files changed, 903 insertions, 1069 deletions
diff --git a/lib/libalias/libalias.3 b/lib/libalias/libalias.3 index 995d965dac58..aa804db4ab74 100644 --- a/lib/libalias/libalias.3 +++ b/lib/libalias/libalias.3 @@ -27,7 +27,7 @@ .\" .Dd April 13, 2000 .Dt LIBALIAS 3 -.Os FreeBSD +.Os .Sh NAME .Nm libalias .Nd packet aliasing library for masquerading and network address translation @@ -170,12 +170,10 @@ Mainly useful for debugging when the log file is viewed continuously with .It Dv PKT_ALIAS_DENY_INCOMING If this mode bit is set, all incoming packets associated with new TCP connections or new UDP transactions will be marked for being ignored -.Po -.Fn PacketAliasIn +.Fn ( PacketAliasIn returns .Dv PKT_ALIAS_IGNORED -code -.Pc +code) by the calling program. Response packets to connections or transactions initiated from the packet aliasing host or local network will be unaffected. diff --git a/lib/libc/compat-43/creat.2 b/lib/libc/compat-43/creat.2 index 1ec50b0d4347..334fc01de4dc 100644 --- a/lib/libc/compat-43/creat.2 +++ b/lib/libc/compat-43/creat.2 @@ -34,7 +34,7 @@ .\" .Dd June 2, 1993 .Dt CREAT 2 -.Os BSD 4 +.Os .Sh NAME .Nm creat .Nd create a new file diff --git a/lib/libc/compat-43/gethostid.3 b/lib/libc/compat-43/gethostid.3 index 3139fcc61b29..dcf62505be74 100644 --- a/lib/libc/compat-43/gethostid.3 +++ b/lib/libc/compat-43/gethostid.3 @@ -34,7 +34,7 @@ .\" .Dd June 2, 1993 .Dt GETHOSTID 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm gethostid , .Nm sethostid diff --git a/lib/libc/compat-43/killpg.2 b/lib/libc/compat-43/killpg.2 index 68e5e18f01a9..13b8f06fac8a 100644 --- a/lib/libc/compat-43/killpg.2 +++ b/lib/libc/compat-43/killpg.2 @@ -34,7 +34,7 @@ .\" .Dd June 2, 1993 .Dt KILLPG 2 -.Os BSD 4 +.Os .Sh NAME .Nm killpg .Nd send signal to a process group @@ -66,10 +66,7 @@ the sender must be the super-user. As a single special case the continue signal SIGCONT may be sent to any process that is a descendant of the current process. .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. Otherwise, -a value of -1 is returned and the global variable -.Va errno -is set to indicate the error. +.Rv -std killpg .Sh ERRORS .Fn Killpg will fail and no signal will be sent if: diff --git a/lib/libc/compat-43/setruid.3 b/lib/libc/compat-43/setruid.3 index 1d1e884c9faa..b90656b2b2a9 100644 --- a/lib/libc/compat-43/setruid.3 +++ b/lib/libc/compat-43/setruid.3 @@ -34,7 +34,7 @@ .\" .Dd June 2, 1993 .Dt SETRUID 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm setruid , .Nm setrgid diff --git a/lib/libc/compat-43/sigpause.2 b/lib/libc/compat-43/sigpause.2 index 917874648cc2..53333153eeff 100644 --- a/lib/libc/compat-43/sigpause.2 +++ b/lib/libc/compat-43/sigpause.2 @@ -34,7 +34,7 @@ .\" .Dd June 2, 1993 .Dt SIGPAUSE 2 -.Os BSD 4 +.Os .Sh NAME .Nm sigpause .Nd atomically release blocked signals and wait for interrupt diff --git a/lib/libc/compat-43/sigsetmask.2 b/lib/libc/compat-43/sigsetmask.2 index c39e566ce81b..639268e01817 100644 --- a/lib/libc/compat-43/sigsetmask.2 +++ b/lib/libc/compat-43/sigsetmask.2 @@ -34,7 +34,7 @@ .\" .Dd June 2, 1993 .Dt SIGSETMASK 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm sigsetmask .Nd set current signal mask diff --git a/lib/libc/compat-43/sigvec.2 b/lib/libc/compat-43/sigvec.2 index 3b6a22bc2044..77dfb67ef977 100644 --- a/lib/libc/compat-43/sigvec.2 +++ b/lib/libc/compat-43/sigvec.2 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt SIGVEC 2 -.Os BSD 4 +.Os .Sh NAME .Nm sigvec .Nd software signal facilities @@ -53,7 +53,8 @@ struct sigvec { .Fn sigvec "int sig" "struct sigvec *vec" "struct sigvec *ovec" .Sh DESCRIPTION .Bf -symbolic -This interface is made obsolete by sigaction(2). +This interface is made obsolete by +.Xr sigaction 2 . .Ef .Pp The system defines a set of signals that may be delivered to a process. @@ -255,10 +256,7 @@ flag is not available in .Bx 4.2 , hence it should not be used if backward compatibility is needed. .Sh RETURN VALUES -A 0 value indicated that the call succeeded. A \-1 return value -indicates an error occurred and -.Va errno -is set to indicated the reason. +.Rv -std sigvec .Sh ERRORS .Fn Sigvec will fail and no new signal handler will be installed if one diff --git a/lib/libc/db/man/dbm.3 b/lib/libc/db/man/dbm.3 index cb0cb6d7407f..e8a21bbc5aff 100644 --- a/lib/libc/db/man/dbm.3 +++ b/lib/libc/db/man/dbm.3 @@ -91,7 +91,7 @@ and .Fa mode are passed to .Xr open 2 . -.Pq Dv O_RDWR \*(Ba O_CREAT +.Pq Dv O_RDWR | O_CREAT is a typical value for .Fa flags ; .Li 0660 diff --git a/lib/libc/db/man/mpool.3 b/lib/libc/db/man/mpool.3 index 58fb5db405c3..d3d401d14e12 100644 --- a/lib/libc/db/man/mpool.3 +++ b/lib/libc/db/man/mpool.3 @@ -232,7 +232,7 @@ function may fail and set for any of the errors specified for the library routine .Xr free 3 . .Sh SEE ALSO -.Xr dbopen 3 , .Xr btree 3 , +.Xr dbopen 3 , .Xr hash 3 , .Xr recno 3 diff --git a/lib/libc/gen/alarm.3 b/lib/libc/gen/alarm.3 index a65cd01df5db..94f05901912c 100644 --- a/lib/libc/gen/alarm.3 +++ b/lib/libc/gen/alarm.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt ALARM 3 -.Os BSD 4 +.Os .Sh NAME .Nm alarm .Nd set signal timer alarm @@ -46,7 +46,8 @@ .Fn alarm "unsigned int seconds" .Sh DESCRIPTION .Bf -symbolic -This interface is made obsolete by setitimer(2). +This interface is made obsolete by +.Xr setitimer 2 . .Ef .Pp The diff --git a/lib/libc/gen/arc4random.3 b/lib/libc/gen/arc4random.3 index 5d3afdb40c27..7e97d0908f0f 100644 --- a/lib/libc/gen/arc4random.3 +++ b/lib/libc/gen/arc4random.3 @@ -37,7 +37,7 @@ .Nm arc4random , .Nm arc4random_stir , .Nm arc4random_addrandom -.Nd arc4 random number generator. +.Nd arc4 random number generator .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/gen/confstr.3 b/lib/libc/gen/confstr.3 index 8071f8e58aef..2346d6dca6a5 100644 --- a/lib/libc/gen/confstr.3 +++ b/lib/libc/gen/confstr.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt CONFSTR 3 -.Os BSD 4 +.Os .Sh NAME .Nm confstr .Nd get string-valued configurable variables @@ -59,7 +59,7 @@ The .Fa name argument specifies the system variable to be queried. Symbolic constants for each name value are found in the include file -.Li <unistd.h> . +.Aq Pa unistd.h . The .Fa len argument specifies the size of the buffer referenced by the @@ -107,7 +107,7 @@ was truncated. The .Fn confstr function may fail and set -.Va error +.Va errno for any of the errors specified for the library functions .Xr malloc 3 and diff --git a/lib/libc/gen/devname.3 b/lib/libc/gen/devname.3 index 2f39c80e9cd1..d7cc940feea5 100644 --- a/lib/libc/gen/devname.3 +++ b/lib/libc/gen/devname.3 @@ -34,7 +34,7 @@ .\" .Dd April 29, 1995 .Dt DEVNAME 3 -.Os BSD 4.4 +.Os .Sh NAME .Nm devname .Nd get device name diff --git a/lib/libc/gen/directory.3 b/lib/libc/gen/directory.3 index 8061d1db4d6e..e9f3a90ce9a2 100644 --- a/lib/libc/gen/directory.3 +++ b/lib/libc/gen/directory.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt DIRECTORY 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm opendir , .Nm readdir , diff --git a/lib/libc/gen/dladdr.3 b/lib/libc/gen/dladdr.3 index 36c58865f254..596fc7a9239c 100644 --- a/lib/libc/gen/dladdr.3 +++ b/lib/libc/gen/dladdr.3 @@ -26,7 +26,7 @@ .\" $FreeBSD$ .\" .Dd February 5, 1998 -.Os FreeBSD +.Os .Dt DLADDR 3 .Sh NAME .Nm dladdr diff --git a/lib/libc/gen/dllockinit.3 b/lib/libc/gen/dllockinit.3 index 0e97857dcff0..9301809b27c0 100644 --- a/lib/libc/gen/dllockinit.3 +++ b/lib/libc/gen/dllockinit.3 @@ -26,7 +26,7 @@ .\" $FreeBSD$ .\" .Dd July 5, 2000 -.Os FreeBSD +.Os .Dt DLLOCKINIT 3 .Sh NAME .Nm dllockinit diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3 index a45362de338d..480d7c3a6293 100644 --- a/lib/libc/gen/dlopen.3 +++ b/lib/libc/gen/dlopen.3 @@ -33,7 +33,7 @@ .\" $FreeBSD$ .\" .Dd September 24, 1989 -.Os FreeBSD +.Os .Dt DLOPEN 3 .Sh NAME .Nm dlopen , dlsym , dlerror , dlclose diff --git a/lib/libc/gen/err.3 b/lib/libc/gen/err.3 index f0303c0a785e..792b5e67f186 100644 --- a/lib/libc/gen/err.3 +++ b/lib/libc/gen/err.3 @@ -34,7 +34,7 @@ .\" .Dd March 6, 1999 .Dt ERR 3 -.Os BSD 4 +.Os .Sh NAME .Nm err , .Nm verr , diff --git a/lib/libc/gen/fmtcheck.3 b/lib/libc/gen/fmtcheck.3 index f8a7eb966612..972f0a8d1df5 100644 --- a/lib/libc/gen/fmtcheck.3 +++ b/lib/libc/gen/fmtcheck.3 @@ -37,7 +37,9 @@ .Dt FMTCHECK 3 .Sh NAME .Nm fmtcheck -.Nd sanitizes user-supplied printf(3)-style format string +.Nd sanitizes user-supplied +.Xr printf 3 Ns -style +format string .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/gen/getbsize.3 b/lib/libc/gen/getbsize.3 index 55b6f3f04563..828ab2c74d13 100644 --- a/lib/libc/gen/getbsize.3 +++ b/lib/libc/gen/getbsize.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETBSIZE 3 -.Os BSD 4.4 +.Os .Sh NAME .Nm getbsize .Nd get user block size diff --git a/lib/libc/gen/getcwd.3 b/lib/libc/gen/getcwd.3 index b9d479037f27..f7c851dddaec 100644 --- a/lib/libc/gen/getcwd.3 +++ b/lib/libc/gen/getcwd.3 @@ -34,7 +34,7 @@ .\" .Dd November 24, 1997 .Dt GETCWD 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm getcwd , .Nm getwd diff --git a/lib/libc/gen/getdiskbyname.3 b/lib/libc/gen/getdiskbyname.3 index b6b86664bf53..9acceaf95ee2 100644 --- a/lib/libc/gen/getdiskbyname.3 +++ b/lib/libc/gen/getdiskbyname.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETDISKBYNAME 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm getdiskbyname .Nd get generic disk description by its name @@ -48,7 +48,7 @@ The .Fn getdiskbyname function -takes a disk name (e.g. +takes a disk name (e.g.\& .Ql rm03 ) and returns a prototype disk label describing its geometry information and the standard diff --git a/lib/libc/gen/getdomainname.3 b/lib/libc/gen/getdomainname.3 index 60f1f26edde1..4d6f72376655 100644 --- a/lib/libc/gen/getdomainname.3 +++ b/lib/libc/gen/getdomainname.3 @@ -34,7 +34,7 @@ .\" .Dd May 6, 1994 .Dt GETDOMAINNAME 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm getdomainname , .Nm setdomainname diff --git a/lib/libc/gen/getfsent.3 b/lib/libc/gen/getfsent.3 index 82d1ef66cf34..2998246ea916 100644 --- a/lib/libc/gen/getfsent.3 +++ b/lib/libc/gen/getfsent.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETFSENT 3 -.Os BSD 4 +.Os .Sh NAME .Nm getfsent , .Nm getfsspec , diff --git a/lib/libc/gen/gethostname.3 b/lib/libc/gen/gethostname.3 index 8596a2d1c05c..88863e5737e9 100644 --- a/lib/libc/gen/gethostname.3 +++ b/lib/libc/gen/gethostname.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETHOSTNAME 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm gethostname , .Nm sethostname diff --git a/lib/libc/gen/getnetgrent.3 b/lib/libc/gen/getnetgrent.3 index 3258df66c4a6..5f70293a5921 100644 --- a/lib/libc/gen/getnetgrent.3 +++ b/lib/libc/gen/getnetgrent.3 @@ -121,7 +121,8 @@ netgroup database file The netgroup members have three string fields to maintain compatibility with other vendor implementations, however it is not obvious what use the .Sy domain -string has within BSD. +string has within +.Bx . .Sh BUGS The function .Fn getnetgrent diff --git a/lib/libc/gen/getobjformat.3 b/lib/libc/gen/getobjformat.3 index 33240c8d4d08..8e282c5dcd67 100644 --- a/lib/libc/gen/getobjformat.3 +++ b/lib/libc/gen/getobjformat.3 @@ -26,7 +26,7 @@ .\" .Dd September 7, 1998 .Dt GETOBJFORMAT 3 -.Os FreeBSD +.Os .Sh NAME .Nm getobjformat .Nd get preferred object file format diff --git a/lib/libc/gen/getpagesize.3 b/lib/libc/gen/getpagesize.3 index 5fd90df3320a..8b5e2f7aaf6e 100644 --- a/lib/libc/gen/getpagesize.3 +++ b/lib/libc/gen/getpagesize.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETPAGESIZE 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm getpagesize .Nd get system page size diff --git a/lib/libc/gen/getpwent.3 b/lib/libc/gen/getpwent.3 index 5442555a834d..33f43f9c6061 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 @@ -131,7 +131,7 @@ The function closes any open files. .Pp -These routines have been written to ``shadow'' the password file, e.g. +These routines have been written to ``shadow'' the password file, e.g.\& allow only certain programs to have access to the encrypted password. If the process which calls them has an effective uid of 0, the encrypted password will be returned, otherwise, the password field of the returned diff --git a/lib/libc/gen/getttyent.3 b/lib/libc/gen/getttyent.3 index cc108e671892..88762e10cc8d 100644 --- a/lib/libc/gen/getttyent.3 +++ b/lib/libc/gen/getttyent.3 @@ -34,7 +34,7 @@ .\" .Dd November 17, 1996 .Dt GETTTYENT 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm getttyent , .Nm getttynam , diff --git a/lib/libc/gen/getusershell.3 b/lib/libc/gen/getusershell.3 index 068c5d9d96ec..59cea10c4625 100644 --- a/lib/libc/gen/getusershell.3 +++ b/lib/libc/gen/getusershell.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETUSERSHELL 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm getusershell , .Nm setusershell , @@ -55,9 +55,9 @@ The .Fn getusershell function returns a pointer to a legal user shell as defined by the -system manager in the file +system manager in the file .Pa /etc/shells . -If +If .Pa /etc/shells is unreadable or does not exist, .Fn getusershell @@ -90,7 +90,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/getvfsbyname.3 b/lib/libc/gen/getvfsbyname.3 index dd59d8a979ba..537c667344aa 100644 --- a/lib/libc/gen/getvfsbyname.3 +++ b/lib/libc/gen/getvfsbyname.3 @@ -86,6 +86,7 @@ specifies a filesystem that is unknown or not configured in the kernel. .El .Sh SEE ALSO .Xr mount 2 , +.Xr getvfsent 3 , .Xr sysctl 3 , .Xr mount 8 , .Xr sysctl 8 diff --git a/lib/libc/gen/initgroups.3 b/lib/libc/gen/initgroups.3 index 27155fa29a4b..23756b294a71 100644 --- a/lib/libc/gen/initgroups.3 +++ b/lib/libc/gen/initgroups.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt INITGROUPS 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm initgroups .Nd initialize group access list diff --git a/lib/libc/gen/lockf.3 b/lib/libc/gen/lockf.3 index a7c511de8802..236c49a63824 100644 --- a/lib/libc/gen/lockf.3 +++ b/lib/libc/gen/lockf.3 @@ -38,7 +38,7 @@ .\" .Dd December 19, 1997 .Dt LOCKF 3 -.Os NetBSD 1.4 +.Os .Sh NAME .Nm lockf .Nd record locking on files @@ -179,12 +179,8 @@ locks may be safely used concurrently. .Pp Blocking on a section is interrupted by any signal. .Sh RETURN VALUES -If successful, the -.Fn lockf -function returns 0. -Otherwise, it returns -1, sets -.Dv errno -to indicate an error, and existing locks are not changed. +.Rv -std lockf +In the case of a failure, existing locks are not changed. .Sh ERRORS .Fn lockf will fail if: diff --git a/lib/libc/gen/msgctl.3 b/lib/libc/gen/msgctl.3 index 56b4f8697415..3d1d55a09a91 100644 --- a/lib/libc/gen/msgctl.3 +++ b/lib/libc/gen/msgctl.3 @@ -33,7 +33,7 @@ .\"/ .Dd November 24, 1997 .Dt MSGCTL 3 -.Os FreeBSD +.Os .Sh NAME .Nm msgctl .Nd message control operations @@ -166,11 +166,7 @@ effective gid can match either or .Va msg_perm.gid . .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, -1 is -returned and the global variable -.Va errno -is set to indicate the error. +.Rv -std msgctl .Sh ERRORS .Fn msgctl will fail if: diff --git a/lib/libc/gen/msgget.3 b/lib/libc/gen/msgget.3 index 6d221415415e..838e13a955f2 100644 --- a/lib/libc/gen/msgget.3 +++ b/lib/libc/gen/msgget.3 @@ -33,7 +33,7 @@ .\"/ .Dd August 17, 1995 .Dt MSGGET 3 -.Os FreeBSD +.Os .Sh NAME .Nm msgget .Nd get message queue diff --git a/lib/libc/gen/msgrcv.3 b/lib/libc/gen/msgrcv.3 index bf8ccf8c586e..ed627bde0d6f 100644 --- a/lib/libc/gen/msgrcv.3 +++ b/lib/libc/gen/msgrcv.3 @@ -33,7 +33,7 @@ .\"/ .Dd November 24, 1997 .Dt MSGRCV 3 -.Os FreeBSD +.Os .Sh NAME .Nm msgrcv .Nd receive a message from a message queue diff --git a/lib/libc/gen/msgsnd.3 b/lib/libc/gen/msgsnd.3 index 1feb94bad9b0..3ee09c084396 100644 --- a/lib/libc/gen/msgsnd.3 +++ b/lib/libc/gen/msgsnd.3 @@ -33,7 +33,7 @@ .\" .Dd November 24, 1997 .Dt MSGSND 3 -.Os FreeBSD +.Os .Sh NAME .Nm msgsnd .Nd send a message to a message queue @@ -121,10 +121,7 @@ is set to the pid of the calling process. is set to the current time. .El .Sh RETURN VALUES -Upon successful completion, 0 is returned. -Otherwise, -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std msgsnd .Sh ERRORS .Fn msgsnd will fail if: @@ -159,7 +156,7 @@ points to an invalid address. The system call was interrupted by the delivery of a signal. .El .Sh BUGS -.Tn NetBSD +.Nx and .Fx do not define the diff --git a/lib/libc/gen/nice.3 b/lib/libc/gen/nice.3 index df1291f78afc..38bd0534db36 100644 --- a/lib/libc/gen/nice.3 +++ b/lib/libc/gen/nice.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt NICE 3 -.Os BSD 4 +.Os .Sh NAME .Nm nice .Nd set program scheduling priority @@ -46,7 +46,8 @@ .Fn nice "int incr" .Sh DESCRIPTION .Bf -symbolic -This interface is obsoleted by setpriority(2). +This interface is obsoleted by +.Xr setpriority 2 . .Ef .Pp The diff --git a/lib/libc/gen/nlist.3 b/lib/libc/gen/nlist.3 index 96ba25cc7b60..9597b37791a3 100644 --- a/lib/libc/gen/nlist.3 +++ b/lib/libc/gen/nlist.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt NLIST 3 -.Os BSD 4 +.Os .Sh NAME .Nm nlist .Nd retrieve symbol table name list from an executable file diff --git a/lib/libc/gen/pause.3 b/lib/libc/gen/pause.3 index 80d1f9f83e88..8ffd75ccfff8 100644 --- a/lib/libc/gen/pause.3 +++ b/lib/libc/gen/pause.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt PAUSE 3 -.Os BSD 4 +.Os .Sh NAME .Nm pause .Nd stop until signal diff --git a/lib/libc/gen/psignal.3 b/lib/libc/gen/psignal.3 index 3ea6216e1e6d..fd8052890760 100644 --- a/lib/libc/gen/psignal.3 +++ b/lib/libc/gen/psignal.3 @@ -34,7 +34,7 @@ .\" .Dd February 27, 1995 .Dt PSIGNAL 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm psignal , .Nm strsignal , diff --git a/lib/libc/gen/raise.3 b/lib/libc/gen/raise.3 index 2177fa4a0c2e..e2d82efa2813 100644 --- a/lib/libc/gen/raise.3 +++ b/lib/libc/gen/raise.3 @@ -55,10 +55,7 @@ function sends the signal .Fa sig to the current process. .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, a value of \-1 is returned and the global variable -.Va errno -is set to indicate the error. +.Rv -std raise .Sh ERRORS The .Fn raise diff --git a/lib/libc/gen/rand48.3 b/lib/libc/gen/rand48.3 index d42461b87ddc..5386bce71034 100644 --- a/lib/libc/gen/rand48.3 +++ b/lib/libc/gen/rand48.3 @@ -14,7 +14,7 @@ .\" .Dd October 8, 1993 .Dt RAND48 3 -.Os FreeBSD +.Os .Sh NAME .Nm drand48 , .Nm erand48 , diff --git a/lib/libc/gen/scandir.3 b/lib/libc/gen/scandir.3 index 3f6907889874..0502bd26ab8b 100644 --- a/lib/libc/gen/scandir.3 +++ b/lib/libc/gen/scandir.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SCANDIR 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm scandir , .Nm alphasort diff --git a/lib/libc/gen/setjmp.3 b/lib/libc/gen/setjmp.3 index 1c4800c2d3bb..29c2a9b95ef1 100644 --- a/lib/libc/gen/setjmp.3 +++ b/lib/libc/gen/setjmp.3 @@ -38,7 +38,7 @@ .\" .Dd June 4, 1993 .Dt SETJMP 3 -.Os BSD 4 +.Os .Sh NAME .Nm sigsetjmp , .Nm siglongjmp , diff --git a/lib/libc/gen/setproctitle.3 b/lib/libc/gen/setproctitle.3 index eed8f810af9b..60b8c4f8c728 100644 --- a/lib/libc/gen/setproctitle.3 +++ b/lib/libc/gen/setproctitle.3 @@ -21,7 +21,7 @@ .\" .\" The following requests are required for all man pages. .Dd December 16, 1995 -.Os FreeBSD +.Os .Dt SETPROCTITLE 3 .Sh NAME .Nm setproctitle @@ -85,7 +85,7 @@ It is thought that the implementation is compatible with other systems, including .Nx and -.Tn BSD/OS . +.Bsx . .Sh HISTORY .Fn setproctitle first appeared in diff --git a/lib/libc/gen/siginterrupt.3 b/lib/libc/gen/siginterrupt.3 index 102c04e93b1e..4a3b4a4aea8c 100644 --- a/lib/libc/gen/siginterrupt.3 +++ b/lib/libc/gen/siginterrupt.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SIGINTERRUPT 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm siginterrupt .Nd allow signals to interrupt system calls @@ -99,8 +99,16 @@ system call that is not available in .Bx 4.2 , hence it should not be used if backward compatibility is needed. .Sh RETURN VALUES -A 0 value indicates that the call succeeded. -A \-1 value indicates that an invalid signal number has been supplied. +.Rv -std siginterrupt +.Sh ERRORS +The +.Fn siginterrupt +call fails if: +.Bl -tag -width Er +.It Bq Er EINVAL +.Fa sig +is not a valid signal number. +.El .Sh SEE ALSO .Xr sigaction 2 , .Xr sigblock 2 , diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3 index 06abdb43b71d..392074b08e4d 100644 --- a/lib/libc/gen/signal.3 +++ b/lib/libc/gen/signal.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt SIGNAL 3 -.Os BSD 4 +.Os .Sh NAME .Nm signal .Nd simplified software signal facilities diff --git a/lib/libc/gen/stringlist.3 b/lib/libc/gen/stringlist.3 index bd5e0705ae92..6708055af7d8 100644 --- a/lib/libc/gen/stringlist.3 +++ b/lib/libc/gen/stringlist.3 @@ -36,7 +36,7 @@ .\" $FreeBSD$ .\" .Dd February 24, 1997 -.Os NetBSD 1.3 +.Os .Dt STRINGLIST 3 .Sh NAME .Nm stringlist , diff --git a/lib/libc/gen/sysconf.3 b/lib/libc/gen/sysconf.3 index ef5c64929887..18dc9e9f4542 100644 --- a/lib/libc/gen/sysconf.3 +++ b/lib/libc/gen/sysconf.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt SYSCONF 3 -.Os BSD 4 +.Os .Sh NAME .Nm sysconf .Nd get configurable system variables @@ -58,7 +58,7 @@ The .Fa name argument specifies the system variable to be queried. Symbolic constants for each name value are found in the include file -.Li <unistd.h> . +.Aq Pa unistd.h . .Pp The available values are as follows: .Pp @@ -167,7 +167,7 @@ The .Fn sysconf function may fail and set .Va errno -for any of the errors specified for the library functions +for any of the errors specified for the library function .Xr sysctl 3 . In addition, the following error may be reported: .Bl -tag -width Er diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3 index 01a10b8a124f..99d906bfcb63 100644 --- a/lib/libc/gen/sysctl.3 +++ b/lib/libc/gen/sysctl.3 @@ -532,7 +532,7 @@ The fifth and sixth level names are as follows: .El .It Li PF_INET Get or set various global information about the IPv4 -.Pq Internet Protocol version 4 . +(Internet Protocol version 4). The third level name is the protocol. The fourth level name is the variable name. The currently defined protocols and names are: @@ -573,7 +573,7 @@ For variables net.inet.*.ipsec, please refer to .El .It Li PF_INET6 Get or set various global information about the IPv6 -.Pq Internet Protocol version 6 . +(Internet Protocol version 6). The third level name is the protocol. The fourth level name is the variable name. .Pp diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index a2763234f4fb..88285d47da8f 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SYSLOG 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm syslog , .Nm vsyslog , diff --git a/lib/libc/gen/time.3 b/lib/libc/gen/time.3 index 4a27f6fd82cf..570a88d4b0cb 100644 --- a/lib/libc/gen/time.3 +++ b/lib/libc/gen/time.3 @@ -38,7 +38,7 @@ .\" .Dd June 4, 1993 .Dt TIME 3 -.Os BSD 4 +.Os .Sh NAME .Nm time .Nd get time of day @@ -66,9 +66,7 @@ Upon successful completion, .Fn time returns the value of time. Otherwise a value of -.Po -.Po Fa time_t Pc \-1 -.Pc +.Pq Po Vt time_t Pc \-1 is returned and the global variable .Va errno is set to indicate the error. diff --git a/lib/libc/gen/times.3 b/lib/libc/gen/times.3 index 85a33f7b04e9..45429d0613e2 100644 --- a/lib/libc/gen/times.3 +++ b/lib/libc/gen/times.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt TIMES 3 -.Os BSD 4 +.Os .Sh NAME .Nm times .Nd process times @@ -46,8 +46,10 @@ .Fn times "struct tms *tp" .Sh DESCRIPTION .Bf -symbolic -This interface is obsoleted by getrusage(2) -and gettimeofday(3). +This interface is obsoleted by +.Xr getrusage 2 +and +.Xr gettimeofday 2 . .Ef .Pp The @@ -63,35 +65,35 @@ It also fills in the structure pointed to by with time-accounting information. .Pp The -.Fa tms +.Vt tms structure is defined as follows: .Bd -literal -offset indent -typedef struct { +struct tms { clock_t tms_utime; clock_t tms_stime; clock_t tms_cutime; clock_t tms_cstime; -} +}; .Ed .Pp The elements of this structure are defined as follows: -.Bl -tag -width tms_cutime -.It Fa tms_utime +.Bl -tag -width ".Va tms_cutime" +.It Va tms_utime The .Tn CPU time charged for the execution of user instructions. -.It Fa tms_stime +.It Va tms_stime The .Tn CPU time charged for execution by the system on behalf of the process. -.It Fa tms_cutime +.It Va tms_cutime The sum of the -.Fa tms_utime s +.Va tms_utime Ns s and -.Fa tms_cutime s +.Va tms_cutime Ns s of the child processes. -.It Fa tms_cstime +.It Va tms_cstime The sum of the .Fa tms_stime Ns s and @@ -104,17 +106,19 @@ All times are in of a second. .Pp The times of a terminated child process are included in the -.Fa tms_cutime +.Va tms_cutime and -.Fa tms_cstime +.Va tms_cstime elements of the parent when one of the .Xr wait 2 functions returns the process ID of the terminated child to the parent. If an error occurs, .Fn times returns the value -.Pq (clock_t)\-1 , -and sets errno to indicate the error. +.Pq Po Vt clock_t Pc Ns \-1 , +and sets +.Va errno +to indicate the error. .Sh ERRORS The .Fn times diff --git a/lib/libc/gen/tzset.3 b/lib/libc/gen/tzset.3 index 6dca2bca21e1..1c7622c9ce2f 100644 --- a/lib/libc/gen/tzset.3 +++ b/lib/libc/gen/tzset.3 @@ -227,7 +227,7 @@ The .Em d Ns 'th day (0 \*(Le .Em d -\*(Le 6 ) +\*(Le 6) of week .Em n of month diff --git a/lib/libc/gen/ualarm.3 b/lib/libc/gen/ualarm.3 index 3e53f048a598..f2b269c0aafa 100644 --- a/lib/libc/gen/ualarm.3 +++ b/lib/libc/gen/ualarm.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt UALARM 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm ualarm .Nd schedule signal after specified time @@ -46,7 +46,8 @@ .Fn ualarm "u_int microseconds" "u_int interval" .Sh DESCRIPTION .Bf -symbolic -This is a simplified interface to setitimer(2). +This is a simplified interface to +.Xr setitimer 2 . .Ef .Pp The diff --git a/lib/libc/gen/uname.3 b/lib/libc/gen/uname.3 index 0ad18d888554..9a9d5fe27d8a 100644 --- a/lib/libc/gen/uname.3 +++ b/lib/libc/gen/uname.3 @@ -69,11 +69,7 @@ Version level of the operating system. Machine hardware platform. .El .Sh RETURN VALUES -If -.Fn uname -is successful, 0 is returned, otherwise, -1 is returned and -.Va errno -is set appropriately. +.Rv -std uname .Sh ERRORS The .Fn uname diff --git a/lib/libc/gen/unvis.3 b/lib/libc/gen/unvis.3 index ebf452a28ec4..c1f617a97c29 100644 --- a/lib/libc/gen/unvis.3 +++ b/lib/libc/gen/unvis.3 @@ -43,9 +43,9 @@ .Lb libc .Sh SYNOPSIS .Fd #include <vis.h> -.Ft int +.Ft int .Fn unvis "char *cp" "int c" "int *astate" "int flag" -.Ft int +.Ft int .Fn strunvis "char *dst" "const char *src" .Sh DESCRIPTION The @@ -58,7 +58,7 @@ by the .Xr vis 3 function, back into the original form. Unvis is called with successive characters in -.Ar c +.Ar c until a valid sequence is recognized, at which time the decoded character is available at the character pointed to by @@ -126,7 +126,9 @@ unknown state. The decoder is placed into the starting state. .Pp When all bytes in the stream have been processed, call .Fn unvis -one more time with flag set to +one more time with +.Ar flag +set to .Dv UNVIS_END to extract any remaining character (the character passed in is ignored). .Pp diff --git a/lib/libc/gen/usleep.3 b/lib/libc/gen/usleep.3 index b47ea0145fb5..ae89133ff2cb 100644 --- a/lib/libc/gen/usleep.3 +++ b/lib/libc/gen/usleep.3 @@ -34,7 +34,7 @@ .\" .Dd February 13, 1998 .Dt USLEEP 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm usleep .Nd suspend process execution for an interval measured in microseconds diff --git a/lib/libc/gen/utime.3 b/lib/libc/gen/utime.3 index e50389824b0c..a14eea3081c1 100644 --- a/lib/libc/gen/utime.3 +++ b/lib/libc/gen/utime.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt UTIME 3 -.Os BSD 4 +.Os .Sh NAME .Nm utime .Nd set file times @@ -47,7 +47,8 @@ .Fn utime "const char *file" "const struct utimbuf *timep" .Sh DESCRIPTION .Bf -symbolic -This interface is obsoleted by utimes(2) . +This interface is obsoleted by +.Xr utimes 2 . .Ef .Pp The diff --git a/lib/libc/gen/valloc.3 b/lib/libc/gen/valloc.3 index a7af23f1e423..b15847fa13ab 100644 --- a/lib/libc/gen/valloc.3 +++ b/lib/libc/gen/valloc.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt VALLOC 3 -.Os BSD 3 +.Os .Sh NAME .Nm valloc .Nd aligned memory allocation function @@ -46,7 +46,10 @@ .Fn valloc "size_t size" .Sh DESCRIPTION .Bf -symbolic -Valloc is obsoleted by the current version of malloc(3), +The +.Fn valloc +function is obsoleted by the current version of +.Xr malloc 3 , which aligns page-sized and larger allocations. .Ef .Pp diff --git a/lib/libc/gen/vis.3 b/lib/libc/gen/vis.3 index 4669420c62b3..b46368e3a457 100644 --- a/lib/libc/gen/vis.3 +++ b/lib/libc/gen/vis.3 @@ -128,7 +128,7 @@ functions. There are two parameters that can be controlled: the range of characters that are encoded, and the type of representation used. -By default, all non-graphic characters. +By default, all non-graphic characters except space, tab, and newline are encoded. (See .Xr isgraph 3 . ) diff --git a/lib/libc/gmon/moncontrol.3 b/lib/libc/gmon/moncontrol.3 index 92a76b721b64..1966d72e8ddd 100644 --- a/lib/libc/gmon/moncontrol.3 +++ b/lib/libc/gmon/moncontrol.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt MONCONTROL 3 -.Os BSD 4 +.Os .Sh NAME .Nm moncontrol , .Nm monstartup diff --git a/lib/libc/i386/sys/i386_get_ioperm.2 b/lib/libc/i386/sys/i386_get_ioperm.2 index 27b38c7a5892..11437dca1396 100644 --- a/lib/libc/i386/sys/i386_get_ioperm.2 +++ b/lib/libc/i386/sys/i386_get_ioperm.2 @@ -81,6 +81,8 @@ arguments. .It Bq Er EPERM The caller of i386_set_ioperm was not the superuser. .El +.Sh SEE ALSO +.Xr io 4 .Sh AUTHORS This man page was written by .An Jonathan Lemon . diff --git a/lib/libc/i386/sys/i386_get_ldt.2 b/lib/libc/i386/sys/i386_get_ldt.2 index af0f993f8c07..5b74325bb0f1 100644 --- a/lib/libc/i386/sys/i386_get_ldt.2 +++ b/lib/libc/i386/sys/i386_get_ldt.2 @@ -34,7 +34,7 @@ .\" .Dd September 20, 1993 .Dt I386_GET_LDT 2 -.Os FreeBSD +.Os .Sh NAME .Nm i386_get_ldt , .Nm i386_set_ldt @@ -56,11 +56,11 @@ LDT. will set a list of i386 descriptors for the current process in its LDT. Both routines accept a starting selector number -.Fa start_sel -, an array of memory that +.Fa start_sel , +an array of memory that will contain the descriptors to be set or returned -.Fa descs -, and the number of entries to set or return +.Fa descs , +and the number of entries to set or return .Fa num_sels . .Pp The argument diff --git a/lib/libc/i386/sys/i386_vm86.2 b/lib/libc/i386/sys/i386_vm86.2 index 3c85ade2953e..185b537ea116 100644 --- a/lib/libc/i386/sys/i386_vm86.2 +++ b/lib/libc/i386/sys/i386_vm86.2 @@ -78,13 +78,7 @@ with the correct machine context for vm86, and with the .Em PSL_VM bit set. Control returns to the process upon delivery of a signal. .Sh RETURN VALUES -Upon successful completion, -.Fn i386_vm86 -will return the value of 0. -Otherwise, a value of -1 is returned and the global -variable -.Va errno -is set to indicate the error. +.Rv -std i386_vm86 .Sh ERRORS .Fn i386_vm86 will fail if: diff --git a/lib/libc/locale/multibyte.3 b/lib/libc/locale/multibyte.3 index 52ee84eb12fb..e909dce18bf6 100644 --- a/lib/libc/locale/multibyte.3 +++ b/lib/libc/locale/multibyte.3 @@ -77,7 +77,8 @@ Multibyte characters are used for input and output and code each basic element as a sequence of C .Va char Ns s . Individual basic elements may map into one or more -.Pq up to Dv MB_CHAR_MAX +(up to +.Dv MB_CHAR_MAX ) bytes in a multibyte character. .Pp The current locale @@ -128,10 +129,10 @@ categories. .Pp For convenience in processing, the wide character with value 0 -.Pq the null wide character +(the null wide character) is recognized as the wide character string terminator, and the character with value 0 -.Pq the null byte +(the null byte) is recognized as the multibyte character string terminator. Null bytes are not permitted within multibyte characters. .Pp diff --git a/lib/libc/locale/setlocale.3 b/lib/libc/locale/setlocale.3 index b705bf7ea964..d8c48db0e91d 100644 --- a/lib/libc/locale/setlocale.3 +++ b/lib/libc/locale/setlocale.3 @@ -258,7 +258,7 @@ a value that is not in the current locale. A .Dv CHAR_MAX result similarly denotes an unavailable value. -.Sh "RETURN VALUES +.Sh RETURN VALUES The .Fn setlocale function returns @@ -285,7 +285,7 @@ locale file for the locale and the category .Em category . .El -.Sh "SEE ALSO +.Sh SEE ALSO .Xr colldef 1 , .Xr mklocale 1 , .Xr catopen 3 , diff --git a/lib/libc/net/addr2ascii.3 b/lib/libc/net/addr2ascii.3 index b9f6fa9022d2..4003a83cecb8 100644 --- a/lib/libc/net/addr2ascii.3 +++ b/lib/libc/net/addr2ascii.3 @@ -105,13 +105,16 @@ addresses in the specified family: .Bl -tag -width AF_INETxxxx -compact .It Dv AF_INET .Li struct in_addr -.Pq in Aq Pa netinet/in.h +(in +.Aq Pa netinet/in.h ) .It Dv AF_LINK .Li struct sockaddr_dl -.Pq in Aq Pa net/if_dl.h +(in +.Aq Pa net/if_dl.h ) .\" .It Dv AF_INET6 .\" .Li struct in6_addr -.\" .Pq in Aq Pa netinet6/in6.h +.\" (in +.\" .Aq Pa netinet6/in6.h ) .El .Sh RETURN VALUES The diff --git a/lib/libc/net/byteorder.3 b/lib/libc/net/byteorder.3 index 2b805f01b5ad..cae00a76f061 100644 --- a/lib/libc/net/byteorder.3 +++ b/lib/libc/net/byteorder.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt BYTEORDER 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm htonl , .Nm htons , diff --git a/lib/libc/net/ethers.3 b/lib/libc/net/ethers.3 index 559c9e865ae4..6a9ea5529d55 100644 --- a/lib/libc/net/ethers.3 +++ b/lib/libc/net/ethers.3 @@ -32,7 +32,7 @@ .\" .Dd April 12, 1995 .Dt ETHERS 3 -.Os FreeBSD +.Os .Sh NAME .Nm ethers , .Nm ether_line , diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3 index 71ee2bb30150..9db36c79af1d 100644 --- a/lib/libc/net/getaddrinfo.3 +++ b/lib/libc/net/getaddrinfo.3 @@ -107,9 +107,7 @@ A .Pf non Dv -NULL .Fa nodename string can be either a node name or a numeric host address string -.Po -i.e., a dotted-decimal IPv4 address or an IPv6 hex address -.Pc . +(i.e., a dotted-decimal IPv4 address or an IPv6 hex address). A .Pf non Dv -NULL .Fa servname @@ -226,13 +224,13 @@ member of the structure, then the returned socket address structure will be ready for a call to .Fn connect -.Pq for a connection-oriented protocol +(for a connection-oriented protocol) or either .Fn connect , .Fn sendto , or .Fn sendmsg -.Pq for a connectionless protocol . +(for a connectionless protocol). In this case, if the .Fa nodename argument is a @@ -379,10 +377,8 @@ and allows cut-and-paste input of scoped addresses. At the moment the code supports only link-local addresses in this format. The scope identifier is hardcoded to name of hardware interface associated with the link, -.Po -such as -.Li ne0 -.Pc . +(such as +.Li ne0 ) . For example, .Dq Li fe80::1%ne0 , which means @@ -566,8 +562,8 @@ values, the function still returns a pointer to a string whose contents indicate an unknown error. .\" .Sh SEE ALSO -.Xr getnameinfo 3 , .Xr gethostbyname 3 , +.Xr getnameinfo 3 , .Xr getservbyname 3 , .Xr hosts 5 , .Xr services 5 , @@ -608,7 +604,7 @@ function is defined in .St -p1003.1g-2000 , and documented in .Dq Basic Socket Interface Extensions for IPv6 -.Pq RFC2553 . +(RFC2553). .\" .Sh BUGS The current implementation is not thread-safe. diff --git a/lib/libc/net/gethostbyname.3 b/lib/libc/net/gethostbyname.3 index fb7976bf9c55..7d432f8a88eb 100644 --- a/lib/libc/net/gethostbyname.3 +++ b/lib/libc/net/gethostbyname.3 @@ -34,7 +34,7 @@ .\" .Dd May 25, 1995 .Dt GETHOSTBYNAME 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm gethostbyname , .Nm gethostbyname2 , @@ -78,7 +78,7 @@ following structure describing an internet host referenced by name or by address, respectively. This structure contains either the information obtained from the name server, .Xr named 8 , -or broken-out fields from a line in +or broken-out fields from a line in .Pa /etc/hosts . If the local name server is not running these routines do a lookup in .Pa /etc/hosts . @@ -205,7 +205,9 @@ Error return status from .Fn gethostbyname2 and .Fn gethostbyaddr -is indicated by return of a null pointer. +is indicated by return of a +.Dv NULL +pointer. The external integer .Va h_errno may then be checked to see whether this is a temporary failure diff --git a/lib/libc/net/getifaddrs.3 b/lib/libc/net/getifaddrs.3 index a83e3973f322..8f6c58232549 100644 --- a/lib/libc/net/getifaddrs.3 +++ b/lib/libc/net/getifaddrs.3 @@ -114,11 +114,13 @@ field references address family specific data. For .Dv AF_LINK addresses it contains a pointer to the .Fa struct if_data -.Pq as defined in include file Aq Pa net/if.h +(as defined in include file +.Aq Pa net/if.h ) which contains various interface attributes and statistics. For all other address families, it contains a pointer to the .Fa struct ifa_data -.Pq as defined in include file Aq Pa net/if.h +(as defined in include file +.Aq Pa net/if.h ) which contains per-address interface statistics. .Pp The data returned by @@ -161,4 +163,5 @@ be included before .Sh HISTORY The .Nm -implementation first appeared in BSDI BSD/OS. +implementation first appeared in BSDi +.Bsx . diff --git a/lib/libc/net/getipnodebyname.3 b/lib/libc/net/getipnodebyname.3 index 618f5a3ac6c6..017dd73569d9 100644 --- a/lib/libc/net/getipnodebyname.3 +++ b/lib/libc/net/getipnodebyname.3 @@ -75,12 +75,10 @@ and for specifying address family and operation mode. The additional arguments allow programmer to get address for a nodename, for specific address family -.Po -such as +(such as .Dv AF_INET or -.Dv AF_INET6 -.Pc . +.Dv AF_INET6 ) . The functions also require an additional pointer argument, .Ar error_num to return the appropriate error code, @@ -97,9 +95,7 @@ the .Ar name argument can be either a node name or a numeric address string -.Po -i.e., a dotted-decimal IPv4 address or an IPv6 hex address -.Pc . +(i.e., a dotted-decimal IPv4 address or an IPv6 hex address). The .Ar af argument specifies the address family, either @@ -112,7 +108,7 @@ argument specifies the types of addresses that are searched for, and the types of addresses that are returned. We note that a special flags value of .Dv AI_DEFAULT -.Pq defined below +(defined below) should handle most applications. That is, porting simple applications to use IPv6 replaces the call .Bd -literal -offset @@ -192,10 +188,8 @@ That is, if no records are found then a query is made for .Li A records and any found are returned as IPv4-mapped IPv6 addresses -.Po -.Li h_length -will be 16 -.Pc . +.Li ( h_length +will be 16). The .Dv AI_V4MAPPED flag is ignored unless @@ -284,9 +278,7 @@ We noted that the function must allow the .Ar name argument to be either a node name or a literal address string -.Po -i.e., a dotted-decimal IPv4 address or an IPv6 hex address -.Pc . +(i.e., a dotted-decimal IPv4 address or an IPv6 hex address). This saves applications from having to call .Xr inet_pton 3 to handle literal address strings. @@ -329,15 +321,11 @@ is a copy of the argument, .Li h_length is either 4 -.Po -for -.Dv AF_INET -.Pc +(for +.Dv AF_INET ) or 16 -.Po -for -.Dv AF_INET6 -.Pc , +(for +.Dv AF_INET6 ) , .Li h_addr_list[0] is a pointer to the 4-byte or 16-byte binary address, and @@ -426,8 +414,8 @@ The meanings of each error code are described in .Xr gethostbyname 3 . .\" .Sh SEE ALSO -.Xr gethostbyname 3 , .Xr gethostbyaddr 3 , +.Xr gethostbyname 3 , .Xr hosts 5 , .Xr services 5 , .Xr hostname 7 , @@ -452,7 +440,7 @@ and .Fn getipnodebyaddr are documented in .Dq Basic Socket Interface Extensions for IPv6 -.Pq RFC2553 . +(RFC2553). .\" .Sh BUGS .Fn getipnodebyname diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3 index eaef8d3d5280..3a5d46b58891 100644 --- a/lib/libc/net/getnameinfo.3 +++ b/lib/libc/net/getnameinfo.3 @@ -122,9 +122,7 @@ The first value is actually defined as the constant in recent versions of BIND's .Aq Pa arpa/nameser.h header -.Po -older versions of BIND define this constant to be 256 -.Pc +(older versions of BIND define this constant to be 256) and the second is a guess based on the services listed in the current Assigned Numbers RFC. .Pp @@ -143,12 +141,10 @@ bit .Dv NI_NUMERICHOST is set, or if the host's name cannot be located in the DNS, the numeric form of the host's address is returned instead of its name -.Po -e.g., by calling +(e.g., by calling .Fn inet_ntop instead of -.Fn getnodebyaddr -.Pc . +.Fn getnodebyaddr ) . If the .Fa flag bit @@ -158,7 +154,7 @@ is set, an error is returned if the host's name cannot be located in the DNS. If the flag bit .Dv NI_NUMERICSERV is set, the numeric form of the service address is returned -.Pq e.g., its port number +(e.g., its port number) instead of its name. The two .Dv NI_NUMERICxxx @@ -302,7 +298,7 @@ function is defined in .St -p1003.1g-2000 , and documented in .Dq Basic Socket Interface Extensions for IPv6 -.Pq RFC2553 . +(RFC2553). .\" .Sh BUGS The current implementation is not thread-safe. diff --git a/lib/libc/net/getnetent.3 b/lib/libc/net/getnetent.3 index c28917016f18..14afb428bf0c 100644 --- a/lib/libc/net/getnetent.3 +++ b/lib/libc/net/getnetent.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETNETENT 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm getnetent , .Nm getnetbyaddr , diff --git a/lib/libc/net/getprotoent.3 b/lib/libc/net/getprotoent.3 index a35ced1237ad..d073ac0558a7 100644 --- a/lib/libc/net/getprotoent.3 +++ b/lib/libc/net/getprotoent.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETPROTOENT 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm getprotoent , .Nm getprotobynumber , diff --git a/lib/libc/net/getservent.3 b/lib/libc/net/getservent.3 index a5d94f476b68..5a0258ea122b 100644 --- a/lib/libc/net/getservent.3 +++ b/lib/libc/net/getservent.3 @@ -34,7 +34,7 @@ .\" .Dd July 9, 1995 .Dt GETSERVENT 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm getservent , .Nm getservbyport , diff --git a/lib/libc/net/if_indextoname.3 b/lib/libc/net/if_indextoname.3 index adf82cbc4f5f..29ae464166aa 100644 --- a/lib/libc/net/if_indextoname.3 +++ b/lib/libc/net/if_indextoname.3 @@ -139,4 +139,4 @@ R. Gilligan, S. Thomson, J. Bound, and W. Stevens, The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit. .Sh STANDARDS These functions are defined in ``Basic Socket Interface Extensions for IPv6'' -.Pq RFC2533 . +(RFC2533). diff --git a/lib/libc/net/inet.3 b/lib/libc/net/inet.3 index 48f1f53705d2..5bc01f57db77 100644 --- a/lib/libc/net/inet.3 +++ b/lib/libc/net/inet.3 @@ -34,7 +34,7 @@ .\" .Dd June 17, 1996 .Dt INET 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm inet_aton , .Nm inet_addr , @@ -147,7 +147,7 @@ respectively. All Internet addresses are returned in network order (bytes ordered from left to right). All network numbers and local address parts are -returned as machine format integer values. +returned as machine byte order integer values. .Sh INTERNET ADDRESSES Values specified using the .Ql .\& @@ -239,10 +239,10 @@ The and .Fn inet_pton functions conform to -.St -xns5.2d2.0 . +.St -xns5.2 . Note that .Fn inet_pton -does not accept 1-, 2-, or 3-part dotted addresses; all four parts +does not accept 1-, 2-, or 3-part dotted addresses; all four parts must be specified. This is a narrower input set than that accepted by .Fn inet_aton . diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3 index c2338fcadd9d..726a41c7db40 100644 --- a/lib/libc/net/inet6_option_space.3 +++ b/lib/libc/net/inet6_option_space.3 @@ -102,7 +102,7 @@ is the number of options to be stored in the object. This is of little consequence, since it is assumed that most Hop-by-Hop option headers and Destination option headers carry only one option -.Pq appendix B of [RFC-2460] . +(appendix B of [RFC-2460]). .\" .Ss inet6_option_init .Fn inet6_option_init @@ -171,7 +171,7 @@ field is immediately followed by the 8-bit option data length field, which is then followed immediately by the option data. The caller initializes these three fields -.Pq the type-length-value, or TLV +(the type-length-value, or TLV) before calling this function. .Pp The option type must have a value from @@ -439,7 +439,7 @@ The implementation first appeared in KAME advanced networking kit. The functions are documented in .Dq Advanced Sockets API for IPv6 -.Pq RFC2292 . +(RFC2292). .\" .Sh BUGS The text was shamelessly copied from RFC2292. diff --git a/lib/libc/net/inet6_rthdr_space.3 b/lib/libc/net/inet6_rthdr_space.3 index 2c3fd9c49f34..d09bba6b35da 100644 --- a/lib/libc/net/inet6_rthdr_space.3 +++ b/lib/libc/net/inet6_rthdr_space.3 @@ -106,7 +106,7 @@ header of the specified .Fa type containing the specified number of .Fa segments -.Pq addresses . +(addresses). For an IPv6 Type 0 Routing header, the number of segments must be between 1 and 23, inclusive. The return value includes the size of the cmsghdr structure that precedes the Routing @@ -218,14 +218,14 @@ and writes a new Routing header that sends datagrams along the reverse of that route. Both arguments are allowed to point to the same buffer -.Pq that is, the reversal can occur in place . +(that is, the reversal can occur in place). .Pp The return value of the function is 0 on success, or -1 upon an error. .\" .Ss inet6_rthdr_segments This function returns the number of segments -.Pq addresses +(addresses) contained in the Routing header described by .Fa cmsg . @@ -314,7 +314,7 @@ The implementation first appeared in KAME advanced networking kit. The functions are documented in .Dq Advanced Sockets API for IPv6 -.Pq RFC2292 . +(RFC2292). .\" .Sh BUGS The text was shamelessly copied from RFC2292. diff --git a/lib/libc/net/linkaddr.3 b/lib/libc/net/linkaddr.3 index 9729ee608235..7631c4a3fa79 100644 --- a/lib/libc/net/linkaddr.3 +++ b/lib/libc/net/linkaddr.3 @@ -37,7 +37,7 @@ .\" .Dd June 17, 1996 .Dt LINK_ADDR 3 -.Os BSD 4.4 +.Os .Sh NAME .Nm link_addr , .Nm link_ntoa diff --git a/lib/libc/net/ns.3 b/lib/libc/net/ns.3 index 5616de4ec7eb..e8cc2ec209d0 100644 --- a/lib/libc/net/ns.3 +++ b/lib/libc/net/ns.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt NS 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm ns_addr , .Nm ns_ntoa diff --git a/lib/libc/net/rcmd.3 b/lib/libc/net/rcmd.3 index 3c676cb18f0b..08b6e72c461d 100644 --- a/lib/libc/net/rcmd.3 +++ b/lib/libc/net/rcmd.3 @@ -34,7 +34,7 @@ .\" .Dd March 3, 2000 .Dt RCMD 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm rcmd , .Nm rresvport , diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3 index 32144815e147..3e71ca5a4f97 100644 --- a/lib/libc/net/resolver.3 +++ b/lib/libc/net/resolver.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt RESOLVER 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm res_query , .Nm res_search , @@ -179,7 +179,10 @@ environment variable. Network daemons should set this option. .It Dv RES_USE_INET6 Enables support for IPv6-only applications. This causes IPv4 addresses to be returned as an IPv4 mapped address. -For example, 10.1.1.1 will be returned as ::ffff:10.1.1.1. +For example, +.Li 10.1.1.1 +will be returned as +.Li ::ffff:10.1.1.1 . The option is meaningful with certain kernel configuration only. .It Dv RES_USE_EDNS0 Enables support for OPT pseudo-RR for EDNS0 extension. @@ -211,7 +214,7 @@ tokens if you wish to override the on a per-process basis. This is similar to the .Em search command in the configuration file. -Another environment variable ( +Another environment variable .Dq Ev RES_OPTIONS can be set to override certain internal resolver options which are otherwise diff --git a/lib/libc/regex/regex.3 b/lib/libc/regex/regex.3 index 9d91f200f77e..c7681c759248 100644 --- a/lib/libc/regex/regex.3 +++ b/lib/libc/regex/regex.3 @@ -442,7 +442,7 @@ is first ORed with the .Dq message that results is the printable name of the error code, -e.g. +e.g.\& .Dq Dv REG_NOMATCH , rather than an explanation thereof. If @@ -533,12 +533,10 @@ The endpoint of one range cannot begin another. the limit on repetition counts in bounded repetitions, is 255. .Pp A repetition operator -.Po -.Ql ?\& , +.Ql ( ?\& , .Ql *\& , .Ql +\& , -or bounds -.Pc +or bounds) cannot follow another repetition operator. A repetition operator cannot begin an expression or subexpression diff --git a/lib/libc/rpc/rpc_secure.3 b/lib/libc/rpc/rpc_secure.3 index f2c516f9da5b..65ad98f2c859 100644 --- a/lib/libc/rpc/rpc_secure.3 +++ b/lib/libc/rpc/rpc_secure.3 @@ -153,8 +153,8 @@ Inverse of is an interface to the keyserver daemon, which is associated with .Tn RPC Ns 's -secure authentication system ( -.Tn DES +secure authentication system +.Tn ( DES authentication). User programs rarely need to call it, or its associated routines .Fn key_encryptsession , diff --git a/lib/libc/stdio/getc.3 b/lib/libc/stdio/getc.3 index db69606ba673..0a6a649b2ab6 100644 --- a/lib/libc/stdio/getc.3 +++ b/lib/libc/stdio/getc.3 @@ -76,8 +76,8 @@ but is a macro that expands in-line. The .Fn getchar function -is equivalent to: -getc with the argument stdin. +is equivalent to +.Fn getc stdin . .Pp The .Fn getw diff --git a/lib/libc/stdio/printf.3 b/lib/libc/stdio/printf.3 index d9d125d86e9f..39ce7655e78f 100644 --- a/lib/libc/stdio/printf.3 +++ b/lib/libc/stdio/printf.3 @@ -40,16 +40,8 @@ .Dt PRINTF 3 .Os .Sh NAME -.Nm printf , -.Nm fprintf , -.Nm sprintf , -.Nm snprintf , -.Nm asprintf , -.Nm vprintf , -.Nm vfprintf, -.Nm vsprintf , -.Nm vsnprintf , -.Nm vasprintf +.Nm printf , fprintf , sprintf , snprintf , asprintf , +.Nm vprintf , vfprintf, vsprintf , vsnprintf , vasprintf .Nd formatted output conversion .Sh LIBRARY .Lb libc @@ -86,7 +78,7 @@ as described below. and .Fn vprintf write output to -.Em stdout , +.Pa stdout , the standard output stream; .Fn fprintf and @@ -114,8 +106,7 @@ string that specifies how subsequent arguments .Xr stdarg 3 ) are converted for output. .Pp -These functions return -the number of characters printed +These functions return the number of characters printed (not including the trailing .Ql \e0 used to end output to strings), @@ -126,10 +117,8 @@ and which return the number of characters that would have been printed if the .Fa size were unlimited -.Po -again, not including the final -.Ql \e0 -.Pc . +(again, not including the final +.Ql \e0 ) . .Pp .Fn Asprintf and @@ -146,7 +135,9 @@ and .Fn vasprintf will return -1 and set .Fa ret -to be a NULL pointer. +to be a +.Dv NULL +pointer. .Pp .Fn Snprintf and @@ -178,8 +169,9 @@ which are copied unchanged to the output stream; and conversion specifications, each of which results in fetching zero or more subsequent arguments. Each conversion specification is introduced by -the character -.Cm % . +the +.Cm % +character. The arguments must correspond properly (after type promotion) with the conversion specifier. After the @@ -189,7 +181,7 @@ the following appear in sequence: .It An optional field, consisting of a decimal digit string followed by a .Cm $ , -specifying the next argument to access . +specifying the next argument to access. If this field is not provided, the argument following the last argument accessed will be used. Arguments are numbered starting at @@ -203,16 +195,12 @@ Zero or more of the following flags: A .Cm # character -specifying that the value should be converted to an ``alternate form''. +specifying that the value should be converted to an +.Dq alternate form . For -.Cm c , -.Cm d , -.Cm i , -.Cm n , -.Cm p , -.Cm s , +.Cm c , d , i , n , p , s , and -.Cm u , +.Cm u conversions, this option has no effect. For .Cm o @@ -231,12 +219,9 @@ for .Cm X conversions) prepended to it. For -.Cm e , -.Cm E , -.Cm f , -.Cm g , +.Cm e , E , f , g , and -.Cm G , +.Cm G conversions, the result will always contain a decimal point, even if no digits follow it (normally, a decimal point appears in the results of those conversions only if a digit follows). @@ -247,55 +232,46 @@ and conversions, trailing zeros are not removed from the result as they would otherwise be. .It -A zero -.Sq Cm \&0 +A +.Cm 0 +(zero) character specifying zero padding. For all conversions except .Cm n , the converted value is padded on the left with zeros rather than blanks. If a precision is given with a numeric conversion -.Pf ( Cm d , -.Cm i , -.Cm o , -.Cm u , -.Cm i , -.Cm x , +.Cm ( d , i , o , u , i , x , and .Cm X ) , the -.Sq Cm \&0 +.Cm 0 flag is ignored. .It A negative field width flag -.Sq Cm \- +.Cm \- indicates the converted value is to be left adjusted on the field boundary. Except for .Cm n conversions, the converted value is padded on the right with blanks, rather than on the left with blanks or zeros. A -.Sq Cm \- +.Cm \- overrides a -.Sq Cm \&0 +.Cm 0 if both are given. .It A space, specifying that a blank should be left before a positive number produced by a signed conversion -.Pf ( Cm d , -.Cm e , -.Cm E , -.Cm f , -.Cm g , -.Cm G , +.Cm ( d , e , E , f , g , G , or .Cm i ) . .It A -.Sq Cm + +.Cm + character specifying that a sign always be placed before a number produced by a signed conversion. A -.Sq Cm + +.Cm + overrides a space if both are used. .El .It @@ -306,20 +282,16 @@ flag has been given) to fill out the field width. .It An optional precision, in the form of a period -.Sq Cm .\& +.Cm \&. followed by an -optional digit string. If the digit string is omitted, the precision -is taken as zero. This gives the minimum number of digits to appear for -.Cm d , -.Cm i , -.Cm o , -.Cm u , -.Cm x , +optional digit string. +If the digit string is omitted, the precision is taken as zero. +This gives the minimum number of digits to appear for +.Cm d , i , o , u , x , and .Cm X conversions, the number of digits to appear after the decimal-point for -.Cm e , -.Cm E , +.Cm e , E , and .Cm f conversions, the maximum number of significant digits for @@ -334,94 +306,75 @@ conversions. The optional character .Cm h , specifying that a following -.Cm d , -.Cm i , -.Cm o , -.Cm u , -.Cm x , +.Cm d , i , o , u , x , or .Cm X conversion corresponds to a -.Em short int +.Vt short int or -.Em unsigned short int +.Vt unsigned short int argument, or that a following .Cm n conversion corresponds to a pointer to a -.Em short int +.Vt short int argument. .It The optional character .Cm l (ell) specifying that a following -.Cm d , -.Cm i , -.Cm o , -.Cm u , -.Cm x , +.Cm d , i , o , u , x , or .Cm X conversion applies to a pointer to a -.Em long int +.Vt long int or -.Em unsigned long int +.Vt unsigned long int argument, or that a following .Cm n conversion corresponds to a pointer to a -.Em long int +.Vt long int argument. .It The optional characters .Cm ll (ell ell) specifying that a following -.Cm d , -.Cm i , -.Cm o , -.Cm u , -.Cm x , +.Cm d , i , o , u , x , or .Cm X conversion applies to a pointer to a -.Em long long int +.Vt long long int or -.Em unsigned long long int +.Vt unsigned long long int argument, or that a following .Cm n conversion corresponds to a pointer to a -.Em long long int +.Vt long long int argument. .It The optional character .Cm q , specifying that a following -.Cm d , -.Cm i , -.Cm o , -.Cm u , -.Cm x , +.Cm d , i , o , u , x , or .Cm X conversion corresponds to a -.Em quad int +.Vt quad int or -.Em unsigned quad int +.Vt unsigned quad int argument, or that a following .Cm n conversion corresponds to a pointer to a -.Em quad int +.Vt quad int argument. .It The character .Cm L specifying that a following -.Cm e , -.Cm E , -.Cm f , -.Cm g , +.Cm e , E , f , g , or .Cm G conversion corresponds to a -.Em long double +.Vt long double argument. .It A character that specifies the type of conversion to be applied. @@ -435,7 +388,7 @@ or an asterisk followed by one or more decimal digits and a instead of a digit string. In this case, an -.Em int +.Vt int argument supplies the field width or precision. A negative field width is treated as a left adjustment flag followed by a positive field width; a negative precision is treated as though it were @@ -447,9 +400,9 @@ The conversion specifiers and their meanings are: .Bl -tag -width "diouxX" .It Cm diouxX The -.Em int +.Vt int (or appropriate variant) argument is converted to signed decimal -.Pf ( Cm d +.Cm ( d and .Cm i ) , unsigned octal @@ -457,10 +410,11 @@ unsigned octal unsigned decimal .Pq Cm u , or unsigned hexadecimal -.Pf ( Cm x +.Cm ( x and .Cm X ) -notation. The letters +notation. +The letters .Cm abcdef are used for .Cm x @@ -474,22 +428,19 @@ appear; if the converted value requires fewer digits, it is padded on the left with zeros. .It Cm DOU The -.Em long int +.Vt long int argument is converted to signed decimal, unsigned octal, or unsigned decimal, as if the format had been -.Cm ld , -.Cm lo , +.Cm ld , lo , or .Cm lu respectively. These conversion characters are deprecated, and will eventually disappear. .It Cm eE The -.Em double +.Vt double argument is rounded and converted in the style -.Sm off -.Pf [\-]d Cm \&. No ddd Cm e No \\*(Pmdd -.Sm on +.Oo \- Oc Ns d Ns Cm \&. Ns ddd Ns Cm e Ns \\*[Pm]dd where there is one digit before the decimal-point character and the number of digits after it is equal to the precision; @@ -507,11 +458,9 @@ The exponent always contains at least two digits; if the value is zero, the exponent is 00. .It Cm f The -.Em double +.Vt double argument is rounded and converted to decimal notation in the style -.Sm off -.Pf [-]ddd Cm \&. No ddd , -.Sm on +.Oo \- Oc Ns ddd Ns Cm \&. Ns ddd , where the number of digits after the decimal-point character is equal to the precision specification. If the precision is missing, it is taken as 6; if the precision is @@ -519,7 +468,7 @@ explicitly zero, no decimal-point character appears. If a decimal point appears, at least one digit appears before it. .It Cm gG The -.Em double +.Vt double argument is converted in style .Cm f or @@ -540,13 +489,13 @@ Trailing zeros are removed from the fractional part of the result; a decimal point appears only if it is followed by at least one digit. .It Cm c The -.Em int +.Vt int argument is converted to an -.Em unsigned char , +.Vt unsigned char , and the resulting character is written. .It Cm s The -.Dq Em char * +.Vt char * argument is expected to be a pointer to an array of character type (pointer to a string). Characters from the array are written up to (but not including) @@ -562,7 +511,7 @@ the size of the array, the array must contain a terminating character. .It Cm p The -.Dq Em void * +.Vt void * pointer argument is printed in hexadecimal (as if by .Ql %#x or @@ -570,7 +519,7 @@ or .It Cm n The number of characters written so far is stored into the integer indicated by the -.Dq Em int * +.Vt int * (or variant) pointer argument. No argument is converted. .It Cm % @@ -586,13 +535,13 @@ is In no case does a non-existent or small field width cause truncation of a field; if the result of a conversion is wider than the field width, the field is expanded to contain the conversion result. -.Pp .Sh EXAMPLES -To print a date and time in the form `Sunday, July 3, 10:02', +To print a date and time in the form +.Dq Li "Sunday, July 3, 10:02" , where -.Em weekday +.Fa weekday and -.Em month +.Fa month are pointers to strings: .Bd -literal -offset indent #include <stdio.h> @@ -645,7 +594,9 @@ The functions .Fn asprintf and .Fn vasprintf -first appeared in the GNU C library. +first appeared in the +.Tn GNU C +library. These were implemented by .An Peter Wemm Aq peter@FreeBSD.org in @@ -657,8 +608,7 @@ for .Ox 2.3 . .Sh BUGS The conversion formats -.Cm \&%D , -.Cm \&%O , +.Cm \&%D , \&%O , and .Cm %U are not standard and @@ -666,10 +616,10 @@ are provided only for backward compatibility. The effect of padding the .Cm %p format with zeros (either by the -.Sq Cm 0 +.Cm 0 flag or by specifying a precision), and the benign effect (i.e., none) of the -.Sq Cm # +.Cm # flag on .Cm %n and diff --git a/lib/libc/stdio/remove.3 b/lib/libc/stdio/remove.3 index a79219f8e5c8..c463a5558af3 100644 --- a/lib/libc/stdio/remove.3 +++ b/lib/libc/stdio/remove.3 @@ -63,12 +63,7 @@ is the equivalent of Otherwise, it is the equivalent of .Fn unlink "path" . .Sh RETURN VALUES -Upon successful completion, -.Fn remove -returns 0. -Otherwise, \-1 is returned and the global variable -.Va errno -is set to indicate the error. +.Rv -std remove .Sh ERRORS The .Fn remove diff --git a/lib/libc/stdio/setbuf.3 b/lib/libc/stdio/setbuf.3 index 67179f42c7cf..d2b20564902d 100644 --- a/lib/libc/stdio/setbuf.3 +++ b/lib/libc/stdio/setbuf.3 @@ -38,7 +38,7 @@ .\" .Dd June 4, 1993 .Dt SETBUF 3 -.Os BSD 4 +.Os .Sh NAME .Nm setbuf , .Nm setbuffer , diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3 index 3bca0aae6483..f91e2f74bebf 100644 --- a/lib/libc/stdio/stdio.3 +++ b/lib/libc/stdio/stdio.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt STDIO 3 -.Os BSD 4 +.Os .Sh NAME .Nm stdio .Nd standard input/output library functions diff --git a/lib/libc/stdio/ungetc.3 b/lib/libc/stdio/ungetc.3 index f3de89d9315d..83483be04ffb 100644 --- a/lib/libc/stdio/ungetc.3 +++ b/lib/libc/stdio/ungetc.3 @@ -61,12 +61,10 @@ stream (in reverse order). A successful intervening call, using the same stream, to one of the file positioning functions -.Po -.Xr fseek 3 , +.Xr ( fseek 3 , .Xr fsetpos 3 , or -.Xr rewind 3 -.Pc +.Xr rewind 3 ) will discard the pushed back characters. .Pp One character of push-back is guaranteed, diff --git a/lib/libc/stdlib/alloca.3 b/lib/libc/stdlib/alloca.3 index de09a0384241..db0ea46a24de 100644 --- a/lib/libc/stdlib/alloca.3 +++ b/lib/libc/stdlib/alloca.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt ALLOCA 3 -.Os BSD 4 +.Os .Sh NAME .Nm alloca .Nd memory allocator diff --git a/lib/libc/stdlib/getopt.3 b/lib/libc/stdlib/getopt.3 index d0782f3a1e33..bf1549f368bd 100644 --- a/lib/libc/stdlib/getopt.3 +++ b/lib/libc/stdlib/getopt.3 @@ -34,7 +34,7 @@ .\" .Dd April 27, 1995 .Dt GETOPT 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm getopt .Nd get option character from command line argument list diff --git a/lib/libc/stdlib/malloc.3 b/lib/libc/stdlib/malloc.3 index 584f03bf3007..33cda594efe1 100644 --- a/lib/libc/stdlib/malloc.3 +++ b/lib/libc/stdlib/malloc.3 @@ -38,7 +38,7 @@ .\" .Dd August 27, 1996 .Dt MALLOC 3 -.Os FreeBSD +.Os .Sh NAME .Nm malloc , calloc , realloc , free , reallocf .Nd general purpose memory allocation functions @@ -73,7 +73,9 @@ bytes in length (see the returned memory will be page boundary aligned as well. If .Fn malloc -fails, a NULL pointer is returned. +fails, a +.Dv NULL +pointer is returned. .Pp Note that .Fn malloc @@ -107,13 +109,17 @@ The contents of the memory are unchanged up to the lesser of the new and old sizes. If the new size is larger, the value of the newly allocated portion of the memory is undefined. -If the requested memory cannot be allocated, NULL is returned and +If the requested memory cannot be allocated, +.Dv NULL +is returned and the memory referenced by .Fa ptr is valid and unchanged. If .Fa ptr -is NULL, the +is +.Dv NULL , +the .Fn realloc function behaves identically to .Fn malloc @@ -135,7 +141,9 @@ function causes the allocated memory referenced by to be made available for future allocations. If .Fa ptr -is NULL, no action occurs. +is +.Dv NULL , +no action occurs. .Sh TUNING Once, when the first call is made to one of these memory allocation routines, various flags will be set or reset, which affect the @@ -195,7 +203,9 @@ entries for for all operations. Consult the source for details on this option. .It V -Attempting to allocate zero bytes will return a NULL pointer instead of +Attempting to allocate zero bytes will return a +.Dv NULL +pointer instead of a valid pointer. (The default behavior is to make a minimal allocation and return a pointer to it.) @@ -255,7 +265,7 @@ malloc_options = "X"; .Sh ENVIRONMENT The following environment variables affect the execution of the allocation functions: -.Bl -tag -width MMM +.Bl -tag -width ".Ev MALLOC_OPTIONS" .It Ev MALLOC_OPTIONS If the environment variable .Ev MALLOC_OPTIONS @@ -268,7 +278,9 @@ The and .Fn calloc functions return a pointer to the allocated memory if successful; otherwise -a NULL pointer is returned and +a +.Dv NULL +pointer is returned and .Va errno is set to .Er ENOMEM . @@ -280,7 +292,9 @@ and functions return a pointer, possibly identical to .Fa ptr , to the allocated memory -if successful; otherwise a NULL pointer is returned, in which case the +if successful; otherwise a +.Dv NULL +pointer is returned, in which case the memory referenced by .Fa ptr is still available and intact. @@ -367,55 +381,54 @@ option is set, all warnings are treated as errors. The following is a brief description of possible error messages and their meanings: .Pp -.Bl -tag -width indent -.It "(ES): mumble mumble mumble +.Bl -diag +.It "(ES): mumble mumble mumble" The allocation functions were compiled with .Dq EXTRA_SANITY defined, and an error was found during the additional error checking. Consult the source code for further information. -.It "mmap(2) failed, check limits +.It "mmap(2) failed, check limits" This most likely means that the system is dangerously overloaded or that the process' limits are incorrectly specified. -.It "freelist is destroyed +.It "freelist is destroyed" The internal free-list has been corrupted. +.It "out of memory" +The +.Dq X +option was specified and an allocation of memory failed. .El .Pp -.Bl -tag -width indent The following is a brief description of possible warning messages and their meanings: -.Pp -.It "chunk/page is already free +.Bl -diag +.It "chunk/page is already free" The process attempted to .Fn free memory which had already been freed. -.It "junk pointer ... +.It "junk pointer, ..." A pointer specified to one of the allocation functions points outside the bounds of the memory of which they are aware. -.It "malloc() has never been called +.It "malloc() has never been called" No memory has been allocated, yet something is being freed or realloc'ed. -.It "modified (chunk-/page-) pointer +.It "modified (chunk-/page-) pointer" The pointer passed to .Fn free or .Fn realloc has been modified. -.It "pointer to wrong page +.It "pointer to wrong page" The pointer that .Fn malloc or .Fn calloc is trying to free does not reference a possible page. -.It "recursive call +.It "recursive call" A process has attempted to call an allocation function recursively. This is not permitted. In particular, signal handlers should not attempt to allocate memory. -.It "out of memory -The -.Dq X -option was specified and an allocation of memory failed. -.It "unknown char in MALLOC_OPTIONS +.It "unknown char in MALLOC_OPTIONS" An unknown option was specified. Even with the .Dq A @@ -423,6 +436,7 @@ option set, this warning is still only a warning. .El .Sh SEE ALSO .Xr brk 2 , +.Xr mmap 2 , .Xr alloca 3 , .Xr getpagesize 3 , .Xr memory 3 @@ -436,12 +450,6 @@ and .Fn free functions conform to .St -isoC . -.Sh BUGS -The messages printed in case of problems provide no detail about the -actual values. -.Pp -It can be argued that returning a null pointer when asked to -allocate zero bytes is a silly response to a silly question. .Sh HISTORY The present allocation implementation started out as a filesystem for a drum attached to a 20bit binary challenged computer which was built @@ -456,3 +464,11 @@ function first appeared in .Fx 3.0 . .Sh AUTHORS .An Poul-Henning Kamp Aq phk@FreeBSD.org +.Sh BUGS +The messages printed in case of problems provide no detail about the +actual values. +.Pp +It can be argued that returning a +.Dv NULL +pointer when asked to +allocate zero bytes is a silly response to a silly question. diff --git a/lib/libc/stdlib/memory.3 b/lib/libc/stdlib/memory.3 index f9a2bc798c01..65fced200a4d 100644 --- a/lib/libc/stdlib/memory.3 +++ b/lib/libc/stdlib/memory.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt MEMORY 3 -.Os BSD 4 +.Os .Sh NAME .Nm malloc , .Nm free , diff --git a/lib/libc/stdlib/radixsort.3 b/lib/libc/stdlib/radixsort.3 index 90a52c66aa56..04b2007a4533 100644 --- a/lib/libc/stdlib/radixsort.3 +++ b/lib/libc/stdlib/radixsort.3 @@ -108,10 +108,7 @@ These functions are variants of most-significant-byte radix sorting; in particular, see D.E. Knuth's Algorithm R and section 5.2.5, exercise 10. They take linear time relative to the number of bytes in the strings. .Sh RETURN VALUES -Upon successful completion 0 is returned. -Otherwise, \-1 is returned and the global variable -.Va errno -is set to indicate the error. +.Rv -std radixsort .Sh ERRORS .Bl -tag -width Er .It Bq Er EINVAL diff --git a/lib/libc/stdlib/rand.3 b/lib/libc/stdlib/rand.3 index 700470063436..ecf87d66ef19 100644 --- a/lib/libc/stdlib/rand.3 +++ b/lib/libc/stdlib/rand.3 @@ -56,7 +56,8 @@ .Fn rand_r "unsigned *ctx" .Sh DESCRIPTION .Bf -symbolic -These interfaces are obsoleted by random(3). +These interfaces are obsoleted by +.Xr random 3 . .Ef .Pp The diff --git a/lib/libc/stdlib/random.3 b/lib/libc/stdlib/random.3 index 2b07a204382f..cb1bec7b72d2 100644 --- a/lib/libc/stdlib/random.3 +++ b/lib/libc/stdlib/random.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt RANDOM 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm random , .Nm srandom , diff --git a/lib/libc/stdtime/ctime.3 b/lib/libc/stdtime/ctime.3 index 581212a12907..a30bf4197dad 100644 --- a/lib/libc/stdtime/ctime.3 +++ b/lib/libc/stdtime/ctime.3 @@ -36,7 +36,7 @@ .\" .Dd January 2, 1999 .Dt CTIME 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm asctime , .Nm asctime_r , diff --git a/lib/libc/stdtime/strptime.3 b/lib/libc/stdtime/strptime.3 index b69cbeea8850..78ffd777d05e 100644 --- a/lib/libc/stdtime/strptime.3 +++ b/lib/libc/stdtime/strptime.3 @@ -115,10 +115,10 @@ without .Fa %p will produce undefined results. Note that 12AM -.Pq ante meridiem +(ante meridiem) is taken as midnight and 12PM -.Pq post meridiem +(post meridiem) is taken as noon. .Pp The diff --git a/lib/libc/stdtime/tzfile.5 b/lib/libc/stdtime/tzfile.5 index e29d4d73350e..cc7e65966060 100644 --- a/lib/libc/stdtime/tzfile.5 +++ b/lib/libc/stdtime/tzfile.5 @@ -1,7 +1,7 @@ .\" $FreeBSD$ .Dd September 13, 1994 .Dt TZFILE 5 -.Os FreeBSD +.Os .Sh NAME .Nm tzfile .Nd timezone information diff --git a/lib/libc/string/bcmp.3 b/lib/libc/string/bcmp.3 index a901c257e035..8d06b8b6fb5a 100644 --- a/lib/libc/string/bcmp.3 +++ b/lib/libc/string/bcmp.3 @@ -36,7 +36,7 @@ .\" .Dd June 4, 1993 .Dt BCMP 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm bcmp .Nd compare byte string diff --git a/lib/libc/string/bcopy.3 b/lib/libc/string/bcopy.3 index 591edf04bd97..095ae053fa83 100644 --- a/lib/libc/string/bcopy.3 +++ b/lib/libc/string/bcopy.3 @@ -37,7 +37,7 @@ .\" .Dd June 4, 1993 .Dt BCOPY 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm bcopy .Nd copy byte string diff --git a/lib/libc/string/bzero.3 b/lib/libc/string/bzero.3 index c94b18153e87..73d34289d416 100644 --- a/lib/libc/string/bzero.3 +++ b/lib/libc/string/bzero.3 @@ -37,7 +37,7 @@ .\" .Dd June 4, 1993 .Dt BZERO 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm bzero .Nd write zeroes to a byte string diff --git a/lib/libc/string/strerror.3 b/lib/libc/string/strerror.3 index 1799c1c6a8b2..e714ff24b4c3 100644 --- a/lib/libc/string/strerror.3 +++ b/lib/libc/string/strerror.3 @@ -38,7 +38,7 @@ .\" .Dd June 9, 1993 .Dt STRERROR 3 -.Os BSD 4 +.Os .Sh NAME .Nm perror , .Nm strerror , diff --git a/lib/libc/string/string.3 b/lib/libc/string/string.3 index 6a3457c12b9b..e822f7f841be 100644 --- a/lib/libc/string/string.3 +++ b/lib/libc/string/string.3 @@ -36,7 +36,7 @@ .\" .Dd December 11, 1993 .Dt STRING 3 -.Os BSD 4 +.Os .Sh NAME .Nm strcat , .Nm strncat , diff --git a/lib/libc/string/strlcpy.3 b/lib/libc/string/strlcpy.3 index f22c89711477..2d2bb8c6f863 100644 --- a/lib/libc/string/strlcpy.3 +++ b/lib/libc/string/strlcpy.3 @@ -146,9 +146,9 @@ if (strlcat(pname, file, sizeof(pname)) >= sizeof(pname)) .Ed .Pp Since we know how many characters we copied the first time, we can -speed things up a bit by using a copy instead on an append: +speed things up a bit by using a copy instead of an append: .Bd -literal -offset indent -char *dir, *file, pname[MAXPATHNAMELEN]; +char *dir, *file, pname[MAXPATHLEN]; size_t n; \&... diff --git a/lib/libc/string/strtok.3 b/lib/libc/string/strtok.3 index 945904d5e082..814cee57388c 100644 --- a/lib/libc/string/strtok.3 +++ b/lib/libc/string/strtok.3 @@ -52,7 +52,7 @@ .\" .Dd November 27, 1998 .Dt STRTOK 3 -.Os FreeBSD +.Os .Sh NAME .Nm strtok , strtok_r .Nd string tokens @@ -66,7 +66,8 @@ .Fn strtok_r "char *str" "const char *sep" "char **last" .Sh DESCRIPTION .Bf -symbolic -This interface is obsoleted by strsep(3). +This interface is obsoleted by +.Xr strsep 3 . .Ef .Pp The diff --git a/lib/libc/sys/_exit.2 b/lib/libc/sys/_exit.2 index 0ec1bfdf0a25..efeb4e86a7ad 100644 --- a/lib/libc/sys/_exit.2 +++ b/lib/libc/sys/_exit.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt EXIT 2 -.Os BSD 4 +.Os .Sh NAME .Nm _exit .Nd terminate the calling process diff --git a/lib/libc/sys/accept.2 b/lib/libc/sys/accept.2 index 9e6b5fdc6b68..968f4cecbd7d 100644 --- a/lib/libc/sys/accept.2 +++ b/lib/libc/sys/accept.2 @@ -34,7 +34,7 @@ .\" .Dd December 11, 1993 .Dt ACCEPT 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm accept .Nd accept a connection on a socket diff --git a/lib/libc/sys/access.2 b/lib/libc/sys/access.2 index 8bb7f168c679..6a11a00c24b8 100644 --- a/lib/libc/sys/access.2 +++ b/lib/libc/sys/access.2 @@ -34,7 +34,7 @@ .\" .Dd April 1, 1994 .Dt ACCESS 2 -.Os BSD 4 +.Os .Sh NAME .Nm access .Nd check access permissions of a file or pathname diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2 index 69d160e38787..ed41171cf729 100644 --- a/lib/libc/sys/acct.2 +++ b/lib/libc/sys/acct.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt ACCT 2 -.Os BSD 4 +.Os .Sh NAME .Nm acct .Nd enable or disable process accounting diff --git a/lib/libc/sys/adjtime.2 b/lib/libc/sys/adjtime.2 index 4e447c91a277..f6a005171d50 100644 --- a/lib/libc/sys/adjtime.2 +++ b/lib/libc/sys/adjtime.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt ADJTIME 2 -.Os BSD 4.3 +.Os .Sh NAME .Nm adjtime .Nd "correct the time to allow synchronization of the system clock" @@ -84,10 +84,7 @@ The call .Fn adjtime is restricted to the super-user. .Sh RETURN VALUES -A return value of 0 indicates that the call succeeded. -A return value of -1 indicates that an error occurred, and in this -case an error code is stored in the global variable -.Va errno . +.Rv -std adjtime .Sh ERRORS .Fn Adjtime will fail if: diff --git a/lib/libc/sys/bind.2 b/lib/libc/sys/bind.2 index d41849802a35..7024168d74f1 100644 --- a/lib/libc/sys/bind.2 +++ b/lib/libc/sys/bind.2 @@ -34,10 +34,10 @@ .\" .Dd June 4, 1993 .Dt BIND 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm bind -.Nd assign a local protocol address to a socket. +.Nd assign a local protocol address to a socket .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -86,10 +86,7 @@ Before returning, unlocks .Fa s . .Sh RETURN VALUES -If the bind is successful, a 0 value is returned. -A return value of -1 indicates an error, which is -further specified in the global -.Va errno . +.Rv -std bind .Sh ERRORS The .Fn bind diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2 index d501ae1f25ad..50c819635c6a 100644 --- a/lib/libc/sys/brk.2 +++ b/lib/libc/sys/brk.2 @@ -34,7 +34,7 @@ .\" .Dd May 1, 1995 .Dt BRK 2 -.Os BSD 4 +.Os .Sh NAME .Nm brk , .Nm sbrk diff --git a/lib/libc/sys/chdir.2 b/lib/libc/sys/chdir.2 index 0bbbd7dbd014..bd969f9c0ead 100644 --- a/lib/libc/sys/chdir.2 +++ b/lib/libc/sys/chdir.2 @@ -34,7 +34,7 @@ .\" .Dd December 11, 1993 .Dt CHDIR 2 -.Os BSD 4 +.Os .Sh NAME .Nm chdir , .Nm fchdir diff --git a/lib/libc/sys/chmod.2 b/lib/libc/sys/chmod.2 index c2a0ae450054..cc056d8527be 100644 --- a/lib/libc/sys/chmod.2 +++ b/lib/libc/sys/chmod.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt CHMOD 2 -.Os BSD 4 +.Os .Sh NAME .Nm chmod , .Nm fchmod , diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2 index 13b488f4ac20..363893ac784a 100644 --- a/lib/libc/sys/chown.2 +++ b/lib/libc/sys/chown.2 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt CHOWN 2 -.Os BSD 4 +.Os .Sh NAME .Nm chown , .Nm fchown , diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2 index db1053403b90..eeb9def46521 100644 --- a/lib/libc/sys/chroot.2 +++ b/lib/libc/sys/chroot.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt CHROOT 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm chroot .Nd change root directory diff --git a/lib/libc/sys/clock_gettime.2 b/lib/libc/sys/clock_gettime.2 index 02e076c869ff..57375608e2f1 100644 --- a/lib/libc/sys/clock_gettime.2 +++ b/lib/libc/sys/clock_gettime.2 @@ -34,7 +34,7 @@ .\" .Dd May 8, 1997 .Dt CLOCK_GETTIME 2 -.Os BSD 4 +.Os .Sh NAME .Nm clock_gettime , .Nm clock_settime , @@ -121,6 +121,6 @@ A user other than the super-user attempted to set the time. .Sh STANDARDS The .Fn clock_gettime , -etc. +etc.\& functions conform to .St -p1003.1b-93 . diff --git a/lib/libc/sys/close.2 b/lib/libc/sys/close.2 index 9071e0c58165..6a6fb0f53f63 100644 --- a/lib/libc/sys/close.2 +++ b/lib/libc/sys/close.2 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt CLOSE 2 -.Os BSD 4 +.Os .Sh NAME .Nm close .Nd delete a descriptor @@ -123,10 +123,7 @@ Before returning, unlocks .Fa d . .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and the global integer variable -.Va errno -is set to indicate the error. +.Rv -std close .Sh ERRORS .Fn Close will fail if: diff --git a/lib/libc/sys/connect.2 b/lib/libc/sys/connect.2 index a8b920071bf9..eb1c6182cfb8 100644 --- a/lib/libc/sys/connect.2 +++ b/lib/libc/sys/connect.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt CONNECT 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm connect .Nd initiate a connection on a socket @@ -96,10 +96,7 @@ Before returning, unlocks .Va s . .Sh RETURN VALUES -If the connection or binding succeeds, 0 is returned. -Otherwise a -1 is returned, and a more specific error -code is stored in -.Va errno . +.Rv -std connect .Sh ERRORS The .Fn connect diff --git a/lib/libc/sys/dup.2 b/lib/libc/sys/dup.2 index da0f480a14c4..9c2a7b1b462b 100644 --- a/lib/libc/sys/dup.2 +++ b/lib/libc/sys/dup.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt DUP 2 -.Os BSD 4 +.Os .Sh NAME .Nm dup , .Nm dup2 @@ -96,7 +96,7 @@ the value of the new descriptor .Fa newd is specified. If this descriptor is already in use and .Fa oldd -!= +\*(Ne .Fa newd , the descriptor is first deallocated as if a .Xr close 2 diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2 index f7bd2e9d6d26..9086232b44e0 100644 --- a/lib/libc/sys/execve.2 +++ b/lib/libc/sys/execve.2 @@ -34,7 +34,7 @@ .\" .Dd June 1, 1994 .Dt EXECVE 2 -.Os BSD 4 +.Os .Sh NAME .Nm execve .Nd execute a file @@ -276,8 +276,8 @@ is ``root'', then the program has some of the powers of a super-user as well. .Sh SEE ALSO .Xr ktrace 1 , -.Xr _exit 2 , .Xr fork 2 , +.Xr _exit 2 , .Xr execl 3 , .Xr exit 3 , .Xr sysctl 3 , diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2 index c4e13d26af6d..86364c151b4d 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -34,7 +34,7 @@ .\" .Dd January 12, 1994 .Dt FCNTL 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm fcntl .Nd file control diff --git a/lib/libc/sys/fhopen.2 b/lib/libc/sys/fhopen.2 index 07cfa47923c4..6deb16a057e8 100644 --- a/lib/libc/sys/fhopen.2 +++ b/lib/libc/sys/fhopen.2 @@ -120,10 +120,10 @@ The file handle is no longer valid. .El .Sh SEE ALSO -.Xr getfh 2 , -.Xr open 2 , .Xr fstat 2 , -.Xr fstatfs 2 +.Xr fstatfs 2 , +.Xr getfh 2 , +.Xr open 2 .Sh HISTORY The .Fn fhopen , @@ -138,4 +138,5 @@ by Alfred Perlstein. .Sh AUTHORS This man page was written by .An William Studenmund -for NetBSD. +for +.Nx . diff --git a/lib/libc/sys/flock.2 b/lib/libc/sys/flock.2 index 119bfe149fe5..d890bedadcc9 100644 --- a/lib/libc/sys/flock.2 +++ b/lib/libc/sys/flock.2 @@ -34,7 +34,7 @@ .\" .Dd December 11, 1993 .Dt FLOCK 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm flock .Nd "apply or remove an advisory lock on an open file" @@ -134,10 +134,7 @@ Before returning, unlocks .Fa fd . .Sh RETURN VALUES -Zero is returned if the operation was successful; -on an error a -1 is returned and an error code is left in -the global location -.Va errno . +.Rv -std flock .Sh ERRORS The .Fn flock diff --git a/lib/libc/sys/fork.2 b/lib/libc/sys/fork.2 index ba948731dd1b..047e5a98ff15 100644 --- a/lib/libc/sys/fork.2 +++ b/lib/libc/sys/fork.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt FORK 2 -.Os BSD 4 +.Os .Sh NAME .Nm fork .Nd create a new process diff --git a/lib/libc/sys/fsync.2 b/lib/libc/sys/fsync.2 index a2f75bb2cbdb..33a0167c06b4 100644 --- a/lib/libc/sys/fsync.2 +++ b/lib/libc/sys/fsync.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt FSYNC 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm fsync .Nd "synchronise changes to a file" @@ -78,8 +78,7 @@ Before returning, unlocks .Fa fd . .Sh RETURN VALUES -A 0 value is returned on success. A -1 value indicates -an error. +.Rv -std fsync .Sh ERRORS The .Fn fsync diff --git a/lib/libc/sys/getdtablesize.2 b/lib/libc/sys/getdtablesize.2 index 0254456d9917..28344ac430fd 100644 --- a/lib/libc/sys/getdtablesize.2 +++ b/lib/libc/sys/getdtablesize.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETDTABLESIZE 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm getdtablesize .Nd get descriptor table size diff --git a/lib/libc/sys/getfh.2 b/lib/libc/sys/getfh.2 index d0ec2ede2d0f..422c1f6fb814 100644 --- a/lib/libc/sys/getfh.2 +++ b/lib/libc/sys/getfh.2 @@ -52,10 +52,7 @@ in the file handle pointed to by .Fa fhp . This system call is restricted to the superuser. .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, -1 is returned and the global variable -.Va errno -is set to indicate the error. +.Rv -std getfh .Sh ERRORS .Fn Getfh fails if one or more of the following are true: diff --git a/lib/libc/sys/getgid.2 b/lib/libc/sys/getgid.2 index 83285167bad5..39215e19a225 100644 --- a/lib/libc/sys/getgid.2 +++ b/lib/libc/sys/getgid.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETGID 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm getgid , .Nm getegid diff --git a/lib/libc/sys/getgroups.2 b/lib/libc/sys/getgroups.2 index 9edf10ba9f82..7b0789d90fcf 100644 --- a/lib/libc/sys/getgroups.2 +++ b/lib/libc/sys/getgroups.2 @@ -34,7 +34,7 @@ .\" .Dd March 5, 1999 .Dt GETGROUPS 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm getgroups .Nd get group access list diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index 91bc638cebf0..156caa1cc558 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -34,7 +34,7 @@ .\" .Dd May 16, 1995 .Dt GETITIMER 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm getitimer , .Nm setitimer diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2 index c52bb2e2e1e1..89c9211cea8c 100644 --- a/lib/libc/sys/getlogin.2 +++ b/lib/libc/sys/getlogin.2 @@ -34,7 +34,7 @@ .\" .Dd June 9, 1993 .Dt GETLOGIN 2 -.Os BSD 4.4 +.Os .Sh NAME .Nm getlogin , .Nm getlogin_r , diff --git a/lib/libc/sys/getpeername.2 b/lib/libc/sys/getpeername.2 index af79bfa3cd11..28d7a92e18cd 100644 --- a/lib/libc/sys/getpeername.2 +++ b/lib/libc/sys/getpeername.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETPEERNAME 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm getpeername .Nd get name of connected peer @@ -80,7 +80,7 @@ Before returning, unlocks .Fa s . .Sh RETURN VALUES -A 0 is returned if the call succeeds, -1 if it fails. +.Rv -std getpeername .Sh ERRORS The call succeeds unless: .Bl -tag -width Er diff --git a/lib/libc/sys/getpgrp.2 b/lib/libc/sys/getpgrp.2 index 06aa8c433c9d..30209ac663c7 100644 --- a/lib/libc/sys/getpgrp.2 +++ b/lib/libc/sys/getpgrp.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETPGRP 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm getpgrp .Nd get process group diff --git a/lib/libc/sys/getpid.2 b/lib/libc/sys/getpid.2 index 2bebebbc85c6..656d7e71b606 100644 --- a/lib/libc/sys/getpid.2 +++ b/lib/libc/sys/getpid.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETPID 2 -.Os BSD 4 +.Os .Sh NAME .Nm getpid , .Nm getppid diff --git a/lib/libc/sys/getpriority.2 b/lib/libc/sys/getpriority.2 index 9db9d51cddf2..efaa5ed826a2 100644 --- a/lib/libc/sys/getpriority.2 +++ b/lib/libc/sys/getpriority.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETPRIORITY 2 -.Os BSD 4 +.Os .Sh NAME .Nm getpriority , .Nm setpriority diff --git a/lib/libc/sys/getrlimit.2 b/lib/libc/sys/getrlimit.2 index 17a4412c21a8..9b762145e380 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETRLIMIT 2 -.Os BSD 4 +.Os .Sh NAME .Nm getrlimit , .Nm setrlimit diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2 index 34cba3295805..80e119791297 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETRUSAGE 2 -.Os BSD 4 +.Os .Sh NAME .Nm getrusage .Nd get information about resource utilization @@ -152,11 +152,7 @@ account only for real I/O; data supplied by the caching mechanism is charged only to the first process to read or write the data. .Sh RETURN VALUES -Upon successful completion, -.Fn getrusage -returns 0. Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std getrusage .Sh ERRORS The .Fn getrusage diff --git a/lib/libc/sys/getsid.2 b/lib/libc/sys/getsid.2 index 00f46c90c1f4..ea91e62c2249 100644 --- a/lib/libc/sys/getsid.2 +++ b/lib/libc/sys/getsid.2 @@ -1,4 +1,4 @@ -.\" Copyright (c) 1997 Peter Wemm <peter@freebsd.org> +.\" Copyright (c) 1997 Peter Wemm <peter@FreeBSD.org> .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions @@ -25,7 +25,7 @@ .\" .Dd August 19, 1997 .Dt GETSID 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm getsid .Nd get process session diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2 index 3eb0563bc9cb..e5b2c3c5048c 100644 --- a/lib/libc/sys/getsockname.2 +++ b/lib/libc/sys/getsockname.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETSOCKNAME 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm getsockname .Nd get socket name @@ -78,7 +78,7 @@ Before returning, unlocks .Fa fd . .Sh RETURN VALUES -A 0 is returned if the call succeeds, -1 if it fails. +.Rv -std getsockname .Sh ERRORS The call succeeds unless: .Bl -tag -width Er diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index 66c00e75b30b..b5bc37ba7d36 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -34,7 +34,7 @@ .\" .Dd May 2, 1995 .Dt GETSOCKOPT 2 -.Os BSD 4.3r +.Os .Sh NAME .Nm getsockopt , .Nm setsockopt diff --git a/lib/libc/sys/gettimeofday.2 b/lib/libc/sys/gettimeofday.2 index bcaa92f21cad..06b7996b5179 100644 --- a/lib/libc/sys/gettimeofday.2 +++ b/lib/libc/sys/gettimeofday.2 @@ -34,7 +34,7 @@ .\" .Dd May 26, 1995 .Dt GETTIMEOFDAY 2 -.Os BSD 4 +.Os .Sh NAME .Nm gettimeofday , .Nm settimeofday diff --git a/lib/libc/sys/getuid.2 b/lib/libc/sys/getuid.2 index 07baf1c3ebdf..95873bf23b33 100644 --- a/lib/libc/sys/getuid.2 +++ b/lib/libc/sys/getuid.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt GETUID 2 -.Os BSD 4 +.Os .Sh NAME .Nm getuid , .Nm geteuid diff --git a/lib/libc/sys/intro.2 b/lib/libc/sys/intro.2 index bcd8c1609195..56dbcd79b22d 100644 --- a/lib/libc/sys/intro.2 +++ b/lib/libc/sys/intro.2 @@ -34,7 +34,7 @@ .\" .Dd February 27, 1995 .Dt INTRO 2 -.Os BSD 4 +.Os .Sh NAME .Nm intro .Nd introduction to system calls and error numbers diff --git a/lib/libc/sys/ioctl.2 b/lib/libc/sys/ioctl.2 index f2da58db8395..15c12e09f0d3 100644 --- a/lib/libc/sys/ioctl.2 +++ b/lib/libc/sys/ioctl.2 @@ -35,7 +35,7 @@ .\" .Dd December 11, 1993 .Dt IOCTL 2 -.Os BSD 4 +.Os .Sh NAME .Nm ioctl .Nd control device diff --git a/lib/libc/sys/jail.2 b/lib/libc/sys/jail.2 index 1347bc0d5bfa..e4575485cb90 100644 --- a/lib/libc/sys/jail.2 +++ b/lib/libc/sys/jail.2 @@ -10,10 +10,10 @@ .\" .Dd April 28, 1999 .Dt JAIL 2 -.Os FreeBSD +.Os .Sh NAME .Nm jail -.Nd Imprison current process and future decendants. +.Nd imprison current process and future decendants .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2 index 2c2166b44004..1e27caf570ea 100644 --- a/lib/libc/sys/kill.2 +++ b/lib/libc/sys/kill.2 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt KILL 2 -.Os BSD 4 +.Os .Sh NAME .Nm kill .Nd send signal to a process @@ -87,9 +87,12 @@ this is a variant of If the user has super-user privileges, the signal is sent to all processes excluding system processes -.Pq with Dv P_SYSTEM flag set , +(with +.Dv P_SYSTEM +flag set), process with ID 1 -.Pq usually Xr init 8 , +(usually +.Xr init 8 ) , and the process sending the signal. If the user is not the super user, the signal is sent to all processes with the same uid as the user excluding the process sending the signal. @@ -103,10 +106,7 @@ is equal to the absolute value of the process number. This is a variant of .Xr killpg 2 . .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std kill .Sh ERRORS .Fn Kill will fail and no signal will be sent if: diff --git a/lib/libc/sys/kldfind.2 b/lib/libc/sys/kldfind.2 index 1ee3f3c08ed2..4cfc6a80c60c 100644 --- a/lib/libc/sys/kldfind.2 +++ b/lib/libc/sys/kldfind.2 @@ -27,7 +27,7 @@ .\" .Dd March 3, 1999 .Dt KLDFIND 2 -.Os FreeBSD +.Os .Sh NAME .Nm kldfind .Nd returns the fileid of a kld file @@ -68,11 +68,14 @@ The file specified is not loaded in the kernel. .Xr kldload 2 , .Xr kldnext 2 , .Xr kldstat 2 , +.Xr kldsym 2 , .Xr kldunload 2 , .Xr modfind 2 , +.Xr modfnext 2 , .Xr modnext 2 , .Xr modstat 2 , -.Xr kld 4 +.Xr kld 4 , +.Xr kldstat 8 .Sh HISTORY The .Nm kld diff --git a/lib/libc/sys/kldfirstmod.2 b/lib/libc/sys/kldfirstmod.2 index d03cc4b1cb8b..adaa6e5ed342 100644 --- a/lib/libc/sys/kldfirstmod.2 +++ b/lib/libc/sys/kldfirstmod.2 @@ -27,7 +27,7 @@ .\" .Dd March 3, 1999 .Dt KLDFIRSTMOD 2 -.Os FreeBSD +.Os .Sh NAME .Nm kldfirstmod .Nd "return first module id from the kld file specified" @@ -61,11 +61,14 @@ was not found. .Xr kldload 2 , .Xr kldnext 2 , .Xr kldstat 2 , +.Xr kldsym 2 , .Xr kldunload 2 , .Xr modfind 2 , +.Xr modfnext 2 , .Xr modnext 2 , .Xr modstat 2 , -.Xr kld 4 +.Xr kld 4 , +.Xr kldstat 8 .Sh HISTORY The .Nm kld diff --git a/lib/libc/sys/kldload.2 b/lib/libc/sys/kldload.2 index fb6170c22768..f5c5ef8092bf 100644 --- a/lib/libc/sys/kldload.2 +++ b/lib/libc/sys/kldload.2 @@ -27,7 +27,7 @@ .\" .Dd March 3, 1999 .Dt KLDLOAD 2 -.Os FreeBSD +.Os .Sh NAME .Nm kldload .Nd load KLD files into the kernel @@ -45,8 +45,8 @@ loads a kld file into the kernel using the kernel linker. .Sh RETURN VALUES The function .Fn kldload -returns the fileid of the kld file which was loaded into the kernel. If -an error occurs, +returns the fileid of the kld file which was loaded into the kernel. +If an error occurs, .Fn kldload will return -1 and set .Va errno @@ -55,8 +55,8 @@ to indicate the error. The named file is loaded unless: .Bl -tag -width Er .It Bq Er EPERM -You do not have access to read the file or link it with the kernel. You should -be the root user to be able to use the +You do not have access to read the file or link it with the kernel. +You should be the root user to be able to use the .Nm kld functions. .It Bq Er EFAULT @@ -75,8 +75,10 @@ was unrecognized. .Xr kldfirstmod 2 , .Xr kldnext 2 , .Xr kldstat 2 , +.Xr kldsym 2 , .Xr kldunload 2 , .Xr modfind 2 , +.Xr modfnext 2 , .Xr modnext 2 , .Xr modstat 2 , .Xr kld 4 , diff --git a/lib/libc/sys/kldnext.2 b/lib/libc/sys/kldnext.2 index 6403ed60a1b6..3382c6800f99 100644 --- a/lib/libc/sys/kldnext.2 +++ b/lib/libc/sys/kldnext.2 @@ -27,7 +27,7 @@ .\" .Dd March 3, 1999 .Dt KLDNEXT 2 -.Os FreeBSD +.Os .Sh NAME .Nm kldnext .Nd return the fileid of the next kld file @@ -65,11 +65,14 @@ refers to a kld file that does not exist (isn't loaded). .Xr kldfirstmod 2 , .Xr kldload 2 , .Xr kldstat 2 , +.Xr kldsym 2 , .Xr kldunload 2 , .Xr modfind 2 , +.Xr modfnext 2 , .Xr modnext 2 , .Xr modstat 2 , -.Xr kld 4 +.Xr kld 4 , +.Xr kldstat 8 .Sh HISTORY The .Nm kld diff --git a/lib/libc/sys/kldstat.2 b/lib/libc/sys/kldstat.2 index 8c3935542441..5b3fe699a8fc 100644 --- a/lib/libc/sys/kldstat.2 +++ b/lib/libc/sys/kldstat.2 @@ -27,7 +27,7 @@ .\" .Dd March 3, 1999 .Dt KLDSTAT 2 -.Os FreeBSD +.Os .Sh NAME .Nm kldstat .Nd get status of kld file @@ -79,12 +79,7 @@ The load address of the kld file. The size of the file. .El .Sh RETURN VALUES -The function -.Fn kldstat -returns 0 on success. -It returns -1 on failure, and sets -.Va errno -to indicate the error. +.Rv -std kldstat .Sh ERRORS The information for the file referred to by .Fa fileid @@ -114,8 +109,10 @@ function. .Xr kldfirstmod 2 , .Xr kldload 2 , .Xr kldnext 2 , +.Xr kldsym 2 , .Xr kldunload 2 , .Xr modfind 2 , +.Xr modfnext 2 , .Xr modnext 2 , .Xr modstat 2 , .Xr kld 4 , diff --git a/lib/libc/sys/kldsym.2 b/lib/libc/sys/kldsym.2 index 4ee5c33d0d12..a67c50240c43 100644 --- a/lib/libc/sys/kldsym.2 +++ b/lib/libc/sys/kldsym.2 @@ -1,6 +1,6 @@ .\" Copyright (c) 2001 Chris Costello <chris@FreeBSD.org> .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -9,7 +9,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE @@ -21,20 +21,20 @@ .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. -.\" -.\" $FreeBSD$ -.\" +.\" +.\" $FreeBSD$ +.\" .Dd July 26, 2001 .Dt KLDSYM 2 -.Os FreeBSD +.Os .Sh NAME .Nm kldsym .Nd look up address by symbol name in a KLD .Sh LIBRARY .Lb libc .Sh SYNOPSIS -.Fd #include <sys/param.h> -.Fd #include <sys/linker.h> +.In sys/param.h +.In sys/linker.h .Ft int .Fn kldsym "int fileid" "int command" "void *data" .Sh DESCRIPTION @@ -68,7 +68,7 @@ member is to be set by the code calling .Fn kldsym to -.Li sizeof(struct kld_sym_lookup) . +.Fn sizeof "struct kld_sym_lookup" . The next two members, .Va version and @@ -84,12 +84,7 @@ and contain the address associated with .Va symname and the size of the data it points to, respectively. .Sh RETURN VALUES -The -.Fn kldsym -function returns 0 on success -and -1 on failure, and sets -.Va errno -to indicate the error. +.Rv -std kldsym .Sh ERRORS The .Fn kldsym @@ -101,7 +96,7 @@ Invalid value in or .Fa command . .It Bq Er ENOENT -.Fa Fileid +.Fa fileid is invalid, or the specified symbol could not be found. .El diff --git a/lib/libc/sys/kldunload.2 b/lib/libc/sys/kldunload.2 index 6ef3d3a94f39..c2fbf4b7c6e7 100644 --- a/lib/libc/sys/kldunload.2 +++ b/lib/libc/sys/kldunload.2 @@ -27,7 +27,7 @@ .\" .Dd March 3, 1999 .Dt KLDUNLOAD 2 -.Os FreeBSD +.Os .Sh NAME .Nm kldunload .Nd unload kld files @@ -71,7 +71,9 @@ You attempted to unload a file linked by the kernel. .Xr kldload 2 , .Xr kldnext 2 , .Xr kldstat 2 , +.Xr kldsym 2 , .Xr modfind 2 , +.Xr modfnext 2 , .Xr modnext 2 , .Xr modstat 2 , .Xr kld 4 , diff --git a/lib/libc/sys/ktrace.2 b/lib/libc/sys/ktrace.2 index 992319c85814..e903ff273b19 100644 --- a/lib/libc/sys/ktrace.2 +++ b/lib/libc/sys/ktrace.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt KTRACE 2 -.Os BSD 4 +.Os .Sh NAME .Nm ktrace .Nd process tracing @@ -135,10 +135,7 @@ The type specific records are defined in the .Aq Pa sys/ktrace.h include file. .Sh RETURN VALUES -On successful completion a value of 0 is returned. -Otherwise, a value of -1 is returned and -.Va errno -is set to show the error. +.Rv -std ktrace .Sh ERRORS .Fn Ktrace will fail if: diff --git a/lib/libc/sys/link.2 b/lib/libc/sys/link.2 index 21108fe7af40..9c126c94bb06 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -34,7 +34,7 @@ .\" .Dd March 5, 1999 .Dt LINK 2 -.Os BSD 4 +.Os .Sh NAME .Nm link .Nd make a hard file link @@ -80,10 +80,7 @@ must be in the same file system. .Fa name1 may not be a directory. .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. Otherwise, -a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std link .Sh ERRORS .Fn Link will fail and no link will be created if: diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2 index 3dfe864a84d4..a9ab96bc6976 100644 --- a/lib/libc/sys/listen.2 +++ b/lib/libc/sys/listen.2 @@ -34,7 +34,7 @@ .\" .Dd November 3, 1995 .Dt LISTEN 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm listen .Nd listen for connections on a socket @@ -107,7 +107,7 @@ Before returning, unlocks .Fa s . .Sh RETURN VALUES -A 0 return value indicates success; -1 indicates an error. +.Rv -std listen .Sh ERRORS .Fn Listen will fail if: diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2 index f236c9206fed..362485bebc1d 100644 --- a/lib/libc/sys/lseek.2 +++ b/lib/libc/sys/lseek.2 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt LSEEK 2 -.Os BSD 4 +.Os .Sh NAME .Nm lseek .Nd reposition read/write file offset diff --git a/lib/libc/sys/madvise.2 b/lib/libc/sys/madvise.2 index e5d6a06b03f0..5ddfa96fad78 100644 --- a/lib/libc/sys/madvise.2 +++ b/lib/libc/sys/madvise.2 @@ -133,11 +133,7 @@ Region is not included in a core file. Include region in a core file. .El .Sh RETURN VALUES -Upon successful completion, -.Fn madvise -returns 0. Otherwise a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std madvise .Sh ERRORS The .Fn madvise diff --git a/lib/libc/sys/mincore.2 b/lib/libc/sys/mincore.2 index cd34c5aed063..1bc309f1af9b 100644 --- a/lib/libc/sys/mincore.2 +++ b/lib/libc/sys/mincore.2 @@ -57,14 +57,7 @@ in the character array with a value of 1 meaning that the page is in-core. .Sh RETURN VALUES -Upon successful completion, -.Fn mincore -returns 0 and -.Fa vec -is updated to reflect the page status. Otherwise a value of -1 -is returned and -.Va errno -is set to indicate the error. +.Rv -std mincore .Sh ERRORS .Bl -tag -width Er .It Bq Er EINVAL diff --git a/lib/libc/sys/minherit.2 b/lib/libc/sys/minherit.2 index 265d6d27fb5e..037723019031 100644 --- a/lib/libc/sys/minherit.2 +++ b/lib/libc/sys/minherit.2 @@ -56,11 +56,7 @@ Not all implementations will guarantee that the inheritance characteristic can be set on a page basis; the granularity of changes may be as large as an entire region. .Sh RETURN VALUES -Upon successful completion, -.Fn minherit -returns 0. Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std minherit .Sh ERRORS The .Fn minherit @@ -93,4 +89,5 @@ arguments. .Sh HISTORY The .Fn minherit -function first appeared in OpenBSD. +function first appeared in +.Ox . diff --git a/lib/libc/sys/mkdir.2 b/lib/libc/sys/mkdir.2 index 964d3c3755c6..25fad1ebef34 100644 --- a/lib/libc/sys/mkdir.2 +++ b/lib/libc/sys/mkdir.2 @@ -34,7 +34,7 @@ .\" .Dd December 11, 1993 .Dt MKDIR 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm mkdir .Nd make a directory file @@ -58,9 +58,7 @@ The directory's owner ID is set to the process's effective user ID. The directory's group ID is set to that of the parent directory in which it is created. .Sh RETURN VALUES -A 0 return value indicates success. A -1 return value -indicates an error, and an error code is stored in -.Va errno . +.Rv -std mkdir .Sh ERRORS .Fn Mkdir will fail and no directory will be created if: diff --git a/lib/libc/sys/mkfifo.2 b/lib/libc/sys/mkfifo.2 index 2a606cbb68dd..c711690083a6 100644 --- a/lib/libc/sys/mkfifo.2 +++ b/lib/libc/sys/mkfifo.2 @@ -60,9 +60,7 @@ The fifo's owner ID is set to the process's effective user ID. The fifo's group ID is set to that of the parent directory in which it is created. .Sh RETURN VALUES -A 0 return value indicates success. A -1 return value -indicates an error, and an error code is stored in -.Va errno . +.Rv -std mkfifo .Sh ERRORS .Fn Mkfifo will fail and no fifo will be created if: diff --git a/lib/libc/sys/mknod.2 b/lib/libc/sys/mknod.2 index 0910beed21ed..a81c1aaad9e5 100644 --- a/lib/libc/sys/mknod.2 +++ b/lib/libc/sys/mknod.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt MKNOD 2 -.Os BSD 4 +.Os .Sh NAME .Nm mknod .Nd make a special file node @@ -64,10 +64,7 @@ is ignored. .Fn Mknod requires super-user privileges. .Sh RETURN VALUES -Upon successful completion a value of 0 is returned. -Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std mknod .Sh ERRORS .Fn Mknod will fail and the file will be not created if: diff --git a/lib/libc/sys/mlock.2 b/lib/libc/sys/mlock.2 index 4f141e3b3c90..ba2bbb1976d5 100644 --- a/lib/libc/sys/mlock.2 +++ b/lib/libc/sys/mlock.2 @@ -152,7 +152,7 @@ Unlike The Sun implementation, multiple .Fn mlock calls on the same address range require the corresponding number of .Fn munlock -calls to actually unlock the pages, i.e. +calls to actually unlock the pages, i.e.\& .Fn mlock nests. This should be considered a consequence of the implementation diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index faefd3252b3b..f4cb27e81198 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -34,7 +34,7 @@ .\" .Dd May 11, 1995 .Dt MMAP 2 -.Os BSD 4 +.Os .Sh NAME .Nm mmap .Nd allocate memory, or map files or devices into memory diff --git a/lib/libc/sys/modfind.2 b/lib/libc/sys/modfind.2 index 6ab9f681f275..401eb601f81e 100644 --- a/lib/libc/sys/modfind.2 +++ b/lib/libc/sys/modfind.2 @@ -27,7 +27,7 @@ .\" .Dd September 28, 2000 .Dt MODFIND 2 -.Os FreeBSD +.Os .Sh NAME .Nm modfind .Nd returns the modid of a kernel module @@ -64,15 +64,18 @@ The data required for this operation could not be read from the kernel space. The file specified is not loaded in the kernel. .El .Sh SEE ALSO +.Xr kldfind 2 , .Xr kldfirstmod 2 , .Xr kldload 2 , .Xr kldnext 2 , .Xr kldstat 2 , +.Xr kldsym 2 , .Xr kldunload 2 , -.Xr modnext 2 , .Xr modfnext 2 , +.Xr modnext 2 , .Xr modstat 2 , -.Xr kld 4 +.Xr kld 4 , +.Xr kldstat 8 .Sh HISTORY The .Nm kld diff --git a/lib/libc/sys/modnext.2 b/lib/libc/sys/modnext.2 index 399836a6eb21..ed6398e27fcc 100644 --- a/lib/libc/sys/modnext.2 +++ b/lib/libc/sys/modnext.2 @@ -27,7 +27,7 @@ .\" .Dd September 28, 2000 .Dt MODNEXT 2 -.Os FreeBSD +.Os .Sh NAME .Nm modnext .Nd return the modid of the next kernel module @@ -74,11 +74,14 @@ refers to a kernel module that does not exist (isn't loaded). .Xr kldfind 2 , .Xr kldfirstmod 2 , .Xr kldload 2 , +.Xr kldnext 2 , .Xr kldstat 2 , +.Xr kldsym 2 , .Xr kldunload 2 , .Xr modfind 2 , .Xr modstat 2 , -.Xr kld 4 +.Xr kld 4 , +.Xr kldstat 8 .Sh HISTORY The .Nm kld diff --git a/lib/libc/sys/modstat.2 b/lib/libc/sys/modstat.2 index 1b2d9ca99163..9cadabd676f3 100644 --- a/lib/libc/sys/modstat.2 +++ b/lib/libc/sys/modstat.2 @@ -27,7 +27,7 @@ .\" .Dd September 28, 2000 .Dt MODSTAT 2 -.Os FreeBSD +.Os .Sh NAME .Nm modstat .Nd get status of kernel module @@ -112,10 +112,12 @@ function. .Xr kldfirstmod 2 , .Xr kldload 2 , .Xr kldnext 2 , +.Xr kldstat 2 , +.Xr kldsym 2 , .Xr kldunload 2 , -.Xr modnext 2 , .Xr modfind 2 , .Xr modfnext 2 , +.Xr modnext 2 , .Xr kld 4 , .Xr kldstat 8 .Sh HISTORY diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index a0c2b1afdafa..a59f3dbb0b02 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -34,7 +34,7 @@ .\" .Dd May 24, 1995 .Dt MOUNT 2 -.Os BSD 4 +.Os .Sh NAME .Nm mount , .Nm unmount diff --git a/lib/libc/sys/mprotect.2 b/lib/libc/sys/mprotect.2 index 7f46d241c839..fe8df3039d49 100644 --- a/lib/libc/sys/mprotect.2 +++ b/lib/libc/sys/mprotect.2 @@ -54,12 +54,7 @@ changes the specified pages to have protection Not all implementations will guarantee protection on a page basis; the granularity of protection changes may be as large as an entire region. .Sh RETURN VALUES -Upon successful completion, -.Fn mprotect -returns 0. Otherwise a value of -1 is returned -and -.Va errno -is set to indicate the error. +.Rv -std mprotect .Sh ERRORS The .Fn mprotect diff --git a/lib/libc/sys/msync.2 b/lib/libc/sys/msync.2 index 38fda84c9b5c..9adc3acd919a 100644 --- a/lib/libc/sys/msync.2 +++ b/lib/libc/sys/msync.2 @@ -72,9 +72,7 @@ MS_SYNC Perform synchronous writes MS_INVALIDATE Invalidate all cached data .Ed .Sh RETURN VALUES -If any errors occur, -1 is returned and errno is set to indicate the -error. -Otherwise, a 0 value is returned. +.Rv -std msync .Sh ERRORS .Fn msync will fail if: diff --git a/lib/libc/sys/munmap.2 b/lib/libc/sys/munmap.2 index 230ec4bdccf8..164473002934 100644 --- a/lib/libc/sys/munmap.2 +++ b/lib/libc/sys/munmap.2 @@ -53,12 +53,7 @@ deletes the mappings for the specified address range, and causes further references to addresses within the range to generate invalid memory references. .Sh RETURN VALUES -Upon successful completion, -.Fn munmap -returns zero. -Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std munmap .Sh ERRORS .Fn Munmap will fail if: diff --git a/lib/libc/sys/nanosleep.2 b/lib/libc/sys/nanosleep.2 index 382672e5317b..b69ef331503c 100644 --- a/lib/libc/sys/nanosleep.2 +++ b/lib/libc/sys/nanosleep.2 @@ -37,7 +37,7 @@ .\" .Dd April 17, 1997 .Dt NANOSLEEP 2 -.Os +.Os .Sh NAME .Nm nanosleep .Nd suspend process execution for an interval measured in nanoseconds @@ -71,12 +71,10 @@ is .Pf non- Dv NULL , the timespec structure it references is updated to contain the unslept amount (the request time minus the time actually slept). -.Pp -If any of the following conditions occur, the +.Sh ERRORS +The .Fn nanosleep -function shall return -1 and set -.Va errno -to the corresponding value: +call fails if: .Bl -tag -width Er .It Bq Er EFAULT Either diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index 04d39a3b0775..5e4aeeba4ccb 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -34,7 +34,7 @@ .\" .Dd November 16, 1993 .Dt OPEN 2 -.Os BSD 4 +.Os .Sh NAME .Nm open .Nd open or create a file for reading or writing diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2 index a8797e64d5d9..90318c02b595 100644 --- a/lib/libc/sys/pathconf.2 +++ b/lib/libc/sys/pathconf.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt PATHCONF 2 -.Os BSD 4 +.Os .Sh NAME .Nm pathconf , .Nm fpathconf diff --git a/lib/libc/sys/pipe.2 b/lib/libc/sys/pipe.2 index d8c5cc521efc..52f0f98bece8 100644 --- a/lib/libc/sys/pipe.2 +++ b/lib/libc/sys/pipe.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt PIPE 2 -.Os BSD 4 +.Os .Sh NAME .Nm pipe .Nd create descriptor pair for interprocess communication @@ -88,12 +88,7 @@ portable to older systems, so it is recommended to use the convention for using the endpoints in the traditional manner when using a pipe in one direction. .Sh RETURN VALUES -On successful creation of the pipe, zero is returned. -Otherwise, -a value of -1 is returned and the variable -.Va errno -set to indicate the -error. +.Rv -std pipe .Sh ERRORS The .Fn pipe diff --git a/lib/libc/sys/profil.2 b/lib/libc/sys/profil.2 index 568d25731425..14b2bd52edd7 100644 --- a/lib/libc/sys/profil.2 +++ b/lib/libc/sys/profil.2 @@ -91,19 +91,7 @@ A .Fa scale value of 0 disables profiling. .Sh RETURN VALUES -If the -.Fa scale -value is nonzero and the buffer -.Fa samples -contains an illegal address, -.Fn profil -returns \-1, -profiling is terminated and -.Va errno -is set appropriately. -Otherwise -.Fn profil -returns 0. +.Rv -std profil .Sh FILES .Bl -tag -width /usr/lib/gcrt0.o -compact .It Pa /usr/lib/gcrt0.o diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2 index 275bdc63be3f..177d88b884d1 100644 --- a/lib/libc/sys/ptrace.2 +++ b/lib/libc/sys/ptrace.2 @@ -4,7 +4,7 @@ .\" This file is in the public domain. .Dd January 20, 1996 .Dt PTRACE 2 -.Os FreeBSD +.Os .Sh NAME .Nm ptrace .Nd process tracing and debugging @@ -23,10 +23,8 @@ process) to control another (the .Em traced process). Most of the time, the traced process runs normally, but when it receives a signal -.Po -see -.Xr sigaction 2 -.Pc , +(see +.Xr sigaction 2 ) , it stops. The tracing process is expected to notice this via .Xr wait 2 or the delivery of a @@ -58,10 +56,8 @@ traced process stops, it cannot be made to continue except via When a process has used this request and calls .Xr execve 2 or any of the routines built on it -.Po -such as -.Xr execv 3 -.Pc , +(such as +.Xr execv 3 ) , it will stop before executing the first instruction of the new image. Also, any setuid or setgid bits on the executable being executed will be ignored. @@ -136,9 +132,7 @@ The traced process continues execution. .Fa addr is an address specifying the place where execution is to be resumed (a new value for the program counter), or -.Po -.Vt caddr_t -.Pc Ns 1 +.Po Vt caddr_t Pc Ns 1 to indicate that execution is to pick up where it left off. .Fa data provides a signal number to be delivered to the traced process as it diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index 6fe4a094decc..9aa5a481efe6 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -151,10 +151,7 @@ and parameters are ignored. .El .Sh RETURN VALUES -A successful call returns 0, -otherwise the value -1 is returned and the global variable -.Va errno -indicates the reason for the failure. +.Rv -std quotactl .Sh ERRORS A .Fn quotactl diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2 index aa558f35e936..9c38809d21a9 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -34,7 +34,7 @@ .\" .Dd February 26, 1994 .Dt READ 2 -.Os BSD 4 +.Os .Sh NAME .Nm read , .Nm readv , diff --git a/lib/libc/sys/readlink.2 b/lib/libc/sys/readlink.2 index 160686d4941b..4708594b4289 100644 --- a/lib/libc/sys/readlink.2 +++ b/lib/libc/sys/readlink.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt READLINK 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm readlink .Nd read value of a symbolic link diff --git a/lib/libc/sys/reboot.2 b/lib/libc/sys/reboot.2 index 411e689e1217..cf347452f910 100644 --- a/lib/libc/sys/reboot.2 +++ b/lib/libc/sys/reboot.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt REBOOT 2 -.Os BSD 4 +.Os .Sh NAME .Nm reboot .Nd reboot system or halt processor diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index 4e702c093416..7a49e41d438d 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -34,7 +34,7 @@ .\" .Dd February 21, 1994 .Dt RECV 2 -.Os BSD 4.3r +.Os .Sh NAME .Nm recv , .Nm recvfrom , diff --git a/lib/libc/sys/rename.2 b/lib/libc/sys/rename.2 index f69ea1457f78..8d5523a1c00a 100644 --- a/lib/libc/sys/rename.2 +++ b/lib/libc/sys/rename.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt RENAME 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm rename .Nd change the name of a file @@ -98,11 +98,7 @@ not the file or directory to which it points. .\"Hard links to directories should be .\"replaced by symbolic links by the system administrator. .Sh RETURN VALUES -A 0 value is returned if the operation succeeds, otherwise -.Fn rename -returns -1 and the global variable -.Va errno -indicates the reason for the failure. +.Rv -std rename .Sh ERRORS .Fn Rename will fail and neither of the argument files will be diff --git a/lib/libc/sys/revoke.2 b/lib/libc/sys/revoke.2 index d89d50c8e164..8b6b01d58489 100644 --- a/lib/libc/sys/revoke.2 +++ b/lib/libc/sys/revoke.2 @@ -73,10 +73,7 @@ device files. It is normally used to prepare a terminal device for a new login session, preventing any access by a previous user of the terminal. .Sh RETURN VALUES -A 0 value indicated that the call succeeded. A \-1 return value -indicates an error occurred and -.Va errno -is set to indicated the reason. +.Rv -std revoke .Sh ERRORS Access to the named file is revoked unless one of the following: .Bl -tag -width Er diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2 index 1f9644793c25..80d7f76d3da7 100644 --- a/lib/libc/sys/rfork.2 +++ b/lib/libc/sys/rfork.2 @@ -46,8 +46,8 @@ See .Xr wait 2 . .It RFFDG If set, the invoker's file descriptor table (see -.Xr intro 2 -) is copied; otherwise the two processes share a +.Xr intro 2 ) +is copied; otherwise the two processes share a single table. .It RFCFDG If set, the new process starts with a clean file descriptor table. diff --git a/lib/libc/sys/rmdir.2 b/lib/libc/sys/rmdir.2 index 523bc21e1b1a..373b185800c9 100644 --- a/lib/libc/sys/rmdir.2 +++ b/lib/libc/sys/rmdir.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt RMDIR 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm rmdir .Nd remove a directory file @@ -55,9 +55,7 @@ than and .Ql \&.. . .Sh RETURN VALUES -A 0 is returned if the remove succeeds; otherwise a -1 is -returned and an error code is stored in the global location -.Va errno . +.Rv -std rmdir .Sh ERRORS The named file is removed unless: .Bl -tag -width Er diff --git a/lib/libc/sys/rtprio.2 b/lib/libc/sys/rtprio.2 index 9f8915d0ca67..bfd72c446e23 100644 --- a/lib/libc/sys/rtprio.2 +++ b/lib/libc/sys/rtprio.2 @@ -31,7 +31,7 @@ .\" .Dd July 23, 1994 .Dt RTPRIO 2 -.Os FreeBSD +.Os .Sh NAME .Nm rtprio .Nd examine or modify a process realtime or idle priority diff --git a/lib/libc/sys/sched_get_priority_max.2 b/lib/libc/sys/sched_get_priority_max.2 index 103b913d3976..54095d0e78b7 100644 --- a/lib/libc/sys/sched_get_priority_max.2 +++ b/lib/libc/sys/sched_get_priority_max.2 @@ -25,12 +25,12 @@ .\" .Dd March 12, 1998 .Dt SCHED_GET_PRIORITY_MAX 2 -.Os BSD 4 +.Os .Sh NAME .Nm sched_get_priority_max , .Nm sched_get_priority_min , .Nm sched_rr_get_interval -.Nd Get scheduling parameter limits +.Nd get scheduling parameter limits .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -112,10 +112,10 @@ No process can be found corresponding to that specified by .Fa pid . .El .Sh SEE ALSO -.Xr sched_get_scheduler 2 , .Xr sched_getparam 2 , -.Xr sched_set_scheduler 2 , -.Xr sched_setparam 2 +.Xr sched_getscheduler 2 , +.Xr sched_setparam 2 , +.Xr sched_setscheduler 2 .Sh STANDARDS The .Fn sched_setscheduler diff --git a/lib/libc/sys/sched_setparam.2 b/lib/libc/sys/sched_setparam.2 index ee25174b27c3..57b077f5ec19 100644 --- a/lib/libc/sys/sched_setparam.2 +++ b/lib/libc/sys/sched_setparam.2 @@ -25,7 +25,7 @@ .\" .Dd March 12, 1998 .Dt SCHED_SETPARAM 2 -.Os BSD 4 +.Os .Sh NAME .Nm sched_setparam , .Nm sched_getparam @@ -159,9 +159,9 @@ is outside the range defined for the scheduling policy of the specified .Fa pid . .El .Sh SEE ALSO +.Xr sched_getscheduler 2 , .Xr sched_get_priority_max 2 , .Xr sched_get_priority_min 2 , -.Xr sched_getscheduler 2 , .Xr sched_rr_get_interval 2 , .Xr sched_setscheduler 2 , .Xr sched_yield 2 diff --git a/lib/libc/sys/sched_setscheduler.2 b/lib/libc/sys/sched_setscheduler.2 index a5b0b1d437d1..b616e6dede16 100644 --- a/lib/libc/sys/sched_setscheduler.2 +++ b/lib/libc/sys/sched_setscheduler.2 @@ -25,7 +25,7 @@ .\" .Dd March 12, 1998 .Dt SCHED_SETSCHEDULER 2 -.Os BSD 4 +.Os .Sh NAME .Nm sched_setscheduler , .Nm sched_getscheduler @@ -154,9 +154,9 @@ parameter is invalid, or one or more of the parameters contained in is outside the valid range for the specified scheduling policy. .El .Sh SEE ALSO +.Xr sched_getparam 2 , .Xr sched_get_priority_max 2 , .Xr sched_get_priority_min 2 , -.Xr sched_getparam 2 , .Xr sched_rr_get_interval 2 , .Xr sched_setparam 2 , .Xr sched_yield 2 diff --git a/lib/libc/sys/sched_yield.2 b/lib/libc/sys/sched_yield.2 index f962c623ef41..2d8240cd8f53 100644 --- a/lib/libc/sys/sched_yield.2 +++ b/lib/libc/sys/sched_yield.2 @@ -25,7 +25,7 @@ .\" .Dd March 12, 1998 .Dt SCHED_YIELD 2 -.Os BSD 4 +.Os .Sh NAME .Nm sched_yield .Nd yield processor @@ -41,12 +41,7 @@ The function forces the running process to relinquish the processor until it again becomes the head of its process list. It takes no arguments. .Sh RETURN VALUES -The -.Fn sched_yield -function will return zero if it completes successfully, or it -will return a value of -1 and set -.Va errno -to indicate the error. +.Rv -std sched_yield .Sh ERRORS On failure .Va errno diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2 index 5bc9ac94d571..d888bfb91bf3 100644 --- a/lib/libc/sys/select.2 +++ b/lib/libc/sys/select.2 @@ -34,7 +34,7 @@ .\" .Dd March 25, 1994 .Dt SELECT 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm select .Nd synchronous I/O multiplexing @@ -170,8 +170,8 @@ The default size of is currently 1024. In order to accommodate programs which might potentially use a larger number of open files with -.Fn select -, it is possible +.Fn select , +it is possible to increase this size by having the program define .Dv FD_SETSIZE before the inclusion of any header which includes diff --git a/lib/libc/sys/semctl.2 b/lib/libc/sys/semctl.2 index 1892237ba027..2b3df6888dc4 100644 --- a/lib/libc/sys/semctl.2 +++ b/lib/libc/sys/semctl.2 @@ -27,7 +27,7 @@ .\" .Dd September 12, 1995 .Dt SEMCTL 2 -.Os FreeBSD +.Os .Sh NAME .Nm semctl .Nd control operations on a semaphore set diff --git a/lib/libc/sys/semget.2 b/lib/libc/sys/semget.2 index dc22c0ac272f..b35db9f2b158 100644 --- a/lib/libc/sys/semget.2 +++ b/lib/libc/sys/semget.2 @@ -27,7 +27,7 @@ .\" .Dd September 12, 1995 .Dt SEMGET 2 -.Os FreeBSD +.Os .Sh NAME .Nm semget .Nd obtain a semaphore id diff --git a/lib/libc/sys/semop.2 b/lib/libc/sys/semop.2 index 87f3ae2df94e..7f18510d89c6 100644 --- a/lib/libc/sys/semop.2 +++ b/lib/libc/sys/semop.2 @@ -27,7 +27,7 @@ .\" .Dd September 22, 1995 .Dt SEMOP 2 -.Os FreeBSD +.Os .Sh NAME .Nm semop .Nd atomic array of operations on a semaphore set @@ -163,11 +163,7 @@ for each semaphore is added to the semaphore's value. This can be used to insure that a resource is released if a process terminates unexpectedly. .Sh RETURN VALUES -On success, -.Fn semop -returns 0; otherwise, -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std semop .Sh ERRORS .Fn Semop will fail if: diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2 index 533854de8b2e..8ec9476ee32d 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -34,7 +34,7 @@ .\" .Dd February 15, 1995 .Dt SEND 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm send , .Nm sendto , @@ -108,7 +108,7 @@ The flag .Dv MSG_OOB is used to send .Dq out-of-band -data on sockets that support this notion (e.g. +data on sockets that support this notion (e.g.\& .Dv SOCK_STREAM ) ; the underlying protocol must also support .Dq out-of-band @@ -186,7 +186,8 @@ doesn't necessarily block until the data has been transferred, it is possible to transfer an open file descriptor across an .Dv AF_UNIX domain socket -.Pq see Xr recv 2 , +(see +.Xr recv 2 ) , then .Fn close it before it has actually been sent, the result being that the receiver diff --git a/lib/libc/sys/sendfile.2 b/lib/libc/sys/sendfile.2 index e9d17b862dc2..24296c2d041d 100644 --- a/lib/libc/sys/sendfile.2 +++ b/lib/libc/sys/sendfile.2 @@ -132,11 +132,7 @@ unlocks and .Fa s . .Sh RETURN VALUES -Upon successful completion, -.Fn sendfile -returns 0. Otherwise a -1 is returned and the global variable -.Va errno -is set to indicate the error. +.Rv -std sendfile .Sh ERRORS .Bl -tag -width Er .It Bq Er EBADF diff --git a/lib/libc/sys/setgroups.2 b/lib/libc/sys/setgroups.2 index 25af1f4dabb6..3ba324dd3cf0 100644 --- a/lib/libc/sys/setgroups.2 +++ b/lib/libc/sys/setgroups.2 @@ -34,7 +34,7 @@ .\" .Dd April 16, 1994 .Dt SETGROUPS 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm setgroups .Nd set group access list @@ -60,9 +60,7 @@ as defined in .Pp Only the super-user may set new groups. .Sh RETURN VALUES -A 0 value is returned on success, -1 on error, with -an error code stored in -.Va errno . +.Rv -std setgroups .Sh ERRORS The .Fn setgroups diff --git a/lib/libc/sys/setpgid.2 b/lib/libc/sys/setpgid.2 index a6585a179c73..d9178b597b84 100644 --- a/lib/libc/sys/setpgid.2 +++ b/lib/libc/sys/setpgid.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SETPGID 2 -.Os BSD 4 +.Os .Sh NAME .Nm setpgid , .Nm setpgrp diff --git a/lib/libc/sys/setregid.2 b/lib/libc/sys/setregid.2 index 9fcb1d1a2336..2dc211216616 100644 --- a/lib/libc/sys/setregid.2 +++ b/lib/libc/sys/setregid.2 @@ -34,7 +34,7 @@ .\" .Dd April 16, 1994 .Dt SETREGID 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm setregid .Nd set real and effective group ID @@ -71,10 +71,7 @@ the standard .Fn setgid function is preferred. .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. Otherwise, -a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std setregid .Sh ERRORS .Bl -tag -width Er .It Bq Er EPERM diff --git a/lib/libc/sys/setresuid.2 b/lib/libc/sys/setresuid.2 index 2d25986041fa..a3db8944929a 100644 --- a/lib/libc/sys/setresuid.2 +++ b/lib/libc/sys/setresuid.2 @@ -74,7 +74,7 @@ nor the current saved ID. .Xr setgid 2 , .Xr setregid 2 , .Xr setreuid 2 , -.Xr setuid 2 , +.Xr setuid 2 .Sh STANDARDS These system calls are not available on many platforms. They exist in diff --git a/lib/libc/sys/setreuid.2 b/lib/libc/sys/setreuid.2 index a421e4af6a12..76d5dd893372 100644 --- a/lib/libc/sys/setreuid.2 +++ b/lib/libc/sys/setreuid.2 @@ -32,9 +32,9 @@ .\" @(#)setreuid.2 8.2 (Berkeley) 4/16/94 .\" $FreeBSD$ .\" -.Dd April 16, 1994 +.Dd February 8, 2001 .Dt SETREUID 2 -.Os BSD 4 +.Os .Sh NAME .Nm setreuid .Nd set real and effective user ID's diff --git a/lib/libc/sys/setuid.2 b/lib/libc/sys/setuid.2 index c62d26af2a3c..4ef4d35eee7d 100644 --- a/lib/libc/sys/setuid.2 +++ b/lib/libc/sys/setuid.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SETUID 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm setuid , .Nm seteuid , diff --git a/lib/libc/sys/shmat.2 b/lib/libc/sys/shmat.2 index 53d5e079e32c..6f7dc13eba75 100644 --- a/lib/libc/sys/shmat.2 +++ b/lib/libc/sys/shmat.2 @@ -27,7 +27,7 @@ .\" .Dd August 2, 1995 .Dt SHMAT 2 -.Os FreeBSD +.Os .Sh NAME .Nm shmat , .Nm shmdt diff --git a/lib/libc/sys/shmctl.2 b/lib/libc/sys/shmctl.2 index 9b5e8763808c..e3ab92cf296d 100644 --- a/lib/libc/sys/shmctl.2 +++ b/lib/libc/sys/shmctl.2 @@ -27,7 +27,7 @@ .\" .Dd July 17, 1995 .Dt SHMCTL 2 -.Os FreeBSD +.Os .Sh NAME .Nm shmctl .Nd shared memory control @@ -109,11 +109,7 @@ struct shmid_ds { }; .Ed .Sh RETURN VALUES -Upon successful completion, -.Fn shmctl -returns 0. Otherwise, it returns -1 and -.Va errno -is set to indicate the error. +.Rv -std shmctl .Sh ERRORS .Fn Shmctl will fail if: diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2 index cddfefe9c792..b176c536b132 100644 --- a/lib/libc/sys/shmget.2 +++ b/lib/libc/sys/shmget.2 @@ -27,7 +27,7 @@ .\" .Dd July 3, 1995 .Dt SHMGET 2 -.Os FreeBSD +.Os .Sh NAME .Nm shmget .Nd obtain a shared memory identifier diff --git a/lib/libc/sys/shutdown.2 b/lib/libc/sys/shutdown.2 index 59e4d340a826..5cef2e53042d 100644 --- a/lib/libc/sys/shutdown.2 +++ b/lib/libc/sys/shutdown.2 @@ -65,7 +65,7 @@ further sends will be disallowed. further sends and receives will be disallowed. .El .Sh RETURN VALUES -.Rv -std shutdown . +.Rv -std shutdown .Sh ERRORS The .Fn shutdown diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index 443aec50501c..43bd088f2056 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -211,9 +211,10 @@ If this bit is set, the handler is reset back to .Dv SIG_DFL at the moment the signal is delivered. .It Dv SA_SIGINFO -If this bit is set, the handler function is assumed to be pointed to -by the sa_sigaction member of struct sigaction and should match the -prototype shown above or as below in +If this bit is set, the handler function is assumed to be pointed to by the +.Dv sa_sigaction +member of struct sigaction and should match the prototype shown above or as +below in .Sx EXAMPLES . This bit should not be set when assigning .Dv SIG_DFL @@ -424,10 +425,7 @@ All functions not in the above lists are considered to be unsafe with respect to signals. That is to say, the behaviour of such functions when called from a signal handler is undefined. .Sh RETURN VALUES -A 0 value indicated that the call succeeded. A \-1 return value -indicates an error occurred and -.Va errno -is set to indicated the reason. +.Rv -std sigaction .Sh EXAMPLES There are three possible prototypes the handler may match: .Bl -tag -offset indent -width short @@ -451,7 +449,9 @@ member of Note that you should not assign SIG_DFL or SIG_IGN this way. .Pp If the SA_SIGINFO flag is not set, the handler function should match -either the ANSI C or traditional BSD prototype and be pointed to by +either the ANSI C or traditional +.Bx +prototype and be pointed to by the .Dv sa_handler member of @@ -465,9 +465,13 @@ The member declaration in .Fx include files is that of ANSI C (as required by POSIX), -so a function pointer of a BSD-style function needs to be casted to +so a function pointer of a +.Bx Ns -style +function needs to be casted to compile without warning. -The traditional BSD style is not portable and since its capabilities +The traditional +.Bx +style is not portable and since its capabilities are a full subset of a SA_SIGINFO handler, its use is deprecated. .Pp @@ -479,7 +483,9 @@ values from <signal.h>. .Pp The .Fa code -argument of the BSD-style handler and the +argument of the +.Bx Ns -style +handler and the .Dv si_code member of the .Dv info @@ -493,7 +499,9 @@ values for SIGFPE. .Pp The .Fa scp -argument to a BSD-style handler points to an instance of struct +argument to a +.Bx Ns -style +handler points to an instance of struct sigcontext. .Pp The @@ -546,7 +554,7 @@ as are the signals, and .Dv SIGINFO . Those signals are available on most -.Tn BSD Ns \-derived +.Bx Ns \-derived systems. The .Dv SA_NODEFER diff --git a/lib/libc/sys/sigaltstack.2 b/lib/libc/sys/sigaltstack.2 index aeb3cf9f0fa3..e39b8930636b 100644 --- a/lib/libc/sys/sigaltstack.2 +++ b/lib/libc/sys/sigaltstack.2 @@ -34,7 +34,7 @@ .\" .Dd May 1, 1995 .Dt SIGALTSTACK 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm sigaltstack .Nd set and/or get signal stack context @@ -133,10 +133,7 @@ are not ``grown'' automatically as is done for the normal stack. If the stack overflows and this space is not protected unpredictable results may occur. .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std sigaltstack .Sh ERRORS .Fn Sigaltstack will fail and the signal stack context will remain unchanged diff --git a/lib/libc/sys/sigpending.2 b/lib/libc/sys/sigpending.2 index 361a91898199..8ab927bb2dc1 100644 --- a/lib/libc/sys/sigpending.2 +++ b/lib/libc/sys/sigpending.2 @@ -57,10 +57,7 @@ Signals may be pending because they are currently masked, or transiently before delivery (although the latter case is not normally detectable). .Sh RETURN VALUES -A 0 value indicated that the call succeeded. A \-1 return value -indicates an error occurred and -.Va errno -is set to indicated the reason. +.Rv -std sigpending .Sh ERRORS .Fn sigpending will fail if: diff --git a/lib/libc/sys/sigprocmask.2 b/lib/libc/sys/sigprocmask.2 index ff60beb2291d..a7bf788883a0 100644 --- a/lib/libc/sys/sigprocmask.2 +++ b/lib/libc/sys/sigprocmask.2 @@ -96,10 +96,7 @@ or .Dv SIGSTOP to be blocked. .Sh RETURN VALUES -A 0 value indicated that the call succeeded. A -1 return value -indicates an error occurred and -.Va errno -is set to indicated the reason. +.Rv -std sigprocmask .Sh ERRORS The .Fn sigprocmask diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2 index e67c48e24c31..cc7ca47fc62f 100644 --- a/lib/libc/sys/sigreturn.2 +++ b/lib/libc/sys/sigreturn.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SIGRETURN 2 -.Os BSD 4.3 +.Os .Sh NAME .Nm sigreturn .Nd return from signal @@ -85,7 +85,7 @@ This system call is used by the trampoline code and when returning from a signal to the previously executing program. .Sh NOTES This system call is not available in 4.2 -.Tn BSD +.Bx hence it should not be used if backward compatibility is needed. .Sh RETURN VALUES If successful, the system call does not return. diff --git a/lib/libc/sys/sigstack.2 b/lib/libc/sys/sigstack.2 index 317fee656eb1..9f1dfa95b677 100644 --- a/lib/libc/sys/sigstack.2 +++ b/lib/libc/sys/sigstack.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SIGSTACK 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm sigstack .Nd set and/or get signal stack context diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index eef676e04b7f..ef2669feec25 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -34,7 +34,7 @@ .\" .Dd November 24, 1997 .Dt SOCKET 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm socket .Nd create an endpoint for communication diff --git a/lib/libc/sys/socketpair.2 b/lib/libc/sys/socketpair.2 index ae4c337e7427..875aea04b37a 100644 --- a/lib/libc/sys/socketpair.2 +++ b/lib/libc/sys/socketpair.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SOCKETPAIR 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm socketpair .Nd create a pair of connected sockets @@ -62,7 +62,7 @@ and .Fa sv Ns [1] . The two sockets are indistinguishable. .Sh RETURN VALUES -A 0 is returned if the call succeeds, -1 if it fails. +.Rv -std socketpair .Sh ERRORS The call succeeds unless: .Bl -tag -width Er diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index efeb8f61f44a..9984a1ef1f43 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -34,7 +34,7 @@ .\" .Dd May 1, 1995 .Dt STAT 2 -.Os BSD 4 +.Os .Sh NAME .Nm stat , .Nm lstat , diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2 index 7e7eee1c8c2b..16e7e163f900 100644 --- a/lib/libc/sys/swapon.2 +++ b/lib/libc/sys/swapon.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SWAPON 2 -.Os BSD 4 +.Os .Sh NAME .Nm swapon .Nd add a swap device for interleaved paging/swapping diff --git a/lib/libc/sys/symlink.2 b/lib/libc/sys/symlink.2 index 92e1849a2c22..175ce9fecd89 100644 --- a/lib/libc/sys/symlink.2 +++ b/lib/libc/sys/symlink.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SYMLINK 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm symlink .Nd make symbolic link to a file @@ -58,10 +58,7 @@ used in creating the symbolic link). Either name may be an arbitrary path name; the files need not be on the same file system. .Sh RETURN VALUES -Upon successful completion, a zero value is returned. -If an error occurs, the error code is stored in -.Va errno -and a -1 value is returned. +.Rv -std symlink .Sh ERRORS The symbolic link succeeds unless: .Bl -tag -width Er diff --git a/lib/libc/sys/sync.2 b/lib/libc/sys/sync.2 index 8af30ddbff98..d60c0e42c2b2 100644 --- a/lib/libc/sys/sync.2 +++ b/lib/libc/sys/sync.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt SYNC 2 -.Os BSD 4 +.Os .Sh NAME .Nm sync .Nd "schedule filesystem updates" diff --git a/lib/libc/sys/syscall.2 b/lib/libc/sys/syscall.2 index f30e2ff6f22a..ea8d639cd3cb 100644 --- a/lib/libc/sys/syscall.2 +++ b/lib/libc/sys/syscall.2 @@ -34,7 +34,7 @@ .\" .Dd June 16, 1993 .Dt SYSCALL 2 -.Os BSD 4 +.Os .Sh NAME .Nm syscall , .Nm __syscall diff --git a/lib/libc/sys/truncate.2 b/lib/libc/sys/truncate.2 index 7456adce6993..fb3311f494fa 100644 --- a/lib/libc/sys/truncate.2 +++ b/lib/libc/sys/truncate.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt TRUNCATE 2 -.Os BSD 4.2 +.Os .Sh NAME .Nm truncate , .Nm ftruncate diff --git a/lib/libc/sys/umask.2 b/lib/libc/sys/umask.2 index 732c78668a97..026a983e2ce9 100644 --- a/lib/libc/sys/umask.2 +++ b/lib/libc/sys/umask.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt UMASK 2 -.Os BSD 4 +.Os .Sh NAME .Nm umask .Nd set file creation mode mask diff --git a/lib/libc/sys/undelete.2 b/lib/libc/sys/undelete.2 index 5be51a28d458..1b5d0daee8c0 100644 --- a/lib/libc/sys/undelete.2 +++ b/lib/libc/sys/undelete.2 @@ -35,7 +35,7 @@ .\" .Dd October 18, 1994 .Dt UNDELETE 2 -.Os BSD 4 +.Os .Sh NAME .Nm undelete .Nd attempt to recover a deleted file @@ -61,10 +61,7 @@ Eventually, the functionality may be expanded to other filesystems able to recover deleted files such as the log-structured filesystem. .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std undelete .Sh ERRORS The .Fn undelete @@ -103,4 +100,5 @@ points outside the process's allocated address space. .Sh HISTORY An .Fn undelete -function call first appeared in 4.4BSD-Lite. +function call first appeared in +.Bx 4.4 Lite . diff --git a/lib/libc/sys/unlink.2 b/lib/libc/sys/unlink.2 index 15fe8444af6f..2b5e3cb725f2 100644 --- a/lib/libc/sys/unlink.2 +++ b/lib/libc/sys/unlink.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt UNLINK 2 -.Os BSD 4 +.Os .Sh NAME .Nm unlink .Nd remove directory entry @@ -62,10 +62,7 @@ all references to it have been closed. .Fa path may not be a directory. .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. +.Rv -std unlink .Sh ERRORS The .Fn unlink diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2 index 13d8dcf25f86..49e36b67fdbb 100644 --- a/lib/libc/sys/vfork.2 +++ b/lib/libc/sys/vfork.2 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt VFORK 2 -.Os BSD 4 +.Os .Sh NAME .Nm vfork .Nd spawn new process in a virtual memory efficient way @@ -92,12 +92,12 @@ it is wrong to call .Xr exit 3 since buffered data would then be flushed twice.) .Sh SEE ALSO -.Xr _exit 2 , .Xr execve 2 , .Xr fork 2 , .Xr rfork 2 , .Xr sigvec 2 , .Xr wait 2 , +.Xr _exit 2 , .Xr exit 3 .Sh RETURN VALUES Same as for diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2 index 4a0e6ba1b36b..bbb2c57c6500 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt WAIT 2 -.Os BSD 4 +.Os .Sh NAME .Nm wait , .Nm waitpid , @@ -290,9 +290,9 @@ and the ability to restart a pending .Fn wait call are extensions to the POSIX interface. .Sh SEE ALSO -.Xr _exit 2 , .Xr ptrace 2 , .Xr sigaction 2 , +.Xr _exit 2 , .Xr exit 3 .Sh HISTORY A diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index 5b76325a4610..5d4fdc265b8d 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -34,7 +34,7 @@ .\" .Dd April 2, 1994 .Dt WRITE 2 -.Os BSD 4 +.Os .Sh NAME .Nm write , .Nm writev , diff --git a/lib/libc_r/man/pthread_attr.3 b/lib/libc_r/man/pthread_attr.3 index 6707b0a21f7d..6b26659fd253 100644 --- a/lib/libc_r/man/pthread_attr.3 +++ b/lib/libc_r/man/pthread_attr.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libc_r/man/pthread_cleanup_pop.3 b/lib/libc_r/man/pthread_cleanup_pop.3 index 3cefb6132299..38fc46ca05fd 100644 --- a/lib/libc_r/man/pthread_cleanup_pop.3 +++ b/lib/libc_r/man/pthread_cleanup_pop.3 @@ -29,7 +29,7 @@ .\" .Dd July 30, 1998 .Dt PTHREAD_CLEANUP_POP 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_cleanup_pop .Nd call the first cleanup routine diff --git a/lib/libc_r/man/pthread_cleanup_push.3 b/lib/libc_r/man/pthread_cleanup_push.3 index 70ee964f6b96..5cc2a1e0cb79 100644 --- a/lib/libc_r/man/pthread_cleanup_push.3 +++ b/lib/libc_r/man/pthread_cleanup_push.3 @@ -29,7 +29,7 @@ .\" .Dd July 30, 1998 .Dt PTHREAD_CLEANUP_PUSH 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_cleanup_push .Nd add a cleanup function for thread exit diff --git a/lib/libc_r/man/pthread_cond_broadcast.3 b/lib/libc_r/man/pthread_cond_broadcast.3 index 5a5f1a899459..f881886ed6cc 100644 --- a/lib/libc_r/man/pthread_cond_broadcast.3 +++ b/lib/libc_r/man/pthread_cond_broadcast.3 @@ -29,7 +29,7 @@ .\" .Dd July 28, 1998 .Dt PTHREAD_COND_BROADCAST 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_cond_broadcast .Nd unblock all threads waiting for a condition variable diff --git a/lib/libc_r/man/pthread_cond_destroy.3 b/lib/libc_r/man/pthread_cond_destroy.3 index fb93c07ea3d4..4ac17f951623 100644 --- a/lib/libc_r/man/pthread_cond_destroy.3 +++ b/lib/libc_r/man/pthread_cond_destroy.3 @@ -29,7 +29,7 @@ .\" .Dd July 28, 1998 .Dt PTHREAD_COND_DESTROY 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_cond_destroy .Nd destroy a condition variable diff --git a/lib/libc_r/man/pthread_cond_init.3 b/lib/libc_r/man/pthread_cond_init.3 index 4c7a637cede5..5339f38259a0 100644 --- a/lib/libc_r/man/pthread_cond_init.3 +++ b/lib/libc_r/man/pthread_cond_init.3 @@ -29,7 +29,7 @@ .\" .Dd July 28, 1998 .Dt PTHREAD_COND_INIT 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_cond_init .Nd create a condition variable diff --git a/lib/libc_r/man/pthread_cond_signal.3 b/lib/libc_r/man/pthread_cond_signal.3 index 540b84c8f4b4..654d5a803122 100644 --- a/lib/libc_r/man/pthread_cond_signal.3 +++ b/lib/libc_r/man/pthread_cond_signal.3 @@ -29,7 +29,7 @@ .\" .Dd July 28, 1998 .Dt PTHREAD_COND_SIGNAL 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_cond_signal .Nd unblock a thread waiting for a condition variable diff --git a/lib/libc_r/man/pthread_cond_timedwait.3 b/lib/libc_r/man/pthread_cond_timedwait.3 index 1d0fe70d5204..b0c56e80fe3a 100644 --- a/lib/libc_r/man/pthread_cond_timedwait.3 +++ b/lib/libc_r/man/pthread_cond_timedwait.3 @@ -29,7 +29,7 @@ .\" .Dd July 28, 1998 .Dt PTHREAD_COND_TIMEDWAIT 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_cond_timedwait .Nd "wait on a condition variable for a specific amount of time" diff --git a/lib/libc_r/man/pthread_cond_wait.3 b/lib/libc_r/man/pthread_cond_wait.3 index abe44c72565b..e9fde91842f8 100644 --- a/lib/libc_r/man/pthread_cond_wait.3 +++ b/lib/libc_r/man/pthread_cond_wait.3 @@ -29,7 +29,7 @@ .\" .Dd July 28, 1998 .Dt PTHREAD_COND_WAIT 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_cond_wait .Nd wait on a condition variable diff --git a/lib/libc_r/man/pthread_condattr.3 b/lib/libc_r/man/pthread_condattr.3 index d117c7505642..28df565c60f2 100644 --- a/lib/libc_r/man/pthread_condattr.3 +++ b/lib/libc_r/man/pthread_condattr.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libc_r/man/pthread_create.3 b/lib/libc_r/man/pthread_create.3 index 2dae2a1f657e..5f2d24ce8ed3 100644 --- a/lib/libc_r/man/pthread_create.3 +++ b/lib/libc_r/man/pthread_create.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_CREATE 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_create .Nd create a new thread diff --git a/lib/libc_r/man/pthread_detach.3 b/lib/libc_r/man/pthread_detach.3 index e91a2fe91669..a3b660fdde64 100644 --- a/lib/libc_r/man/pthread_detach.3 +++ b/lib/libc_r/man/pthread_detach.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_DETACH 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_detach .Nd detach a thread diff --git a/lib/libc_r/man/pthread_equal.3 b/lib/libc_r/man/pthread_equal.3 index d08111038c8a..be55e90b46ba 100644 --- a/lib/libc_r/man/pthread_equal.3 +++ b/lib/libc_r/man/pthread_equal.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_EQUAL 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_equal .Nd compare thread IDs diff --git a/lib/libc_r/man/pthread_exit.3 b/lib/libc_r/man/pthread_exit.3 index 93a584b084cf..1eabc9bcb94b 100644 --- a/lib/libc_r/man/pthread_exit.3 +++ b/lib/libc_r/man/pthread_exit.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_EXIT 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_exit .Nd terminate the calling thread diff --git a/lib/libc_r/man/pthread_getspecific.3 b/lib/libc_r/man/pthread_getspecific.3 index 4bcb0d9b50d9..c003f3fca894 100644 --- a/lib/libc_r/man/pthread_getspecific.3 +++ b/lib/libc_r/man/pthread_getspecific.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_GETSPECIFIC 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_getspecific .Nd get a thread-specific data value diff --git a/lib/libc_r/man/pthread_join.3 b/lib/libc_r/man/pthread_join.3 index 3a68895fc5f2..f8e8e18a2fea 100644 --- a/lib/libc_r/man/pthread_join.3 +++ b/lib/libc_r/man/pthread_join.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_JOIN 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_join .Nd wait for thread termination diff --git a/lib/libc_r/man/pthread_key_create.3 b/lib/libc_r/man/pthread_key_create.3 index dcafc0c52113..d1fb92216949 100644 --- a/lib/libc_r/man/pthread_key_create.3 +++ b/lib/libc_r/man/pthread_key_create.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_KEY_CREATE 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_key_create .Nd thread-specific data key creation diff --git a/lib/libc_r/man/pthread_key_delete.3 b/lib/libc_r/man/pthread_key_delete.3 index 06447e07abc0..9baa5020f12b 100644 --- a/lib/libc_r/man/pthread_key_delete.3 +++ b/lib/libc_r/man/pthread_key_delete.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_KEY_DELETE 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_key_delete .Nd delete a thread-specific data key diff --git a/lib/libc_r/man/pthread_kill.3 b/lib/libc_r/man/pthread_kill.3 index a18a969cdd75..7a33cf6c6016 100644 --- a/lib/libc_r/man/pthread_kill.3 +++ b/lib/libc_r/man/pthread_kill.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libc_r/man/pthread_mutex_destroy.3 b/lib/libc_r/man/pthread_mutex_destroy.3 index 0bb44d01d075..f7b915d82820 100644 --- a/lib/libc_r/man/pthread_mutex_destroy.3 +++ b/lib/libc_r/man/pthread_mutex_destroy.3 @@ -29,7 +29,7 @@ .\" .Dd July 29, 1998 .Dt PTHREAD_MUTEX_DESTROY 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_mutex_destroy .Nd free resources allocated for a mutex diff --git a/lib/libc_r/man/pthread_mutex_init.3 b/lib/libc_r/man/pthread_mutex_init.3 index 7d25baf41b55..42b3a26a61f9 100644 --- a/lib/libc_r/man/pthread_mutex_init.3 +++ b/lib/libc_r/man/pthread_mutex_init.3 @@ -29,7 +29,7 @@ .\" .Dd July 29, 1998 .Dt PTHREAD_MUTEX_INIT 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_mutex_init .Nd create a mutex diff --git a/lib/libc_r/man/pthread_mutex_lock.3 b/lib/libc_r/man/pthread_mutex_lock.3 index 82dfaadf731b..972d277eade4 100644 --- a/lib/libc_r/man/pthread_mutex_lock.3 +++ b/lib/libc_r/man/pthread_mutex_lock.3 @@ -29,7 +29,7 @@ .\" .Dd July 30, 1998 .Dt PTHREAD_MUTEX_LOCK 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_mutex_lock .Nd lock a mutex diff --git a/lib/libc_r/man/pthread_mutex_trylock.3 b/lib/libc_r/man/pthread_mutex_trylock.3 index fa3bdf87a8c4..143df146702c 100644 --- a/lib/libc_r/man/pthread_mutex_trylock.3 +++ b/lib/libc_r/man/pthread_mutex_trylock.3 @@ -29,7 +29,7 @@ .\" .Dd July 30, 1998 .Dt PTHREAD_MUTEX_TRYLOCK 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_mutex_trylock .Nd attempt to lock a mutex without blocking diff --git a/lib/libc_r/man/pthread_mutex_unlock.3 b/lib/libc_r/man/pthread_mutex_unlock.3 index e873be9904fa..93e635496ec6 100644 --- a/lib/libc_r/man/pthread_mutex_unlock.3 +++ b/lib/libc_r/man/pthread_mutex_unlock.3 @@ -29,7 +29,7 @@ .\" .Dd July 30, 1998 .Dt PTHREAD_MUTEX_UNLOCK 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_mutex_unlock .Nd unlock a mutex diff --git a/lib/libc_r/man/pthread_mutexattr.3 b/lib/libc_r/man/pthread_mutexattr.3 index 555cdd4735db..707984606094 100644 --- a/lib/libc_r/man/pthread_mutexattr.3 +++ b/lib/libc_r/man/pthread_mutexattr.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libc_r/man/pthread_once.3 b/lib/libc_r/man/pthread_once.3 index 4549288a667a..72a132249ccb 100644 --- a/lib/libc_r/man/pthread_once.3 +++ b/lib/libc_r/man/pthread_once.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_ONCE 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_once .Nd dynamic package initialization diff --git a/lib/libc_r/man/pthread_rwlock_init.3 b/lib/libc_r/man/pthread_rwlock_init.3 index 128f5d12d47e..749a848d41d6 100644 --- a/lib/libc_r/man/pthread_rwlock_init.3 +++ b/lib/libc_r/man/pthread_rwlock_init.3 @@ -55,9 +55,9 @@ If successful, the function will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO -.Xr pthread_rwlock_destroy 3 , .Xr pthread_rwlockattr_init 3 , -.Xr pthread_rwlockattr_setpshared 3 +.Xr pthread_rwlockattr_setpshared 3 , +.Xr pthread_rwlock_destroy 3 .Sh STANDARDS The .Fn pthread_rwlock_init diff --git a/lib/libc_r/man/pthread_rwlockattr_getpshared.3 b/lib/libc_r/man/pthread_rwlockattr_getpshared.3 index a433d6020a36..40eed6e0232a 100644 --- a/lib/libc_r/man/pthread_rwlockattr_getpshared.3 +++ b/lib/libc_r/man/pthread_rwlockattr_getpshared.3 @@ -58,9 +58,9 @@ If successful, the function will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO -.Xr pthread_rwlock_init 3 , .Xr pthread_rwlockattr_init 3 , -.Xr pthread_rwlockattr_setpshared 3 +.Xr pthread_rwlockattr_setpshared 3 , +.Xr pthread_rwlock_init 3 .Sh STANDARDS The .Fn pthread_rwlockattr_getpshared diff --git a/lib/libc_r/man/pthread_rwlockattr_init.3 b/lib/libc_r/man/pthread_rwlockattr_init.3 index c35510468e96..4fbbe3676097 100644 --- a/lib/libc_r/man/pthread_rwlockattr_init.3 +++ b/lib/libc_r/man/pthread_rwlockattr_init.3 @@ -46,10 +46,10 @@ If successful, the function will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO -.Xr pthread_rwlock_init 3 , .Xr pthread_rwlockattr_destroy 3 , .Xr pthread_rwlockattr_getpshared 3 , -.Xr pthread_rwlockattr_setpshared 3 +.Xr pthread_rwlockattr_setpshared 3 , +.Xr pthread_rwlock_init 3 .Sh STANDARDS The .Fn pthread_rwlockattr_init diff --git a/lib/libc_r/man/pthread_rwlockattr_setpshared.3 b/lib/libc_r/man/pthread_rwlockattr_setpshared.3 index fd5fa90f995b..dfc7fe625ce2 100644 --- a/lib/libc_r/man/pthread_rwlockattr_setpshared.3 +++ b/lib/libc_r/man/pthread_rwlockattr_setpshared.3 @@ -60,9 +60,9 @@ If successful, the function will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO -.Xr pthread_rwlock_init 3 , .Xr pthread_rwlockattr_init 3 , -.Xr pthread_rwlockattr_setpshared 3 +.Xr pthread_rwlockattr_setpshared 3 , +.Xr pthread_rwlock_init 3 .Sh STANDARDS The .Fn pthread_rwlockattr_setpshared diff --git a/lib/libc_r/man/pthread_schedparam.3 b/lib/libc_r/man/pthread_schedparam.3 index 96287e5b6e7b..50c556f2824a 100644 --- a/lib/libc_r/man/pthread_schedparam.3 +++ b/lib/libc_r/man/pthread_schedparam.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libc_r/man/pthread_self.3 b/lib/libc_r/man/pthread_self.3 index 9723b5eebdc1..acd46e9955b7 100644 --- a/lib/libc_r/man/pthread_self.3 +++ b/lib/libc_r/man/pthread_self.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_SELF 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_self .Nd get the calling thread's ID diff --git a/lib/libc_r/man/pthread_setspecific.3 b/lib/libc_r/man/pthread_setspecific.3 index 698c3ca807c5..5265def7e7f1 100644 --- a/lib/libc_r/man/pthread_setspecific.3 +++ b/lib/libc_r/man/pthread_setspecific.3 @@ -32,7 +32,7 @@ .\" .Dd April 4, 1996 .Dt PTHREAD_SETSPECIFIC 3 -.Os BSD 4 +.Os .Sh NAME .Nm pthread_setspecific .Nd set a thread-specific data value diff --git a/lib/libc_r/man/pthread_sigmask.3 b/lib/libc_r/man/pthread_sigmask.3 index 233d7db18f11..2b23d3ba8149 100644 --- a/lib/libc_r/man/pthread_sigmask.3 +++ b/lib/libc_r/man/pthread_sigmask.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -88,8 +88,8 @@ is not one of the defined values. .Xr sigaction 2 , .Xr sigpending 2 , .Xr sigprocmask 2 , -.Xr sigsetops 3 , -.Xr sigsuspend 2 +.Xr sigsuspend 2 , +.Xr sigsetops 3 .Sh STANDARDS .Fn pthread_sigmask conforms to diff --git a/lib/libc_r/man/pthread_testcancel.3 b/lib/libc_r/man/pthread_testcancel.3 index 2bb4ae2abb76..110ab38b2cd7 100644 --- a/lib/libc_r/man/pthread_testcancel.3 +++ b/lib/libc_r/man/pthread_testcancel.3 @@ -195,4 +195,7 @@ conforms to .Sh AUTHORS This man page was written by .An David Leonard Aq d@openbsd.org -for the OpenBSD implementation of pthread_cancel. +for the +.Ox +implementation of +.Xr pthread_cancel 3 . diff --git a/lib/libc_r/man/sem_destroy.3 b/lib/libc_r/man/sem_destroy.3 index 0de46913728b..82f0946da621 100644 --- a/lib/libc_r/man/sem_destroy.3 +++ b/lib/libc_r/man/sem_destroy.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -49,12 +49,7 @@ After a successful call to is unuseable until re-initialized by another call to .Fn sem_init . .Sh RETURN VALUES -If successful, -.Fn sem_destroy -returns 0. Otherwise, -1 is returned and -.Va errno -is set to indicate the type of -error. +.Rv -std sem_destroy .Sh ERRORS .Fn sem_destroy will fail if: diff --git a/lib/libc_r/man/sem_getvalue.3 b/lib/libc_r/man/sem_getvalue.3 index 3ee947af7ad8..2ad564642e0d 100644 --- a/lib/libc_r/man/sem_getvalue.3 +++ b/lib/libc_r/man/sem_getvalue.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -49,12 +49,7 @@ as of the time that the call to .Fn sem_getvalue is actually run. .Sh RETURN VALUES -If successful, -.Fn sem_getvalue -returns 0. Otherwise, -1 is returned and -.Va errno -is set to indicate the type of -error. +.Rv -std sem_getvalue .Sh ERRORS .Fn sem_getvalue will fail if: diff --git a/lib/libc_r/man/sem_init.3 b/lib/libc_r/man/sem_init.3 index 5f43c08e3789..6226edc3b485 100644 --- a/lib/libc_r/man/sem_init.3 +++ b/lib/libc_r/man/sem_init.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -63,12 +63,7 @@ and is no longer valid after a successful call to .Fa sem_destroy . .Sh RETURN VALUES -If successful, -.Fn sem_init -returns 0. Otherwise, -1 is returned and -.Va errno -is set to indicate the type of -error. +.Rv -std sem_init .Sh ERRORS .Fn sem_init will fail if: diff --git a/lib/libc_r/man/sem_open.3 b/lib/libc_r/man/sem_open.3 index eec5a5798a0d..b735a56a96cb 100644 --- a/lib/libc_r/man/sem_open.3 +++ b/lib/libc_r/man/sem_open.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libc_r/man/sem_post.3 b/lib/libc_r/man/sem_post.3 index 0c8dea4934ef..ca6bf6df4a00 100644 --- a/lib/libc_r/man/sem_post.3 +++ b/lib/libc_r/man/sem_post.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without @@ -52,12 +52,7 @@ the semaphore will be allowed to return from .Fn sem_post is signal-reentrant and may be called within signal handlers. .Sh RETURN VALUES -If successful, -.Fn sem_post -returns 0. Otherwise, -1 is returned and -.Va errno -is set to indicate the type of -error. +.Rv -std sem_post .Sh ERRORS .Fn sem_post will fail if: diff --git a/lib/libc_r/man/sem_wait.3 b/lib/libc_r/man/sem_wait.3 index 397cbfe1663f..61a21be84aed 100644 --- a/lib/libc_r/man/sem_wait.3 +++ b/lib/libc_r/man/sem_wait.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libc_r/man/sigwait.3 b/lib/libc_r/man/sigwait.3 index bd46b1ca9614..fba1f67d3fdf 100644 --- a/lib/libc_r/man/sigwait.3 +++ b/lib/libc_r/man/sigwait.3 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. +.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libcalendar/calendar.3 b/lib/libcalendar/calendar.3 index 9a0a6fefeda6..1e7b51a04897 100644 --- a/lib/libcalendar/calendar.3 +++ b/lib/libcalendar/calendar.3 @@ -37,7 +37,7 @@ .Nm ndaysj , .Nm week , .Nm weekday -.Nd Calendar arithmetic for the Christian era. +.Nd Calendar arithmetic for the Christian era .Sh LIBRARY .Lb libcalendar .Sh SYNOPSIS diff --git a/lib/libcam/cam.3 b/lib/libcam/cam.3 index 04508674aa9d..2253bda28308 100644 --- a/lib/libcam/cam.3 +++ b/lib/libcam/cam.3 @@ -28,7 +28,7 @@ .\" $FreeBSD$ .\" .Dd October 10, 1998 -.Os FreeBSD +.Os .Dt CAM 3 .Sh NAME .Nm cam_open_device , diff --git a/lib/libcam/cam_cdbparse.3 b/lib/libcam/cam_cdbparse.3 index 39ca4785eb86..e7612491a7d5 100644 --- a/lib/libcam/cam_cdbparse.3 +++ b/lib/libcam/cam_cdbparse.3 @@ -62,7 +62,7 @@ .\" .\" .Dd October 13, 1998 -.Os FreeBSD +.Os .Dt CAM_CDBPARSE 3 .Sh NAME .Nm csio_build , @@ -170,7 +170,7 @@ layer. These functions may be used in new applications, but users may find it easier to use the various SCSI CCB building functions included with the .Xr cam 3 -library. (e.g. +library. (e.g.\& .Fn cam_fill_csio , .Fn scsi_start_stop , and @@ -413,10 +413,10 @@ them to a dummy variable in the arg list. The seek field type .Fa s permits you to skip over data. -This seeks to an absolute position ( -.Fa s3 ) -or a relative position ( -.Fa s+3 ) +This seeks to an absolute position +.Pq Fa s3 +or a relative position +.Pq Fa s+3 in the data, based on whether or not the presence of the '+' sign. The seek value can be specified as .Fa v @@ -522,7 +522,10 @@ go here; Peter Dufault first read about it in a 1989 Sun Expert magazine. The new CCB data structures are derived from the CAM-2 and CAM-3 specifications. .Pp -Peter Dufault implemented a clone of SGI's interface in 386bsd that +.An Peter Dufault +implemented a clone of SGI's interface in +.Bx 386 +that led to the original .Fx .Tn SCSI diff --git a/lib/libcompat/4.1/ftime.3 b/lib/libcompat/4.1/ftime.3 index eb834c1e20d8..26423876dab0 100644 --- a/lib/libcompat/4.1/ftime.3 +++ b/lib/libcompat/4.1/ftime.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt FTIME 3 -.Os BSD 4 +.Os .Sh NAME .Nm ftime .Nd get date and time @@ -47,7 +47,8 @@ .Fn ftime "struct timeb *tp" .Sh DESCRIPTION .Bf -symbolic -This interface is obsoleted by gettimeofday(2). +This interface is obsoleted by +.Xr gettimeofday 2 . .Ef .Pp The diff --git a/lib/libcompat/4.1/getpw.3 b/lib/libcompat/4.1/getpw.3 index 618da44a928c..f1a57c5e1784 100644 --- a/lib/libcompat/4.1/getpw.3 +++ b/lib/libcompat/4.1/getpw.3 @@ -46,7 +46,10 @@ .Fn getpw "uid_t uid" "char *buf" .Sh DESCRIPTION .Bf -symbolic -The getpw function is made obsolete by getpwuid(3). +The +.Fn getpw +function is made obsolete by +.Xr getpwuid 3 . .Ef .Pp The diff --git a/lib/libcompat/4.1/stty.3 b/lib/libcompat/4.1/stty.3 index 9193bcfeef0d..a1f89d1a2528 100644 --- a/lib/libcompat/4.1/stty.3 +++ b/lib/libcompat/4.1/stty.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt STTY 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm stty , .Nm gtty @@ -49,7 +49,8 @@ .Fn gtty "int fd" "struct sgttyb *buf" .Sh DESCRIPTION .Bf -symbolic -These interfaces are obsoleted by ioctl(2). +These interfaces are obsoleted by +.Xr ioctl 2 . .Ef .Pp The diff --git a/lib/libcompat/4.3/insque.3 b/lib/libcompat/4.3/insque.3 index 6c02bb7cac1a..2744daec02ab 100644 --- a/lib/libcompat/4.3/insque.3 +++ b/lib/libcompat/4.3/insque.3 @@ -34,7 +34,7 @@ .\" .Dd December 11, 1993 .Dt INSQUE 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm insque , .Nm remque diff --git a/lib/libcompat/4.3/rexec.3 b/lib/libcompat/4.3/rexec.3 index eb80689cd9c9..737c976f1abc 100644 --- a/lib/libcompat/4.3/rexec.3 +++ b/lib/libcompat/4.3/rexec.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt REXEC 3 -.Os BSD 4.2 +.Os .Sh NAME .Nm rexec .Nd return stream to a remote command diff --git a/lib/libcompat/4.4/cuserid.3 b/lib/libcompat/4.4/cuserid.3 index 5ac7e3465b46..5141c0341d8e 100644 --- a/lib/libcompat/4.4/cuserid.3 +++ b/lib/libcompat/4.4/cuserid.3 @@ -73,11 +73,9 @@ returns the address of an array in which the name has been stored. .Pp If the name associated with the effective UID of the current process could not be found, either a null pointer will be returned, or -.Po -if +(if .Fa s -is non-NULL -.Pc +is non-NULL) the buffer .Fa s will be filled with a null string. diff --git a/lib/libcrypt/crypt.3 b/lib/libcrypt/crypt.3 index fa9b34f9bac0..d4d3020c94c1 100644 --- a/lib/libcrypt/crypt.3 +++ b/lib/libcrypt/crypt.3 @@ -33,7 +33,7 @@ .\" .Dd January 19, 1997 .Dt CRYPT 3 -.Os "FreeSec 1.0" +.Os .Sh NAME .Nm crypt .Nd Trapdoor encryption @@ -244,7 +244,7 @@ Otherwise, a value of 0 is returned. .Xr cipher 3 , .Xr getpass 3 , .Xr auth.conf 5 , -.Xr passwd 5 , +.Xr passwd 5 .Sh BUGS The .Fn crypt @@ -269,8 +269,6 @@ section of the code (FreeSec 1.0) was developed outside the United States of America as an unencumbered replacement for the U.S.-only .Nx libcrypt encryption library. -Users should be aware that this code (and programs staticly linked with it) -may not be exported from the U.S., although it apparently can be imported. .Sh AUTHORS .An -nosplit Originally written by diff --git a/lib/libdevstat/devstat.3 b/lib/libdevstat/devstat.3 index ff030a47a574..9e804d65013f 100644 --- a/lib/libdevstat/devstat.3 +++ b/lib/libdevstat/devstat.3 @@ -29,7 +29,7 @@ .\" .Dd May 21, 1998 .Dt DEVSTAT 3 -.Os FreeBSD +.Os .Sh NAME .Nm devstat , .Nm getnumdevs , @@ -123,16 +123,17 @@ returns the current kernel version. .Pp .Fn checkversion -checks the userland devstat version against the kernel devstat version. If -the two are identical, it returns zero. Otherwise, it prints an -appropriate error in +checks the userland devstat version against the kernel devstat version. +If the two are identical, it returns zero. +Otherwise, it prints an appropriate error in .Va devstat_errbuf and returns -1. .Pp .Fn getdevs fetches the current list of devices and statistics into the supplied .Va statinfo -structure. The +structure. +The .Va statinfo structure can be found in .Aq Pa devstat.h : @@ -177,11 +178,11 @@ variable contains an array of .Nm structures, but at the head of the array is the current .Nm -generation. The reason the generation is at the head of the buffer is so -that userland software accessing the devstat statistics information can -atomically get both the statistics information and the corresponding -generation number. If client software were forced to get the generation -number via a separate +generation. +The reason the generation is at the head of the buffer is so that userland +software accessing the devstat statistics information can atomically get +both the statistics information and the corresponding generation number. +If client software were forced to get the generation number via a separate .Nm sysctl variable (which is available for convenience), the list of devices could change between the time the client gets the generation and the time the @@ -200,7 +201,8 @@ structure is basically a pointer to the beginning of the array of devstat structures from the .Va kern.devstat.all .Nm sysctl -variable. The generation subelement of the +variable. +The generation subelement of the .Va devinfo structure contains the generation number from the .Va kern.devstat.all @@ -219,8 +221,8 @@ subsystem. selects devices to display based upon a number of criteria: .Bl -tag -width flag .It specified devices -Specified devices are the first selection priority. These are generally -devices specified by name by the user. e.g. da0, da1, cd0. +Specified devices are the first selection priority. +These are generally devices specified by name by the user e.g. da0, da1, cd0. .It match patterns These are pattern matching expressions generated by .Fn buildmatch @@ -234,15 +236,16 @@ structure passed in to .Fn selectdevs . The .Va bytes -value currently must be maintained by the user. In the future, -this may be done for him in a +value currently must be maintained by the user. +In the future, this may be done for him in a .Nm library routine. If no devices have been selected by name or by pattern, the performance tracking code will select every device in the system, and sort them by -performance. If devices have been selected by name or pattern, the -performance tracking code will honor those selections and will only sort -among the selected devices. +performance. +If devices have been selected by name or pattern, the performance tracking +code will honor those selections and will only sort among the selected +devices. .It order in the devstat list If the selection mode is set to DS_SELECT_ADD, and if there are still less than @@ -274,30 +277,30 @@ by name or by matching pattern. .It DS_SELECT_REMOVE In remove mode, .Fn selectdevs -will remove devices specified by name or by matching pattern. It will not -select any additional devices. +will remove devices specified by name or by matching pattern. +It will not select any additional devices. .It DS_SELECT_ADDONLY In add only mode, .Fn selectdevs will select any unselected devices specified by name or matching pattern. -In this respect it is identical to add mode. It will not, however, select -any devices other than those specified. +In this respect it is identical to add mode. +It will not, however, select any devices other than those specified. .El .Pp In all selection modes, .Fn selectdevs will not select any more than .Va maxshowdevs -devices. One exception to -this is when you are in +devices. +One exception to this is when you are in .Dq top -mode and no devices have been selected. In -this case, +mode and no devices have been selected. +In this case, .Fn selectdevs -will select every device in the system. Client programs must pay attention -to selection order when deciding whether to pay attention to a particular -device. This may be the wrong behavior, and probably requires additional -thought. +will select every device in the system. +Client programs must pay attention to selection order when deciding whether +to pay attention to a particular device. +This may be the wrong behavior, and probably requires additional thought. .Pp .Fn selectdevs handles allocation and resizing of the @@ -312,7 +315,8 @@ and fields to track the current .Nm -generation and number of devices. If +generation and number of devices. +If .Va num_selections is not the same as @@ -388,21 +392,23 @@ Passthrough devices .El .Pp .Fn compute_stats -provides an easy way to obtain various device statistics. Only two -arguments are mandatory: +provides an easy way to obtain various device statistics. +Only two arguments are mandatory: .Va current and .Va etime . -Every other argument is optional. For most applications, the user will -want to supply both +Every other argument is optional. +For most applications, the user will want to supply both .Va current and .Va previous devstat structures so that statistics may be calculated over a given period -of time. In some instances, for instance when calculating statistics since -system boot, the user may pass in a NULL pointer for the +of time. +In some instances, for instance when calculating statistics since system boot, +the user may pass in a NULL pointer for the .Va previous -argument. In that case, +argument. +In that case, .Fn compute_stats will use the total stats in the .Va current @@ -437,7 +443,8 @@ is NULL, the result will be the total number of transactions listed in .It total_blocks This is basically .Va total_bytes -divided by the device blocksize. If the device blocksize is listed as +divided by the device blocksize. +If the device blocksize is listed as .Sq 0 , the device blocksize will default to 512 bytes. .It kb_per_transfer @@ -448,7 +455,8 @@ This is the average number of transfers per second. .It mb_per_second This is average megabytes per second. .It blocks_per_second -This is average blocks per second. If the device blocksize is +This is average blocks per second. +If the device blocksize is .Sq 0 , a default blocksize of 512 bytes will be used instead. .It ms_per_transaction @@ -458,8 +466,8 @@ The average number of milliseconds per transaction. .Fn compute_etime provides an easy way to find the difference in seconds between two .Va timeval -structures. This is most commonly used in conjunction with the time -recorded by the +structures. +This is most commonly used in conjunction with the time recorded by the .Fn getdevs function (in struct .Va statinfo ) @@ -477,13 +485,15 @@ fetching the variable. .Fn checkversion returns 0 if the kernel and userland .Nm -versions match. If they do not match, it returns -1. +versions match. +If they do not match, it returns -1. .Pp .Fn getdevs and .Fn selectdevs return -1 in case of an error, 0 if there is no error and 1 if the device -list or selected devices have changed. A return value of 1 from +list or selected devices have changed. +A return value of 1 from .Fn getdevs is usually a hint to re-run .Fn selectdevs diff --git a/lib/libdisk/libdisk.3 b/lib/libdisk/libdisk.3 index 00be4ceb40ab..8f3c9cf7d9ab 100644 --- a/lib/libdisk/libdisk.3 +++ b/lib/libdisk/libdisk.3 @@ -180,7 +180,9 @@ values for a .It CHUNK_PAST_1024 This chunk cannot be booted from because it extends past cylinder 1024. .It CHUNK_BSD_COMPAT -This chunk is in the BSD-compatibility, and has a short name too, i.e. +This chunk is in the +.Bx Ns -compatibility , +and has a short name too, i.e.\& .Ql wd0s4f -> wd0f . .It CHUNK_ALIGN This chunk should be aligned. diff --git a/lib/libedit/editline.3 b/lib/libedit/editline.3 index b387023edad2..8108026d3b97 100644 --- a/lib/libedit/editline.3 +++ b/lib/libedit/editline.3 @@ -36,7 +36,7 @@ .\" $FreeBSD$ .\" .Dd January 11, 1997 -.Os BSD 4.4 +.Os .Dt EDITLINE 3 .Sh NAME .Nm editline , @@ -207,9 +207,7 @@ The colon between and the command, .Ar command , will be replaced with a NUL -.Po -.Dq \e0 -.Pc . +.Pq Dq \e0 . .It Fn el_set Set .Nm diff --git a/lib/libedit/editrc.5 b/lib/libedit/editrc.5 index ee8e3787e75f..e617a7c5d6d5 100644 --- a/lib/libedit/editrc.5 +++ b/lib/libedit/editrc.5 @@ -36,7 +36,7 @@ .\" $FreeBSD$ .\" .Dd January 11, 1997 -.Os BSD 4.4 +.Os .Dt EDITRC 5 .Sh NAME .Nm editrc @@ -156,10 +156,8 @@ can contain control characters of the form .Sm off .Sq No ^ Ar character .Sm on -.Po -e.g. -.Sq ^A -.Pc , +(e.g.\& +.Sq ^A ) , and the following backslashed escape sequences: .Pp .Bl -tag -compact -offset indent -width 4n @@ -261,13 +259,9 @@ set of tty modes respectively; defaulting to Without other arguments, .Ic setty lists the modes in the chosen set which are fixed on -.Po -.Sq +mode -.Pc +.Pq Sq +mode or off -.Po -.Sq -mode -.Pc . +.Pq Sq -mode . .Fl a lists all tty modes in the chosen set regardless of the setting. With diff --git a/lib/libfetch/fetch.3 b/lib/libfetch/fetch.3 index b663232bd418..2c4bd10dcd3c 100644 --- a/lib/libfetch/fetch.3 +++ b/lib/libfetch/fetch.3 @@ -147,7 +147,7 @@ components. and .Fn fetchParseURL return a pointer to a -.Fa url +.Vt url structure, which is defined as follows in .Aq Pa fetch.h : .Bd -literal @@ -186,7 +186,7 @@ method, and call the appropriate lower-level functions to perform the actual transfer. .Fn fetchXGetURL also returns the remote document's metadata in the -.Fa url_stat +.Vt url_stat structure pointed to by the .Fa us argument. @@ -202,7 +202,7 @@ in the appropriate section below. attempts to obtain the requested document's metadata and fill in the structure pointed to by its second argument. The -.Fa url_stat +.Vt url_stat structure is defined as follows in .Aq Pa fetch.h : .Bd -literal @@ -227,10 +227,10 @@ field is set to the modification time. attempts to list the contents of the directory pointed to by the URL provided. If successful, it returns a malloced array of -.Fa url_ent +.Vt url_ent structures. The -.Fa url_ent +.Vt url_ent structure is defined as follows in .Aq Pa fetch.h : .Bd -literal @@ -260,7 +260,7 @@ and .Fn fetchStatURL , except that they expect a pre-parsed URL in the form of a pointer to a -.Fa struct url +.Vt struct url rather than a string. .Pp All of the @@ -295,7 +295,7 @@ do not accept any flags. .Pp .Fn fetchPutFile accepts the -.Fa a +.Ql a (append to file) flag. If that flag is specified, the data written to the stream returned by @@ -310,18 +310,18 @@ and implement the FTP protocol as described in RFC959. .Pp If the -.Fa p +.Ql p (passive) flag is specified, a passive (rather than active) connection will be attempted. .Pp If the -.Fa l +.Ql l (low) flag is specified, data sockets will be allocated in the low (or default) port range instead of the hifh port range (see .Xr ip 4 ) . .Pp If the -.Fa d +.Ql d (direct) flag is specified, .Fn fetchXGetFTP , .Fn fetchGetFTP @@ -344,7 +344,7 @@ With a little luck, there's even a chance that they comply with RFC2616 and RFC2617. .Pp If the -.Fa d +.Ql d (direct) flag is specified, .Fn fetchXGetHTTP , .Fn fetchGetHTTP @@ -361,7 +361,7 @@ is currently unimplemented. .Sh RETURN VALUES .Fn fetchParseURL returns a pointer to a -.Fa struct url +.Vt struct url containing the individual components of the URL. If it is unable to allocate memory, or the URL is syntactically incorrect, @@ -489,7 +489,7 @@ URL. .It Ev HTTP_USER_AGENT Specifies the User-Agent string to use for HTTP requests. This can be useful when working with HTTP origin or proxy servers that -differentiate between usder agents. +differentiate between user agents. .El .Sh SEE ALSO .Xr fetch 1 , diff --git a/lib/libftpio/ftpio.3 b/lib/libftpio/ftpio.3 index 7c897b1cec6f..e8af68976004 100644 --- a/lib/libftpio/ftpio.3 +++ b/lib/libftpio/ftpio.3 @@ -43,7 +43,7 @@ .Nm ftpLoginAf , .Nm ftpGetURLAf , .Nm ftpPutURLAf -.Nd FTPIO User library +.Nd FTPIO user library .Sh SYNOPSIS .Fd #include <ftpio.h> .Ft FILE * diff --git a/lib/libipsec/ipsec_set_policy.3 b/lib/libipsec/ipsec_set_policy.3 index e676b95f9517..f1a57fe1f7b7 100644 --- a/lib/libipsec/ipsec_set_policy.3 +++ b/lib/libipsec/ipsec_set_policy.3 @@ -54,7 +54,7 @@ generates IPsec policy specification structure, namely and/or .Li struct sadb_x_ipsecrequest from human-readable policy specification. -policy specification must be given as C string +Policy specification must be given as C string .Fa policy and length .Fa len @@ -110,7 +110,7 @@ means to consult to SPD defined by .It Ar direction Li bypass .Li bypass means to be bypassed the IPsec processing. -.Pq packet will be transmitted in clear . +(packet will be transmitted in clear). This is for privileged socket. .It Xo .Ar direction @@ -167,7 +167,7 @@ is this node and .Ar src is the other node -.Pq peer . +(peer). If .Ar mode is @@ -196,9 +196,9 @@ regarding the system default. means that a relevant SA can be used when available, since the kernel may perform IPsec operation against packets when possible. In this case, packets can be transmitted in clear -.Pq when SA is not available , +(when SA is not available), or encrypted -.Pq when SA is available . +(when SA is available). .Li require means that a relevant SA is required, since the kernel must perform IPsec operation against packets. @@ -241,7 +241,7 @@ Refer to for detail. .Pp Here are several examples -.Pq long lines are wrapped for readability : +(long lines are wrapped for readability): .Bd -literal -offset indent in discard out ipsec esp/transport//require @@ -255,7 +255,7 @@ in ipsec ipcomp/transport//use returns a pointer to the allocated buffer of policy specification if successful; otherwise a NULL pointer is returned. .Fn ipsec_get_policylen returns with positive value -.Pq meaning the buffer size +(meaning the buffer size) on success, and negative value on errors. .Fn ipsec_dump_policy returns a pointer to dynamically allocated region on success, diff --git a/lib/libipx/ipx.3 b/lib/libipx/ipx.3 index ca0f5228b891..93e21e266b04 100644 --- a/lib/libipx/ipx.3 +++ b/lib/libipx/ipx.3 @@ -33,7 +33,7 @@ .\" .Dd June 4, 1993 .Dt IPX 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm ipx_addr , .Nm ipx_ntoa diff --git a/lib/libkvm/kvm.3 b/lib/libkvm/kvm.3 index 5382ae3b7773..560f83d8a018 100644 --- a/lib/libkvm/kvm.3 +++ b/lib/libkvm/kvm.3 @@ -72,7 +72,9 @@ Accordingly, the generic portion of the interface (i.e., .Fn kvm_write , and .Fn kvm_nlist ) -has been incorporated into the BSD interface. Indeed, many kvm +has been incorporated into the +.Bx +interface. Indeed, many kvm applications (i.e., debuggers and statistical monitors) use only this subset of the interface. .Pp @@ -84,7 +86,9 @@ Finally, the Sun kvm error reporting semantics are poorly defined. The library can be configured either to print errors to stderr automatically, or to print no error messages at all. In the latter case, the nature of the error cannot be determined. -To overcome this, the BSD interface includes a +To overcome this, the +.Bx +interface includes a routine, .Xr kvm_geterr 3 , to return (not print out) the error message diff --git a/lib/libkvm/kvm_getswapinfo.3 b/lib/libkvm/kvm_getswapinfo.3 index a3c44c80bad4..21f988b5bf50 100644 --- a/lib/libkvm/kvm_getswapinfo.3 +++ b/lib/libkvm/kvm_getswapinfo.3 @@ -43,7 +43,7 @@ structure will be filled with the grand total over all swap devices. The grand total is calculated from all available swap devices whether or not you made room for them all in the array. -the grant total is returned. +The grand total is returned. .Pp The flags argument is currently unused and must be passed as 0. .Pp diff --git a/lib/libkvm/kvm_open.3 b/lib/libkvm/kvm_open.3 index c22c49cd8872..b3b0441c2bc9 100644 --- a/lib/libkvm/kvm_open.3 +++ b/lib/libkvm/kvm_open.3 @@ -131,7 +131,9 @@ call. .Pp The .Fn kvm_openfiles -function provides BSD style error reporting. +function provides +.Bx +style error reporting. Here, error messages are not printed out by the library. Instead, the application obtains the error message corresponding to the most recent kvm library call using @@ -174,7 +176,9 @@ function returns 0 on success and -1 on failure. .Sh BUGS There should not be two open calls. The ill-defined error semantics of the Sun library and the desire to have a backward-compatible library -for BSD left little choice. +for +.Bx +left little choice. .Sh SEE ALSO .Xr open 2 , .Xr kvm 3 , diff --git a/lib/libm/common_source/acosh.3 b/lib/libm/common_source/acosh.3 index 37a0e1a0fa78..495f3d7bdb9c 100644 --- a/lib/libm/common_source/acosh.3 +++ b/lib/libm/common_source/acosh.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt ACOSH 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm acosh .Nd inverse hyperbolic cosine function diff --git a/lib/libm/common_source/asin.3 b/lib/libm/common_source/asin.3 index fe6184b9d58f..a1571abac47e 100644 --- a/lib/libm/common_source/asin.3 +++ b/lib/libm/common_source/asin.3 @@ -62,7 +62,7 @@ function returns the arc sine in the range radians. On the .Tn VAX , -and Tahoe , +and Tahoe, if: .Bd -unfilled -offset indent .Pf \&| Ns Ar x Ns \&| > 1 diff --git a/lib/libm/common_source/asinh.3 b/lib/libm/common_source/asinh.3 index b44b640ac24f..7266dade40d6 100644 --- a/lib/libm/common_source/asinh.3 +++ b/lib/libm/common_source/asinh.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt ASINH 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm asinh .Nd inverse hyperbolic sine function diff --git a/lib/libm/common_source/atanh.3 b/lib/libm/common_source/atanh.3 index 25bdd4d9fcb4..db67a382bd39 100644 --- a/lib/libm/common_source/atanh.3 +++ b/lib/libm/common_source/atanh.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt ATANH 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm atanh .Nd inverse hyperbolic tangent function diff --git a/lib/libm/common_source/erf.3 b/lib/libm/common_source/erf.3 index 2b4b90295f12..d0f407188183 100644 --- a/lib/libm/common_source/erf.3 +++ b/lib/libm/common_source/erf.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt ERF 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm erf , .Nm erfc diff --git a/lib/libm/common_source/exp.3 b/lib/libm/common_source/exp.3 index ab37be32154a..842b72c54429 100644 --- a/lib/libm/common_source/exp.3 +++ b/lib/libm/common_source/exp.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt EXP 3 -.Os BSD 4 +.Os .Sh NAME .Nm exp , .Nm expm1 , @@ -150,8 +150,9 @@ and .Fn pow detect if the computed value will overflow, set the global variable -.Va errno to -.Er RANGE +.Va errno +to +.Er ERANGE and cause a reserved operand fault on a .Tn VAX or diff --git a/lib/libm/common_source/hypot.3 b/lib/libm/common_source/hypot.3 index 2f77bb0462a8..7c1b14aecc27 100644 --- a/lib/libm/common_source/hypot.3 +++ b/lib/libm/common_source/hypot.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt HYPOT 3 -.Os BSD 4 +.Os .Sh NAME .Nm hypot , .Nm cabs diff --git a/lib/libm/common_source/ieee.3 b/lib/libm/common_source/ieee.3 index d70233d0ff30..c0e04740f551 100644 --- a/lib/libm/common_source/ieee.3 +++ b/lib/libm/common_source/ieee.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt IEEE 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm copysign , .Nm drem , diff --git a/lib/libm/common_source/infnan.3 b/lib/libm/common_source/infnan.3 index 5baaad7dba29..1b6927eb2cfa 100644 --- a/lib/libm/common_source/infnan.3 +++ b/lib/libm/common_source/infnan.3 @@ -34,7 +34,7 @@ .\" .Dd June 4, 1993 .Dt INFNAN 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm infnan .Nd signals invalid floating\-point operations on a @@ -99,7 +99,7 @@ variable .Va errno , and allows computation to resume. Alternatively, the Reserved Operand Fault Handler could be -changed to respond by returning that plausible value, etc. +changed to respond by returning that plausible value, etc.\& instead of aborting. .Pp In the table below, the first two columns show various @@ -157,7 +157,7 @@ int iarg ; .Sh SEE ALSO .Xr intro 2 , .Xr math 3 , -.Xr signal 3 . +.Xr signal 3 .Pp .Er ERANGE and diff --git a/lib/libm/common_source/j0.3 b/lib/libm/common_source/j0.3 index 2234a4cef9f5..5bfb9a7b6087 100644 --- a/lib/libm/common_source/j0.3 +++ b/lib/libm/common_source/j0.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1994 .Dt J0 3 -.Os BSD 4 +.Os .Sh NAME .Nm j0 , .Nm j1 , diff --git a/lib/libm/common_source/lgamma.3 b/lib/libm/common_source/lgamma.3 index 505eb8ad1b48..24f769e24faf 100644 --- a/lib/libm/common_source/lgamma.3 +++ b/lib/libm/common_source/lgamma.3 @@ -34,7 +34,7 @@ .\" .Dd December 11, 1993 .Dt LGAMMA 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm lgamma .Nm gamma diff --git a/lib/libmd/mdX.3 b/lib/libmd/mdX.3 index 3b685883262c..0830e90cda82 100644 --- a/lib/libmd/mdX.3 +++ b/lib/libmd/mdX.3 @@ -10,7 +10,7 @@ .\" .Dd February 11, 1999 .Dt MDX 3 -.Os FreeBSD +.Os .Sh NAME .Nm MDXInit , .Nm MDXUpdate , @@ -99,7 +99,7 @@ When using or .Fn MDXData , the -.Ar buf +.Fa buf argument can be a null pointer, in which case the returned string is allocated with .Xr malloc 3 @@ -107,7 +107,7 @@ and subsequently must be explicitly deallocated using .Xr free 3 after use. If the -.Ar buf +.Fa buf argument is non-null it must point to at least 33 characters of buffer space. .Sh SEE ALSO .Xr md2 3 , diff --git a/lib/libmd/ripemd.3 b/lib/libmd/ripemd.3 index 9cbddd198ddc..ef8a273311d3 100644 --- a/lib/libmd/ripemd.3 +++ b/lib/libmd/ripemd.3 @@ -11,7 +11,7 @@ .\" .Dd February 26, 1999 .Dt RIPEMD 3 -.Os FreeBSD +.Os .Sh NAME .Nm RIPEMD160_Init , .Nm RIPEMD160_Update , @@ -83,7 +83,7 @@ When using or .Fn RIPEMD160_Data , the -.Ar buf +.Fa buf argument can be a null pointer, in which case the returned string is allocated with .Xr malloc 3 @@ -91,7 +91,7 @@ and subsequently must be explicitly deallocated using .Xr free 3 after use. If the -.Ar buf +.Fa buf argument is non-null it must point to at least 41 characters of buffer space. .Sh SEE ALSO .Xr md2 3 , diff --git a/lib/libmd/sha.3 b/lib/libmd/sha.3 index 7b3a5377f534..3f6e1de684d6 100644 --- a/lib/libmd/sha.3 +++ b/lib/libmd/sha.3 @@ -11,7 +11,7 @@ .\" .Dd February 25, 1999 .Dt SHA 3 -.Os FreeBSD +.Os .Sh NAME .Nm SHA_Init , .Nm SHA_Update , @@ -68,7 +68,8 @@ a ``fingerprint'' of the input-data, which doesn't disclose the actual input. .Pp .Tn SHA -.Pq \&or Tn SHA-0 +(or +.Tn SHA-0 ) is the original Secure Hash Algorithm specified in .Tn FIPS 160. It was quickly proven insecure, and has been superseded by @@ -112,7 +113,7 @@ When using or .Fn SHA1_Data , the -.Ar buf +.Fa buf argument can be a null pointer, in which case the returned string is allocated with .Xr malloc 3 @@ -120,7 +121,7 @@ and subsequently must be explicitly deallocated using .Xr free 3 after use. If the -.Ar buf +.Fa buf argument is non-null it must point to at least 41 characters of buffer space. .Sh SEE ALSO .Xr md2 3 , diff --git a/lib/libnetgraph/netgraph.3 b/lib/libnetgraph/netgraph.3 index f7ee37817735..feff469bde33 100644 --- a/lib/libnetgraph/netgraph.3 +++ b/lib/libnetgraph/netgraph.3 @@ -37,7 +37,7 @@ .\" .Dd January 19, 1999 .Dt NETGRAPH 3 -.Os FreeBSD +.Os .Sh NAME .Nm NgMkSockNode , .Nm NgNameNode , @@ -281,12 +281,12 @@ control message parse error or illegal value. ASCII control message array or fixed width string buffer overflow. .El .Sh SEE ALSO -.Xr socket 2 , .Xr select 2 , +.Xr socket 2 , .Xr warnx 3 , +.Xr kld 4 , .Xr netgraph 4 , -.Xr ng_socket 4 , -.Xr kld 4 +.Xr ng_socket 4 .Sh HISTORY The .Nm netgraph diff --git a/lib/libpam/modules/pam_radius/pam_radius.8 b/lib/libpam/modules/pam_radius/pam_radius.8 index a36e66e96e3c..d70467458162 100644 --- a/lib/libpam/modules/pam_radius/pam_radius.8 +++ b/lib/libpam/modules/pam_radius/pam_radius.8 @@ -39,8 +39,8 @@ .\" $FreeBSD$ .\" .Dd August 2, 1999 -.Dt pam_radius 8 -.Os FreeBSD +.Dt PAM_RADIUS 8 +.Os .Sh NAME .Nm pam_radius .Nd RADIUS authentication PAM module @@ -106,9 +106,9 @@ The standard RADIUS client configuration file for .Nm .El .Sh SEE ALSO -.Xr pam 8 , .Xr passwd 5 , -.Xr radius.conf 5 +.Xr radius.conf 5 , +.Xr pam 8 .Sh HISTORY The .Nm diff --git a/lib/libradius/libradius.3 b/lib/libradius/libradius.3 index 56ee09da0cc3..7f55a3a044e3 100644 --- a/lib/libradius/libradius.3 +++ b/lib/libradius/libradius.3 @@ -26,7 +26,7 @@ .\" .Dd October 30, 1999 .Dt LIBRADIUS 3 -.Os FreeBSD +.Os .Sh NAME .Nm libradius .Nd RADIUS client library diff --git a/lib/libradius/radius.conf.5 b/lib/libradius/radius.conf.5 index 4ad3f8a7e5a7..d5ef42de752d 100644 --- a/lib/libradius/radius.conf.5 +++ b/lib/libradius/radius.conf.5 @@ -26,7 +26,7 @@ .\" .Dd October 30, 1999 .Dt RADIUS.CONF 5 -.Os FreeBSD +.Os .Sh NAME .Nm radius.conf .Nd RADIUS client configuration file diff --git a/lib/libstand/libstand.3 b/lib/libstand/libstand.3 index ab1cf254f5d8..dba6ef7fe6f7 100644 --- a/lib/libstand/libstand.3 +++ b/lib/libstand/libstand.3 @@ -26,7 +26,7 @@ .\" .Dd June 22, 1998 .Dt LIBSTAND 3 -.Os FreeBSD +.Os .Sh NAME .Nm libstand .Nd support library for standalone executables @@ -35,7 +35,9 @@ .Sh DESCRIPTION .Nm provides a set of supporting functions for standalone -applications, mimicking where possible the standard BSD programming +applications, mimicking where possible the standard +.Bx +programming environment. The following sections group these functions by kind. Unless specifically described here, see the corresponding section 3 manpages for the given functions. @@ -573,7 +575,9 @@ structures. The following filesystem handlers are supplied by the consumer may supply other filesystems of their own: .Bl -hang -width "cd9660_fsops " .It ufs_fsops -The BSD UFS. +The +.Bx +UFS. .It ext2fs_fsops Linux ext2fs filesystem. .It tftp_fsops @@ -631,4 +635,4 @@ from The reorganisation and port to .Fx 3.0 , the environment functions and this manpage were written by -.An Mike Smith Aq msmith@freebsd.org . +.An Mike Smith Aq msmith@FreeBSD.org . diff --git a/lib/libtacplus/libtacplus.3 b/lib/libtacplus/libtacplus.3 index 97552252ed12..ccea628dc7fb 100644 --- a/lib/libtacplus/libtacplus.3 +++ b/lib/libtacplus/libtacplus.3 @@ -26,7 +26,7 @@ .\" .Dd September 2, 1998 .Dt LIBTACPLUS 3 -.Os FreeBSD +.Os .Sh NAME .Nm libtacplus .Nd TACACS+ client library diff --git a/lib/libtacplus/tacplus.conf.5 b/lib/libtacplus/tacplus.conf.5 index 315c06572b8c..be7af6133807 100644 --- a/lib/libtacplus/tacplus.conf.5 +++ b/lib/libtacplus/tacplus.conf.5 @@ -26,7 +26,7 @@ .\" .Dd July 29, 1998 .Dt TACPLUS.CONF 5 -.Os FreeBSD +.Os .Sh NAME .Nm tacplus.conf .Nd TACACS+ client configuration file diff --git a/lib/libutil/_secure_path.3 b/lib/libutil/_secure_path.3 index d4e316fed134..082328d9bcc3 100644 --- a/lib/libutil/_secure_path.3 +++ b/lib/libutil/_secure_path.3 @@ -20,7 +20,7 @@ .\" $FreeBSD$ .\" .Dd May 2, 1997 -.Os FreeBSD +.Os .Dt _SECURE_PATH 3 .Sh NAME .Nm _secure_path diff --git a/lib/libutil/auth.conf.5 b/lib/libutil/auth.conf.5 index eb892c6fd616..df1e8f9969ba 100644 --- a/lib/libutil/auth.conf.5 +++ b/lib/libutil/auth.conf.5 @@ -15,7 +15,7 @@ .\" .Dd October 7, 1998 .Dt AUTH.CONF 5 -.Os FreeBSD +.Os .Sh NAME .Nm auth.conf .Nd authentication capability database diff --git a/lib/libutil/login.conf.5 b/lib/libutil/login.conf.5 index a6619ec2c444..37580b6f5700 100644 --- a/lib/libutil/login.conf.5 +++ b/lib/libutil/login.conf.5 @@ -21,7 +21,7 @@ .\" .Dd November 22, 1996 .Dt LOGIN.CONF 5 -.Os FreeBSD +.Os .Sh NAME .Nm login.conf .Nd login class capability database diff --git a/lib/libutil/login_auth.3 b/lib/libutil/login_auth.3 index f9db7ab91096..0144f5c9e3be 100644 --- a/lib/libutil/login_auth.3 +++ b/lib/libutil/login_auth.3 @@ -20,7 +20,7 @@ .\" $FreeBSD$ .\" .Dd December 29, 1996 -.Os FreeBSD +.Os .Dt LOGIN_AUTH 3 .Sh NAME .\" .Nm authenticate @@ -33,7 +33,7 @@ .\" .Nm auth_ttyok .\" .Nm auth_hostok .\" .Nm auth_timesok -.Nd authentication style support library for login class capabilities database. +.Nd "authentication style support library for login class capabilities database" .Sh LIBRARY .Lb libutil .Sh SYNOPSIS diff --git a/lib/libutil/login_cap.3 b/lib/libutil/login_cap.3 index 7f771714834a..12f6412809e0 100644 --- a/lib/libutil/login_cap.3 +++ b/lib/libutil/login_cap.3 @@ -20,7 +20,7 @@ .\" $FreeBSD$ .\" .Dd December 27, 1996 -.Os FreeBSD +.Os .Dt LOGIN_CAP 3 .Sh NAME .Nm login_close , @@ -36,7 +36,7 @@ .Nm login_getstyle , .Nm login_getuserclass , .Nm login_setcryptfmt -.Nd functions for accessing the login class capabilities database. +.Nd "functions for accessing the login class capabilities database" .Sh LIBRARY .Lb libutil .Sh SYNOPSIS diff --git a/lib/libutil/login_class.3 b/lib/libutil/login_class.3 index 72848839c1b1..16f994e7adaf 100644 --- a/lib/libutil/login_class.3 +++ b/lib/libutil/login_class.3 @@ -20,14 +20,14 @@ .\" $FreeBSD$ .\" .Dd December 28, 1996 -.Os FreeBSD +.Os .Dt LOGIN_CLASS 3 .Sh NAME .Nm setclasscontext , .Nm setclassenvironment , .Nm setclassresources , .Nm setusercontext -.Nd functions for using the login class capabilities database. +.Nd "functions for using the login class capabilities database" .Sh LIBRARY .Lb libutil .Sh SYNOPSIS diff --git a/lib/libutil/login_ok.3 b/lib/libutil/login_ok.3 index 4d1bab63d5f3..188f00c9c44b 100644 --- a/lib/libutil/login_ok.3 +++ b/lib/libutil/login_ok.3 @@ -20,7 +20,7 @@ .\" $FreeBSD$ .\" .Dd January 2, 1997 -.Os FreeBSD +.Os .Dt LOGIN_OK 3 .Sh NAME .Nm auth_ttyok , @@ -93,7 +93,7 @@ is in its canonical form. No hostname or address lookups are attempted. .Pp It is possible to call this function with either the hostname or -the IP address missing (i.e. +the IP address missing (i.e.\& .Dv NULL ) and matching will be performed only on the basis of the parameter given. diff --git a/lib/libutil/login_times.3 b/lib/libutil/login_times.3 index 11a3e7d53d4f..28afbfaa590f 100644 --- a/lib/libutil/login_times.3 +++ b/lib/libutil/login_times.3 @@ -20,7 +20,7 @@ .\" $FreeBSD$ .\" .Dd January 2, 1997 -.Os FreeBSD +.Os .Dt LOGIN_TIMES 3 .Sh NAME .Nm parse_lt , diff --git a/lib/libvgl/vgl.3 b/lib/libvgl/vgl.3 index e3e1edf9a0cc..54386f152e47 100644 --- a/lib/libvgl/vgl.3 +++ b/lib/libvgl/vgl.3 @@ -11,7 +11,7 @@ .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products -.\" derived from this software withough specific prior written permission. +.\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES @@ -27,7 +27,7 @@ .\" $FreeBSD$ .Dd November 7, 1999 .Dt VGL 3 -.Os FreeBSD +.Os .Sh NAME .Nm VGLBitmapAllocateBits , .Nm VGLBitmapCopy , @@ -402,9 +402,10 @@ must be Passing a in-memory bitmap to this function results in error. .Pp .Fn VGLBlankDisplay -blank the display if the argment +blank the display if the argument .Va blank -!= 0. This can be done to shut off the screen during display updates that +\*(Ne 0. +This can be done to shut off the screen during display updates that the user should first see when it's done. .Ss Program termination and signal processing It is important to call @@ -426,7 +427,7 @@ have a flag to indicate signal's delivery. Your signal handlers set this flag but do not terminate the program immediately. The main part of the program checks the flag to see if it is -supporsed to terminate, and call +supposed to terminate, and calls .Fn VGLEnd and .Xr exit 3 diff --git a/lib/msun/man/acosh.3 b/lib/msun/man/acosh.3 index 0a4982ef6ed4..1b423abc8358 100644 --- a/lib/msun/man/acosh.3 +++ b/lib/msun/man/acosh.3 @@ -34,7 +34,7 @@ .\" .Dd May 6, 1991 .Dt ACOSH 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm acosh , .Nm acoshf diff --git a/lib/msun/man/asin.3 b/lib/msun/man/asin.3 index 6515fbdfc47a..3bb80611b02b 100644 --- a/lib/msun/man/asin.3 +++ b/lib/msun/man/asin.3 @@ -67,7 +67,7 @@ functions return the arc sine in the range radians. On the .Tn VAX , -and Tahoe , +and Tahoe, if: .Bd -unfilled -offset indent .Pf \&| Ns Ar x Ns \&| > 1 diff --git a/lib/msun/man/asinh.3 b/lib/msun/man/asinh.3 index 73de4f71c5f9..09450f97f6b6 100644 --- a/lib/msun/man/asinh.3 +++ b/lib/msun/man/asinh.3 @@ -34,7 +34,7 @@ .\" .Dd May 6, 1991 .Dt ASINH 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm asinh , .Nm asinhf diff --git a/lib/msun/man/atanh.3 b/lib/msun/man/atanh.3 index 528b6b5ca929..bff082b84f6f 100644 --- a/lib/msun/man/atanh.3 +++ b/lib/msun/man/atanh.3 @@ -34,7 +34,7 @@ .\" .Dd May 6, 1991 .Dt ATANH 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm atanh , .Nm atanhf diff --git a/lib/msun/man/erf.3 b/lib/msun/man/erf.3 index 2046a6ddc5e6..6157fd8864c9 100644 --- a/lib/msun/man/erf.3 +++ b/lib/msun/man/erf.3 @@ -34,7 +34,7 @@ .\" .Dd April 20, 1991 .Dt ERF 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm erf , .Nm erff , diff --git a/lib/msun/man/exp.3 b/lib/msun/man/exp.3 index 86d1fd81880e..3ba89f479551 100644 --- a/lib/msun/man/exp.3 +++ b/lib/msun/man/exp.3 @@ -34,7 +34,7 @@ .\" .Dd July 31, 1991 .Dt EXP 3 -.Os BSD 4 +.Os .Sh NAME .Nm exp , .Nm expf , @@ -187,7 +187,8 @@ The functions .Fn pow detect if the computed value will overflow, set the global variable -.Va errno to +.Va errno +to .Er ERANGE and cause a reserved operand fault on a .Tn VAX diff --git a/lib/msun/man/hypot.3 b/lib/msun/man/hypot.3 index a139e3931e45..951e25355f6e 100644 --- a/lib/msun/man/hypot.3 +++ b/lib/msun/man/hypot.3 @@ -34,7 +34,7 @@ .\" .Dd May 6, 1991 .Dt HYPOT 3 -.Os BSD 4 +.Os .Sh NAME .Nm hypot , .Nm hypotf , diff --git a/lib/msun/man/ieee.3 b/lib/msun/man/ieee.3 index fb4001ca4364..f0186e204842 100644 --- a/lib/msun/man/ieee.3 +++ b/lib/msun/man/ieee.3 @@ -48,7 +48,7 @@ .Nm remainderf , .Nm scalbn , .Nm scalbnf -.Nd Functions for IEEE arithmetic +.Nd functions for IEEE arithmetic .Sh SYNOPSIS .Fd #include <math.h> .Ft double diff --git a/lib/msun/man/ieee_test.3 b/lib/msun/man/ieee_test.3 index be27dfc52972..84f78a5341b8 100644 --- a/lib/msun/man/ieee_test.3 +++ b/lib/msun/man/ieee_test.3 @@ -34,7 +34,7 @@ .\" .Dd March 10, 1994 .Dt IEEE_TEST 3 -.Os +.Os .Sh NAME .Nm logb , .Nm logbf , diff --git a/lib/msun/man/j0.3 b/lib/msun/man/j0.3 index 8a21644e1b9b..dfd58b7ddee1 100644 --- a/lib/msun/man/j0.3 +++ b/lib/msun/man/j0.3 @@ -34,7 +34,7 @@ .\" .Dd April 19, 1991 .Dt J0 3 -.Os BSD 4 +.Os .Sh NAME .Nm j0 , .Nm j0f , diff --git a/lib/msun/man/lgamma.3 b/lib/msun/man/lgamma.3 index a34fe0fc4482..0b7e31b66bbf 100644 --- a/lib/msun/man/lgamma.3 +++ b/lib/msun/man/lgamma.3 @@ -34,7 +34,7 @@ .\" .Dd December 3, 1992 .Dt LGAMMA 3 -.Os BSD 4.3 +.Os .Sh NAME .Nm lgamma , .Nm lgammaf , |