diff options
Diffstat (limited to 'lib/libc')
178 files changed, 991 insertions, 396 deletions
diff --git a/lib/libc/compat-43/killpg.2 b/lib/libc/compat-43/killpg.2 index 937140f6659f..fe78a9670fdb 100644 --- a/lib/libc/compat-43/killpg.2 +++ b/lib/libc/compat-43/killpg.2 @@ -76,7 +76,9 @@ function 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 in the process group specified by diff --git a/lib/libc/compat-43/sigpause.2 b/lib/libc/compat-43/sigpause.2 index 611b06c5ccfd..331a6b34299e 100644 --- a/lib/libc/compat-43/sigpause.2 +++ b/lib/libc/compat-43/sigpause.2 @@ -56,7 +56,9 @@ assigns to the set of masked signals and then waits for a signal to arrive; on return the set of masked signals is restored. -.Fa Sigmask +The +.Fa sigmask +argument is usually 0 to indicate that no signals are to be blocked. The diff --git a/lib/libc/compat-43/sigvec.2 b/lib/libc/compat-43/sigvec.2 index 335413643b31..4a0db25849af 100644 --- a/lib/libc/compat-43/sigvec.2 +++ b/lib/libc/compat-43/sigvec.2 @@ -274,7 +274,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 @@ -312,8 +314,10 @@ Here .Fa sig is the signal number, into which the hardware faults and traps are mapped as defined below. -.Fa Code -is a parameter that is either a constant +The +.Fa code +argument +is either a constant as given below or, for compatibility mode faults, the code provided by the hardware (Compatibility mode faults are distinguished from the other @@ -321,7 +325,9 @@ other traps by having .Dv PSL_CM set in the psl). -.Fa Scp +The +.Fa scp +argument is a pointer to the .Fa sigcontext structure (defined in diff --git a/lib/libc/db/man/btree.3 b/lib/libc/db/man/btree.3 index 99b2b1502ee7..b861aeb94fdb 100644 --- a/lib/libc/db/man/btree.3 +++ b/lib/libc/db/man/btree.3 @@ -172,7 +172,9 @@ is (no comparison function is specified), the keys are compared lexically, with shorter keys considered less than longer keys. .It Va prefix -.Va Prefix +The +.Va prefix +element is the prefix comparison function. If specified, this routine must return the number of bytes of the second key argument which are necessary to determine that it is greater than the first @@ -206,10 +208,11 @@ is 0 (no order is specified) the current host order is used. If the file already exists (and the .Dv O_TRUNC flag is not specified), the -values specified for the parameters +values specified for the .Va flags , lorder and .Va psize +arguments are ignored in favor of the values used when the tree was created. .Pp diff --git a/lib/libc/db/man/dbm.3 b/lib/libc/db/man/dbm.3 index a78d35a5840e..1fd4d85ae12c 100644 --- a/lib/libc/db/man/dbm.3 +++ b/lib/libc/db/man/dbm.3 @@ -77,7 +77,9 @@ The .Fn dbm_open base flags mode function opens or creates a database. +The .Fa base +argument is the basename of the file containing the database; the actual database has a .Pa .db @@ -88,9 +90,11 @@ is .Qq Li /home/me/mystuff then the actual database is in the file .Pa /home/me/mystuff.db . +The .Fa flags and .Fa mode +arguments are passed to .Xr open 2 . .Pq Dv O_RDWR | O_CREAT @@ -129,7 +133,9 @@ The .Fn dbm_store db key data flags function inserts or replaces an entry in the database. +The .Fa flags +argument is either .Dv DBM_INSERT or diff --git a/lib/libc/db/man/dbopen.3 b/lib/libc/db/man/dbopen.3 index 44ff6576ea22..e67fc29d941e 100644 --- a/lib/libc/db/man/dbopen.3 +++ b/lib/libc/db/man/dbopen.3 @@ -69,7 +69,9 @@ opens .Fa file for reading and/or writing. Files never intended to be preserved on disk may be created by setting -the file parameter to +the +.Fa file +argument to .Dv NULL . .Pp The @@ -180,15 +182,16 @@ with a or .Va sync function may result in inconsistent or lost information. -.Va Close +.Va close routines return -1 on error (setting .Va errno ) and 0 on success. .It Va del A pointer to a routine to remove key/data pairs from the database. .Pp -The parameter +The .Fa flags +argument may be set to the following value: .Bl -tag -width indent .It Dv R_CURSOR @@ -196,7 +199,7 @@ Delete the record referenced by the cursor. The cursor must have previously been initialized. .El .Pp -.Va Delete +.Va delete routines return -1 on error (setting .Va errno ) , 0 on success, and 1 if the specified @@ -230,7 +233,7 @@ The address and length of the data associated with the specified .Fa key are returned in the structure referenced by .Fa data . -.Va Get +.Va get routines return -1 on error (setting .Va errno ) , 0 on success, and 1 if the @@ -239,8 +242,9 @@ was not in the file. .It Va put A pointer to a routine to store key/data pairs in the database. .Pp -The parameter +The .Fa flags +argument may be set to one of the following values: .Bl -tag -width indent .It Dv R_CURSOR @@ -302,7 +306,7 @@ The default behavior of the routines is to enter the new key/data pair, replacing any previously existing key. .Pp -.Va Put +.Va put routines return -1 on error (setting .Va errno ) , 0 on success, and 1 if the @@ -336,7 +340,7 @@ while records inserted in front of the cursor will be returned. .Pp The .Fa flags -value +argument .Em must be set to one of the following values: .Bl -tag -width indent @@ -390,7 +394,7 @@ and access methods because they each imply that the keys have an inherent order which does not change. .Pp -.Va Seq +.Va seq routines return -1 on error (setting .Va errno ) , 0 on success and 1 if there are no key/data pairs less than or greater @@ -410,7 +414,7 @@ routine has no effect and will always succeed. .Pp The .Fa flags -value may be set to the following value: +argument may be set to the following value: .Bl -tag -width indent .It Dv R_RECNOSYNC If the @@ -427,7 +431,7 @@ field of the manual page for more information.) .El .Pp -.Va Sync +.Va sync routines return -1 on error (setting .Va errno ) and 0 on success. @@ -471,7 +475,7 @@ or the following: .It Bq Er EFTYPE A file is incorrectly formatted. .It Bq Er EINVAL -A parameter has been specified (hash function, pad byte etc.) that is +An argument has been specified (hash function, pad byte etc.) that is incompatible with the current file specification or which is not meaningful for the function (for example, use of the cursor without prior initialization) or there is a mismatch between the version diff --git a/lib/libc/db/man/hash.3 b/lib/libc/db/man/hash.3 index 4ed6df96f675..527f59ffcb37 100644 --- a/lib/libc/db/man/hash.3 +++ b/lib/libc/db/man/hash.3 @@ -77,14 +77,18 @@ typedef struct { The elements of this structure are as follows: .Bl -tag -width indent .It Va bsize -.Va Bsize +The +.Va bsize +element defines the .Nm table bucket size, and is, by default, 256 bytes. It may be preferable to increase the page size for disk-resident tables and tables with large data items. .It Va ffactor -.Va Ffactor +The +.Va ffactor +element indicates a desired density within the .Nm table. @@ -94,7 +98,9 @@ one bucket, determining when the table grows or shrinks. The default value is 8. .It Va nelem -.Va Nelem +The +.Va nelem +element is an estimate of the final size of the .Nm table. @@ -110,7 +116,9 @@ This value is advisory, and the access method will allocate more memory rather than fail. .It Va hash -.Va Hash +The +.Va hash +element is a user defined .Nm function. @@ -141,10 +149,11 @@ value specified when the tree was created is used. If the file already exists (and the .Dv O_TRUNC flag is not specified), the -values specified for the parameters +values specified for the .Va bsize , ffactor , lorder and .Va nelem +arguments are ignored and the values specified when the tree was created are used. .Pp diff --git a/lib/libc/db/man/mpool.3 b/lib/libc/db/man/mpool.3 index 26333b8b43a1..965be557f060 100644 --- a/lib/libc/db/man/mpool.3 +++ b/lib/libc/db/man/mpool.3 @@ -146,20 +146,22 @@ is returned and is set. The .Fa flags -parameter is not currently used. +argument is not currently used. .Pp The function .Fn mpool_put unpins the page referenced by .Fa pgaddr . -.Fa Pgaddr +The +.Fa pgaddr +argument must be an address previously returned by .Fn mpool_get or .Fn mpool_new . The .Fa flags -value is specified by +argument is specified by .Em or Ns 'ing any of the following values: .Bl -tag -width indent diff --git a/lib/libc/gen/dllockinit.3 b/lib/libc/gen/dllockinit.3 index f1177283d98a..6af2cf747f6a 100644 --- a/lib/libc/gen/dllockinit.3 +++ b/lib/libc/gen/dllockinit.3 @@ -52,7 +52,7 @@ threads from entering its critical sections simultaneously. .Pp The .Fa context -parameter specifies an opaque context for creating locks. The +argument specifies an opaque context for creating locks. The dynamic linker will pass it to the .Fa lock_create function when creating the locks it needs. When the dynamic linker @@ -65,26 +65,26 @@ to destroy the context. .Pp The .Fa lock_create -parameter specifies a function for creating a read/write lock. It +argument specifies a function for creating a read/write lock. It must return a pointer to the new lock. .Pp The .Fa rlock_acquire and .Fa wlock_acquire -parameters specify functions which lock a lock for reading or +arguments specify functions which lock a lock for reading or writing, respectively. The .Fa lock_release -parameter specifies a function which unlocks a lock. Each of these +argument specifies a function which unlocks a lock. Each of these functions is passed a pointer to the lock. .Pp The .Fa lock_destroy -parameter specifies a function to destroy a lock. It may be +argument specifies a function to destroy a lock. It may be .Dv NULL if locks do not need to be destroyed. The .Fa context_destroy -parameter specifies a function to destroy the context. It may be +argument specifies a function to destroy the context. It may be .Dv NULL if the context does not need to be destroyed. .Pp diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3 index ba37c6f2c9a6..d6bb9f90f004 100644 --- a/lib/libc/gen/dlopen.3 +++ b/lib/libc/gen/dlopen.3 @@ -92,7 +92,9 @@ A null pointer supplied for .Fa path is interpreted as a reference to the main executable of the process. +The .Fa mode +argument controls the way in which external function references from the loaded object are bound to their referents. It must contain one of the following values, possibly ORed with diff --git a/lib/libc/gen/exec.3 b/lib/libc/gen/exec.3 index a17a7de6603c..4875575b0ced 100644 --- a/lib/libc/gen/exec.3 +++ b/lib/libc/gen/exec.3 @@ -118,9 +118,9 @@ and functions also specify the environment of the executed process by following the .Dv NULL -pointer that terminates the list of arguments in the parameter list -or the pointer to the argv array with an additional parameter. -This additional parameter is an array of pointers to null-terminated strings +pointer that terminates the list of arguments in the argument list +or the pointer to the argv array with an additional argument. +This additional argument is an array of pointers to null-terminated strings and .Em must be terminated by a diff --git a/lib/libc/gen/fmtcheck.3 b/lib/libc/gen/fmtcheck.3 index 507ef27b1859..1cb48838b86a 100644 --- a/lib/libc/gen/fmtcheck.3 +++ b/lib/libc/gen/fmtcheck.3 @@ -67,7 +67,7 @@ family of functions cannot verify the types of arguments that they are passed at run-time. In some cases, like .Xr catgets 3 , it is useful or necessary to use a user-supplied format string with no -guarantee that the format string matches the specified parameters. +guarantee that the format string matches the specified arguments. .Pp The .Fn fmtcheck @@ -94,7 +94,7 @@ Otherwise, it will return .Fa fmt_default . .Sh SECURITY CONSIDERATIONS Note that the formats may be quite different as long as they accept the -same parameters. For example, +same arguments. For example, .Qq Li "%p %o %30s %#llx %-10.*e %n" is compatible with .Qq Li "This number %lu %d%% and string %s has %qd numbers and %.*g floats (%n)" . diff --git a/lib/libc/gen/fts.3 b/lib/libc/gen/fts.3 index b50b31663454..541286dd6bba 100644 --- a/lib/libc/gen/fts.3 +++ b/lib/libc/gen/fts.3 @@ -95,25 +95,25 @@ prune and/or re-visit portions of the hierarchy. Two structures are defined (and typedef'd) in the include file .Aq Pa fts.h . The first is -.Fa FTS , +.Vt FTS , the structure that represents the file hierarchy itself. The second is -.Fa FTSENT , +.Vt FTSENT , the structure that represents a file in the file hierarchy. Normally, an -.Fa FTSENT +.Vt FTSENT structure is returned for every file in the file hierarchy. In this manual page, .Dq file and -.Dq Fa FTSENT No structure +.Dq Vt FTSENT No structure are generally interchangeable. .Pp The -.Fa FTS +.Vt FTS structure contains space for a single pointer, which may be used to store application data or per-hierarchy state. The @@ -123,7 +123,7 @@ and functions may be used to set and retrieve this pointer. This is likely to be useful only when accessed from the sort comparison function, which can determine the original -.Fa FTS +.Vt FTS stream of its arguments using the .Fn fts_get_stream function. @@ -132,7 +132,7 @@ The two functions are also available as macros of the same name. .Pp The -.Fa FTSENT +.Vt FTSENT structure contains at least the following fields, which are described in greater detail below: .Bd -literal @@ -158,7 +158,7 @@ These fields are defined as follows: .Bl -tag -width "fts_namelen" .It Fa fts_info One of the following values describing the returned -.Fa FTSENT +.Vt FTSENT structure and the file it represents. With the exception of directories without errors @@ -174,11 +174,11 @@ A directory that causes a cycle in the tree. (The .Fa fts_cycle field of the -.Fa FTSENT +.Vt FTSENT structure will be filled in as well.) .It Dv FTS_DEFAULT Any -.Fa FTSENT +.Vt FTSENT structure that represents a file type not explicitly described by one of the other .Fa fts_info @@ -200,7 +200,7 @@ which was not specified as a file name to .It Dv FTS_DP A directory being visited in post-order. The contents of the -.Fa FTSENT +.Vt FTSENT structure will be unchanged from when it was returned in pre-order, i.e. with the .Fa fts_info @@ -257,19 +257,19 @@ The length of the string referenced by The depth of the traversal, numbered from \-1 to N, where this file was found. The -.Fa FTSENT +.Vt FTSENT structure representing the parent of the starting point (or root) of the traversal is numbered .Dv FTS_ROOTPARENTLEVEL (\-1), and the -.Fa FTSENT +.Vt FTSENT structure for the root itself is numbered .Dv FTS_ROOTLEVEL (0). .It Fa fts_errno Upon return of a -.Fa FTSENT +.Vt FTSENT structure from the .Fn fts_children or @@ -304,7 +304,7 @@ It is initialized to .Dv NULL . .It Fa fts_parent A pointer to the -.Fa FTSENT +.Vt FTSENT structure referencing the file in the hierarchy immediately above the current file, i.e. the directory of which this file is a member. @@ -333,9 +333,9 @@ of a hard link between two directories, or a symbolic link pointing to a directory, the .Fa fts_cycle field of the structure will point to the -.Fa FTSENT +.Vt FTSENT structure in the hierarchy that references the same file as the current -.Fa FTSENT +.Vt FTSENT structure. Otherwise, the contents of the .Fa fts_cycle @@ -358,10 +358,10 @@ fields are guaranteed to be for the file most recently returned by .Fn fts_read . To use these fields to reference any files represented by other -.Fa FTSENT +.Vt FTSENT structures will require that the path buffer be modified using the information contained in that -.Fa FTSENT +.Vt FTSENT structure's .Fa fts_pathlen field. @@ -400,11 +400,11 @@ is also specified. This option causes the .Nm routines to return -.Fa FTSENT +.Vt FTSENT structures for the targets of symbolic links instead of the symbolic links themselves. If this option is set, the only symbolic links for which -.Fa FTSENT +.Vt FTSENT structures are returned to the application are those referencing non-existent files. Either @@ -434,7 +434,7 @@ pathnames were provided as arguments to .Fn fts_open . .It Dv FTS_NOSTAT By default, returned -.Fa FTSENT +.Vt FTSENT structures reference file characteristic information (the .Fa statp field) for each file visited. @@ -452,11 +452,11 @@ field undefined. This option causes the .Nm routines to return -.Fa FTSENT +.Vt FTSENT structures for symbolic links themselves instead of the target files they point to. If this option is set, -.Fa FTSENT +.Vt FTSENT structures for all symbolic links in the hierarchy are returned to the application. Either @@ -478,7 +478,7 @@ encountered in the file hierarchy are ignored. This option causes the .Nm routines to return -.Fa FTSENT +.Vt FTSENT structures for them. .It Dv FTS_XDEV This option prevents @@ -493,7 +493,7 @@ specifies a user-defined function which may be used to order the traversal of the hierarchy. It takes two pointers to pointers to -.Fa FTSENT +.Vt FTSENT structures as arguments and should return a negative value, zero, or a positive value to indicate if the file referenced by its first argument comes before, in any order @@ -504,7 +504,7 @@ The and .Fa fts_pathlen fields of the -.Fa FTSENT +.Vt FTSENT structures may .Em never be used in this comparison. @@ -529,7 +529,7 @@ everything else. The .Fn fts_read function returns a pointer to an -.Fa FTSENT +.Vt FTSENT structure describing a file in the hierarchy. Directories (that are readable and do not cause cycles) are visited at @@ -554,14 +554,14 @@ and sets .Va errno appropriately. If an error related to a returned file occurs, a pointer to an -.Fa FTSENT +.Vt FTSENT structure is returned, and .Va errno may or may not have been set (see .Fa fts_info ) . .Pp The -.Fa FTSENT +.Vt FTSENT structures returned by .Fn fts_read may be overwritten after a call to @@ -572,7 +572,7 @@ on the same file hierarchy stream unless they represent a file of type directory, in which case they will not be overwritten until after a call to .Fn fts_read after the -.Fa FTSENT +.Vt FTSENT structure has been returned by the function .Fn fts_read in post-order. @@ -580,16 +580,16 @@ in post-order. The .Fn fts_children function returns a pointer to an -.Fa FTSENT +.Vt FTSENT structure describing the first entry in a NULL-terminated linked list of the files in the directory represented by the -.Fa FTSENT +.Vt FTSENT structure most recently returned by .Fn fts_read . The list is linked through the .Fa fts_link field of the -.Fa FTSENT +.Vt FTSENT structure, and is ordered by the user-specified comparison function, if any. Repeated calls to .Fn fts_children @@ -604,7 +604,7 @@ will return a pointer to the files in the logical directory specified to i.e. the arguments specified to .Fn fts_open . Otherwise, if the -.Fa FTSENT +.Vt FTSENT structure most recently returned by .Fn fts_read is not a directory being visited in pre-order, @@ -624,7 +624,7 @@ and sets appropriately. .Pp The -.Fa FTSENT +.Vt FTSENT structures returned by .Fn fts_children may be overwritten after a call to diff --git a/lib/libc/gen/getcap.3 b/lib/libc/gen/getcap.3 index 9b4b4f8cb831..a2c2e7dec86a 100644 --- a/lib/libc/gen/getcap.3 +++ b/lib/libc/gen/getcap.3 @@ -94,7 +94,9 @@ function will first look for files ending in (see .Xr cap_mkdb 1 ) before accessing the ASCII file. -.Fa Buf +The +.Fa buf +argument must be retained through all subsequent calls to .Fn cgetmatch , .Fn cgetcap , diff --git a/lib/libc/gen/getdomainname.3 b/lib/libc/gen/getdomainname.3 index 7fd3d48b271b..6e0ed6b4073a 100644 --- a/lib/libc/gen/getdomainname.3 +++ b/lib/libc/gen/getdomainname.3 @@ -54,8 +54,9 @@ function returns the standard domain name for the current processor, as previously set by .Fn setdomainname . -The parameter +The .Fa namelen +argument specifies the size of the .Fa name array. The returned name is null-terminated unless insufficient @@ -80,7 +81,7 @@ The .Fa name or .Fa namelen -parameter gave an +argument gave an invalid address. .It Bq Er EPERM The caller tried to set the hostname and was not the super-user. diff --git a/lib/libc/gen/gethostname.3 b/lib/libc/gen/gethostname.3 index c8cd1cbdf394..78223225746f 100644 --- a/lib/libc/gen/gethostname.3 +++ b/lib/libc/gen/gethostname.3 @@ -54,8 +54,9 @@ function returns the standard host name for the current processor, as previously set by .Fn sethostname . -The parameter +The .Fa namelen +argument specifies the size of the .Fa name array. The returned name is null-terminated unless insufficient @@ -80,7 +81,7 @@ The .Fa name or .Fa namelen -parameter gave an +argument gave an invalid address. .It Bq Er EPERM The caller tried to set the hostname and was not the super-user. diff --git a/lib/libc/gen/getmntinfo.3 b/lib/libc/gen/getmntinfo.3 index 16f6fcc94490..7a3cc0261c30 100644 --- a/lib/libc/gen/getmntinfo.3 +++ b/lib/libc/gen/getmntinfo.3 @@ -60,7 +60,7 @@ The function passes its .Fa flags -parameter transparently to +argument transparently to .Xr getfsstat 2 . .Sh RETURN VALUES On successful completion, diff --git a/lib/libc/gen/getttyent.3 b/lib/libc/gen/getttyent.3 index 593bef191184..4a8535fca367 100644 --- a/lib/libc/gen/getttyent.3 +++ b/lib/libc/gen/getttyent.3 @@ -183,7 +183,7 @@ The routines and .Fn isnettty return non-zero if the dialup or network flag is set for the -tty entry relating to the tty named by the parameter, and +tty entry relating to the tty named by the argument, and zero otherwise. .Sh FILES .Bl -tag -width /etc/ttys -compact diff --git a/lib/libc/gen/getvfsbyname.3 b/lib/libc/gen/getvfsbyname.3 index 067e87a6cf2e..a7cfa2e9c47f 100644 --- a/lib/libc/gen/getvfsbyname.3 +++ b/lib/libc/gen/getvfsbyname.3 @@ -94,10 +94,12 @@ The following errors may be reported: .It Bq Er EFAULT The .Fa vfc -pointer contains an invalid address. +argument +points to an invalid address. .It Bq Er ENOENT The .Fa name +argument specifies a file system that is unknown or not configured in the kernel. .El .Sh SEE ALSO diff --git a/lib/libc/gen/getvfsent.3 b/lib/libc/gen/getvfsent.3 index 89d52e7becb7..7c4a9340a8bc 100644 --- a/lib/libc/gen/getvfsent.3 +++ b/lib/libc/gen/getvfsent.3 @@ -77,7 +77,7 @@ obtained in toto from the kernel via .Xr sysctl 3 . If the .Fa cachelist -parameter to +argument to .Fn setvfsent is non-zero, the list will be retrieved only once, upon the first call to one of the retrieval functions, until diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3 index 9aac9b0cc81c..93f0c8f6dcd2 100644 --- a/lib/libc/gen/glob.3 +++ b/lib/libc/gen/glob.3 @@ -354,7 +354,7 @@ contains the number of matched pathnames in the current invocation of .It Fa gl_flags contains a copy of the .Fa flags -parameter with the bit +argument with the bit .Dv GLOB_MAGCHAR set if .Fa pattern diff --git a/lib/libc/gen/makecontext.3 b/lib/libc/gen/makecontext.3 index 041985372d32..ad55e7abcb47 100644 --- a/lib/libc/gen/makecontext.3 +++ b/lib/libc/gen/makecontext.3 @@ -65,14 +65,18 @@ and had a stack allocated for it. The context is modified so that it will continue execution by invoking .Fn func with the arguments provided. +The .Fa argc +argument must be equal to the number of additional arguments provided to .Fn makecontext -and also equal to the number of parameters to +and also equal to the number of arguments to .Fn func , or else the behavior is undefined. .Pp +The .Fa "ucp->uc_link" +argument must be initialized before calling .Fn makecontext and determines the action to take when diff --git a/lib/libc/gen/msgctl.3 b/lib/libc/gen/msgctl.3 index 45db2b91a66a..b0264b5428c7 100644 --- a/lib/libc/gen/msgctl.3 +++ b/lib/libc/gen/msgctl.3 @@ -174,7 +174,9 @@ function will fail if: .Bl -tag -width Er .It Bq Er EPERM +The .Fa cmd +argument is equal to IPC_SET or IPC_RMID and the caller is not the super-user, nor does the effective uid match either the .Va msg_perm.uid @@ -190,13 +192,17 @@ but the caller is not the super-user. The command is IPC_STAT and the caller has no read permission for this message queue. .It Bq Er EINVAL +The .Fa msqid +argument is not a valid message queue identifier. .Pp .Va cmd is not a valid command. .It Bq Er EFAULT +The .Fa buf +argument specifies an invalid address. .El .Sh SEE ALSO diff --git a/lib/libc/gen/msgrcv.3 b/lib/libc/gen/msgrcv.3 index 298576178d00..d6401b654b9d 100644 --- a/lib/libc/gen/msgrcv.3 +++ b/lib/libc/gen/msgrcv.3 @@ -69,22 +69,30 @@ The value of has one of the following meanings: .Bl -bullet .It +The .Fa msgtyp +argument is greater than 0. The first message of type .Fa msgtyp will be received. .It +The .Fa msgtyp +argument is equal to 0. The first message on the queue will be received. .It +The .Fa msgtyp +argument is less than 0. The first message of the lowest message type that is less than or equal to the absolute value of .Fa msgtyp will be received. .El .Pp +The .Fa msgsz +argument specifies the maximum length of the requested message. If the received message has a length greater than @@ -165,14 +173,18 @@ function will fail if: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa msqid +argument is not a valid message queue identifier. .Pp The message queue was removed while .Fn msgrcv was waiting for a message of the requested type to become available on it. .Pp +The .Fa msgsz +argument is less than 0. .It Bq Er E2BIG A matching message was received, but its size was greater than @@ -184,7 +196,9 @@ flag was not set in .It Bq Er EACCES The calling process does not have read access to the message queue. .It Bq Er EFAULT +The .Fa msgp +argument points to an invalid address. .It Bq Er EINTR The system call was interrupted by the delivery of a signal. diff --git a/lib/libc/gen/msgsnd.3 b/lib/libc/gen/msgsnd.3 index 70ed45a97a66..f41c17347a4d 100644 --- a/lib/libc/gen/msgsnd.3 +++ b/lib/libc/gen/msgsnd.3 @@ -50,7 +50,9 @@ The .Fn msgsnd function sends a message to the message queue specified in .Fa msqid . +The .Fa msgp +argument points to a structure containing the message. This structure should consist of the following members: @@ -129,7 +131,9 @@ function will fail if: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa msqid +argument is not a valid message queue identifier .Pp The message queue was removed while @@ -137,11 +141,15 @@ The message queue was removed while was waiting for a resource to become available in order to deliver the message. .Pp +The .Fa msgsz +argument is less than 0, or greater than .Va msg_qbytes . .Pp +The .Fa mtype +argument is not greater than 0. .It Bq Er EACCES The calling process does not have write access to the message queue. @@ -152,7 +160,9 @@ system, and was set in .Fa msgflg . .It Bq Er EFAULT +The .Fa msgp +argument points to an invalid address. .It Bq Er EINTR The system call was interrupted by the delivery of a signal. diff --git a/lib/libc/gen/rand48.3 b/lib/libc/gen/rand48.3 index 0fe766a656c8..3a263c8f1e24 100644 --- a/lib/libc/gen/rand48.3 +++ b/lib/libc/gen/rand48.3 @@ -163,7 +163,7 @@ and the seed used in .Fn lrand48 , and .Fn mrand48 . -An array of 7 shorts is passed as parameter; the first three shorts are +An array of 7 shorts is passed as argument; the first three shorts are used to initialize the seed; the second three are used to initialize the multiplicand; and the last short is used to initialize the addend. It is thus not possible to use values greater than 0xffff as the addend. diff --git a/lib/libc/gen/scandir.3 b/lib/libc/gen/scandir.3 index fd090cc31d64..045e4ececa09 100644 --- a/lib/libc/gen/scandir.3 +++ b/lib/libc/gen/scandir.3 @@ -64,7 +64,7 @@ referenced by .Pp The .Fa select -parameter is a pointer to a user supplied subroutine which is called by +argument is a pointer to a user supplied subroutine which is called by .Fn scandir to select which entries are to be included in the array. The select routine is passed a @@ -76,7 +76,7 @@ is null, then all the directory entries will be included. .Pp The .Fa compar -parameter is a pointer to a user supplied subroutine which is passed to +argument is a pointer to a user supplied subroutine which is passed to .Xr qsort 3 to sort the completed array. If this pointer is null, the array is not sorted. @@ -86,7 +86,7 @@ The function is a routine which can be used for the .Fa compar -parameter to sort the array alphabetically. +argument to sort the array alphabetically. .Pp The memory allocated for the array can be deallocated with .Xr free 3 , diff --git a/lib/libc/gen/siginterrupt.3 b/lib/libc/gen/siginterrupt.3 index 79aed047fefa..9680a1523d42 100644 --- a/lib/libc/gen/siginterrupt.3 +++ b/lib/libc/gen/siginterrupt.3 @@ -106,7 +106,9 @@ The call fails if: .Bl -tag -width Er .It Bq Er EINVAL +The .Fa sig +argument is not a valid signal number. .El .Sh SEE ALSO diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3 index a311e86e05c2..c536cd76141a 100644 --- a/lib/libc/gen/signal.3 +++ b/lib/libc/gen/signal.3 @@ -135,7 +135,7 @@ is possible on a descriptor (see .Pp The .Fa sig -parameter specifies which signal was received. +argument specifies which signal was received. The .Fa func procedure allows a user to choose the action upon receipt of a signal. @@ -218,7 +218,9 @@ will fail and no action will take place if one of the following occur: .Bl -tag -width Er .It Bq Er EINVAL +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/gen/sysctl.3 b/lib/libc/gen/sysctl.3 index 6ea38c374581..8bf54abb2649 100644 --- a/lib/libc/gen/sysctl.3 +++ b/lib/libc/gen/sysctl.3 @@ -109,7 +109,9 @@ should be set to NULL. .Pp The size of the available data can be determined by calling .Fn sysctl -with a NULL parameter for +with the +.Dv NULL +argument for .Fa oldp . The size of the available data will be returned in the location pointed to by .Fa oldlenp . diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index 96c0cfad2b18..a82d36a01a58 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -130,8 +130,9 @@ by .Fn syslog and .Fn vsyslog . -The parameter +The .Fa ident +argument is a string that will be prepended to every message. The .Fa logopt @@ -163,7 +164,7 @@ instantiations of daemons. .Pp The .Fa facility -parameter encodes a default facility to be assigned to all messages +argument encodes a default facility to be assigned to all messages that do not have an explicit facility encoded: .Bl -tag -width LOG_AUTHPRIV .It Dv LOG_AUTH diff --git a/lib/libc/gen/tcsendbreak.3 b/lib/libc/gen/tcsendbreak.3 index 5c9c36211de2..e85d104c15d9 100644 --- a/lib/libc/gen/tcsendbreak.3 +++ b/lib/libc/gen/tcsendbreak.3 @@ -117,7 +117,7 @@ of a second to the terminal referenced by .Fa fd . The .Fa len -parameter is ignored in this implementation. +argument is ignored in this implementation. .Sh RETURN VALUES Upon successful completion, all of these functions return a value of zero. .Sh ERRORS diff --git a/lib/libc/gen/tcsetattr.3 b/lib/libc/gen/tcsetattr.3 index 24717a866aeb..f52742beed67 100644 --- a/lib/libc/gen/tcsetattr.3 +++ b/lib/libc/gen/tcsetattr.3 @@ -215,7 +215,7 @@ termios structure referenced by .Fa tp . The .Fa action -field is created by +argument is created by .Em or Ns 'ing the following values, as specified in the include file .Aq Pa termios.h . diff --git a/lib/libc/gen/timezone.3 b/lib/libc/gen/timezone.3 index e506d61776ae..2a90c11793f9 100644 --- a/lib/libc/gen/timezone.3 +++ b/lib/libc/gen/timezone.3 @@ -58,7 +58,9 @@ function returns a pointer to a time zone abbreviation for the specified and .Fa dst values. -.Fa Zone +The +.Fa zone +argument is the number of minutes west of GMT and .Fa dst is non-zero if daylight savings time is in effect. diff --git a/lib/libc/gen/ulimit.3 b/lib/libc/gen/ulimit.3 index fc58dfe977e9..c5030a5da62e 100644 --- a/lib/libc/gen/ulimit.3 +++ b/lib/libc/gen/ulimit.3 @@ -42,7 +42,7 @@ function will get and set process limits. Currently this is limited to the maximum file size. The .Fa cmd -parameter is one of the following: +argument is one of the following: .Bl -tag -width ".Dv UL_GETSIZE" .It Dv UL_GETSIZE will return the maximum file size in units of 512 blocks of diff --git a/lib/libc/gen/vis.3 b/lib/libc/gen/vis.3 index 67bbc1f1e828..6f685a90e7fb 100644 --- a/lib/libc/gen/vis.3 +++ b/lib/libc/gen/vis.3 @@ -67,7 +67,9 @@ thus, when encoding a set of characters into a buffer, the size of the buffer should be four times the number of characters encoded, plus one for the trailing .Dv NUL . -The flag parameter is used for altering the default range of +The +.Fa flag +argument is used for altering the default range of characters considered for encoding and for altering the visual representation. The additional character, @@ -227,7 +229,9 @@ The following sequences are used to represent the indicated characters: .Li \e0 Tn - NUL No (000) .Ed .Pp -When using this format, the nextc parameter is looked at to determine +When using this format, the +.Fa nextc +argument is looked at to determine if a .Dv NUL character can be encoded as diff --git a/lib/libc/gmon/moncontrol.3 b/lib/libc/gmon/moncontrol.3 index 6d07aa7be854..07636c48255f 100644 --- a/lib/libc/gmon/moncontrol.3 +++ b/lib/libc/gmon/moncontrol.3 @@ -82,9 +82,11 @@ Programs that are not loaded with may selectively collect profiling statistics by calling .Fn monstartup with the range of addresses to be profiled. +The .Fa lowpc and .Fa highpc +arguments specify the address range that is to be sampled; the lowest address sampled is that of .Fa lowpc diff --git a/lib/libc/i386/sys/i386_get_ldt.2 b/lib/libc/i386/sys/i386_get_ldt.2 index 9bc8583c5d84..a64742c89d81 100644 --- a/lib/libc/i386/sys/i386_get_ldt.2 +++ b/lib/libc/i386/sys/i386_get_ldt.2 @@ -98,7 +98,7 @@ system calls will fail if: .Bl -tag -width Er .It Bq Er EINVAL -An inappropriate parameter was used for +An inappropriate value was used for .Fa start_sel or .Fa num_sels . diff --git a/lib/libc/i386/sys/i386_set_watch.3 b/lib/libc/i386/sys/i386_set_watch.3 index 8f025556f985..b388c46cbf91 100644 --- a/lib/libc/i386/sys/i386_set_watch.3 +++ b/lib/libc/i386/sys/i386_set_watch.3 @@ -54,13 +54,15 @@ The .Fn i386_set_watch function will set up the specified debug registers as indicated by the -parameters. The +arguments. The .Fa watchnum argument specifies which watch register is used, 0, 1, 2, 3, or -1. If .Fa watchnum is -1, a free watch register is found and used. If there are no free watch registers, an error code of -1 is returned. -.Fa Watchaddr +The +.Fa watchaddr +argument specifies the watch address, .Fa size specifies the size in bytes of the area to be watched (1, 2, or 4 bytes), diff --git a/lib/libc/i386/sys/i386_vm86.2 b/lib/libc/i386/sys/i386_vm86.2 index 2ba058094e01..ab2263337000 100644 --- a/lib/libc/i386/sys/i386_vm86.2 +++ b/lib/libc/i386/sys/i386_vm86.2 @@ -43,13 +43,17 @@ The .Fn i386_vm86 system call is used to call various vm86 related functions. +The .Fa function +argument can be one of the following values: .Bl -tag -offset indent -width VM86_SET_VME .It Dv VM86_INIT This will initialize the kernel's vm86 parameter area for the process, and permit the process to make vm86 calls. +The .Fa data +argument points to the following structure: .Bd -literal struct vm86_init_args { @@ -59,11 +63,17 @@ struct vm86_init_args { }; .Ed .Pp +The .Fa debug +argument is used to turn on debugging code. +The .Fa cpu_type +argument controls the type of CPU being emulated, and is currently unimplemented. +The .Fa int_map +argument is a bitmap which determines whether vm86 interrupts should be handled in vm86 mode, or reflected back to the process. If the .Em Nth diff --git a/lib/libc/locale/rune.3 b/lib/libc/locale/rune.3 index a880deeb15dc..3e90e2069138 100644 --- a/lib/libc/locale/rune.3 +++ b/lib/libc/locale/rune.3 @@ -239,6 +239,7 @@ The function was successful. .It Bq Er EINVAL +The .Fa locale name was incorrect. .It Bq Er ENOENT diff --git a/lib/libc/net/addr2ascii.3 b/lib/libc/net/addr2ascii.3 index ce5d720a8777..31e9f3f7bbe2 100644 --- a/lib/libc/net/addr2ascii.3 +++ b/lib/libc/net/addr2ascii.3 @@ -87,16 +87,16 @@ function performs the inverse operation to .Fn addr2ascii . In addition to .Fa af , -it takes two parameters, +it takes two arguments, .Fa ascii and .Fa result . The .Fa ascii -parameter is a pointer to the string which is to be converted into +argument is a pointer to the string which is to be converted into binary. The .Fa result -parameter is a pointer to an appropriate network address structure for +argument is a pointer to an appropriate network address structure for the specified family. .Pp The following gives the appropriate structure to use for binary @@ -171,12 +171,12 @@ The .Fn addr2ascii routine was passed a .Fa len -parameter which was inappropriate for the address family given by +argument which was inappropriate for the address family given by .Fa af . .It Bq Er EPROTONOSUPPORT Either routine was passed an .Fa af -parameter other than +argument other than .Dv AF_INET or .Dv AF_LINK . diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3 index 4dbd771fa050..f8c8f571d00c 100644 --- a/lib/libc/net/getaddrinfo.3 +++ b/lib/libc/net/getaddrinfo.3 @@ -342,9 +342,10 @@ To return this information to the system the function .Fn freeaddrinfo is called. The -.Fa addrinfo +.Vt addrinfo structure pointed to by the -.Fa ai argument +.Fa ai +argument is freed, along with any dynamic storage pointed to by the structure. This operation is repeated until a .Dv NULL @@ -531,7 +532,9 @@ Invalid value for .It Dv EAI_FAIL Non-recoverable failure in name resolution. .It Dv EAI_FAMILY +The .Fa ai_family +address family is not supported. .It Dv EAI_MEMORY Memory allocation failure. @@ -539,16 +542,21 @@ Memory allocation failure. No address associated with .Fa nodename . .It Dv EAI_NONAME +Neither .Fa nodename nor .Fa servname provided, or not known. .It Dv EAI_SERVICE +The .Fa servname +service name is not supported for .Fa ai_socktype . .It Dv EAI_SOCKTYPE +The .Fa ai_socktype +socket type is not supported. .It Dv EAI_SYSTEM System error returned in diff --git a/lib/libc/net/gethostbyname.3 b/lib/libc/net/gethostbyname.3 index 4f4b9dc46a99..c6f7b90aee9f 100644 --- a/lib/libc/net/gethostbyname.3 +++ b/lib/libc/net/gethostbyname.3 @@ -92,7 +92,7 @@ referenced by name or by address, respectively. .Pp The .Fa name -parameter passed to +argument passed to .Fn gethostbyname or .Fn gethostbyname2 @@ -101,7 +101,7 @@ should point to a hostname. The .Fa addr -parameter passed to +argument passed to .Fn gethostbyaddr should point to an address which is .Fa len @@ -112,7 +112,7 @@ in binary form form). The .Fa type -parameter specifies the address family +argument specifies the address family (e.g.\& .Dv AF_INET , AF_INET6 , etc.) of this address. @@ -217,8 +217,8 @@ connection. The .Fn herror function writes a message to the diagnostic output consisting of the -string parameter -.Fa s , +string argument +.Fa string , the constant string .Qq Li ":\ " , and a message corresponding to the value of @@ -229,7 +229,7 @@ The function returns a string which is the message text corresponding to the value of the .Fa err -parameter. +argument. .Sh FILES .Bl -tag -width /etc/nsswitch.conf -compact .It Pa /etc/hosts diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3 index 09da4a88751d..f0496e74ffb5 100644 --- a/lib/libc/net/getnameinfo.3 +++ b/lib/libc/net/getnameinfo.3 @@ -246,7 +246,7 @@ for the specified family. .It Bq Er EAI_MEMORY There was a memory allocation failure. .It Bq Er EAI_NONAME -The name does not resolve for the supplied parameters. +The name does not resolve for the supplied arguments. .Dv NI_NAMEREQD is set and the host's name cannot be located, or both nodename and servname were null. diff --git a/lib/libc/net/getnetent.3 b/lib/libc/net/getnetent.3 index 8a9fb69c65e9..f05df36e2d4e 100644 --- a/lib/libc/net/getnetent.3 +++ b/lib/libc/net/getnetent.3 @@ -133,6 +133,7 @@ or until is encountered. The .Fa type +argument must be .Dv AF_INET . Network numbers are supplied in host order. diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3 index 00a9b462c5fc..aae979193cff 100644 --- a/lib/libc/net/inet6_option_space.3 +++ b/lib/libc/net/inet6_option_space.3 @@ -118,7 +118,9 @@ on success or .Li -1 on an error. .Pp +The .Fa bp +argument is a pointer to previously allocated space that will contain the ancillary data object. It must be large enough to contain all the @@ -127,17 +129,23 @@ individual options to be added by later calls to and .Fn inet6_option_alloc . .Pp +The .Fa cmsgp +argument is a pointer to a pointer to a .Li cmsghdr structure. +The .Fa *cmsgp +argument is initialized by this function to point to the .Li cmsghdr structure constructed by this function in the buffer pointed to by .Fa bp . .Pp +The .Fa type +argument is either .Dv IPV6_HOPOPTS or @@ -161,14 +169,18 @@ if it succeeds or .Li -1 on an error. .Pp +The .Fa cmsg +argument is a pointer to the .Li cmsghdr structure that must have been initialized by .Fn inet6_option_init . .Pp +The .Fa typep +argument is a pointer to the 8-bit option type. It is assumed that this field is immediately followed by the 8-bit option data length field, @@ -198,7 +210,9 @@ and .Li 255 , inclusive, and is the length of the option data that follows. .Pp +The .Fa multx +argument is the value .Li x in the alignment term @@ -210,7 +224,9 @@ It must have a value of or .Li 8 . .Pp +The .Fa plusy +argument is the value .Li y in the alignment term @@ -237,14 +253,18 @@ the ancillary data object while the current function returns a pointer to the space in the data object where the option's TLV must then be built by the caller. .Pp +The .Fa cmsg +argument is a pointer to the .Li cmsghdr structure that must have been initialized by .Fn inet6_option_init . .Pp +The .Fa datalen +argument is the value of the option data length byte for this option. This value is required as an argument to allow the function to determine if padding must be appended at the end of the option. @@ -253,7 +273,9 @@ determine if padding must be appended at the end of the option. function does not need a data length argument since the option data length must already be stored by the caller.) .Pp +The .Fa multx +argument is the value .Li x in the alignment term @@ -265,7 +287,9 @@ It must have a value of or .Li 8 . .Pp +The .Fa plusy +argument is the value .Li y in the alignment term @@ -302,7 +326,9 @@ and is not .Dv NULL . .Pp +The .Fa cmsg +argument is a pointer to .Li cmsghdr structure of which @@ -316,7 +342,9 @@ equals either or .Dv IPV6_DSTOPTS . .Pp +The .Fa tptrp +argument is a pointer to a pointer to an 8-bit byte and .Fa *tptrp is used @@ -339,7 +367,9 @@ This function is similar to the previously described function, except this function lets the caller specify the option type to be searched for, instead of always returning the next option in the ancillary data object. +The .Fa cmsg +argument is a pointer to .Li cmsghdr @@ -354,7 +384,9 @@ equals either or .Dv IPV6_DSTOPTS . .Pp +The .Fa tptrp +argument is a pointer to a pointer to an 8-bit byte and .Fa *tptrp is used diff --git a/lib/libc/net/inet_net.3 b/lib/libc/net/inet_net.3 index 72fc4455feed..9ca00a6e86a7 100644 --- a/lib/libc/net/inet_net.3 +++ b/lib/libc/net/inet_net.3 @@ -61,7 +61,9 @@ function converts an Internet network number from network format (usually a .Vt "struct in_addr" or some other binary form, in network byte order) to CIDR presentation format (suitable for external display purposes). +The .Fa bits +argument is the number of bits in .Fa src that are the network number. @@ -90,7 +92,9 @@ The only value for .Fa af currently supported is .Dv AF_INET . +The .Fa size +argument is the size of the result buffer .Fa dst . .Pp diff --git a/lib/libc/net/rcmdsh.3 b/lib/libc/net/rcmdsh.3 index 10d95a22d6f7..91b81b98e7fe 100644 --- a/lib/libc/net/rcmdsh.3 +++ b/lib/libc/net/rcmdsh.3 @@ -79,8 +79,9 @@ residing at the well-known Internet port .Dq Li shell/tcp (or whatever port is used by .Fa rshprog ) . -The parameter +The .Fa inport +argument is ignored; it is only included to provide an interface similar to .Xr rcmd 3 . .Pp diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3 index 60c1193208da..2a895002dafc 100644 --- a/lib/libc/net/resolver.3 +++ b/lib/libc/net/resolver.3 @@ -292,7 +292,9 @@ but can be any of the query types defined in .Aq Pa arpa/nameser.h . The domain name for the query is given by .Fa dname . -.Fa Newrr +The +.Fa newrr_in +argument is currently unused but is intended for making update messages. .Pp The diff --git a/lib/libc/net/sockatmark.3 b/lib/libc/net/sockatmark.3 index da073c0b356f..61a1a9f52989 100644 --- a/lib/libc/net/sockatmark.3 +++ b/lib/libc/net/sockatmark.3 @@ -94,10 +94,14 @@ The call fails if: .Bl -tag -width Er .It Bq Er EBADF +The .Fa s +argument is not a valid descriptor. .It Bq Er ENOTTY +The .Fa s +argument is a descriptor for a file, not a socket. .El .Sh SEE ALSO diff --git a/lib/libc/posix1e/mac_set.3 b/lib/libc/posix1e/mac_set.3 index 04ab2213f782..92097753bfe9 100644 --- a/lib/libc/posix1e/mac_set.3 +++ b/lib/libc/posix1e/mac_set.3 @@ -87,10 +87,14 @@ or has appropriate privileges. .It Bq Er EACCES MAC write access to the file is denied. .It Bq Er EBADF +The .Fa fd +argument is not a valid file descriptor. .It Bq Er EINVAL +The .Fa label +argument is not a valid MAC label. .It Bq Er EOPNOTSUPP Setting MAC labels is not supported diff --git a/lib/libc/regex/regex.3 b/lib/libc/regex/regex.3 index 22e844785193..af7f57509cfc 100644 --- a/lib/libc/regex/regex.3 +++ b/lib/libc/regex/regex.3 @@ -110,7 +110,9 @@ and places the results in the .Ft regex_t structure pointed to by .Fa preg . -.Fa Cflags +The +.Fa cflags +argument is the bitwise OR of zero or more of the following flags: .Bl -tag -width REG_EXTENDED .It Dv REG_EXTENDED @@ -669,7 +671,9 @@ The function performance is poor. This will improve with later releases. -.Fa Nmatch +The +.Fa nmatch +argument exceeding 0 is expensive; .Fa nmatch exceeding 1 is worse. diff --git a/lib/libc/rpc/des_crypt.3 b/lib/libc/rpc/des_crypt.3 index 39b927b31ce3..b40a62c4ae29 100644 --- a/lib/libc/rpc/des_crypt.3 +++ b/lib/libc/rpc/des_crypt.3 @@ -54,23 +54,23 @@ Also, regularities in the clear text will not appear in the cipher text. .Pp Here is how to use these routines. -The first parameter, +The first argument, .Fa key , is the 8-byte encryption key with parity. To set the key's parity, which for .Tn DES is in the low bit of each byte, use .Fn des_setparity . -The second parameter, +The second argument, .Fa data , contains the data to be encrypted or decrypted. The -third parameter, +third argument, .Fa datalen , is the length in bytes of .Fa data , which must be a multiple of 8. -The fourth parameter, +The fourth argument, .Fa mode , is formed by .Em OR Ns 'ing @@ -95,8 +95,9 @@ in software and the routine returns .Er DESERR_NOHWDEVICE . For .Fn cbc_crypt , -the parameter +the .Fa ivec +argument is the 8-byte initialization vector for the chaining. It is updated to the next initialization @@ -110,7 +111,7 @@ Encryption succeeded, but done in software instead of the requested hardware. .It Bq Er DESERR_HWERR An error occurred in the hardware or driver. .It Bq Er DESERR_BADPARAM -Bad parameter to routine. +Bad argument to routine. .El .Pp Given a result status diff --git a/lib/libc/rpc/getnetconfig.3 b/lib/libc/rpc/getnetconfig.3 index 241b946611f5..e67b9bbb75c9 100644 --- a/lib/libc/rpc/getnetconfig.3 +++ b/lib/libc/rpc/getnetconfig.3 @@ -58,7 +58,9 @@ function returns .Dv NULL at the end of the file. +The .Fa handlep +argument is the handle obtained through .Fn setnetconfig . .Pp @@ -90,7 +92,9 @@ The .Fn endnetconfig function should be called when processing is complete to release resources for reuse. +The .Fa handlep +argument is the handle obtained through .Fn setnetconfig . Programmers should be aware, however, that the last call to diff --git a/lib/libc/rpc/rpc.3 b/lib/libc/rpc/rpc.3 index 835ae2df60e7..b8688ad0d307 100644 --- a/lib/libc/rpc/rpc.3 +++ b/lib/libc/rpc/rpc.3 @@ -33,7 +33,7 @@ be included. Some of the high-level RPC interface routines take a .Fa nettype -string as one of the parameters +string as one of the arguments (for example, .Fn clnt_create , .Fn svc_create , @@ -42,7 +42,9 @@ string as one of the parameters This string defines a class of transports which can be used for a particular application. .Pp +The .Fa nettype +argument can be one of the following: .Bl -tag -width datagram_v .It netpath diff --git a/lib/libc/rpc/rpc_clnt_auth.3 b/lib/libc/rpc/rpc_clnt_auth.3 index 3a5b5b37e75b..1412c61e481b 100644 --- a/lib/libc/rpc/rpc_clnt_auth.3 +++ b/lib/libc/rpc/rpc_clnt_auth.3 @@ -72,8 +72,9 @@ This is the default authentication used by RPC. Create and return an RPC authentication handle that contains .Dv AUTH_SYS authentication information. -The parameter +The .Fa host +argument is the name of the machine on which the information was created; .Fa uid @@ -87,7 +88,7 @@ refer to a counted array of groups to which the user belongs. .It Fn authsys_create_default Call .Fn authsys_create -with the appropriate parameters. +with the appropriate arguments. .El .Sh SEE ALSO .Xr rpc 3 , diff --git a/lib/libc/rpc/rpc_clnt_calls.3 b/lib/libc/rpc/rpc_clnt_calls.3 index 08435b8837a5..0626d90869a5 100644 --- a/lib/libc/rpc/rpc_clnt_calls.3 +++ b/lib/libc/rpc/rpc_clnt_calls.3 @@ -77,7 +77,7 @@ The remaining routines deal with error handling in the case of errors. .Pp Some of the routines take a .Vt CLIENT -handle as one of the parameters. +handle as one of the arguments. A .Vt CLIENT handle can be created by an RPC creation routine such as @@ -107,16 +107,19 @@ client creation routine such as .Fn clnt_create (see .Xr rpc_clnt_create 3 ) . -The parameter +The .Fa inproc -is the XDR function used to encode the procedure's parameters, and +argument +is the XDR function used to encode the procedure's arguments, and .Fa outproc is the XDR function used to decode the procedure's results; .Fa in is the address of the procedure's argument(s), and .Fa out is the address of where to place the result(s). +The .Fa tout +argument is the time allowed for results to be returned, which is overridden by a time-out set explicitly through .Fn clnt_control , @@ -128,8 +131,9 @@ otherwise an appropriate status is returned. .It Fn clnt_freeres A function macro that frees any data allocated by the RPC/XDR system when it decoded the results of an RPC call. -The parameter +The .Fa out +argument is the address of the results, and .Fa outproc is the XDR routine describing the results. @@ -257,7 +261,9 @@ except that the initial timeout, and the maximum timeout, .Fa waittime are specified in milliseconds. +The .Fa inittime +argument is the initial time that .Fn rpc_broadcast_exp waits before resending the request. @@ -272,16 +278,19 @@ and .Fa procnum on the machine, .Fa host . -The parameter +The .Fa inproc -is used to encode the procedure's parameters, and +argument +is used to encode the procedure's arguments, and .Fa outproc is used to decode the procedure's results; .Fa in is the address of the procedure's argument(s), and .Fa out is the address of where to place the result(s). +The .Fa nettype +argument can be any of the values listed on .Xr rpc 3 . This routine returns diff --git a/lib/libc/rpc/rpc_clnt_create.3 b/lib/libc/rpc/rpc_clnt_create.3 index ca6f92edcdbc..c083c6fbf8bb 100644 --- a/lib/libc/rpc/rpc_clnt_create.3 +++ b/lib/libc/rpc/rpc_clnt_create.3 @@ -73,7 +73,9 @@ to perform the requested service, and then sends a reply. .It Fn clnt_control A function macro to change or retrieve various information about a client object. +The .Fa req +argument indicates the type of operation, and .Fa info is a pointer to the information. @@ -98,7 +100,7 @@ If you set the timeout value to 0, .Fn clnt_control immediately returns an error .Pq Dv RPC_TIMEDOUT . -Set the timeout parameter to 0 for batching calls. +Set the timeout argument to 0 for batching calls. .Bl -column CLSET_FD_NCLOSE "struct timeval *" "do not close fd on destroy" .It Dv CLGET_SVC_ADDR Ta "struct netbuf *" Ta "get servers address" .It Dv CLGET_FD Ta "int *" Ta "get fd from handle" @@ -132,10 +134,14 @@ Generic client creation routine for program .Fa prognum and version .Fa versnum . +The .Fa host +argument identifies the name of the remote host where the server is located. +The .Fa nettype +argument indicates the class of transport protocol to use. The transports are tried in left to right order in .Ev NETPATH @@ -174,7 +180,7 @@ later (see .It Fn clnt_create_timed Generic client creation routine which is similar to .Fn clnt_create -but which also has the additional parameter +but which also has the additional argument .Fa timeout that specifies the maximum amount of time allowed for each transport class tried. @@ -188,10 +194,14 @@ Generic client creation routine which is similar to .Fn clnt_create but which also checks for the version availability. +The .Fa host +argument identifies the name of the remote host where the server is located. +The .Fa nettype +argument indicates the class transport protocols to be used. If the routine is successful it returns a client handle created for the highest version between @@ -199,7 +209,9 @@ the highest version between and .Fa vers_high that is supported by the server. +The .Fa vers_outp +argument is set to this value. That is, after a successful return .Fa vers_low @@ -241,7 +253,7 @@ the range supplied is supported by the server. .It Fn clnt_create_vers_timed Generic client creation routine which is similar to .Fn clnt_create_vers -but which also has the additional parameter +but which also has the additional argument .Fa timeout that specifies the maximum amount of time allowed for each transport class tried. @@ -281,8 +293,9 @@ and version the client uses a connectionless transport. The remote program is located at address .Fa svcaddr . -The parameter +The .Fa fildes +argument is an open and bound file descriptor. This routine will resend the call message in intervals of 15 seconds until a response is received or until the @@ -297,10 +310,11 @@ The retry time out and the total time out periods can be changed using .Fn clnt_control . The user may set the size of the send and receive -buffers with the parameters +buffers with the .Fa sendsz and -.Fa recvsz ; +.Fa recvsz +arguments; values of 0 choose suitable defaults. This routine returns .Dv NULL @@ -365,7 +379,9 @@ is .Dv NULL , .Dv RPC_UNKNOWNADDR error is set. +The .Fa fildes +argument is a file descriptor which may be open, bound and connected. If it is .Dv RPC_ANYFD , @@ -385,10 +401,11 @@ error is set. If .Fa fildes is unbound, then it will attempt to bind the descriptor. -The user may specify the size of the buffers with the parameters +The user may specify the size of the buffers with the .Fa sendsz and -.Fa recvsz ; +.Fa recvsz +arguments; values of 0 choose suitable defaults. Depending upon the type of the transport (connection-oriented or connectionless), @@ -439,7 +456,7 @@ Like .Fn clnt_tp_create except .Fn clnt_tp_create_timed -has the extra parameter +has the extra argument .Fa timeout which specifies the maximum time allowed for for the creation attempt to succeed. @@ -457,14 +474,16 @@ and version the client uses a connection-oriented transport. The remote program is located at address .Fa svcaddr . -The parameter +The .Fa fildes +argument is an open and bound file descriptor. The user may specify the size of the send and receive buffers -with the parameters +with the .Fa sendsz and -.Fa recvsz ; +.Fa recvsz +arguments; values of 0 choose suitable defaults. This routine returns .Dv NULL diff --git a/lib/libc/rpc/rpc_secure.3 b/lib/libc/rpc/rpc_secure.3 index 27b9870f1419..559cb6bd136e 100644 --- a/lib/libc/rpc/rpc_secure.3 +++ b/lib/libc/rpc/rpc_secure.3 @@ -68,7 +68,7 @@ The function, used on the client side, returns an authentication handle that will enable the use of the secure authentication system. -The first parameter +The first argument .Fa name is the network name, or .Fa netname , @@ -86,7 +86,7 @@ window is more secure than a large one, but choosing too small of a window will increase the frequency of resynchronizations because of clock drift. The third -parameter +argument .Fa addr is optional. If it is .Dv NULL , @@ -98,11 +98,11 @@ is supplied, however, then the system will use the address for consulting the remote time service whenever resynchronization is required. -This parameter is usually the +This argument is usually the address of the .Tn RPC server itself. -The final parameter +The final argument .Fa ckey is also optional. If it is .Dv NULL , diff --git a/lib/libc/rpc/rpc_soc.3 b/lib/libc/rpc/rpc_soc.3 index 5bf40990b910..453c45d2da9d 100644 --- a/lib/libc/rpc/rpc_soc.3 +++ b/lib/libc/rpc/rpc_soc.3 @@ -156,8 +156,9 @@ Create and return an authentication handle that contains .Ux authentication information. -The parameter +The .Fa host +argument is the name of the machine on which the information was created; .Fa uid @@ -179,7 +180,7 @@ It is easy to impersonate a user. .Pp Calls .Fn authunix_create -with the appropriate parameters. +with the appropriate arguments. .Pp .It Xo .Ft int @@ -202,13 +203,14 @@ and .Fa procnum on the machine .Fa host . -The parameter +The .Fa in +argument is the address of the procedure's argument(s), and .Fa out is the address of where to place the result(s); .Fa inproc -is used to encode the procedure's parameters, and +is used to encode the procedure's arguments, and .Fa outproc is used to decode the procedure's results. This routine returns zero if it succeeds, or the value of @@ -300,13 +302,14 @@ which is obtained with an .Tn RPC client creation routine such as .Fn clnt_create . -The parameter +The .Fa in +argument is the address of the procedure's argument(s), and .Fa out is the address of where to place the result(s); .Fa inproc -is used to encode the procedure's parameters, and +is used to encode the procedure's arguments, and .Fa outproc is used to decode the procedure's results; .Fa tout @@ -341,10 +344,14 @@ Otherwise, the socket remains open. .Xc .Pp Generic client creation routine. +The .Fa host +argument identifies the name of the remote host where the server is located. +The .Fa proto +argument indicates which kind of transport protocol to use. The currently supported values for this field are @@ -373,7 +380,9 @@ large arguments or return huge results. .Pp A macro used to change or retrieve various information about a client object. +The .Fa req +argument indicates the type of operation, and .Fa info is a pointer to the information. @@ -395,7 +404,7 @@ and their argument types and what they do are: .Pp Note: if you set the timeout using .Fn clnt_control , -the timeout parameter passed to +the timeout argument passed to .Fn clnt_call will be ignored in all future calls. .Bl -column "CLSET_RETRY_TIMEOUT" "struct sockaddr_in" @@ -431,8 +440,9 @@ A macro that frees any data allocated by the system when it decoded the results of an .Tn RPC call. -The parameter +The .Fa out +argument is the address of the results, and .Fa outproc is the @@ -637,8 +647,9 @@ is zero, then it is set to the actual port that the remote program is listening on (the remote .Xr rpcbind 8 service is consulted for this information). -The parameter +The .Fa sockp +argument is a socket; if it is .Dv RPC_ANYSOCK , then this routine opens a new one and sets @@ -649,10 +660,11 @@ Since uses buffered .Tn I/O , the user may specify the size of the send and receive buffers -with the parameters +with the .Fa sendsz and -.Fa recvsz ; +.Fa recvsz +arguments; values of zero choose suitable defaults. This routine returns .Dv NULL @@ -689,8 +701,9 @@ is zero, then it is set to actual port that the remote program is listening on (the remote .Xr rpcbind 8 service is consulted for this information). -The parameter +The .Fa sockp +argument is a socket; if it is .Dv RPC_ANYSOCK , then this routine opens a new one and sets @@ -744,8 +757,9 @@ is zero, then it is set to actual port that the remote program is listening on (the remote .Xr rpcbind 8 service is consulted for this information). -The parameter +The .Fa sockp +argument is a socket; if it is .Dv RPC_ANYSOCK , then this routine opens a new one and sets @@ -791,8 +805,9 @@ the client uses sockets as a transport. The local program is located at the .Fa *raddr . -The parameter +The .Fa sockp +argument is a socket; if it is .Dv RPC_ANYSOCK , then this routine opens a new one and sets @@ -803,10 +818,11 @@ Since uses buffered .Tn I/O , the user may specify the size of the send and receive buffers -with the parameters +with the .Fa sendsz and -.Fa recvsz ; +.Fa recvsz +arguments; values of zero choose suitable defaults. This routine returns .Dv NULL @@ -920,12 +936,13 @@ address to make an .Tn RPC call on your behalf to a procedure on that host. -The parameter +The .Fa portp +argument will be modified to the program's port number if the procedure succeeds. -The definitions of other parameters are discussed +The definitions of other arguments are discussed in .Fn callrpc and @@ -1002,11 +1019,11 @@ version and procedure .Fa procnum , .Fa procname -is called with a pointer to its parameter(s); +is called with a pointer to its argument(s); .Fa progname should return a pointer to its static result(s); .Fa inproc -is used to decode the parameters while +is used to decode the arguments while .Fa outproc is used to encode the results. This routine returns zero if the registration succeeded, \-1 @@ -1055,7 +1072,7 @@ is undefined after calling this routine. A global variable reflecting the .Tn RPC service side's -read file descriptor bit mask; it is suitable as a template parameter +read file descriptor bit mask; it is suitable as a template argument to the .Xr select 2 system call. @@ -1112,8 +1129,9 @@ associated with the .Tn RPC service transport handle, .Fa xprt . -The parameter +The .Fa in +argument is the address where the arguments will be placed; .Fa inproc is the @@ -1241,8 +1259,9 @@ Called by an .Tn RPC service's dispatch routine to send the results of a remote procedure call. -The parameter +The .Fa xprt +argument is the request's associated transport handle; .Fa outproc is the @@ -1283,7 +1302,7 @@ a remote procedure call due to an authentication error. .Xc .Pp Called by a service dispatch routine that cannot successfully -decode its parameters. +decode its arguments. See also .Fn svc_getargs . .Pp @@ -1344,7 +1363,7 @@ it may call this routine. .Pp Called by a service dispatch routine that refuses to perform a remote procedure call due to insufficient -authentication parameters. +authentication arguments. The routine calls .Fn svcerr_auth xprt AUTH_TOOWEAK . .Pp @@ -1427,7 +1446,9 @@ The transport is associated with the socket which may be .Dv RPC_ANYSOCK , in which case a new socket is created. +The .Fa *path +argument is a variable-length file system pathname of at most 104 characters. This file is @@ -1457,9 +1478,11 @@ choose suitable defaults. .Xc .Pp Create a service on top of any open descriptor. +The .Fa sendsize and .Fa recvsize +arguments indicate sizes for the send and receive buffers. If they are zero, a reasonable default is chosen. @@ -1477,9 +1500,11 @@ this descriptor is a connected socket for a stream protocol such as .Tn TCP . +The .Fa sendsize and .Fa recvsize +arguments indicate sizes for the send and receive buffers. If they are zero, a reasonable default is chosen. @@ -1600,11 +1625,11 @@ package. .Fn xdr_pmap "XDR *xdrs" "struct pmap *regs" .Xc .Pp -Used for describing parameters to various +Used for describing arguments to various .Xr rpcbind 8 procedures, externally. This routine is useful for users who wish to generate -these parameters without using the +these arguments without using the .Fn pmap_* interface. .Pp @@ -1615,7 +1640,7 @@ interface. .Pp Used for describing a list of port mappings, externally. This routine is useful for users who wish to generate -these parameters without using the +these arguments without using the .Fn pmap_* interface. .Pp diff --git a/lib/libc/rpc/rpc_svc_calls.3 b/lib/libc/rpc/rpc_svc_calls.3 index 82b82aa450d4..1569d7688ca3 100644 --- a/lib/libc/rpc/rpc_svc_calls.3 +++ b/lib/libc/rpc/rpc_svc_calls.3 @@ -111,7 +111,7 @@ has global scope and ends all RPC server activity. .Vt fd_set Va svc_fdset .Xc A global variable reflecting the -RPC server's read file descriptor bit mask; it is suitable as a parameter +RPC server's read file descriptor bit mask; it is suitable as a argument to the .Xr select 2 system call. @@ -140,8 +140,9 @@ A function macro that decodes the arguments of an RPC request associated with the RPC service transport handle .Fa xprt . -The parameter +The .Fa in +argument is the address where the arguments will be placed; .Fa inproc is the XDR @@ -217,7 +218,7 @@ is an array of .Vt pollfd structures derived from .Va svc_fdset[] . -It is suitable as a parameter to the +It is suitable as an argument to the .Xr poll 2 system call. The derivation of @@ -242,8 +243,9 @@ system call to return. .It Fn svc_sendreply Called by an RPC service's dispatch routine to send the results of a remote procedure call. -The parameter +The .Fa xprt +argument is the request's associated transport handle; .Fa outproc is the XDR diff --git a/lib/libc/rpc/rpc_svc_create.3 b/lib/libc/rpc/rpc_svc_create.3 index 23c00535f1b6..b1efa3ad94ba 100644 --- a/lib/libc/rpc/rpc_svc_create.3 +++ b/lib/libc/rpc/rpc_svc_create.3 @@ -57,7 +57,9 @@ data structure. .It Fn svc_control A function to change or retrieve various information about a service object. +The .Fa req +argument indicates the type of operation and .Fa info is a pointer to the information. @@ -73,7 +75,9 @@ an .Dv RPC_PROGVERSMISMATCH error will normally be returned. +The .Fa info +argument should be a pointer to an integer. Upon successful completion of the @@ -98,7 +102,9 @@ error will normally be returned. It is sometimes desirable to change this behavior. +The .Fa info +argument should be a pointer to an integer which is either 0 (indicating normal server behavior - an @@ -114,7 +120,9 @@ function creates server handles for all the transports belonging to the class .Fa nettype . +The .Fa nettype +argument defines a class of transports which can be used for a particular application. The transports are tried in left to right order in @@ -133,7 +141,9 @@ function registers itself with the rpcbind service (see .Xr rpcbind 8 ) . +The .Fa dispatch +function is called when there is a remote procedure call for the given .Fa prognum and @@ -167,10 +177,12 @@ service handle, and returns a pointer to it. This routine returns .Dv NULL if it fails, and an error message is logged. +The .Fa sendsz and .Fa recvsz -are parameters used to specify the size of the buffers. +arguments +are arguments used to specify the size of the buffers. If they are 0, suitable defaults are chosen. The file descriptor .Fa fildes @@ -188,9 +200,11 @@ This routine creates a service on top of an open and bound file descriptor, and returns the handle to it. Typically, this descriptor is a connected file descriptor for a connection-oriented transport. +The .Fa sendsz and .Fa recvsz +arguments indicate sizes for the send and receive buffers. If they are 0, reasonable defaults are chosen. This routine returns @@ -219,7 +233,9 @@ should not be called when the raw interface is being used. .It Fn svc_tli_create This routine creates an RPC server handle, and returns a pointer to it. +The .Fa fildes +argument is the file descriptor on which the service is listening. If .Fa fildes @@ -257,7 +273,7 @@ In the case where the default address is chosen, the number of outstanding connect requests is set to 8 for connection-oriented transports. The user may specify the size of the send and receive buffers -with the parameters +with the arguments .Fa sendsz and .Fa recvsz ; @@ -277,7 +293,9 @@ creates a server handle for the network specified by .Fa netconf , and registers itself with the rpcbind service. +The .Fa dispatch +function is called when there is a remote procedure call for the given .Fa prognum @@ -299,7 +317,7 @@ This routine returns .Dv NULL if it fails, and an error message is logged. The users may specify the size of the send and receive buffers -with the parameters +with the arguments .Fa sendsz and .Fa recvsz ; diff --git a/lib/libc/rpc/rpc_svc_err.3 b/lib/libc/rpc/rpc_svc_err.3 index 039501f34d25..6e26b1ab4bbd 100644 --- a/lib/libc/rpc/rpc_svc_err.3 +++ b/lib/libc/rpc/rpc_svc_err.3 @@ -55,7 +55,7 @@ Called by a service dispatch routine that refuses to perform a remote procedure call due to an authentication error. .It Fn svcerr_decode Called by a service dispatch routine that cannot successfully -decode the remote parameters +decode the remote arguments (see .Fn svc_getargs in @@ -70,7 +70,9 @@ Service implementors usually do not need this routine. .It Fn svcerr_progvers Called when the desired version of a program is not registered with the RPC package. +The .Fa low_vers +argument is the lowest version number, and .Fa high_vers @@ -84,7 +86,7 @@ it may call this routine. .It Fn svcerr_weakauth Called by a service dispatch routine that refuses to perform a remote procedure call due to insufficient (but correct) -authentication parameters. +authentication arguments. The routine calls .Fn svcerr_auth "xprt" "AUTH_TOOWEAK" . .El diff --git a/lib/libc/rpc/rpc_svc_reg.3 b/lib/libc/rpc/rpc_svc_reg.3 index 2804bf07c25b..95756db178c0 100644 --- a/lib/libc/rpc/rpc_svc_reg.3 +++ b/lib/libc/rpc/rpc_svc_reg.3 @@ -65,11 +65,11 @@ version and procedure .Fa procnum , .Fa procname -is called with a pointer to its parameter(s); +is called with a pointer to its argument(s); .Fa procname should return a pointer to its static result(s); .Fa inproc -is the XDR function used to decode the parameters while +is the XDR function used to decode the arguments while .Fa outproc is the XDR function used to encode the results. Procedures are registered on all available transports of the class @@ -135,7 +135,7 @@ When needed to process an RPC credential of type .Fa cred_flavor , the .Fa handler -procedure will be called with two parameters, +procedure will be called with two arguments, .Fa "struct svc_req *rqst" and .Fa "struct rpc_msg *msg" , diff --git a/lib/libc/rpc/rpcbind.3 b/lib/libc/rpc/rpcbind.3 index d9ccaaf5b5cc..b90d461f72a7 100644 --- a/lib/libc/rpc/rpcbind.3 +++ b/lib/libc/rpc/rpcbind.3 @@ -64,7 +64,9 @@ and speaks the transport protocol associated with .Fa netconf . The address found is returned in .Fa svcaddr . +The .Fa svcaddr +argument should be preallocated. This routine returns .Dv TRUE @@ -111,8 +113,9 @@ call on your behalf to a procedure on that host. The .Fn netconfig structure should correspond to a connectionless transport. -The parameter +The .Fa svcaddr +argument will be modified to the server's address if the procedure succeeds (see .Fn rpc_call @@ -120,7 +123,7 @@ and .Fn clnt_call in .Xr rpc_clnt_calls 3 -for the definitions of other parameters). +for the definitions of other arguments). .Pp This procedure should normally be used for a .Dq ping diff --git a/lib/libc/rpc/rtime.3 b/lib/libc/rpc/rtime.3 index 5e85e9c432ee..028d2beade14 100644 --- a/lib/libc/rpc/rtime.3 +++ b/lib/libc/rpc/rtime.3 @@ -34,7 +34,7 @@ Normally, the protocol is used when consulting the Time Server. The .Fa timeout -parameter specifies how long the +argument specifies how long the routine should wait before giving up when waiting for a reply. If diff --git a/lib/libc/stdio/fflush.3 b/lib/libc/stdio/fflush.3 index 35ccd452fea6..e57fc37983e0 100644 --- a/lib/libc/stdio/fflush.3 +++ b/lib/libc/stdio/fflush.3 @@ -88,7 +88,9 @@ is set to indicate the error. .Sh ERRORS .Bl -tag -width Er .It Bq Er EBADF -.Fa Stream +The +.Fa stream +argument is not an open stream, or, in the case of .Fn fflush , not a stream open for writing. diff --git a/lib/libc/stdio/fopen.3 b/lib/libc/stdio/fopen.3 index 502a04955a76..eb393763281b 100644 --- a/lib/libc/stdio/fopen.3 +++ b/lib/libc/stdio/fopen.3 @@ -137,8 +137,7 @@ The .Fn fdopen function associates a stream with the existing file descriptor, .Fa fildes . -The -.Fa mode +The mode of the stream must be compatible with the mode of the file descriptor. When the stream is closed via .Xr fclose 3 , @@ -186,7 +185,8 @@ is set to indicate the error. .It Bq Er EINVAL The .Fa mode -provided to +argument +to .Fn fopen , .Fn fdopen , or diff --git a/lib/libc/stdio/fputs.3 b/lib/libc/stdio/fputs.3 index c51213d73cbc..3ce20b25b58a 100644 --- a/lib/libc/stdio/fputs.3 +++ b/lib/libc/stdio/fputs.3 @@ -85,7 +85,7 @@ on error. .It Bq Er EBADF The .Fa stream -supplied +argument is not a writable stream. .El .Pp diff --git a/lib/libc/stdio/fseek.3 b/lib/libc/stdio/fseek.3 index 6481fe6e578f..41493beb7b40 100644 --- a/lib/libc/stdio/fseek.3 +++ b/lib/libc/stdio/fseek.3 @@ -193,7 +193,7 @@ is set to indicate the error. .It Bq Er EBADF The .Fa stream -specified +argument is not a seekable stream. .It Bq Er EINVAL The diff --git a/lib/libc/stdio/setbuf.3 b/lib/libc/stdio/setbuf.3 index d10b5bc27691..0342149d2d16 100644 --- a/lib/libc/stdio/setbuf.3 +++ b/lib/libc/stdio/setbuf.3 @@ -94,7 +94,7 @@ function may be used to alter the buffering behavior of a stream. The .Fa mode -parameter must be one of the following three macros: +argument must be one of the following three macros: .Bl -tag -width _IOFBF -offset indent .It Dv _IONBF unbuffered @@ -106,7 +106,7 @@ fully buffered .Pp The .Fa size -parameter may be given as zero +argument may be given as zero to obtain deferred optimal-size buffer allocation as usual. If it is not zero, then except for unbuffered files, the diff --git a/lib/libc/stdlib/lsearch.3 b/lib/libc/stdlib/lsearch.3 index 4eecb1e87577..e3a324cd52f8 100644 --- a/lib/libc/stdlib/lsearch.3 +++ b/lib/libc/stdlib/lsearch.3 @@ -37,7 +37,9 @@ and functions walk linearly through an array and compare each element with the one to be sought using a supplied comparison function. .Pp +The .Fa key +argument points to an element that matches the one that is searched. The array's address in memory is denoted by the .Fa base diff --git a/lib/libc/stdlib/tsearch.3 b/lib/libc/stdlib/tsearch.3 index ac6d841cfa80..0c7f1bdba063 100644 --- a/lib/libc/stdlib/tsearch.3 +++ b/lib/libc/stdlib/tsearch.3 @@ -97,7 +97,9 @@ walks the binary search tree rooted in and calls the function .Fa action on each node. -.Fa Action +The +.Fa action +function is called with three arguments: a pointer to the current node, a value from the enum .Sy "typedef enum { preorder, postorder, endorder, leaf } VISIT;" diff --git a/lib/libc/string/strcpy.3 b/lib/libc/string/strcpy.3 index 1ee2bebeef2e..f40e79205894 100644 --- a/lib/libc/string/strcpy.3 +++ b/lib/libc/string/strcpy.3 @@ -130,7 +130,7 @@ Note that it does terminate .Va chararray because the length of the source string is greater than or equal -to the length parameter. +to the length argument. .Pp The following copies as many characters from .Va input diff --git a/lib/libc/sys/accept.2 b/lib/libc/sys/accept.2 index b0adcbd3ce9d..2f86735cd3e9 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 0d3611a742c0..94e78317252e 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 7db84c829eb6..2786fe49f867 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 7f2399b719cf..c9c5b04ddd61 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 444e2817b2b7..0d1e1defebc3 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 8090963e5f6e..c52629e85066 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 b12b7878864c..07bc0ae75399 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 7c88bf849ab3..d8e74a95e14b 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 9858ea963cb0..7148c7fd0303 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 33e228cc8419..9cad89740b91 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 373892bd4340..8e8214e447f5 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 70e3d89340c1..f80e67130595 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 8c92be218147..e703df122c62 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 d663776b86f7..555ee38441e1 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 78bdfb69a248..148bcd51a80a 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 0e41168d257d..f6ee311de6fe 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 16abee5e9d55..16b3ff90f10f 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 79ab4f9418ff..dc91aefbb892 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 10cbc79a4375..f4da9f598231 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 19b9f8d447c8..9b0f22c6fac5 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 5716cc2f0112..5c2f0584c098 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 5d5a25228f20..c9dc8e757d4b 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 a48f9d050ba4..2bbb42b6b6ed 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 40f071d2428b..3cfc7cc423c2 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 1c699bbf1178..a1adafddab82 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 883177e00277..644f33708607 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 70dfc0b92a02..d739549eb4ba 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 c61a8c572e74..44caa76733e0 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 c9bd8dccac3e..a42b31148899 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 bdff4fb5f054..54b6959f18ab 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 ef175d2dd4c1..38e384d72d70 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 7f7ba9b4173e..a3ce3599df7e 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 627770a3f011..97e6fddf482d 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 9466435eb30a..0b580dc014d0 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 3d556432a746..ce0fcd003ad4 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 2efa81954f31..6a529c1d043c 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 9f9005f0560e..408566eebcc3 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 a6ef175ac608..3889b2621cab 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 397388d35078..4aa62f091d92 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 9208ed728eeb..3278e4921502 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 2ca1c99b6ad2..1a24a273429a 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 7cbe63dca0b2..b0a4fde598c7 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 3a2f32d1eaa9..acd6fcd77b14 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 2d65591acbde..93d5c785c002 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 4222c05b9092..606501c5fb88 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 41761a021e96..b51558c6f5aa 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 dbf26827b7d1..9c064b4a9418 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 c7a9bdbb3aba..fb0dafc5f732 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 d394ef9cb310..30cf1e04d259 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 8ef3f18378b1..e91c9ba9ec3a 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 19461bebb6a2..329c26b29dcd 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 849e17a25cb5..1c9fca389f37 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 c4839c06450a..f44d4c3f93d1 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 05f5b4f5ae85..54079688e84d 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 96032d78f5b6..d22f68df0223 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 254ed127f721..bb55bbccb7b5 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 f6acf79186f8..d05b489e48e6 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 b628131bdc82..c0d5b5b66830 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 8775f0e8041b..f125877d433e 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 de521bb8e80e..873f9b7a70ed 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 10268118e041..dbbbcefe12ce 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 640cfda7ef9a..5dea7ab3786e 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 298de96fbf83..7ce40777eefb 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 527613393b82..6a4c09bccb47 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 fc7d002c0c5a..da93d6f764aa 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 57ed4e64f926..28ecc4b2c208 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 6ab7952b0ab3..619c2fd3bbe3 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 9d85d2b902ca..a2ea33a63bd5 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 56572cad0008..67866f6e15cc 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 f420db9a65c2..64de5569043b 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 d4d4e20d4ab9..4e60fb7e2c71 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 54b9b250b39f..c2014fc1a998 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 a9354049c4e9..ce519fc88fc6 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 e54228f985df..9f8104a07b61 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 7043649ac011..cd47aaa3147f 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 871d68d9c1bf..849d6aa36df5 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 b5a33bab920c..b69b8fb3caac 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 f45e92bb6a3d..f493281a5caa 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 ac64f3f24938..dfd110d21a0a 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 09e8dac70d64..a0d823964478 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 79f60ac61d5d..1570ac7e5d52 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 0ea6acf90d9f..fd27e71191e5 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 e4c9eee1f573..31e2a80d5091 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 bf54fb25c9ed..e27ad0d3ce92 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 a302cee5c19f..adf7beda0d98 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 c8866fc363c6..ca9be1542b6a 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 3aec154acc96..aed6a9126cbd 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 c3869a7e4482..c8d9368738be 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 fbdbb5b1c0bc..68ab743790a5 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 6cdc69239b5a..43af72aeecb7 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 1feb7c025491..6aaf4f29f94f 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 8d25e333fa4b..19fa7fa04712 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 2685a37c8a70..6e631bcb95a5 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 10109ce07cd8..df913251e048 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 32e487eff583..29892ac65593 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 fba16f8d787a..5faf50aec6de 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 61a2de158a75..6050b39fd00e 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 dd03e902bd47..79dd2d068731 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 6aa09a84f74e..5cb87ee192df 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 7f8925a599a0..a3ba36262874 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 0ea137acc2c7..5f8776f4d2b2 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 diff --git a/lib/libc/uuid/uuid.3 b/lib/libc/uuid/uuid.3 index 946888d98392..a8c407b8e984 100644 --- a/lib/libc/uuid/uuid.3 +++ b/lib/libc/uuid/uuid.3 @@ -77,7 +77,7 @@ A 16-bit hash value can be obtained by calling The successful or unsuccessful completion of the function is returned in the .Fa status -parameter. +argument. Possible values are: .Pp .Bl -tag -width ".Dv uuid_s_invalid_string_uuid" diff --git a/lib/libc/xdr/xdr.3 b/lib/libc/xdr/xdr.3 index fbaf61e60cc0..25944ccd279b 100644 --- a/lib/libc/xdr/xdr.3 +++ b/lib/libc/xdr/xdr.3 @@ -78,15 +78,16 @@ A filter primitive that translates between variable-length arrays and their corresponding external representations. The -parameter .Fa arrp +argument is the address of the pointer to the array, while .Fa sizep is the address of the element count of the array; this element count cannot exceed .Fa maxsize . -The parameter +The .Fa elsize +argument is the .Ic sizeof each of the array's elements, and @@ -121,8 +122,9 @@ This routine returns one if it succeeds, zero otherwise. .Pp A filter primitive that translates between counted byte strings and their external representations. -The parameter +The .Fa sp +argument is the address of the string pointer. The length of the string is located at address @@ -339,6 +341,7 @@ whose length is no more than bytes long. The .Fa op +argument determines the direction of the .Tn XDR stream @@ -358,8 +361,9 @@ or A filter primitive that translates between fixed size opaque data and its external representation. -The parameter +The .Fa cp +argument is the address of the opaque object, and .Fa cnt is its size in bytes. @@ -425,7 +429,7 @@ and .Xr write 2 , except that .Fa handle -is passed to the former routines as the first parameter. +is passed to the former routines as the first argument. Note: the .Tn XDR stream's @@ -494,8 +498,9 @@ This routine returns one if it succeeds, zero otherwise. .Xc .Pp A primitive that provides pointer chasing within structures. -The parameter +The .Fa pp +argument is the address of the pointer; .Fa size is the @@ -529,8 +534,9 @@ the .Tn XDR stream .Fa xdrs . -The parameter +The .Fa pos +argument is a position value obtained from .Fn xdr_getpos . This routine returns one if the @@ -575,8 +581,9 @@ stream data is written to, or read from, the Standard .Tn I/O stream .Fa file . -The parameter +The .Fa op +argument determines the direction of the .Tn XDR stream (either @@ -709,8 +716,9 @@ This discriminant is always an Next the union located at .Fa unp is translated. -The parameter +The .Fa choices +argument is a pointer to an array of .Vt xdr_discrim structures. @@ -750,13 +758,14 @@ A filter primitive that translates between fixed-length arrays and their corresponding external representations. The -parameter .Fa arrp +argument is the address of the pointer to the array, while .Fa size is the element count of the array. -The parameter +The .Fa elsize +argument is the .Ic sizeof each of the array's elements, and @@ -778,7 +787,7 @@ This routine returns one if it succeeds, zero otherwise. This routine always returns one. It may be passed to .Tn RPC -routines that require a function parameter, +routines that require a function argument, where nothing is to be done. .Pp .It Xo @@ -800,7 +809,7 @@ is handy because the .Tn RPC package passes a maximum of two .Tn XDR -routines as parameters, and +routines as arguments, and .Fn xdr_string , one of the most frequently used primitives, requires three. Returns one if it succeeds, zero otherwise. |