Formatting fixes.

This commit is contained in:
Michael Kerrisk 2005-07-19 15:36:19 +00:00
parent 32f3001571
commit a5e0a0e427
31 changed files with 73 additions and 67 deletions

View File

@ -9,6 +9,7 @@ The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release: been incorporated in changes in this release:
###Andries Brouwer <Andries.Brouwer@cwi.nl> ###Andries Brouwer <Andries.Brouwer@cwi.nl>
Mike Frysinger <vapier@gentoo.org>
Apologies if I missed anyone! Apologies if I missed anyone!
@ -21,3 +22,7 @@ places.
Changes to individual pages Changes to individual pages
--------------------------- ---------------------------
stat.2
Mike Frysinger
Improve st_blocks description.

View File

@ -159,14 +159,14 @@ See also
.TP .TP
.BI "\-x " "fstype, " "\-\-exclude\-type=" "fstype" .BI "\-x " "fstype, " "\-\-exclude\-type=" "fstype"
Limit the listing to filesystems not of type Limit the listing to filesystems not of type
.I fstype. .IR fstype .
Multiple filesystem types can be eliminated by giving multiple Multiple filesystem types can be eliminated by giving multiple
.B "\-x" .B "\-x"
options. By default, no filesystem types are omitted. options. By default, no filesystem types are omitted.
.TP .TP
.B "\-v" .B "\-v"
Ignored; for compatibility with System V versions of Ignored; for compatibility with System V versions of
.B df. .B df .
.SH "GNU STANDARD OPTIONS" .SH "GNU STANDARD OPTIONS"
.TP .TP
.B "\-\-help" .B "\-\-help"

View File

@ -384,7 +384,7 @@ Do not list files whose names match the shell pattern
(not regular expression) unless they are given on the command line. As (not regular expression) unless they are given on the command line. As
in the shell, an initial `.' in a filename does not match a wildcard at in the shell, an initial `.' in a filename does not match a wildcard at
the start of the start of
.I pattern. .IR pattern .
For simple-minded root-kits: add LS_OPTIONS="$LS_OPTIONS \-I mystuff" For simple-minded root-kits: add LS_OPTIONS="$LS_OPTIONS \-I mystuff"
in /etc/profile or so, to hide your directories. in /etc/profile or so, to hide your directories.
.TP .TP

View File

@ -43,7 +43,7 @@ Write back to memory and invalidate the affected valid cache lines.
.TP .TP
.B BCACHE .B BCACHE
Same as Same as
.B (ICACHE|DCACHE). .B (ICACHE|DCACHE) .
.PP .PP
.SH "RETURN VALUE" .SH "RETURN VALUE"
.B cacheflush .B cacheflush

View File

@ -61,7 +61,7 @@ is set appropriately.
.I start .I start
is not a multiple of PAGESIZE, or any bit other than is not a multiple of PAGESIZE, or any bit other than
MS_ASYNC | MS_INVALIDATE | MS_SYNC is set in MS_ASYNC | MS_INVALIDATE | MS_SYNC is set in
.IR flags. .IR flags .
.TP .TP
.B ENOMEM .B ENOMEM
The indicated memory (or part of it) was not mapped. The indicated memory (or part of it) was not mapped.

View File

@ -75,7 +75,7 @@ PTRACE_TRACEME
Indicates that this process is to be traced by its parent. Any signal Indicates that this process is to be traced by its parent. Any signal
(except SIGKILL) delivered to this process will cause it to stop and its (except SIGKILL) delivered to this process will cause it to stop and its
parent to be notified via parent to be notified via
.BR wait. .BR wait .
Also, all subsequent calls to Also, all subsequent calls to
.BR exec .BR exec
by this process will cause a SIGTRAP to be sent to it, giving the parent a by this process will cause a SIGTRAP to be sent to it, giving the parent a

View File

