mirror of https://github.com/mkerrisk/man-pages
system_data_types.7: srcfix
The contents of each type are a logical block that is indented as a block. They are not separate paragraphs that happen to be indented separately, but a set of continuous paragraphs, all at the same level, indented as a block from the list entry--the name of the type--. Therefore, it makes more sense to use block indentation, represented by .RS/.RE, rather than indenting each paragraph separately. That way it's also easier to further indent a separate paragraph inside a block, which happens for example in the case of float_t & double_t. It's simply much easier now to use .IP specifically in those cases where you want to indent just a single paragraph. Also added an ending separator comment line just after the last type. [mtk: minor edits to commit message] Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
0c3e8eb330
commit
156e30baa6
|
@ -65,10 +65,11 @@ system_data_types \- overview of system data types
|
|||
.\"------------------------------------- aiocb ------------------------/
|
||||
.TP
|
||||
.I aiocb
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <aio.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
struct aiocb {
|
||||
int aio_fildes; /* File descriptor */
|
||||
|
@ -80,12 +81,12 @@ struct aiocb {
|
|||
int aio_lio_opcode;/* Operation to be performed */
|
||||
};
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
For further information about this structure, see
|
||||
.BR aio (7).
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR aio_cancel (3),
|
||||
.BR aio_error (3),
|
||||
|
@ -95,42 +96,45 @@ See also:
|
|||
.BR aio_suspend (3),
|
||||
.BR aio_write (3),
|
||||
.BR lio_listio (3)
|
||||
.RE
|
||||
.\"------------------------------------- div_t ------------------------/
|
||||
.TP
|
||||
.I div_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <stdlib.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
typedef struct {
|
||||
int quot; /* Quotient */
|
||||
int rem; /* Remainder */
|
||||
} div_t;
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
It is the type of the value returned by the
|
||||
.BR div (3)
|
||||
function.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR div (3)
|
||||
.RE
|
||||
.\"------------------------------------- double_t ---------------------/
|
||||
.TP
|
||||
.I double_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <math.h> .
|
||||
.IP
|
||||
.PP
|
||||
The implementation's most efficient floating type at least as wide as
|
||||
.IR double .
|
||||
Its type depends on the value of the macro
|
||||
.BR FLT_EVAL_METHOD ,
|
||||
defined in
|
||||
.IR <float.h> :
|
||||
.RS
|
||||
.TP
|
||||
0
|
||||
.I double_t
|
||||
|
@ -152,57 +156,61 @@ For other values of
|
|||
the type of
|
||||
.I double_t
|
||||
is implementation-defined.
|
||||
.RE
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I float_t
|
||||
type in this page.
|
||||
.RE
|
||||
.\"------------------------------------- fenv_t -----------------------/
|
||||
.TP
|
||||
.I fenv_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <fenv.h> .
|
||||
.IP
|
||||
.PP
|
||||
This type represents the entire floating-point environment,
|
||||
including control modes and status flags; for further details, see
|
||||
.BR fenv (3).
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR fenv (3)
|
||||
.RE
|
||||
.\"------------------------------------- fexcept_t --------------------/
|
||||
.TP
|
||||
.I fexcept_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <fenv.h> .
|
||||
.IP
|
||||
.PP
|
||||
This type represents the floating-point status flags collectively;
|
||||
for further details see
|
||||
.BR fenv (3).
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR fenv (3)
|
||||
.RE
|
||||
.\"------------------------------------- float_t ----------------------/
|
||||
.TP
|
||||
.I float_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <math.h> .
|
||||
.IP
|
||||
.PP
|
||||
The implementation's most efficient floating type at least as wide as
|
||||
.IR float .
|
||||
Its type depends on the value of the macro
|
||||
.BR FLT_EVAL_METHOD ,
|
||||
defined in
|
||||
.IR <float.h> :
|
||||
.RS
|
||||
.TP
|
||||
0
|
||||
.I float_t
|
||||
|
@ -224,17 +232,18 @@ For other values of
|
|||
the type of
|
||||
.I float_t
|
||||
is implementation-defined.
|
||||
.RE
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I double_t
|
||||
type in this page.
|
||||
.RE
|
||||
.\"------------------------------------- gid_t ------------------------/
|
||||
.TP
|
||||
.I gid_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <sys/types.h> ;
|
||||
or
|
||||
|
@ -251,13 +260,13 @@ or
|
|||
.I <sys/stat.h>
|
||||
or
|
||||
.IR <unistd.h> .
|
||||
.IP
|
||||
.PP
|
||||
A type used to hold group IDs.
|
||||
According to POSIX,
|
||||
this shall be an integer type.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR chown (2),
|
||||
.BR getgid (2),
|
||||
|
@ -266,15 +275,17 @@ See also:
|
|||
.BR getresgid (2),
|
||||
.BR getgrnam (2),
|
||||
.BR credentials (7)
|
||||
.RE
|
||||
.\"------------------------------------- id_t -------------------------/
|
||||
.TP
|
||||
.I id_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <sys/types.h> ;
|
||||
or
|
||||
.IR <sys/resource.h> .
|
||||
.IP
|
||||
.PP
|
||||
A type used to hold a general identifier.
|
||||
According to POSIX,
|
||||
this shall be an integer type that can be used to contain a
|
||||
|
@ -282,41 +293,45 @@ this shall be an integer type that can be used to contain a
|
|||
.IR uid_t ,
|
||||
or
|
||||
.IR gid_t .
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR getpriority (2),
|
||||
.BR waitid (2)
|
||||
.RE
|
||||
.\"------------------------------------- imaxdiv_t --------------------/
|
||||
.TP
|
||||
.I imaxdiv_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <inttypes.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
typedef struct {
|
||||
intmax_t quot; /* Quotient */
|
||||
intmax_t rem; /* Remainder */
|
||||
} imaxdiv_t;
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
It is the type of the value returned by the
|
||||
.BR imaxdiv (3)
|
||||
function.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR imaxdiv (3)
|
||||
.RE
|
||||
.\"------------------------------------- lconv ------------------------/
|
||||
.TP
|
||||
.I lconv
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <locale.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
struct lconv { /* Values in the "C" locale: */
|
||||
char *decimal_point; /* "." */
|
||||
|
@ -345,66 +360,72 @@ struct lconv { /* Values in the "C" locale: */
|
|||
char int_n_sign_posn; /* CHAR_MAX */
|
||||
};
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
Contains members related to the formatting of numeric values.
|
||||
In the "C" locale, its members have the values
|
||||
shown in the comments above.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C11 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR setlocale (3),
|
||||
.BR localeconv (3),
|
||||
.BR charsets (5),
|
||||
.BR locale (7)
|
||||
.RE
|
||||
.\"------------------------------------- ldiv_t -----------------------/
|
||||
.TP
|
||||
.I ldiv_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <stdlib.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
typedef struct {
|
||||
long quot; /* Quotient */
|
||||
long rem; /* Remainder */
|
||||
} ldiv_t;
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
It is the type of the value returned by the
|
||||
.BR ldiv (3)
|
||||
function.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR ldiv (3)
|
||||
.RE
|
||||
.\"------------------------------------- lldiv_t ----------------------/
|
||||
.TP
|
||||
.I lldiv_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <stdlib.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
typedef struct {
|
||||
long long quot; /* Quotient */
|
||||
long long rem; /* Remainder */
|
||||
} lldiv_t;
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
It is the type of the value returned by the
|
||||
.BR lldiv (3)
|
||||
function.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR lldiv (3)
|
||||
.RE
|
||||
.\"------------------------------------- pid_t ------------------------/
|
||||
.TP
|
||||
.I pid_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include
|
||||
.IR <sys/types.h> ;
|
||||
or
|
||||
|
@ -431,7 +452,7 @@ or
|
|||
.I <unistd.h>
|
||||
or
|
||||
.IR <utmpx.h> .
|
||||
.IP
|
||||
.PP
|
||||
This type is used for storing process IDs, process group IDs, and session IDs.
|
||||
According to POSIX, it shall be a signed integer type,
|
||||
and the implementation shall support one or more programming environments
|
||||
|
@ -439,9 +460,9 @@ where the width of
|
|||
.I pid_t
|
||||
is no greater than the width of the type
|
||||
.IR long .
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR fork (2),
|
||||
.BR getpid (2),
|
||||
|
@ -455,20 +476,22 @@ See also:
|
|||
.BR waitpid (2),
|
||||
.BR sigqueue (3),
|
||||
.BR credentials (7),
|
||||
.RE
|
||||
.\"------------------------------------- ptrdiff_t --------------------/
|
||||
.TP
|
||||
.I ptrdiff_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <stddef.h> .
|
||||
.IP
|
||||
.PP
|
||||
Used for a count of elements, and array indices.
|
||||
It is the result of subtracting two pointers.
|
||||
According to the C language standard, it shall be a signed integer type
|
||||
capable of storing values in the range
|
||||
.RB [ PTRDIFF_MIN ,
|
||||
.BR PTRDIFF_MAX ].
|
||||
.IP
|
||||
.PP
|
||||
The length modifier for
|
||||
.I ptrdiff_t
|
||||
for the
|
||||
|
@ -484,21 +507,23 @@ or
|
|||
for printing
|
||||
.I ptrdiff_t
|
||||
values.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I size_t
|
||||
and
|
||||
.I ssize_t
|
||||
types in this page.
|
||||
.RE
|
||||
.\"------------------------------------- regmatch_t -------------------/
|
||||
.TP
|
||||
.I regmatch_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <regex.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
typedef struct {
|
||||
regoff_t rm_so; /* Byte offset from start of string
|
||||
|
@ -508,36 +533,38 @@ typedef struct {
|
|||
substring */
|
||||
} regmatch_t;
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
This is a structure type used in regular expression matching.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR regexec (3)
|
||||
.RE
|
||||
.\"------------------------------------- regoff_t ---------------------/
|
||||
.TP
|
||||
.I regoff_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <regex.h> .
|
||||
.IP
|
||||
.PP
|
||||
According to POSIX, it shall be a signed integer type
|
||||
capable of storing the largest value that can be stored in either a
|
||||
.I ptrdiff_t
|
||||
type or a
|
||||
.I ssize_t
|
||||
type.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
Notes: Prior to POSIX.1-2008, the type was capable of storing
|
||||
the largest value that can be stored in either an
|
||||
.I off_t
|
||||
type or a
|
||||
.I ssize_t
|
||||
type.
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I regmatch_t
|
||||
structure and the
|
||||
|
@ -545,10 +572,12 @@ structure and the
|
|||
and
|
||||
.I ssize_t
|
||||
types in this page.
|
||||
.RE
|
||||
.\"------------------------------------- sigevent ---------------------/
|
||||
.TP
|
||||
.I sigevent
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <signal.h> ;
|
||||
or
|
||||
|
@ -557,7 +586,7 @@ or
|
|||
.I <mqueue.h>
|
||||
or
|
||||
.IR <time.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
struct sigevent {
|
||||
int sigev_notify; /* Notification type */
|
||||
|
@ -569,12 +598,12 @@ struct sigevent {
|
|||
/* Notification attributes */
|
||||
};
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
For further details about this type, see
|
||||
.BR sigevent (7).
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
Notes:
|
||||
.I <aio.h>
|
||||
and
|
||||
|
@ -582,25 +611,27 @@ and
|
|||
define
|
||||
.I sigevent
|
||||
since POSIX.1-2008.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR timer_create (2),
|
||||
.BR getaddrinfo_a (3),
|
||||
.BR lio_listio (3),
|
||||
.BR mq_notify (3)
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I aiocb
|
||||
structure in this page.
|
||||
.RE
|
||||
.\"------------------------------------- siginfo_t --------------------/
|
||||
.TP
|
||||
.I siginfo_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <signal.h> ;
|
||||
or
|
||||
.IR <sys/wait.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
typedef struct {
|
||||
int si_signo; /* Signal number */
|
||||
|
@ -612,36 +643,38 @@ typedef struct {
|
|||
union sigval si_value; /* Signal value */
|
||||
} siginfo_t;
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
Information associated with a signal.
|
||||
For further details on this structure
|
||||
(including additional, Linux-specific fields), see
|
||||
.BR sigaction (2).
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR pidfd_send_signal (2),
|
||||
.BR rt_sigqueueinfo (2),
|
||||
.BR sigaction (2),
|
||||
.BR sigwaitinfo (2),
|
||||
.BR psiginfo (3)
|
||||
.RE
|
||||
.\"------------------------------------- sigset_t ---------------------/
|
||||
.TP
|
||||
.I sigset_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <signal.h> ;
|
||||
or
|
||||
.I <spawn.h>
|
||||
or
|
||||
.IR <sys/select.h> .
|
||||
.IP
|
||||
.PP
|
||||
This is a type that represents a set of signals.
|
||||
According to POSIX, this shall be an integer or structure type.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR epoll_pwait (2),
|
||||
.BR ppoll (2),
|
||||
|
@ -653,29 +686,31 @@ See also:
|
|||
.BR sigsuspend (2),
|
||||
.BR sigwaitinfo (2),
|
||||
.BR signal (7)
|
||||
.RE
|
||||
.\"------------------------------------- sigval -----------------------/
|
||||
.TP
|
||||
.I sigval
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <signal.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
union sigval {
|
||||
int sigval_int; /* Integer value */
|
||||
void *sigval_ptr; /* Pointer value */
|
||||
};
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
Data passed with a signal.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR pthread_sigqueue (3),
|
||||
.BR sigqueue (3),
|
||||
.BR sigevent (7)
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I sigevent
|
||||
structure
|
||||
|
@ -683,10 +718,12 @@ and the
|
|||
.I siginfo_t
|
||||
type
|
||||
in this page.
|
||||
.RE
|
||||
.\"------------------------------------- size_t -----------------------/
|
||||
.TP
|
||||
.I size_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.I <stddef.h>
|
||||
or
|
||||
|
@ -741,7 +778,7 @@ or
|
|||
.I <wchar.h>
|
||||
or
|
||||
.IR <wordexp.h> .
|
||||
.IP
|
||||
.PP
|
||||
Used for a count of bytes. It is the result of the
|
||||
.I sizeof
|
||||
operator.
|
||||
|
@ -755,7 +792,7 @@ where the width of
|
|||
.I size_t
|
||||
is no greater than the width of the type
|
||||
.IR long .
|
||||
.IP
|
||||
.PP
|
||||
The length modifier for
|
||||
.I size_t
|
||||
for the
|
||||
|
@ -771,9 +808,9 @@ or
|
|||
for printing
|
||||
.I size_t
|
||||
values.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
Notes:
|
||||
.IR <aio.h> ,
|
||||
.IR <glob.h> ,
|
||||
|
@ -787,7 +824,7 @@ and
|
|||
define
|
||||
.I size_t
|
||||
since POSIX.1-2008.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR read (2),
|
||||
.BR write (2),
|
||||
|
@ -798,16 +835,18 @@ See also:
|
|||
.BR memcpy (3),
|
||||
.BR memset (3),
|
||||
.BR offsetof (3)
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I ptrdiff_t
|
||||
and
|
||||
.I ssize_t
|
||||
types in this page.
|
||||
.RE
|
||||
.\"------------------------------------- ssize_t ----------------------/
|
||||
.TP
|
||||
.I ssize_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <sys/types.h> ;
|
||||
or
|
||||
|
@ -826,7 +865,7 @@ or
|
|||
.I <sys/uio.h>
|
||||
or
|
||||
.IR <unistd.h> .
|
||||
.IP
|
||||
.PP
|
||||
Used for a count of bytes or an error indication.
|
||||
According to POSIX, it shall be a signed integer type
|
||||
capable of storing values at least in the range [-1,
|
||||
|
@ -836,7 +875,7 @@ where the width of
|
|||
.I ssize_t
|
||||
is no greater than the width of the type
|
||||
.IR long .
|
||||
.IP
|
||||
.PP
|
||||
Glibc and most other implementations provide a length modifier for
|
||||
.I ssize_t
|
||||
for the
|
||||
|
@ -862,9 +901,9 @@ by converting the value to
|
|||
.I intmax_t
|
||||
and using its length modifier
|
||||
.RB ( j ).
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR read (2),
|
||||
.BR readlink (2),
|
||||
|
@ -872,23 +911,25 @@ See also:
|
|||
.BR recv (2),
|
||||
.BR send (2),
|
||||
.BR write (2)
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I ptrdiff_t
|
||||
and
|
||||
.I size_t
|
||||
types in this page.
|
||||
.RE
|
||||
.\"------------------------------------- suseconds_t ------------------/
|
||||
.TP
|
||||
.I suseconds_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <sys/types.h> ;
|
||||
or
|
||||
.I <sys/select.h>
|
||||
or
|
||||
.IR <sys/time.h> .
|
||||
.IP
|
||||
.PP
|
||||
Used for time in microseconds.
|
||||
According to POSIX, it shall be a signed integer type
|
||||
capable of storing values at least in the range [-1, 1000000],
|
||||
|
@ -897,16 +938,18 @@ where the width of
|
|||
.I suseconds_t
|
||||
is no greater than the width of the type
|
||||
.IR long .
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also the
|
||||
.I timeval
|
||||
structure in this page.
|
||||
.RE
|
||||
.\"------------------------------------- time_t -----------------------/
|
||||
.TP
|
||||
.I time_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.I <sys/types.h>
|
||||
or
|
||||
|
@ -927,48 +970,52 @@ or
|
|||
.I <sys/time.h>
|
||||
or
|
||||
.IR <utime.h> .
|
||||
.IP
|
||||
.PP
|
||||
Used for time in seconds.
|
||||
According to POSIX, it shall be an integer type.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C99 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
Notes:
|
||||
.I <sched.h>
|
||||
defines
|
||||
.I time_t
|
||||
since POSIX.1-2008.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR stime (2),
|
||||
.BR time (2),
|
||||
.BR ctime (3),
|
||||
.BR difftime (3)
|
||||
.RE
|
||||
.\"------------------------------------- timer_t ----------------------/
|
||||
.TP
|
||||
.I timer_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <sys/types.h> ;
|
||||
or
|
||||
.IR <time.h> .
|
||||
.IP
|
||||
.PP
|
||||
Used for timer ID returned by
|
||||
.BR timer_create (2).
|
||||
According to POSIX,
|
||||
there are no defined comparison or assignment operators for this type.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR timer_create (2),
|
||||
.BR timer_delete (2),
|
||||
.BR timer_getoverrun (2),
|
||||
.BR timer_settime (2)
|
||||
.RE
|
||||
.\"------------------------------------- timespec ---------------------/
|
||||
.TP
|
||||
.I timespec
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <time.h> ;
|
||||
or
|
||||
|
@ -983,28 +1030,30 @@ or
|
|||
.I <sys/select.h>
|
||||
or
|
||||
.IR <sys/stat.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
struct timespec {
|
||||
time_t tv_sec; /* Seconds */
|
||||
long tv_nsec; /* Nanoseconds */
|
||||
};
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
Describes times in seconds and nanoseconds.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: C11 and later; POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR clock_gettime (2),
|
||||
.BR clock_nanosleep (2),
|
||||
.BR nanosleep (2),
|
||||
.BR timerfd_gettime (2),
|
||||
.BR timer_gettime (2)
|
||||
.RE
|
||||
.\"------------------------------------- timeval ----------------------/
|
||||
.TP
|
||||
.I timeval
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <sys/time.h> ;
|
||||
or
|
||||
|
@ -1013,18 +1062,18 @@ or
|
|||
.I <sys/select.h>
|
||||
or
|
||||
.IR <utmpx.h> .
|
||||
.IP
|
||||
.PP
|
||||
.EX
|
||||
struct timeval {
|
||||
time_t tv_sec; /* Seconds */
|
||||
suseconds_t tv_usec; /* Microseconds */
|
||||
};
|
||||
.EE
|
||||
.IP
|
||||
.PP
|
||||
Describes times in seconds and microseconds.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR gettimeofday (2),
|
||||
.BR select (2),
|
||||
|
@ -1032,10 +1081,12 @@ See also:
|
|||
.BR adjtime (3),
|
||||
.BR futimes (3),
|
||||
.BR timeradd (3)
|
||||
.RE
|
||||
.\"------------------------------------- uid_t ----------------------/
|
||||
.TP
|
||||
.I uid_t
|
||||
.IP
|
||||
.RS
|
||||
.PP
|
||||
Include:
|
||||
.IR <sys/types.h> ;
|
||||
or
|
||||
|
@ -1050,13 +1101,13 @@ or
|
|||
.I <sys/stat.h>
|
||||
or
|
||||
.IR <unistd.h> .
|
||||
.IP
|
||||
.PP
|
||||
A type used to hold user IDs.
|
||||
According to POSIX,
|
||||
this shall be an integer type.
|
||||
.IP
|
||||
.PP
|
||||
Conforming to: POSIX.1-2001 and later.
|
||||
.IP
|
||||
.PP
|
||||
See also:
|
||||
.BR chown (2),
|
||||
.BR getuid (2),
|
||||
|
@ -1064,6 +1115,8 @@ See also:
|
|||
.BR getresuid (2),
|
||||
.BR getpwnam (2),
|
||||
.BR credentials (7)
|
||||
.RE
|
||||
.\"--------------------------------------------------------------------/
|
||||
.SH NOTES
|
||||
The structures described in this manual page shall contain,
|
||||
at least, the members shown in their definition, in no particular order.
|
||||
|
|
Loading…
Reference in New Issue