diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:41:09 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:41:09 +0000 |
| commit | 0db324e2e5d9d3347ea0e93138372fb65aac09e6 (patch) | |
| tree | 1b794022fb98db123c73021e75286a82c116aa7f /man3type | |
| parent | Releasing progress-linux version 6.05.01-1~progress7.99u1. (diff) | |
| download | manpages-0db324e2e5d9d3347ea0e93138372fb65aac09e6.tar.xz manpages-0db324e2e5d9d3347ea0e93138372fb65aac09e6.zip | |
Merging upstream version 6.7.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man3type')
34 files changed, 317 insertions, 174 deletions
diff --git a/man3type/FILE.3type b/man3type/FILE.3type index 6edeeb4..3e8ea24 100644 --- a/man3type/FILE.3type +++ b/man3type/FILE.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH FILE 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH FILE 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME FILE \- input/output stream .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdio.h> -.PP +.P .BR typedef " /* ... */ " FILE; .fi .SH DESCRIPTION diff --git a/man3type/aiocb.3type b/man3type/aiocb.3type index 45739e2..5daec06 100644 --- a/man3type/aiocb.3type +++ b/man3type/aiocb.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH aiocb 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH aiocb 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME aiocb \- asynchronous I/O control block .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <aio.h> -.PP +.P .B struct aiocb { .BR " int aio_fildes;" " /* File descriptor */" .BR " off_t aio_offset;" " /* File offset */" diff --git a/man3type/blkcnt_t.3type b/man3type/blkcnt_t.3type index 5cdacdc..d5b2e44 100644 --- a/man3type/blkcnt_t.3type +++ b/man3type/blkcnt_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH blkcnt_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH blkcnt_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME blkcnt_t \- file block counts .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " blkcnt_t; .fi .SH DESCRIPTION diff --git a/man3type/blksize_t.3type b/man3type/blksize_t.3type index 5406a88..00f341c 100644 --- a/man3type/blksize_t.3type +++ b/man3type/blksize_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH blksize_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH blksize_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME blksize_t \- file block sizes .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " blksize_t; .fi .SH DESCRIPTION diff --git a/man3type/cc_t.3type b/man3type/cc_t.3type index 33d5829..c7b4021 100644 --- a/man3type/cc_t.3type +++ b/man3type/cc_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH cc_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH cc_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME cc_t, speed_t, tcflag_t \- terminal special characters, baud rates, modes .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <termios.h> -.PP +.P .BR typedef " /* ... */ " cc_t; .BR typedef " /* ... */ " speed_t; .BR typedef " /* ... */ " tcflag_t; @@ -25,7 +25,7 @@ is used for terminal special characters, for baud rates, and .I tcflag_t for modes. -.PP +.P All are unsigned integer types. .SH STANDARDS POSIX.1-2008. diff --git a/man3type/clock_t.3type b/man3type/clock_t.3type index e1346e3..aa061b0 100644 --- a/man3type/clock_t.3type +++ b/man3type/clock_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH clock_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH clock_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME clock_t \- system time .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <time.h> -.PP +.P .BR typedef " /* ... */ " clock_t; .fi .SH DESCRIPTION @@ -31,7 +31,7 @@ C89, POSIX.1-2001. The following headers also provide this type: .I <sys/types.h> and -.IR <sys/time.h> . +.IR <sys/times.h> . .SH SEE ALSO .BR times (2), .BR clock (3) diff --git a/man3type/clockid_t.3type b/man3type/clockid_t.3type index bc9a3b8..a28c065 100644 --- a/man3type/clockid_t.3type +++ b/man3type/clockid_t.3type @@ -1,4 +1,4 @@ -.TH clockid_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH clockid_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME clockid_t \- clock ID for the clock and timer functions .SH LIBRARY @@ -7,7 +7,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " clockid_t; .fi .SH DESCRIPTION diff --git a/man3type/dev_t.3type b/man3type/dev_t.3type index e4c4ae9..d30803b 100644 --- a/man3type/dev_t.3type +++ b/man3type/dev_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH dev_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH dev_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME dev_t \- device ID .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " dev_t; .fi .SH DESCRIPTION diff --git a/man3type/div_t.3type b/man3type/div_t.3type index f0bce13..977d5af 100644 --- a/man3type/div_t.3type +++ b/man3type/div_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH div_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH div_t 3type 2024-01-16 "Linux man-pages 6.7" .SH NAME div_t, ldiv_t, lldiv_t, imaxdiv_t \- quotient and remainder of an integer division @@ -14,24 +14,24 @@ Standard C library .SH SYNOPSIS .EX .B #include <stdlib.h> -.PP +.P .B typedef struct { .BR " int quot;" " /* Quotient */" .BR " int rem;" " /* Remainder */" .B } div_t; -.PP +.P .B typedef struct { .BR " long quot;" " /* Quotient */" .BR " long rem;" " /* Remainder */" .B } ldiv_t; -.PP +.P .B typedef struct { .BR " long long quot;" " /* Quotient */" .BR " long long rem;" " /* Remainder */" .B } lldiv_t; -.PP +.P .B #include <inttypes.h> -.PP +.P .B typedef struct { .BR " intmax_t quot;" " /* Quotient */" .BR " intmax_t rem;" " /* Remainder */" @@ -40,9 +40,10 @@ Standard C library .SH DESCRIPTION .RI [[ l ] l ] div_t is the type of the value returned by the -.RB [[ l ] l ] div (3) +.RB [[ l ] l ]\c +.BR div (3) function. -.PP +.P .I imaxdiv_t is the type of the value returned by the .BR imaxdiv (3) diff --git a/man3type/double_t.3type b/man3type/double_t.3type index ca200af..06c7699 100644 --- a/man3type/double_t.3type +++ b/man3type/double_t.3type @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH double_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH double_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME float_t, double_t \- most efficient floating types .SH LIBRARY @@ -14,7 +14,7 @@ Math library .SH SYNOPSIS .nf .B #include <math.h> -.PP +.P .BR typedef " /* ... */ " float_t; .BR typedef " /* ... */ " double_t; .fi @@ -28,7 +28,7 @@ Their type depends on the value of the macro .B FLT_EVAL_METHOD (defined in .IR <float.h> ): -.PP +.P .TS lB rI rI. FLT_EVAL_METHOD float_t double_t @@ -39,7 +39,7 @@ _ 1 double double 2 long double long double .TE -.PP +.P For other values of .BR FLT_EVAL_METHOD , the types of diff --git a/man3type/epoll_event.3type b/man3type/epoll_event.3type index 0a9fa74..1ba679d 100644 --- a/man3type/epoll_event.3type +++ b/man3type/epoll_event.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH epoll_event 3type 2023-07-08 "Linux man-pages 6.05.01" +.TH epoll_event 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME epoll_event, epoll_data, epoll_data_t \- epoll event @@ -13,19 +13,19 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/epoll.h> -.PP +.P .B struct epoll_event { .BR " uint32_t events;" " /* Epoll events */" .BR " epoll_data_t data;" " /* User data variable */" .B }; -.PP +.P .B union epoll_data { .B " void *ptr;" .B " int fd;" .B " uint32_t u32;" .B " uint64_t u64;" .B }; -.PP +.P .B "typedef union epoll_data epoll_data_t;" .EE .SH DESCRIPTION @@ -37,7 +37,7 @@ return when the corresponding file descriptor becomes ready. .SS C library/kernel differences The Linux kernel headers also provide this type, with a slightly different definition: -.PP +.P .in +4n .EX #include <linux/eventpoll.h> diff --git a/man3type/fenv_t.3type b/man3type/fenv_t.3type index 95e036e..bc430b0 100644 --- a/man3type/fenv_t.3type +++ b/man3type/fenv_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH fenv_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH fenv_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME fenv_t, fexcept_t \- floating-point environment .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <fenv.h> -.PP +.P .BR typedef " /* ... */ " fenv_t; .BR typedef " /* ... */ " fexcept_t; .fi @@ -21,10 +21,10 @@ Standard C library .I fenv_t represents the entire floating-point environment, including control modes and status flags. -.PP +.P .I fexcept_t represents the floating-point status flags collectively. -.PP +.P For further details see .BR fenv (3). .SH STANDARDS diff --git a/man3type/id_t.3type b/man3type/id_t.3type index 9b30e47..23c130c 100644 --- a/man3type/id_t.3type +++ b/man3type/id_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH id_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH id_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME pid_t, uid_t, gid_t, id_t \- process/user/group identifier .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " pid_t; .BR typedef " /* ... */ " uid_t; .BR typedef " /* ... */ " gid_t; @@ -23,15 +23,15 @@ Standard C library .I pid_t is a type used for storing process IDs, process group IDs, and session IDs. It is a signed integer type. -.PP +.P .I uid_t is a type used to hold user IDs. It is an integer type. -.PP +.P .I gid_t is a type used to hold group IDs. It is an integer type. -.PP +.P .I id_t is a type used to hold a general identifier. It is an integer type that can be used to contain a @@ -59,7 +59,7 @@ The following headers also provide .IR <unistd.h> , and .IR <utmpx.h> . -.PP +.P The following headers also provide .IR uid_t : .IR <pwd.h> , @@ -69,7 +69,7 @@ The following headers also provide .IR <sys/stat.h> , and .IR <unistd.h> . -.PP +.P The following headers also provide .IR gid_t : .IR <grp.h> , @@ -80,7 +80,7 @@ The following headers also provide .IR <sys/stat.h> , and .IR <unistd.h> . -.PP +.P The following header also provides .IR id_t : .IR <sys/resource.h> . diff --git a/man3type/intN_t.3type b/man3type/intN_t.3type index 56cd445..dc42042 100644 --- a/man3type/intN_t.3type +++ b/man3type/intN_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH intN_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH intN_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME intN_t, int8_t, int16_t, int32_t, int64_t, uintN_t, uint8_t, uint16_t, uint32_t, uint64_t @@ -15,47 +15,47 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdint.h> -.PP +.P .BR typedef " /* ... */ " int8_t; .BR typedef " /* ... */ " int16_t; .BR typedef " /* ... */ " int32_t; .BR typedef " /* ... */ " int64_t; -.PP +.P .BR typedef " /* ... */ " uint8_t; .BR typedef " /* ... */ " uint16_t; .BR typedef " /* ... */ " uint32_t; .BR typedef " /* ... */ " uint64_t; -.PP +.P .B "#define INT8_WIDTH 8" .B "#define INT16_WIDTH 16" .B "#define INT32_WIDTH 32" .B "#define INT64_WIDTH 64" -.PP +.P .B "#define UINT8_WIDTH 8" .B "#define UINT16_WIDTH 16" .B "#define UINT32_WIDTH 32" .B "#define UINT64_WIDTH 64" -.PP +.P .BR "#define INT8_MAX " "/* 2**(INT8_WIDTH - 1) - 1 */" .BR "#define INT16_MAX " "/* 2**(INT16_WIDTH - 1) - 1 */" .BR "#define INT32_MAX " "/* 2**(INT32_WIDTH - 1) - 1 */" .BR "#define INT64_MAX " "/* 2**(INT64_WIDTH - 1) - 1 */" -.PP +.P .BR "#define INT8_MIN " "/* - 2**(INT8_WIDTH - 1) */" .BR "#define INT16_MIN " "/* - 2**(INT16_WIDTH - 1) */" .BR "#define INT32_MIN " "/* - 2**(INT32_WIDTH - 1) */" .BR "#define INT64_MIN " "/* - 2**(INT64_WIDTH - 1) */" -.PP +.P .BR "#define UINT8_MAX " "/* 2**INT8_WIDTH - 1 */" .BR "#define UINT16_MAX " "/* 2**INT16_WIDTH - 1 */" .BR "#define UINT32_MAX " "/* 2**INT32_WIDTH - 1 */" .BR "#define UINT64_MAX " "/* 2**INT64_WIDTH - 1 */" -.PP +.P .BI "#define INT8_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define INT16_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define INT32_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define INT64_C(" c ") " c " ## " "\fR/* ... */\fP" -.PP +.P .BI "#define UINT8_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define UINT16_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define UINT32_C(" c ") " c " ## " "\fR/* ... */\fP" @@ -74,7 +74,7 @@ They are be capable of storing values in the range substituting .I N by the appropriate number. -.PP +.P .IR uint N _t are unsigned integer types @@ -86,7 +86,7 @@ They are capable of storing values in the range substituting .I N by the appropriate number. -.PP +.P According to POSIX, .RI [ u ] int8_t , .RI [ u ] int16_t , @@ -96,25 +96,25 @@ are required; .RI [ u ] int64_t are only required in implementations that provide integer types with width 64; and all other types of this form are optional. -.PP +.P The macros .RB [ U ] INT \fIN\fP _WIDTH expand to the width in bits of these types .RI ( N ). -.PP +.P The macros .RB [ U ] INT \fIN\fP _MAX expand to the maximum value that these types can hold. -.PP +.P The macros .BI INT N _MIN expand to the minimum value that these types can hold. -.PP +.P The macros .RB [ U ] INT \fIN\fP _C () expand their argument to an integer constant of type .RI [ u ] int N _t . -.PP +.P The length modifiers for the .RI [ u ] int N _t types for the @@ -159,7 +159,7 @@ values. C11, POSIX.1-2008. .SH HISTORY C99, POSIX.1-2001. -.PP +.P The .RB [ U ] INT \fIN\fP _WIDTH macros were added in C23. diff --git a/man3type/intmax_t.3type b/man3type/intmax_t.3type index 9048e63..846c5cc 100644 --- a/man3type/intmax_t.3type +++ b/man3type/intmax_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH intmax_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH intmax_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME intmax_t, uintmax_t \- greatest-width basic integer types .SH LIBRARY @@ -13,17 +13,17 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdint.h> -.PP +.P .BR typedef " /* ... */ " intmax_t; .BR typedef " /* ... */ " uintmax_t; -.PP +.P .BR "#define INTMAX_WIDTH " "/* ... */" .B "#define UINTMAX_WIDTH INTMAX_WIDTH" -.PP +.P .BR "#define INTMAX_MAX " "/* 2**(INTMAX_WIDTH - 1) - 1 */" .BR "#define INTMAX_MIN " "/* - 2**(INTMAX_WIDTH - 1) */" .BR "#define UINTMAX_MAX " "/* 2**UINTMAX_WIDTH - 1 */" -.PP +.P .BI "#define INTMAX_C(" c ) " c " ## " \fR/* ... */\fP" .BI "#define UINTMAX_C(" c ) " c " ## " \fR/* ... */\fP" .fi @@ -35,7 +35,7 @@ supported by the implementation. It is capable of storing values in the range .RB [ INTMAX_MIN , .BR INTMAX_MAX ]. -.PP +.P .I uintmax_t is an unsigned integer type capable of representing any value of any basic unsigned integer type @@ -43,26 +43,26 @@ supported by the implementation. It is capable of storing values in the range .RB [ 0 , .BR UINTMAX_MAX ]. -.PP +.P The macros .RB [ U ] INTMAX_WIDTH expand to the width in bits of these types. -.PP +.P The macros .RB [ U ] INTMAX_MAX expand to the maximum value that these types can hold. -.PP +.P The macro .B INTMAX_MIN expands to the minimum value that .I intmax_t can hold. -.PP +.P The macros .RB [ U ] INTMAX_C () expand their argument to an integer constant of type .RI [ u ] intmax_t . -.PP +.P The length modifier for .RI [ u ] intmax_t for the diff --git a/man3type/intptr_t.3type b/man3type/intptr_t.3type index 1bec12f..4ee3291 100644 --- a/man3type/intptr_t.3type +++ b/man3type/intptr_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH intptr_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH intptr_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME intptr_t, uintptr_t \- integer types wide enough to hold pointers .SH LIBRARY @@ -13,13 +13,13 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdint.h> -.PP +.P .BR typedef " /* ... */ " intptr_t; .BR typedef " /* ... */ " uintptr_t; -.PP +.P .BR "#define INTPTR_WIDTH" " /* ... */" .B #define UINTPTR_WIDTH INTPTR_WIDTH -.PP +.P .BR "#define INTPTR_MAX" " /* 2**(INTPTR_WIDTH \- 1) \- 1 */" .BR "#define INTPTR_MIN" " /* \- 2**(INTPTR_WIDTH \- 1) */" .BR "#define UINTPTR_MAX" " /* 2**UINTPTR_WIDTH \- 1 */" @@ -33,7 +33,7 @@ value can be converted to this type and then converted back. It is capable of storing values in the range .RB [ INTPTR_MIN , .BR INTPTR_MAX ]. -.PP +.P .I uintptr_t is an unsigned integer type such that any valid @@ -42,21 +42,21 @@ value can be converted to this type and then converted back. It is capable of storing values in the range .RB [ 0 , .BR INTPTR_MAX ]. -.PP +.P The macros .RB [ U ] INTPTR_WIDTH expand to the width in bits of these types. -.PP +.P The macros .RB [ U ] INTPTR_MAX expand to the maximum value that these types can hold. -.PP +.P The macro .B INTPTR_MIN expands to the minimum value that .I intptr_t can hold. -.PP +.P The length modifiers for the .RI [ u ] intptr_t types diff --git a/man3type/iovec.3type b/man3type/iovec.3type index c2786f5..4d5c9ec 100644 --- a/man3type/iovec.3type +++ b/man3type/iovec.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH iovec 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH iovec 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME iovec \- Vector I/O data structure .SH LIBRARY @@ -12,7 +12,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/uio.h> -.PP +.P .B struct iovec { .BR " void *iov_base;" " /* Starting address */" .BR " size_t iov_len;" " /* Size of the memory pointed to by "\c diff --git a/man3type/itimerspec.3type b/man3type/itimerspec.3type index 7def422..1650e0a 100644 --- a/man3type/itimerspec.3type +++ b/man3type/itimerspec.3type @@ -3,16 +3,16 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH itimerspec 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH itimerspec 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME -timespec \- interval for a timer with nanosecond precision +itimerspec \- interval for a timer with nanosecond precision .SH LIBRARY Standard C library .RI ( libc ) .SH SYNOPSIS .EX .B #include <time.h> -.PP +.P .B struct itimerspec { .BR " struct timespec it_interval;" " /* Interval for periodic timer */" .BR " struct timespec it_value;" " /* Initial expiration */" @@ -23,10 +23,9 @@ Describes the initial expiration of a timer, and its interval, in seconds and nanoseconds. .SH STANDARDS -Linux. -.SH NOTES -The following header also provides this type: -.IR <sys/timerfd.h> . +POSIX.1-2008. +.SH HISTORY +POSIX.1-2001. .SH SEE ALSO .BR timerfd_create (2), .BR timer_settime (2), diff --git a/man3type/lconv.3type b/man3type/lconv.3type index f36522c..5fe2e74 100644 --- a/man3type/lconv.3type +++ b/man3type/lconv.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH lconv 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH lconv 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME lconv \- numeric formatting information .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <locale.h> -.PP +.P .BR "struct lconv {" " /* Values in the \[dq]C\[dq] locale: */" .BR " char *decimal_point;" " /* \[dq].\[dq] */" .BR " char *thousands_sep;" " /* \[dq]\[dq] */" diff --git a/man3type/mode_t.3type b/man3type/mode_t.3type index 7d56100..36f4bb8 100644 --- a/man3type/mode_t.3type +++ b/man3type/mode_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH mode_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH mode_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME mode_t \- file attributes .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " mode_t; .fi .SH DESCRIPTION diff --git a/man3type/off_t.3type b/man3type/off_t.3type index b544f66..95193d2 100644 --- a/man3type/off_t.3type +++ b/man3type/off_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH off_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH off_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME off_t, off64_t, loff_t \- file sizes .SH LIBRARY @@ -13,28 +13,28 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " off_t; -.PP +.P .B #define _LARGEFILE64_SOURCE .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " off64_t; -.PP +.P .B #define _GNU_SOURCE .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " loff_t; .fi .SH DESCRIPTION .I off_t is used for describing file sizes. It is a signed integer type. -.PP +.P .I off64_t is a 64-bit version of the type, used in glibc. -.PP +.P .I loff_t is a 64-bit version of the type, introduced by the Linux kernel. @@ -52,7 +52,7 @@ Linux. .TP .I off_t POSIX.1-2001. -.PP +.P .I <aio.h> and .I <stdio.h> @@ -65,7 +65,7 @@ the width of .I off_t can be controlled with the feature test macro .BR _FILE_OFFSET_BITS . -.PP +.P The following headers also provide .IR off_t : .IR <aio.h> , diff --git a/man3type/ptrdiff_t.3type b/man3type/ptrdiff_t.3type index bb6b404..7e1ce76 100644 --- a/man3type/ptrdiff_t.3type +++ b/man3type/ptrdiff_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ptrdiff_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH ptrdiff_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME ptrdiff_t \- count of elements or array index .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <stddef.h> -.PP +.P .BR typedef " /* ... */ " ptrdiff_t; .fi .SH DESCRIPTION @@ -21,9 +21,9 @@ Used for a count of elements, or an array index. It is the result of subtracting two pointers. It is a signed integer type capable of storing values in the range -.RB [ PTRDIFF_MAX , +.RB [ PTRDIFF_MIN , .BR PTRDIFF_MAX ]. -.PP +.P The length modifier for .I ptrdiff_t for the diff --git a/man3type/sigevent.3type b/man3type/sigevent.3type index db50c0f..4f1cb71 100644 --- a/man3type/sigevent.3type +++ b/man3type/sigevent.3type @@ -1 +1,142 @@ -.so man7/system_data_types.7 +.\" Copyright (c) 2006, 2010, 2020, Michael Kerrisk <mtk.manpages@gmail.com> +.\" Copyright (C) 2009 Petr Baudis <pasky@suse.cz> +.\" Copyright (c) 2020-2023, Alejandro Colomar <alx@kernel.org> +.\" +.\" SPDX-License-Identifier: Linux-man-pages-copyleft +.\" +.TH sigevent 3type 2023-10-31 "Linux man-pages 6.7" +.SH NAME +sigevent, sigval \- structure for notification from asynchronous routines +.SH SYNOPSIS +.EX +.B #include <signal.h> +.P +.B struct sigevent { +.BR " int sigev_notify;" " /* Notification type */" +.BR " int sigev_signo;" " /* Signal number */" +.BR " union sigval sigev_value;" " /* Data passed with notification */" +\& +.B " void (*sigev_notify_function)(union sigval);" +.BR " " " /* Notification function" +.BR " " " (SIGEV_THREAD) */" +.B " pthread_attr_t *sigev_notify_attributes;" +.BR " " " /* Notification attributes */" +\& +.BR " " "/* Linux only: */" +.B " pid_t sigev_notify_thread_id;" +.BR " " " /* ID of thread to signal" +.BR " " " (SIGEV_THREAD_ID) */" +.B }; +.P +.BR "union sigval {" " /* Data passed with notification */" +.BR " int sival_int;" " /* Integer value */" +.BR " void *sival_ptr;" " /* Pointer value */" +.B }; +.EE +.SH DESCRIPTION +.SS sigevent +The +.I sigevent +structure is used by various APIs +to describe the way a process is to be notified about an event +(e.g., completion of an asynchronous request, expiration of a timer, +or the arrival of a message). +.P +The definition shown in the SYNOPSIS is approximate: +some of the fields in the +.I sigevent +structure may be defined as part of a union. +Programs should employ only those fields relevant +to the value specified in +.IR sigev_notify . +.P +The +.I sigev_notify +field specifies how notification is to be performed. +This field can have one of the following values: +.TP +.B SIGEV_NONE +A "null" notification: don't do anything when the event occurs. +.TP +.B SIGEV_SIGNAL +Notify the process by sending the signal specified in +.IR sigev_signo . +.IP +If the signal is caught with a signal handler that was registered using the +.BR sigaction (2) +.B SA_SIGINFO +flag, then the following fields are set in the +.I siginfo_t +structure that is passed as the second argument of the handler: +.RS +.TP 10 +.I si_code +This field is set to a value that depends on the API +delivering the notification. +.TP +.I si_signo +This field is set to the signal number (i.e., the same value as in +.IR sigev_signo ). +.TP +.I si_value +This field is set to the value specified in +.IR sigev_value . +.RE +.IP +Depending on the API, other fields may also be set in the +.I siginfo_t +structure. +.IP +The same information is also available if the signal is accepted using +.BR sigwaitinfo (2). +.TP +.B SIGEV_THREAD +Notify the process by invoking +.I sigev_notify_function +"as if" it were the start function of a new thread. +(Among the implementation possibilities here are that +each timer notification could result in the creation of a new thread, +or that a single thread is created to receive all notifications.) +The function is invoked with +.I sigev_value +as its sole argument. +If +.I sigev_notify_attributes +is not NULL, it should point to a +.I pthread_attr_t +structure that defines attributes for the new thread (see +.BR pthread_attr_init (3)). +.TP +.BR SIGEV_THREAD_ID " (Linux-specific)" +.\" | SIGEV_SIGNAL vs not? +Currently used only by POSIX timers; see +.BR timer_create (2). +.SS sigval +Data passed with a signal. +.SH STANDARDS +POSIX.1-2008. +.SH HISTORY +POSIX.1-2001. +.P +.I <aio.h> +and +.I <time.h> +define +.I sigevent +since POSIX.1-2008. +.SH NOTES +The following headers also provide +.IR sigevent : +.IR <aio.h> , +.IR <mqueue.h> , +and +.IR <time.h> . +.SH SEE ALSO +.BR timer_create (2), +.BR getaddrinfo_a (3), +.BR lio_listio (3), +.BR mq_notify (3), +.BR pthread_sigqueue (3), +.BR sigqueue (3), +.BR aiocb (3type), +.BR siginfo_t (3type) diff --git a/man3type/sigval.3type b/man3type/sigval.3type index db50c0f..b43f1bb 100644 --- a/man3type/sigval.3type +++ b/man3type/sigval.3type @@ -1 +1 @@ -.so man7/system_data_types.7 +.so man3type/sigevent.3type diff --git a/man3type/size_t.3type b/man3type/size_t.3type index 9df433a..c9ac9c2 100644 --- a/man3type/size_t.3type +++ b/man3type/size_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH size_t 3type 2023-03-31 "Linux man-pages 6.05.01" +.TH size_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME size_t, ssize_t \- count of bytes .SH LIBRARY @@ -13,11 +13,11 @@ Standard C library .SH SYNOPSIS .nf .B #include <stddef.h> -.PP +.P .BR typedef " /* ... */ " size_t; -.PP +.P .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " ssize_t; .fi .SH DESCRIPTION @@ -99,7 +99,7 @@ C89, POSIX.1-2001. .TP .I ssize_t POSIX.1-2001. -.PP +.P .IR <aio.h> , .IR <glob.h> , .IR <grp.h> , @@ -112,7 +112,7 @@ and define .I size_t since POSIX.1-2008. -.PP +.P .IR <aio.h> , .IR <mqueue.h> , and diff --git a/man3type/sockaddr.3type b/man3type/sockaddr.3type index dacc9ad..2ca69c8 100644 --- a/man3type/sockaddr.3type +++ b/man3type/sockaddr.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH sockaddr 3type 2023-04-22 "Linux man-pages 6.05.01" +.TH sockaddr 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME sockaddr, sockaddr_storage, sockaddr_in, sockaddr_in6, sockaddr_un, socklen_t, in_addr, in6_addr, in_addr_t, in_port_t, @@ -15,30 +15,30 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/socket.h> -.PP +.P .B struct sockaddr { .BR " sa_family_t sa_family;" " /* Address family */" .BR " char sa_data[];" " /* Socket address */" .B }; -.PP +.P .B struct sockaddr_storage { .BR " sa_family_t ss_family;" " /* Address family */" .B }; -.PP +.P .BR typedef " /* ... */ " socklen_t; .BR typedef " /* ... */ " sa_family_t; -.PP +.P .EE .SS Internet domain sockets .EX .B #include <netinet/in.h> -.PP +.P .B struct sockaddr_in { .BR " sa_family_t sin_family;" " /* " AF_INET " */" .BR " in_port_t sin_port;" " /* Port number */" .BR " struct in_addr sin_addr;" " /* IPv4 address */" .B }; -.PP +.P .B struct sockaddr_in6 { .BR " sa_family_t sin6_family;" " /* " AF_INET6 " */" .BR " in_port_t sin6_port;" " /* Port number */" @@ -46,22 +46,22 @@ Standard C library .BR " struct in6_addr sin6_addr;" " /* IPv6 address */" .BR " uint32_t sin6_scope_id;" " /* Set of interfaces for a scope */" .B }; -.PP +.P .B struct in_addr { .B " in_addr_t s_addr;" .B }; -.PP +.P .B struct in6_addr { .B " uint8_t s6_addr[16];" .B }; -.PP +.P .B typedef uint32_t in_addr_t; .B typedef uint16_t in_port_t; .EE .SS UNIX domain sockets .EX .B #include <sys/un.h> -.PP +.P .B struct sockaddr_un { .BR " sa_family_t sun_family;" " /* Address family */" .BR " char sun_path[];" " /* Socket pathname */" @@ -112,12 +112,12 @@ Describes a UNIX domain socket address. POSIX.1-2008. .SH HISTORY POSIX.1-2001. -.PP +.P .I socklen_t was invented by POSIX. See also .BR accept (2). -.PP +.P These structures were invented before modern ISO C strict-aliasing rules. If aliasing rules are applied strictly, these structures would be extremely difficult to use @@ -129,7 +129,7 @@ can be safely used as they were designed. .I socklen_t is also defined in .IR <netdb.h> . -.PP +.P .I sa_family_t is also defined in .I <netinet/in.h> diff --git a/man3type/stat.3type b/man3type/stat.3type index 6630641..71b850e 100644 --- a/man3type/stat.3type +++ b/man3type/stat.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH stat 3type 2023-05-03 "Linux man-pages 6.05.01" +.TH stat 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME stat \- file status .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/stat.h> -.PP +.P .B struct stat { .BR " dev_t st_dev;" " /* ID of device containing file */" .BR " ino_t st_ino;" " /* Inode number */" @@ -39,12 +39,12 @@ Standard C library .B "#define st_ctime st_ctim.tv_sec" .B }; .EE -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .IR st_atim , .IR st_mtim , .IR st_ctim : @@ -56,7 +56,7 @@ Feature Test Macro Requirements for glibc (see .fi .SH DESCRIPTION Describes information about a file. -.PP +.P The fields are as follows: .TP .I st_dev @@ -113,14 +113,14 @@ This is the time of last modification of file data. .I st_ctime This is the file's last status change timestamp (time of last change to the inode). -.PP +.P For further information on the above fields, see .BR inode (7). .SH STANDARDS POSIX.1-2008. .SH HISTORY POSIX.1-2001. -.PP +.P Old kernels and old standards did not support nanosecond timestamp fields. Instead, there were three timestamp .RI fields\[em] st_atime , @@ -130,7 +130,7 @@ and as .I time_t that recorded timestamps with one-second precision. -.PP +.P Since Linux 2.5.48, the .I stat structure supports nanosecond resolution for the three file timestamp fields. diff --git a/man3type/time_t.3type b/man3type/time_t.3type index 2b087e5..d528ad3 100644 --- a/man3type/time_t.3type +++ b/man3type/time_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH time_t 3type 2023-03-31 "Linux man-pages 6.05.01" +.TH time_t 3type 2023-11-11 "Linux man-pages 6.7" .SH NAME time_t, suseconds_t, useconds_t \- integer time .SH LIBRARY @@ -13,11 +13,11 @@ Standard C library .SH SYNOPSIS .nf .B #include <time.h> -.PP +.P .BR typedef " /* ... */ " time_t; -.PP +.P .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " suseconds_t; .BR typedef " /* ... */ " useconds_t; .fi @@ -64,12 +64,12 @@ C89, POSIX.1-2001. .TQ .I useconds_t POSIX.1-2001. -.PP +.P .I <sched.h> defines .I time_t since POSIX.1-2008. -.PP +.P POSIX.1-2001 defined .I useconds_t in @@ -81,7 +81,9 @@ the width of .I time_t can be controlled with the feature test macro .BR _TIME_BITS . -.PP +See +.BR feature_test_macros (7). +.P The following headers also provide .IR time_t : .IR <sched.h> , @@ -94,7 +96,7 @@ The following headers also provide .IR <sys/types.h> , and .IR <utime.h> . -.PP +.P The following headers also provide .IR suseconds_t : .I <sys/select.h> diff --git a/man3type/timer_t.3type b/man3type/timer_t.3type index 8341ec1..a14dc1e 100644 --- a/man3type/timer_t.3type +++ b/man3type/timer_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH timer_t 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH timer_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME timer_t \- timer ID .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " timer_t; .fi .SH DESCRIPTION diff --git a/man3type/timespec.3type b/man3type/timespec.3type index 213c131..8e18d2e 100644 --- a/man3type/timespec.3type +++ b/man3type/timespec.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH timespec 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH timespec 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME timespec \- time in seconds and nanoseconds .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <time.h> -.PP +.P .B struct timespec { .BR " time_t tv_sec;" " /* Seconds */" .RB " /* ... */" " tv_nsec;" \ @@ -22,7 +22,7 @@ Standard C library .EE .SH DESCRIPTION Describes times in seconds and nanoseconds. -.PP +.P .I tv_nsec is of an implementation-defined signed type capable of holding the specified range. diff --git a/man3type/timeval.3type b/man3type/timeval.3type index 97f450d..9724029 100644 --- a/man3type/timeval.3type +++ b/man3type/timeval.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH timeval 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH timeval 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME timeval \- time in seconds and microseconds .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/time.h> -.PP +.P .B struct timeval { .BR " time_t tv_sec;" " /* Seconds */" .BR " suseconds_t tv_usec;" " /* Microseconds */" diff --git a/man3type/tm.3type b/man3type/tm.3type index 42cd1e3..721a5aa 100644 --- a/man3type/tm.3type +++ b/man3type/tm.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH tm 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH tm 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME tm \- broken-down time .SH LIBRARY @@ -12,7 +12,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <time.h> -.PP +.P .B struct tm { .BR " int tm_sec;" " /* Seconds [" 0 ", " 60 "] */" .BR " int tm_min;" " /* Minutes [" 0 ", " 59 "] */" @@ -26,17 +26,17 @@ Standard C library .BR " int tm_yday;" \ " /* Day of the year [" 0 ", " 365 "] (Jan/01 = " 0 ") */" .BR " int tm_isdst;" " /* Daylight savings flag */" -.PP +.P .BR " long tm_gmtoff;" " /* Seconds East of UTC */" .BR " const char *tm_zone;" " /* Timezone abbreviation */" .B }; .EE -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .IR tm_gmtoff , .IR tm_zone : .nf @@ -48,19 +48,19 @@ Feature Test Macro Requirements for glibc (see .fi .SH DESCRIPTION Describes time, broken down into distinct components. -.PP +.P .I tm_isdst describes whether daylight saving time is in effect at the time described. The value is positive if daylight saving time is in effect, zero if it is not, and negative if the information is not available. -.PP +.P .I tm_gmtoff is the difference, in seconds, of the timezone represented by this broken-down time and UTC (this is the additive inverse of .BR timezone (3)). -.PP +.P .I tm_zone is the equivalent of .BR tzname (3) @@ -75,7 +75,7 @@ UTC doesn't permit double leap seconds, so it was limited to .B 60 in C99. -.PP +.P .BR timezone (3), as a variable, is an XSI extension: some systems provide the V7-compatible .\" FreeBSD @@ -84,7 +84,7 @@ function. The .I tm_gmtoff field provides an alternative (with the opposite sign) for those systems. -.PP +.P .I tm_zone points to static storage and may be overridden on subsequent calls to .BR localtime (3) @@ -93,7 +93,7 @@ and similar functions (however, this never happens under glibc). C11, POSIX.1-2008. .SH HISTORY C89, POSIX.1-2001. -.PP +.P .I tm_gmtoff and .I tm_zone diff --git a/man3type/va_list.3type b/man3type/va_list.3type index 3549829..d520594 100644 --- a/man3type/va_list.3type +++ b/man3type/va_list.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH va_list 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH va_list 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME va_list \- variable argument list .SH LIBRARY @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdarg.h> -.PP +.P .BR typedef " /* ... */ " va_list; .fi .SH DESCRIPTION diff --git a/man3type/void.3type b/man3type/void.3type index 45907e9..4174f5f 100644 --- a/man3type/void.3type +++ b/man3type/void.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH void 3type 2023-03-30 "Linux man-pages 6.05.01" +.TH void 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME void \- abstract type .SH SYNOPSIS @@ -20,7 +20,7 @@ including pointers to functions, may be converted to a pointer to .I void and back. -.PP +.P Conversions from and to any other pointer type are done implicitly, not requiring casts at all. Note that this feature prevents any kind of type checking: @@ -28,13 +28,13 @@ the programmer should be careful not to convert a .I void * value to a type incompatible to that of the underlying data, because that would result in undefined behavior. -.PP +.P This type is useful in function parameters and return value to allow passing values of any type. The function will typically use some mechanism to know the real type of the data being passed via a pointer to .IR void . -.PP +.P A value of this type can't be dereferenced, as it would give a value of type .IR void , |