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 a31c5d5e9155e..b402686e53faa 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 c05396b0b9883..6cc0228cfa11f 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 848185136626e..cd99deabcb531 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 313b4c7a71160..74105ecf3729f 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 b0ecd92287c77..af1ca7a17e65a 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 e881066096b49..33ad1f75a04a3 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 9d2a0d78a9175..7679f9eb5403d 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 1428d832a34d6..ea73890db9ce0 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 5d94d72dd275e..4e531885c571f 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 b0c6f1bb14832..4676714fa4b1e 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 99672947b2a54..372d85afdece3 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 b98f499997d22..13b79884dbc0a 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 aa151a0d8afae..fdb0a1e1b49b2 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 42b9028dada90..14c0d56aaf462 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 1a80b9cf15c79..7219304fb6abd 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 a5c75884e1b98..c8d761f0b5def 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 55098bc413fa5..3335b0c5f93db 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 a63f526ae4282..138c221918d89 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 38c58b9dcf592..f848938c59194 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 4c27ab9765ac2..e535e5b60de4c 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 d4b600ca677bf..65f888d426135 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 a100cb9642205..aa9d6881d21d8 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 a51fcc9fc464b..3341175cff70f 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 6f7686ebe3d77..79e5c50961183 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 d77ccbcc7efff..63e7061da4f4b 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 90bb7c7d8e034..15ce741e0f10d 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 2b87189dc7238..d70d871ac54b1 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 6829a3e666b99..03879e1cd65ac 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 4ddd65d5e8ac1..51d1b14c51e9c 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 409dd08b35a23..388790f5838ba 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 5d14016e887d9..ef6c7f99243a4 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 0c8038fb67d0e..e113fd0a46e3f 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 bb7526250cb4f..ac5335a88d5a0 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 1b4fbc4362d65..f8500e3221be9 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 480fb916fdd4e..9a03c8448e457 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 f40a0dee2d0b2..31c7c77ce9b37 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 ea428fd47a12b..a09cc374fcee6 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 48271102bcdef..da96ac1032cab 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 d51468d8c3587..1eda9b3532239 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 9ed24a3756fa6..02f841b383e74 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 e7828744e0d58..93dfdee57bc5e 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 29f8833a47e00..3697bf4a62eeb 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 a178a01471043..e42553fe0b712 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 77e2ed88df250..e39f5c0317349 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 e20b47e6ac774..bce9e1a88b900 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 e890a98c45f25..787dd1192a9b8 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 12af3ca214181..9d9402cf3625e 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 404b1b81a0085..e67aae4a13eb8 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 976f958f82708..6c159e94d3f3d 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 38e86139c69f9..03f5bc20aa68f 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 4892a923fcbdf..5e8815d62af86 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 0c87d4ff90a06..e7b7c3b8c827c 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 73b014d23be09..b1452cb7c02bc 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 f995d11615e5f..b116db32fa5b9 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 54d1c14d9517a..3fbe6e61bf797 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 a2344548847c7..cbd6c5234ba63 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 e048b4674173c..7482150db8fde 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 1e8ba246d1908..5f697b48e8877 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 51a5b2e5ff4b7..cc4e59ff23b23 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 a7a1da21b4e9f..49a8a5a9a6d5b 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 5f152ccb94493..6a3f6a1c582b9 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 cc71cf2d8f072..7440ee0a1101b 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 6309c18c7261b..2b2b664c9ec79 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 2e020adc7d633..f3573667be820 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 0503535feca49..73f249b3f6350 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 1f469453d5ad2..b0d3b1f0879a5 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 125b6193c637b..ef45836fda90c 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 0d0dbf02d3bef..ad726bffaefc6 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 cd9ab62750e78..d348361773f77 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 a1e4a517cbe28..f290628b43714 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 . |