diff options
Diffstat (limited to 'lib/libc/sys')
70 files changed, 167 insertions, 139 deletions
diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2 index a31c5d5e9155..b402686e53fa 100644 --- a/lib/libc/sys/acct.2 +++ b/lib/libc/sys/acct.2 @@ -112,4 +112,5 @@ An I/O error occurred while reading from or writing to the file system. .Sh HISTORY An .Fn acct -function call appeared in Version 7 AT&T UNIX. +function call appeared in +.At v7 . diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2 index c05396b0b988..6cc0228cfa11 100644 --- a/lib/libc/sys/brk.2 +++ b/lib/libc/sys/brk.2 @@ -143,4 +143,5 @@ the data segment without consulting .Sh HISTORY A .Fn brk -function call appeared in Version 7 AT&T UNIX. +function call appeared in +.At v7 . diff --git a/lib/libc/sys/chflags.2 b/lib/libc/sys/chflags.2 index 848185136626..cd99deabcb53 100644 --- a/lib/libc/sys/chflags.2 +++ b/lib/libc/sys/chflags.2 @@ -151,4 +151,5 @@ The .Nm chflags and .Nm fchflags -functions first appeared in 4.4BSD. +functions first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/fsync.2 b/lib/libc/sys/fsync.2 index 313b4c7a7116..74105ecf3729 100644 --- a/lib/libc/sys/fsync.2 +++ b/lib/libc/sys/fsync.2 @@ -98,6 +98,6 @@ An I/O error occurred while reading from or writing to the file system. .Xr sync 8 .Sh HISTORY The -.Nm +.Fn fsync function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2 index b0ecd92287c7..af1ca7a17e65 100644 --- a/lib/libc/sys/getdirentries.2 +++ b/lib/libc/sys/getdirentries.2 @@ -170,5 +170,6 @@ error occurred while reading from or writing to the file system. .Xr lseek 2 .Sh HISTORY The -.Nm getdirentries -function first appeared in 4.4BSD. +.Fn getdirentries +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/getfh.2 b/lib/libc/sys/getfh.2 index e881066096b4..33ad1f75a04a 100644 --- a/lib/libc/sys/getfh.2 +++ b/lib/libc/sys/getfh.2 @@ -91,6 +91,7 @@ error occurred while reading from or writing to the file system. .El .Sh HISTORY The -.Nm getfh +.Fn getfh function -first appeared in 4.4BSD. +first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/getfsstat.2 b/lib/libc/sys/getfsstat.2 index 9d2a0d78a917..7679f9eb5403 100644 --- a/lib/libc/sys/getfsstat.2 +++ b/lib/libc/sys/getfsstat.2 @@ -131,5 +131,6 @@ error occurred while reading from or writing to the filesystem. .Xr mount 8 .Sh HISTORY The -.Nm getfsstat -function first appeared in 4.4BSD. +.Fn getfsstat +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/getgroups.2 b/lib/libc/sys/getgroups.2 index 1428d832a34d..ea73890db9ce 100644 --- a/lib/libc/sys/getgroups.2 +++ b/lib/libc/sys/getgroups.2 @@ -85,6 +85,6 @@ an invalid address. .Xr initgroups 3 .Sh HISTORY The -.Nm +.Fn getgroups function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index 5d94d72dd275..4e531885c571 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -162,6 +162,6 @@ to be handled. .Xr clocks 7 .Sh HISTORY The -.Nm +.Fn getitimer function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2 index b0c6f1bb1483..4676714fa4b1 100644 --- a/lib/libc/sys/getlogin.2 +++ b/lib/libc/sys/getlogin.2 @@ -168,4 +168,5 @@ Portable programs should probably still make this check. .Sh HISTORY The .Fn getlogin -function first appeared in 4.4BSD. +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/getpeername.2 b/lib/libc/sys/getpeername.2 index 99672947b2a5..372d85afdece 100644 --- a/lib/libc/sys/getpeername.2 +++ b/lib/libc/sys/getpeername.2 @@ -108,6 +108,6 @@ process address space. .Xr getsockname 2 .Sh HISTORY The -.Nm +.Fn getpeername function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/getpgrp.2 b/lib/libc/sys/getpgrp.2 index b98f499997d2..13b79884dbc0 100644 --- a/lib/libc/sys/getpgrp.2 +++ b/lib/libc/sys/getpgrp.2 @@ -67,7 +67,7 @@ are used to get/set the process group of the control terminal. .Xr termios 4 .Sh HISTORY The -.Nm +.Fn getpgrp function call appeared in .Bx 4.0 . .Sh STANDARDS @@ -88,14 +88,17 @@ From the .St -p1003.1-88 Rationale: .sp -4.3BSD provides a +.Bx 4.3 +provides a .Fn getpgrp function that returns the process group ID for a specified process. Although this function is used to support job control, all known job-control shells always specify the calling process with this function. -Thus, the simpler System V +Thus, the simpler +.At V .Fn getpgrp -suffices, and the added complexity of the 4.3BSD +suffices, and the added complexity of the +.Bx 4.3 .Fn getpgrp has been omitted from POSIX.1. diff --git a/lib/libc/sys/getpriority.2 b/lib/libc/sys/getpriority.2 index aa151a0d8afa..fdb0a1e1b49b 100644 --- a/lib/libc/sys/getpriority.2 +++ b/lib/libc/sys/getpriority.2 @@ -137,6 +137,6 @@ A non super-user attempted to lower a process priority. .Xr renice 8 .Sh HISTORY The -.Nm +.Fn getpriority function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/getrlimit.2 b/lib/libc/sys/getrlimit.2 index 42b9028dada9..14c0d56aaf46 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -178,6 +178,6 @@ raised the maximum limit value, and the caller is not the super-user. .Xr sysctl 3 .Sh HISTORY The -.Nm +.Fn getrlimit function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2 index 1a80b9cf15c7..7219304fb6ab 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -164,6 +164,6 @@ There is no way to obtain information about a child process that has not yet terminated. .Sh HISTORY The -.Nm +.Fn getrusage function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2 index a5c75884e1b9..c8d761f0b5de 100644 --- a/lib/libc/sys/getsockname.2 +++ b/lib/libc/sys/getsockname.2 @@ -106,6 +106,6 @@ Names bound to sockets in the UNIX domain are inaccessible; returns a zero length name. .Sh HISTORY The -.Nm +.Fn getsockname function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index 55098bc413fa..3335b0c5f93d 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" @(#)getsockopt.2 8.3 (Berkeley) 4/19/94 -.\" $Id: getsockopt.2,v 1.4 1996/02/11 22:34:21 mpp Exp $ +.\" $Id: getsockopt.2,v 1.5 1996/03/27 20:48:59 mpp Exp $ .\" .Dd November 3, 1995 .Dt GETSOCKOPT 2 @@ -392,6 +392,6 @@ is not in a valid part of the process address space. Several of the socket options should be handled at lower levels of the system. .Sh HISTORY The -.Nm +.Fn getsockopt system call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/gettimeofday.2 b/lib/libc/sys/gettimeofday.2 index a63f526ae428..138c221918d8 100644 --- a/lib/libc/sys/gettimeofday.2 +++ b/lib/libc/sys/gettimeofday.2 @@ -115,6 +115,6 @@ A user other than the super-user attempted to set the time. .Xr timed 8 .Sh HISTORY The -.Nm +.Fn gettimeofday function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/ioctl.2 b/lib/libc/sys/ioctl.2 index 38c58b9dcf59..f848938c5919 100644 --- a/lib/libc/sys/ioctl.2 +++ b/lib/libc/sys/ioctl.2 @@ -124,5 +124,6 @@ is not valid. .Xr intro 4 .Sh HISTORY An -.Nm -function call appeared in Version 7 AT&T UNIX. +.Fn ioctl +function call appeared in +.At v7 . diff --git a/lib/libc/sys/link.2 b/lib/libc/sys/link.2 index 4c27ab9765ac..e535e5b60de4 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -150,7 +150,7 @@ conform to IEEE Std 1003.1-1988 .Sh HISTORY .Pp The -.Nm +.Fn link system call traditionally allows the super-user to link directories which corrupts the filesystem coherency. This implementation no longer permits it. diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2 index d4b600ca677b..65f888d42613 100644 --- a/lib/libc/sys/listen.2 +++ b/lib/libc/sys/listen.2 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)listen.2 8.2 (Berkeley) 12/11/93 -.\" $Id: listen.2,v 1.5 1996/02/11 22:34:24 mpp Exp $ +.\" $Id: listen.2,v 1.6 1996/05/23 01:05:25 mpp Exp $ .\" .Dd November 3, 1995 .Dt LISTEN 2 @@ -130,7 +130,7 @@ The socket is not of a type that supports the operation .Xr sysctl 8 .Sh HISTORY The -.Nm +.Fn listen function call appeared in .Bx 4.2 . The ability to configure the maximum diff --git a/lib/libc/sys/madvise.2 b/lib/libc/sys/madvise.2 index a100cb964220..aa9d6881d21d 100644 --- a/lib/libc/sys/madvise.2 +++ b/lib/libc/sys/madvise.2 @@ -98,5 +98,6 @@ modified again. .Sh HISTORY The -.Nm madvise -function first appeared in 4.4BSD. +.Fn madvise +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/mincore.2 b/lib/libc/sys/mincore.2 index a51fcc9fc464..3341175cff70 100644 --- a/lib/libc/sys/mincore.2 +++ b/lib/libc/sys/mincore.2 @@ -60,4 +60,5 @@ that the page is in-core. .Sh HISTORY The .Fn mincore -function first appeared in 4.4BSD. +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/mkfifo.2 b/lib/libc/sys/mkfifo.2 index 6f7686ebe3d7..79e5c5096118 100644 --- a/lib/libc/sys/mkfifo.2 +++ b/lib/libc/sys/mkfifo.2 @@ -119,6 +119,6 @@ points outside the process's allocated address space. .Xr umask 2 .Sh STANDARDS The -.Nm mkfifo +.Fn mkfifo function call conforms to .St -p1003.1-88 . diff --git a/lib/libc/sys/mknod.2 b/lib/libc/sys/mknod.2 index d77ccbcc7eff..63e7061da4f4 100644 --- a/lib/libc/sys/mknod.2 +++ b/lib/libc/sys/mknod.2 @@ -123,5 +123,6 @@ points outside the process's allocated address space. .Xr umask 2 .Sh HISTORY A -.Nm -function call appeared in Version 6 AT&T UNIX. +.Fn mknod +function call appeared in +.At v6 . diff --git a/lib/libc/sys/mlock.2 b/lib/libc/sys/mlock.2 index 90bb7c7d8e03..15ce741e0f10 100644 --- a/lib/libc/sys/mlock.2 +++ b/lib/libc/sys/mlock.2 @@ -47,7 +47,7 @@ .Fn munlock "caddr_t addr" "size_t len" .Sh DESCRIPTION The -.Nm mlock +.Fn mlock system call locks into memory the physical pages associated with the virtual address range starting at @@ -56,9 +56,9 @@ for .Fa len bytes. The -.Nm munlock +.Fn munlock call unlocks pages previously locked by one or more -.Nm mlock +.Fn mlock calls. For both, the .Fa addr @@ -70,7 +70,7 @@ to be so. The entire range must be allocated. .Pp After an -.Nm mlock +.Fn mlock call, the indicated pages will cause neither a non-resident page nor address-translation fault until they are unlocked. They may still cause protection-violation faults or TLB-miss faults on @@ -81,12 +81,12 @@ Multiple processes may have the same physical pages locked via their own virtual address mappings. A single process may likewise have pages multiply-locked via different virtual mappings of the same pages or via nested -.Nm mlock +.Fn mlock calls on the same address range. Unlocking is performed explicitly by -.Nm munlock +.Fn munlock or implicitly by a call to -.Nm munmap +.Fn munmap which deallocates the unmapped address range. Locked mappings are not inherited by the child process after a .Xr fork 2 . @@ -94,7 +94,7 @@ Locked mappings are not inherited by the child process after a Since physical memory is a potentially scarce resource, processes are limited in how much they can lock down. A single process can -.Nm mlock +.Fn mlock the minimum of a system-wide ``wired pages'' limit and the per-process @@ -138,11 +138,11 @@ Some portion of the indicated address range is not locked. .Xr getpagesize 3 .Sh BUGS Unlike The Sun implementation, multiple -.Nm mlock +.Fn mlock calls on the same address range require the corresponding number of -.Nm munlock +.Fn munlock calls to actually unlock the pages, i.e. -.Nm mlock +.Fn mlock nests. This should be considered a consequence of the implementation and not a feature. @@ -158,4 +158,5 @@ The .Fn mlock and .Fn munlock -functions first appeared in 4.4BSD. +functions first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index 2b87189dc723..d70d871ac54b 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -44,7 +44,7 @@ .Fn mmap "caddr_t addr" "size_t len" "int prot" "int flags" "int fd" "off_t offset" .Sh DESCRIPTION The -.Nm mmap +.Fn mmap function causes the pages starting at .Fa addr and continuing for at most @@ -113,7 +113,7 @@ region. Do not permit the system to select a different address than the one specified. If the specified address cannot be used, -.Nm mmap +.Fn mmap will fail. If MAP_FIXED is specified, .Fa addr @@ -147,7 +147,7 @@ the file descriptor argument specifies a file or device to which swapping should be done. .Sh RETURN VALUES Upon successful completion, -.Nm mmap +.Fn mmap returns a pointer to the mapped region. Otherwise, a value of -1 is returned and .Va errno diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index 6829a3e666b9..03879e1cd65a 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -165,14 +165,16 @@ and the variable .Va errno is set to indicate the error. .Pp -.Nm Umount -returns the value 0 if the umount succeeded; otherwise -1 is returned +The +.Fn umount +function returns the value 0 if the umount succeeded; otherwise -1 is returned and the variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Mount -will fail when one of the following occurs: +The +.Fn mount +function will fail when one of the following occurs: .Bl -tag -width [ENOTBLK] .It Bq Er EPERM The caller is not the super-user. @@ -269,8 +271,9 @@ cylinder group information. points outside the process's allocated address space. .El .Pp -.Nm Umount -may fail with one of the following errors: +The +.Fn umount +function may fail with one of the following errors: .Bl -tag -width [ENOTBLK] .It Bq Er EPERM The caller is not the super-user. @@ -311,4 +314,5 @@ Some of the error codes need translation to more obvious messages. .Fn Mount and .Fn umount -function calls appeared in Version 6 AT&T UNIX. +function calls appeared in +.At v6 . diff --git a/lib/libc/sys/mprotect.2 b/lib/libc/sys/mprotect.2 index 4ddd65d5e8ac..51d1b14c51e9 100644 --- a/lib/libc/sys/mprotect.2 +++ b/lib/libc/sys/mprotect.2 @@ -57,4 +57,5 @@ the granularity of protection changes may be as large as an entire region. .Sh HISTORY The .Fn mprotect -function first appeared in 4.4BSD. +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/msync.2 b/lib/libc/sys/msync.2 index 409dd08b35a2..388790f5838b 100644 --- a/lib/libc/sys/msync.2 +++ b/lib/libc/sys/msync.2 @@ -90,4 +90,5 @@ was both MS_ASYNC and MS_INVALIDATE. Only one of these flags is allowed. .Sh HISTORY The .Fn msync -function first appeared in 4.4BSD. +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/munmap.2 b/lib/libc/sys/munmap.2 index 5d14016e887d..ef6c7f99243a 100644 --- a/lib/libc/sys/munmap.2 +++ b/lib/libc/sys/munmap.2 @@ -50,7 +50,7 @@ and causes further references to addresses within the range to generate invalid memory references. .Sh RETURN VALUES Upon successful completion, -.Nm munmap +.Fn munmap returns zero. Otherwise, a value of -1 is returned and .Va errno @@ -77,4 +77,5 @@ valid address space. .Sh HISTORY The .Fn munmap -function first appeared in 4.4BSD. +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/nfssvc.2 b/lib/libc/sys/nfssvc.2 index 0c8038fb67d0..e113fd0a46e3 100644 --- a/lib/libc/sys/nfssvc.2 +++ b/lib/libc/sys/nfssvc.2 @@ -199,7 +199,7 @@ socket into the kernel for servicing by the daemons. .Sh RETURN VALUES Normally -.Nm nfssvc +.Fn nfssvc does not return unless the server is terminated by a signal when a value of 0 is returned. Otherwise, -1 is returned and the global variable @@ -220,11 +220,12 @@ The caller is not the super-user. .Xr nfsiod 8 .Sh HISTORY The -.Nm nfssvc -function first appeared in 4.4BSD. +.Fn nfssvc +function first appeared in +.Bx 4.4 . .Sh BUGS The -.Nm nfssvc +.Fn nfssvc system call is designed specifically for the .Tn NFS support daemons and as such is specific to their requirements. @@ -234,5 +235,5 @@ support, since is not really an error. Several fields of the argument structures are assumed to be valid and sometimes to be unchanged from a previous call, such that -.Nm nfssvc +.Fn nfssvc must be used with extreme care. diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index bb7526250cb4..ac5335a88d5a 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -208,7 +208,7 @@ special file, and the device associated with this special file does not exist. .It Bq Er EINTR The -.Nm +.Fn open operation was interrupted by a signal. .It Bq Er EOPNOTSUPP .Dv O_SHLOCK @@ -273,5 +273,6 @@ An attempt was made to open a socket (not currently implemented). .Xr umask 2 .Sh HISTORY An -.Nm -function call appeared in Version 6 AT&T UNIX. +.Fn open +function call appeared in +.At v6 . diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2 index 1b4fbc4362d6..f8500e3221be 100644 --- a/lib/libc/sys/pathconf.2 +++ b/lib/libc/sys/pathconf.2 @@ -55,12 +55,12 @@ value of a configurable system limit or option variable associated with a pathname or file descriptor. .Pp For -.Nm pathconf , +.Fn pathconf , the .Fa path argument is the name of a file or directory. For -.Nm fpathconf , +.Fn fpathconf , the .Fa fd argument is an open file descriptor. @@ -98,9 +98,9 @@ Returns the terminal character disabling value. .El .Sh RETURN VALUES If the call to -.Nm pathconf +.Fn pathconf or -.Nm fpathconf +.Fn fpathconf is not successful, \-1 is returned and .Va errno is set appropriately. @@ -111,9 +111,9 @@ is not modified. Otherwise, the current variable value is returned. .Sh ERRORS If any of the following conditions occur, the -.Nm pathconf +.Fn pathconf and -.Nm fpathconf +.Fn fpathconf functions shall return -1 and set .Va errno to the corresponding value. @@ -157,7 +157,8 @@ An I/O error occurred while reading from or writing to the file system. .Xr sysctl 3 .Sh HISTORY The -.Nm pathconf +.Fn pathconf and -.Nm fpathconf -functions first appeared in 4.4BSD. +.Fn fpathconf +functions first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/pipe.2 b/lib/libc/sys/pipe.2 index 480fb916fdd4..9a03c8448e45 100644 --- a/lib/libc/sys/pipe.2 +++ b/lib/libc/sys/pipe.2 @@ -113,7 +113,7 @@ space. .Xr socketpair 2 .Sh HISTORY A -.Nm +.Fn pipe function call appeared in Version 3 AT&T UNIX. .Pp Bidirectional pipes were first used on Unix System V release 4. diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index f40a0dee2d0b..31c7c77ce9b3 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -208,6 +208,6 @@ and .Xr getrlimit 2 . .Sh HISTORY The -.Nm quotactl +.Fn quotactl function call appeared in .Bx 4.3 Reno . diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2 index ea428fd47a12..a09cc374fcee 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -230,7 +230,6 @@ function call appeared in .Bx 4.2 . A -.Nm read -function call -appeared in -Version 6 AT&T UNIX. +.Fn read +function call appeared in +.At v6 . diff --git a/lib/libc/sys/readlink.2 b/lib/libc/sys/readlink.2 index 48271102bcde..da96ac1032ca 100644 --- a/lib/libc/sys/readlink.2 +++ b/lib/libc/sys/readlink.2 @@ -49,8 +49,9 @@ in the buffer .Fa buf , which has size .Fa bufsiz . -.Nm Readlink -does not append a +The +.Fn readlink +function does not append a .Dv NUL character to .Fa buf . @@ -91,6 +92,6 @@ extends outside the process's allocated address space. .Xr symlink 7 , .Sh HISTORY The -.Nm +.Fn readlink function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/reboot.2 b/lib/libc/sys/reboot.2 index d51468d8c358..1eda9b353223 100644 --- a/lib/libc/sys/reboot.2 +++ b/lib/libc/sys/reboot.2 @@ -155,6 +155,6 @@ nor .Dv RB_KDB . .Sh HISTORY The -.Nm +.Fn reboot function call appeared in .Bx 4.0 . diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index 9ed24a3756fa..02f841b383e7 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -258,6 +258,6 @@ address space. .Xr socket 2 .Sh HISTORY The -.Nm +.Fn recv function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/revoke.2 b/lib/libc/sys/revoke.2 index e7828744e0d5..93dfdee57bc5 100644 --- a/lib/libc/sys/revoke.2 +++ b/lib/libc/sys/revoke.2 @@ -45,7 +45,7 @@ .Fn revoke "char *path" .Sh DESCRIPTION The -.Nm revoke +.Fn revoke function invalidates all current open file descriptors in the system for the file named by .Fa path . @@ -63,7 +63,7 @@ is called as if all open references to the file had been closed. .Pp Access to a file may be revoked only by its owner or the super user. The -.Nm revoke +.Fn revoke function is currently supported only for block and character special device files. It is normally used to prepare a terminal device for a new login session, @@ -100,6 +100,6 @@ The caller is neither the owner of the file nor the super user. .Xr close 2 .Sh HISTORY The -.Nm revoke +.Fn revoke function was introduced in .Bx 4.3 Reno . diff --git a/lib/libc/sys/rmdir.2 b/lib/libc/sys/rmdir.2 index 29f8833a47e0..3697bf4a62ee 100644 --- a/lib/libc/sys/rmdir.2 +++ b/lib/libc/sys/rmdir.2 @@ -101,6 +101,6 @@ points outside the process's allocated address space. .Xr unlink 2 .Sh HISTORY The -.Nm +.Fn rmdir function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2 index a178a0147104..e42553fe0b71 100644 --- a/lib/libc/sys/select.2 +++ b/lib/libc/sys/select.2 @@ -186,6 +186,6 @@ by the call. .Sh HISTORY The -.Nm +.Fn select function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2 index 77e2ed88df25..e39f5c031734 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)send.2 8.2 (Berkeley) 2/21/94 -.\" $Id$ +.\" $Id: send.2,v 1.2 1995/02/15 22:53:02 wollman Exp $ .\" .Dd February 15, 1995 .Dt SEND 2 @@ -174,6 +174,6 @@ but may be caused by transient congestion. .Xr write 2 .Sh HISTORY The -.Nm +.Fn send function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/setgroups.2 b/lib/libc/sys/setgroups.2 index e20b47e6ac77..bce9e1a88b90 100644 --- a/lib/libc/sys/setgroups.2 +++ b/lib/libc/sys/setgroups.2 @@ -78,6 +78,6 @@ address space. .Xr initgroups 3 .Sh HISTORY The -.Nm +.Fn setgroups function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/setregid.2 b/lib/libc/sys/setregid.2 index e890a98c45f2..787dd1192a9b 100644 --- a/lib/libc/sys/setregid.2 +++ b/lib/libc/sys/setregid.2 @@ -86,6 +86,6 @@ was specified. .Xr setuid 2 .Sh HISTORY The -.Nm +.Fn setregid system call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/setreuid.2 b/lib/libc/sys/setreuid.2 index 12af3ca21418..9d9402cf3625 100644 --- a/lib/libc/sys/setreuid.2 +++ b/lib/libc/sys/setreuid.2 @@ -84,6 +84,6 @@ was specified. .Xr setuid 2 .Sh HISTORY The -.Nm +.Fn setreuid system call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/setsid.2 b/lib/libc/sys/setsid.2 index 404b1b81a008..e67aae4a13eb 100644 --- a/lib/libc/sys/setsid.2 +++ b/lib/libc/sys/setsid.2 @@ -43,7 +43,7 @@ .Fn setsid "void" .Sh DESCRIPTION The -.Nm setsid +.Fn setsid function creates a new session. The calling process is the session leader of the new session, is the process group leader of a new process group and has no controlling @@ -52,12 +52,12 @@ The calling process is the only process in either the session or the process group. .Pp Upon successful completion, the -.Nm setsid +.Fn setsid function returns the value of the process group ID of the new process group, which is the same as the process ID of the calling process. .Sh ERRORS If an error occurs, -.Nm setsid +.Fn setsid returns -1 and the global variable .Va errno is set to indicate the error, as follows: @@ -73,7 +73,7 @@ ID of the calling process. .Xr tcsetpgrp 3 .Sh STANDARDS The -.Nm setsid +.Fn setsid function is expected to be compliant with the .St -p1003.1-88 specification. diff --git a/lib/libc/sys/shutdown.2 b/lib/libc/sys/shutdown.2 index 976f958f8270..6c159e94d3f3 100644 --- a/lib/libc/sys/shutdown.2 +++ b/lib/libc/sys/shutdown.2 @@ -76,6 +76,6 @@ The specified socket is not connected. .Xr socket 2 .Sh HISTORY The -.Nm +.Fn shutdown function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index 38e86139c69f..03f5bc20aa68 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -337,7 +337,7 @@ or .El .Sh STANDARDS The -.Nm sigaction +.Fn sigaction function is defined by .St -p1003.1-88 . The diff --git a/lib/libc/sys/sigaltstack.2 b/lib/libc/sys/sigaltstack.2 index 4892a923fcbd..5e8815d62af8 100644 --- a/lib/libc/sys/sigaltstack.2 +++ b/lib/libc/sys/sigaltstack.2 @@ -79,7 +79,7 @@ and .Fa ss_size are ignored and the signal stack will be disabled. Trying to disable an active stack will cause -.Nm +.Fn sigaltstack to return -1 with .Va errno set to @@ -158,7 +158,7 @@ Size of alternate stack area is less than or equal to .Xr setjmp 3 .Sh HISTORY The predecessor to -.Nm sigaltstack , +.Fn sigaltstack , the .Fn sigstack system call, appeared in diff --git a/lib/libc/sys/sigpending.2 b/lib/libc/sys/sigpending.2 index 0c87d4ff90a0..e7b7c3b8c827 100644 --- a/lib/libc/sys/sigpending.2 +++ b/lib/libc/sys/sigpending.2 @@ -46,7 +46,7 @@ .Fn sigpending "sigset_t *set" .Sh DESCRIPTION The -.Nm sigpending +.Fn sigpending function returns a mask of the signals pending for delivery to the calling process in the location indicated by .Fa set . @@ -60,13 +60,13 @@ indicates an error occurred and is set to indicated the reason. .Sh ERRORS The -.Nm sigpending +.Fn sigpending function does not currently detect any errors. .Sh SEE ALSO .Xr sigaction 2 , .Xr sigprocmask 2 .Sh STANDARDS The -.Nm sigpending +.Fn sigpending function is defined by .St -p1003.1-88 . diff --git a/lib/libc/sys/sigprocmask.2 b/lib/libc/sys/sigprocmask.2 index 73b014d23be0..b1452cb7c02b 100644 --- a/lib/libc/sys/sigprocmask.2 +++ b/lib/libc/sys/sigprocmask.2 @@ -114,7 +114,7 @@ has a value other than those listed here. .Xr sigsuspend 2 .Sh STANDARDS The -.Nm sigprocmask +.Fn sigprocmask function call is expected to conform to .St -p1003.1-88 . diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2 index f995d11615e5..b116db32fa5b 100644 --- a/lib/libc/sys/sigreturn.2 +++ b/lib/libc/sys/sigreturn.2 @@ -92,6 +92,6 @@ raise the privilege level of the process. .Xr setjmp 3 .Sh HISTORY The -.Nm +.Fn sigreturn function call appeared in .Bx 4.3 . diff --git a/lib/libc/sys/sigstack.2 b/lib/libc/sys/sigstack.2 index 54d1c14d9517..3fbe6e61bf79 100644 --- a/lib/libc/sys/sigstack.2 +++ b/lib/libc/sys/sigstack.2 @@ -46,6 +46,6 @@ function has been deprecated in favor of the interface described in .Xr sigaltstack 2 .Sh HISTORY The -.Nm +.Fn sigstack function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/sigsuspend.2 b/lib/libc/sys/sigsuspend.2 index a2344548847c..cbd6c5234ba6 100644 --- a/lib/libc/sys/sigsuspend.2 +++ b/lib/libc/sys/sigsuspend.2 @@ -74,7 +74,7 @@ set to .Xr sigsetops 3 .Sh STANDARDS The -.Nm sigsupend +.Fn sigsupend function call conforms to .St -p1003.1-88 . diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index e048b4674173..7482150db8fd 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)socket.2 8.1 (Berkeley) 6/4/93 -.\" $Id$ +.\" $Id: socket.2,v 1.2 1995/02/15 22:53:04 wollman Exp $ .\" .Dd February 15, 1995 .Dt SOCKET 2 @@ -265,6 +265,6 @@ The socket cannot be created until sufficient resources are freed. .Re .Sh HISTORY The -.Nm +.Fn socket function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/socketpair.2 b/lib/libc/sys/socketpair.2 index 1e8ba246d190..5f697b48e887 100644 --- a/lib/libc/sys/socketpair.2 +++ b/lib/libc/sys/socketpair.2 @@ -86,6 +86,6 @@ This call is currently implemented only for the domain. .Sh HISTORY The -.Nm +.Fn socketpair function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index 51a5b2e5ff4b..cc4e59ff23b2 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -271,6 +271,6 @@ conform to IEEE Std 1003.1-1988 .Pq Dq Tn POSIX . .Sh HISTORY A -.Nm lstat +.Fn lstat function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/statfs.2 b/lib/libc/sys/statfs.2 index a7a1da21b4e9..49a8a5a9a6d5 100644 --- a/lib/libc/sys/statfs.2 +++ b/lib/libc/sys/statfs.2 @@ -157,5 +157,6 @@ error occurred while reading from or writing to the file system. .El .Sh HISTORY The -.Nm statfs -function first appeared in 4.4BSD. +.Fn statfs +function first appeared in +.Bx 4.4 . diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2 index 5f152ccb9449..6a3f6a1c582b 100644 --- a/lib/libc/sys/swapon.2 +++ b/lib/libc/sys/swapon.2 @@ -108,6 +108,6 @@ dismounted. This call will be upgraded in future versions of the system. .Sh HISTORY The -.Nm +.Fn swapon function call appeared in .Bx 4.0 . diff --git a/lib/libc/sys/symlink.2 b/lib/libc/sys/symlink.2 index cc71cf2d8f07..7440ee0a1101 100644 --- a/lib/libc/sys/symlink.2 +++ b/lib/libc/sys/symlink.2 @@ -137,6 +137,6 @@ points outside the process's allocated address space. .Xr unlink 2 .Sh HISTORY The -.Nm +.Fn symlink function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/sync.2 b/lib/libc/sys/sync.2 index 6309c18c7261..2b2b664c9ec7 100644 --- a/lib/libc/sys/sync.2 +++ b/lib/libc/sys/sync.2 @@ -69,5 +69,6 @@ attributes. may return before the buffers are completely flushed. .Sh HISTORY A -.Nm -function call appeared in Version 6 AT&T UNIX. +.Fn sync +function call appeared in +.At v6 . diff --git a/lib/libc/sys/syscall.2 b/lib/libc/sys/syscall.2 index 2e020adc7d63..f3573667be82 100644 --- a/lib/libc/sys/syscall.2 +++ b/lib/libc/sys/syscall.2 @@ -54,7 +54,7 @@ with the specified arguments. Symbolic constants for system calls can be found in the header file .Ao Pa sys/syscall.h Ac . The -.Nm __syscall +.Fn __syscall form should be used when one or more of the parameters is a 64-bit argument to ensure that argument alignment is correct. This system call is useful for testing new system calls that @@ -71,6 +71,6 @@ such as .Xr pipe 2 . .Sh HISTORY The -.Nm syscall +.Fn syscall function call appeared in .Bx 4.0 . diff --git a/lib/libc/sys/truncate.2 b/lib/libc/sys/truncate.2 index 0503535feca4..73f249b3f635 100644 --- a/lib/libc/sys/truncate.2 +++ b/lib/libc/sys/truncate.2 @@ -125,6 +125,6 @@ Use of to extend a file is not portable. .Sh HISTORY The -.Nm +.Fn truncate function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/unlink.2 b/lib/libc/sys/unlink.2 index 1f469453d5ad..b0d3b1f0879a 100644 --- a/lib/libc/sys/unlink.2 +++ b/lib/libc/sys/unlink.2 @@ -109,11 +109,12 @@ points outside the process's allocated address space. .Xr symlink 7 .Sh HISTORY An -.Nm -function call appeared in Version 6 AT&T UNIX. +.Fn unlink +function call appeared in +.At v6 . .Pp The -.Nm +.Fn unlink system call traditionally allows the super-user to unlink directories which can damage the filesystem integrity. This implementation no longer permits it. diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2 index 125b6193c637..ef45836fda90 100644 --- a/lib/libc/sys/utimes.2 +++ b/lib/libc/sys/utimes.2 @@ -113,6 +113,6 @@ The file system containing the file is mounted read-only. .Xr stat 2 .Sh HISTORY The -.Nm utimes +.Fn utimes function call appeared in .Bx 4.2 . diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2 index 0d0dbf02d3be..ad726bffaefc 100644 --- a/lib/libc/sys/vfork.2 +++ b/lib/libc/sys/vfork.2 @@ -121,6 +121,6 @@ are allowed and input attempts result in an end-of-file indication. .Sh HISTORY The -.Nm +.Fn vfork function call appeared in .Bx 3.0 . diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2 index cd9ab62750e7..d348361773f7 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -292,5 +292,6 @@ call are extensions to the POSIX interface. .Xr exit 3 .Sh HISTORY A -.Nm -function call appeared in Version 6 AT&T UNIX. +.Fn wait +function call appeared in +.At v6 . diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index a1e4a517cbe2..f290628b4371 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -246,7 +246,6 @@ function call appeared in .Bx 4.2 . A -.Nm write -function call -appeared in -Version 6 AT&T UNIX. +.Fn write +function call appeared in +.At v6 . |