diff options
Diffstat (limited to 'lib/libc/gen')
-rw-r--r-- | lib/libc/gen/dllockinit.3 | 12 | ||||
-rw-r--r-- | lib/libc/gen/dlopen.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/exec.3 | 6 | ||||
-rw-r--r-- | lib/libc/gen/fmtcheck.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/fts.3 | 72 | ||||
-rw-r--r-- | lib/libc/gen/getcap.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/getdomainname.3 | 5 | ||||
-rw-r--r-- | lib/libc/gen/gethostname.3 | 5 | ||||
-rw-r--r-- | lib/libc/gen/getmntinfo.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/getttyent.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/getvfsbyname.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/getvfsent.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/glob.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/makecontext.3 | 6 | ||||
-rw-r--r-- | lib/libc/gen/msgctl.3 | 6 | ||||
-rw-r--r-- | lib/libc/gen/msgrcv.3 | 14 | ||||
-rw-r--r-- | lib/libc/gen/msgsnd.3 | 10 | ||||
-rw-r--r-- | lib/libc/gen/rand48.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/scandir.3 | 6 | ||||
-rw-r--r-- | lib/libc/gen/siginterrupt.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/signal.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/sysctl.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/syslog.3 | 5 | ||||
-rw-r--r-- | lib/libc/gen/tcsendbreak.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/tcsetattr.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/timezone.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/ulimit.3 | 2 | ||||
-rw-r--r-- | lib/libc/gen/vis.3 | 8 |
28 files changed, 127 insertions, 72 deletions
diff --git a/lib/libc/gen/dllockinit.3 b/lib/libc/gen/dllockinit.3 index f117728..6af2cf7 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 ba37c6f..d6bb9f9 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 a17a7de..4875575 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 507ef27..1cb4883 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 b50b316..541286d 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 9b4b4f8..a2c2e7d 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 7fd3d48..6e0ed6b 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 c8cd1cb..7822322 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 16f6fcc..7a3cc02 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 593bef1..4a8535f 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 067e87a..a7cfa2e 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 89d52e7..7c4a934 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 9aac9b0..93f0c8f 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 0419853..ad55e7a 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 45db2b9..b0264b5 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 2985761..d6401b6 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 70ed45a..f41c173 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 0fe766a..3a263c8 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 fd090cc..045e4ec 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 79aed04..9680a15 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 a311e86..c536cd7 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 6ea38c3..8bf54ab 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 96c0cfa..a82d36a 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 5c9c362..e85d104 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 24717a8..f52742b 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 e506d61..2a90c11 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 fc58dfe..c5030a5 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 67bbc1f..6f685a9 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 |