diff --git a/man2/alloc_hugepages.2 b/man2/alloc_hugepages.2 index 19cf234d0..4ece3a023 100644 --- a/man2/alloc_hugepages.2 +++ b/man2/alloc_hugepages.2 @@ -57,7 +57,7 @@ Huge pages are locked into memory, and are not swapped. .LP The .I key -parameter is an identifier. +argument is an identifier. When zero the pages are private, and not inherited by children. When positive the pages are shared with other applications using the same @@ -66,7 +66,7 @@ and inherited by child processes. .LP The .I addr -parameter of +argument of .BR free_hugepages () tells which page is being freed: it was the return value of a call to @@ -74,19 +74,19 @@ call to (The memory is first actually freed when all users have released it.) The .I addr -parameter of +argument of .BR alloc_hugepages () is a hint, that the kernel may or may not follow. Addresses must be properly aligned. .LP The .I len -parameter is the length of the required segment. +argument is the length of the required segment. It must be a multiple of the huge page size. .LP The .I prot -parameter specifies the memory protection of the segment. +argument specifies the memory protection of the segment. It is one of .BR PROT_READ , .BR PROT_WRITE , @@ -94,7 +94,7 @@ It is one of .LP The .I flag -parameter is ignored, unless +argument is ignored, unless .I key is positive. In that case, if diff --git a/man2/brk.2 b/man2/brk.2 index 66a29a795..f4edee2a6 100644 --- a/man2/brk.2 +++ b/man2/brk.2 @@ -115,7 +115,7 @@ the memory allocation package is the portable and comfortable way of allocating memory. -Various systems use various types for the parameter of +Various systems use various types for the argument of .BR sbrk (). Common are \fIint\fP, \fIssize_t\fP, \fIptrdiff_t\fP, \fIintptr_t\fP. .\" One sees diff --git a/man2/clone.2 b/man2/clone.2 index 8bfbda540..cb54973e7 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -514,7 +514,7 @@ which is initially empty. .BR CLONE_SETTLS " (since Linux 2.5.32)" The .I newtls -parameter is the new TLS (Thread Local Storage) descriptor. +argument is the new TLS (Thread Local Storage) descriptor. (See .BR set_thread_area (2).) .TP @@ -569,8 +569,8 @@ In this case, for correct operation, the .B CLONE_VM option should not be specified. -Since Linux 2.5.49 the system call has five parameters. -The two new parameters are +Since Linux 2.5.49 the system call has five arguments. +The two new arguments are .I parent_tidptr which points to the location (in parent and child memory) where the child thread ID will be written in case diff --git a/man2/epoll_ctl.2 b/man2/epoll_ctl.2 index f74a5e94a..515a94b36 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -127,7 +127,7 @@ interface supports all file descriptors that support .BR poll (2). Valid values for the .I op -parameter are : +argument are : .RS .TP .B EPOLL_CTL_ADD diff --git a/man2/epoll_wait.2 b/man2/epoll_wait.2 index b3f87ec77..9e37f9f0b 100644 --- a/man2/epoll_wait.2 +++ b/man2/epoll_wait.2 @@ -52,7 +52,7 @@ are returned by .BR epoll_wait (). The .I maxevents -parameter must be greater than zero. +argument must be greater than zero. Specifying a .I timeout of \-1 makes diff --git a/man2/flock.2 b/man2/flock.2 index 54c90a4a3..f059f67f8 100644 --- a/man2/flock.2 +++ b/man2/flock.2 @@ -39,7 +39,7 @@ flock \- apply or remove an advisory lock on an open file .SH DESCRIPTION Apply or remove an advisory lock on the open file specified by .IR fd . -The parameter +The argument .I operation is one of the following: .RS 4 diff --git a/man2/futex.2 b/man2/futex.2 index c21341971..2275174e9 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -65,7 +65,7 @@ The argument needs to point to an aligned integer which stores the counter. The operation to execute is passed via the .I op -parameter, along with a value +argument, along with a value .IR val . .PP Five operations are currently defined: @@ -238,11 +238,11 @@ Invalid operation specified in .PP Initial futex support was merged in Linux 2.5.7 but with different semantics from what was described above. -A 4-parameter system call with the semantics +A 4-argument system call with the semantics given here was introduced in Linux 2.5.40. -In Linux 2.5.70 one parameter +In Linux 2.5.70 one argument was added. -In Linux 2.6.7 a sixth parameter was added \(em messy, especially +In Linux 2.6.7 a sixth argument was added \(em messy, especially on the s390 architecture. .SH "CONFORMING TO" This system call is Linux-specific. diff --git a/man2/getdents.2 b/man2/getdents.2 index 8c79b1f69..bd9d261e3 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -54,7 +54,7 @@ referred to by the open file descriptor .I fd into the buffer pointed to by .IR dirp . -The parameter +The argument .I count is the size of the memory area. .PP diff --git a/man2/getpeername.2 b/man2/getpeername.2 index 1cbedd928..df4c11ad7 100644 --- a/man2/getpeername.2 +++ b/man2/getpeername.2 @@ -50,7 +50,7 @@ returns the name of the peer connected to socket .IR s . The .I namelen -parameter should be initialized to indicate the amount of space pointed to +argument should be initialized to indicate the amount of space pointed to by .IR name . On return it contains the actual size of the name returned (in bytes). @@ -70,7 +70,7 @@ is not a valid descriptor. .B EFAULT The .I 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. .TP .B EINVAL diff --git a/man2/getsockname.2 b/man2/getsockname.2 index 420b003cf..74f7aa771 100644 --- a/man2/getsockname.2 +++ b/man2/getsockname.2 @@ -51,7 +51,7 @@ returns the current for the specified socket. The .I namelen -parameter should be initialized to indicate +argument should be initialized to indicate the amount of space pointed to by .IR name . On return it contains the actual size of the name @@ -71,7 +71,7 @@ is not a valid descriptor. .B EFAULT The .I 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. .TP .B EINVAL diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index 39adf92ad..35ddbfb61 100644 --- a/man2/getsockopt.2 +++ b/man2/getsockopt.2 @@ -84,7 +84,7 @@ should be set to the protocol number of see .BR getprotoent (3). -The parameters +The arguments .I optval and .I optlen @@ -97,7 +97,7 @@ requested option(s) are to be returned. For .BR getsockopt (), .I optlen -is a value-result parameter, initially containing the +is a value-result argument, initially containing the size of the buffer pointed to by .IR optval , and modified on return to indicate the actual size of @@ -118,11 +118,11 @@ entries in section 4 of the manual. Most socket-level options utilize an .I int -parameter for +argument for .IR optval . For .BR setsockopt (), -the parameter should be non-zero to enable a boolean option, or zero if the +the argument should be non-zero to enable a boolean option, or zero if the option is to be disabled. .PP For a description of the available socket options see diff --git a/man2/ioctl_list.2 b/man2/ioctl_list.2 index 109745776..7c650cc83 100644 --- a/man2/ioctl_list.2 +++ b/man2/ioctl_list.2 @@ -91,7 +91,7 @@ and They use .I sizeof(size) so that size is a -misnomer here: this third parameter is a data type. +misnomer here: this third argument is a data type. .LP Note that the size bits are very unreliable: in lots of cases they are wrong, either because of buggy macros using diff --git a/man2/listen.2 b/man2/listen.2 index 81f3f0cde..5cf8e09a0 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -135,7 +135,7 @@ file, and portable applications are probably wise to include it. The behavior of the .I backlog -parameter on TCP sockets changed with Linux 2.2. +argument on TCP sockets changed with Linux 2.2. Now it specifies the queue length for .I completely established sockets waiting to be accepted, diff --git a/man2/madvise.2 b/man2/madvise.2 index 53cd93851..c0d01003b 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -62,7 +62,7 @@ The kernel is free to ignore the advice. .LP The advice is indicated in the .I advice -parameter which can be +argument which can be .TP .B MADV_NORMAL No special treatment. diff --git a/man2/mbind.2 b/man2/mbind.2 index 1e522c372..9ccda4e13 100644 --- a/man2/mbind.2 +++ b/man2/mbind.2 @@ -117,7 +117,7 @@ All policy modes except .B MPOL_DEFAULT require the caller to specify via the .I nodemask -parameter, +argument, the node or nodes to which the mode applies. .I nodemask diff --git a/man2/mkdir.2 b/man2/mkdir.2 index 10242e69d..e6cb28c52 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -22,7 +22,7 @@ mkdir \- create a directory attempts to create a directory named .IR pathname . -The parameter +The argument .I mode specifies the permissions to use. It is modified by the process's diff --git a/man2/open.2 b/man2/open.2 index df2af8307..0e3e7b82e 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -103,7 +103,7 @@ with any other process, but sharing may arise via .BR fork (2). .PP -The parameter +The argument .I flags must include one of the following .IR "access modes" : diff --git a/man2/posix_fadvise.2 b/man2/posix_fadvise.2 index 40aeebe8a..95e9cb93f 100644 --- a/man2/posix_fadvise.2 +++ b/man2/posix_fadvise.2 @@ -96,7 +96,7 @@ Glibc support has been provided since version 2.2. POSIX.1-2001. Note that the type of the .I len -parameter was changed from +argument was changed from .I size_t to .I off_t diff --git a/man2/prctl.2 b/man2/prctl.2 index a292a5955..e4deea803 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -53,7 +53,7 @@ prctl \- operations on a process .BR prctl () is called with a first argument describing what to do (with values defined in \fI\fP), and further -parameters with a significance depending on the first one. +arguments with a significance depending on the first one. The first argument can be: .TP .BR PR_SET_PDEATHSIG " (since Linux 2.1.57)" diff --git a/man2/readdir.2 b/man2/readdir.2 index 7212d505a..a757da1f8 100644 --- a/man2/readdir.2 +++ b/man2/readdir.2 @@ -53,7 +53,7 @@ referred to by the file descriptor .I fd into the buffer pointed to by .IR dirp . -The parameter +The argument .I count is ignored; at most one .I dirent diff --git a/man2/readv.2 b/man2/readv.2 index 1a24ce18d..8d5ab2338 100644 --- a/man2/readv.2 +++ b/man2/readv.2 @@ -153,7 +153,7 @@ permitted maximum. and .BR writev () functions first appeared in 4.2BSD), POSIX.1-2001. -Linux libc5 used \fIsize_t\fP as the type of the \fIiovcnt\fP parameter, +Linux libc5 used \fIsize_t\fP as the type of the \fIiovcnt\fP argument, and \fIint\fP as return type for these functions. .\" The readv/writev system calls were buggy before Linux 1.3.40. .\" (Says release.libc.) diff --git a/man2/recv.2 b/man2/recv.2 index 107d6b47f..4444a5516 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -76,7 +76,7 @@ this source address is filled in. .\" Kernel 2.4.18. (MTK, 22 Jul 02)] The argument .I fromlen -is a value-result parameter, initialized to the size of the buffer +is a value-result argument, initialized to the size of the buffer associated with .IR from , and modified on return to indicate the actual size of the address stored @@ -92,7 +92,7 @@ and is identical to .BR recvfrom () with a NULL .I from -parameter. +argument. .PP All three routines return the length of the message on successful completion. @@ -269,7 +269,7 @@ The .BR recvmsg () call uses a .I 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 .IR : .in +4n diff --git a/man2/sched_get_priority_max.2 b/man2/sched_get_priority_max.2 index 37320806c..d5bc3007e 100644 --- a/man2/sched_get_priority_max.2 +++ b/man2/sched_get_priority_max.2 @@ -97,7 +97,7 @@ is set appropriately. .SH ERRORS .TP .B EINVAL -The parameter \fIpolicy\fP does not identify a defined scheduling policy. +The argument \fIpolicy\fP does not identify a defined scheduling policy. .SH "CONFORMING TO" POSIX.1-2001. .SH "SEE ALSO" diff --git a/man2/sched_setparam.2 b/man2/sched_setparam.2 index 302ba7d14..54b95fd5a 100644 --- a/man2/sched_setparam.2 +++ b/man2/sched_setparam.2 @@ -52,7 +52,7 @@ for the process identified by \fIpid\fP. If \fIpid\fP is zero, then the parameters of the calling process are set. The interpretation of -the parameter \fIparam\fP depends on the scheduling +the argument \fIparam\fP depends on the scheduling policy of the process identified by .IR pid . See @@ -97,7 +97,7 @@ is set appropriately. .SH ERRORS .TP .B EINVAL -The parameter \fIparam\fP does not make sense for the current +The argument \fIparam\fP does not make sense for the current scheduling policy. .TP .B EPERM diff --git a/man2/semop.2 b/man2/semop.2 index c985dff54..f5f54a93c 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -289,7 +289,7 @@ time specified by the .I timespec structure whose address is passed in the .I timeout -parameter. +argument. If the specified time limit has been reached, .BR semtimedop () fails with @@ -301,7 +301,7 @@ set to is performed). If the .I timeout -parameter is NULL, +argument is NULL, then .BR semtimedop () behaves exactly like @@ -348,9 +348,9 @@ expired. .B EFAULT An address specified in either the .I sops -or +or the .I timeout -parameters isn't accessible. +argument isn't accessible. .TP .B EFBIG For some operation the value of diff --git a/man2/send.2 b/man2/send.2 index a646c1145..93ec7c3bd 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -74,7 +74,7 @@ is the presence of .IR flags . With zero .I flags -parameter, +argument, .BR send () is equivalent to .BR write (2). @@ -83,7 +83,7 @@ Also, is equivalent to .RI sendto( s , buf , len , flags ,NULL,0). .PP -The parameter +The argument .I s is the file descriptor of the sending socket. .PP @@ -92,7 +92,7 @@ If is used on a connection-mode .RB ( SOCK_STREAM , .BR SOCK_SEQPACKET ) -socket, the parameters +socket, the arguments .I to and .I tolen @@ -153,7 +153,7 @@ call may be used to determine when it is possible to send more data. .PP The .I flags -parameter is the bitwise OR +argument is the bitwise OR of zero or more of the following flags. .\" FIXME ? document MSG_PROXY (which went away in 2.3.15) .TP @@ -296,7 +296,7 @@ Connection reset by peer. The socket is not connection-mode, and no peer address is set. .TP .B EFAULT -An invalid user space address was specified for a parameter. +An invalid user space address was specified for an argument. .TP .B EINTR A signal occurred before any data was transmitted; see diff --git a/man2/set_mempolicy.2 b/man2/set_mempolicy.2 index 5ede98afe..1cc3737c9 100644 --- a/man2/set_mempolicy.2 +++ b/man2/set_mempolicy.2 @@ -83,8 +83,7 @@ All modes except .B MPOL_DEFAULT require the caller to specify via the .I nodemask -parameter -one or more nodes. +argument one or more nodes. .I nodemask points to a bit mask of node IDs that contains up to diff --git a/man2/set_tid_address.2 b/man2/set_tid_address.2 index e6e86ef7b..133502c0c 100644 --- a/man2/set_tid_address.2 +++ b/man2/set_tid_address.2 @@ -44,7 +44,7 @@ flag, .I set_child_tid is set to .IR child_tidptr , -the fifth parameter of that system call. +the fifth argument of that system call. .LP When .I set_child_tid @@ -59,7 +59,7 @@ flag, .I clear_child_tid is set to .IR child_tidptr , -the fifth parameter of that system call. +the fifth argument of that system call. .LP The system call .BR set_tid_address () diff --git a/man2/setresuid.2 b/man2/setresuid.2 index b89e3c303..3de02fdd2 100644 --- a/man2/setresuid.2 +++ b/man2/setresuid.2 @@ -49,7 +49,7 @@ Privileged processes (on Linux, those having the \fBCAP_SETUID\fP capability) may set the real UID, effective UID, and saved set-user-ID to arbitrary values. -If one of the parameters equals \-1, the corresponding value is not changed. +If one of the arguments equals \-1, the corresponding value is not changed. Regardless of what changes are made to the real UID, effective UID, and saved set-user-ID, the file system UID is always set to the same diff --git a/man2/setup.2 b/man2/setup.2 index 9e6a90107..aa6497237 100644 --- a/man2/setup.2 +++ b/man2/setup.2 @@ -61,7 +61,7 @@ Always, for a user process. This function is Linux-specific, and should not be used in programs intended to be portable, or indeed in any programs at all. Since Linux 2.1.121, no such function exists anymore. -The calling sequence varied: it has had a single parameter +The calling sequence varied: it has had a single argument .I "void *BIOS" -and at other times a single parameter +and at other times a single argument .IR "int magic" . diff --git a/man2/setxattr.2 b/man2/setxattr.2 index c5541de27..3c034183f 100644 --- a/man2/setxattr.2 +++ b/man2/setxattr.2 @@ -95,7 +95,7 @@ binary data of specified length. .PP The .I flags -parameter can be used to refine the semantics of the operation. +argument can be used to refine the semantics of the operation. .B XATTR_CREATE specifies a pure create, which fails if the named attribute exists already. diff --git a/man2/sigaction.2 b/man2/sigaction.2 index c56bae622..310cf5f6b 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -226,7 +226,7 @@ This flag is only meaningful when establishing a signal handler. .PP The .I siginfo_t -parameter to +argument to .I sa_sigaction is a struct with the following elements: .sp diff --git a/man2/socket.2 b/man2/socket.2 index 170873f31..9a17b2cfd 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -53,7 +53,7 @@ creates an endpoint for communication and returns a descriptor. .PP The .I domain -parameter specifies a communication domain; this selects the protocol +argument specifies a communication domain; this selects the protocol family which will be used for communication. These families are defined in .IR . diff --git a/man2/statfs.2 b/man2/statfs.2 index 628f0212c..5d99673a5 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -245,7 +245,7 @@ when NFS-exported, and giving it out is a security concern. .LP Under some OSes the .I fsid -can be used as second parameter to the +can be used as second argument to the .BR sysfs () system call. .SH "SEE ALSO" diff --git a/man2/syscalls.2 b/man2/syscalls.2 index 65a5f892f..49ff2c515 100644 --- a/man2/syscalls.2 +++ b/man2/syscalls.2 @@ -722,9 +722,9 @@ The .BR select (2) and .BR mmap (2) -system calls use five or more parameters, +system calls use five or more arguments, which caused problems the way -parameter passing on the i386 used to be set up. +argument passing on the i386 used to be set up. Thus, while other architectures have .IR sys_select () and @@ -738,8 +738,8 @@ on i386 one finds and .IR old_mmap () (routines that use a pointer to a -parameter block) instead. -These days passing five parameters +argument block) instead. +These days passing five arguments is not a problem any more, and there is a .I __NR__newselect .\" (used by libc 6) diff --git a/man2/syslog.2 b/man2/syslog.2 index b13e3cd60..8b8b96975 100644 --- a/man2/syslog.2 +++ b/man2/syslog.2 @@ -209,7 +209,7 @@ and \fIerrno\fP is set to indicate the error. .SH ERRORS .TP .B EINVAL -Bad parameters (e.g., +Bad arguments (e.g., bad .IR type ; or for diff --git a/man3/addseverity.3 b/man3/addseverity.3 index 29b602302..803eff432 100644 --- a/man3/addseverity.3 +++ b/man3/addseverity.3 @@ -25,7 +25,7 @@ _SVID_SOURCE This function allows the introduction of new severity classes which can be addressed by the .I severity -parameter of the +argument of the .BR fmtmsg (3) function. By default that latter function only knows how to diff --git a/man3/asprintf.3 b/man3/asprintf.3 index e61375975..0f3cb14b4 100644 --- a/man3/asprintf.3 +++ b/man3/asprintf.3 @@ -44,7 +44,7 @@ and .BR vsprintf (3), except that they allocate a string large enough to hold the output including the terminating null byte, -and return a pointer to it via the first parameter. +and return a pointer to it via the first argument. This pointer should be passed to .BR free (3) to release the allocated storage when it is no longer needed. diff --git a/man3/bcopy.3 b/man3/bcopy.3 index 616236aca..c80b5e717 100644 --- a/man3/bcopy.3 +++ b/man3/bcopy.3 @@ -56,7 +56,7 @@ This function is deprecated (marked as LEGACY in POSIX.1-2001): use or .BR memmove (3) in new programs. -Note that the first two parameters +Note that the first two arguments are interchanged for .BR memcpy (3) and diff --git a/man3/btree.3 b/man3/btree.3 index 01fe43bed..0b77e0d4e 100644 --- a/man3/btree.3 +++ b/man3/btree.3 @@ -200,7 +200,7 @@ is 0 (no order is specified) the current host order is used. If the file already exists (and the .B O_TRUNC flag is not specified), the -values specified for the parameters +values specified for the arguments .IR flags , .I lorder and diff --git a/man3/dbopen.3 b/man3/dbopen.3 index 00714324b..fa403ffb5 100644 --- a/man3/dbopen.3 +++ b/man3/dbopen.3 @@ -65,7 +65,9 @@ opens .I file for reading and/or writing. Files never intended to be preserved on disk may be created by setting -the file parameter to NULL. +the +.I file +argument to NULL. .PP The .I flags @@ -185,7 +187,7 @@ and 0 on success. .I del A pointer to a routine to remove key/data pairs from the database. .IP -The parameter +The argument .I flag may be set to the following value: .RS @@ -241,7 +243,7 @@ was not in the file. .I put A pointer to a routine to store key/data pairs in the database. .IP -The parameter +The argument .I flag may be set to one of the following values: .RS diff --git a/man3/des_crypt.3 b/man3/des_crypt.3 index 68c31bfe5..55f228da1 100644 --- a/man3/des_crypt.3 +++ b/man3/des_crypt.3 @@ -58,23 +58,23 @@ Also, regularities in the clear text will not appear in the cipher text. .LP Here is how to use these routines. -The first parameter, +The first argument, .IR key , is the 8-byte encryption key with parity. To set the key's parity, which for DES is in the low bit of each byte, use .BR des_setparity (). -The second parameter, +The second argument, .IR data , contains the data to be encrypted or decrypted. The -third parameter, +third argument, .IR datalen , is the length in bytes of .IR data , which must be a multiple of 8. -The fourth parameter, +The fourth argument, .IR mode , is formed by OR 'ing @@ -95,7 +95,7 @@ in software and the routine returns .BR DESERR_NOHWDEVICE . For .BR cbc_crypt (), -the parameter +the argument .I ivec is the 8-byte initialization vector for the chaining. @@ -114,7 +114,7 @@ Encryption succeeded, but done in software instead of the requested hardware. An error occurred in the hardware or driver. .TP .BR DESERR_BADPARAM -Bad parameter to routine. +Bad argument to routine. .PD .LP Given a result status diff --git a/man3/dprintf.3 b/man3/dprintf.3 index f2295fcd4..0fea773f7 100644 --- a/man3/dprintf.3 +++ b/man3/dprintf.3 @@ -62,7 +62,7 @@ next POSIX.1 revision. .\" .\" .BI "void dprintf(int level, const char *" format ", ...);" .\" -.\" where the first parameter is a debugging level (and output is to +.\" where the first argument is a debugging level (and output is to .\" .IR stderr ). .\" Moreover, .\" .BR dprintf () diff --git a/man3/encrypt.3 b/man3/encrypt.3 index 79b015cba..a7d831433 100644 --- a/man3/encrypt.3 +++ b/man3/encrypt.3 @@ -55,7 +55,7 @@ function sets the key used by .BR encrypt (). The .I key -parameter used here is an array of 64 bytes, each of which has +argument used here is an array of 64 bytes, each of which has numerical value 1 or 0. The bytes key[n] where n=8*i-1 are ignored, so that the effective key length is 56 bits. @@ -65,7 +65,9 @@ The function modifies the passed buffer, encoding if .I edflag is 0, and decoding if 1 is being passed. -Like the key parameter also +Like the +.I key +argument, also .I block is a bit vector representation of the actual value that is encoded. The result is returned in that same vector. diff --git a/man3/exec.3 b/man3/exec.3 index 389dcca94..45fc2b430 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -107,10 +107,12 @@ The .BR execle () function also specifies the environment of the executed process by following the NULL -pointer that terminates the list of arguments in the parameter list or the -pointer to the argv array with an additional parameter. +pointer that terminates the list of arguments in the argument list or the +pointer to the +.I argv +array with an additional argument. This additional -parameter is an array of pointers to null-terminated strings and +argument is an array of pointers to null-terminated strings and .I must be terminated by a NULL pointer. The other functions take the environment for the new process diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3 index 5ab94ea09..7bc2ee8fd 100644 --- a/man3/fmtmsg.3 +++ b/man3/fmtmsg.3 @@ -20,10 +20,10 @@ fmtmsg \- print formatted error messages .BI " const char *" action ", const char *" tag ); .fi .SH DESCRIPTION -This function displays a message described by its parameters on the device(s) +This function displays a message described by its arguments on the device(s) specified in the .I classification -parameter. +argument. For messages written to .IR stderr , the format depends on the @@ -32,29 +32,29 @@ environment variable. .LP The .I label -parameter identifies the source of the message. +argument identifies the source of the message. The string must consist of two colon separated parts where the first part has not more than 10 and the second part not more than 14 characters. .LP The .I text -parameter describes the condition of the error. +argument describes the condition of the error. .LP The .I action -parameter describes possible steps to recover from the error. +argument describes possible steps to recover from the error. If it is printed, it is prefixed by "TO FIX: ". .LP The .I tag -parameter is a reference to the online documentation where more +argument is a reference to the online documentation where more information can be found. It should contain the .I label value and a unique identification number. -.SS "Dummy parameters" -Each of the parameters can have a dummy value. +.SS "Dummy arguments" +Each of the arguments can have a dummy value. The dummy classification value .B MM_NULLMC (0L) does not specify any output, so nothing is printed. @@ -72,10 +72,10 @@ the empty string, and .B MM_NULLSEV is a synonym for .BR NO_SEV . -.SS "The classification parameter" +.SS "The classification argument" The .I classification -parameter is the sum of values describing 4 types of information. +argument is the sum of values describing 4 types of information. .br .sp The first value defines the output channel. @@ -119,10 +119,10 @@ It is a recoverable error. .TP .B MM_NRECOV It is a non-recoverable error. -.SS "The severity parameter" +.SS "The severity argument" The .I severity -parameter can take one of the following values: +argument can take one of the following values: .TP 12n .B MM_NOSEV No severity is printed. @@ -207,7 +207,7 @@ The severity-keyword part is not used by but it has to be present. The level part is a string representation of a number. The numeric value must be a number greater than 4. -This value must be used in the severity parameter of +This value must be used in the severity argument of .BR fmtmsg () to select this class. It is not possible to overwrite diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index 175f32cd3..a4a4497ae 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -103,9 +103,8 @@ The maximum needed size for .I buf can be found using .BR sysconf (3) -with the -.B _SC_GETGR_R_SIZE_MAX -parameter. +with the argument +.BR _SC_GETGR_R_SIZE_MAX . .SH "RETURN VALUE" The .BR getgrnam () diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 0655fed7a..4b364491a 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -310,7 +310,7 @@ was an .IR int . The SUSv2 standard is buggy and declares the .I len -parameter of +argument of .BR gethostbyaddr () to be of type .IR size_t . diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index 1420c0596..b227b61d6 100644 --- a/man3/getipnodebyname.3 +++ b/man3/getipnodebyname.3 @@ -88,33 +88,33 @@ function is used to release the dynamically allocated memory after the caller no longer needs the .I hostent structure. -.SS getipnodebyname parameters +.SS getipnodebyname() arguments The .BR getipnodebyname () function looks up network addresses for the host specified by the .I name -parameter. +argument. The .I af -parameter specifies one of the following values: +argument specifies one of the following values: .TP .B AF_INET The .I name -parameter points to a dotted-quad IPv4 address or a name +argument points to a dotted-quad IPv4 address or a name of an IPv4 network host. .TP .B AF_INET6 The .I name -parameter points to a hexadecimal IPv6 address or a name +argument points to a hexadecimal IPv6 address or a name of an IPv6 network host. .PP The .I flags -parameter specifies additional options. +argument specifies additional options. More than one option can be specified by logically OR-ing them together. .I flags @@ -149,7 +149,7 @@ flag. .B AI_DEFAULT This flag is equivalent to .BR "(AI_ADDRCONFIG | AI_V4MAPPED)" . -.SS getipnodebyaddr parameters +.SS getipnodebyaddr() arguments The .BR getipnodebyaddr () function @@ -157,15 +157,15 @@ looks up the name of the host whose network address is specified by the .I addr -parameter. +argument. The .I af -parameter specifies one of the following values: +argument specifies one of the following values: .TP .B AF_INET The .I addr -parameter points to a +argument points to a .I struct in_addr and .I len @@ -175,7 +175,7 @@ must be set to .B AF_INET6 The .I addr -parameter points to a +argument points to a .I struct in6_addr and .I len @@ -216,7 +216,7 @@ The array is terminated by a null pointer. .I h_addrtype This is a copy of the .I af -parameter to +argument to .BR getipnodebyname () or .BR getipnodebyaddr (). @@ -225,14 +225,14 @@ will always be .B AF_INET if the .I af -parameter was +argument was .BR AF_INET . .I h_addrtype will always be .B AF_INET6 if the .I af -parameter was +argument was .BR AF_INET6 . .TP .I h_length diff --git a/man3/getline.3 b/man3/getline.3 index 28c890404..2d1c21f95 100644 --- a/man3/getline.3 +++ b/man3/getline.3 @@ -101,7 +101,7 @@ condition). .SH ERRORS .TP .B EINVAL -Bad parameters +Bad arguments .RI ( n or .I lineptr diff --git a/man3/getpwent_r.3 b/man3/getpwent_r.3 index 3717b0ced..873b18041 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -58,8 +58,7 @@ and The former reads the next passwd entry from the stream initialized by .BR setpwent (3). The latter reads the next passwd entry from the stream -.I fp -given as parameter. +.IR fp . .PP The \fIpasswd\fP structure is defined in .I diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 703b80a62..7543599ca 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -117,9 +117,8 @@ The maximum needed size for .I buf can be found using .BR sysconf (3) -with the -.B _SC_GETPW_R_SIZE_MAX -parameter. +with the argument +.BR _SC_GETPW_R_SIZE_MAX . .SH "RETURN VALUE" The .BR getpwnam () diff --git a/man3/getutent.3 b/man3/getutent.3 index 59e1f2beb..e6a8ebc11 100644 --- a/man3/getutent.3 +++ b/man3/getutent.3 @@ -224,7 +224,7 @@ These functions are GNU extensions, analogs of the functions of the same name without the _r suffix. The .I ubuf -parameter gives these functions a place to store their result. +argument gives these functions a place to store their result. On success they return 0, and a pointer to the result is written in .IR *ubufp . On error these functions return \-1. diff --git a/man3/glob.3 b/man3/glob.3 index d00501a18..089dce6f2 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -85,7 +85,7 @@ typedef struct { .PP Results are stored in dynamically allocated storage. .PP -The parameter +The argument .I flags is made up of the bitwise OR of zero or more the following symbolic constants, which modify the behavior of diff --git a/man3/gsignal.3 b/man3/gsignal.3 index 3caff0544..f922e8342 100644 --- a/man3/gsignal.3 +++ b/man3/gsignal.3 @@ -84,7 +84,7 @@ then it does nothing and returns 1. Otherwise, it resets the action to .B SIG_DFL and calls -the action function with parameter +the action function with argument .IR signum , and returns the value returned by that function. The range of possible values diff --git a/man3/hsearch.3 b/man3/hsearch.3 index aaec52c02..4fab64ea9 100644 --- a/man3/hsearch.3 +++ b/man3/hsearch.3 @@ -140,7 +140,7 @@ The glibc implementation will return the following two errors. Table full with \fIaction\fP set to \fBENTER\fP. .TP .B ESRCH -The \fIaction\fP parameter is \fBFIND\fP and no corresponding element +The \fIaction\fP argument is \fBFIND\fP and no corresponding element is found in the table. .SH "CONFORMING TO" The functions diff --git a/man3/inet_ntop.3 b/man3/inet_ntop.3 index 1f95fc9ac..6bc6e828c 100644 --- a/man3/inet_ntop.3 +++ b/man3/inet_ntop.3 @@ -98,7 +98,7 @@ The converted address string would exceed the size given by .IR cnt . .SH "CONFORMING TO" POSIX.1-2001. -Note that RFC\ 2553 defines a prototype where the last parameter +Note that RFC\ 2553 defines a prototype where the last argument .I cnt is of type .IR size_t . diff --git a/man3/lgamma.3 b/man3/lgamma.3 index 711c66df6..87b5bd57e 100644 --- a/man3/lgamma.3 +++ b/man3/lgamma.3 @@ -66,7 +66,7 @@ Since using a constant location is not thread-safe, the functions .BR lgamma_r () etc. have -been introduced; they return this sign via the parameter +been introduced; they return this sign via the argument .IR signp . .PP For non-positive integer values of \fIx\fP, diff --git a/man3/mpool.3 b/man3/mpool.3 index befd90501..a00dd9f29 100644 --- a/man3/mpool.3 +++ b/man3/mpool.3 @@ -133,7 +133,9 @@ If the page exists, a pointer to the page is returned. Otherwise, NULL is returned and .I errno is set. -The flags parameter is not currently used. +The +.I flags +argument is not currently used. .PP The function .BR mpool_put () diff --git a/man3/netlink.3 b/man3/netlink.3 index 708d78677..3415f10ff 100644 --- a/man3/netlink.3 +++ b/man3/netlink.3 @@ -66,7 +66,9 @@ The caller must check if the current didn't have the .B NLMSG_DONE set \(em this function doesn't return NULL on end. -The length parameter is an lvalue containing the remaining length +The +.I len +argument is an lvalue containing the remaining length of the message buffer. This macro decrements it by the length of the message header. .TP diff --git a/man3/openpty.3 b/man3/openpty.3 index 4e3d2eddf..e033af078 100644 --- a/man3/openpty.3 +++ b/man3/openpty.3 @@ -103,7 +103,7 @@ The .I termp and .I winp -parameters, if not NULL, +arguments, if not NULL, will determine the terminal attributes and window size of the slave side of the pseudo-terminal. .SH "RETURN VALUE" diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3 index 7f604c62c..1b06b9fbf 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -95,7 +95,7 @@ is not set. .B EINVAL The .I alignment -parameter was not a power of two, or was not a multiple of +argument was not a power of two, or was not a multiple of .IR "sizeof(void *)" . .TP .B ENOMEM @@ -163,7 +163,7 @@ matches the requirements detailed above. .BR memalign () may not check that the .I boundary -parameter is correct. +argument is correct. POSIX requires that memory obtained from .BR posix_memalign () diff --git a/man3/regex.3 b/man3/regex.3 index 1165a084f..cdc79214c 100644 --- a/man3/regex.3 +++ b/man3/regex.3 @@ -98,7 +98,7 @@ The .I nmatch and .I pmatch -parameters to +arguments to .BR regexec () are ignored if the pattern buffer supplied was compiled with this flag set. .TP diff --git a/man3/setbuf.3 b/man3/setbuf.3 index f0871ea53..6c69a1a56 100644 --- a/man3/setbuf.3 +++ b/man3/setbuf.3 @@ -97,7 +97,7 @@ The function may be used on any open stream to change its buffer. The .I mode -parameter must be one of the following three macros: +argument must be one of the following three macros: .RS .TP .B _IONBF diff --git a/man3/sigpause.3 b/man3/sigpause.3 index e9188ceb5..29a0dcc26 100644 --- a/man3/sigpause.3 +++ b/man3/sigpause.3 @@ -70,7 +70,7 @@ same name was solved by the .BR \%sigsuspend (2) function, that takes a .I "sigset_t *" -parameter (instead of an +argument (instead of an .IR int ). .SS Linux Notes On Linux, this routine is a system call only on the Sparc (sparc64) diff --git a/man3/stdarg.3 b/man3/stdarg.3 index d5c2280d8..67b4538a8 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -79,12 +79,12 @@ and .BR va_end (), and must be called first. .PP -The parameter +The argument .I last -is the name of the last parameter before the variable argument list, that is, -the last parameter of which the calling function knows the type. +is the name of the last argument before the variable argument list, that is, +the last argument of which the calling function knows the type. .PP -Because the address of this parameter may be used in the +Because the address of this argument may be used in the .BR va_start () macro, it should not be declared as a register variable, or as a function or an array type. @@ -93,7 +93,7 @@ The .BR va_arg () macro expands to an expression that has the type and value of the next argument in the call. -The parameter +The argument .I ap is the .I va_list @@ -105,7 +105,7 @@ Each call to modifies .I ap so that the next call returns the next argument. -The parameter +The argument .I type is a type name specified so that the type of a pointer to an object that has the specified type can be obtained simply by adding a * to @@ -174,11 +174,11 @@ va_list aq; .fi .in -Finally, on systems where parameters are passed in registers, +Finally, on systems where arguments are passed in registers, it may be necessary for .BR va_start () -to allocate memory, store the parameters there, and also -an indication of which parameter is next, so that +to allocate memory, store the arguments there, and also +an indication of which argument is next, so that .BR va_arg () can step through the list. Now diff --git a/man3/stdio_ext.3 b/man3/stdio_ext.3 index 7ae363cfd..713a383c2 100644 --- a/man3/stdio_ext.3 +++ b/man3/stdio_ext.3 @@ -100,7 +100,7 @@ function can be used to select the desired type of locking on the stream. It returns the current type. The .I type -parameter can take the following three values: +argument can take the following three values: .TP .B FSETLOCKING_INTERNAL Perform implicit locking around every operation on the given stream diff --git a/man3/sysconf.3 b/man3/sysconf.3 index c52406861..11a7d0b24 100644 --- a/man3/sysconf.3 +++ b/man3/sysconf.3 @@ -102,7 +102,7 @@ argument will be .SS "POSIX.1 Variables" We give the name of the variable, the name of the .BR sysconf () -parameter used to inquire about its value, +argument used to inquire about its value, and a short description. .LP First, the POSIX.1 compatible values. diff --git a/man3/syslog.3 b/man3/syslog.3 index b0d16e4b4..e057ce084 100644 --- a/man3/syslog.3 +++ b/man3/syslog.3 @@ -123,7 +123,7 @@ been obtained using the .BR stdarg (3) variable argument list macros. -The subsections below lists the parameters used to set the values of +The subsections below list the parameters used to set the values of .IR option , " facility" ", and " priority . .SS option The @@ -285,7 +285,7 @@ in most versions of Unix. .\" mechanism, which is not compatible with .\" .IR . .SH NOTES -The parameter +The argument .I ident in the call of .BR openlog () diff --git a/man3/tmpnam.3 b/man3/tmpnam.3 index caf3353d9..c79ce44e5 100644 --- a/man3/tmpnam.3 +++ b/man3/tmpnam.3 @@ -108,7 +108,7 @@ or .LP Portable applications that use threads cannot call .BR tmpnam () -with NULL parameter if either +with a NULL argument if either .B _POSIX_THREADS or .B _POSIX_THREAD_SAFE_FUNCTIONS diff --git a/man3/wordexp.3 b/man3/wordexp.3 index 731b3383e..0c4151dd3 100644 --- a/man3/wordexp.3 +++ b/man3/wordexp.3 @@ -157,7 +157,7 @@ initial NULLs in the array Don't do command substitution. .TP .B WRDE_REUSE -The parameter +The argument .I p resulted from a previous call to .BR wordexp (), diff --git a/man3/xdr.3 b/man3/xdr.3 index a37d0dc68..da19a5b3b 100644 --- a/man3/xdr.3 +++ b/man3/xdr.3 @@ -39,14 +39,14 @@ type, see .IP A filter primitive that translates between variable-length arrays and their corresponding external representations. -The parameter +The argument .I arrp is the address of the pointer to the array, while .I sizep is the address of the element count of the array; this element count cannot exceed .IR maxsize . -The parameter +The argument .I elsize is the .I sizeof @@ -75,7 +75,7 @@ This routine returns one if it succeeds, zero otherwise. .IP A filter primitive that translates between counted byte strings and their external representations. -The parameter +The argument .I sp is the address of the string pointer. The length of the @@ -231,7 +231,7 @@ or .IP A filter primitive that translates between fixed size opaque data and its external representation. -The parameter +The argument .I cp is the address of the opaque object, and .I cnt @@ -282,7 +282,7 @@ and .BR write (2), except that .I handle -is passed to the former routines as the first parameter. +is passed to the former routines as the first argument. Note: the XDR stream's .I op field must be set by the caller. @@ -330,7 +330,7 @@ This routine returns one if it succeeds, zero otherwise. .fi .IP A primitive that provides pointer chasing within structures. -The parameter +The argument .I pp is the address of the pointer; .I size @@ -356,7 +356,7 @@ instead. A macro that invokes the set position routine associated with the XDR stream .IR xdrs . -The parameter +The argument .I pos is a position value obtained from .BR xdr_getpos (). @@ -386,7 +386,7 @@ The XDR stream data is written to, or read from, the .I stdio stream .IR file . -The parameter +The argument .I op determines the direction of the XDR stream (either .BR XDR_ENCODE , @@ -467,7 +467,7 @@ This discriminant is always an Next the union located at .I unp is translated. -The parameter +The argument .I choices is a pointer to an array of .BR xdr_discrim () @@ -496,12 +496,12 @@ Returns one if it succeeds, zero otherwise. .IP A filter primitive that translates between fixed-length arrays and their corresponding external representations. -The parameter +The argument .I arrp is the address of the pointer to the array, while .I size is the element count of the array. -The parameter +The argument .I elsize is the .I sizeof @@ -517,7 +517,7 @@ This routine returns one if it succeeds, zero otherwise. .fi .IP This routine always returns one. -It may be passed to RPC routines that require a function parameter, +It may be passed to RPC routines that require a function argument, where nothing is to be done. .LP .nf @@ -531,7 +531,7 @@ where is the maximum value of an unsigned integer. .BR xdr_wrapstring () is handy because the RPC package passes a maximum of two XDR -routines as parameters, and +routines as arguments, and .BR xdr_string (), one of the most frequently used primitives, requires three. Returns one if it succeeds, zero otherwise. diff --git a/man7/arp.7 b/man7/arp.7 index 8896cfd4d..c1879c230 100644 --- a/man7/arp.7 +++ b/man7/arp.7 @@ -72,7 +72,7 @@ Three ioctls are available on all sockets. They take a pointer to a .I struct arpreq -as their parameter. +as their argument. .in +4n .nf diff --git a/man7/socket.7 b/man7/socket.7 index 0290cce34..41b37f1b4 100644 --- a/man7/socket.7 +++ b/man7/socket.7 @@ -416,7 +416,7 @@ bytes are available. .\" Implemented in 2.1.11 for getsockopt: always return a zero struct. .\" Implemented in 2.3.41 for setsockopt, and actually used. Specify the receiving or sending timeouts until reporting an error. -The parameter is a +The argument is a .IR "struct timeval" . If an input or output function blocks for this period of time, and data has been sent or received, the return value of that function diff --git a/man7/utf-8.7 b/man7/utf-8.7 index c312effdf..74574615f 100644 --- a/man7/utf-8.7 +++ b/man7/utf-8.7 @@ -41,7 +41,7 @@ consists of a sequence of 16-bit words. Such strings can contain as parts of many 16-bit characters bytes like \(aq\\0\(aq or \(aq/\(aq which have a -special meaning in filenames and other C library function parameters. +special meaning in filenames and other C library function arguments. In addition, the majority of Unix tools expects ASCII files and can't read 16-bit words as characters without major modifications. For these reasons, diff --git a/man7/x25.7 b/man7/x25.7 index 03c5e6e24..92a77e06b 100644 --- a/man7/x25.7 +++ b/man7/x25.7 @@ -69,7 +69,9 @@ The following X.25-specific socket options can be set by using .BR setsockopt (2) and read with .BR getsockopt (2) -with the level parameter set to +with the +.I level +argument set to .BR SOL_X25 . .TP .B X25_QBITINCL