diff options
Diffstat (limited to 'upstream/mageia-cauldron/man0p')
82 files changed, 18831 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man0p/aio.h.0p b/upstream/mageia-cauldron/man0p/aio.h.0p new file mode 100644 index 00000000..aa28ef13 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/aio.h.0p @@ -0,0 +1,178 @@ +'\" et +.TH aio.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +aio.h +\(em asynchronous input and output +.SH SYNOPSIS +.LP +.nf +#include <aio.h> +.fi +.SH DESCRIPTION +The +.IR <aio.h> +header shall define the +.BR aiocb +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int aio_fildes \fRFile descriptor.\fR +off_t aio_offset \fRFile offset.\fR +volatile void *aio_buf \fRLocation of buffer.\fR +size_t aio_nbytes \fRLength of transfer.\fR +int aio_reqprio \fRRequest priority offset.\fR +struct sigevent aio_sigevent \fRSignal number and value.\fR +int aio_lio_opcode \fROperation to be performed.\fR +.fi +.P +.RE +.P +The +.IR <aio.h> +header shall define the +.BR off_t , +.BR pthread_attr_t , +.BR size_t , +and +.BR ssize_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <aio.h> +header shall define the +.BR "struct timespec" +structure as described in +.IR <time.h> . +.P +The +.IR <aio.h> +header shall define the +.BR sigevent +structure and +.BR sigval +union as described in +.IR "\fB<signal.h>\fP". +.P +The +.IR <aio.h> +header shall define the following symbolic constants: +.IP AIO_ALLDONE 14 +A return value indicating that none of the requested operations could +be canceled since they are already complete. +.IP AIO_CANCELED 14 +A return value indicating that all requested operations have been +canceled. +.IP AIO_NOTCANCELED 14 +.br +A return value indicating that some of the requested operations could +not be canceled since they are in progress. +.IP LIO_NOP 14 +A +\fIlio_listio\fR() +element operation option indicating that no transfer is requested. +.IP LIO_NOWAIT 14 +A +\fIlio_listio\fR() +synchronization operation indicating that the calling thread is to +continue execution while the +\fIlio_listio\fR() +operation is being performed, and no notification is given when the +operation is complete. +.IP LIO_READ 14 +A +\fIlio_listio\fR() +element operation option requesting a read. +.IP LIO_WAIT 14 +A +\fIlio_listio\fR() +synchronization operation indicating that the calling thread is to +suspend until the +\fIlio_listio\fR() +operation is complete. +.IP LIO_WRITE 14 +A +\fIlio_listio\fR() +element operation option requesting a write. +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int aio_cancel(int, struct aiocb *); +int aio_error(const struct aiocb *); +int aio_fsync(int, struct aiocb *); +int aio_read(struct aiocb *); +ssize_t aio_return(struct aiocb *); +int aio_suspend(const struct aiocb *const [], int, + const struct timespec *); +int aio_write(struct aiocb *); +int lio_listio(int, struct aiocb *restrict const [restrict], int, + struct sigevent *restrict); +.fi +.P +.RE +.P +Inclusion of the +.IR <aio.h> +header may make visible symbols defined in the headers +.IR <fcntl.h> , +.IR <signal.h> , +and +.IR <time.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<fcntl.h>\fP", +.IR "\fB<signal.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<time.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIaio_cancel\fR\^(\|)", +.IR "\fIaio_error\fR\^(\|)", +.IR "\fIaio_fsync\fR\^(\|)", +.IR "\fIaio_read\fR\^(\|)", +.IR "\fIaio_return\fR\^(\|)", +.IR "\fIaio_suspend\fR\^(\|)", +.IR "\fIaio_write\fR\^(\|)", +.IR "\fIfsync\fR\^(\|)", +.IR "\fIlio_listio\fR\^(\|)", +.IR "\fIlseek\fR\^(\|)", +.IR "\fIread\fR\^(\|)", +.IR "\fIwrite\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/arpa_inet.h.0p b/upstream/mageia-cauldron/man0p/arpa_inet.h.0p new file mode 100644 index 00000000..ef9eeb84 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/arpa_inet.h.0p @@ -0,0 +1,120 @@ +'\" et +.TH arpa_inet.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +arpa/inet.h +\(em definitions for internet operations +.SH SYNOPSIS +.LP +.nf +#include <arpa/inet.h> +.fi +.SH DESCRIPTION +The +.IR <arpa/inet.h> +header shall define the +.BR in_port_t +and +.BR in_addr_t +types as described in +.IR <netinet/in.h> . +.P +The +.IR <arpa/inet.h> +header shall define the +.BR in_addr +structure as described in +.IR <netinet/in.h> . +.P +The +.IR <arpa/inet.h> +header shall define the INET_ADDRSTRLEN +and INET6_ADDRSTRLEN +macros as described in +.IR <netinet/in.h> . +.P +The following shall be declared as functions, or defined as macros, +or both. If functions are declared, function prototypes shall be +provided. +.sp +.RS 4 +.nf + +uint32_t htonl(uint32_t); +uint16_t htons(uint16_t); +uint32_t ntohl(uint32_t); +uint16_t ntohs(uint16_t); +.fi +.P +.RE +.P +The +.IR <arpa/inet.h> +header shall define the +.BR uint32_t +and +.BR uint16_t +types as described in +.IR <inttypes.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +in_addr_t inet_addr(const char *); +char *inet_ntoa(struct in_addr); +const char *inet_ntop(int, const void *restrict, char *restrict, + socklen_t); +int inet_pton(int, const char *restrict, void *restrict); +.fi +.P +.RE +.P +Inclusion of the +.IR <arpa/inet.h> +header may also make visible all symbols from +.IR <netinet/in.h> +and +.IR <inttypes.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH "RATIONALE" +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<inttypes.h>\fP", +.IR "\fB<netinet_in.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIhtonl\fR\^(\|)", +.IR "\fIinet_addr\fR\^(\|)", +.IR "\fIinet_ntop\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/assert.h.0p b/upstream/mageia-cauldron/man0p/assert.h.0p new file mode 100644 index 00000000..c20cef35 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/assert.h.0p @@ -0,0 +1,84 @@ +'\" et +.TH assert.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +assert.h +\(em verify program assertion +.SH SYNOPSIS +.LP +.nf +#include <assert.h> +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The +.IR <assert.h> +header shall define the +\fIassert\fR() +macro. It refers to the macro NDEBUG +which is not defined in the header. If NDEBUG is defined as a macro +name before the inclusion of this header, the +\fIassert\fR() +macro shall be defined simply as: +.sp +.RS 4 +.nf + +#define assert(ignore)((void) 0) +.fi +.P +.RE +.P +Otherwise, the macro behaves as described in +\fIassert\fR(). +.P +The +\fIassert\fR() +macro shall be redefined according to the current state of NDEBUG each +time +.IR <assert.h> +is included. +.P +The +\fIassert\fR() +macro shall be implemented as a macro, not as a function. If the macro +definition is suppressed in order to access an actual function, the +behavior is undefined. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIassert\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/complex.h.0p b/upstream/mageia-cauldron/man0p/complex.h.0p new file mode 100644 index 00000000..ccc21a70 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/complex.h.0p @@ -0,0 +1,256 @@ +'\" et +.TH complex.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +complex.h +\(em complex arithmetic +.SH SYNOPSIS +.LP +.nf +#include <complex.h> +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The +.IR <complex.h> +header shall define the following macros: +.IP complex 12 +Expands to +.BR _Complex . +.IP _Complex_I 12 +Expands to a constant expression of type +.BR "const float _Complex" , +with the value of the imaginary unit (that is, a number +.IR i +such that \fIi\fR\s-3\u2\d\s+3=\-1). +.IP imaginary 12 +Expands to +.BR _Imaginary . +.IP _Imaginary_I 12 +Expands to a constant expression of type +.BR "const float _Imaginary" +with the value of the imaginary unit. +.IP I 12 +Expands to either _Imaginary_I or _Complex_I. If _Imaginary_I is not +defined, I expands to _Complex_I. +.P +The macros imaginary and _Imaginary_I shall be defined if and only if +the implementation supports imaginary types. +.P +An application may undefine and then, perhaps, redefine the complex, +imaginary, and I macros. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +double cabs(double complex); +float cabsf(float complex); +long double cabsl(long double complex); +double complex cacos(double complex); +float complex cacosf(float complex); +double complex cacosh(double complex); +float complex cacoshf(float complex); +long double complex cacoshl(long double complex); +long double complex cacosl(long double complex); +double carg(double complex); +float cargf(float complex); +long double cargl(long double complex); +double complex casin(double complex); +float complex casinf(float complex); +double complex casinh(double complex); +float complex casinhf(float complex); +long double complex casinhl(long double complex); +long double complex casinl(long double complex); +double complex catan(double complex); +float complex catanf(float complex); +double complex catanh(double complex); +float complex catanhf(float complex); +long double complex catanhl(long double complex); +long double complex catanl(long double complex); +double complex ccos(double complex); +float complex ccosf(float complex); +double complex ccosh(double complex); +float complex ccoshf(float complex); +long double complex ccoshl(long double complex); +long double complex ccosl(long double complex); +double complex cexp(double complex); +float complex cexpf(float complex); +long double complex cexpl(long double complex); +double cimag(double complex); +float cimagf(float complex); +long double cimagl(long double complex); +double complex clog(double complex); +float complex clogf(float complex); +long double complex clogl(long double complex); +double complex conj(double complex); +float complex conjf(float complex); +long double complex conjl(long double complex); +double complex cpow(double complex, double complex); +float complex cpowf(float complex, float complex); +long double complex cpowl(long double complex, long double complex); +double complex cproj(double complex); +float complex cprojf(float complex); +long double complex cprojl(long double complex); +double creal(double complex); +float crealf(float complex); +long double creall(long double complex); +double complex csin(double complex); +float complex csinf(float complex); +double complex csinh(double complex); +float complex csinhf(float complex); +long double complex csinhl(long double complex); +long double complex csinl(long double complex); +double complex csqrt(double complex); +float complex csqrtf(float complex); +long double complex csqrtl(long double complex); +double complex ctan(double complex); +float complex ctanf(float complex); +double complex ctanh(double complex); +float complex ctanhf(float complex); +long double complex ctanhl(long double complex); +long double complex ctanl(long double complex); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +Values are interpreted as radians, not degrees. +.SH RATIONALE +The choice of +.IR I +instead of +.IR i +for the imaginary unit concedes to the widespread use of the identifier +.IR i +for other purposes. The application can use a different identifier, say +.IR j , +for the imaginary unit by following the inclusion of the +.IR <complex.h> +header with: +.sp +.RS 4 +.nf + +#undef I +#define j _Imaginary_I +.fi +.P +.RE +.P +An +.IR I +suffix to designate imaginary constants is not required, as +multiplication by +.IR I +provides a sufficiently convenient and more generally useful notation +for imaginary terms. The corresponding real type for the imaginary unit +is +.BR float , +so that use of +.IR I +for algorithmic or notational convenience will not result in +widening types. +.P +On systems with imaginary types, the application has the ability to +control whether use of the macro I introduces an imaginary type, by +explicitly defining I to be _Imaginary_I or _Complex_I. Disallowing +imaginary types is useful for some applications intended to run on +implementations without support for such types. +.P +The macro _Imaginary_I provides a test for whether imaginary types are +supported. +.P +The +\fIcis\fR() +function (\fIcos\fR(\fIx\fR) + \fII\fR*\fIsin\fR(\fIx\fR)) was +considered but rejected because its implementation is easy and +straightforward, even though some implementations could compute sine +and cosine more efficiently in tandem. +.SH "FUTURE DIRECTIONS" +The following function names and the same names suffixed with +.IR f +or +.IR l +are reserved for future use, and may be added to the declarations +in the +.IR <complex.h> +header. +.sp +.RS +.TS +tab(!); +l l l. +T{ +.nf +\fIcerf\fR() +\fIcerfc\fR() +\fIcexp2\fR() +T}!T{ +.nf +\fIcexpm1\fR() +\fIclog10\fR() +\fIclog1p\fR() +T}!T{ +.nf +\fIclog2\fR() +\fIclgamma\fR() +\fIctgamma\fR() +.fi +T} +.TE +.RE +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIcabs\fR\^(\|)", +.IR "\fIcacos\fR\^(\|)", +.IR "\fIcacosh\fR\^(\|)", +.IR "\fIcarg\fR\^(\|)", +.IR "\fIcasin\fR\^(\|)", +.IR "\fIcasinh\fR\^(\|)", +.IR "\fIcatan\fR\^(\|)", +.IR "\fIcatanh\fR\^(\|)", +.IR "\fIccos\fR\^(\|)", +.IR "\fIccosh\fR\^(\|)", +.IR "\fIcexp\fR\^(\|)", +.IR "\fIcimag\fR\^(\|)", +.IR "\fIclog\fR\^(\|)", +.IR "\fIconj\fR\^(\|)", +.IR "\fIcpow\fR\^(\|)", +.IR "\fIcproj\fR\^(\|)", +.IR "\fIcreal\fR\^(\|)", +.IR "\fIcsin\fR\^(\|)", +.IR "\fIcsinh\fR\^(\|)", +.IR "\fIcsqrt\fR\^(\|)", +.IR "\fIctan\fR\^(\|)", +.IR "\fIctanh\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/cpio.h.0p b/upstream/mageia-cauldron/man0p/cpio.h.0p new file mode 100644 index 00000000..b6618357 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/cpio.h.0p @@ -0,0 +1,93 @@ +'\" et +.TH cpio.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +cpio.h +\(em cpio archive values +.SH SYNOPSIS +.LP +.nf +#include <cpio.h> +.fi +.SH DESCRIPTION +The +.IR <cpio.h> +header shall define the symbolic constants needed by the +.IR c_mode +field of the +.IR cpio +archive format, with the names and values given in the following table: +.TS +box center tab(@); +cB| cB |cB +l| l |c. +Name@Description@Value (Octal) +_ +C_IRUSR@Read by owner.@0000400 +C_IWUSR@Write by owner.@0000200 +C_IXUSR@Execute by owner.@0000100 +C_IRGRP@Read by group.@0000040 +C_IWGRP@Write by group.@0000020 +C_IXGRP@Execute by group.@0000010 +C_IROTH@Read by others.@0000004 +C_IWOTH@Write by others.@0000002 +C_IXOTH@Execute by others.@0000001 +C_ISUID@Set user ID.@0004000 +C_ISGID@Set group ID.@0002000 +C_ISVTX@On directories, restricted deletion flag.@0001000 +C_ISDIR@Directory.@0040000 +C_ISFIFO@FIFO.@0010000 +C_ISREG@Regular file.@0100000 +C_ISBLK@Block special.@0060000 +C_ISCHR@Character special.@0020000 +C_ISCTG@Reserved.@0110000 +C_ISLNK@Symbolic link.@0120000 +C_ISSOCK@Socket.@0140000 +.TE +.P +The +.IR <cpio.h> +header shall define the following symbolic constant as a string: +.sp +.RS 4 +.nf + +MAGIC "070707" +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "\fIpax\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/ctype.h.0p b/upstream/mageia-cauldron/man0p/ctype.h.0p new file mode 100644 index 00000000..5fcd17c2 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/ctype.h.0p @@ -0,0 +1,140 @@ +'\" et +.TH ctype.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +ctype.h +\(em character types +.SH SYNOPSIS +.LP +.nf +#include <ctype.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <ctype.h> +header shall define the +.BR locale_t +type as described in +.IR <locale.h> , +representing a locale object. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided for use with ISO\ C standard +compilers. +.sp +.RS 4 +.nf + +int isalnum(int); +int isalnum_l(int, locale_t); +int isalpha(int); +int isalpha_l(int, locale_t); +int isascii(int); +int isblank(int); +int isblank_l(int, locale_t); +int iscntrl(int); +int iscntrl_l(int, locale_t); +int isdigit(int); +int isdigit_l(int, locale_t); +int isgraph(int); +int isgraph_l(int, locale_t); +int islower(int); +int islower_l(int, locale_t); +int isprint(int); +int isprint_l(int, locale_t); +int ispunct(int); +int ispunct_l(int, locale_t); +int isspace(int); +int isspace_l(int, locale_t); +int isupper(int); +int isupper_l(int, locale_t); +int isxdigit(int); +int isxdigit_l(int, locale_t); +int toascii(int); +int tolower(int); +int tolower_l(int, locale_t); +int toupper(int); +int toupper_l(int, locale_t); +.fi +.P +.RE +.P +The +.IR <ctype.h> +header shall define the following as macros: +.sp +.RS 4 +.nf + +int _toupper(int); +int _tolower(int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<locale.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIisalnum\fR\^(\|)", +.IR "\fIisalpha\fR\^(\|)", +.IR "\fIisascii\fR\^(\|)", +.IR "\fIisblank\fR\^(\|)", +.IR "\fIiscntrl\fR\^(\|)", +.IR "\fIisdigit\fR\^(\|)", +.IR "\fIisgraph\fR\^(\|)", +.IR "\fIislower\fR\^(\|)", +.IR "\fIisprint\fR\^(\|)", +.IR "\fIispunct\fR\^(\|)", +.IR "\fIisspace\fR\^(\|)", +.IR "\fIisupper\fR\^(\|)", +.IR "\fIisxdigit\fR\^(\|)", +.IR "\fImblen\fR\^(\|)", +.IR "\fImbstowcs\fR\^(\|)", +.IR "\fImbtowc\fR\^(\|)", +.IR "\fIsetlocale\fR\^(\|)", +.IR "\fItoascii\fR\^(\|)", +.IR "\fItolower\fR\^(\|)", +.IR "\fI_tolower\fR\^(\|)", +.IR "\fItoupper\fR\^(\|)", +.IR "\fI_toupper\fR\^(\|)", +.IR "\fIwcstombs\fR\^(\|)", +.IR "\fIwctomb\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/dirent.h.0p b/upstream/mageia-cauldron/man0p/dirent.h.0p new file mode 100644 index 00000000..15dded5c --- /dev/null +++ b/upstream/mageia-cauldron/man0p/dirent.h.0p @@ -0,0 +1,165 @@ +'\" et +.TH dirent.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +dirent.h +\(em format of directory entries +.SH SYNOPSIS +.LP +.nf +#include <dirent.h> +.fi +.SH DESCRIPTION +The internal format of directories is unspecified. +.P +The +.IR <dirent.h> +header shall define the following type: +.IP "\fBDIR\fR" 8 +A type representing a directory stream. The +.BR DIR +type may be an incomplete type. +.P +It shall also define the structure +.BR dirent +which shall include the following members: +.sp +.RS 4 +.nf + +ino_t d_ino \fRFile serial number.\fR +char d_name[] \fRFilename string of entry.\fR +.fi +.P +.RE +.P +The +.IR <dirent.h> +header shall define the +.BR ino_t +type as described in +.IR <sys/types.h> . +.P +The array +.IR d_name +is of unspecified size, but shall contain a filename of at most +{NAME_MAX} +bytes followed by a terminating null byte. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int alphasort(const struct dirent **, const struct dirent **); +int closedir(DIR *); +int dirfd(DIR *); +DIR *fdopendir(int); +DIR *opendir(const char *); +struct dirent *readdir(DIR *); +int readdir_r(DIR *restrict, struct dirent *restrict, + struct dirent **restrict); +void rewinddir(DIR *); +int scandir(const char *, struct dirent ***, + int (*)(const struct dirent *), + int (*)(const struct dirent **, + const struct dirent **)); +void seekdir(DIR *, long); +long telldir(DIR *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +Information similar to that in the +.IR <dirent.h> +header is contained in a file +.IR <sys/dir.h> +in 4.2 BSD and 4.3 BSD. The equivalent in these implementations of +.BR "struct dirent" +from this volume of POSIX.1\(hy2017 is +.BR "struct direct" . +The filename was changed because the name +.IR <sys/dir.h> +was also used in earlier implementations to refer to definitions +related to the older access method; this produced name conflicts. The +name of the structure was changed because this volume of POSIX.1\(hy2017 does not completely +define what is in the structure, so it could be different on some +implementations from +.BR "struct direct" . +.P +The name of an array of +.BR char +of an unspecified size should not be used as an lvalue. Use of: +.sp +.RS 4 +.nf + +sizeof(d_name) +.fi +.P +.RE +.P +is incorrect; use: +.sp +.RS 4 +.nf + +strlen(d_name) +.fi +.P +.RE +.P +instead. +.P +The array of +.BR char +.IR d_name +is not a fixed size. Implementations may need to declare +.BR "struct dirent" +with an array size for +.IR d_name +of 1, but the actual number of bytes provided matches (or only slightly +exceeds) the length of the filename string. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIalphasort\fR\^(\|)", +.IR "\fIclosedir\fR\^(\|)", +.IR "\fIdirfd\fR\^(\|)", +.IR "\fIfdopendir\fR\^(\|)", +.IR "\fIreaddir\fR\^(\|)", +.IR "\fIrewinddir\fR\^(\|)", +.IR "\fIseekdir\fR\^(\|)", +.IR "\fItelldir\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/dlfcn.h.0p b/upstream/mageia-cauldron/man0p/dlfcn.h.0p new file mode 100644 index 00000000..59b38b26 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/dlfcn.h.0p @@ -0,0 +1,80 @@ +'\" et +.TH dlfcn.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +dlfcn.h +\(em dynamic linking +.SH SYNOPSIS +.LP +.nf +#include <dlfcn.h> +.fi +.SH DESCRIPTION +The +.IR <dlfcn.h> +header shall define at least the following symbolic constants for use +in the construction of a +\fIdlopen\fR() +.IR mode +argument: +.IP RTLD_LAZY 14 +Relocations are performed at an implementation-defined time. +.IP RTLD_NOW 14 +Relocations are performed when the object is loaded. +.IP RTLD_GLOBAL 14 +All symbols are available for relocation processing of other modules. +.IP RTLD_LOCAL 14 +All symbols are not made available for relocation processing by other +modules. +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int dlclose(void *); +char *dlerror(void); +void *dlopen(const char *, int); +void *dlsym(void *restrict, const char *restrict); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIdlclose\fR\^(\|)", +.IR "\fIdlerror\fR\^(\|)", +.IR "\fIdlopen\fR\^(\|)", +.IR "\fIdlsym\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/errno.h.0p b/upstream/mageia-cauldron/man0p/errno.h.0p new file mode 100644 index 00000000..3241ec26 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/errno.h.0p @@ -0,0 +1,335 @@ +'\" et +.TH errno.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +errno.h +\(em system error numbers +.SH SYNOPSIS +.LP +.nf +#include <errno.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends +the ISO\ C standard. Any conflict between the requirements described here +and the ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The ISO\ C standard only requires the symbols +.BR [EDOM] , +.BR [EILSEQ] , +and +.BR [ERANGE] +to be defined. +.P +The +.IR <errno.h> +header shall provide a declaration or definition for +.IR errno . +The symbol +.IR errno +shall expand to a modifiable lvalue of type +.BR int . +It is unspecified whether +.IR errno +is a macro or an identifier declared with external linkage. If a macro +definition is suppressed in order to access an actual object, or a +program defines an identifier with the name +.IR errno , +the behavior is undefined. +.P +The +.IR <errno.h> +header shall define the following macros which shall expand to +integer constant expressions with type +.BR int , +distinct positive values (except as noted below), and which shall be +suitable for use in +.BR #if +preprocessing directives: +.TP +.BR E2BIG +Argument list too long. +.TP +.BR EACCES +Permission denied. +.TP +.BR EADDRINUSE +Address in use. +.TP +.BR EADDRNOTAVAIL +Address not available. +.TP +.BR EAFNOSUPPORT +Address family not supported. +.TP +.BR EAGAIN +Resource unavailable, try again (may be the same value as +.BR [EWOULDBLOCK] ). +.TP +.BR EALREADY +Connection already in progress. +.TP +.BR EBADF +Bad file descriptor. +.TP +.BR EBADMSG +Bad message. +.TP +.BR EBUSY +Device or resource busy. +.TP +.BR ECANCELED +Operation canceled. +.TP +.BR ECHILD +No child processes. +.TP +.BR ECONNABORTED +Connection aborted. +.TP +.BR ECONNREFUSED +Connection refused. +.TP +.BR ECONNRESET +Connection reset. +.TP +.BR EDEADLK +Resource deadlock would occur. +.TP +.BR EDESTADDRREQ +Destination address required. +.TP +.BR EDOM +Mathematics argument out of domain of function. +.TP +.BR EDQUOT +Reserved. +.TP +.BR EEXIST +File exists. +.TP +.BR EFAULT +Bad address. +.TP +.BR EFBIG +File too large. +.TP +.BR EHOSTUNREACH +Host is unreachable. +.TP +.BR EIDRM +Identifier removed. +.TP +.BR EILSEQ +Illegal byte sequence. +.TP +.BR EINPROGRESS +Operation in progress. +.TP +.BR EINTR +Interrupted function. +.TP +.BR EINVAL +Invalid argument. +.TP +.BR EIO +I/O error. +.TP +.BR EISCONN +Socket is connected. +.TP +.BR EISDIR +Is a directory. +.TP +.BR ELOOP +Too many levels of symbolic links. +.TP +.BR EMFILE +File descriptor value too large. +.TP +.BR EMLINK +Too many links. +.TP +.BR EMSGSIZE +Message too large. +.TP +.BR EMULTIHOP +Reserved. +.TP +.BR ENAMETOOLONG +Filename too long. +.TP +.BR ENETDOWN +Network is down. +.TP +.BR ENETRESET +Connection aborted by network. +.TP +.BR ENETUNREACH +Network unreachable. +.TP +.BR ENFILE +Too many files open in system. +.TP +.BR ENOBUFS +No buffer space available. +.TP +.BR ENODATA +No message is available on the STREAM head read queue. +.TP +.BR ENODEV +No such device. +.TP +.BR ENOENT +No such file or directory. +.TP +.BR ENOEXEC +Executable file format error. +.TP +.BR ENOLCK +No locks available. +.TP +.BR ENOLINK +Reserved. +.TP +.BR ENOMEM +Not enough space. +.TP +.BR ENOMSG +No message of the desired type. +.TP +.BR ENOPROTOOPT +Protocol not available. +.TP +.BR ENOSPC +No space left on device. +.TP +.BR ENOSR +No STREAM resources. +.TP +.BR ENOSTR +Not a STREAM. +.TP +.BR ENOSYS +Functionality not supported. +.TP +.BR ENOTCONN +The socket is not connected. +.TP +.BR ENOTDIR +Not a directory or a symbolic link to a directory. +.TP +.BR ENOTEMPTY +Directory not empty. +.TP +.BR ENOTRECOVERABLE +.br +State not recoverable. +.TP +.BR ENOTSOCK +Not a socket. +.TP +.BR ENOTSUP +Not supported (may be the same value as +.BR [EOPNOTSUPP] ). +.TP +.BR ENOTTY +Inappropriate I/O control operation. +.TP +.BR ENXIO +No such device or address. +.TP +.BR EOPNOTSUPP +Operation not supported on socket (may be the same value as +.BR [ENOTSUP] ). +.TP +.BR EOVERFLOW +Value too large to be stored in data type. +.TP +.BR EOWNERDEAD +Previous owner died. +.TP +.BR EPERM +Operation not permitted. +.TP +.BR EPIPE +Broken pipe. +.TP +.BR EPROTO +Protocol error. +.TP +.BR EPROTONOSUPPORT +.br +Protocol not supported. +.TP +.BR EPROTOTYPE +Protocol wrong type for socket. +.TP +.BR ERANGE +Result too large. +.TP +.BR EROFS +Read-only file system. +.TP +.BR ESPIPE +Invalid seek. +.TP +.BR ESRCH +No such process. +.TP +.BR ESTALE +Reserved. +.TP +.BR ETIME +Stream +\fIioctl\fR() +timeout. +.TP +.BR ETIMEDOUT +Connection timed out. +.TP +.BR ETXTBSY +Text file busy. +.TP +.BR EWOULDBLOCK +Operation would block (may be the same value as +.BR [EAGAIN] ). +.TP +.BR EXDEV +Cross-device link. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +Additional error numbers may be defined on conforming systems; see +the System Interfaces volume of POSIX.1\(hy2017. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.3" ", " "Error Numbers" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/fcntl.h.0p b/upstream/mageia-cauldron/man0p/fcntl.h.0p new file mode 100644 index 00000000..3f03104f --- /dev/null +++ b/upstream/mageia-cauldron/man0p/fcntl.h.0p @@ -0,0 +1,377 @@ +'\" et +.TH fcntl.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +fcntl.h +\(em file control options +.SH SYNOPSIS +.LP +.nf +#include <fcntl.h> +.fi +.SH DESCRIPTION +The +.IR <fcntl.h> +header shall define the following symbolic constants for the +.IR cmd +argument used by +\fIfcntl\fR(). +The values shall be unique and shall be suitable for use in +.BR #if +preprocessing directives. +.IP F_DUPFD 12 +Duplicate file descriptor. +.IP F_DUPFD_CLOEXEC 12 +.br +Duplicate file descriptor with the close-on-\c +.IR exec +flag FD_CLOEXEC set. +.IP F_GETFD 12 +Get file descriptor flags. +.IP F_SETFD 12 +Set file descriptor flags. +.IP F_GETFL 12 +Get file status flags and file access modes. +.IP F_SETFL 12 +Set file status flags. +.IP F_GETLK 12 +Get record locking information. +.IP F_SETLK 12 +Set record locking information. +.IP F_SETLKW 12 +Set record locking information; wait if blocked. +.IP F_GETOWN 12 +Get process or process group ID to receive SIGURG signals. +.IP F_SETOWN 12 +Set process or process group ID to receive SIGURG signals. +.P +The +.IR <fcntl.h> +header shall define the following symbolic constant used for the +\fIfcntl\fR() +file descriptor flags, which shall be suitable for use in +.BR #if +preprocessing directives. +.IP FD_CLOEXEC 12 +Close the file descriptor upon execution of an +.IR exec +family function. +.P +The +.IR <fcntl.h> +header shall also define the following symbolic constants for the +.IR l_type +argument used for record locking with +\fIfcntl\fR(). +The values shall be unique and shall be suitable for use in +.BR #if +preprocessing directives. +.IP F_RDLCK 12 +Shared or read lock. +.IP F_UNLCK 12 +Unlock. +.IP F_WRLCK 12 +Exclusive or write lock. +.P +The +.IR <fcntl.h> +header shall define the values used for +.IR l_whence , +SEEK_SET, SEEK_CUR, and SEEK_END +as described in +.IR <stdio.h> . +.P +The +.IR <fcntl.h> +header shall define the following symbolic constants as file creation +flags for use in the +.IR oflag +value to +\fIopen\fR() +and +\fIopenat\fR(). +The values shall be bitwise-distinct and shall be suitable for use in +.BR #if +preprocessing directives. +.IP O_CLOEXEC 12 +The FD_CLOEXEC flag associated with the new descriptor shall be +set to close the file descriptor upon execution of an +.IR exec +family function. +.IP O_CREAT 12 +Create file if it does not exist. +.IP O_DIRECTORY 12 +Fail if file is a non-directory file. +.IP O_EXCL 12 +Exclusive use flag. +.IP O_NOCTTY 12 +Do not assign controlling terminal. +.IP O_NOFOLLOW 12 +Do not follow symbolic links. +.IP O_TRUNC 12 +Truncate flag. +.IP O_TTY_INIT 12 +Set the +.BR termios +structure terminal parameters to a state that provides conforming +behavior; see +.IR "Section 11.2" ", " "Parameters that Can be Set". +.P +The O_TTY_INIT flag can have the value zero and in this case it need +not be bitwise-distinct from the other flags. +.P +The +.IR <fcntl.h> +header shall define the following symbolic constants for use as +file status flags for +\fIopen\fR(), +\fIopenat\fR(), +and +\fIfcntl\fR(). +The values shall be suitable for use in +.BR #if +preprocessing directives. +.IP O_APPEND 12 +Set append mode. +.IP O_DSYNC 12 +Write according to synchronized I/O data integrity completion. +.IP O_NONBLOCK 12 +Non-blocking mode. +.IP O_RSYNC 12 +Synchronized read I/O operations. +.IP O_SYNC 12 +Write according to synchronized I/O file integrity completion. +.P +The +.IR <fcntl.h> +header shall define the following symbolic constant for use as the mask +for file access modes. The value shall be suitable for use in +.BR #if +preprocessing directives. +.IP O_ACCMODE 12 +Mask for file access modes. +.P +The +.IR <fcntl.h> +header shall define the following symbolic constants for use as +the file access modes for +\fIopen\fR(), +\fIopenat\fR(), +and +\fIfcntl\fR(). +The values shall be unique, except that O_EXEC and O_SEARCH may have +equal values. The values shall be suitable for use in +.BR #if +preprocessing directives. +.IP O_EXEC 12 +Open for execute only (non-directory files). The result is unspecified +if this flag is applied to a directory. +.IP O_RDONLY 12 +Open for reading only. +.IP O_RDWR 12 +Open for reading and writing. +.IP O_SEARCH 12 +Open directory for search only. The result is unspecified if this flag +is applied to a non-directory file. +.IP O_WRONLY 12 +Open for writing only. +.P +The +.IR <fcntl.h> +header shall define the symbolic constants for file modes for use as +values of +.BR mode_t +as described in +.IR <sys/stat.h> . +.P +The +.IR <fcntl.h> +header shall define the following symbolic constant as a special value +used in place of a file descriptor for the +.IR *at (\|) +functions which take a directory file descriptor as a parameter: +.IP AT_FDCWD 12 +Use the current working directory to determine the target of relative +file paths. +.P +The +.IR <fcntl.h> +header shall define the following symbolic constant as a value for the +.IR flag +used by +\fIfaccessat\fR(): +.IP AT_EACCESS 12 +Check access using effective user and group ID. +.P +The +.IR <fcntl.h> +header shall define the following symbolic constant as a value for the +.IR flag +used by +\fIfstatat\fR(), +\fIfchmodat\fR(), +\fIfchownat\fR(), +and +\fIutimensat\fR(): +.IP AT_SYMLINK_NOFOLLOW 12 +.br +Do not follow symbolic links. +.P +The +.IR <fcntl.h> +header shall define the following symbolic constant as a value for +the flag used by +\fIlinkat\fR(): +.IP AT_SYMLINK_FOLLOW 12 +.br +Follow symbolic link. +.br +.P +The +.IR <fcntl.h> +header shall define the following symbolic constant as a value +for the flag used by +\fIunlinkat\fR(): +.IP AT_REMOVEDIR 12 +.br +Remove directory instead of file. +.P +The +.IR <fcntl.h> +header shall define the following symbolic constants for the +.IR advice +argument used by +\fIposix_fadvise\fR(): +.IP POSIX_FADV_DONTNEED 6 +.br +The application expects that it will not access the specified data in +the near future. +.IP POSIX_FADV_NOREUSE 6 +.br +The application expects to access the specified data once and then not +reuse it thereafter. +.IP POSIX_FADV_NORMAL 6 +.br +The application has no advice to give on its behavior with respect to +the specified data. It is the default characteristic if no advice is +given for an open file. +.IP POSIX_FADV_RANDOM 6 +.br +The application expects to access the specified data in a random +order. +.IP POSIX_FADV_SEQUENTIAL 6 +.br +The application expects to access the specified data sequentially from +lower offsets to higher offsets. +.IP POSIX_FADV_WILLNEED 6 +.br +The application expects to access the specified data in the near +future. +.P +The +.IR <fcntl.h> +header shall define the +.BR flock +structure describing a file lock. It shall include the following members: +.sp +.RS 4 +.nf + +short l_type \fRType of lock; F_RDLCK, F_WRLCK, F_UNLCK.\fR +short l_whence \fRFlag for starting offset.\fR +off_t l_start \fRRelative offset in bytes.\fR +off_t l_len \fRSize; if 0 then until EOF.\fR +pid_t l_pid \fRProcess ID of the process holding the lock; returned with F_GETLK.\fR +.fi +.P +.RE +.P +The +.IR <fcntl.h> +header shall define the +.BR mode_t , +.BR off_t , +and +.BR pid_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int creat(const char *, mode_t); +int fcntl(int, int, ...); +int open(const char *, int, ...); +int openat(int, const char *, int, ...); +int posix_fadvise(int, off_t, off_t, int); +int posix_fallocate(int, off_t, off_t); +.fi +.P +.RE +.P +Inclusion of the +.IR <fcntl.h> +header may also make visible all symbols from +.IR <sys/stat.h> +and +.IR <unistd.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +Although no existing implementation defines AT_SYMLINK_FOLLOW and +AT_SYMLINK_NOFOLLOW as the same numeric value, POSIX.1\(hy2008 does not prohibit +that as the two constants are not used with the same interfaces. +.SH RATIONALE +While many of the symbolic constants introduced in the +.IR <fcntl.h> +header do not strictly need to be used in +.BR #if +preprocessor directives, widespread historic practice has defined +them as macros that are usable in such constructs, and examination +of existing applications has shown that they are occasionally used in +such a way. Therefore it was decided to retain this requirement on an +implementation in POSIX.1\(hy2008. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<stdio.h>\fP", +.IR "\fB<sys_stat.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<unistd.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIcreat\fR\^(\|)", +.IR "\fIexec\fR\^", +.IR "\fIfcntl\fR\^(\|)", +.IR "\fIfutimens\fR\^(\|)", +.IR "\fIopen\fR\^(\|)", +.IR "\fIposix_fadvise\fR\^(\|)", +.IR "\fIposix_fallocate\fR\^(\|)", +.IR "\fIposix_madvise\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/fenv.h.0p b/upstream/mageia-cauldron/man0p/fenv.h.0p new file mode 100644 index 00000000..33e7285c --- /dev/null +++ b/upstream/mageia-cauldron/man0p/fenv.h.0p @@ -0,0 +1,287 @@ +'\" et +.TH fenv.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +fenv.h +\(em floating-point environment +.SH SYNOPSIS +.LP +.nf +#include <fenv.h> +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The +.IR <fenv.h> +header shall define the following data types through +.BR typedef : +.IP "\fBfenv_t\fR" 10 +Represents the entire floating-point environment. The floating-point +environment refers collectively to any floating-point status flags and +control modes supported by the implementation. +.IP "\fBfexcept_t\fR" 10 +Represents the floating-point status flags collectively, including any +status the implementation associates with the flags. A floating-point +status flag is a system variable whose value is set (but never cleared) +when a floating-point exception is raised, which occurs as a side-effect +of exceptional floating-point arithmetic to provide auxiliary +information. A floating-point control mode is a system variable whose +value may be set by the user to affect the subsequent behavior of +floating-point arithmetic. +.P +The +.IR <fenv.h> +header shall define each of the following macros if and only if the +implementation supports the floating-point exception by means of the +floating-point functions +\fIfeclearexcept\fR(), +\fIfegetexceptflag\fR(), +\fIferaiseexcept\fR(), +\fIfesetexceptflag\fR(), +and +\fIfetestexcept\fR(). +The defined macros shall expand to integer constant expressions with +values that are bitwise-distinct. +.sp +.RS +FE_DIVBYZERO +FE_INEXACT +FE_INVALID +FE_OVERFLOW +FE_UNDERFLOW +.RE +.P +If the implementation supports the IEC 60559 Floating-Point option, all +five macros shall be defined. +Additional implementation-defined floating-point exceptions with +macros beginning with FE_ and an uppercase letter may also be +specified by the implementation. +.P +The +.IR <fenv.h> +header shall define the macro FE_ALL_EXCEPT as the bitwise-inclusive +OR of all floating-point exception macros defined by the +implementation, if any. If no such macros are defined, then the +macro FE_ALL_EXCEPT shall be defined as zero. +.P +The +.IR <fenv.h> +header shall define each of the following macros if and only if the +implementation supports getting and setting the represented rounding +direction by means of the +\fIfegetround\fR() +and +\fIfesetround\fR() +functions. The defined macros shall expand to integer constant +expressions whose values are distinct non-negative values. +.sp +.RS +FE_DOWNWARD +FE_TONEAREST +FE_TOWARDZERO +FE_UPWARD +.RE +.P +If the implementation supports the IEC 60559 Floating-Point option, all +four macros shall be defined. +Additional implementation-defined rounding directions with macros +beginning with FE_ and an uppercase letter may also be specified by the +implementation. +.P +The +.IR <fenv.h> +header shall define the following macro, which represents the +default floating-point environment (that is, the one installed at +program startup) and has type pointer to const-qualified +.BR fenv_t . +It can be used as an argument to the functions within the +.IR <fenv.h> +header that manage the floating-point environment. +.sp +.RS +FE_DFL_ENV +.RE +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int feclearexcept(int); +int fegetenv(fenv_t *); +int fegetexceptflag(fexcept_t *, int); +int fegetround(void); +int feholdexcept(fenv_t *); +int feraiseexcept(int); +int fesetenv(const fenv_t *); +int fesetexceptflag(const fexcept_t *, int); +int fesetround(int); +int fetestexcept(int); +int feupdateenv(const fenv_t *); +.fi +.P +.RE +.P +The FENV_ACCESS pragma provides a means to inform the implementation +when an application might access the floating-point environment to test +floating-point status flags or run under non-default floating-point +control modes. The pragma shall occur either outside external +declarations or preceding all explicit declarations and statements +inside a compound statement. When outside external declarations, the +pragma takes effect from its occurrence until another FENV_ACCESS +pragma is encountered, or until the end of the translation unit. When +inside a compound statement, the pragma takes effect from its +occurrence until another FENV_ACCESS pragma is encountered (including +within a nested compound statement), or until the end of the compound +statement; at the end of a compound statement the state for the pragma +is restored to its condition just before the compound statement. If +this pragma is used in any other context, the behavior is undefined. If +part of an application tests floating-point status flags, sets +floating-point control modes, or runs under non-default mode settings, +but was translated with the state for the FENV_ACCESS pragma off, the +behavior is undefined. The default state (on or off) for the pragma is +implementation-defined. (When execution passes from a part of the +application translated with FENV_ACCESS off to a part translated with +FENV_ACCESS on, the state of the floating-point status flags is +unspecified and the floating-point control modes have their default +settings.) +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +This header is designed to support the floating-point exception status +flags and directed-rounding control modes required by the IEC\ 60559:\|1989 standard, and +other similar floating-point state information. Also it is designed to +facilitate code portability among all systems. +.P +Certain application programming conventions support the intended model +of use for the floating-point environment: +.IP " *" 4 +A function call does not alter its caller's floating-point control +modes, clear its caller's floating-point status flags, nor depend on +the state of its caller's floating-point status flags unless the +function is so documented. +.IP " *" 4 +A function call is assumed to require default floating-point control +modes, unless its documentation promises otherwise. +.IP " *" 4 +A function call is assumed to have the potential for raising +floating-point exceptions, unless its documentation promises otherwise. +.P +With these conventions, an application can safely assume default +floating-point control modes (or be unaware of them). The +responsibilities associated with accessing the floating-point +environment fall on the application that does so explicitly. +.P +Even though the rounding direction macros may expand to constants +corresponding to the values of FLT_ROUNDS, they are not required to do +so. +.P +For example: +.sp +.RS 4 +.nf + +#include <fenv.h> +void f(double x) +{ + #pragma STDC FENV_ACCESS ON + void g(double); + void h(double); + /* ... */ + g(x + 1); + h(x + 1); + /* ... */ +} +.fi +.P +.RE +.P +If the function +\fIg\fR() +might depend on status flags set as a side-effect of the first +.IR x +1, +or if the second +.IR x +1 +might depend on control modes set as a side-effect of the call to +function +\fIg\fR(), +then the application shall contain an appropriately placed invocation +as follows: +.sp +.RS 4 +.nf + +#pragma STDC FENV_ACCESS ON +.fi +.P +.RE +.SH RATIONALE +.SS "The fexcept_t Type" +.P +.BR fexcept_t +does not have to be an integer type. Its values must be obtained by a +call to +\fIfegetexceptflag\fR(), +and cannot be created by logical operations from the exception macros. +An implementation might simply implement +.BR fexcept_t +as an +.BR int +and use the representations reflected by the exception macros, but is +not required to; other representations might contain extra information +about the exceptions. +.BR fexcept_t +might be a +.BR struct +with a member for each exception (that might hold the address of the +first or last floating-point instruction that caused that exception). +The ISO/IEC\ 9899:\|1999 standard makes no claims about the internals of an +.BR fexcept_t , +and so the user cannot inspect it. +.SS "Exception and Rounding Macros" +.P +Macros corresponding to unsupported modes and rounding directions are +not defined by the implementation and must not be defined by the +application. An application might use +.BR #ifdef +to test for this. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIfeclearexcept\fR\^(\|)", +.IR "\fIfegetenv\fR\^(\|)", +.IR "\fIfegetexceptflag\fR\^(\|)", +.IR "\fIfegetround\fR\^(\|)", +.IR "\fIfeholdexcept\fR\^(\|)", +.IR "\fIferaiseexcept\fR\^(\|)", +.IR "\fIfetestexcept\fR\^(\|)", +.IR "\fIfeupdateenv\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/float.h.0p b/upstream/mageia-cauldron/man0p/float.h.0p new file mode 100644 index 00000000..8ebc912f --- /dev/null +++ b/upstream/mageia-cauldron/man0p/float.h.0p @@ -0,0 +1,366 @@ +'\" et +.TH float.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.EQ +delim $$ +.EN +.SH NAME +float.h +\(em floating types +.SH SYNOPSIS +.LP +.nf +#include <float.h> +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The characteristics of floating types are defined in terms of a model +that describes a representation of floating-point numbers and values +that provide information about an implementation's floating-point +arithmetic. +.P +The following parameters are used to define the model for each +floating-point type: +.IP "\fIs\fP" 6 +Sign (\(+-1). +.IP "\fIb\fP" 6 +Base or radix of exponent representation (an integer >1). +.IP "\fIe\fP" 6 +Exponent (an integer between a minimum $e_ min$ and a maximum +$e_ max$). +.IP "\fIp\fP" 6 +Precision (the number of base\-\fIb\fP digits in the significand). +.IP "$f_ k$" 6 +Non-negative integers less than +.IR b +(the significand digits). +.P +A floating-point number +.IR x +is defined by the following model: +.P +.EQ +x " " = " " sb"^" e" " " " sum from k=1 to p^ " " f_ k" " " " b"^" " "-k , + " " e_ min" " " " <= " " e " " <= " " e_ max" " +.EN +.P +In addition to normalized floating-point numbers ($f_ 1$>0 if +.IR x \(!=0), +floating types may be able to contain other kinds of floating-point +numbers, such as subnormal floating-point numbers (\c +.IR x \(!=0, +.IR e =\c +$e_ min$, $f_ 1$=0) and unnormalized floating-point numbers (\c +.IR x \(!=0, +.IR e >\c +$e_ min$, $f_ 1$=0), and values that are not floating-point +numbers, such as infinities and NaNs. A +.IR NaN +is an encoding signifying Not-a-Number. A +.IR "quiet NaN" +propagates through almost every arithmetic operation without raising a +floating-point exception; a +.IR "signaling NaN" +generally raises a floating-point exception when occurring as an +arithmetic operand. +.P +An implementation may give zero and non-numeric values, such as +infinities and NaNs, a sign, or may leave them unsigned. Wherever such +values are unsigned, any requirement in POSIX.1\(hy2008 to retrieve the +sign shall produce an unspecified sign and any requirement to set the +sign shall be ignored. +.P +The accuracy of the floating-point operations (\c +.BR '+' , +.BR '\-' , +.BR '*' , +.BR '/' ) +and of the functions in +.IR <math.h> +and +.IR <complex.h> +that return floating-point results is implementation-defined, as is the +accuracy of the conversion between floating-point internal +representations and string representations performed by the functions +in +.IR <stdio.h> , +.IR <stdlib.h> , +and +.IR <wchar.h> . +The implementation may state that the accuracy is unknown. +.P +All integer values in the +.IR <float.h> +header, except FLT_ROUNDS, shall be constant expressions suitable for +use in +.BR #if +preprocessing directives; all floating values shall be constant +expressions. All except DECIMAL_DIG, FLT_EVAL_METHOD, FLT_RADIX, and +FLT_ROUNDS have separate names for all three floating-point types. The +floating-point model representation is provided for all values except +FLT_EVAL_METHOD and FLT_ROUNDS. +.P +The rounding mode for floating-point addition is characterized by the +implementation-defined value of FLT_ROUNDS: +.IP "\-1" 6 +Indeterminable. +.IP "\00" 6 +Toward zero. +.IP "\01" 6 +To nearest. +.IP "\02" 6 +Toward positive infinity. +.IP "\03" 6 +Toward negative infinity. +.P +All other values for FLT_ROUNDS characterize implementation-defined +rounding behavior. +.P +The values of operations with floating operands and values subject to +the usual arithmetic conversions and of floating constants are +evaluated to a format whose range and precision may be greater than +required by the type. The use of evaluation formats is characterized by +the implementation-defined value of FLT_EVAL_METHOD: +.IP "\-1" 6 +Indeterminable. +.IP "\00" 6 +Evaluate all operations and constants just to the range and +precision of the type. +.IP "\01" 6 +Evaluate operations and constants of type +.BR float +and +.BR double +to the range and precision of the +.BR double +type; evaluate +.BR "long double" +operations and constants to the range and precision of the +.BR "long double" +type. +.IP "\02" 6 +Evaluate all operations and constants to the range and precision of the +.BR "long double" +type. +.P +All other negative values for FLT_EVAL_METHOD characterize +implementation-defined behavior. +.P +The +.IR <float.h> +header shall define the following values as constant expressions with +implementation-defined values that are greater or equal in magnitude +(absolute value) to those shown, with the same sign. +.IP " *" 4 +Radix of exponent representation, +.IR b . +.RS 4 +.IP FLT_RADIX 14 +2 +.RE +.IP " *" 4 +Number of base-FLT_RADIX digits in the floating-point significand, +.IR p . +.RS 4 +.IP FLT_MANT_DIG 14 +.IP DBL_MANT_DIG 14 +.IP LDBL_MANT_DIG 14 +.RE +.IP " *" 4 +Number of decimal digits, +.IR n , +such that any floating-point number in the widest supported floating +type with $p_ max$ radix +.IR b +digits can be rounded to a floating-point number with +.IR n +decimal digits and back again without change to the value. +.RS 4 +.P +.EQ +lpile { p_ max" " " " log_ 10" " " " b above +left ceiling " " 1 " " + " " p_ max" " " " log_ 10" " " " b right ceiling } + " " " " lpile {if " " b " " is " " a " " power " " of " " 10 above otherwise} +.EN +.IP DECIMAL_DIG 14 +10 +.RE +.br +.RE +.IP " *" 4 +Number of decimal digits, +.IR q , +such that any floating-point number with +.IR q +decimal digits can be rounded into a floating-point number with +.IR p +radix +.IR b +digits and back again without change to the +.IR q +decimal digits. +.RS 4 +.P +.EQ +lpile { p " " log_ 10" " " " b above +left floor " " (p " " - " " 1) " " log_ 10" " " " b " " right floor } + " " " " lpile {if " " b " " is " " a " " power " " of " " 10 above otherwise} +.EN +.IP FLT_DIG 14 +6 +.IP DBL_DIG 14 +10 +.IP LDBL_DIG 14 +10 +.RE +.IP " *" 4 +Minimum negative integer such that FLT_RADIX raised to that power +minus 1 is a normalized floating-point number, $e_ min$. +.RS 4 +.IP FLT_MIN_EXP 14 +.IP DBL_MIN_EXP 14 +.IP LDBL_MIN_EXP 14 +.RE +.IP " *" 4 +Minimum negative integer such that 10 raised to that power is in +the range of normalized floating-point numbers. +.RS 4 +.P +.EQ +left ceiling " " log_ 10" " " " b"^" " "{ e_ min" " " " "^" " "-1 } ^ " " right ceiling +.EN +.IP FLT_MIN_10_EXP 14 +\-37 +.IP DBL_MIN_10_EXP 14 +\-37 +.IP LDBL_MIN_10_EXP 14 +\-37 +.RE +.IP " *" 4 +Maximum integer such that FLT_RADIX raised to that power +minus 1 is a representable finite floating-point number, $e_ max$. +.RS 4 +.IP FLT_MAX_EXP 14 +.IP DBL_MAX_EXP 14 +.IP LDBL_MAX_EXP 14 +.P +Additionally, FLT_MAX_EXP shall be at least as large as FLT_MANT_DIG, +DBL_MAX_EXP shall be at least as large as DBL_MANT_DIG, and LDBL_MAX_EXP +shall be at least as large as LDBL_MANT_DIG; which has the effect that +FLT_MAX, DBL_MAX, and LDBL_MAX are integral. +.RE +.IP " *" 4 +Maximum integer such that 10 raised to that power is in the range +of representable finite floating-point numbers. +.RS 4 +.P +.EQ +left floor " " log_ 10" " ( ( 1 " " - " " b"^" " "-p ) " " + b"^" e" "_ max" "^ ) " " right floor +.EN +.IP FLT_MAX_10_EXP 14 ++37 +.IP DBL_MAX_10_EXP 14 ++37 +.IP LDBL_MAX_10_EXP 14 ++37 +.RE +.P +The +.IR <float.h> +header shall define the following values as constant expressions with +implementation-defined values that are greater than or equal to those +shown: +.IP " *" 4 +Maximum representable finite floating-point number. +.RS 4 +.P +.EQ +(1 " " - " " b"^" " "-p^) " " b"^" e" "_ max" " +.EN +.IP FLT_MAX 14 +1E+37 +.IP DBL_MAX 14 +1E+37 +.IP LDBL_MAX 14 +1E+37 +.RE +.P +The +.IR <float.h> +header shall define the following values as constant expressions with +implementation-defined (positive) values that are less than or equal to +those shown: +.IP " *" 4 +The difference between 1 and the least value greater than 1 +that is representable in the given floating-point type, $b"^" " "{1 " " - " " p}$. +.RS 4 +.IP FLT_EPSILON 14 +1E\-5 +.IP DBL_EPSILON 14 +1E\-9 +.IP LDBL_EPSILON 14 +1E\-9 +.RE +.IP " *" 4 +Minimum normalized positive floating-point number, +$b"^" " "{ e_ min" " " " "^" " "-1 }$. +.RS 4 +.IP FLT_MIN 14 +1E\-37 +.IP DBL_MIN 14 +1E\-37 +.IP LDBL_MIN 14 +1E\-37 +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +All known hardware floating-point formats satisfy the property that the +exponent range is larger than the number of mantissa digits. The ISO\ C standard +permits a floating-point format where this property is not true, such that +the largest finite value would not be integral; however, it is unlikely +that there will ever be hardware support for such a floating-point format, +and it introduces boundary cases that portable programs should not have +to be concerned with (for example, a non-integral DBL_MAX means that +\fIceil\fR() +would have to worry about overflow). Therefore, this standard imposes +an additional requirement that the largest representable finite value +is integral. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<complex.h>\fP", +.IR "\fB<math.h>\fP", +.IR "\fB<stdio.h>\fP", +.IR "\fB<stdlib.h>\fP", +.IR "\fB<wchar.h>\fP" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/fmtmsg.h.0p b/upstream/mageia-cauldron/man0p/fmtmsg.h.0p new file mode 100644 index 00000000..bdaaf4f3 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/fmtmsg.h.0p @@ -0,0 +1,131 @@ +'\" et +.TH fmtmsg.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +fmtmsg.h +\(em message display structures +.SH SYNOPSIS +.LP +.nf +#include <fmtmsg.h> +.fi +.SH DESCRIPTION +The +.IR <fmtmsg.h> +header shall define the following symbolic constants: +.IP MM_HARD 14 +Source of the condition is hardware. +.IP MM_SOFT 14 +Source of the condition is software. +.IP MM_FIRM 14 +Source of the condition is firmware. +.IP MM_APPL 14 +Condition detected by application. +.IP MM_UTIL 14 +Condition detected by utility. +.IP MM_OPSYS 14 +Condition detected by operating system. +.IP MM_RECOVER 14 +Recoverable error. +.IP MM_NRECOV 14 +Non-recoverable error. +.IP MM_HALT 14 +Error causing application to halt. +.IP MM_ERROR 14 +Application has encountered a non-fatal fault. +.IP MM_WARNING 14 +Application has detected unusual non-error condition. +.IP MM_INFO 14 +Informative message. +.IP MM_NOSEV 14 +No severity level provided for the message. +.IP MM_PRINT 14 +Display message on standard error. +.IP MM_CONSOLE 14 +Display message on system console. +.P +The table below indicates the null values and identifiers for +\fIfmtmsg\fR() +arguments. The +.IR <fmtmsg.h> +header shall define the symbolic constants in the +.BR Identifier +column, which shall have the type indicated in the +.BR Type +column: +.TS +box tab(!) center; +cB | cB | cB | cB +lI | lB | l | l. +Argument!Type!Null-Value!Identifier +_ +label!char *!(\fBchar\fR*)0!MM_NULLLBL +severity!int!0!MM_NULLSEV +class!long!\fB0L\fR!MM_NULLMC +text!char *!(\fBchar\fR*)0!MM_NULLTXT +action!char *!(\fBchar\fR*)0!MM_NULLACT +tag!char *!(\fBchar\fR*)0!MM_NULLTAG +.TE +.P +The +.IR <fmtmsg.h> +header shall also define the following symbolic constants for use +as return values for +\fIfmtmsg\fR(): +.IP MM_OK 14 +The function succeeded. +.IP MM_NOTOK 14 +The function failed completely. +.IP MM_NOMSG 14 +The function was unable to generate a message on standard error, but +otherwise succeeded. +.IP MM_NOCON 14 +The function was unable to generate a console message, but otherwise +succeeded. +.P +The following shall be declared as a function and may also be defined +as a macro. A function prototype shall be provided. +.sp +.RS 4 +.nf + +int fmtmsg(long, const char *, int, + const char *, const char *, const char *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIfmtmsg\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/fnmatch.h.0p b/upstream/mageia-cauldron/man0p/fnmatch.h.0p new file mode 100644 index 00000000..a3c02d6d --- /dev/null +++ b/upstream/mageia-cauldron/man0p/fnmatch.h.0p @@ -0,0 +1,82 @@ +'\" et +.TH fnmatch.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +fnmatch.h +\(em filename-matching types +.SH SYNOPSIS +.LP +.nf +#include <fnmatch.h> +.fi +.SH DESCRIPTION +The +.IR <fnmatch.h> +header shall define the following symbolic constants: +.IP FNM_NOMATCH 14 +The string does not match the specified pattern. +.IP FNM_PATHNAME 14 +<slash> +in +.IR string +only matches +<slash> +in +.IR pattern . +.IP FNM_PERIOD 14 +Leading +<period> +in +.IR string +must be exactly matched by +<period> +in +.IR pattern . +.IP FNM_NOESCAPE 14 +Disable backslash escaping. +.P +The following shall be declared as a function and may also be defined +as a macro. A function prototype shall be provided. +.sp +.RS 4 +.nf + +int fnmatch(const char *, const char *, int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIfnmatch\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/ftw.h.0p b/upstream/mageia-cauldron/man0p/ftw.h.0p new file mode 100644 index 00000000..9b4a94f3 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/ftw.h.0p @@ -0,0 +1,133 @@ +'\" et +.TH ftw.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +ftw.h +\(em file tree traversal +.SH SYNOPSIS +.LP +.nf +#include <ftw.h> +.fi +.SH DESCRIPTION +The +.IR <ftw.h> +header shall define the +.BR FTW +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int base +int level +.fi +.P +.RE +.P +The +.IR <ftw.h> +header shall define the following symbolic constants for use as values +of the third argument to the application-supplied function that is +passed as the second argument to +\fIftw\fR() +and +\fInftw\fR(): +.IP FTW_F 14 +Non-directory file. +.IP FTW_D 14 +Directory. +.IP FTW_DNR 14 +Directory without read permission. +.IP FTW_DP 14 +Directory with subdirectories visited. +.IP FTW_NS 14 +Unknown type; +\fIstat\fR() +failed. +.IP FTW_SL 14 +Symbolic link. +.IP FTW_SLN 14 +Symbolic link that names a nonexistent file. +.P +The +.IR <ftw.h> +header shall define the following symbolic constants for use as +values of the fourth argument to +\fInftw\fR(): +.IP FTW_PHYS 14 +Physical walk, does not follow symbolic links. Otherwise, +\fInftw\fR() +follows links but does not walk down any path that crosses itself. +.IP FTW_MOUNT 14 +The walk does not cross a mount point. +.IP FTW_DEPTH 14 +All subdirectories are visited before the directory itself. +.IP FTW_CHDIR 14 +The walk changes to each directory before reading it. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int ftw(const char *, int (*)(const char *, const struct stat *, + int), int); +int nftw(const char *, int (*)(const char *, const struct stat *, + int, struct FTW *), int, int); +.fi +.P +.RE +.P +The +.IR <ftw.h> +header shall define the +.BR stat +structure and the symbolic names for +.IR st_mode +and the file type test macros as described in +.IR <sys/stat.h> . +.P +Inclusion of the +.IR <ftw.h> +header may also make visible all symbols from +.IR <sys/stat.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_stat.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIftw\fR\^(\|)", +.IR "\fInftw\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/glob.h.0p b/upstream/mageia-cauldron/man0p/glob.h.0p new file mode 100644 index 00000000..eaf8083b --- /dev/null +++ b/upstream/mageia-cauldron/man0p/glob.h.0p @@ -0,0 +1,134 @@ +'\" et +.TH glob.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +glob.h +\(em pathname pattern-matching types +.SH SYNOPSIS +.LP +.nf +#include <glob.h> +.fi +.SH DESCRIPTION +The +.IR <glob.h> +header shall define the structures and symbolic constants used by the +\fIglob\fR() +function. +.P +The +.IR <glob.h> +header shall define the +.BR glob_t +structure type, which shall include at least the following members: +.sp +.RS 4 +.nf + +size_t gl_pathc \fRCount of paths matched by \fIpattern.\fR +char **gl_pathv \fRPointer to a list of matched pathnames.\fR +size_t gl_offs \fRSlots to reserve at the beginning of \fIgl_pathv.\fR +.fi +.P +.RE +.P +The +.IR <glob.h> +header shall define the +.BR size_t +type as described in +.IR <sys/types.h> . +.P +The +.IR <glob.h> +header shall define the following symbolic constants as values for the +.IR flags +argument: +.IP GLOB_APPEND 14 +Append generated pathnames to those previously obtained. +.IP GLOB_DOOFFS 14 +Specify how many null pointers to add to the beginning of +.IR gl_pathv . +.IP GLOB_ERR 14 +Cause +\fIglob\fR() +to return on error. +.IP GLOB_MARK 14 +Each pathname that is a directory that matches +.IR pattern +has a +<slash> +appended. +.IP GLOB_NOCHECK 14 +If +.IR pattern +does not match any pathname, then return a list consisting of only +.IR pattern . +.IP GLOB_NOESCAPE 14 +Disable backslash escaping. +.IP GLOB_NOSORT 14 +Do not sort the pathnames returned. +.P +The +.IR <glob.h> +header shall define the following symbolic constants as error +return values: +.IP GLOB_ABORTED 14 +The scan was stopped because GLOB_ERR was set or (*\fIerrfunc\fP)(\|) +returned non-zero. +.IP GLOB_NOMATCH 14 +The pattern does not match any existing pathname, and GLOB_NOCHECK was +not set in +.IR flags . +.IP GLOB_NOSPACE 14 +An attempt to allocate memory failed. +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int glob(const char *restrict, int, int(*)(const char *, int), + glob_t *restrict); +void globfree(glob_t *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIglob\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/grp.h.0p b/upstream/mageia-cauldron/man0p/grp.h.0p new file mode 100644 index 00000000..9faac37d --- /dev/null +++ b/upstream/mageia-cauldron/man0p/grp.h.0p @@ -0,0 +1,95 @@ +'\" et +.TH grp.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +grp.h +\(em group structure +.SH SYNOPSIS +.LP +.nf +#include <grp.h> +.fi +.SH DESCRIPTION +The +.IR <grp.h> +header shall declare the +.BR group +structure, which shall include the following members: +.sp +.RS 4 +.nf + +char *gr_name \fRThe name of the group.\fR +gid_t gr_gid \fRNumerical group ID.\fR +char **gr_mem \fRPointer to a null-terminated array of character\fR + \fRpointers to member names.\fR +.fi +.P +.RE +.P +The +.IR <grp.h> +header shall define the +.BR gid_t +and +.BR size_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void endgrent(void); +struct group *getgrent(void); +struct group *getgrgid(gid_t); +int getgrgid_r(gid_t, struct group *, char *, + size_t, struct group **); +struct group *getgrnam(const char *); +int getgrnam_r(const char *, struct group *, char *, + size_t , struct group **); +void setgrent(void); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIendgrent\fR\^(\|)", +.IR "\fIgetgrgid\fR\^(\|)", +.IR "\fIgetgrnam\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/iconv.h.0p b/upstream/mageia-cauldron/man0p/iconv.h.0p new file mode 100644 index 00000000..0c73fbe1 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/iconv.h.0p @@ -0,0 +1,73 @@ +'\" et +.TH iconv.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +iconv.h +\(em codeset conversion facility +.SH SYNOPSIS +.LP +.nf +#include <iconv.h> +.fi +.SH DESCRIPTION +The +.IR <iconv.h> +header shall define the following types: +.IP "\fBiconv_t\fP" 12 +Identifies the conversion from one codeset to another. +.IP "\fBsize_t\fP" 12 +As described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +size_t iconv(iconv_t, char **restrict, size_t *restrict, + char **restrict, size_t *restrict); +int iconv_close(iconv_t); +iconv_t iconv_open(const char *, const char *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIiconv\fR\^(\|)", +.IR "\fIiconv_close\fR\^(\|)", +.IR "\fIiconv_open\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/inttypes.h.0p b/upstream/mageia-cauldron/man0p/inttypes.h.0p new file mode 100644 index 00000000..ed8498b1 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/inttypes.h.0p @@ -0,0 +1,244 @@ +'\" et +.TH inttypes.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +inttypes.h +\(em fixed size integer types +.SH SYNOPSIS +.LP +.nf +#include <inttypes.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <inttypes.h> +header shall include the +.IR <stdint.h> +header. +.P +The +.IR <inttypes.h> +header shall define at least the following types: +.IP "\fBimaxdiv_t\fR" 12 +Structure type that is the type of the value returned by the +\fIimaxdiv\fR() +function. +.IP "\fBwchar_t\fR" 12 +As described in +.IR <stddef.h> . +.P +The +.IR <inttypes.h> +header shall define the following macros. Each expands to a +character string literal containing a conversion specifier, possibly +modified by a length modifier, suitable for use within the +.IR format +argument of a formatted input/output function when converting the +corresponding integer type. These macros have the general form of +PRI (character string literals for the +\fIfprintf\fR() +and +\fIfwprintf\fR() +family of functions) or SCN (character string literals for the +\fIfscanf\fR() +and +\fIfwscanf\fR() +family of functions), followed by the conversion specifier, followed by +a name corresponding to a similar type name in +.IR <stdint.h> . +In these names, +.IR N +represents the width of the type as described in +.IR <stdint.h> . +For example, +.IR PRIdFAST32 +can be used in a format string to print the value of an integer of type +.BR int_fast32_t . +.P +The +\fIfprintf\fR() +macros for signed integers are: +.sp +.RS +.TS +tab(!); +le le le le le. +PRId\fIN\fR!PRIdLEAST\fIN\fR!PRIdFAST\fIN\fR!PRIdMAX!PRIdPTR +PRIi\fIN\fR!PRIiLEAST\fIN\fR!PRIiFAST\fIN\fR!PRIiMAX!PRIiPTR +.TE +.RE +.P +The +\fIfprintf\fR() +macros for unsigned integers are: +.sp +.RS +.TS +tab(!); +le le le le le. +PRIo\fIN\fR!PRIoLEAST\fIN\fR!PRIoFAST\fIN\fR!PRIoMAX!PRIoPTR +PRIu\fIN\fR!PRIuLEAST\fIN\fR!PRIuFAST\fIN\fR!PRIuMAX!PRIuPTR +PRIx\fIN\fR!PRIxLEAST\fIN\fR!PRIxFAST\fIN\fR!PRIxMAX!PRIxPTR +PRIX\fIN\fR!PRIXLEAST\fIN\fR!PRIXFAST\fIN\fR!PRIXMAX!PRIXPTR +.TE +.RE +.P +The +\fIfscanf\fR() +macros for signed integers are: +.sp +.RS +.TS +tab(!); +le le le le le. +SCNd\fIN\fR!SCNdLEAST\fIN\fR!SCNdFAST\fIN\fR!SCNdMAX!SCNdPTR +SCNi\fIN\fR!SCNiLEAST\fIN\fR!SCNiFAST\fIN\fR!SCNiMAX!SCNiPTR +.TE +.RE +.P +The +\fIfscanf\fR() +macros for unsigned integers are: +.sp +.RS +.TS +tab(!); +le le le le le. +SCNo\fIN\fR!SCNoLEAST\fIN\fR!SCNoFAST\fIN\fR!SCNoMAX!SCNoPTR +SCNu\fIN\fR!SCNuLEAST\fIN\fR!SCNuFAST\fIN\fR!SCNuMAX!SCNuPTR +SCNx\fIN\fR!SCNxLEAST\fIN\fR!SCNxFAST\fIN\fR!SCNxMAX!SCNxPTR +.TE +.RE +.P +For each type that the implementation provides in +.IR <stdint.h> , +the corresponding +\fIfprintf\fR() +and +\fIfwprintf\fR() +macros shall be defined and the corresponding +\fIfscanf\fR() +and +\fIfwscanf\fR() +macros shall be defined unless the implementation does not have a +suitable modifier for the type. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +intmax_t imaxabs(intmax_t); +imaxdiv_t imaxdiv(intmax_t, intmax_t); +intmax_t strtoimax(const char *restrict, char **restrict, int); +uintmax_t strtoumax(const char *restrict, char **restrict, int); +intmax_t wcstoimax(const wchar_t *restrict, wchar_t **restrict, int); +uintmax_t wcstoumax(const wchar_t *restrict, wchar_t **restrict, int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "EXAMPLES" +.LP +.nf +#include <inttypes.h> +#include <wchar.h> +int main(void) +{ + uintmax_t i = UINTMAX_MAX; // This type always exists. + wprintf(L"The largest integer value is %020" + PRIxMAX "\en", i); + return 0; +} +.fi +.SH "APPLICATION USAGE" +The purpose of +.IR <inttypes.h> +is to provide a set of integer types whose definitions are consistent +across machines and independent of operating systems and other +implementation idiosyncrasies. It defines, through +.BR typedef , +integer types of various sizes. Implementations are free to +.BR typedef +them as ISO\ C standard integer types or extensions that they support. Consistent +use of this header will greatly increase the portability of applications +across platforms. +.SH RATIONALE +The ISO/IEC\ 9899:\|1990 standard specified that the language should support four signed and +unsigned integer data types\(em\c +.BR char , +.BR short , +.BR int , +and +.BR long \(em\c +but placed very little requirement on their size other than that +.BR int +and +.BR short +be at least 16 bits and +.BR long +be at least as long as +.BR int +and not smaller than 32 bits. For 16-bit systems, most implementations +assigned 8, 16, 16, and 32 bits to +.BR char , +.BR short , +.BR int , +and +.BR long , +respectively. For 32-bit systems, the common practice has been to +assign 8, 16, 32, and 32 bits to these types. This difference in +.BR int +size can create some problems for users who migrate from one system to +another which assigns different sizes to integer types, because the +ISO\ C standard integer promotion rule can produce silent changes unexpectedly. +The need for defining an extended integer type increased with the +introduction of 64-bit systems. +.SH "FUTURE DIRECTIONS" +Macro names beginning with PRI or SCN followed by any lowercase letter +or +.BR 'X' +may be added to the macros defined in the +.IR <inttypes.h> +header. +.SH "SEE ALSO" +.IR "\fB<stddef.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIimaxabs\fR\^(\|)", +.IR "\fIimaxdiv\fR\^(\|)", +.IR "\fIstrtoimax\fR\^(\|)", +.IR "\fIwcstoimax\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/iso646.h.0p b/upstream/mageia-cauldron/man0p/iso646.h.0p new file mode 100644 index 00000000..c800cfc9 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/iso646.h.0p @@ -0,0 +1,76 @@ +'\" et +.TH iso646.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +iso646.h +\(em alternative spellings +.SH SYNOPSIS +.LP +.nf +#include <iso646.h> +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The +.IR <iso646.h> +header shall define the following eleven macros (on the left) that +expand to the corresponding tokens (on the right): +.IP and 10 +\&\fR&&\fR +.IP and_eq 10 +\&\fR&=\fR +.IP bitand 10 +\&\fR&\fR +.IP bitor 10 +\&\fR|\fR +.IP compl 10 +\&\fR~\fR +.IP not 10 +\&\fR!\fR +.IP not_eq 10 +\&\fR!=\fR +.IP or 10 +\&\fR||\fR +.IP or_eq 10 +\&\fR|=\fR +.IP xor 10 +\&\fR^\fR +.IP xor_eq 10 +\&\fR^=\fR +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +None. +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/langinfo.h.0p b/upstream/mageia-cauldron/man0p/langinfo.h.0p new file mode 100644 index 00000000..0a49b923 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/langinfo.h.0p @@ -0,0 +1,197 @@ +'\" et +.TH langinfo.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +langinfo.h +\(em language information constants +.SH SYNOPSIS +.LP +.nf +#include <langinfo.h> +.fi +.SH DESCRIPTION +The +.IR <langinfo.h> +header shall define the symbolic constants used to identify items of +.IR langinfo +data (see +\fInl_langinfo\fR()). +.P +The +.IR <langinfo.h> +header shall define the +.BR locale_t +type as described in +.IR <locale.h> . +.P +The +.IR <langinfo.h> +header shall define the +.BR nl_item +type as described in +.IR <nl_types.h> . +.P +The +.IR <langinfo.h> +header shall define the following symbolic constants with type +.BR nl_item . +The entries under +.BR Category +indicate in which +\fIsetlocale\fR() +category each item is defined. +.TS +box center tab(!); +cB | cB | cB +l1 | lI1 | l. +Constant!Category!Meaning +_ +CODESET!LC_CTYPE!Codeset name. +D_T_FMT!LC_TIME!String for formatting date and time. +D_FMT!LC_TIME!Date format string. +T_FMT!LC_TIME!Time format string. +T_FMT_AMPM!LC_TIME!a.m. or p.m. time format string. +AM_STR!LC_TIME!Ante-meridiem affix. +PM_STR!LC_TIME!Post-meridiem affix. +DAY_1!LC_TIME!Name of the first day of the week (for example, Sunday). +DAY_2!LC_TIME!Name of the second day of the week (for example, Monday). +DAY_3!LC_TIME!Name of the third day of the week (for example, Tuesday). +DAY_4!LC_TIME!Name of the fourth day of the week + !!(for example, Wednesday). +DAY_5!LC_TIME!Name of the fifth day of the week (for example, Thursday). +DAY_6!LC_TIME!Name of the sixth day of the week (for example, Friday). +DAY_7!LC_TIME!Name of the seventh day of the week + !!(for example, Saturday). +ABDAY_1!LC_TIME!Abbreviated name of the first day of the week. +ABDAY_2!LC_TIME!Abbreviated name of the second day of the week. +ABDAY_3!LC_TIME!Abbreviated name of the third day of the week. +ABDAY_4!LC_TIME!Abbreviated name of the fourth day of the week. +ABDAY_5!LC_TIME!Abbreviated name of the fifth day of the week. +ABDAY_6!LC_TIME!Abbreviated name of the sixth day of the week. +ABDAY_7!LC_TIME!Abbreviated name of the seventh day of the week. +MON_1!LC_TIME!Name of the first month of the year. +MON_2!LC_TIME!Name of the second month. +MON_3!LC_TIME!Name of the third month. +MON_4!LC_TIME!Name of the fourth month. +MON_5!LC_TIME!Name of the fifth month. +MON_6!LC_TIME!Name of the sixth month. +MON_7!LC_TIME!Name of the seventh month. +MON_8!LC_TIME!Name of the eighth month. +MON_9!LC_TIME!Name of the ninth month. +MON_10!LC_TIME!Name of the tenth month. +MON_11!LC_TIME!Name of the eleventh month. +MON_12!LC_TIME!Name of the twelfth month. +ABMON_1!LC_TIME!Abbreviated name of the first month. +ABMON_2!LC_TIME!Abbreviated name of the second month. +ABMON_3!LC_TIME!Abbreviated name of the third month. +ABMON_4!LC_TIME!Abbreviated name of the fourth month. +ABMON_5!LC_TIME!Abbreviated name of the fifth month. +ABMON_6!LC_TIME!Abbreviated name of the sixth month. +ABMON_7!LC_TIME!Abbreviated name of the seventh month. +ABMON_8!LC_TIME!Abbreviated name of the eighth month. +ABMON_9!LC_TIME!Abbreviated name of the ninth month. +ABMON_10!LC_TIME!Abbreviated name of the tenth month. +ABMON_11!LC_TIME!Abbreviated name of the eleventh month. +ABMON_12!LC_TIME!Abbreviated name of the twelfth month. +ERA!LC_TIME!Era description segments. +ERA_D_FMT!LC_TIME!Era date format string. +ERA_D_T_FMT!LC_TIME!Era date and time format string. +ERA_T_FMT!LC_TIME!Era time format string. +ALT_DIGITS!LC_TIME!Alternative symbols for digits. +RADIXCHAR!LC_NUMERIC!Radix character. +THOUSEP!LC_NUMERIC!Separator for thousands. +YESEXPR!LC_MESSAGES!Affirmative response expression. +NOEXPR!LC_MESSAGES!Negative response expression. +CRNCYSTR!LC_MONETARY!T{ +Local currency symbol, preceded by +.BR '\-' +if the symbol should appear before the value, +.BR '+' +if the symbol should appear after the value, or +.BR '.' +if the symbol should replace the radix character. If the local +currency symbol is the empty string, implementations may return +the empty string (\c +.BR \(dq\&\(dq ). +T} +.TE +.P +If the locale's values for +.BR p_cs_precedes +and +.BR n_cs_precedes +do not match, the value of +.IR nl_langinfo (CRNCYSTR) +and +.IR nl_langinfo_l (CRNCYSTR,loc) +is unspecified. +.P +The following shall be declared as a function and may also be defined +as a macro. A function prototype shall be provided. +.sp +.RS 4 +.nf + +char *nl_langinfo(nl_item); +char *nl_langinfo_l(nl_item, locale_t); +.fi +.P +.RE +.P +Inclusion of the +.IR <langinfo.h> +header may also make visible all symbols from +.IR <nl_types.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +Wherever possible, users are advised to use functions compatible with +those in the ISO\ C standard to access items of +.IR langinfo +data. In particular, the +\fIstrftime\fR() +function should be used to access date and time information defined in +category +.IR LC_TIME . +The +\fIlocaleconv\fR() +function should be used to access information corresponding to +RADIXCHAR, THOUSEP, and CRNCYSTR. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "Chapter 7" ", " "Locale", +.IR "\fB<locale.h>\fP", +.IR "\fB<nl_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fInl_langinfo\fR\^(\|)", +.IR "\fIlocaleconv\fR\^(\|)", +.IR "\fIstrfmon\fR\^(\|)", +.IR "\fIstrftime\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/libgen.h.0p b/upstream/mageia-cauldron/man0p/libgen.h.0p new file mode 100644 index 00000000..bf6d49f6 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/libgen.h.0p @@ -0,0 +1,59 @@ +'\" et +.TH libgen.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +libgen.h +\(em definitions for pattern matching functions +.SH SYNOPSIS +.LP +.nf +#include <libgen.h> +.fi +.SH DESCRIPTION +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +char *basename(char *); +char *dirname(char *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIbasename\fR\^(\|)", +.IR "\fIdirname\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/limits.h.0p b/upstream/mageia-cauldron/man0p/limits.h.0p new file mode 100644 index 00000000..f75e1c16 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/limits.h.0p @@ -0,0 +1,1174 @@ +'\" et +.TH limits.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +limits.h +\(em implementation-defined constants +.SH SYNOPSIS +.LP +.nf +#include <limits.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +Many of the symbols listed here are not defined by the ISO/IEC\ 9899:\|1999 standard. Such symbols +are not shown as CX shaded, except under the heading ``Numerical Limits''. +.P +The +.IR <limits.h> +header shall define macros and symbolic constants for various limits. +Different categories of limits are described below, representing various +limits on resources that the implementation imposes on applications. +All macros and symbolic constants defined in this header shall be +suitable for use in +.BR #if +preprocessing directives. +.P +Implementations may choose any appropriate value for each limit, +provided it is not more restrictive than the Minimum Acceptable Values +listed below. Symbolic constant names beginning with _POSIX may be +found in +.IR <unistd.h> . +.P +Applications should not assume any particular value for a limit. To +achieve maximum portability, an application should not require more +resource than the Minimum Acceptable Value quantity. However, an +application wishing to avail itself of the full amount of a resource +available on an implementation may make use of the value given in +.IR <limits.h> +on that particular implementation, by using the macros and symbolic +constants listed below. It should be noted, however, that many of the +listed limits are not invariant, and at runtime, the value of the limit +may differ from those given in this header, for the following reasons: +.IP " *" 4 +The limit is pathname-dependent. +.IP " *" 4 +The limit differs between the compile and runtime machines. +.P +For these reasons, an application may use the +\fIfpathconf\fR(), +\fIpathconf\fR(), +and +\fIsysconf\fR() +functions to determine the actual value of a limit at runtime. +.P +The items in the list ending in _MIN give the most negative values that +the mathematical types are guaranteed to be capable of representing. +Numbers of a more negative value may be supported on some +implementations, as indicated by the +.IR <limits.h> +header on the implementation, but applications requiring such numbers +are not guaranteed to be portable to all implementations. For positive +constants ending in _MIN, this indicates the minimum acceptable value. +.SS "Runtime Invariant Values (Possibly Indeterminate)" +.P +A definition of one of the symbolic constants in the following list +shall be omitted from +.IR <limits.h> +on specific implementations where the corresponding value is equal to +or greater than the stated minimum, but is unspecified. +.P +This indetermination might depend on the amount of available memory +space on a specific instance of a specific implementation. The actual +value supported by a specific instance shall be provided by the +\fIsysconf\fR() +function. +.IP {AIO_LISTIO_MAX} 6 +.br +Maximum number of I/O operations in a single list I/O call supported by +the implementation. +.br +Minimum Acceptable Value: +{_POSIX_AIO_LISTIO_MAX} +.IP {AIO_MAX} 6 +.br +Maximum number of outstanding asynchronous I/O operations supported by +the implementation. +.br +Minimum Acceptable Value: +{_POSIX_AIO_MAX} +.IP {AIO_PRIO_DELTA_MAX} 6 +.br +The maximum amount by which a process can decrease its asynchronous I/O +priority level from its own scheduling priority. +.br +Minimum Acceptable Value: 0 +.IP {ARG_MAX} 6 +.br +Maximum length of argument to the +.IR exec +functions including environment data. +.br +Minimum Acceptable Value: +{_POSIX_ARG_MAX} +.IP {ATEXIT_MAX} 6 +.br +Maximum number of functions that may be registered with +\fIatexit\fR(). +.br +Minimum Acceptable Value: 32 +.IP {CHILD_MAX} 6 +.br +Maximum number of simultaneous processes per real user ID. +.br +Minimum Acceptable Value: +{_POSIX_CHILD_MAX} +.IP {DELAYTIMER_MAX} 6 +.br +Maximum number of timer expiration overruns. +.br +Minimum Acceptable Value: +{_POSIX_DELAYTIMER_MAX} +.IP {HOST_NAME_MAX} 6 +.br +Maximum length of a host name (not including the terminating null) +as returned from the +\fIgethostname\fR() +function. +.br +Minimum Acceptable Value: +{_POSIX_HOST_NAME_MAX} +.IP {IOV_MAX} 6 +.br +Maximum number of +.BR iovec +structures that one process has available for use with +\fIreadv\fR() +or +\fIwritev\fR(). +.br +Minimum Acceptable Value: +{_XOPEN_IOV_MAX} +.IP {LOGIN_NAME_MAX} 6 +.br +Maximum length of a login name. +.br +Minimum Acceptable Value: +{_POSIX_LOGIN_NAME_MAX} +.IP {MQ_OPEN_MAX} 6 +.br +The maximum number of open message queue descriptors a process may +hold. +.br +Minimum Acceptable Value: +{_POSIX_MQ_OPEN_MAX} +.IP {MQ_PRIO_MAX} 6 +.br +The maximum number of message priorities supported by the implementation. +.br +Minimum Acceptable Value: +{_POSIX_MQ_PRIO_MAX} +.IP {OPEN_MAX} 6 +.br +A value one greater than the maximum value that the system may +assign to a newly-created file descriptor. +.br +Minimum Acceptable Value: +{_POSIX_OPEN_MAX} +.IP {PAGESIZE} 6 +.br +Size in bytes of a page. +.br +Minimum Acceptable Value: 1 +.IP {PAGE_SIZE} 6 +.br +Equivalent to +{PAGESIZE}. +If either +{PAGESIZE} +or +{PAGE_SIZE} +is defined, the other is defined with the same value. +.IP {PTHREAD_DESTRUCTOR_ITERATIONS} 6 +.br +Maximum number of attempts made to destroy a thread's thread-specific +data values on thread exit. +.br +Minimum Acceptable Value: +{_POSIX_THREAD_DESTRUCTOR_ITERATIONS} +.IP {PTHREAD_KEYS_MAX} 6 +.br +Maximum number of data keys that can be created by a process. +.br +Minimum Acceptable Value: +{_POSIX_THREAD_KEYS_MAX} +.IP {PTHREAD_STACK_MIN} 6 +.br +Minimum size in bytes of thread stack storage. +.br +Minimum Acceptable Value: 0 +.IP {PTHREAD_THREADS_MAX} 6 +.br +Maximum number of threads that can be created per process. +.br +Minimum Acceptable Value: +{_POSIX_THREAD_THREADS_MAX} +.IP {RTSIG_MAX} 6 +.br +Maximum number of realtime signals reserved for application use in this +implementation. +.br +Minimum Acceptable Value: +{_POSIX_RTSIG_MAX} +.IP {SEM_NSEMS_MAX} 6 +.br +Maximum number of semaphores that a process may have. +.br +Minimum Acceptable Value: +{_POSIX_SEM_NSEMS_MAX} +.IP {SEM_VALUE_MAX} 6 +.br +The maximum value a semaphore may have. +.br +Minimum Acceptable Value: +{_POSIX_SEM_VALUE_MAX} +.IP {SIGQUEUE_MAX} 6 +.br +Maximum number of queued signals that a process may send and have +pending at the receiver(s) at any time. +.br +Minimum Acceptable Value: +{_POSIX_SIGQUEUE_MAX} +.IP {SS_REPL_MAX} 6 +.br +The maximum number of replenishment operations that may be simultaneously +pending for a particular sporadic server scheduler. +.br +Minimum Acceptable Value: +{_POSIX_SS_REPL_MAX} +.IP {STREAM_MAX} 6 +.br +Maximum number of streams that one process can have open at one time. +If defined, it has the same value as +{FOPEN_MAX} +(see +.IR <stdio.h> ). +.br +Minimum Acceptable Value: +{_POSIX_STREAM_MAX} +.IP {SYMLOOP_MAX} 6 +.br +Maximum number of symbolic links that can be reliably traversed in the +resolution of a pathname in the absence of a loop. +.br +Minimum Acceptable Value: +{_POSIX_SYMLOOP_MAX} +.IP {TIMER_MAX} 6 +.br +Maximum number of timers per process supported by the implementation. +.br +Minimum Acceptable Value: +{_POSIX_TIMER_MAX} +.IP {TRACE_EVENT_NAME_MAX} 6 +.br +Maximum length of the trace event name (not including the terminating null). +.br +Minimum Acceptable Value: +{_POSIX_TRACE_EVENT_NAME_MAX} +.IP {TRACE_NAME_MAX} 6 +.br +Maximum length of the trace generation version string or of the +trace stream name (not including the terminating null). +.br +Minimum Acceptable Value: +{_POSIX_TRACE_NAME_MAX} +.IP {TRACE_SYS_MAX} 6 +.br +Maximum number of trace streams that may simultaneously exist in +the system. +.br +Minimum Acceptable Value: +{_POSIX_TRACE_SYS_MAX} +.IP {TRACE_USER_EVENT_MAX} 6 +.br +Maximum number of user trace event type identifiers that may +simultaneously exist in a traced process, including the predefined +user trace event POSIX_TRACE_UNNAMED_USER_EVENT. +.br +Minimum Acceptable Value: +{_POSIX_TRACE_USER_EVENT_MAX} +.IP {TTY_NAME_MAX} 6 +.br +Maximum length of terminal device name. +.br +Minimum Acceptable Value: +{_POSIX_TTY_NAME_MAX} +.IP {TZNAME_MAX} 6 +.br +Maximum number of bytes supported for the name of a timezone (not of +the +.IR TZ +variable). +.br +Minimum Acceptable Value: +{_POSIX_TZNAME_MAX} +.TP 10 +.BR Note: +The length given by +{TZNAME_MAX} +does not include the quoting characters mentioned in +.IR "Section 8.3" ", " "Other Environment Variables". +.P +.SS "Pathname Variable Values" +.P +The values in the following list may be constants within an +implementation or may vary from one pathname to another. For example, +file systems or directories may have different characteristics. +.P +A definition of one of the symbolic constants in the following list +shall be omitted from the +.IR <limits.h> +header on specific implementations where the corresponding value is +equal to or greater than the stated minimum, but where the value can +vary depending on the file to which it is applied. The actual value +supported for a specific pathname shall be provided by the +\fIpathconf\fR() +function. +.IP {FILESIZEBITS} 6 +.br +Minimum number of bits needed to represent, as a signed integer value, +the maximum size of a regular file allowed in the specified directory. +.br +Minimum Acceptable Value: 32 +.IP {LINK_MAX} 6 +.br +Maximum number of links to a single file. +.br +Minimum Acceptable Value: +{_POSIX_LINK_MAX} +.IP {MAX_CANON} 6 +.br +Maximum number of bytes in a terminal canonical input line. +.br +Minimum Acceptable Value: +{_POSIX_MAX_CANON} +.IP {MAX_INPUT} 6 +.br +Minimum number of bytes for which space is available in a terminal +input queue; therefore, the maximum number of bytes a conforming +application may require to be typed as input before reading them. +.br +Minimum Acceptable Value: +{_POSIX_MAX_INPUT} +.IP {NAME_MAX} 6 +.br +Maximum number of bytes in a filename (not including the terminating +null of a filename string). +.br +Minimum Acceptable Value: +{_POSIX_NAME_MAX} +.br +Minimum Acceptable Value: +{_XOPEN_NAME_MAX} +.IP {PATH_MAX} 6 +.br +Maximum number of bytes the implementation will store as a pathname in +a user-supplied buffer of unspecified size, including the terminating +null character. Minimum number the implementation will accept as the +maximum number of bytes in a pathname. +.br +Minimum Acceptable Value: +{_POSIX_PATH_MAX} +.br +Minimum Acceptable Value: +{_XOPEN_PATH_MAX} +.IP {PIPE_BUF} 6 +.br +Maximum number of bytes that is guaranteed to be atomic when writing to +a pipe. +.br +Minimum Acceptable Value: +{_POSIX_PIPE_BUF} +.IP {POSIX_ALLOC_SIZE_MIN} 6 +.br +Minimum number of bytes of storage actually allocated for any portion +of a file. +.br +Minimum Acceptable Value: Not specified. +.IP {POSIX_REC_INCR_XFER_SIZE} 6 +.br +Recommended increment for file transfer sizes between the +{POSIX_REC_MIN_XFER_SIZE} +and +{POSIX_REC_MAX_XFER_SIZE} +values. +.br +Minimum Acceptable Value: Not specified. +.IP {POSIX_REC_MAX_XFER_SIZE} 6 +.br +Maximum recommended file transfer size. +.br +Minimum Acceptable Value: Not specified. +.IP {POSIX_REC_MIN_XFER_SIZE} 6 +.br +Minimum recommended file transfer size. +.br +Minimum Acceptable Value: Not specified. +.IP {POSIX_REC_XFER_ALIGN} 6 +.br +Recommended file transfer buffer alignment. +.br +Minimum Acceptable Value: Not specified. +.IP {SYMLINK_MAX} 6 +.br +Maximum number of bytes in a symbolic link. +.br +Minimum Acceptable Value: +{_POSIX_SYMLINK_MAX} +.SS "Runtime Increasable Values" +.P +The magnitude limitations in the following list shall be fixed by +specific implementations. An application should assume that the value +of the symbolic constant defined by +.IR <limits.h> +in a specific implementation is the minimum that pertains whenever the +application is run under that implementation. A specific instance of a +specific implementation may increase the value relative to that +supplied by +.IR <limits.h> +for that implementation. The actual value supported by a specific +instance shall be provided by the +\fIsysconf\fR() +function. +.IP {BC_BASE_MAX} 6 +.br +Maximum +.IR obase +values allowed by the +.IR bc +utility. +.br +Minimum Acceptable Value: +{_POSIX2_BC_BASE_MAX} +.IP {BC_DIM_MAX} 6 +.br +Maximum number of elements permitted in an array by the +.IR bc +utility. +.br +Minimum Acceptable Value: +{_POSIX2_BC_DIM_MAX} +.IP {BC_SCALE_MAX} 6 +.br +Maximum +.IR scale +value allowed by the +.IR bc +utility. +.br +Minimum Acceptable Value: +{_POSIX2_BC_SCALE_MAX} +.IP {BC_STRING_MAX} 6 +.br +Maximum length of a string constant accepted by the +.IR bc +utility. +.br +Minimum Acceptable Value: +{_POSIX2_BC_STRING_MAX} +.IP {CHARCLASS_NAME_MAX} 6 +.br +Maximum number of bytes in a character class name. +.br +Minimum Acceptable Value: +{_POSIX2_CHARCLASS_NAME_MAX} +.IP {COLL_WEIGHTS_MAX} 6 +.br +Maximum number of weights that can be assigned to an entry of the +.IR LC_COLLATE +.BR order +keyword in the locale definition file; see +.IR "Chapter 7" ", " "Locale". +.br +Minimum Acceptable Value: +{_POSIX2_COLL_WEIGHTS_MAX} +.IP {EXPR_NEST_MAX} 6 +.br +Maximum number of expressions that can be nested within parentheses by +the +.IR expr +utility. +.br +Minimum Acceptable Value: +{_POSIX2_EXPR_NEST_MAX} +.IP {LINE_MAX} 6 +.br +Unless otherwise noted, the maximum length, in bytes, of a utility's +input line (either standard input or another file), when the utility is +described as processing text files. The length includes room for the +trailing +<newline>. +.br +Minimum Acceptable Value: +{_POSIX2_LINE_MAX} +.IP {NGROUPS_MAX} 6 +.br +Maximum number of simultaneous supplementary group IDs per process. +.br +Minimum Acceptable Value: +{_POSIX_NGROUPS_MAX} +.IP {RE_DUP_MAX} 6 +.br +Maximum number of repeated occurrences of a BRE or ERE interval +expression; see +.IR "Section 9.3.6" ", " "BREs Matching Multiple Characters" +and +.IR "Section 9.4.6" ", " "EREs Matching Multiple Characters". +.br +Minimum Acceptable Value: +{_POSIX_RE_DUP_MAX} +.SS "Maximum Values" +.P +The +.IR <limits.h> +header shall define the following symbolic constants with the values +shown. These are the most restrictive values for certain features on +an implementation. A conforming implementation shall provide values no +larger than these values. A conforming application must not require a +smaller value for correct operation. +.IP {_POSIX_CLOCKRES_MIN} 6 +.br +The resolution of the CLOCK_REALTIME clock, in nanoseconds. +.br +Value: 20 000 000 +.RS 6 +.P +If the Monotonic Clock option is supported, the resolution of the +CLOCK_MONOTONIC clock, in nanoseconds, is represented by +{_POSIX_CLOCKRES_MIN}. +.RE +.SS "Minimum Values" +.P +The +.IR <limits.h> +header shall define the following symbolic constants with the values +shown. These are the most restrictive values for certain features on +an implementation conforming to this volume of POSIX.1\(hy2017. Related symbolic constants are +defined elsewhere in this volume of POSIX.1\(hy2017 which reflect the actual implementation and +which need not be as restrictive. For each of these limits, a conforming +implementation shall provide a value at least this large or shall have +no limit. A strictly conforming application must not require a larger +value for correct operation. +.IP {_POSIX_AIO_LISTIO_MAX} 6 +.br +The number of I/O operations that can be specified in a list I/O call. +.br +Value: 2 +.IP {_POSIX_AIO_MAX} 6 +.br +The number of outstanding asynchronous I/O operations. +.br +Value: 1 +.IP {_POSIX_ARG_MAX} 6 +.br +Maximum length of argument to the +.IR exec +functions including environment data. +.br +Value: 4 096 +.IP {_POSIX_CHILD_MAX} 6 +.br +Maximum number of simultaneous processes per real user ID. +.br +Value: 25 +.IP {_POSIX_DELAYTIMER_MAX} 6 +.br +The number of timer expiration overruns. +.br +Value: 32 +.IP {_POSIX_HOST_NAME_MAX} 6 +.br +Maximum length of a host name (not including the terminating null) +as returned from the +\fIgethostname\fR() +function. +.br +Value: 255 +.IP {_POSIX_LINK_MAX} 6 +.br +Maximum number of links to a single file. +.br +Value: 8 +.IP {_POSIX_LOGIN_NAME_MAX} 6 +.br +The size of the storage required for a login name, in bytes +(including the terminating null). +.br +Value: 9 +.IP {_POSIX_MAX_CANON} 6 +.br +Maximum number of bytes in a terminal canonical input queue. +.br +Value: 255 +.IP {_POSIX_MAX_INPUT} 6 +.br +Maximum number of bytes allowed in a terminal input queue. +.br +Value: 255 +.IP {_POSIX_MQ_OPEN_MAX} 6 +.br +The number of message queues that can be open for a single process. +.br +Value: 8 +.IP {_POSIX_MQ_PRIO_MAX} 6 +.br +The maximum number of message priorities supported by the implementation. +.br +Value: 32 +.IP {_POSIX_NAME_MAX} 6 +.br +Maximum number of bytes in a filename (not including the terminating +null of a filename string). +.br +Value: 14 +.IP {_POSIX_NGROUPS_MAX} 6 +.br +Maximum number of simultaneous supplementary group IDs per process. +.br +Value: 8 +.IP {_POSIX_OPEN_MAX} 6 +.br +A value one greater than the maximum value that the system may assign +to a newly-created file descriptor. +.br +Value: 20 +.IP {_POSIX_PATH_MAX} 6 +.br +Minimum number the implementation will accept as the maximum number of +bytes in a pathname. +.br +Value: 256 +.IP {_POSIX_PIPE_BUF} 6 +.br +Maximum number of bytes that is guaranteed to be atomic when writing to +a pipe. +.br +Value: 512 +.IP {_POSIX_RE_DUP_MAX} 6 +.br +Maximum number of repeated occurrences of a BRE or ERE interval +expression; see +.IR "Section 9.3.6" ", " "BREs Matching Multiple Characters" +and +.IR "Section 9.4.6" ", " "EREs Matching Multiple Characters". +.br +Value: 255 +.IP {_POSIX_RTSIG_MAX} 6 +.br +The number of realtime signal numbers reserved for application use. +.br +Value: 8 +.IP {_POSIX_SEM_NSEMS_MAX} 6 +.br +The number of semaphores that a process may have. +.br +Value: 256 +.IP {_POSIX_SEM_VALUE_MAX} 6 +.br +The maximum value a semaphore may have. +.br +Value: 32 767 +.IP {_POSIX_SIGQUEUE_MAX} 6 +.br +The number of queued signals that a process may send and have pending +at the receiver(s) at any time. +.br +Value: 32 +.IP {_POSIX_SSIZE_MAX} 6 +.br +The value that can be stored in an object of type +.BR ssize_t . +.br +Value: 32 767 +.IP {_POSIX_SS_REPL_MAX} 6 +.br +The number of replenishment operations that may be simultaneously +pending for a particular sporadic server scheduler. +.br +Value: 4 +.IP {_POSIX_STREAM_MAX} 6 +.br +The number of streams that one process can have open at one time. +.br +Value: 8 +.IP {_POSIX_SYMLINK_MAX} 6 +.br +The number of bytes in a symbolic link. +.br +Value: 255 +.IP {_POSIX_SYMLOOP_MAX} 6 +.br +The number of symbolic links that can be traversed in the resolution of +a pathname in the absence of a loop. +.br +Value: 8 +.IP {_POSIX_THREAD_DESTRUCTOR_ITERATIONS} 6 +.br +The number of attempts made to destroy a thread's thread-specific data +values on thread exit. +.br +Value: 4 +.IP {_POSIX_THREAD_KEYS_MAX} 6 +.br +The number of data keys per process. +.br +Value: 128 +.IP {_POSIX_THREAD_THREADS_MAX} 6 +.br +The number of threads per process. +.br +Value: 64 +.IP {_POSIX_TIMER_MAX} 6 +.br +The per-process number of timers. +.br +Value: 32 +.IP {_POSIX_TRACE_EVENT_NAME_MAX} 6 +.br +The length in bytes of a trace event name (not including the terminating null). +.br +Value: 30 +.IP {_POSIX_TRACE_NAME_MAX} 6 +.br +The length in bytes of a trace generation version string or a trace +stream name (not including the terminating null). +.br +Value: 8 +.IP {_POSIX_TRACE_SYS_MAX} 6 +.br +The number of trace streams that may simultaneously exist in the system. +.br +Value: 8 +.IP {_POSIX_TRACE_USER_EVENT_MAX} 6 +.br +The number of user trace event type identifiers that may simultaneously +exist in a traced process, including the predefined user trace event +POSIX_TRACE_UNNAMED_USER_EVENT. +.br +Value: 32 +.IP {_POSIX_TTY_NAME_MAX} 6 +.br +The size of the storage required for a terminal device name, in bytes +(including the terminating null). +.br +Value: 9 +.IP {_POSIX_TZNAME_MAX} 6 +.br +Maximum number of bytes supported for the name of a timezone (not of +the +.IR TZ +variable). +.br +Value: 6 +.RS 6 +.TP 10 +.BR Note: +The length given by +{_POSIX_TZNAME_MAX} +does not include the quoting characters mentioned in +.IR "Section 8.3" ", " "Other Environment Variables". +.P +.RE +.IP {_POSIX2_BC_BASE_MAX} 6 +.br +Maximum +.IR obase +values allowed by the +.IR bc +utility. +.br +Value: 99 +.IP {_POSIX2_BC_DIM_MAX} 6 +.br +Maximum number of elements permitted in an array by the +.IR bc +utility. +.br +Value: 2 048 +.IP {_POSIX2_BC_SCALE_MAX} 6 +.br +Maximum +.IR scale +value allowed by the +.IR bc +utility. +.br +Value: 99 +.IP {_POSIX2_BC_STRING_MAX} 6 +.br +Maximum length of a string constant accepted by the +.IR bc +utility. +.br +Value: 1 000 +.IP {_POSIX2_CHARCLASS_NAME_MAX} 6 +.br +Maximum number of bytes in a character class name. +.br +Value: 14 +.IP {_POSIX2_COLL_WEIGHTS_MAX} 6 +.br +Maximum number of weights that can be assigned to an entry of the +.IR LC_COLLATE +.BR order +keyword in the locale definition file; see +.IR "Chapter 7" ", " "Locale". +.br +Value: 2 +.IP {_POSIX2_EXPR_NEST_MAX} 6 +.br +Maximum number of expressions that can be nested within parentheses by +the +.IR expr +utility. +.br +Value: 32 +.IP {_POSIX2_LINE_MAX} 6 +.br +Unless otherwise noted, the maximum length, in bytes, of a utility's +input line (either standard input or another file), when the utility is +described as processing text files. The length includes room for the +trailing +<newline>. +.br +Value: 2 048 +.IP {_POSIX2_RE_DUP_MAX} 6 +.br +Maximum number of repeated occurrences of a BRE or ERE interval +expression; see +.IR "Section 9.3.6" ", " "BREs Matching Multiple Characters" +and +.IR "Section 9.4.6" ", " "EREs Matching Multiple Characters". +.br +Value: 255 +.IP {_XOPEN_IOV_MAX} 6 +.br +Maximum number of +.BR iovec +structures that one process has available for use with +\fIreadv\fR() +or +\fIwritev\fR(). +.br +Value: 16 +.IP {_XOPEN_NAME_MAX} 6 +.br +Maximum number of bytes in a filename (not including the terminating +null of a filename string). +.br +Value: 255 +.IP {_XOPEN_PATH_MAX} 6 +.br +Minimum number the implementation will accept as the maximum number of +bytes in a pathname. +.br +Value: 1\|024 +.SS "Numerical Limits" +.P +The +.IR <limits.h> +header shall define the following macros and, except for +{CHAR_BIT}, +{LONG_BIT}, +{MB_LEN_MAX}, +and +{WORD_BIT}, +they shall be replaced by expressions that have the same type as +would an expression that is an object of the corresponding type +converted according to the integer promotions. +.P +If the value of an object of type +.BR char +is treated as a signed integer when used in an expression, the value of +{CHAR_MIN} +is the same as that of +{SCHAR_MIN} +and the value of +{CHAR_MAX} +is the same as that of +{SCHAR_MAX}. +Otherwise, the value of +{CHAR_MIN} +is 0 and the value of +{CHAR_MAX} +is the same as that of +{UCHAR_MAX}. +.IP {CHAR_BIT} 6 +.br +Number of bits in a type +.BR char . +.br +Value: 8 +.IP {CHAR_MAX} 6 +.br +Maximum value for an object of type +.BR char . +.br +Value: +{UCHAR_MAX} +or +{SCHAR_MAX} +.IP {CHAR_MIN} 6 +.br +Minimum value for an object of type +.BR char . +.br +Value: +{SCHAR_MIN} +or 0 +.IP {INT_MAX} 6 +.br +Maximum value for an object of type +.BR int . +.br +Minimum Acceptable Value: 2 147 483 647 +.IP {INT_MIN} 6 +.br +Minimum value for an object of type +.BR int . +.br +Maximum Acceptable Value: \-2 147 483 647 +.IP {LLONG_MAX} 6 +.br +Maximum value for an object of type +.BR "long long" . +.br +Minimum Acceptable Value: +9\|223\|372\|036\|854\|775\|807 +.IP {LLONG_MIN} 6 +.br +Minimum value for an object of type +.BR "long long" . +.br +Maximum Acceptable Value: \-9\|223\|372\|036\|854\|775\|807 +.IP {LONG_BIT} 6 +.br +Number of bits in an object of type +.BR long . +.br +Minimum Acceptable Value: 32 +.IP {LONG_MAX} 6 +.br +Maximum value for an object of type +.BR long . +.br +Minimum Acceptable Value: +2 147 483 647 +.IP {LONG_MIN} 6 +.br +Minimum value for an object of type +.BR long . +.br +Maximum Acceptable Value: \-2 147 483 647 +.IP {MB_LEN_MAX} 6 +.br +Maximum number of bytes in a character, for any supported locale. +.br +Minimum Acceptable Value: 1 +.IP {SCHAR_MAX} 6 +.br +Maximum value for an object of type +.BR "signed char" . +.br +Value: +127 +.IP {SCHAR_MIN} 6 +.br +Minimum value for an object of type +.BR "signed char" . +.br +Value: \-128 +.IP {SHRT_MAX} 6 +.br +Maximum value for an object of type +.BR short . +.br +Minimum Acceptable Value: +32 767 +.IP {SHRT_MIN} 6 +.br +Minimum value for an object of type +.BR short . +.br +Maximum Acceptable Value: \-32 767 +.IP {SSIZE_MAX} 6 +.br +Maximum value for an object of type +.BR ssize_t . +.br +Minimum Acceptable Value: +{_POSIX_SSIZE_MAX} +.IP {UCHAR_MAX} 6 +.br +Maximum value for an object of type +.BR "unsigned char" . +.br +Value: 255 +.IP {UINT_MAX} 6 +.br +Maximum value for an object of type +.BR unsigned . +.br +Minimum Acceptable Value: 4 294 967 295 +.IP {ULLONG_MAX} 6 +.br +Maximum value for an object of type +.BR "unsigned long long" . +.br +Minimum Acceptable Value: 18\|446\|744\|073\|709\|551\|615 +.IP {ULONG_MAX} 6 +.br +Maximum value for an object of type +.BR "unsigned long" . +.br +Minimum Acceptable Value: 4 294 967 295 +.IP {USHRT_MAX} 6 +.br +Maximum value for an object of type +.BR "unsigned short" . +.br +Minimum Acceptable Value: 65 535 +.IP {WORD_BIT} 6 +.br +Number of bits in an object of type +.BR int . +.br +Minimum Acceptable Value: 32 +.SS "Other Invariant Values" +.P +The +.IR <limits.h> +header shall define the following symbolic constants: +.IP {NL_ARGMAX} 6 +.br +Maximum value of +.IR n +in conversion specifications using the \fR"%\fIn\fR$"\fR +sequence in calls to the +\fIprintf\fR() +and +\fIscanf\fR() +families of functions. +.br +Minimum Acceptable Value: 9 +.IP {NL_LANGMAX} 6 +.br +Maximum number of bytes in a +.IR LANG +name. +.br +Minimum Acceptable Value: 14 +.IP {NL_MSGMAX} 6 +.br +Maximum message number. +.br +Minimum Acceptable Value: 32 767 +.IP {NL_SETMAX} 6 +.br +Maximum set number. +.br +Minimum Acceptable Value: 255 +.IP {NL_TEXTMAX} 6 +.br +Maximum number of bytes in a message string. +.br +Minimum Acceptable Value: +{_POSIX2_LINE_MAX} +.IP {NZERO} 6 +.br +Default process priority. +.br +Minimum Acceptable Value: 20 +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +A request was made to reduce the value of +{_POSIX_LINK_MAX} +from the value of 8 specified for it in the POSIX.1\(hy1990 standard to 2. The +standard developers decided to deny this request for several reasons: +.IP " *" 4 +They wanted to avoid making any changes to the standard that could +break conforming applications, and the requested change could have that +effect. +.IP " *" 4 +The use of multiple hard links to a file cannot always be replaced with +use of symbolic links. Symbolic links are semantically different from +hard links in that they associate a pathname with another pathname +rather than a pathname with a file. This has implications for access +control, file permanence, and transparency. +.IP " *" 4 +The original standard developers had considered the issue of allowing +for implementations that did not in general support hard links, and +decided that this would reduce consensus on the standard. +.P +Systems that support historical versions of the development option of +the ISO\ POSIX\(hy2 standard retain the name +{_POSIX2_RE_DUP_MAX} +as an alias for +{_POSIX_RE_DUP_MAX}. +.IP {PATH_MAX} 6 +.br +IEEE PASC Interpretation 1003.1 #15 addressed the inconsistency in the +standard with the definition of pathname and the description of +{PATH_MAX}, +allowing application developers to allocate either +{PATH_MAX} +or +{PATH_MAX}+1 +bytes. The inconsistency has been removed by correction to the +{PATH_MAX} +definition to include the null character. With this change, +applications that previously allocated +{PATH_MAX} +bytes will continue to succeed. +.IP {SYMLINK_MAX} 6 +.br +This symbol refers to space for data that is stored in the file system, +as opposed to +{PATH_MAX} +which is the length of a name that can be passed to a function. In some +existing implementations, the pathnames pointed to by symbolic links +are stored in the +.IR inode s +of the links, so it is important that +{SYMLINK_MAX} +not be constrained to be as large as +{PATH_MAX}. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "Chapter 7" ", " "Locale", +.IR "\fB<stdio.h>\fP", +.IR "\fB<unistd.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIfpathconf\fR\^(\|)", +.IR "\fIsysconf\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/locale.h.0p b/upstream/mageia-cauldron/man0p/locale.h.0p new file mode 100644 index 00000000..0899da57 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/locale.h.0p @@ -0,0 +1,182 @@ +'\" et +.TH locale.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +locale.h +\(em category macros +.SH SYNOPSIS +.LP +.nf +#include <locale.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <locale.h> +header shall define the +.BR lconv +structure, which shall include at least the following members. +(See the definitions of +.IR LC_MONETARY +in +.IR "Section 7.3.3" ", " "LC_MONETARY" +and +.IR "Section 7.3.4" ", " "LC_NUMERIC".) +.sp +.RS 4 +.nf + +char *currency_symbol +char *decimal_point +char frac_digits +char *grouping +char *int_curr_symbol +char int_frac_digits +char int_n_cs_precedes +char int_n_sep_by_space +char int_n_sign_posn +char int_p_cs_precedes +char int_p_sep_by_space +char int_p_sign_posn +char *mon_decimal_point +char *mon_grouping +char *mon_thousands_sep +char *negative_sign +char n_cs_precedes +char n_sep_by_space +char n_sign_posn +char *positive_sign +char p_cs_precedes +char p_sep_by_space +char p_sign_posn +char *thousands_sep +.fi +.P +.RE +.P +The +.IR <locale.h> +header shall define NULL (as described in +.IR <stddef.h> ) +and at least the following as macros: +.P +.nf +LC_ALL +LC_COLLATE +LC_CTYPE +LC_MESSAGES +LC_MONETARY +LC_NUMERIC +LC_TIME +.fi +.P +which shall expand to integer constant expressions with distinct +values for use as the first argument to the +\fIsetlocale\fR() +function. +.P +Additional macro definitions, beginning with the characters +.IR LC_ +and an uppercase letter, may also be specified by the implementation. +.P +The +.IR <locale.h> +header shall contain at least the following macros representing +bitmasks for use with the +\fInewlocale\fR() +function for each supported locale category: +LC_COLLATE_MASK +LC_CTYPE_MASK +LC_MESSAGES_MASK +LC_MONETARY_MASK +LC_NUMERIC_MASK +LC_TIME_MASK +.P +In addition, a macro to set the bits for all categories set shall be +defined: +LC_ALL_MASK +.P +The +.IR <locale.h> +header shall define LC_GLOBAL_LOCALE, a special locale object descriptor +used by the +\fIduplocale\fR() +and +\fIuselocale\fR() +functions. +.P +The +.IR <locale.h> +header shall define the +.BR locale_t +type, representing a locale object. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided for use with ISO\ C standard +compilers. +.sp +.RS 4 +.nf + +locale_t duplocale(locale_t); +void freelocale(locale_t); +struct lconv *localeconv(void); +locale_t newlocale(int, const char *, locale_t); +char *setlocale(int, const char *); +locale_t uselocale (locale_t); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +It is suggested that each category macro name for use in +\fIsetlocale\fR() +have a corresponding macro name ending in +.IR _MASK +for use in +\fInewlocale\fR(). +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "Chapter 8" ", " "Environment Variables", +.IR "\fB<stddef.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIduplocale\fR\^(\|)", +.IR "\fIfreelocale\fR\^(\|)", +.IR "\fIlocaleconv\fR\^(\|)", +.IR "\fInewlocale\fR\^(\|)", +.IR "\fIsetlocale\fR\^(\|)", +.IR "\fIuselocale\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/math.h.0p b/upstream/mageia-cauldron/man0p/math.h.0p new file mode 100644 index 00000000..e9fc2dd9 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/math.h.0p @@ -0,0 +1,588 @@ +'\" et +.TH math.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.EQ +delim $$ +.EN +.SH NAME +math.h +\(em mathematical declarations +.SH SYNOPSIS +.LP +.nf +#include <math.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <math.h> +header shall define at least the following types: +.IP "\fBfloat_t\fR" 12 +A real-floating type at least as wide as +.BR float . +.IP "\fBdouble_t\fR" 12 +A real-floating type at least as wide as +.BR double , +and at least as wide as +.BR float_t . +.P +If FLT_EVAL_METHOD equals 0, +.BR float_t +and +.BR double_t +shall be +.BR float +and +.BR double , +respectively; if FLT_EVAL_METHOD equals 1, they shall both be +.BR double ; +if FLT_EVAL_METHOD equals 2, they shall both be +.BR "long double" ; +for other values of FLT_EVAL_METHOD, they are otherwise +implementation-defined. +.P +The +.IR <math.h> +header shall define the following macros, where real-floating indicates +that the argument shall be an expression of real-floating type: +.sp +.RS 4 +.nf + +int fpclassify(real-floating x); +int isfinite(real-floating x); +int isgreater(real-floating x, real-floating y); +int isgreaterequal(real-floating x, real-floating y); +int isinf(real-floating x); +int isless(real-floating x, real-floating y); +int islessequal(real-floating x, real-floating y); +int islessgreater(real-floating x, real-floating y); +int isnan(real-floating x); +int isnormal(real-floating x); +int isunordered(real-floating x, real-floating y); +int signbit(real-floating x); +.fi +.P +.RE +.P +The +.IR <math.h> +header shall define the following symbolic constants. The values +shall have type +.BR double +and shall be accurate to at least the precision of the +.BR double +type. +.IP M_E 12 +Value of $e$ +.IP M_LOG2E 12 +Value of $log_ 2" " e$ +.IP M_LOG10E 12 +Value of $log_ 10" " e$ +.IP M_LN2 12 +Value of $log_ e" " 2$ +.IP M_LN10 12 +Value of $log_ e" " 10$ +.IP M_PI 12 +Value of $pi$ +.IP M_PI_2 12 +Value of $pi /2$ +.IP M_PI_4 12 +Value of $pi /4$ +.IP M_1_PI 12 +Value of $1/ pi$ +.IP M_2_PI 12 +Value of $2/ pi$ +.IP M_2_SQRTPI 12 +Value of $2/ sqrt pi$ +.IP M_SQRT2 12 +Value of $sqrt 2$ +.IP M_SQRT1_2 12 +Value of $1/ sqrt 2$ +.P +The +.IR <math.h> +header shall define the following symbolic constant: +.IP MAXFLOAT 12 +Same value as FLT_MAX in +.IR <float.h> . +.P +The +.IR <math.h> +header shall define the following macros: +.IP HUGE_VAL 12 +A positive +.BR double +constant expression, not necessarily representable as a +.BR float . +Used as an error value returned by the mathematics library. HUGE_VAL +evaluates to +infinity on systems supporting IEEE\ Std\ 754\(hy1985. +.IP HUGE_VALF 12 +A positive +.BR float +constant expression. Used as an error value returned by the mathematics +library. HUGE_VALF evaluates to +infinity on systems supporting IEEE\ Std\ 754\(hy1985. +.IP HUGE_VALL 12 +A positive +.BR "long double" +constant expression. Used as an error value returned by the mathematics +library. HUGE_VALL evaluates to +infinity on systems supporting IEEE\ Std\ 754\(hy1985. +.IP INFINITY 12 +A constant expression of type +.BR float +representing positive or unsigned infinity, if available; else a +positive constant of type +.BR float +that overflows at translation time. +.IP NAN 12 +A constant expression of type +.BR float +representing a quiet NaN. This macro is only defined if the +implementation supports quiet NaNs for the +.BR float +type. +.P +The following macros shall be defined for number classification. They +represent the mutually-exclusive kinds of floating-point values. They +expand to integer constant expressions with distinct values. Additional +implementation-defined floating-point classifications, with macro +definitions beginning with FP_ and an uppercase letter, may also be +specified by the implementation. +.sp +.RS +FP_INFINITE +FP_NAN +FP_NORMAL +FP_SUBNORMAL +FP_ZERO +.RE +.P +The following optional macros indicate whether the +\fIfma\fR() +family of functions are fast compared with direct code: +.sp +.RS +FP_FAST_FMA +FP_FAST_FMAF +FP_FAST_FMAL +.RE +.P +If defined, the FP_FAST_FMA macro shall expand to the integer constant +1 and shall indicate that the +\fIfma\fR() +function generally executes about as fast as, or faster than, a +multiply and an add of +.BR double +operands. If undefined, the speed of execution is unspecified. The +other macros have the equivalent meaning for the +.BR float +and +.BR "long double" +versions. +.P +The following macros shall expand to integer constant expressions whose +values are returned by +.IR ilogb (\c +.IR x ) +if +.IR x +is zero or NaN, respectively. The value of FP_ILOGB0 shall be either +{INT_MIN} +or \-\c +{INT_MAX}. +The value of FP_ILOGBNAN shall be either +{INT_MAX} +or +{INT_MIN}. +.sp +.RS +FP_ILOGB0 +FP_ILOGBNAN +.RE +.P +The following macros shall expand to the integer constants 1 and 2, +respectively; +.sp +.RS +MATH_ERRNO +MATH_ERREXCEPT +.RE +.P +The following macro shall expand to an expression that has type +.BR int +and the value MATH_ERRNO, MATH_ERREXCEPT, or the bitwise-inclusive OR +of both: +.sp +.RS +math_errhandling +.RE +.P +The value of math_errhandling is constant for the duration of the +program. It is unspecified whether math_errhandling is a macro or an +identifier with external linkage. If a macro definition is suppressed +or a program defines an identifier with the name math_errhandling , the +behavior is undefined. If the expression (math_errhandling & +MATH_ERREXCEPT) can be non-zero, the implementation shall define the +macros FE_DIVBYZERO, FE_INVALID, and FE_OVERFLOW in +.IR <fenv.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +double acos(double); +float acosf(float); +double acosh(double); +float acoshf(float); +long double acoshl(long double); +long double acosl(long double); +double asin(double); +float asinf(float); +double asinh(double); +float asinhf(float); +long double asinhl(long double); +long double asinl(long double); +double atan(double); +double atan2(double, double); +float atan2f(float, float); +long double atan2l(long double, long double); +float atanf(float); +double atanh(double); +float atanhf(float); +long double atanhl(long double); +long double atanl(long double); +double cbrt(double); +float cbrtf(float); +long double cbrtl(long double); +double ceil(double); +float ceilf(float); +long double ceill(long double); +double copysign(double, double); +float copysignf(float, float); +long double copysignl(long double, long double); +double cos(double); +float cosf(float); +double cosh(double); +float coshf(float); +long double coshl(long double); +long double cosl(long double); +double erf(double); +double erfc(double); +float erfcf(float); +long double erfcl(long double); +float erff(float); +long double erfl(long double); +double exp(double); +double exp2(double); +float exp2f(float); +long double exp2l(long double); +float expf(float); +long double expl(long double); +double expm1(double); +float expm1f(float); +long double expm1l(long double); +double fabs(double); +float fabsf(float); +long double fabsl(long double); +double fdim(double, double); +float fdimf(float, float); +long double fdiml(long double, long double); +double floor(double); +float floorf(float); +long double floorl(long double); +double fma(double, double, double); +float fmaf(float, float, float); +long double fmal(long double, long double, long double); +double fmax(double, double); +float fmaxf(float, float); +long double fmaxl(long double, long double); +double fmin(double, double); +float fminf(float, float); +long double fminl(long double, long double); +double fmod(double, double); +float fmodf(float, float); +long double fmodl(long double, long double); +double frexp(double, int *); +float frexpf(float, int *); +long double frexpl(long double, int *); +double hypot(double, double); +float hypotf(float, float); +long double hypotl(long double, long double); +int ilogb(double); +int ilogbf(float); +int ilogbl(long double); +double j0(double); +double j1(double); +double jn(int, double); +double ldexp(double, int); +float ldexpf(float, int); +long double ldexpl(long double, int); +double lgamma(double); +float lgammaf(float); +long double lgammal(long double); +long long llrint(double); +long long llrintf(float); +long long llrintl(long double); +long long llround(double); +long long llroundf(float); +long long llroundl(long double); +double log(double); +double log10(double); +float log10f(float); +long double log10l(long double); +double log1p(double); +float log1pf(float); +long double log1pl(long double); +double log2(double); +float log2f(float); +long double log2l(long double); +double logb(double); +float logbf(float); +long double logbl(long double); +float logf(float); +long double logl(long double); +long lrint(double); +long lrintf(float); +long lrintl(long double); +long lround(double); +long lroundf(float); +long lroundl(long double); +double modf(double, double *); +float modff(float, float *); +long double modfl(long double, long double *); +double nan(const char *); +float nanf(const char *); +long double nanl(const char *); +double nearbyint(double); +float nearbyintf(float); +long double nearbyintl(long double); +double nextafter(double, double); +float nextafterf(float, float); +long double nextafterl(long double, long double); +double nexttoward(double, long double); +float nexttowardf(float, long double); +long double nexttowardl(long double, long double); +double pow(double, double); +float powf(float, float); +long double powl(long double, long double); +double remainder(double, double); +float remainderf(float, float); +long double remainderl(long double, long double); +double remquo(double, double, int *); +float remquof(float, float, int *); +long double remquol(long double, long double, int *); +double rint(double); +float rintf(float); +long double rintl(long double); +double round(double); +float roundf(float); +long double roundl(long double); +double scalbln(double, long); +float scalblnf(float, long); +long double scalblnl(long double, long); +double scalbn(double, int); +float scalbnf(float, int); +long double scalbnl(long double, int); +double sin(double); +float sinf(float); +double sinh(double); +float sinhf(float); +long double sinhl(long double); +long double sinl(long double); +double sqrt(double); +float sqrtf(float); +long double sqrtl(long double); +double tan(double); +float tanf(float); +double tanh(double); +float tanhf(float); +long double tanhl(long double); +long double tanl(long double); +double tgamma(double); +float tgammaf(float); +long double tgammal(long double); +double trunc(double); +float truncf(float); +long double truncl(long double); +double y0(double); +double y1(double); +double yn(int, double); +.fi +.P +.RE +.P +The following external variable shall be defined: +.sp +.RS 4 +.nf + +extern int signgam; +.fi +.P +.RE +.P +The behavior of each of the functions defined in +.IR <math.h> +is specified in the System Interfaces volume of POSIX.1\(hy2017 for all representable values of its input +arguments, except where stated otherwise. Each function shall execute +as if it were a single operation without generating any externally +visible exceptional conditions. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +The FP_CONTRACT pragma can be used to allow (if the state is on) or +disallow (if the state is off) the implementation to contract +expressions. Each pragma can occur either outside external declarations +or preceding all explicit declarations and statements inside a compound +statement. When outside external declarations, the pragma takes effect +from its occurrence until another FP_CONTRACT pragma is encountered, or +until the end of the translation unit. When inside a compound +statement, the pragma takes effect from its occurrence until another +FP_CONTRACT pragma is encountered (including within a nested compound +statement), or until the end of the compound statement; at the end of a +compound statement the state for the pragma is restored to its +condition just before the compound statement. If this pragma is used in +any other context, the behavior is undefined. The default state (on or +off) for the pragma is implementation-defined. +.P +Applications should use FLT_MAX as described in the +.IR <float.h> +header instead of the obsolescent MAXFLOAT. +.P +Note that if FLT_EVAL_METHOD is neither 0 nor 1, then some constants might +not compare equal as expected; for example, \fR(double)M_PI == M_PI\fR +can fail. +.SH RATIONALE +Before the ISO/IEC\ 9899:\|1999 standard, the math library was defined only for the floating +type +.BR double . +All the names formed by appending +.BR 'f' +or +.BR 'l' +to a name in +.IR <math.h> +were reserved to allow for the definition of +.BR float +and +.BR "long double" +libraries; and the ISO/IEC\ 9899:\|1999 standard provides for all three versions of math +functions. +.P +The functions +.IR ecvt (\|), +.IR fcvt (\|), +and +.IR gcvt (\|) +have been dropped from the ISO\ C standard since their capability is available +through +\fIsprintf\fR(). +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<float.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIacos\fR\^(\|)", +.IR "\fIacosh\fR\^(\|)", +.IR "\fIasin\fR\^(\|)", +.IR "\fIasinh\fR\^(\|)", +.IR "\fIatan\fR\^(\|)", +.IR "\fIatan2\fR\^(\|)", +.IR "\fIatanh\fR\^(\|)", +.IR "\fIcbrt\fR\^(\|)", +.IR "\fIceil\fR\^(\|)", +.IR "\fIcopysign\fR\^(\|)", +.IR "\fIcos\fR\^(\|)", +.IR "\fIcosh\fR\^(\|)", +.IR "\fIerf\fR\^(\|)", +.IR "\fIerfc\fR\^(\|)", +.IR "\fIexp\fR\^(\|)", +.IR "\fIexp2\fR\^(\|)", +.IR "\fIexpm1\fR\^(\|)", +.IR "\fIfabs\fR\^(\|)", +.IR "\fIfdim\fR\^(\|)", +.IR "\fIfloor\fR\^(\|)", +.IR "\fIfma\fR\^(\|)", +.IR "\fIfmax\fR\^(\|)", +.IR "\fIfmin\fR\^(\|)", +.IR "\fIfmod\fR\^(\|)", +.IR "\fIfpclassify\fR\^(\|)", +.IR "\fIfrexp\fR\^(\|)", +.IR "\fIhypot\fR\^(\|)", +.IR "\fIilogb\fR\^(\|)", +.IR "\fIisfinite\fR\^(\|)", +.IR "\fIisgreater\fR\^(\|)", +.IR "\fIisgreaterequal\fR\^(\|)", +.IR "\fIisinf\fR\^(\|)", +.IR "\fIisless\fR\^(\|)", +.IR "\fIislessequal\fR\^(\|)", +.IR "\fIislessgreater\fR\^(\|)", +.IR "\fIisnan\fR\^(\|)", +.IR "\fIisnormal\fR\^(\|)", +.IR "\fIisunordered\fR\^(\|)", +.IR "\fIj0\fR\^(\|)", +.IR "\fIldexp\fR\^(\|)", +.IR "\fIlgamma\fR\^(\|)", +.IR "\fIllrint\fR\^(\|)", +.IR "\fIllround\fR\^(\|)", +.IR "\fIlog\fR\^(\|)", +.IR "\fIlog10\fR\^(\|)", +.IR "\fIlog1p\fR\^(\|)", +.IR "\fIlog2\fR\^(\|)", +.IR "\fIlogb\fR\^(\|)", +.IR "\fIlrint\fR\^(\|)", +.IR "\fIlround\fR\^(\|)", +.IR "\fImodf\fR\^(\|)", +.IR "\fInan\fR\^(\|)", +.IR "\fInearbyint\fR\^(\|)", +.IR "\fInextafter\fR\^(\|)", +.IR "\fIpow\fR\^(\|)", +.IR "\fIremainder\fR\^(\|)", +.IR "\fIremquo\fR\^(\|)", +.IR "\fIrint\fR\^(\|)", +.IR "\fIround\fR\^(\|)", +.IR "\fIscalbln\fR\^(\|)", +.IR "\fIsignbit\fR\^(\|)", +.IR "\fIsin\fR\^(\|)", +.IR "\fIsinh\fR\^(\|)", +.IR "\fIsqrt\fR\^(\|)", +.IR "\fItan\fR\^(\|)", +.IR "\fItanh\fR\^(\|)", +.IR "\fItgamma\fR\^(\|)", +.IR "\fItrunc\fR\^(\|)", +.IR "\fIy0\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/monetary.h.0p b/upstream/mageia-cauldron/man0p/monetary.h.0p new file mode 100644 index 00000000..6759aca0 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/monetary.h.0p @@ -0,0 +1,85 @@ +'\" et +.TH monetary.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +monetary.h +\(em monetary types +.SH SYNOPSIS +.LP +.nf +#include <monetary.h> +.fi +.SH DESCRIPTION +The +.IR <monetary.h> +header shall define the +.BR locale_t +type as described in +.IR <locale.h> . +.P +The +.IR <monetary.h> +header shall define the +.BR size_t +type as described in +.IR <stddef.h> . +.P +The +.IR <monetary.h> +header shall define the +.BR ssize_t +type as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided for use with ISO\ C standard +compilers. +.sp +.RS 4 +.nf + +ssize_t strfmon(char *restrict, size_t, const char *restrict, ...); +ssize_t strfmon_l(char *restrict, size_t, locale_t, + const char *restrict, ...); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<locale.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIstrfmon\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/mqueue.h.0p b/upstream/mageia-cauldron/man0p/mqueue.h.0p new file mode 100644 index 00000000..6cdfe633 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/mqueue.h.0p @@ -0,0 +1,142 @@ +'\" et +.TH mqueue.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +mqueue.h +\(em message queues +(\fBREALTIME\fP) +.SH SYNOPSIS +.LP +.nf +#include <mqueue.h> +.fi +.SH DESCRIPTION +The +.IR <mqueue.h> +header shall define the +.BR mqd_t +type, which is used for message queue descriptors. This is not an +array type. +.P +The +.IR <mqueue.h> +header shall define the +.BR pthread_attr_t , +.BR size_t , +and +.BR ssize_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <mqueue.h> +header shall define the +.BR "struct timespec" +structure as described in +.IR <time.h> . +.P +The tag +.BR sigevent +shall be declared as naming an incomplete structure type, the contents +of which are described in the +.IR <signal.h> +header. +.P +The +.IR <mqueue.h> +header shall define the +.BR mq_attr +structure, which is used in getting and setting the attributes of a +message queue. Attributes are initially set when the message queue is +created. An +.BR mq_attr +structure shall have at least the following fields: +.sp +.RS 4 +.nf + +long mq_flags \fRMessage queue flags.\fP +long mq_maxmsg \fRMaximum number of messages.\fP +long mq_msgsize \fRMaximum message size.\fP +long mq_curmsgs \fRNumber of messages currently queued.\fP +.fi +.P +.RE +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int mq_close(mqd_t); +int mq_getattr(mqd_t, struct mq_attr *); +int mq_notify(mqd_t, const struct sigevent *); +mqd_t mq_open(const char *, int, ...); +ssize_t mq_receive(mqd_t, char *, size_t, unsigned *); +int mq_send(mqd_t, const char *, size_t, unsigned); +int mq_setattr(mqd_t, const struct mq_attr *restrict, + struct mq_attr *restrict); +ssize_t mq_timedreceive(mqd_t, char *restrict, size_t, + unsigned *restrict, const struct timespec *restrict); +int mq_timedsend(mqd_t, const char *, size_t, unsigned, + const struct timespec *); +int mq_unlink(const char *); +.fi +.P +.RE +.P +Inclusion of the +.IR <mqueue.h> +header may make visible symbols defined in the headers +.IR <fcntl.h> , +.IR <signal.h> , +and +.IR <time.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<fcntl.h>\fP", +.IR "\fB<signal.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<time.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fImq_close\fR\^(\|)", +.IR "\fImq_getattr\fR\^(\|)", +.IR "\fImq_notify\fR\^(\|)", +.IR "\fImq_open\fR\^(\|)", +.IR "\fImq_receive\fR\^(\|)", +.IR "\fImq_send\fR\^(\|)", +.IR "\fImq_setattr\fR\^(\|)", +.IR "\fImq_unlink\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/ndbm.h.0p b/upstream/mageia-cauldron/man0p/ndbm.h.0p new file mode 100644 index 00000000..6d47eb0d --- /dev/null +++ b/upstream/mageia-cauldron/man0p/ndbm.h.0p @@ -0,0 +1,117 @@ +'\" et +.TH ndbm.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +ndbm.h +\(em definitions for ndbm database operations +.SH SYNOPSIS +.LP +.nf +#include <ndbm.h> +.fi +.SH DESCRIPTION +The +.IR <ndbm.h> +header shall define the +.BR datum +type as a structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +void *dptr \fRA pointer to the application's data.\fR +size_t dsize \fRThe size of the object pointed to by \fIdptr.\fR +.fi +.P +.RE +.P +The +.IR <ndbm.h> +header shall define the +.BR size_t +type as described in +.IR <stddef.h> . +.P +The +.IR <ndbm.h> +header shall define the +.BR DBM +type. +.P +The +.IR <ndbm.h> +header shall define the following symbolic constants as possible +values for the +.IR store_mode +argument to +\fIdbm_store\fR(): +.IP DBM_INSERT 14 +Insertion of new entries only. +.IP DBM_REPLACE 14 +Allow replacing existing entries. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int dbm_clearerr(DBM *); +void dbm_close(DBM *); +int dbm_delete(DBM *, datum); +int dbm_error(DBM *); +datum dbm_fetch(DBM *, datum); +datum dbm_firstkey(DBM *); +datum dbm_nextkey(DBM *); +DBM *dbm_open(const char *, int, mode_t); +int dbm_store(DBM *, datum, datum, int); +.fi +.P +.RE +.P +The +.IR <ndbm.h> +header shall define the +.BR mode_t +type through +.BR typedef , +as described in +.IR <sys/types.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<stddef.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIdbm_clearerr\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/net_if.h.0p b/upstream/mageia-cauldron/man0p/net_if.h.0p new file mode 100644 index 00000000..413ee8dd --- /dev/null +++ b/upstream/mageia-cauldron/man0p/net_if.h.0p @@ -0,0 +1,86 @@ +'\" et +.TH net_if.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +net/if.h +\(em sockets local interfaces +.SH SYNOPSIS +.LP +.nf +#include <net/if.h> +.fi +.SH DESCRIPTION +The +.IR <net/if.h> +header shall define the +.BR if_nameindex +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +unsigned if_index \fRNumeric index of the interface.\fR +char *if_name \fRNull-terminated name of the interface.\fR +.fi +.P +.RE +.P +The +.IR <net/if.h> +header shall define the following symbolic constant for the length of +a buffer containing an interface name (including the terminating NULL +character): +.IP IF_NAMESIZE 12 +Interface name length. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void if_freenameindex(struct if_nameindex *); +char *if_indextoname(unsigned, char *); +struct if_nameindex *if_nameindex(void); +unsigned if_nametoindex(const char *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH "RATIONALE" +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIif_freenameindex\fR\^(\|)", +.IR "\fIif_indextoname\fR\^(\|)", +.IR "\fIif_nameindex\fR\^(\|)", +.IR "\fIif_nametoindex\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/netdb.h.0p b/upstream/mageia-cauldron/man0p/netdb.h.0p new file mode 100644 index 00000000..5c64629e --- /dev/null +++ b/upstream/mageia-cauldron/man0p/netdb.h.0p @@ -0,0 +1,327 @@ +'\" et +.TH netdb.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +netdb.h +\(em definitions for network database operations +.SH SYNOPSIS +.LP +.nf +#include <netdb.h> +.fi +.SH DESCRIPTION +The +.IR <netdb.h> +header may define the +.BR in_port_t +type and the +.BR in_addr_t +type as described in +.IR <netinet/in.h> . +.P +The +.IR <netdb.h> +header shall define the +.BR hostent +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +char *h_name \fROfficial name of the host.\fR +char **h_aliases \fRA pointer to an array of pointers to\fR + \fRalternative host names, terminated by a\fR + \fRnull pointer.\fR +int h_addrtype \fRAddress type.\fR +int h_length \fRThe length, in bytes, of the address.\fR +char **h_addr_list \fRA pointer to an array of pointers to network\fR + \fRaddresses (in network byte order) for the host,\fR + \fRterminated by a null pointer.\fR +.fi +.P +.RE +.P +The +.IR <netdb.h> +header shall define the +.BR netent +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +char *n_name \fROfficial, fully-qualified (including the\fR + \fRdomain) name of the host.\fR +char **n_aliases \fRA pointer to an array of pointers to\fR + \fRalternative network names, terminated by a\fR + \fRnull pointer.\fR +int n_addrtype \fRThe address type of the network.\fR +uint32_t n_net \fRThe network number, in host byte order.\fR +.fi +.P +.RE +.P +The +.IR <netdb.h> +header shall define the +.BR uint32_t +type as described in +.IR <inttypes.h> . +.P +The +.IR <netdb.h> +header shall define the +.BR protoent +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +char *p_name \fROfficial name of the protocol.\fR +char **p_aliases \fRA pointer to an array of pointers to\fR + \fRalternative protocol names, terminated by\fR + \fRa null pointer.\fR +int p_proto \fRThe protocol number.\fR +.fi +.P +.RE +.P +The +.IR <netdb.h> +header shall define the +.BR servent +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +char *s_name \fROfficial name of the service.\fR +char **s_aliases \fRA pointer to an array of pointers to\fR + \fRalternative service names, terminated by\fR + \fRa null pointer.\fR +int s_port \fRA value which, when converted to uint16_t,\fR + \fRyields the port number in network byte order\fR + \fRat which the service resides.\fR +char *s_proto \fRThe name of the protocol to use when\fR + \fRcontacting the service.\fR +.fi +.P +.RE +.P +The +.IR <netdb.h> +header shall define the IPPORT_RESERVED symbolic constant with the +value of the highest reserved Internet port number. +.SS "Address Information Structure" +.P +The +.IR <netdb.h> +header shall define the +.BR addrinfo +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int ai_flags \fRInput flags.\fR +int ai_family \fRAddress family of socket.\fR +int ai_socktype \fRSocket type.\fR +int ai_protocol \fRProtocol of socket.\fR +socklen_t ai_addrlen \fRLength of socket address.\fR +struct sockaddr *ai_addr \fRSocket address of socket.\fR +char *ai_canonname \fRCanonical name of service location.\fR +struct addrinfo *ai_next \fRPointer to next in list.\fR +.fi +.P +.RE +.P +The +.IR <netdb.h> +header shall define the following symbolic constants that evaluate to +bitwise-distinct integer constants for use in the +.IR flags +field of the +.BR addrinfo +structure: +.IP AI_PASSIVE 14 +Socket address is intended for +\fIbind\fR(). +.IP AI_CANONNAME 14 +Request for canonical name. +.IP AI_NUMERICHOST 14 +Return numeric host address as name. +.IP AI_NUMERICSERV 14 +Inhibit service name resolution. +.IP AI_V4MAPPED 14 +If no IPv6 addresses are found, query for IPv4 addresses and return +them to the caller as IPv4-mapped IPv6 addresses. +.IP AI_ALL 14 +Query for both IPv4 and IPv6 addresses. +.IP AI_ADDRCONFIG 14 +Query for IPv4 addresses only when an IPv4 address is configured; +query for IPv6 addresses only when an IPv6 address is configured. +.P +The +.IR <netdb.h> +header shall define the following symbolic constants that evaluate +to bitwise-distinct integer constants for use in the +.IR flags +argument to +\fIgetnameinfo\fR(): +.IP NI_NOFQDN 14 +Only the nodename portion of the FQDN is returned for local hosts. +.IP NI_NUMERICHOST 14 +The numeric form of the node's address is returned instead of its +name. +.IP NI_NAMEREQD 14 +Return an error if the node's name cannot be located in the database. +.IP NI_NUMERICSERV 14 +The numeric form of the service address is returned instead of its name. +.IP NI_NUMERICSCOPE 14 +.br +For IPv6 addresses, the numeric form of the scope identifier is +returned instead of its name. +.IP NI_DGRAM 14 +Indicates that the service is a datagram service (SOCK_DGRAM). +.SS "Address Information Errors" +.P +The +.IR <netdb.h> +header shall define the following symbolic constants for use as +error values for +\fIgetaddrinfo\fR() +and +\fIgetnameinfo\fR(). +The values shall be suitable for use in +.BR #if +preprocessing directives. +.IP EAI_AGAIN 14 +The name could not be resolved at this time. Future attempts may +succeed. +.IP EAI_BADFLAGS 14 +The flags had an invalid value. +.IP EAI_FAIL 14 +A non-recoverable error occurred. +.IP EAI_FAMILY 14 +The address family was not recognized or the address length was invalid +for the specified family. +.IP EAI_MEMORY 14 +There was a memory allocation failure. +.IP EAI_NONAME 14 +The name does not resolve for the supplied parameters. +.RS 14 +.P +NI_NAMEREQD is set and the host's name cannot be located, or both +.IR nodename +and +.IR servname +were null. +.RE +.IP EAI_SERVICE 14 +The service passed was not recognized for the specified socket type. +.IP EAI_SOCKTYPE 14 +The intended socket type was not recognized. +.IP EAI_SYSTEM 14 +A system error occurred. The error code can be found in +.IR errno . +.IP EAI_OVERFLOW 14 +An argument buffer overflowed. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void endhostent(void); +void endnetent(void); +void endprotoent(void); +void endservent(void); +void freeaddrinfo(struct addrinfo *); +const char *gai_strerror(int); +int getaddrinfo(const char *restrict, const char *restrict, + const struct addrinfo *restrict, + struct addrinfo **restrict); +struct hostent *gethostent(void); +int getnameinfo(const struct sockaddr *restrict, socklen_t, + char *restrict, socklen_t, char *restrict, + socklen_t, int); +struct netent *getnetbyaddr(uint32_t, int); +struct netent *getnetbyname(const char *); +struct netent *getnetent(void); +struct protoent *getprotobyname(const char *); +struct protoent *getprotobynumber(int); +struct protoent *getprotoent(void); +struct servent *getservbyname(const char *, const char *); +struct servent *getservbyport(int, const char *); +struct servent *getservent(void); +void sethostent(int); +void setnetent(int); +void setprotoent(int); +void setservent(int); +.fi +.P +.RE +.P +The +.IR <netdb.h> +header shall define the +.BR socklen_t +type through +.BR typedef , +as described in +.IR <sys/socket.h> . +.P +Inclusion of the +.IR <netdb.h> +header may also make visible all symbols from +.IR <netinet/in.h> , +.IR <sys/socket.h> , +and +.IR <inttypes.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH "RATIONALE" +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<inttypes.h>\fP", +.IR "\fB<netinet_in.h>\fP", +.IR "\fB<sys_socket.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIbind\fR\^(\|)", +.IR "\fIendhostent\fR\^(\|)", +.IR "\fIendnetent\fR\^(\|)", +.IR "\fIendprotoent\fR\^(\|)", +.IR "\fIendservent\fR\^(\|)", +.IR "\fIfreeaddrinfo\fR\^(\|)", +.IR "\fIgai_strerror\fR\^(\|)", +.IR "\fIgetnameinfo\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/netinet_in.h.0p b/upstream/mageia-cauldron/man0p/netinet_in.h.0p new file mode 100644 index 00000000..9f9c50aa --- /dev/null +++ b/upstream/mageia-cauldron/man0p/netinet_in.h.0p @@ -0,0 +1,485 @@ +'\" et +.TH netinet_in.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +netinet/in.h +\(em Internet address family +.SH SYNOPSIS +.LP +.nf +#include <netinet/in.h> +.fi +.SH DESCRIPTION +The +.IR <netinet/in.h> +header shall define the following types: +.IP "\fBin_port_t\fP" 10 +Equivalent to the type +.BR uint16_t +as described in +.IR <inttypes.h> . +.IP "\fBin_addr_t\fP" 10 +Equivalent to the type +.BR uint32_t +as described in +.IR <inttypes.h> . +.P +The +.IR <netinet_in.h> +header shall define the +.BR sa_family_t +type as described in +.IR <sys/socket.h> . +.P +The +.IR <netinet_in.h> +header shall define the +.BR uint8_t +and +.BR uint32_t +types as described in +.IR <inttypes.h> . +Inclusion of the +.IR <netinet/in.h> +header may also make visible all symbols from +.IR <inttypes.h> +and +.IR <sys/socket.h> . +.P +The +.IR <netinet/in.h> +header shall define the +.BR in_addr +structure, which shall include at least the following member: +.sp +.RS 4 +.nf + +in_addr_t s_addr +.fi +.P +.RE +.P +The +.IR <netinet/in.h> +header shall define the +.BR sockaddr_in +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +sa_family_t sin_family \fRAF_INET.\fR +in_port_t sin_port \fRPort number.\fR +struct in_addr sin_addr \fRIP address.\fR +.fi +.P +.RE +.P +The +.IR sin_port +and +.IR sin_addr +members shall be in network byte order. +.P +The +.BR sockaddr_in +structure is used to store addresses for the Internet address family. +Pointers to this type shall be cast by applications to +.BR "struct sockaddr *" +for use with socket functions. +.P +The +.IR <netinet/in.h> +header shall define the +.BR in6_addr +structure, which shall include at least the following member: +.sp +.RS 4 +.nf + +uint8_t s6_addr[16] +.fi +.P +.RE +.P +This array is used to contain a 128-bit IPv6 address, stored in network +byte order. +.P +The +.IR <netinet/in.h> +header shall define the +.BR sockaddr_in6 +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +sa_family_t sin6_family \fRAF_INET6.\fR +in_port_t sin6_port \fRPort number.\fR +uint32_t sin6_flowinfo \fRIPv6 traffic class and flow information.\fR +struct in6_addr sin6_addr \fRIPv6 address.\fR +uint32_t sin6_scope_id \fRSet of interfaces for a scope.\fR +.fi +.P +.RE +.P +The +.IR sin6_port +and +.IR sin6_addr +members shall be in network byte order. +.P +Prior to calling a function in this standard which reads values from a +.BR sockaddr_in6 +structure (for example, +\fIbind\fR() +or +\fIconnect\fR()), +the application shall ensure that all members of the structure, +including any additional non-standard members, if any, are initialized. +If the +.BR sockaddr_in6 +structure has a non-standard member, and that member has a value +other than the value that would result from default initialization, +the behavior of any function in this standard that reads values +from the +.BR sockaddr_in6 +structure is implementation-defined. All functions in this standard +that return data in a +.BR sockaddr_in6 +structure (for example, +\fIgetaddrinfo\fR() +or +\fIaccept\fR()) +shall initialize the structure in a way that meets the above +requirements, and shall ensure that each non-standard member, +if any, has a value that produces the same behavior as default +initialization would in all functions in this standard which +read values from a +.BR sockaddr_in6 +structure. +.P +The +.IR sin6_scope_id +field is a 32-bit integer that identifies a set of interfaces as +appropriate for the scope of the address carried in the +.IR sin6_addr +field. For a link scope +.IR sin6_addr , +the application shall ensure that +.IR sin6_scope_id +is a link index. For a site scope +.IR sin6_addr , +the application shall ensure that +.IR sin6_scope_id +is a site index. The mapping of +.IR sin6_scope_id +to an interface or set of interfaces is implementation-defined. +.P +The +.IR <netinet/in.h> +header shall declare the following external variable: +.sp +.RS 4 +.nf + +const struct in6_addr in6addr_any +.fi +.P +.RE +.P +This variable is initialized by the system to contain the wildcard IPv6 +address. The +.IR <netinet/in.h> +header also defines the IN6ADDR_ANY_INIT macro. This macro must be +constant at compile time and can be used to initialize a variable of +type +.BR "struct in6_addr" +to the IPv6 wildcard address. +.P +The +.IR <netinet/in.h> +header shall declare the following external variable: +.sp +.RS 4 +.nf + +const struct in6_addr in6addr_loopback +.fi +.P +.RE +.P +This variable is initialized by the system to contain the loopback IPv6 +address. The +.IR <netinet/in.h> +header also defines the IN6ADDR_LOOPBACK_INIT macro. This macro must be +constant at compile time and can be used to initialize a variable of +type +.BR "struct in6_addr" +to the IPv6 loopback address. +.P +The +.IR <netinet/in.h> +header shall define the +.BR ipv6_mreq +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +struct in6_addr ipv6mr_multiaddr \fRIPv6 multicast address.\fR +unsigned ipv6mr_interface \fRInterface index.\fR +.fi +.P +.RE +.P +The +.IR <netinet/in.h> +header shall define the following symbolic constants for use as +values of the +.IR level +argument of +\fIgetsockopt\fR() +and +\fIsetsockopt\fR(): +.IP IPPROTO_IP 16 +Internet protocol. +.IP IPPROTO_IPV6 16 +Internet Protocol Version 6. +.IP IPPROTO_ICMP 16 +Control message protocol. +.IP IPPROTO_RAW 16 +Raw IP Packets Protocol. +.IP IPPROTO_TCP 16 +Transmission control protocol. +.IP IPPROTO_UDP 16 +User datagram protocol. +.P +The +.IR <netinet/in.h> +header shall define the following symbolic constant for use as a +local address in the structure passed to +\fIbind\fR(): +.IP INADDR_ANY 16 +IPv4 wildcard address. +.P +The +.IR <netinet/in.h> +header shall define the following symbolic constant for use as a +destination address in the structures passed to +\fIconnect\fR(), +\fIsendmsg\fR(), +and +\fIsendto\fR(): +.IP INADDR_BROADCAST 16 +IPv4 broadcast address. +.P +The +.IR <netinet/in.h> +header shall define the following symbolic constant, with the value +specified, to help applications declare buffers of the proper size +to store IPv4 addresses in string form: +.IP INET_ADDRSTRLEN 16 +16. Length of the string form for IP. +.P +The +\fIhtonl\fR(), +\fIhtons\fR(), +\fIntohl\fR(), +and +\fIntohs\fR() +functions shall be available as described in +.IR <arpa/inet.h> . +Inclusion of the +.IR <netinet/in.h> +header may also make visible all symbols from +.IR <arpa/inet.h> . +.P +The +.IR <netinet/in.h> +header shall define the following symbolic constant, with the value +specified, to help applications declare buffers of the proper size +to store IPv6 addresses in string form: +.IP INET6_ADDRSTRLEN 16 +46. Length of the string form for IPv6. +.br +.P +The +.IR <netinet/in.h> +header shall define the following symbolic constants, with distinct +integer values, for use in the +.IR option_name +argument in the +\fIgetsockopt\fR() +or +\fIsetsockopt\fR() +functions at protocol level IPPROTO_IPV6: +.IP IPV6_JOIN_GROUP 16 +Join a multicast group. +.IP IPV6_LEAVE_GROUP 16 +Quit a multicast group. +.IP IPV6_MULTICAST_HOPS 16 +.br +Multicast hop limit. +.IP IPV6_MULTICAST_IF 16 +Interface to use for outgoing multicast packets. +.IP IPV6_MULTICAST_LOOP 16 +.br +Multicast packets are delivered back to the local application. +.IP IPV6_UNICAST_HOPS 16 +Unicast hop limit. +.IP IPV6_V6ONLY 16 +Restrict AF_INET6 socket to IPv6 communications only. +.P +The +.IR <netinet/in.h> +header shall define the following macros that test for special IPv6 +addresses. Each macro is of type +.BR int +and takes a single argument of type +.BR "const struct in6_addr *" : +.IP IN6_IS_ADDR_UNSPECIFIED 6 +.br +Unspecified address. +.IP IN6_IS_ADDR_LOOPBACK 6 +.br +Loopback address. +.IP IN6_IS_ADDR_MULTICAST 6 +.br +Multicast address. +.IP IN6_IS_ADDR_LINKLOCAL 6 +.br +Unicast link-local address. +.IP IN6_IS_ADDR_SITELOCAL 6 +.br +Unicast site-local address. +.IP IN6_IS_ADDR_V4MAPPED 6 +.br +IPv4 mapped address. +.IP IN6_IS_ADDR_V4COMPAT 6 +.br +IPv4-compatible address. +.IP IN6_IS_ADDR_MC_NODELOCAL 6 +.br +Multicast node-local address. +.IP IN6_IS_ADDR_MC_LINKLOCAL 6 +.br +Multicast link-local address. +.IP IN6_IS_ADDR_MC_SITELOCAL 6 +.br +Multicast site-local address. +.IP IN6_IS_ADDR_MC_ORGLOCAL 6 +.br +Multicast organization-local address. +.IP IN6_IS_ADDR_MC_GLOBAL 6 +.br +Multicast global address. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +Although applications are required to initialize all members +(including any non-standard ones) of a +.BR sockaddr_in6 +structure, the same is not required for the +.BR sockaddr_in +structure, since historically many applications only initialized +the standard members. Despite this, applications are encouraged +to initialize +.BR sockaddr_in +structures in a manner similar to the required initialization of +.BR sockaddr_in6 +structures. +.P +Although it is common practice to initialize a +.BR sockaddr_in6 +structure using: +.sp +.RS 4 +.nf + +struct sockaddr_in6 sa; +memset(&sa, 0, sizeof sa); +.fi +.P +.RE +.P +this method is not portable according to this standard, because the +structure can contain pointer or floating-point members that are +not required to have an all-bits-zero representation after default +initialization. Portable methods make use of default initialization; +for example: +.sp +.RS 4 +.nf + +struct sockaddr_in6 sa = { 0 }; +.fi +.P +.RE +.P +or: +.sp +.RS 4 +.nf + +static struct sockaddr_in6 sa_init; +struct sockaddr_in6 sa = sa_init; +.fi +.P +.RE +.P +A future version of this standard may require that a pointer object +with an all-bits-zero representation is a null pointer, and that +.BR sockaddr_in6 +does not have any floating-point members if a floating-point object +with an all-bits-zero representation does not have the value 0.0. +.SH "RATIONALE" +The INADDR_ANY and INADDR_BROADCAST values are byte-order-neutral +and thus their byte order is not specified. Many implementations +have additional constants as extensions, such as INADDR_LOOPBACK, +that are not byte-order-neutral. Traditionally, these constants +are in host byte order, requiring the use of +\fIhtonl\fR() +when using them in a +.BR sockaddr_in +structure. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "Section 4.10" ", " "Host and Network Byte Orders", +.IR "\fB<arpa_inet.h>\fP", +.IR "\fB<inttypes.h>\fP", +.IR "\fB<sys_socket.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIconnect\fR\^(\|)", +.IR "\fIgetsockopt\fR\^(\|)", +.IR "\fIhtonl\fR\^(\|)", +.IR "\fIsendmsg\fR\^(\|)", +.IR "\fIsendto\fR\^(\|)", +.IR "\fIsetsockopt\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/netinet_tcp.h.0p b/upstream/mageia-cauldron/man0p/netinet_tcp.h.0p new file mode 100644 index 00000000..418fb032 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/netinet_tcp.h.0p @@ -0,0 +1,61 @@ +'\" et +.TH netinet_tcp.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +netinet/tcp.h +\(em definitions for the Internet Transmission Control Protocol (TCP) +.SH SYNOPSIS +.LP +.nf +#include <netinet/tcp.h> +.fi +.SH DESCRIPTION +The +.IR <netinet/tcp.h> +header shall define the following symbolic constant for use as a +socket option at the IPPROTO_TCP level: +.IP TCP_NODELAY 12 +Avoid coalescing of small segments. +.P +The implementation need not allow the value of the option to be set via +\fIsetsockopt\fR() +or retrieved via +\fIgetsockopt\fR(). +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH "RATIONALE" +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_socket.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIgetsockopt\fR\^(\|)", +.IR "\fIsetsockopt\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/nl_types.h.0p b/upstream/mageia-cauldron/man0p/nl_types.h.0p new file mode 100644 index 00000000..3fcec0a6 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/nl_types.h.0p @@ -0,0 +1,111 @@ +'\" et +.TH nl_types.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +nl_types.h +\(em data types +.SH SYNOPSIS +.LP +.nf +#include <nl_types.h> +.fi +.SH DESCRIPTION +The +.IR <nl_types.h> +header shall define at least the following types: +.IP "\fBnl_catd\fP" 14 +Used by the message catalog functions +\fIcatopen\fR(), +\fIcatgets\fR(), +and +\fIcatclose\fR() +to identify a catalog descriptor. +.IP "\fBnl_item\fP" 14 +Used by +\fInl_langinfo\fR() +to identify items of +.IR langinfo +data. Values of objects of type +.BR nl_item +are defined in +.IR <langinfo.h> . +.P +The +.IR <nl_types.h> +header shall define at least the following symbolic constants: +.IP NL_SETD 14 +Used by +.IR gencat +when no $\fIset\fP directive is specified in a message text source +file. This constant can be passed as the value of +.IR set_id +on subsequent calls to +\fIcatgets\fR() +(that is, to retrieve messages from the default message set). The +value of NL_SETD is implementation-defined. +.IP NL_CAT_LOCALE 14 +Value that must be passed as the +.IR oflag +argument to +\fIcatopen\fR() +to ensure that message catalog selection depends on the +.IR LC_MESSAGES +locale category, rather than directly on the +.IR LANG +environment variable. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int catclose(nl_catd); +char *catgets(nl_catd, int, int, const char *); +nl_catd catopen(const char *, int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<langinfo.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIcatclose\fR\^(\|)", +.IR "\fIcatgets\fR\^(\|)", +.IR "\fIcatopen\fR\^(\|)", +.IR "\fInl_langinfo\fR\^(\|)" +.P +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "\fIgencat\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/poll.h.0p b/upstream/mageia-cauldron/man0p/poll.h.0p new file mode 100644 index 00000000..773b20a7 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/poll.h.0p @@ -0,0 +1,137 @@ +'\" et +.TH poll.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +poll.h +\(em definitions for the poll(\|) function +.SH SYNOPSIS +.LP +.nf +#include <poll.h> +.fi +.SH DESCRIPTION +The +.IR <poll.h> +header shall define the +.BR pollfd +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int fd \fRThe following descriptor being polled.\fP +short events \fRThe input event flags (see below).\fP +short revents \fRThe output event flags (see below).\fP +.fi +.P +.RE +.P +The +.IR <poll.h> +header shall define the following type through +.BR typedef : +.IP "\fBnfds_t\fR" 14 +An unsigned integer type used for the number of file descriptors. +.P +The implementation shall support one or more programming environments +in which the width of +.BR nfds_t +is no greater than the width of type +.BR long . +The names of these programming environments can be obtained using the +\fIconfstr\fR() +function or the +.IR getconf +utility. +.P +The +.IR <poll.h> +header shall define the following symbolic constants, zero or more of +which may be OR'ed together to form the +.IR events +or +.IR revents +members in the +.BR pollfd +structure: +.IP POLLIN 14 +Data other than high-priority data may be read without blocking. +.IP POLLRDNORM 14 +Normal data may be read without blocking. +.IP POLLRDBAND 14 +Priority data may be read without blocking. +.IP POLLPRI 14 +High priority data may be read without blocking. +.IP POLLOUT 14 +Normal data may be written without blocking. +.IP POLLWRNORM 14 +Equivalent to POLLOUT. +.IP POLLWRBAND 14 +Priority data may be written. +.IP POLLERR 14 +An error has occurred (\c +.IR revents +only). +.IP POLLHUP 14 +Device has been disconnected (\c +.IR revents +only). +.IP POLLNVAL 14 +Invalid +.IR fd +member (\c +.IR revents +only). +.P +The significance and semantics of normal, priority, and high-priority +data are file and device-specific. +.P +The following shall be declared as a function and may also be defined +as a macro. A function prototype shall be provided. +.sp +.RS 4 +.nf + +int poll(struct pollfd [], nfds_t, int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIconfstr\fR\^(\|)", +.IR "\fIpoll\fR\^(\|)" +.P +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "\fIgetconf\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/pthread.h.0p b/upstream/mageia-cauldron/man0p/pthread.h.0p new file mode 100644 index 00000000..6ec8ed3d --- /dev/null +++ b/upstream/mageia-cauldron/man0p/pthread.h.0p @@ -0,0 +1,333 @@ +'\" et +.TH pthread.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +pthread.h +\(em threads +.SH SYNOPSIS +.LP +.nf +#include <pthread.h> +.fi +.SH DESCRIPTION +The +.IR <pthread.h> +header shall define the following symbolic constants: +.P +.nf +PTHREAD_BARRIER_SERIAL_THREAD +PTHREAD_CANCEL_ASYNCHRONOUS +PTHREAD_CANCEL_ENABLE +PTHREAD_CANCEL_DEFERRED +PTHREAD_CANCEL_DISABLE +PTHREAD_CANCELED +PTHREAD_CREATE_DETACHED +PTHREAD_CREATE_JOINABLE +PTHREAD_EXPLICIT_SCHED +PTHREAD_INHERIT_SCHED +PTHREAD_MUTEX_DEFAULT +PTHREAD_MUTEX_ERRORCHECK +PTHREAD_MUTEX_NORMAL +PTHREAD_MUTEX_RECURSIVE +PTHREAD_MUTEX_ROBUST +PTHREAD_MUTEX_STALLED +PTHREAD_ONCE_INIT +PTHREAD_PRIO_INHERIT +PTHREAD_PRIO_NONE +PTHREAD_PRIO_PROTECT +PTHREAD_PROCESS_SHARED +PTHREAD_PROCESS_PRIVATE +PTHREAD_SCOPE_PROCESS +PTHREAD_SCOPE_SYSTEM +.fi +.P +The +.IR <pthread.h> +header shall define the following compile-time constant +expressions valid as initializers for the following types: +.TS +tab(!) center box; +cB | cB +l | lB. +Name!Initializer for Type +_ +PTHREAD_COND_INITIALIZER!pthread_cond_t +PTHREAD_MUTEX_INITIALIZER!pthread_mutex_t +PTHREAD_RWLOCK_INITIALIZER!pthread_rwlock_t +.TE +.P +The +.IR <pthread.h> +header shall define the +.BR pthread_attr_t , +.BR pthread_barrier_t , +.BR pthread_barrierattr_t , +.BR pthread_cond_t , +.BR pthread_condattr_t , +.BR pthread_key_t , +.BR pthread_mutex_t , +.BR pthread_mutexattr_t , +.BR pthread_once_t , +.BR pthread_rwlock_t , +.BR pthread_rwlockattr_t , +.BR pthread_spinlock_t , +and +.BR pthread_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int pthread_atfork(void (*)(void), void (*)(void), + void(*)(void)); +int pthread_attr_destroy(pthread_attr_t *); +int pthread_attr_getdetachstate(const pthread_attr_t *, int *); +int pthread_attr_getguardsize(const pthread_attr_t *restrict, + size_t *restrict); +int pthread_attr_getinheritsched(const pthread_attr_t *restrict, + int *restrict); +int pthread_attr_getschedparam(const pthread_attr_t *restrict, + struct sched_param *restrict); +int pthread_attr_getschedpolicy(const pthread_attr_t *restrict, + int *restrict); +int pthread_attr_getscope(const pthread_attr_t *restrict, + int *restrict); +int pthread_attr_getstack(const pthread_attr_t *restrict, + void **restrict, size_t *restrict); +int pthread_attr_getstacksize(const pthread_attr_t *restrict, + size_t *restrict); +int pthread_attr_init(pthread_attr_t *); +int pthread_attr_setdetachstate(pthread_attr_t *, int); +int pthread_attr_setguardsize(pthread_attr_t *, size_t); +int pthread_attr_setinheritsched(pthread_attr_t *, int); +int pthread_attr_setschedparam(pthread_attr_t *restrict, + const struct sched_param *restrict); +int pthread_attr_setschedpolicy(pthread_attr_t *, int); +int pthread_attr_setscope(pthread_attr_t *, int); +int pthread_attr_setstack(pthread_attr_t *, void *, size_t); +int pthread_attr_setstacksize(pthread_attr_t *, size_t); +int pthread_barrier_destroy(pthread_barrier_t *); +int pthread_barrier_init(pthread_barrier_t *restrict, + const pthread_barrierattr_t *restrict, unsigned); +int pthread_barrier_wait(pthread_barrier_t *); +int pthread_barrierattr_destroy(pthread_barrierattr_t *); +int pthread_barrierattr_getpshared( + const pthread_barrierattr_t *restrict, int *restrict); +int pthread_barrierattr_init(pthread_barrierattr_t *); +int pthread_barrierattr_setpshared(pthread_barrierattr_t *, int); +int pthread_cancel(pthread_t); +int pthread_cond_broadcast(pthread_cond_t *); +int pthread_cond_destroy(pthread_cond_t *); +int pthread_cond_init(pthread_cond_t *restrict, + const pthread_condattr_t *restrict); +int pthread_cond_signal(pthread_cond_t *); +int pthread_cond_timedwait(pthread_cond_t *restrict, + pthread_mutex_t *restrict, const struct timespec *restrict); +int pthread_cond_wait(pthread_cond_t *restrict, + pthread_mutex_t *restrict); +int pthread_condattr_destroy(pthread_condattr_t *); +int pthread_condattr_getclock(const pthread_condattr_t *restrict, + clockid_t *restrict); +int pthread_condattr_getpshared(const pthread_condattr_t *restrict, + int *restrict); +int pthread_condattr_init(pthread_condattr_t *); +int pthread_condattr_setclock(pthread_condattr_t *, clockid_t); +int pthread_condattr_setpshared(pthread_condattr_t *, int); +int pthread_create(pthread_t *restrict, const pthread_attr_t *restrict, + void *(*)(void*), void *restrict); +int pthread_detach(pthread_t); +int pthread_equal(pthread_t, pthread_t); +void pthread_exit(void *); +int pthread_getconcurrency(void); +int pthread_getcpuclockid(pthread_t, clockid_t *); +int pthread_getschedparam(pthread_t, int *restrict, + struct sched_param *restrict); +void *pthread_getspecific(pthread_key_t); +int pthread_join(pthread_t, void **); +int pthread_key_create(pthread_key_t *, void (*)(void*)); +int pthread_key_delete(pthread_key_t); +int pthread_mutex_consistent(pthread_mutex_t *); +int pthread_mutex_destroy(pthread_mutex_t *); +int pthread_mutex_getprioceiling(const pthread_mutex_t *restrict, + int *restrict); +int pthread_mutex_init(pthread_mutex_t *restrict, + const pthread_mutexattr_t *restrict); +int pthread_mutex_lock(pthread_mutex_t *); +int pthread_mutex_setprioceiling(pthread_mutex_t *restrict, int, + int *restrict); +int pthread_mutex_timedlock(pthread_mutex_t *restrict, + const struct timespec *restrict); +int pthread_mutex_trylock(pthread_mutex_t *); +int pthread_mutex_unlock(pthread_mutex_t *); +int pthread_mutexattr_destroy(pthread_mutexattr_t *); +int pthread_mutexattr_getprioceiling( + const pthread_mutexattr_t *restrict, int *restrict); +int pthread_mutexattr_getprotocol(const pthread_mutexattr_t *restrict, + int *restrict); +int pthread_mutexattr_getpshared(const pthread_mutexattr_t *restrict, + int *restrict); +int pthread_mutexattr_getrobust(const pthread_mutexattr_t *restrict, + int *restrict); +int pthread_mutexattr_gettype(const pthread_mutexattr_t *restrict, + int *restrict); +int pthread_mutexattr_init(pthread_mutexattr_t *); +int pthread_mutexattr_setprioceiling(pthread_mutexattr_t *, int); +int pthread_mutexattr_setprotocol(pthread_mutexattr_t *, int); +int pthread_mutexattr_setpshared(pthread_mutexattr_t *, int); +int pthread_mutexattr_setrobust(pthread_mutexattr_t *, int); +int pthread_mutexattr_settype(pthread_mutexattr_t *, int); +int pthread_once(pthread_once_t *, void (*)(void)); +int pthread_rwlock_destroy(pthread_rwlock_t *); +int pthread_rwlock_init(pthread_rwlock_t *restrict, + const pthread_rwlockattr_t *restrict); +int pthread_rwlock_rdlock(pthread_rwlock_t *); +int pthread_rwlock_timedrdlock(pthread_rwlock_t *restrict, + const struct timespec *restrict); +int pthread_rwlock_timedwrlock(pthread_rwlock_t *restrict, + const struct timespec *restrict); +int pthread_rwlock_tryrdlock(pthread_rwlock_t *); +int pthread_rwlock_trywrlock(pthread_rwlock_t *); +int pthread_rwlock_unlock(pthread_rwlock_t *); +int pthread_rwlock_wrlock(pthread_rwlock_t *); +int pthread_rwlockattr_destroy(pthread_rwlockattr_t *); +int pthread_rwlockattr_getpshared( + const pthread_rwlockattr_t *restrict, int *restrict); +int pthread_rwlockattr_init(pthread_rwlockattr_t *); +int pthread_rwlockattr_setpshared(pthread_rwlockattr_t *, int); +pthread_t + pthread_self(void); +int pthread_setcancelstate(int, int *); +int pthread_setcanceltype(int, int *); +int pthread_setconcurrency(int); +int pthread_setschedparam(pthread_t, int, + const struct sched_param *); +int pthread_setschedprio(pthread_t, int); +int pthread_setspecific(pthread_key_t, const void *); +int pthread_spin_destroy(pthread_spinlock_t *); +int pthread_spin_init(pthread_spinlock_t *, int); +int pthread_spin_lock(pthread_spinlock_t *); +int pthread_spin_trylock(pthread_spinlock_t *); +int pthread_spin_unlock(pthread_spinlock_t *); +void pthread_testcancel(void); +.fi +.P +.RE +.P +The following may be declared as functions, or defined as macros, or both. +If functions are declared, function prototypes shall be provided. +.sp +.RS +\fIpthread_cleanup_pop\fR() +\fIpthread_cleanup_push\fR() +.RE +.P +Inclusion of the +.IR <pthread.h> +header shall make symbols defined in the headers +.IR <sched.h> +and +.IR <time.h> +visible. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sched.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<time.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIpthread_atfork\fR\^(\|)", +.IR "\fIpthread_attr_destroy\fR\^(\|)", +.IR "\fIpthread_attr_getdetachstate\fR\^(\|)", +.IR "\fIpthread_attr_getguardsize\fR\^(\|)", +.IR "\fIpthread_attr_getinheritsched\fR\^(\|)", +.IR "\fIpthread_attr_getschedparam\fR\^(\|)", +.IR "\fIpthread_attr_getschedpolicy\fR\^(\|)", +.IR "\fIpthread_attr_getscope\fR\^(\|)", +.IR "\fIpthread_attr_getstack\fR\^(\|)", +.IR "\fIpthread_attr_getstacksize\fR\^(\|)", +.IR "\fIpthread_barrier_destroy\fR\^(\|)", +.IR "\fIpthread_barrier_wait\fR\^(\|)", +.IR "\fIpthread_barrierattr_destroy\fR\^(\|)", +.IR "\fIpthread_barrierattr_getpshared\fR\^(\|)", +.IR "\fIpthread_cancel\fR\^(\|)", +.IR "\fIpthread_cleanup_pop\fR\^(\|)", +.IR "\fIpthread_cond_broadcast\fR\^(\|)", +.IR "\fIpthread_cond_destroy\fR\^(\|)", +.IR "\fIpthread_cond_timedwait\fR\^(\|)", +.IR "\fIpthread_condattr_destroy\fR\^(\|)", +.IR "\fIpthread_condattr_getclock\fR\^(\|)", +.IR "\fIpthread_condattr_getpshared\fR\^(\|)", +.IR "\fIpthread_create\fR\^(\|)", +.IR "\fIpthread_detach\fR\^(\|)", +.IR "\fIpthread_equal\fR\^(\|)", +.IR "\fIpthread_exit\fR\^(\|)", +.IR "\fIpthread_getconcurrency\fR\^(\|)", +.IR "\fIpthread_getcpuclockid\fR\^(\|)", +.IR "\fIpthread_getschedparam\fR\^(\|)", +.IR "\fIpthread_getspecific\fR\^(\|)", +.IR "\fIpthread_join\fR\^(\|)", +.IR "\fIpthread_key_create\fR\^(\|)", +.IR "\fIpthread_key_delete\fR\^(\|)", +.IR "\fIpthread_mutex_consistent\fR\^(\|)", +.IR "\fIpthread_mutex_destroy\fR\^(\|)", +.IR "\fIpthread_mutex_getprioceiling\fR\^(\|)", +.IR "\fIpthread_mutex_lock\fR\^(\|)", +.IR "\fIpthread_mutex_timedlock\fR\^(\|)", +.IR "\fIpthread_mutexattr_destroy\fR\^(\|)", +.IR "\fIpthread_mutexattr_getprioceiling\fR\^(\|)", +.IR "\fIpthread_mutexattr_getprotocol\fR\^(\|)", +.IR "\fIpthread_mutexattr_getpshared\fR\^(\|)", +.IR "\fIpthread_mutexattr_getrobust\fR\^(\|)", +.IR "\fIpthread_mutexattr_gettype\fR\^(\|)", +.IR "\fIpthread_once\fR\^(\|)", +.IR "\fIpthread_rwlock_destroy\fR\^(\|)", +.IR "\fIpthread_rwlock_rdlock\fR\^(\|)", +.IR "\fIpthread_rwlock_timedrdlock\fR\^(\|)", +.IR "\fIpthread_rwlock_timedwrlock\fR\^(\|)", +.IR "\fIpthread_rwlock_trywrlock\fR\^(\|)", +.IR "\fIpthread_rwlock_unlock\fR\^(\|)", +.IR "\fIpthread_rwlockattr_destroy\fR\^(\|)", +.IR "\fIpthread_rwlockattr_getpshared\fR\^(\|)", +.IR "\fIpthread_self\fR\^(\|)", +.IR "\fIpthread_setcancelstate\fR\^(\|)", +.IR "\fIpthread_setschedprio\fR\^(\|)", +.IR "\fIpthread_spin_destroy\fR\^(\|)", +.IR "\fIpthread_spin_lock\fR\^(\|)", +.IR "\fIpthread_spin_unlock\fR\^(\|)" +.ad b +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/pwd.h.0p b/upstream/mageia-cauldron/man0p/pwd.h.0p new file mode 100644 index 00000000..23e4605c --- /dev/null +++ b/upstream/mageia-cauldron/man0p/pwd.h.0p @@ -0,0 +1,97 @@ +'\" et +.TH pwd.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +pwd.h +\(em password structure +.SH SYNOPSIS +.LP +.nf +#include <pwd.h> +.fi +.SH DESCRIPTION +The +.IR <pwd.h> +header shall define the +.BR "struct passwd" , +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +char *pw_name \fRUser's login name.\fP +uid_t pw_uid \fRNumerical user ID.\fP +gid_t pw_gid \fRNumerical group ID.\fP +char *pw_dir \fRInitial working directory.\fP +char *pw_shell \fRProgram to use as shell.\fP +.fi +.P +.RE +.P +The +.IR <pwd.h> +header shall define the +.BR gid_t , +.BR uid_t , +and +.BR size_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void endpwent(void); +struct passwd *getpwent(void); +struct passwd *getpwnam(const char *); +int getpwnam_r(const char *, struct passwd *, char *, + size_t, struct passwd **); +struct passwd *getpwuid(uid_t); +int getpwuid_r(uid_t, struct passwd *, char *, + size_t, struct passwd **); +void setpwent(void); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIendpwent\fR\^(\|)", +.IR "\fIgetpwnam\fR\^(\|)", +.IR "\fIgetpwuid\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/regex.h.0p b/upstream/mageia-cauldron/man0p/regex.h.0p new file mode 100644 index 00000000..053928cd --- /dev/null +++ b/upstream/mageia-cauldron/man0p/regex.h.0p @@ -0,0 +1,211 @@ +'\" et +.TH regex.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +regex.h +\(em regular expression matching types +.SH SYNOPSIS +.LP +.nf +#include <regex.h> +.fi +.SH DESCRIPTION +The +.IR <regex.h> +header shall define the structures and symbolic constants used by the +\fIregcomp\fR(), +\fIregexec\fR(), +\fIregerror\fR(), +and +\fIregfree\fR() +functions. +.P +The +.IR <regex.h> +header shall define the +.BR regex_t +structure type, which shall include at least the following member: +.sp +.RS 4 +.nf + +size_t re_nsub \fRNumber of parenthesized subexpressions.\fR +.fi +.P +.RE +.P +The +.IR <regex.h> +header shall define the +.BR size_t +type as described in +.IR <sys/types.h> . +.P +The +.IR <regex.h> +header shall define the +.BR regoff_t +type as a signed integer type that can hold +the largest value that can be stored in either a +.BR ptrdiff_t +type or a +.BR ssize_t +type. +.P +The +.IR <regex.h> +header shall define the +.BR regmatch_t +structure type, which shall include at least the following members: +.sp +.RS 4 +.nf + +regoff_t rm_so \fRByte offset from start of string\fR + \fRto start of substring.\fR +regoff_t rm_eo \fRByte offset from start of string of the\fR + \fRfirst character after the end of substring.\fR +.fi +.P +.RE +.P +The +.IR <regex.h> +header shall define the following symbolic constants for the +.IR cflags +parameter to the +\fIregcomp\fR() +function: +.IP REG_EXTENDED 14 +Use Extended Regular Expressions. +.IP REG_ICASE 14 +Ignore case in match. +.IP REG_NOSUB 14 +Report only success or fail in +\fIregexec\fR(). +.IP REG_NEWLINE 14 +Change the handling of +<newline>. +.P +The +.IR <regex.h> +header shall define the following symbolic constants for the +.IR eflags +parameter to the +\fIregexec\fR() +function: +.IP REG_NOTBOL 14 +The +<circumflex> +character (\c +.BR '\(ha' ), +when taken as a special character, does not match the beginning of +.IR string . +.IP REG_NOTEOL 14 +The +<dollar-sign> +(\c +.BR '$' ), +when taken as a special character, does not match the end of +.IR string . +.P +The +.IR <regex.h> +header shall define the following symbolic constants as error +return values: +.IP REG_NOMATCH 14 +\fIregexec\fR() +failed to match. +.IP REG_BADPAT 14 +Invalid regular expression. +.IP REG_ECOLLATE 14 +Invalid collating element referenced. +.IP REG_ECTYPE 14 +Invalid character class type referenced. +.IP REG_EESCAPE 14 +Trailing +<backslash> +character in pattern. +.IP REG_ESUBREG 14 +Number in \e\fIdigit\fP invalid or in error. +.IP REG_EBRACK 14 +.BR \(dq[]\(dq +imbalance. +.IP REG_EPAREN 14 +.BR \(dq\e(\e)\(dq +or +.BR \(dq()\(dq +imbalance. +.IP REG_EBRACE 14 +.BR \(dq\e{\e}\(dq +imbalance. +.IP REG_BADBR 14 +Content of +.BR \(dq\e{\e}\(dq +invalid: not a number, number too large, more than two numbers, first +larger than second. +.IP REG_ERANGE 14 +Invalid endpoint in range expression. +.IP REG_ESPACE 14 +Out of memory. +.IP REG_BADRPT 14 +.BR '?' , +.BR '*' , +or +.BR '+' +not preceded by valid regular expression. +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int regcomp(regex_t *restrict, const char *restrict, int); +size_t regerror(int, const regex_t *restrict, char *restrict, size_t); +int regexec(const regex_t *restrict, const char *restrict, size_t, + regmatch_t [restrict], int); +void regfree(regex_t *); +.fi +.P +.RE +.P +The implementation may define additional macros or constants using +names beginning with REG_. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIregcomp\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sched.h.0p b/upstream/mageia-cauldron/man0p/sched.h.0p new file mode 100644 index 00000000..6cc2562e --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sched.h.0p @@ -0,0 +1,157 @@ +'\" et +.TH sched.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sched.h +\(em execution scheduling +.SH SYNOPSIS +.LP +.nf +#include <sched.h> +.fi +.SH DESCRIPTION +The +.IR <sched.h> +header shall define the +.BR pid_t +type as described in +.IR <sys/types.h> . +.P +The +.IR <sched.h> +header shall define the +.BR time_t +type as described in +.IR <sys/types.h> . +.P +The +.IR <sched.h> +header shall define the +.BR timespec +structure as described in +.IR <time.h> . +.P +The +.IR <sched.h> +header shall define the +.BR sched_param +structure, which shall include the scheduling parameters required for +implementation of each supported scheduling policy. This structure +shall include at least the following member: +.sp +.RS 4 +.nf + +int sched_priority \fRProcess or thread execution scheduling priority.\fP +.fi +.P +.RE +.P +The +.BR sched_param +structure defined in +.IR <sched.h> +shall include the following members in addition to those specified +above: +.sp +.RS 4 +.nf + +int sched_ss_low_priority \fRLow scheduling priority for\fR + \fRsporadic server.\fR +struct timespec sched_ss_repl_period \fRReplenishment period for\fR + \fRsporadic server.\fR +struct timespec sched_ss_init_budget \fRInitial budget for sporadic server.\fR +int sched_ss_max_repl \fRMaximum pending replenishments for\fR + \fRsporadic server.\fR +.fi +.P +.RE +.P +Each process or thread is controlled by an associated scheduling policy +and priority. Associated with each policy is a priority range. Each +policy definition specifies the minimum priority range for that +policy. The priority ranges for each policy may overlap the priority +ranges of other policies. +.P +Four scheduling policies are defined; others may be defined by the +implementation. The four standard policies are indicated by the +values of the following symbolic constants: +.IP SCHED_FIFO 14 +First in-first out (FIFO) scheduling policy. +.IP SCHED_RR 14 +Round robin scheduling policy. +.IP SCHED_SPORADIC 14 +Sporadic server scheduling policy. +.IP SCHED_OTHER 14 +Another scheduling policy. +.P +The values of these constants are distinct. +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int sched_get_priority_max(int); +int sched_get_priority_min(int); +int sched_getparam(pid_t, struct sched_param *); +int sched_getscheduler(pid_t); +int sched_rr_get_interval(pid_t, struct timespec *); +int sched_setparam(pid_t, const struct sched_param *); +int sched_setscheduler(pid_t, int, const struct sched_param *); +int sched_yield(void); +.fi +.P +.RE +.P +Inclusion of the +.IR <sched.h> +header may make visible all symbols from the +.IR <time.h> +header. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP", +.IR "\fB<time.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIsched_get_priority_max\fR\^(\|)", +.IR "\fIsched_getparam\fR\^(\|)", +.IR "\fIsched_getscheduler\fR\^(\|)", +.IR "\fIsched_rr_get_interval\fR\^(\|)", +.IR "\fIsched_setparam\fR\^(\|)", +.IR "\fIsched_setscheduler\fR\^(\|)", +.IR "\fIsched_yield\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/search.h.0p b/upstream/mageia-cauldron/man0p/search.h.0p new file mode 100644 index 00000000..b3741cce --- /dev/null +++ b/upstream/mageia-cauldron/man0p/search.h.0p @@ -0,0 +1,117 @@ +'\" et +.TH search.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +search.h +\(em search tables +.SH SYNOPSIS +.LP +.nf +#include <search.h> +.fi +.SH DESCRIPTION +The +.IR <search.h> +header shall define the +.BR ENTRY +type for structure +.BR entry +which shall include the following members: +.sp +.RS 4 +.nf + +char *key +void *data +.fi +.P +.RE +.P +and shall define +.BR ACTION +and +.BR VISIT +as enumeration data types through type definitions as follows: +.sp +.RS 4 +.nf + +enum { FIND, ENTER } ACTION; +enum { preorder, postorder, endorder, leaf } VISIT; +.fi +.P +.RE +.P +The +.IR <search.h> +header shall define the +.BR size_t +type as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int hcreate(size_t); +void hdestroy(void); +ENTRY *hsearch(ENTRY, ACTION); +void insque(void *, void *); +void *lfind(const void *, const void *, size_t *, + size_t, int (*)(const void *, const void *)); +void *lsearch(const void *, void *, size_t *, + size_t, int (*)(const void *, const void *)); +void remque(void *); +void *tdelete(const void *restrict, void **restrict, + int(*)(const void *, const void *)); +void *tfind(const void *, void *const *, + int(*)(const void *, const void *)); +void *tsearch(const void *, void **, + int(*)(const void *, const void *)); +void twalk(const void *, + void (*)(const void *, VISIT, int )); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIhcreate\fR\^(\|)", +.IR "\fIinsque\fR\^(\|)", +.IR "\fIlsearch\fR\^(\|)", +.IR "\fItdelete\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/semaphore.h.0p b/upstream/mageia-cauldron/man0p/semaphore.h.0p new file mode 100644 index 00000000..c8d1bd69 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/semaphore.h.0p @@ -0,0 +1,102 @@ +'\" et +.TH semaphore.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +semaphore.h +\(em semaphores +.SH SYNOPSIS +.LP +.nf +#include <semaphore.h> +.fi +.SH DESCRIPTION +The +.IR <semaphore.h> +header shall define the +.BR sem_t +type, used in performing semaphore operations. The semaphore may be +implemented using a file descriptor, in which case applications are +able to open up at least a total of +{OPEN_MAX} +files and semaphores. +.P +The +.IR <semaphore.h> +header shall define the symbolic constant SEM_FAILED which shall +have type +.BR "sem_t *" . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int sem_close(sem_t *); +int sem_destroy(sem_t *); +int sem_getvalue(sem_t *restrict, int *restrict); +int sem_init(sem_t *, int, unsigned); +sem_t *sem_open(const char *, int, ...); +int sem_post(sem_t *); +int sem_timedwait(sem_t *restrict, const struct timespec *restrict); +int sem_trywait(sem_t *); +int sem_unlink(const char *); +int sem_wait(sem_t *); +.fi +.P +.RE +.P +Inclusion of the +.IR <semaphore.h> +header may make visible symbols defined in the +.IR <fcntl.h> +and +.IR <time.h> +headers. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<fcntl.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<time.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIsem_close\fR\^(\|)", +.IR "\fIsem_destroy\fR\^(\|)", +.IR "\fIsem_getvalue\fR\^(\|)", +.IR "\fIsem_init\fR\^(\|)", +.IR "\fIsem_open\fR\^(\|)", +.IR "\fIsem_post\fR\^(\|)", +.IR "\fIsem_timedwait\fR\^(\|)", +.IR "\fIsem_trywait\fR\^(\|)", +.IR "\fIsem_unlink\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/setjmp.h.0p b/upstream/mageia-cauldron/man0p/setjmp.h.0p new file mode 100644 index 00000000..2e380370 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/setjmp.h.0p @@ -0,0 +1,91 @@ +'\" et +.TH setjmp.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +setjmp.h +\(em stack environment declarations +.SH SYNOPSIS +.LP +.nf +#include <setjmp.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <setjmp.h> +header shall define the array types +.BR jmp_buf +and +.BR sigjmp_buf . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void _longjmp(jmp_buf, int); +void longjmp(jmp_buf, int); +void siglongjmp(sigjmp_buf, int); +.fi +.P +.RE +.P +The following may be declared as functions, or defined as macros, or +both. If functions are declared, function prototypes shall be +provided. +.sp +.RS 4 +.nf + +int _setjmp(jmp_buf); +int setjmp(jmp_buf); +int sigsetjmp(sigjmp_buf, int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fI_longjmp\fR\^(\|)", +.IR "\fIlongjmp\fR\^(\|)", +.IR "\fIsetjmp\fR\^(\|)", +.IR "\fIsiglongjmp\fR\^(\|)", +.IR "\fIsigsetjmp\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/signal.h.0p b/upstream/mageia-cauldron/man0p/signal.h.0p new file mode 100644 index 00000000..830dee69 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/signal.h.0p @@ -0,0 +1,615 @@ +'\" et +.TH signal.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +signal.h +\(em signals +.SH SYNOPSIS +.LP +.nf +#include <signal.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <signal.h> +header shall define the following macros, which shall expand to constant +expressions with distinct values that have a type compatible with the +second argument to, and the return value of, the +\fIsignal\fR() +function, and whose values shall compare unequal to the address of any +declarable function. +.IP SIG_DFL 14 +Request for default signal handling. +.IP SIG_ERR 14 +Return value from +\fIsignal\fR() +in case of error. +.IP SIG_HOLD 14 +Request that signal be held. +.IP SIG_IGN 14 +Request that signal be ignored. +.P +The +.IR <signal.h> +header shall define the +.BR pthread_t , +.BR size_t , +and +.BR uid_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <signal.h> +header shall define the +.BR timespec +structure as described in +.IR <time.h> . +.P +The +.IR <signal.h> +header shall define the following data types: +.IP "\fBsig_atomic_t\fP" 14 +Possibly volatile-qualified integer type of an object that can be +accessed as an atomic entity, even in the presence of asynchronous +interrupts. +.IP "\fBsigset_t\fP" 14 +Integer or structure type of an object used to represent sets of +signals. +.IP "\fBpid_t\fP" 14 +As described in +.IR <sys/types.h> . +.P +The +.IR <signal.h> +header shall define the +.BR pthread_attr_t +type as described in +.IR <sys/types.h> . +.P +The +.IR <signal.h> +header shall define the +.BR sigevent +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int sigev_notify \fRNotification type.\fP +int sigev_signo \fRSignal number.\fP +union sigval sigev_value \fRSignal value.\fP +void (*sigev_notify_function)(union sigval) + \fRNotification function.\fP +pthread_attr_t *sigev_notify_attributes \fRNotification attributes.\fP +.fi +.P +.RE +.P +The +.IR <signal.h> +header shall define the following symbolic constants for the values of +.IR sigev_notify : +.IP SIGEV_NONE 14 +No asynchronous notification is delivered when the event of interest +occurs. +.IP SIGEV_SIGNAL 14 +A queued signal, with an application-defined value, is generated when +the event of interest occurs. +.IP SIGEV_THREAD 14 +A notification function is called to perform notification. +.br +.P +The +.BR sigval +union shall be defined as: +.sp +.RS 4 +.nf + +int sival_int \fRInteger signal value.\fP +void *sival_ptr \fRPointer signal value.\fP +.fi +.P +.RE +.P +The +.IR <signal.h> +header shall declare the SIGRTMIN and SIGRTMAX macros, +which shall expand to positive integer expressions with type +.BR int , +but which need not be constant expressions. These macros specify a +range of signal numbers that are reserved for application use and for +which the realtime signal behavior specified in this volume of POSIX.1\(hy2017 is supported. The +signal numbers in this range do not overlap any of the signals specified +in the following table. +.P +The range SIGRTMIN through SIGRTMAX inclusive shall include at least +{RTSIG_MAX} +signal numbers. +.P +It is implementation-defined whether realtime signal behavior is +supported for other signals. +.P +The +.IR <signal.h> +header shall define the following macros that are used to refer to the +signals that occur in the system. Signals defined here begin with the +letters SIG followed by an uppercase letter. The macros shall expand to +positive integer constant expressions with type +.BR int +and distinct values. The value 0 is reserved for use as the null signal +(see +\fIkill\fR()). +Additional implementation-defined signals may occur in the system. +.P +The ISO\ C standard only requires the signal names SIGABRT, SIGFPE, SIGILL, +SIGINT, SIGSEGV, and SIGTERM to be defined. An implementation need +not generate any of these six signals, except as a result of +explicit use of interfaces that generate signals, such as +\fIraise\fR(), +\fIkill\fR(), +the General Terminal Interface (see +.IR "Section 11.1.9" ", " "Special Characters"), +and the +.IR kill +utility, unless otherwise stated (see, for example, the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.8.3.3" ", " "Memory Protection"). +.P +The following signals shall be supported on all implementations +(default actions are explained below the table): +.TS +box center tab(!); +cB | cB | cB +l | n | lw(3.6i). +Signal!Default Action!Description +_ +SIGABRT!A!Process abort signal. +SIGALRM!T!Alarm clock. +SIGBUS!A!Access to an undefined portion of a memory object. +SIGCHLD!I!Child process terminated, stopped, +!!or continued. +SIGCONT!C!Continue executing, if stopped. +SIGFPE!A!Erroneous arithmetic operation. +SIGHUP!T!Hangup. +SIGILL!A!Illegal instruction. +SIGINT!T!Terminal interrupt signal. +SIGKILL!T!Kill (cannot be caught or ignored). +SIGPIPE!T!Write on a pipe with no one to read it. +SIGQUIT!A!Terminal quit signal. +SIGSEGV!A!Invalid memory reference. +SIGSTOP!S!Stop executing (cannot be caught or ignored). +SIGTERM!T!Termination signal. +SIGTSTP!S!Terminal stop signal. +SIGTTIN!S!Background process attempting read. +SIGTTOU!S!Background process attempting write. +SIGUSR1!T!User-defined signal 1. +SIGUSR2!T!User-defined signal 2. +SIGPOLL!T!Pollable event. +SIGPROF!T!Profiling timer expired. +SIGSYS!A!Bad system call. +SIGTRAP!A!Trace/breakpoint trap. +SIGURG!I!High bandwidth data is available at a socket. +SIGVTALRM!T!Virtual timer expired. +SIGXCPU!A!CPU time limit exceeded. +SIGXFSZ!A!File size limit exceeded. +.sp +.TE +.br +.P +The default actions are as follows: +.IP T 6 +Abnormal termination of the process. +.IP A 6 +Abnormal termination of the process +with additional actions. +.IP I 6 +Ignore the signal. +.IP S 6 +Stop the process. +.IP C 6 +Continue the process, if it is stopped; otherwise, ignore the signal. +.P +The effects on the process in each case are described in the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.4.3" ", " "Signal Actions". +.P +The +.IR <signal.h> +header shall declare the +.BR sigaction +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +void (*sa_handler)(int) \fRPointer to a signal-catching function\fR + \fRor one of the SIG_IGN or SIG_DFL.\fR +sigset_t sa_mask \fRSet of signals to be blocked during execution\fR + \fRof the signal handling function.\fR +int sa_flags \fRSpecial flags.\fR +void (*sa_sigaction)(int, siginfo_t *, void *) + \fRPointer to a signal-catching function.\fR +.fi +.P +.RE +.P +The storage occupied by +.IR sa_handler +and +.IR sa_sigaction +may overlap, and a conforming application shall not use both +simultaneously. +.P +The +.IR <signal.h> +header shall define the following macros which shall expand to +integer constant expressions that need not be usable in +.BR #if +preprocessing directives: +.IP SIG_BLOCK 14 +The resulting set is the union of the current set and the signal set +pointed to by the argument +.IR set . +.IP SIG_UNBLOCK 14 +The resulting set is the intersection of the current set and the +complement of the signal set pointed to by the argument +.IR set . +.IP SIG_SETMASK 14 +The resulting set is the signal set pointed to by the argument +.IR set . +.P +The +.IR <signal.h> +header shall also define the following symbolic constants: +.IP SA_NOCLDSTOP 14 +Do not generate SIGCHLD when children stop +.br +or stopped children continue. +.IP SA_ONSTACK 14 +Causes signal delivery to occur on an alternate stack. +.IP SA_RESETHAND 14 +Causes signal dispositions to be set to SIG_DFL on entry to signal +handlers. +.IP SA_RESTART 14 +Causes certain functions to become restartable. +.IP SA_SIGINFO 14 +Causes extra information to be passed to signal handlers at the time of +receipt of a signal. +.IP SA_NOCLDWAIT 14 +Causes implementations not to create zombie processes or status +information on child termination. See +.IR "\fIsigaction\fR\^(\|)". +.IP SA_NODEFER 14 +Causes signal not to be automatically blocked on entry to signal handler. +.IP SS_ONSTACK 14 +Process is executing on an alternate signal stack. +.IP SS_DISABLE 14 +Alternate signal stack is disabled. +.IP MINSIGSTKSZ 14 +Minimum stack size for a signal handler. +.IP SIGSTKSZ 14 +Default size in bytes for the alternate signal stack. +.P +The +.IR <signal.h> +header shall define the +.BR mcontext_t +type through +.BR typedef . +.P +The +.IR <signal.h> +header shall define the +.BR ucontext_t +type as a structure that shall include at least the following members: +.sp +.RS 4 +.nf + +ucontext_t *uc_link \fRPointer to the context that is resumed\fR + \fRwhen this context returns.\fR +sigset_t uc_sigmask \fRThe set of signals that are blocked when this\fR + \fRcontext is active.\fR +stack_t uc_stack \fRThe stack used by this context.\fR +mcontext_t uc_mcontext \fRA machine-specific representation of the saved\fR + \fRcontext.\fR +.fi +.P +.RE +.P +The +.IR <signal.h> +header shall define the +.BR stack_t +type as a structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +void *ss_sp \fRStack base or pointer.\fR +size_t ss_size \fRStack size.\fR +int ss_flags \fRFlags.\fR +.fi +.P +.RE +.P +The +.IR <signal.h> +header shall define the +.BR siginfo_t +type as a structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int si_signo \fRSignal number.\fR +int si_code \fRSignal code.\fR +int si_errno \fRIf non-zero, an \fIerrno\fR value associated with\fR + \fRthis signal, as described in \fB<errno.h>\fR.\fR +pid_t si_pid \fRSending process ID.\fR +uid_t si_uid \fRReal user ID of sending process.\fR +void *si_addr \fRAddress of faulting instruction.\fR +int si_status \fRExit value or signal.\fR +long si_band \fRBand event for SIGPOLL.\fR +union sigval si_value \fRSignal value.\fR +.fi +.P +.RE +.P +The +.IR <signal.h> +header shall define the symbolic constants in the +.BR Code +column of the following table for use as values of +.IR si_code +that are signal-specific or non-signal-specific reasons why the +signal was generated. +.TS +box center tab(!); +cB | cB | cB +l1 | l1 | l. +Signal!Code!Reason +_ +SIGILL!ILL_ILLOPC!Illegal opcode. +!ILL_ILLOPN!Illegal operand. +!ILL_ILLADR!Illegal addressing mode. +!ILL_ILLTRP!Illegal trap. +!ILL_PRVOPC!Privileged opcode. +!ILL_PRVREG!Privileged register. +!ILL_COPROC!Coprocessor error. +!ILL_BADSTK!Internal stack error. +_ +SIGFPE!FPE_INTDIV!Integer divide by zero. +!FPE_INTOVF!Integer overflow. +!FPE_FLTDIV!Floating-point divide by zero. +!FPE_FLTOVF!Floating-point overflow. +!FPE_FLTUND!Floating-point underflow. +!FPE_FLTRES!Floating-point inexact result. +!FPE_FLTINV!Invalid floating-point operation. +!FPE_FLTSUB!Subscript out of range. +_ +SIGSEGV!SEGV_MAPERR!Address not mapped to object. +!SEGV_ACCERR!Invalid permissions for mapped object. +_ +SIGBUS!BUS_ADRALN!Invalid address alignment. +!BUS_ADRERR!Nonexistent physical address. +!BUS_OBJERR!Object-specific hardware error. +_ +SIGTRAP!TRAP_BRKPT!Process breakpoint. +!TRAP_TRACE!Process trace trap. +_ +SIGCHLD!CLD_EXITED!Child has exited. +!CLD_KILLED!Child has terminated abnormally and did not create a \fBcore\fP file. +!CLD_DUMPED!Child has terminated abnormally and created a \fBcore\fP file. +!CLD_TRAPPED!Traced child has trapped. +!CLD_STOPPED!Child has stopped. +!CLD_CONTINUED!Stopped child has continued. +_ +SIGPOLL!POLL_IN!Data input available. +!POLL_OUT!Output buffers available. +!POLL_MSG!Input message available. +!POLL_ERR!I/O error. +!POLL_PRI!High priority input available. +!POLL_HUP!Device disconnected. +_ +Any!SI_USER!Signal sent by \fIkill\fP\^(\|). +!SI_QUEUE!Signal sent by \fIsigqueue\fP\^(\|). +!SI_TIMER!Signal generated by expiration of a timer set by \fItimer_settime\fP\^(\|). +!SI_ASYNCIO!Signal generated by completion of an asynchronous I/O +!!request. +!SI_MESGQ!Signal generated by arrival of a message on an empty message +!!queue. +.TE +.P +Implementations may support additional +.IR si_code +values not included in this list, may generate values included in this +list under circumstances other than those described in this list, and +may contain extensions or limitations that prevent some values from +being generated. Implementations do not generate a different value from +the ones described in this list for circumstances described in this +list. +.br +.P +In addition, the following signal-specific information shall be +available: +.TS +box center tab(!); +cB | cB | cB +l | lB | lw(3.9i). +Signal!Member!Value +_ +SIGILL!void * \fIsi_addr\fP!Address of faulting instruction. +SIGFPE +_ +SIGSEGV!void * \fIsi_addr\fP!Address of faulting memory reference. +SIGBUS +_ +SIGCHLD!pid_t \fIsi_pid\fP!Child process ID. +!int \fIsi_status\fP!T{ +If +.IR si_code +is equal to CLD_EXITED, then +.IR si_status +holds the exit value of the process; otherwise, it is equal to the +signal that caused the process to change state. The exit value in +.IR si_status +shall be equal to the full exit value (that is, the value passed to +\fI_exit\fR(), +\fI_Exit\fR(), +or +\fIexit\fR(), +or returned from +\fImain\fR()); +it shall not be limited to the least significant eight bits of the value. +T} +!uid_t \fIsi_uid\fP!Real user ID of the process that sent the signal. +_ +SIGPOLL!long \fIsi_band\fP!Band event for POLL_IN, POLL_OUT, or POLL_MSG. +.TE +.P +For some implementations, the value of \fIsi_addr\fR may be inaccurate. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int kill(pid_t, int); +int killpg(pid_t, int); +void psiginfo(const siginfo_t *, const char *); +void psignal(int, const char *); +int pthread_kill(pthread_t, int); +int pthread_sigmask(int, const sigset_t *restrict, + sigset_t *restrict); +int raise(int); +int sigaction(int, const struct sigaction *restrict, + struct sigaction *restrict); +int sigaddset(sigset_t *, int); +int sigaltstack(const stack_t *restrict, stack_t *restrict); +int sigdelset(sigset_t *, int); +int sigemptyset(sigset_t *); +int sigfillset(sigset_t *); +int sighold(int); +int sigignore(int); +int siginterrupt(int, int); +int sigismember(const sigset_t *, int); +void (*signal(int, void (*)(int)))(int); +int sigpause(int); +int sigpending(sigset_t *); +int sigprocmask(int, const sigset_t *restrict, sigset_t *restrict); +int sigqueue(pid_t, int, union sigval); +int sigrelse(int); +void (*sigset(int, void (*)(int)))(int); +int sigsuspend(const sigset_t *); +int sigtimedwait(const sigset_t *restrict, siginfo_t *restrict, + const struct timespec *restrict); +int sigwait(const sigset_t *restrict, int *restrict); +int sigwaitinfo(const sigset_t *restrict, siginfo_t *restrict); +.fi +.P +.RE +.P +Inclusion of the +.IR <signal.h> +header may make visible all symbols from the +.IR <time.h> +header. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +On systems not supporting the XSI option, the +.IR si_pid +and +.IR si_uid +members of +.BR siginfo_t +are only required to be valid when +.IR si_code +is SI_USER or SI_QUEUE. On XSI-conforming systems, they are also +valid for all +.IR si_code +values less than or equal to 0; however, it is unspecified whether +SI_USER and SI_QUEUE have values less than or equal to zero, and +therefore XSI applications should check whether +.IR si_code +has the value SI_USER or SI_QUEUE or is less than or equal to 0 +to tell whether +.IR si_pid +and +.IR si_uid +are valid. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +The SIGPOLL and SIGPROF signals may be removed in a future version. +.SH "SEE ALSO" +.IR "\fB<errno.h>\fP", +.IR "\fB<stropts.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<time.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIalarm\fR\^(\|)", +.IR "\fIioctl\fR\^(\|)", +.IR "\fIkill\fR\^(\|)", +.IR "\fIkillpg\fR\^(\|)", +.IR "\fIpsiginfo\fR\^(\|)", +.IR "\fIpthread_kill\fR\^(\|)", +.IR "\fIpthread_sigmask\fR\^(\|)", +.IR "\fIraise\fR\^(\|)", +.IR "\fIsigaction\fR\^(\|)", +.IR "\fIsigaddset\fR\^(\|)", +.IR "\fIsigaltstack\fR\^(\|)", +.IR "\fIsigdelset\fR\^(\|)", +.IR "\fIsigemptyset\fR\^(\|)", +.IR "\fIsigfillset\fR\^(\|)", +.IR "\fIsighold\fR\^(\|)", +.IR "\fIsiginterrupt\fR\^(\|)", +.IR "\fIsigismember\fR\^(\|)", +.IR "\fIsignal\fR\^(\|)", +.IR "\fIsigpending\fR\^(\|)", +.IR "\fIsigqueue\fR\^(\|)", +.IR "\fIsigsuspend\fR\^(\|)", +.IR "\fIsigtimedwait\fR\^(\|)", +.IR "\fIsigwait\fR\^(\|)", +.IR "\fItimer_create\fR\^(\|)", +.IR "\fIwait\fR\^(\|)", +.IR "\fIwaitid\fR\^(\|)" +.ad b +.P +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "\fIkill\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/spawn.h.0p b/upstream/mageia-cauldron/man0p/spawn.h.0p new file mode 100644 index 00000000..4e36f35e --- /dev/null +++ b/upstream/mageia-cauldron/man0p/spawn.h.0p @@ -0,0 +1,170 @@ +'\" et +.TH spawn.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +spawn.h +\(em spawn (\fBADVANCED REALTIME\fP) +.SH SYNOPSIS +.LP +.nf +#include <spawn.h> +.fi +.SH DESCRIPTION +The +.IR <spawn.h> +header shall define the +.BR posix_spawnattr_t +and +.BR posix_spawn_file_actions_t +types used in performing spawn operations. +.P +The +.IR <spawn.h> +header shall define the +.BR mode_t +and +.BR pid_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <spawn.h> +header shall define the +.BR sigset_t +type as described in +.IR <signal.h> . +.P +The tag +.BR sched_param +shall be declared as naming an incomplete structure type, the contents +of which are described in the +.IR <sched.h> +header. +.P +The +.IR <spawn.h> +header shall define the following symbolic constants for use as the +flags that may be set in a +.BR posix_spawnattr_t +object using the +\fIposix_spawnattr_setflags\fR() +function: +.P +.nf +POSIX_SPAWN_RESETIDS +POSIX_SPAWN_SETPGROUP +POSIX_SPAWN_SETSCHEDPARAM +POSIX_SPAWN_SETSCHEDULER +POSIX_SPAWN_SETSIGDEF +POSIX_SPAWN_SETSIGMASK +.fi +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int posix_spawn(pid_t *restrict, const char *restrict, + const posix_spawn_file_actions_t *, + const posix_spawnattr_t *restrict, char *const [restrict], + char *const [restrict]); +int posix_spawn_file_actions_addclose(posix_spawn_file_actions_t *, + int); +int posix_spawn_file_actions_adddup2(posix_spawn_file_actions_t *, + int, int); +int posix_spawn_file_actions_addopen(posix_spawn_file_actions_t *restrict, + int, const char *restrict, int, mode_t); +int posix_spawn_file_actions_destroy(posix_spawn_file_actions_t *); +int posix_spawn_file_actions_init(posix_spawn_file_actions_t *); +int posix_spawnattr_destroy(posix_spawnattr_t *); +int posix_spawnattr_getflags(const posix_spawnattr_t *restrict, + short *restrict); +int posix_spawnattr_getpgroup(const posix_spawnattr_t *restrict, + pid_t *restrict); +int posix_spawnattr_getschedparam(const posix_spawnattr_t *restrict, + struct sched_param *restrict); +int posix_spawnattr_getschedpolicy(const posix_spawnattr_t *restrict, + int *restrict); +int posix_spawnattr_getsigdefault(const posix_spawnattr_t *restrict, + sigset_t *restrict); +int posix_spawnattr_getsigmask(const posix_spawnattr_t *restrict, + sigset_t *restrict); +int posix_spawnattr_init(posix_spawnattr_t *); +int posix_spawnattr_setflags(posix_spawnattr_t *, short); +int posix_spawnattr_setpgroup(posix_spawnattr_t *, pid_t); +.br +int posix_spawnattr_setschedparam(posix_spawnattr_t *restrict, + const struct sched_param *restrict); +int posix_spawnattr_setschedpolicy(posix_spawnattr_t *, int); +int posix_spawnattr_setsigdefault(posix_spawnattr_t *restrict, + const sigset_t *restrict); +int posix_spawnattr_setsigmask(posix_spawnattr_t *restrict, + const sigset_t *restrict); +int posix_spawnp(pid_t *restrict, const char *restrict, + const posix_spawn_file_actions_t *, + const posix_spawnattr_t *restrict, + char *const [restrict], char *const [restrict]); +.fi +.P +.RE +.P +Inclusion of the +.IR <spawn.h> +header may make visible symbols defined in the +.IR <sched.h> +and +.IR <signal.h> +headers. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sched.h>\fP", +.IR "\fB<semaphore.h>\fP", +.IR "\fB<signal.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIposix_spawn\fR\^(\|)", +.IR "\fIposix_spawn_file_actions_addclose\fR\^(\|)", +.IR "\fIposix_spawn_file_actions_adddup2\fR\^(\|)", +.IR "\fIposix_spawn_file_actions_destroy\fR\^(\|)", +.IR "\fIposix_spawnattr_destroy\fR\^(\|)", +.IR "\fIposix_spawnattr_getflags\fR\^(\|)", +.IR "\fIposix_spawnattr_getpgroup\fR\^(\|)", +.IR "\fIposix_spawnattr_getschedparam\fR\^(\|)", +.IR "\fIposix_spawnattr_getschedpolicy\fR\^(\|)", +.IR "\fIposix_spawnattr_getsigdefault\fR\^(\|)", +.IR "\fIposix_spawnattr_getsigmask\fR\^(\|)" +.ad b +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/stdarg.h.0p b/upstream/mageia-cauldron/man0p/stdarg.h.0p new file mode 100644 index 00000000..bfa482ed --- /dev/null +++ b/upstream/mageia-cauldron/man0p/stdarg.h.0p @@ -0,0 +1,226 @@ +'\" et +.TH stdarg.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +stdarg.h +\(em handle variable argument list +.SH SYNOPSIS +.LP +.nf +#include <stdarg.h> +.P +void va_start(va_list \fIap\fP, \fIargN\fP); +void va_copy(va_list \fIdest\fP, va_list \fIsrc\fP); +\fItype\fP va_arg(va_list \fIap\fP, \fItype\fP); +void va_end(va_list \fIap\fP); +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The +.IR <stdarg.h> +header shall contain a set of macros which allows portable functions +that accept variable argument lists to be written. Functions that have +variable argument lists (such as +\fIprintf\fR()) +but do not use these macros are inherently non-portable, as different +systems use different argument-passing conventions. +.P +The +.IR <stdarg.h> +header shall define the +.BR va_list +type for variables used to traverse the list. +.P +The +\fIva_start\fR() +macro is invoked to initialize +.IR ap +to the beginning of the list before any calls to +\fIva_arg\fR(). +.P +The +\fIva_copy\fR() +macro initializes +.IR dest +as a copy of +.IR src , +as if the +\fIva_start\fR() +macro had been applied to +.IR dest +followed by the same sequence of uses of the +\fIva_arg\fR() +macro as had previously been used to reach the present state of +.IR src . +Neither the +\fIva_copy\fR() +nor +\fIva_start\fR() +macro shall be invoked to reinitialize +.IR dest +without an intervening invocation of the +\fIva_end\fR() +macro for the same +.IR dest . +.P +The object +.IR ap +may be passed as an argument to another function; if that function +invokes the +\fIva_arg\fR() +macro with parameter +.IR ap , +the value of +.IR ap +in the calling function is unspecified and shall be passed to the +\fIva_end\fR() +macro prior to any further reference to +.IR ap . +The parameter +.IR argN +is the identifier of the rightmost parameter in the variable parameter +list in the function definition (the one just before the .\|.\|.). If +the parameter +.IR argN +is declared with the +.BR register +storage class, with a function type or array type, or with a type that +is not compatible with the type that results after application of the +default argument promotions, the behavior is undefined. +.P +The +\fIva_arg\fR() +macro shall return the next argument in the list pointed to by +.IR ap . +Each invocation of +\fIva_arg\fR() +modifies +.IR ap +so that the values of successive arguments are returned in turn. The +.IR type +parameter shall be a type name specified such that the type of a +pointer to an object that has the specified type can be obtained simply +by postfixing a +.BR '*' +to type. If there is no actual next argument, or if +.IR type +is not compatible with the type of the actual next argument (as +promoted according to the default argument promotions), the behavior is +undefined, except for the following cases: +.IP " *" 4 +One type is a signed integer type, the other type is the corresponding +unsigned integer type, and the value is representable in both types. +.IP " *" 4 +One type is a pointer to +.BR void +and the other is a pointer to a character type. +.IP " *" 4 +Both types are pointers. +.P +Different types can be mixed, but it is up to the routine to +know what type of argument is expected. +.P +The +\fIva_end\fR() +macro is used to clean up; it invalidates +.IR ap +for use (unless +\fIva_start\fR() +or +\fIva_copy\fR() +is invoked again). +.P +Each invocation of the +\fIva_start\fR() +and +\fIva_copy\fR() +macros shall be matched by a corresponding invocation of the +\fIva_end\fR() +macro in the same function. +.P +Multiple traversals, each bracketed by +\fIva_start\fR() +\&.\|.\|. +\fIva_end\fR(), +are possible. +.LP +.IR "The following sections are informative." +.SH "EXAMPLES" +This example is a possible implementation of +\fIexecl\fR(): +.sp +.RS 4 +.nf + +#include <stdarg.h> +.P +#define MAXARGS 31 +.P +/* + * execl is called by + * execl(file, arg1, arg2, ..., (char *)(0)); + */ +int execl(const char *file, const char *args, ...) +{ + va_list ap; + char *array[MAXARGS +1]; + int argno = 0; +.P + va_start(ap, args); + while (args != 0 && argno < MAXARGS) + { + array[argno++] = args; + args = va_arg(ap, const char *); + } + array[argno] = (char *) 0; + va_end(ap); + return execv(file, array); +} +.fi +.P +.RE +.SH "APPLICATION USAGE" +It is up to the calling routine to communicate to the called routine +how many arguments there are, since it is not always possible for the +called routine to determine this in any other way. For example, +\fIexecl\fR() +is passed a null pointer to signal the end of the list. The +\fIprintf\fR() +function can tell how many arguments are there by the +.IR format +argument. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIexec\fR\^", +.IR "\fIfprintf\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/stdbool.h.0p b/upstream/mageia-cauldron/man0p/stdbool.h.0p new file mode 100644 index 00000000..6639298a --- /dev/null +++ b/upstream/mageia-cauldron/man0p/stdbool.h.0p @@ -0,0 +1,67 @@ +'\" et +.TH stdbool.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +stdbool.h +\(em boolean type and values +.SH SYNOPSIS +.LP +.nf +#include <stdbool.h> +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The +.IR <stdbool.h> +header shall define the following macros: +.IP bool 8 +Expands to +.BR _Bool . +.IP true 8 +Expands to the integer constant 1. +.IP false 8 +Expands to the integer constant 0. +.IP "_\|_bool_true_false_are_defined" 8 +.br +Expands to the integer constant 1. +.P +An application may undefine and then possibly redefine the macros bool, +true, and false. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +The ability to undefine and redefine the macros bool, true, and false +is an obsolescent feature and may be removed in a future version. +.SH "SEE ALSO" +None. +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/stddef.h.0p b/upstream/mageia-cauldron/man0p/stddef.h.0p new file mode 100644 index 00000000..5e748857 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/stddef.h.0p @@ -0,0 +1,106 @@ +'\" et +.TH stddef.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +stddef.h +\(em standard type definitions +.SH SYNOPSIS +.LP +.nf +#include <stddef.h> +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The +.IR <stddef.h> +header shall define the following macros: +.IP NULL 10 +Null pointer constant. +The macro shall expand to an integer constant expression with the +value 0 cast to type +.BR "void *" . +.IP "offsetof(\fItype\fP, \fImember-designator\fP)" 10 +.br +Integer constant expression of type +.BR size_t , +the value of which is the offset in bytes to the structure member +(\fImember-designator\fP), from the beginning of its structure +(\fItype\fP). +.P +The +.IR <stddef.h> +header shall define the following types: +.IP "\fBptrdiff_t\fP" 10 +Signed integer type of the result of subtracting two pointers. +.IP "\fBwchar_t\fP" 10 +Integer type whose range of values can represent distinct codes for +all members of the largest extended character set specified among the +supported locales; the null character shall have the code value zero. Each +member of the basic character set shall have a code value equal to its +value when used as the lone character in an integer character constant +if an implementation does not define _\|_STDC_MB_MIGHT_NEQ_WC_\|_. +.IP "\fBsize_t\fP" 10 +Unsigned integer type of the result of the +.IR sizeof +operator. +.P +The implementation shall support one or more programming environments +in which the widths of +.BR ptrdiff_t , +.BR size_t , +and +.BR wchar_t +are no greater than the width of type +.BR long . +The names of these programming environments can be obtained using the +\fIconfstr\fR() +function or the +.IR getconf +utility. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +The ISO\ C standard does not require the NULL macro to include the cast to type +.BR "void *" +and specifies that the NULL macro be implementation-defined. POSIX.1\(hy2008 +requires the cast and therefore need not be implementation-defined. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP", +.IR "\fB<wchar.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIconfstr\fR\^(\|)" +.P +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "\fIgetconf\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/stdint.h.0p b/upstream/mageia-cauldron/man0p/stdint.h.0p new file mode 100644 index 00000000..5acc838c --- /dev/null +++ b/upstream/mageia-cauldron/man0p/stdint.h.0p @@ -0,0 +1,646 @@ +'\" et +.TH stdint.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.EQ +delim $$ +.EN +.SH NAME +stdint.h +\(em integer types +.SH SYNOPSIS +.LP +.nf +#include <stdint.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <stdint.h> +header shall declare sets of integer types having specified widths, and +shall define corresponding sets of macros. It shall also define macros +that specify limits of integer types corresponding to types defined in +other standard headers. +.TP 10 +.BR Note: +The ``width'' of an integer type is the number of bits used to store +its value in a pure binary system; the actual type may use more bits +than that (for example, a 28-bit type could be stored in 32 bits of +actual storage). An +.IR N -bit +signed type has values in the range \-2\s-3\u\fIN\fR\-1\d\s+3 or +1\-2\s-3\u\fIN\fR\-1\d\s+3 to 2\s-3\u\fIN\fR\-1\d\s+3\-1, while +an +.IR N -bit +unsigned type has values in the range 0 to 2\s-3\u\fIN\fR\d\s+3\-1. +.P +.P +Types are defined in the following categories: +.IP " *" 4 +Integer types having certain exact widths +.IP " *" 4 +Integer types having at least certain specified widths +.IP " *" 4 +Fastest integer types having at least certain specified widths +.IP " *" 4 +Integer types wide enough to hold pointers to objects +.IP " *" 4 +Integer types having greatest width +.P +(Some of these types may denote the same type.) +.P +Corresponding macros specify limits of the declared types and construct +suitable constants. +.P +For each type described herein that the implementation provides, the +.IR <stdint.h> +header shall declare that +.BR typedef +name and define the associated macros. Conversely, for each type +described herein that the implementation does not provide, the +.IR <stdint.h> +header shall not declare that +.BR typedef +name, nor shall it define the associated macros. An implementation +shall provide those types described as required, but need not provide +any of the others (described as optional). +.SS "Integer Types" +.P +When +.BR typedef +names differing only in the absence or presence of the initial +.IR u +are defined, they shall denote corresponding signed and unsigned types +as described in the ISO/IEC\ 9899:\|1999 standard, Section 6.2.5; an implementation providing +one of these corresponding types shall also provide the other. +.P +In the following descriptions, the symbol +.IR N +represents an unsigned decimal integer with no leading zeros (for +example, 8 or 24, but not 04 or 048). +.IP " *" 4 +Exact-width integer types +.RS 4 +.P +The +.BR typedef +name +.BR int \c +.IR N \c +.BR _t +designates a signed integer type with width +.IR N , +no padding bits, and a two's-complement representation. Thus, +.BR int8_t +denotes a signed integer type with a width of exactly 8 bits. +.P +The +.BR typedef +name +.BR uint \c +.IR N \c +.BR _t +designates an unsigned integer type with width +.IR N . +Thus, +.BR uint24_t +denotes an unsigned integer type with a width of exactly 24 bits. +.P +The following types are required: +.P +.nf +.BR int8_t +.BR int16_t +.BR int32_t +.BR uint8_t +.BR uint16_t +.BR uint32_t +.fi +.P +If an implementation provides integer types with width 64 that +meet these requirements, then the following types are required: +.BR int64_t +.BR uint64_t +.P +In particular, this will be the case if any of the following are +true: +.IP -- 4 +The implementation supports the _POSIX_V7_ILP32_OFFBIG programming +environment and the application is being built in the +_POSIX_V7_ILP32_OFFBIG programming environment (see the Shell and Utilities volume of POSIX.1\(hy2017, +.IR c99 , +Programming Environments). +.IP -- 4 +The implementation supports the _POSIX_V7_LP64_OFF64 programming +environment and the application is being built in the +_POSIX_V7_LP64_OFF64 programming environment. +.IP -- 4 +The implementation supports the _POSIX_V7_LPBIG_OFFBIG programming +environment and the application is being built in the +_POSIX_V7_LPBIG_OFFBIG programming environment. +.P +All other types of this form are optional. +.RE +.IP " *" 4 +Minimum-width integer types +.RS 4 +.P +The +.BR typedef +name +.BR int_least \c +.IR N \c +.BR _t +designates a signed integer type with a width of at least +.IR N , +such that no signed integer type with lesser size has at least the +specified width. Thus, +.BR int_least32_t +denotes a signed integer type with a width of at least 32 bits. +.P +The +.BR typedef +name +.BR uint_least \c +.IR N \c +.BR _t +designates an unsigned integer type with a width of at least +.IR N , +such that no unsigned integer type with lesser size has at least the +specified width. Thus, +.BR uint_least16_t +denotes an unsigned integer type with a width of at least 16 bits. +.P +The following types are required: +.BR int_least8_t +.BR int_least16_t +.BR int_least32_t +.BR int_least64_t +.BR uint_least8_t +.BR uint_least16_t +.BR uint_least32_t +.BR uint_least64_t +.P +All other types of this form are optional. +.RE +.IP " *" 4 +Fastest minimum-width integer types +.RS 4 +.P +Each of the following types designates an integer type that is usually +fastest to operate with among all integer types that have at least the +specified width. +.P +The designated type is not guaranteed to be fastest for all purposes; +if the implementation has no clear grounds for choosing one type over +another, it will simply pick some integer type satisfying the +signedness and width requirements. +.P +The +.BR typedef +name +.BR int_fast \c +.IR N \c +.BR _t +designates the fastest signed integer type with a width of at least +.IR N . +The +.BR typedef +name +.BR uint_fast \c +.IR N \c +.BR _t +designates the fastest unsigned integer type with a width of at least +.IR N . +.P +The following types are required: +.BR int_fast8_t +.BR int_fast16_t +.BR int_fast32_t +.BR int_fast64_t +.BR uint_fast8_t +.BR uint_fast16_t +.BR uint_fast32_t +.BR uint_fast64_t +.P +All other types of this form are optional. +.RE +.IP " *" 4 +Integer types capable of holding object pointers +.RS 4 +.P +The following type designates a signed integer type with the property +that any valid pointer to +.BR void +can be converted to this type, then converted back to a pointer to +.BR void , +and the result will compare equal to the original pointer: +.BR intptr_t +.P +The following type designates an unsigned integer type with the +property that any valid pointer to +.BR void +can be converted to this type, then converted back to a pointer to +.BR void , +and the result will compare equal to the original pointer: +.BR uintptr_t +.P +On XSI-conformant systems, the +.BR intptr_t +and +.BR uintptr_t +types are required; +otherwise, they are optional. +.RE +.IP " *" 4 +Greatest-width integer types +.RS 4 +.P +The following type designates a signed integer type capable of +representing any value of any signed integer type: +.BR intmax_t +.P +The following type designates an unsigned integer type capable of +representing any value of any unsigned integer type: +.BR uintmax_t +.P +These types are required. +.RE +.TP 10 +.BR Note: +Applications can test for optional types by using the corresponding +limit macro from +.IR "Limits of Specified-Width Integer Types". +.P +.SS "Limits of Specified-Width Integer Types" +.P +The following macros specify the minimum and maximum limits of the +types declared in the +.IR <stdint.h> +header. Each macro name corresponds to a similar type name in +.IR "Integer Types". +.P +Each instance of any defined macro shall be replaced by a constant +expression suitable for use in +.BR #if +preprocessing directives, and this expression shall have the same type +as would an expression that is an object of the corresponding type +converted according to the integer promotions. Its +implementation-defined value shall be equal to or greater in magnitude +(absolute value) than the corresponding value given below, with the +same sign, except where stated to be exactly the given value. +.IP " *" 4 +Limits of exact-width integer types +.RS 4 +.IP -- 4 +Minimum values of exact-width signed integer types: +.RS 4 +.IP "{INT\fIN\fR_MIN}" 16 +Exactly \-($2"^" N\-1$) +.RE +.IP -- 4 +Maximum values of exact-width signed integer types: +.RS 4 +.IP "{INT\fIN\fR_MAX}" 16 +Exactly $2"^" N\-1$ \-1 +.RE +.IP -- 4 +Maximum values of exact-width unsigned integer types: +.RS 4 +.IP "{UINT\fIN\fR_MAX}" 16 +Exactly $2"^" N$ \-1 +.RE +.RE +.IP " *" 4 +Limits of minimum-width integer types +.RS 4 +.IP -- 4 +Minimum values of minimum-width signed integer types: +.RS 4 +.IP "{INT_LEAST\fIN\fR_MIN}" 16 +\-($2"^" N\-1$ \-1) +.RE +.IP -- 4 +Maximum values of minimum-width signed integer types: +.RS 4 +.IP "{INT_LEAST\fIN\fR_MAX}" 16 +$2"^" N\-1$ \-1 +.RE +.IP -- 4 +Maximum values of minimum-width unsigned integer types: +.RS 4 +.IP "{UINT_LEAST\fIN\fR_MAX}" 16 +$2"^" N$ \-1 +.RE +.RE +.IP " *" 4 +Limits of fastest minimum-width integer types +.RS 4 +.IP -- 4 +Minimum values of fastest minimum-width signed integer types: +.RS 4 +.IP "{INT_FAST\fIN\fR_MIN}" 16 +\-($2"^" N\-1$ \-1) +.RE +.IP -- 4 +Maximum values of fastest minimum-width signed integer types: +.RS 4 +.IP "{INT_FAST\fIN\fR_MAX}" 16 +$2"^" N\-1$ \-1 +.RE +.IP -- 4 +Maximum values of fastest minimum-width unsigned integer types: +.RS 4 +.IP "{UINT_FAST\fIN\fR_MAX}" 16 +$2"^" N$ \-1 +.RE +.RE +.IP " *" 4 +Limits of integer types capable of holding object pointers +.RS 4 +.IP -- 4 +Minimum value of pointer-holding signed integer type: +.RS 4 +.IP {INTPTR_MIN} 16 +\-($2"^" 15$ \-1) +.RE +.IP -- 4 +Maximum value of pointer-holding signed integer type: +.RS 4 +.IP {INTPTR_MAX} 16 +$2"^" 15$ \-1 +.RE +.IP -- 4 +Maximum value of pointer-holding unsigned integer type: +.RS 4 +.IP {UINTPTR_MAX} 16 +$2"^" 16$ \-1 +.RE +.RE +.IP " *" 4 +Limits of greatest-width integer types +.RS 4 +.IP -- 4 +Minimum value of greatest-width signed integer type: +.RS 4 +.IP {INTMAX_MIN} 16 +\-($2"^" 63$ \-1) +.RE +.IP -- 4 +Maximum value of greatest-width signed integer type: +.RS 4 +.IP {INTMAX_MAX} 16 +$2"^" 63$ \-1 +.RE +.IP -- 4 +Maximum value of greatest-width unsigned integer type: +.RS 4 +.IP {UINTMAX_MAX} 16 +$2"^" 64$ \-1 +.RE +.RE +.SS "Limits of Other Integer Types" +.P +The following macros specify the minimum and maximum limits of integer +types corresponding to types defined in other standard headers. +.P +Each instance of these macros shall be replaced by a constant +expression suitable for use in +.BR #if +preprocessing directives, and this expression shall have the same type +as would an expression that is an object of the corresponding type +converted according to the integer promotions. Its +implementation-defined value shall be equal to or greater in magnitude +(absolute value) than the corresponding value given below, with the +same sign. +.IP " *" 4 +Limits of \fBptrdiff_t\fR: +.RS 4 +.IP {PTRDIFF_MIN} 16 +\-65\|535 +.IP {PTRDIFF_MAX} 16 ++65\|535 +.RE +.IP " *" 4 +Limits of \fBsig_atomic_t\fR: +.RS 4 +.IP {SIG_ATOMIC_MIN} 16 +See below. +.IP {SIG_ATOMIC_MAX} 16 +See below. +.RE +.IP " *" 4 +Limit of \fBsize_t\fR: +.RS 4 +.IP {SIZE_MAX} 16 +65\|535 +.RE +.IP " *" 4 +Limits of \fBwchar_t\fR: +.RS 4 +.IP {WCHAR_MIN} 16 +See below. +.IP {WCHAR_MAX} 16 +See below. +.RE +.IP " *" 4 +Limits of \fBwint_t\fR: +.RS 4 +.IP {WINT_MIN} 16 +See below. +.IP {WINT_MAX} 16 +See below. +.RE +.P +If +.BR sig_atomic_t +(see the +.IR <signal.h> +header) is defined as a signed integer type, the value of +{SIG_ATOMIC_MIN} +shall be no greater than \-127 and the value of +{SIG_ATOMIC_MAX} +shall be no less than 127; otherwise, +.BR sig_atomic_t +shall be defined as an unsigned integer type, and the value of +{SIG_ATOMIC_MIN} +shall be 0 and the value of +{SIG_ATOMIC_MAX} +shall be no less than 255. +.P +If +.BR wchar_t +(see the +.IR <stddef.h> +header) is defined as a signed integer type, the value of +{WCHAR_MIN} +shall be no greater than \-127 and the value of +{WCHAR_MAX} +shall be no less than 127; otherwise, +.BR wchar_t +shall be defined as an unsigned integer type, and the value of +{WCHAR_MIN} +shall be 0 and the value of +{WCHAR_MAX} +shall be no less than 255. +.P +If +.BR wint_t +(see the +.IR <wchar.h> +header) is defined as a signed integer type, the value of +{WINT_MIN} +shall be no greater than \-32\|767 and the value of +{WINT_MAX} +shall be no less than 32\|767; otherwise, +.BR wint_t +shall be defined as an unsigned integer type, and the value of +{WINT_MIN} +shall be 0 and the value of +{WINT_MAX} +shall be no less than 65\|535. +.SS "Macros for Integer Constant Expressions" +.P +The following macros expand to integer constant expressions suitable for +initializing objects that have integer types corresponding to types +defined in the +.IR <stdint.h> +header. Each macro name corresponds to a similar type name listed under +\fIMinimum-width integer types\fR and \fIGreatest-width integer +types\fR. +.P +Each invocation of one of these macros shall expand to an integer +constant expression suitable for use in +.BR #if +preprocessing directives. The type of the expression shall have the +same type as would an expression that is an object of the corresponding +type converted according to the integer promotions. The value of the +expression shall be that of the argument. +.P +The argument in any instance of these macros shall be an unsuffixed +integer constant with a value that does not exceed the limits for the +corresponding type. +.IP " *" 4 +Macros for minimum-width integer constant expressions +.RS 4 +.P +The macro +.IR INTN_C (\c +.IR value ) +shall expand to an integer constant expression corresponding to the +type +.BR int_least \c +.IR N \c +.BR _t . +The macro +.IR UINTN_C (\c +.IR value ) +shall expand to an integer constant expression corresponding to the +type +.BR uint_least \c +.IR N \c +.BR _t . +For example, if +.BR uint_least64_t +is a name for the type +.BR "unsigned long long" , +then +.IR UINT64_C (0x123) +might expand to the integer constant 0x123ULL. +.RE +.IP " *" 4 +Macros for greatest-width integer constant expressions +.RS 4 +.P +The following macro expands to an integer constant expression having +the value specified by its argument and the type +.BR intmax_t : +INTMAX_C(\fIvalue\fR) +.P +The following macro expands to an integer constant expression having +the value specified by its argument and the type +.BR uintmax_t : +UINTMAX_C(\fIvalue\fR) +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +The +.IR <stdint.h> +header is a subset of the +.IR <inttypes.h> +header more suitable for use in freestanding environments, which might +not support the formatted I/O functions. In some environments, if the +formatted conversion support is not wanted, using this header instead +of the +.IR <inttypes.h> +header avoids defining such a large number of macros. +.br +.P +As a consequence of adding +.BR int8_t , +the following are true: +.IP " *" 4 +A byte is exactly 8 bits. +.IP " *" 4 +{CHAR_BIT} +has the value 8, +{SCHAR_MAX} +has the value 127, +{SCHAR_MIN} +has the value \-128, and +{UCHAR_MAX} +has the value 255. +.P +(The POSIX standard explicitly requires 8-bit char and +two's-complement arithmetic.) +.SH "FUTURE DIRECTIONS" +.BR typedef +names beginning with +.BR int +or +.BR uint +and ending with _t may be added to the types defined in the +.IR <stdint.h> +header. Macro names beginning with INT or UINT and ending with _MAX, +_MIN, or _C may be added to the macros defined in the +.IR <stdint.h> +header. +.SH "SEE ALSO" +.IR "\fB<inttypes.h>\fP", +.IR "\fB<signal.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<wchar.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/stdio.h.0p b/upstream/mageia-cauldron/man0p/stdio.h.0p new file mode 100644 index 00000000..6be44a65 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/stdio.h.0p @@ -0,0 +1,329 @@ +'\" et +.TH stdio.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +stdio.h +\(em standard buffered input/output +.SH SYNOPSIS +.LP +.nf +#include <stdio.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <stdio.h> +header shall define the following data types through +.BR typedef : +.IP "\fBFILE\fP" 14 +A structure containing information about a file. +.IP "\fBfpos_t\fP" 14 +A non-array type containing all information needed to specify uniquely +every position within a file. +.IP "\fBoff_t\fP" 14 +As described in +.IR <sys/types.h> . +.IP "\fBsize_t\fP" 14 +As described in +.IR <stddef.h> . +.IP "\fBssize_t\fP" 14 +As described in +.IR <sys/types.h> . +.IP "\fBva_list\fP" 14 +As described in +.IR <stdarg.h> . +.P +The +.IR <stdio.h> +header shall define the following macros which shall expand to +integer constant expressions: +.IP BUFSIZ 14 +Size of +.IR <stdio.h> +buffers. +This shall expand to a positive value. +.IP L_ctermid 14 +Maximum size of character array to hold +\fIctermid\fR() +output. +.IP L_tmpnam 14 +Maximum size of character array to hold +\fItmpnam\fR() +output. +.P +The +.IR <stdio.h> +header shall define the following macros which shall expand to +integer constant expressions with distinct values: +.IP _IOFBF 14 +Input/output fully buffered. +.IP _IOLBF 14 +Input/output line buffered. +.IP _IONBF 14 +Input/output unbuffered. +.P +The +.IR <stdio.h> +header shall define the following macros which shall expand to +integer constant expressions with distinct values: +.IP SEEK_CUR 14 +Seek relative to current position. +.IP SEEK_END 14 +Seek relative to end-of-file. +.IP SEEK_SET 14 +Seek relative to start-of-file. +.P +The +.IR <stdio.h> +header shall define the following macros which shall expand to +integer constant expressions denoting implementation limits: +.IP {FILENAME_MAX} 14 +Maximum size in bytes of the longest pathname that the implementation +guarantees can be opened. +.IP {FOPEN_MAX} 14 +Number of streams which the implementation guarantees can be open +simultaneously. The value is at least eight. +.IP {TMP_MAX} 14 +Minimum number of unique filenames generated by +\fItmpnam\fR(). +Maximum number of times an application can call +\fItmpnam\fR() +reliably. The value of +{TMP_MAX} +is at least 25. +.RS 14 +.P +On XSI-conformant systems, the value of +{TMP_MAX} +is at least 10\|000. +.RE +.P +The +.IR <stdio.h> +header shall define the following macro which shall expand to an integer +constant expression with type +.BR int +and a negative value: +.IP EOF 14 +End-of-file return value. +.P +The +.IR <stdio.h> +header shall define NULL as described in +.IR <stddef.h> . +.br +.P +The +.IR <stdio.h> +header shall define the following macro which shall expand to a +string constant: +.IP P_tmpdir 14 +Default directory prefix for +\fItempnam\fR(). +.P +The +.IR <stdio.h> +header shall define the following macros which shall expand to +expressions of type ``pointer to +.BR FILE '' +that point to the +.BR FILE +objects associated, respectively, with the standard error, input, and +output streams: +.IP "\fIstderr\fR" 14 +Standard error output stream. +.IP "\fIstdin\fR" 14 +Standard input stream. +.IP "\fIstdout\fR" 14 +Standard output stream. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void clearerr(FILE *); +char *ctermid(char *); +int dprintf(int, const char *restrict, ...) +int fclose(FILE *); +FILE *fdopen(int, const char *); +int feof(FILE *); +int ferror(FILE *); +int fflush(FILE *); +int fgetc(FILE *); +int fgetpos(FILE *restrict, fpos_t *restrict); +char *fgets(char *restrict, int, FILE *restrict); +int fileno(FILE *); +void flockfile(FILE *); +FILE *fmemopen(void *restrict, size_t, const char *restrict); +FILE *fopen(const char *restrict, const char *restrict); +int fprintf(FILE *restrict, const char *restrict, ...); +int fputc(int, FILE *); +int fputs(const char *restrict, FILE *restrict); +size_t fread(void *restrict, size_t, size_t, FILE *restrict); +FILE *freopen(const char *restrict, const char *restrict, + FILE *restrict); +int fscanf(FILE *restrict, const char *restrict, ...); +int fseek(FILE *, long, int); +int fseeko(FILE *, off_t, int); +int fsetpos(FILE *, const fpos_t *); +long ftell(FILE *); +off_t ftello(FILE *); +int ftrylockfile(FILE *); +void funlockfile(FILE *); +size_t fwrite(const void *restrict, size_t, size_t, FILE *restrict); +int getc(FILE *); +int getchar(void); +int getc_unlocked(FILE *); +int getchar_unlocked(void); +ssize_t getdelim(char **restrict, size_t *restrict, int, + FILE *restrict); +ssize_t getline(char **restrict, size_t *restrict, FILE *restrict); +char *gets(char *); +FILE *open_memstream(char **, size_t *); +int pclose(FILE *); +void perror(const char *); +FILE *popen(const char *, const char *); +int printf(const char *restrict, ...); +int putc(int, FILE *); +int putchar(int); +int putc_unlocked(int, FILE *); +int putchar_unlocked(int); +int puts(const char *); +int remove(const char *); +int rename(const char *, const char *); +int renameat(int, const char *, int, const char *); +void rewind(FILE *); +int scanf(const char *restrict, ...); +void setbuf(FILE *restrict, char *restrict); +int setvbuf(FILE *restrict, char *restrict, int, size_t); +int snprintf(char *restrict, size_t, const char *restrict, ...); +int sprintf(char *restrict, const char *restrict, ...); +int sscanf(const char *restrict, const char *restrict, ...); +char *tempnam(const char *, const char *); +FILE *tmpfile(void); +char *tmpnam(char *); +int ungetc(int, FILE *); +int vdprintf(int, const char *restrict, va_list); +int vfprintf(FILE *restrict, const char *restrict, va_list); +int vfscanf(FILE *restrict, const char *restrict, va_list); +int vprintf(const char *restrict, va_list); +int vscanf(const char *restrict, va_list); +int vsnprintf(char *restrict, size_t, const char *restrict, + va_list); +int vsprintf(char *restrict, const char *restrict, va_list); +int vsscanf(const char *restrict, const char *restrict, va_list); +.fi +.P +.RE +.P +Inclusion of the +.IR <stdio.h> +header may also make visible all symbols from +.IR <stddef.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +Since standard I/O streams may use an underlying file descriptor to +access the file associated with a stream, application developers need +to be aware that +{FOPEN_MAX} +streams may not be available if file descriptors are being used to access +files that are not associated with streams. +.SH RATIONALE +There is a conflict between the ISO\ C standard and the POSIX definition of the +{TMP_MAX} +macro that is addressed by ISO/IEC\ 9899:\|1999 standard, Defect Report 336. The POSIX standard is +in alignment with the public record of the response to the Defect Report. +This change has not yet been published as part of the ISO\ C standard. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<stdarg.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIclearerr\fR\^(\|)", +.IR "\fIctermid\fR\^(\|)", +.IR "\fIfclose\fR\^(\|)", +.IR "\fIfdopen\fR\^(\|)", +.IR "\fIfeof\fR\^(\|)", +.IR "\fIferror\fR\^(\|)", +.IR "\fIfflush\fR\^(\|)", +.IR "\fIfgetc\fR\^(\|)", +.IR "\fIfgetpos\fR\^(\|)", +.IR "\fIfgets\fR\^(\|)", +.IR "\fIfileno\fR\^(\|)", +.IR "\fIflockfile\fR\^(\|)", +.IR "\fIfmemopen\fR\^(\|)", +.IR "\fIfopen\fR\^(\|)", +.IR "\fIfprintf\fR\^(\|)", +.IR "\fIfputc\fR\^(\|)", +.IR "\fIfputs\fR\^(\|)", +.IR "\fIfread\fR\^(\|)", +.IR "\fIfreopen\fR\^(\|)", +.IR "\fIfscanf\fR\^(\|)", +.IR "\fIfseek\fR\^(\|)", +.IR "\fIfsetpos\fR\^(\|)", +.IR "\fIftell\fR\^(\|)", +.IR "\fIfwrite\fR\^(\|)", +.IR "\fIgetc\fR\^(\|)", +.IR "\fIgetchar\fR\^(\|)", +.IR "\fIgetc_unlocked\fR\^(\|)", +.IR "\fIgetdelim\fR\^(\|)", +.IR "\fIgetopt\fR\^(\|)", +.IR "\fIgets\fR\^(\|)", +.IR "\fIopen_memstream\fR\^(\|)", +.IR "\fIpclose\fR\^(\|)", +.IR "\fIperror\fR\^(\|)", +.IR "\fIpopen\fR\^(\|)", +.IR "\fIputc\fR\^(\|)", +.IR "\fIputchar\fR\^(\|)", +.IR "\fIputs\fR\^(\|)", +.IR "\fIremove\fR\^(\|)", +.IR "\fIrename\fR\^(\|)", +.IR "\fIrewind\fR\^(\|)", +.IR "\fIsetbuf\fR\^(\|)", +.IR "\fIsetvbuf\fR\^(\|)", +.IR "\fIstdin\fR\^", +.IR "\fIsystem\fR\^(\|)", +.IR "\fItempnam\fR\^(\|)", +.IR "\fItmpfile\fR\^(\|)", +.IR "\fItmpnam\fR\^(\|)", +.IR "\fIungetc\fR\^(\|)", +.IR "\fIvfprintf\fR\^(\|)", +.IR "\fIvfscanf\fR\^(\|)" +.ad b +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/stdlib.h.0p b/upstream/mageia-cauldron/man0p/stdlib.h.0p new file mode 100644 index 00000000..c913788e --- /dev/null +++ b/upstream/mageia-cauldron/man0p/stdlib.h.0p @@ -0,0 +1,266 @@ +'\" et +.TH stdlib.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +stdlib.h +\(em standard library definitions +.SH SYNOPSIS +.LP +.nf +#include <stdlib.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <stdlib.h> +header shall define the following macros which shall expand to +integer constant expressions: +.IP EXIT_FAILURE 12 +Unsuccessful termination for +\fIexit\fR(); +evaluates to a non-zero value. +.IP EXIT_SUCCESS 12 +Successful termination for +\fIexit\fR(); +evaluates to 0. +.IP {RAND_MAX} 12 +Maximum value returned by +\fIrand\fR(); +at least 32\|767. +.P +The +.IR <stdlib.h> +header shall define the following macro which shall expand to a +positive integer expression with type +.BR size_t : +.IP {MB_CUR_MAX} 12 +Maximum number of bytes in a character specified by the current +locale (category +.IR LC_CTYPE ). +.P +In the POSIX locale the value of +{MB_CUR_MAX} +shall be 1. +.P +The +.IR <stdlib.h> +header shall define NULL as described in +.IR <stddef.h> . +.P +The +.IR <stdlib.h> +header shall define the following data types through +.BR typedef : +.IP "\fBdiv_t\fP" 12 +Structure type returned by the +\fIdiv\fR() +function. +.IP "\fBldiv_t\fP" 12 +Structure type returned by the +\fIldiv\fR() +function. +.IP "\fBlldiv_t\fP" 12 +Structure type returned by the +\fIlldiv\fR() +function. +.IP "\fBsize_t\fP" 12 +As described in +.IR <stddef.h> . +.IP "\fBwchar_t\fP" 12 +As described in +.IR <stddef.h> . +.P +In addition, the +.IR <stdlib.h> +header shall define the following symbolic constants and macros +as described in +.IR <sys/wait.h> : +.P +.nf +WEXITSTATUS +WIFEXITED +WIFSIGNALED +WIFSTOPPED +WNOHANG +WSTOPSIG +WTERMSIG +WUNTRACED +.fi +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void _Exit(int); +long a64l(const char *); +void abort(void); +int abs(int); +int atexit(void (*)(void)); +double atof(const char *); +int atoi(const char *); +long atol(const char *); +long long atoll(const char *); +void *bsearch(const void *, const void *, size_t, size_t, + int (*)(const void *, const void *)); +void *calloc(size_t, size_t); +div_t div(int, int); +double drand48(void); +double erand48(unsigned short [3]); +void exit(int); +void free(void *); +char *getenv(const char *); +int getsubopt(char **, char *const *, char **); +int grantpt(int); +char *initstate(unsigned, char *, size_t); +long jrand48(unsigned short [3]); +char *l64a(long); +long labs(long); +void lcong48(unsigned short [7]); +ldiv_t ldiv(long, long); +long long llabs(long long); +lldiv_t lldiv(long long, long long); +long lrand48(void); +void *malloc(size_t); +int mblen(const char *, size_t); +size_t mbstowcs(wchar_t *restrict, const char *restrict, size_t); +int mbtowc(wchar_t *restrict, const char *restrict, size_t); +char *mkdtemp(char *); +int mkstemp(char *); +long mrand48(void); +long nrand48(unsigned short [3]); +int posix_memalign(void **, size_t, size_t); +int posix_openpt(int); +char *ptsname(int); +int putenv(char *); +void qsort(void *, size_t, size_t, int (*)(const void *, + const void *)); +int rand(void); +int rand_r(unsigned *); +long random(void); +void *realloc(void *, size_t); +char *realpath(const char *restrict, char *restrict); +unsigned short *seed48(unsigned short [3]); +int setenv(const char *, const char *, int); +void setkey(const char *); +char *setstate(char *); +void srand(unsigned); +void srand48(long); +void srandom(unsigned); +double strtod(const char *restrict, char **restrict); +float strtof(const char *restrict, char **restrict); +long strtol(const char *restrict, char **restrict, int); +long double strtold(const char *restrict, char **restrict); +long long strtoll(const char *restrict, char **restrict, int); +unsigned long strtoul(const char *restrict, char **restrict, int); +unsigned long long + strtoull(const char *restrict, char **restrict, int); +int system(const char *); +int unlockpt(int); +int unsetenv(const char *); +size_t wcstombs(char *restrict, const wchar_t *restrict, size_t); +int wctomb(char *, wchar_t); +.fi +.P +.RE +.P +Inclusion of the +.IR <stdlib.h> +header may also make visible all symbols from +.IR <stddef.h> , +.IR <limits.h> , +.IR <math.h> , +and +.IR <sys/wait.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<limits.h>\fP", +.IR "\fB<math.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<sys_wait.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fI_Exit\fR\^(\|)", +.IR "\fIa64l\fR\^(\|)", +.IR "\fIabort\fR\^(\|)", +.IR "\fIabs\fR\^(\|)", +.IR "\fIatexit\fR\^(\|)", +.IR "\fIatof\fR\^(\|)", +.IR "\fIatoi\fR\^(\|)", +.IR "\fIatol\fR\^(\|)", +.IR "\fIbsearch\fR\^(\|)", +.IR "\fIcalloc\fR\^(\|)", +.IR "\fIdiv\fR\^(\|)", +.IR "\fIdrand48\fR\^(\|)", +.IR "\fIexit\fR\^(\|)", +.IR "\fIfree\fR\^(\|)", +.IR "\fIgetenv\fR\^(\|)", +.IR "\fIgetsubopt\fR\^(\|)", +.IR "\fIgrantpt\fR\^(\|)", +.IR "\fIinitstate\fR\^(\|)", +.IR "\fIlabs\fR\^(\|)", +.IR "\fIldiv\fR\^(\|)", +.IR "\fImalloc\fR\^(\|)", +.IR "\fImblen\fR\^(\|)", +.IR "\fImbstowcs\fR\^(\|)", +.IR "\fImbtowc\fR\^(\|)", +.IR "\fImkdtemp\fR\^(\|)", +.IR "\fIposix_memalign\fR\^(\|)", +.IR "\fIposix_openpt\fR\^(\|)", +.IR "\fIptsname\fR\^(\|)", +.IR "\fIputenv\fR\^(\|)", +.IR "\fIqsort\fR\^(\|)", +.IR "\fIrand\fR\^(\|)", +.IR "\fIrealloc\fR\^(\|)", +.IR "\fIrealpath\fR\^(\|)", +.IR "\fIsetenv\fR\^(\|)", +.IR "\fIsetkey\fR\^(\|)", +.IR "\fIstrtod\fR\^(\|)", +.IR "\fIstrtol\fR\^(\|)", +.IR "\fIstrtoul\fR\^(\|)", +.IR "\fIsystem\fR\^(\|)", +.IR "\fIunlockpt\fR\^(\|)", +.IR "\fIunsetenv\fR\^(\|)", +.IR "\fIwcstombs\fR\^(\|)", +.IR "\fIwctomb\fR\^(\|)" +.ad b +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/string.h.0p b/upstream/mageia-cauldron/man0p/string.h.0p new file mode 100644 index 00000000..e1d36b08 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/string.h.0p @@ -0,0 +1,148 @@ +'\" et +.TH string.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +string.h +\(em string operations +.SH SYNOPSIS +.LP +.nf +#include <string.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <string.h> +header shall define NULL and +.BR size_t +as described in +.IR <stddef.h> . +.P +The +.IR <string.h> +header shall define the +.BR locale_t +type as described in +.IR <locale.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided for use with ISO\ C standard +compilers. +.sp +.RS 4 +.nf + +void *memccpy(void *restrict, const void *restrict, int, size_t); +void *memchr(const void *, int, size_t); +int memcmp(const void *, const void *, size_t); +void *memcpy(void *restrict, const void *restrict, size_t); +void *memmove(void *, const void *, size_t); +void *memset(void *, int, size_t); +char *stpcpy(char *restrict, const char *restrict); +char *stpncpy(char *restrict, const char *restrict, size_t); +char *strcat(char *restrict, const char *restrict); +char *strchr(const char *, int); +int strcmp(const char *, const char *); +int strcoll(const char *, const char *); +int strcoll_l(const char *, const char *, locale_t); +char *strcpy(char *restrict, const char *restrict); +size_t strcspn(const char *, const char *); +char *strdup(const char *); +char *strerror(int); +char *strerror_l(int, locale_t); +int strerror_r(int, char *, size_t); +size_t strlen(const char *); +char *strncat(char *restrict, const char *restrict, size_t); +int strncmp(const char *, const char *, size_t); +char *strncpy(char *restrict, const char *restrict, size_t); +char *strndup(const char *, size_t); +size_t strnlen(const char *, size_t); +char *strpbrk(const char *, const char *); +char *strrchr(const char *, int); +char *strsignal(int); +size_t strspn(const char *, const char *); +char *strstr(const char *, const char *); +char *strtok(char *restrict, const char *restrict); +char *strtok_r(char *restrict, const char *restrict, char **restrict); +size_t strxfrm(char *restrict, const char *restrict, size_t); +size_t strxfrm_l(char *restrict, const char *restrict, + size_t, locale_t); +.fi +.P +.RE +.P +Inclusion of the +.IR <string.h> +header may also make visible all symbols from +.IR <stddef.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<locale.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fImemccpy\fR\^(\|)", +.IR "\fImemchr\fR\^(\|)", +.IR "\fImemcmp\fR\^(\|)", +.IR "\fImemcpy\fR\^(\|)", +.IR "\fImemmove\fR\^(\|)", +.IR "\fImemset\fR\^(\|)", +.IR "\fIstrcat\fR\^(\|)", +.IR "\fIstrchr\fR\^(\|)", +.IR "\fIstrcmp\fR\^(\|)", +.IR "\fIstrcoll\fR\^(\|)", +.IR "\fIstrcpy\fR\^(\|)", +.IR "\fIstrcspn\fR\^(\|)", +.IR "\fIstrdup\fR\^(\|)", +.IR "\fIstrerror\fR\^(\|)", +.IR "\fIstrlen\fR\^(\|)", +.IR "\fIstrncat\fR\^(\|)", +.IR "\fIstrncmp\fR\^(\|)", +.IR "\fIstrncpy\fR\^(\|)", +.IR "\fIstrpbrk\fR\^(\|)", +.IR "\fIstrrchr\fR\^(\|)", +.IR "\fIstrsignal\fR\^(\|)", +.IR "\fIstrspn\fR\^(\|)", +.IR "\fIstrstr\fR\^(\|)", +.IR "\fIstrtok\fR\^(\|)", +.IR "\fIstrxfrm\fR\^(\|)" +.ad b +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/strings.h.0p b/upstream/mageia-cauldron/man0p/strings.h.0p new file mode 100644 index 00000000..8086dea4 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/strings.h.0p @@ -0,0 +1,80 @@ +'\" et +.TH strings.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +strings.h +\(em string operations +.SH SYNOPSIS +.LP +.nf +#include <strings.h> +.fi +.SH DESCRIPTION +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided for use with ISO\ C standard +compilers. +.sp +.RS 4 +.nf + +int ffs(int); +int strcasecmp(const char *, const char *); +int strcasecmp_l(const char *, const char *, locale_t); +int strncasecmp(const char *, const char *, size_t); +int strncasecmp_l(const char *, const char *, size_t, locale_t); +.fi +.P +.RE +.P +The +.IR <strings.h> +header shall define the +.BR locale_t +type as described in +.IR <locale.h> . +.P +The +.IR <strings.h> +header shall define the +.BR size_t +type as described in +.IR <sys/types.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<locale.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIffs\fR\^(\|)", +.IR "\fIstrcasecmp\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/stropts.h.0p b/upstream/mageia-cauldron/man0p/stropts.h.0p new file mode 100644 index 00000000..b06aac39 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/stropts.h.0p @@ -0,0 +1,441 @@ +'\" et +.TH stropts.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +stropts.h +\(em STREAMS interface (\fBSTREAMS\fP) +.SH SYNOPSIS +.LP +.nf +#include <stropts.h> +.fi +.SH DESCRIPTION +The +.IR <stropts.h> +header shall define the +.BR bandinfo +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int bi_flag \fRFlushing type.\fR +unsigned char bi_pri \fRPriority band.\fR +.fi +.P +.RE +.P +The +.IR <stropts.h> +header shall define the +.BR strpeek +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +struct strbuf ctlbuf \fRThe control portion of the message.\fR +struct strbuf databuf \fRThe data portion of the message.\fR +t_uscalar_t flags \fRRS_HIPRI or 0.\fR +.fi +.P +.RE +.P +The +.IR <stropts.h> +header shall define the +.BR strbuf +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +char *buf \fRPointer to buffer.\fP +int len \fRLength of data.\fP +int maxlen \fRMaximum buffer length.\fP +.fi +.P +.RE +.P +The +.IR <stropts.h> +header shall define the +.BR strfdinsert +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +struct strbuf ctlbuf \fRThe control portion of the message.\fR +struct strbuf databuf \fRThe data portion of the message.\fR +int fildes \fRFile descriptor of the other STREAM.\fR +t_uscalar_t flags \fRRS_HIPRI or 0.\fR +int offset \fRRelative location of the stored value.\fR +.fi +.P +.RE +.P +The +.IR <stropts.h> +header shall define the +.BR strioctl +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int ic_cmd \fIioctl\fR(\|) command.\fR +char *ic_dp \fRPointer to buffer.\fR +int ic_len \fRLength of data.\fR +int ic_timout \fRTimeout for response.\fR +.fi +.P +.RE +.P +The +.IR <stropts.h> +header shall define the +.BR strrecvfd +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int fd \fRReceived file descriptor.\fR +gid_t gid \fRGID of sender.\fR +uid_t uid \fRUID of sender.\fR +.fi +.P +.RE +.P +The +.IR <stropts.h> +header shall define the +.BR uid_t +and +.BR gid_t +types through +.BR typedef , +as described in +.IR <sys/types.h> . +.P +The +.IR <stropts.h> +header shall define the +.BR t_scalar_t +and +.BR t_uscalar_t +types, respectively, as signed and unsigned opaque types of equal +length of at least 32 bits. +.P +The +.IR <stropts.h> +header shall define the +.BR str_list +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +struct str_mlist *sl_modlist \fRSTREAMS module names.\fR +int sl_nmods \fRNumber of STREAMS module names.\fR +.fi +.P +.RE +.P +The +.IR <stropts.h> +header shall define the +.BR str_mlist +structure, which shall include at least the following member: +.sp +.RS 4 +.nf + +char l_name[FMNAMESZ+1] \fRA STREAMS module name.\fR +.fi +.P +.RE +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constants for use +as the +.IR request +argument to +\fIioctl\fR(): +.IP I_ATMARK 12 +Is the top message ``marked''? +.IP I_CANPUT 12 +Is a band writable? +.IP I_CKBAND 12 +See if any messages exist in a band. +.IP I_FDINSERT 12 +Send implementation-defined information about another STREAM. +.IP I_FIND 12 +Look for a STREAMS module. +.IP I_FLUSH 12 +Flush a STREAM. +.IP I_FLUSHBAND 12 +Flush one band of a STREAM. +.IP I_GETBAND 12 +Get the band of the top message on a STREAM. +.IP I_GETCLTIME 12 +Get close time delay. +.IP I_GETSIG 12 +Retrieve current notification signals. +.IP I_GRDOPT 12 +Get the read mode. +.IP I_GWROPT 12 +Get the write mode. +.IP I_LINK 12 +Connect two STREAMs. +.IP I_LIST 12 +Get all the module names on a STREAM. +.IP I_LOOK 12 +Get the top module name. +.IP I_NREAD 12 +Size the top message. +.IP I_PEEK 12 +Peek at the top message on a STREAM. +.IP I_PLINK 12 +Persistently connect two STREAMs. +.IP I_POP 12 +Pop a STREAMS module. +.IP I_PUNLINK 12 +Dismantle a persistent STREAMS link. +.IP I_PUSH 12 +Push a STREAMS module. +.IP I_RECVFD 12 +Get a file descriptor sent via I_SENDFD. +.IP I_SENDFD 12 +Pass a file descriptor through a STREAMS pipe. +.IP I_SETCLTIME 12 +Set close time delay. +.IP I_SETSIG 12 +Ask for notification signals. +.IP I_SRDOPT 12 +Set the read mode. +.IP I_STR 12 +Send a STREAMS +\fIioctl\fR(). +.IP I_SWROPT 12 +Set the write mode. +.IP I_UNLINK 12 +Disconnect two STREAMs. +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constant for use +with I_LOOK: +.IP FMNAMESZ 12 +The minimum size in bytes of the buffer referred to by the +.IR arg +argument. +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constants for use +with I_FLUSH: +.IP FLUSHR 12 +Flush read queues. +.IP FLUSHRW 12 +Flush read and write queues. +.IP FLUSHW 12 +Flush write queues. +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constants for use +with I_SETSIG: +.IP S_BANDURG 12 +When used in conjunction with S_RDBAND, SIGURG is generated instead of +SIGPOLL when a priority message reaches the front of the STREAM head +read queue. +.IP S_ERROR 12 +Notification of an error condition reaches the STREAM head. +.IP S_HANGUP 12 +Notification of a hangup reaches the STREAM head. +.IP S_HIPRI 12 +A high-priority message is present on a STREAM head read queue. +.IP S_INPUT 12 +A message, other than a high-priority message, has arrived at the head +of a STREAM head read queue. +.IP S_MSG 12 +A STREAMS signal message that contains the SIGPOLL signal reaches the +front of the STREAM head read queue. +.IP S_OUTPUT 12 +The write queue for normal data (priority band 0) just below the STREAM +head is no longer full. This notifies the process that there is room +on the queue for sending (or writing) normal data downstream. +.IP S_RDBAND 12 +A message with a non-zero priority band has arrived at the head of a +STREAM head read queue. +.IP S_RDNORM 12 +A normal (priority band set to 0) message has arrived at the head of a +STREAM head read queue. +.IP S_WRBAND 12 +The write queue for a non-zero priority band just below the STREAM head +is no longer full. +.IP S_WRNORM 12 +Equivalent to S_OUTPUT. +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constant for use +with I_PEEK: +.IP RS_HIPRI 12 +Only look for high-priority messages. +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constants for use +with I_SRDOPT: +.IP RMSGD 12 +Message-discard mode. +.IP RMSGN 12 +Message-non-discard mode. +.IP RNORM 12 +Byte-STREAM mode, the default. +.IP RPROTDAT 12 +Deliver the control part of a message as data when a process issues a +\fIread\fR(). +.IP RPROTDIS 12 +Discard the control part of a message, delivering any data part, when a +process issues a +\fIread\fR(). +.IP RPROTNORM 12 +Fail +\fIread\fR() +with +.BR [EBADMSG] +if a message containing a control part is at the front of the STREAM +head read queue. +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constant for use +with I_SWOPT: +.IP SNDZERO 12 +Send a zero-length message downstream when a +\fIwrite\fR() +of 0 bytes occurs. +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constants for use +with I_ATMARK: +.IP ANYMARK 12 +Check if the message is marked. +.IP LASTMARK 12 +Check if the message is the last one marked on the queue. +.P +The +.IR <stropts.h> +header shall define at least the following symbolic constant for use +with I_UNLINK: +.IP MUXID_ALL 12 +Unlink all STREAMs linked to the STREAM associated with +.IR fildes . +.P +The +.IR <stropts.h> +header shall define the following symbolic constants for +\fIgetmsg\fR(), +\fIgetpmsg\fR(), +\fIputmsg\fR(), +and +\fIputpmsg\fR(): +.IP MORECTL 12 +More control information is left in message. +.IP MOREDATA 12 +More data is left in message. +.IP MSG_ANY 12 +Receive any message. +.IP MSG_BAND 12 +Receive message from specified band. +.IP MSG_HIPRI 12 +Send/receive high-priority message. +.P +The +.IR <stropts.h> +header may make visible all of the symbols from +.IR <unistd.h> . +.P +The +.IR <stropts.h> +header may also define macros for message types using names that +start with +.IR M_ . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int fattach(int, const char *); +int fdetach(const char *); +int getmsg(int, struct strbuf *restrict, struct strbuf *restrict, + int *restrict); +int getpmsg(int, struct strbuf *restrict, struct strbuf *restrict, + int *restrict, int *restrict); +int ioctl(int, int, ...); +int isastream(int); +int putmsg(int, const struct strbuf *, const struct strbuf *, int); +int putpmsg(int, const struct strbuf *, const struct strbuf *, int, + int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP", +.IR "\fB<unistd.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIclose\fR\^(\|)", +.IR "\fIfattach\fR\^(\|)", +.IR "\fIfcntl\fR\^(\|)", +.IR "\fIfdetach\fR\^(\|)", +.IR "\fIgetmsg\fR\^(\|)", +.IR "\fIioctl\fR\^(\|)", +.IR "\fIisastream\fR\^(\|)", +.IR "\fIopen\fR\^(\|)", +.IR "\fIpipe\fR\^(\|)", +.IR "\fIread\fR\^(\|)", +.IR "\fIpoll\fR\^(\|)", +.IR "\fIputmsg\fR\^(\|)", +.IR "\fIsignal\fR\^(\|)", +.IR "\fIwrite\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_ipc.h.0p b/upstream/mageia-cauldron/man0p/sys_ipc.h.0p new file mode 100644 index 00000000..c2712102 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_ipc.h.0p @@ -0,0 +1,122 @@ +'\" et +.TH sys_ipc.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/ipc.h +\(em XSI interprocess communication access structure +.SH SYNOPSIS +.LP +.nf +#include <sys/ipc.h> +.fi +.SH DESCRIPTION +The +.IR <sys/ipc.h> +header is used by three mechanisms for XSI interprocess communication +(IPC): +messages, semaphores, and shared memory. All use a common structure +type, +.BR ipc_perm , +to pass information used in determining permission to perform an IPC +operation. +.P +The +.IR <sys/ipc.h> +header shall define the +.BR ipc_perm +structure, which shall include the following members: +.sp +.RS 4 +.nf + +uid_t uid \fROwner's user ID.\fR +gid_t gid \fROwner's group ID.\fR +uid_t cuid \fRCreator's user ID.\fR +gid_t cgid \fRCreator's group ID.\fR +mode_t mode \fRRead/write permission.\fR +.fi +.P +.RE +.P +The +.IR <sys/ipc.h> +header shall define the +.BR uid_t , +.BR gid_t , +.BR mode_t , +and +.BR key_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <sys/ipc.h> +header shall define the following symbolic constants. +.P +Mode bits: +.IP IPC_CREAT 12 +Create entry if key does not exist. +.IP IPC_EXCL 12 +Fail if key exists. +.IP IPC_NOWAIT 12 +Error if request must wait. +.P +Keys: +.IP IPC_PRIVATE 12 +Private key. +.P +Control commands: +.IP IPC_RMID 12 +Remove identifier. +.IP IPC_SET 12 +Set options. +.IP IPC_STAT 12 +Get options. +.P +The following shall be declared as a function and may also be defined +as a macro. A function prototype shall be provided. +.sp +.RS 4 +.nf + +key_t ftok(const char *, int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIftok\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_mman.h.0p b/upstream/mageia-cauldron/man0p/sys_mman.h.0p new file mode 100644 index 00000000..986971ca --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_mman.h.0p @@ -0,0 +1,215 @@ +'\" et +.TH sys_mman.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/mman.h +\(em memory management declarations +.SH SYNOPSIS +.LP +.nf +#include <sys/mman.h> +.fi +.SH DESCRIPTION +The +.IR <sys/mman.h> +header shall define the following symbolic constants for use as +protection options: +.IP PROT_EXEC 14 +Page can be executed. +.IP PROT_NONE 14 +Page cannot be accessed. +.IP PROT_READ 14 +Page can be read. +.IP PROT_WRITE 14 +Page can be written. +.P +The +.IR <sys/mman.h> +header shall define the following symbolic constants for use as +flag options: +.IP MAP_FIXED 14 +Interpret +.IR addr +exactly. +.IP MAP_PRIVATE 14 +Changes are private. +.IP MAP_SHARED 14 +Share changes. +.P +The +.IR <sys/mman.h> +header shall define the following symbolic constants for the +\fImsync\fR() +function: +.IP MS_ASYNC 14 +Perform asynchronous writes. +.IP MS_INVALIDATE 14 +Invalidate mappings. +.IP MS_SYNC 14 +Perform synchronous writes. +.P +The +.IR <sys/mman.h> +header shall define the following symbolic constants for the +\fImlockall\fR() +function: +.IP MCL_CURRENT 14 +Lock currently mapped pages. +.IP MCL_FUTURE 14 +Lock pages that become mapped. +.P +The +.IR <sys/mman.h> +header shall define the symbolic constant MAP_FAILED which shall +have type +.BR "void *" +and shall be used to indicate a failure from the +\fImmap\fR() +function . +.P +If the Advisory Information option is supported, the +.IR <sys/mman.h> +header shall define symbolic constants for the +.IR advice +argument to the +\fIposix_madvise\fR() +function as follows: +.IP POSIX_MADV_DONTNEED 6 +.br +The application expects that it will not access the specified range in +the near future. +.IP POSIX_MADV_NORMAL 6 +.br +The application has no advice to give on its behavior with respect to +the specified range. It is the default characteristic if no advice is +given for a range of memory. +.IP POSIX_MADV_RANDOM 6 +.br +The application expects to access the specified range in a random +order. +.IP POSIX_MADV_SEQUENTIAL 6 +.br +The application expects to access the specified range sequentially from +lower addresses to higher addresses. +.IP POSIX_MADV_WILLNEED 6 +.br +The application expects to access the specified range in the near +future. +.P +The +.IR <sys/mman.h> +header shall define the following symbolic constants for use as +flags for the +\fIposix_typed_mem_open\fR() +function: +.IP POSIX_TYPED_MEM_ALLOCATE 6 +.br +Allocate on +\fImmap\fR(). +.IP POSIX_TYPED_MEM_ALLOCATE_CONTIG 6 +.br +Allocate contiguously on +\fImmap\fR(). +.IP POSIX_TYPED_MEM_MAP_ALLOCATABLE 6 +.br +Map on +\fImmap\fR(), +without affecting allocatability. +.P +The +.IR <sys/mman.h> +header shall define the +.BR mode_t , +.BR off_t , +and +.BR size_t +types as described in +.IR "\fB<sys_types.h>\fP". +.P +The +.IR <sys/mman.h> +header shall define the +.BR posix_typed_mem_info +structure, which shall include at least the following member: +.sp +.RS 4 +.nf + +size_t posix_tmi_length \fRMaximum length which may be allocated\fR + \fRfrom a typed memory object.\fR +.fi +.P +.RE +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int mlock(const void *, size_t); +int mlockall(int); +void *mmap(void *, size_t, int, int, int, off_t); +int mprotect(void *, size_t, int); +int msync(void *, size_t, int); +int munlock(const void *, size_t); +int munlockall(void); +int munmap(void *, size_t); +int posix_madvise(void *, size_t, int); +int posix_mem_offset(const void *restrict, size_t, off_t *restrict, + size_t *restrict, int *restrict); +int posix_typed_mem_get_info(int, struct posix_typed_mem_info *); +int posix_typed_mem_open(const char *, int, int); +int shm_open(const char *, int, mode_t); +int shm_unlink(const char *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fImlock\fR\^(\|)", +.IR "\fImlockall\fR\^(\|)", +.IR "\fImmap\fR\^(\|)", +.IR "\fImprotect\fR\^(\|)", +.IR "\fImsync\fR\^(\|)", +.IR "\fImunmap\fR\^(\|)", +.IR "\fIposix_madvise\fR\^(\|)", +.IR "\fIposix_mem_offset\fR\^(\|)", +.IR "\fIposix_typed_mem_get_info\fR\^(\|)", +.IR "\fIposix_typed_mem_open\fR\^(\|)", +.IR "\fIshm_open\fR\^(\|)", +.IR "\fIshm_unlink\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_msg.h.0p b/upstream/mageia-cauldron/man0p/sys_msg.h.0p new file mode 100644 index 00000000..bb9b5477 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_msg.h.0p @@ -0,0 +1,124 @@ +'\" et +.TH sys_msg.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/msg.h +\(em XSI message queue structures +.SH SYNOPSIS +.LP +.nf +#include <sys/msg.h> +.fi +.SH DESCRIPTION +The +.IR <sys/msg.h> +header shall define the following data types through +.BR typedef : +.IP "\fBmsgqnum_t\fP" 14 +Used for the number of messages in the message queue. +.IP "\fBmsglen_t\fP" 14 +Used for the number of bytes allowed in a message queue. +.P +These types shall be unsigned integer types that are able to store +values at least as large as a type +.BR "unsigned short" . +.P +The +.IR <sys/msg.h> +header shall define the following symbolic constant as a message +operation flag: +.IP MSG_NOERROR 14 +No error if big message. +.P +The +.IR <sys/msg.h> +header shall define the +.BR msqid_ds +structure, which shall include the following members: +.sp +.RS 4 +.nf + +struct ipc_perm msg_perm \fROperation permission structure.\fR +msgqnum_t msg_qnum \fRNumber of messages currently on queue.\fR +msglen_t msg_qbytes \fRMaximum number of bytes allowed on queue.\fR +pid_t msg_lspid \fRProcess ID of last \fImsgsnd\fP\^(\|).\fR +pid_t msg_lrpid \fRProcess ID of last \fImsgrcv\fP\^(\|).\fR +time_t msg_stime \fRTime of last \fImsgsnd\fP\^(\|).\fR +time_t msg_rtime \fRTime of last \fImsgrcv\fP\^(\|).\fR +time_t msg_ctime \fRTime of last change.\fR +.fi +.P +.RE +.P +The +.IR <sys/msg.h> +header shall define the +.BR pid_t , +.BR size_t , +.BR ssize_t , +and +.BR time_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int msgctl(int, int, struct msqid_ds *); +int msgget(key_t, int); +ssize_t msgrcv(int, void *, size_t, long, int); +int msgsnd(int, const void *, size_t, int); +.fi +.P +.RE +.P +In addition, the +.IR <sys/msg.h> +header shall include the +.IR <sys/ipc.h> +header. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_ipc.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fImsgctl\fR\^(\|)", +.IR "\fImsgget\fR\^(\|)", +.IR "\fImsgrcv\fR\^(\|)", +.IR "\fImsgsnd\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_resource.h.0p b/upstream/mageia-cauldron/man0p/sys_resource.h.0p new file mode 100644 index 00000000..40f45c1c --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_resource.h.0p @@ -0,0 +1,209 @@ +'\" et +.TH sys_resource.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/resource.h +\(em definitions for XSI resource operations +.SH SYNOPSIS +.LP +.nf +#include <sys/resource.h> +.fi +.SH DESCRIPTION +The +.IR <sys/resource.h> +header shall define the following symbolic constants as possible values +of the +.IR which +argument of +\fIgetpriority\fR() +and +\fIsetpriority\fR(): +.IP PRIO_PROCESS 16 +Identifies the +.IR who +argument as a process ID. +.IP PRIO_PGRP 16 +Identifies the +.IR who +argument as a process group ID. +.IP PRIO_USER 16 +Identifies the +.IR who +argument as a user ID. +.P +The +.IR <sys/resource.h> +header shall define the following type through +.BR typedef : +.IP "\fBrlim_t\fR" 16 +Unsigned integer type used for limit values. +.P +The +.IR <sys/resource.h> +header shall define the following symbolic constants, which shall have +values suitable for use in +.BR #if +preprocessing directives: +.IP RLIM_INFINITY 16 +A value of +.BR rlim_t +indicating no limit. +.IP RLIM_SAVED_MAX 16 +A value of type +.BR rlim_t +indicating an unrepresentable saved hard limit. +.IP RLIM_SAVED_CUR 16 +A value of type +.BR rlim_t +indicating an unrepresentable saved soft limit. +.P +On implementations where all resource limits are representable in an +object of type +.BR rlim_t , +RLIM_SAVED_MAX and RLIM_SAVED_CUR need not be distinct from +RLIM_INFINITY. +.P +The +.IR <sys/resource.h> +header shall define the following symbolic constants as possible values +of the +.IR who +parameter of +\fIgetrusage\fR(): +.IP RUSAGE_SELF 16 +Returns information about the current process. +.IP RUSAGE_CHILDREN 16 +Returns information about children of the current process. +.P +The +.IR <sys/resource.h> +header shall define the +.BR rlimit +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +rlim_t rlim_cur \fRThe current (soft) limit.\fR +rlim_t rlim_max \fRThe hard limit.\fR +.fi +.P +.RE +.P +The +.IR <sys/resource.h> +header shall define the +.BR rusage +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +struct timeval ru_utime \fRUser time used.\fR +struct timeval ru_stime \fRSystem time used.\fR +.fi +.P +.RE +.P +The +.IR <sys/resource.h> +header shall define the +.BR timeval +structure as described in +.IR <sys/time.h> . +.P +The +.IR <sys/resource.h> +header shall define the following symbolic constants as possible values +for the +.IR resource +argument of +\fIgetrlimit\fR() +and +\fIsetrlimit\fR(): +.IP RLIMIT_CORE 16 +Limit on size of +.BR core +file. +.IP RLIMIT_CPU 16 +Limit on CPU time per process. +.IP RLIMIT_DATA 16 +Limit on data segment size. +.IP RLIMIT_FSIZE 16 +Limit on file size. +.IP RLIMIT_NOFILE 16 +Limit on number of open files. +.IP RLIMIT_STACK 16 +Limit on stack size. +.IP RLIMIT_AS 16 +Limit on address space size. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int getpriority(int, id_t); +int getrlimit(int, struct rlimit *); +int getrusage(int, struct rusage *); +int setpriority(int, id_t, int); +int setrlimit(int, const struct rlimit *); +.fi +.P +.RE +.P +The +.IR <sys/resource.h> +header shall define the +.BR id_t +type through +.BR typedef , +as described in +.IR <sys/types.h> . +.P +Inclusion of the +.IR <sys/resource.h> +header may also make visible all symbols from +.IR <sys/time.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_time.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIgetpriority\fR\^(\|)", +.IR "\fIgetrlimit\fR\^(\|)", +.IR "\fIgetrusage\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_select.h.0p b/upstream/mageia-cauldron/man0p/sys_select.h.0p new file mode 100644 index 00000000..077af630 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_select.h.0p @@ -0,0 +1,146 @@ +'\" et +.TH sys_select.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/select.h +\(em select types +.SH SYNOPSIS +.LP +.nf +#include <sys/select.h> +.fi +.SH DESCRIPTION +The +.IR <sys/select.h> +header shall define the +.BR timeval +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +time_t tv_sec \fRSeconds.\fR +suseconds_t tv_usec \fRMicroseconds.\fR +.fi +.P +.RE +.P +The +.IR <sys/select.h> +header shall define the +.BR time_t +and +.BR suseconds_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <sys/select.h> +header shall define the +.BR sigset_t +type as described in +.IR <signal.h> . +.P +The +.IR <sys/select.h> +header shall define the +.BR timespec +structure as described in +.IR <time.h> . +.P +The +.IR <sys/select.h> +header shall define the +.BR fd_set +type as a structure. +.P +The +.IR <sys/select.h> +header shall define the following symbolic constant, which shall have +a value suitable for use in +.BR #if +preprocessing directives: +.IP FD_SETSIZE 12 +Maximum number of file descriptors in an +.BR fd_set +structure. +.P +The following shall be declared as functions, defined as macros, or +both. If functions are declared, function prototypes shall be +provided. +.sp +.RS 4 +.nf + +void FD_CLR(int, fd_set *); +int FD_ISSET(int, fd_set *); +void FD_SET(int, fd_set *); +void FD_ZERO(fd_set *); +.fi +.P +.RE +.P +If implemented as macros, these may evaluate their arguments more than +once, so applications should ensure that the arguments they supply are +never expressions with side-effects. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int pselect(int, fd_set *restrict, fd_set *restrict, fd_set *restrict, + const struct timespec *restrict, const sigset_t *restrict); +int select(int, fd_set *restrict, fd_set *restrict, fd_set *restrict, + struct timeval *restrict); +.fi +.P +.RE +.P +Inclusion of the +.IR <sys/select.h> +header may make visible all symbols from the headers +.IR <signal.h> +and +.IR <time.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<signal.h>\fP", +.IR "\fB<sys_time.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<time.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIpselect\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_sem.h.0p b/upstream/mageia-cauldron/man0p/sys_sem.h.0p new file mode 100644 index 00000000..869d0e8e --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_sem.h.0p @@ -0,0 +1,164 @@ +'\" et +.TH sys_sem.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/sem.h +\(em XSI semaphore facility +.SH SYNOPSIS +.LP +.nf +#include <sys/sem.h> +.fi +.SH DESCRIPTION +The +.IR <sys/sem.h> +header shall define the following symbolic constant for use as a +semaphore operation flag: +.IP SEM_UNDO 12 +Set up adjust on exit entry. +.P +The +.IR <sys/sem.h> +header shall define the following symbolic constants for use as +commands for the +\fIsemctl\fR() +function: +.IP GETNCNT 12 +Get +.IR semncnt . +.IP GETPID 12 +Get +.IR sempid . +.IP GETVAL 12 +Get +.IR semval . +.IP GETALL 12 +Get all cases of +.IR semval . +.IP GETZCNT 12 +Get +.IR semzcnt . +.IP SETVAL 12 +Set +.IR semval . +.IP SETALL 12 +Set all cases of +.IR semval . +.P +The +.IR <sys/sem.h> +header shall define the +.BR semid_ds +structure, which shall include the following members: +.sp +.RS 4 +.nf + +struct ipc_perm sem_perm \fROperation permission structure.\fR +unsigned short sem_nsems \fRNumber of semaphores in set.\fR +time_t sem_otime \fRLast \fIsemop\fP\^(\|) time.\fR +time_t sem_ctime \fRLast time changed by \fIsemctl\fP\^(\|).\fR +.fi +.P +.RE +.P +The +.IR <sys/sem.h> +header shall define the +.BR pid_t , +.BR size_t , +and +.BR time_t +types as described in +.IR <sys/types.h> . +.P +A semaphore shall be represented by an anonymous structure, +which shall include the following members: +.sp +.RS 4 +.nf + +unsigned short semval \fRSemaphore value.\fR +pid_t sempid \fRProcess ID of last operation.\fR +unsigned short semncnt \fRNumber of processes waiting for \fIsemval\fR + \fRto become greater than current value.\fR +unsigned short semzcnt \fRNumber of processes waiting for \fIsemval\fR + \fRto become 0.\fR +.fi +.P +.RE +.P +The +.IR <sys/sem.h> +header shall define the +.BR sembuf +structure, which shall include the following members: +.sp +.RS 4 +.nf + +unsigned short sem_num \fRSemaphore number.\fR +short sem_op \fRSemaphore operation.\fR +short sem_flg \fROperation flags.\fR +.fi +.P +.RE +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int semctl(int, int, int, ...); +int semget(key_t, int, int); +int semop(int, struct sembuf *, size_t); +.fi +.P +.RE +.P +In addition, the +.IR <sys/sem.h> +header shall include the +.IR <sys/ipc.h> +header. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_ipc.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIsemctl\fR\^(\|)", +.IR "\fIsemget\fR\^(\|)", +.IR "\fIsemop\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_shm.h.0p b/upstream/mageia-cauldron/man0p/sys_shm.h.0p new file mode 100644 index 00000000..65f702d9 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_shm.h.0p @@ -0,0 +1,122 @@ +'\" et +.TH sys_shm.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/shm.h +\(em XSI shared memory facility +.SH SYNOPSIS +.LP +.nf +#include <sys/shm.h> +.fi +.SH DESCRIPTION +The +.IR <sys/shm.h> +header shall define the following symbolic constants: +.IP SHM_RDONLY 12 +Attach read-only (else read-write). +.IP SHM_RND 12 +Round attach address to SHMLBA. +.IP SHMLBA 12 +Segment low boundary address multiple. +.P +The +.IR <sys/shm.h> +header shall define the following data types through +.BR typedef : +.IP "\fBshmatt_t\fP" 12 +Unsigned integer used for the number of current attaches that must be +able to store values at least as large as a type +.BR "unsigned short" . +.P +The +.IR <sys/shm.h> +header shall define the +.BR shmid_ds +structure, which shall include the following members: +.sp +.RS 4 +.nf + +struct ipc_perm shm_perm \fROperation permission structure.\fR +size_t shm_segsz \fRSize of segment in bytes.\fR +pid_t shm_lpid \fRProcess ID of last shared memory operation.\fR +pid_t shm_cpid \fRProcess ID of creator.\fR +shmatt_t shm_nattch \fRNumber of current attaches.\fR +time_t shm_atime \fRTime of last \fIshmat\fP\^(\|).\fR +time_t shm_dtime \fRTime of last \fIshmdt\fP\^(\|).\fR +time_t shm_ctime \fRTime of last change by \fIshmctl\fP\^(\|).\fR +.fi +.P +.RE +.P +The +.IR <sys/shm.h> +header shall define the +.BR pid_t , +.BR size_t , +and +.BR time_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void *shmat(int, const void *, int); +int shmctl(int, int, struct shmid_ds *); +int shmdt(const void *); +int shmget(key_t, size_t, int); +.fi +.P +.RE +.P +In addition, the +.IR <sys/shm.h> +header shall include the +.IR <sys/ipc.h> +header. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_ipc.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIshmat\fR\^(\|)", +.IR "\fIshmctl\fR\^(\|)", +.IR "\fIshmdt\fR\^(\|)", +.IR "\fIshmget\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_socket.h.0p b/upstream/mageia-cauldron/man0p/sys_socket.h.0p new file mode 100644 index 00000000..02b7e4b4 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_socket.h.0p @@ -0,0 +1,567 @@ +'\" et +.TH sys_socket.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/socket.h +\(em main sockets header +.SH SYNOPSIS +.LP +.nf +#include <sys/socket.h> +.fi +.SH DESCRIPTION +The +.IR <sys/socket.h> +header shall define the +.BR socklen_t +type, which is an integer type of width of at least 32 bits; +see APPLICATION USAGE. +.P +The +.IR <sys/socket.h> +header shall define the +.BR sa_family_t +unsigned integer type. +.P +The +.IR <sys/socket.h> +header shall define the +.BR sockaddr +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +sa_family_t sa_family \fRAddress family.\fR +char sa_data[] \fRSocket address (variable-length data).\fR +.fi +.P +.RE +.P +The +.BR sockaddr +structure is used to define a socket address which is used +in the +\fIbind\fR(), +\fIconnect\fR(), +\fIgetpeername\fR(), +\fIgetsockname\fR(), +\fIrecvfrom\fR(), +and +\fIsendto\fR() +functions. +.P +The +.IR <sys/socket.h> +header shall define the +.BR sockaddr_storage +structure, which shall be: +.IP " *" 4 +Large enough to accommodate all supported protocol-specific address +structures +.IP " *" 4 +Aligned at an appropriate boundary so that pointers to it can be cast +as pointers to protocol-specific address structures and used to access +the fields of those structures without alignment problems +.P +The +.BR sockaddr_storage +structure shall include at least the following members: +.sp +.RS 4 +.nf + +sa_family_t ss_family +.fi +.P +.RE +.P +When a pointer to a +.BR sockaddr_storage +structure is cast as a pointer to a +.BR sockaddr +structure, the +.IR ss_family +field of the +.BR sockaddr_storage +structure shall map onto the +.IR sa_family +field of the +.BR sockaddr +structure. When a pointer to a +.BR sockaddr_storage +structure is cast as a pointer to a protocol-specific address structure, +the +.IR ss_family +field shall map onto +a field of that structure that is of type +.BR sa_family_t +and that identifies the protocol's address family. +.P +The +.IR <sys/socket.h> +header shall define the +.BR msghdr +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +void *msg_name \fROptional address.\fR +socklen_t msg_namelen \fRSize of address.\fR +struct iovec *msg_iov \fRScatter/gather array.\fR +int msg_iovlen \fRMembers in \fImsg_iov\fR.\fR +void *msg_control \fRAncillary data; see below.\fR +socklen_t msg_controllen \fRAncillary data buffer \fIlen\fR.\fR +int msg_flags \fRFlags on received message.\fR +.fi +.P +.RE +.P +The +.BR msghdr +structure is used to minimize the number of directly supplied +parameters to the +\fIrecvmsg\fR() +and +\fIsendmsg\fR() +functions. This structure is used as a +.IR value \(hy\c +.IR result +parameter in the +\fIrecvmsg\fR() +function and +.IR value +only for the +\fIsendmsg\fR() +function. +.P +The +.IR <sys/socket.h> +header shall define the +.BR iovec +structure as described in +.IR <sys/uio.h> . +.P +The +.IR <sys/socket.h> +header shall define the +.BR cmsghdr +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +socklen_t cmsg_len \fRData byte count, including the \fBcmsghdr\fR.\fR +int cmsg_level \fROriginating protocol.\fR +int cmsg_type \fRProtocol-specific type.\fR +.fi +.P +.RE +.P +The +.BR cmsghdr +structure is used for storage of ancillary data object information. +.P +Ancillary data consists of a sequence of pairs, each consisting of a +.BR cmsghdr +structure followed by a data array. The data array contains the +ancillary data message, and the +.BR cmsghdr +structure contains descriptive information that allows an application +to correctly parse the data. +.P +The values for +.IR cmsg_level +shall be legal values for the +.IR level +argument to the +\fIgetsockopt\fR() +and +\fIsetsockopt\fR() +functions. The system documentation shall specify the +.IR cmsg_type +definitions for the supported protocols. +.P +Ancillary data is also possible at the socket level. The +.IR <sys/socket.h> +header shall define the following symbolic constant for use as the +.IR cmsg_type +value when +.IR cmsg_level +is SOL_SOCKET: +.IP SCM_RIGHTS 14 +Indicates that the data array contains the access rights to be sent or +received. +.P +The +.IR <sys/socket.h> +header shall define the following macros to gain access to the data +arrays in the ancillary data associated with a message header: +.IP "CMSG_DATA(\fIcmsg\fP)" 6 +.br +If the argument is a pointer to a +.BR cmsghdr +structure, this macro shall return an unsigned character pointer +to the data array associated with the +.BR cmsghdr +structure. +.IP "CMSG_NXTHDR(\fImhdr,cmsg\fP)" 6 +.br +If the first argument is a pointer to a +.BR msghdr +structure and the second argument is a pointer to a +.BR cmsghdr +structure in the ancillary data pointed to by the +.IR msg_control +field of that +.BR msghdr +structure, this macro shall return a pointer to the next +.BR cmsghdr +structure, or a null pointer if this structure is the last +.BR cmsghdr +in the ancillary data. +.IP "CMSG_FIRSTHDR(\fImhdr\fP)" 6 +.br +If the argument is a pointer to a +.BR msghdr +structure, this macro shall return a pointer to the first +.BR cmsghdr +structure in the ancillary data associated with this +.BR msghdr +structure, or a null pointer if there is no ancillary data associated +with the +.BR msghdr +structure. +.P +The +.IR <sys/socket.h> +header shall define the +.BR linger +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int l_onoff \fRIndicates whether linger option is enabled.\fR +int l_linger \fRLinger time, in seconds.\fR +.fi +.P +.RE +.P +The +.IR <sys/socket.h> +header shall define the following symbolic constants with distinct values: +.IP SOCK_DGRAM 14 +Datagram socket. +.IP SOCK_RAW 14 +Raw Protocol Interface. +.IP SOCK_SEQPACKET 14 +Sequenced-packet socket. +.IP SOCK_STREAM 14 +Byte-stream socket. +.P +The +.IR <sys/socket.h> +header shall define the following symbolic constant for use as the +.IR level +argument of +\fIsetsockopt\fR() +and +\fIgetsockopt\fR(). +.IP SOL_SOCKET 14 +Options to be accessed at socket level, not protocol level. +.P +The +.IR <sys/socket.h> +header shall define the following symbolic constants with distinct values +for use as the +.IR option_name +argument in +\fIgetsockopt\fR() +or +\fIsetsockopt\fR() +calls (see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.10.16" ", " "Use of Options"): +.IP SO_ACCEPTCONN 14 +Socket is accepting connections. +.IP SO_BROADCAST 14 +Transmission of broadcast messages is supported. +.IP SO_DEBUG 14 +Debugging information is being recorded. +.IP SO_DONTROUTE 14 +Bypass normal routing. +.IP SO_ERROR 14 +Socket error status. +.IP SO_KEEPALIVE 14 +Connections are kept alive with periodic messages. +.IP SO_LINGER 14 +Socket lingers on close. +.IP SO_OOBINLINE 14 +Out-of-band data is transmitted in line. +.IP SO_RCVBUF 14 +Receive buffer size. +.IP SO_RCVLOWAT 14 +Receive ``low water mark''. +.IP SO_RCVTIMEO 14 +Receive timeout. +.IP SO_REUSEADDR 14 +Reuse of local addresses is supported. +.IP SO_SNDBUF 14 +Send buffer size. +.IP SO_SNDLOWAT 14 +Send ``low water mark''. +.IP SO_SNDTIMEO 14 +Send timeout. +.IP SO_TYPE 14 +Socket type. +.P +The +.IR <sys/socket.h> +header shall define the following symbolic constant for use as the maximum +.IR backlog +queue length which may be specified by the +.IR backlog +field of the +\fIlisten\fR() +function: +.IP SOMAXCONN 14 +The maximum +.IR backlog +queue length. +.P +The +.IR <sys/socket.h> +header shall define the following symbolic constants with distinct values +for use as the valid values for the +.IR msg_flags +field in the +.BR msghdr +structure, or the +.IR flags +parameter in +\fIrecv\fR(), +\fIrecvfrom\fR(), +\fIrecvmsg\fR(), +\fIsend\fR(), +\fIsendmsg\fR(), +or +\fIsendto\fR() +calls: +.IP MSG_CTRUNC 14 +Control data truncated. +.IP MSG_DONTROUTE 14 +Send without using routing tables. +.IP MSG_EOR 14 +Terminates a record (if supported by the protocol). +.IP MSG_OOB 14 +Out-of-band data. +.IP MSG_NOSIGNAL 14 +No SIGPIPE generated when an attempt to send is made on a +stream-oriented socket that is no longer connected. +.IP MSG_PEEK 14 +Leave received data in queue. +.IP MSG_TRUNC 14 +Normal data truncated. +.IP MSG_WAITALL 14 +Attempt to fill the read buffer. +.P +The +.IR <sys/socket.h> +header shall define the following symbolic constants with distinct values: +.IP AF_INET 14 +Internet domain sockets for use with IPv4 addresses. +.IP AF_INET6 14 +Internet domain sockets for use with IPv6 addresses. +.IP AF_UNIX 14 +UNIX domain sockets. +.IP AF_UNSPEC 14 +Unspecified. +.P +The value of AF_UNSPEC shall be 0. +.P +The +.IR <sys/socket.h> +header shall define the following symbolic constants with distinct values: +.IP SHUT_RD 14 +Disables further receive operations. +.IP SHUT_RDWR 14 +Disables further send and receive operations. +.IP SHUT_WR 14 +Disables further send operations. +.P +The +.IR <sys/socket.h> +header shall define the +.BR size_t +and +.BR ssize_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int accept(int, struct sockaddr *restrict, socklen_t *restrict); +int bind(int, const struct sockaddr *, socklen_t); +int connect(int, const struct sockaddr *, socklen_t); +int getpeername(int, struct sockaddr *restrict, socklen_t *restrict); +int getsockname(int, struct sockaddr *restrict, socklen_t *restrict); +int getsockopt(int, int, int, void *restrict, socklen_t *restrict); +int listen(int, int); +ssize_t recv(int, void *, size_t, int); +ssize_t recvfrom(int, void *restrict, size_t, int, + struct sockaddr *restrict, socklen_t *restrict); +ssize_t recvmsg(int, struct msghdr *, int); +ssize_t send(int, const void *, size_t, int); +ssize_t sendmsg(int, const struct msghdr *, int); +ssize_t sendto(int, const void *, size_t, int, const struct sockaddr *, + socklen_t); +int setsockopt(int, int, int, const void *, socklen_t); +int shutdown(int, int); +int sockatmark(int); +int socket(int, int, int); +int socketpair(int, int, int, int [2]); +.fi +.P +.RE +.P +Inclusion of +.IR <sys/socket.h> +may also make visible all symbols from +.IR <sys/uio.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +To forestall portability problems, it is recommended that applications +not use values larger than 2\u\s-331\s+3\d \-1 for the +.BR socklen_t +type. +.P +The +.BR sockaddr_storage +structure solves the problem of declaring storage for automatic +variables which is both large enough and aligned enough for storing the +socket address data structure of any family. For example, code with a +file descriptor and without the context of the address family can pass +a pointer to a variable of this type, where a pointer to a socket +address structure is expected in calls such as +\fIgetpeername\fR(), +and determine the address family by accessing the received content +after the call. +.P +The example below illustrates a data structure which aligns on a 64-bit +boundary. An implementation-defined field +.IR _ss_align +following +.IR _ss_pad1 +is used to force a 64-bit alignment which covers proper alignment good +enough for needs of at least +.BR sockaddr_in6 +(IPv6) and +.BR sockaddr_in +(IPv4) address data structures. The size of padding field +.IR _ss_pad1 +depends on the chosen alignment boundary. The size of padding field +.IR _ss_pad2 +depends on the value of overall size chosen for the total size of the +structure. This size and alignment are represented in the above example +by implementation-defined (not required) constants _SS_MAXSIZE +(chosen value 128) and _SS_ALIGNMENT (with chosen value 8). Constants +_SS_PAD1SIZE (derived value 6) and _SS_PAD2SIZE (derived value 112) are +also for illustration and not required. The implementation-defined +definitions and structure field names above start with an +<underscore> +to denote implementation private name space. Portable code is not expected +to access or reference those fields or constants. +.sp +.RS 4 +.nf + +/* + * Desired design of maximum size and alignment. + */ +#define _SS_MAXSIZE 128 + /* Implementation-defined maximum size. */ +#define _SS_ALIGNSIZE (sizeof(int64_t)) + /* Implementation-defined desired alignment. */ +.P +/* + * Definitions used for sockaddr_storage structure paddings design. + */ +#define _SS_PAD1SIZE (_SS_ALIGNSIZE - sizeof(sa_family_t)) +#define _SS_PAD2SIZE (_SS_MAXSIZE - (sizeof(sa_family_t)+ \e + _SS_PAD1SIZE + _SS_ALIGNSIZE)) +struct sockaddr_storage { + sa_family_t ss_family; /* Address family. */ +/* + * Following fields are implementation-defined. + */ + char _ss_pad1[_SS_PAD1SIZE]; + /* 6-byte pad; this is to make implementation-defined + pad up to alignment field that follows explicit in + the data structure. */ + int64_t _ss_align; /* Field to force desired structure + storage alignment. */ + char _ss_pad2[_SS_PAD2SIZE]; + /* 112-byte pad to achieve desired size, + _SS_MAXSIZE value minus size of ss_family + __ss_pad1, __ss_align fields is 112. */ +}; +.fi +.P +.RE +.SH "RATIONALE" +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP", +.IR "\fB<sys_uio.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIaccept\fR\^(\|)", +.IR "\fIbind\fR\^(\|)", +.IR "\fIconnect\fR\^(\|)", +.IR "\fIgetpeername\fR\^(\|)", +.IR "\fIgetsockname\fR\^(\|)", +.IR "\fIgetsockopt\fR\^(\|)", +.IR "\fIlisten\fR\^(\|)", +.IR "\fIrecv\fR\^(\|)", +.IR "\fIrecvfrom\fR\^(\|)", +.IR "\fIrecvmsg\fR\^(\|)", +.IR "\fIsend\fR\^(\|)", +.IR "\fIsendmsg\fR\^(\|)", +.IR "\fIsendto\fR\^(\|)", +.IR "\fIsetsockopt\fR\^(\|)", +.IR "\fIshutdown\fR\^(\|)", +.IR "\fIsockatmark\fR\^(\|)", +.IR "\fIsocket\fR\^(\|)", +.IR "\fIsocketpair\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_stat.h.0p b/upstream/mageia-cauldron/man0p/sys_stat.h.0p new file mode 100644 index 00000000..83b2f159 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_stat.h.0p @@ -0,0 +1,414 @@ +'\" et +.TH sys_stat.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/stat.h +\(em data returned by the stat(\|) function +.SH SYNOPSIS +.LP +.nf +#include <sys/stat.h> +.fi +.SH DESCRIPTION +The +.IR <sys/stat.h> +header shall define the structure of the data returned by the +\fIfstat\fR(), +\fIlstat\fR(), +and +\fIstat\fR() +functions. +.P +The +.IR <sys/stat.h> +header shall define the +.BR stat +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +dev_t st_dev \fRDevice ID of device containing file.\fR +ino_t st_ino \fRFile serial number.\fR +mode_t st_mode \fRMode of file (see below).\fR +nlink_t st_nlink \fRNumber of hard links to the file.\fR +uid_t st_uid \fRUser ID of file.\fR +gid_t st_gid \fRGroup ID of file.\fR +dev_t st_rdev \fRDevice ID (if file is character or block special).\fR +off_t st_size \fRFor regular files, the file size in bytes.\fR + \fRFor symbolic links, the length in bytes of the\fR + \fRpathname contained in the symbolic link.\fR + \fRFor a shared memory object, the length in bytes.\fR + \fRFor a typed memory object, the length in bytes.\fR + \fRFor other file types, the use of this field is\fR + \fRunspecified.\fR +struct timespec st_atim \fRLast data access timestamp.\fR +struct timespec st_mtim \fRLast data modification timestamp.\fR +struct timespec st_ctim \fRLast file status change timestamp.\fR +blksize_t st_blksize \fRA file system-specific preferred I/O block size\fR + \fRfor this object. In some file system types, this\fR + \fRmay vary from file to file.\fR +blkcnt_t st_blocks \fRNumber of blocks allocated for this object.\fR +.fi +.P +.RE +.P +The +.IR st_ino +and +.IR st_dev +fields taken together uniquely identify the file within the system. +.P +The +.IR <sys/stat.h> +header shall define the +.BR blkcnt_t , +.BR blksize_t , +.BR dev_t , +.BR ino_t , +.BR mode_t , +.BR nlink_t , +.BR uid_t , +.BR gid_t , +.BR off_t , +and +.BR time_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <sys/stat.h> +header shall define the +.BR timespec +structure as described in +.IR <time.h> . +Times shall be given in seconds since the Epoch. +.P +Which structure members have meaningful values depends on the +type of file. For further information, see the descriptions of +\fIfstat\fR(), +\fIlstat\fR(), +and +\fIstat\fR() +in the System Interfaces volume of POSIX.1\(hy2017. +.P +For compatibility with earlier versions of this standard, the +.IR st_atime +macro shall be defined with the value +.IR st_atim.tv_sec . +Similarly, +.IR st_ctime +and +.IR st_mtime +shall be defined as macros with the values +.IR st_ctim.tv_sec +and +.IR st_mtim.tv_sec , +respectively. +.br +.P +The +.IR <sys/stat.h> +header shall define the following symbolic constants for the +file types encoded in type +.BR mode_t . +The values shall be suitable for use in +.BR #if +preprocessing directives: +.IP S_IFMT 12 +Type of file. +.RS 12 +.IP S_IFBLK 12 +Block special. +.IP S_IFCHR 12 +Character special. +.IP S_IFIFO 12 +FIFO special. +.IP S_IFREG 12 +Regular. +.IP S_IFDIR 12 +Directory. +.IP S_IFLNK 12 +Symbolic link. +.IP S_IFSOCK 12 +Socket. +.RE +.P +The +.IR <sys/stat.h> +header shall define the following symbolic constants for the file mode +bits encoded in type +.BR mode_t , +with the indicated numeric values. These macros shall expand to an +expression which has a type that allows them to be used, either singly +or OR'ed together, as the third argument to +\fIopen\fR() +without the need for a +.BR mode_t +cast. The values shall be suitable for use in +.BR #if +preprocessing directives. +.TS +center box tab(@); +cB | cB | cB +l | n | l. +Name@Numeric Value@Description +_ +S_IRWXU@0700@Read, write, execute/search by owner. +S_IRUSR@0400@Read permission, owner. +S_IWUSR@0200@Write permission, owner. +S_IXUSR@0100@Execute/search permission, owner. +_ +S_IRWXG@070@Read, write, execute/search by group. +S_IRGRP@040@Read permission, group. +S_IWGRP@020@Write permission, group. +S_IXGRP@010@Execute/search permission, group. +_ +S_IRWXO@07@Read, write, execute/search by others. +S_IROTH@04@Read permission, others. +S_IWOTH@02@Write permission, others. +S_IXOTH@01@Execute/search permission, others. +_ +S_ISUID@04000@Set-user-ID on execution. +S_ISGID@02000@Set-group-ID on execution. +\*!S_ISVTX@01000@On directories, restricted deletion flag.\0\0\0\*? +.TE +.P +The following macros shall be provided to test whether a file is of the +specified type. The value +.IR m +supplied to the macros is the value of +.IR st_mode +from a +.BR stat +structure. The macro shall evaluate to a non-zero value if the test is +true; 0 if the test is false. +.IP "S_ISBLK(\fIm\fP)" 14 +Test for a block special file. +.IP "S_ISCHR(\fIm\fP)" 14 +Test for a character special file. +.IP "S_ISDIR(\fIm\fP)" 14 +Test for a directory. +.IP "S_ISFIFO(\fIm\fP)" 14 +Test for a pipe or FIFO special file. +.IP "S_ISREG(\fIm\fP)" 14 +Test for a regular file. +.IP "S_ISLNK(\fIm\fP)" 14 +Test for a symbolic link. +.IP "S_ISSOCK(\fIm\fP)" 14 +Test for a socket. +.P +The implementation may implement message queues, semaphores, or shared +memory objects as distinct file types. The following macros shall be +provided to test whether a file is of the specified type. The value of +the +.IR buf +argument supplied to the macros is a pointer to a +.BR stat +structure. The macro shall evaluate to a non-zero value if the +specified object is implemented as a distinct file type and the +specified file type is contained in the +.BR stat +structure referenced by +.IR buf . +Otherwise, the macro shall evaluate to zero. +.IP "S_TYPEISMQ(\fIbuf\fP)" 14 +Test for a message queue. +.IP "S_TYPEISSEM(\fIbuf\fP)" 14 +Test for a semaphore. +.IP "S_TYPEISSHM(\fIbuf\fP)" 14 +Test for a shared memory object. +.P +The implementation may implement typed memory objects as distinct +file types, and the following macro shall test whether a file is of the +specified type. The value of the +.IR buf +argument supplied to the macros is a pointer to a +.BR stat +structure. The macro shall evaluate to a non-zero value if the +specified object is implemented as a distinct file type and the +specified file type is contained in the +.BR stat +structure referenced by +.IR buf . +Otherwise, the macro shall evaluate to zero. +.IP "S_TYPEISTMO(\fIbuf\fP)" 14 +Test macro for a typed memory object. +.P +The +.IR <sys/stat.h> +header shall define the following symbolic constants as distinct +integer values outside of the range [0,999\|999\|999], +for use with the +\fIfutimens\fR() +and +\fIutimensat\fR() +functions: +UTIME_NOW +UTIME_OMIT +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int chmod(const char *, mode_t); +int fchmod(int, mode_t); +int fchmodat(int, const char *, mode_t, int); +int fstat(int, struct stat *); +int fstatat(int, const char *restrict, struct stat *restrict, int); +int futimens(int, const struct timespec [2]); +int lstat(const char *restrict, struct stat *restrict); +int mkdir(const char *, mode_t); +int mkdirat(int, const char *, mode_t); +int mkfifo(const char *, mode_t); +int mkfifoat(int, const char *, mode_t); +int mknod(const char *, mode_t, dev_t); +int mknodat(int, const char *, mode_t, dev_t); +int stat(const char *restrict, struct stat *restrict); +mode_t umask(mode_t); +int utimensat(int, const char *, const struct timespec [2], int); +.fi +.P +.RE +.P +Inclusion of the +.IR <sys/stat.h> +header may make visible all symbols from the +.IR <time.h> +header. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +Use of the macros is recommended for determining the type of a file. +.SH RATIONALE +A conforming C-language application must include +.IR <sys/stat.h> +for functions that have arguments or return values of type +.BR mode_t , +so that symbolic values for that type can be used. An alternative +would be to require that these constants are also defined by including +.IR <sys/types.h> . +.P +The S_ISUID and S_ISGID +bits may be cleared on any write, not just on +\fIopen\fR(), +as some historical implementations do. +.P +System calls that update the time entry fields in the +.BR stat +structure must be documented by the implementors. POSIX-conforming +systems should not update the time entry fields for functions listed in +the System Interfaces volume of POSIX.1\(hy2017 unless the standard requires that they do, except in the case +of documented extensions to the standard. +.P +Upon assignment, file timestamps are immediately converted to the +resolution of the file system by truncation (i.e., the recorded time +can be older than the actual time). For example, if the file system +resolution is 1 microsecond, then a conforming +\fIstat\fR() +must always return an +.IR st_mtim.tv_nsec +that is a multiple of 1000. Some older implementations returned +higher-resolution timestamps while the +.IR inode +information was cached, and then spontaneously truncated the +.IR tv_nsec +fields when they were stored to and retrieved from disk, but this behavior +does not conform. +.P +Note that +.IR st_dev +must be unique within a Local Area Network (LAN) in a ``system'' made +up of multiple computers' file systems connected by a LAN. +.P +Networked implementations of a POSIX-conforming system must guarantee +that all files visible within the file tree (including parts of the +tree that may be remotely mounted from other machines on the network) +on each individual processor are uniquely identified by the combination +of the +.IR st_ino +and +.IR st_dev +fields. +.P +The unit for the +.IR st_blocks +member of the +.BR stat +structure is not defined within POSIX.1\(hy2008. In some implementations +it is 512 bytes. It may differ on a file system basis. There is no +correlation between values of the +.IR st_blocks +and +.IR st_blksize , +and the +.IR f_bsize +(from +.IR <sys/statvfs.h> ) +structure members. +.P +Traditionally, some implementations defined the multiplier for +.IR st_blocks +in +.IR <sys/param.h> +as the symbol DEV_BSIZE. +.P +Some earlier versions of this standard did not specify values for the +file mode bit macros. The expectation was that some implementors might +choose to use a different encoding for these bits than the traditional +one, and that new applications would use symbolic file modes instead of +numeric. This version of the standard specifies the traditional encoding, +in recognition that nearly 20 years after the first publication of this +standard numeric file modes are still in widespread use by application +developers, and that all conforming implementations still use the +traditional encoding. +.SH "FUTURE DIRECTIONS" +No new S_IFMT symbolic names for the file type values of +.BR mode_t +will be defined by POSIX.1\(hy2008; if new file types are required, they will +only be testable through +.IR S_ISxx (\|) +or +.IR S_TYPEISxxx (\|) +macros instead. +.SH "SEE ALSO" +.IR "\fB<sys_statvfs.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<time.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIchmod\fR\^(\|)", +.IR "\fIfchmod\fR\^(\|)", +.IR "\fIfstat\fR\^(\|)", +.IR "\fIfstatat\fR\^(\|)", +.IR "\fIfutimens\fR\^(\|)", +.IR "\fImkdir\fR\^(\|)", +.IR "\fImkfifo\fR\^(\|)", +.IR "\fImknod\fR\^(\|)", +.IR "\fIumask\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_statvfs.h.0p b/upstream/mageia-cauldron/man0p/sys_statvfs.h.0p new file mode 100644 index 00000000..10ce2762 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_statvfs.h.0p @@ -0,0 +1,106 @@ +'\" et +.TH sys_statvfs.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/statvfs.h +\(em VFS File System information structure +.SH SYNOPSIS +.LP +.nf +#include <sys/statvfs.h> +.fi +.SH DESCRIPTION +The +.IR <sys/statvfs.h> +header shall define the +.BR statvfs +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +unsigned long f_bsize \fRFile system block size.\fR +unsigned long f_frsize \fRFundamental file system block size.\fR +fsblkcnt_t f_blocks \fRTotal number of blocks on file system in units of \fIf_frsize.\fR +fsblkcnt_t f_bfree \fRTotal number of free blocks.\fR +fsblkcnt_t f_bavail \fRNumber of free blocks available to\fR + \fRnon-privileged process.\fR +fsfilcnt_t f_files \fRTotal number of file serial numbers.\fR +fsfilcnt_t f_ffree \fRTotal number of free file serial numbers.\fR +fsfilcnt_t f_favail \fRNumber of file serial numbers available to\fR + \fRnon-privileged process.\fR +unsigned long f_fsid \fRFile system ID.\fR +unsigned long f_flag \fRBit mask of \fIf_flag\fR values.\fR +unsigned long f_namemax \fRMaximum filename length.\fR +.fi +.P +.RE +.P +The +.IR <sys/statvfs.h> +header shall define the +.BR fsblkcnt_t +and +.BR fsfilcnt_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <sys/statvfs.h> +header shall define the following symbolic constants for the +.IR f_flag +member: +.IP ST_RDONLY 12 +Read-only file system. +.IP ST_NOSUID 12 +Does not support the semantics of the ST_ISUID and ST_ISGID file mode +bits. +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int fstatvfs(int, struct statvfs *); +int statvfs(const char *restrict, struct statvfs *restrict); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIfstatvfs\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_time.h.0p b/upstream/mageia-cauldron/man0p/sys_time.h.0p new file mode 100644 index 00000000..f2fd7095 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_time.h.0p @@ -0,0 +1,147 @@ +'\" et +.TH sys_time.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/time.h +\(em time types +.SH SYNOPSIS +.LP +.nf +#include <sys/time.h> +.fi +.SH DESCRIPTION +The +.IR <sys/time.h> +header shall define the +.BR timeval +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +time_t tv_sec \fRSeconds.\fR +suseconds_t tv_usec \fRMicroseconds.\fR +.fi +.P +.RE +.P +The +.IR <sys/time.h> +header shall define the +.BR itimerval +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +struct timeval it_interval \fRTimer interval.\fR +struct timeval it_value \fRCurrent value.\fR +.fi +.P +.RE +.P +The +.IR <sys/time.h> +header shall define the +.BR time_t +and +.BR suseconds_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <sys/time.h> +header shall define the +.BR fd_set +type as described in +.IR <sys/select.h> . +.P +The +.IR <sys/time.h> +header shall define the following symbolic constants for the +.IR which +argument of +\fIgetitimer\fR() +and +\fIsetitimer\fR(): +.IP ITIMER_REAL 14 +Decrements in real time. +.IP ITIMER_VIRTUAL 14 +Decrements in process virtual time. +.IP ITIMER_PROF 14 +Decrements both in process virtual time and when the system is running +on behalf of the process. +.P +The +.IR <sys/time.h> +header shall define the following as described in +.IR <sys/select.h> : +\fIFD_CLR\fR() +\fIFD_ISSET\fR() +\fIFD_SET\fR() +\fIFD_ZERO\fR() +FD_SETSIZE +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int getitimer(int, struct itimerval *); +int gettimeofday(struct timeval *restrict, void *restrict); +int setitimer(int, const struct itimerval *restrict, + struct itimerval *restrict); +int select(int, fd_set *restrict, fd_set *restrict, fd_set *restrict, + struct timeval *restrict); +int utimes(const char *, const struct timeval [2]); +.fi +.P +.RE +.P +Inclusion of the +.IR <sys/time.h> +header may make visible all symbols from the +.IR <sys/select.h> +header. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_select.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIfutimens\fR\^(\|)", +.IR "\fIgetitimer\fR\^(\|)", +.IR "\fIgettimeofday\fR\^(\|)", +.IR "\fIpselect\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_times.h.0p b/upstream/mageia-cauldron/man0p/sys_times.h.0p new file mode 100644 index 00000000..cd62b05e --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_times.h.0p @@ -0,0 +1,85 @@ +'\" et +.TH sys_times.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/times.h +\(em file access and modification times structure +.SH SYNOPSIS +.LP +.nf +#include <sys/times.h> +.fi +.SH DESCRIPTION +The +.IR <sys/times.h> +header shall define the +.BR tms +structure, which is returned by +\fItimes\fR() +and shall include at least the following members: +.sp +.RS 4 +.nf + +clock_t tms_utime \fRUser CPU time.\fR +clock_t tms_stime \fRSystem CPU time.\fR +clock_t tms_cutime \fRUser CPU time of terminated child processes.\fR +clock_t tms_cstime \fRSystem CPU time of terminated child processes.\fR +.fi +.P +.RE +.P +The +.IR <sys/times.h> +header shall define the +.BR clock_t +type as described in +.IR <sys/types.h> . +.P +The following shall be declared as a function and may also be defined +as a macro. A function prototype shall be provided. +.sp +.RS 4 +.nf + +clock_t times(struct tms *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fItimes\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_types.h.0p b/upstream/mageia-cauldron/man0p/sys_types.h.0p new file mode 100644 index 00000000..6e124417 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_types.h.0p @@ -0,0 +1,245 @@ +'\" et +.TH sys_types.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/types.h +\(em data types +.SH SYNOPSIS +.LP +.nf +#include <sys/types.h> +.fi +.SH DESCRIPTION +The +.IR <sys/types.h> +header shall define at least the following types: +.IP "\fBblkcnt_t\fP" 16 +Used for file block counts. +.IP "\fBblksize_t\fP" 16 +Used for block sizes. +.IP "\fBclock_t\fP" 16 +Used for system times in clock ticks or CLOCKS_PER_SEC; see +.IR <time.h> . +.IP "\fBclockid_t\fP" 16 +Used for clock ID type in the clock and timer functions. +.IP "\fBdev_t\fP" 16 +Used for device IDs. +.IP "\fBfsblkcnt_t\fP" 16 +Used for file system block counts. +.IP "\fBfsfilcnt_t\fP" 16 +Used for file system file counts. +.IP "\fBgid_t\fP" 16 +Used for group IDs. +.IP "\fBid_t\fP" 16 +Used as a general identifier; can be used to contain at least a +.BR pid_t , +.BR uid_t , +or +.BR gid_t . +.IP "\fBino_t\fP" 16 +Used for file serial numbers. +.IP "\fBkey_t\fP" 16 +Used for XSI interprocess communication. +.IP "\fBmode_t\fP" 16 +Used for some file attributes. +.IP "\fBnlink_t\fP" 16 +Used for link counts. +.IP "\fBoff_t\fP" 16 +Used for file sizes. +.IP "\fBpid_t\fP" 16 +Used for process IDs and process group IDs. +.IP "\fBpthread_attr_t\fP" 16 +Used to identify a thread attribute object. +.IP "\fBpthread_barrier_t\fP" 16 +Used to identify a barrier. +.IP "\fBpthread_barrierattr_t\fP" 16 +Used to define a barrier attributes object. +.IP "\fBpthread_cond_t\fP" 16 +Used for condition variables. +.IP "\fBpthread_condattr_t\fP" 16 +Used to identify a condition attribute object. +.IP "\fBpthread_key_t\fP" 16 +Used for thread-specific data keys. +.IP "\fBpthread_mutex_t\fP" 16 +Used for mutexes. +.IP "\fBpthread_mutexattr_t\fP" 16 +Used to identify a mutex attribute object. +.IP "\fBpthread_once_t\fP" 16 +Used for dynamic package initialization. +.IP "\fBpthread_rwlock_t\fP" 16 +Used for read-write locks. +.IP "\fBpthread_rwlockattr_t\fP" 16 +Used for read-write lock attributes. +.IP "\fBpthread_spinlock_t\fP" 16 +Used to identify a spin lock. +.IP "\fBpthread_t\fP" 16 +Used to identify a thread. +.IP "\fBsize_t\fP" 16 +Used for sizes of objects. +.IP "\fBssize_t\fP" 16 +Used for a count of bytes or an error indication. +.IP "\fBsuseconds_t\fP" 16 +Used for time in microseconds. +.IP "\fBtime_t\fP" 16 +Used for time in seconds. +.IP "\fBtimer_t\fP" 16 +Used for timer ID returned by +\fItimer_create\fR(). +.IP "\fBtrace_attr_t\fP" 16 +Used to identify a trace stream attributes object +.IP "\fBtrace_event_id_t\fP" 16 +Used to identify a trace event type. +.IP "\fBtrace_event_set_t\fP" 16 +Used to identify a trace event type set. +.IP "\fBtrace_id_t\fP" 16 +Used to identify a trace stream. +.IP "\fBuid_t\fP" 16 +Used for user IDs. +.P +All of the types shall be defined as arithmetic types of an appropriate +length, with the following exceptions: +.P +.nf +.BR pthread_attr_t +.BR pthread_barrier_t +.BR pthread_barrierattr_t +.BR pthread_cond_t +.BR pthread_condattr_t +.BR pthread_key_t +.BR pthread_mutex_t +.BR pthread_mutexattr_t +.BR pthread_once_t +.BR pthread_rwlock_t +.BR pthread_rwlockattr_t +.BR pthread_spinlock_t +.BR pthread_t +.BR timer_t +.BR trace_attr_t +.BR trace_event_id_t +.BR trace_event_set_t +.BR trace_id_t +.fi +.P +Additionally: +.IP " *" 4 +.BR mode_t +shall be an integer type. +.IP " *" 4 +.BR dev_t +shall be an integer type. +.IP " *" 4 +.BR nlink_t , +.BR uid_t , +.BR gid_t , +and +.BR id_t +shall be integer types. +.IP " *" 4 +.BR blkcnt_t +and +.BR off_t +shall be signed integer types. +.IP " *" 4 +.BR fsblkcnt_t , +.BR fsfilcnt_t , +and +.BR ino_t +shall be defined as unsigned integer types. +.IP " *" 4 +.BR size_t +shall be an unsigned integer type. +.IP " *" 4 +.BR blksize_t , +.BR pid_t , +and +.BR ssize_t +shall be signed integer types. +.IP " *" 4 +.BR clock_t +shall be an integer or real-floating type. +.BR time_t +shall be an integer type. +.P +The type +.BR ssize_t +shall be capable of storing values at least in the range +[\-1,\ {SSIZE_MAX}]. +.P +The type +.BR suseconds_t +shall be a signed integer type capable of storing values at least in +the range [\-1,\ 1\|000\|000]. +.P +The implementation shall support one or more programming environments +in which the widths of +.BR blksize_t , +.BR pid_t , +.BR size_t , +.BR ssize_t , +and +.BR suseconds_t +are no greater than the width of type +.BR long . +The names of these programming environments can be obtained using the +\fIconfstr\fR() +function or the +.IR getconf +utility. +.P +There are no defined comparison or assignment operators for the +following types: +.P +.nf +.BR pthread_attr_t +.BR pthread_barrier_t +.BR pthread_barrierattr_t +.BR pthread_cond_t +.BR pthread_condattr_t +.BR pthread_mutex_t +.BR pthread_mutexattr_t +.BR pthread_rwlock_t +.BR pthread_rwlockattr_t +.BR pthread_spinlock_t +.BR timer_t +.BR trace_attr_t +.fi +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<time.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIconfstr\fR\^(\|)" +.P +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "\fIgetconf\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_uio.h.0p b/upstream/mageia-cauldron/man0p/sys_uio.h.0p new file mode 100644 index 00000000..fc914272 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_uio.h.0p @@ -0,0 +1,106 @@ +'\" et +.TH sys_uio.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/uio.h +\(em definitions for vector I/O operations +.SH SYNOPSIS +.LP +.nf +#include <sys/uio.h> +.fi +.SH DESCRIPTION +The +.IR <sys/uio.h> +header shall define the +.BR iovec +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +void *iov_base \fRBase address of a memory region for input or output.\fR +size_t iov_len \fRThe size of the memory pointed to by \fIiov_base.\fR +.fi +.P +.RE +.P +The +.IR <sys/uio.h> +header uses the +.BR iovec +structure for scatter/gather I/O. +.P +The +.IR <sys/uio.h> +header shall define the +.BR ssize_t +and +.BR size_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +ssize_t readv(int, const struct iovec *, int); +ssize_t writev(int, const struct iovec *, int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +The implementation can put a limit on the number of scatter/gather +elements which can be processed in one call. The symbol +{IOV_MAX} +defined in +.IR <limits.h> +should always be used to learn about the limits instead of assuming a +fixed value. +.SH RATIONALE +Traditionally, the maximum number of scatter/gather elements the system +can process in one call were described by the symbolic value +{UIO_MAXIOV}. +In IEEE\ Std\ 1003.1\(hy2001 this value is replaced by the constant +{IOV_MAX} +which can be found in +.IR <limits.h> . +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<limits.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIread\fR\^(\|)", +.IR "\fIreadv\fR\^(\|)", +.IR "\fIwrite\fR\^(\|)", +.IR "\fIwritev\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_un.h.0p b/upstream/mageia-cauldron/man0p/sys_un.h.0p new file mode 100644 index 00000000..1154449e --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_un.h.0p @@ -0,0 +1,107 @@ +'\" et +.TH sys_un.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/un.h +\(em definitions for UNIX domain sockets +.SH SYNOPSIS +.LP +.nf +#include <sys/un.h> +.fi +.SH DESCRIPTION +The +.IR <sys/un.h> +header shall define the +.BR sockaddr_un +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +sa_family_t sun_family \fRAddress family.\fR +char sun_path[] \fRSocket pathname.\fR +.fi +.P +.RE +.P +The +.BR sockaddr_un +structure is used to store addresses for UNIX domain sockets. +Pointers to this type shall be cast by applications to +.BR "struct sockaddr *" +for use with socket functions. +.P +The +.IR <sys/un.h> +header shall define the +.BR sa_family_t +type as described in +.IR <sys/socket.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +The size of +.IR sun_path +has intentionally been left undefined. This is because different +implementations use different sizes. For example, 4.3 BSD uses a size of +108, and 4.4 BSD uses a size of 104. Since most implementations +originate from BSD versions, the size is typically in the range 92 to +108. +.P +Applications should not assume a particular length for +.IR sun_path +or assume that it can hold +{_POSIX_PATH_MAX} +bytes (256). +.P +Although applications are required to initialize all members +(including any non-standard ones) of a +.BR sockaddr_in6 +structure (see +.IR "\fB<netinet_in.h>\fP"), +the same is not required for the +.BR sockaddr_un +structure, since historically many applications only initialized +the standard members. Despite this, applications are encouraged +to initialize +.BR sockaddr_un +structures in a manner similar to the required initialization of +.BR sockaddr_in6 +structures. +.SH "RATIONALE" +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<netinet_in.h>\fP", +.IR "\fB<sys_socket.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIbind\fR\^(\|)", +.IR "\fIsocket\fR\^(\|)", +.IR "\fIsocketpair\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_utsname.h.0p b/upstream/mageia-cauldron/man0p/sys_utsname.h.0p new file mode 100644 index 00000000..7a30f072 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_utsname.h.0p @@ -0,0 +1,79 @@ +'\" et +.TH sys_utsname.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/utsname.h +\(em system name structure +.SH SYNOPSIS +.LP +.nf +#include <sys/utsname.h> +.fi +.SH DESCRIPTION +The +.IR <sys/utsname.h> +header shall define the structure +.BR utsname +which shall include at least the following members: +.sp +.RS 4 +.nf + +char sysname[] \fRName of this implementation of the operating system.\fR +char nodename[] \fRName of this node within the communications\fR + \fRnetwork to which this node is attached, if any.\fR +char release[] \fRCurrent release level of this implementation.\fR +char version[] \fRCurrent version level of this release.\fR +char machine[] \fRName of the hardware type on which the system is running.\fR +.fi +.P +.RE +.P +The character arrays are of unspecified size, but the data stored in +them shall be terminated by a null byte. +.P +The following shall be declared as a function and may also be defined +as a macro: +.sp +.RS 4 +.nf + +int uname(struct utsname *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIuname\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/sys_wait.h.0p b/upstream/mageia-cauldron/man0p/sys_wait.h.0p new file mode 100644 index 00000000..d7331c55 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/sys_wait.h.0p @@ -0,0 +1,150 @@ +'\" et +.TH sys_wait.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +sys/wait.h +\(em declarations for waiting +.SH SYNOPSIS +.LP +.nf +#include <sys/wait.h> +.fi +.SH DESCRIPTION +The +.IR <sys/wait.h> +header shall define the following symbolic constants for use with +\fIwaitpid\fR(): +.IP WCONTINUED 14 +Report status of continued child process. +.IP WNOHANG 14 +Do not hang if no status is available; return immediately. +.IP WUNTRACED 14 +Report status of stopped child process. +.P +The +.IR <sys/wait.h> +header shall define the following macros for analysis of process status +values: +.IP WEXITSTATUS 14 +Return exit status. +.IP WIFCONTINUED 14 +True if child has been continued. +.IP WIFEXITED 14 +True if child exited normally. +.IP WIFSIGNALED 14 +True if child exited due to uncaught signal. +.IP WIFSTOPPED 14 +True if child is currently stopped. +.IP WSTOPSIG 14 +Return signal number that caused process to stop. +.IP WTERMSIG 14 +Return signal number that caused process to terminate. +.P +The +.IR <sys/wait.h> +header shall define the following symbolic constants as possible values +for the +.IR options +argument to +\fIwaitid\fR(): +.IP WEXITED 14 +Wait for processes that have exited. +.IP WNOWAIT 14 +Keep the process whose status is returned in +.IR infop +in a waitable state. +.IP WSTOPPED 14 +Status is returned for any child that has stopped upon receipt of a +signal. +.P +The +WCONTINUED +and WNOHANG constants, described above for +\fIwaitpid\fR(), +can also be used with +\fIwaitid\fR(). +.P +The type +.BR idtype_t +shall be defined as an enumeration type whose possible values shall +include at least the following: +P_ALL +P_PGID +P_PID +.P +The +.IR <sys/wait.h> +header shall define the +.BR id_t +and +.BR pid_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <sys/wait.h> +header shall define the +.BR siginfo_t +type and the +.BR sigval +union as described in +.IR <signal.h> . +.P +Inclusion of the +.IR <sys/wait.h> +header may also make visible +all symbols from +.IR <signal.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +pid_t wait(int *); +int waitid(idtype_t, id_t, siginfo_t *, int); +pid_t waitpid(pid_t, int *, int); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<signal.h>\fP", +.IR "\fB<sys_resource.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIwait\fR\^(\|)", +.IR "\fIwaitid\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/syslog.h.0p b/upstream/mageia-cauldron/man0p/syslog.h.0p new file mode 100644 index 00000000..946a6e94 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/syslog.h.0p @@ -0,0 +1,160 @@ +'\" et +.TH syslog.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +syslog.h +\(em definitions for system error logging +.SH SYNOPSIS +.LP +.nf +#include <syslog.h> +.fi +.SH DESCRIPTION +The +.IR <syslog.h> +header shall define the following symbolic constants, zero or more +of which may be OR'ed together to form the +.IR logopt +option of +\fIopenlog\fR(): +.IP LOG_PID 14 +Log the process ID with each message. +.IP LOG_CONS 14 +Log to the system console on error. +.IP LOG_NDELAY 14 +Connect to syslog daemon immediately. +.IP LOG_ODELAY 14 +Delay open until +\fIsyslog\fR() +is called. +.IP LOG_NOWAIT 14 +Do not wait for child processes. +.P +The +.IR <syslog.h> +header shall define the following symbolic constants for use as the +.IR facility +argument to +\fIopenlog\fR(): +.IP LOG_KERN 14 +Reserved for message generated by the system. +.IP LOG_USER 14 +Message generated by a process. +.IP LOG_MAIL 14 +Reserved for message generated by mail system. +.IP LOG_NEWS 14 +Reserved for message generated by news system. +.IP LOG_UUCP 14 +Reserved for message generated by UUCP system. +.IP LOG_DAEMON 14 +Reserved for message generated by system daemon. +.IP LOG_AUTH 14 +Reserved for message generated by authorization daemon. +.IP LOG_CRON 14 +Reserved for message generated by clock daemon. +.IP LOG_LPR 14 +Reserved for message generated by printer system. +.IP LOG_LOCAL0 14 +Reserved for local use. +.IP LOG_LOCAL1 14 +Reserved for local use. +.IP LOG_LOCAL2 14 +Reserved for local use. +.IP LOG_LOCAL3 14 +Reserved for local use. +.IP LOG_LOCAL4 14 +Reserved for local use. +.IP LOG_LOCAL5 14 +Reserved for local use. +.IP LOG_LOCAL6 14 +Reserved for local use. +.IP LOG_LOCAL7 14 +Reserved for local use. +.P +The +.IR <syslog.h> +header shall define the following macros for constructing the +.IR maskpri +argument to +\fIsetlogmask\fR(). +The following macros expand to an expression of type +.BR int +when the argument +.IR pri +is an expression of type +.BR int : +.IP "LOG_MASK(\fIpri\fR)" 14 +A mask for priority +.IR pri . +.P +The +.IR <syslog.h> +header shall define the following symbolic constants for use as the +.IR priority +argument of +\fIsyslog\fR(): +.IP LOG_EMERG 14 +A panic condition was reported to all processes. +.IP LOG_ALERT 14 +A condition that should be corrected immediately. +.IP LOG_CRIT 14 +A critical condition. +.IP LOG_ERR 14 +An error message. +.IP LOG_WARNING 14 +A warning message. +.IP LOG_NOTICE 14 +A condition requiring special handling. +.IP LOG_INFO 14 +A general information message. +.IP LOG_DEBUG 14 +A message useful for debugging programs. +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void closelog(void); +void openlog(const char *, int, int); +int setlogmask(int); +void syslog(int, const char *, ...); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIcloselog\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/tar.h.0p b/upstream/mageia-cauldron/man0p/tar.h.0p new file mode 100644 index 00000000..59daf9e1 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/tar.h.0p @@ -0,0 +1,112 @@ +'\" et +.TH tar.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +tar.h +\(em extended tar definitions +.SH SYNOPSIS +.LP +.nf +#include <tar.h> +.fi +.SH DESCRIPTION +The +.IR <tar.h> +header shall define the following symbolic constants with the +indicated values. +.P +General definitions: +.TS +box tab(!); +cB | cB | cB +lw(1i) | cf5w(1i) | lw(3i). +Name!Value!Description +_ +TMAGIC!"ustar"!T{ +Used in the magic field in the +.BR ustar +header block, including the trailing null byte. +T} +TMAGLEN!6!Length in octets of the magic field. +TVERSION!"00"!T{ +Used in the version field in the +.BR ustar +header block, excluding the trailing null byte. +T} +TVERSLEN!2!Length in octets of the version field. +.TE +.P +.IR Typeflag +field definitions: +.TS +box tab(!); +cB | cB | cB +lw(1i) | cf5w(1i) | lw(3i). +Name!Value!Description +_ +REGTYPE!'0'!Regular file. +AREGTYPE!'\e0'!Regular file. +LNKTYPE!'1'!Link. +SYMTYPE!'2'!Symbolic link. +CHRTYPE!'3'!Character special. +BLKTYPE!'4'!Block special. +DIRTYPE!'5'!Directory. +FIFOTYPE!'6'!FIFO special. +CONTTYPE!'7'!Reserved. +.TE +.P +\fIMode\fP field bit definitions (octal): +.TS +box tab(@); +cB | cB | cB +lw(1i) | cf5w(1i) | lw(3i). +Name@Value@Description +_ +TSUID@04000@Set UID on execution. +TSGID@02000@Set GID on execution. +TSVTX@01000@\*!On directories, restricted deletion flag.\0\0\0\*? +TUREAD@00400@Read by owner. +TUWRITE@00200@Write by owner special. +TUEXEC@00100@Execute/search by owner. +TGREAD@00040@Read by group. +TGWRITE@00020@Write by group. +TGEXEC@00010@Execute/search by group. +TOREAD@00004@Read by other. +TOWRITE@00002@Write by other. +TOEXEC@00001@Execute/search by other. +.TE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "\fIpax\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/termios.h.0p b/upstream/mageia-cauldron/man0p/termios.h.0p new file mode 100644 index 00000000..77f768ab --- /dev/null +++ b/upstream/mageia-cauldron/man0p/termios.h.0p @@ -0,0 +1,459 @@ +'\" et +.TH termios.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +termios.h +\(em define values for termios +.SH SYNOPSIS +.LP +.nf +#include <termios.h> +.fi +.SH DESCRIPTION +The +.IR <termios.h> +header shall contain the definitions used by the terminal I/O +interfaces (see +.IR "Chapter 11" ", " "General Terminal Interface" +for the structures and names defined). +.SS "The termios Structure" +.P +The +.IR <termios.h> +header shall define the following data types through +.BR typedef : +.IP "\fBcc_t\fP" 12 +Used for terminal special characters. +.IP "\fBspeed_t\fP" 12 +Used for terminal baud rates. +.IP "\fBtcflag_t\fP" 12 +Used for terminal modes. +.P +The above types shall be all unsigned integer types. +.P +The implementation shall support one or more programming environments +in which the widths of +.BR cc_t , +.BR speed_t , +and +.BR tcflag_t +are no greater than the width of type +.BR long . +The names of these programming environments can be obtained using the +\fIconfstr\fR() +function or the +.IR getconf +utility. +.P +The +.IR <termios.h> +header shall define the +.BR termios +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +tcflag_t c_iflag \fRInput modes.\fR +tcflag_t c_oflag \fROutput modes.\fR +tcflag_t c_cflag \fRControl modes.\fR +tcflag_t c_lflag \fRLocal modes.\fR +cc_t c_cc[NCCS] \fRControl characters.\fR +.fi +.P +.RE +.P +The +.IR <termios.h> +header shall define the following symbolic constant: +.IP NCCS 12 +Size of the array +.IR c_cc +for control characters. +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use as +subscripts for the array +.IR c_cc : +.TS +box center tab(!); +cb s | l +cb cb | cb +l | l | l. +Subscript Usage +Canonical Mode!Non-Canonical Mode!Description +_ +VEOF!!EOF character. +VEOL!!EOL character. +VERASE!!ERASE character. +VINTR!VINTR!INTR character. +VKILL!!KILL character. +\&!VMIN!MIN value. +VQUIT!VQUIT!QUIT character. +VSTART!VSTART!START character. +VSTOP!VSTOP!STOP character. +VSUSP!VSUSP!SUSP character. +\&!VTIME!TIME value. +.TE +.P +The subscript values shall be suitable for use in +.BR #if +preprocessing directives and shall be distinct, except that the VMIN +and VTIME subscripts may have the same values as the VEOF and +VEOL subscripts, respectively. +.SS "Input Modes" +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use as flags +in the +.IR c_iflag +field. The +.IR c_iflag +field describes the basic terminal input control. +.IP BRKINT 12 +Signal interrupt on break. +.IP ICRNL 12 +Map CR to NL on input. +.IP IGNBRK 12 +Ignore break condition. +.IP IGNCR 12 +Ignore CR. +.IP IGNPAR 12 +Ignore characters with parity errors. +.IP INLCR 12 +Map NL to CR on input. +.IP INPCK 12 +Enable input parity check. +.IP ISTRIP 12 +Strip character. +.IP IXANY 12 +Enable any character to restart output. +.IP IXOFF 12 +Enable start/stop input control. +.IP IXON 12 +Enable start/stop output control. +.IP PARMRK 12 +Mark parity errors. +.SS "Output Modes" +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use as flags +in the +.IR c_oflag +field. The +.IR c_oflag +field specifies the system treatment of output. +.IP OPOST 12 +Post-process output. +.IP ONLCR 12 +Map NL to CR-NL on output. +.IP OCRNL 12 +Map CR to NL on output. +.IP ONOCR 12 +No CR output at column 0. +.IP ONLRET 12 +NL performs CR function. +.IP OFDEL 12 +Fill is DEL. +.IP OFILL 12 +Use fill characters for delay. +.IP NLDLY 12 +Select newline delays: +.RS 12 +.IP NL0 8 +Newline type 0. +.IP NL1 8 +Newline type 1. +.RE +.IP CRDLY 12 +Select carriage-return delays: +.RS 12 +.IP CR0 8 +Carriage-return delay type 0. +.IP CR1 8 +Carriage-return delay type 1. +.IP CR2 8 +Carriage-return delay type 2. +.IP CR3 8 +Carriage-return delay type 3. +.RE +.IP TABDLY 12 +Select horizontal-tab delays: +.RS 12 +.IP TAB0 8 +Horizontal-tab delay type 0. +.IP TAB1 8 +Horizontal-tab delay type 1. +.IP TAB2 8 +Horizontal-tab delay type 2. +.IP TAB3 8 +Expand tabs to spaces. +.RE +.IP BSDLY 12 +Select backspace delays: +.RS 12 +.IP BS0 8 +Backspace-delay type 0. +.IP BS1 8 +Backspace-delay type 1. +.RE +.IP VTDLY 12 +Select vertical-tab delays: +.RS 12 +.IP VT0 8 +Vertical-tab delay type 0. +.IP VT1 8 +Vertical-tab delay type 1. +.RE +.IP FFDLY 12 +Select form-feed delays: +.RS 12 +.IP FF0 8 +Form-feed delay type 0. +.IP FF1 8 +Form-feed delay type 1. +.RE +.SS "Baud Rate Selection" +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use as values +of objects of type +.BR speed_t . +.P +The input and output baud rates are stored in the +.BR termios +structure. These are the valid values for objects of type +.BR speed_t . +Not all baud rates need be supported by the underlying hardware. +.IP B0 12 +Hang up +.IP B50 12 +50 baud +.IP B75 12 +75 baud +.IP B110 12 +110 baud +.IP B134 12 +134.5 baud +.IP B150 12 +150 baud +.IP B200 12 +200 baud +.IP B300 12 +300 baud +.IP B600 12 +600 baud +.IP B1200 12 +1\|200 baud +.IP B1800 12 +1\|800 baud +.IP B2400 12 +2\|400 baud +.IP B4800 12 +4\|800 baud +.IP B9600 12 +9\|600 baud +.IP B19200 12 +19\|200 baud +.IP B38400 12 +38\|400 baud +.SS "Control Modes" +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use as flags +in the +.IR c_cflag +field. The +.IR c_cflag +field describes the hardware control of the terminal; not all values +specified are required to be supported by the underlying hardware. +.IP CSIZE 12 +Character size: +.RS 12 +.IP CS5 8 +5 bits +.IP CS6 8 +6 bits +.IP CS7 8 +7 bits +.IP CS8 8 +8 bits +.RE +.IP CSTOPB 12 +Send two stop bits, else one. +.IP CREAD 12 +Enable receiver. +.IP PARENB 12 +Parity enable. +.IP PARODD 12 +Odd parity, else even. +.IP HUPCL 12 +Hang up on last close. +.IP CLOCAL 12 +Ignore modem status lines. +.P +The implementation shall support the functionality associated with the +symbols CS7, CS8, CSTOPB, PARODD, and PARENB. +.SS "Local Modes" +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use as flags +in the +.IR c_lflag +field. The +.IR c_lflag +field of the argument structure is used to control various terminal +functions. +.IP ECHO 12 +Enable echo. +.IP ECHOE 12 +Echo erase character as error-correcting backspace. +.IP ECHOK 12 +Echo KILL. +.IP ECHONL 12 +Echo NL. +.IP ICANON 12 +Canonical input (erase and kill processing). +.IP IEXTEN 12 +Enable extended input character processing. +.IP ISIG 12 +Enable signals. +.IP NOFLSH 12 +Disable flush after interrupt or quit. +.IP TOSTOP 12 +Send SIGTTOU for background output. +.SS "Attribute Selection" +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use with +\fItcsetattr\fR(): +.IP TCSANOW 12 +Change attributes immediately. +.IP TCSADRAIN 12 +Change attributes when output has drained. +.IP TCSAFLUSH 12 +Change attributes when output has drained; also flush pending input. +.SS "Line Control" +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use with +\fItcflush\fR(): +.IP TCIFLUSH 12 +Flush pending input. +.IP TCIOFLUSH 12 +Flush both pending input and untransmitted output. +.IP TCOFLUSH 12 +Flush untransmitted output. +.P +The +.IR <termios.h> +header shall define the following symbolic constants for use with +\fItcflow\fR(): +.IP TCIOFF 12 +Transmit a STOP character, intended to suspend input data. +.IP TCION 12 +Transmit a START character, intended to restart input data. +.IP TCOOFF 12 +Suspend output. +.IP TCOON 12 +Restart output. +.P +The +.IR <termios.h> +header shall define the +.BR pid_t +type as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +speed_t cfgetispeed(const struct termios *); +speed_t cfgetospeed(const struct termios *); +int cfsetispeed(struct termios *, speed_t); +int cfsetospeed(struct termios *, speed_t); +int tcdrain(int); +int tcflow(int, int); +int tcflush(int, int); +int tcgetattr(int, struct termios *); +pid_t tcgetsid(int); +int tcsendbreak(int, int); +int tcsetattr(int, int, const struct termios *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +The following names are reserved for XSI-conformant systems to use as +an extension to the above; therefore strictly conforming applications +shall not use them: +.TS +tab(@); +le le le. +CBAUD@EXTB@VDSUSP +DEFECHO@FLUSHO@VLNEXT +ECHOCTL@LOBLK@VREPRINT +ECHOKE@PENDIN@VSTATUS +ECHOPRT@SWTCH@VWERASE +EXTA@VDISCARD +.TE +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIcfgetispeed\fR\^(\|)", +.IR "\fIcfgetospeed\fR\^(\|)", +.IR "\fIcfsetispeed\fR\^(\|)", +.IR "\fIcfsetospeed\fR\^(\|)", +.IR "\fIconfstr\fR\^(\|)", +.IR "\fItcdrain\fR\^(\|)", +.IR "\fItcflow\fR\^(\|)", +.IR "\fItcflush\fR\^(\|)", +.IR "\fItcgetattr\fR\^(\|)", +.IR "\fItcgetsid\fR\^(\|)", +.IR "\fItcsendbreak\fR\^(\|)", +.IR "\fItcsetattr\fR\^(\|)" +.P +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "Chapter 11" ", " "General Terminal Interface", +.IR "\fIgetconf\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/tgmath.h.0p b/upstream/mageia-cauldron/man0p/tgmath.h.0p new file mode 100644 index 00000000..af13357d --- /dev/null +++ b/upstream/mageia-cauldron/man0p/tgmath.h.0p @@ -0,0 +1,398 @@ +'\" et +.TH tgmath.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +tgmath.h +\(em type-generic macros +.SH SYNOPSIS +.LP +.nf +#include <tgmath.h> +.fi +.SH DESCRIPTION +The functionality described on this reference page is aligned with the +ISO\ C standard. Any conflict between the requirements described here and the +ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard. +.P +The +.IR <tgmath.h> +header shall include the headers +.IR <math.h> +and +.IR <complex.h> +and shall define several type-generic macros. +.P +Of the functions contained within the +.IR <math.h> +and +.IR <complex.h> +headers without an +.IR f +(\c +.BR float ) +or +.IR l +(\c +.BR "long double" ) +suffix, several have one or more parameters whose corresponding real +type is +.BR double . +For each such function, except +\fImodf\fR(), +\fIj0\fR(), +\fIj1\fR(), +\fIjn\fR(), +\fIy0\fR(), +\fIy1\fR(), +and +\fIyn\fR(), +there shall be a corresponding type-generic macro. The parameters +whose corresponding real type is +.BR double +in the function synopsis are generic parameters. Use of the macro +invokes a function whose corresponding real type and type domain are +determined by the arguments for the generic parameters. +.P +Use of the macro invokes a function whose generic parameters have the +corresponding real type determined as follows: +.IP " *" 4 +First, if any argument for generic parameters has type +.BR "long double" , +the type determined is +.BR "long double" . +.IP " *" 4 +Otherwise, if any argument for generic parameters has type +.BR double +or is of integer type, the type determined is +.BR double . +.IP " *" 4 +Otherwise, the type determined is +.BR float . +.P +For each unsuffixed function in the +.IR <math.h> +header for which there is a function in the +.IR <complex.h> +header with the same name except for a +.IR c +prefix, the corresponding type-generic macro (for both functions) has +the same name as the function in the +.IR <math.h> +header. The corresponding type-generic macro for +\fIfabs\fR() +and +\fIcabs\fR() +is +\fIfabs\fR(). +.TS +center box tab(!); +cB | cB | cB +l | l | l. +<math.h> Function!<complex.h> Function!Type-Generic Macro +_ +\fIacos\fR\^(\|)!\fIcacos\fR\^(\|)!\fIacos\fR\^(\|) +\fIasin\fR\^(\|)!\fIcasin\fR\^(\|)!\fIasin\fR\^(\|) +\fIatan\fR\^(\|)!\fIcatan\fR\^(\|)!\fIatan\fR\^(\|) +\fIacosh\fR\^(\|)!\fIcacosh\fR\^(\|)!\fIacosh\fR\^(\|) +\fIasinh\fR\^(\|)!\fIcasinh\fR\^(\|)!\fIasinh\fR\^(\|) +\fIatanh\fR\^(\|)!\fIcatanh\fR\^(\|)!\fIatanh\fR\^(\|) +\fIcos\fR\^(\|)!\fIccos\fR\^(\|)!\fIcos\fR\^(\|) +\fIsin\fR\^(\|)!\fIcsin\fR\^(\|)!\fIsin\fR\^(\|) +\fItan\fR\^(\|)!\fIctan\fR\^(\|)!\fItan\fR\^(\|) +\fIcosh\fR\^(\|)!\fIccosh\fR\^(\|)!\fIcosh\fR\^(\|) +\fIsinh\fR\^(\|)!\fIcsinh\fR\^(\|)!\fIsinh\fR\^(\|) +\fItanh\fR\^(\|)!\fIctanh\fR\^(\|)!\fItanh\fR\^(\|) +\fIexp\fR\^(\|)!\fIcexp\fR\^(\|)!\fIexp\fR\^(\|) +\fIlog\fR\^(\|)!\fIclog\fR\^(\|)!\fIlog\fR\^(\|) +\fIpow\fR\^(\|)!\fIcpow\fR\^(\|)!\fIpow\fR\^(\|) +\fIsqrt\fR\^(\|)!\fIcsqrt\fR\^(\|)!\fIsqrt\fR\^(\|) +\fIfabs\fR\^(\|)!\fIcabs\fR\^(\|)!\fIfabs\fR\^(\|) +.TE +.P +If at least one argument for a generic parameter is complex, then use +of the macro invokes a complex function; otherwise, use of the macro +invokes a real function. +.P +For each unsuffixed function in the +.IR <math.h> +header without a +.IR c -prefixed +counterpart in the +.IR <complex.h> +header, except for +\fImodf\fR(), +\fIj0\fR(), +\fIj1\fR(), +\fIjn\fR(), +\fIy0\fR(), +\fIy1\fR(), +and +\fIyn\fR(), +the corresponding type-generic macro has the same name as the function. +These type-generic macros are: +.sp +.RS +.TS +tab(!); +l l l l. +T{ +.nf +\fIatan2\fR() +\fIcbrt\fR() +\fIceil\fR() +\fIcopysign\fR() +\fIerf\fR() +\fIerfc\fR() +\fIexp2\fR() +\fIexpm1\fR() +\fIfdim\fR() +\fIfloor\fR() +T}!T{ +.nf +\fIfma\fR() +\fIfmax\fR() +\fIfmin\fR() +\fIfmod\fR() +\fIfrexp\fR() +\fIhypot\fR() +\fIilogb\fR() +\fIldexp\fR() +\fIlgamma\fR() +\fIllrint\fR() +T}!T{ +.nf +\fIllround\fR() +\fIlog10\fR() +\fIlog1p\fR() +\fIlog2\fR() +\fIlogb\fR() +\fIlrint\fR() +\fIlround\fR() +\fInearbyint\fR() +\fInextafter\fR() +\fInexttoward\fR() +T}!T{ +.nf +\fIremainder\fR() +\fIremquo\fR() +\fIrint\fR() +\fIround\fR() +\fIscalbln\fR() +\fIscalbn\fR() +\fItgamma\fR() +\fItrunc\fR() +.fi +T} +.TE +.RE +.P +If all arguments for generic parameters are real, then use of the macro +invokes a real function; otherwise, use of the macro results in +undefined behavior. +.P +For each unsuffixed function in the +.IR <complex.h> +header that is not a +.IR c -prefixed +counterpart to a function in the +.IR <math.h> +header, the corresponding type-generic macro has the same name as the +function. These type-generic macros are: +.sp +.RS +\fIcarg\fR() +\fIcimag\fR() +\fIconj\fR() +\fIcproj\fR() +\fIcreal\fR() +.RE +.P +Use of the macro with any real or complex argument invokes a complex +function. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +With the declarations: +.sp +.RS 4 +.nf + +#include <tgmath.h> +int n; +float f; +double d; +long double ld; +float complex fc; +double complex dc; +long double complex ldc; +.fi +.P +.RE +.P +functions invoked by use of type-generic macros are shown in the +following table: +.TS +center box tab(!); +cB | cB +l | l. +Macro!Use Invokes +_ +\fIexp\fR(\fIn\fR)!\fIexp\fR(\fIn\fR), the function +\fIacosh\fR(\fIf\fR)!\fIacoshf\fR(\fIf\fR) +\fIsin\fR(\fId\fR)!\fIsin\fR(\fId\fR), the function +\fIatan\fR(\fIld\fR)!\fIatanl\fR(\fIld\fR) +\fIlog\fR(\fIfc\fR)!\fIclogf\fR(\fIfc\fR) +\fIsqrt\fR(\fIdc\fR)!\fIcsqrt\fR(\fIdc\fR) +\fIpow\fR(\fIldc,f\fR)!\fIcpowl\fR(\fIldc, f\fR) +\fIremainder\fR(\fIn,n\fR)!\fIremainder\fR(\fIn, n\fR), the function +\fInextafter\fR(\fId,f\fR)!\fInextafter\fR(\fId, f\fR), the function +\fInexttoward\fR(\fIf,ld\fR)!\fInexttowardf\fR(\fIf, ld\fR) +\fIcopysign\fR(\fIn,ld\fR)!\fIcopysignl\fR(\fIn, ld\fR) +\fIceil\fR(\fIfc\fR)!Undefined behavior +\fIrint\fR(\fIdc\fR)!Undefined behavior +\fIfmax\fR(\fIldc,ld\fR)!Undefined behavior +\fIcarg\fR(\fIn\fR)!\fIcarg\fR(\fIn\fR), the function +\fIcproj\fR(\fIf\fR)!\fIcprojf\fR(\fIf\fR) +\fIcreal\fR(\fId\fR)!\fIcreal\fR(\fId\fR), the function +\fIcimag\fR(\fIld\fR)!\fIcimagl\fR(\fIld\fR) +\fIcabs\fR(\fIfc\fR)!\fIcabsf\fR(\fIfc\fR) +\fIcarg\fR(\fIdc\fR)!\fIcarg\fR(\fIdc\fR), the function +\fIcproj\fR(\fIldc\fR)!\fIcprojl\fR(\fIldc\fR) +.TE +.SH RATIONALE +Type-generic macros allow calling a function whose type is determined +by the argument type, as is the case for C operators such as +.BR '+' +and +.BR '*' . +For example, with a type-generic +\fIcos\fR() +macro, the expression +.IR cos ((\c +.BR float )\c +.IR x ) +will have type +.BR float . +This feature enables writing more portably efficient code and +alleviates need for awkward casting and suffixing in the process of +porting or adjusting precision. Generic math functions are a widely +appreciated feature of Fortran. +.P +The only arguments that affect the type resolution are the arguments +corresponding to the parameters that have type +.BR double +in the synopsis. Hence the type of a type-generic call to +\fInexttoward\fR(), +whose second parameter is +.BR "long double" +in the synopsis, is determined solely by the type of the first +argument. +.P +The term ``type-generic'' was chosen over the proposed alternatives of +intrinsic and overloading. The term is more specific than intrinsic, +which already is widely used with a more general meaning, and reflects +a closer match to Fortran's generic functions than to C++ overloading. +.P +The macros are placed in their own header in order not to silently +break old programs that include the +.IR <math.h> +header; for example, with: +.sp +.RS 4 +.nf + +printf ("%e", sin(x)) +.fi +.P +.RE +.P +.IR modf (\c +.BR double , +.BR "double *" ) +is excluded because no way was seen to make it safe without +complicating the type resolution. +.P +The implementation might, as an extension, endow appropriate ones of +the macros that POSIX.1\(hy2008 specifies only for real arguments with the +ability to invoke the complex functions. +.P +POSIX.1\(hy2008 does not prescribe any particular implementation mechanism +for generic macros. It could be implemented simply with built-in +macros. The generic macro for +\fIsqrt\fR(), +for example, could be implemented with: +.sp +.RS 4 +.nf + +#undef sqrt +#define sqrt(x) __BUILTIN_GENERIC_sqrt(x) +.fi +.P +.RE +.P +Generic macros are designed for a useful level of consistency with C++ +overloaded math functions. +.P +The great majority of existing C programs are expected to be unaffected +when the +.IR <tgmath.h> +header is included instead of the +.IR <math.h> +or +.IR <complex.h> +headers. Generic macros are similar to the ISO/IEC\ 9899:\|1999 standard library masking +macros, though the semantic types of return values differ. +.P +The ability to overload on integer as well as floating types would have +been useful for some functions; for example, +\fIcopysign\fR(). +Overloading with different numbers of arguments would have allowed +reusing names; for example, +\fIremainder\fR() +for +\fIremquo\fR(). +However, these facilities would have complicated the specification; and +their natural consistent use, such as for a floating +\fIabs\fR() +or a two-argument +\fIatan\fR(), +would have introduced further inconsistencies with the ISO/IEC\ 9899:\|1999 standard for +insufficient benefit. +.P +The ISO\ C standard in no way limits the implementation's options for efficiency, +including inlining library functions. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<math.h>\fP", +.IR "\fB<complex.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIcabs\fR\^(\|)", +.IR "\fIfabs\fR\^(\|)", +.IR "\fImodf\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/time.h.0p b/upstream/mageia-cauldron/man0p/time.h.0p new file mode 100644 index 00000000..51e74979 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/time.h.0p @@ -0,0 +1,333 @@ +'\" et +.TH time.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +time.h +\(em time types +.SH SYNOPSIS +.LP +.nf +#include <time.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <time.h> +header shall define the +.BR clock_t , +.BR size_t , +.BR time_t , +types as described in +.IR <sys/types.h> . +.P +The +.IR <time.h> +header shall define the +.BR clockid_t +and +.BR timer_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <time.h> +header shall define the +.BR locale_t +type as described in +.IR <locale.h> . +.P +The +.IR <time.h> +header shall define the +.BR pid_t +type as described in +.IR <sys/types.h> . +.P +The tag +.BR sigevent +shall be declared as naming an incomplete structure type, the contents +of which are described in the +.IR <signal.h> +header. +.P +The +.IR <time.h> +header shall declare the +.BR tm +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int tm_sec \fRSeconds [0,60].\fR +int tm_min \fRMinutes [0,59].\fR +int tm_hour \fRHour [0,23].\fR +int tm_mday \fRDay of month [1,31].\fR +int tm_mon \fRMonth of year [0,11].\fR +int tm_year \fRYears since 1900.\fR +int tm_wday \fRDay of week [0,6] (Sunday =0).\fR +int tm_yday \fRDay of year [0,365].\fR +int tm_isdst \fRDaylight Savings flag.\fR +.fi +.P +.RE +.P +The value of +.IR tm_isdst +shall be positive if Daylight Savings Time is in effect, 0 if Daylight +Savings Time is not in effect, and negative if the information is not +available. +.P +The +.IR <time.h> +header shall declare the +.BR timespec +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +time_t tv_sec \fRSeconds.\fR +long tv_nsec \fRNanoseconds.\fR +.fi +.P +.RE +.P +The +.IR <time.h> +header shall also declare the +.BR itimerspec +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +struct timespec it_interval \fRTimer period.\fR +struct timespec it_value \fRTimer expiration.\fR +.fi +.P +.RE +.P +The +.IR <time.h> +header shall define the following macros: +.IP NULL 14 +As described in +.IR <stddef.h> . +.IP CLOCKS_PER_SEC 14 +A number used to convert the value returned by the +\fIclock\fR() +function into seconds. The value shall be an expression with type +.BR clock_t . +The value of CLOCKS_PER_SEC shall be 1 million +on XSI-conformant systems. However, it may be variable on other systems, +and it should not be assumed that CLOCKS_PER_SEC is a compile-time +constant. +.P +The +.IR <time.h> +header shall define the following symbolic constants. The values shall +have a type that is assignment-compatible with +.BR clockid_t . +.IP CLOCK_MONOTONIC 14 +.br +The identifier for the system-wide monotonic clock, which is defined as +a clock measuring real time, whose value cannot be set via +\fIclock_settime\fR() +and which cannot have negative clock jumps. The maximum possible clock +jump shall be implementation-defined. +.IP CLOCK_PROCESS_CPUTIME_ID 14 +.br +The identifier of the CPU-time clock associated with the process +making a +\fIclock\fR() +or +.IR timer* (\|) +function call. +.IP CLOCK_REALTIME 14 +The identifier of the system-wide clock measuring real time. +.IP CLOCK_THREAD_CPUTIME_ID 14 +.br +The identifier of the CPU-time clock associated with the thread making a +\fIclock\fR() +or +.IR timer* (\|) +function call. +.P +The +.IR <time.h> +header shall define the following symbolic constant: +.IP TIMER_ABSTIME 14 +Flag indicating time is absolute. For functions taking timer objects, +this refers to the clock associated with the timer. +.P +The +.IR <time.h> +header shall provide a declaration or definition for +.IR getdate_err . +The +.IR getdate_err +symbol shall expand to an expression of type +.BR int . +It is unspecified whether +.IR getdate_err +is a macro or an identifier declared with external linkage, and whether or +not it is a modifiable lvalue. If a macro definition is suppressed in +order to access an actual object, or a program defines an identifier +with the name +.IR getdate_err , +the behavior is undefined. +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +char *asctime(const struct tm *); +char *asctime_r(const struct tm *restrict, char *restrict); +clock_t clock(void); +int clock_getcpuclockid(pid_t, clockid_t *); +int clock_getres(clockid_t, struct timespec *); +int clock_gettime(clockid_t, struct timespec *); +int clock_nanosleep(clockid_t, int, const struct timespec *, + struct timespec *); +int clock_settime(clockid_t, const struct timespec *); +char *ctime(const time_t *); +char *ctime_r(const time_t *, char *); +double difftime(time_t, time_t); +struct tm *getdate(const char *); +struct tm *gmtime(const time_t *); +struct tm *gmtime_r(const time_t *restrict, struct tm *restrict); +struct tm *localtime(const time_t *); +struct tm *localtime_r(const time_t *restrict, struct tm *restrict); +time_t mktime(struct tm *); +int nanosleep(const struct timespec *, struct timespec *); +size_t strftime(char *restrict, size_t, const char *restrict, + const struct tm *restrict); +size_t strftime_l(char *restrict, size_t, const char *restrict, + const struct tm *restrict, locale_t); +char *strptime(const char *restrict, const char *restrict, + struct tm *restrict); +time_t time(time_t *); +int timer_create(clockid_t, struct sigevent *restrict, + timer_t *restrict); +int timer_delete(timer_t); +int timer_getoverrun(timer_t); +int timer_gettime(timer_t, struct itimerspec *); +int timer_settime(timer_t, int, const struct itimerspec *restrict, + struct itimerspec *restrict); +void tzset(void); +.fi +.P +.RE +.br +.P +The +.IR <time.h> +header shall declare the following as variables: +.sp +.RS 4 +.nf + +extern int daylight; +extern long timezone; +extern char *tzname[]; +.fi +.P +.RE +.P +Inclusion of the +.IR <time.h> +header may make visible all symbols from the +.IR <signal.h> +header. +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +The range [0,60] for +.IR tm_sec +allows for the occasional leap second. +.P +.IR tm_year +is a signed value; therefore, years before 1900 may be represented. +.P +To obtain the number of clock ticks per second returned by the +\fItimes\fR() +function, applications should call +.IR sysconf (_SC_CLK_TCK). +.SH RATIONALE +The range [0,60] seconds allows for positive or negative leap seconds. +The formal definition of UTC does not permit double leap seconds, so +all mention of double leap seconds has been removed, and the range +shortened from the former [0,61] seconds seen in earlier versions of +this standard. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<locale.h>\fP", +.IR "\fB<signal.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIasctime\fR\^(\|)", +.IR "\fIclock\fR\^(\|)", +.IR "\fIclock_getcpuclockid\fR\^(\|)", +.IR "\fIclock_getres\fR\^(\|)", +.IR "\fIclock_nanosleep\fR\^(\|)", +.IR "\fIctime\fR\^(\|)", +.IR "\fIdifftime\fR\^(\|)", +.IR "\fIgetdate\fR\^(\|)", +.IR "\fIgmtime\fR\^(\|)", +.IR "\fIlocaltime\fR\^(\|)", +.IR "\fImktime\fR\^(\|)", +.IR "\fImq_receive\fR\^(\|)", +.IR "\fImq_send\fR\^(\|)", +.IR "\fInanosleep\fR\^(\|)", +.IR "\fIpthread_getcpuclockid\fR\^(\|)", +.IR "\fIpthread_mutex_timedlock\fR\^(\|)", +.IR "\fIpthread_rwlock_timedrdlock\fR\^(\|)", +.IR "\fIpthread_rwlock_timedwrlock\fR\^(\|)", +.IR "\fIsem_timedwait\fR\^(\|)", +.IR "\fIstrftime\fR\^(\|)", +.IR "\fIstrptime\fR\^(\|)", +.IR "\fIsysconf\fR\^(\|)", +.IR "\fItime\fR\^(\|)", +.IR "\fItimer_create\fR\^(\|)", +.IR "\fItimer_delete\fR\^(\|)", +.IR "\fItimer_getoverrun\fR\^(\|)", +.IR "\fItzset\fR\^(\|)", +.IR "\fIutime\fR\^(\|)" +.ad b +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/trace.h.0p b/upstream/mageia-cauldron/man0p/trace.h.0p new file mode 100644 index 00000000..41009ec0 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/trace.h.0p @@ -0,0 +1,238 @@ +'\" et +.TH trace.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +trace.h +\(em tracing +.SH SYNOPSIS +.LP +.nf +#include <trace.h> +.fi +.SH DESCRIPTION +The +.IR <trace.h> +header shall define the +.BR posix_trace_event_info +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +trace_event_id_t posix_event_id +pid_t posix_pid +void *posix_prog_address +pthread_t posix_thread_id +struct timespec posix_timestamp +int posix_truncation_status +.fi +.P +.RE +.P +The +.IR <trace.h> +header shall define the +.BR posix_trace_status_info +structure, which shall include at least the following members: +.sp +.RS 4 +.nf + +int posix_stream_full_status +int posix_stream_overrun_status +int posix_stream_status +int posix_log_full_status +int posix_log_overrun_status +int posix_stream_flush_error +int posix_stream_flush_status +.fi +.P +.RE +.P +The +.IR <trace.h> +header shall define the following symbolic constants: +.P +.nf +POSIX_TRACE_ALL_EVENTS +POSIX_TRACE_APPEND +POSIX_TRACE_CLOSE_FOR_CHILD +POSIX_TRACE_FILTER +POSIX_TRACE_FLUSH +POSIX_TRACE_FLUSH_START +POSIX_TRACE_FLUSH_STOP +POSIX_TRACE_FLUSHING +POSIX_TRACE_FULL +POSIX_TRACE_LOOP +POSIX_TRACE_NO_OVERRUN +POSIX_TRACE_NOT_FLUSHING +POSIX_TRACE_NOT_FULL +POSIX_TRACE_INHERITED +POSIX_TRACE_NOT_TRUNCATED +POSIX_TRACE_OVERFLOW +POSIX_TRACE_OVERRUN +POSIX_TRACE_RESUME +POSIX_TRACE_RUNNING +POSIX_TRACE_START +POSIX_TRACE_STOP +POSIX_TRACE_SUSPENDED +POSIX_TRACE_SYSTEM_EVENTS +POSIX_TRACE_TRUNCATED_READ +POSIX_TRACE_TRUNCATED_RECORD +POSIX_TRACE_UNNAMED_USER_EVENT +POSIX_TRACE_UNTIL_FULL +POSIX_TRACE_WOPID_EVENTS +.fi +.P +The +.IR <trace.h> +header shall define the +.BR size_t , +.BR trace_attr_t , +.BR trace_event_id_t , +.BR trace_event_set_t , +and +.BR trace_id_t +types as described in +.IR <sys/types.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int posix_trace_attr_destroy(trace_attr_t *); +int posix_trace_attr_getclockres(const trace_attr_t *, + struct timespec *); +int posix_trace_attr_getcreatetime(const trace_attr_t *, + struct timespec *); +int posix_trace_attr_getgenversion(const trace_attr_t *, char *); +int posix_trace_attr_getinherited(const trace_attr_t *restrict, + int *restrict); +int posix_trace_attr_getlogfullpolicy(const trace_attr_t *restrict, + int *restrict); +int posix_trace_attr_getlogsize(const trace_attr_t *restrict, + size_t *restrict); +int posix_trace_attr_getmaxdatasize(const trace_attr_t *restrict, + size_t *restrict); +int posix_trace_attr_getmaxsystemeventsize(const trace_attr_t *restrict, + size_t *restrict); +int posix_trace_attr_getmaxusereventsize(const trace_attr_t *restrict, + size_t, size_t *restrict); +int posix_trace_attr_getname(const trace_attr_t *, char *); +int posix_trace_attr_getstreamfullpolicy(const trace_attr_t *restrict, + int *restrict); +int posix_trace_attr_getstreamsize(const trace_attr_t *restrict, + size_t *restrict); +int posix_trace_attr_init(trace_attr_t *); +int posix_trace_attr_setinherited(trace_attr_t *, int); +int posix_trace_attr_setlogfullpolicy(trace_attr_t *, int); +int posix_trace_attr_setlogsize(trace_attr_t *, size_t); +int posix_trace_attr_setmaxdatasize(trace_attr_t *, size_t); +int posix_trace_attr_setname(trace_attr_t *, const char *); +int posix_trace_attr_setstreamfullpolicy(trace_attr_t *, int); +int posix_trace_attr_setstreamsize(trace_attr_t *, size_t); +int posix_trace_clear(trace_id_t); +int posix_trace_close(trace_id_t); +int posix_trace_create(pid_t, const trace_attr_t *restrict, + trace_id_t *restrict); +int posix_trace_create_withlog(pid_t, const trace_attr_t *restrict, + int, trace_id_t *restrict); +void posix_trace_event(trace_event_id_t, const void *restrict, size_t); +int posix_trace_eventid_equal(trace_id_t, trace_event_id_t, + trace_event_id_t); +int posix_trace_eventid_get_name(trace_id_t, trace_event_id_t, char *); +int posix_trace_eventid_open(const char *restrict, + trace_event_id_t *restrict); +int posix_trace_eventset_add(trace_event_id_t, trace_event_set_t *); +int posix_trace_eventset_del(trace_event_id_t, trace_event_set_t *); +int posix_trace_eventset_empty(trace_event_set_t *); +int posix_trace_eventset_fill(trace_event_set_t *, int); +int posix_trace_eventset_ismember(trace_event_id_t, + const trace_event_set_t *restrict, int *restrict); +int posix_trace_eventtypelist_getnext_id(trace_id_t, + trace_event_id_t *restrict, int *restrict); +int posix_trace_eventtypelist_rewind(trace_id_t); +int posix_trace_flush(trace_id_t); +int posix_trace_get_attr(trace_id_t, trace_attr_t *); +int posix_trace_get_filter(trace_id_t, trace_event_set_t *); +int posix_trace_get_status(trace_id_t, + struct posix_trace_status_info *); +int posix_trace_getnext_event(trace_id_t, + struct posix_trace_event_info *restrict, void *restrict, + size_t, size_t *restrict, int *restrict); +int posix_trace_open(int, trace_id_t *); +int posix_trace_rewind(trace_id_t); +int posix_trace_set_filter(trace_id_t, const trace_event_set_t *, int); +int posix_trace_shutdown(trace_id_t); +int posix_trace_start(trace_id_t); +int posix_trace_stop(trace_id_t); +int posix_trace_timedgetnext_event(trace_id_t, + struct posix_trace_event_info *restrict, void *restrict, + size_t, size_t *restrict, int *restrict, + const struct timespec *restrict); +int posix_trace_trid_eventid_open(trace_id_t, const char *restrict, + trace_event_id_t *restrict); +int posix_trace_trygetnext_event(trace_id_t, + struct posix_trace_event_info *restrict, void *restrict, size_t, + size_t *restrict, int *restrict); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +The +.IR <trace.h> +header may be removed in a future version. +.SH "SEE ALSO" +.IR "\fB<sys_types.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.11" ", " "Tracing", +.IR "\fIposix_trace_attr_destroy\fR\^(\|)", +.IR "\fIposix_trace_attr_getclockres\fR\^(\|)", +.IR "\fIposix_trace_attr_getinherited\fR\^(\|)", +.IR "\fIposix_trace_attr_getlogsize\fR\^(\|)", +.IR "\fIposix_trace_clear\fR\^(\|)", +.IR "\fIposix_trace_close\fR\^(\|)", +.IR "\fIposix_trace_create\fR\^(\|)", +.IR "\fIposix_trace_event\fR\^(\|)", +.IR "\fIposix_trace_eventid_equal\fR\^(\|)", +.IR "\fIposix_trace_eventset_add\fR\^(\|)", +.IR "\fIposix_trace_eventtypelist_getnext_id\fR\^(\|)", +.IR "\fIposix_trace_get_attr\fR\^(\|)", +.IR "\fIposix_trace_get_filter\fR\^(\|)", +.IR "\fIposix_trace_getnext_event\fR\^(\|)", +.IR "\fIposix_trace_start\fR\^(\|)" +.ad b +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/ulimit.h.0p b/upstream/mageia-cauldron/man0p/ulimit.h.0p new file mode 100644 index 00000000..a4a78301 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/ulimit.h.0p @@ -0,0 +1,70 @@ +'\" et +.TH ulimit.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +ulimit.h +\(em ulimit commands +.SH SYNOPSIS +.LP +.nf +#include <ulimit.h> +.fi +.SH DESCRIPTION +The +.IR <ulimit.h> +header shall define the symbolic constants used by the +\fIulimit\fR() +function. +.P +Symbolic constants: +.IP UL_GETFSIZE 12 +Get maximum file size. +.IP UL_SETFSIZE 12 +Set maximum file size. +.P +The following shall be declared as a function and may also be defined +as a macro. A function prototype shall be provided. +.sp +.RS 4 +.nf + +long ulimit(int, ...); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +See +\fIulimit\fR(). +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIulimit\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/unistd.h.0p b/upstream/mageia-cauldron/man0p/unistd.h.0p new file mode 100644 index 00000000..86137f16 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/unistd.h.0p @@ -0,0 +1,1634 @@ +'\" et +.TH unistd.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +unistd.h +\(em standard symbolic constants and types +.SH SYNOPSIS +.LP +.nf +#include <unistd.h> +.fi +.SH DESCRIPTION +The +.IR <unistd.h> +header defines miscellaneous symbolic constants and types, and declares +miscellaneous functions. The actual values of the constants are +unspecified except as shown. The contents of this header are shown +below. +.SS "Version Test Macros" +.P +The +.IR <unistd.h> +header shall define the following symbolic constants. The values shall +be suitable for use in +.BR #if +preprocessing directives. +.IP _POSIX_VERSION 6 +.br +Integer value indicating version of this standard (C-language +binding) to which the implementation conforms. For implementations +conforming to POSIX.1\(hy2008, the value shall be 200809L. +.IP _POSIX2_VERSION 6 +.br +Integer value indicating version of the Shell and Utilities volume of POSIX.1 to which the implementation +conforms. For implementations conforming to POSIX.1\(hy2008, the value shall +be 200809L. For profile implementations that define _POSIX_SUBPROFILE +(see +.IR "Section 2.1.5.1" ", " "Subprofiling Considerations") +in +.IR <unistd.h> , +_POSIX2_VERSION may be left undefined or be defined with the value \-1 +to indicate that the Shell and Utilities volume of POSIX.1 is not supported. In this case, a call to +.IR sysconf(_SC_2_VERSION) +shall return either 200809L or \-1 indicating that the Shell and Utilities volume of POSIX.1 is or is +not, respectively, supported at runtime. +.P +The +.IR <unistd.h> +header shall define the following symbolic constant only if +the implementation supports the XSI option; see +.IR "Section 2.1.4" ", " "XSI Conformance". +If defined, its value shall be suitable for use in +.BR #if +preprocessing directives. +.IP _XOPEN_VERSION 6 +.br +Integer value indicating version of the X/Open Portability Guide +to which the implementation conforms. The value shall be 700. +.SS "Constants for Options and Option Groups" +.P +The following symbolic constants, if defined in +.IR <unistd.h> , +shall have a value of \-1, 0, or greater, unless otherwise specified +below. For profile implementations that define _POSIX_SUBPROFILE (see +.IR "Section 2.1.5.1" ", " "Subprofiling Considerations") +in +.IR <unistd.h> , +constants described below as always having a value greater than zero need +not be defined and, if defined, may have a value of \-1, 0, or greater. +The values shall be suitable for use in +.BR #if +preprocessing directives. +.P +If a symbolic constant is not defined or is defined with the value +\-1, the option is not supported for compilation. If it is defined +with a value greater than zero, the option shall always be supported +when the application is executed. If it is defined with the value zero, +the option shall be supported for compilation and might or might not be +supported at runtime. See +.IR "Section 2.1.6" ", " "Options" +for further information about the conformance requirements of these +three categories of support. +.IP _POSIX_ADVISORY_INFO 6 +.br +The implementation supports the Advisory Information option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_ASYNCHRONOUS_IO 6 +.br +The implementation supports asynchronous input and output. +This symbol shall always be set to the value 200809L. +.IP _POSIX_BARRIERS 6 +.br +The implementation supports barriers. +This symbol shall always be set to the value 200809L. +.IP _POSIX_CHOWN_RESTRICTED 6 +.br +The use of +\fIchown\fR() +and +\fIfchown\fR() +is restricted to a process with appropriate privileges, and to changing +the group ID of a file only to the effective group ID of the process or +to one of its supplementary group IDs. This symbol shall be defined +with a value other than \-1. +.IP _POSIX_CLOCK_SELECTION 6 +.br +The implementation supports clock selection. +This symbol shall always be set to the value 200809L. +.IP _POSIX_CPUTIME 6 +.br +The implementation supports the Process CPU-Time Clocks option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_FSYNC 6 +.br +The implementation supports the File Synchronization option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_IPV6 6 +.br +The implementation supports the IPv6 option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_JOB_CONTROL 6 +.br +The implementation supports job control. This symbol shall always be +set to a value greater than zero. +.IP _POSIX_MAPPED_FILES 6 +.br +The implementation supports memory mapped Files. +This symbol shall always be set to the value 200809L. +.IP _POSIX_MEMLOCK 6 +.br +The implementation supports the Process Memory Locking option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_MEMLOCK_RANGE 6 +.br +The implementation supports the Range Memory Locking option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_MEMORY_PROTECTION 6 +.br +The implementation supports memory protection. +This symbol shall always be set to the value 200809L. +.IP _POSIX_MESSAGE_PASSING 6 +.br +The implementation supports the Message Passing option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_MONOTONIC_CLOCK 6 +.br +The implementation supports the Monotonic Clock option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_NO_TRUNC 6 +.br +Pathname components longer than +{NAME_MAX} +generate an error. This symbol shall be defined with a value +other than \-1. +.IP _POSIX_PRIORITIZED_IO 6 +.br +The implementation supports the Prioritized Input and Output option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_PRIORITY_SCHEDULING 6 +.br +The implementation supports the Process Scheduling option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_RAW_SOCKETS 6 +.br +The implementation supports the Raw Sockets option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_READER_WRITER_LOCKS 6 +.br +The implementation supports read-write locks. +This symbol shall always be set to the value 200809L. +.IP _POSIX_REALTIME_SIGNALS 6 +.br +The implementation supports realtime signals. +This symbol shall always be set to the value 200809L. +.IP _POSIX_REGEXP 6 +.br +The implementation supports the Regular Expression Handling option. +This symbol shall always be set to a value greater than zero. +.IP _POSIX_SAVED_IDS 6 +.br +Each process has a saved set-user-ID and a saved set-group-ID. +This symbol shall always be set to a value greater than zero. +.IP _POSIX_SEMAPHORES 6 +.br +The implementation supports semaphores. +This symbol shall always be set to the value 200809L. +.IP _POSIX_SHARED_MEMORY_OBJECTS 6 +.br +The implementation supports the Shared Memory Objects option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_SHELL 6 +.br +The implementation supports the POSIX shell. This symbol shall always +be set to a value greater than zero. +.IP _POSIX_SPAWN 6 +.br +The implementation supports the Spawn option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_SPIN_LOCKS 6 +.br +The implementation supports spin locks. +This symbol shall always be set to the value 200809L. +.IP _POSIX_SPORADIC_SERVER 6 +.br +The implementation supports the Process Sporadic Server option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_SYNCHRONIZED_IO 6 +.br +The implementation supports the Synchronized Input and Output option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_ATTR_STACKADDR 6 +.br +The implementation supports the Thread Stack Address Attribute option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_ATTR_STACKSIZE 6 +.br +The implementation supports the Thread Stack Size Attribute option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_CPUTIME 6 +.br +The implementation supports the Thread CPU-Time Clocks option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_PRIO_INHERIT 6 +.br +The implementation supports the Non-Robust Mutex Priority +Inheritance option. If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_PRIO_PROTECT 6 +.br +The implementation supports the Non-Robust Mutex Priority +Protection option. If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_PRIORITY_SCHEDULING 6 +.br +The implementation supports the Thread Execution Scheduling option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_PROCESS_SHARED 6 +.br +The implementation supports the Thread Process-Shared Synchronization +option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_ROBUST_PRIO_INHERIT 6 +.br +The implementation supports the Robust Mutex Priority Inheritance +option. If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_ROBUST_PRIO_PROTECT 6 +.br +The implementation supports the Robust Mutex Priority Protection +option. If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREAD_SAFE_FUNCTIONS 6 +.br +The implementation supports thread-safe functions. +This symbol shall always be set to the value 200809L. +.IP _POSIX_THREAD_SPORADIC_SERVER 6 +.br +The implementation supports the Thread Sporadic Server option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_THREADS 6 +.br +The implementation supports threads. +This symbol shall always be set to the value 200809L. +.IP _POSIX_TIMEOUTS 6 +.br +The implementation supports timeouts. +This symbol shall always be set to the value 200809L. +.IP _POSIX_TIMERS 6 +.br +The implementation supports timers. +This symbol shall always be set to the value 200809L. +.IP _POSIX_TRACE 6 +.br +The implementation supports the Trace option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_TRACE_EVENT_FILTER 6 +.br +The implementation supports the Trace Event Filter option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_TRACE_INHERIT 6 +.br +The implementation supports the Trace Inherit option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_TRACE_LOG 6 +.br +The implementation supports the Trace Log option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_TYPED_MEMORY_OBJECTS 6 +.br +The implementation supports the Typed Memory Objects option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX_V6_ILP32_OFF32 6 +.br +The implementation provides a C-language compilation environment with +32-bit +.BR int , +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _POSIX_V6_ILP32_OFFBIG 6 +.br +The implementation provides a C-language compilation environment with +32-bit +.BR int , +.BR long , +and +.BR pointer +types and an +.BR off_t +type using at least 64 bits. +.IP _POSIX_V6_LP64_OFF64 6 +.br +The implementation provides a C-language compilation environment with +32-bit +.BR int +and 64-bit +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _POSIX_V6_LPBIG_OFFBIG 6 +.br +The implementation provides a C-language compilation environment with +an +.BR int +type using at least 32 bits and +.BR long , +.BR pointer , +and +.BR off_t +types using at least 64 bits. +.IP _POSIX_V7_ILP32_OFF32 6 +.br +The implementation provides a C-language compilation environment with +32-bit +.BR int , +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _POSIX_V7_ILP32_OFFBIG 6 +.br +The implementation provides a C-language compilation environment with +32-bit +.BR int , +.BR long , +and +.BR pointer +types and an +.BR off_t +type using at least 64 bits. +.IP _POSIX_V7_LP64_OFF64 6 +.br +The implementation provides a C-language compilation environment with +32-bit +.BR int +and 64-bit +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _POSIX_V7_LPBIG_OFFBIG 6 +.br +The implementation provides a C-language compilation environment with +an +.BR int +type using at least 32 bits and +.BR long , +.BR pointer , +and +.BR off_t +types using at least 64 bits. +.IP _POSIX2_C_BIND 6 +.br +The implementation supports the C-Language Binding option. This +symbol shall always have the value 200809L. +.IP _POSIX2_C_DEV 6 +.br +The implementation supports the C-Language Development Utilities option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_CHAR_TERM 6 +.br +The implementation supports the Terminal Characteristics option. +The value of this symbol reported by +\fIsysconf\fR() +shall either be \-1 or a value greater than zero. +.IP _POSIX2_FORT_DEV 6 +.br +The implementation supports the FORTRAN Development Utilities option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_FORT_RUN 6 +.br +The implementation supports the FORTRAN Runtime Utilities option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_LOCALEDEF 6 +.br +The implementation supports the creation of locales by the +.IR localedef +utility. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_PBS 6 +.br +The implementation supports the Batch Environment Services and +Utilities option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_PBS_ACCOUNTING 6 +.br +The implementation supports the Batch Accounting option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_PBS_CHECKPOINT 6 +.br +The implementation supports the Batch Checkpoint/Restart option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_PBS_LOCATE 6 +.br +The implementation supports the Locate Batch Job Request option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_PBS_MESSAGE 6 +.br +The implementation supports the Batch Job Message Request option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_PBS_TRACK 6 +.br +The implementation supports the Track Batch Job Request option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_SW_DEV 6 +.br +The implementation supports the Software Development Utilities option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _POSIX2_UPE 6 +.br +The implementation supports the User Portability Utilities option. +If this symbol is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this +symbol reported by +\fIsysconf\fR() +shall either be \-1 or 200809L. +.IP _XOPEN_CRYPT 6 +.br +The implementation supports the X/Open Encryption Option Group. +.IP _XOPEN_ENH_I18N 6 +.br +The implementation supports the Issue 4, Version 2 Enhanced +Internationalization Option Group. This symbol shall always be set +to a value other than \-1. +.IP _XOPEN_REALTIME 6 +.br +The implementation supports the X/Open Realtime Option Group. +.IP _XOPEN_REALTIME_THREADS 6 +.br +The implementation supports the X/Open Realtime Threads Option Group. +.IP _XOPEN_SHM 6 +.br +The implementation supports the Issue 4, Version 2 Shared Memory Option +Group. This symbol shall always be set to a value other than \-1. +.IP _XOPEN_STREAMS 6 +.br +The implementation supports the XSI STREAMS Option Group. +.IP _XOPEN_UNIX 6 +.br +The implementation supports the XSI option. +.IP _XOPEN_UUCP 6 +.br +The implementation supports the UUCP Utilities option. If this symbol +is defined in +.IR <unistd.h> , +it shall be defined to be \-1, 0, or 200809L. The value of this symbol +reported by +\fIsysconf\fR() +shall be either \-1 or 200809L. +.SS "Execution-Time Symbolic Constants" +.P +If any of the following symbolic constants are not defined in the +.IR <unistd.h> +header, the value shall vary depending on the file to which it +is applied. If defined, they shall have values suitable for use in +.BR #if +preprocessing directives. +.P +If any of the following symbolic constants are defined to have value +\-1 in the +.IR <unistd.h> +header, the implementation shall not provide the option on any file; if +any are defined to have a value other than \-1 in the +.IR <unistd.h> +header, the implementation shall provide the option on all applicable +files. +.P +All of the following values, whether defined as symbolic constants in +.IR <unistd.h> +or not, may be queried with respect to a specific file using the +\fIpathconf\fR() +or +\fIfpathconf\fR() +functions: +.IP _POSIX_ASYNC_IO 6 +.br +Asynchronous input or output operations may be performed for the +associated file. +.IP _POSIX_PRIO_IO 6 +.br +Prioritized input or output operations may be performed for the +associated file. +.IP _POSIX_SYNC_IO 6 +.br +Synchronized input or output operations may be performed for the +associated file. +.P +If the following symbolic constants are defined in the +.IR <unistd.h> +header, they apply to files and all paths in all file systems on +the implementation: +.IP _POSIX_TIMESTAMP_RESOLUTION 6 +.br +The resolution in nanoseconds for all file timestamps. +.IP _POSIX2_SYMLINKS 6 +.br +Symbolic links can be created. +.SS "Constants for Functions" +.P +The +.IR <unistd.h> +header shall define NULL as described in +.IR <stddef.h> . +.P +The +.IR <unistd.h> +header shall define the following symbolic constants for use with the +\fIaccess\fR() +function. The values shall be suitable for use in +.BR #if +preprocessing directives. +.IP F_OK 12 +Test for existence of file. +.IP R_OK 12 +Test for read permission. +.IP W_OK 12 +Test for write permission. +.IP X_OK 12 +Test for execute (search) permission. +.P +The constants F_OK, R_OK, W_OK, and X_OK and the expressions +\fIR_OK\fP|\fIW_OK\fP, \fIR_OK\fP|\fIX_OK\fP, and +\fIR_OK\fP|\fIW_OK\fP|\fIX_OK\fP shall all have distinct values. +.P +The +.IR <unistd.h> +header shall define the following symbolic constants for the +\fIconfstr\fR() +function: +.IP _CS_PATH 6 +.br +This is the value for the +.IR PATH +environment variable that finds all of the standard utilities that are +provided in a manner accessible via the +.IR exec +family of functions. +.IP _CS_POSIX_V7_ILP32_OFF32_CFLAGS 6 +.br +If \fIsysconf\fP(_SC_V7_ILP32_OFF32) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of initial +options to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int , +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _CS_POSIX_V7_ILP32_OFF32_LDFLAGS 6 +.br +If \fIsysconf\fP(_SC_V7_ILP32_OFF32) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of final +options to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int , +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _CS_POSIX_V7_ILP32_OFF32_LIBS 6 +.br +If \fIsysconf\fP(_SC_V7_ILP32_OFF32) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of +libraries to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int , +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _CS_POSIX_V7_ILP32_OFFBIG_CFLAGS 6 +.br +If \fIsysconf\fP(_SC_V7_ILP32_OFFBIG) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of initial +options to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int , +.BR long , +and +.BR pointer +types, and an +.BR off_t +type using at least 64 bits. +.IP _CS_POSIX_V7_ILP32_OFFBIG_LDFLAGS 6 +.br +If \fIsysconf\fP(_SC_V7_ILP32_OFFBIG) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of final +options to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int , +.BR long , +and +.BR pointer +types, and an +.BR off_t +type using at least 64 bits. +.IP _CS_POSIX_V7_ILP32_OFFBIG_LIBS 6 +.br +If \fIsysconf\fP(_SC_V7_ILP32_OFFBIG) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of +libraries to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int , +.BR long , +and +.BR pointer +types, and an +.BR off_t +type using at least 64 bits. +.IP _CS_POSIX_V7_LP64_OFF64_CFLAGS 6 +.br +If \fIsysconf\fP(_SC_V7_LP64_OFF64) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of initial +options to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int +and 64-bit +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _CS_POSIX_V7_LP64_OFF64_LDFLAGS 6 +.br +If \fIsysconf\fP(_SC_V7_LP64_OFF64) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of final +options to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int +and 64-bit +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _CS_POSIX_V7_LP64_OFF64_LIBS 6 +.br +If \fIsysconf\fP(_SC_V7_LP64_OFF64) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of +libraries to be given to the +.IR c99 +utility to build an application using a programming model with 32-bit +.BR int +and 64-bit +.BR long , +.BR pointer , +and +.BR off_t +types. +.IP _CS_POSIX_V7_LPBIG_OFFBIG_CFLAGS 6 +.br +If \fIsysconf\fP(_SC_V7_LPBIG_OFFBIG) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of initial +options to be given to the +.IR c99 +utility to build an application using a programming model with an +.BR int +type using at least 32 bits and +.BR long , +.BR pointer , +and +.BR off_t +types using at least 64 bits. +.IP _CS_POSIX_V7_LPBIG_OFFBIG_LDFLAGS 6 +.br +If \fIsysconf\fP(_SC_V7_LPBIG_OFFBIG) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of final +options to be given to the +.IR c99 +utility to build an application using a programming model with an +.BR int +type using at least 32 bits and +.BR long , +.BR pointer , +and +.BR off_t +types using at least 64 bits. +.IP _CS_POSIX_V7_LPBIG_OFFBIG_LIBS 6 +.br +If \fIsysconf\fP(_SC_V7_LPBIG_OFFBIG) returns \-1, the meaning of +this value is unspecified. Otherwise, this value is the set of +libraries to be given to the +.IR c99 +utility to build an application using a programming model with an +.BR int +type using at least 32 bits and +.BR long , +.BR pointer , +and +.BR off_t +types using at least 64 bits. +.IP _CS_POSIX_V7_THREADS_CFLAGS 6 +.br +If +.IR sysconf (_SC_POSIX_THREADS) +returns \-1, the meaning of this value is unspecified. Otherwise, +this value is the set of initial options to be given to the +.IR c99 +utility to build a multi-threaded application. These flags are in addition +to those associated with any of the other _CS_POSIX_V7_*_CFLAGS values +used to specify particular type size programing environments. +.IP _CS_POSIX_V7_THREADS_LDFLAGS 6 +.br +If +.IR sysconf (_SC_POSIX_THREADS) +returns \-1, the meaning of this value is unspecified. Otherwise, +this value is the set of final options to be given to the +.IR c99 +utility to build a multi-threaded application. These flags are in addition +to those associated with any of the other _CS_POSIX_V7_*_LDFLAGS values +used to specify particular type size programing environments. +.IP _CS_POSIX_V7_WIDTH_RESTRICTED_ENVS 6 +.br +This value is a +<newline>-separated +list of names of programming environments supported by the +implementation in which the widths of the +.BR blksize_t , +.BR cc_t , +.BR mode_t , +.BR nfds_t , +.BR pid_t , +.BR ptrdiff_t , +.BR size_t , +.BR speed_t , +.BR ssize_t , +.BR suseconds_t , +.BR tcflag_t , +.BR wchar_t , +and +.BR wint_t +types are no greater than the width of type +.BR long . +The format of each name shall be suitable for use with the +.IR getconf +.BR \-v +option. +.IP _CS_V7_ENV 6 +.br +This is the value that provides the environment variable information +(other than that provided by _CS_PATH) that is required by the +implementation to create a conforming environment, as described in the +implementation's conformance documentation. +.br +.P +The following symbolic constants are reserved for compatibility +with Issue 6: +.P +.nf +_CS_POSIX_V6_ILP32_OFF32_CFLAGS +_CS_POSIX_V6_ILP32_OFF32_LDFLAGS +_CS_POSIX_V6_ILP32_OFF32_LIBS +_CS_POSIX_V6_ILP32_OFFBIG_CFLAGS +_CS_POSIX_V6_ILP32_OFFBIG_LDFLAGS +_CS_POSIX_V6_ILP32_OFFBIG_LIBS +_CS_POSIX_V6_LP64_OFF64_CFLAGS +_CS_POSIX_V6_LP64_OFF64_LDFLAGS +_CS_POSIX_V6_LP64_OFF64_LIBS +_CS_POSIX_V6_LPBIG_OFFBIG_CFLAGS +_CS_POSIX_V6_LPBIG_OFFBIG_LDFLAGS +_CS_POSIX_V6_LPBIG_OFFBIG_LIBS +_CS_POSIX_V6_WIDTH_RESTRICTED_ENVS +_CS_V6_ENV +.fi +.P +The +.IR <unistd.h> +header shall define SEEK_CUR, SEEK_END, and SEEK_SET as described in +.IR <stdio.h> . +.P +The +.IR <unistd.h> +header shall define the following symbolic constants as possible +values for the +.IR function +argument to the +\fIlockf\fR() +function: +.IP F_LOCK 12 +Lock a section for exclusive use. +.IP F_TEST 12 +Test section for locks by other processes. +.IP F_TLOCK 12 +Test and lock a section for exclusive use. +.IP F_ULOCK 12 +Unlock locked sections. +.P +The +.IR <unistd.h> +header shall define the following symbolic constants for +\fIpathconf\fR(): +.P +.nf +_PC_2_SYMLINKS +_PC_ALLOC_SIZE_MIN +_PC_ASYNC_IO +_PC_CHOWN_RESTRICTED +_PC_FILESIZEBITS +_PC_LINK_MAX +_PC_MAX_CANON +_PC_MAX_INPUT +_PC_NAME_MAX +_PC_NO_TRUNC +_PC_PATH_MAX +_PC_PIPE_BUF +_PC_PRIO_IO +_PC_REC_INCR_XFER_SIZE +_PC_REC_MAX_XFER_SIZE +_PC_REC_MIN_XFER_SIZE +_PC_REC_XFER_ALIGN +_PC_SYMLINK_MAX +_PC_SYNC_IO +_PC_TIMESTAMP_RESOLUTION +_PC_VDISABLE +.fi +.P +The +.IR <unistd.h> +header shall define the following symbolic constants for +\fIsysconf\fR(): +.P +.nf +_SC_2_C_BIND +_SC_2_C_DEV +_SC_2_CHAR_TERM +_SC_2_FORT_DEV +_SC_2_FORT_RUN +_SC_2_LOCALEDEF +_SC_2_PBS +_SC_2_PBS_ACCOUNTING +_SC_2_PBS_CHECKPOINT +_SC_2_PBS_LOCATE +_SC_2_PBS_MESSAGE +_SC_2_PBS_TRACK +_SC_2_SW_DEV +_SC_2_UPE +_SC_2_VERSION +_SC_ADVISORY_INFO +_SC_AIO_LISTIO_MAX +_SC_AIO_MAX +_SC_AIO_PRIO_DELTA_MAX +_SC_ARG_MAX +_SC_ASYNCHRONOUS_IO +_SC_ATEXIT_MAX +_SC_BARRIERS +_SC_BC_BASE_MAX +_SC_BC_DIM_MAX +_SC_BC_SCALE_MAX +_SC_BC_STRING_MAX +_SC_CHILD_MAX +_SC_CLK_TCK +_SC_CLOCK_SELECTION +_SC_COLL_WEIGHTS_MAX +_SC_CPUTIME +_SC_DELAYTIMER_MAX +_SC_EXPR_NEST_MAX +_SC_FSYNC +_SC_GETGR_R_SIZE_MAX +_SC_GETPW_R_SIZE_MAX +_SC_HOST_NAME_MAX +_SC_IOV_MAX +_SC_IPV6 +_SC_JOB_CONTROL +_SC_LINE_MAX +_SC_LOGIN_NAME_MAX +_SC_MAPPED_FILES +_SC_MEMLOCK +_SC_MEMLOCK_RANGE +_SC_MEMORY_PROTECTION +_SC_MESSAGE_PASSING +_SC_MONOTONIC_CLOCK +_SC_MQ_OPEN_MAX +_SC_MQ_PRIO_MAX +_SC_NGROUPS_MAX +_SC_OPEN_MAX +_SC_PAGE_SIZE +_SC_PAGESIZE +_SC_PRIORITIZED_IO +_SC_PRIORITY_SCHEDULING +_SC_RAW_SOCKETS +_SC_RE_DUP_MAX +_SC_READER_WRITER_LOCKS +_SC_REALTIME_SIGNALS +_SC_REGEXP +_SC_RTSIG_MAX +_SC_SAVED_IDS +_SC_SEM_NSEMS_MAX +_SC_SEM_VALUE_MAX +_SC_SEMAPHORES +_SC_SHARED_MEMORY_OBJECTS +_SC_SHELL +_SC_SIGQUEUE_MAX +_SC_SPAWN +_SC_SPIN_LOCKS +_SC_SPORADIC_SERVER +_SC_SS_REPL_MAX +_SC_STREAM_MAX +_SC_SYMLOOP_MAX +_SC_SYNCHRONIZED_IO +_SC_THREAD_ATTR_STACKADDR +_SC_THREAD_ATTR_STACKSIZE +_SC_THREAD_CPUTIME +_SC_THREAD_DESTRUCTOR_ITERATIONS +_SC_THREAD_KEYS_MAX +_SC_THREAD_PRIO_INHERIT +_SC_THREAD_PRIO_PROTECT +_SC_THREAD_PRIORITY_SCHEDULING +_SC_THREAD_PROCESS_SHARED +_SC_THREAD_ROBUST_PRIO_INHERIT +_SC_THREAD_ROBUST_PRIO_PROTECT +_SC_THREAD_SAFE_FUNCTIONS +_SC_THREAD_SPORADIC_SERVER +_SC_THREAD_STACK_MIN +_SC_THREAD_THREADS_MAX +_SC_THREADS +_SC_TIMEOUTS +_SC_TIMER_MAX +_SC_TIMERS +_SC_TRACE +_SC_TRACE_EVENT_FILTER +_SC_TRACE_EVENT_NAME_MAX +_SC_TRACE_INHERIT +_SC_TRACE_LOG +_SC_TRACE_NAME_MAX +_SC_TRACE_SYS_MAX +_SC_TRACE_USER_EVENT_MAX +_SC_TTY_NAME_MAX +_SC_TYPED_MEMORY_OBJECTS +_SC_TZNAME_MAX +_SC_V7_ILP32_OFF32 +_SC_V7_ILP32_OFFBIG +_SC_V7_LP64_OFF64 +_SC_V7_LPBIG_OFFBIG +_SC_V6_ILP32_OFF32 +_SC_V6_ILP32_OFFBIG +_SC_V6_LP64_OFF64 +_SC_V6_LPBIG_OFFBIG +_SC_VERSION +_SC_XOPEN_CRYPT +_SC_XOPEN_ENH_I18N +_SC_XOPEN_REALTIME +_SC_XOPEN_REALTIME_THREADS +_SC_XOPEN_SHM +_SC_XOPEN_STREAMS +_SC_XOPEN_UNIX +_SC_XOPEN_UUCP +_SC_XOPEN_VERSION +.fi +.P +The two constants _SC_PAGESIZE and _SC_PAGE_SIZE may be defined to +have the same value. +.P +The +.IR <unistd.h> +header shall define the following symbolic constants for file streams: +.IP STDERR_FILENO 14 +File number of +.IR stderr ; +2. +.IP STDIN_FILENO 14 +File number of +.IR stdin ; +0. +.IP STDOUT_FILENO 14 +File number of +.IR stdout ; +1. +.P +The +.IR <unistd.h> +header shall define the following symbolic constant for terminal +special character handling: +.IP _POSIX_VDISABLE 14 +This symbol shall be defined to be the value of a character that shall +disable terminal special character handling as described in +.IR "Section 11.2.6" ", " "Special Control Characters". +This symbol shall always be set to a value other than \-1. +.SS "Type Definitions" +.P +The +.IR <unistd.h> +header shall define the +.BR size_t , +.BR ssize_t , +.BR uid_t , +.BR gid_t , +.BR off_t , +and +.BR pid_t +types as described in +.IR <sys/types.h> . +.P +The +.IR <unistd.h> +header shall define the +.BR intptr_t +type as described in +.IR <stdint.h> . +.SS "Declarations" +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int access(const char *, int); +unsigned alarm(unsigned); +int chdir(const char *); +int chown(const char *, uid_t, gid_t); +int close(int); +size_t confstr(int, char *, size_t); +char *crypt(const char *, const char *); +int dup(int); +.br +int dup2(int, int); +void _exit(int); +void encrypt(char [64], int); +int execl(const char *, const char *, ...); +int execle(const char *, const char *, ...); +int execlp(const char *, const char *, ...); +int execv(const char *, char *const []); +int execve(const char *, char *const [], char *const []); +int execvp(const char *, char *const []); +int faccessat(int, const char *, int, int); +int fchdir(int); +int fchown(int, uid_t, gid_t); +int fchownat(int, const char *, uid_t, gid_t, int); +int fdatasync(int); +int fexecve(int, char *const [], char *const []); +pid_t fork(void); +long fpathconf(int, int); +int fsync(int); +int ftruncate(int, off_t); +char *getcwd(char *, size_t); +gid_t getegid(void); +uid_t geteuid(void); +gid_t getgid(void); +int getgroups(int, gid_t []); +long gethostid(void); +int gethostname(char *, size_t); +char *getlogin(void); +int getlogin_r(char *, size_t); +int getopt(int, char * const [], const char *); +pid_t getpgid(pid_t); +pid_t getpgrp(void); +pid_t getpid(void); +pid_t getppid(void); +pid_t getsid(pid_t); +uid_t getuid(void); +int isatty(int); +int lchown(const char *, uid_t, gid_t); +int link(const char *, const char *); +int linkat(int, const char *, int, const char *, int); +int lockf(int, int, off_t); +off_t lseek(int, off_t, int); +int nice(int); +long pathconf(const char *, int); +int pause(void); +int pipe(int [2]); +ssize_t pread(int, void *, size_t, off_t); +ssize_t pwrite(int, const void *, size_t, off_t); +ssize_t read(int, void *, size_t); +ssize_t readlink(const char *restrict, char *restrict, size_t); +ssize_t readlinkat(int, const char *restrict, char *restrict, size_t); +int rmdir(const char *); +int setegid(gid_t); +int seteuid(uid_t); +int setgid(gid_t); +.br +int setpgid(pid_t, pid_t); +pid_t setpgrp(void); +int setregid(gid_t, gid_t); +int setreuid(uid_t, uid_t); +pid_t setsid(void); +int setuid(uid_t); +unsigned sleep(unsigned); +void swab(const void *restrict, void *restrict, ssize_t); +int symlink(const char *, const char *); +int symlinkat(const char *, int, const char *); +void sync(void); +long sysconf(int); +pid_t tcgetpgrp(int); +int tcsetpgrp(int, pid_t); +int truncate(const char *, off_t); +char *ttyname(int); +int ttyname_r(int, char *, size_t); +int unlink(const char *); +int unlinkat(int, const char *, int); +ssize_t write(int, const void *, size_t); +.fi +.P +.RE +.P +Implementations may also include the +\fIpthread_atfork\fR() +prototype as defined in +.IR <pthread.h> . +Implementations may also include the +\fIctermid\fR() +prototype as defined in +.IR <stdio.h> . +.P +The +.IR <unistd.h> +header shall declare the following external variables: +.sp +.RS 4 +.nf + +extern char *optarg; +extern int opterr, optind, optopt; +.fi +.P +.RE +.P +Inclusion of the +.IR <unistd.h> +header may make visible all symbols from the headers +.IR <stddef.h> , +.IR <stdint.h> , +and +.IR <stdio.h> . +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +POSIX.1\(hy2008 only describes the behavior of systems that claim conformance to +it. However, application developers who want to write applications that +adapt to other versions of this standard (or to systems that do not +conform to any POSIX standard) may find it useful to code them so as to +conditionally compile different code depending on the value of +_POSIX_VERSION, for example: +.sp +.RS 4 +.nf + +#if _POSIX_VERSION >= 200112L +/* Use the newer function that copes with large files. */ +off_t pos=ftello(fp); +#else +/* Either this is an old version of POSIX, or _POSIX_VERSION is + not even defined, so use the traditional function. */ +long pos=ftell(fp); +#endif +.fi +.P +.RE +.P +Earlier versions of POSIX.1\(hy2008 and of the Single UNIX Specification +can be identified by the following macros: +.IP "POSIX.1\(hy1988 standard" 6 +.br +_POSIX_VERSION\|=\^=\|198808L +.IP "POSIX.1\(hy1990 standard" 6 +.br +_POSIX_VERSION\|=\^=\|199009L +.IP "ISO\ POSIX\(hy1:\|1996 standard" 6 +.br +_POSIX_VERSION\|=\^=\|199506L +.IP "Single UNIX Specification, Version 1" 6 +.br +_XOPEN_UNIX and _XOPEN_VERSION\|=\^=\|4 +.IP "Single UNIX Specification, Version 2" 6 +.br +_XOPEN_UNIX and _XOPEN_VERSION\|=\^=\|500 +.IP "ISO POSIX\(hy1:\|2001 and Single UNIX Specification, Version 3" 6 +.br +_POSIX_VERSION\|=\^=\|200112L, plus (if the XSI option is supported) +_XOPEN_UNIX and _XOPEN_VERSION\|=\^=\|600 +.P +POSIX.1\(hy2008 does not make any attempt to define application binary +interaction with the underlying operating system. However, application +developers may find it useful to query _SC_VERSION at runtime via +\fIsysconf\fR() +to determine whether the current version of the operating system +supports the necessary functionality as in the following program +fragment: +.sp +.RS 4 +.nf + +if (sysconf(_SC_VERSION) < 200809L) { + fprintf(stderr, "POSIX.1-2008 system required, terminating \en"); + exit(1); +} +.fi +.P +.RE +.P +New applications should not use _XOPEN_SHM or _XOPEN_ENH_I18N. +.SH RATIONALE +As POSIX.1\(hy2008 evolved, certain options became sufficiently standardized that +it was concluded that simply requiring one of the option choices was +simpler than retaining the option. However, for backwards-compatibility, +the option flags (with required constant values) are retained. +.SS "Version Test Macros" +.P +The standard developers considered altering the definition of +_POSIX_VERSION and removing _SC_VERSION from the specification of +\fIsysconf\fR() +since the utility to an application was deemed by some to be minimal, +and since the implementation of the functionality is potentially +problematic. However, they recognized that support for existing +application binaries is a concern to manufacturers, application +developers, and the users of implementations conforming to POSIX.1\(hy2008. +.P +While the example using _SC_VERSION in the APPLICATION USAGE section +does not provide the greatest degree of imaginable utility to the +application developer or user, it is arguably better than a +.BR core +file or some other equally obscure result. (It is also possible for +implementations to encode and recognize application binaries compiled +in various POSIX.1-conforming environments, and modify the semantics of +the underlying system to conform to the expectations of the +application.) For the reasons outlined in the preceding paragraphs and +in the APPLICATION USAGE section, the standard developers elected to +retain the _POSIX_VERSION and _SC_VERSION functionality. +.SS "Compile-Time Symbolic Constants for System-Wide Options" +.P +POSIX.1\(hy2008 includes support in certain areas for the newly adopted +policy governing options and stubs. +.P +This policy provides flexibility for implementations in how they +support options. It also specifies how conforming applications can +adapt to different implementations that support different sets of +options. It allows the following: +.IP " 1." 4 +If an implementation has no interest in supporting an option, it does +not have to provide anything associated with that option beyond the +announcement that it does not support it. +.IP " 2." 4 +An implementation can support a partial or incompatible version of an +option (as a non-standard extension) as long as it does not claim to +support the option. +.IP " 3." 4 +An application can determine whether the option is supported. A +strictly conforming application must check this announcement mechanism +before first using anything associated with the option. +.P +There is an important implication of this policy. POSIX.1\(hy2008 cannot +dictate the behavior of interfaces associated with an option when the +implementation does not claim to support the option. In particular, it +cannot require that a function associated with an unsupported option +will fail if it does not perform as specified. However, this policy +does not prevent a standard from requiring certain functions to always +be present, but that they shall always fail on some implementations. +The +\fIsetpgid\fR() +function in the POSIX.1\(hy1990 standard, for example, is considered appropriate. +.P +The POSIX standards include various options, and the C-language +binding support for an option implies that the implementation must +supply data types and function interfaces. An application must be able +to discover whether the implementation supports each option. +.P +Any application must consider the following three cases for each +option: +.IP " 1." 4 +Option never supported. +.RS 4 +.P +The implementation advertises at compile time that the option will +never be supported. In this case, it is not necessary for the +implementation to supply any of the data types or function interfaces +that are provided only as part of the option. The implementation might +provide data types and functions that are similar to those defined by +POSIX.1\(hy2008, but there is no guarantee for any particular behavior. +.RE +.IP " 2." 4 +Option always supported. +.RS 4 +.P +The implementation advertises at compile time that the option will +always be supported. In this case, all data types and function +interfaces shall be available and shall operate as specified. +.RE +.IP " 3." 4 +Option might or might not be supported. +.RS 4 +.P +Some implementations might not provide a mechanism to specify support +of options at compile time. In addition, the implementation might be +unable or unwilling to specify support or non-support at compile time. +In either case, any application that might use the option at runtime +must be able to compile and execute. The implementation must provide, +at compile time, all data types and function interfaces that are +necessary to allow this. In this situation, there must be a mechanism +that allows the application to query, at runtime, whether the option is +supported. If the application attempts to use the option when it is not +supported, the result is unspecified unless explicitly specified +otherwise in POSIX.1\(hy2008. +.RE +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<limits.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<stdint.h>\fP", +.IR "\fB<stdio.h>\fP", +.IR "\fB<sys_socket.h>\fP", +.IR "\fB<sys_types.h>\fP", +.IR "\fB<termios.h>\fP", +.IR "\fB<wctype.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIaccess\fR\^(\|)", +.IR "\fIalarm\fR\^(\|)", +.IR "\fIchown\fR\^(\|)", +.IR "\fIclose\fR\^(\|)", +.IR "\fIconfstr\fR\^(\|)", +.IR "\fIcrypt\fR\^(\|)", +.IR "\fIctermid\fR\^(\|)", +.IR "\fIdup\fR\^(\|)", +.IR "\fI_Exit\fR\^(\|)", +.IR "\fIencrypt\fR\^(\|)", +.IR "\fIexec\fR\^", +.IR "\fIfchdir\fR\^(\|)", +.IR "\fIfchown\fR\^(\|)", +.IR "\fIfdatasync\fR\^(\|)", +.IR "\fIfork\fR\^(\|)", +.IR "\fIfpathconf\fR\^(\|)", +.IR "\fIfsync\fR\^(\|)", +.IR "\fIftruncate\fR\^(\|)", +.IR "\fIgetcwd\fR\^(\|)", +.IR "\fIgetegid\fR\^(\|)", +.IR "\fIgeteuid\fR\^(\|)", +.IR "\fIgetgid\fR\^(\|)", +.IR "\fIgetgroups\fR\^(\|)", +.IR "\fIgethostid\fR\^(\|)", +.IR "\fIgethostname\fR\^(\|)", +.IR "\fIgetlogin\fR\^(\|)", +.IR "\fIgetopt\fR\^(\|)", +.IR "\fIgetpgid\fR\^(\|)", +.IR "\fIgetpgrp\fR\^(\|)", +.IR "\fIgetpid\fR\^(\|)", +.IR "\fIgetppid\fR\^(\|)", +.IR "\fIgetsid\fR\^(\|)", +.IR "\fIgetuid\fR\^(\|)", +.IR "\fIisatty\fR\^(\|)", +.IR "\fIlchown\fR\^(\|)", +.IR "\fIlink\fR\^(\|)", +.IR "\fIlockf\fR\^(\|)", +.IR "\fIlseek\fR\^(\|)", +.IR "\fInice\fR\^(\|)", +.IR "\fIpause\fR\^(\|)", +.IR "\fIpipe\fR\^(\|)", +.IR "\fIread\fR\^(\|)", +.IR "\fIreadlink\fR\^(\|)", +.IR "\fIrmdir\fR\^(\|)", +.IR "\fIsetegid\fR\^(\|)", +.IR "\fIseteuid\fR\^(\|)", +.IR "\fIsetgid\fR\^(\|)", +.IR "\fIsetpgid\fR\^(\|)", +.IR "\fIsetpgrp\fR\^(\|)", +.IR "\fIsetregid\fR\^(\|)", +.IR "\fIsetreuid\fR\^(\|)", +.IR "\fIsetsid\fR\^(\|)", +.IR "\fIsetuid\fR\^(\|)", +.IR "\fIsleep\fR\^(\|)", +.IR "\fIswab\fR\^(\|)", +.IR "\fIsymlink\fR\^(\|)", +.IR "\fIsync\fR\^(\|)", +.IR "\fIsysconf\fR\^(\|)", +.IR "\fItcgetpgrp\fR\^(\|)", +.IR "\fItcsetpgrp\fR\^(\|)", +.IR "\fItruncate\fR\^(\|)", +.IR "\fIttyname\fR\^(\|)", +.IR "\fIunlink\fR\^(\|)", +.IR "\fIwrite\fR\^(\|)" +.ad b +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/utime.h.0p b/upstream/mageia-cauldron/man0p/utime.h.0p new file mode 100644 index 00000000..89de7d53 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/utime.h.0p @@ -0,0 +1,93 @@ +'\" et +.TH utime.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +utime.h +\(em access and modification times structure +.SH SYNOPSIS +.LP +.nf +#include <utime.h> +.fi +.SH DESCRIPTION +The +.IR <utime.h> +header shall declare the +.BR utimbuf +structure, which shall include the following members: +.sp +.RS 4 +.nf + +time_t actime \fRAccess time.\fR +time_t modtime \fRModification time.\fR +.fi +.P +.RE +.P +The times shall be measured in seconds since the Epoch. +.P +The +.IR <utime.h> +header shall define the +.BR time_t +type as described in +.IR <sys/types.h> . +.P +The following shall be declared as a function and may also be defined +as a macro. A function prototype shall be provided. +.sp +.RS 4 +.nf + +int utime(const char *, const struct utimbuf *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +The +\fIutime\fR() +function only allows setting file timestamps to the nearest second. +Applications should use the +\fIutimensat\fR() +function instead. See +.IR <sys/stat.h> . +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +The +.IR <utime.h> +header may be removed in a future version. +.SH "SEE ALSO" +.IR "\fB<sys_stat.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIfutimens\fR\^(\|)", +.IR "\fIutime\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/utmpx.h.0p b/upstream/mageia-cauldron/man0p/utmpx.h.0p new file mode 100644 index 00000000..1de94ced --- /dev/null +++ b/upstream/mageia-cauldron/man0p/utmpx.h.0p @@ -0,0 +1,130 @@ +'\" et +.TH utmpx.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +utmpx.h +\(em user accounting database definitions +.SH SYNOPSIS +.LP +.nf +#include <utmpx.h> +.fi +.SH DESCRIPTION +The +.IR <utmpx.h> +header shall define the +.BR utmpx +structure that shall include at least the following members: +.sp +.RS 4 +.nf + +char ut_user[] \fRUser login name.\fR +char ut_id[] \fRUnspecified initialization process identifier.\fR +char ut_line[] \fRDevice name.\fR +pid_t ut_pid \fRProcess ID.\fR +short ut_type \fRType of entry.\fR +struct timeval ut_tv \fRTime entry was made.\fR +.fi +.P +.RE +.P +The +.IR <utmpx.h> +header shall define the +.BR pid_t +type through +.BR typedef , +as described in +.IR <sys/types.h> . +.P +The +.IR <utmpx.h> +header shall define the +.BR timeval +structure as described in +.IR <sys/time.h> . +.P +Inclusion of the +.IR <utmpx.h> +header may also make visible all symbols from +.IR <sys/time.h> . +.P +The +.IR <utmpx.h> +header shall define the following symbolic constants as possible values +for the +.IR ut_type +member of the +.BR utmpx +structure: +.IP EMPTY 14 +No valid user accounting information. +.IP BOOT_TIME 14 +Identifies time of system boot. +.IP OLD_TIME 14 +Identifies time when system clock changed. +.IP NEW_TIME 14 +Identifies time after system clock changed. +.IP USER_PROCESS 14 +Identifies a process. +.IP INIT_PROCESS 14 +Identifies a process spawned by the init process. +.IP LOGIN_PROCESS 14 +Identifies the session leader of a logged-in user. +.IP DEAD_PROCESS 14 +Identifies a session leader who has exited. +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +void endutxent(void); +struct utmpx *getutxent(void); +struct utmpx *getutxid(const struct utmpx *); +struct utmpx *getutxline(const struct utmpx *); +struct utmpx *pututxline(const struct utmpx *); +void setutxent(void); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<sys_time.h>\fP", +.IR "\fB<sys_types.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "\fIendutxent\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/wchar.h.0p b/upstream/mageia-cauldron/man0p/wchar.h.0p new file mode 100644 index 00000000..e727ee82 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/wchar.h.0p @@ -0,0 +1,360 @@ +'\" et +.TH wchar.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +wchar.h +\(em wide-character handling +.SH SYNOPSIS +.LP +.nf +#include <wchar.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <wchar.h> +header shall define the following types: +.IP "\fBFILE\fP" 12 +As described in +.IR <stdio.h> . +.IP "\fBlocale_t\fP" 12 +As described in +.IR <locale.h> . +.IP "\fBmbstate_t\fP" 12 +An object type other than an array type that can hold the conversion +state information necessary to convert between sequences of (possibly +multi-byte) characters and wide characters. +If a codeset is being used such that an +.BR mbstate_t +needs to preserve more than two levels of reserved state, the +results are unspecified. +.IP "\fBsize_t\fP" 12 +As described in +.IR <stddef.h> . +.IP "\fBva_list\fP" 12 +As described in +.IR <stdarg.h> . +.IP "\fBwchar_t\fP" 12 +As described in +.IR <stddef.h> . +.IP "\fBwctype_t\fP" 12 +A scalar type of a data object that can hold values which represent +locale-specific character classification. +.IP "\fBwint_t\fP" 12 +An integer type capable of storing any valid value of +.BR wchar_t +or WEOF. +.P +The tag +.BR tm +shall be declared as naming an incomplete structure type, the contents +of which are described in the +.IR <time.h> +header. +.P +The implementation shall support one or more programming environments +in which the width of +.BR wint_t +is no greater than the width of type +.BR long . +The names of these programming environments can be obtained using the +\fIconfstr\fR() +function or the +.IR getconf +utility. +.P +The +.IR <wchar.h> +header shall define the following macros: +.IP WCHAR_MAX 12 +As described in +.IR <stdint.h> . +.IP WCHAR_MIN 12 +As described in +.IR <stdint.h> . +.IP WEOF 12 +Constant expression of type +.BR wint_t +that is returned by several WP functions to indicate end-of-file. +.IP NULL 12 +As described in +.IR <stddef.h> . +.P +Inclusion of the +.IR <wchar.h> +header may make visible all symbols from the headers +.IR <ctype.h> , +.IR <string.h> , +.IR <stdarg.h> , +.IR <stddef.h> , +.IR <stdio.h> , +.IR <stdlib.h> , +and +.IR <time.h> . +.P +The following shall be declared as functions and may also be defined +as macros. Function prototypes shall be provided for use with ISO\ C standard +compilers. Arguments to functions in this list can point to arrays +containing +.BR wchar_t +values that do not correspond to members of the character set of the +current locale. Such values shall be processed according to the +specified semantics, unless otherwise stated. +.sp +.RS 4 +.nf + +wint_t btowc(int); +wint_t fgetwc(FILE *); +wchar_t *fgetws(wchar_t *restrict, int, FILE *restrict); +wint_t fputwc(wchar_t, FILE *); +int fputws(const wchar_t *restrict, FILE *restrict); +int fwide(FILE *, int); +int fwprintf(FILE *restrict, const wchar_t *restrict, ...); +int fwscanf(FILE *restrict, const wchar_t *restrict, ...); +wint_t getwc(FILE *); +wint_t getwchar(void); +int iswalnum(wint_t); +int iswalpha(wint_t); +int iswcntrl(wint_t); +int iswctype(wint_t, wctype_t); +int iswdigit(wint_t); +int iswgraph(wint_t); +int iswlower(wint_t); +int iswprint(wint_t); +int iswpunct(wint_t); +int iswspace(wint_t); +int iswupper(wint_t); +int iswxdigit(wint_t); +size_t mbrlen(const char *restrict, size_t, mbstate_t *restrict); +size_t mbrtowc(wchar_t *restrict, const char *restrict, size_t, + mbstate_t *restrict); +int mbsinit(const mbstate_t *); +size_t mbsnrtowcs(wchar_t *restrict, const char **restrict, + size_t, size_t, mbstate_t *restrict); +size_t mbsrtowcs(wchar_t *restrict, const char **restrict, size_t, + mbstate_t *restrict); +FILE *open_wmemstream(wchar_t **, size_t *); +wint_t putwc(wchar_t, FILE *); +wint_t putwchar(wchar_t); +int swprintf(wchar_t *restrict, size_t, + const wchar_t *restrict, ...); +int swscanf(const wchar_t *restrict, + const wchar_t *restrict, ...); +wint_t towlower(wint_t); +wint_t towupper(wint_t); +wint_t ungetwc(wint_t, FILE *); +int vfwprintf(FILE *restrict, const wchar_t *restrict, va_list); +int vfwscanf(FILE *restrict, const wchar_t *restrict, va_list); +int vswprintf(wchar_t *restrict, size_t, + const wchar_t *restrict, va_list); +int vswscanf(const wchar_t *restrict, const wchar_t *restrict, + va_list); +int vwprintf(const wchar_t *restrict, va_list); +int vwscanf(const wchar_t *restrict, va_list); +wchar_t *wcpcpy(wchar_t *restrict, const wchar_t *restrict); +wchar_t *wcpncpy(wchar_t *restrict, const wchar_t *restrict, size_t); +size_t wcrtomb(char *restrict, wchar_t, mbstate_t *restrict); +int wcscasecmp(const wchar_t *, const wchar_t *); +int wcscasecmp_l(const wchar_t *, const wchar_t *, locale_t); +wchar_t *wcscat(wchar_t *restrict, const wchar_t *restrict); +wchar_t *wcschr(const wchar_t *, wchar_t); +int wcscmp(const wchar_t *, const wchar_t *); +int wcscoll(const wchar_t *, const wchar_t *); +int wcscoll_l(const wchar_t *, const wchar_t *, locale_t); +wchar_t *wcscpy(wchar_t *restrict, const wchar_t *restrict); +size_t wcscspn(const wchar_t *, const wchar_t *); +wchar_t *wcsdup(const wchar_t *); +size_t wcsftime(wchar_t *restrict, size_t, + const wchar_t *restrict, const struct tm *restrict); +size_t wcslen(const wchar_t *); +int wcsncasecmp(const wchar_t *, const wchar_t *, size_t); +int wcsncasecmp_l(const wchar_t *, const wchar_t *, size_t, + locale_t); +wchar_t *wcsncat(wchar_t *restrict, const wchar_t *restrict, size_t); +int wcsncmp(const wchar_t *, const wchar_t *, size_t); +wchar_t *wcsncpy(wchar_t *restrict, const wchar_t *restrict, size_t); +size_t wcsnlen(const wchar_t *, size_t); +size_t wcsnrtombs(char *restrict, const wchar_t **restrict, size_t, + size_t, mbstate_t *restrict); +wchar_t *wcspbrk(const wchar_t *, const wchar_t *); +wchar_t *wcsrchr(const wchar_t *, wchar_t); +size_t wcsrtombs(char *restrict, const wchar_t **restrict, + size_t, mbstate_t *restrict); +size_t wcsspn(const wchar_t *, const wchar_t *); +wchar_t *wcsstr(const wchar_t *restrict, const wchar_t *restrict); +double wcstod(const wchar_t *restrict, wchar_t **restrict); +float wcstof(const wchar_t *restrict, wchar_t **restrict); +wchar_t *wcstok(wchar_t *restrict, const wchar_t *restrict, + wchar_t **restrict); +long wcstol(const wchar_t *restrict, wchar_t **restrict, int); +long double wcstold(const wchar_t *restrict, wchar_t **restrict); +long long wcstoll(const wchar_t *restrict, wchar_t **restrict, int); +unsigned long wcstoul(const wchar_t *restrict, wchar_t **restrict, int); +unsigned long long + wcstoull(const wchar_t *restrict, wchar_t **restrict, int); +int wcswidth(const wchar_t *, size_t); +size_t wcsxfrm(wchar_t *restrict, const wchar_t *restrict, size_t); +size_t wcsxfrm_l(wchar_t *restrict, const wchar_t *restrict, + size_t, locale_t); +int wctob(wint_t); +wctype_t wctype(const char *); +int wcwidth(wchar_t); +wchar_t *wmemchr(const wchar_t *, wchar_t, size_t); +int wmemcmp(const wchar_t *, const wchar_t *, size_t); +wchar_t *wmemcpy(wchar_t *restrict, const wchar_t *restrict, size_t); +wchar_t *wmemmove(wchar_t *, const wchar_t *, size_t); +wchar_t *wmemset(wchar_t *, wchar_t, size_t); +int wprintf(const wchar_t *restrict, ...); +int wscanf(const wchar_t *restrict, ...); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +The +\fIiswblank\fR() +function was a late addition to the ISO\ C standard and was introduced at the same +time as the ISO\ C standard introduced +.IR <wctype.h> , +which contains all of the +.IR isw* (\|) +functions. The Open Group Base Specifications had previously aligned +with the MSE working draft and had introduced the rest of the +.IR isw* (\|) +functions into +.IR <wchar.h> . +For backwards-compatibility, the original set of +.IR isw* (\|) +functions, without +\fIiswblank\fR(), +are permitted (as part of the XSI option) in +.IR <wchar.h> . +For maximum portability, applications should include +.IR <wctype.h> +in order to obtain declarations for the +.IR isw* (\|) +functions. This compatibility has been made obsolescent. +.SH RATIONALE +In the ISO\ C standard, the symbols referenced as XSI extensions are in +.IR <wctype.h> . +Their presence here is thus an extension. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<ctype.h>\fP", +.IR "\fB<locale.h>\fP", +.IR "\fB<stdarg.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<stdint.h>\fP", +.IR "\fB<stdio.h>\fP", +.IR "\fB<stdlib.h>\fP", +.IR "\fB<string.h>\fP", +.IR "\fB<time.h>\fP", +.IR "\fB<wctype.h>\fP" +.P +.ad l +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIbtowc\fR\^(\|)", +.IR "\fIconfstr\fR\^(\|)", +.IR "\fIfgetwc\fR\^(\|)", +.IR "\fIfgetws\fR\^(\|)", +.IR "\fIfputwc\fR\^(\|)", +.IR "\fIfputws\fR\^(\|)", +.IR "\fIfwide\fR\^(\|)", +.IR "\fIfwprintf\fR\^(\|)", +.IR "\fIfwscanf\fR\^(\|)", +.IR "\fIgetwc\fR\^(\|)", +.IR "\fIgetwchar\fR\^(\|)", +.IR "\fIiswalnum\fR\^(\|)", +.IR "\fIiswalpha\fR\^(\|)", +.IR "\fIiswcntrl\fR\^(\|)", +.IR "\fIiswctype\fR\^(\|)", +.IR "\fIiswdigit\fR\^(\|)", +.IR "\fIiswgraph\fR\^(\|)", +.IR "\fIiswlower\fR\^(\|)", +.IR "\fIiswprint\fR\^(\|)", +.IR "\fIiswpunct\fR\^(\|)", +.IR "\fIiswspace\fR\^(\|)", +.IR "\fIiswupper\fR\^(\|)", +.IR "\fIiswxdigit\fR\^(\|)", +.IR "\fImbrlen\fR\^(\|)", +.IR "\fImbrtowc\fR\^(\|)", +.IR "\fImbsinit\fR\^(\|)", +.IR "\fImbsrtowcs\fR\^(\|)", +.IR "\fIopen_memstream\fR\^(\|)", +.IR "\fIputwc\fR\^(\|)", +.IR "\fIputwchar\fR\^(\|)", +.IR "\fItowlower\fR\^(\|)", +.IR "\fItowupper\fR\^(\|)", +.IR "\fIungetwc\fR\^(\|)", +.IR "\fIvfwprintf\fR\^(\|)", +.IR "\fIvfwscanf\fR\^(\|)", +.IR "\fIwcrtomb\fR\^(\|)", +.IR "\fIwcscasecmp\fR\^(\|)", +.IR "\fIwcscat\fR\^(\|)", +.IR "\fIwcschr\fR\^(\|)", +.IR "\fIwcscmp\fR\^(\|)", +.IR "\fIwcscoll\fR\^(\|)", +.IR "\fIwcscpy\fR\^(\|)", +.IR "\fIwcscspn\fR\^(\|)", +.IR "\fIwcsdup\fR\^(\|)", +.IR "\fIwcsftime\fR\^(\|)", +.IR "\fIwcslen\fR\^(\|)", +.IR "\fIwcsncat\fR\^(\|)", +.IR "\fIwcsncmp\fR\^(\|)", +.IR "\fIwcsncpy\fR\^(\|)", +.IR "\fIwcspbrk\fR\^(\|)", +.IR "\fIwcsrchr\fR\^(\|)", +.IR "\fIwcsrtombs\fR\^(\|)", +.IR "\fIwcsspn\fR\^(\|)", +.IR "\fIwcsstr\fR\^(\|)", +.IR "\fIwcstod\fR\^(\|)", +.IR "\fIwcstok\fR\^(\|)", +.IR "\fIwcstol\fR\^(\|)", +.IR "\fIwcstoul\fR\^(\|)", +.IR "\fIwcswidth\fR\^(\|)", +.IR "\fIwcsxfrm\fR\^(\|)", +.IR "\fIwctob\fR\^(\|)", +.IR "\fIwctype\fR\^(\|)", +.IR "\fIwcwidth\fR\^(\|)", +.IR "\fIwmemchr\fR\^(\|)", +.IR "\fIwmemcmp\fR\^(\|)", +.IR "\fIwmemcpy\fR\^(\|)", +.IR "\fIwmemmove\fR\^(\|)", +.IR "\fIwmemset\fR\^(\|)" +.ad b +.P +The Shell and Utilities volume of POSIX.1\(hy2017, +.IR "\fIgetconf\fR\^" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/wctype.h.0p b/upstream/mageia-cauldron/man0p/wctype.h.0p new file mode 100644 index 00000000..e07a6777 --- /dev/null +++ b/upstream/mageia-cauldron/man0p/wctype.h.0p @@ -0,0 +1,180 @@ +'\" et +.TH wctype.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +wctype.h +\(em wide-character classification and mapping utilities +.SH SYNOPSIS +.LP +.nf +#include <wctype.h> +.fi +.SH DESCRIPTION +Some of the functionality described on this reference page extends the +ISO\ C standard. Applications shall define the appropriate feature test macro +(see the System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment") +to enable the visibility of these symbols in this header. +.P +The +.IR <wctype.h> +header shall define the following types: +.IP "\fBwint_t\fP" 12 +As described in +.IR <wchar.h> . +.IP "\fBwctrans_t\fP" 12 +A scalar type that can hold values which represent locale-specific +character mappings. +.IP "\fBwctype_t\fP" 12 +As described in +.IR <wchar.h> . +.P +The +.IR <wctype.h> +header shall define the +.BR locale_t +type as described in +.IR <locale.h> . +.P +The +.IR <wctype.h> +header shall define the following macro: +.IP WEOF 12 +As described in +.IR <wchar.h> . +.P +For all functions described in this header that accept an argument of +type +.BR wint_t , +the value is representable as a +.BR wchar_t +or equals the value of WEOF. If this argument has any other value, the +behavior is undefined. +.P +The behavior of these functions shall be affected by the +.IR LC_CTYPE +category of the current locale. +.P +Inclusion of the +.IR <wctype.h> +header may make visible all symbols from the headers +.IR <ctype.h> , +.IR <stdarg.h> , +.IR <stddef.h> , +.IR <stdio.h> , +.IR <stdlib.h> , +.IR <string.h> , +.IR <time.h> , +and +.IR <wchar.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided for use with ISO\ C standard +compilers. +.sp +.RS 4 +.nf + +int iswalnum(wint_t); +int iswalnum_l(wint_t, locale_t); +int iswalpha(wint_t); +int iswalpha_l(wint_t, locale_t); +int iswblank(wint_t); +int iswblank_l(wint_t, locale_t); +int iswcntrl(wint_t); +int iswcntrl_l(wint_t, locale_t); +int iswctype(wint_t, wctype_t); +int iswctype_l(wint_t, wctype_t, locale_t); +int iswdigit(wint_t); +int iswdigit_l(wint_t, locale_t); +int iswgraph(wint_t); +int iswgraph_l(wint_t, locale_t); +int iswlower(wint_t); +int iswlower_l(wint_t, locale_t); +int iswprint(wint_t); +int iswprint_l(wint_t, locale_t); +int iswpunct(wint_t); +int iswpunct_l(wint_t, locale_t); +int iswspace(wint_t); +int iswspace_l(wint_t, locale_t); +int iswupper(wint_t); +int iswupper_l(wint_t, locale_t); +int iswxdigit(wint_t); +int iswxdigit_l(wint_t, locale_t); +wint_t towctrans(wint_t, wctrans_t); +wint_t towctrans_l(wint_t, wctrans_t, locale_t); +wint_t towlower(wint_t); +wint_t towlower_l(wint_t, locale_t); +wint_t towupper(wint_t); +wint_t towupper_l(wint_t, locale_t); +wctrans_t wctrans(const char *); +wctrans_t wctrans_l(const char *, locale_t); +wctype_t wctype(const char *); +wctype_t wctype_l(const char *, locale_t); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<ctype.h>\fP", +.IR "\fB<locale.h>\fP", +.IR "\fB<stdarg.h>\fP", +.IR "\fB<stddef.h>\fP", +.IR "\fB<stdio.h>\fP", +.IR "\fB<stdlib.h>\fP", +.IR "\fB<string.h>\fP", +.IR "\fB<time.h>\fP", +.IR "\fB<wchar.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.2" ", " "The Compilation Environment", +.IR "\fIiswalnum\fR\^(\|)", +.IR "\fIiswalpha\fR\^(\|)", +.IR "\fIiswblank\fR\^(\|)", +.IR "\fIiswcntrl\fR\^(\|)", +.IR "\fIiswctype\fR\^(\|)", +.IR "\fIiswdigit\fR\^(\|)", +.IR "\fIiswgraph\fR\^(\|)", +.IR "\fIiswlower\fR\^(\|)", +.IR "\fIiswprint\fR\^(\|)", +.IR "\fIiswpunct\fR\^(\|)", +.IR "\fIiswspace\fR\^(\|)", +.IR "\fIiswupper\fR\^(\|)", +.IR "\fIiswxdigit\fR\^(\|)", +.IR "\fIsetlocale\fR\^(\|)", +.IR "\fItowctrans\fR\^(\|)", +.IR "\fItowlower\fR\^(\|)", +.IR "\fItowupper\fR\^(\|)", +.IR "\fIwctrans\fR\^(\|)", +.IR "\fIwctype\fR\^(\|)" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . diff --git a/upstream/mageia-cauldron/man0p/wordexp.h.0p b/upstream/mageia-cauldron/man0p/wordexp.h.0p new file mode 100644 index 00000000..fa121e5b --- /dev/null +++ b/upstream/mageia-cauldron/man0p/wordexp.h.0p @@ -0,0 +1,154 @@ +'\" et +.TH wordexp.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual" +.\" +.SH PROLOG +This manual page is part of the POSIX Programmer's Manual. +The Linux implementation of this interface may differ (consult +the corresponding Linux manual page for details of Linux behavior), +or the interface may not be implemented on Linux. +.\" +.SH NAME +wordexp.h +\(em word-expansion types +.SH SYNOPSIS +.LP +.nf +#include <wordexp.h> +.fi +.SH DESCRIPTION +The +.IR <wordexp.h> +header shall define the structures and symbolic constants used by the +\fIwordexp\fR() +and +\fIwordfree\fR() +functions. +.P +The +.IR <wordexp.h> +header shall define the +.BR wordexp_t +structure type, which shall include at least the following members: +.sp +.RS 4 +.nf + +size_t we_wordc \fRCount of words matched by \fIwords.\fR +char **we_wordv \fRPointer to list of expanded words.\fR +size_t we_offs \fRSlots to reserve at the beginning of \fIwe_wordv.\fR +.fi +.P +.RE +.P +The +.IR <wordexp.h> +header shall define the following symbolic constants for use as flags +for the +\fIwordexp\fR() +function: +.IP WRDE_APPEND 14 +Append words to those previously generated. +.IP WRDE_DOOFFS 14 +Number of null pointers to prepend to +.IR we_wordv . +.IP WRDE_NOCMD 14 +Fail if command substitution is requested. +.IP WRDE_REUSE 14 +The +.IR pwordexp +argument was passed to a previous successful call to +\fIwordexp\fR(), +and has not been passed to +\fIwordfree\fR(). +The result is the same as if the application had called +\fIwordfree\fR() +and then called +\fIwordexp\fR() +without WRDE_REUSE. +.IP WRDE_SHOWERR 14 +Do not redirect +.IR stderr +to +.BR /dev/null . +.IP WRDE_UNDEF 14 +Report error on an attempt to expand an undefined shell variable. +.P +The +.IR <wordexp.h> +header shall define the following symbolic constants as error +return values: +.IP WRDE_BADCHAR 14 +One of the unquoted characters\(em\c +<newline>, +.BR '|' , +.BR '&' , +.BR ';' , +.BR '<' , +.BR '>' , +.BR '(' , +.BR ')' , +.BR '{' , +.BR '}' \(em\c +appears in +.IR words +in an inappropriate context. +.IP WRDE_BADVAL 14 +Reference to undefined shell variable when WRDE_UNDEF is set in +.IR flags . +.IP WRDE_CMDSUB 14 +Command substitution requested when WRDE_NOCMD was set in +.IR flags . +.IP WRDE_NOSPACE 14 +Attempt to allocate memory failed. +.IP WRDE_SYNTAX 14 +Shell syntax error, such as unbalanced parentheses or unterminated string. +.P +The +.IR <wordexp.h> +header shall define the +.BR size_t +type as described in +.IR <stddef.h> . +.P +The following shall be declared as functions and may also be defined as +macros. Function prototypes shall be provided. +.sp +.RS 4 +.nf + +int wordexp(const char *restrict, wordexp_t *restrict, int); +void wordfree(wordexp_t *); +.fi +.P +.RE +.LP +.IR "The following sections are informative." +.SH "APPLICATION USAGE" +None. +.SH RATIONALE +None. +.SH "FUTURE DIRECTIONS" +None. +.SH "SEE ALSO" +.IR "\fB<stddef.h>\fP" +.P +The System Interfaces volume of POSIX.1\(hy2017, +.IR "Section 2.6" ", " "Word Expansions" +.\" +.SH COPYRIGHT +Portions of this text are reprinted and reproduced in electronic form +from IEEE Std 1003.1-2017, Standard for Information Technology +-- Portable Operating System Interface (POSIX), The Open Group Base +Specifications Issue 7, 2018 Edition, +Copyright (C) 2018 by the Institute of +Electrical and Electronics Engineers, Inc and The Open Group. +In the event of any discrepancy between this version and the original IEEE and +The Open Group Standard, the original IEEE and The Open Group Standard +is the referee document. The original Standard can be obtained online at +http://www.opengroup.org/unix/online.html . +.PP +Any typographical or formatting errors that appear +in this page are most likely +to have been introduced during the conversion of the source files to +man page format. To report such errors, see +https://www.kernel.org/doc/man-pages/reporting_bugs.html . |