@ -86,7 +86,7 @@ is the distance from the start of the directory to this
.IR dirent . .IR dirent .
.I d_reclen .I d_reclen
is the size of is the size of
.IR d_name, .IR d_name ,
not counting the null terminator. not counting the null terminator.
.I d_name .I d_name
is a null-terminated file name. is a null-terminated file name.

View File

@ -57,7 +57,7 @@ following three scheduling policies are supported under Linux:
.IR SCHED_FIFO , .IR SCHED_FIFO ,
.IR SCHED_RR , .IR SCHED_RR ,
and and
.IR SCHED_OTHER. .IR SCHED_OTHER .
.B sched_getparam .B sched_getparam
retrieves the scheduling parameters for the retrieves the scheduling parameters for the

View File

@ -36,7 +36,7 @@ setsid \- creates a session and sets the process group ID
.br .br
.ad b .ad b
.SH DESCRIPTION .SH DESCRIPTION
\fBsetsid()\fP creates a new session if the calling process is not a \fBsetsid\fP() creates a new session if the calling process is not a
process group leader. The calling process is the leader of the new process group leader. The calling process is the leader of the new
session, the process group leader of the new process group, and has no session, the process group leader of the new process group, and has no
controlling tty. The process group ID and session ID of the calling controlling tty. The process group ID and session ID of the calling
@ -58,7 +58,7 @@ A process group leader is a process with process group ID equal
to its PID. In order to be sure that to its PID. In order to be sure that
.B setsid .B setsid
will succeed, fork and exit, and have the child do will succeed, fork and exit, and have the child do
.BR setsid(). .BR setsid ().
.SH "CONFORMING TO" .SH "CONFORMING TO"
POSIX, SVr4. POSIX, SVr4.
.SH "SEE ALSO" .SH "SEE ALSO"

View File

@ -105,7 +105,7 @@ For Linux 2.4 and earlier this point is the moment the system was booted.
Since Linux 2.6, this point is \fI(2^32/HZ) \- 300\fP Since Linux 2.6, this point is \fI(2^32/HZ) \- 300\fP
(i.e., about 429 million) seconds before system boot time. (i.e., about 429 million) seconds before system boot time.
The return value may overflow the possible range of type The return value may overflow the possible range of type
.I clock_t. .IR clock_t .
On error, \fI(clock_t) \-1\fP is returned, and On error, \fI(clock_t) \-1\fP is returned, and
.I errno .I errno
is set appropriately. is set appropriately.

View File

@ -179,7 +179,7 @@ returns true if the child terminated normally, that is,
by calling by calling
.BR exit (3) .BR exit (3)
or or
.BR _exit(2), .BR _exit (2),
or by returning from main(). or by returning from main().
.TP .TP
.BI WEXITSTATUS( status ) .BI WEXITSTATUS( status )
@ -189,7 +189,7 @@ This consists of the least significant 8 bits of the
argument that the child specified in a call to argument that the child specified in a call to
.BR exit () .BR exit ()
or or
.BR _exit() .BR _exit ()
or as the argument for a return statement in main(). or as the argument for a return statement in main().
This macro should only be employed if This macro should only be employed if
.B WIFEXITED .B WIFEXITED
@ -339,7 +339,7 @@ after the call returns.
on success, returns the process ID of the terminated child; on success, returns the process ID of the terminated child;
on error, \-1 is returned. on error, \-1 is returned.
.BR waitpid(): .BR waitpid ():
on success, returns the process ID of the child whose state has changed; on success, returns the process ID of the child whose state has changed;
on error, \-1 is returned; on error, \-1 is returned;
if if
@ -348,7 +348,7 @@ was specified and no child(ren) specified by
.I pid .I pid
has yet changed state, then 0 is returned. has yet changed state, then 0 is returned.
.BR waitid(): .BR waitid ():
returns 0 on success or returns 0 on success or
if if
.B WNOHANG .B WNOHANG

View File

@ -63,7 +63,7 @@ which is a copy of whatever value was passed by the calling
program as the second argument (also named program as the second argument (also named
.IR data ) .IR data )
in the call to in the call to
.BR dl_iterate_phdr. .BR dl_iterate_phdr .
The The
.I info .I info

