diff options
author | ru <ru@FreeBSD.org> | 2002-12-19 09:40:28 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2002-12-19 09:40:28 +0000 |
commit | 51fe7c1a888747c57136cc34ec54a93a0487b745 (patch) | |
tree | f0781cb8e5be3a35234a6d0c123d6ae11ba70e40 /lib/libc/sys | |
parent | 3424a53ebeadf7ab320c37cf93702953cee94efe (diff) | |
download | FreeBSD-src-51fe7c1a888747c57136cc34ec54a93a0487b745.zip FreeBSD-src-51fe7c1a888747c57136cc34ec54a93a0487b745.tar.gz |
mdoc(7) police: "The .Fa argument.".
Diffstat (limited to 'lib/libc/sys')
101 files changed, 507 insertions, 177 deletions
diff --git a/lib/libc/sys/accept.2 b/lib/libc/sys/accept.2 index b0adcbd..2f86735 100644 --- a/lib/libc/sys/accept.2 +++ b/lib/libc/sys/accept.2 @@ -79,16 +79,17 @@ remains open. .Pp The argument .Fa addr -is a result parameter that is filled-in with +is a result argument that is filled-in with the address of the connecting entity, as known to the communications layer. The exact format of the .Fa addr -parameter is determined by the domain in which the communication +argument is determined by the domain in which the communication is occurring. The .Fa addrlen -is a value-result parameter; it should initially contain the +argument +is a value-result argument; it should initially contain the amount of space pointed to by .Fa addr ; on return it will contain the actual length (in bytes) of the @@ -145,7 +146,7 @@ has not been called on the socket descriptor. .It Bq Er EFAULT The .Fa addr -parameter is not in a writable part of the +argument is not in a writable part of the user address space. .It Bq Er EWOULDBLOCK The socket is marked non-blocking and no connections diff --git a/lib/libc/sys/access.2 b/lib/libc/sys/access.2 index 0d3611a..94e7831 100644 --- a/lib/libc/sys/access.2 +++ b/lib/libc/sys/access.2 @@ -122,7 +122,9 @@ Permission bits of the file mode do not permit the requested access, or search permission is denied on a component of the path prefix. .It Bq Er EFAULT +The .Fa path +argument points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2 index 7db84c8..2786fe4 100644 --- a/lib/libc/sys/acct.2 +++ b/lib/libc/sys/acct.2 @@ -103,7 +103,9 @@ Too many symbolic links were encountered in translating the pathname. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa File +The +.Fa file +argument points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/aio_cancel.2 b/lib/libc/sys/aio_cancel.2 index 7f2399b..c9c5b04 100644 --- a/lib/libc/sys/aio_cancel.2 +++ b/lib/libc/sys/aio_cancel.2 @@ -78,7 +78,9 @@ An error return from indicates: .Bl -tag -width Er .It Bq Er EBADF +The .Fa fildes +argument is an invalid file descriptor. .El .Sh SEE ALSO diff --git a/lib/libc/sys/aio_error.2 b/lib/libc/sys/aio_error.2 index 444e281..0d1e1de 100644 --- a/lib/libc/sys/aio_error.2 +++ b/lib/libc/sys/aio_error.2 @@ -67,7 +67,9 @@ The system call will fail if: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa iocb +argument does not reference an outstanding asynchronous I/O request. .El .Sh SEE ALSO diff --git a/lib/libc/sys/aio_read.2 b/lib/libc/sys/aio_read.2 index 8090963..c52629e 100644 --- a/lib/libc/sys/aio_read.2 +++ b/lib/libc/sys/aio_read.2 @@ -59,6 +59,7 @@ of the calling process minus .Pp The .Fa iocb->aio_lio_opcode +argument is ignored by the .Fn aio_read system call. @@ -137,7 +138,9 @@ returned in .Pp .Bl -tag -width Er .It Bq Er EBADF +The .Fa iocb->aio_fildes +argument is invalid. .It Bq Er EINVAL The offset @@ -169,7 +172,9 @@ system call is either one of the error returns from the system call, or one of: .Bl -tag -width Er .It Bq Er EBADF +The .Fa iocb->aio_fildes +argument is invalid for reading. .It Bq Er ECANCELED The request was explicitly cancelled via a call to diff --git a/lib/libc/sys/aio_return.2 b/lib/libc/sys/aio_return.2 index b12b787..07bc0ae 100644 --- a/lib/libc/sys/aio_return.2 +++ b/lib/libc/sys/aio_return.2 @@ -71,7 +71,9 @@ The system call will fail if: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa iocb +argument does not reference an outstanding asynchronous I/O request. .El .Sh SEE ALSO diff --git a/lib/libc/sys/aio_suspend.2 b/lib/libc/sys/aio_suspend.2 index 7c88bf8..d8e74a9 100644 --- a/lib/libc/sys/aio_suspend.2 +++ b/lib/libc/sys/aio_suspend.2 @@ -45,7 +45,9 @@ delivered, or the .Fa timeout has passed. .Pp +The .Fa iocbs +argument is an array of .Fa niocb pointers to asynchronous I/O requests. Array members containing @@ -77,7 +79,9 @@ the .Fa timeout expired before any I/O requests completed. .It Bq Er EINVAL +The .Fa iocbs +argument contains more than .Dv AIO_LISTIO_MAX asynchronous I/O requests, or at least one of the requests is not diff --git a/lib/libc/sys/aio_write.2 b/lib/libc/sys/aio_write.2 index 9858ea9..7148c7f 100644 --- a/lib/libc/sys/aio_write.2 +++ b/lib/libc/sys/aio_write.2 @@ -139,7 +139,9 @@ returned in .Pp .Bl -tag -width Er .It Bq Er EBADF +The .Fa iocb->aio_fildes +argument is invalid, or is not opened for writing. .It Bq Er EINVAL The offset @@ -163,7 +165,9 @@ system call is either one of the error returns from the system call, or one of: .Bl -tag -width Er .It Bq Er EBADF +The .Fa iocb->aio_fildes +argument is invalid for writing. .It Bq Er ECANCELED The request was explicitly canceled via a call to diff --git a/lib/libc/sys/bind.2 b/lib/libc/sys/bind.2 index 33e228c..9cad897 100644 --- a/lib/libc/sys/bind.2 +++ b/lib/libc/sys/bind.2 @@ -82,10 +82,14 @@ system call will fail if: Kernel resources to complete the request are temporarily unavailable. .It Bq Er EBADF -.Fa S +The +.Fa s +argument is not a valid descriptor. .It Bq Er ENOTSOCK -.Fa S +The +.Fa s +argument is not a socket. .It Bq Er EADDRNOTAVAIL The specified address is not available from the local machine. @@ -97,7 +101,7 @@ has inadequate permission to access it. .It Bq Er EFAULT The .Fa addr -parameter is not in a valid part of the user +argument is not in a valid part of the user address space. .El .Pp diff --git a/lib/libc/sys/chdir.2 b/lib/libc/sys/chdir.2 index 373892b..8e8214e 100644 --- a/lib/libc/sys/chdir.2 +++ b/lib/libc/sys/chdir.2 @@ -94,7 +94,9 @@ Too many symbolic links were encountered in translating the pathname. Search permission is denied for any component of the path name. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/chflags.2 b/lib/libc/sys/chflags.2 index 70e3d89..f80e671 100644 --- a/lib/libc/sys/chflags.2 +++ b/lib/libc/sys/chflags.2 @@ -142,7 +142,9 @@ the effective user ID is not the super-user. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .It Bq Er EIO An @@ -159,7 +161,9 @@ system call will fail if: .It Bq Er EBADF The descriptor is not valid. .It Bq Er EINVAL +The .Fa fd +argument refers to a socket, not to a file. .It Bq Er EPERM The effective user ID does not match the owner of the file and diff --git a/lib/libc/sys/chmod.2 b/lib/libc/sys/chmod.2 index 8c92be2..e703df1 100644 --- a/lib/libc/sys/chmod.2 +++ b/lib/libc/sys/chmod.2 @@ -181,7 +181,9 @@ the effective user ID is not the super-user. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. @@ -196,7 +198,9 @@ system call will fail if: .It Bq Er EBADF The descriptor is not valid. .It Bq Er EINVAL +The .Fa fd +argument refers to a socket, not to a file. .It Bq Er EROFS The file resides on a read-only file system. diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2 index d663776..555ee38 100644 --- a/lib/libc/sys/chown.2 +++ b/lib/libc/sys/chown.2 @@ -122,7 +122,9 @@ The effective user ID is not the super-user. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. @@ -133,10 +135,14 @@ The system call will fail if: .Bl -tag -width Er .It Bq Er EBADF +The .Fa fd +argument does not refer to a valid descriptor. .It Bq Er EINVAL +The .Fa fd +argument refers to a socket, not a file. .It Bq Er EPERM The effective user ID is not the super-user. diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2 index 78bdfb6..148bcd5 100644 --- a/lib/libc/sys/chroot.2 +++ b/lib/libc/sys/chroot.2 @@ -45,7 +45,9 @@ .Ft int .Fn chroot "const char *dirname" .Sh DESCRIPTION -.Fa Dirname +The +.Fa dirname +argument is the address of the pathname of a directory, terminated by an ASCII NUL. The .Fn chroot @@ -120,7 +122,9 @@ Search permission is denied for any component of the path name. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er EFAULT +The .Fa dirname +argument points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/clock_gettime.2 b/lib/libc/sys/clock_gettime.2 index 0e41168..f6ee311 100644 --- a/lib/libc/sys/clock_gettime.2 +++ b/lib/libc/sys/clock_gettime.2 @@ -60,7 +60,9 @@ allow the calling process to retrieve or set the value used by a clock which is specifed by .Fa clock_id . .Pp +The .Fa clock_id +argument can be one of three values: CLOCK_REALTIME for time that increments as a wall clock should, CLOCK_VIRTUAL for time that increments only when the CPU is running in user mode on behalf of the calling process, or @@ -103,6 +105,7 @@ The following error codes may be set in .It Bq Er EINVAL The .Fa clock_id +argument was not a valid value. .It Bq Er EFAULT The diff --git a/lib/libc/sys/close.2 b/lib/libc/sys/close.2 index 16abee5..16b3ff9 100644 --- a/lib/libc/sys/close.2 +++ b/lib/libc/sys/close.2 @@ -109,7 +109,9 @@ The system call will fail if: .Bl -tag -width Er .It Bq Er EBADF -.Fa D +The +.Fa d +argument is not an active descriptor. .It Bq Er EINTR An interrupt was received. diff --git a/lib/libc/sys/connect.2 b/lib/libc/sys/connect.2 index 79ab4f9..dc91aef 100644 --- a/lib/libc/sys/connect.2 +++ b/lib/libc/sys/connect.2 @@ -46,8 +46,9 @@ .Ft int .Fn connect "int s" "const struct sockaddr *name" "socklen_t namelen" .Sh DESCRIPTION -The parameter +The .Fa s +argument is a socket. If it is of type .Dv SOCK_DGRAM , @@ -63,7 +64,7 @@ The other socket is specified by which is an address in the communications space of the socket. Each communications space interprets the .Fa name -parameter in its own way. +argument in its own way. Generally, stream sockets may successfully .Fn connect only once; datagram sockets may use @@ -79,10 +80,14 @@ The system call fails if: .Bl -tag -width Er .It Bq Er EBADF +The .Fa s +argument is not a valid descriptor. .It Bq Er ENOTSOCK +The .Fa s +argument is a descriptor for a file, not a socket. .It Bq Er EADDRNOTAVAIL The specified address is not available on this machine. @@ -101,7 +106,7 @@ The address is already in use. .It Bq Er EFAULT The .Fa name -parameter specifies an area outside +argument specifies an area outside the process address space. .It Bq Er EINPROGRESS The socket is non-blocking diff --git a/lib/libc/sys/dup.2 b/lib/libc/sys/dup.2 index 10cbc79..f4da9f5 100644 --- a/lib/libc/sys/dup.2 +++ b/lib/libc/sys/dup.2 @@ -130,9 +130,11 @@ and system calls fail if: .Bl -tag -width Er .It Bq Er EBADF -.Fa Oldd +The +.Fa oldd or .Fa newd +argument is not a valid active descriptor .It Bq Er EMFILE Too many descriptors are active. diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2 index 19b9f8d..9b0f22c 100644 --- a/lib/libc/sys/execve.2 +++ b/lib/libc/sys/execve.2 @@ -258,10 +258,12 @@ MIB variable The new process file is not as long as indicated by the size values in its header. .It Bq Er EFAULT -.Fa Path , +The +.Fa path , .Fa argv , or .Fa envp +arguments point to an illegal address. .It Bq Er EIO diff --git a/lib/libc/sys/extattr_get_file.2 b/lib/libc/sys/extattr_get_file.2 index 5716cc2..5c2f058 100644 --- a/lib/libc/sys/extattr_get_file.2 +++ b/lib/libc/sys/extattr_get_file.2 @@ -178,13 +178,16 @@ Additionally, the file system implementing the call may return any other errors it desires. .Bl -tag -width Er .It Bq Er EFAULT -.Fa attrnamespace , -.Fa attrname , +The +.Fa attrnamespace +and +.Fa attrname +arguments, or the memory range defined by .Fa data and .Fa nbytes -points outside the process's allocated address space. +point outside the process's allocated address space. .It Bq Er ENAMETOOLONG The attribute name was longer than .Dv EXTATTR_MAXNAMELEN . diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2 index 5d5a252..c9dc8e7 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -409,7 +409,9 @@ or the type is an exclusive lock and some portion of the segment of a file to be locked is already shared-locked or exclusive-locked by another process. .It Bq Er EBADF -.Fa \&Fd +The +.Fa fd +argument is not a valid open file descriptor. .Pp The argument @@ -452,7 +454,9 @@ is .Dv F_SETLKW , and the system call was interrupted by a signal. .It Bq Er EINVAL -.Fa Cmd +The +.Fa cmd +argument is .Dv F_DUPFD and @@ -513,14 +517,18 @@ and an .Fa off_t calculation overflowed. .It Bq Er EPERM -.Fa Cmd +The +.Fa cmd +argument is .Dv F_SETOWN and the process ID or process group given as an argument is in a different session than the caller. .It Bq Er ESRCH -.Fa Cmd +The +.Fa cmd +argument is .Dv F_SETOWN and diff --git a/lib/libc/sys/fhopen.2 b/lib/libc/sys/fhopen.2 index a48f9d0..2bbb42b 100644 --- a/lib/libc/sys/fhopen.2 +++ b/lib/libc/sys/fhopen.2 @@ -69,7 +69,8 @@ for reading and/or writing as specified by the argument and returns the file descriptor to the calling process. The .Fa flags -are specified by +argument +is specified by .Em or Ns 'ing together the flags used for the .Xr open 2 diff --git a/lib/libc/sys/flock.2 b/lib/libc/sys/flock.2 index 40f071d..3cfc7cc 100644 --- a/lib/libc/sys/flock.2 +++ b/lib/libc/sys/flock.2 @@ -57,7 +57,7 @@ lock on the file associated with the file descriptor .Fa fd . A lock is applied by specifying an .Fa operation -parameter that is one of +argument that is one of .Dv LOCK_SH or .Dv LOCK_EX diff --git a/lib/libc/sys/fork.2 b/lib/libc/sys/fork.2 index 1c699bb..a1adafd 100644 --- a/lib/libc/sys/fork.2 +++ b/lib/libc/sys/fork.2 @@ -114,7 +114,9 @@ MIB variable .Dv KERN_MAXPROCPERUID . .It Bq Er EAGAIN The user is not the super user, and -the soft resource limit corresponding to the resource parameter +the soft resource limit corresponding to the +.Fa resource +argument .Dv RLIMIT_NPROC would be exceeded (see .Xr getrlimit 2 ) . diff --git a/lib/libc/sys/fsync.2 b/lib/libc/sys/fsync.2 index 883177e..644f337 100644 --- a/lib/libc/sys/fsync.2 +++ b/lib/libc/sys/fsync.2 @@ -68,10 +68,14 @@ The fails if: .Bl -tag -width Er .It Bq Er EBADF +The .Fa fd +argument is not a valid descriptor. .It Bq Er EINVAL +The .Fa fd +argument refers to a socket, not to a file. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2 index 70dfc0b..d739549 100644 --- a/lib/libc/sys/getdirentries.2 +++ b/lib/libc/sys/getdirentries.2 @@ -153,7 +153,9 @@ system call will fail if: .Bl -tag -width Er .It Bq Er EBADF +The .Fa fd +argument is not a valid file descriptor open for reading. .It Bq Er EFAULT Either diff --git a/lib/libc/sys/getfh.2 b/lib/libc/sys/getfh.2 index c61a8c5..44caa76 100644 --- a/lib/libc/sys/getfh.2 +++ b/lib/libc/sys/getfh.2 @@ -83,7 +83,9 @@ Search permission is denied for a component of the path prefix of Too many symbolic links were encountered in translating .Fa path . .It Bq Er EFAULT -.Fa Fhp +The +.Fa fhp +argument points to an invalid address. .It Bq Er EIO An diff --git a/lib/libc/sys/getfsstat.2 b/lib/libc/sys/getfsstat.2 index c9bd8dc..a42b311 100644 --- a/lib/libc/sys/getfsstat.2 +++ b/lib/libc/sys/getfsstat.2 @@ -51,7 +51,9 @@ The .Fn getfsstat system call returns information about all mounted file systems. -.Fa Buf +The +.Fa buf +argument is a pointer to .Xr statfs structures defined as follows: @@ -160,7 +162,9 @@ system call fails if one or more of the following are true: .Bl -tag -width Er .It Bq Er EFAULT -.Fa Buf +The +.Fa buf +argument points to an invalid address. .It Bq Er EIO An diff --git a/lib/libc/sys/getgroups.2 b/lib/libc/sys/getgroups.2 index bdff4fb..54b6959 100644 --- a/lib/libc/sys/getgroups.2 +++ b/lib/libc/sys/getgroups.2 @@ -52,8 +52,9 @@ system call gets the current group access list of the user process and stores it in the array .Fa gidset . -The parameter +The .Fa gidsetlen +argument indicates the number of entries that may be placed in .Fa gidset . The diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index ef175d2..38e384d 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -140,11 +140,13 @@ is 100000000. .Sh NOTES Three macros for manipulating time values are defined in .Ao Pa sys/time.h Ac . -.Fa Timerclear +The +.Fn timerclear +macro sets a time value to zero, -.Fa timerisset +.Fn timerisset tests if a time value is non-zero, and -.Fa timercmp +.Fn timercmp compares two time values. .Sh RETURN VALUES .Rv -std @@ -159,11 +161,11 @@ will fail if: .It Bq Er EFAULT The .Fa value -parameter specified a bad address. +argument specified a bad address. .It Bq Er EINVAL -A +The .Fa value -parameter specified a time that was too large +argument specified a time that was too large to be handled. .El .Sh SEE ALSO diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2 index 7f7ba9b..a3ce359 100644 --- a/lib/libc/sys/getlogin.2 +++ b/lib/libc/sys/getlogin.2 @@ -152,17 +152,17 @@ The following errors may be returned by these calls: .It Bq Er EFAULT The .Fa name -parameter gave an +argument gave an invalid address. .It Bq Er EINVAL The .Fa name -parameter +argument pointed to a string that was too long. Login names are limited to .Dv MAXLOGNAME (from -.Ao Pa sys/param.h Ac ) +.Aq Pa sys/param.h ) characters, currently 17 including null. .It Bq Er EPERM The caller tried to set the login name and was not the super-user. diff --git a/lib/libc/sys/getpeername.2 b/lib/libc/sys/getpeername.2 index 627770a..97e6fdd 100644 --- a/lib/libc/sys/getpeername.2 +++ b/lib/libc/sys/getpeername.2 @@ -54,7 +54,7 @@ socket .Fa s . The .Fa namelen -parameter should be initialized to indicate +argument should be initialized to indicate the amount of space pointed to by .Fa name . On return it contains the actual size of the name @@ -83,7 +83,7 @@ to perform the operation. .It Bq Er EFAULT The .Fa name -parameter points to memory not in a valid part of the +argument points to memory not in a valid part of the process address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/getpriority.2 b/lib/libc/sys/getpriority.2 index 9466435..0b580dc 100644 --- a/lib/libc/sys/getpriority.2 +++ b/lib/libc/sys/getpriority.2 @@ -59,7 +59,9 @@ is obtained with the system call and set with the .Fn setpriority system call. -.Fa Which +The +.Fa which +argument is one of .Dv PRIO_PROCESS , .Dv PRIO_PGRP , @@ -79,7 +81,9 @@ and a user ID for A zero value of .Fa who denotes the current process, process group, or user. -.Fa Prio +The +.Fa prio +argument is a value in the range -20 to 20. The default priority is 0; lower priorities cause more favorable scheduling. .Pp @@ -116,7 +120,9 @@ and .Fa who values specified. .It Bq Er EINVAL -.Fa Which +The +.Fa which +argument was not one of .Dv PRIO_PROCESS , .Dv PRIO_PGRP , diff --git a/lib/libc/sys/getrlimit.2 b/lib/libc/sys/getrlimit.2 index 3d55643..ce0fcd0 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -59,7 +59,7 @@ system call. .Pp The .Fa resource -parameter is one of the following: +argument is one of the following: .Bl -tag -width RLIMIT_FSIZEAA .It Li RLIMIT_CORE The largest size (in bytes) diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2 index 2efa819..6a529c1 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -56,7 +56,7 @@ returns information describing the resources utilized by the current process, or all its terminated child processes. The .Fa who -parameter is either +argument is either .Dv RUSAGE_SELF or .Dv RUSAGE_CHILDREN . @@ -163,11 +163,11 @@ system call will fail if: .It Bq Er EINVAL The .Fa who -parameter is not a valid value. +argument is not a valid value. .It Bq Er EFAULT The address specified by the .Fa rusage -parameter is not in a valid part of the process address space. +argument is not in a valid part of the process address space. .El .Sh SEE ALSO .Xr gettimeofday 2 , diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2 index 9f9005f..408566e 100644 --- a/lib/libc/sys/getsockname.2 +++ b/lib/libc/sys/getsockname.2 @@ -53,7 +53,7 @@ returns the current .Fa name for the specified socket. The .Fa namelen -parameter should be initialized to indicate +argument should be initialized to indicate the amount of space pointed to by .Fa name . On return it contains the actual size of the name @@ -79,7 +79,7 @@ to perform the operation. .It Bq Er EFAULT The .Fa name -parameter points to memory not in a valid part of the +argument points to memory not in a valid part of the process address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index a6ef175..3889b26 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -79,10 +79,11 @@ should be set to the protocol number of see .Xr getprotoent 3 . .Pp -The parameters +The .Fa optval and .Fa optlen +arguments are used to access option values for .Fn setsockopt . For @@ -91,7 +92,7 @@ they identify a buffer in which the value for the requested option(s) are to be returned. For .Fn getsockopt , .Fa optlen -is a value-result parameter, initially containing the +is a value-result argument, initially containing the size of the buffer pointed to by .Fa optval , and modified on return to indicate the actual size of @@ -100,7 +101,9 @@ to be supplied or returned, .Fa optval may be NULL. .Pp -.Fa Optname +The +.Fa optname +argument and any specified options are passed uninterpreted to the appropriate protocol module for interpretation. The include file @@ -113,17 +116,17 @@ section 4 of the manual. .Pp Most socket-level options utilize an -.Fa int -parameter for +.Vt int +argument for .Fa optval . For .Fn setsockopt , -the parameter should be non-zero to enable a boolean option, +the argument should be non-zero to enable a boolean option, or zero if the option is to be disabled. .Dv SO_LINGER uses a -.Fa struct linger -parameter, defined in +.Vt "struct linger" +argument, defined in .Ao Pa sys/socket.h Ac , which specifies the desired state of the option and the linger interval (see below). @@ -131,8 +134,8 @@ linger interval (see below). and .Dv SO_RCVTIMEO use a -.Fa struct timeval -parameter, defined in +.Vt "struct timeval" +argument, defined in .Ao Pa sys/time.h Ac . .Pp The following options are recognized at the socket level. @@ -277,8 +280,8 @@ is different from that which was returned. .Dv SO_SNDTIMEO is an option to set a timeout value for output operations. It accepts a -.Fa struct timeval -parameter with the number of seconds and microseconds +.Vt "struct timeval" +argument with the number of seconds and microseconds used to limit waits for output operations to complete. If a send operation has blocked for this much time, it returns with a partial count @@ -292,8 +295,8 @@ from the low water mark to the high water mark for output. .Dv SO_RCVTIMEO is an option to set a timeout value for input operations. It accepts a -.Fa struct timeval -parameter with the number of seconds and microseconds +.Vt "struct timeval" +argument with the number of seconds and microseconds used to limit waits for input operations to complete. In the current implementation, this timer is restarted each time additional data are received by the protocol, @@ -325,16 +328,21 @@ struct accept_filter_arg { }; .Ed .Pp +The .Fa optval +argument should point to a .Fa struct accept_filter_arg that will select and configure the .Xr accept_filter 9 . +The .Fa af_name +argument should be filled with the name of the accept filter that the application wishes to place on the listening socket. +The optional argument .Fa af_arg -is an optional parameter that can be passed to the accept +can be passed to the accept filter specified by .Fa af_name to provide additional configuration options at attach time. diff --git a/lib/libc/sys/gettimeofday.2 b/lib/libc/sys/gettimeofday.2 index 397388d..4aa62f0 100644 --- a/lib/libc/sys/gettimeofday.2 +++ b/lib/libc/sys/gettimeofday.2 @@ -91,7 +91,7 @@ struct timezone { .Ed .Pp The -.Fa timezone +.Vt timezone structure indicates the local time zone (measured in minutes of time westward from Greenwich), and a flag that, if nonzero, indicates that diff --git a/lib/libc/sys/ioctl.2 b/lib/libc/sys/ioctl.2 index 9208ed7..3278e49 100644 --- a/lib/libc/sys/ioctl.2 +++ b/lib/libc/sys/ioctl.2 @@ -76,10 +76,10 @@ An .Fa request has encoded in it whether the argument is an .Dq in -parameter +argument or .Dq out -parameter, and the size of the argument +argument, and the size of the argument .Fa argp in bytes. Macros and defines used in specifying an ioctl @@ -97,10 +97,14 @@ system call will fail if: .Bl -tag -width Er .It Bq Er EBADF +The .Fa d +argument is not a valid descriptor. .It Bq Er ENOTTY +The .Fa d +argument is not associated with a character special device. .It Bq Er ENOTTY @@ -109,12 +113,16 @@ of object that the descriptor .Fa d references. .It Bq Er EINVAL +The .Fa request or .Fa argp +argument is not valid. .It Bq Er EFAULT +The .Fa argp +argument points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/kenv.2 b/lib/libc/sys/kenv.2 index 2ca1c99..1a24a27 100644 --- a/lib/libc/sys/kenv.2 +++ b/lib/libc/sys/kenv.2 @@ -48,7 +48,7 @@ the kernel environment. .Pp The .Fa action -parameter can be one of the following: +argument can be one of the following: .Bl -tag -width ".Dv KENV_UNSET" .It Dv KENV_GET Returns the value associated with the named kernel environment variable. @@ -85,14 +85,14 @@ will return the number of bytes required to copy out the entire environment. .Pp The .Fa name -parameter is the name of the environment variable to be affected. +argument is the name of the environment variable to be affected. In the case of .Dv KENV_DUMP it is ignored. .Pp The .Fa value -parameter contains either the value to set the environment variable +argument contains either the value to set the environment variable .Fa name to in the case of .Dv KENV_SET , @@ -113,7 +113,7 @@ will return the number of bytes required to copy out the entire environment. .Pp The .Fa len -parameter indicates how many bytes of storage +argument indicates how many bytes of storage .Fa value points to. .Sh RETURN VALUES @@ -140,7 +140,9 @@ system call will fail if: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa action +argument is not a valid option, or the length of the .Fa value is less than 1 for a diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2 index 7cbe63d..b0a4fde 100644 --- a/lib/libc/sys/kill.2 +++ b/lib/libc/sys/kill.2 @@ -54,7 +54,9 @@ to .Fa pid , a process or a group of processes. -.Fa Sig +The +.Fa sig +argument may be one of the signals specified in .Xr sigaction 2 or it may be 0, in which case @@ -73,11 +75,15 @@ A single exception is the signal SIGCONT, which may always be sent to any descendant of the current process. .Bl -tag -width Ds .It \&If Fa pid No \&is greater than zero : -.Fa Sig +The +.Fa sig +signal is sent to the process whose ID is equal to .Fa pid . .It \&If Fa pid No \&is zero : -.Fa Sig +The +.Fa sig +signal is sent to all processes whose group ID is equal to the process group ID of the sender, and for which the process has permission; @@ -114,7 +120,9 @@ system call will fail and no signal will be sent if: .Bl -tag -width Er .It Bq Er EINVAL -.Fa Sig +The +.Fa sig +argument is not a valid signal number. .It Bq Er ESRCH No process can be found corresponding to that specified by diff --git a/lib/libc/sys/kldsym.2 b/lib/libc/sys/kldsym.2 index 3a2f32d..acd6fcd 100644 --- a/lib/libc/sys/kldsym.2 +++ b/lib/libc/sys/kldsym.2 @@ -99,7 +99,9 @@ Invalid value in or .Fa command . .It Bq Er ENOENT +The .Fa fileid +argument is invalid, or the specified symbol could not be found. .El diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2 index 2d65591..93d5c78 100644 --- a/lib/libc/sys/kqueue.2 +++ b/lib/libc/sys/kqueue.2 @@ -89,7 +89,9 @@ The system call is used to register events with the queue, and return any pending events to the user. +The .Fa changelist +argument is a pointer to an array of .Va kevent structures, as defined in @@ -97,12 +99,18 @@ structures, as defined in All changes contained in the .Fa changelist are applied before any pending events are read from the queue. +The .Fa nchanges +argument gives the size of .Fa changelist . +The .Fa eventlist +argument is a pointer to an array of kevent structures. +The .Fa nevents +argument determines the size of .Fa eventlist . If diff --git a/lib/libc/sys/kse.2 b/lib/libc/sys/kse.2 index 4222c05..606501c 100644 --- a/lib/libc/sys/kse.2 +++ b/lib/libc/sys/kse.2 @@ -290,6 +290,7 @@ If the KSE has already woken up for another reason, this system call has no effect. The .Fa mbx +argument may be .Dv NULL to specify @@ -542,12 +543,16 @@ MIB variable .Dv KERN_MAXPROCPERUID . .It Bq Er EAGAIN The user is not the super user, and the soft resource limit corresponding -to the resource parameter +to the +.Fa resource +argument .Dv RLIMIT_NPROC would be exceeded (see .Xr getrlimit 2 ) . .It Bq Er EFAULT +The .Fa mbx +argument points to an address which is not a valid part of the process address space. .El .Pp @@ -582,14 +587,18 @@ system call will fail if: .Bl -tag -width Er .It Bq Er ESRCH +The .Fa mbx +argument is not .Dv NULL and the mailbox pointed to by .Fa mbx is not associated with any KSE in the process. .It Bq Er ESRCH +The .Fa mbx +argument is .Dv NULL and the current KSE has no associated mailbox, i.e., the process is operating diff --git a/lib/libc/sys/ktrace.2 b/lib/libc/sys/ktrace.2 index 41761a0..b51558c 100644 --- a/lib/libc/sys/ktrace.2 +++ b/lib/libc/sys/ktrace.2 @@ -56,6 +56,7 @@ Only the super-user can trace setuid or setgid programs. .Pp The .Fa tracefile +argument gives the pathname of the file to be used for tracing. The file must exist and be a regular file writable by the calling process. All trace records are always appended to the file, @@ -67,7 +68,7 @@ may be NULL. .Pp The .Fa ops -parameter specifies the requested ktrace operation. +argument specifies the requested ktrace operation. The defined operations are: .Bl -column KTRFLAG_DESCENDXXX -offset indent .It "KTROP_SET Enable trace points specified in" @@ -81,7 +82,7 @@ specified process and all its current children. .Pp The .Fa trpoints -parameter specifies the trace points of interest. +argument specifies the trace points of interest. The defined trace points are: .Bl -column KTRFAC_SYSCALLXXX -offset indent .It "KTRFAC_SYSCALL Trace system calls." diff --git a/lib/libc/sys/link.2 b/lib/libc/sys/link.2 index dbf2682..9c064b4 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -69,7 +69,9 @@ is not deleted and the link count of the underlying object is decremented. .Pp -.Fa Name1 +The object pointed at by the +.Fa name1 +argument must exist for the hard link to succeed and both @@ -77,7 +79,9 @@ both and .Fa name2 must be in the same file system. +The .Fa name1 +argument may not be a directory. .Sh RETURN VALUES .Rv -std link diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2 index c7a9bdb..fb0dafc 100644 --- a/lib/libc/sys/listen.2 +++ b/lib/libc/sys/listen.2 @@ -64,7 +64,7 @@ or .Pp The .Fa backlog -parameter defines the maximum length the queue of +argument defines the maximum length the queue of pending connections may grow to. If a connection request arrives with the queue full the client may @@ -78,7 +78,7 @@ Note that before and the introduction of the syncache, the .Fa backlog -parameter also determined the length of the incomplete +argument also determined the length of the incomplete connection queue, which held TCP sockets in the process of completing TCP's 3-way handshake. These incomplete connections @@ -116,7 +116,7 @@ its accept filter criteria will be terminated. This secondary queue, like the primary listen queue, is sized according to the .Fa backlog -parameter. +argument. .Sh RETURN VALUES .Rv -std listen .Sh ERRORS diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2 index d394ef9..30cf1e0 100644 --- a/lib/libc/sys/lseek.2 +++ b/lib/libc/sys/lseek.2 @@ -120,10 +120,14 @@ system call will fail and the file position pointer will remain unchanged if: .Bl -tag -width Er .It Bq Er EBADF +The .Fa fildes +argument is not an open file descriptor. .It Bq Er EINVAL -.Fa Whence +The +.Fa whence +argument is not a proper value or the resulting file offset would be negative for a non-character special file. @@ -132,7 +136,9 @@ The resulting file offset would be a value which cannot be represented correctly in an object of type .Fa off_t . .It Bq Er ESPIPE +The .Fa fildes +argument is associated with a pipe, socket, or FIFO. .El .Sh SEE ALSO diff --git a/lib/libc/sys/mkdir.2 b/lib/libc/sys/mkdir.2 index 8ef3f18..e91c9ba 100644 --- a/lib/libc/sys/mkdir.2 +++ b/lib/libc/sys/mkdir.2 @@ -100,7 +100,9 @@ An I/O error occurred while making the directory entry or allocating the inode. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/mkfifo.2 b/lib/libc/sys/mkfifo.2 index 19461be..329c26b 100644 --- a/lib/libc/sys/mkfifo.2 +++ b/lib/libc/sys/mkfifo.2 @@ -110,7 +110,9 @@ An .Tn I/O error occurred while reading from or writing to the file system. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/mknod.2 b/lib/libc/sys/mknod.2 index 849e17a..1c9fca3 100644 --- a/lib/libc/sys/mknod.2 +++ b/lib/libc/sys/mknod.2 @@ -108,7 +108,9 @@ The named file resides on a read-only file system. .It Bq Er EEXIST The named file exists. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .It Bq Er EINVAL Creating anything else than a block or character special diff --git a/lib/libc/sys/mlock.2 b/lib/libc/sys/mlock.2 index c4839c0..f44d4c3 100644 --- a/lib/libc/sys/mlock.2 +++ b/lib/libc/sys/mlock.2 @@ -64,10 +64,10 @@ system call unlocks pages previously locked by one or more calls. For both, the .Fa addr -parameter should be aligned to a multiple of the page size. +argument should be aligned to a multiple of the page size. If the .Fa len -parameter is not a multiple of the page size, it will be rounded up +argument is not a multiple of the page size, it will be rounded up to be so. The entire range must be allocated. .Pp diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index 05f5b4f..5407968 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -93,7 +93,7 @@ Pages may be executed. .Pp The .Fa flags -parameter specifies the type of the mapped object, mapping options and +argument specifies the type of the mapped object, mapping options and whether modifications made to the mapped copy of the page are private to the process or are to be shared with other references. Sharing, mapping type and options are specified in the @@ -109,7 +109,7 @@ The file descriptor used for creating must be \-1. The .Fa offset -parameter is ignored. +argument is ignored. .\".It Dv MAP_FILE .\"Mapped from a regular file or character-special device memory. .It Dv MAP_FIXED @@ -212,7 +212,9 @@ implies and .Fa offset of 0. +The .Fa fd +argument must be -1 and .Fa prot must include at least @@ -264,7 +266,7 @@ The flag .Dv PROT_READ was specified as part of the .Fa prot -parameter and +argument and .Fa fd was not open for reading. The flags @@ -275,33 +277,39 @@ were specified as part of the .Fa flags and .Fa prot -parameters and +argument and .Fa fd was not open for writing. .It Bq Er EBADF +The .Fa fd +argument is not a valid open file descriptor. .It Bq Er EINVAL .Dv MAP_FIXED was specified and the .Fa addr -parameter was not page aligned, or part of the desired address space +argument was not page aligned, or part of the desired address space resides out of the valid address space for a user process. .It Bq Er EINVAL -.Fa Len +The +.Fa len +argument was negative. .It Bq Er EINVAL .Dv MAP_ANON was specified and the .Fa fd -parameter was not -1. +argument was not -1. .It Bq Er EINVAL .Dv MAP_ANON has not been specified and .Fa fd did not reference a regular or character special file. .It Bq Er EINVAL -.Fa Offset +The +.Fa offset +argument was not page-aligned. (See .Sx BUGS @@ -310,7 +318,7 @@ below.) .Dv MAP_FIXED was specified and the .Fa addr -parameter was not available. +argument was not available. .Dv MAP_ANON was specified and insufficient memory was available. The system has reached the per-process mmap limit specified in the @@ -329,7 +337,9 @@ sysctl. .Xr getpagesize 3 , .Xr make.conf 5 .Sh BUGS +The .Fa len +argument is limited to 2GB. Mmapping slightly more than 2GB does not work, but it is possible to map a window of size (filesize % 2GB) for file sizes diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index 96032d7..d22f68d 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -128,7 +128,9 @@ argument names the file system. The types of file systems known to the system can be obtained with .Xr lsvfs 1 . .Pp -.Fa Data +The +.Fa data +argument is a pointer to a structure that contains the type specific arguments to mount. The format for these argument structures is described in the @@ -197,7 +199,9 @@ is not a directory. Another process currently holds a reference to .Fa dir . .It Bq Er EFAULT -.Fa Dir +The +.Fa dir +argument points outside the process's allocated address space. .El .Pp @@ -210,7 +214,9 @@ A component of ufs_args .Fa fspec does not exist. .It Bq Er ENOTBLK +The .Fa fspec +argument is not a block device. .It Bq Er ENXIO The major device number of @@ -232,7 +238,9 @@ group information for the file system. An I/O error occurred while reading the super block or cylinder group information. .It Bq Er EFAULT +The .Fa fspec +argument points outside the process's allocated address space. .El .Pp @@ -269,7 +277,9 @@ on the file system. .It Bq Er EIO An I/O error occurred while writing cached file system information. .It Bq Er EFAULT -.Fa Dir +The +.Fa dir +argument points outside the process's allocated address space. .El .Pp diff --git a/lib/libc/sys/msync.2 b/lib/libc/sys/msync.2 index 254ed12..bb55bbc 100644 --- a/lib/libc/sys/msync.2 +++ b/lib/libc/sys/msync.2 @@ -79,13 +79,19 @@ system call will fail if: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa addr +argument is not a multiple of the hardware page size. .It Bq Er EINVAL +The .Fa len +argument is too large or negative. .It Bq Er EINVAL +The .Fa flags +argument was both MS_ASYNC and MS_INVALIDATE. Only one of these flags is allowed. .It Bq Er EIO diff --git a/lib/libc/sys/munmap.2 b/lib/libc/sys/munmap.2 index f6acf79..d05b489 100644 --- a/lib/libc/sys/munmap.2 +++ b/lib/libc/sys/munmap.2 @@ -62,9 +62,9 @@ will fail if: .It Bq Er EINVAL The .Fa addr -parameter was not page aligned, the +argument was not page aligned, the .Fa len -parameter was negative, or +argument was negative, or some part of the region being unmapped is outside the valid address range for a process. .El diff --git a/lib/libc/sys/nanosleep.2 b/lib/libc/sys/nanosleep.2 index b628131..c0d5b5b 100644 --- a/lib/libc/sys/nanosleep.2 +++ b/lib/libc/sys/nanosleep.2 @@ -91,7 +91,9 @@ The system call was interrupted by the delivery of a signal. .It Bq Er EINVAL +The .Fa rqtp +argument specified a nanosecond value less than zero or greater than or equal to 1000 million. .It Bq Er ENOSYS diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index 8775f0e..f125877 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -288,7 +288,9 @@ executed and the .Fn open system call requests write access. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .It Bq Er EEXIST .Dv O_CREAT diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2 index de521bb..873f9b7 100644 --- a/lib/libc/sys/pathconf.2 +++ b/lib/libc/sys/pathconf.2 @@ -106,7 +106,6 @@ otherwise 0. Returns 1 if synchronised I/O is supported for this file, otherwise 0. .It Li _PC_ALLOC_SIZE_MIN Minimum number of bytes of storage allocated for any portion of a file. -.Fa path . .It Li _PC_FILESIZEBITS Number of bits needed to represented the maximum file size. .It Li _PC_REC_INCR_XFER_SIZE @@ -194,7 +193,9 @@ The system call will fail if: .It Bq Er EBADF +The .Fa fd +argument is not a valid open file descriptor. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/poll.2 b/lib/libc/sys/poll.2 index 1026811..dbbbcef 100644 --- a/lib/libc/sys/poll.2 +++ b/lib/libc/sys/poll.2 @@ -163,7 +163,9 @@ An error return from indicates: .Bl -tag -width Er .It Bq Er EFAULT -.Fa Fds +The +.Fa fds +argument points outside the process's allocated address space. .It Bq Er EINTR A signal was delivered before the time limit expired and diff --git a/lib/libc/sys/profil.2 b/lib/libc/sys/profil.2 index 640cfda..5dea7ab 100644 --- a/lib/libc/sys/profil.2 +++ b/lib/libc/sys/profil.2 @@ -78,11 +78,11 @@ by the relation: .Pp The .Fa offset -parameter is the lowest address at which +argument is the lowest address at which the kernel takes program counter samples. The .Fa scale -parameter ranges from 1 to 65536 and +argument ranges from 1 to 65536 and can be used to change the span of the bins. A scale of 65536 maps each bin to 2 bytes of address range; a scale of 32768 gives 4 bytes, 16384 gives 8 bytes and so on. diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2 index 298de96..7ce4077 100644 --- a/lib/libc/sys/ptrace.2 +++ b/lib/libc/sys/ptrace.2 @@ -53,7 +53,9 @@ special case noted below, all calls are made by the tracing process, and the .Fa pid argument specifies the process ID of the traced process. +The .Fa request +argument can be: .Bl -tag -width 12n .It Dv PT_TRACE_ME @@ -137,21 +139,29 @@ The actual number of bytes read or written is stored in upon return. .It Dv PT_CONTINUE The traced process continues execution. +The .Fa addr +argument is an address specifying the place where execution is to be resumed (a new value for the program counter), or .Po Vt caddr_t Pc Ns 1 to indicate that execution is to pick up where it left off. +The .Fa data +argument provides a signal number to be delivered to the traced process as it 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 +argument should be passed .Po Vt caddr_t Pc Ns 1 . +The .Fa data +argument is not used. .It Dv PT_KILL The traced process terminates, as if @@ -272,6 +282,7 @@ on itself. .It The .Fa request +argument was not one of the legal requests. .It The signal number diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index 5276133..6a4c09b 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -112,7 +112,9 @@ Only the super-user may turn quotas off. Get disk quota limits and current usage for the user or group (as determined by the command type) with identifier .Fa id . -.Fa Addr +The +.Fa addr +argument is a pointer to a .Fa struct dqblk structure (defined in @@ -121,7 +123,9 @@ structure (defined in Set disk quota limits for the user or group (as determined by the command type) with identifier .Fa id . -.Fa Addr +The +.Fa addr +argument is a pointer to a .Fa struct dqblk structure (defined in @@ -134,7 +138,9 @@ This system call is restricted to the super-user. Set disk usage limits for the user or group (as determined by the command type) with identifier .Fa id . -.Fa Addr +The +.Fa addr +argument is a pointer to a .Fa struct dqblk structure (defined in @@ -148,7 +154,7 @@ The .Fa id and .Fa addr -parameters are ignored. +arguments are ignored. .El .Sh RETURN VALUES .Rv -std quotactl @@ -164,7 +170,9 @@ option. .It Bq Er EUSERS The quota table cannot be expanded. .It Bq Er EINVAL -.Fa Cmd +The +.Fa cmd +argument or the command type is invalid. In .Dv Q_GETQUOTA @@ -201,7 +209,9 @@ An invalid was supplied; the associated structure could not be copied in or out of the kernel. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .It Bq Er EPERM The call was privileged and the caller was not the super-user. diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2 index fc7d002..da93d6f 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -142,10 +142,14 @@ system calls will succeed unless: .Bl -tag -width Er .It Bq Er EBADF -.Fa D +The +.Fa d +argument is not a valid file or socket descriptor open for reading. .It Bq Er EFAULT -.Fa Buf +The +.Fa buf +argument points outside the allocated address space. .It Bq Er EIO An I/O error occurred while reading from the file system. @@ -166,7 +170,9 @@ In addition, may return one of the following errors: .Bl -tag -width Er .It Bq Er EINVAL -.Fa Iovcnt +The +.Fa iovcnt +argument was less than or equal to 0, or greater than 16. .It Bq Er EINVAL One of the diff --git a/lib/libc/sys/readlink.2 b/lib/libc/sys/readlink.2 index 57ed4e6..28ecc4b 100644 --- a/lib/libc/sys/readlink.2 +++ b/lib/libc/sys/readlink.2 @@ -87,7 +87,9 @@ The named file is not a symbolic link. .It Bq Er EIO An I/O error occurred while reading from the file system. .It Bq Er EFAULT -.Fa Buf +The +.Fa buf +argument extends outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/reboot.2 b/lib/libc/sys/reboot.2 index 6ab7952..619c2fd 100644 --- a/lib/libc/sys/reboot.2 +++ b/lib/libc/sys/reboot.2 @@ -54,7 +54,9 @@ Only the super-user may reboot a machine on demand. However, a reboot is invoked automatically in the event of unrecoverable system failures. .Pp -.Fa Howto +The +.Fa howto +argument is a mask of options; the system call interface allows the following options, defined in the include file .Aq Pa sys/reboot.h , diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index 9d85d2b..a2ea33a 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -65,8 +65,10 @@ If .Fa from is non-nil, and the socket is not connection-oriented, the source address of the message is filled in. -.Fa Fromlen -is a value-result parameter, initialized to the size of +The +.Fa fromlen +argument +is a value-result argument, initialized to the size of the buffer associated with .Fa from , and modified on return to indicate the actual size of the @@ -82,7 +84,7 @@ and is identical to .Fn recvfrom with a nil .Fa from -parameter. +argument. As it is redundant, it may not be supported in future releases. .Pp All three routines return the length of the message on successful @@ -148,7 +150,7 @@ The .Fn recvmsg system call uses a .Fa msghdr -structure to minimize the number of directly supplied parameters. +structure to minimize the number of directly supplied arguments. This structure has the following form, as defined in .Ao Pa sys/socket.h Ac : .Pp @@ -171,12 +173,16 @@ and specify the destination address if the socket is unconnected; .Fa msg_name may be given as a null pointer if no names are desired or required. -.Fa Msg_iov +The +.Fa msg_iov and .Fa msg_iovlen +arguments describe scatter gather locations, as discussed in .Xr read 2 . -.Fa Msg_control , +The +.Fa msg_control +argument, which has length .Fa msg_controllen , points to a buffer for other protocol control related messages diff --git a/lib/libc/sys/rename.2 b/lib/libc/sys/rename.2 index 56572ca..67866f6 100644 --- a/lib/libc/sys/rename.2 +++ b/lib/libc/sys/rename.2 @@ -135,9 +135,10 @@ and neither the containing directory nor .Fa from are owned by the effective user ID. .It Bq Er EPERM -The +The file pointed at by the .Fa to -file exists, +argument +exists, the directory containing .Fa to is marked sticky, @@ -149,12 +150,16 @@ Too many symbolic links were encountered in translating either pathname. .It Bq Er ENOTDIR A component of either path prefix is not a directory. .It Bq Er ENOTDIR +The .Fa from +argument is a directory, but .Fa to is not a directory. .It Bq Er EISDIR +The .Fa to +argument is a directory, but .Fa from is not a directory. @@ -184,7 +189,9 @@ system. Path points outside the process's allocated address space. .It Bq Er EINVAL -.Fa From +The +.Fa from +argument is a parent directory of .Fa to , or an attempt is made to rename @@ -192,7 +199,9 @@ or an attempt is made to rename or .Ql \&.. . .It Bq Er ENOTEMPTY -.Fa To +The +.Fa to +argument is a directory and is not empty. .El .Sh SEE ALSO diff --git a/lib/libc/sys/revoke.2 b/lib/libc/sys/revoke.2 index f420db9..64de556 100644 --- a/lib/libc/sys/revoke.2 +++ b/lib/libc/sys/revoke.2 @@ -89,7 +89,9 @@ Search permission is denied for a component of the path prefix. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .It Bq Er EINVAL The implementation does not support the diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2 index d4d4e20..4e60fb7 100644 --- a/lib/libc/sys/rfork.2 +++ b/lib/libc/sys/rfork.2 @@ -31,7 +31,9 @@ The resources include the open file descriptor table (which, when shared, permits processes to open and close files for other processes), and open files. -.Fa Flags +The +.Fa flags +argument is the logical OR of some subset of: .Bl -tag -width "RFCNAMEG" -compact -offset indent .It RFPROC @@ -140,7 +142,9 @@ MIB variable .Dv KERN_MAXPROCPERUID . .It Bq Er EAGAIN The user is not the super user, and -the soft resource limit corresponding to the resource parameter +the soft resource limit corresponding to the +.Fa resource +argument .Dv RLIMIT_NOFILE would be exceeded (see .Xr getrlimit 2 ) . diff --git a/lib/libc/sys/rmdir.2 b/lib/libc/sys/rmdir.2 index 54b9b25..c2014fc 100644 --- a/lib/libc/sys/rmdir.2 +++ b/lib/libc/sys/rmdir.2 @@ -94,7 +94,9 @@ or deallocating the inode. .It Bq Er EROFS The directory entry to be removed resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/rtprio.2 b/lib/libc/sys/rtprio.2 index a935404..ce519fc 100644 --- a/lib/libc/sys/rtprio.2 +++ b/lib/libc/sys/rtprio.2 @@ -48,14 +48,20 @@ The system call is used to lookup or change the realtime or idle priority of a process. .Pp +The .Fa function +argument specifies the operation to be performed. RTP_LOOKUP to lookup the current priority, and RTP_SET to set the priority. +The .Fa pid +argument specifies the process to be used, 0 for the current process. .Pp +The .Fa *rtp +argument 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 diff --git a/lib/libc/sys/sched_get_priority_max.2 b/lib/libc/sys/sched_get_priority_max.2 index e54228f..9f8104a 100644 --- a/lib/libc/sys/sched_get_priority_max.2 +++ b/lib/libc/sys/sched_get_priority_max.2 @@ -95,7 +95,7 @@ will be set to the corresponding value: .It Bq Er EINVAL The value of the .Fa policy -parameter does not represent a defined scheduling policy. +argument does not represent a defined scheduling policy. .It Bq Er ENOSYS The .Fn sched_get_priority_max , diff --git a/lib/libc/sys/sched_setscheduler.2 b/lib/libc/sys/sched_setscheduler.2 index 7043649..cd47aaa 100644 --- a/lib/libc/sys/sched_setscheduler.2 +++ b/lib/libc/sys/sched_setscheduler.2 @@ -47,7 +47,7 @@ of the process specified by to .Fa policy and the parameters specified in the -.Fa sched_param +.Vt sched_param structure pointed to by .Fa param , respectively. @@ -92,7 +92,7 @@ Round-robin scheduling across same priority processes. .El .Pp The -.Fa sched_param +.Vt sched_param structure is defined in .Fa <sched.h> : .Pp @@ -146,7 +146,7 @@ No process can be found corresponding to that specified by .It Bq Er EINVAL The value of the .Fa policy -parameter is invalid, or one or more of the parameters contained in +argument is invalid, or one or more of the parameters contained in .Fa param is outside the valid range for the specified scheduling policy. .El diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2 index 871d68d..849d6aa 100644 --- a/lib/libc/sys/select.2 +++ b/lib/libc/sys/select.2 @@ -155,7 +155,9 @@ before any of the selected events occurred. The specified time limit is invalid. One of its components is negative or too large. .It Bq Er EINVAL +The .Fa nfds +argument was invalid. .El .Sh SEE ALSO diff --git a/lib/libc/sys/semctl.2 b/lib/libc/sys/semctl.2 index b5a33ba..b69b8fb 100644 --- a/lib/libc/sys/semctl.2 +++ b/lib/libc/sys/semctl.2 @@ -53,7 +53,7 @@ is required for certain values of .Fa cmd . For the commands that use the .Fa arg -parameter, +argument, .Fa "union semun" is defined as follows: .Bd -literal @@ -136,7 +136,7 @@ in any process are cleared. .El .Pp The -.Fa "struct semid_ds" +.Vt "struct semid_ds" is defined as follows: .Bd -literal .\" @@ -177,7 +177,9 @@ will fail if: No semaphore set corresponds to .Fa semid . .It Bq Er EINVAL +The .Fa semnum +argument is not in the range of valid semaphores for given semaphore set. .It Bq Er EPERM The calling process's effective uid does not match the uid of diff --git a/lib/libc/sys/semget.2 b/lib/libc/sys/semget.2 index f45e92b..f493281 100644 --- a/lib/libc/sys/semget.2 +++ b/lib/libc/sys/semget.2 @@ -79,7 +79,7 @@ The mode of a newly created IPC object is determined by .Em OR Ns 'ing the following constants into the .Fa flag -parameter: +argument: .Bl -tag -width XSEM_WXX6XXX .It Dv SEM_R Read access for user. diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2 index ac64f3f..dfd110d 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -101,7 +101,7 @@ send more data. .Pp The .Fa flags -parameter may include one or more of the following: +argument may include one or more of the following: .Bd -literal #define MSG_OOB 0x1 /* process out-of-band data */ #define MSG_PEEK 0x2 /* peek at incoming message */ @@ -165,7 +165,7 @@ The argument .Fa s is not a socket. .It Bq Er EFAULT -An invalid user space address was specified for a parameter. +An invalid user space address was specified for an argument. .It Bq Er EMSGSIZE The socket requires that message be sent atomically, and the size of the message to be sent made this impossible. diff --git a/lib/libc/sys/sendfile.2 b/lib/libc/sys/sendfile.2 index 09e8dac..a0d8239 100644 --- a/lib/libc/sys/sendfile.2 +++ b/lib/libc/sys/sendfile.2 @@ -111,25 +111,39 @@ is "zero-copy", meaning that it has been optimized so that copying of the file d .Sh ERRORS .Bl -tag -width Er .It Bq Er EBADF +The .Fa fd +argument is not a valid file descriptor. .It Bq Er EBADF +The .Fa s +argument is not a valid socket descriptor. .It Bq Er ENOTSOCK +The .Fa s +argument is not a socket. .It Bq Er EINVAL +The .Fa fd +argument is not a regular file. .It Bq Er EINVAL +The .Fa s +argument is not a SOCK_STREAM type socket. .It Bq Er EINVAL +The .Fa offset +argument is negative or out of range. .It Bq Er ENOTCONN +The .Fa s +argument points to an unconnected socket. .It Bq Er EPIPE The socket peer has closed the connection. @@ -137,7 +151,7 @@ The socket peer has closed the connection. An error occurred while reading from .Fa fd . .It Bq Er EFAULT -An invalid address was specified for a parameter. +An invalid address was specified for an argument. .It Bq Er EAGAIN The socket is marked for non-blocking I/O and not all data was sent due to the socket buffer being filled. If specified, the number of bytes successfully sent will be returned in diff --git a/lib/libc/sys/setgroups.2 b/lib/libc/sys/setgroups.2 index 79f60ac..1570ac7 100644 --- a/lib/libc/sys/setgroups.2 +++ b/lib/libc/sys/setgroups.2 @@ -52,8 +52,9 @@ system call sets the group access list of the current user process according to the array .Fa gidset . -The parameter +The .Fa ngroups +argument indicates the number of entries in the array and must be no more than .Dv NGROUPS , diff --git a/lib/libc/sys/setregid.2 b/lib/libc/sys/setregid.2 index 0ea6acf..fd27e71 100644 --- a/lib/libc/sys/setregid.2 +++ b/lib/libc/sys/setregid.2 @@ -56,7 +56,7 @@ make other changes. .Pp Supplying a value of -1 for either the real or effective group ID forces the system to substitute the current -ID in place of the -1 parameter. +ID in place of the -1 argument. .Pp The .Fn setregid diff --git a/lib/libc/sys/shmat.2 b/lib/libc/sys/shmat.2 index e4c9eee..31e2a80 100644 --- a/lib/libc/sys/shmat.2 +++ b/lib/libc/sys/shmat.2 @@ -100,7 +100,9 @@ will fail if: No shared memory segment was found corresponding to .Fa shmid . .It Bq Er EINVAL +The .Fa addr +argument was not an acceptable address. .El .Pp @@ -110,7 +112,9 @@ system call will fail if: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa addr +argument does not point to a shared memory segment. .El .Sh "SEE ALSO" diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2 index bf54fb2..e27ad0d 100644 --- a/lib/libc/sys/shmget.2 +++ b/lib/libc/sys/shmget.2 @@ -76,7 +76,7 @@ The mode of a newly created IPC object is determined by .Em OR Ns 'ing the following constants into the .Fa flag -parameter: +argument: .Bl -tag -width XSHM_WXX6XXX .It Dv SHM_R Read access for user. diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index a302cee..adf7bed 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -551,7 +551,9 @@ or points to memory that is not a valid part of the process address space. .It Bq Er EINVAL -.Fa Sig +The +.Fa sig +argument is not a valid signal number. .It Bq Er EINVAL An attempt is made to ignore or supply a handler for diff --git a/lib/libc/sys/sigprocmask.2 b/lib/libc/sys/sigprocmask.2 index c8866fc..ca9be15 100644 --- a/lib/libc/sys/sigprocmask.2 +++ b/lib/libc/sys/sigprocmask.2 @@ -59,8 +59,9 @@ If .Fa set is not null, the action of .Fn sigprocmask -depends on the value of the parameter -.Fa how . +depends on the value of the +.Fa how +argument. The signal mask is changed as a function of the specified .Fa set and the current mask. @@ -108,7 +109,9 @@ system call will fail and the signal mask will be unchanged if one of the following occurs: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa how +argument has a value other than those listed here. .El .Sh SEE ALSO diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2 index 3aec154..aed6a91 100644 --- a/lib/libc/sys/sigreturn.2 +++ b/lib/libc/sys/sigreturn.2 @@ -77,7 +77,9 @@ will fail and the process context will remain unchanged if one of the following occurs. .Bl -tag -width Er .It Bq Er EFAULT -.Fa Scp +The +.Fa scp +argument points to memory that is not a valid part of the process address space. .It Bq Er EINVAL diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index c3869a7..c8d9368 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -53,7 +53,7 @@ creates an endpoint for communication and returns a descriptor. .Pp The .Fa domain -parameter specifies a communications domain within which +argument specifies a communications domain within which communication will take place; this selects the protocol family which should be used. These families are defined in the include file @@ -139,6 +139,7 @@ but not yet implemented, are not described here. .Pp The .Fa protocol +argument specifies a particular protocol to be used with the socket. Normally only a single protocol exists to support a particular socket type within a given protocol family. However, it is possible diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index fbdbb5b..68ab743 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -163,7 +163,7 @@ is not defined, the time-related fields are defined as: .Ed .Pp The size-related fields of the -.Fa struct stat +.Vt "struct stat" are as follows: .Bl -tag -width XXXst_blksize .It st_blksize @@ -223,9 +223,11 @@ system calls will fail if: .It Bq Er EACCES Search permission is denied for a component of the path prefix. .It Bq Er EFAULT +The .Fa sb or .Fa path +argument points to an invalid address. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. @@ -249,10 +251,14 @@ The .Fn fstat system call will fail if: .It Bq Er EBADF +The .Fa fd +argument is not a valid open file descriptor. .It Bq Er EFAULT +The .Fa sb +argument points to an invalid address. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/statfs.2 b/lib/libc/sys/statfs.2 index 6cdc692..43af72a 100644 --- a/lib/libc/sys/statfs.2 +++ b/lib/libc/sys/statfs.2 @@ -52,11 +52,15 @@ The .Fn statfs system call returns information about a mounted file system. -.Fa Path +The +.Fa path +argument is the path name of any file within the mounted file system. -.Fa Buf +The +.Fa buf +argument is a pointer to a -.Fn statfs +.Vt statfs structure defined as follows: .Bd -literal typedef struct fsid { int32_t val[2]; } fsid_t; /* file system id type */ @@ -138,7 +142,7 @@ fails if one or more of the following are true: .Bl -tag -width Er .It Bq Er ENOTDIR A component of the path prefix of -.Fa Path +.Fa path is not a directory. .It Bq Er ENAMETOOLONG The length of a component of @@ -158,9 +162,11 @@ Search permission is denied for a component of the path prefix of Too many symbolic links were encountered in translating .Fa path . .It Bq Er EFAULT -.Fa Buf +The +.Fa buf or .Fa path +argument points to an invalid address. .It Bq Er EIO An @@ -174,10 +180,14 @@ system call fails if one or more of the following are true: .Bl -tag -width Er .It Bq Er EBADF +The .Fa fd +argument is not a valid open file descriptor. .It Bq Er EFAULT -.Fa Buf +The +.Fa buf +argument points to an invalid address. .It Bq Er EIO An diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2 index 1feb7c0..6aaf4f2 100644 --- a/lib/libc/sys/swapon.2 +++ b/lib/libc/sys/swapon.2 @@ -90,7 +90,9 @@ Too many symbolic links were encountered in translating the pathname. .It Bq Er EPERM The caller is not the super-user. .It Bq Er EFAULT -.Fa Special +The +.Fa special +argument points outside the process's allocated address space. .El .Pp @@ -103,7 +105,9 @@ The system has reached the boot-time limit on the number of swap devices, .Va vm.nswapdev . .It Bq Er ENOTBLK -.Fa Special +The +.Fa special +argument is not a block device. .It Bq Er EBUSY The device specified by diff --git a/lib/libc/sys/symlink.2 b/lib/libc/sys/symlink.2 index 8d25e33..19fa7fa 100644 --- a/lib/libc/sys/symlink.2 +++ b/lib/libc/sys/symlink.2 @@ -78,7 +78,9 @@ path prefix denies search permission. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er EEXIST -.Fa Name2 +The path name pointed at by the +.Fa name2 +argument already exists. .It Bq Er EIO An I/O error occurred while making the directory entry for @@ -117,9 +119,11 @@ which the symbolic link is being created has been exhausted. .It Bq Er EIO An I/O error occurred while making the directory entry or allocating the inode. .It Bq Er EFAULT -.Fa Name1 +The +.Fa name1 or .Fa name2 +argument points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/sysarch.2 b/lib/libc/sys/sysarch.2 index 2685a37..6e631bc 100644 --- a/lib/libc/sys/sysarch.2 +++ b/lib/libc/sys/sysarch.2 @@ -56,7 +56,9 @@ specified by with the arguments specified by the .Fa args pointer. -.Fa Args +The +.Fa args +argument is a pointer to a structure defining the actual arguments of the function. Symbolic constants and argument structures diff --git a/lib/libc/sys/syscall.2 b/lib/libc/sys/syscall.2 index 10109ce..df91325 100644 --- a/lib/libc/sys/syscall.2 +++ b/lib/libc/sys/syscall.2 @@ -60,7 +60,7 @@ Symbolic constants for system calls can be found in the header file .Ao Pa sys/syscall.h Ac . The .Fn __syscall -form should be used when one or more of the parameters is a +form should be used when one or more of the arguments is a 64-bit argument to ensure that argument alignment is correct. This system call is useful for testing new system calls that do not have entries in the C library. diff --git a/lib/libc/sys/truncate.2 b/lib/libc/sys/truncate.2 index 32e487e..29892ac 100644 --- a/lib/libc/sys/truncate.2 +++ b/lib/libc/sys/truncate.2 @@ -96,7 +96,9 @@ The file is a pure procedure (shared text) file that is being executed. .It Bq Er EIO An I/O error occurred updating the inode. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .El .Pp @@ -108,14 +110,17 @@ succeeds unless: .It Bq Er EBADF The .Fa fd +argument is not a valid descriptor. .It Bq Er EINVAL The .Fa fd +argument references a socket, not a file. .It Bq Er EINVAL The .Fa fd +descriptor is not open for writing. .El .Sh SEE ALSO diff --git a/lib/libc/sys/undelete.2 b/lib/libc/sys/undelete.2 index fba16f8..5faf50a 100644 --- a/lib/libc/sys/undelete.2 +++ b/lib/libc/sys/undelete.2 @@ -91,7 +91,9 @@ An I/O error occurred while updating the directory entry. .It Bq Er EROFS The name resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/unlink.2 b/lib/libc/sys/unlink.2 index 61a2de1..6050b39 100644 --- a/lib/libc/sys/unlink.2 +++ b/lib/libc/sys/unlink.2 @@ -59,7 +59,9 @@ all resources associated with the file are reclaimed. If one or more process have the file open when the last link is removed, the link is removed, but the removal of the file is delayed until all references to it have been closed. +The .Fa path +argument may not be a directory. .Sh RETURN VALUES .Rv -std unlink @@ -97,7 +99,9 @@ or deallocating the inode. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +The +.Fa path +argument points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2 index dd03e90..79dd2d0 100644 --- a/lib/libc/sys/utimes.2 +++ b/lib/libc/sys/utimes.2 @@ -121,9 +121,11 @@ and the effective user ID of the process does not match the owner of the file, and is not the super-user, and write access is denied. .It Bq Er EFAULT +The .Fa path or .Fa times +argument points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading or writing the affected inode. @@ -156,7 +158,9 @@ system call will fail if: .Bl -tag -width Er .It Bq Er EBADF +The .Fa fd +argument does not refer to a valid descriptor. .El .Pp @@ -171,7 +175,9 @@ and the effective user ID of the process does not match the owner of the file, and is not the super-user, and write access is denied. .It Bq Er EFAULT +The .Fa times +argument points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading or writing the affected inode. diff --git a/lib/libc/sys/uuidgen.2 b/lib/libc/sys/uuidgen.2 index 6aa09a8..5cb87ee 100644 --- a/lib/libc/sys/uuidgen.2 +++ b/lib/libc/sys/uuidgen.2 @@ -124,7 +124,7 @@ could not be written to for any or all identifiers. .It Bq Er EINVAL The .Fa count -parameter is less than 1 or larger than the hard upper limit of 2048. +argument is less than 1 or larger than the hard upper limit of 2048. .El .Sh SEE ALSO .Xr uuidgen 1 , diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2 index 7f8925a..a3ba362 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -82,7 +82,7 @@ The other wait functions are implemented using .Pp The .Fa wpid -parameter specifies the set of child processes for which to wait. +argument specifies the set of child processes for which to wait. If .Fa wpid is -1, the call waits for any child process. @@ -102,9 +102,9 @@ equals the absolute value of .Pp The .Fa status -parameter is defined below. The +argument is defined below. The .Fa options -parameter contains the bitwise OR of any of the following options. +argument contains the bitwise OR of any of the following options. The .Dv WCONTINUED option indicates that children of the current process that @@ -279,7 +279,7 @@ The .Fa status or .Fa rusage -arguments point to an illegal address. +argument points to an illegal address. (May not be detected before exit of a child process.) .It Bq Er EINTR The call was interrupted by a caught signal, diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index 0ea137a..5f8776f 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -147,7 +147,9 @@ system calls will fail and the file pointer will remain unchanged if: .Bl -tag -width Er .It Bq Er EBADF -.Fa D +The +.Fa d +argument is not a valid descriptor open for writing. .It Bq Er EPIPE An attempt is made to write to a pipe that is not open @@ -201,7 +203,9 @@ domain datagram socket on which .Xr connect 2 had been used to set a destination address. .It Bq Er EINVAL -.Fa Iovcnt +The +.Fa iovcnt +argument was less than or equal to 0, or greater than .Dv UIO_MAXIOV . .It Bq Er EINVAL |