summaryrefslogtreecommitdiffstats
path: root/lib/libc/sys
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-12-19 09:40:28 +0000
committerru <ru@FreeBSD.org>2002-12-19 09:40:28 +0000
commit51fe7c1a888747c57136cc34ec54a93a0487b745 (patch)
treef0781cb8e5be3a35234a6d0c123d6ae11ba70e40 /lib/libc/sys
parent3424a53ebeadf7ab320c37cf93702953cee94efe (diff)
downloadFreeBSD-src-51fe7c1a888747c57136cc34ec54a93a0487b745.zip
FreeBSD-src-51fe7c1a888747c57136cc34ec54a93a0487b745.tar.gz
mdoc(7) police: "The .Fa argument.".
Diffstat (limited to 'lib/libc/sys')
-rw-r--r--lib/libc/sys/accept.29
-rw-r--r--lib/libc/sys/access.22
-rw-r--r--lib/libc/sys/acct.24
-rw-r--r--lib/libc/sys/aio_cancel.22
-rw-r--r--lib/libc/sys/aio_error.22
-rw-r--r--lib/libc/sys/aio_read.25
-rw-r--r--lib/libc/sys/aio_return.22
-rw-r--r--lib/libc/sys/aio_suspend.24
-rw-r--r--lib/libc/sys/aio_write.24
-rw-r--r--lib/libc/sys/bind.210
-rw-r--r--lib/libc/sys/chdir.24
-rw-r--r--lib/libc/sys/chflags.26
-rw-r--r--lib/libc/sys/chmod.26
-rw-r--r--lib/libc/sys/chown.28
-rw-r--r--lib/libc/sys/chroot.26
-rw-r--r--lib/libc/sys/clock_gettime.23
-rw-r--r--lib/libc/sys/close.24
-rw-r--r--lib/libc/sys/connect.211
-rw-r--r--lib/libc/sys/dup.24
-rw-r--r--lib/libc/sys/execve.24
-rw-r--r--lib/libc/sys/extattr_get_file.29
-rw-r--r--lib/libc/sys/fcntl.216
-rw-r--r--lib/libc/sys/fhopen.23
-rw-r--r--lib/libc/sys/flock.22
-rw-r--r--lib/libc/sys/fork.24
-rw-r--r--lib/libc/sys/fsync.24
-rw-r--r--lib/libc/sys/getdirentries.22
-rw-r--r--lib/libc/sys/getfh.24
-rw-r--r--lib/libc/sys/getfsstat.28
-rw-r--r--lib/libc/sys/getgroups.23
-rw-r--r--lib/libc/sys/getitimer.214
-rw-r--r--lib/libc/sys/getlogin.26
-rw-r--r--lib/libc/sys/getpeername.24
-rw-r--r--lib/libc/sys/getpriority.212
-rw-r--r--lib/libc/sys/getrlimit.22
-rw-r--r--lib/libc/sys/getrusage.26
-rw-r--r--lib/libc/sys/getsockname.24
-rw-r--r--lib/libc/sys/getsockopt.238
-rw-r--r--lib/libc/sys/gettimeofday.22
-rw-r--r--lib/libc/sys/ioctl.212
-rw-r--r--lib/libc/sys/kenv.210
-rw-r--r--lib/libc/sys/kill.216
-rw-r--r--lib/libc/sys/kldsym.22
-rw-r--r--lib/libc/sys/kqueue.28
-rw-r--r--lib/libc/sys/kse.211
-rw-r--r--lib/libc/sys/ktrace.25
-rw-r--r--lib/libc/sys/link.26
-rw-r--r--lib/libc/sys/listen.26
-rw-r--r--lib/libc/sys/lseek.28
-rw-r--r--lib/libc/sys/mkdir.24
-rw-r--r--lib/libc/sys/mkfifo.24
-rw-r--r--lib/libc/sys/mknod.24
-rw-r--r--lib/libc/sys/mlock.24
-rw-r--r--lib/libc/sys/mmap.228
-rw-r--r--lib/libc/sys/mount.216
-rw-r--r--lib/libc/sys/msync.26
-rw-r--r--lib/libc/sys/munmap.24
-rw-r--r--lib/libc/sys/nanosleep.22
-rw-r--r--lib/libc/sys/open.24
-rw-r--r--lib/libc/sys/pathconf.23
-rw-r--r--lib/libc/sys/poll.24
-rw-r--r--lib/libc/sys/profil.24
-rw-r--r--lib/libc/sys/ptrace.211
-rw-r--r--lib/libc/sys/quotactl.222
-rw-r--r--lib/libc/sys/read.212
-rw-r--r--lib/libc/sys/readlink.24
-rw-r--r--lib/libc/sys/reboot.24
-rw-r--r--lib/libc/sys/recv.218
-rw-r--r--lib/libc/sys/rename.217
-rw-r--r--lib/libc/sys/revoke.24
-rw-r--r--lib/libc/sys/rfork.28
-rw-r--r--lib/libc/sys/rmdir.24
-rw-r--r--lib/libc/sys/rtprio.26
-rw-r--r--lib/libc/sys/sched_get_priority_max.22
-rw-r--r--lib/libc/sys/sched_setscheduler.26
-rw-r--r--lib/libc/sys/select.22
-rw-r--r--lib/libc/sys/semctl.26
-rw-r--r--lib/libc/sys/semget.22
-rw-r--r--lib/libc/sys/send.24
-rw-r--r--lib/libc/sys/sendfile.216
-rw-r--r--lib/libc/sys/setgroups.23
-rw-r--r--lib/libc/sys/setregid.22
-rw-r--r--lib/libc/sys/shmat.24
-rw-r--r--lib/libc/sys/shmget.22
-rw-r--r--lib/libc/sys/sigaction.24
-rw-r--r--lib/libc/sys/sigprocmask.27
-rw-r--r--lib/libc/sys/sigreturn.24
-rw-r--r--lib/libc/sys/socket.23
-rw-r--r--lib/libc/sys/stat.28
-rw-r--r--lib/libc/sys/statfs.222
-rw-r--r--lib/libc/sys/swapon.28
-rw-r--r--lib/libc/sys/symlink.28
-rw-r--r--lib/libc/sys/sysarch.24
-rw-r--r--lib/libc/sys/syscall.22
-rw-r--r--lib/libc/sys/truncate.27
-rw-r--r--lib/libc/sys/undelete.24
-rw-r--r--lib/libc/sys/unlink.26
-rw-r--r--lib/libc/sys/utimes.26
-rw-r--r--lib/libc/sys/uuidgen.22
-rw-r--r--lib/libc/sys/wait.28
-rw-r--r--lib/libc/sys/write.28
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
OpenPOWER on IntegriCloud