mirror of https://github.com/mkerrisk/man-pages
getent.1, localedef.1, clock_nanosleep.2, fcntl.2, getitimer.2, getsockopt.2, inotify_init.2, ioctl.2, mlock.2, mprotect.2, quotactl.2, s390_sthyi.2, semctl.2, shmctl.2, shmget.2, wait.2, CPU_SET.3, aio_init.3, des_crypt.3, fmemopen.3, fopencookie.3, fts.3, getaddrinfo.3, getrpcent.3, lio_listio.3, posix_spawn.3, shm_open.3, st.4, elf.5, group.5, proc.5, services.5, aio.7, feature_test_macros.7, keyrings.7, man-pages.7, sigevent.7, tcp.7, udp.7: Global formatting fix: disfavor nonstandard .TP indents
In many cases, these don't improve readability, and (when stacked) they sometimes have the side effect of sometimes forcing text to be justified within a narrow column range. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
e41f05af22
commit
0019177eac
|
@ -376,7 +376,7 @@ Print the version number, license, and disclaimer of warranty for
|
||||||
One of the following exit values can be returned by
|
One of the following exit values can be returned by
|
||||||
.BR getent :
|
.BR getent :
|
||||||
.RS 3
|
.RS 3
|
||||||
.TP 10
|
.TP
|
||||||
.B 0
|
.B 0
|
||||||
Command completed successfully.
|
Command completed successfully.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -290,7 +290,7 @@ Print the version number, license, and disclaimer of warranty for
|
||||||
One of the following exit values can be returned by
|
One of the following exit values can be returned by
|
||||||
.BR localedef :
|
.BR localedef :
|
||||||
.RS 3
|
.RS 3
|
||||||
.TP 10
|
.TP
|
||||||
.B 0
|
.B 0
|
||||||
Command completed successfully.
|
Command completed successfully.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -77,7 +77,7 @@ The
|
||||||
argument specifies the clock against which the sleep interval
|
argument specifies the clock against which the sleep interval
|
||||||
is to be measured.
|
is to be measured.
|
||||||
This argument can have one of the following values:
|
This argument can have one of the following values:
|
||||||
.TP 17
|
.TP
|
||||||
.BR CLOCK_REALTIME
|
.BR CLOCK_REALTIME
|
||||||
A settable system-wide real-time clock.
|
A settable system-wide real-time clock.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -1229,7 +1229,7 @@ the following bits:
|
||||||
.PP
|
.PP
|
||||||
.RS
|
.RS
|
||||||
.PD 0
|
.PD 0
|
||||||
.TP 12
|
.TP
|
||||||
.B DN_ACCESS
|
.B DN_ACCESS
|
||||||
A file was accessed
|
A file was accessed
|
||||||
.RB ( read (2),
|
.RB ( read (2),
|
||||||
|
@ -1627,7 +1627,7 @@ All the write-specific hints are relative to each other,
|
||||||
and no individual absolute meaning should be attributed to them.
|
and no individual absolute meaning should be attributed to them.
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
For a successful call, the return value depends on the operation:
|
For a successful call, the return value depends on the operation:
|
||||||
.TP 0.9i
|
.TP
|
||||||
.B F_DUPFD
|
.B F_DUPFD
|
||||||
The new file descriptor.
|
The new file descriptor.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -34,7 +34,7 @@ Three types of timers\(emspecified via the
|
||||||
argument\(emare provided,
|
argument\(emare provided,
|
||||||
each of which counts against a different clock and
|
each of which counts against a different clock and
|
||||||
generates a different signal on timer expiration:
|
generates a different signal on timer expiration:
|
||||||
.TP 1.5i
|
.TP
|
||||||
.B ITIMER_REAL
|
.B ITIMER_REAL
|
||||||
This timer counts down in real (i.e., wall clock) time.
|
This timer counts down in real (i.e., wall clock) time.
|
||||||
At each expiration, a
|
At each expiration, a
|
||||||
|
|
|
@ -137,7 +137,7 @@ Netfilter allows the programmer
|
||||||
to define custom socket options with associated handlers; for such
|
to define custom socket options with associated handlers; for such
|
||||||
options, the return value on success is the value returned by the handler.
|
options, the return value on success is the value returned by the handler.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
.TP 10
|
.TP
|
||||||
.B EBADF
|
.B EBADF
|
||||||
The argument
|
The argument
|
||||||
.I sockfd
|
.I sockfd
|
||||||
|
|
|
@ -53,7 +53,7 @@ is the same as
|
||||||
The following values can be bitwise ORed in
|
The following values can be bitwise ORed in
|
||||||
.IR flags
|
.IR flags
|
||||||
to obtain different behavior:
|
to obtain different behavior:
|
||||||
.TP 12
|
.TP
|
||||||
.B IN_NONBLOCK
|
.B IN_NONBLOCK
|
||||||
Set the
|
Set the
|
||||||
.BR O_NONBLOCK
|
.BR O_NONBLOCK
|
||||||
|
|
|
@ -92,7 +92,7 @@ On error, \-1 is returned, and
|
||||||
.I errno
|
.I errno
|
||||||
is set appropriately.
|
is set appropriately.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
.TP 0.7i
|
.TP
|
||||||
.B EBADF
|
.B EBADF
|
||||||
.I fd
|
.I fd
|
||||||
is not a valid file descriptor.
|
is not a valid file descriptor.
|
||||||
|
|
|
@ -120,7 +120,7 @@ The
|
||||||
.I flags
|
.I flags
|
||||||
argument is constructed as the bitwise OR of one or more of the
|
argument is constructed as the bitwise OR of one or more of the
|
||||||
following constants:
|
following constants:
|
||||||
.TP 1.2i
|
.TP
|
||||||
.B MCL_CURRENT
|
.B MCL_CURRENT
|
||||||
Lock all pages which are currently mapped into the address space of
|
Lock all pages which are currently mapped into the address space of
|
||||||
the process.
|
the process.
|
||||||
|
|
|
@ -61,7 +61,7 @@ signal for the process.
|
||||||
is a combination of the following access flags:
|
is a combination of the following access flags:
|
||||||
.B PROT_NONE
|
.B PROT_NONE
|
||||||
or a bitwise-or of the other values in the following list:
|
or a bitwise-or of the other values in the following list:
|
||||||
.TP 1.1i
|
.TP
|
||||||
.B PROT_NONE
|
.B PROT_NONE
|
||||||
The memory cannot be accessed at all.
|
The memory cannot be accessed at all.
|
||||||
.TP
|
.TP
|
||||||
|
@ -95,7 +95,7 @@ and it is available on POWER 7 or PowerPC A2, for example).
|
||||||
Additionally (since Linux 2.6.0),
|
Additionally (since Linux 2.6.0),
|
||||||
.I prot
|
.I prot
|
||||||
can have one of the following flags set:
|
can have one of the following flags set:
|
||||||
.TP 1.1i
|
.TP
|
||||||
.\" mm/mmap.c:
|
.\" mm/mmap.c:
|
||||||
.\" vm_flags |= calc_vm_prot_bits(prot, pkey) | calc_vm_flag_bits(flags) |
|
.\" vm_flags |= calc_vm_prot_bits(prot, pkey) | calc_vm_flag_bits(flags) |
|
||||||
.\" mm->def_flags | VM_MAYREAD | VM_MAYWRITE | VM_MAYEXEC;
|
.\" mm->def_flags | VM_MAYREAD | VM_MAYWRITE | VM_MAYEXEC;
|
||||||
|
|
|
@ -90,7 +90,7 @@ is given with each operation below.
|
||||||
The
|
The
|
||||||
.I subcmd
|
.I subcmd
|
||||||
value is one of the following operations:
|
value is one of the following operations:
|
||||||
.TP 8
|
.TP
|
||||||
.B Q_QUOTAON
|
.B Q_QUOTAON
|
||||||
Turn on quotas for a filesystem.
|
Turn on quotas for a filesystem.
|
||||||
The
|
The
|
||||||
|
@ -138,7 +138,7 @@ operation.
|
||||||
.IP
|
.IP
|
||||||
This operation requires privilege
|
This operation requires privilege
|
||||||
.RB ( CAP_SYS_ADMIN ).
|
.RB ( CAP_SYS_ADMIN ).
|
||||||
.TP 8
|
.TP
|
||||||
.B Q_QUOTAOFF
|
.B Q_QUOTAOFF
|
||||||
Turn off quotas for a filesystem.
|
Turn off quotas for a filesystem.
|
||||||
The
|
The
|
||||||
|
@ -399,7 +399,7 @@ carry the information instead.
|
||||||
.PP
|
.PP
|
||||||
For XFS filesystems making use of the XFS Quota Manager (XQM),
|
For XFS filesystems making use of the XFS Quota Manager (XQM),
|
||||||
the above operations are bypassed and the following operations are used:
|
the above operations are bypassed and the following operations are used:
|
||||||
.TP 8
|
.TP
|
||||||
.B Q_XQUOTAON
|
.B Q_XQUOTAON
|
||||||
Turn on quotas for an XFS filesystem.
|
Turn on quotas for an XFS filesystem.
|
||||||
XFS provides the ability to turn on/off quota limit enforcement
|
XFS provides the ability to turn on/off quota limit enforcement
|
||||||
|
|
|
@ -64,7 +64,7 @@ The
|
||||||
.I return_code
|
.I return_code
|
||||||
argument stores the return code of the STHYI instruction,
|
argument stores the return code of the STHYI instruction,
|
||||||
using one of the following values:
|
using one of the following values:
|
||||||
.TP 8
|
.TP
|
||||||
0
|
0
|
||||||
Success.
|
Success.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -117,7 +117,7 @@ struct ipc_perm {
|
||||||
Valid values for
|
Valid values for
|
||||||
.I cmd
|
.I cmd
|
||||||
are:
|
are:
|
||||||
.TP 10
|
.TP
|
||||||
.B IPC_STAT
|
.B IPC_STAT
|
||||||
Copy information from the kernel data structure associated with
|
Copy information from the kernel data structure associated with
|
||||||
.I semid
|
.I semid
|
||||||
|
@ -359,7 +359,7 @@ indicating the error.
|
||||||
Otherwise, the system call returns a nonnegative value depending on
|
Otherwise, the system call returns a nonnegative value depending on
|
||||||
.I cmd
|
.I cmd
|
||||||
as follows:
|
as follows:
|
||||||
.TP 10
|
.TP
|
||||||
.B GETNCNT
|
.B GETNCNT
|
||||||
the value of
|
the value of
|
||||||
.BR semncnt .
|
.BR semncnt .
|
||||||
|
|
|
@ -106,7 +106,7 @@ struct ipc_perm {
|
||||||
Valid values for
|
Valid values for
|
||||||
.I cmd
|
.I cmd
|
||||||
are:
|
are:
|
||||||
.TP 10
|
.TP
|
||||||
.B IPC_STAT
|
.B IPC_STAT
|
||||||
Copy information from the kernel data structure associated with
|
Copy information from the kernel data structure associated with
|
||||||
.I shmid
|
.I shmid
|
||||||
|
@ -162,7 +162,7 @@ See also the description of
|
||||||
.I /proc/sys/kernel/shm_rmid_forced
|
.I /proc/sys/kernel/shm_rmid_forced
|
||||||
in
|
in
|
||||||
.BR proc (5).
|
.BR proc (5).
|
||||||
.TP 10
|
.TP
|
||||||
.BR IPC_INFO " (Linux-specific)"
|
.BR IPC_INFO " (Linux-specific)"
|
||||||
Return information about system-wide shared memory limits and
|
Return information about system-wide shared memory limits and
|
||||||
parameters in the structure pointed to by
|
parameters in the structure pointed to by
|
||||||
|
@ -259,7 +259,7 @@ to obtain the same information).
|
||||||
.PP
|
.PP
|
||||||
The caller can prevent or allow swapping of a shared
|
The caller can prevent or allow swapping of a shared
|
||||||
memory segment with the following \fIcmd\fP values:
|
memory segment with the following \fIcmd\fP values:
|
||||||
.TP 10
|
.T
|
||||||
.BR SHM_LOCK " (Linux-specific)"
|
.BR SHM_LOCK " (Linux-specific)"
|
||||||
Prevent swapping of the shared memory segment.
|
Prevent swapping of the shared memory segment.
|
||||||
The caller must fault in
|
The caller must fault in
|
||||||
|
|
|
@ -101,7 +101,7 @@ for
|
||||||
The value
|
The value
|
||||||
.I shmflg
|
.I shmflg
|
||||||
is composed of:
|
is composed of:
|
||||||
.TP 12
|
.TP
|
||||||
.B IPC_CREAT
|
.B IPC_CREAT
|
||||||
Create a new segment.
|
Create a new segment.
|
||||||
If this flag is not used, then
|
If this flag is not used, then
|
||||||
|
|
|
@ -155,7 +155,7 @@ value of
|
||||||
The value of
|
The value of
|
||||||
.I options
|
.I options
|
||||||
is an OR of zero or more of the following constants:
|
is an OR of zero or more of the following constants:
|
||||||
.TP 12
|
.TP
|
||||||
.B WNOHANG
|
.B WNOHANG
|
||||||
return immediately if no child has exited.
|
return immediately if no child has exited.
|
||||||
.TP
|
.TP
|
||||||
|
@ -286,7 +286,7 @@ is ignored.
|
||||||
The child state changes to wait for are specified by ORing
|
The child state changes to wait for are specified by ORing
|
||||||
one or more of the following flags in
|
one or more of the following flags in
|
||||||
.IR options :
|
.IR options :
|
||||||
.TP 12
|
.TP
|
||||||
.B WEXITED
|
.B WEXITED
|
||||||
Wait for children that have terminated.
|
Wait for children that have terminated.
|
||||||
.TP
|
.TP
|
||||||
|
@ -300,7 +300,7 @@ resumed by delivery of
|
||||||
.PP
|
.PP
|
||||||
The following flags may additionally be ORed in
|
The following flags may additionally be ORed in
|
||||||
.IR options :
|
.IR options :
|
||||||
.TP 12
|
.TP
|
||||||
.B WNOHANG
|
.B WNOHANG
|
||||||
As for
|
As for
|
||||||
.BR waitpid ().
|
.BR waitpid ().
|
||||||
|
@ -315,7 +315,7 @@ fills in the following fields of the
|
||||||
.I siginfo_t
|
.I siginfo_t
|
||||||
structure pointed to by
|
structure pointed to by
|
||||||
.IR infop :
|
.IR infop :
|
||||||
.TP 12
|
.TP
|
||||||
\fIsi_pid\fP
|
\fIsi_pid\fP
|
||||||
The process ID of the child.
|
The process ID of the child.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -93,7 +93,7 @@ described in this page.
|
||||||
.PP
|
.PP
|
||||||
The following macros are provided to operate on the CPU set
|
The following macros are provided to operate on the CPU set
|
||||||
.IR set :
|
.IR set :
|
||||||
.TP 17
|
.TP
|
||||||
.BR CPU_ZERO ()
|
.BR CPU_ZERO ()
|
||||||
Clears
|
Clears
|
||||||
.IR set ,
|
.IR set ,
|
||||||
|
@ -141,7 +141,7 @@ number that can be stored in
|
||||||
.IR cpu_set_t .
|
.IR cpu_set_t .
|
||||||
.PP
|
.PP
|
||||||
The following macros perform logical operations on CPU sets:
|
The following macros perform logical operations on CPU sets:
|
||||||
.TP 17
|
.TP
|
||||||
.BR CPU_AND ()
|
.BR CPU_AND ()
|
||||||
Store the intersection of the sets
|
Store the intersection of the sets
|
||||||
.I srcset1
|
.I srcset1
|
||||||
|
@ -184,7 +184,7 @@ defined by the standard
|
||||||
data type), glibc nowadays provides a set of macros to support this.
|
data type), glibc nowadays provides a set of macros to support this.
|
||||||
.PP
|
.PP
|
||||||
The following macros are used to allocate and deallocate CPU sets:
|
The following macros are used to allocate and deallocate CPU sets:
|
||||||
.TP 17
|
.TP
|
||||||
.BR CPU_ALLOC ()
|
.BR CPU_ALLOC ()
|
||||||
Allocate a CPU set large enough to hold CPUs
|
Allocate a CPU set large enough to hold CPUs
|
||||||
in the range 0 to
|
in the range 0 to
|
||||||
|
|
|
@ -67,7 +67,7 @@ struct aioinit {
|
||||||
The following fields are used in the
|
The following fields are used in the
|
||||||
.I aioinit
|
.I aioinit
|
||||||
structure:
|
structure:
|
||||||
.TP 15
|
.TP
|
||||||
.I aio_threads
|
.I aio_threads
|
||||||
This field specifies the maximum number of worker threads that
|
This field specifies the maximum number of worker threads that
|
||||||
may be used by the implementation.
|
may be used by the implementation.
|
||||||
|
|
|
@ -104,8 +104,7 @@ vector for the chaining.
|
||||||
It is updated to the next initialization
|
It is updated to the next initialization
|
||||||
vector upon return.
|
vector upon return.
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
.PD 0
|
.TP
|
||||||
.TP 20
|
|
||||||
.BR DESERR_NONE
|
.BR DESERR_NONE
|
||||||
No error.
|
No error.
|
||||||
.TP
|
.TP
|
||||||
|
@ -117,7 +116,6 @@ An error occurred in the hardware or driver.
|
||||||
.TP
|
.TP
|
||||||
.BR DESERR_BADPARAM
|
.BR DESERR_BADPARAM
|
||||||
Bad argument to routine.
|
Bad argument to routine.
|
||||||
.PD
|
|
||||||
.PP
|
.PP
|
||||||
Given a result status
|
Given a result status
|
||||||
.IR stat ,
|
.IR stat ,
|
||||||
|
|
|
@ -45,7 +45,7 @@ The
|
||||||
.I mode
|
.I mode
|
||||||
argument specifies the semantics of I/O on the stream,
|
argument specifies the semantics of I/O on the stream,
|
||||||
and is one of the following:
|
and is one of the following:
|
||||||
.TP 8
|
.TP
|
||||||
.I r
|
.I r
|
||||||
The stream is opened for reading.
|
The stream is opened for reading.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -183,7 +183,7 @@ argument specifies the new file offset depending on which
|
||||||
of the following three values is supplied in
|
of the following three values is supplied in
|
||||||
.IR whence :
|
.IR whence :
|
||||||
.RS
|
.RS
|
||||||
.TP 10
|
.TP
|
||||||
.B SEEK_SET
|
.B SEEK_SET
|
||||||
The stream offset should be set
|
The stream offset should be set
|
||||||
.I *offset
|
.I *offset
|
||||||
|
|
12
man3/fts.3
12
man3/fts.3
|
@ -142,7 +142,7 @@ typedef struct _ftsent {
|
||||||
.PP
|
.PP
|
||||||
These fields are defined as follows:
|
These fields are defined as follows:
|
||||||
.\" .Bl -tag -width "fts_namelen"
|
.\" .Bl -tag -width "fts_namelen"
|
||||||
.TP 12
|
.TP
|
||||||
.IR fts_info
|
.IR fts_info
|
||||||
One of the following values describing the returned
|
One of the following values describing the returned
|
||||||
.I FTSENT
|
.I FTSENT
|
||||||
|
@ -154,8 +154,8 @@ all of these
|
||||||
entries are terminal, that is, they will not be revisited, nor will any
|
entries are terminal, that is, they will not be revisited, nor will any
|
||||||
of their descendants be visited.
|
of their descendants be visited.
|
||||||
.\" .Bl -tag -width FTS_DEFAULT
|
.\" .Bl -tag -width FTS_DEFAULT
|
||||||
.RS 12
|
.RS
|
||||||
.TP 12
|
.TP
|
||||||
.BR FTS_D
|
.BR FTS_D
|
||||||
A directory being visited in preorder.
|
A directory being visited in preorder.
|
||||||
.TP
|
.TP
|
||||||
|
@ -400,7 +400,7 @@ must be specified.
|
||||||
The options are selected by ORing
|
The options are selected by ORing
|
||||||
the following values:
|
the following values:
|
||||||
.\" .Bl -tag -width "FTS_PHYSICAL"
|
.\" .Bl -tag -width "FTS_PHYSICAL"
|
||||||
.TP 14
|
.TP
|
||||||
.BR FTS_COMFOLLOW
|
.BR FTS_COMFOLLOW
|
||||||
This option causes any symbolic link specified as a root path to be
|
This option causes any symbolic link specified as a root path to be
|
||||||
followed immediately whether or not
|
followed immediately whether or not
|
||||||
|
@ -647,7 +647,7 @@ The
|
||||||
.I instr
|
.I instr
|
||||||
argument is either zero or the following value:
|
argument is either zero or the following value:
|
||||||
.\" .Bl -tag -width FTS_NAMEONLY
|
.\" .Bl -tag -width FTS_NAMEONLY
|
||||||
.TP 13
|
.TP
|
||||||
.BR FTS_NAMEONLY
|
.BR FTS_NAMEONLY
|
||||||
Only the names of the files are needed.
|
Only the names of the files are needed.
|
||||||
The contents of all the fields in the returned linked list of structures
|
The contents of all the fields in the returned linked list of structures
|
||||||
|
@ -674,7 +674,7 @@ The
|
||||||
.I instr
|
.I instr
|
||||||
argument is either 0 (meaning "do nothing") or one of the following values:
|
argument is either 0 (meaning "do nothing") or one of the following values:
|
||||||
.\" .Bl -tag -width FTS_PHYSICAL
|
.\" .Bl -tag -width FTS_PHYSICAL
|
||||||
.TP 13
|
.TP
|
||||||
.BR FTS_AGAIN
|
.BR FTS_AGAIN
|
||||||
Revisit the file; any file type may be revisited.
|
Revisit the file; any file type may be revisited.
|
||||||
The next call to
|
The next call to
|
||||||
|
|
|
@ -138,7 +138,7 @@ and
|
||||||
specify criteria that limit the set of socket addresses returned by
|
specify criteria that limit the set of socket addresses returned by
|
||||||
.BR getaddrinfo (),
|
.BR getaddrinfo (),
|
||||||
as follows:
|
as follows:
|
||||||
.TP 12
|
.TP
|
||||||
.I ai_family
|
.I ai_family
|
||||||
This field specifies the desired address family for the returned addresses.
|
This field specifies the desired address family for the returned addresses.
|
||||||
Valid values for this field include
|
Valid values for this field include
|
||||||
|
|
|
@ -45,8 +45,7 @@ struct rpcent {
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
The members of this structure are:
|
The members of this structure are:
|
||||||
.RS 4
|
.TP
|
||||||
.TP 12
|
|
||||||
.I r_name
|
.I r_name
|
||||||
The name of the server for this RPC program.
|
The name of the server for this RPC program.
|
||||||
.TP
|
.TP
|
||||||
|
@ -55,7 +54,6 @@ A NULL-terminated list of alternate names for the RPC program.
|
||||||
.TP
|
.TP
|
||||||
.I r_number
|
.I r_number
|
||||||
The RPC program number for this service.
|
The RPC program number for this service.
|
||||||
.RE
|
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.BR getrpcent ()
|
.BR getrpcent ()
|
||||||
|
|
|
@ -42,7 +42,7 @@ function initiates the list of I/O operations described by the array
|
||||||
The
|
The
|
||||||
.I mode
|
.I mode
|
||||||
operation has one of the following values:
|
operation has one of the following values:
|
||||||
.TP 12
|
.TP
|
||||||
.B LIO_WAIT
|
.B LIO_WAIT
|
||||||
The call blocks until all operations are complete.
|
The call blocks until all operations are complete.
|
||||||
The
|
The
|
||||||
|
@ -80,7 +80,7 @@ In each control block in
|
||||||
the
|
the
|
||||||
.I aio_lio_opcode
|
.I aio_lio_opcode
|
||||||
field specifies the I/O operation to be initiated, as follows:
|
field specifies the I/O operation to be initiated, as follows:
|
||||||
.TP 10
|
.TP
|
||||||
.BR LIO_READ
|
.BR LIO_READ
|
||||||
Initiate a read operation.
|
Initiate a read operation.
|
||||||
The operation is queued as for a call to
|
The operation is queued as for a call to
|
||||||
|
|
|
@ -271,7 +271,7 @@ to be used during those actions.
|
||||||
The effects of the flags that may be specified in
|
The effects of the flags that may be specified in
|
||||||
.IR spawn-flags
|
.IR spawn-flags
|
||||||
are as follows:
|
are as follows:
|
||||||
.TP 8
|
.TP
|
||||||
.B POSIX_SPAWN_SETSIGMASK
|
.B POSIX_SPAWN_SETSIGMASK
|
||||||
Set the signal mask to the signal set specified in the
|
Set the signal mask to the signal set specified in the
|
||||||
.I spawn-sigmask
|
.I spawn-sigmask
|
||||||
|
|
|
@ -78,7 +78,7 @@ is a bit mask created by ORing together exactly one of
|
||||||
or
|
or
|
||||||
.B O_RDWR
|
.B O_RDWR
|
||||||
and any of the other flags listed here:
|
and any of the other flags listed here:
|
||||||
.TP 1.1i
|
.TP
|
||||||
.B O_RDONLY
|
.B O_RDONLY
|
||||||
Open the object for read access.
|
Open the object for read access.
|
||||||
A shared memory object opened in this way can be
|
A shared memory object opened in this way can be
|
||||||
|
|
26
man4/st.4
26
man4/st.4
|
@ -257,7 +257,7 @@ struct mtop {
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
Magnetic Tape operations for normal tape use:
|
Magnetic Tape operations for normal tape use:
|
||||||
.TP 14
|
.TP
|
||||||
.B MTBSF
|
.B MTBSF
|
||||||
Backward space over
|
Backward space over
|
||||||
.I mt_count
|
.I mt_count
|
||||||
|
@ -418,7 +418,7 @@ Write
|
||||||
setmarks.
|
setmarks.
|
||||||
.PP
|
.PP
|
||||||
Magnetic Tape operations for setting of device options (by the superuser):
|
Magnetic Tape operations for setting of device options (by the superuser):
|
||||||
.TP 8
|
.TP
|
||||||
.B MTSETDRVBUFFER
|
.B MTSETDRVBUFFER
|
||||||
Set various drive and driver options according to bits encoded in
|
Set various drive and driver options according to bits encoded in
|
||||||
.IR mt_count .
|
.IR mt_count .
|
||||||
|
@ -706,7 +706,8 @@ struct mtget {
|
||||||
};
|
};
|
||||||
.EE
|
.EE
|
||||||
.in
|
.in
|
||||||
.IP \fImt_type\fP 11
|
.TP
|
||||||
|
\fImt_type\fP
|
||||||
The header file defines many values for
|
The header file defines many values for
|
||||||
.IR mt_type ,
|
.IR mt_type ,
|
||||||
but the current driver reports only the generic types
|
but the current driver reports only the generic types
|
||||||
|
@ -715,9 +716,11 @@ but the current driver reports only the generic types
|
||||||
and
|
and
|
||||||
.B MT_ISSCSI2
|
.B MT_ISSCSI2
|
||||||
(Generic SCSI-2 tape).
|
(Generic SCSI-2 tape).
|
||||||
.IP \fImt_resid\fP
|
.TP
|
||||||
|
\fImt_resid\fP
|
||||||
contains the current tape partition number.
|
contains the current tape partition number.
|
||||||
.IP \fImt_dsreg\fP
|
.TP
|
||||||
|
\fImt_dsreg\fP
|
||||||
reports the drive's current settings for block size (in the low 24
|
reports the drive's current settings for block size (in the low 24
|
||||||
bits) and density (in the high 8 bits).
|
bits) and density (in the high 8 bits).
|
||||||
These fields are defined by
|
These fields are defined by
|
||||||
|
@ -726,7 +729,8 @@ These fields are defined by
|
||||||
.BR MT_ST_DENSITY_SHIFT ,
|
.BR MT_ST_DENSITY_SHIFT ,
|
||||||
and
|
and
|
||||||
.BR MT_ST_DENSITY_MASK .
|
.BR MT_ST_DENSITY_MASK .
|
||||||
.IP \fImt_gstat\fP
|
.TP
|
||||||
|
\fImt_gstat\fP
|
||||||
reports generic (device independent) status information.
|
reports generic (device independent) status information.
|
||||||
The header file defines macros for testing these status bits:
|
The header file defines macros for testing these status bits:
|
||||||
.RS
|
.RS
|
||||||
|
@ -784,7 +788,8 @@ the drive is set not to buffer data.
|
||||||
The drive has requested cleaning.
|
The drive has requested cleaning.
|
||||||
Implemented in kernels since 2.4.19 and 2.5.43.
|
Implemented in kernels since 2.4.19 and 2.5.43.
|
||||||
.RE
|
.RE
|
||||||
.IP \fImt_erreg\fP
|
.TP
|
||||||
|
\fImt_erreg\fP
|
||||||
The only field defined in
|
The only field defined in
|
||||||
.I mt_erreg
|
.I mt_erreg
|
||||||
is the recovered error count in the low 16 bits (as defined by
|
is the recovered error count in the low 16 bits (as defined by
|
||||||
|
@ -794,13 +799,15 @@ and
|
||||||
Due to inconsistencies in the way drives report recovered errors, this
|
Due to inconsistencies in the way drives report recovered errors, this
|
||||||
count is often not maintained (most drives do not by default report
|
count is often not maintained (most drives do not by default report
|
||||||
soft errors but this can be changed with a SCSI MODE SELECT command).
|
soft errors but this can be changed with a SCSI MODE SELECT command).
|
||||||
.IP \fImt_fileno\fP
|
.TP
|
||||||
|
\fImt_fileno\fP
|
||||||
reports the current file number (zero-based).
|
reports the current file number (zero-based).
|
||||||
This value is set to \-1 when the file number is unknown (e.g., after
|
This value is set to \-1 when the file number is unknown (e.g., after
|
||||||
.BR MTBSS
|
.BR MTBSS
|
||||||
or
|
or
|
||||||
.BR MTSEEK ).
|
.BR MTSEEK ).
|
||||||
.IP \fImt_blkno\fP
|
.TP
|
||||||
|
\fImt_blkno\fP
|
||||||
reports the block number (zero-based) within the current file.
|
reports the block number (zero-based) within the current file.
|
||||||
This value is set to \-1 when the block number is unknown (e.g., after
|
This value is set to \-1 when the block number is unknown (e.g., after
|
||||||
.BR MTBSF ,
|
.BR MTBSF ,
|
||||||
|
@ -831,7 +838,6 @@ struct mtpos {
|
||||||
.EE
|
.EE
|
||||||
.in
|
.in
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
.TP 14
|
|
||||||
.TP
|
.TP
|
||||||
.B EACCES
|
.B EACCES
|
||||||
An attempt was made to write or erase a write-protected tape.
|
An attempt was made to write or erase a write-protected tape.
|
||||||
|
|
20
man5/elf.5
20
man5/elf.5
|
@ -164,7 +164,7 @@ typedef struct {
|
||||||
.PP
|
.PP
|
||||||
The fields have the following meanings:
|
The fields have the following meanings:
|
||||||
.\"
|
.\"
|
||||||
.nr l1_indent 10
|
.nr l1_indent 7
|
||||||
.\"
|
.\"
|
||||||
.TP \n[l1_indent]
|
.TP \n[l1_indent]
|
||||||
.IR e_ident
|
.IR e_ident
|
||||||
|
@ -177,7 +177,7 @@ and may contain values which start with the prefix
|
||||||
.BR ELF .
|
.BR ELF .
|
||||||
The following macros are defined:
|
The following macros are defined:
|
||||||
.RS
|
.RS
|
||||||
.TP 9
|
.TP
|
||||||
.BR EI_MAG0
|
.BR EI_MAG0
|
||||||
The first byte of the magic number.
|
The first byte of the magic number.
|
||||||
It must be filled with
|
It must be filled with
|
||||||
|
@ -554,7 +554,7 @@ Otherwise, the
|
||||||
.IR sh_info
|
.IR sh_info
|
||||||
member of the initial entry contains the value zero.
|
member of the initial entry contains the value zero.
|
||||||
.RS \n[l1_indent]
|
.RS \n[l1_indent]
|
||||||
.TP 9
|
.TP
|
||||||
.BR PN_XNUM
|
.BR PN_XNUM
|
||||||
This is defined as 0xffff, the largest number
|
This is defined as 0xffff, the largest number
|
||||||
.IR e_phnum
|
.IR e_phnum
|
||||||
|
@ -669,12 +669,12 @@ The main difference between the 32-bit and the 64-bit program header lies
|
||||||
in the location of the
|
in the location of the
|
||||||
.IR p_flags
|
.IR p_flags
|
||||||
member in the total struct.
|
member in the total struct.
|
||||||
.TP 10
|
.TP
|
||||||
.IR p_type
|
.IR p_type
|
||||||
This member of the structure indicates what kind of segment this array
|
This member of the structure indicates what kind of segment this array
|
||||||
element describes or how to interpret the array element's information.
|
element describes or how to interpret the array element's information.
|
||||||
.RS 10
|
.RS 10
|
||||||
.TP 12
|
.TP
|
||||||
.BR PT_NULL
|
.BR PT_NULL
|
||||||
The array element is unused and the other members' values are undefined.
|
The array element is unused and the other members' values are undefined.
|
||||||
This lets the program header have ignored entries.
|
This lets the program header have ignored entries.
|
||||||
|
@ -767,7 +767,7 @@ It may be zero.
|
||||||
.TP
|
.TP
|
||||||
.IR p_flags
|
.IR p_flags
|
||||||
This member holds a bit mask of flags relevant to the segment:
|
This member holds a bit mask of flags relevant to the segment:
|
||||||
.RS \n[l1_indent]
|
.RS
|
||||||
.TP
|
.TP
|
||||||
.PD 0
|
.PD 0
|
||||||
.BR PF_X
|
.BR PF_X
|
||||||
|
@ -923,7 +923,7 @@ a null-terminated string.
|
||||||
.IR sh_type
|
.IR sh_type
|
||||||
This member categorizes the section's contents and semantics.
|
This member categorizes the section's contents and semantics.
|
||||||
.RS \n[l1_indent]
|
.RS \n[l1_indent]
|
||||||
.TP 15
|
.TP
|
||||||
.BR SHT_NULL
|
.BR SHT_NULL
|
||||||
This value marks the section header as inactive.
|
This value marks the section header as inactive.
|
||||||
It does not
|
It does not
|
||||||
|
@ -1034,7 +1034,7 @@ Otherwise, the attribute is
|
||||||
or does not apply.
|
or does not apply.
|
||||||
Undefined attributes are set to zero.
|
Undefined attributes are set to zero.
|
||||||
.RS \n[l1_indent]
|
.RS \n[l1_indent]
|
||||||
.TP 15
|
.TP
|
||||||
.BR SHF_WRITE
|
.BR SHF_WRITE
|
||||||
This section contains data that should be writable during process
|
This section contains data that should be writable during process
|
||||||
execution.
|
execution.
|
||||||
|
@ -1491,7 +1491,7 @@ has no size or an unknown size.
|
||||||
.IR st_info
|
.IR st_info
|
||||||
This member specifies the symbol's type and binding attributes:
|
This member specifies the symbol's type and binding attributes:
|
||||||
.RS \n[l1_indent]
|
.RS \n[l1_indent]
|
||||||
.TP 12
|
.TP
|
||||||
.BR STT_NOTYPE
|
.BR STT_NOTYPE
|
||||||
The symbol's type is not defined.
|
The symbol's type is not defined.
|
||||||
.TP
|
.TP
|
||||||
|
@ -1569,7 +1569,7 @@ value.
|
||||||
.IR st_other
|
.IR st_other
|
||||||
This member defines the symbol visibility.
|
This member defines the symbol visibility.
|
||||||
.RS \n[l1_indent]
|
.RS \n[l1_indent]
|
||||||
.TP 16
|
.TP
|
||||||
.PD 0
|
.PD 0
|
||||||
.BR STV_DEFAULT
|
.BR STV_DEFAULT
|
||||||
Default symbol visibility rules.
|
Default symbol visibility rules.
|
||||||
|
|
|
@ -39,7 +39,7 @@ group_name:password:GID:user_list
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
The fields are as follows:
|
The fields are as follows:
|
||||||
.TP 12
|
.TP
|
||||||
.I group_name
|
.I group_name
|
||||||
the name of the group.
|
the name of the group.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -1321,7 +1321,7 @@ Offset field in the ELF program headers
|
||||||
.RI ( "readelf\ \-l" ).
|
.RI ( "readelf\ \-l" ).
|
||||||
.IP
|
.IP
|
||||||
There are additional helpful pseudo-paths:
|
There are additional helpful pseudo-paths:
|
||||||
.RS 12
|
.RS
|
||||||
.TP
|
.TP
|
||||||
.IR [stack]
|
.IR [stack]
|
||||||
The initial process's (also known as the main thread's) stack.
|
The initial process's (also known as the main thread's) stack.
|
||||||
|
@ -1720,7 +1720,7 @@ This file shows the mapping of each of the process's virtual pages
|
||||||
into physical page frames or swap area.
|
into physical page frames or swap area.
|
||||||
It contains one 64-bit value for each virtual page,
|
It contains one 64-bit value for each virtual page,
|
||||||
with the bits set as follows:
|
with the bits set as follows:
|
||||||
.RS 12
|
.RS
|
||||||
.TP
|
.TP
|
||||||
63
|
63
|
||||||
If set, the page is present in RAM.
|
If set, the page is present in RAM.
|
||||||
|
|
|
@ -97,7 +97,7 @@ Each line describes one service, and is of the form:
|
||||||
\f2service-name\ \ \ port\f3/\f2protocol\ \ \ \f1[\f2aliases ...\f1]
|
\f2service-name\ \ \ port\f3/\f2protocol\ \ \ \f1[\f2aliases ...\f1]
|
||||||
.TP
|
.TP
|
||||||
where:
|
where:
|
||||||
.TP 10
|
.TP
|
||||||
.I service-name
|
.I service-name
|
||||||
is the friendly name the service is known by and looked up under.
|
is the friendly name the service is known by and looked up under.
|
||||||
It is case sensitive.
|
It is case sensitive.
|
||||||
|
|
|
@ -36,7 +36,7 @@ by delivery of a signal, by instantiation of a thread,
|
||||||
or no notification at all.
|
or no notification at all.
|
||||||
.PP
|
.PP
|
||||||
The POSIX AIO interface consists of the following functions:
|
The POSIX AIO interface consists of the following functions:
|
||||||
.TP 16
|
.TP
|
||||||
.BR aio_read (3)
|
.BR aio_read (3)
|
||||||
Enqueue a read request.
|
Enqueue a read request.
|
||||||
This is the asynchronous analog of
|
This is the asynchronous analog of
|
||||||
|
@ -104,7 +104,7 @@ enum { LIO_READ, LIO_WRITE, LIO_NOP };
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
The fields of this structure are as follows:
|
The fields of this structure are as follows:
|
||||||
.TP 16
|
.TP
|
||||||
.I aio_fildes
|
.I aio_fildes
|
||||||
The file descriptor on which the I/O operation is to be performed.
|
The file descriptor on which the I/O operation is to be performed.
|
||||||
.TP
|
.TP
|
||||||
|
@ -147,7 +147,7 @@ The type of operation to be performed; used only for
|
||||||
.PP
|
.PP
|
||||||
In addition to the standard functions listed above,
|
In addition to the standard functions listed above,
|
||||||
the GNU C library provides the following extension to the POSIX AIO API:
|
the GNU C library provides the following extension to the POSIX AIO API:
|
||||||
.TP 16
|
.TP
|
||||||
.BR aio_init (3)
|
.BR aio_init (3)
|
||||||
Set parameters for tuning the behavior of the glibc POSIX AIO implementation.
|
Set parameters for tuning the behavior of the glibc POSIX AIO implementation.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
|
|
|
@ -214,7 +214,7 @@ _XOPEN_SOURCE >= 700
|
||||||
.\" would make for a complicated description.
|
.\" would make for a complicated description.
|
||||||
.PP
|
.PP
|
||||||
Linux glibc understands the following feature test macros:
|
Linux glibc understands the following feature test macros:
|
||||||
.TP 8
|
.TP
|
||||||
.B __STRICT_ANSI__
|
.B __STRICT_ANSI__
|
||||||
ISO Standard C.
|
ISO Standard C.
|
||||||
This macro is implicitly defined by
|
This macro is implicitly defined by
|
||||||
|
|
|
@ -672,7 +672,7 @@ The optional
|
||||||
field provides some further information about the key.
|
field provides some further information about the key.
|
||||||
The information that appears here depends on the key type, as follows:
|
The information that appears here depends on the key type, as follows:
|
||||||
.RS
|
.RS
|
||||||
.TP 4
|
.TP
|
||||||
.IR """user""" " and " """logon"""
|
.IR """user""" " and " """logon"""
|
||||||
The size in bytes of the key payload (expressed in decimal).
|
The size in bytes of the key payload (expressed in decimal).
|
||||||
.TP
|
.TP
|
||||||
|
@ -705,7 +705,7 @@ the description field has the form shown in the following example:
|
||||||
.IP
|
.IP
|
||||||
The three subfields are as follows:
|
The three subfields are as follows:
|
||||||
.RS
|
.RS
|
||||||
.TP 5
|
.TP
|
||||||
.I key
|
.I key
|
||||||
The hexadecimal ID of the key being instantiated in the requesting program.
|
The hexadecimal ID of the key being instantiated in the requesting program.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -48,7 +48,7 @@ for authors writing man pages for other projects.
|
||||||
.SS Sections of the manual pages
|
.SS Sections of the manual pages
|
||||||
.PP
|
.PP
|
||||||
The manual Sections are traditionally defined as follows:
|
The manual Sections are traditionally defined as follows:
|
||||||
.TP 10
|
.TP
|
||||||
.B 1 User commands (Programs)
|
.B 1 User commands (Programs)
|
||||||
Those commands that can be executed by the user from within
|
Those commands that can be executed by the user from within
|
||||||
a shell.
|
a shell.
|
||||||
|
@ -213,7 +213,7 @@ those sections.
|
||||||
.PP
|
.PP
|
||||||
The following list elaborates on the contents of each of
|
The following list elaborates on the contents of each of
|
||||||
the above sections.
|
the above sections.
|
||||||
.TP 14
|
.TP
|
||||||
.B NAME
|
.B NAME
|
||||||
The name of this manual page.
|
The name of this manual page.
|
||||||
.IP
|
.IP
|
||||||
|
|
|
@ -71,7 +71,7 @@ The
|
||||||
.I sigev_notify
|
.I sigev_notify
|
||||||
field specifies how notification is to be performed.
|
field specifies how notification is to be performed.
|
||||||
This field can have one of the following values:
|
This field can have one of the following values:
|
||||||
.TP 8
|
.TP
|
||||||
.BR SIGEV_NONE
|
.BR SIGEV_NONE
|
||||||
A "null" notification: don't do anything when the event occurs.
|
A "null" notification: don't do anything when the event occurs.
|
||||||
.TP
|
.TP
|
||||||
|
@ -85,7 +85,7 @@ If the signal is caught with a signal handler that was registered using the
|
||||||
flag, then the following fields are set in the
|
flag, then the following fields are set in the
|
||||||
.I siginfo_t
|
.I siginfo_t
|
||||||
structure that is passed as the second argument of the handler:
|
structure that is passed as the second argument of the handler:
|
||||||
.RS 8
|
.RS
|
||||||
.TP 10
|
.TP 10
|
||||||
.I si_code
|
.I si_code
|
||||||
This field is set to a value that depends on the API
|
This field is set to a value that depends on the API
|
||||||
|
|
|
@ -642,7 +642,7 @@ available memory.
|
||||||
for this, which is limited to around 900 megabytes on 32-bit systems.
|
for this, which is limited to around 900 megabytes on 32-bit systems.
|
||||||
64-bit systems do not suffer this limitation.)
|
64-bit systems do not suffer this limitation.)
|
||||||
.RS
|
.RS
|
||||||
.TP 10
|
.TP
|
||||||
.I low
|
.I low
|
||||||
TCP doesn't regulate its memory allocation when the number
|
TCP doesn't regulate its memory allocation when the number
|
||||||
of pages it has allocated globally is below this number.
|
of pages it has allocated globally is below this number.
|
||||||
|
@ -740,7 +740,7 @@ TCP dynamically adjusts the size of the
|
||||||
receive buffer from the defaults listed below, in the range
|
receive buffer from the defaults listed below, in the range
|
||||||
of these values, depending on memory available in the system.
|
of these values, depending on memory available in the system.
|
||||||
.RS
|
.RS
|
||||||
.TP 10
|
.TP
|
||||||
.I min
|
.I min
|
||||||
minimum size of the receive buffer used by each TCP socket.
|
minimum size of the receive buffer used by each TCP socket.
|
||||||
The default value is the system page size.
|
The default value is the system page size.
|
||||||
|
@ -933,7 +933,7 @@ TCP dynamically adjusts the size of the send buffer from the
|
||||||
default values listed below, in the range of these values,
|
default values listed below, in the range of these values,
|
||||||
depending on memory available.
|
depending on memory available.
|
||||||
.RS
|
.RS
|
||||||
.TP 10
|
.TP
|
||||||
.I min
|
.I min
|
||||||
Minimum size of the send buffer used by each TCP socket.
|
Minimum size of the send buffer used by each TCP socket.
|
||||||
The default value is the system page size.
|
The default value is the system page size.
|
||||||
|
|
|
@ -142,7 +142,7 @@ System-wide UDP parameter settings can be accessed by files in the directory
|
||||||
This is a vector of three integers governing the number
|
This is a vector of three integers governing the number
|
||||||
of pages allowed for queueing by all UDP sockets.
|
of pages allowed for queueing by all UDP sockets.
|
||||||
.RS
|
.RS
|
||||||
.TP 10
|
.TP
|
||||||
.I min
|
.I min
|
||||||
Below this number of pages, UDP is not bothered about its
|
Below this number of pages, UDP is not bothered about its
|
||||||
memory appetite.
|
memory appetite.
|
||||||
|
|
Loading…
Reference in New Issue