Formatting fixes

This commit is contained in:
Michael Kerrisk 2005-11-02 13:55:25 +00:00
parent 836f07c1c3
commit 8478ee0279
93 changed files with 373 additions and 411 deletions

11
Changes
View File

@ -17,6 +17,17 @@ Global changes
Typographical or grammatical errors have been corrected in several Typographical or grammatical errors have been corrected in several
places. places.
Make all function and page cross references that were italicised bold
(which is how the majority of function and page cross references
were already done).
Change instances of things like "NULL-terminated string" to
"null-terminated string"
Pathnames, structures, and arguments that were bold were changed to italics
Instances of the constant "NULL" that were bold-faced were made unformatted
(which is how most instances of "NULL" already were.)
Changes to individual pages Changes to individual pages
--------------------------- ---------------------------

View File

@ -40,7 +40,7 @@ The
describes the object linked to the file descriptor describes the object linked to the file descriptor
.IR fd . .IR fd .
The The
.B struct epoll_event .I struct epoll_event
is defined as : is defined as :
.sp .sp
.nf .nf

View File

@ -52,7 +52,7 @@ equal to zero makes
.BR epoll_wait (2) .BR epoll_wait (2)
to return immediately even if no events are available ( return code equal to zero ). to return immediately even if no events are available ( return code equal to zero ).
The The
.B struct epoll_event .I struct epoll_event
is defined as : is defined as :
.sp .sp
.nf .nf

View File

@ -57,9 +57,7 @@ For
.BR getdomainname () .BR getdomainname ()
under libc: under libc:
.I name .I name
is is NULL or
.B NULL
or
.I name .I name
is longer than is longer than
.I len .I len

View File

