| /* DO NOT EDIT! GENERATED AUTOMATICALLY! */ |
| /* Substitute for and wrapper around <unistd.h>. |
| Copyright (C) 2003-2019 Free Software Foundation, Inc. |
| |
| This program is free software; you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation; either version 3, or (at your option) |
| any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program; if not, see <https://www.gnu.org/licenses/>. */ |
| |
| #ifndef _GL_UNISTD_H |
| |
| #if __GNUC__ >= 3 |
| #pragma GCC system_header |
| #endif |
| |
| |
| #ifdef _GL_INCLUDING_UNISTD_H |
| /* Special invocation convention: |
| - On Mac OS X 10.3.9 we have a sequence of nested includes |
| <unistd.h> -> <signal.h> -> <pthread.h> -> <unistd.h> |
| In this situation, the functions are not yet declared, therefore we cannot |
| provide the C++ aliases. */ |
| |
| #include_next <unistd.h> |
| |
| #else |
| /* Normal invocation convention. */ |
| |
| /* The include_next requires a split double-inclusion guard. */ |
| #if 1 |
| # define _GL_INCLUDING_UNISTD_H |
| # include_next <unistd.h> |
| # undef _GL_INCLUDING_UNISTD_H |
| #endif |
| |
| /* Get all possible declarations of gethostname(). */ |
| #if 0 && 0 \ |
| && !defined _GL_INCLUDING_WINSOCK2_H |
| # define _GL_INCLUDING_WINSOCK2_H |
| # include <winsock2.h> |
| # undef _GL_INCLUDING_WINSOCK2_H |
| #endif |
| |
| #if !defined _GL_UNISTD_H && !defined _GL_INCLUDING_WINSOCK2_H |
| #define _GL_UNISTD_H |
| |
| /* NetBSD 5.0 mis-defines NULL. Also get size_t. */ |
| /* But avoid namespace pollution on glibc systems. */ |
| #ifndef __GLIBC__ |
| # include <stddef.h> |
| #endif |
| |
| /* mingw doesn't define the SEEK_* or *_FILENO macros in <unistd.h>. */ |
| /* MSVC declares 'unlink' in <stdio.h>, not in <unistd.h>. We must include |
| it before we #define unlink rpl_unlink. */ |
| /* Cygwin 1.7.1 declares symlinkat in <stdio.h>, not in <unistd.h>. */ |
| /* But avoid namespace pollution on glibc systems. */ |
| #if (!(defined SEEK_CUR && defined SEEK_END && defined SEEK_SET) \ |
| || ((1 || defined GNULIB_POSIXCHECK) \ |
| && (defined _WIN32 && ! defined __CYGWIN__)) \ |
| || ((0 || defined GNULIB_POSIXCHECK) \ |
| && defined __CYGWIN__)) \ |
| && ! defined __GLIBC__ |
| # include <stdio.h> |
| #endif |
| |
| /* Cygwin 1.7.1 and Android 4.3 declare unlinkat in <fcntl.h>, not in |
| <unistd.h>. */ |
| /* But avoid namespace pollution on glibc systems. */ |
| #if (0 || defined GNULIB_POSIXCHECK) \ |
| && (defined __CYGWIN__ || defined __ANDROID__) \ |
| && ! defined __GLIBC__ |
| # include <fcntl.h> |
| #endif |
| |
| /* mingw fails to declare _exit in <unistd.h>. */ |
| /* mingw, MSVC, BeOS, Haiku declare environ in <stdlib.h>, not in |
| <unistd.h>. */ |
| /* Solaris declares getcwd not only in <unistd.h> but also in <stdlib.h>. */ |
| /* OSF Tru64 Unix cannot see gnulib rpl_strtod when system <stdlib.h> is |
| included here. */ |
| /* But avoid namespace pollution on glibc systems. */ |
| #if !defined __GLIBC__ && !defined __osf__ |
| # define __need_system_stdlib_h |
| # include <stdlib.h> |
| # undef __need_system_stdlib_h |
| #endif |
| |
| /* Native Windows platforms declare chdir, getcwd, rmdir in |
| <io.h> and/or <direct.h>, not in <unistd.h>. |
| They also declare access(), chmod(), close(), dup(), dup2(), isatty(), |
| lseek(), read(), unlink(), write() in <io.h>. */ |
| #if ((0 || 0 || 0 \ |
| || defined GNULIB_POSIXCHECK) \ |
| && (defined _WIN32 && ! defined __CYGWIN__)) |
| # include <io.h> /* mingw32, mingw64 */ |
| # include <direct.h> /* mingw64, MSVC 9 */ |
| #elif (1 || 0 || 1 || 0 \ |
| || 0 || 0 || 1 || 0 \ |
| || defined GNULIB_POSIXCHECK) \ |
| && (defined _WIN32 && ! defined __CYGWIN__) |
| # include <io.h> |
| #endif |
| |
| /* AIX and OSF/1 5.1 declare getdomainname in <netdb.h>, not in <unistd.h>. |
| NonStop Kernel declares gethostname in <netdb.h>, not in <unistd.h>. */ |
| /* But avoid namespace pollution on glibc systems. */ |
| #if ((0 && (defined _AIX || defined __osf__)) \ |
| || (0 && defined __TANDEM)) \ |
| && !defined __GLIBC__ |
| # include <netdb.h> |
| #endif |
| |
| /* Android 4.3 declares fchownat in <sys/stat.h>, not in <unistd.h>. */ |
| /* But avoid namespace pollution on glibc systems. */ |
| #if (0 || defined GNULIB_POSIXCHECK) && defined __ANDROID__ \ |
| && !defined __GLIBC__ |
| # include <sys/stat.h> |
| #endif |
| |
| /* MSVC defines off_t in <sys/types.h>. |
| May also define off_t to a 64-bit type on native Windows. */ |
| /* But avoid namespace pollution on glibc systems. */ |
| #ifndef __GLIBC__ |
| /* Get off_t, ssize_t. */ |
| # include <sys/types.h> |
| #endif |
| |
| /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */ |
| /* C++ compatible function declaration macros. |
| Copyright (C) 2010-2019 Free Software Foundation, Inc. |
| |
| This program is free software: you can redistribute it and/or modify it |
| under the terms of the GNU General Public License as published |
| by the Free Software Foundation; either version 3 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program. If not, see <https://www.gnu.org/licenses/>. */ |
| |
| #ifndef _GL_CXXDEFS_H |
| #define _GL_CXXDEFS_H |
| |
| /* Begin/end the GNULIB_NAMESPACE namespace. */ |
| #if defined __cplusplus && defined GNULIB_NAMESPACE |
| # define _GL_BEGIN_NAMESPACE namespace GNULIB_NAMESPACE { |
| # define _GL_END_NAMESPACE } |
| #else |
| # define _GL_BEGIN_NAMESPACE |
| # define _GL_END_NAMESPACE |
| #endif |
| |
| /* The three most frequent use cases of these macros are: |
| |
| * For providing a substitute for a function that is missing on some |
| platforms, but is declared and works fine on the platforms on which |
| it exists: |
| |
| #if @GNULIB_FOO@ |
| # if !@HAVE_FOO@ |
| _GL_FUNCDECL_SYS (foo, ...); |
| # endif |
| _GL_CXXALIAS_SYS (foo, ...); |
| _GL_CXXALIASWARN (foo); |
| #elif defined GNULIB_POSIXCHECK |
| ... |
| #endif |
| |
| * For providing a replacement for a function that exists on all platforms, |
| but is broken/insufficient and needs to be replaced on some platforms: |
| |
| #if @GNULIB_FOO@ |
| # if @REPLACE_FOO@ |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef foo |
| # define foo rpl_foo |
| # endif |
| _GL_FUNCDECL_RPL (foo, ...); |
| _GL_CXXALIAS_RPL (foo, ...); |
| # else |
| _GL_CXXALIAS_SYS (foo, ...); |
| # endif |
| _GL_CXXALIASWARN (foo); |
| #elif defined GNULIB_POSIXCHECK |
| ... |
| #endif |
| |
| * For providing a replacement for a function that exists on some platforms |
| but is broken/insufficient and needs to be replaced on some of them and |
| is additionally either missing or undeclared on some other platforms: |
| |
| #if @GNULIB_FOO@ |
| # if @REPLACE_FOO@ |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef foo |
| # define foo rpl_foo |
| # endif |
| _GL_FUNCDECL_RPL (foo, ...); |
| _GL_CXXALIAS_RPL (foo, ...); |
| # else |
| # if !@HAVE_FOO@ or if !@HAVE_DECL_FOO@ |
| _GL_FUNCDECL_SYS (foo, ...); |
| # endif |
| _GL_CXXALIAS_SYS (foo, ...); |
| # endif |
| _GL_CXXALIASWARN (foo); |
| #elif defined GNULIB_POSIXCHECK |
| ... |
| #endif |
| */ |
| |
| /* _GL_EXTERN_C declaration; |
| performs the declaration with C linkage. */ |
| #if defined __cplusplus |
| # define _GL_EXTERN_C extern "C" |
| #else |
| # define _GL_EXTERN_C extern |
| #endif |
| |
| /* _GL_FUNCDECL_RPL (func, rettype, parameters_and_attributes); |
| declares a replacement function, named rpl_func, with the given prototype, |
| consisting of return type, parameters, and attributes. |
| Example: |
| _GL_FUNCDECL_RPL (open, int, (const char *filename, int flags, ...) |
| _GL_ARG_NONNULL ((1))); |
| */ |
| #define _GL_FUNCDECL_RPL(func,rettype,parameters_and_attributes) \ |
| _GL_FUNCDECL_RPL_1 (rpl_##func, rettype, parameters_and_attributes) |
| #define _GL_FUNCDECL_RPL_1(rpl_func,rettype,parameters_and_attributes) \ |
| _GL_EXTERN_C rettype rpl_func parameters_and_attributes |
| |
| /* _GL_FUNCDECL_SYS (func, rettype, parameters_and_attributes); |
| declares the system function, named func, with the given prototype, |
| consisting of return type, parameters, and attributes. |
| Example: |
| _GL_FUNCDECL_SYS (open, int, (const char *filename, int flags, ...) |
| _GL_ARG_NONNULL ((1))); |
| */ |
| #define _GL_FUNCDECL_SYS(func,rettype,parameters_and_attributes) \ |
| _GL_EXTERN_C rettype func parameters_and_attributes |
| |
| /* _GL_CXXALIAS_RPL (func, rettype, parameters); |
| declares a C++ alias called GNULIB_NAMESPACE::func |
| that redirects to rpl_func, if GNULIB_NAMESPACE is defined. |
| Example: |
| _GL_CXXALIAS_RPL (open, int, (const char *filename, int flags, ...)); |
| |
| Wrapping rpl_func in an object with an inline conversion operator |
| avoids a reference to rpl_func unless GNULIB_NAMESPACE::func is |
| actually used in the program. */ |
| #define _GL_CXXALIAS_RPL(func,rettype,parameters) \ |
| _GL_CXXALIAS_RPL_1 (func, rpl_##func, rettype, parameters) |
| #if defined __cplusplus && defined GNULIB_NAMESPACE |
| # define _GL_CXXALIAS_RPL_1(func,rpl_func,rettype,parameters) \ |
| namespace GNULIB_NAMESPACE \ |
| { \ |
| static const struct _gl_ ## func ## _wrapper \ |
| { \ |
| typedef rettype (*type) parameters; \ |
| \ |
| inline operator type () const \ |
| { \ |
| return ::rpl_func; \ |
| } \ |
| } func = {}; \ |
| } \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #else |
| # define _GL_CXXALIAS_RPL_1(func,rpl_func,rettype,parameters) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #endif |
| |
| /* _GL_CXXALIAS_RPL_CAST_1 (func, rpl_func, rettype, parameters); |
| is like _GL_CXXALIAS_RPL_1 (func, rpl_func, rettype, parameters); |
| except that the C function rpl_func may have a slightly different |
| declaration. A cast is used to silence the "invalid conversion" error |
| that would otherwise occur. */ |
| #if defined __cplusplus && defined GNULIB_NAMESPACE |
| # define _GL_CXXALIAS_RPL_CAST_1(func,rpl_func,rettype,parameters) \ |
| namespace GNULIB_NAMESPACE \ |
| { \ |
| static const struct _gl_ ## func ## _wrapper \ |
| { \ |
| typedef rettype (*type) parameters; \ |
| \ |
| inline operator type () const \ |
| { \ |
| return reinterpret_cast<type>(::rpl_func); \ |
| } \ |
| } func = {}; \ |
| } \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #else |
| # define _GL_CXXALIAS_RPL_CAST_1(func,rpl_func,rettype,parameters) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #endif |
| |
| /* _GL_CXXALIAS_SYS (func, rettype, parameters); |
| declares a C++ alias called GNULIB_NAMESPACE::func |
| that redirects to the system provided function func, if GNULIB_NAMESPACE |
| is defined. |
| Example: |
| _GL_CXXALIAS_SYS (open, int, (const char *filename, int flags, ...)); |
| |
| Wrapping func in an object with an inline conversion operator |
| avoids a reference to func unless GNULIB_NAMESPACE::func is |
| actually used in the program. */ |
| #if defined __cplusplus && defined GNULIB_NAMESPACE |
| # define _GL_CXXALIAS_SYS(func,rettype,parameters) \ |
| namespace GNULIB_NAMESPACE \ |
| { \ |
| static const struct _gl_ ## func ## _wrapper \ |
| { \ |
| typedef rettype (*type) parameters; \ |
| \ |
| inline operator type () const \ |
| { \ |
| return ::func; \ |
| } \ |
| } func = {}; \ |
| } \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #else |
| # define _GL_CXXALIAS_SYS(func,rettype,parameters) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #endif |
| |
| /* _GL_CXXALIAS_SYS_CAST (func, rettype, parameters); |
| is like _GL_CXXALIAS_SYS (func, rettype, parameters); |
| except that the C function func may have a slightly different declaration. |
| A cast is used to silence the "invalid conversion" error that would |
| otherwise occur. */ |
| #if defined __cplusplus && defined GNULIB_NAMESPACE |
| # define _GL_CXXALIAS_SYS_CAST(func,rettype,parameters) \ |
| namespace GNULIB_NAMESPACE \ |
| { \ |
| static const struct _gl_ ## func ## _wrapper \ |
| { \ |
| typedef rettype (*type) parameters; \ |
| \ |
| inline operator type () const \ |
| { \ |
| return reinterpret_cast<type>(::func); \ |
| } \ |
| } func = {}; \ |
| } \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #else |
| # define _GL_CXXALIAS_SYS_CAST(func,rettype,parameters) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #endif |
| |
| /* _GL_CXXALIAS_SYS_CAST2 (func, rettype, parameters, rettype2, parameters2); |
| is like _GL_CXXALIAS_SYS (func, rettype, parameters); |
| except that the C function is picked among a set of overloaded functions, |
| namely the one with rettype2 and parameters2. Two consecutive casts |
| are used to silence the "cannot find a match" and "invalid conversion" |
| errors that would otherwise occur. */ |
| #if defined __cplusplus && defined GNULIB_NAMESPACE |
| /* The outer cast must be a reinterpret_cast. |
| The inner cast: When the function is defined as a set of overloaded |
| functions, it works as a static_cast<>, choosing the designated variant. |
| When the function is defined as a single variant, it works as a |
| reinterpret_cast<>. The parenthesized cast syntax works both ways. */ |
| # define _GL_CXXALIAS_SYS_CAST2(func,rettype,parameters,rettype2,parameters2) \ |
| namespace GNULIB_NAMESPACE \ |
| { \ |
| static const struct _gl_ ## func ## _wrapper \ |
| { \ |
| typedef rettype (*type) parameters; \ |
| \ |
| inline operator type () const \ |
| { \ |
| return reinterpret_cast<type>((rettype2 (*) parameters2)(::func)); \ |
| } \ |
| } func = {}; \ |
| } \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #else |
| # define _GL_CXXALIAS_SYS_CAST2(func,rettype,parameters,rettype2,parameters2) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #endif |
| |
| /* _GL_CXXALIASWARN (func); |
| causes a warning to be emitted when ::func is used but not when |
| GNULIB_NAMESPACE::func is used. func must be defined without overloaded |
| variants. */ |
| #if defined __cplusplus && defined GNULIB_NAMESPACE |
| # define _GL_CXXALIASWARN(func) \ |
| _GL_CXXALIASWARN_1 (func, GNULIB_NAMESPACE) |
| # define _GL_CXXALIASWARN_1(func,namespace) \ |
| _GL_CXXALIASWARN_2 (func, namespace) |
| /* To work around GCC bug <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=43881>, |
| we enable the warning only when not optimizing. */ |
| # if !__OPTIMIZE__ |
| # define _GL_CXXALIASWARN_2(func,namespace) \ |
| _GL_WARN_ON_USE (func, \ |
| "The symbol ::" #func " refers to the system function. " \ |
| "Use " #namespace "::" #func " instead.") |
| # elif __GNUC__ >= 3 && GNULIB_STRICT_CHECKING |
| # define _GL_CXXALIASWARN_2(func,namespace) \ |
| extern __typeof__ (func) func |
| # else |
| # define _GL_CXXALIASWARN_2(func,namespace) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| # endif |
| #else |
| # define _GL_CXXALIASWARN(func) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #endif |
| |
| /* _GL_CXXALIASWARN1 (func, rettype, parameters_and_attributes); |
| causes a warning to be emitted when the given overloaded variant of ::func |
| is used but not when GNULIB_NAMESPACE::func is used. */ |
| #if defined __cplusplus && defined GNULIB_NAMESPACE |
| # define _GL_CXXALIASWARN1(func,rettype,parameters_and_attributes) \ |
| _GL_CXXALIASWARN1_1 (func, rettype, parameters_and_attributes, \ |
| GNULIB_NAMESPACE) |
| # define _GL_CXXALIASWARN1_1(func,rettype,parameters_and_attributes,namespace) \ |
| _GL_CXXALIASWARN1_2 (func, rettype, parameters_and_attributes, namespace) |
| /* To work around GCC bug <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=43881>, |
| we enable the warning only when not optimizing. */ |
| # if !__OPTIMIZE__ |
| # define _GL_CXXALIASWARN1_2(func,rettype,parameters_and_attributes,namespace) \ |
| _GL_WARN_ON_USE_CXX (func, rettype, parameters_and_attributes, \ |
| "The symbol ::" #func " refers to the system function. " \ |
| "Use " #namespace "::" #func " instead.") |
| # elif __GNUC__ >= 3 && GNULIB_STRICT_CHECKING |
| # define _GL_CXXALIASWARN1_2(func,rettype,parameters_and_attributes,namespace) \ |
| extern __typeof__ (func) func |
| # else |
| # define _GL_CXXALIASWARN1_2(func,rettype,parameters_and_attributes,namespace) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| # endif |
| #else |
| # define _GL_CXXALIASWARN1(func,rettype,parameters_and_attributes) \ |
| _GL_EXTERN_C int _gl_cxxalias_dummy |
| #endif |
| |
| #endif /* _GL_CXXDEFS_H */ |
| |
| /* The definition of _GL_ARG_NONNULL is copied here. */ |
| /* A C macro for declaring that specific arguments must not be NULL. |
| Copyright (C) 2009-2019 Free Software Foundation, Inc. |
| |
| This program is free software: you can redistribute it and/or modify it |
| under the terms of the GNU General Public License as published |
| by the Free Software Foundation; either version 3 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program. If not, see <https://www.gnu.org/licenses/>. */ |
| |
| /* _GL_ARG_NONNULL((n,...,m)) tells the compiler and static analyzer tools |
| that the values passed as arguments n, ..., m must be non-NULL pointers. |
| n = 1 stands for the first argument, n = 2 for the second argument etc. */ |
| #ifndef _GL_ARG_NONNULL |
| # if (__GNUC__ == 3 && __GNUC_MINOR__ >= 3) || __GNUC__ > 3 |
| # define _GL_ARG_NONNULL(params) __attribute__ ((__nonnull__ params)) |
| # else |
| # define _GL_ARG_NONNULL(params) |
| # endif |
| #endif |
| |
| /* The definition of _GL_WARN_ON_USE is copied here. */ |
| /* A C macro for emitting warnings if a function is used. |
| Copyright (C) 2010-2019 Free Software Foundation, Inc. |
| |
| This program is free software: you can redistribute it and/or modify it |
| under the terms of the GNU General Public License as published |
| by the Free Software Foundation; either version 3 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program. If not, see <https://www.gnu.org/licenses/>. */ |
| |
| /* _GL_WARN_ON_USE (function, "literal string") issues a declaration |
| for FUNCTION which will then trigger a compiler warning containing |
| the text of "literal string" anywhere that function is called, if |
| supported by the compiler. If the compiler does not support this |
| feature, the macro expands to an unused extern declaration. |
| |
| _GL_WARN_ON_USE_ATTRIBUTE ("literal string") expands to the |
| attribute used in _GL_WARN_ON_USE. If the compiler does not support |
| this feature, it expands to empty. |
| |
| These macros are useful for marking a function as a potential |
| portability trap, with the intent that "literal string" include |
| instructions on the replacement function that should be used |
| instead. |
| _GL_WARN_ON_USE is for functions with 'extern' linkage. |
| _GL_WARN_ON_USE_ATTRIBUTE is for functions with 'static' or 'inline' |
| linkage. |
| |
| However, one of the reasons that a function is a portability trap is |
| if it has the wrong signature. Declaring FUNCTION with a different |
| signature in C is a compilation error, so this macro must use the |
| same type as any existing declaration so that programs that avoid |
| the problematic FUNCTION do not fail to compile merely because they |
| included a header that poisoned the function. But this implies that |
| _GL_WARN_ON_USE is only safe to use if FUNCTION is known to already |
| have a declaration. Use of this macro implies that there must not |
| be any other macro hiding the declaration of FUNCTION; but |
| undefining FUNCTION first is part of the poisoning process anyway |
| (although for symbols that are provided only via a macro, the result |
| is a compilation error rather than a warning containing |
| "literal string"). Also note that in C++, it is only safe to use if |
| FUNCTION has no overloads. |
| |
| For an example, it is possible to poison 'getline' by: |
| - adding a call to gl_WARN_ON_USE_PREPARE([[#include <stdio.h>]], |
| [getline]) in configure.ac, which potentially defines |
| HAVE_RAW_DECL_GETLINE |
| - adding this code to a header that wraps the system <stdio.h>: |
| #undef getline |
| #if HAVE_RAW_DECL_GETLINE |
| _GL_WARN_ON_USE (getline, "getline is required by POSIX 2008, but" |
| "not universally present; use the gnulib module getline"); |
| #endif |
| |
| It is not possible to directly poison global variables. But it is |
| possible to write a wrapper accessor function, and poison that |
| (less common usage, like &environ, will cause a compilation error |
| rather than issue the nice warning, but the end result of informing |
| the developer about their portability problem is still achieved): |
| #if HAVE_RAW_DECL_ENVIRON |
| static char *** |
| rpl_environ (void) { return &environ; } |
| _GL_WARN_ON_USE (rpl_environ, "environ is not always properly declared"); |
| # undef environ |
| # define environ (*rpl_environ ()) |
| #endif |
| or better (avoiding contradictory use of 'static' and 'extern'): |
| #if HAVE_RAW_DECL_ENVIRON |
| static char *** |
| _GL_WARN_ON_USE_ATTRIBUTE ("environ is not always properly declared") |
| rpl_environ (void) { return &environ; } |
| # undef environ |
| # define environ (*rpl_environ ()) |
| #endif |
| */ |
| #ifndef _GL_WARN_ON_USE |
| |
| # if 4 < __GNUC__ || (__GNUC__ == 4 && 3 <= __GNUC_MINOR__) |
| /* A compiler attribute is available in gcc versions 4.3.0 and later. */ |
| # define _GL_WARN_ON_USE(function, message) \ |
| extern __typeof__ (function) function __attribute__ ((__warning__ (message))) |
| # define _GL_WARN_ON_USE_ATTRIBUTE(message) \ |
| __attribute__ ((__warning__ (message))) |
| # elif __GNUC__ >= 3 && GNULIB_STRICT_CHECKING |
| /* Verify the existence of the function. */ |
| # define _GL_WARN_ON_USE(function, message) \ |
| extern __typeof__ (function) function |
| # define _GL_WARN_ON_USE_ATTRIBUTE(message) |
| # else /* Unsupported. */ |
| # define _GL_WARN_ON_USE(function, message) \ |
| _GL_WARN_EXTERN_C int _gl_warn_on_use |
| # define _GL_WARN_ON_USE_ATTRIBUTE(message) |
| # endif |
| #endif |
| |
| /* _GL_WARN_ON_USE_CXX (function, rettype, parameters_and_attributes, "string") |
| is like _GL_WARN_ON_USE (function, "string"), except that the function is |
| declared with the given prototype, consisting of return type, parameters, |
| and attributes. |
| This variant is useful for overloaded functions in C++. _GL_WARN_ON_USE does |
| not work in this case. */ |
| #ifndef _GL_WARN_ON_USE_CXX |
| # if 4 < __GNUC__ || (__GNUC__ == 4 && 3 <= __GNUC_MINOR__) |
| # define _GL_WARN_ON_USE_CXX(function,rettype,parameters_and_attributes,msg) \ |
| extern rettype function parameters_and_attributes \ |
| __attribute__ ((__warning__ (msg))) |
| # elif __GNUC__ >= 3 && GNULIB_STRICT_CHECKING |
| /* Verify the existence of the function. */ |
| # define _GL_WARN_ON_USE_CXX(function,rettype,parameters_and_attributes,msg) \ |
| extern rettype function parameters_and_attributes |
| # else /* Unsupported. */ |
| # define _GL_WARN_ON_USE_CXX(function,rettype,parameters_and_attributes,msg) \ |
| _GL_WARN_EXTERN_C int _gl_warn_on_use |
| # endif |
| #endif |
| |
| /* _GL_WARN_EXTERN_C declaration; |
| performs the declaration with C linkage. */ |
| #ifndef _GL_WARN_EXTERN_C |
| # if defined __cplusplus |
| # define _GL_WARN_EXTERN_C extern "C" |
| # else |
| # define _GL_WARN_EXTERN_C extern |
| # endif |
| #endif |
| |
| |
| /* Get getopt(), optarg, optind, opterr, optopt. */ |
| #if 0 && !defined _GL_SYSTEM_GETOPT |
| # include <getopt-cdefs.h> |
| # include <getopt-pfx-core.h> |
| #endif |
| |
| #ifndef _GL_INLINE_HEADER_BEGIN |
| #error "Please include config.h first." |
| #endif |
| _GL_INLINE_HEADER_BEGIN |
| #ifndef _GL_UNISTD_INLINE |
| # define _GL_UNISTD_INLINE _GL_INLINE |
| #endif |
| |
| /* Hide some function declarations from <winsock2.h>. */ |
| |
| #if 0 && 0 |
| # if !defined _GL_SYS_SOCKET_H |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef socket |
| # define socket socket_used_without_including_sys_socket_h |
| # undef connect |
| # define connect connect_used_without_including_sys_socket_h |
| # undef accept |
| # define accept accept_used_without_including_sys_socket_h |
| # undef bind |
| # define bind bind_used_without_including_sys_socket_h |
| # undef getpeername |
| # define getpeername getpeername_used_without_including_sys_socket_h |
| # undef getsockname |
| # define getsockname getsockname_used_without_including_sys_socket_h |
| # undef getsockopt |
| # define getsockopt getsockopt_used_without_including_sys_socket_h |
| # undef listen |
| # define listen listen_used_without_including_sys_socket_h |
| # undef recv |
| # define recv recv_used_without_including_sys_socket_h |
| # undef send |
| # define send send_used_without_including_sys_socket_h |
| # undef recvfrom |
| # define recvfrom recvfrom_used_without_including_sys_socket_h |
| # undef sendto |
| # define sendto sendto_used_without_including_sys_socket_h |
| # undef setsockopt |
| # define setsockopt setsockopt_used_without_including_sys_socket_h |
| # undef shutdown |
| # define shutdown shutdown_used_without_including_sys_socket_h |
| # else |
| _GL_WARN_ON_USE (socket, |
| "socket() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (connect, |
| "connect() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (accept, |
| "accept() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (bind, |
| "bind() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (getpeername, |
| "getpeername() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (getsockname, |
| "getsockname() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (getsockopt, |
| "getsockopt() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (listen, |
| "listen() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (recv, |
| "recv() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (send, |
| "send() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (recvfrom, |
| "recvfrom() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (sendto, |
| "sendto() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (setsockopt, |
| "setsockopt() used without including <sys/socket.h>"); |
| _GL_WARN_ON_USE (shutdown, |
| "shutdown() used without including <sys/socket.h>"); |
| # endif |
| # endif |
| # if !defined _GL_SYS_SELECT_H |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef select |
| # define select select_used_without_including_sys_select_h |
| # else |
| _GL_WARN_ON_USE (select, |
| "select() used without including <sys/select.h>"); |
| # endif |
| # endif |
| #endif |
| |
| |
| /* OS/2 EMX lacks these macros. */ |
| #ifndef STDIN_FILENO |
| # define STDIN_FILENO 0 |
| #endif |
| #ifndef STDOUT_FILENO |
| # define STDOUT_FILENO 1 |
| #endif |
| #ifndef STDERR_FILENO |
| # define STDERR_FILENO 2 |
| #endif |
| |
| /* Ensure *_OK macros exist. */ |
| #ifndef F_OK |
| # define F_OK 0 |
| # define X_OK 1 |
| # define W_OK 2 |
| # define R_OK 4 |
| #endif |
| |
| |
| /* Declare overridden functions. */ |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef access |
| # define access rpl_access |
| # endif |
| _GL_FUNCDECL_RPL (access, int, (const char *file, int mode) |
| _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (access, int, (const char *file, int mode)); |
| # else |
| _GL_CXXALIAS_SYS (access, int, (const char *file, int mode)); |
| # endif |
| _GL_CXXALIASWARN (access); |
| #elif defined GNULIB_POSIXCHECK |
| # undef access |
| # if HAVE_RAW_DECL_ACCESS |
| /* The access() function is a security risk. */ |
| _GL_WARN_ON_USE (access, "access does not always support X_OK - " |
| "use gnulib module access for portability; " |
| "also, this function is a security risk - " |
| "use the gnulib module faccessat instead"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| _GL_CXXALIAS_SYS (chdir, int, (const char *file) _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIASWARN (chdir); |
| #elif defined GNULIB_POSIXCHECK |
| # undef chdir |
| # if HAVE_RAW_DECL_CHDIR |
| _GL_WARN_ON_USE (chown, "chdir is not always in <unistd.h> - " |
| "use gnulib module chdir for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Change the owner of FILE to UID (if UID is not -1) and the group of FILE |
| to GID (if GID is not -1). Follow symbolic links. |
| Return 0 if successful, otherwise -1 and errno set. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/chown.html. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef chown |
| # define chown rpl_chown |
| # endif |
| _GL_FUNCDECL_RPL (chown, int, (const char *file, uid_t uid, gid_t gid) |
| _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (chown, int, (const char *file, uid_t uid, gid_t gid)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (chown, int, (const char *file, uid_t uid, gid_t gid) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| _GL_CXXALIAS_SYS (chown, int, (const char *file, uid_t uid, gid_t gid)); |
| # endif |
| _GL_CXXALIASWARN (chown); |
| #elif defined GNULIB_POSIXCHECK |
| # undef chown |
| # if HAVE_RAW_DECL_CHOWN |
| _GL_WARN_ON_USE (chown, "chown fails to follow symlinks on some systems and " |
| "doesn't treat a uid or gid of -1 on some systems - " |
| "use gnulib module chown for portability"); |
| # endif |
| #endif |
| |
| |
| #if 1 |
| # if 0 |
| /* Automatically included by modules that need a replacement for close. */ |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef close |
| # define close rpl_close |
| # endif |
| _GL_FUNCDECL_RPL (close, int, (int fd)); |
| _GL_CXXALIAS_RPL (close, int, (int fd)); |
| # else |
| _GL_CXXALIAS_SYS (close, int, (int fd)); |
| # endif |
| _GL_CXXALIASWARN (close); |
| #elif 0 |
| # undef close |
| # define close close_used_without_requesting_gnulib_module_close |
| #elif defined GNULIB_POSIXCHECK |
| # undef close |
| /* Assume close is always declared. */ |
| _GL_WARN_ON_USE (close, "close does not portably work on sockets - " |
| "use gnulib module close for portability"); |
| #endif |
| |
| |
| #if 0 |
| # if !1 |
| _GL_FUNCDECL_SYS (copy_file_range, ssize_t, (int ifd, off_t *ipos, |
| int ofd, off_t *opos, |
| size_t len, unsigned flags)); |
| _GL_CXXALIAS_SYS (copy_file_range, ssize_t, (int ifd, off_t *ipos, |
| int ofd, off_t *opos, |
| size_t len, unsigned flags)); |
| # endif |
| _GL_CXXALIASWARN (copy_file_range); |
| #elif defined GNULIB_POSIXCHECK |
| /* Assume copy_file_range is always declared. */ |
| _GL_WARN_ON_USE (copy_file_range, |
| "copy_file_range is unportable - " |
| "use gnulib module copy_file_range for portability"); |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define dup rpl_dup |
| # endif |
| _GL_FUNCDECL_RPL (dup, int, (int oldfd)); |
| _GL_CXXALIAS_RPL (dup, int, (int oldfd)); |
| # else |
| _GL_CXXALIAS_SYS (dup, int, (int oldfd)); |
| # endif |
| _GL_CXXALIASWARN (dup); |
| #elif defined GNULIB_POSIXCHECK |
| # undef dup |
| # if HAVE_RAW_DECL_DUP |
| _GL_WARN_ON_USE (dup, "dup is unportable - " |
| "use gnulib module dup for portability"); |
| # endif |
| #endif |
| |
| |
| #if 1 |
| /* Copy the file descriptor OLDFD into file descriptor NEWFD. Do nothing if |
| NEWFD = OLDFD, otherwise close NEWFD first if it is open. |
| Return newfd if successful, otherwise -1 and errno set. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/dup2.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define dup2 rpl_dup2 |
| # endif |
| _GL_FUNCDECL_RPL (dup2, int, (int oldfd, int newfd)); |
| _GL_CXXALIAS_RPL (dup2, int, (int oldfd, int newfd)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (dup2, int, (int oldfd, int newfd)); |
| # endif |
| _GL_CXXALIAS_SYS (dup2, int, (int oldfd, int newfd)); |
| # endif |
| _GL_CXXALIASWARN (dup2); |
| #elif defined GNULIB_POSIXCHECK |
| # undef dup2 |
| # if HAVE_RAW_DECL_DUP2 |
| _GL_WARN_ON_USE (dup2, "dup2 is unportable - " |
| "use gnulib module dup2 for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Copy the file descriptor OLDFD into file descriptor NEWFD, with the |
| specified flags. |
| The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>) |
| and O_TEXT, O_BINARY (defined in "binary-io.h"). |
| Close NEWFD first if it is open. |
| Return newfd if successful, otherwise -1 and errno set. |
| See the Linux man page at |
| <https://www.kernel.org/doc/man-pages/online/pages/man2/dup3.2.html>. */ |
| # if 1 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define dup3 rpl_dup3 |
| # endif |
| _GL_FUNCDECL_RPL (dup3, int, (int oldfd, int newfd, int flags)); |
| _GL_CXXALIAS_RPL (dup3, int, (int oldfd, int newfd, int flags)); |
| # else |
| _GL_FUNCDECL_SYS (dup3, int, (int oldfd, int newfd, int flags)); |
| _GL_CXXALIAS_SYS (dup3, int, (int oldfd, int newfd, int flags)); |
| # endif |
| _GL_CXXALIASWARN (dup3); |
| #elif defined GNULIB_POSIXCHECK |
| # undef dup3 |
| # if HAVE_RAW_DECL_DUP3 |
| _GL_WARN_ON_USE (dup3, "dup3 is unportable - " |
| "use gnulib module dup3 for portability"); |
| # endif |
| #endif |
| |
| |
| #if 1 |
| # if defined __CYGWIN__ && !defined __i386__ |
| /* The 'environ' variable is defined in a DLL. Therefore its declaration needs |
| the '__declspec(dllimport)' attribute, but the system's <unistd.h> lacks it. |
| This leads to a link error on 64-bit Cygwin when the option |
| -Wl,--disable-auto-import is in use. */ |
| _GL_EXTERN_C __declspec(dllimport) char **environ; |
| # endif |
| # if !1 |
| /* Set of environment variables and values. An array of strings of the form |
| "VARIABLE=VALUE", terminated with a NULL. */ |
| # if defined __APPLE__ && defined __MACH__ |
| # include <TargetConditionals.h> |
| # if !TARGET_OS_IPHONE && !TARGET_IPHONE_SIMULATOR |
| # define _GL_USE_CRT_EXTERNS |
| # endif |
| # endif |
| # ifdef _GL_USE_CRT_EXTERNS |
| # include <crt_externs.h> |
| # define environ (*_NSGetEnviron ()) |
| # else |
| # ifdef __cplusplus |
| extern "C" { |
| # endif |
| extern char **environ; |
| # ifdef __cplusplus |
| } |
| # endif |
| # endif |
| # endif |
| #elif defined GNULIB_POSIXCHECK |
| # if HAVE_RAW_DECL_ENVIRON |
| _GL_UNISTD_INLINE char *** |
| _GL_WARN_ON_USE_ATTRIBUTE ("environ is unportable - " |
| "use gnulib module environ for portability") |
| rpl_environ (void) |
| { |
| return &environ; |
| } |
| # undef environ |
| # define environ (*rpl_environ ()) |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Like access(), except that it uses the effective user id and group id of |
| the current process. */ |
| # if !1 |
| _GL_FUNCDECL_SYS (euidaccess, int, (const char *filename, int mode) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| _GL_CXXALIAS_SYS (euidaccess, int, (const char *filename, int mode)); |
| _GL_CXXALIASWARN (euidaccess); |
| # if defined GNULIB_POSIXCHECK |
| /* Like access(), this function is a security risk. */ |
| _GL_WARN_ON_USE (euidaccess, "the euidaccess function is a security risk - " |
| "use the gnulib module faccessat instead"); |
| # endif |
| #elif defined GNULIB_POSIXCHECK |
| # undef euidaccess |
| # if HAVE_RAW_DECL_EUIDACCESS |
| _GL_WARN_ON_USE (euidaccess, "euidaccess is unportable - " |
| "use gnulib module euidaccess for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef faccessat |
| # define faccessat rpl_faccessat |
| # endif |
| _GL_FUNCDECL_RPL (faccessat, int, |
| (int fd, char const *name, int mode, int flag) |
| _GL_ARG_NONNULL ((2))); |
| _GL_CXXALIAS_RPL (faccessat, int, |
| (int fd, char const *name, int mode, int flag)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (faccessat, int, |
| (int fd, char const *file, int mode, int flag) |
| _GL_ARG_NONNULL ((2))); |
| # endif |
| _GL_CXXALIAS_SYS (faccessat, int, |
| (int fd, char const *file, int mode, int flag)); |
| # endif |
| _GL_CXXALIASWARN (faccessat); |
| #elif defined GNULIB_POSIXCHECK |
| # undef faccessat |
| # if HAVE_RAW_DECL_FACCESSAT |
| _GL_WARN_ON_USE (faccessat, "faccessat is not portable - " |
| "use gnulib module faccessat for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Change the process' current working directory to the directory on which |
| the given file descriptor is open. |
| Return 0 if successful, otherwise -1 and errno set. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fchdir.html>. */ |
| # if ! 1 |
| _GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/)); |
| |
| /* Gnulib internal hooks needed to maintain the fchdir metadata. */ |
| _GL_EXTERN_C int _gl_register_fd (int fd, const char *filename) |
| _GL_ARG_NONNULL ((2)); |
| _GL_EXTERN_C void _gl_unregister_fd (int fd); |
| _GL_EXTERN_C int _gl_register_dup (int oldfd, int newfd); |
| _GL_EXTERN_C const char *_gl_directory_name (int fd); |
| |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/)); |
| # endif |
| # endif |
| _GL_CXXALIAS_SYS (fchdir, int, (int /*fd*/)); |
| _GL_CXXALIASWARN (fchdir); |
| #elif defined GNULIB_POSIXCHECK |
| # undef fchdir |
| # if HAVE_RAW_DECL_FCHDIR |
| _GL_WARN_ON_USE (fchdir, "fchdir is unportable - " |
| "use gnulib module fchdir for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef fchownat |
| # define fchownat rpl_fchownat |
| # endif |
| _GL_FUNCDECL_RPL (fchownat, int, (int fd, char const *file, |
| uid_t owner, gid_t group, int flag) |
| _GL_ARG_NONNULL ((2))); |
| _GL_CXXALIAS_RPL (fchownat, int, (int fd, char const *file, |
| uid_t owner, gid_t group, int flag)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (fchownat, int, (int fd, char const *file, |
| uid_t owner, gid_t group, int flag) |
| _GL_ARG_NONNULL ((2))); |
| # endif |
| _GL_CXXALIAS_SYS (fchownat, int, (int fd, char const *file, |
| uid_t owner, gid_t group, int flag)); |
| # endif |
| _GL_CXXALIASWARN (fchownat); |
| #elif defined GNULIB_POSIXCHECK |
| # undef fchownat |
| # if HAVE_RAW_DECL_FCHOWNAT |
| _GL_WARN_ON_USE (fchownat, "fchownat is not portable - " |
| "use gnulib module openat for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Synchronize changes to a file. |
| Return 0 if successful, otherwise -1 and errno set. |
| See POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fdatasync.html>. */ |
| # if !1 || !1 |
| _GL_FUNCDECL_SYS (fdatasync, int, (int fd)); |
| # endif |
| _GL_CXXALIAS_SYS (fdatasync, int, (int fd)); |
| _GL_CXXALIASWARN (fdatasync); |
| #elif defined GNULIB_POSIXCHECK |
| # undef fdatasync |
| # if HAVE_RAW_DECL_FDATASYNC |
| _GL_WARN_ON_USE (fdatasync, "fdatasync is unportable - " |
| "use gnulib module fdatasync for portability"); |
| # endif |
| #endif |
| |
| |
| #if 1 |
| /* Synchronize changes, including metadata, to a file. |
| Return 0 if successful, otherwise -1 and errno set. |
| See POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fsync.html>. */ |
| # if !1 |
| _GL_FUNCDECL_SYS (fsync, int, (int fd)); |
| # endif |
| _GL_CXXALIAS_SYS (fsync, int, (int fd)); |
| _GL_CXXALIASWARN (fsync); |
| #elif defined GNULIB_POSIXCHECK |
| # undef fsync |
| # if HAVE_RAW_DECL_FSYNC |
| _GL_WARN_ON_USE (fsync, "fsync is unportable - " |
| "use gnulib module fsync for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Change the size of the file to which FD is opened to become equal to LENGTH. |
| Return 0 if successful, otherwise -1 and errno set. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/ftruncate.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef ftruncate |
| # define ftruncate rpl_ftruncate |
| # endif |
| _GL_FUNCDECL_RPL (ftruncate, int, (int fd, off_t length)); |
| _GL_CXXALIAS_RPL (ftruncate, int, (int fd, off_t length)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (ftruncate, int, (int fd, off_t length)); |
| # endif |
| _GL_CXXALIAS_SYS (ftruncate, int, (int fd, off_t length)); |
| # endif |
| _GL_CXXALIASWARN (ftruncate); |
| #elif defined GNULIB_POSIXCHECK |
| # undef ftruncate |
| # if HAVE_RAW_DECL_FTRUNCATE |
| _GL_WARN_ON_USE (ftruncate, "ftruncate is unportable - " |
| "use gnulib module ftruncate for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Get the name of the current working directory, and put it in SIZE bytes |
| of BUF. |
| Return BUF if successful, or NULL if the directory couldn't be determined |
| or SIZE was too small. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getcwd.html>. |
| Additionally, the gnulib module 'getcwd' guarantees the following GNU |
| extension: If BUF is NULL, an array is allocated with 'malloc'; the array |
| is SIZE bytes long, unless SIZE == 0, in which case it is as big as |
| necessary. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define getcwd rpl_getcwd |
| # endif |
| _GL_FUNCDECL_RPL (getcwd, char *, (char *buf, size_t size)); |
| _GL_CXXALIAS_RPL (getcwd, char *, (char *buf, size_t size)); |
| # else |
| /* Need to cast, because on mingw, the second parameter is |
| int size. */ |
| _GL_CXXALIAS_SYS_CAST (getcwd, char *, (char *buf, size_t size)); |
| # endif |
| _GL_CXXALIASWARN (getcwd); |
| #elif defined GNULIB_POSIXCHECK |
| # undef getcwd |
| # if HAVE_RAW_DECL_GETCWD |
| _GL_WARN_ON_USE (getcwd, "getcwd is unportable - " |
| "use gnulib module getcwd for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Return the NIS domain name of the machine. |
| WARNING! The NIS domain name is unrelated to the fully qualified host name |
| of the machine. It is also unrelated to email addresses. |
| WARNING! The NIS domain name is usually the empty string or "(none)" when |
| not using NIS. |
| |
| Put up to LEN bytes of the NIS domain name into NAME. |
| Null terminate it if the name is shorter than LEN. |
| If the NIS domain name is longer than LEN, set errno = EINVAL and return -1. |
| Return 0 if successful, otherwise set errno and return -1. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef getdomainname |
| # define getdomainname rpl_getdomainname |
| # endif |
| _GL_FUNCDECL_RPL (getdomainname, int, (char *name, size_t len) |
| _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (getdomainname, int, (char *name, size_t len)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (getdomainname, int, (char *name, size_t len) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| _GL_CXXALIAS_SYS (getdomainname, int, (char *name, size_t len)); |
| # endif |
| _GL_CXXALIASWARN (getdomainname); |
| #elif defined GNULIB_POSIXCHECK |
| # undef getdomainname |
| # if HAVE_RAW_DECL_GETDOMAINNAME |
| _GL_WARN_ON_USE (getdomainname, "getdomainname is unportable - " |
| "use gnulib module getdomainname for portability"); |
| # endif |
| #endif |
| |
| |
| #if 1 |
| /* Return the maximum number of file descriptors in the current process. |
| In POSIX, this is same as sysconf (_SC_OPEN_MAX). */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef getdtablesize |
| # define getdtablesize rpl_getdtablesize |
| # endif |
| _GL_FUNCDECL_RPL (getdtablesize, int, (void)); |
| _GL_CXXALIAS_RPL (getdtablesize, int, (void)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (getdtablesize, int, (void)); |
| # endif |
| /* Need to cast, because on AIX, the parameter list is |
| (...). */ |
| _GL_CXXALIAS_SYS_CAST (getdtablesize, int, (void)); |
| # endif |
| _GL_CXXALIASWARN (getdtablesize); |
| #elif defined GNULIB_POSIXCHECK |
| # undef getdtablesize |
| # if HAVE_RAW_DECL_GETDTABLESIZE |
| _GL_WARN_ON_USE (getdtablesize, "getdtablesize is unportable - " |
| "use gnulib module getdtablesize for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Return the supplemental groups that the current process belongs to. |
| It is unspecified whether the effective group id is in the list. |
| If N is 0, return the group count; otherwise, N describes how many |
| entries are available in GROUPS. Return -1 and set errno if N is |
| not 0 and not large enough. Fails with ENOSYS on some systems. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef getgroups |
| # define getgroups rpl_getgroups |
| # endif |
| _GL_FUNCDECL_RPL (getgroups, int, (int n, gid_t *groups)); |
| _GL_CXXALIAS_RPL (getgroups, int, (int n, gid_t *groups)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (getgroups, int, (int n, gid_t *groups)); |
| # endif |
| _GL_CXXALIAS_SYS (getgroups, int, (int n, gid_t *groups)); |
| # endif |
| _GL_CXXALIASWARN (getgroups); |
| #elif defined GNULIB_POSIXCHECK |
| # undef getgroups |
| # if HAVE_RAW_DECL_GETGROUPS |
| _GL_WARN_ON_USE (getgroups, "getgroups is unportable - " |
| "use gnulib module getgroups for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Return the standard host name of the machine. |
| WARNING! The host name may or may not be fully qualified. |
| |
| Put up to LEN bytes of the host name into NAME. |
| Null terminate it if the name is shorter than LEN. |
| If the host name is longer than LEN, set errno = EINVAL and return -1. |
| Return 0 if successful, otherwise set errno and return -1. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef gethostname |
| # define gethostname rpl_gethostname |
| # endif |
| _GL_FUNCDECL_RPL (gethostname, int, (char *name, size_t len) |
| _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (gethostname, int, (char *name, size_t len)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (gethostname, int, (char *name, size_t len) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| /* Need to cast, because on Solaris 10 and OSF/1 5.1 systems, the second |
| parameter is |
| int len. */ |
| _GL_CXXALIAS_SYS_CAST (gethostname, int, (char *name, size_t len)); |
| # endif |
| _GL_CXXALIASWARN (gethostname); |
| #elif 0 |
| # undef gethostname |
| # define gethostname gethostname_used_without_requesting_gnulib_module_gethostname |
| #elif defined GNULIB_POSIXCHECK |
| # undef gethostname |
| # if HAVE_RAW_DECL_GETHOSTNAME |
| _GL_WARN_ON_USE (gethostname, "gethostname is unportable - " |
| "use gnulib module gethostname for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Returns the user's login name, or NULL if it cannot be found. Upon error, |
| returns NULL with errno set. |
| |
| See <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getlogin.html>. |
| |
| Most programs don't need to use this function, because the information is |
| available through environment variables: |
| ${LOGNAME-$USER} on Unix platforms, |
| $USERNAME on native Windows platforms. |
| */ |
| # if !1 |
| _GL_FUNCDECL_SYS (getlogin, char *, (void)); |
| # endif |
| _GL_CXXALIAS_SYS (getlogin, char *, (void)); |
| _GL_CXXALIASWARN (getlogin); |
| #elif defined GNULIB_POSIXCHECK |
| # undef getlogin |
| # if HAVE_RAW_DECL_GETLOGIN |
| _GL_WARN_ON_USE (getlogin, "getlogin is unportable - " |
| "use gnulib module getlogin for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Copies the user's login name to NAME. |
| The array pointed to by NAME has room for SIZE bytes. |
| |
| Returns 0 if successful. Upon error, an error number is returned, or -1 in |
| the case that the login name cannot be found but no specific error is |
| provided (this case is hopefully rare but is left open by the POSIX spec). |
| |
| See <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getlogin.html>. |
| |
| Most programs don't need to use this function, because the information is |
| available through environment variables: |
| ${LOGNAME-$USER} on Unix platforms, |
| $USERNAME on native Windows platforms. |
| */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define getlogin_r rpl_getlogin_r |
| # endif |
| _GL_FUNCDECL_RPL (getlogin_r, int, (char *name, size_t size) |
| _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (getlogin_r, int, (char *name, size_t size)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (getlogin_r, int, (char *name, size_t size) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| /* Need to cast, because on Solaris 10 systems, the second argument is |
| int size. */ |
| _GL_CXXALIAS_SYS_CAST (getlogin_r, int, (char *name, size_t size)); |
| # endif |
| _GL_CXXALIASWARN (getlogin_r); |
| #elif defined GNULIB_POSIXCHECK |
| # undef getlogin_r |
| # if HAVE_RAW_DECL_GETLOGIN_R |
| _GL_WARN_ON_USE (getlogin_r, "getlogin_r is unportable - " |
| "use gnulib module getlogin_r for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define getpagesize rpl_getpagesize |
| # endif |
| _GL_FUNCDECL_RPL (getpagesize, int, (void)); |
| _GL_CXXALIAS_RPL (getpagesize, int, (void)); |
| # else |
| # if !1 |
| # if !defined getpagesize |
| /* This is for POSIX systems. */ |
| # if !defined _gl_getpagesize && defined _SC_PAGESIZE |
| # if ! (defined __VMS && __VMS_VER < 70000000) |
| # define _gl_getpagesize() sysconf (_SC_PAGESIZE) |
| # endif |
| # endif |
| /* This is for older VMS. */ |
| # if !defined _gl_getpagesize && defined __VMS |
| # ifdef __ALPHA |
| # define _gl_getpagesize() 8192 |
| # else |
| # define _gl_getpagesize() 512 |
| # endif |
| # endif |
| /* This is for BeOS. */ |
| # if !defined _gl_getpagesize && 0 |
| # include <OS.h> |
| # if defined B_PAGE_SIZE |
| # define _gl_getpagesize() B_PAGE_SIZE |
| # endif |
| # endif |
| /* This is for AmigaOS4.0. */ |
| # if !defined _gl_getpagesize && defined __amigaos4__ |
| # define _gl_getpagesize() 2048 |
| # endif |
| /* This is for older Unix systems. */ |
| # if !defined _gl_getpagesize && 0 |
| # include <sys/param.h> |
| # ifdef EXEC_PAGESIZE |
| # define _gl_getpagesize() EXEC_PAGESIZE |
| # else |
| # ifdef NBPG |
| # ifndef CLSIZE |
| # define CLSIZE 1 |
| # endif |
| # define _gl_getpagesize() (NBPG * CLSIZE) |
| # else |
| # ifdef NBPC |
| # define _gl_getpagesize() NBPC |
| # endif |
| # endif |
| # endif |
| # endif |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define getpagesize() _gl_getpagesize () |
| # else |
| # if !GNULIB_defined_getpagesize_function |
| _GL_UNISTD_INLINE int |
| getpagesize () |
| { |
| return _gl_getpagesize (); |
| } |
| # define GNULIB_defined_getpagesize_function 1 |
| # endif |
| # endif |
| # endif |
| # endif |
| /* Need to cast, because on Cygwin 1.5.x systems, the return type is size_t. */ |
| _GL_CXXALIAS_SYS_CAST (getpagesize, int, (void)); |
| # endif |
| # if 1 |
| _GL_CXXALIASWARN (getpagesize); |
| # endif |
| #elif defined GNULIB_POSIXCHECK |
| # undef getpagesize |
| # if HAVE_RAW_DECL_GETPAGESIZE |
| _GL_WARN_ON_USE (getpagesize, "getpagesize is unportable - " |
| "use gnulib module getpagesize for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Function getpass() from module 'getpass': |
| Read a password from /dev/tty or stdin. |
| Function getpass() from module 'getpass-gnu': |
| Read a password of arbitrary length from /dev/tty or stdin. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef getpass |
| # define getpass rpl_getpass |
| # endif |
| _GL_FUNCDECL_RPL (getpass, char *, (const char *prompt) |
| _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (getpass, char *, (const char *prompt)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (getpass, char *, (const char *prompt) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| _GL_CXXALIAS_SYS (getpass, char *, (const char *prompt)); |
| # endif |
| _GL_CXXALIASWARN (getpass); |
| #elif defined GNULIB_POSIXCHECK |
| # undef getpass |
| # if HAVE_RAW_DECL_GETPASS |
| _GL_WARN_ON_USE (getpass, "getpass is unportable - " |
| "use gnulib module getpass or getpass-gnu for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Return the next valid login shell on the system, or NULL when the end of |
| the list has been reached. */ |
| # if !1 |
| _GL_FUNCDECL_SYS (getusershell, char *, (void)); |
| # endif |
| _GL_CXXALIAS_SYS (getusershell, char *, (void)); |
| _GL_CXXALIASWARN (getusershell); |
| #elif defined GNULIB_POSIXCHECK |
| # undef getusershell |
| # if HAVE_RAW_DECL_GETUSERSHELL |
| _GL_WARN_ON_USE (getusershell, "getusershell is unportable - " |
| "use gnulib module getusershell for portability"); |
| # endif |
| #endif |
| |
| #if 0 |
| /* Rewind to pointer that is advanced at each getusershell() call. */ |
| # if !1 |
| _GL_FUNCDECL_SYS (setusershell, void, (void)); |
| # endif |
| _GL_CXXALIAS_SYS (setusershell, void, (void)); |
| _GL_CXXALIASWARN (setusershell); |
| #elif defined GNULIB_POSIXCHECK |
| # undef setusershell |
| # if HAVE_RAW_DECL_SETUSERSHELL |
| _GL_WARN_ON_USE (setusershell, "setusershell is unportable - " |
| "use gnulib module getusershell for portability"); |
| # endif |
| #endif |
| |
| #if 0 |
| /* Free the pointer that is advanced at each getusershell() call and |
| associated resources. */ |
| # if !1 |
| _GL_FUNCDECL_SYS (endusershell, void, (void)); |
| # endif |
| _GL_CXXALIAS_SYS (endusershell, void, (void)); |
| _GL_CXXALIASWARN (endusershell); |
| #elif defined GNULIB_POSIXCHECK |
| # undef endusershell |
| # if HAVE_RAW_DECL_ENDUSERSHELL |
| _GL_WARN_ON_USE (endusershell, "endusershell is unportable - " |
| "use gnulib module getusershell for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Determine whether group id is in calling user's group list. */ |
| # if !1 |
| _GL_FUNCDECL_SYS (group_member, int, (gid_t gid)); |
| # endif |
| _GL_CXXALIAS_SYS (group_member, int, (gid_t gid)); |
| _GL_CXXALIASWARN (group_member); |
| #elif defined GNULIB_POSIXCHECK |
| # undef group_member |
| # if HAVE_RAW_DECL_GROUP_MEMBER |
| _GL_WARN_ON_USE (group_member, "group_member is unportable - " |
| "use gnulib module group-member for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef isatty |
| # define isatty rpl_isatty |
| # endif |
| _GL_FUNCDECL_RPL (isatty, int, (int fd)); |
| _GL_CXXALIAS_RPL (isatty, int, (int fd)); |
| # else |
| _GL_CXXALIAS_SYS (isatty, int, (int fd)); |
| # endif |
| _GL_CXXALIASWARN (isatty); |
| #elif defined GNULIB_POSIXCHECK |
| # undef isatty |
| # if HAVE_RAW_DECL_ISATTY |
| _GL_WARN_ON_USE (isatty, "isatty has portability problems on native Windows - " |
| "use gnulib module isatty for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Change the owner of FILE to UID (if UID is not -1) and the group of FILE |
| to GID (if GID is not -1). Do not follow symbolic links. |
| Return 0 if successful, otherwise -1 and errno set. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/lchown.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef lchown |
| # define lchown rpl_lchown |
| # endif |
| _GL_FUNCDECL_RPL (lchown, int, (char const *file, uid_t owner, gid_t group) |
| _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (lchown, int, (char const *file, uid_t owner, gid_t group)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (lchown, int, (char const *file, uid_t owner, gid_t group) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| _GL_CXXALIAS_SYS (lchown, int, (char const *file, uid_t owner, gid_t group)); |
| # endif |
| _GL_CXXALIASWARN (lchown); |
| #elif defined GNULIB_POSIXCHECK |
| # undef lchown |
| # if HAVE_RAW_DECL_LCHOWN |
| _GL_WARN_ON_USE (lchown, "lchown is unportable to pre-POSIX.1-2001 systems - " |
| "use gnulib module lchown for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Create a new hard link for an existing file. |
| Return 0 if successful, otherwise -1 and errno set. |
| See POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/link.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define link rpl_link |
| # endif |
| _GL_FUNCDECL_RPL (link, int, (const char *path1, const char *path2) |
| _GL_ARG_NONNULL ((1, 2))); |
| _GL_CXXALIAS_RPL (link, int, (const char *path1, const char *path2)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (link, int, (const char *path1, const char *path2) |
| _GL_ARG_NONNULL ((1, 2))); |
| # endif |
| _GL_CXXALIAS_SYS (link, int, (const char *path1, const char *path2)); |
| # endif |
| _GL_CXXALIASWARN (link); |
| #elif defined GNULIB_POSIXCHECK |
| # undef link |
| # if HAVE_RAW_DECL_LINK |
| _GL_WARN_ON_USE (link, "link is unportable - " |
| "use gnulib module link for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Create a new hard link for an existing file, relative to two |
| directories. FLAG controls whether symlinks are followed. |
| Return 0 if successful, otherwise -1 and errno set. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef linkat |
| # define linkat rpl_linkat |
| # endif |
| _GL_FUNCDECL_RPL (linkat, int, |
| (int fd1, const char *path1, int fd2, const char *path2, |
| int flag) |
| _GL_ARG_NONNULL ((2, 4))); |
| _GL_CXXALIAS_RPL (linkat, int, |
| (int fd1, const char *path1, int fd2, const char *path2, |
| int flag)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (linkat, int, |
| (int fd1, const char *path1, int fd2, const char *path2, |
| int flag) |
| _GL_ARG_NONNULL ((2, 4))); |
| # endif |
| _GL_CXXALIAS_SYS (linkat, int, |
| (int fd1, const char *path1, int fd2, const char *path2, |
| int flag)); |
| # endif |
| _GL_CXXALIASWARN (linkat); |
| #elif defined GNULIB_POSIXCHECK |
| # undef linkat |
| # if HAVE_RAW_DECL_LINKAT |
| _GL_WARN_ON_USE (linkat, "linkat is unportable - " |
| "use gnulib module linkat for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Set the offset of FD relative to SEEK_SET, SEEK_CUR, or SEEK_END. |
| Return the new offset if successful, otherwise -1 and errno set. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/lseek.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define lseek rpl_lseek |
| # endif |
| _GL_FUNCDECL_RPL (lseek, off_t, (int fd, off_t offset, int whence)); |
| _GL_CXXALIAS_RPL (lseek, off_t, (int fd, off_t offset, int whence)); |
| # else |
| _GL_CXXALIAS_SYS (lseek, off_t, (int fd, off_t offset, int whence)); |
| # endif |
| _GL_CXXALIASWARN (lseek); |
| #elif defined GNULIB_POSIXCHECK |
| # undef lseek |
| # if HAVE_RAW_DECL_LSEEK |
| _GL_WARN_ON_USE (lseek, "lseek does not fail with ESPIPE on pipes on some " |
| "systems - use gnulib module lseek for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Create a pipe, defaulting to O_BINARY mode. |
| Store the read-end as fd[0] and the write-end as fd[1]. |
| Return 0 upon success, or -1 with errno set upon failure. */ |
| # if !1 |
| _GL_FUNCDECL_SYS (pipe, int, (int fd[2]) _GL_ARG_NONNULL ((1))); |
| # endif |
| _GL_CXXALIAS_SYS (pipe, int, (int fd[2])); |
| _GL_CXXALIASWARN (pipe); |
| #elif defined GNULIB_POSIXCHECK |
| # undef pipe |
| # if HAVE_RAW_DECL_PIPE |
| _GL_WARN_ON_USE (pipe, "pipe is unportable - " |
| "use gnulib module pipe-posix for portability"); |
| # endif |
| #endif |
| |
| |
| #if 1 |
| /* Create a pipe, applying the given flags when opening the read-end of the |
| pipe and the write-end of the pipe. |
| The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>) |
| and O_TEXT, O_BINARY (defined in "binary-io.h"). |
| Store the read-end as fd[0] and the write-end as fd[1]. |
| Return 0 upon success, or -1 with errno set upon failure. |
| See also the Linux man page at |
| <https://www.kernel.org/doc/man-pages/online/pages/man2/pipe2.2.html>. */ |
| # if 1 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define pipe2 rpl_pipe2 |
| # endif |
| _GL_FUNCDECL_RPL (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (pipe2, int, (int fd[2], int flags)); |
| # else |
| _GL_FUNCDECL_SYS (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_SYS (pipe2, int, (int fd[2], int flags)); |
| # endif |
| _GL_CXXALIASWARN (pipe2); |
| #elif defined GNULIB_POSIXCHECK |
| # undef pipe2 |
| # if HAVE_RAW_DECL_PIPE2 |
| _GL_WARN_ON_USE (pipe2, "pipe2 is unportable - " |
| "use gnulib module pipe2 for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Read at most BUFSIZE bytes from FD into BUF, starting at OFFSET. |
| Return the number of bytes placed into BUF if successful, otherwise |
| set errno and return -1. 0 indicates EOF. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/pread.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef pread |
| # define pread rpl_pread |
| # endif |
| _GL_FUNCDECL_RPL (pread, ssize_t, |
| (int fd, void *buf, size_t bufsize, off_t offset) |
| _GL_ARG_NONNULL ((2))); |
| _GL_CXXALIAS_RPL (pread, ssize_t, |
| (int fd, void *buf, size_t bufsize, off_t offset)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (pread, ssize_t, |
| (int fd, void *buf, size_t bufsize, off_t offset) |
| _GL_ARG_NONNULL ((2))); |
| # endif |
| _GL_CXXALIAS_SYS (pread, ssize_t, |
| (int fd, void *buf, size_t bufsize, off_t offset)); |
| # endif |
| _GL_CXXALIASWARN (pread); |
| #elif defined GNULIB_POSIXCHECK |
| # undef pread |
| # if HAVE_RAW_DECL_PREAD |
| _GL_WARN_ON_USE (pread, "pread is unportable - " |
| "use gnulib module pread for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Write at most BUFSIZE bytes from BUF into FD, starting at OFFSET. |
| Return the number of bytes written if successful, otherwise |
| set errno and return -1. 0 indicates nothing written. See the |
| POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/pwrite.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef pwrite |
| # define pwrite rpl_pwrite |
| # endif |
| _GL_FUNCDECL_RPL (pwrite, ssize_t, |
| (int fd, const void *buf, size_t bufsize, off_t offset) |
| _GL_ARG_NONNULL ((2))); |
| _GL_CXXALIAS_RPL (pwrite, ssize_t, |
| (int fd, const void *buf, size_t bufsize, off_t offset)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (pwrite, ssize_t, |
| (int fd, const void *buf, size_t bufsize, off_t offset) |
| _GL_ARG_NONNULL ((2))); |
| # endif |
| _GL_CXXALIAS_SYS (pwrite, ssize_t, |
| (int fd, const void *buf, size_t bufsize, off_t offset)); |
| # endif |
| _GL_CXXALIASWARN (pwrite); |
| #elif defined GNULIB_POSIXCHECK |
| # undef pwrite |
| # if HAVE_RAW_DECL_PWRITE |
| _GL_WARN_ON_USE (pwrite, "pwrite is unportable - " |
| "use gnulib module pwrite for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Read up to COUNT bytes from file descriptor FD into the buffer starting |
| at BUF. See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/read.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef read |
| # define read rpl_read |
| # endif |
| _GL_FUNCDECL_RPL (read, ssize_t, (int fd, void *buf, size_t count) |
| _GL_ARG_NONNULL ((2))); |
| _GL_CXXALIAS_RPL (read, ssize_t, (int fd, void *buf, size_t count)); |
| # else |
| /* Need to cast, because on mingw, the third parameter is |
| unsigned int count |
| and the return type is 'int'. */ |
| _GL_CXXALIAS_SYS_CAST (read, ssize_t, (int fd, void *buf, size_t count)); |
| # endif |
| _GL_CXXALIASWARN (read); |
| #endif |
| |
| |
| #if 1 |
| /* Read the contents of the symbolic link FILE and place the first BUFSIZE |
| bytes of it into BUF. Return the number of bytes placed into BUF if |
| successful, otherwise -1 and errno set. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/readlink.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define readlink rpl_readlink |
| # endif |
| _GL_FUNCDECL_RPL (readlink, ssize_t, |
| (const char *file, char *buf, size_t bufsize) |
| _GL_ARG_NONNULL ((1, 2))); |
| _GL_CXXALIAS_RPL (readlink, ssize_t, |
| (const char *file, char *buf, size_t bufsize)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (readlink, ssize_t, |
| (const char *file, char *buf, size_t bufsize) |
| _GL_ARG_NONNULL ((1, 2))); |
| # endif |
| _GL_CXXALIAS_SYS (readlink, ssize_t, |
| (const char *file, char *buf, size_t bufsize)); |
| # endif |
| _GL_CXXALIASWARN (readlink); |
| #elif defined GNULIB_POSIXCHECK |
| # undef readlink |
| # if HAVE_RAW_DECL_READLINK |
| _GL_WARN_ON_USE (readlink, "readlink is unportable - " |
| "use gnulib module readlink for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define readlinkat rpl_readlinkat |
| # endif |
| _GL_FUNCDECL_RPL (readlinkat, ssize_t, |
| (int fd, char const *file, char *buf, size_t len) |
| _GL_ARG_NONNULL ((2, 3))); |
| _GL_CXXALIAS_RPL (readlinkat, ssize_t, |
| (int fd, char const *file, char *buf, size_t len)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (readlinkat, ssize_t, |
| (int fd, char const *file, char *buf, size_t len) |
| _GL_ARG_NONNULL ((2, 3))); |
| # endif |
| _GL_CXXALIAS_SYS (readlinkat, ssize_t, |
| (int fd, char const *file, char *buf, size_t len)); |
| # endif |
| _GL_CXXALIASWARN (readlinkat); |
| #elif defined GNULIB_POSIXCHECK |
| # undef readlinkat |
| # if HAVE_RAW_DECL_READLINKAT |
| _GL_WARN_ON_USE (readlinkat, "readlinkat is not portable - " |
| "use gnulib module readlinkat for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Remove the directory DIR. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # define rmdir rpl_rmdir |
| # endif |
| _GL_FUNCDECL_RPL (rmdir, int, (char const *name) _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (rmdir, int, (char const *name)); |
| # else |
| _GL_CXXALIAS_SYS (rmdir, int, (char const *name)); |
| # endif |
| _GL_CXXALIASWARN (rmdir); |
| #elif defined GNULIB_POSIXCHECK |
| # undef rmdir |
| # if HAVE_RAW_DECL_RMDIR |
| _GL_WARN_ON_USE (rmdir, "rmdir is unportable - " |
| "use gnulib module rmdir for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Set the host name of the machine. |
| The host name may or may not be fully qualified. |
| |
| Put LEN bytes of NAME into the host name. |
| Return 0 if successful, otherwise, set errno and return -1. |
| |
| Platforms with no ability to set the hostname return -1 and set |
| errno = ENOSYS. */ |
| # if !1 || !1 |
| _GL_FUNCDECL_SYS (sethostname, int, (const char *name, size_t len) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| /* Need to cast, because on Solaris 11 2011-10, Mac OS X 10.5, IRIX 6.5 |
| and FreeBSD 6.4 the second parameter is int. On Solaris 11 |
| 2011-10, the first parameter is not const. */ |
| _GL_CXXALIAS_SYS_CAST (sethostname, int, (const char *name, size_t len)); |
| _GL_CXXALIASWARN (sethostname); |
| #elif defined GNULIB_POSIXCHECK |
| # undef sethostname |
| # if HAVE_RAW_DECL_SETHOSTNAME |
| _GL_WARN_ON_USE (sethostname, "sethostname is unportable - " |
| "use gnulib module sethostname for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Pause the execution of the current thread for N seconds. |
| Returns the number of seconds left to sleep. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/sleep.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef sleep |
| # define sleep rpl_sleep |
| # endif |
| _GL_FUNCDECL_RPL (sleep, unsigned int, (unsigned int n)); |
| _GL_CXXALIAS_RPL (sleep, unsigned int, (unsigned int n)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (sleep, unsigned int, (unsigned int n)); |
| # endif |
| _GL_CXXALIAS_SYS (sleep, unsigned int, (unsigned int n)); |
| # endif |
| _GL_CXXALIASWARN (sleep); |
| #elif defined GNULIB_POSIXCHECK |
| # undef sleep |
| # if HAVE_RAW_DECL_SLEEP |
| _GL_WARN_ON_USE (sleep, "sleep is unportable - " |
| "use gnulib module sleep for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef symlink |
| # define symlink rpl_symlink |
| # endif |
| _GL_FUNCDECL_RPL (symlink, int, (char const *contents, char const *file) |
| _GL_ARG_NONNULL ((1, 2))); |
| _GL_CXXALIAS_RPL (symlink, int, (char const *contents, char const *file)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (symlink, int, (char const *contents, char const *file) |
| _GL_ARG_NONNULL ((1, 2))); |
| # endif |
| _GL_CXXALIAS_SYS (symlink, int, (char const *contents, char const *file)); |
| # endif |
| _GL_CXXALIASWARN (symlink); |
| #elif defined GNULIB_POSIXCHECK |
| # undef symlink |
| # if HAVE_RAW_DECL_SYMLINK |
| _GL_WARN_ON_USE (symlink, "symlink is not portable - " |
| "use gnulib module symlink for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef symlinkat |
| # define symlinkat rpl_symlinkat |
| # endif |
| _GL_FUNCDECL_RPL (symlinkat, int, |
| (char const *contents, int fd, char const *file) |
| _GL_ARG_NONNULL ((1, 3))); |
| _GL_CXXALIAS_RPL (symlinkat, int, |
| (char const *contents, int fd, char const *file)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (symlinkat, int, |
| (char const *contents, int fd, char const *file) |
| _GL_ARG_NONNULL ((1, 3))); |
| # endif |
| _GL_CXXALIAS_SYS (symlinkat, int, |
| (char const *contents, int fd, char const *file)); |
| # endif |
| _GL_CXXALIASWARN (symlinkat); |
| #elif defined GNULIB_POSIXCHECK |
| # undef symlinkat |
| # if HAVE_RAW_DECL_SYMLINKAT |
| _GL_WARN_ON_USE (symlinkat, "symlinkat is not portable - " |
| "use gnulib module symlinkat for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Change the size of the file designated by FILENAME to become equal to LENGTH. |
| Return 0 if successful, otherwise -1 and errno set. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/truncate.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef truncate |
| # define truncate rpl_truncate |
| # endif |
| _GL_FUNCDECL_RPL (truncate, int, (const char *filename, off_t length) |
| _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (truncate, int, (const char *filename, off_t length)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (truncate, int, (const char *filename, off_t length) |
| _GL_ARG_NONNULL ((1))); |
| # endif |
| _GL_CXXALIAS_SYS (truncate, int, (const char *filename, off_t length)); |
| # endif |
| _GL_CXXALIASWARN (truncate); |
| #elif defined GNULIB_POSIXCHECK |
| # undef truncate |
| # if HAVE_RAW_DECL_TRUNCATE |
| _GL_WARN_ON_USE (truncate, "truncate is unportable - " |
| "use gnulib module truncate for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Store at most BUFLEN characters of the pathname of the terminal FD is |
| open on in BUF. Return 0 on success, otherwise an error number. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef ttyname_r |
| # define ttyname_r rpl_ttyname_r |
| # endif |
| _GL_FUNCDECL_RPL (ttyname_r, int, |
| (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2))); |
| _GL_CXXALIAS_RPL (ttyname_r, int, |
| (int fd, char *buf, size_t buflen)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (ttyname_r, int, |
| (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2))); |
| # endif |
| _GL_CXXALIAS_SYS (ttyname_r, int, |
| (int fd, char *buf, size_t buflen)); |
| # endif |
| _GL_CXXALIASWARN (ttyname_r); |
| #elif defined GNULIB_POSIXCHECK |
| # undef ttyname_r |
| # if HAVE_RAW_DECL_TTYNAME_R |
| _GL_WARN_ON_USE (ttyname_r, "ttyname_r is not portable - " |
| "use gnulib module ttyname_r for portability"); |
| # endif |
| #endif |
| |
| |
| #if 1 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef unlink |
| # define unlink rpl_unlink |
| # endif |
| _GL_FUNCDECL_RPL (unlink, int, (char const *file) _GL_ARG_NONNULL ((1))); |
| _GL_CXXALIAS_RPL (unlink, int, (char const *file)); |
| # else |
| _GL_CXXALIAS_SYS (unlink, int, (char const *file)); |
| # endif |
| _GL_CXXALIASWARN (unlink); |
| #elif defined GNULIB_POSIXCHECK |
| # undef unlink |
| # if HAVE_RAW_DECL_UNLINK |
| _GL_WARN_ON_USE (unlink, "unlink is not portable - " |
| "use gnulib module unlink for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef unlinkat |
| # define unlinkat rpl_unlinkat |
| # endif |
| _GL_FUNCDECL_RPL (unlinkat, int, (int fd, char const *file, int flag) |
| _GL_ARG_NONNULL ((2))); |
| _GL_CXXALIAS_RPL (unlinkat, int, (int fd, char const *file, int flag)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (unlinkat, int, (int fd, char const *file, int flag) |
| _GL_ARG_NONNULL ((2))); |
| # endif |
| _GL_CXXALIAS_SYS (unlinkat, int, (int fd, char const *file, int flag)); |
| # endif |
| _GL_CXXALIASWARN (unlinkat); |
| #elif defined GNULIB_POSIXCHECK |
| # undef unlinkat |
| # if HAVE_RAW_DECL_UNLINKAT |
| _GL_WARN_ON_USE (unlinkat, "unlinkat is not portable - " |
| "use gnulib module openat for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Pause the execution of the current thread for N microseconds. |
| Returns 0 on completion, or -1 on range error. |
| See the POSIX:2001 specification |
| <https://pubs.opengroup.org/onlinepubs/009695399/functions/usleep.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef usleep |
| # define usleep rpl_usleep |
| # endif |
| _GL_FUNCDECL_RPL (usleep, int, (useconds_t n)); |
| _GL_CXXALIAS_RPL (usleep, int, (useconds_t n)); |
| # else |
| # if !1 |
| _GL_FUNCDECL_SYS (usleep, int, (useconds_t n)); |
| # endif |
| _GL_CXXALIAS_SYS (usleep, int, (useconds_t n)); |
| # endif |
| _GL_CXXALIASWARN (usleep); |
| #elif defined GNULIB_POSIXCHECK |
| # undef usleep |
| # if HAVE_RAW_DECL_USLEEP |
| _GL_WARN_ON_USE (usleep, "usleep is unportable - " |
| "use gnulib module usleep for portability"); |
| # endif |
| #endif |
| |
| |
| #if 0 |
| /* Write up to COUNT bytes starting at BUF to file descriptor FD. |
| See the POSIX:2008 specification |
| <https://pubs.opengroup.org/onlinepubs/9699919799/functions/write.html>. */ |
| # if 0 |
| # if !(defined __cplusplus && defined GNULIB_NAMESPACE) |
| # undef write |
| # define write rpl_write |
| # endif |
| _GL_FUNCDECL_RPL (write, ssize_t, (int fd, const void *buf, size_t count) |
| _GL_ARG_NONNULL ((2))); |
| _GL_CXXALIAS_RPL (write, ssize_t, (int fd, const void *buf, size_t count)); |
| # else |
| /* Need to cast, because on mingw, the third parameter is |
| unsigned int count |
| and the return type is 'int'. */ |
| _GL_CXXALIAS_SYS_CAST (write, ssize_t, (int fd, const void *buf, size_t count)); |
| # endif |
| _GL_CXXALIASWARN (write); |
| #endif |
| |
| _GL_INLINE_HEADER_END |
| |
| #endif /* _GL_UNISTD_H */ |
| #endif /* _GL_INCLUDING_UNISTD_H */ |
| #endif /* _GL_UNISTD_H */ |
