mirror of https://github.com/mkerrisk/man-pages
ioctl_list.2, sched_yield.2, vm86.2, backtrace.3, catopen.3, daemon.3, dl_iterate_phdr.3, fnmatch.3, getfsent.3, glob.3, grantpt.3, infnan.3, putgrent.3, setaliasent.3, shm_open.3, stdin.3, ttyS.4: Convert inline formatting (\fX...\fP) to dot-directive formatting
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
40aa0db03c
commit
c994238936
|
@ -85,7 +85,8 @@ followed by an 8-bit type (collecting the ioctls in groups
|
||||||
for a common purpose or a common driver), and an 8-bit
|
for a common purpose or a common driver), and an 8-bit
|
||||||
serial number.
|
serial number.
|
||||||
.LP
|
.LP
|
||||||
The macros describing this structure live in \fI<asm/ioctl.h>\fP
|
The macros describing this structure live in
|
||||||
|
.I <asm/ioctl.h>
|
||||||
and are
|
and are
|
||||||
.B _IO(type,nr)
|
.B _IO(type,nr)
|
||||||
and
|
and
|
||||||
|
|
|
@ -61,7 +61,8 @@ POSIX systems on which
|
||||||
.BR sched_yield ()
|
.BR sched_yield ()
|
||||||
is available define
|
is available define
|
||||||
.B _POSIX_PRIORITY_SCHEDULING
|
.B _POSIX_PRIORITY_SCHEDULING
|
||||||
in \fI<unistd.h>\fP.
|
in
|
||||||
|
.IR <unistd.h> .
|
||||||
|
|
||||||
Strategic calls to
|
Strategic calls to
|
||||||
.BR sched_yield ()
|
.BR sched_yield ()
|
||||||
|
|
|
@ -41,7 +41,9 @@ In Linux 2.1.15 and 2.0.28 it was renamed to
|
||||||
and a new
|
and a new
|
||||||
.BR vm86 ()
|
.BR vm86 ()
|
||||||
was introduced.
|
was introduced.
|
||||||
The definition of \fIstruct vm86_struct\fP was changed
|
The definition of
|
||||||
|
.IR "struct vm86_struct"
|
||||||
|
was changed
|
||||||
in 1.1.8 and 1.1.9.
|
in 1.1.8 and 1.1.9.
|
||||||
.LP
|
.LP
|
||||||
These calls cause the process to enter VM86 mode (virtual-8086 in Intel
|
These calls cause the process to enter VM86 mode (virtual-8086 in Intel
|
||||||
|
|
|
@ -56,7 +56,9 @@ A backtrace is the series of currently active function calls for
|
||||||
the program.
|
the program.
|
||||||
Each item in the array pointed to by
|
Each item in the array pointed to by
|
||||||
.I buffer
|
.I buffer
|
||||||
is of type \fIvoid *\fP, and is the return address from
|
is of type
|
||||||
|
.IR "void\ *" ,
|
||||||
|
and is the return address from
|
||||||
the corresponding stack frame.
|
the corresponding stack frame.
|
||||||
The
|
The
|
||||||
.I size
|
.I size
|
||||||
|
|
|
@ -115,7 +115,8 @@ The function
|
||||||
returns a message catalog descriptor of type
|
returns a message catalog descriptor of type
|
||||||
.I nl_catd
|
.I nl_catd
|
||||||
on success.
|
on success.
|
||||||
On failure, it returns \fI(nl_catd)\ \-1\fP
|
On failure, it returns
|
||||||
|
.IR "(nl_catd)\ \-1"
|
||||||
and sets
|
and sets
|
||||||
.I errno
|
.I errno
|
||||||
to indicate the error.
|
to indicate the error.
|
||||||
|
|
|
@ -67,7 +67,8 @@ If
|
||||||
is zero,
|
is zero,
|
||||||
.BR daemon ()
|
.BR daemon ()
|
||||||
redirects standard input, standard output and standard error
|
redirects standard input, standard output and standard error
|
||||||
to \fI/dev/null\fP;
|
to
|
||||||
|
.IR /dev/null ;
|
||||||
otherwise, no changes are made to these file descriptors.
|
otherwise, no changes are made to these file descriptors.
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
(This function forks, and if the
|
(This function forks, and if the
|
||||||
|
|
|
@ -30,11 +30,10 @@ dl_iterate_phdr \- walk through list of shared objects
|
||||||
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
|
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
|
||||||
.B #include <link.h>
|
.B #include <link.h>
|
||||||
|
|
||||||
\fBint dl_iterate_phdr(\fP
|
.BI "int dl_iterate_phdr("
|
||||||
\fBint (*\fPcallback\fB) \
|
.BI " int (*" callback ") (struct dl_phdr_info *" info ,
|
||||||
(struct dl_phdr_info *\fPinfo\fB,\fP
|
.BI " size_t " size ", void *" data ,
|
||||||
\fBsize_t\fP size\fB, void *\fPdata\fB),\fP
|
.BI " void *" data ;
|
||||||
\fBvoid *\fPdata\fB);\fP
|
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The
|
The
|
||||||
|
|
|
@ -72,7 +72,8 @@ or if both
|
||||||
is set and the period immediately follows a slash.
|
is set and the period immediately follows a slash.
|
||||||
.TP
|
.TP
|
||||||
.B FNM_FILE_NAME
|
.B FNM_FILE_NAME
|
||||||
This is a GNU synonym for \fBFNM_PATHNAME\fR.
|
This is a GNU synonym for
|
||||||
|
.BR FNM_PATHNAME .
|
||||||
.TP
|
.TP
|
||||||
.B FNM_LEADING_DIR
|
.B FNM_LEADING_DIR
|
||||||
If this flag (a GNU extension) is set, the pattern is considered to be
|
If this flag (a GNU extension) is set, the pattern is considered to be
|
||||||
|
|
|
@ -42,7 +42,9 @@ getfsent, getfsspec, getfsfile, setfsent, endfsent \- handle fstab entries
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
These functions read from the file
|
These functions read from the file
|
||||||
.IR /etc/fstab .
|
.IR /etc/fstab .
|
||||||
The \fIstruct fstab\fP is defined by:
|
The
|
||||||
|
.IR "struct fstab"
|
||||||
|
is defined by:
|
||||||
.LP
|
.LP
|
||||||
.in +4n
|
.in +4n
|
||||||
.nf
|
.nf
|
||||||
|
@ -100,7 +102,9 @@ Upon success, the functions
|
||||||
.BR getfsfile (),
|
.BR getfsfile (),
|
||||||
and
|
and
|
||||||
.BR getfsspec ()
|
.BR getfsspec ()
|
||||||
return a pointer to a \fIstruct fstab\fP, while
|
return a pointer to a
|
||||||
|
.IR "struct fstab" ,
|
||||||
|
while
|
||||||
.BR setfsent ()
|
.BR setfsent ()
|
||||||
returns 1.
|
returns 1.
|
||||||
Upon failure or end-of-file, these functions return NULL and 0, respectively.
|
Upon failure or end-of-file, these functions return NULL and 0, respectively.
|
||||||
|
@ -114,8 +118,10 @@ Several operating systems have them,
|
||||||
e.g., *BSD, SunOS, Digital UNIX, AIX (which also has a
|
e.g., *BSD, SunOS, Digital UNIX, AIX (which also has a
|
||||||
.BR getfstype ()).
|
.BR getfstype ()).
|
||||||
HP-UX has functions of the same names,
|
HP-UX has functions of the same names,
|
||||||
that however use a \fIstruct checklist\fP
|
that however use a
|
||||||
instead of a \fIstruct fstab\fP,
|
.IR "struct checklist"
|
||||||
|
instead of a
|
||||||
|
.IR "struct fstab" ,
|
||||||
and calls these functions obsolete, superseded by
|
and calls these functions obsolete, superseded by
|
||||||
.BR getmntent (3).
|
.BR getmntent (3).
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
|
|
|
@ -159,7 +159,8 @@ functions.
|
||||||
.B GLOB_BRACE
|
.B GLOB_BRACE
|
||||||
Expand
|
Expand
|
||||||
.BR csh (1)
|
.BR csh (1)
|
||||||
style brace expressions of the form \fB{a,b}\fR.
|
style brace expressions of the form
|
||||||
|
.BR {a,b} .
|
||||||
Brace expressions can be nested.
|
Brace expressions can be nested.
|
||||||
Thus, for example, specifying the pattern
|
Thus, for example, specifying the pattern
|
||||||
"{foo/{,cat,dog},bar}" would return the same results as four separate
|
"{foo/{,cat,dog},bar}" would return the same results as four separate
|
||||||
|
@ -253,7 +254,9 @@ on the second and later invocations.
|
||||||
.PP
|
.PP
|
||||||
As a GNU extension,
|
As a GNU extension,
|
||||||
.I pglob\->gl_flags
|
.I pglob\->gl_flags
|
||||||
is set to the flags specified, \fBor\fRed with
|
is set to the flags specified,
|
||||||
|
.BR or ed
|
||||||
|
with
|
||||||
.B GLOB_MAGCHAR
|
.B GLOB_MAGCHAR
|
||||||
if any metacharacters were found.
|
if any metacharacters were found.
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
|
|
|
@ -20,7 +20,8 @@ function changes the mode and owner of the slave pseudoterminal device
|
||||||
corresponding to the master pseudoterminal referred to by
|
corresponding to the master pseudoterminal referred to by
|
||||||
.IR fd .
|
.IR fd .
|
||||||
The user ID of the slave is set to the real UID of the calling process.
|
The user ID of the slave is set to the real UID of the calling process.
|
||||||
The group ID is set to an unspecified value (e.g., \fItty\fP).
|
The group ID is set to an unspecified value (e.g.,
|
||||||
|
.IR tty ).
|
||||||
The mode of the slave is set to 0620 (crw\-\-w\-\-\-\-).
|
The mode of the slave is set to 0620 (crw\-\-w\-\-\-\-).
|
||||||
.PP
|
.PP
|
||||||
The behavior of
|
The behavior of
|
||||||
|
|
|
@ -64,7 +64,11 @@ is returned.
|
||||||
.PP
|
.PP
|
||||||
If
|
If
|
||||||
.I error
|
.I error
|
||||||
is \-\fBERANGE\fP (\-Infinity), \-\fBHUGE_VAL\fP is returned.
|
is
|
||||||
|
.RB \- ERANGE
|
||||||
|
(\-Infinity),
|
||||||
|
.RB \- HUGE_VAL
|
||||||
|
is returned.
|
||||||
.PP
|
.PP
|
||||||
If
|
If
|
||||||
.I error
|
.I error
|
||||||
|
|
|
@ -18,12 +18,16 @@ The
|
||||||
.BR putgrent ()
|
.BR putgrent ()
|
||||||
function is the counterpart for
|
function is the counterpart for
|
||||||
.BR fgetgrent (3).
|
.BR fgetgrent (3).
|
||||||
The function writes the content of the provided \fIstruct group\fP into the
|
The function writes the content of the provided
|
||||||
|
.IR "struct group"
|
||||||
|
into the
|
||||||
file pointed to by
|
file pointed to by
|
||||||
.IR fp .
|
.IR fp .
|
||||||
The list of group members must be NULL-terminated or NULL-initialized.
|
The list of group members must be NULL-terminated or NULL-initialized.
|
||||||
.sp
|
.sp
|
||||||
The \fIstruct group\fP is defined as follows:
|
The
|
||||||
|
.IR "struct group"
|
||||||
|
is defined as follows:
|
||||||
.sp
|
.sp
|
||||||
.in +4n
|
.in +4n
|
||||||
.nf
|
.nf
|
||||||
|
|
|
@ -31,7 +31,8 @@ getaliasbyname, getaliasbyname_r \- read an alias entry
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
One of the databases available with the Name Service Switch (NSS)
|
One of the databases available with the Name Service Switch (NSS)
|
||||||
is the aliases database, that contains mail aliases.
|
is the aliases database, that contains mail aliases.
|
||||||
(To find out which databases are supported, try \fIgetent \-\-help\fP.)
|
(To find out which databases are supported, try
|
||||||
|
.IR "getent \-\-help" .)
|
||||||
Six functions are provided to access the aliases database.
|
Six functions are provided to access the aliases database.
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
|
|
|
@ -83,7 +83,9 @@ and any of the other flags listed here:
|
||||||
Open the object for read access.
|
Open the object for read access.
|
||||||
A shared memory object opened in this way can be
|
A shared memory object opened in this way can be
|
||||||
.BR mmap (2)ed
|
.BR mmap (2)ed
|
||||||
only for read (\fBPROT_READ\fP) access.
|
only for read
|
||||||
|
.RB ( PROT_READ )
|
||||||
|
access.
|
||||||
.TP
|
.TP
|
||||||
.B O_RDWR
|
.B O_RDWR
|
||||||
Open the object for read-write access.
|
Open the object for read-write access.
|
||||||
|
|
|
@ -74,7 +74,7 @@ The preprocessor symbols
|
||||||
and
|
and
|
||||||
.B STDERR_FILENO
|
.B STDERR_FILENO
|
||||||
are defined with these values in
|
are defined with these values in
|
||||||
\fI<unistd.h>\fP.
|
.IR <unistd.h> .
|
||||||
(Applying
|
(Applying
|
||||||
.BR freopen (3)
|
.BR freopen (3)
|
||||||
to one of these streams can change the file descriptor number
|
to one of these streams can change the file descriptor number
|
||||||
|
|
|
@ -27,7 +27,8 @@
|
||||||
.SH NAME
|
.SH NAME
|
||||||
ttyS \- serial terminal lines
|
ttyS \- serial terminal lines
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
\fBttyS[0\-3]\fP are character devices for the serial terminal lines.
|
.B ttyS[0\-3]
|
||||||
|
are character devices for the serial terminal lines.
|
||||||
.LP
|
.LP
|
||||||
They are typically created by:
|
They are typically created by:
|
||||||
.RS
|
.RS
|
||||||
|
|
Loading…
Reference in New Issue