LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

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:
Michael Kerrisk 2020-02-19 14:22:55 +01:00
parent e41f05af22
commit 0019177eac
39 changed files with 89 additions and 87 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
man1/getent.1
View File

@ -376,7 +376,7 @@ Print the version number, license, and disclaimer of warranty for
One of the following exit values can be returned by
.BR getent :
.RS 3
.TP 10
.TP
.B 0
Command completed successfully.
.TP

2
man1/localedef.1
View File

@ -290,7 +290,7 @@ Print the version number, license, and disclaimer of warranty for
One of the following exit values can be returned by
.BR localedef :
.RS 3
.TP 10
.TP
.B 0
Command completed successfully.
.TP

2
man2/clock_nanosleep.2
View File

@ -77,7 +77,7 @@ The
argument specifies the clock against which the sleep interval
is to be measured.
This argument can have one of the following values:
.TP 17
.TP
.BR CLOCK_REALTIME
A settable system-wide real-time clock.
.TP

4
man2/fcntl.2
View File

@ -1229,7 +1229,7 @@ the following bits:
.PP
.RS
.PD 0
.TP 12
.TP
.B DN_ACCESS
A file was accessed
.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.
.SH RETURN VALUE
For a successful call, the return value depends on the operation:
.TP 0.9i
.TP
.B F_DUPFD
The new file descriptor.
.TP

2
man2/getitimer.2
View File

