s/parameter/argument/ when talking about the things given

to a function call, for consistency with majority usage.
This commit is contained in:
Michael Kerrisk 2008-07-10 20:53:08 +00:00
parent be9c618d66
commit c4bb193f3c
76 changed files with 177 additions and 169 deletions

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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,

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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" :

View File

@ -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

View File

@ -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<linux/prctl.h>\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)"

View File

@ -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

View File

@ -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.)

View File

@ -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 <sys/socket.h> :
.in +4n

View File

@ -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"

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ()

View File

@ -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

View File

@ -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" .

View File

@ -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.

View File

@ -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

View File

@ -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 <sys/socket.h> .

View File

@ -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"

View File

@ -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)

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ()

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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 ()

View File

@ -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 .

View File

@ -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

View File

@ -101,7 +101,7 @@ condition).
.SH ERRORS
.TP
.B EINVAL
Bad parameters
Bad arguments
.RI ( n
or
.I lineptr

View File

@ -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 <pwd.h>

View File

@ -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 ()

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 .

View File

@ -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,

View File

@ -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 ()

View File

@ -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

View File

@ -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"

View File

@ -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 ()

View File

@ -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

View File

@ -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

View File

@ -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)

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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 <stdarg.h> .
.SH NOTES
The parameter
The argument
.I ident
in the call of
.BR openlog ()

View File

@ -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

View File

@ -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 (),

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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,

View File

@ -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