diff options
| author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-21 15:33:38 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-21 15:33:55 +0200 |
| commit | 8042eca2fb8edc41c20c225cce6bfae143e055ed (patch) | |
| tree | d853dde61efdcd5ced71386ac7d6084c088aab44 | |
| parent | 3316dc71809dcc815703d93cb046c34c23881a97 (diff) | |
| download | man-pages-8042eca2fb8edc41c20c225cce6bfae143e055ed.tar.gz | |
timespec.3type, system_data_types.7: Move timespec to a separate page
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
| -rw-r--r-- | man3/timespec.3type | 75 | ||||
| -rw-r--r-- | man7/system_data_types.7 | 64 |
2 files changed, 74 insertions, 65 deletions
diff --git a/man3/timespec.3type b/man3/timespec.3type index db50c0f091..000206d97e 100644 --- a/man3/timespec.3type +++ b/man3/timespec.3type @@ -1 +1,74 @@ -.so man7/system_data_types.7 +.\" Copyright (c) 2020-2022 by Alejandro Colomar <colomar.6.4.3@gmail.com> +.\" and Copyright (c) 2020 by Michael Kerrisk <mtk.manpages@gmail.com> +.\" +.\" SPDX-License-Identifier: Linux-man-pages-copyleft +.\" +.\" +.TH TIMESPEC 3type 2022-07-21 Linux "Linux Programmer's Manual" +.SH NAME +timespec \- time in seconds and nanoseconds +.SH LIBRARY +Standard C library +.RI ( libc ) +.SH SYNOPSIS +.nf +.B #include <time.h> +.PP +.B struct timespec { +.BR " time_t tv_sec;" " /* Seconds */" +.BR " long tv_usec;" " /* Nanoseconds [" 0 ", " 999999999 "] */" +.B }; +.fi +.SH DESCRIPTION +Describes times in seconds and nanoseconds. +.SH CONFORMING TO +C11 and later; +POSIX.1-2001 and later. +.SH NOTES +The following headers also provide this type: +.IR <aio.h> , +.IR <mqueue.h> , +.IR <sched.h> , +.IR <signal.h> , +.IR <sys/select.h> , +and +.IR <sys/stat.h> . +.SH BUGS +Under glibc, +.I tv_nsec +is the +.I syscall +long, +though this affects only fringe architectures like X32, +which is ILP32, but uses the LP64 AMD64 syscall ABI. +In reality, the field ends up being defined as: +.PP +.in +4n +.EX +#if __x86_64__ && __ILP32__ /* == x32 */ + long long tv_nsec; +#else + long tv_nsec; +#endif +.EE +.in +.PP +This is a long-stansing and long-enshrined glibc bug +.UR https://sourceware.org/bugzilla/show_bug.cgi?id=16437 +.I #16437 +.UE , +and an incompatible extension to the standards; +however, as even a 32-bit +.I long +can hold the entire +.I tv_nsec +range, +it's always safe to forcibly down-cast it to the standard type. +.SH SEE ALSO +.BR clock_gettime (2), +.BR clock_nanosleep (2), +.BR nanosleep (2), +.BR timerfd_gettime (2), +.BR timer_gettime (2), +.BR time_t (3type), +.BR timeval (3type) diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 index 078debd0a1..491fe884eb 100644 --- a/man7/system_data_types.7 +++ b/man7/system_data_types.7 @@ -456,70 +456,6 @@ POSIX.1-2001 and later. .BR timer_settime (2) .RE .\"------------------------------------- timespec ---------------------/ -.TP -.I timespec -.RS -.IR Include : -.IR <time.h> . -Alternatively, -.IR <aio.h> , -.IR <mqueue.h> , -.IR <sched.h> , -.IR <signal.h> , -.IR <sys/select.h> , -or -.IR <sys/stat.h> . -.PP -.EX -struct timespec { - time_t tv_sec; /* Seconds */ - long tv_nsec; /* Nanoseconds [0 .. 999999999] */ -}; -.EE -.PP -Describes times in seconds and nanoseconds. -.PP -.IR "Conforming to" : -C11 and later; POSIX.1-2001 and later. -.PP -.IR Bugs : -Under glibc, -.I tv_nsec -is the -.I syscall -long, though this affects only fringe architectures like X32, -which is ILP32, but uses the LP64 AMD64 syscall ABI. -In reality, the field ends up being defined as: -.PP -.in +4 -.EX -#if __x86_64__ && __ILP32__ /* == x32 */ - long long tv_nsec; -#else - long tv_nsec; -#endif -.EE -.in -.PP -This is a long-standing and long-enshrined -.UR https://sourceware.org/bugzilla/show_bug.cgi?id=16437 -glibc bug -.I #16437 -.UE , -and an incompatible extension to the standards; -however, as even a 32-bit -.I long -can hold the entire -.I tv_nsec -range, it's always safe to forcibly down-cast it to the standard type. -.PP -.IR "See also" : -.BR clock_gettime (2), -.BR clock_nanosleep (2), -.BR nanosleep (2), -.BR timerfd_gettime (2), -.BR timer_gettime (2) -.RE .\"------------------------------------- timeval ----------------------/ .\"------------------------------------- uid_t ----------------------/ .\"------------------------------------- uintmax_t --------------------/ |