@ -34,7 +34,7 @@ Three types of timers\(emspecified via the
argument\(emare provided,
each of which counts against a different clock and
generates a different signal on timer expiration:
.TP 1.5i
.TP
.B ITIMER_REAL
This timer counts down in real (i.e., wall clock) time.
At each expiration, a

2
man2/getsockopt.2
View File

@ -137,7 +137,7 @@ Netfilter allows the programmer
to define custom socket options with associated handlers; for such
options, the return value on success is the value returned by the handler.
.SH ERRORS
.TP 10
.TP
.B EBADF
The argument
.I sockfd

2
man2/inotify_init.2
View File

@ -53,7 +53,7 @@ is the same as
The following values can be bitwise ORed in
.IR flags
to obtain different behavior:
.TP 12
.TP
.B IN_NONBLOCK
Set the
.BR O_NONBLOCK

2
man2/ioctl.2
View File

@ -92,7 +92,7 @@ On error, \-1 is returned, and
.I errno
is set appropriately.
.SH ERRORS
.TP 0.7i
.TP
.B EBADF
.I fd
is not a valid file descriptor.

2
man2/mlock.2
View File

@ -120,7 +120,7 @@ The
.I flags
argument is constructed as the bitwise OR of one or more of the
following constants:
.TP 1.2i
.TP
.B MCL_CURRENT
Lock all pages which are currently mapped into the address space of
the process.

4
man2/mprotect.2
View File

@ -61,7 +61,7 @@ signal for the process.
is a combination of the following access flags:
.B PROT_NONE
or a bitwise-or of the other values in the following list:
.TP 1.1i
.TP
.B PROT_NONE
The memory cannot be accessed at all.
.TP
@ -95,7 +95,7 @@ and it is available on POWER 7 or PowerPC A2, for example).
Additionally (since Linux 2.6.0),
.I prot
can have one of the following flags set:
.TP 1.1i
.TP
.\" mm/mmap.c:
.\" vm_flags |= calc_vm_prot_bits(prot, pkey) | calc_vm_flag_bits(flags) |
.\" mm->def_flags | VM_MAYREAD | VM_MAYWRITE | VM_MAYEXEC;

6
man2/quotactl.2
View File

@ -90,7 +90,7 @@ is given with each operation below.
The
.I subcmd
value is one of the following operations:
.TP 8
.TP
.B Q_QUOTAON
Turn on quotas for a filesystem.
The
@ -138,7 +138,7 @@ operation.
.IP
This operation requires privilege
.RB ( CAP_SYS_ADMIN ).
.TP 8
.TP
.B Q_QUOTAOFF
Turn off quotas for a filesystem.
The
@ -399,7 +399,7 @@ carry the information instead.
.PP
For XFS filesystems making use of the XFS Quota Manager (XQM),
the above operations are bypassed and the following operations are used:
.TP 8
.TP
.B Q_XQUOTAON
Turn on quotas for an XFS filesystem.
XFS provides the ability to turn on/off quota limit enforcement

2
man2/s390_sthyi.2
View File

@ -64,7 +64,7 @@ The
.I return_code
argument stores the return code of the STHYI instruction,
using one of the following values:
.TP 8
.TP
0
Success.
.TP

4
man2/semctl.2
View File

@ -117,7 +117,7 @@ struct ipc_perm {
Valid values for
.I cmd
are:
.TP 10
.TP
.B IPC_STAT
Copy information from the kernel data structure associated with
.I semid
@ -359,7 +359,7 @@ indicating the error.
Otherwise, the system call returns a nonnegative value depending on
.I cmd
as follows:
.TP 10
.TP
.B GETNCNT
the value of
.BR semncnt .

6
man2/shmctl.2
View File

@ -106,7 +106,7 @@ struct ipc_perm {
Valid values for
.I cmd
are:
.TP 10
.TP
.B IPC_STAT
Copy information from the kernel data structure associated with
.I shmid
@ -162,7 +162,7 @@ See also the description of
.I /proc/sys/kernel/shm_rmid_forced
in
.BR proc (5).
.TP 10
.TP
.BR IPC_INFO " (Linux-specific)"
Return information about system-wide shared memory limits and
parameters in the structure pointed to by
@ -259,7 +259,7 @@ to obtain the same information).
.PP
The caller can prevent or allow swapping of a shared
memory segment with the following \fIcmd\fP values:
.TP 10
.T
.BR SHM_LOCK " (Linux-specific)"
Prevent swapping of the shared memory segment.
The caller must fault in

2
man2/shmget.2
View File

@ -101,7 +101,7 @@ for
The value
.I shmflg
is composed of:
.TP 12
.TP
.B IPC_CREAT
Create a new segment.
If this flag is not used, then

8
man2/wait.2
View File

@ -155,7 +155,7 @@ value of
The value of
.I options
is an OR of zero or more of the following constants:
.TP 12
.TP
.B WNOHANG
return immediately if no child has exited.
.TP
@ -286,7 +286,7 @@ is ignored.
The child state changes to wait for are specified by ORing
one or more of the following flags in
.IR options :
.TP 12
.TP
.B WEXITED
Wait for children that have terminated.
.TP
@ -300,7 +300,7 @@ resumed by delivery of
.PP
The following flags may additionally be ORed in
.IR options :
.TP 12
.TP
.B WNOHANG
As for
.BR waitpid ().
@ -315,7 +315,7 @@ fills in the following fields of the
.I siginfo_t
structure pointed to by
.IR infop :
.TP 12
.TP
\fIsi_pid\fP
The process ID of the child.
.TP

6
man3/CPU_SET.3
View File

@ -93,7 +93,7 @@ described in this page.
.PP
The following macros are provided to operate on the CPU set
.IR set :
.TP 17
.TP
.BR CPU_ZERO ()
Clears
.IR set ,
@ -141,7 +141,7 @@ number that can be stored in
.IR cpu_set_t .
.PP
The following macros perform logical operations on CPU sets:
.TP 17
.TP
.BR CPU_AND ()
Store the intersection of the sets
.I srcset1
@ -184,7 +184,7 @@ defined by the standard
data type), glibc nowadays provides a set of macros to support this.
.PP
The following macros are used to allocate and deallocate CPU sets:
.TP 17
.TP
.BR CPU_ALLOC ()
Allocate a CPU set large enough to hold CPUs
in the range 0 to

2
man3/aio_init.3
View File

@ -67,7 +67,7 @@ struct aioinit {
The following fields are used in the
.I aioinit
structure:
.TP 15
.TP
.I aio_threads
This field specifies the maximum number of worker threads that
may be used by the implementation.

4
man3/des_crypt.3
View File

@ -104,8 +104,7 @@ vector for the chaining.
It is updated to the next initialization
vector upon return.
.SH RETURN VALUE
.PD 0
.TP 20
.TP
.BR DESERR_NONE
No error.
.TP
@ -117,7 +116,6 @@ An error occurred in the hardware or driver.
.TP
.BR DESERR_BADPARAM
Bad argument to routine.
.PD
.PP
Given a result status
.IR stat ,

2
man3/fmemopen.3
View File

@ -45,7 +45,7 @@ The
.I mode
argument specifies the semantics of I/O on the stream,
and is one of the following:
.TP 8
.TP
.I r
The stream is opened for reading.
.TP

2
man3/fopencookie.3
View File

@ -183,7 +183,7 @@ argument specifies the new file offset depending on which
of the following three values is supplied in
.IR whence :
.RS
.TP 10
.TP
.B SEEK_SET
The stream offset should be set
.I *offset

12
man3/fts.3
View File

@ -142,7 +142,7 @@ typedef struct _ftsent {
.PP
These fields are defined as follows:
.\" .Bl -tag -width "fts_namelen"
.TP 12
.TP
.IR fts_info
One of the following values describing the returned
.I FTSENT
@ -154,8 +154,8 @@ all of these
entries are terminal, that is, they will not be revisited, nor will any
of their descendants be visited.
.\" .Bl -tag -width FTS_DEFAULT
.RS 12
.TP 12
.RS
.TP
.BR FTS_D
A directory being visited in preorder.
.TP
@ -400,7 +400,7 @@ must be specified.
The options are selected by ORing
the following values:
.\" .Bl -tag -width "FTS_PHYSICAL"
.TP 14
.TP
.BR FTS_COMFOLLOW
This option causes any symbolic link specified as a root path to be
followed immediately whether or not
@ -647,7 +647,7 @@ The
.I instr
argument is either zero or the following value:
.\" .Bl -tag -width FTS_NAMEONLY
.TP 13
.TP
.BR FTS_NAMEONLY
Only the names of the files are needed.
The contents of all the fields in the returned linked list of structures
@ -674,7 +674,7 @@ The
.I instr
argument is either 0 (meaning "do nothing") or one of the following values:
.\" .Bl -tag -width FTS_PHYSICAL
.TP 13
.TP
.BR FTS_AGAIN
Revisit the file; any file type may be revisited.
The next call to

2
man3/getaddrinfo.3
View File

@ -138,7 +138,7 @@ and
specify criteria that limit the set of socket addresses returned by
.BR getaddrinfo (),
as follows:
.TP 12
.TP
.I ai_family
This field specifies the desired address family for the returned addresses.
Valid values for this field include

4
man3/getrpcent.3
View File

@ -45,8 +45,7 @@ struct rpcent {
.in
.PP
The members of this structure are:
.RS 4
.TP 12
.TP
.I r_name
The name of the server for this RPC program.
.TP
@ -55,7 +54,6 @@ A NULL-terminated list of alternate names for the RPC program.
.TP
.I r_number
The RPC program number for this service.
.RE
.PP
The
.BR getrpcent ()

4
man3/lio_listio.3
View File

@ -42,7 +42,7 @@ function initiates the list of I/O operations described by the array
The
.I mode
operation has one of the following values:
.TP 12
.TP
.B LIO_WAIT
The call blocks until all operations are complete.
The
@ -80,7 +80,7 @@ In each control block in
the
.I aio_lio_opcode
field specifies the I/O operation to be initiated, as follows:
.TP 10
.TP
.BR LIO_READ
Initiate a read operation.
The operation is queued as for a call to

2
man3/posix_spawn.3
View File

@ -271,7 +271,7 @@ to be used during those actions.
The effects of the flags that may be specified in
.IR spawn-flags
are as follows:
.TP 8
.TP
.B POSIX_SPAWN_SETSIGMASK
Set the signal mask to the signal set specified in the
.I spawn-sigmask

2
man3/shm_open.3
View File

@ -78,7 +78,7 @@ is a bit mask created by ORing together exactly one of
or
.B O_RDWR
and any of the other flags listed here:
.TP 1.1i
.TP
.B O_RDONLY
Open the object for read access.
A shared memory object opened in this way can be

26
man4/st.4
View File

@ -257,7 +257,7 @@ struct mtop {
.in
.PP
Magnetic Tape operations for normal tape use:
.TP 14
.TP
.B MTBSF
Backward space over
.I mt_count
@ -418,7 +418,7 @@ Write
setmarks.
.PP
Magnetic Tape operations for setting of device options (by the superuser):
.TP 8
.TP
.B MTSETDRVBUFFER
Set various drive and driver options according to bits encoded in
.IR mt_count .
@ -706,7 +706,8 @@ struct mtget {
};
.EE
.in
.IP \fImt_type\fP 11
.TP
\fImt_type\fP
The header file defines many values for
.IR mt_type ,
but the current driver reports only the generic types
@ -715,9 +716,11 @@ but the current driver reports only the generic types
and
.B MT_ISSCSI2
(Generic SCSI-2 tape).
.IP \fImt_resid\fP
.TP
\fImt_resid\fP
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
bits) and density (in the high 8 bits).
These fields are defined by
@ -726,7 +729,8 @@ These fields are defined by
.BR MT_ST_DENSITY_SHIFT ,
and
.BR MT_ST_DENSITY_MASK .
.IP \fImt_gstat\fP
.TP
\fImt_gstat\fP
reports generic (device independent) status information.
The header file defines macros for testing these status bits:
.RS
@ -784,7 +788,8 @@ the drive is set not to buffer data.
The drive has requested cleaning.
Implemented in kernels since 2.4.19 and 2.5.43.
.RE
.IP \fImt_erreg\fP
.TP
\fImt_erreg\fP
The only field defined in
.I mt_erreg
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
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).
.IP \fImt_fileno\fP
.TP
\fImt_fileno\fP
reports the current file number (zero-based).
This value is set to \-1 when the file number is unknown (e.g., after
.BR MTBSS
or
.BR MTSEEK ).
.IP \fImt_blkno\fP
.TP
\fImt_blkno\fP
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
.BR MTBSF ,
@ -831,7 +838,6 @@ struct mtpos {
.EE
.in
.SH RETURN VALUE
.TP 14
.TP
.B EACCES
An attempt was made to write or erase a write-protected tape.

20
man5/elf.5
View File

@ -164,7 +164,7 @@ typedef struct {
.PP
The fields have the following meanings:
.\"
.nr l1_indent 10
.nr l1_indent 7
.\"
.TP \n[l1_indent]
.IR e_ident
@ -177,7 +177,7 @@ and may contain values which start with the prefix
.BR ELF .
The following macros are defined:
.RS
.TP 9
.TP
.BR EI_MAG0
The first byte of the magic number.
It must be filled with
@ -554,7 +554,7 @@ Otherwise, the
.IR sh_info
member of the initial entry contains the value zero.
.RS \n[l1_indent]
.TP 9
.TP
.BR PN_XNUM
This is defined as 0xffff, the largest number
.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
.IR p_flags
member in the total struct.
.TP 10
.TP
.IR p_type
This member of the structure indicates what kind of segment this array
element describes or how to interpret the array element's information.
.RS 10
.TP 12
.TP
.BR PT_NULL
The array element is unused and the other members' values are undefined.
This lets the program header have ignored entries.
@ -767,7 +767,7 @@ It may be zero.
.TP
.IR p_flags
This member holds a bit mask of flags relevant to the segment:
.RS \n[l1_indent]
.RS
.TP
.PD 0
.BR PF_X
@ -923,7 +923,7 @@ a null-terminated string.
.IR sh_type
This member categorizes the section's contents and semantics.
.RS \n[l1_indent]
.TP 15
.TP
.BR SHT_NULL
This value marks the section header as inactive.
It does not
@ -1034,7 +1034,7 @@ Otherwise, the attribute is
or does not apply.
Undefined attributes are set to zero.
.RS \n[l1_indent]
.TP 15
.TP
.BR SHF_WRITE
This section contains data that should be writable during process
execution.
@ -1491,7 +1491,7 @@ has no size or an unknown size.
.IR st_info
This member specifies the symbol's type and binding attributes:
.RS \n[l1_indent]
.TP 12
.TP
.BR STT_NOTYPE
The symbol's type is not defined.
.TP
@ -1569,7 +1569,7 @@ value.
.IR st_other
This member defines the symbol visibility.
.RS \n[l1_indent]
.TP 16
.TP
.PD 0
.BR STV_DEFAULT
Default symbol visibility rules.

2
man5/group.5
View File

@ -39,7 +39,7 @@ group_name:password:GID:user_list
.in
.PP
The fields are as follows:
.TP 12
.TP
.I group_name
the name of the group.
.TP

4
man5/proc.5
View File

@ -1321,7 +1321,7 @@ Offset field in the ELF program headers
.RI ( "readelf\ \-l" ).
.IP
There are additional helpful pseudo-paths:
.RS 12
.RS
.TP
.IR [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.
It contains one 64-bit value for each virtual page,
with the bits set as follows:
.RS 12
.RS
.TP
63
If set, the page is present in RAM.

2
man5/services.5
View File

@ -97,7 +97,7 @@ Each line describes one service, and is of the form:
\f2service-name\ \ \ port\f3/\f2protocol\ \ \ \f1[\f2aliases ...\f1]
.TP
where:
.TP 10
.TP
.I service-name
is the friendly name the service is known by and looked up under.
It is case sensitive.

6
man7/aio.7
View File

@ -36,7 +36,7 @@ by delivery of a signal, by instantiation of a thread,
or no notification at all.
.PP
The POSIX AIO interface consists of the following functions:
.TP 16
.TP
.BR aio_read (3)
Enqueue a read request.
This is the asynchronous analog of
@ -104,7 +104,7 @@ enum { LIO_READ, LIO_WRITE, LIO_NOP };
.in
.PP
The fields of this structure are as follows:
.TP 16
.TP
.I aio_fildes
The file descriptor on which the I/O operation is to be performed.
.TP
@ -147,7 +147,7 @@ The type of operation to be performed; used only for
.PP
In addition to the standard functions listed above,
the GNU C library provides the following extension to the POSIX AIO API:
.TP 16
.TP
.BR aio_init (3)
Set parameters for tuning the behavior of the glibc POSIX AIO implementation.
.SH ERRORS

2
man7/feature_test_macros.7
View File

@ -214,7 +214,7 @@ _XOPEN_SOURCE >= 700
.\" would make for a complicated description.
.PP
Linux glibc understands the following feature test macros:
.TP 8
.TP
.B __STRICT_ANSI__
ISO Standard C.
This macro is implicitly defined by

4
man7/keyrings.7
View File

@ -672,7 +672,7 @@ The optional
field provides some further information about the key.
The information that appears here depends on the key type, as follows:
.RS
.TP 4
.TP
.IR """user""" " and " """logon"""
The size in bytes of the key payload (expressed in decimal).
.TP
@ -705,7 +705,7 @@ the description field has the form shown in the following example:
.IP
The three subfields are as follows:
.RS
.TP 5
.TP
.I key
The hexadecimal ID of the key being instantiated in the requesting program.
.TP

4
man7/man-pages.7
View File

@ -48,7 +48,7 @@ for authors writing man pages for other projects.
.SS Sections of the manual pages
.PP
The manual Sections are traditionally defined as follows:
.TP 10
.TP
.B 1 User commands (Programs)
Those commands that can be executed by the user from within
a shell.
@ -213,7 +213,7 @@ those sections.
.PP
The following list elaborates on the contents of each of
the above sections.
.TP 14
.TP
.B NAME
The name of this manual page.
.IP

4
man7/sigevent.7
View File

@ -71,7 +71,7 @@ The
.I sigev_notify
field specifies how notification is to be performed.
This field can have one of the following values:
.TP 8
.TP
.BR SIGEV_NONE
A "null" notification: don't do anything when the event occurs.
.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
.I siginfo_t
structure that is passed as the second argument of the handler:
.RS 8
.RS
.TP 10
.I si_code
This field is set to a value that depends on the API

6
man7/tcp.7
View File

@ -642,7 +642,7 @@ available memory.
for this, which is limited to around 900 megabytes on 32-bit systems.
64-bit systems do not suffer this limitation.)
.RS
.TP 10
.TP
.I low
TCP doesn't regulate its memory allocation when the 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
of these values, depending on memory available in the system.
.RS
.TP 10
.TP
.I min
minimum size of the receive buffer used by each TCP socket.
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,
depending on memory available.
.RS
.TP 10
.TP
.I min
Minimum size of the send buffer used by each TCP socket.
The default value is the system page size.

2
man7/udp.7
View File

@ -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
of pages allowed for queueing by all UDP sockets.
.RS
.TP 10
.TP
.I min
Below this number of pages, UDP is not bothered about its
memory appetite.