mirror of https://github.com/mkerrisk/man-pages
arch_prctl.2, getpeername.2, getrlimit.2, ioctl_list.2, mmap2.2, mremap.2, sched_setaffinity.2, setup.2, shmop.2, argz_add.3, exec.3, fenv.3, fmtmsg.3, gethostbyname.3, posix_memalign.3, printf.3, scanf.3, sigpause.3, wordexp.3, xdr.3, st.4, tty_ioctl.4: Formatting fix: prevent '*' in declaration or cast wrapping to next line
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
46d8df8ea4
commit
5049da5bef
|
@ -47,7 +47,7 @@ to it;
|
|||
is interpreted as either an
|
||||
.I "unsigned long"
|
||||
for the "set" operations, or as an
|
||||
.IR "unsigned long *" ,
|
||||
.IR "unsigned long\ *" ,
|
||||
for the "get" operations.
|
||||
.LP
|
||||
Subfunctions for x86-64 are:
|
||||
|
|
|
@ -106,7 +106,7 @@ function call first appeared in 4.2BSD), POSIX.1-2001.
|
|||
The third argument of
|
||||
.BR getpeername ()
|
||||
is in reality an
|
||||
.I int *
|
||||
.I "int\ *"
|
||||
(and this is what 4.x BSD and libc4 and libc5 have).
|
||||
Some POSIX confusion resulted in the present
|
||||
.IR socklen_t ,
|
||||
|
|
|
@ -261,7 +261,7 @@ structure specified as the fourth argument to
|
|||
.BR mq_open (3).
|
||||
|
||||
The first addend in the formula, which includes
|
||||
.I "sizeof(struct msg_msg *)"
|
||||
.I "sizeof(struct msg_msg\ *)"
|
||||
(4 bytes on Linux/i386), ensures that the user cannot
|
||||
create an unlimited number of zero-length messages (such messages
|
||||
nevertheless each consume some system memory for bookkeeping overhead).
|
||||
|
|
|
@ -39,9 +39,9 @@ For each ioctl, its numerical value, its name, and its argument
|
|||
type are given.
|
||||
.PP
|
||||
An argument type of
|
||||
.I const struct foo *
|
||||
.I "const struct foo\ *"
|
||||
means the argument is input to the kernel.
|
||||
.I struct foo *
|
||||
.I "struct foo\ *"
|
||||
means the kernel outputs the argument.
|
||||
If the kernel uses the argument for both input and output, this is
|
||||
marked with \fI//\ I-O\fP.
|
||||
|
@ -765,11 +765,11 @@ These are documented here in alphabetical order.
|
|||
|
||||
.B CDROMREADAUDIO
|
||||
takes an input pointer
|
||||
.IR "const struct cdrom_read_audio *" .
|
||||
.IR "const struct cdrom_read_audio\ *" .
|
||||
The
|
||||
.I buf
|
||||
field points to an output buffer of length
|
||||
.IR "nframes * CD_FRAMESIZE_RAW" .
|
||||
.IR "nframes\ * CD_FRAMESIZE_RAW" .
|
||||
|
||||
.BR CDROMREADCOOKED ,
|
||||
.BR CDROMREADMODE1 ,
|
||||
|
@ -777,7 +777,7 @@ field points to an output buffer of length
|
|||
and
|
||||
.B CDROMREADRAW
|
||||
take an input pointer
|
||||
.IR "const struct cdrom_msf *" .
|
||||
.IR "const struct cdrom_msf\ *" .
|
||||
They use the same pointer as an output pointer to
|
||||
.IR "char []" .
|
||||
The length varies by request.
|
||||
|
@ -802,7 +802,7 @@ driver uses OPT_BLOCKSIZE instead (both have the numerical value
|
|||
and
|
||||
.B EQL_SETMASTERCFG
|
||||
take a
|
||||
.IR "struct ifreq *" .
|
||||
.IR "struct ifreq\ *" .
|
||||
The
|
||||
.I ifr_data
|
||||
field is a pointer to another structure as follows:
|
||||
|
@ -818,7 +818,7 @@ field is a pointer to another structure as follows:
|
|||
.fi
|
||||
.B FDRAWCMD
|
||||
takes a
|
||||
.IR "struct floppy raw_cmd *" .
|
||||
.IR "struct floppy raw_cmd\ *" .
|
||||
If
|
||||
.I flags & FD_RAW_WRITE
|
||||
is nonzero, then
|
||||
|
@ -836,9 +836,9 @@ points to an output buffer of length
|
|||
and
|
||||
.B PIO_FONTX
|
||||
take a
|
||||
.I struct console_font_desc *
|
||||
.I struct console_font_desc\ *
|
||||
or a
|
||||
.IR "const struct console_font_desc *" ,
|
||||
.IR "const struct console_font_desc\ *" ,
|
||||
respectively.
|
||||
.I chardata
|
||||
points to a buffer of
|
||||
|
@ -852,9 +852,9 @@ and an input buffer for
|
|||
and
|
||||
.B PIO_UNIMAP
|
||||
take a
|
||||
.I struct unimapdesc *
|
||||
.I "struct unimapdesc\ *"
|
||||
or a
|
||||
.IR "const struct unimapdesc *" ,
|
||||
.IR "const struct unimapdesc\ *" ,
|
||||
respectively.
|
||||
.I entries
|
||||
points to a buffer of
|
||||
|
@ -876,7 +876,7 @@ They are not implemented in the kernel.
|
|||
|
||||
.B SCSI_IOCTL_PROBE_HOST
|
||||
takes an input pointer
|
||||
.IR "const int *" ,
|
||||
.IR "const int\ *" ,
|
||||
which is a length.
|
||||
It uses the same pointer as an output pointer to a
|
||||
.I char []
|
||||
|
@ -896,7 +896,7 @@ the protocol:
|
|||
.fi
|
||||
.B SIOCGIFCONF
|
||||
takes a
|
||||
.IR "struct ifconf *" .
|
||||
.IR "struct ifconf\ *" .
|
||||
The
|
||||
.I ifc_buf
|
||||
field points to a buffer of length
|
||||
|
@ -914,7 +914,7 @@ takes an input pointer whose type depends on the protocol:
|
|||
.fi
|
||||
.B TIOCLINUX
|
||||
takes a
|
||||
.IR "const char *" .
|
||||
.IR "const char\ *" .
|
||||
It uses this to distinguish several
|
||||
independent subcases.
|
||||
In the table below,
|
||||
|
|
|
@ -65,7 +65,7 @@ Problem with getting the data from user space.
|
|||
.TP
|
||||
.B EINVAL
|
||||
(Various platforms where the page size is not 4096 bytes.)
|
||||
.I offset * 4096
|
||||
.I "offset\ *\ 4096"
|
||||
is not a multiple of the system page size.
|
||||
.PP
|
||||
.BR mmap2 ()
|
||||
|
|
|
@ -101,7 +101,7 @@ flag of
|
|||
If this flag is specified, then
|
||||
.BR mremap ()
|
||||
accepts a fifth argument,
|
||||
.IR "void *new_address" ,
|
||||
.IR "void\ *new_address" ,
|
||||
which specifies a page-aligned address to which the mapping must
|
||||
be moved.
|
||||
Any previous mapping at the address range specified by
|
||||
|
|
|
@ -202,7 +202,7 @@ This manual page describes the glibc interface for the CPU affinity calls.
|
|||
The actual system call interface is slightly different, with the
|
||||
.I mask
|
||||
being typed as
|
||||
.IR "unsigned long *" ,
|
||||
.IR "unsigned long\ *" ,
|
||||
reflecting the fact that the underlying implementation of CPU
|
||||
sets is a simple bit mask.
|
||||
On success, the raw
|
||||
|
|
|
@ -66,6 +66,6 @@ intended to be portable, or indeed in any programs at all.
|
|||
The calling sequence varied: at some times
|
||||
.I setup ()
|
||||
has had a single argument
|
||||
.I "void *BIOS"
|
||||
.I "void\ *BIOS"
|
||||
and at other times a single argument
|
||||
.IR "int magic" .
|
||||
|
|
12
man2/shmop.2
12
man2/shmop.2
|
@ -234,19 +234,19 @@ SVr4, POSIX.1-2001.
|
|||
|
||||
In SVID 3 (or perhaps earlier)
|
||||
the type of the \fIshmaddr\fP argument was changed from
|
||||
.I "char *"
|
||||
.I "char\ *"
|
||||
into
|
||||
.IR "const void *" ,
|
||||
.IR "const void\ *" ,
|
||||
and the returned type of
|
||||
.BR shmat ()
|
||||
from
|
||||
.I "char *"
|
||||
.I "char\ *"
|
||||
into
|
||||
.IR "void *" .
|
||||
.IR "void\ *" .
|
||||
(Linux libc4 and libc5 have the
|
||||
.I "char *"
|
||||
.I "char\ *"
|
||||
prototypes; glibc2 has
|
||||
.IR "void *" .)
|
||||
.IR "void\ *" .)
|
||||
.SH NOTES
|
||||
Using
|
||||
.BR shmat ()
|
||||
|
|
|
@ -91,9 +91,9 @@ delimiter \(aq:\(aq.
|
|||
.LP
|
||||
.BR argz_append ()
|
||||
appends the argz vector
|
||||
.RI ( buf ,\ buf_len )
|
||||
.RI ( buf ,\ buf_len )
|
||||
after
|
||||
.RI ( *argz ,\ *argz_len )
|
||||
.RI ( *argz ,\ *argz_len )
|
||||
and updates
|
||||
.IR *argz
|
||||
and
|
||||
|
@ -106,21 +106,21 @@ will be increased by
|
|||
.BR argz_count ()
|
||||
counts the number of strings, that is,
|
||||
the number of null bytes (\(aq\\0\(aq), in
|
||||
.RI ( argz ,\ argz_len ).
|
||||
.RI ( argz ,\ argz_len ).
|
||||
.LP
|
||||
.BR argz_create ()
|
||||
converts a UNIX-style argument vector
|
||||
.IR argv ,
|
||||
terminated by
|
||||
.IR "(char *) 0" ,
|
||||
.IR "(char\ *)\ 0" ,
|
||||
into an argz vector
|
||||
.RI ( *argz ,\ *argz_len ).
|
||||
.RI ( *argz ,\ *argz_len ).
|
||||
.LP
|
||||
.BR argz_create_sep ()
|
||||
converts the null-terminated string
|
||||
.I str
|
||||
into an argz vector
|
||||
.RI ( *argz ,\ *argz_len )
|
||||
.RI ( *argz ,\ *argz_len )
|
||||
by breaking it up at every occurrence of the separator
|
||||
.IR sep .
|
||||
.LP
|
||||
|
@ -128,7 +128,7 @@ by breaking it up at every occurrence of the separator
|
|||
removes the substring pointed to by
|
||||
.I entry
|
||||
from the argz vector
|
||||
.RI ( *argz ,\ *argz_len )
|
||||
.RI ( *argz ,\ *argz_len )
|
||||
and updates
|
||||
.I *argz
|
||||
and
|
||||
|
@ -138,7 +138,7 @@ and
|
|||
is the opposite of
|
||||
.BR argz_create ().
|
||||
It takes the argz vector
|
||||
.RI ( argz ,\ argz_len )
|
||||
.RI ( argz ,\ argz_len )
|
||||
and fills the array starting at
|
||||
.I argv
|
||||
with pointers to the substrings, and a final NULL,
|
||||
|
@ -157,7 +157,7 @@ It inserts the argument
|
|||
at position
|
||||
.I before
|
||||
into the argz vector
|
||||
.RI ( *argz ,\ *argz_len )
|
||||
.RI ( *argz ,\ *argz_len )
|
||||
and updates
|
||||
.I *argz
|
||||
and
|
||||
|
|
|
@ -84,7 +84,7 @@ The initial argument for these functions is the name of a file that is
|
|||
to be executed.
|
||||
.PP
|
||||
The
|
||||
.I "const char *arg"
|
||||
.I "const char\ *arg"
|
||||
and subsequent ellipses in the
|
||||
.BR execl (),
|
||||
.BR execlp (),
|
||||
|
@ -103,7 +103,7 @@ The list of arguments
|
|||
.I must
|
||||
be terminated by a NULL
|
||||
pointer, and, since these are variadic functions, this pointer must be cast
|
||||
.IR "(char *) NULL" .
|
||||
.IR "(char\ *) NULL" .
|
||||
.PP
|
||||
The
|
||||
.BR execv (),
|
||||
|
|
|
@ -213,7 +213,7 @@ as one opaque object, of type
|
|||
The default environment is denoted by
|
||||
.B FE_DFL_ENV
|
||||
(of type
|
||||
.IR "const fenv_t *" ).
|
||||
.IR "const fenv_t\ *" ).
|
||||
This is the environment setup at program start and it is defined by
|
||||
ISO C to have round to nearest, all exceptions cleared and a nonstop
|
||||
(continue on exceptions) mode.
|
||||
|
|
|
@ -71,7 +71,7 @@ The values
|
|||
.BR MM_NULLACT ,
|
||||
.B MM_NULLTAG
|
||||
are synonyms for
|
||||
.IR "((char *) 0)" ,
|
||||
.IR "((char\ *)\ 0)" ,
|
||||
the empty string, and
|
||||
.B MM_NULLSEV
|
||||
is a synonym for
|
||||
|
|
|
@ -362,7 +362,7 @@ See also
|
|||
The BSD prototype for
|
||||
.BR gethostbyaddr ()
|
||||
uses
|
||||
.I const char *
|
||||
.I "const char\ *"
|
||||
for the first argument.
|
||||
.SS System V/POSIX extension
|
||||
POSIX requires the
|
||||
|
|
|
@ -91,7 +91,7 @@ bytes and places the address of the allocated memory in
|
|||
The address of the allocated memory will be a multiple of
|
||||
.IR "alignment" ,
|
||||
which must be a power of two and a multiple of
|
||||
.IR "sizeof(void *)".
|
||||
.IR "sizeof(void\ *)" .
|
||||
If
|
||||
.I size
|
||||
is 0, then
|
||||
|
@ -158,7 +158,7 @@ is not set.
|
|||
The
|
||||
.I alignment
|
||||
argument was not a power of two, or was not a multiple of
|
||||
.IR "sizeof(void *)" .
|
||||
.IR "sizeof(void\ *)" .
|
||||
.TP
|
||||
.B ENOMEM
|
||||
There was insufficient memory to fulfill the allocation request.
|
||||
|
|
|
@ -727,7 +727,7 @@ resulting multibyte string is written.
|
|||
If no
|
||||
.B l
|
||||
modifier is present: The
|
||||
.I "const char *"
|
||||
.I "const char\ *"
|
||||
argument is expected to be a pointer to an array of character type (pointer
|
||||
to a string).
|
||||
Characters from the array are written up to (but not
|
||||
|
@ -741,7 +741,7 @@ array, the array must contain a terminating null byte.
|
|||
If an
|
||||
.B l
|
||||
modifier is present: The
|
||||
.I "const wchar_t *"
|
||||
.I "const wchar_t\ *"
|
||||
argument is expected to be a pointer to an array of wide characters.
|
||||
Wide characters from the array are converted to multibyte characters
|
||||
(each by a call to the
|
||||
|
@ -779,7 +779,7 @@ Don't use.
|
|||
.TP
|
||||
.B p
|
||||
The
|
||||
.I "void *"
|
||||
.I "void\ *"
|
||||
pointer argument is printed in hexadecimal (as if by
|
||||
.B %#x
|
||||
or
|
||||
|
@ -788,7 +788,7 @@ or
|
|||
.B n
|
||||
The number of characters written so far is stored into the integer
|
||||
indicated by the
|
||||
.I "int *"
|
||||
.I "int\ *"
|
||||
(or variant) pointer argument.
|
||||
No argument is converted.
|
||||
.TP
|
||||
|
|
|
@ -212,7 +212,7 @@ allocates a buffer of sufficient size,
|
|||
and assigns the address of this buffer to the corresponding
|
||||
.I pointer
|
||||
argument, which should be a pointer to a
|
||||
.I "char *"
|
||||
.I "char\ *"
|
||||
variable (this variable does not need to be initialized before the call).
|
||||
The caller should subsequently
|
||||
.BR free (3)
|
||||
|
|
|
@ -71,7 +71,7 @@ The unfortunate situation with two incompatible functions with the
|
|||
same name was solved by the
|
||||
.BR \%sigsuspend (2)
|
||||
function, that takes a
|
||||
.I "sigset_t *"
|
||||
.I "sigset_t\ *"
|
||||
argument (instead of an
|
||||
.IR int ).
|
||||
.SS Linux notes
|
||||
|
|
|
@ -62,7 +62,7 @@ that gives the number of words in the expansion of
|
|||
The field
|
||||
.I we_wordv
|
||||
is a
|
||||
.I char **
|
||||
.I "char\ **"
|
||||
that points to the array of words found.
|
||||
The field
|
||||
.I we_offs
|
||||
|
|
|
@ -182,7 +182,7 @@ to a contiguous piece of the stream's buffer;
|
|||
.I len
|
||||
is the byte length of the desired buffer.
|
||||
Note: pointer is cast to
|
||||
.IR "long *" .
|
||||
.IR "long\ *" .
|
||||
.IP
|
||||
Warning:
|
||||
.BR xdr_inline ()
|
||||
|
|
|
@ -241,7 +241,7 @@ The definitions below are from
|
|||
.SS MTIOCTOP \(em perform a tape operation
|
||||
.PP
|
||||
This request takes an argument of type
|
||||
.IR "(struct mtop *)" .
|
||||
.IR "(struct mtop\ *)" .
|
||||
Not all drives support all operations.
|
||||
The driver returns an
|
||||
.B EIO
|
||||
|
@ -682,7 +682,7 @@ the masked sense data byte.
|
|||
.SS MTIOCGET \(em get status
|
||||
.PP
|
||||
This request takes an argument of type
|
||||
.IR "(struct mtget *)" .
|
||||
.IR "(struct mtget\ *)" .
|
||||
.PP
|
||||
.in +4n
|
||||
.nf
|
||||
|
@ -804,7 +804,7 @@ or
|
|||
.SS MTIOCPOS \(em get tape position
|
||||
.PP
|
||||
This request takes an argument of type
|
||||
.I "(struct mtpos *)"
|
||||
.I "(struct mtpos\ *)"
|
||||
and reports the drive's notion of the current tape block number,
|
||||
which is not the same as
|
||||
.I mt_blkno
|
||||
|
|
|
@ -61,9 +61,9 @@ The following four ioctls are just like
|
|||
.BR TCSETSW ,
|
||||
.BR TCSETSF ,
|
||||
except that they take a
|
||||
.I "struct termio *"
|
||||
.I "struct termio\ *"
|
||||
instead of a
|
||||
.IR "struct termios *" .
|
||||
.IR "struct termios\ *" .
|
||||
.TP
|
||||
.BI "TCGETA struct termio *" argp
|
||||
.TP
|
||||
|
|
Loading…
Reference in New Issue