View File

@ -154,7 +154,7 @@ followed by all shared libraries loaded at program startup,
and then all shared libraries loaded by and then all shared libraries loaded by
.BR dlopen() .BR dlopen()
with the flag with the flag
.B RTLD_GLOBAL. .BR RTLD_GLOBAL .
.PP .PP
External references in the library are resolved using the libraries External references in the library are resolved using the libraries
in that library's dependency list and any other libraries previously in that library's dependency list and any other libraries previously

View File

@ -36,7 +36,7 @@ getline, getdelim \- delimited string input
.B getline() .B getline()
reads an entire line, storing the address of the buffer containing reads an entire line, storing the address of the buffer containing
the text into the text into
.IR "*lineptr". .IR "*lineptr" .
The buffer is null-terminated and includes the newline character, if a The buffer is null-terminated and includes the newline character, if a
newline delimiter was found. newline delimiter was found.
@ -45,13 +45,13 @@ newline delimiter was found.
If If
.IR "*lineptr" .IR "*lineptr"
is is
.BR "NULL", .BR "NULL" ,
the the
.BR getline() .BR getline()
routine will allocate a buffer for containing the line, which must be freed routine will allocate a buffer for containing the line, which must be freed
by the user program. by the user program.
Alternatively, before calling Alternatively, before calling
.BR "getline()", .BR "getline()" ,
.IR "*lineptr" .IR "*lineptr"
can contain a pointer to a can contain a pointer to a
.BR "malloc()"\-allocated .BR "malloc()"\-allocated
@ -60,7 +60,7 @@ buffer
bytes in size. If the buffer is not large enough to hold the line read in, bytes in size. If the buffer is not large enough to hold the line read in,
.B getline() .B getline()
resizes the buffer to fit with resizes the buffer to fit with
.BR "realloc()", .BR "realloc()" ,
updating updating
.IR "*lineptr" .IR "*lineptr"
and and
@ -73,11 +73,11 @@ will be updated to reflect the buffer address and size respectively.
.BR getdelim() .BR getdelim()
works like works like
.BR "getline()", .BR "getline()" ,
except a line delimiter other than newline can be specified as the except a line delimiter other than newline can be specified as the
.IR delimiter .IR delimiter
argument. As with argument. As with
.BR "getline()", .BR "getline()" ,
a delimiter character is not added if one was not present a delimiter character is not added if one was not present
in the input before end of file was reached. in the input before end of file was reached.

View File

@ -58,7 +58,7 @@ The address is converted
to a to a
.I struct in_addr .I struct in_addr
and copied to and copied to
.IR dst, .IR dst ,
which must be which must be
.I sizeof(struct in_addr) .I sizeof(struct in_addr)
bytes long. bytes long.
@ -71,7 +71,7 @@ The address is converted
to a to a
.I struct in6_addr .I struct in6_addr
and copied to and copied to
.IR dst, .IR dst ,
which must be which must be
.I sizeof(struct in6_addr) .I sizeof(struct in6_addr)
bytes long. bytes long.

View File

@ -45,9 +45,9 @@ The function
allocates allocates
.I size .I size
bytes and places the address of the allocated memory in bytes and places the address of the allocated memory in
.IR "*memptr". .IR "*memptr" .
The address of the allocated memory will be a multiple of The address of the allocated memory will be a multiple of
.IR "alignment", .IR "alignment" ,
which must be a power of two and a multiple of which must be a power of two and a multiple of
.IR "sizeof(void *)". .IR "sizeof(void *)".
@ -57,7 +57,7 @@ allocates
.I size .I size
bytes and returns a pointer to the allocated memory. bytes and returns a pointer to the allocated memory.
The memory address will be a multiple of The memory address will be a multiple of
.IR "boundary", .IR "boundary" ,
which must be a power of two. which must be a power of two.
The obsolete function The obsolete function

View File

