diff options
Diffstat (limited to 'lib/libc/sys')
101 files changed, 297 insertions, 297 deletions
diff --git a/lib/libc/sys/_exit.2 b/lib/libc/sys/_exit.2 index 50096e6..efeb4e8 100644 --- a/lib/libc/sys/_exit.2 +++ b/lib/libc/sys/_exit.2 @@ -113,7 +113,7 @@ can never return. .Sh STANDARDS The .Fn _exit -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY An diff --git a/lib/libc/sys/access.2 b/lib/libc/sys/access.2 index e37d069..6a11a00 100644 --- a/lib/libc/sys/access.2 +++ b/lib/libc/sys/access.2 @@ -124,7 +124,7 @@ An I/O error occurred while reading from or writing to the file system. .Sh STANDARDS The .Fn access -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh CAVEAT .Fn Access diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2 index 7b1c6c2..ed41171 100644 --- a/lib/libc/sys/acct.2 +++ b/lib/libc/sys/acct.2 @@ -56,7 +56,7 @@ If .Fa file is an .Em existing -pathname (null-terminated), record collection is enabled and for +pathname (null-terminated), record collection is enabled and for every process initiated which terminates under normal conditions an accounting record is appended to .Fa file . diff --git a/lib/libc/sys/adjtime.2 b/lib/libc/sys/adjtime.2 index a6ddd8c..359b7ac 100644 --- a/lib/libc/sys/adjtime.2 +++ b/lib/libc/sys/adjtime.2 @@ -80,7 +80,7 @@ of computers in a local area network. Such time servers would slow down the clocks of some machines and speed up the clocks of others to bring them to the average network time. .Pp -The call +The call .Fn adjtime is restricted to the super-user. .Sh RETURN VALUES diff --git a/lib/libc/sys/aio_error.2 b/lib/libc/sys/aio_error.2 index e27c973..af5cade 100644 --- a/lib/libc/sys/aio_error.2 +++ b/lib/libc/sys/aio_error.2 @@ -46,7 +46,7 @@ associated with the structure pointed to by If the asynchronous I/O request has completed successfully, .Fn aio_error returns 0. If the request has not yet completed, -.Er EINPROGRESS +.Er EINPROGRESS is returned. If the request has completed unsuccessfully the error status is returned as described in .Xr read 2 , diff --git a/lib/libc/sys/aio_read.2 b/lib/libc/sys/aio_read.2 index 5dac793..839805e 100644 --- a/lib/libc/sys/aio_read.2 +++ b/lib/libc/sys/aio_read.2 @@ -48,7 +48,7 @@ beginning at the offset .Fa iocb->aio_offset into the buffer pointed to by .Fa iocb->aio_buf . -The call returns immediately after the read request has +The call returns immediately after the read request has been enqueued to the descriptor; the read may or may not have completed at the time the call returns. .Pp @@ -90,7 +90,7 @@ for these objects is discouraged. .Pp The asynchronous I/O control buffer .Fa iocb -should be zeroed before the +should be zeroed before the .Fn aio_read call to avoid passing bogus context information to the kernel. .Pp @@ -195,6 +195,6 @@ This manual page was written by .An Terry Lambert Aq terry@whistle.com . .Sh BUGS -Invalid information in +Invalid information in .Fa iocb->_aiocb_private may confuse the kernel. diff --git a/lib/libc/sys/aio_return.2 b/lib/libc/sys/aio_return.2 index 3477288..64bc8c9 100644 --- a/lib/libc/sys/aio_return.2 +++ b/lib/libc/sys/aio_return.2 @@ -45,7 +45,7 @@ associated with the structure pointed to by .Pp .Fn aio_return should only be called once, to obtain the final status of an asynchronous -I/O operation once +I/O operation once .Xr aio_error 2 returns something other than .Er EINPROGRESS . @@ -59,7 +59,7 @@ or On failure, .Fn aio_return returns -.Dv -1 +.Dv -1 and sets .Dv errno to indicate the error condition. diff --git a/lib/libc/sys/aio_suspend.2 b/lib/libc/sys/aio_suspend.2 index 333ad82..d59cb8d 100644 --- a/lib/libc/sys/aio_suspend.2 +++ b/lib/libc/sys/aio_suspend.2 @@ -46,7 +46,7 @@ delivered, or the has passed. .Pp .Fa iocbs -is an array of +is an array of .Fa niocb pointers to asynchronous I/O requests. Array members containing NULL will be silently ignored. @@ -79,7 +79,7 @@ The function will fail if: .Bl -tag -width Er .It Bq Er EAGAIN -the +the .Fa timeout expired before any I/O requests completed. .It Bq Er EINVAL diff --git a/lib/libc/sys/aio_write.2 b/lib/libc/sys/aio_write.2 index f099d43..8215720 100644 --- a/lib/libc/sys/aio_write.2 +++ b/lib/libc/sys/aio_write.2 @@ -51,9 +51,9 @@ the call returns. If the request could not be enqueued, generally due to invalid arguments, the call returns without having enqueued the request. .Pp -If -.Dv O_APPEND -is set for +If +.Dv O_APPEND +is set for .Fa iocb->aio_fildes , .Fn aio_write operations append to the file in the same order as the calls were @@ -64,7 +64,7 @@ the absolute position from the beginning of the file plus .Fa iocb->aio_offset . .Pp If -.Dv _POSIX_PRIORITIZED_IO +.Dv _POSIX_PRIORITIZED_IO is defined, and the descriptor supports it, then the enqueued operation is submitted at a priority equal to that of the calling process minus @@ -91,7 +91,7 @@ and the buffer that the member of that structure references must remain valid until the operation has completed. For this reason, use of auto (stack) variables for these objects is discouraged. -.Pp +.Pp The asynchronous I/O control buffer .Fa iocb should be zeroed before the diff --git a/lib/libc/sys/bind.2 b/lib/libc/sys/bind.2 index ac8337e..56ab9a5 100644 --- a/lib/libc/sys/bind.2 +++ b/lib/libc/sys/bind.2 @@ -48,7 +48,7 @@ .Sh DESCRIPTION .Fn Bind assigns the local protocol address to a socket. -When a socket is created +When a socket is created with .Xr socket 2 it exists in an address family space but has no protocol address assigned. @@ -96,7 +96,7 @@ The call will fail if: .Bl -tag -width Er .It Bq Er EAGAIN -Kernel resources to complete the request are +Kernel resources to complete the request are temporarily unavilable. .It Bq Er EBADF .Fa S diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2 index 97b2915..50c8196 100644 --- a/lib/libc/sys/brk.2 +++ b/lib/libc/sys/brk.2 @@ -85,7 +85,7 @@ increased to the next page boundary. .\" .Pp The current value of the program break is reliably returned by .Dq Li sbrk(0) -(see also +(see also .Xr end 3 ) . The .Xr getrlimit 2 @@ -143,7 +143,7 @@ to support the expansion. Setting the break may fail due to a temporary lack of swap space. It is not possible to distinguish this from a failure caused by exceeding the maximum size of -the data segment without consulting +the data segment without consulting .Xr getrlimit 2 . .Sh HISTORY A diff --git a/lib/libc/sys/chdir.2 b/lib/libc/sys/chdir.2 index 7a9c716..bd969f9 100644 --- a/lib/libc/sys/chdir.2 +++ b/lib/libc/sys/chdir.2 @@ -121,7 +121,7 @@ is not a valid file descriptor. .Sh STANDARDS The .Fn chdir -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/chmod.2 b/lib/libc/sys/chmod.2 index 6a3120f..d003503 100644 --- a/lib/libc/sys/chmod.2 +++ b/lib/libc/sys/chmod.2 @@ -129,7 +129,7 @@ For more details of the properties of the sticky bit, see If mode ISUID (set UID) is set on a directory, and the MNT_SUIDDIR option was used in the mount of the filesystem, then the owner of any new files and sub-directories -created within this directory are set +created within this directory are set to be the same as the owner of that directory. If this function is enabled, new directories will inherit the bit from their parents. Execute bits are removed from @@ -146,7 +146,7 @@ such should not be used on shell machines, especially on home directories. This option requires the SUIDDIR option in the kernel to work. Only UFS filesystems support this option. -For more details of the suiddir mount option, see +For more details of the suiddir mount option, see .Xr mount 8 . .Pp Writing or changing the owner of a file @@ -212,7 +212,7 @@ An I/O error occurred while reading from or writing to the file system. .Sh STANDARDS The .Fn chmod -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 , except for the return of .Er EFTYPE diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2 index e049ad5..363893a 100644 --- a/lib/libc/sys/chown.2 +++ b/lib/libc/sys/chown.2 @@ -58,7 +58,7 @@ or referenced by .Fa fd is changed as specified by the arguments .Fa owner -and +and .Fa group . The owner of a file may change the .Fa group @@ -147,7 +147,7 @@ An I/O error occurred while reading from or writing to the file system. .Sh STANDARDS The .Fn chown -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2 index db7336c..eeb9def 100644 --- a/lib/libc/sys/chroot.2 +++ b/lib/libc/sys/chroot.2 @@ -67,26 +67,26 @@ This call is restricted to the super-user. Depending on the setting of the .Ql kern.chroot_allow_open_directories sysctl variable, open filedescriptors which reference directories -will make the +will make the .Fn chroot fail as follows: .Pp -If +If .Ql kern.chroot_allow_open_directories -is set to zero, +is set to zero, .Fn chroot will always fail with .Er EPERM if there are any directories open. .Pp -If +If .Ql kern.chroot_allow_open_directories -is set to one (the default), +is set to one (the default), .Fn chroot will fail with .Er EPERM if there are any directories open and the -process is already subject to a +process is already subject to a .Fn chroot call. .Pp diff --git a/lib/libc/sys/clock_gettime.2 b/lib/libc/sys/clock_gettime.2 index 24ead35..e392954 100644 --- a/lib/libc/sys/clock_gettime.2 +++ b/lib/libc/sys/clock_gettime.2 @@ -68,7 +68,7 @@ kernel mode. .Pp The structure pointed to by .Fa tp -is defined in +is defined in .Ao Pa sys/time.h Ac as: .Pp diff --git a/lib/libc/sys/close.2 b/lib/libc/sys/close.2 index 18ebe3c..98c35e0 100644 --- a/lib/libc/sys/close.2 +++ b/lib/libc/sys/close.2 @@ -66,7 +66,7 @@ However, the semantics of System V and dictate that all .Xr fcntl 2 advisory record locks associated with a file for a given process -are removed when +are removed when .Em any file descriptor for that file is closed by that process. .Pp @@ -149,7 +149,7 @@ An interrupt was received. .Sh STANDARDS The .Fn close -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/connect.2 b/lib/libc/sys/connect.2 index 7a8a59d..54adbb2 100644 --- a/lib/libc/sys/connect.2 +++ b/lib/libc/sys/connect.2 @@ -131,7 +131,7 @@ The parameter specifies an area outside the process address space. .It Bq Er EINPROGRESS -The socket is non-blocking +The socket is non-blocking and the connection cannot be completed immediately. It is possible to diff --git a/lib/libc/sys/dup.2 b/lib/libc/sys/dup.2 index d64ee65..347795c 100644 --- a/lib/libc/sys/dup.2 +++ b/lib/libc/sys/dup.2 @@ -90,7 +90,7 @@ additional call. The close-on-exec flag on the new file descriptor is unset. .Pp -In +In .Fn dup2 , the value of the new descriptor .Fa newd @@ -194,7 +194,7 @@ The .Fn dup and .Fn dup2 -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2 index 85531f8..9086232 100644 --- a/lib/libc/sys/execve.2 +++ b/lib/libc/sys/execve.2 @@ -208,7 +208,7 @@ library re-initialization and then calls .Sh RETURN VALUES As the .Fn execve -function overlays the current process image +function overlays the current process image with a new process image the successful call has no process to return to. If diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2 index 9c2a25b..86364c1 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -122,7 +122,7 @@ and signals; process groups are specified by supplying .Fa arg -as negative, otherwise +as negative, otherwise .Fa arg is interpreted as a process ID. .El @@ -302,7 +302,7 @@ locks conflicts with the type specified in the request. This interface follows the completely stupid semantics of System V and .St -p1003.1-88 that require that all locks associated with a file for a given process are -removed when +removed when .Em any file descriptor for that file is closed by that process. This semantic means that applications must be aware of any files that @@ -311,7 +311,7 @@ For example if an application for updating the password file locks the password file database while making the update, and then calls .Xr getpwnam 3 to retrieve a record, -the lock will be lost because +the lock will be lost because .Xr getpwnam 3 opens, reads, and closes the password database. The database close will release all locks that the process has @@ -329,9 +329,9 @@ allows locks to be inherited by child processes. is recommended for applications that want to ensure the integrity of their locks when using library routines or wish to pass locks to their children. -Note that +Note that .Xr flock 2 -and +and .Xr fcntl 2 locks may be safely used concurrently. .Pp @@ -497,10 +497,10 @@ or and satisfying the lock or unlock request would result in the number of locked regions in the system exceeding a system-imposed limit. .It Bq Er EPERM -.Fa Cmd -is +.Fa Cmd +is .Dv F_SETOWN -and +and the process ID or process group given as an argument is in a different session than the caller. .It Bq Er ESRCH @@ -511,7 +511,7 @@ and the process ID given as argument is not in use. .El .Pp -In addition, if +In addition, if .Fa fd refers to a descriptor open on a terminal device (as opposed to a descriptor open on a socket), a diff --git a/lib/libc/sys/flock.2 b/lib/libc/sys/flock.2 index 49ecd4d..5e9ebf6 100644 --- a/lib/libc/sys/flock.2 +++ b/lib/libc/sys/flock.2 @@ -81,7 +81,7 @@ locks and locks. At any time multiple shared locks may be applied to a file, but at no time are multiple exclusive, or both shared and exclusive, -locks allowed simultaneously on a file. +locks allowed simultaneously on a file. .Pp A shared lock may be .Em upgraded diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2 index ee438ff..48d2e0e 100644 --- a/lib/libc/sys/getdirentries.2 +++ b/lib/libc/sys/getdirentries.2 @@ -122,7 +122,7 @@ The current position pointer associated with .Fa fd is set to point to the next block of entries. The pointer may not advance by the number of bytes returned by -.Fn getdirentries +.Fn getdirentries or .Fn getdents . A value of zero is returned when diff --git a/lib/libc/sys/getfsstat.2 b/lib/libc/sys/getfsstat.2 index de2bb80..bec4f14 100644 --- a/lib/libc/sys/getfsstat.2 +++ b/lib/libc/sys/getfsstat.2 @@ -145,7 +145,7 @@ Thus, some of the information will be out of date, but will not block waiting for information from a filesystem that is unable to respond. .Sh RETURN VALUES -Upon successful completion, the number of +Upon successful completion, the number of .Fa fsstat structures is returned. Otherwise, -1 is returned and the global variable diff --git a/lib/libc/sys/getgid.2 b/lib/libc/sys/getgid.2 index 3e1a148..39215e1 100644 --- a/lib/libc/sys/getgid.2 +++ b/lib/libc/sys/getgid.2 @@ -81,5 +81,5 @@ The .Fn getgid and .Fn getegid -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/getgroups.2 b/lib/libc/sys/getgroups.2 index 6527e80..7b0789d 100644 --- a/lib/libc/sys/getgroups.2 +++ b/lib/libc/sys/getgroups.2 @@ -48,11 +48,11 @@ .Sh DESCRIPTION .Fn Getgroups gets the current group access list of the user process -and stores it in the array +and stores it in the array .Fa gidset . The parameter .Fa gidsetlen -indicates the number of entries that may be placed in +indicates the number of entries that may be placed in .Fa gidset . .Fn Getgroups returns the actual number of groups returned in diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index db629f4..156caa1 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -68,7 +68,7 @@ call sets a timer to the specified .Fa ovalue is non-nil). .Pp -A timer value is defined by the +A timer value is defined by the .Fa itimerval structure: .Bd -literal -offset indent @@ -80,13 +80,13 @@ struct itimerval { .Pp If .Fa it_value -is non-zero, it indicates the time to the next timer expiration. +is non-zero, it indicates the time to the next timer expiration. If .Fa it_interval -is non-zero, it specifies a value to be used in reloading +is non-zero, it specifies a value to be used in reloading .Fa it_value when the timer expires. -Setting +Setting .Fa it_value to 0 disables a timer, regardless of the value of .Fa it_interval . diff --git a/lib/libc/sys/getpeername.2 b/lib/libc/sys/getpeername.2 index 20d9f53..c409cea 100644 --- a/lib/libc/sys/getpeername.2 +++ b/lib/libc/sys/getpeername.2 @@ -100,7 +100,7 @@ The socket is not connected. Insufficient resources were available in the system to perform the operation. .It Bq Er EFAULT -The +The .Fa name parameter points to memory not in a valid part of the process address space. diff --git a/lib/libc/sys/getpgrp.2 b/lib/libc/sys/getpgrp.2 index 9e3fa54..30209ac 100644 --- a/lib/libc/sys/getpgrp.2 +++ b/lib/libc/sys/getpgrp.2 @@ -109,7 +109,7 @@ function call is derived from its usage in System V Release 4. .Sh STANDARDS The .Fn getpgrp -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh COMPATIBILITY This version of diff --git a/lib/libc/sys/getpid.2 b/lib/libc/sys/getpid.2 index 70c0b65..656d7e7 100644 --- a/lib/libc/sys/getpid.2 +++ b/lib/libc/sys/getpid.2 @@ -62,7 +62,7 @@ instead. .Pp .Fn Getppid returns the process ID of the parent -of the calling process. +of the calling process. .Sh ERRORS The .Fn getpid @@ -77,7 +77,7 @@ The .Fn getpid and .Fn getppid -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/getpriority.2 b/lib/libc/sys/getpriority.2 index 8a8d57b..efaa5ed 100644 --- a/lib/libc/sys/getpriority.2 +++ b/lib/libc/sys/getpriority.2 @@ -65,9 +65,9 @@ is one of .Dv PRIO_PGRP , or .Dv PRIO_USER , -and +and .Fa who -is interpreted relative to +is interpreted relative to .Fa which (a process identifier for .Dv PRIO_PROCESS , @@ -110,7 +110,7 @@ and will fail if: .Bl -tag -width Er .It Bq Er ESRCH -No process was located using the +No process was located using the .Fa which and .Fa who diff --git a/lib/libc/sys/getrlimit.2 b/lib/libc/sys/getrlimit.2 index ceac426..9b76214 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -55,7 +55,7 @@ and each process it creates may be obtained with the .Fn getrlimit call, and set with the .Fn setrlimit -call. +call. .Pp The .Fa resource @@ -104,7 +104,7 @@ A resource limit is specified as a soft limit and a hard limit. When a soft limit is exceeded a process may receive a signal (for example, if the cpu time or file size is exceeded), but it will be allowed to continue execution until it reaches the hard limit (or modifies -its resource limit). The +its resource limit). The .Em rlimit structure is used to specify the hard and soft limits on a resource, .Bd -literal -offset indent @@ -115,9 +115,9 @@ struct rlimit { .Ed .Pp Only the super-user may raise the maximum limits. Other users -may only alter +may only alter .Fa rlim_cur -within the range from 0 to +within the range from 0 to .Fa rlim_max or (irreversibly) lower .Fa rlim_max . diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2 index ad7f585..2d973cb 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -144,9 +144,9 @@ priority process becoming runnable or because the current process exceeded its time slice. .El .Sh NOTES -The numbers +The numbers .Fa ru_inblock -and +and .Fa ru_oublock account only for real I/O; data supplied by the caching mechanism is charged only diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2 index d2ecff9..afaa86b 100644 --- a/lib/libc/sys/getsockname.2 +++ b/lib/libc/sys/getsockname.2 @@ -47,7 +47,7 @@ .Fn getsockname "int s" "struct sockaddr *name" "socklen_t *namelen" .Sh DESCRIPTION .Fn Getsockname -returns the current +returns the current .Fa name for the specified socket. The .Fa namelen @@ -96,7 +96,7 @@ is a file, not a socket. Insufficient resources were available in the system to perform the operation. .It Bq Er EFAULT -The +The .Fa name parameter points to memory not in a valid part of the process address space. diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index 0f1a23b..b5bc37b 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -187,13 +187,13 @@ of the destination address. .Pp .Dv SO_LINGER controls the action taken when unsent messages -are queued on socket and a +are queued on socket and a .Xr close 2 is performed. If the socket promises reliable delivery of data and .Dv SO_LINGER is set, -the system will block the process on the +the system will block the process on the .Xr close 2 attempt until it is able to transmit the data or until it decides it is unable to deliver the information (a timeout period, termed the @@ -201,10 +201,10 @@ linger interval, is specified in seconds in the .Fn setsockopt call when .Dv SO_LINGER -is requested). +is requested). If .Dv SO_LINGER -is disabled and a +is disabled and a .Xr close 2 is issued, the system will process the close in a manner that allows the process to continue as quickly as possible. @@ -263,7 +263,7 @@ requested. The default value for .Dv SO_RCVLOWAT is 1. -If +If .Dv SO_RCVLOWAT is set to a larger value, blocking receive calls normally wait until they have received the smaller of the low water mark value @@ -406,7 +406,7 @@ is a file, not a socket. .It Bq Er ENOPROTOOPT The option is unknown at the level indicated. .It Bq Er EFAULT -The address pointed to by +The address pointed to by .Fa optval is not in a valid part of the process address space. For diff --git a/lib/libc/sys/gettimeofday.2 b/lib/libc/sys/gettimeofday.2 index 6b8f3f6..06b7996 100644 --- a/lib/libc/sys/gettimeofday.2 +++ b/lib/libc/sys/gettimeofday.2 @@ -74,7 +74,7 @@ The structures pointed to by .Fa tp and .Fa tzp -are defined in +are defined in .Ao Pa sys/time.h Ac as: .Pp @@ -90,7 +90,7 @@ struct timezone { }; .Ed .Pp -The +The .Fa timezone structure indicates the local time zone (measured in minutes of time westward from Greenwich), diff --git a/lib/libc/sys/getuid.2 b/lib/libc/sys/getuid.2 index 1a762fe..95873bf 100644 --- a/lib/libc/sys/getuid.2 +++ b/lib/libc/sys/getuid.2 @@ -83,7 +83,7 @@ The .Fn geteuid and .Fn getuid -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/intro.2 b/lib/libc/sys/intro.2 index 07c1a02..56dbcd7 100644 --- a/lib/libc/sys/intro.2 +++ b/lib/libc/sys/intro.2 @@ -52,7 +52,7 @@ their error returns, and other common definitions and concepts. .Sh RETURN VALUES Nearly all of the system calls provide an error number referenced via the external identifier errno. -This identifier is defined in +This identifier is defined in .Aq Pa sys/errno.h as .Pp @@ -97,7 +97,7 @@ An attempt was made to perform an operation limited to processes with appropriate privileges or to the owner of a file or other resources. .It Er 2 ENOENT Em "No such file or directory" . -A component of a specified pathname did not exist, or the +A component of a specified pathname did not exist, or the pathname was an empty string. .It Er 3 ESRCH Em "No such process" . No process could be found corresponding to that specified by the given @@ -383,7 +383,7 @@ was supplied to a remove directory or rename call. .It Er 68 EUSERS Em "Too many users" . The quota system ran out of table entries. .It Er 69 EDQUOT Em "Disc quota exceeded" . -A +A .Xr write 2 to an ordinary file, the creation of a directory or symbolic link, or the creation of a directory @@ -395,10 +395,10 @@ was exhausted. An attempt was made to access an open file (on an .Tn NFS filesystem) -which is now unavailable as referenced by the file descriptor. +which is now unavailable as referenced by the file descriptor. This may indicate the file was deleted on the -.Tn NFS -server or some +.Tn NFS +server or some other catastrophic event occurred. .It Er 72 EBADRPC Em "RPC struct is bad" . Exchange of @@ -412,7 +412,7 @@ the local version. .It Er 74 EPROGUNAVAIL Em "RPC prog. not avail" . The requested program is not registered on the remote host. .It Er 75 EPROGMISMATCH Em "Program version wrong" . -The requested version of the program is not available +The requested version of the program is not available on the remote host .Pq Tn RPC . .It Er 76 EPROCUNAVAIL Em "Bad procedure for program" . @@ -421,13 +421,13 @@ An call was attempted for a procedure which doesn't exist in the remote program. .It Er 77 ENOLCK Em "No locks available" . -A system-imposed limit on the number of simultaneous file +A system-imposed limit on the number of simultaneous file locks was reached. .It Er 78 ENOSYS Em "Function not implemented" . -Attempted a system call that is not available on this +Attempted a system call that is not available on this system. .It Er 79 EFTYPE Em "Inappropriate file type or format" . -The file was the wrong type for the operation, or a data file had +The file was the wrong type for the operation, or a data file had the wrong format. .It Er 80 EAUTH Em "Authentication error" . Attempted to use an invalid authentication ticket to mount a @@ -448,8 +448,8 @@ provided space. .It Er 85 ECANCELED Em "Operation canceled" . The scheduled operation was canceled. .It Er 86 EILSEQ Em "Illegal byte sequence" . -While decoding a multibyte character the function came along an -invalid or an incomplete sequence of bytes or the given wide +While decoding a multibyte character the function came along an +invalid or an incomplete sequence of bytes or the given wide character is invalid. .El .Sh DEFINITIONS @@ -519,10 +519,10 @@ The process group of a session leader is orphaned by definition. Each user on the system is identified by a positive integer termed the real user ID. .Pp -Each user is also a member of one or more groups. +Each user is also a member of one or more groups. One of these groups is distinguished from others and used in implementing accounting facilities. The positive -integer corresponding to this distinguished group is termed +integer corresponding to this distinguished group is termed the real group ID. .Pp All processes have a real user ID and real group ID. @@ -653,13 +653,13 @@ These permissions are used in determining whether a process may perform a requested operation on the file (such as opening a file for writing). Access permissions are established at the time a file is created. They may be changed at some later time -through the +through the .Xr chmod 2 -call. +call. .Pp File access is broken down according to whether a file may be: read, written, or executed. Directory files use the execute -permission to control if the directory may be searched. +permission to control if the directory may be searched. .Pp File access permissions are interpreted by the system as they apply to three different classes of users: the owner diff --git a/lib/libc/sys/ioctl.2 b/lib/libc/sys/ioctl.2 index 5f75d49..fe1fea2 100644 --- a/lib/libc/sys/ioctl.2 +++ b/lib/libc/sys/ioctl.2 @@ -62,11 +62,11 @@ The third argument to .Nm is traditionally named .Ar "char *argp" . -Most uses of +Most uses of .Nm in .Fx 3.0 -however, require the third argument to be a +however, require the third argument to be a .Ar caddr_t or an .Ar int . diff --git a/lib/libc/sys/jail.2 b/lib/libc/sys/jail.2 index cc0df2a..e457548 100644 --- a/lib/libc/sys/jail.2 +++ b/lib/libc/sys/jail.2 @@ -58,9 +58,9 @@ the prison. It is not possible to add a process to a preexisting prison. .Pp Inside the prison, the concept of "superuser" is very diluted. In general, it can be assumed that nothing can be mangled from inside a prison which -does not exist entirely inside that prison. For instance the directory +does not exist entirely inside that prison. For instance the directory tree below -.Dq Li path +.Dq Li path can be manipulated all the ways a root can normally do it, including .Dq Li "rm -rf /*" but new device special nodes cannot be created because they reference diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2 index e641fd9..f0b9654 100644 --- a/lib/libc/sys/kill.2 +++ b/lib/libc/sys/kill.2 @@ -59,7 +59,7 @@ may be one of the signals specified in .Xr sigaction 2 or it may be 0, in which case error checking is performed but no -signal is actually sent. +signal is actually sent. This can be used to check the validity of .Fa pid . .Pp @@ -135,7 +135,7 @@ of the group could not be signaled. .Sh STANDARDS The .Fn kill -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/kldfind.2 b/lib/libc/sys/kldfind.2 index aabd41d..8305076 100644 --- a/lib/libc/sys/kldfind.2 +++ b/lib/libc/sys/kldfind.2 @@ -23,14 +23,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd March 3, 1999 .Dt KLDFIND 2 .Os .Sh NAME .Nm kldfind -.Nd returns the fileid of a kld file +.Nd returns the fileid of a kld file .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/kldfirstmod.2 b/lib/libc/sys/kldfirstmod.2 index fe928b8..29e81d8 100644 --- a/lib/libc/sys/kldfirstmod.2 +++ b/lib/libc/sys/kldfirstmod.2 @@ -23,7 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd March 3, 1999 .Dt KLDFIRSTMOD 2 diff --git a/lib/libc/sys/kldload.2 b/lib/libc/sys/kldload.2 index f897c83..2b40bab 100644 --- a/lib/libc/sys/kldload.2 +++ b/lib/libc/sys/kldload.2 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm kldload -.Nd load KLD files into the kernel +.Nd load KLD files into the kernel .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -68,7 +68,7 @@ The file was not found. .It Bq Er ENOEXEC The file format of .Fa file -was unrecognized. +was unrecognized. .El .Sh SEE ALSO .Xr kldfind 2 , diff --git a/lib/libc/sys/kldnext.2 b/lib/libc/sys/kldnext.2 index 4ba8ca3..d18f953 100644 --- a/lib/libc/sys/kldnext.2 +++ b/lib/libc/sys/kldnext.2 @@ -23,14 +23,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd March 3, 1999 .Dt KLDNEXT 2 .Os .Sh NAME .Nm kldnext -.Nd return the fileid of the next kld file +.Nd return the fileid of the next kld file .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/kldstat.2 b/lib/libc/sys/kldstat.2 index 4846905..0ad213b 100644 --- a/lib/libc/sys/kldstat.2 +++ b/lib/libc/sys/kldstat.2 @@ -23,14 +23,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd March 3, 1999 .Dt KLDSTAT 2 .Os .Sh NAME .Nm kldstat -.Nd get status of kld file +.Nd get status of kld file .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2 index 7225358..4d5ee64 100644 --- a/lib/libc/sys/kqueue.2 +++ b/lib/libc/sys/kqueue.2 @@ -60,7 +60,7 @@ The filter is also run when the user attempts to retrieve the kevent from the kqueue. If the filter indicates that the condition that triggered the event no longer holds, the kevent is removed from the kqueue and -is not returned. +is not returned. .Pp Multiple events which trigger the filter do not result in multiple kevents being placed on the kqueue; instead, the filter will aggregate @@ -85,17 +85,17 @@ is used to register events with the queue, and return any pending events to the user. .Fa changelist is a pointer to an array of -.Va kevent +.Va kevent structures, as defined in .Aq Pa sys/event.h . -All changes contained in the +All changes contained in the .Fa changelist are applied before any pending events are read from the queue. .Fa nchanges gives the size of .Fa changelist . .Fa eventlist -is a pointer to an array of kevent structures. +is a pointer to an array of kevent structures. .Fa nevents determines the size of .Fa eventlist . @@ -112,7 +112,7 @@ argument should be non-NULL, pointing to a zero-valued .Va timespec structure. The same array may be used for the .Fa changelist -and +and .Fa eventlist . .Pp .Fn EV_SET @@ -149,7 +149,7 @@ Actions to perform on the event. .It fflags Filter-specific flags. .It data -Filter-specific data value. +Filter-specific data value. .It udata Opaque user-defined value passed through the kernel unchanged. .El @@ -172,8 +172,8 @@ Disable the event so .Fn kevent will not return it. The filter itself is not disabled. .It EV_DELETE -Removes the event from the kqueue. Events which are attached to -file descriptors are automatically deleted on the last close of +Removes the event from the kqueue. Events which are attached to +file descriptors are automatically deleted on the last close of the descriptor. .It EV_ONESHOT Causes the event to return only the first occurrence of the filter @@ -193,7 +193,7 @@ below. .El .Pp The predefined system filters are listed below. -Arguments may be passed to and from the filter via the +Arguments may be passed to and from the filter via the .Va fflags and .Va data @@ -218,9 +218,9 @@ subject to the .Dv SO_RCVLOWAT value of the socket buffer. This may be overridden with a per-filter low water mark at the -time the filter is added by setting the -NOTE_LOWAT -flag in +time the filter is added by setting the +NOTE_LOWAT +flag in .Va fflags , and specifying the new low water mark in .Va data . @@ -231,7 +231,7 @@ contains the number of bytes in the socket buffer. If the read direction of the socket has shutdown, then the filter also sets EV_EOF in .Va flags , -and returns the socket error (if any) in +and returns the socket error (if any) in .Va fflags . It is possible for EOF to be returned (indicating the connection is gone) while there is still data pending in the socket buffer. @@ -254,22 +254,22 @@ returning. .It EVFILT_WRITE Takes a descriptor as the identifier, and returns whenever it is possible to write to the descriptor. For sockets, pipes -and fifos, +and fifos, .Va data will contain the amount of space remaining in the write buffer. The filter will set EV_EOF when the reader disconnects, and for the fifo case, this may be cleared by use of EV_CLEAR. Note that this filter is not supported for vnodes. .Pp -For sockets, the low water mark and socket error handling is +For sockets, the low water mark and socket error handling is identical to the EVFILT_READ case. .It EVFILT_AIO The sigevent portion of the AIO request is filled in, with -.Va sigev_notify_kqueue +.Va sigev_notify_kqueue containing the descriptor of the kqueue that the event should be attached to, .Va sigev_value -containing the udata value, and +containing the udata value, and .Va sigev_notify set to SIGEV_EVENT. When the aio_* function is called, the event will be registered @@ -280,7 +280,7 @@ argument set to the returned by the aio_* function. The filter returns under the same conditions as aio_error. .Pp -Alternatively, a kevent structure may be initialized, with +Alternatively, a kevent structure may be initialized, with .Va ident containing the descriptor of the kqueue, and the address of the kevent structure placed in the @@ -288,7 +288,7 @@ address of the kevent structure placed in the field of the AIO request. However, this approach will not work on architectures with 64-bit pointers, and should be considered depreciated. .It EVFILT_VNODE -Takes a file descriptor as the identifier and the events to watch for in +Takes a file descriptor as the identifier and the events to watch for in .Va fflags , and returns when one or more of the requested events occurs on the descriptor. The events to monitor are: @@ -307,7 +307,7 @@ The link count on the file changed. .It NOTE_RENAME The file referenced by the descriptor was renamed. .It NOTE_REVOKE -Access to the file was revoked via +Access to the file was revoked via .Xr revoke 2 or the underlying fileystem was unmounted. .El @@ -316,7 +316,7 @@ On return, .Va fflags contains the events which triggered the filter. .It EVFILT_PROC -Takes the process ID to monitor as the identifier and the events to watch for +Takes the process ID to monitor as the identifier and the events to watch for in .Va fflags , and returns when the process performs one or more of the requested events. @@ -329,7 +329,7 @@ The process has exited. The process has called .Fn fork . .It NOTE_EXEC -The process has executed a new process via +The process has executed a new process via .Xr execve 2 or similar call. .It NOTE_TRACK @@ -339,7 +339,7 @@ calls. The parent process will return with NOTE_TRACK set in the .Va fflags field, while the child process will return with NOTE_CHILD set in .Va fflags -and the parent PID in +and the parent PID in .Va data . .It NOTE_TRACKERR This flag is returned if the system was unable to attach an event to @@ -354,7 +354,7 @@ Takes the signal number to monitor as the identifier and returns when the given signal is delivered to the process. This coexists with the .Fn signal -and +and .Fn sigaction facilities, and has a lower precedence. The filter will record all attempts to deliver a signal to a process, even if the signal has @@ -416,9 +416,9 @@ function fails if: .It Bq Er EACCES The process does not have permission to register a filter. .It Bq Er EFAULT -There was an error reading or writing the +There was an error reading or writing the .Va kevent -structure. +structure. .It Bq Er EBADF The specified descriptor is invalid. .It Bq Er EINTR diff --git a/lib/libc/sys/ktrace.2 b/lib/libc/sys/ktrace.2 index ded62e6..fcbf46e 100644 --- a/lib/libc/sys/ktrace.2 +++ b/lib/libc/sys/ktrace.2 @@ -110,7 +110,7 @@ struct ktr_header { .Pp The .Va ktr_len -field specifies the length of the +field specifies the length of the .Va ktr_type data that follows this header. The @@ -126,7 +126,7 @@ The .Va ktr_buf is an internal kernel pointer and is not useful. .Pp -The generic header is followed by +The generic header is followed by .Va ktr_len bytes of a .Va ktr_type diff --git a/lib/libc/sys/link.2 b/lib/libc/sys/link.2 index 5ddc28b..baea6eb 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -138,7 +138,7 @@ is being placed cannot be extended because the user's quota of disk blocks on the file system containing the directory has been exhausted. .It Bq Er EIO -An I/O error occurred while reading from or writing to +An I/O error occurred while reading from or writing to the file system to make the directory entry. .It Bq Er EROFS The requested link requires writing in a directory on a read-only file @@ -154,7 +154,7 @@ is outside the process's allocated address space. .Sh STANDARDS The .Fn link -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A @@ -166,4 +166,4 @@ The .Fn link system call traditionally allows the super-user to link directories which corrupts the filesystem coherency. This implementation no longer permits -it. +it. diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2 index fd67ca4..b77500a 100644 --- a/lib/libc/sys/listen.2 +++ b/lib/libc/sys/listen.2 @@ -109,7 +109,7 @@ unlocks .Sh RETURN VALUES A 0 return value indicates success; -1 indicates an error. .Sh ERRORS -.Fn Listen +.Fn Listen will fail if: .Bl -tag -width Er .It Bq Er EBADF diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2 index e161025..362485b 100644 --- a/lib/libc/sys/lseek.2 +++ b/lib/libc/sys/lseek.2 @@ -135,7 +135,7 @@ is incorrect English, but is maintained for historical reasons. .Sh STANDARDS The .Fn lseek -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/madvise.2 b/lib/libc/sys/madvise.2 index 4886d02..e5d6a06 100644 --- a/lib/libc/sys/madvise.2 +++ b/lib/libc/sys/madvise.2 @@ -66,7 +66,7 @@ The known behaviors are given in #define MADV_CORE 9 /* revert to including pages in a core file */ .Ed .Pp -.Bl -tag -width MADV_SEQUENTIAL +.Bl -tag -width MADV_SEQUENTIAL .It Dv MADV_NORMAL Tells the system to revert to the default paging behavior. @@ -92,26 +92,26 @@ this address range will incur a page fault. .It Dv MADV_FREE Gives the VM system the freedom to free pages, and tells the system that information in the specified page range -is no longer important. This is an efficient way of allowing +is no longer important. This is an efficient way of allowing .Xr malloc 3 to free pages anywhere in the address space, while keeping the address space valid. The next time that the page is referenced, the page might be demand -zeroed, or might contain the data that was there before the +zeroed, or might contain the data that was there before the .Dv MADV_FREE call. References made to that address space range will not make the VM system page the information back in from backing store until the page is modified again. .It Dv MADV_NOSYNC -Request that the system not flush the data associated with this map to +Request that the system not flush the data associated with this map to physical backing store unless it needs to. Typically this prevents the filesystem update daemon from gratuitously writing pages dirtied -by the VM system to physical disk. Note that VM/filesystem coherency is +by the VM system to physical disk. Note that VM/filesystem coherency is always maintained, this feature simply ensures that the mapped data is only flush when it needs to be, usually by the system pager. .Pp This feature is typically used when you want to use a file-backed shared -memory area to communicate between processes (IPC) and do not particularly +memory area to communicate between processes (IPC) and do not particularly need the data being stored in that area to be physically written to disk. With this feature you get the equivalent performance with mmap that you would expect to get with SysV shared memory calls, but in a more controllable @@ -146,7 +146,7 @@ function will fail if: .It Bq Er EINVAL The virtual address range specified by the .Fa addr -and +and .Fa len arguments is not valid. .El diff --git a/lib/libc/sys/minherit.2 b/lib/libc/sys/minherit.2 index d80c172..265d6d27 100644 --- a/lib/libc/sys/minherit.2 +++ b/lib/libc/sys/minherit.2 @@ -84,9 +84,9 @@ arguments. .El .Sh SEE ALSO .Xr fork 2 , -.Xr madvise 2 , -.Xr mincore 2 , -.Xr mprotect 2 , +.Xr madvise 2 , +.Xr mincore 2 , +.Xr mprotect 2 , .Xr msync 2 , .Xr munmap 2 , .Xr rfork 2 diff --git a/lib/libc/sys/mkdir.2 b/lib/libc/sys/mkdir.2 index 91374ce..5db2074 100644 --- a/lib/libc/sys/mkdir.2 +++ b/lib/libc/sys/mkdir.2 @@ -110,5 +110,5 @@ points outside the process's allocated address space. .Sh STANDARDS The .Fn mkdir -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/mkfifo.2 b/lib/libc/sys/mkfifo.2 index aeed3d9..2a606cb 100644 --- a/lib/libc/sys/mkfifo.2 +++ b/lib/libc/sys/mkfifo.2 @@ -113,11 +113,11 @@ points outside the process's allocated address space. .El .Sh SEE ALSO .Xr chmod 2 , -.Xr mknod 2 , +.Xr mknod 2 , .Xr stat 2 , .Xr umask 2 .Sh STANDARDS The .Fn mkfifo -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index e9eb9d3..f4cb27e 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -137,7 +137,7 @@ Region is not included in a core file. .It Dv MAP_NOSYNC Causes data dirtied via this VM map to be flushed to physical media only when necessary (usually by the pager) rather then gratuitously. -Typically this prevents the update daemons from flushing pages dirtied +Typically this prevents the update daemons from flushing pages dirtied through such maps and thus allows efficient sharing of memory across unassociated processes using a file-backed shared memory map. Without this option any VM pages you dirty may be flushed to disk every so often @@ -193,7 +193,7 @@ The .Xr msync 2 system call is obsolete since .Bx -implements a coherent filesystem buffer cache. However, it may be +implements a coherent filesystem buffer cache. However, it may be used to associate dirty VM pages with filesystem buffers and thus cause them to be flushed to physical media sooner rather then later. .It Dv MAP_PRIVATE @@ -217,26 +217,26 @@ to enable this option for other architechures. implies .Dv MAP_ANON , and -.Fa offset -of 0. -.Fa fd -must be -1 and -.Fa prot +.Fa offset +of 0. +.Fa fd +must be -1 and +.Fa prot must include at least .Dv PROT_READ and .Dv PROT_WRITE . This option creates -a memory region that grows to at most -.Fa len +a memory region that grows to at most +.Fa len bytes in size, starting from the stack top and growing down. The -stack top is the starting address returned by the call, plus -.Fa len +stack top is the starting address returned by the call, plus +.Fa len bytes. The bottom of the stack at maximum growth is the starting address returned by the call. .El .Pp -The +The .Xr close 2 function does not unmap pages, see .Xr munmap 2 @@ -332,7 +332,7 @@ was specified and insufficient memory was available. .Sh BUGS .Fa len is limited to 2GB. Mmapping slightly more than 2GB doesn't work, but -it is possible to map a window of size (filesize % 2GB) for file sizes +it is possible to map a window of size (filesize % 2GB) for file sizes of slightly less than 2G, 4GB, 6GB and 8GB. .Pp The limit is imposed for a variety of reasons. diff --git a/lib/libc/sys/modfind.2 b/lib/libc/sys/modfind.2 index ad29f2e..c1ac0c6 100644 --- a/lib/libc/sys/modfind.2 +++ b/lib/libc/sys/modfind.2 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm modfind -.Nd returns the modid of a kernel module +.Nd returns the modid of a kernel module .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index efc3384..ef3d22d 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -82,7 +82,7 @@ suppress default semantics which affect filesystem access. .It Dv MNT_RDONLY The filesystem should be treated as read-only; Even the super-user may not write on it. -Specifying MNT_UPDATE without this option will upgrade +Specifying MNT_UPDATE without this option will upgrade a read-only filesystem to read/write. .It Dv MNT_NOEXEC Do not allow files to be executed from the filesystem. @@ -109,7 +109,7 @@ Disable write clustering. .Pp The flag .Dv MNT_UPDATE -indicates that the mount command is being applied +indicates that the mount command is being applied to an already mounted filesystem. This allows the mount flags to be changed without requiring that the filesystem be unmounted and remounted. @@ -164,7 +164,7 @@ The option requires the SUIDDIR option to have been compiled into the kernel to have any effect. See the -.Xr mount 8 +.Xr mount 8 and .Xr chmod 2 pages for more information. @@ -225,7 +225,7 @@ does not exist. .Ar Fspec is not a block device. .It Bq Er ENXIO -The major device number of +The major device number of .Ar fspec is out of range (this indicates no device driver exists for the associated hardware). diff --git a/lib/libc/sys/mprotect.2 b/lib/libc/sys/mprotect.2 index 4403dc5..7f46d24 100644 --- a/lib/libc/sys/mprotect.2 +++ b/lib/libc/sys/mprotect.2 @@ -54,7 +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, +Upon successful completion, .Fn mprotect returns 0. Otherwise a value of -1 is returned and diff --git a/lib/libc/sys/msync.2 b/lib/libc/sys/msync.2 index f9a7199..38fda84 100644 --- a/lib/libc/sys/msync.2 +++ b/lib/libc/sys/msync.2 @@ -58,7 +58,7 @@ is 0, all modified pages within the region containing will be flushed; if .Fa len -is non-zero, only those pages containing +is non-zero, only those pages containing .Fa addr and .Fa len-1 diff --git a/lib/libc/sys/nanosleep.2 b/lib/libc/sys/nanosleep.2 index 0c4749f..832684d 100644 --- a/lib/libc/sys/nanosleep.2 +++ b/lib/libc/sys/nanosleep.2 @@ -54,26 +54,26 @@ cause it to terminate the sleep early, regardless of the .Dv SA_RESTART value on the interrupting signal. .Sh RETURN VALUES -If the +If the .Fn nanosleep function returns because the requested time has elapsed, the value -returned will be zero. +returned will be zero. .Pp -If the +If the .Fn nanosleep function returns due to the delivery of a signal, the value returned will be the -1, and the global variable .Va errno will be set to indicate the interruption. -If +If .Fa rmtp -is +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 -.Fn nanosleep +.Fn nanosleep function shall return -1 and set .Va errno to the corresponding value: @@ -81,7 +81,7 @@ to the corresponding value: .It Bq Er EFAULT Either .Fa rqtp -or +or .Fa rmtp points to memory that is not a valid part of the process address space. diff --git a/lib/libc/sys/nfssvc.2 b/lib/libc/sys/nfssvc.2 index a852365..d28edc1 100644 --- a/lib/libc/sys/nfssvc.2 +++ b/lib/libc/sys/nfssvc.2 @@ -121,7 +121,7 @@ with the flags .Dv NFSSVC_MNTD and .Dv NFSSVC_GOTAUTH -after filling the ticket into the +after filling the ticket into the ncd_authstr field and setting the ncd_authlen and ncd_authtype diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index feb05c1..5e4aeeb 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -58,7 +58,7 @@ argument may indicate the file is to be created if it does not exist (by specifying the .Dv O_CREAT flag). -In this case +In this case .Nm requires a third argument .Fa "mode_t mode" , diff --git a/lib/libc/sys/pipe.2 b/lib/libc/sys/pipe.2 index 0e0043f..5bbc563 100644 --- a/lib/libc/sys/pipe.2 +++ b/lib/libc/sys/pipe.2 @@ -89,7 +89,7 @@ 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, +Otherwise, a value of -1 is returned and the variable .Va errno set to indicate the diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2 index 29a8538..a223b80 100644 --- a/lib/libc/sys/ptrace.2 +++ b/lib/libc/sys/ptrace.2 @@ -146,7 +146,7 @@ resumes execution, or 0 if no signal is to be sent. .It Dv PT_STEP The traced process is single stepped one instruction. The -.Fa addr +.Fa addr and .Fa data fields are not used. diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index 75de692..6fe4a09 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -91,7 +91,7 @@ The .Fa addr argument specifies a file from which to take the quotas. The quota file must exist; -it is normally created with the +it is normally created with the .Xr quotacheck 8 program. The @@ -115,7 +115,7 @@ Get disk quota limits and current usage for the user or group .Fa Addr is a pointer to a .Fa struct dqblk -structure (defined in +structure (defined in .Ao Pa ufs/ufs/quota.h Ac ) . .It Dv Q_SETQUOTA Set disk quota limits for the user or group @@ -124,7 +124,7 @@ Set disk quota limits for the user or group .Fa Addr is a pointer to a .Fa struct dqblk -structure (defined in +structure (defined in .Ao Pa ufs/ufs/quota.h Ac ) . The usage fields of the .Fa dqblk diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2 index 90c8e78..9c38809 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -62,7 +62,7 @@ into the buffer pointed to by .Fa buf . .Fn Readv performs the same action, but scatters the input data -into the +into the .Fa iovcnt buffers specified by the members of the .Fa iov @@ -71,9 +71,9 @@ array: iov[0], iov[1], ..., iov[iovcnt\|\-\|1]. performs the same function, but reads from the specified position in the file without modifying the file pointer. .Pp -For +For .Fn readv , -the +the .Fa iovec structure is defined as: .Pp @@ -84,10 +84,10 @@ struct iovec { }; .Ed .Pp -Each +Each .Fa iovec entry specifies the base address and length of an area -in memory where data should be placed. +in memory where data should be placed. .Fn Readv will always fill an area completely before proceeding to the next. @@ -199,7 +199,7 @@ The file was marked for non-blocking I/O, and no data were ready to be read. .El .Pp -In addition, +In addition, .Fn readv may return one of the following errors: .Bl -tag -width Er @@ -244,7 +244,7 @@ The file descriptor is associated with a pipe, socket, or FIFO. .Sh STANDARDS The .Fn read -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . The .Fn readv diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index 7830d77..7a49e41 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -70,9 +70,9 @@ the buffer associated with and modified on return to indicate the actual size of the address stored there. .Pp -The +The .Fn recv -call is normally used only on a +call is normally used only on a .Em connected socket (see .Xr connect 2 ) @@ -115,7 +115,7 @@ call may be used to determine when more data arrive. .Pp The .Fa flags -argument to a recv call is formed by +argument to a recv call is formed by .Em or Ap ing one or more of the values: .Bl -column MSG_WAITALL -offset indent @@ -142,7 +142,7 @@ or the next data to be received is of a different type than that returned. .Pp The .Fn recvmsg -call uses a +call uses a .Fa msghdr structure to minimize the number of directly supplied parameters. This structure has the following form, as defined in diff --git a/lib/libc/sys/rename.2 b/lib/libc/sys/rename.2 index 91bf125..41edfaf 100644 --- a/lib/libc/sys/rename.2 +++ b/lib/libc/sys/rename.2 @@ -50,10 +50,10 @@ causes the link named .Fa from to be renamed as .Fa to . -If +If .Fa to exists, it is first removed. -Both +Both .Fa from and .Fa to @@ -92,7 +92,7 @@ not the file or directory to which it points. .\".Ql rename a/foo b/bar .\"and .\".Ql rename b/bar a/foo , -.\"respectively, +.\"respectively, .\"the system may deadlock attempting to lock .\"both directories for modification. .\"Hard links to directories should be @@ -100,7 +100,7 @@ not the file or directory to which it points. .Sh RETURN VALUES A 0 value is returned if the operation succeeds, otherwise .Fn rename -returns -1 and the global variable +returns -1 and the global variable .Va errno indicates the reason for the failure. .Sh ERRORS @@ -197,5 +197,5 @@ is a directory and is not empty. .Sh STANDARDS The .Fn rename -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2 index bf205d3..1f96447 100644 --- a/lib/libc/sys/rfork.2 +++ b/lib/libc/sys/rfork.2 @@ -42,7 +42,7 @@ The current implementation requires this flag to always be set. If set, the child process will be dissociated from the parent. Upon exit the child will not leave a status for the parent to collect. -See +See .Xr wait 2 . .It RFFDG If set, the invoker's file descriptor table (see @@ -73,7 +73,7 @@ for information. If set, the kernel will force sharing the sigacts structure between the child and the parent. .It RFLINUXTHPN -If set, the kernel will return SIGUSR1 instead of SIGCHILD upon thread +If set, the kernel will return SIGUSR1 instead of SIGCHILD upon thread exit for the child. This is intended to mimic certain Linux clone behaviour. .El .Pp diff --git a/lib/libc/sys/rtprio.2 b/lib/libc/sys/rtprio.2 index 3f902c0..bfd72c4 100644 --- a/lib/libc/sys/rtprio.2 +++ b/lib/libc/sys/rtprio.2 @@ -1,6 +1,6 @@ .\" Copyright (c) 1994, Henrik Vestergaard Draboel .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -26,7 +26,7 @@ .\" 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$ .\" .Dd July 23, 1994 @@ -40,7 +40,7 @@ .Sh SYNOPSIS .Fd #include <sys/types.h> .Fd #include <sys/rtprio.h> -.Ft int +.Ft int .Fn rtprio "int function" "pid_t pid" "struct rtprio *rtp" .Sh DESCRIPTION .Fn rtprio @@ -48,13 +48,13 @@ is used to lookup or change the realtime or idle priority of a process. .Pp .Fa function specifies the operation to be performed. -RTP_LOOKUP to lookup the current priority, +RTP_LOOKUP to lookup the current priority, and RTP_SET to set the priority. .Fa pid specifies the process to be used, 0 for the current process. .Pp .Fa *rtp -is a pointer to a struct rtprio which is used to specify the priority and priority type. +is a pointer to a struct rtprio which is used to specify the priority and priority type. This structure has the following form: .Bd -literal struct rtprio { @@ -69,7 +69,7 @@ field may be RTP_PRIO_REALTIME for realtime priorities, RTP_PRIO_NORMAL for normal priorities, and RTP_PRIO_IDLE for idle priorities. The priority specified by the .Nm prio -field ranges between 0 and +field ranges between 0 and .Dv RTP_PRIO_MAX (usually 31) . 0 is the highest possible priority. .Pp @@ -89,7 +89,7 @@ The global variable will be set to indicate the error. .Sh ERRORS .Fn rtprio -will fail if +will fail if .Bl -tag -width Er .It Bq Er EINVAL The specified diff --git a/lib/libc/sys/sched_get_priority_max.2 b/lib/libc/sys/sched_get_priority_max.2 index cebce15..20b2459 100644 --- a/lib/libc/sys/sched_get_priority_max.2 +++ b/lib/libc/sys/sched_get_priority_max.2 @@ -118,7 +118,7 @@ No process can be found corresponding to that specified by .Xr sched_set_scheduler 2 .Sh STANDARDS The -.Fn sched_setscheduler +.Fn sched_setscheduler and .Fn sched_getscheduler functions conform to diff --git a/lib/libc/sys/sched_setparam.2 b/lib/libc/sys/sched_setparam.2 index d937114..57b077f 100644 --- a/lib/libc/sys/sched_setparam.2 +++ b/lib/libc/sys/sched_setparam.2 @@ -167,7 +167,7 @@ is outside the range defined for the scheduling policy of the specified .Xr sched_yield 2 .Sh STANDARDS The -.Fn sched_setparam +.Fn sched_setparam and .Fn sched_getparam functions conform to diff --git a/lib/libc/sys/sched_setscheduler.2 b/lib/libc/sys/sched_setscheduler.2 index ff3d5ad..b616e6d 100644 --- a/lib/libc/sys/sched_setscheduler.2 +++ b/lib/libc/sys/sched_setscheduler.2 @@ -162,7 +162,7 @@ is outside the valid range for the specified scheduling policy. .Xr sched_yield 2 .Sh STANDARDS The -.Fn sched_setscheduler +.Fn sched_setscheduler and .Fn sched_getscheduler functions conform to diff --git a/lib/libc/sys/sched_yield.2 b/lib/libc/sys/sched_yield.2 index ed886c7..ee5c123 100644 --- a/lib/libc/sys/sched_yield.2 +++ b/lib/libc/sys/sched_yield.2 @@ -41,7 +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 +The .Fn sched_yield function will return zero if it completes successfully, or it will return a value of -1 and set @@ -57,6 +57,6 @@ The system is not configured to support this functionality. .El .Sh STANDARDS The -.Fn sched_yield +.Fn sched_yield function conforms to .St -p1003.1b-93 . diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2 index 058041f..9837eb5 100644 --- a/lib/libc/sys/select.2 +++ b/lib/libc/sys/select.2 @@ -110,7 +110,7 @@ is a non-nil pointer, it specifies the maximum interval to wait for the selection to complete. System activity can lengthen the interval by an indeterminate amount. .Pp -If +If .Fa timeout is a nil pointer, the select blocks indefinitely. .Pp @@ -168,7 +168,7 @@ was invalid. The default size of .Dv FD_SETSIZE is currently 1024. -In order to accommodate programs which might potentially +In order to accommodate programs which might potentially use a larger number of open files with .Fn select , it is possible @@ -179,14 +179,14 @@ before the inclusion of any header which includes .Pp If .Fa nfds -is greater than the number of open files, +is greater than the number of open files, .Fn select is not guaranteed to examine the unused file descriptors. For historical -reasons, +reasons, .Fn select will always examine the first 256 descriptors. .Sh BUGS -.St -susv2 +.St -susv2 allows systems to modify the original timeout in place. Thus, it is unwise to assume that the timeout value will be unmodified by the diff --git a/lib/libc/sys/semctl.2 b/lib/libc/sys/semctl.2 index 4446586..2b3df68 100644 --- a/lib/libc/sys/semctl.2 +++ b/lib/libc/sys/semctl.2 @@ -47,7 +47,7 @@ on the semaphore set indicated by .Fa semid . A fourth argument, a .Fa "union semun arg" , -is required for certain values of +is required for certain values of .Fa cmd . For the commands that use the .Fa arg diff --git a/lib/libc/sys/semop.2 b/lib/libc/sys/semop.2 index b029d3a..3ead1dc 100644 --- a/lib/libc/sys/semop.2 +++ b/lib/libc/sys/semop.2 @@ -152,7 +152,7 @@ When is zero, the process waits for the semaphore's value to become zero. If it is already zero, the call to .Fn semop -can return immediately. Otherwise, the calling process is put to +can return immediately. Otherwise, the calling process is put to sleep until the semaphore's value becomes zero. .El .Pp diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2 index f5749ee..6929ff1 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -58,9 +58,9 @@ and .Fn sendmsg are used to transmit a message to another socket. .Fn Send -may be used only when the socket is in a +may be used only when the socket is in a .Em connected -state, while +state, while .Fn sendto and .Fn sendmsg @@ -68,7 +68,7 @@ may be used at any time. .Pp The address of the target is given by .Fa to -with +with .Fa tolen specifying its size. The length of the message is given by @@ -130,7 +130,7 @@ protocol family, and is used to implement Transaction .Dv MSG_DONTROUTE is usually used only by diagnostic or routing programs. .Pp -See +See .Xr recv 2 for a description of the .Fa msghdr @@ -148,7 +148,7 @@ fail if: .It Bq Er EBADF An invalid descriptor was specified. .It Bq Er EACCES -The destination address is a broadcast address, and +The destination address is a broadcast address, and .Dv SO_BROADCAST has not been set on the socket. .It Bq Er ENOTSOCK diff --git a/lib/libc/sys/setgroups.2 b/lib/libc/sys/setgroups.2 index 0974f93..668b3dc 100644 --- a/lib/libc/sys/setgroups.2 +++ b/lib/libc/sys/setgroups.2 @@ -48,7 +48,7 @@ .Sh DESCRIPTION .Fn Setgroups sets the group access list of the current user process -according to the array +according to the array .Fa gidset . The parameter .Fa ngroups diff --git a/lib/libc/sys/setpgid.2 b/lib/libc/sys/setpgid.2 index c5c8cec..d9178b5 100644 --- a/lib/libc/sys/setpgid.2 +++ b/lib/libc/sys/setpgid.2 @@ -82,7 +82,7 @@ of the calling process. .Sh STANDARDS The .Fn setpgid -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh COMPATIBILITY .Fn Setpgrp diff --git a/lib/libc/sys/setreuid.2 b/lib/libc/sys/setreuid.2 index 102d32b..aa87657 100644 --- a/lib/libc/sys/setreuid.2 +++ b/lib/libc/sys/setreuid.2 @@ -49,7 +49,7 @@ The real and effective user IDs of the current process are set according to the arguments. If .Fa ruid -or +or .Fa euid is -1, the current uid is filled in by the system. Unprivileged users may change the real user @@ -75,7 +75,7 @@ the standard .Fn setuid function is preferred. .Sh RETURN VALUES -.Rv -std setreuid +.Rv -std setreuid .Sh ERRORS .Bl -tag -width Er .It Bq Er EPERM diff --git a/lib/libc/sys/setuid.2 b/lib/libc/sys/setuid.2 index 9374e93..4ef4d35 100644 --- a/lib/libc/sys/setuid.2 +++ b/lib/libc/sys/setuid.2 @@ -148,7 +148,7 @@ The .Fn seteuid and .Fn setegid -functions are extensions based on the +functions are extensions based on the .Tn POSIX concept of .Li _POSIX_SAVED_IDS , diff --git a/lib/libc/sys/shmat.2 b/lib/libc/sys/shmat.2 index 3c3e40f..6f7dc13 100644 --- a/lib/libc/sys/shmat.2 +++ b/lib/libc/sys/shmat.2 @@ -60,7 +60,7 @@ If is 0, the segment is attached at an address selected by the kernel. .It -If +If .Fa addr is nonzero and SHM_RND is not specified in .Fa flag , diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2 index bf0bb58..b176c53 100644 --- a/lib/libc/sys/shmget.2 +++ b/lib/libc/sys/shmget.2 @@ -134,7 +134,7 @@ corresponding to .Fa key already exists. .El -.Sh "SEE ALSO" +.Sh "SEE ALSO" .Xr shmat 2 , .Xr shmctl 2 , .Xr shmdt 2 , diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index e35469e..1d1c98f 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -58,10 +58,10 @@ struct sigaction { .Sh DESCRIPTION The system defines a set of signals that may be delivered to a process. Signal delivery resembles the occurrence of a hardware interrupt: -the signal is normally blocked from further occurrence, the current process +the signal is normally blocked from further occurrence, the current process context is saved, and a new one is built. A process may specify a .Em handler -to which a signal is delivered, or specify that a signal is to be +to which a signal is delivered, or specify that a signal is to be .Em ignored . A process may also specify that a default action is to be taken by the system when a signal occurs. @@ -80,7 +80,7 @@ Signal routines normally execute with the signal that caused their invocation .Em blocked , but other signals may yet occur. -A global +A global .Em "signal mask" defines the set of signals currently blocked from delivery to a process. The signal mask for a process is initialized @@ -107,7 +107,7 @@ The set of pending signals is returned by the function. When a caught signal is delivered, the current state of the process is saved, -a new signal mask is calculated (as described below), +a new signal mask is calculated (as described below), and the signal handler is invoked. The call to the handler is arranged so that if the signal handling routine returns normally the process will resume execution in the context @@ -121,7 +121,7 @@ installed for the duration of the process' signal handler .Xr sigprocmask call is made). This mask is formed by taking the union of the current signal mask set, -the signal to be delivered, and +the signal to be delivered, and the signal mask associated with the handler to be invoked. .Pp .Fn Sigaction @@ -135,7 +135,7 @@ specifies an action .Dv SIG_IGN , or a handler routine) and mask to be used when delivering the specified signal. -If +If .Fa oact is non-zero, the previous handling information for the signal is returned to the user. @@ -143,7 +143,7 @@ is returned to the user. Once a signal handler is installed, it normally remains installed until another .Fn sigaction -call is made, or an +call is made, or an .Xr execve 2 is performed. A signal-specific default action may be reset by @@ -212,11 +212,11 @@ See paragraph below. 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 -.Sx EXAMPLES . -This bit should not be set when assigning -.Dv SIG_DFL -or -.Dv SIG_IGN . +.Sx EXAMPLES . +This bit should not be set when assigning +.Dv SIG_DFL +or +.Dv SIG_IGN . .El .Pp If a signal is caught during the system calls listed below, @@ -311,7 +311,7 @@ is possible on a descriptor (see .Sh NOTE The .Fa sa_mask -field specified in +field specified in .Fa act is not allowed to block .Dv SIGKILL @@ -322,7 +322,7 @@ Any attempt to do so will be silently ignored. The following functions are either reentrant or not interruptible by signals and are async-signal safe. Therefore applications may -invoke them, without restriction, from signal-catching functions: +invoke them, without restriction, from signal-catching functions: .Pp Base Interfaces: .Pp @@ -462,14 +462,14 @@ The .Dv sa_handler member declaration in .Fx -include files is that of ANSI C (as required by POSIX), +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 compile without warning. The traditional BSD style is not portable and since its capabilities are a full subset of a SA_SIGINFO handler, its use is deprecated. .Pp -The +The .Fa sig argument is the signal number, one of the .Dv SIG... @@ -506,7 +506,7 @@ of the following occurs: .It Bq Er EFAULT Either .Fa act -or +or .Fa oact points to memory that is not a valid part of the process address space. @@ -522,7 +522,7 @@ or .Sh STANDARDS The .Fn sigaction -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . The .Dv SA_ONSTACK diff --git a/lib/libc/sys/sigaltstack.2 b/lib/libc/sys/sigaltstack.2 index 171cafc..d69b34b 100644 --- a/lib/libc/sys/sigaltstack.2 +++ b/lib/libc/sys/sigaltstack.2 @@ -70,7 +70,7 @@ call), the system checks to see if the process is currently executing on that stack. If the process is not currently executing on the signal stack, the system arranges a switch to the signal stack for the -duration of the signal handler's execution. +duration of the signal handler's execution. .Pp If .Dv SS_DISABLE @@ -134,7 +134,7 @@ 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 +Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/sigpending.2 b/lib/libc/sys/sigpending.2 index e05d186..361a918 100644 --- a/lib/libc/sys/sigpending.2 +++ b/lib/libc/sys/sigpending.2 @@ -76,5 +76,5 @@ argument specified an invalid address. .Sh STANDARDS The .Fn sigpending -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2 index 674f453..6325b81 100644 --- a/lib/libc/sys/sigreturn.2 +++ b/lib/libc/sys/sigreturn.2 @@ -89,7 +89,7 @@ This system call is not available in 4.2 hence it should not be used if backward compatibility is needed. .Sh RETURN VALUES If successful, the system call does not return. -Otherwise, a value of -1 is returned and +Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/sigstack.2 b/lib/libc/sys/sigstack.2 index 61f58db..9f1dfa9 100644 --- a/lib/libc/sys/sigstack.2 +++ b/lib/libc/sys/sigstack.2 @@ -41,7 +41,7 @@ .Sh LIBRARY .Lb libc .Sh DESCRIPTION -The +The .Fn sigstack function has been deprecated in favor of the interface described in .Xr sigaltstack 2 . diff --git a/lib/libc/sys/sigsuspend.2 b/lib/libc/sys/sigsuspend.2 index b3984be..280d6d9 100644 --- a/lib/libc/sys/sigsuspend.2 +++ b/lib/libc/sys/sigsuspend.2 @@ -78,5 +78,5 @@ set to .Sh STANDARDS The .Fn sigsupend -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/sigwait.2 b/lib/libc/sys/sigwait.2 index 818a623..bd46b1c 100644 --- a/lib/libc/sys/sigwait.2 +++ b/lib/libc/sys/sigwait.2 @@ -1,6 +1,6 @@ .\" Copyright (C) 2000 Jason Evans <jasone@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: @@ -12,7 +12,7 @@ .\" notice(s), 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 COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR @@ -24,7 +24,7 @@ .\" WHETHER IN CONTRACT, STRICT 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$ .Dd April 27, 2000 .Dt SIGWAIT 3 diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index ef98bf5..ef2669f 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -161,7 +161,7 @@ Once connected, data may be transferred using .Xr read 2 and .Xr write 2 -calls or some variant of the +calls or some variant of the .Xr send 2 and .Xr recv 2 @@ -212,7 +212,7 @@ sockets employ the same system calls as .Dv SOCK_STREAM sockets. The only difference -is that +is that .Xr read 2 calls will return only the amount of data requested, and any remaining in the arriving packet will be discarded. @@ -227,7 +227,7 @@ calls. Datagrams are generally received with .Xr recvfrom 2 , which returns the next datagram with its return address. .Pp -An +An .Xr fcntl 2 call can be used to specify a process group to receive a diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index f65c970..9984a1e 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -271,7 +271,7 @@ The .Fn stat and .Fn fstat -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2 index 1eb2b05..16e7e16 100644 --- a/lib/libc/sys/swapon.2 +++ b/lib/libc/sys/swapon.2 @@ -46,12 +46,12 @@ .Fn swapon "const char *special" .Sh DESCRIPTION .Fn Swapon -makes the block device +makes the block device .Fa special available to the system for allocation for paging and swapping. The names of potentially available devices are known to the system and defined at system -configuration time. The size of the swap area on +configuration time. The size of the swap area on .Fa special is calculated at the time the device is first made available for swapping. @@ -90,7 +90,7 @@ The device configured by was not configured into the system as a swap device. .It Bq Er ENXIO -The major device number of +The major device number of .Fa special is out of range (this indicates no device driver exists for the associated hardware). diff --git a/lib/libc/sys/sync.2 b/lib/libc/sys/sync.2 index f5e112c..d60c0e4 100644 --- a/lib/libc/sys/sync.2 +++ b/lib/libc/sys/sync.2 @@ -45,7 +45,7 @@ .Ft void .Fn sync void .Sh DESCRIPTION -The +The .Fn sync function forces a write of dirty (modified) buffers in the block buffer cache out @@ -58,7 +58,7 @@ call is issued frequently by the user process .Xr syncer 4 -(about every 30 seconds). +(about every 30 seconds). .Pp The function .Xr fsync 2 diff --git a/lib/libc/sys/umask.2 b/lib/libc/sys/umask.2 index 4e7815b..026a983 100644 --- a/lib/libc/sys/umask.2 +++ b/lib/libc/sys/umask.2 @@ -81,7 +81,7 @@ function is always successful. .Sh STANDARDS The .Fn umask -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY An diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2 index fdf893f..84a0a0d 100644 --- a/lib/libc/sys/utimes.2 +++ b/lib/libc/sys/utimes.2 @@ -60,9 +60,9 @@ or referenced by are changed as specified by the argument .Fa times . .Pp -If +If .Fa times -is +is .Dv NULL , the access and modification times are set to the current time. The caller must be the owner of the file, have permission to @@ -71,7 +71,7 @@ write the file, or be the super-user. If .Fa times is -.Pf non- Dv NULL , +.Pf non- Dv NULL , it is assumed to point to an array of two timeval structures. The access time is set to the value of the first element, and the modification time is set to the value of the second element. @@ -120,9 +120,9 @@ An I/O error occurred while reading or writing the affected inode. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv NAME_MAX -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv PATH_MAX characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2 index 91a28ee..49e36b6 100644 --- a/lib/libc/sys/vfork.2 +++ b/lib/libc/sys/vfork.2 @@ -104,7 +104,7 @@ Same as for .Xr fork 2 . .Sh BUGS This system call will be eliminated when proper system sharing -mechanisms are implemented. +mechanisms are implemented. Users should not depend on the memory sharing semantics of .Xr vfork 2 diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2 index 3fa5c2b..bbb2c57 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -63,9 +63,9 @@ function suspends execution of its calling process until .Fa status information is available for a terminated child process, or a signal is received. -On return from a successful +On return from a successful .Fn wait -call, +call, the .Fa status area contains termination information about the process that exited @@ -131,9 +131,9 @@ for stopped processes). When the .Dv WNOHANG option is specified and no processes -wish to report status, +wish to report status, .Fn wait4 -returns a +returns a process id of 0. .Pp diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index 255447d..5d4fdc2 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -62,7 +62,7 @@ from the buffer pointed to by .Fa buf . .Fn Writev performs the same action, but gathers the output data -from the +from the .Fa iovcnt buffers specified by the members of the .Fa iov @@ -71,9 +71,9 @@ array: iov[0], iov[1], ..., iov[iovcnt\|-\|1]. performs the same function, but writes to the specified position in the file without modifying the file pointer. .Pp -For +For .Fn writev , -the +the .Fa iovec structure is defined as: .Pp @@ -84,7 +84,7 @@ struct iovec { }; .Ed .Pp -Each +Each .Fa iovec entry specifies the base address and length of an area in memory from which data should be written. @@ -221,7 +221,7 @@ The file was marked for non-blocking I/O, and no data could be written immediately. .El .Pp -In addition, +In addition, .Fn writev may return one of the following errors: .Bl -tag -width Er @@ -269,7 +269,7 @@ The file descriptor is associated with a pipe, socket, or FIFO. .Sh STANDARDS The .Fn write -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . The .Fn writev |
