mirror of https://github.com/mkerrisk/man-pages
ffix
This commit is contained in:
parent
0ff8384a43
commit
0c2ec4f115
|
@ -261,7 +261,7 @@ do not do this.
|
||||||
This causes problems both when Linux code which reads
|
This causes problems both when Linux code which reads
|
||||||
.I timeout
|
.I timeout
|
||||||
is ported to other operating systems, and when code is ported to Linux
|
is ported to other operating systems, and when code is ported to Linux
|
||||||
that reuses a struct timeval for multiple
|
that reuses a \fIstruct timeval\fP for multiple
|
||||||
.BR select ()s
|
.BR select ()s
|
||||||
in a loop without reinitializing it.
|
in a loop without reinitializing it.
|
||||||
Consider
|
Consider
|
||||||
|
|
|
@ -53,7 +53,7 @@ the only field in the structure pointed to by
|
||||||
.I aiocbp
|
.I aiocbp
|
||||||
that is used by this call is the
|
that is used by this call is the
|
||||||
.I aio_sigevent
|
.I aio_sigevent
|
||||||
field (a struct sigevent) that indicates the desired type of
|
field (a \fIstruct sigevent\fP) that indicates the desired type of
|
||||||
asynchronous notification at completion.
|
asynchronous notification at completion.
|
||||||
All other fields are ignored.
|
All other fields are ignored.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
|
|
|
@ -45,7 +45,7 @@ finds the resolution (precision) of the specified clock
|
||||||
.IR clk_id ,
|
.IR clk_id ,
|
||||||
and, if
|
and, if
|
||||||
.I res
|
.I res
|
||||||
is non-NULL, stores it in the struct timespec pointed to by
|
is non-NULL, stores it in the \fIstruct timespec\fP pointed to by
|
||||||
.IR res .
|
.IR res .
|
||||||
The resolution of clocks depends on the implementation and cannot be
|
The resolution of clocks depends on the implementation and cannot be
|
||||||
configured by a particular process.
|
configured by a particular process.
|
||||||
|
|
|
@ -257,7 +257,7 @@ a 0 in
|
||||||
.I tm_mday
|
.I tm_mday
|
||||||
is interpreted as meaning the last day of the preceding month.
|
is interpreted as meaning the last day of the preceding month.
|
||||||
.LP
|
.LP
|
||||||
The glibc version of struct tm has additional fields
|
The glibc version of \fIstruct tm\fP has additional fields
|
||||||
.sp
|
.sp
|
||||||
.RS
|
.RS
|
||||||
.nf
|
.nf
|
||||||
|
|
|
@ -40,7 +40,7 @@ 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 struct fstab is defined by
|
The \fIstruct fstab\fP is defined by
|
||||||
.LP
|
.LP
|
||||||
.nf
|
.nf
|
||||||
struct fstab {
|
struct fstab {
|
||||||
|
@ -95,7 +95,7 @@ Upon success, the functions
|
||||||
.BR getfsfile (),
|
.BR getfsfile (),
|
||||||
and
|
and
|
||||||
.BR getfsspec ()
|
.BR getfsspec ()
|
||||||
return a pointer to a struct fstab, while
|
return a pointer to a \fIstruct fstab\fP, 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.
|
||||||
|
@ -108,8 +108,10 @@ These functions are not in POSIX.1-2001.
|
||||||
Several operating systems have them,
|
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, that however use a struct checklist
|
HP-UX has functions of the same names,
|
||||||
instead of a struct fstab, and calls these functions obsolete, superseded by
|
that however use a \fIstruct checklist\fP
|
||||||
|
instead of a \fIstruct fstab\fP,
|
||||||
|
and calls these functions obsolete, superseded by
|
||||||
.BR getmntent (3).
|
.BR getmntent (3).
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
These functions are not thread-safe.
|
These functions are not thread-safe.
|
||||||
|
|
|
@ -74,21 +74,21 @@ The reentrant functions described here return all of that in
|
||||||
caller-provided buffers.
|
caller-provided buffers.
|
||||||
First of all there is the buffer
|
First of all there is the buffer
|
||||||
.I gbuf
|
.I gbuf
|
||||||
that can hold a struct group.
|
that can hold a \fIstruct group\fP.
|
||||||
And next the buffer
|
And next the buffer
|
||||||
.I buf
|
.I buf
|
||||||
of size
|
of size
|
||||||
.I buflen
|
.I buflen
|
||||||
that can hold additional strings.
|
that can hold additional strings.
|
||||||
The result of these functions, the struct group read from the stream,
|
The result of these functions, the \fIstruct group\fP read from the stream,
|
||||||
is stored in the provided buffer
|
is stored in the provided buffer
|
||||||
.RI * gbuf ,
|
.RI * gbuf ,
|
||||||
and a pointer to this struct group is returned in
|
and a pointer to this \fIstruct group\fP is returned in
|
||||||
.RI * gbufp .
|
.RI * gbufp .
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success, these functions return 0 and
|
On success, these functions return 0 and
|
||||||
.RI * gbufp
|
.RI * gbufp
|
||||||
is a pointer to the struct group.
|
is a pointer to the \fIstruct group\fP.
|
||||||
On error, these functions return an error value and
|
On error, these functions return an error value and
|
||||||
.RI * gbufp
|
.RI * gbufp
|
||||||
is NULL.
|
is NULL.
|
||||||
|
|
|
@ -99,7 +99,7 @@ The reentrant
|
||||||
.BR getmntent_r ()
|
.BR getmntent_r ()
|
||||||
function is similar to
|
function is similar to
|
||||||
.BR getmntent (),
|
.BR getmntent (),
|
||||||
but stores the struct mount in the provided
|
but stores the \fIstruct mount\fP in the provided
|
||||||
.RI * mntbuf
|
.RI * mntbuf
|
||||||
and stores the strings pointed to by the entries in that struct
|
and stores the strings pointed to by the entries in that struct
|
||||||
in the provided array
|
in the provided array
|
||||||
|
|
|
@ -76,21 +76,21 @@ The reentrant functions described here return all of that in
|
||||||
caller-provided buffers.
|
caller-provided buffers.
|
||||||
First of all there is the buffer
|
First of all there is the buffer
|
||||||
.I pwbuf
|
.I pwbuf
|
||||||
that can hold a struct passwd.
|
that can hold a \fIstruct passwd\fP.
|
||||||
And next the buffer
|
And next the buffer
|
||||||
.I buf
|
.I buf
|
||||||
of size
|
of size
|
||||||
.I buflen
|
.I buflen
|
||||||
that can hold additional strings.
|
that can hold additional strings.
|
||||||
The result of these functions, the struct passwd read from the stream,
|
The result of these functions, the \fIstruct passwd\fP read from the stream,
|
||||||
is stored in the provided buffer
|
is stored in the provided buffer
|
||||||
.RI * pwbuf ,
|
.RI * pwbuf ,
|
||||||
and a pointer to this struct passwd is returned in
|
and a pointer to this \fIstruct passwd\fP is returned in
|
||||||
.RI * pwbufp .
|
.RI * pwbufp .
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success, these functions return 0 and
|
On success, these functions return 0 and
|
||||||
.RI * pwbufp
|
.RI * pwbufp
|
||||||
is a pointer to the struct passwd.
|
is a pointer to the \fIstruct passwd\fP.
|
||||||
On error, these functions return an error value and
|
On error, these functions return an error value and
|
||||||
.RI * pwbufp
|
.RI * pwbufp
|
||||||
is NULL.
|
is NULL.
|
||||||
|
|
|
@ -40,7 +40,7 @@ See
|
||||||
.LP
|
.LP
|
||||||
The function
|
The function
|
||||||
.BR login ()
|
.BR login ()
|
||||||
takes the supplied struct utmp
|
takes the supplied \fIstruct utmp\fP,
|
||||||
.IR ut ,
|
.IR ut ,
|
||||||
and writes it to both utmp and wtmp file.
|
and writes it to both utmp and wtmp file.
|
||||||
.LP
|
.LP
|
||||||
|
@ -62,7 +62,7 @@ and fills the field
|
||||||
Then it tries to fill the field
|
Then it tries to fill the field
|
||||||
.IR ut->ut_line .
|
.IR ut->ut_line .
|
||||||
It takes the first of stdin, stdout, stderr that is a tty, and
|
It takes the first of stdin, stdout, stderr that is a tty, and
|
||||||
stores the corresponding pathname minus a possible leading /dev/
|
stores the corresponding pathname minus a possible leading \fI/dev/\fP
|
||||||
into this field, and then writes the struct to the utmp file.
|
into this field, and then writes the struct to the utmp file.
|
||||||
On the other hand, if no tty name was found, this field is filled with "???"
|
On the other hand, if no tty name was found, this field is filled with "???"
|
||||||
and the struct is not written to the utmp file.
|
and the struct is not written to the utmp file.
|
||||||
|
|
|
@ -15,12 +15,12 @@ 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 struct group into the
|
The function writes the content of the provided \fIstruct group\fP 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 struct group is defined as follows:
|
The \fIstruct group\fP is defined as follows:
|
||||||
.sp
|
.sp
|
||||||
.in +0.5i
|
.in +0.5i
|
||||||
.nf
|
.nf
|
||||||
|
|
|
@ -258,7 +258,7 @@ If you want to disable
|
||||||
.BR who (1)
|
.BR who (1)
|
||||||
then do not make utmp world readable.
|
then do not make utmp world readable.
|
||||||
.PP
|
.PP
|
||||||
Note that the utmp struct from libc5 has changed in libc6.
|
Note that the \fIutmp\fP struct from libc5 has changed in libc6.
|
||||||
Because of this,
|
Because of this,
|
||||||
binaries using the old libc5 struct will corrupt
|
binaries using the old libc5 struct will corrupt
|
||||||
.IR /var/run/utmp " and/or " /var/log/wtmp .
|
.IR /var/run/utmp " and/or " /var/log/wtmp .
|
||||||
|
@ -267,7 +267,7 @@ The file format is machine dependent, so it is recommended that it be
|
||||||
processed only on the machine architecture where it was created.
|
processed only on the machine architecture where it was created.
|
||||||
.PP
|
.PP
|
||||||
Note that on platforms which can run both 32-bit and 64-bit applications
|
Note that on platforms which can run both 32-bit and 64-bit applications
|
||||||
(x86-64, ppc64, s390x, etc.), the sizes of the fields of a struct utmp
|
(x86-64, ppc64, s390x, etc.), the sizes of the fields of a \fIutmp\fP struct
|
||||||
must be the same in 32-bit mode as in 64-bit mode.
|
must be the same in 32-bit mode as in 64-bit mode.
|
||||||
This is achieved by changing the type of
|
This is achieved by changing the type of
|
||||||
.I ut_session
|
.I ut_session
|
||||||
|
|
Loading…
Reference in New Issue