@ -58,7 +58,7 @@ is equivalent to
.BR ldexp() . .BR ldexp() .
The value of FLT_RADIX is found in The value of FLT_RADIX is found in
.I <float.h>. .IR <float.h> .
.\" not in /usr/include but in a gcc lib .\" not in /usr/include but in a gcc lib
.SH "CONFORMING TO" .SH "CONFORMING TO"
The The

View File

@ -68,7 +68,7 @@ from
tests whether tests whether
.I signum .I signum
is a member of is a member of
.I set. .IR set .
.SH "RETURN VALUE" .SH "RETURN VALUE"
.BR sigemptyset ", " sigfillset ", " sigaddset .BR sigemptyset ", " sigfillset ", " sigaddset
and and

View File

@ -136,7 +136,7 @@ first removing their current definitions with
.BR FOPEN_MAX , .BR FOPEN_MAX ,
.BR L_cuserid , .BR L_cuserid ,
.BR L_ctermid , .BR L_ctermid ,
.BR L_tmpnam, .BR L_tmpnam ,
.BR NULL , .BR NULL ,
.BR SEEK_END , .BR SEEK_END ,
.BR SEEK_SET , .BR SEEK_SET ,

View File

@ -290,7 +290,7 @@ int main() {
For reasons of symmetry, glibc tries to support for For reasons of symmetry, glibc tries to support for
.B strptime .B strptime
the same format characters as for the same format characters as for
.BR strftime. .BR strftime .
(In most cases the corresponding fields are parsed, but no field in \fItm\fP (In most cases the corresponding fields are parsed, but no field in \fItm\fP
is changed.) is changed.)
This leads to This leads to

View File

@ -367,7 +367,7 @@ The user-defined mapping table can be set using
The result of the mapping is that if a symbol c is printed, the symbol The result of the mapping is that if a symbol c is printed, the symbol
s = map[c] is sent to the video memory. The bitmap that corresponds to s = map[c] is sent to the video memory. The bitmap that corresponds to
s is found in the character ROM, and can be changed using s is found in the character ROM, and can be changed using
.BR setfont(8). .BR setfont (8).
.SH "MOUSE TRACKING" .SH "MOUSE TRACKING"

View File

@ -179,8 +179,9 @@ or
.IR Both .IR Both
whereas whereas
.IR Both .IR Both
is the default. This parameter is only relevant if AutoNeg_A of port A is not set to is the default.
.IR Sense. This parameter is only relevant if AutoNeg_A of port A is not set to
.IR Sense .
If AutoNeg_A is set to If AutoNeg_A is set to
.IR On .IR On
, all three values of DupCap_A ( , all three values of DupCap_A (
@ -207,7 +208,7 @@ or
whereas whereas
.IR Both .IR Both
is the default. This parameter is only relevant if AutoNeg_B of port B is not set to is the default. This parameter is only relevant if AutoNeg_B of port B is not set to
.IR Sense. .IR Sense .
If AutoNeg_B is set to If AutoNeg_B is set to
.IR On .IR On
, all three values of DupCap_B ( , all three values of DupCap_B (

View File

@ -47,9 +47,9 @@ is 1.
.I <mb_cur_min> .I <mb_cur_min>
is followed by the min number of bytes for a character. This is followed by the min number of bytes for a character. This
value must be less or equal than value must be less or equal than
.B mb_cur_max. .BR mb_cur_max .
If not specified, it defaults to If not specified, it defaults to
.B mb_cur_max. .BR mb_cur_max .
.TP .TP
.I <escape_char> .I <escape_char>
is followed by a character that should be used as the is followed by a character that should be used as the

View File

@ -269,20 +269,20 @@ The order-definition starts with a line:
.I order_start .I order_start
.PP .PP
followed by a list of keywords out of followed by a list of keywords out of
.B forward, .BR forward ,
.B backward, .BR backward ,
or or
.B position. .BR position .
The order definition consists of lines that describe the order The order definition consists of lines that describe the order
and is terminated with the keyword and is terminated with the keyword
.TP .TP
.I order_end. .IR order_end .
.PP .PP
For more details see the sources in For more details see the sources in
.B /usr/lib/nls/src .B /usr/lib/nls/src
notably the examples notably the examples
.B POSIX, .BR POSIX ,
.B Example .B Example
and and
.B Example2 .B Example2
@ -291,7 +291,7 @@ and
The The
.B LC_COLLATE .B LC_COLLATE
definition ends with the string definition ends with the string
.I END LC_COLLATE. .IR END LC_COLLATE .
.SS LC_MONETARY .SS LC_MONETARY
The definition starts with the string The definition starts with the string
@ -333,12 +333,12 @@ monetary quantities.
.I int_frac_digits .I int_frac_digits
followed by the number of fractional digits that should be used when followed by the number of fractional digits that should be used when
formatting with the formatting with the
.B int_curr_symbol. .BR int_curr_symbol .
.TP .TP
.I frac_digits .I frac_digits
followed by the number of fractional digits that should be used when followed by the number of fractional digits that should be used when
formatting with the formatting with the
.B currency_symbol. .BR currency_symbol .
.TP .TP
.I p_cs_precedes .I p_cs_precedes
followed by an integer set to followed by an integer set to
@ -398,31 +398,31 @@ if a space separates the symbol and the sign string, if adjacent.
Parentheses enclose the quantity and the Parentheses enclose the quantity and the
.I currency_symbol .I currency_symbol
or or
.I int_curr_symbol. .IR int_curr_symbol .
.TP .TP
.B 1 .B 1
The sign string precedes the quantity and the The sign string precedes the quantity and the
.I currency_symbol .I currency_symbol
or the or the
.I int_curr_symbol. .IR int_curr_symbol .
.TP .TP
.B 2 .B 2
The sign string succeeds the quantity and the The sign string succeeds the quantity and the
.I currency_symbol .I currency_symbol
or the or the
.I int_curr_symbol. .IR int_curr_symbol .
.TP .TP
.B 3 .B 3
The sign string precedes the The sign string precedes the
.I currency_symbol .I currency_symbol
or the or the
.I int_curr_symbol. .IR int_curr_symbol .
.TP .TP
.B 4 .B 4
The sign string succeeds the The sign string succeeds the
.I currency_symbol .I currency_symbol
or the or the
.I int_curr_symbol. .IR int_curr_symbol .
.RE .RE
.TP .TP
.I n_sign_posn .I n_sign_posn
@ -432,31 +432,31 @@ or the
Parentheses enclose the quantity and the Parentheses enclose the quantity and the
.I currency_symbol .I currency_symbol
or or
.I int_curr_symbol. .IR int_curr_symbol .
.TP .TP
.B 1 .B 1
The sign string precedes the quantity and the The sign string precedes the quantity and the
.I currency_symbol .I currency_symbol
or the or the
.I int_curr_symbol. .IR int_curr_symbol .
.TP .TP
.B 2 .B 2
The sign string succeeds the quantity and the The sign string succeeds the quantity and the
.I currency_symbol .I currency_symbol
or the or the
.I int_curr_symbol. .IR int_curr_symbol .
.TP .TP
.B 3 .B 3
The sign string precedes the The sign string precedes the
.I currency_symbol .I currency_symbol
or the or the
.I int_curr_symbol. .IR int_curr_symbol .
.TP .TP
.B 4 .B 4
The sign string succeeds the The sign string succeeds the
.I currency_symbol .I currency_symbol
or the or the
.I int_curr_symbol. .IR int_curr_symbol .
.RE .RE
.PP .PP
The The

View File

@ -219,10 +219,10 @@ and
If this is not sufficient, the NSS `compat' service provides full If this is not sufficient, the NSS `compat' service provides full
+/\- semantics. By default, the source is `nis', but this may be +/\- semantics. By default, the source is `nis', but this may be
overridden by specifying `nisplus' as source for the pseudo-databases overridden by specifying `nisplus' as source for the pseudo-databases
.BR passwd_compat, .BR passwd_compat ,
.B group_compat .B group_compat
and and
.BR shadow_compat. .BR shadow_compat .
This pseudo-databases are only available in GNU C Library. This pseudo-databases are only available in GNU C Library.
.SH FILES .SH FILES
A service named SERVICE is implemented by a shared object library named A service named SERVICE is implemented by a shared object library named

View File

@ -184,7 +184,7 @@ Include files for the C compiler.
.I /usr/include/X11 .I /usr/include/X11
Include files for the C compiler and the X\-Windows system. This is Include files for the C compiler and the X\-Windows system. This is
usually a symbolic link to usually a symbolic link to
.I /usr/X11R6/include/X11. .IR /usr/X11R6/include/X11 .
.TP .TP
.I /usr/include/asm .I /usr/include/asm
Include files which declare some assembler functions. This used to be a Include files which declare some assembler functions. This used to be a

View File

@ -199,7 +199,7 @@ structure as argument to the ioctl. It contains a pointer to an array of
structures in structures in
.B ifc_req .B ifc_req
and its length in bytes in and its length in bytes in
.B ifc_len. .BR ifc_len .
The kernel fills the ifreqs with all current L3 interface addresses that The kernel fills the ifreqs with all current L3 interface addresses that
are running: are running:
.I ifr_name .I ifr_name

View File

@ -209,8 +209,8 @@ and
sets the socket up to receive all multicast packets arriving at the interface. sets the socket up to receive all multicast packets arriving at the interface.
In addition the traditional ioctls In addition the traditional ioctls
.B SIOCSIFFLAGS, .BR SIOCSIFFLAGS ,
.B SIOCADDMULTI, .BR SIOCADDMULTI ,
.B SIOCDELMULTI .B SIOCDELMULTI
can be used for the same purpose. can be used for the same purpose.
@ -347,11 +347,11 @@ In addition other errors may be generated by the low-level driver.
.SH VERSIONS .SH VERSIONS
.B PF_PACKET .B PF_PACKET
is a new feature in Linux 2.2. Earlier Linux versions supported only is a new feature in Linux 2.2. Earlier Linux versions supported only
.B SOCK_PACKET. .BR SOCK_PACKET .
.SH BUGS .SH BUGS
glibc 2.1 does not have a define for glibc 2.1 does not have a define for
.B SOL_PACKET. .BR SOL_PACKET .
The suggested workaround is to use The suggested workaround is to use
.RS .RS
.nf .nf

View File

@ -110,7 +110,7 @@ On Linux, programs that use the Pthreads API should be compiled using
Over time, two threading implementations have been provided by Over time, two threading implementations have been provided by
the GNU C library on Linux: the GNU C library on Linux:
.IP \- 3 .IP \- 3
.B LinuxThreads. .B LinuxThreads
This is the original (now obsolete) Pthreads implementation. This is the original (now obsolete) Pthreads implementation.
.IP \- 3 .IP \- 3
.B NPTL .B NPTL

View File

@ -175,7 +175,7 @@ intended to be portable.
Sending on raw sockets should take the IP protocol from Sending on raw sockets should take the IP protocol from
.B sin_port; .B sin_port;
this ability was lost in Linux 2.2. Work around is to use this ability was lost in Linux 2.2. Work around is to use
.B IP_HDRINCL. .BR IP_HDRINCL .
.SH "ERROR HANDLING" .SH "ERROR HANDLING"
Errors originating from the network are only passed to the user when the Errors originating from the network are only passed to the user when the

View File

@ -573,7 +573,7 @@ To set or get a TCP socket option, call
to read or to read or
.BR setsockopt (2) .BR setsockopt (2)
to write the option with the option level argument set to to write the option with the option level argument set to
.BR SOL_TCP. .BR SOL_TCP .
In addition, In addition,
most most
.B SOL_IP .B SOL_IP