@ -76,7 +76,7 @@ and
.BR setrlimit () .BR setrlimit ()
get and set resource limits respectively. get and set resource limits respectively.
Each resource has an associated soft and hard limit, as defined by the Each resource has an associated soft and hard limit, as defined by the
.B rlimit .I rlimit
structure (the structure (the
.I rlim .I rlim
argument to both argument to both

View File

@ -56,8 +56,9 @@ can get and set the time as well as a timezone.
The The
.I tv .I tv
argument is a argument is a
.B timeval .I struct timeval
struct, as specified in <sys/time.h>: (as specified in
.IR <sys/time.h> ):
.sp .sp
.nf .nf
struct timeval { struct timeval {
@ -73,8 +74,7 @@ and gives the number of seconds and microseconds since the Epoch (see
The The
.I tz .I tz
argument is a argument is a
.B timezone .IR "struct timezone" :
:
.sp .sp
.nf .nf
struct timezone { struct timezone {
@ -151,8 +151,9 @@ is on local time, and that it has to be incremented by this amount
to get UTC system time. to get UTC system time.
No doubt it is a bad idea to use this feature. No doubt it is a bad idea to use this feature.
.PP .PP
The following macros are defined to operate on a struct timeval : The following macros are defined to operate on a
.br .IR "struct timeval" :
.sp
.nf .nf
#define timerisset(tvp)\\ #define timerisset(tvp)\\
.ti +8 .ti +8
@ -213,9 +214,12 @@ and the defines for
are (since glibc2.2.2) only available if are (since glibc2.2.2) only available if
.B _BSD_SOURCE .B _BSD_SOURCE
is defined (either explicitly, or implicitly, by not defining is defined (either explicitly, or implicitly, by not defining
_POSIX_SOURCE or compiling with the \-ansi flag). .B _POSIX_SOURCE
or compiling with the \-ansi flag).
.LP .LP
Traditionally, the fields of struct timeval were longs. Traditionally, the fields of
.I struct timeval
were longs.
.SH "CONFORMING TO" .SH "CONFORMING TO"
SVr4, 4.3BSD. POSIX 1003.1-2001 describes SVr4, 4.3BSD. POSIX 1003.1-2001 describes
.BR gettimeofday () .BR gettimeofday ()

View File

@ -128,7 +128,7 @@ even if the same filesystem is mounted on both.)
Hard links, as created by Hard links, as created by
.BR link (), .BR link (),
cannot span filesystems. Use cannot span filesystems. Use
.B symlink .BR symlink ()
if this is required. if this is required.
POSIX.1-2001 says that POSIX.1-2001 says that

View File

@ -161,9 +161,9 @@ is unspecified."
Under Linux, this call cannot be used to create directories. Under Linux, this call cannot be used to create directories.
One should make directories with One should make directories with
.BR mkdir , .BR mkdir (2),
and FIFOs with and FIFOs with
.BR mkfifo . .BR mkfifo (2).
.\" Unix domain sockets with .BR socket " (and " bind ), .\" Unix domain sockets with .BR socket " (and " bind ),
There are many infelicities in the protocol underlying NFS. Some There are many infelicities in the protocol underlying NFS. Some

View File

@ -87,9 +87,9 @@ the process or are to be shared with other references. It has bits
.B MAP_FIXED .B MAP_FIXED
Do not select a different address than the one specified. Do not select a different address than the one specified.
If the memory region specified by If the memory region specified by
.B start .I start
and and
.B len .I len
overlaps pages of any existing mapping(s), then the overlapped overlaps pages of any existing mapping(s), then the overlapped
part of the existing mapping(s) will be discarded. part of the existing mapping(s) will be discarded.
If the specified address cannot be used, If the specified address cannot be used,
@ -216,16 +216,16 @@ to these pages will generate SIGSEGV. It is not an error if the
indicated range does not contain any mapped pages. indicated range does not contain any mapped pages.
For file-backed mappings, the For file-backed mappings, the
.B st_atime .I st_atime
field for the mapped file may be updated at any time between the field for the mapped file may be updated at any time between the
.BR mmap () .BR mmap ()
and the corresponding unmapping; the first reference to a mapped and the corresponding unmapping; the first reference to a mapped
page will update the field if it has not been already. page will update the field if it has not been already.
.LP .LP
The The
.B st_ctime .I st_ctime
and and
.B st_mtime .I st_mtime
field for a file mapped with PROT_WRITE and MAP_SHARED will be updated after field for a file mapped with PROT_WRITE and MAP_SHARED will be updated after
a write to the mapped region, and before a subsequent a write to the mapped region, and before a subsequent
.BR msync () .BR msync ()

View File

@ -157,7 +157,7 @@ capability.
.TP .TP
.B EEXIST .B EEXIST
A message queue exists for A message queue exists for
.B key .I key
and and
.I msgflg .I msgflg
specified both specified both

View File

@ -46,8 +46,7 @@ remaining time into the structure pointed to by
.IR rem .IR rem
unless unless
.I rem .I rem
is is NULL.
.BR NULL .
The value of The value of
.I *rem .I *rem
can then be used to call can then be used to call

View File

@ -191,9 +191,9 @@ in which case the lock is also successful.
.B O_LARGEFILE .B O_LARGEFILE
(LFS) (LFS)
Allow files whose sizes cannot be represented in an Allow files whose sizes cannot be represented in an
.B off_t .I off_t
(but can be represented in an (but can be represented in an
.BR off64_t ) .IR off64_t )
to be opened. to be opened.
.TP .TP
.B O_NOATIME .B O_NOATIME

View File

@ -59,7 +59,7 @@ They must be directories.
the current root. the current root.
.IP \- 3 .IP \- 3
\fIput_old\fP must be underneath \fInew_root\fP, i.e. adding a non-zero \fIput_old\fP must be underneath \fInew_root\fP, i.e. adding a non-zero
number of \fB/..\fP to the string pointed to by \fIput_old\fP must yield number of \fI/..\fP to the string pointed to by \fIput_old\fP must yield
the same directory as \fInew_root\fP. the same directory as \fInew_root\fP.
.IP \- 3 .IP \- 3
No other file system may be mounted on \fIput_old\fP. No other file system may be mounted on \fIput_old\fP.
@ -71,8 +71,8 @@ If the current root is not a mount point (e.g. after \fBchroot(2)\fP or
mount point of that file system is mounted on \fIput_old\fP. mount point of that file system is mounted on \fIput_old\fP.
.SH NOTES .SH NOTES
\fInew_root\fP does not have to be a mount point. In this case, \fInew_root\fP does not have to be a mount point. In this case,
\fB/proc/mounts\fP will show the mount point of the file system containing \fI/proc/mounts\fP will show the mount point of the file system containing
\fInew_root\fP as root (\fB/\fP). \fInew_root\fP as root (\fI/\fP).
.SH "RETURN VALUE" .SH "RETURN VALUE"
On success, zero is returned. On error, \-1 is returned, and On success, zero is returned. On error, \-1 is returned, and
\fIerrno\fP is set appropriately. \fIerrno\fP is set appropriately.

View File

@ -89,7 +89,7 @@ is not, in fact, a directory.
.B ENOTEMPTY .B ENOTEMPTY
.I pathname .I pathname
contains entries other than contains entries other than
.BR . " and " .. " ." .IR . " and " .. " ."
.TP .TP
.B EPERM .B EPERM
The directory containing The directory containing

View File

@ -71,7 +71,7 @@ elements in the array pointed to by
.I sops .I sops
specifies an operation to be performed on a single semaphore. specifies an operation to be performed on a single semaphore.
The elements of this structure are of type The elements of this structure are of type
.BR "struct sembuf" , .IR "struct sembuf" ,
containing the following members: containing the following members:
.sp .sp
.in +4n .in +4n
@ -296,8 +296,7 @@ set to
is performed). is performed).
If the If the
.I timeout .I timeout
parameter is parameter isNULL,
.BR NULL ,
then then
.BR semtimedop () .BR semtimedop ()
behaves exactly like behaves exactly like

View File

@ -61,15 +61,13 @@ with one of the following criteria:
.LP .LP
If If
.I shmaddr .I shmaddr
is is NULL,
.BR NULL ,
the system chooses a suitable (unused) address at which to attach the system chooses a suitable (unused) address at which to attach
the segment. the segment.
.LP .LP
If If
.I shmaddr .I shmaddr
isn't isn't NULL
.B NULL
and and
.B SHM_RND .B SHM_RND
is specified in is specified in
@ -105,8 +103,7 @@ and continuing for the size of the segment.
error would result if a mapping already exists in this address range.) error would result if a mapping already exists in this address range.)
In this case, In this case,
.I shmaddr .I shmaddr
must not be must not be NULL.
.BR NULL .
.PP .PP
The The
.BR brk (2) .BR brk (2)
@ -210,8 +207,7 @@ or
.B SHM_REMAP .B SHM_REMAP
was specified and was specified and
.I shmaddr .I shmaddr
was was NULL.
.BR NULL .
.TP .TP
.B ENOMEM .B ENOMEM
Could not allocate memory for the descriptor or for the page tables. Could not allocate memory for the descriptor or for the page tables.
@ -228,8 +224,7 @@ Using
.BR shmat () .BR shmat ()
with with
.I shmaddr .I shmaddr
equal to equal to NULL
.B NULL
is the preferred, portable way of attaching a shared memory segment. is the preferred, portable way of attaching a shared memory segment.
Be aware that the shared memory segment attached in this way Be aware that the shared memory segment attached in this way
may be attached at different addresses in different processes. may be attached at different addresses in different processes.

View File

@ -43,8 +43,7 @@ removes the delivered signal from the calling process's list of pending
signals and returns the signal number as its function result. signals and returns the signal number as its function result.
If the If the
.I info .I info
argument is not argument is not NULL,
.BR NULL ,
then it returns a structure of type then it returns a structure of type
.I siginfo_t .I siginfo_t
(see (see
@ -121,9 +120,7 @@ or
.BR sigtimedwait ()) .BR sigtimedwait ())
and does not establish handlers for these signals. and does not establish handlers for these signals.
.PP .PP
POSIX leaves the meaning of a POSIX leaves the meaning of a NULL value for the
.B NULL
value for the
.I timeout .I timeout
argument of argument of
.BR sigtimedwait () .BR sigtimedwait ()

View File

@ -184,7 +184,7 @@ was inspired by the 4.4BSD one
Solaris, Irix and POSIX have a system call Solaris, Irix and POSIX have a system call
.BR statvfs (2) .BR statvfs (2)
that returns a that returns a
.B "struct statvfs" .I "struct statvfs"
(defined in (defined in
.IR "<sys/statvfs.h>" ) .IR "<sys/statvfs.h>" )
containing an containing an
@ -193,7 +193,7 @@ containing an
Linux, SunOS, HPUX, 4.4BSD have a system call Linux, SunOS, HPUX, 4.4BSD have a system call
.BR statfs () .BR statfs ()
that returns a that returns a
.B "struct statfs" .I "struct statfs"
(defined in (defined in
.IR "<sys/vfs.h>" ) .IR "<sys/vfs.h>" )
containing a containing a
@ -202,7 +202,7 @@ containing a
where where
.I fsid_t .I fsid_t
is defined as is defined as
.BR "struct { int val[2]; }" . .IR "struct { int val[2]; }" .
The same holds for FreeBSD, except that it uses the include file The same holds for FreeBSD, except that it uses the include file
.IR "<sys/mount.h>" . .IR "<sys/mount.h>" .

View File

@ -60,7 +60,7 @@ struct __sysctl_args {
.PP .PP
This call does a search in a tree structure, possibly resembling This call does a search in a tree structure, possibly resembling
a directory tree under a directory tree under
.BR /proc/sys , .IR /proc/sys ,
and if the requested item is found calls some appropriate routine and if the requested item is found calls some appropriate routine
to read or modify the value. to read or modify the value.

View File

@ -161,8 +161,7 @@ signal (see
.PP .PP
If If
.I status .I status
is not is not NULL,
.BR NULL ,
.BR wait () .BR wait ()
and and
.BR waitpid () .BR waitpid ()

View File

@ -99,9 +99,7 @@ for further details.
.PP .PP
If If
.I rusage .I rusage
is not is not NULL, the
.BR NULL ,
the
.I struct rusage .I struct rusage
to which it points will be filled with accounting information to which it points will be filled with accounting information
about the child. about the child.

View File

@ -48,7 +48,7 @@ and received by calling
See their manual pages for more information. See their manual pages for more information.
.PP .PP
Ancillary data is a sequence of Ancillary data is a sequence of
.B struct cmsghdr .I struct cmsghdr
structures with appended data. This sequence should only be accessed structures with appended data. This sequence should only be accessed
using the macros described in this manual page and never directly. using the macros described in this manual page and never directly.
See the specific protocol man pages for the available control message types. See the specific protocol man pages for the available control message types.
@ -68,10 +68,8 @@ data buffer associated with the passed
returns the next valid returns the next valid
.B cmsghdr .B cmsghdr
after the passed after the passed
.B cmsghdr. .B cmsghdr .
It returns It returns NULL when there isn't enough space left in the buffer.
.B NULL
when there isn't enough space left in the buffer.
.PP .PP
.BR CMSG_ALIGN (), .BR CMSG_ALIGN (),
given a length, returns it including the required alignment. This is a given a length, returns it including the required alignment. This is a

View File

@ -64,9 +64,7 @@ be found.
.PP .PP
If If
.I buf .I buf
is not is not NULL and
.BR NULL ,
and
.I len .I len
is not zero, is not zero,
.BR confstr () .BR confstr ()
@ -84,8 +82,7 @@ If
.I len .I len
is zero and is zero and
.I buf .I buf
is is NULL,
.BR NULL ,
.BR confstr () .BR confstr ()
just returns the value as defined below. just returns the value as defined below.
.SH "RETURN VALUE" .SH "RETURN VALUE"

View File

@ -36,8 +36,7 @@ returns a string which is the pathname for the current controlling terminal for
process. process.
If If
.I s .I s
is is NULL,
.BR NULL ,
a static buffer is used, otherwise a static buffer is used, otherwise
.I s .I s
points to a buffer used to hold the terminal pathname. points to a buffer used to hold the terminal pathname.
@ -51,7 +50,7 @@ SVID, Issue 1; POSIX.1
.SH BUGS .SH BUGS
The path returned may not uniquely identify the controlling The path returned may not uniquely identify the controlling
terminal; it may, for example, be terminal; it may, for example, be
.BR /dev/tty . .IR /dev/tty .
.PP .PP
It is not assured that the program can open the terminal. It is not assured that the program can open the terminal.
.SH "SEE ALSO" .SH "SEE ALSO"

View File

@ -85,8 +85,7 @@ strings that represent the argument list available to the executed program.
The first argument, by convention, should point to the file name associated The first argument, by convention, should point to the file name associated
with the file being executed. The list of arguments with the file being executed. The list of arguments
.I must .I must
be terminated by a be terminated by a NULL
.B NULL
pointer, and, since these are variadic functions, this pointer must be cast pointer, and, since these are variadic functions, this pointer must be cast
.BR "(char *) NULL" . .BR "(char *) NULL" .
.PP .PP
@ -99,22 +98,18 @@ represent the argument list available to the new program. The first
argument, by convention, should point to the file name associated with the argument, by convention, should point to the file name associated with the
file being executed. The array of pointers file being executed. The array of pointers
.I must .I must
be terminated by a be terminated by a NULL pointer.
.B NULL
pointer.
.PP .PP
The The
.BR execle () .BR execle ()
function also specifies the environment of the executed process by following function also specifies the environment of the executed process by following
the the NULL
.B NULL
pointer that terminates the list of arguments in the parameter list or the pointer that terminates the list of arguments in the parameter list or the
pointer to the argv array with an additional parameter. This additional pointer to the argv array with an additional parameter. This additional
parameter is an array of pointers to null-terminated strings and parameter is an array of pointers to null-terminated strings and
.I must .I must
be terminated by a be terminated by a NULL pointer.
.B NULL The other functions take the environment for the new process
pointer. The other functions take the environment for the new process
image from the external variable image from the external variable
.I environ .I environ
in the current process. in the current process.

View File

@ -57,8 +57,7 @@ is unaffected.
.PP .PP
If the If the
.I stream .I stream
argument is argument is NULL,
.BR NULL ,
.BR fflush () .BR fflush ()
flushes flushes
.I all .I all

View File

@ -172,9 +172,8 @@ and
.BR freopen () .BR freopen ()
return a return a
.I FILE .I FILE
pointer. Otherwise, pointer.
.B NULL Otherwise, NULL is returned and the global variable
is returned and the global variable
.I errno .I errno
is set to indicate the error. is set to indicate the error.
.SH ERRORS .SH ERRORS

View File

@ -71,7 +71,7 @@ or
to prepare a client or a server socket. to prepare a client or a server socket.
.PP .PP
The The
.B addrinfo .I addrinfo
structure used by this function contains the following members: structure used by this function contains the following members:
.sp .sp
.nf .nf
@ -91,13 +91,13 @@ structure used by this function contains the following members:
sets sets
.I res .I res
to point to a dynamically-allocated linked list of to point to a dynamically-allocated linked list of
.B addrinfo .I addrinfo
structures, linked by the structures, linked by the
.I ai_next .I ai_next
member. member.
There are several reasons why There are several reasons why
the linked list may have more than one the linked list may have more than one
.B addrinfo .I addrinfo
structure, including: if the network host is structure, including: if the network host is
multi-homed; or if the same service multi-homed; or if the same service
is available from multiple socket protocols (one is available from multiple socket protocols (one
@ -132,7 +132,7 @@ A NULL
.I hints .I hints
specifies that any network address or protocol is acceptable. specifies that any network address or protocol is acceptable.
If this parameter is not NULL it points to an If this parameter is not NULL it points to an
.B addrinfo .I addrinfo
structure structure
whose whose
.IR ai_family , .IR ai_family ,
@ -181,7 +181,7 @@ flag suppresses any potentially lengthy network host address lookups.
The The
.BR getaddrinfo (3) .BR getaddrinfo (3)
function creates a linked list of function creates a linked list of
.B addrinfo .I addrinfo
structures, one for each network address subject to any restrictions structures, one for each network address subject to any restrictions
imposed by the imposed by the
.I hints .I hints
@ -189,7 +189,7 @@ parameter.
The The
.I ai_canonname .I ai_canonname
field of the first of these field of the first of these
.B addrinfo .I addrinfo
structures is set to point to the official name of the host, if structures is set to point to the official name of the host, if
.I hints.ai_flags .I hints.ai_flags
includes the includes the

View File

@ -49,9 +49,7 @@ which is of length
.PP .PP
If the current absolute path name would require a buffer longer than If the current absolute path name would require a buffer longer than
.I size .I size
elements, elements, NULL is returned, and
.B NULL
is returned, and
.I errno .I errno
is set to is set to
.BR ERANGE ; .BR ERANGE ;
@ -70,9 +68,8 @@ allocates the buffer dynamically using
.BR malloc () .BR malloc ()
if if
.I buf .I buf
is is NULL on call.
.B NULL In this case, the allocated buffer has the length
on call. In this case, the allocated buffer has the length
.I size .I size
unless unless
.I size .I size
@ -116,7 +113,7 @@ and may even be unlimited. For portability and security reasons, use of
.BR getwd () .BR getwd ()
is deprecated. is deprecated.
.SH "RETURN VALUE" .SH "RETURN VALUE"
.B NULL NULL
on failure with on failure with
.I errno .I errno
set accordingly, and set accordingly, and

View File

@ -95,13 +95,13 @@ If no date is given, but we know the hour, then that hour is taken
to be the first such hour equal to or after the current hour. to be the first such hour equal to or after the current hour.
.SH "RETURN VALUE" .SH "RETURN VALUE"
When successful, this function returns a pointer to a When successful, this function returns a pointer to a
.BR "struct tm" . .IR "struct tm" .
Otherwise, it returns NULL and sets the global variable Otherwise, it returns NULL and sets the global variable
.BR getdate_err . .IR getdate_err .
Changes to Changes to
.I errno .I errno
are unspecified. The following values for are unspecified. The following values for
.B getdate_err .I getdate_err
are defined: are defined:
.TP 4n .TP 4n
.B 1 .B 1
@ -131,7 +131,7 @@ Invalid input specification.
Since Since
.BR getdate () .BR getdate ()
is not reentrant because of the use of is not reentrant because of the use of
.B getdate_err .I getdate_err
and the static buffer to return the result in, glibc provides a and the static buffer to return the result in, glibc provides a
thread-safe variant. The functionality is the same. The result thread-safe variant. The functionality is the same. The result
is returned in the buffer pointed to by is returned in the buffer pointed to by

View File

@ -165,21 +165,21 @@ parameter specifies one of the following values:
The The
.I addr .I addr
parameter points to a parameter points to a
.B struct in_addr .I struct in_addr
and and
.I len .I len
must be set to must be set to
.BR "sizeof(struct in_addr)" . .IR "sizeof(struct in_addr)" .
.TP .TP
.B AF_INET6 .B AF_INET6
The The
.I addr .I addr
parameter points to a parameter points to a
.B struct in6_addr .I struct in6_addr
and and
.I len .I len
must be set to must be set to
.BR "sizeof(struct in6_addr)" . .IR "sizeof(struct in6_addr)" .
.SH "RETURN VALUE" .SH "RETURN VALUE"
A null pointer is returned if an error occurred, and A null pointer is returned if an error occurred, and
.I error_num .I error_num
@ -236,11 +236,11 @@ parameter was
.TP .TP
.B h_length .B h_length
This field will be set to This field will be set to
.B sizeof(struct in_addr) .I sizeof(struct in_addr)
if if
.I h_addrtype .I h_addrtype
is AF_INET, and to is AF_INET, and to
.B sizeof(struct in6_addr) .I sizeof(struct in6_addr)
if if
.I h_addrtype .I h_addrtype
is AF_INET6. is AF_INET6.

View File

@ -44,9 +44,7 @@ newline delimiter was found.
.\" Answer: *n is ignored and a new buffer is allocated .\" Answer: *n is ignored and a new buffer is allocated
If If
.IR "*lineptr" .IR "*lineptr"
is is NULL, then the
.BR "NULL" ,
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.

View File

@ -154,9 +154,9 @@ or
.PP .PP
.I longopts .I longopts
is a pointer to the first element of an array of is a pointer to the first element of an array of
.B struct option .I struct option
declared in declared in
.B <getopt.h> .I <getopt.h>
as as
.nf .nf
.sp .sp

View File

@ -35,7 +35,7 @@ each return a pointer to an object with the
following structure following structure
containing the broken-out containing the broken-out
fields of a line in the rpc program number data base, fields of a line in the rpc program number data base,
.BR /etc/rpc . .IR /etc/rpc .
.RS .RS
.LP .LP
.nf .nf
@ -88,7 +88,7 @@ program number is found, or until end-of-file is encountered.
.SH FILES .SH FILES
.PD 0 .PD 0
.TP 20 .TP 20
.B /etc/rpc .I /etc/rpc
.PD .PD
.SH "SEE ALSO" .SH "SEE ALSO"
.BR rpc (5), .BR rpc (5),

View File

@ -124,8 +124,7 @@ and
.BR fgets () .BR fgets ()
return return
.I s .I s
on success, and on success, and NULL
.B NULL
on error or when end of file occurs while no characters have been read. on error or when end of file occurs while no characters have been read.
.PP .PP
.BR ungetc () .BR ungetc ()

View File

@ -148,8 +148,7 @@ which means that only directories are matched.
.PP .PP
If If
.I errfunc .I errfunc
is not is not NULL,
.BR NULL ,
it will be called in case of an error with the arguments it will be called in case of an error with the arguments
.IR epath , .IR epath ,
a pointer to the path which failed, and a pointer to the path which failed, and
@ -175,8 +174,7 @@ Upon successful return,
contains the number of matched pathnames and contains the number of matched pathnames and
.I pglob->gl_pathv .I pglob->gl_pathv
a pointer to the list of matched pathnames. The first pointer after a pointer to the list of matched pathnames. The first pointer after
the last pathname is the last pathname is NULL.
.BR NULL .
.PP .PP
It is possible to call It is possible to call
.BR glob () .BR glob ()

View File

@ -34,7 +34,7 @@ localeconv \- get numeric formatting information
The The
.BR localeconv () .BR localeconv ()
function returns a pointer to a function returns a pointer to a
.B struct lconv .I struct lconv
for the current locale. This structure is defined in the header-file for the current locale. This structure is defined in the header-file
.B locale.h .B locale.h
and contains all values associated with the locale categories and contains all values associated with the locale categories

View File

@ -91,15 +91,17 @@ to your compiler command line.
Note that the Note that the
member member
.B ut_user .I ut_user
of struct utmp is called of
.B ut_name .I struct utmp
is called
.I ut_name
in BSD. Therefore, in BSD. Therefore,
.B ut_name .I ut_name
is defined as an alias for is defined as an alias for
.B ut_user .I ut_user
in in
.IR utmp.h . .IR <utmp.h> .
.SH FILES .SH FILES
.TP .TP
.I /var/run/utmp .I /var/run/utmp

View File

@ -67,9 +67,7 @@ Otherwise, or if
has already been called before, undefined behaviour occurs. has already been called before, undefined behaviour occurs.
If If
.I ptr .I ptr
is is NULL, no operation is performed.
.BR NULL ,
no operation is performed.
.PP .PP
.BR realloc () .BR realloc ()
changes the size of the memory block pointed to by changes the size of the memory block pointed to by
@ -81,18 +79,14 @@ The contents will be unchanged to the minimum of the old and new sizes;
newly allocated memory will be uninitialized. newly allocated memory will be uninitialized.
If If
.I ptr .I ptr
is is NULL, the call is equivalent to
.BR NULL ,
the call is equivalent to
.BR malloc(size) ; .BR malloc(size) ;
if size is equal to zero, if size is equal to zero,
the call is equivalent to the call is equivalent to
.BI "free(" "ptr" ) . .BI "free(" "ptr" ) .
Unless Unless
.I ptr .I ptr
is is NULL, it must have been returned by an earlier call to
.BR NULL ,
it must have been returned by an earlier call to
.BR malloc (), .BR malloc (),
.BR calloc () .BR calloc ()
or or
@ -106,9 +100,7 @@ For
and and
.BR malloc (), .BR malloc (),
the value returned is a pointer to the allocated memory, which is suitably the value returned is a pointer to the allocated memory, which is suitably
aligned for any kind of variable, or aligned for any kind of variable, or NULL if the request fails.
.B NULL
if the request fails.
.PP .PP
.BR free () .BR free ()
returns no value. returns no value.
@ -117,9 +109,8 @@ returns no value.
returns a pointer to the newly allocated memory, which is suitably returns a pointer to the newly allocated memory, which is suitably
aligned for any kind of variable and may be different from aligned for any kind of variable and may be different from
.IR ptr , .IR ptr ,
or or NULL if the request fails.
.B NULL If
if the request fails. If
.I size .I size
was equal to 0, either NULL or a pointer suitable to be passed to was equal to 0, either NULL or a pointer suitable to be passed to
.BR free () .BR free ()

View File

@ -30,7 +30,7 @@ function. It copies
bytes from the object beginning at bytes from the object beginning at
.I src .I src
into the object pointed to by into the object pointed to by
.I dest. .IR dest .
But instead of returning the value of But instead of returning the value of
.I dest .I dest
it returns a pointer to the byte following the last written byte. it returns a pointer to the byte following the last written byte.

View File

@ -92,9 +92,7 @@ status of the command as returned by
.SH "RETURN VALUE" .SH "RETURN VALUE"
The The
.BR popen () .BR popen ()
function returns function returns NULL if the
.B NULL
if the
.BR fork (2) .BR fork (2)
or or
.BR pipe (2) .BR pipe (2)

View File

@ -75,9 +75,7 @@ For all three routines, the memory is not zeroed.
.BR memalign () .BR memalign ()
and and
.BR valloc () .BR valloc ()
return the pointer to the allocated memory, or return the pointer to the allocated memory, or NULL if the request fails.
.B NULL
if the request fails.
.BR posix_memalign () .BR posix_memalign ()
returns zero on success, or one of the error values listed in the returns zero on success, or one of the error values listed in the

View File

@ -295,7 +295,7 @@ For decimal conversion
.BR G ) .BR G )
the output is to be grouped with thousands' grouping characters the output is to be grouped with thousands' grouping characters
if the locale information indicates any. Note that many versions of if the locale information indicates any. Note that many versions of
.B gcc .BR gcc (1)
cannot parse this option and will issue a warning. SUSv2 does not cannot parse this option and will issue a warning. SUSv2 does not
include %'F. include %'F.
.PP .PP

View File

@ -42,8 +42,7 @@ which is overwritten by subsequent use of
.BR re_comp (). .BR re_comp ().
If If
.I regex .I regex
is is NULL,
.BR NULL ,
no operation is performed and the pattern buffer's contents are not no operation is performed and the pattern buffer's contents are not
altered. altered.
@ -54,9 +53,7 @@ matches the previously compiled
.IR regex . .IR regex .
.SH "RETURN VALUE" .SH "RETURN VALUE"
.BR re_comp () .BR re_comp ()
returns returns NULL on successful compilation of
.B NULL
on successful compilation of
.I regex .I regex
otherwise it returns a pointer to an appropriate error message. otherwise it returns a pointer to an appropriate error message.

View File

@ -747,7 +747,7 @@ Stuff the machine's
address into address into
.IR *addr , .IR *addr ,
without consulting the library routines that deal with without consulting the library routines that deal with
.BR /etc/hosts . .IR /etc/hosts .
The port number is always set to The port number is always set to
.BR htons(\s-1PMAPPORT\s0) . .BR htons(\s-1PMAPPORT\s0) .
.br .br

View File

@ -105,8 +105,7 @@ argument should point to a buffer at least
bytes long; this buffer will be used instead of the current buffer. If the bytes long; this buffer will be used instead of the current buffer. If the
argument argument
.I buf .I buf
is is NULL,
.BR NULL ,
only the mode is affected; a new buffer will be allocated on the next read only the mode is affected; a new buffer will be allocated on the next read
or write operation. The or write operation. The
.BR setvbuf () .BR setvbuf ()

View File

@ -43,8 +43,7 @@ function is used to set or query the program's current locale.
.PP .PP
If If
.I locale .I locale
is not is not NULL,
.BR NULL ,
the program's current locale is modified according to the arguments. the program's current locale is modified according to the arguments.
The argument The argument
.I category .I category
@ -132,9 +131,7 @@ For a list of all supported locales, try "locale \-a", cf.\&
.PP .PP
If If
.I locale .I locale
is is NULL, the current locale is only queried, not modified.
.BR NULL ,
the current locale is only queried, not modified.
.PP .PP
On startup of the main program, the portable On startup of the main program, the portable
.B """C""" .B """C"""
@ -162,9 +159,8 @@ returns an opaque string that corresponds to the locale set.
This string may be allocated in static storage. This string may be allocated in static storage.
The string returned is such that a subsequent call with that string The string returned is such that a subsequent call with that string
and its associated category will restore that part of the process's and its associated category will restore that part of the process's
locale. The return value is locale.
.B NULL The return value is NULL if the request cannot be honored.
if the request cannot be honored.
.SH "CONFORMING TO" .SH "CONFORMING TO"
ANSI C, POSIX.1 ANSI C, POSIX.1
.SH NOTES .SH NOTES

View File

@ -111,8 +111,7 @@ These functions return the converted value, if any.
If If
.I endptr .I endptr
is not is not NULL,
.BR NULL ,
a pointer to the character after the last character used in the conversion a pointer to the character after the last character used in the conversion
is stored in the location referenced by is stored in the location referenced by
.IR endptr . .IR endptr .

View File

@ -67,8 +67,7 @@ a command that does
.PP .PP
If the value of If the value of
.I command .I command
is is NULL,
.BR NULL ,
.BR system () .BR system ()
returns non-zero if the shell is available, and zero if not. returns non-zero if the shell is available, and zero if not.
.PP .PP

View File

@ -51,9 +51,8 @@ of length
.SH "RETURN VALUE" .SH "RETURN VALUE"
The function The function
.BR ttyname () .BR ttyname ()
returns a pointer to a pathname on success. On error, returns a pointer to a pathname on success.
.B NULL On error, NULL is returned, and
is returned, and
.I errno .I errno
is set appropriately. is set appropriately.
The function The function

View File

@ -13,9 +13,9 @@ console \- console terminal and virtual consoles
.SH DESCRIPTION .SH DESCRIPTION
A Linux system has up to 63 \fIvirtual consoles\fP A Linux system has up to 63 \fIvirtual consoles\fP
(character devices with major number 4 and minor number 1 to 63), (character devices with major number 4 and minor number 1 to 63),
usually called \fB/dev/tty\fP\fIn\fP with 1 \(<= \fIn\fP \(<= 63. usually called \fI/dev/tty\fP\fIn\fP with 1 \(<= \fIn\fP \(<= 63.
The current console is also addressed by The current console is also addressed by
\fB/dev/console\fP or \fB/dev/tty0\fP, the character device with \fI/dev/console\fP or \fI/dev/tty0\fP, the character device with
major number 4 and minor number 0. major number 4 and minor number 0.
The device files /dev/* are usually created using the script MAKEDEV, The device files /dev/* are usually created using the script MAKEDEV,
or using or using

View File

@ -141,7 +141,7 @@ lost when the media is changed.
sets the media information of a drive (geometry of disk in drive). The sets the media information of a drive (geometry of disk in drive). The
media information will not be lost when the media is changed. This media information will not be lost when the media is changed. This
will disable autodetection. In order to re-enable autodetection, you will disable autodetection. In order to re-enable autodetection, you
have to issue an \fBFDCLRPRM\fP . have to issue an \fBFDCLRPRM\fP.
.IP \fBFDGETDRVTYP\fP .IP \fBFDGETDRVTYP\fP
returns the type of a drive (name parameter). For formats which work returns the type of a drive (name parameter). For formats which work
in several drive types, \fBFDGETDRVTYP\fP returns a name which is in several drive types, \fBFDGETDRVTYP\fP returns a name which is

View File

@ -27,16 +27,16 @@
.SH NAME .SH NAME
full \- always full device full \- always full device
.SH DESCRIPTION .SH DESCRIPTION
File \fB/dev/full\fP has major device number 1 File \fI/dev/full\fP has major device number 1
and minor device number 7. and minor device number 7.
.LP .LP
Writes to the \fB/dev/full\fP device will fail with an ENOSPC error. Writes to the \fI/dev/full\fP device will fail with an ENOSPC error.
Reads from the \fB/dev/full\fP device will return \\0 characters. Reads from the \fI/dev/full\fP device will return \\0 characters.
Seeks on \fB/dev/full\fP will always succeed. Seeks on \fI/dev/full\fP will always succeed.
.SH CONFIGURING .SH CONFIGURING
If your system does not have \fB/dev/full\fP created already, it If your system does not have \fI/dev/full\fP created already, it
can be created with the following commands: can be created with the following commands:
.nf .nf

View File

@ -58,9 +58,9 @@ Both DOS-type partitioning and BSD-disklabel partitioning are supported.
You can have at most 63 partitions on an IDE disk. You can have at most 63 partitions on an IDE disk.
.LP .LP
For example, For example,
.B /dev/hda .I /dev/hda
refers to all of the first IDE drive in the system; and refers to all of the first IDE drive in the system; and
.B /dev/hdb3 .I /dev/hdb3
refers to the third DOS `primary' partition on the second one. refers to the third DOS `primary' partition on the second one.
.LP .LP
They are typically created by: They are typically created by:

View File

@ -39,20 +39,20 @@ initrd \- boot loader initialized RAM disk
.\" .\"
.SH DESCRIPTION .SH DESCRIPTION
The special file The special file
.B /dev/initrd .I /dev/initrd
is a read-only block device. is a read-only block device.
Device Device
.B /dev/initrd .I /dev/initrd
is a RAM disk that is initialized (e.g. loaded) by the boot loader before is a RAM disk that is initialized (e.g. loaded) by the boot loader before
the kernel is started. the kernel is started.
The kernel then can use the block device The kernel then can use the block device
.BR /dev/initrd "'s " .IR /dev/initrd "'s "
contents for a two phased system boot-up. contents for a two phased system boot-up.
.PP .PP
In the first boot-up phase, the kernel starts up In the first boot-up phase, the kernel starts up
and mounts an initial root file-system from the contents and mounts an initial root file-system from the contents
of of
.B /dev/initrd .I /dev/initrd
(e.g. RAM disk initialized by the boot loader). (e.g. RAM disk initialized by the boot loader).
In the second phase, additional drivers or other modules In the second phase, additional drivers or other modules
are loaded from the initial root device's contents. are loaded from the initial root device's contents.
@ -68,41 +68,42 @@ When booting up with
.RS 0.2i .RS 0.2i
.PP .PP
1. The boot loader loads the kernel program and 1. The boot loader loads the kernel program and
.BR /dev/initrd "'s contents into memory." .IR /dev/initrd "'s contents into memory."
.PP .PP
2. On kernel startup, the kernel uncompresses and copies the contents of the device 2. On kernel startup,
.B /dev/initrd the kernel uncompresses and copies the contents of the device
.I /dev/initrd
onto device onto device
.B /dev/ram0 .I /dev/ram0
and then frees the memory used by and then frees the memory used by
.BR /dev/initrd "." .IR /dev/initrd "."
.PP .PP
3. The kernel then read-write mounts device 3. The kernel then read-write mounts device
.B /dev/ram0 .I /dev/ram0
as the initial root file system. as the initial root file system.
.PP .PP
4. If the indicated normal root file system is also the initial root file-system 4. If the indicated normal root file system is also the initial root file-system
(e.g. (e.g.
.B /dev/ram0 .I /dev/ram0
) then the kernel skips to the last step for the usual boot sequence. ) then the kernel skips to the last step for the usual boot sequence.
.PP .PP
5. If the executable file 5. If the executable file
.BR /linuxrc " is present in the initial root file-system, " /linuxrc .IR /linuxrc " is present in the initial root file-system, " /linuxrc
is executed with UID 0. is executed with UID 0.
(The file (The file
.B /linuxrc .I /linuxrc
must have executable permission. must have executable permission.
The file The file
.B /linuxrc .I /linuxrc
can be any valid executable, including a shell script.) can be any valid executable, including a shell script.)
.PP .PP
6. If 6. If
.B /linuxrc .I /linuxrc
is not executed or when is not executed or when
.B /linuxrc .I /linuxrc
terminates, the normal root file system is mounted. terminates, the normal root file system is mounted.
(If (If
.BR /linuxrc .IR /linuxrc
exits with any file-systems mounted on the initial root exits with any file-systems mounted on the initial root
file-system, then the behavior of the kernel is file-system, then the behavior of the kernel is
.BR UNSPECIFIED "." .BR UNSPECIFIED "."
@ -111,21 +112,21 @@ See the
section for the current kernel behavior.) section for the current kernel behavior.)
.PP .PP
7. If the normal root file has directory 7. If the normal root file has directory
.BR /initrd ", device" .IR /initrd ", device"
.B /dev/ram0 .I /dev/ram0
is moved from is moved from
.BR / " to " /initrd "." .IR / " to " /initrd "."
Otherwise if directory Otherwise if directory
.BR /initrd " does not exist device " /dev/ram0 " is unmounted." .IR /initrd " does not exist device " /dev/ram0 " is unmounted."
(When moved from (When moved from
.BR / " to " /initrd ", " /dev/ram0 .IR / " to " /initrd ", " /dev/ram0
is not unmounted and therefore processes can remain running from is not unmounted and therefore processes can remain running from
.BR /dev/ram0 "." .IR /dev/ram0 "."
If directory If directory
.BR /initrd .IR /initrd
does not exist on the normal root file-system does not exist on the normal root file-system
and any processes remain running from and any processes remain running from
.BR /dev/ram0 " when " /linuxrc .IR /dev/ram0 " when " /linuxrc
exits, the behavior of the kernel is exits, the behavior of the kernel is
.BR UNSPECIFIED "." .BR UNSPECIFIED "."
See the See the
@ -133,7 +134,8 @@ See the
section for the current kernel behavior.) section for the current kernel behavior.)
.PP .PP
8. The usual boot sequence (e.g. invocation of 8. The usual boot sequence (e.g. invocation of
.BR /sbin/init ") is performed on the normal root file system." .IR /sbin/init )
is performed on the normal root file system.
.\" .\"
.\" .\"
.\" .\"
@ -143,27 +145,29 @@ The following boot loader options when used with
.TP .TP
.BI initrd= "filename" .BI initrd= "filename"
Specifies the file to load as the contents of Specifies the file to load as the contents of
.BR /dev/initrd "." .IR /dev/initrd "."
.RB "For " LOADLIN .RB "For " LOADLIN
this is a command line option. this is a command line option.
.RB "For " LILO " you have to use this command in the .RB "For " LILO " you have to use this command in the
.BR LILO " configuration file " /etc/lilo.config "." .BR LILO
configuration file
.IR /etc/lilo.config .
The filename specified with this The filename specified with this
option will typically be a gzipped file-system image. option will typically be a gzipped file-system image.
.TP .TP
.B noinitrd .I noinitrd
This boot time option disables the two phase boot-up operation. This boot time option disables the two phase boot-up operation.
The kernel performs the usual boot sequence as if The kernel performs the usual boot sequence as if
.B /dev/initrd .I /dev/initrd
was not initialized. was not initialized.
With this option, any contents of With this option, any contents of
.B /dev/initrd .I /dev/initrd
loaded into memory by the boot loader contents are preserved. loaded into memory by the boot loader contents are preserved.
This option permits the contents of This option permits the contents of
.B /dev/initrd .I /dev/initrd
to be any data and need not be limited to a file system image. to be any data and need not be limited to a file system image.
However, device However, device
.B /dev/initrd .I /dev/initrd
is read-only and can be read only one time after system startup. is read-only and can be read only one time after system startup.
.TP .TP
.BI root= "device-name" .BI root= "device-name"
@ -182,7 +186,7 @@ device having a suitable root file-system.
By default, By default,
the kernel's settings the kernel's settings
(e.g. set in the kernel file with (e.g. set in the kernel file with
.B rdev .BR rdev (8)
or compiled into the kernel file), or compiled into the kernel file),
or the boot loader option setting or the boot loader option setting
is used for the normal root file systems. is used for the normal root file systems.
@ -195,38 +199,38 @@ For more information on setting the root file system also see the
.BR LILO " and " LOADLIN " documentation." .BR LILO " and " LOADLIN " documentation."
.PP .PP
It is also possible for the It is also possible for the
.BR /linuxrc .IR /linuxrc
executable to change the normal root device. executable to change the normal root device.
For For
.BR /linuxrc .IR /linuxrc
to change the normal root device, to change the normal root device,
.BR /proc " must be mounted." .IR /proc " must be mounted."
After mounting After mounting
.BR /proc ", " /linuxrc .IR /proc ", " /linuxrc
changes the normal root device by writing into the proc files changes the normal root device by writing into the proc files
.BR /proc/sys/kernel/real-root-dev ", " .IR /proc/sys/kernel/real-root-dev ", "
.BR /proc/sys/kernel/nfs-root-name ", and " .IR /proc/sys/kernel/nfs-root-name ", and "
.BR /proc/sys/kernel/nfs-root-addrs "." .IR /proc/sys/kernel/nfs-root-addrs "."
For a physical root device, the root device is changed by having For a physical root device, the root device is changed by having
.BR /linuxrc .IR /linuxrc
write the new root file system device number into write the new root file system device number into
.BR /proc/sys/kernel/real-root-dev "." .IR /proc/sys/kernel/real-root-dev "."
For a NFS root file system, the root device is changed by having For a NFS root file system, the root device is changed by having
.BR /linuxrc .IR /linuxrc
write the NFS setting into files write the NFS setting into files
.BR /proc/sys/kernel/nfs-root-name " and " .IR /proc/sys/kernel/nfs-root-name " and "
.BR /proc/sys/kernel/nfs-root-addrs .IR /proc/sys/kernel/nfs-root-addrs
and then writing 0xff (e.g. the pseudo-NFS-device number) into file and then writing 0xff (e.g. the pseudo-NFS-device number) into file
.BR /proc/sys/kernel/real-root-dev "." .IR /proc/sys/kernel/real-root-dev "."
For example, the following shell command line would change For example, the following shell command line would change
the normal root device to the normal root device to
.BR /dev/hdb1 : .IR /dev/hdb1 :
.nf .nf
echo 0x365 >/proc/sys/kernel/real-root-dev echo 0x365 >/proc/sys/kernel/real-root-dev
.fi .fi
For a NFS example, the following shell command lines would change the For a NFS example, the following shell command lines would change the
normal root device to the NFS directory normal root device to the NFS directory
.BR /var/nfsroot .IR /var/nfsroot
on a local networked NFS server with IP number 193.8.232.7 for a system with on a local networked NFS server with IP number 193.8.232.7 for a system with
IP number 193.8.232.7 and named 'idefix': IP number 193.8.232.7 and named 'idefix':
.nf .nf
@ -238,7 +242,7 @@ IP number 193.8.232.7 and named 'idefix':
.BR Note : .BR Note :
The use of The use of
.BR /proc/sys/kernel/real-root-dev .IR /proc/sys/kernel/real-root-dev
to change the root file system is obsolete. to change the root file system is obsolete.
See the kernel source file See the kernel source file
.I Documentation/initrd.txt .I Documentation/initrd.txt
@ -261,11 +265,11 @@ A possible system installation scenario is as follows:
.PP .PP
1. The loader program boots from floppy or other media with a minimal kernel 1. The loader program boots from floppy or other media with a minimal kernel
(e.g. support for (e.g. support for
.BR /dev/ram ", " /dev/initrd ", and the ext2 file-system) and loads " .IR /dev/ram ", " /dev/initrd ", and the ext2 file-system) and loads "
.BR /dev/initrd " with a gzipped version of the initial file-system. .IR /dev/initrd " with a gzipped version of the initial file-system.
.PP .PP
2. The executable 2. The executable
.BR /linuxrc .IR /linuxrc
determines what is needed to (1) mount the normal root file-system determines what is needed to (1) mount the normal root file-system
(i.e. device type, device drivers, file system) and (2) the (i.e. device type, device drivers, file system) and (2) the
distribution media (e.g. CD-ROM, network, tape, ...). This can be distribution media (e.g. CD-ROM, network, tape, ...). This can be
@ -273,19 +277,19 @@ done by asking the user, by auto-probing, or by using a hybrid
approach. approach.
.PP .PP
3. The executable 3. The executable
.BR /linuxrc .IR /linuxrc
loads the necessary modules from the initial root file-system. loads the necessary modules from the initial root file-system.
.PP .PP
4. The executable 4. The executable
.BR /linuxrc .IR /linuxrc
creates and populates the root file system. (At this stage the normal creates and populates the root file system. (At this stage the normal
root file system does not have to be a root file system does not have to be a
completed system yet.) completed system yet.)
.PP .PP
5. The executable 5. The executable
.BR /linuxrc " sets " /proc/sys/kernel/real-root-dev, .IR /linuxrc " sets " /proc/sys/kernel/real-root-dev,
unmount unmount
.BR /proc ", " .IR /proc ", "
the normal root file system and any other file the normal root file system and any other file
systems it has mounted, and then terminates. systems it has mounted, and then terminates.
.PP .PP
@ -295,12 +299,12 @@ systems it has mounted, and then terminates.
the boot loader can be installed. the boot loader can be installed.
.PP .PP
8. The boot loader is configured to load into 8. The boot loader is configured to load into
.BR /dev/initrd .IR /dev/initrd
a file system with the set of modules that was used to bring up the system. a file system with the set of modules that was used to bring up the system.
(e.g. Device (e.g. Device
.BR /dev/ram0 .IR /dev/ram0
can be modified, then unmounted, and finally, the image is written from can be modified, then unmounted, and finally, the image is written from
.BR /dev/ram0 .IR /dev/ram0
to a file.) to a file.)
.PP .PP
9. The system is now bootable and additional installation tasks can be 9. The system is now bootable and additional installation tasks can be
@ -308,7 +312,7 @@ performed.
.RE .RE
.PP .PP
The key role of The key role of
.BR /dev/initrd .IR /dev/initrd
in the above is to re-use the configuration data during normal system operation in the above is to re-use the configuration data during normal system operation
without requiring initial kernel selection, a large generic kernel or, without requiring initial kernel selection, a large generic kernel or,
recompiling the kernel. recompiling the kernel.
@ -321,15 +325,15 @@ information as small as possible.
In this case, create a common file In this case, create a common file
with all needed modules. with all needed modules.
Then, only the Then, only the
.B /linuxrc .I /linuxrc
file or a file executed by file or a file executed by
.B /linuxrc .I /linuxrc
would be different. would be different.
.PP .PP
A third scenario is more convenient recovery disks. A third scenario is more convenient recovery disks.
Because information like the location of the root file-system Because information like the location of the root file-system
partition is not needed at boot time, the system loaded from partition is not needed at boot time, the system loaded from
.B /dev/initrd .I /dev/initrd
can use a dialog and/or auto-detection followed by a can use a dialog and/or auto-detection followed by a
possible sanity check. possible sanity check.
.PP .PP
@ -339,27 +343,27 @@ for easy installation from the CD-ROM.
The distribution can use The distribution can use
.BR LOADLIN .BR LOADLIN
to directly load to directly load
.BR /dev/initrd .IR /dev/initrd
from CD-ROM without the need of any floppies. from CD-ROM without the need of any floppies.
The distribution could also use a The distribution could also use a
.BR LILO .BR LILO
boot floppy and then bootstrap a bigger ram disk via boot floppy and then bootstrap a bigger ram disk via
.BR /dev/initrd " from the CD-ROM." .IR /dev/initrd " from the CD-ROM."
.\" .\"
.\" .\"
.\" .\"
.SH CONFIGURATION .SH CONFIGURATION
The The
.B /dev/initrd .I /dev/initrd
is a read-only block device assigned is a read-only block device assigned
major number 1 and minor number 250. major number 1 and minor number 250.
Typically Typically
.B /dev/initrd .I /dev/initrd
is owned by is owned by
.B root.disk .I root.disk
with mode 0400 (read access by root only). with mode 0400 (read access by root only).
If the Linux system does not have If the Linux system does not have
.B /dev/initrd .I /dev/initrd
already created, it can be created with the following commands: already created, it can be created with the following commands:
.nf .nf
\fB \fB
@ -371,9 +375,9 @@ Also, support for both "RAM disk" and "Initial RAM disk"
(e.g. (e.g.
.BR CONFIG_BLK_DEV_RAM=y " and " CONFIG_BLK_DEV_INITRD=y .BR CONFIG_BLK_DEV_RAM=y " and " CONFIG_BLK_DEV_INITRD=y
) support must be compiled directly into the Linux kernel to use ) support must be compiled directly into the Linux kernel to use
.BR /dev/initrd "." .IR /dev/initrd "."
When using When using
.BR /dev/initrd ", " .IR /dev/initrd ", "
the RAM disk driver cannot be loaded as a module. the RAM disk driver cannot be loaded as a module.
.\" .\"
.\" .\"
@ -402,24 +406,25 @@ the LOADLIN documentation, the SYSLINUX documentation.
.\" .\"
.SH NOTES .SH NOTES
1. With the current kernel, any file systems that remain mounted when 1. With the current kernel, any file systems that remain mounted when
.BR /dev/ram0 " is moved from " / " to " /initrd .IR /dev/ram0 " is moved from " / " to " /initrd
continue to be accessible. However, the continue to be accessible. However, the
.BR /proc/mounts .IR /proc/mounts
entries are not updated. entries are not updated.
.PP .PP
2. With the current kernel, if directory 2. With the current kernel, if directory
.BR /initrd " does not exist, then " /dev/ram0 .IR /initrd " does not exist, then "
.I /dev/ram0
will NOT be fully unmounted if will NOT be fully unmounted if
.BR /dev/ram0 .IR /dev/ram0
is used by any process or has any file-system mounted on it. is used by any process or has any file-system mounted on it.
If If
.BR /dev/ram0 " is NOT fully unmounted, " .IR /dev/ram0 " is NOT fully unmounted, "
then then
.BR /dev/ram0 .IR /dev/ram0
will remain in memory. will remain in memory.
.PP .PP
3. Users of 3. Users of
.BR /dev/initrd .IR /dev/initrd
should not depend on the behavior give in the above notes. should not depend on the behavior give in the above notes.
The behavior may change in future versions of the Linux kernel. The behavior may change in future versions of the Linux kernel.
.\" .\"

View File

@ -7,15 +7,15 @@
.SH NAME .SH NAME
ptmx and pts \- pseudo-terminal master and slave ptmx and pts \- pseudo-terminal master and slave
.SH DESCRIPTION .SH DESCRIPTION
The file \fB/dev/ptmx\fP is a character file with major number 5 and The file \fI/dev/ptmx\fP is a character file with major number 5 and
minor number 2, usually of mode 0666 and owner.group of root.root. minor number 2, usually of mode 0666 and owner.group of root.root.
It is used to create a pseudo-terminal master and slave pair. It is used to create a pseudo-terminal master and slave pair.
.PP .PP
When a process opens \fB/dev/ptmx\fP, it gets a file When a process opens \fI/dev/ptmx\fP, it gets a file
descriptor for a pseudo-terminal master (PTM), descriptor for a pseudo-terminal master (PTM),
and a pseudo-terminal slave (PTS) device is created in the and a pseudo-terminal slave (PTS) device is created in the
.I /dev/pts .I /dev/pts
directory. Each file descriptor obtained by opening \fB/dev/ptmx\fP directory. Each file descriptor obtained by opening \fI/dev/ptmx\fP
is an independent PTM with its own associated PTS, whose path can is an independent PTM with its own associated PTS, whose path can
be found by passing the descriptor to be found by passing the descriptor to
.BR ptsname (3). .BR ptsname (3).

View File

@ -14,11 +14,11 @@
.SH NAME .SH NAME
random, urandom \- kernel random number source devices random, urandom \- kernel random number source devices
.SH DESCRIPTION .SH DESCRIPTION
The character special files \fB/dev/random\fP and The character special files \fI/dev/random\fP and
\fB/dev/urandom\fP (present since Linux 1.3.30) \fI/dev/urandom\fP (present since Linux 1.3.30)
provide an interface to the kernel's random number generator. provide an interface to the kernel's random number generator.
File \fB/dev/random\fP has major device number 1 File \fI/dev/random\fP has major device number 1
and minor device number 8. File \fB/dev/urandom\fP and minor device number 8. File \fI/dev/urandom\fP
has major device number 1 and minor device number 9. has major device number 1 and minor device number 9.
.LP .LP
The random number generator gathers environmental noise The random number generator gathers environmental noise
@ -27,25 +27,25 @@ The generator also keeps an estimate of the
number of bits of noise in the entropy pool. number of bits of noise in the entropy pool.
From this entropy pool random numbers are created. From this entropy pool random numbers are created.
.LP .LP
When read, the \fB/dev/random\fP device will only return random bytes When read, the \fI/dev/random\fP device will only return random bytes
within the estimated number of bits of noise in the entropy within the estimated number of bits of noise in the entropy
pool. \fB/dev/random\fP should be suitable for uses that need very pool. \fI/dev/random\fP should be suitable for uses that need very
high quality randomness such as one-time pad or key generation. high quality randomness such as one-time pad or key generation.
When the entropy pool is empty, reads from \fB/dev/random\fP will block When the entropy pool is empty, reads from \fI/dev/random\fP will block
until additional environmental noise is gathered. until additional environmental noise is gathered.
.LP .LP
A read from the \fB/dev/urandom\fP device will not block A read from the \fI/dev/urandom\fP device will not block
waiting for more entropy. waiting for more entropy.
As a result, if there is not sufficient entropy in the As a result, if there is not sufficient entropy in the
entropy pool, the returned values are theoretically vulnerable to a entropy pool, the returned values are theoretically vulnerable to a
cryptographic attack on the algorithms used by the driver. Knowledge of cryptographic attack on the algorithms used by the driver. Knowledge of
how to do this is not available in the current non-classified how to do this is not available in the current non-classified
literature, but it is theoretically possible that such an attack may literature, but it is theoretically possible that such an attack may
exist. If this is a concern in your application, use \fB/dev/random\fP exist. If this is a concern in your application, use \fI/dev/random\fP
instead. instead.
.SH CONFIGURING .SH CONFIGURING
If your system does not have If your system does not have
\fB/dev/random\fP and \fB/dev/urandom\fP created already, they \fI/dev/random\fP and \fI/dev/urandom\fP created already, they
can be created with the following commands: can be created with the following commands:
.nf .nf
@ -96,7 +96,7 @@ run during the Linux system shutdown:
The files in the directory The files in the directory
.I /proc/sys/kernel/random .I /proc/sys/kernel/random
(present since 2.3.16) provide an additional interface to the (present since 2.3.16) provide an additional interface to the
.B /dev/random .I /dev/random
device. device.
.LP .LP
The read-only file The read-only file

View File

@ -55,10 +55,10 @@ partitions 1-4 are the DOS "primary" partitions
partitions 5-8 are the DOS "extended" (or "logical") partitions partitions 5-8 are the DOS "extended" (or "logical") partitions
For example, For example,
.B /dev/sda .I /dev/sda
will have major 8, minor 0, and will refer to all of the first SCSI drive will have major 8, minor 0, and will refer to all of the first SCSI drive
in the system; and in the system; and
.B /dev/sdb3 .I /dev/sdb3
will have major 8, minor 19, and will refer to the third DOS "primary" will have major 8, minor 19, and will refer to the third DOS "primary"
partition on the second SCSI drive in the system. partition on the second SCSI drive in the system.

View File

@ -422,11 +422,11 @@ and
are designed to operate in configurations where a network path between the ports on one adapter exists. Moreover, they are not designed to work where adapters are connected back-to-back. are designed to operate in configurations where a network path between the ports on one adapter exists. Moreover, they are not designed to work where adapters are connected back-to-back.
.SH FILES .SH FILES
.TP .TP
.B /proc/net/sk98lin/eth[x] .I /proc/net/sk98lin/eth[x]
.br .br
The statistics file of a particular interface of an adapter card. It contains generic information about the adapter card plus a detailed summary of all transmit and receive counters. The statistics file of a particular interface of an adapter card. It contains generic information about the adapter card plus a detailed summary of all transmit and receive counters.
.TP .TP
.B /usr/src/linux/Documentation/network/sk98lin.txt .I /usr/src/linux/Documentation/network/sk98lin.txt
.br .br
This is the This is the
.IR README .IR README

View File

@ -142,12 +142,12 @@ compile-time constant (originally four). The driver contains an
that can format a tape with either one or two partitions. that can format a tape with either one or two partitions.
.PP .PP
Device Device
.B /dev/tape .I /dev/tape
is usually created as a hard or soft link to the default tape device is usually created as a hard or soft link to the default tape device
on the system. on the system.
.PP .PP
Starting from kernel 2.6.2, the driver exports in the sysfs directory Starting from kernel 2.6.2, the driver exports in the sysfs directory
.BR /sys/class/scsi_tape .IR /sys/class/scsi_tape
the attached devices and some parameters assigned to the devices. the attached devices and some parameters assigned to the devices.
.SH "DATA TRANSFER" .SH "DATA TRANSFER"
The driver supports operation in both fixed-block mode and The driver supports operation in both fixed-block mode and
@ -202,11 +202,11 @@ driver are passed to the
.B SCSI .B SCSI
driver. driver.
The definitions below are from The definitions below are from
.BR /usr/include/linux/mtio.h : .IR /usr/include/linux/mtio.h :
.SS "\s-1MTIOCTOP\s+1 \(em Perform a tape operation" .SS "\s-1MTIOCTOP\s+1 \(em Perform a tape operation"
.PP .PP
This request takes an argument of type This request takes an argument of type
.BR "(struct mtop *)" . .IR "(struct mtop *)" .
Not all drives support all operations. Not all drives support all operations.
The driver returns an EIO error if the drive rejects an operation. The driver returns an EIO error if the drive rejects an operation.
.PP .PP
@ -537,7 +537,7 @@ the masked sense data byte.
.SS "\s-1MTIOCGET\s+1 \(em Get status" .SS "\s-1MTIOCGET\s+1 \(em Get status"
.PP .PP
This request takes an argument of type This request takes an argument of type
.BR "(struct mtget *)" . .IR "(struct mtget *)" .
.PP .PP
.nf .nf
/* structure for \s-1MTIOCGET\s+1 \- mag tape get status command */ /* structure for \s-1MTIOCGET\s+1 \- mag tape get status command */
@ -637,7 +637,7 @@ This value is set to \-1 when the block number is unknown (e.g., after
.SS "\s-1MTIOCPOS\s+1 \(em Get tape position" .SS "\s-1MTIOCPOS\s+1 \(em Get tape position"
.PP .PP
This request takes an argument of type This request takes an argument of type
.B "(struct mtpos *)" .I "(struct mtpos *)"
and reports the drive's notion of the current tape block number, and reports the drive's notion of the current tape block number,
which is not the same as which is not the same as
.B mt_blkno .B mt_blkno

View File

@ -27,7 +27,7 @@
.SH NAME .SH NAME
tty \- controlling terminal tty \- controlling terminal
.SH DESCRIPTION .SH DESCRIPTION
The file \fB/dev/tty\fP is a character file with major number 5 and The file \fI/dev/tty\fP is a character file with major number 5 and
minor number 0, usually of mode 0666 and owner.group root.tty. It is a minor number 0, usually of mode 0666 and owner.group root.tty. It is a
synonym for the controlling terminal of a process, if any. synonym for the controlling terminal of a process, if any.
.LP .LP
@ -41,9 +41,9 @@ then SIGHUP and SIGCONT signals are sent to the foreground process group
and all processes in the current session lose their controlling tty. and all processes in the current session lose their controlling tty.
.sp .sp
This \fBioctl\fP() call only works on file descriptors connected This \fBioctl\fP() call only works on file descriptors connected
to \fB/dev/tty\fP. It is used by daemon processes when they are invoked to \fI/dev/tty\fP. It is used by daemon processes when they are invoked
by a user at a terminal. by a user at a terminal.
The process attempts to open \fB/dev/tty\fP. If the open succeeds, it The process attempts to open \fI/dev/tty\fP. If the open succeeds, it
detaches itself from the terminal by using \fBTIOCNOTTY\fP, while if the detaches itself from the terminal by using \fBTIOCNOTTY\fP, while if the
open fails, it is obviously not attached to a terminal and does not need open fails, it is obviously not attached to a terminal and does not need
to detach itself. to detach itself.

View File

@ -54,9 +54,9 @@ set the current serial port settings.
.LP .LP
The following four ioctls are just like TCGETS, TCSETS, TCSETSW, TCSETSF, The following four ioctls are just like TCGETS, TCSETS, TCSETSW, TCSETSF,
except that they take a except that they take a
.B "struct termio *" .I "struct termio *"
instead of a instead of a
.BR "struct termios *" . .IR "struct termios *" .
.TP .TP
.BI "TCGETA struct termio *" argp .BI "TCGETA struct termio *" argp
.TP .TP

View File

@ -27,14 +27,14 @@
.SH NAME .SH NAME
vcs, vcsa \- virtual console memory vcs, vcsa \- virtual console memory
.SH DESCRIPTION .SH DESCRIPTION
\fB/dev/vcs0\fP is a character device with major number 7 and minor number \fI/dev/vcs0\fP is a character device with major number 7 and minor number
0, usually of mode 0644 and owner root.tty. It refers to the memory 0, usually of mode 0644 and owner root.tty. It refers to the memory
of the currently of the currently
displayed virtual console terminal. displayed virtual console terminal.
.LP .LP
\fB/dev/vcs[1\-63]\fP are character devices for virtual console \fI/dev/vcs[1\-63]\fP are character devices for virtual console
terminals, they have major number 7 and minor number 1 to 63, usually terminals, they have major number 7 and minor number 1 to 63, usually
mode 0644 and owner root.tty. \fB/dev/vcsa[0\-63]\fP are the same, but mode 0644 and owner root.tty. \fI/dev/vcsa[0\-63]\fP are the same, but
including attributes, and prefixed with four bytes giving the screen including attributes, and prefixed with four bytes giving the screen
dimensions and cursor position: \fIlines\fP, \fIcolumns\fP, \fIx\fP, \fIy\fP. dimensions and cursor position: \fIlines\fP, \fIcolumns\fP, \fIx\fP, \fIy\fP.
(\fIx\fP = \fIy\fP = 0 at the top left corner of the screen.) (\fIx\fP = \fIy\fP = 0 at the top left corner of the screen.)

View File

@ -36,7 +36,7 @@ acct("/somewhere/accountingfile");
will start the process accounting. Each time a process terminates will start the process accounting. Each time a process terminates
a record for this process is appended to the accounting file. a record for this process is appended to the accounting file.
The accounting structure The accounting structure
.B "struct acct" .I "struct acct"
is also described in the file is also described in the file
.IR /usr/include/linux/acct.h . .IR /usr/include/linux/acct.h .
.SH "SEE ALSO" .SH "SEE ALSO"

View File

@ -25,7 +25,7 @@
.SH NAME .SH NAME
group \- user group file group \- user group file
.SH DESCRIPTION .SH DESCRIPTION
\fB/etc/group\fP is an ASCII file which defines the groups to which users \fI/etc/group\fP is an ASCII file which defines the groups to which users
belong. There is one entry per line, and each line has the format: belong. There is one entry per line, and each line has the format:
.sp .sp
.RS .RS

View File

@ -46,7 +46,7 @@ In the following, the word
means an instantiation of one among such mechanisms. means an instantiation of one among such mechanisms.
.SS Resource Access Permissions .SS Resource Access Permissions
For each resource, the system uses a common structure of type For each resource, the system uses a common structure of type
.BR "struct ipc_perm" .IR "struct ipc_perm"
to store information needed in determining permissions to perform an to store information needed in determining permissions to perform an
ipc operation. ipc operation.
The The
@ -137,7 +137,7 @@ type variable.
A message queue is uniquely identified by a positive integer A message queue is uniquely identified by a positive integer
.RI "(its " msqid ) .RI "(its " msqid )
and has an associated data structure of type and has an associated data structure of type
.BR "struct msqid_ds" , .IR "struct msqid_ds" ,
defined in defined in
.IR <sys/msg.h> , .IR <sys/msg.h> ,
containing the following members: containing the following members:
@ -214,7 +214,7 @@ structure.
A semaphore set is uniquely identified by a positive integer A semaphore set is uniquely identified by a positive integer
.RI "(its " semid ) .RI "(its " semid )
and has an associated data structure of type and has an associated data structure of type
.BR "struct semid_ds" , .IR "struct semid_ds" ,
defined in defined in
.IR <sys/sem.h> , .IR <sys/sem.h> ,
containing the following members: containing the following members:
@ -259,7 +259,7 @@ to
.BR sem_nsems\-1 . .BR sem_nsems\-1 .
.PP .PP
A semaphore is a data structure of type A semaphore is a data structure of type
.B "struct sem" .I "struct sem"
containing the following members: containing the following members:
.sp .sp
.B .B
@ -298,7 +298,7 @@ to become zero.
A shared memory segment is uniquely identified by a positive integer A shared memory segment is uniquely identified by a positive integer
.RI "(its " shmid ) .RI "(its " shmid )
and has an associated data structure of type and has an associated data structure of type
.BR "struct shmid_ds" , .IR "struct shmid_ds" ,
defined in defined in
.IR <sys/shm.h> , .IR <sys/shm.h> ,
containing the following members: containing the following members:

View File

@ -26,7 +26,7 @@
.SH NAME .SH NAME
issue \- pre-login message and identification file issue \- pre-login message and identification file
.SH DESCRIPTION .SH DESCRIPTION
The file \fB/etc/issue\fP is a text file which contains a message or The file \fI/etc/issue\fP is a text file which contains a message or
system identification to be printed before the login prompt. It may system identification to be printed before the login prompt. It may
contain various \fB@\fP\fIchar\fP and \fB\e\fP\fIchar\fP sequences, if contain various \fB@\fP\fIchar\fP and \fB\e\fP\fIchar\fP sequences, if
supported by supported by

View File

@ -280,7 +280,7 @@ and is terminated with the keyword
.PP .PP
For more details see the sources in For more details see the sources in
.B /usr/lib/nls/src .I /usr/lib/nls/src
notably the examples notably the examples
.BR POSIX , .BR POSIX ,
.B Example .B Example

View File

@ -26,7 +26,7 @@
.SH NAME .SH NAME
motd \- message of the day motd \- message of the day
.SH DESCRIPTION .SH DESCRIPTION
The contents of \fB/etc/motd\fP are displayed by The contents of \fI/etc/motd\fP are displayed by
.BR login (1) .BR login (1)
after a successful login but just before it executes the login shell. after a successful login but just before it executes the login shell.

View File

@ -26,7 +26,7 @@
.SH NAME .SH NAME
nologin \- prevent non-root users from logging into the system nologin \- prevent non-root users from logging into the system
.SH DESCRIPTION .SH DESCRIPTION
If the file \fB/etc/nologin\fP exists, If the file \fI/etc/nologin\fP exists,
.BR login (1) .BR login (1)
will allow access only to root. Other users will will allow access only to root. Other users will
be shown the contents of this file and their logins will be refused. be shown the contents of this file and their logins will be refused.

View File

@ -22,7 +22,7 @@
/etc/nscd.conf \- name service cache daemon configuration file /etc/nscd.conf \- name service cache daemon configuration file
.SH DESCRIPTION .SH DESCRIPTION
The file The file
.B /etc/nscd.conf .I /etc/nscd.conf
is read from is read from
.BR nscd (8) .BR nscd (8)
at startup. Each line specifies either an attribute and a value, or an at startup. Each line specifies either an attribute and a value, or an

View File

@ -38,7 +38,7 @@ contain a cleaner solution of this problem. It is designed after a method
used by Sun Microsystems in the C library of Solaris 2. We follow their used by Sun Microsystems in the C library of Solaris 2. We follow their
name and call this scheme "Name Service Switch" (NSS). The sources for name and call this scheme "Name Service Switch" (NSS). The sources for
the "databases" and their lookup order are specified in the the "databases" and their lookup order are specified in the
.B /etc/nsswitch.conf .I /etc/nsswitch.conf
file. file.
.LP .LP
The following databases are available in the NSS: The following databases are available in the NSS:
@ -98,9 +98,9 @@ Shadow user passwords, used by
.BR getspnam (3). .BR getspnam (3).
.LP .LP
An example An example
.B /etc/nsswitch.conf .I /etc/nsswitch.conf
(namely, the default used when (namely, the default used when
.B /etc/nsswitch.conf .I /etc/nsswitch.conf
is missing): is missing):
.sp 1n .sp 1n
.PD 0 .PD 0
@ -202,20 +202,20 @@ default action is `continue'.
.SS Interaction with +/\- syntax (compat mode) .SS Interaction with +/\- syntax (compat mode)
Linux libc5 without NYS does not have the name service switch but does Linux libc5 without NYS does not have the name service switch but does
allow the user some policy control. In allow the user some policy control. In
.B /etc/passwd .I /etc/passwd
you could have entries of the form +user or +@netgroup you could have entries of the form +user or +@netgroup
(include the specified user from the NIS passwd map), (include the specified user from the NIS passwd map),
\-user or \-@netgroup (exclude the specified user), \-user or \-@netgroup (exclude the specified user),
and + (include every user, except the excluded ones, from the NIS and + (include every user, except the excluded ones, from the NIS
passwd map). Since most people only put a + at the end of passwd map). Since most people only put a + at the end of
.B /etc/passwd .I /etc/passwd
to include everything from NIS, the switch provides a faster to include everything from NIS, the switch provides a faster
alternative for this case (`passwd: files nis') which doesn't alternative for this case (`passwd: files nis') which doesn't
require the single + entry in require the single + entry in
.BR /etc/passwd , .IR /etc/passwd ,
.BR /etc/group , .IR /etc/group ,
and and
.BR /etc/shadow . .IR /etc/shadow .
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
@ -231,7 +231,7 @@ that resides in
.IR /lib . .IR /lib .
.TP 25 .TP 25
.PD 0 .PD 0
.B /etc/nsswitch.conf .I /etc/nsswitch.conf
configuration file configuration file
.TP .TP
.BI /lib/libnss_compat.so. X .BI /lib/libnss_compat.so. X
@ -252,7 +252,7 @@ implements `hesiod' source for glibc2
.BI /lib/libnss_nis.so. X .BI /lib/libnss_nis.so. X
implements `nis' source for glibc2 implements `nis' source for glibc2
.TP .TP
.B /lib/libnss_nisplus.so.2 .I /lib/libnss_nisplus.so.2
implements `nisplus' source for glibc 2.1 implements `nisplus' source for glibc 2.1
.SH NOTES .SH NOTES
Within each process that uses Within each process that uses

View File

@ -95,7 +95,7 @@ the user's $HOME directory.
.TP .TP
.I shell .I shell
the program to run at login (if empty, use the program to run at login (if empty, use
.BR /bin/sh ). .IR /bin/sh ).
If set to a non-existing executable, the user will be unable to login If set to a non-existing executable, the user will be unable to login
through through
.BR login (1). .BR login (1).

View File

@ -27,7 +27,7 @@
.SH NAME .SH NAME
shells \- pathnames of valid login shells shells \- pathnames of valid login shells
.SH DESCRIPTION .SH DESCRIPTION
.B /etc/shells .I /etc/shells
is a text file which contains the full pathnames of valid login shells. is a text file which contains the full pathnames of valid login shells.
This file is consulted by This file is consulted by
.BR chsh (1) .BR chsh (1)
@ -37,7 +37,7 @@ Be aware that there are programs which consult this file to
find out if a user is a normal user. E.g.: ftp daemons traditionally find out if a user is a normal user. E.g.: ftp daemons traditionally
disallow access to users with shells not included in this file. disallow access to users with shells not included in this file.
.SH EXAMPLES .SH EXAMPLES
.B /etc/shells .I /etc/shells
may contain the following paths: may contain the following paths:
.sp .sp
.RS .RS

View File

@ -35,7 +35,7 @@ only for capability with old programs; new ones should use the
.BR terminfo (5) .BR terminfo (5)
database and associated libraries. database and associated libraries.
.LP .LP
.B /etc/termcap .I /etc/termcap
is an ASCII file (the database master) that lists the capabilities of is an ASCII file (the database master) that lists the capabilities of
many different types of terminals. Programs can read termcap to find many different types of terminals. Programs can read termcap to find
the particular escape codes needed to control the visual attributes of the particular escape codes needed to control the visual attributes of

View File

@ -14,7 +14,7 @@ begin with the magic characters "TZif" to identify then as
time zone information files, time zone information files,
followed by sixteen bytes reserved for future use, followed by sixteen bytes reserved for future use,
followed by six four-byte values of type followed by six four-byte values of type
.BR long , .IR long ,
written in a ``standard'' byte order written in a ``standard'' byte order
(the high-order byte of the value is written first). (the high-order byte of the value is written first).
These values are, These values are,

View File

@ -73,13 +73,13 @@ for more information.
Most distributions include the HOWTOs and mini-HOWTOs in the installation Most distributions include the HOWTOs and mini-HOWTOs in the installation
.PD 0 .PD 0
.TP .TP
\fB/usr/doc/\fP (old place for documentation) \fI/usr/doc/\fP (old place for documentation)
.TP .TP
\fB/usr/share/doc/\fP (new place for documentation) \fI/usr/share/doc/\fP (new place for documentation)
.TP .TP
\fB/usr/share/doc/HOWTO/\fP (HOWTO files) \fI/usr/share/doc/HOWTO/\fP (HOWTO files)
.TP .TP
\fB/usr/share/doc/HOWTO/mini/\fP (mini-HOWTO files) \fI/usr/share/doc/HOWTO/mini/\fP (mini-HOWTO files)
.PD .PD
.SH "SEE ALSO" .SH "SEE ALSO"
.BR info (1), .BR info (1),

View File

@ -64,7 +64,7 @@ Three ioctls are available on all
.B PF_INET .B PF_INET
sockets. sockets.
They take a pointer to a They take a pointer to a
.B struct arpreq .I struct arpreq
as their parameter. as their parameter.
.nf .nf
@ -126,7 +126,7 @@ is obsolete and should not be used.
ARP supports a sysctl interface to configure parameters on a global ARP supports a sysctl interface to configure parameters on a global
or per-interface basis. or per-interface basis.
The sysctls can be accessed by reading or writing the The sysctls can be accessed by reading or writing the
.B /proc/sys/net/ipv4/neigh/*/* .I /proc/sys/net/ipv4/neigh/*/*
files or with the files or with the
.BR sysctl (2) .BR sysctl (2)
interface. Each interface in the system has its own directory in interface. Each interface in the system has its own directory in
@ -240,7 +240,7 @@ functionality together.
.SH VERSIONS .SH VERSIONS
The The
.B struct arpreq .I struct arpreq
changed in Linux 2.0 to include the changed in Linux 2.0 to include the
.I arp_dev .I arp_dev
member and the ioctl numbers changed at the same time. member and the ioctl numbers changed at the same time.

View File

@ -146,7 +146,7 @@ without parameters displays the possible arguments.
.SS "Sequencing Directories" .SS "Sequencing Directories"
To make specific scripts start/stop at specific run-levels and in To make specific scripts start/stop at specific run-levels and in
specific order, there are \fIsequencing directories\fR. These specific order, there are \fIsequencing directories\fR. These
are normally in \fB/etc/rc[0\-6S].d\fR. In each of these directories are normally in \fI/etc/rc[0\-6S].d\fR. In each of these directories
there are links (usually symbolic) to the scripts in the \fIinit.d\fR there are links (usually symbolic) to the scripts in the \fIinit.d\fR
directory. directory.

View File

@ -75,10 +75,10 @@ struct sockaddr_atalk {
.PP .PP
.I sat_family .I sat_family
is always set to is always set to
.B AF_APPLETALK. .BR AF_APPLETALK .
.I sat_port .I sat_port
contains the port. The port numbers below 129 are known as contains the port. The port numbers below 129 are known as
.B reserved ports. .I reserved ports.
Only processes with the effective user ID 0 or the Only processes with the effective user ID 0 or the
.B CAP_NET_BIND_SERVICE .B CAP_NET_BIND_SERVICE
capability may capability may
@ -89,7 +89,7 @@ is the host address.
The The
.I net .I net
member of member of
.B struct at_addr .I struct at_addr
contains the host network in network byte order. The value of contains the host network in network byte order. The value of
.B AT_ANYNET .B AT_ANYNET
is a is a
@ -97,7 +97,7 @@ wildcard and also implies \(lqthis network.\(rq
The The
.I node .I node
member of member of
.B struct at_addr .I struct at_addr
contains the host node number. The value of contains the host node number. The value of
.B AT_ANYNODE .B AT_ANYNODE
is a is a
@ -111,7 +111,7 @@ No protocol-specific socket options are supported.
.SH SYSCTLS .SH SYSCTLS
IP supports a sysctl interface to configure some global AppleTalk parameters. IP supports a sysctl interface to configure some global AppleTalk parameters.
The sysctls can be accessed by reading or writing the The sysctls can be accessed by reading or writing the
.B /proc/sys/net/atalk/* .I /proc/sys/net/atalk/*
files or with the files or with the
.BR sysctl (2) .BR sysctl (2)
interface. interface.

View File

@ -34,7 +34,7 @@ are also limited by the destination route of the incoming packets.
.SH SYSCTLS .SH SYSCTLS
ICMP supports a sysctl interface to configure some global IP parameters. ICMP supports a sysctl interface to configure some global IP parameters.
The sysctls can be accessed by reading or writing the The sysctls can be accessed by reading or writing the
.B /proc/sys/net/ipv4/* .I /proc/sys/net/ipv4/*
files or with the files or with the
.BR sysctl (2) .BR sysctl (2)
interface. Most of these sysctls are rate limitations for specific ICMP types. interface. Most of these sysctls are rate limitations for specific ICMP types.

View File

@ -106,7 +106,7 @@ are implemented by higher level protocols like
and and
.BR tcp (7). .BR tcp (7).
On raw sockets On raw sockets
.B sin_port .I sin_port
is set to the IP protocol. is set to the IP protocol.
.PP .PP
@ -152,9 +152,9 @@ is the IP host address.
The The
.I addr .I addr
member of member of
.B struct in_addr .I struct in_addr
contains the host interface address in network order. contains the host interface address in network order.
.B in_addr .I in_addr
should be only accessed using the should be only accessed using the
.BR inet_aton (3), .BR inet_aton (3),
.BR inet_addr (3), .BR inet_addr (3),
@ -235,7 +235,7 @@ puts the current IP options used for sending into the supplied buffer.
Pass an Pass an
.I IP_PKTINFO .I IP_PKTINFO
ancillary message that contains a ancillary message that contains a
.B pktinfo .I pktinfo
structure that supplies some information about the incoming packet. structure that supplies some information about the incoming packet.
This only works for datagram oriented sockets. This only works for datagram oriented sockets.
The argument is a flag that tells the socket whether the IP_PKTINFO message The argument is a flag that tells the socket whether the IP_PKTINFO message
@ -258,11 +258,11 @@ struct in_pktinfo {
.RE .RE
.IP .IP
.\" FIXME elaborate on that. .\" FIXME elaborate on that.
.B ipi_ifindex .I ipi_ifindex
is the unique index of the interface the packet was received on. is the unique index of the interface the packet was received on.
.B ipi_spec_dst .I ipi_spec_dst
is the local address of the packet and is the local address of the packet and
.B ipi_addr .I ipi_addr
is the destination address in the packet header. is the destination address in the packet header.
If If
.I IP_PKTINFO .I IP_PKTINFO
@ -270,11 +270,11 @@ is passed to
.BR sendmsg (2) .BR sendmsg (2)
and and
.\" This field is grossly misnamed .\" This field is grossly misnamed
.B ipi_spec_dst .I ipi_spec_dst
is not zero, then it is used as the local source address for the routing is not zero, then it is used as the local source address for the routing
table lookup and for setting up IP source route options. table lookup and for setting up IP source route options.
When When
.B ipi_ifindex .I ipi_ifindex
is not zero the primary local address of the interface specified by the is not zero the primary local address of the interface specified by the
index overwrites index overwrites
.I ipi_spec_dst .I ipi_spec_dst
@ -374,7 +374,7 @@ be received by calling
with the with the
.B MSG_ERRQUEUE .B MSG_ERRQUEUE
flag set. The flag set. The
.B sock_extended_err .I sock_extended_err
structure describing the error will be passed in a ancillary message with structure describing the error will be passed in a ancillary message with
the type the type
.I IP_RECVERR .I IP_RECVERR
@ -388,7 +388,7 @@ contains the error packet.
The The
.I IP_RECVERR .I IP_RECVERR
control message contains a control message contains a
.B sock_extended_err .I sock_extended_err
structure: structure:
.IP .IP
.RS .RS
@ -416,9 +416,9 @@ struct sockaddr *SO_EE_OFFENDER(struct sock_extended_err *);
.fi .fi
.RE .RE
.IP .IP
.B ee_errno .I ee_errno
contains the errno number of the queued error. contains the errno number of the queued error.
.B ee_origin .I ee_origin
is the origin code of where the error originated. is the origin code of where the error originated.
The other fields are protocol specific. The macro The other fields are protocol specific. The macro
.B SO_EE_OFFENDER .B SO_EE_OFFENDER
@ -427,15 +427,15 @@ where the error originated from given a pointer to the ancillary message.
If this address is not known, the If this address is not known, the
.I sa_family .I sa_family
member of the member of the
.B sockaddr .I sockaddr
contains contains
.B AF_UNSPEC .B AF_UNSPEC
and the other fields of the and the other fields of the
.B sockaddr .I sockaddr
are undefined. are undefined.
.IP .IP
IP uses the IP uses the
.B sock_extended_err .I sock_extended_err
structure as follows: structure as follows:
.I ee_origin .I ee_origin
is set to is set to
@ -594,8 +594,8 @@ packets should be looped back to the local sockets.
.\" .\"
.TP .TP
.B IP_ADD_MEMBERSHIP .B IP_ADD_MEMBERSHIP
Join a multicast group. Argument is a Join a multicast group. Argument is an
.B struct ip_mreqn .I ip_mreqn
structure. structure.
.PP .PP
.RS .RS
@ -625,9 +625,9 @@ is the interface index of the interface that should join/leave the
group, or 0 to indicate any interface. group, or 0 to indicate any interface.
.IP .IP
For compatibility, the old For compatibility, the old
.B ip_mreq .I ip_mreq
structure is still supported. It differs from structure is still supported. It differs from
.B ip_mreqn .I ip_mreqn
only by not including only by not including
the the
.I imr_ifindex .I imr_ifindex
@ -637,18 +637,18 @@ field. Only valid as a
.TP .TP
.B IP_DROP_MEMBERSHIP .B IP_DROP_MEMBERSHIP
Leave a multicast group. Argument is an Leave a multicast group. Argument is an
.B ip_mreqn .I ip_mreqn
or or
.B ip_mreq .I ip_mreq
structure similar to structure similar to
.IR IP_ADD_MEMBERSHIP . .IR IP_ADD_MEMBERSHIP .
.\" .\"
.TP .TP
.B IP_MULTICAST_IF .B IP_MULTICAST_IF
Set the local device for a multicast socket. Argument is an Set the local device for a multicast socket. Argument is an
.B ip_mreqn .I ip_mreqn
or or
.B ip_mreq .I ip_mreq
structure similar to structure similar to
.IR IP_ADD_MEMBERSHIP . .IR IP_ADD_MEMBERSHIP .
.IP .IP
@ -659,7 +659,7 @@ is returned.
The IP protocol The IP protocol
supports the sysctl interface to configure some global options. The sysctls supports the sysctl interface to configure some global options. The sysctls
can be accessed by reading or writing the can be accessed by reading or writing the
.B /proc/sys/net/ipv4/* .I /proc/sys/net/ipv4/*
files or using the files or using the
.\" FIXME As at 2.6.12, 14 Jun 2005, the following are undocumented: .\" FIXME As at 2.6.12, 14 Jun 2005, the following are undocumented:
.\" ip_queue_maxlen .\" ip_queue_maxlen
@ -926,7 +926,7 @@ are new options in Linux 2.2.
They are also all Linux specific and should not be used in They are also all Linux specific and should not be used in
programs intended to be portable. programs intended to be portable.
.PP .PP
.B struct ip_mreqn .I struct ip_mreqn
is new in Linux 2.2. Linux 2.0 only supported is new in Linux 2.2. Linux 2.0 only supported
.BR ip_mreq . .BR ip_mreq .
.PP .PP
@ -940,7 +940,7 @@ socket. This is deprecated and should be replaced by
.BI "socket(PF_PACKET, SOCK_RAW, " protocol ) .BI "socket(PF_PACKET, SOCK_RAW, " protocol )
instead. The main difference is the instead. The main difference is the
new new
.B sockaddr_ll .I sockaddr_ll
address structure for generic link layer information instead of the old address structure for generic link layer information instead of the old
.BR sockaddr_pkt . .BR sockaddr_pkt .
.SH BUGS .SH BUGS

View File

@ -77,7 +77,7 @@ struct in6_addr {
.sp .sp
.B sin6_family .B sin6_family
is always set to is always set to
.B AF_INET6; .BR AF_INET6 ;
.B sin6_port .B sin6_port
is the protocol port (see is the protocol port (see
.B sin_port .B sin_port
@ -143,7 +143,7 @@ socket into a socket of a different address family. Only
is currently supported for that. It is only allowed for IPv6 sockets is currently supported for that. It is only allowed for IPv6 sockets
that are connected and bound to a v4-mapped-on-v6 address. The argument that are connected and bound to a v4-mapped-on-v6 address. The argument
is a pointer to a integer containing is a pointer to a integer containing
.B AF_INET. .BR AF_INET .
This is useful to pass v4-mapped sockets as file descriptors to This is useful to pass v4-mapped sockets as file descriptors to
programs that don't know how to deal with the IPv6 API. programs that don't know how to deal with the IPv6 API.
.TP .TP
@ -189,7 +189,7 @@ Argument is a pointer to boolean.
.TP .TP
.B IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP .B IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP
Control membership in multicast groups. Argument is a pointer to a Control membership in multicast groups. Argument is a pointer to a
.B struct ipv6_mreq .I struct ipv6_mreq
structure. structure.
.TP .TP
.B IPV6_MTU .B IPV6_MTU
@ -239,13 +239,13 @@ when the passed address length contains it. Some programs that pass a
longer address buffer and then check the outgoing address length may break. longer address buffer and then check the outgoing address length may break.
.SH "PORTING NOTES" .SH "PORTING NOTES"
The The
.B sockaddr_in6 .I sockaddr_in6
structure is bigger than the generic structure is bigger than the generic
.B sockaddr. .BR sockaddr .
Programs that assume that all address types can be stored safely in a Programs that assume that all address types can be stored safely in a
.B struct sockaddr .I struct sockaddr
need to be changed to use need to be changed to use
.B struct sockaddr_storage .I struct sockaddr_storage
for that instead. for that instead.
.SH BUGS .SH BUGS
The IPv6 extended API as in RFC\ 2292 is currently only partly implemented; The IPv6 extended API as in RFC\ 2292 is currently only partly implemented;

View File

@ -135,7 +135,7 @@ the value of
is used. is used.
.PP .PP
Values about local numeric formatting is made available in a Values about local numeric formatting is made available in a
.B struct lconv .I struct lconv
returned by the returned by the
.BR localeconv () .BR localeconv ()
function, which has the following declaration: function, which has the following declaration:

View File

@ -74,7 +74,7 @@ are passed to a packet socket. To only get packets from a specific interface
use use
.BR bind (2) .BR bind (2)
specifying an address in a specifying an address in a
.B struct sockaddr_ll .I struct sockaddr_ll
to bind the packet socket to an interface. Only the to bind the packet socket to an interface. Only the
.B sll_protocol .B sll_protocol
and the and the
@ -219,7 +219,7 @@ can be used for the same purpose.
.B SIOCGSTAMP .B SIOCGSTAMP
can be used to receive the time stamp of the last received packet. Argument can be used to receive the time stamp of the last received packet. Argument
is a is a
.B struct timeval. .I struct timeval.
In addition all standard ioctls defined in In addition all standard ioctls defined in
.BR netdevice (7) .BR netdevice (7)
@ -239,7 +239,7 @@ This is still supported but strongly deprecated.
The main difference between the two methods is that The main difference between the two methods is that
.B SOCK_PACKET .B SOCK_PACKET
uses the old uses the old
.B struct sockaddr_pkt .I struct sockaddr_pkt
to specify an interface, which doesn't provide physical layer independence. to specify an interface, which doesn't provide physical layer independence.
.RS .RS
@ -289,7 +289,7 @@ multiplexed on the DSAP/SSAP protocol fields; instead they are supplied to the
user as protocol user as protocol
.B ETH_P_802_2 .B ETH_P_802_2
with the LLC header prepended. It is thus not possible to bind to with the LLC header prepended. It is thus not possible to bind to
.B ETH_P_802_3; .BR ETH_P_802_3 ;
bind to bind to
.B ETH_P_802_2 .B ETH_P_802_2
instead and do the protocol multiplex yourself. instead and do the protocol multiplex yourself.

View File

@ -140,7 +140,7 @@ A raw socket can be bound to a specific local address using the
.BR bind (2) .BR bind (2)
call. If it isn't bound all packets with the specified IP protocol are received. call. If it isn't bound all packets with the specified IP protocol are received.
In addition a RAW socket can be bound to a specific network device using In addition a RAW socket can be bound to a specific network device using
.B SO_BINDTODEVICE; .BR SO_BINDTODEVICE ;
see see
.BR socket (7). .BR socket (7).
@ -174,7 +174,7 @@ RAW sockets are generally rather unportable and should be avoided in programs
intended to be portable. 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; .BR 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
.BR IP_HDRINCL . .BR IP_HDRINCL .

View File

@ -133,7 +133,7 @@ struct ifaddrmsg
is the address family type (currently is the address family type (currently
.B AF_INET .B AF_INET
or or
.B AF_INET6), .BR AF_INET6 ),
.B ifa_prefixlen .B ifa_prefixlen
is the length of the address mask of the address if defined for the is the length of the address mask of the address if defined for the
family (like for IPv4), family (like for IPv4),
@ -402,16 +402,16 @@ If the
field is field is
.B NDA_CACHEINFO .B NDA_CACHEINFO
then a then a
.B struct nda_cacheinfo .I struct nda_cacheinfo
header follows header follows
.TP .TP
.BR RTM_NEWRULE ", " RTM_DELRULE ", " RTM_GETRULE .BR RTM_NEWRULE ", " RTM_DELRULE ", " RTM_GETRULE
Add, delete or retrieve a routing rule. Carries a Add, delete or retrieve a routing rule. Carries a
.B struct rtmsg .I struct rtmsg
.TP .TP
.BR RTM_NEWQDISC ", " RTM_DELQDISC ", " RTM_GETQDISC .BR RTM_NEWQDISC ", " RTM_DELQDISC ", " RTM_GETQDISC
Add, remove or get a queueing discipline. The message contains a Add, remove or get a queueing discipline. The message contains a
.B struct tcmsg .I struct tcmsg
and may be followed by a series of and may be followed by a series of
attributes. attributes.
@ -447,13 +447,13 @@ For more information see the appropriate include files.
.TP .TP
.BR RTM_NEWTCLASS ", " RTM_DELTCLASS ", " RTM_GETTCLASS .BR RTM_NEWTCLASS ", " RTM_DELTCLASS ", " RTM_GETTCLASS
Add, remove or get a traffic class. These messages contain a Add, remove or get a traffic class. These messages contain a
.B struct tcmsg .I struct tcmsg
as described above. as described above.
.TP .TP
.BR RTM_NEWTFILTER ", " RTM_DELTFILTER ", " RTM_GETTFILTER .BR RTM_NEWTFILTER ", " RTM_DELTFILTER ", " RTM_GETTFILTER
Add, remove or receive information about a traffic filter. These Add, remove or receive information about a traffic filter. These
messages contain a messages contain a
.B struct tcmsg .I struct tcmsg
as described above. as described above.
.SH VERSIONS .SH VERSIONS
.B rtnetlink .B rtnetlink

View File

@ -281,7 +281,7 @@ of the call to
or or
.BR socketpair (2). .BR socketpair (2).
Argument is a Argument is a
.B ucred .I ucred
structure. structure.
Only valid as a Only valid as a
.BR getsockopt (). .BR getsockopt ().
@ -372,7 +372,7 @@ sysctl.
Sets or gets the Sets or gets the
.B SO_LINGER .B SO_LINGER
option. The argument is a option. The argument is a
.B linger .I linger
structure. structure.
.PP .PP
.RS .RS
@ -457,7 +457,7 @@ signal later.
.\" .SH ANCILLARY MESSAGES .\" .SH ANCILLARY MESSAGES
.SH SYSCTLS .SH SYSCTLS
The core socket networking sysctls can be accessed using the The core socket networking sysctls can be accessed using the
.B /proc/sys/net/core/* .I /proc/sys/net/core/*
files or with the files or with the
.BR sysctl (2) .BR sysctl (2)
interface. interface.
@ -504,12 +504,12 @@ These operations can be accessed using
.TP .TP
.B SIOCGSTAMP .B SIOCGSTAMP
Return a Return a
.B struct timeval .I struct timeval
with the receive timestamp of the last packet passed to the user. This is useful with the receive timestamp of the last packet passed to the user. This is useful
for accurate round trip time measurements. See for accurate round trip time measurements. See
.BR setitimer (2) .BR setitimer (2)
for a description of for a description of
.BR "struct timeval" . .IR "struct timeval" .
.\" .\"
.TP .TP
.BR SIOCSPGRP .BR SIOCSPGRP

View File

@ -146,7 +146,7 @@ communication; broadcasting and multicasting are not
supported. supported.
.SH SYSCTLS .SH SYSCTLS
These variables can be accessed by the These variables can be accessed by the
.B /proc/sys/net/ipv4/* .I /proc/sys/net/ipv4/*
files or with the files or with the
.BR sysctl (2) .BR sysctl (2)
interface. In addition, most IP sysctls also apply to TCP; see interface. In addition, most IP sysctls also apply to TCP; see
@ -339,7 +339,7 @@ exceeds this number of pages, TCP moderates its memory
consumption. This memory pressure state is exited consumption. This memory pressure state is exited
once the number of pages allocated falls below once the number of pages allocated falls below
the the
.B low .I low
mark. mark.
.I high .I high

View File

@ -127,7 +127,7 @@ The passed file descriptors behave as though they have been created with
.B SCM_CREDENTIALS .B SCM_CREDENTIALS
Send or receive Unix credentials. This can be used for authentication. Send or receive Unix credentials. This can be used for authentication.
The credentials are passed as a The credentials are passed as a
.B struct ucred .I struct ucred
ancillary message. ancillary message.
.RS .RS
@ -151,7 +151,7 @@ its user ID, effective user ID, or saved set-user-ID (unless it has
and its group ID, effective group ID, or saved set-group-ID (unless it has and its group ID, effective group ID, or saved set-group-ID (unless it has
.BR CAP_SETGID ). .BR CAP_SETGID ).
To receive a To receive a
.B struct ucred .I struct ucred
message the message the
.B SO_PASSCRED .B SO_PASSCRED
option must be enabled on the socket. option must be enabled on the socket.
@ -249,7 +249,7 @@ User memory address was not valid.
.TP .TP
.B EPERM .B EPERM
The sender passed invalid credentials in the The sender passed invalid credentials in the
.BR "struct ucred" . .IR "struct ucred" .
.PP .PP
Other errors can be generated by the generic socket layer or Other errors can be generated by the generic socket layer or
by the filesystem while generating a filesystem socket object. See by the filesystem while generating a filesystem socket object. See

View File

@ -40,7 +40,7 @@ occurs, the X.25 connection will be reset.
The The
.B AF_X25 .B AF_X25
socket address family uses the socket address family uses the
.B struct sockaddr_x25 .I struct sockaddr_x25
for representing network addresses as defined in ITU-T for representing network addresses as defined in ITU-T
recommendation X.121. recommendation X.121.
.PP .PP

View File

@ -21,7 +21,7 @@ The program
.B ld.so .B ld.so
handles a.out binaries, a format used long ago; handles a.out binaries, a format used long ago;
.B ld-linux.so* .B ld-linux.so*
handles ELF (\fB/lib/ld-linux.so.1\fP for libc5, \fB/lib/ld-linux.so.2\fP handles ELF (\fI/lib/ld-linux.so.1\fP for libc5, \fI/lib/ld-linux.so.2\fP
for glibc2), which everybody has been using for years now. for glibc2), which everybody has been using for years now.
Otherwise both have the same behaviour, and use the same Otherwise both have the same behaviour, and use the same
support files and programs support files and programs
@ -46,16 +46,16 @@ in which case it is ignored.
of the binary if present. of the binary if present.
.IP o .IP o
From the cache file From the cache file
.BR /etc/ld.so.cache .IR /etc/ld.so.cache
which contains a compiled list of candidate libraries previously found which contains a compiled list of candidate libraries previously found
in the augmented library path. If, however, the binary was linked with in the augmented library path. If, however, the binary was linked with
.B \-z nodeflib .B \-z nodeflib
linker option, libraries in the default library paths are skipped. linker option, libraries in the default library paths are skipped.
.IP o .IP o
In the default path In the default path
.BR /lib , .IR /lib ,
and then and then
.BR /usr/lib . .IR /usr/lib .
If the binary was linked with If the binary was linked with
.B \-z nodeflib .B \-z nodeflib
linker option, this step is skipped. linker option, this step is skipped.
@ -67,7 +67,7 @@ which is stored in the
.B .interp .B .interp
section of the program is executed) or directly by running: section of the program is executed) or directly by running:
.P .P
.B /lib/ld-linux.so.* .I /lib/ld-linux.so.*
[OPTIONS] [PROGRAM [ARGUMENTS]] [OPTIONS] [PROGRAM [ARGUMENTS]]
.SH COMMAND LINE OPTIONS .SH COMMAND LINE OPTIONS
.TP .TP
@ -217,17 +217,17 @@ when none is present.
.SH FILES .SH FILES
.PD 0 .PD 0
.TP .TP
.B /lib/ld.so .I /lib/ld.so
a.out dynamic linker/loader a.out dynamic linker/loader
.TP .TP
.BR /lib/ld\-linux.so. { 1 , 2 } .IR /lib/ld\-linux.so. { 1 , 2 }
ELF dynamic linker/loader ELF dynamic linker/loader
.TP .TP
.B /etc/ld.so.cache .I /etc/ld.so.cache
File containing a compiled list of directories in which to search for File containing a compiled list of directories in which to search for
libraries and an ordered list of candidate libraries. libraries and an ordered list of candidate libraries.
.TP .TP
.B /etc/ld.so.preload .I /etc/ld.so.preload
File containing a whitespace separated list of ELF shared libraries to File containing a whitespace separated list of ELF shared libraries to
be loaded before the program. be loaded before the program.
libraries and an ordered list of candidate libraries. libraries and an ordered list of candidate libraries.

View File

@ -81,11 +81,11 @@ Some existing libs do not contain enough information to allow the deduction of
their type. Therefore, the their type. Therefore, the
.IR /etc/ld.so.conf .IR /etc/ld.so.conf
file format allows the specification of an expected type. This is file format allows the specification of an expected type. This is
.B only .I only
used for those ELF libs which we can not work out. The format used for those ELF libs which we can not work out. The format
is "dirname=TYPE", where TYPE can be libc4, libc5, or libc6. is "dirname=TYPE", where TYPE can be libc4, libc5, or libc6.
(This syntax also works on the command line.) Spaces are (This syntax also works on the command line.) Spaces are
.B not .I not
allowed. Also see the allowed. Also see the
.B \-p .B \-p
option. option.
@ -137,7 +137,7 @@ instead of
.TP .TP
.B \-r root .B \-r root
Change to and use Change to and use
.B root .I root
as the root directory. as the root directory.
.TP .TP
.B \-l .B \-l
@ -151,15 +151,15 @@ the current cache.
.SH FILES .SH FILES
.PD 0 .PD 0
.TP 20 .TP 20
.B /lib/ld.so .I /lib/ld.so
run-time linker/loader run-time linker/loader
.TP 20 .TP 20
.B /etc/ld.so.conf .I /etc/ld.so.conf
File containing a list of colon, space, tab, newline, or comma-separated File containing a list of colon, space, tab, newline, or comma-separated
directories in which to search for libraries. directories in which to search for libraries.
.TP 20 .TP 20
.B /etc/ld.so.cache .I /etc/ld.so.cache
File containing an ordered list of libraries found in the directories File containing an ordered list of libraries found in the directories
specified in specified in
.BR /etc/ld.so.conf . .IR /etc/ld.so.conf .
.PD .PD