Update Gnulib to the latest git version
[deliverable/binutils-gdb.git] / gnulib / import / unistd.in.h
CommitLineData
8839a007 1/* Substitute for and wrapper around <unistd.h>.
c0c3707f 2 Copyright (C) 2003-2019 Free Software Foundation, Inc.
8839a007
PA
3
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 3, or (at your option)
7 any later version.
8
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
13
14 You should have received a copy of the GNU General Public License
c0c3707f 15 along with this program; if not, see <https://www.gnu.org/licenses/>. */
8839a007 16
4a626d0a
PA
17#ifndef _@GUARD_PREFIX@_UNISTD_H
18
8839a007
PA
19#if __GNUC__ >= 3
20@PRAGMA_SYSTEM_HEADER@
21#endif
22@PRAGMA_COLUMNS@
23
c0c3707f 24#if @HAVE_UNISTD_H@ && defined _GL_INCLUDING_UNISTD_H
8839a007 25/* Special invocation convention:
4a626d0a
PA
26 - On Mac OS X 10.3.9 we have a sequence of nested includes
27 <unistd.h> -> <signal.h> -> <pthread.h> -> <unistd.h>
28 In this situation, the functions are not yet declared, therefore we cannot
29 provide the C++ aliases. */
8839a007 30
4a626d0a
PA
31#@INCLUDE_NEXT@ @NEXT_UNISTD_H@
32
33#else
34/* Normal invocation convention. */
8839a007
PA
35
36/* The include_next requires a split double-inclusion guard. */
37#if @HAVE_UNISTD_H@
4a626d0a 38# define _GL_INCLUDING_UNISTD_H
8839a007 39# @INCLUDE_NEXT@ @NEXT_UNISTD_H@
4a626d0a 40# undef _GL_INCLUDING_UNISTD_H
8839a007
PA
41#endif
42
43/* Get all possible declarations of gethostname(). */
44#if @GNULIB_GETHOSTNAME@ && @UNISTD_H_HAVE_WINSOCK2_H@ \
45 && !defined _GL_INCLUDING_WINSOCK2_H
46# define _GL_INCLUDING_WINSOCK2_H
47# include <winsock2.h>
48# undef _GL_INCLUDING_WINSOCK2_H
49#endif
50
51#if !defined _@GUARD_PREFIX@_UNISTD_H && !defined _GL_INCLUDING_WINSOCK2_H
52#define _@GUARD_PREFIX@_UNISTD_H
53
54/* NetBSD 5.0 mis-defines NULL. Also get size_t. */
c0c3707f
CB
55/* But avoid namespace pollution on glibc systems. */
56#ifndef __GLIBC__
57# include <stddef.h>
58#endif
8839a007
PA
59
60/* mingw doesn't define the SEEK_* or *_FILENO macros in <unistd.h>. */
c0c3707f
CB
61/* MSVC declares 'unlink' in <stdio.h>, not in <unistd.h>. We must include
62 it before we #define unlink rpl_unlink. */
8839a007
PA
63/* Cygwin 1.7.1 declares symlinkat in <stdio.h>, not in <unistd.h>. */
64/* But avoid namespace pollution on glibc systems. */
65#if (!(defined SEEK_CUR && defined SEEK_END && defined SEEK_SET) \
c0c3707f
CB
66 || ((@GNULIB_UNLINK@ || defined GNULIB_POSIXCHECK) \
67 && (defined _WIN32 && ! defined __CYGWIN__)) \
8839a007
PA
68 || ((@GNULIB_SYMLINKAT@ || defined GNULIB_POSIXCHECK) \
69 && defined __CYGWIN__)) \
70 && ! defined __GLIBC__
71# include <stdio.h>
72#endif
73
c0c3707f
CB
74/* Cygwin 1.7.1 and Android 4.3 declare unlinkat in <fcntl.h>, not in
75 <unistd.h>. */
8839a007 76/* But avoid namespace pollution on glibc systems. */
c0c3707f
CB
77#if (@GNULIB_UNLINKAT@ || defined GNULIB_POSIXCHECK) \
78 && (defined __CYGWIN__ || defined __ANDROID__) \
8839a007
PA
79 && ! defined __GLIBC__
80# include <fcntl.h>
81#endif
82
83/* mingw fails to declare _exit in <unistd.h>. */
84/* mingw, MSVC, BeOS, Haiku declare environ in <stdlib.h>, not in
85 <unistd.h>. */
86/* Solaris declares getcwd not only in <unistd.h> but also in <stdlib.h>. */
4a626d0a
PA
87/* OSF Tru64 Unix cannot see gnulib rpl_strtod when system <stdlib.h> is
88 included here. */
8839a007 89/* But avoid namespace pollution on glibc systems. */
4a626d0a
PA
90#if !defined __GLIBC__ && !defined __osf__
91# define __need_system_stdlib_h
8839a007 92# include <stdlib.h>
4a626d0a 93# undef __need_system_stdlib_h
8839a007
PA
94#endif
95
96/* Native Windows platforms declare chdir, getcwd, rmdir in
97 <io.h> and/or <direct.h>, not in <unistd.h>.
98 They also declare access(), chmod(), close(), dup(), dup2(), isatty(),
99 lseek(), read(), unlink(), write() in <io.h>. */
100#if ((@GNULIB_CHDIR@ || @GNULIB_GETCWD@ || @GNULIB_RMDIR@ \
101 || defined GNULIB_POSIXCHECK) \
c0c3707f 102 && (defined _WIN32 && ! defined __CYGWIN__))
8839a007
PA
103# include <io.h> /* mingw32, mingw64 */
104# include <direct.h> /* mingw64, MSVC 9 */
105#elif (@GNULIB_CLOSE@ || @GNULIB_DUP@ || @GNULIB_DUP2@ || @GNULIB_ISATTY@ \
106 || @GNULIB_LSEEK@ || @GNULIB_READ@ || @GNULIB_UNLINK@ || @GNULIB_WRITE@ \
107 || defined GNULIB_POSIXCHECK) \
c0c3707f 108 && (defined _WIN32 && ! defined __CYGWIN__)
8839a007
PA
109# include <io.h>
110#endif
111
112/* AIX and OSF/1 5.1 declare getdomainname in <netdb.h>, not in <unistd.h>.
113 NonStop Kernel declares gethostname in <netdb.h>, not in <unistd.h>. */
114/* But avoid namespace pollution on glibc systems. */
115#if ((@GNULIB_GETDOMAINNAME@ && (defined _AIX || defined __osf__)) \
116 || (@GNULIB_GETHOSTNAME@ && defined __TANDEM)) \
117 && !defined __GLIBC__
118# include <netdb.h>
119#endif
120
c0c3707f
CB
121/* Android 4.3 declares fchownat in <sys/stat.h>, not in <unistd.h>. */
122/* But avoid namespace pollution on glibc systems. */
123#if (@GNULIB_FCHOWNAT@ || defined GNULIB_POSIXCHECK) && defined __ANDROID__ \
124 && !defined __GLIBC__
125# include <sys/stat.h>
126#endif
127
8839a007
PA
128/* MSVC defines off_t in <sys/types.h>.
129 May also define off_t to a 64-bit type on native Windows. */
c0c3707f
CB
130/* But avoid namespace pollution on glibc systems. */
131#ifndef __GLIBC__
132/* Get off_t, ssize_t. */
8839a007
PA
133# include <sys/types.h>
134#endif
135
c0c3707f
CB
136/* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
137
138/* The definition of _GL_ARG_NONNULL is copied here. */
8839a007 139
c0c3707f
CB
140/* The definition of _GL_WARN_ON_USE is copied here. */
141
142
143/* Get getopt(), optarg, optind, opterr, optopt. */
144#if @GNULIB_UNISTD_H_GETOPT@ && !defined _GL_SYSTEM_GETOPT
145# include <getopt-cdefs.h>
146# include <getopt-pfx-core.h>
8839a007
PA
147#endif
148
4a626d0a
PA
149#ifndef _GL_INLINE_HEADER_BEGIN
150 #error "Please include config.h first."
151#endif
8839a007
PA
152_GL_INLINE_HEADER_BEGIN
153#ifndef _GL_UNISTD_INLINE
154# define _GL_UNISTD_INLINE _GL_INLINE
155#endif
156
8839a007
PA
157/* Hide some function declarations from <winsock2.h>. */
158
159#if @GNULIB_GETHOSTNAME@ && @UNISTD_H_HAVE_WINSOCK2_H@
160# if !defined _@GUARD_PREFIX@_SYS_SOCKET_H
161# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
162# undef socket
163# define socket socket_used_without_including_sys_socket_h
164# undef connect
165# define connect connect_used_without_including_sys_socket_h
166# undef accept
167# define accept accept_used_without_including_sys_socket_h
168# undef bind
169# define bind bind_used_without_including_sys_socket_h
170# undef getpeername
171# define getpeername getpeername_used_without_including_sys_socket_h
172# undef getsockname
173# define getsockname getsockname_used_without_including_sys_socket_h
174# undef getsockopt
175# define getsockopt getsockopt_used_without_including_sys_socket_h
176# undef listen
177# define listen listen_used_without_including_sys_socket_h
178# undef recv
179# define recv recv_used_without_including_sys_socket_h
180# undef send
181# define send send_used_without_including_sys_socket_h
182# undef recvfrom
183# define recvfrom recvfrom_used_without_including_sys_socket_h
184# undef sendto
185# define sendto sendto_used_without_including_sys_socket_h
186# undef setsockopt
187# define setsockopt setsockopt_used_without_including_sys_socket_h
188# undef shutdown
189# define shutdown shutdown_used_without_including_sys_socket_h
190# else
191 _GL_WARN_ON_USE (socket,
192 "socket() used without including <sys/socket.h>");
193 _GL_WARN_ON_USE (connect,
194 "connect() used without including <sys/socket.h>");
195 _GL_WARN_ON_USE (accept,
196 "accept() used without including <sys/socket.h>");
197 _GL_WARN_ON_USE (bind,
198 "bind() used without including <sys/socket.h>");
199 _GL_WARN_ON_USE (getpeername,
200 "getpeername() used without including <sys/socket.h>");
201 _GL_WARN_ON_USE (getsockname,
202 "getsockname() used without including <sys/socket.h>");
203 _GL_WARN_ON_USE (getsockopt,
204 "getsockopt() used without including <sys/socket.h>");
205 _GL_WARN_ON_USE (listen,
206 "listen() used without including <sys/socket.h>");
207 _GL_WARN_ON_USE (recv,
208 "recv() used without including <sys/socket.h>");
209 _GL_WARN_ON_USE (send,
210 "send() used without including <sys/socket.h>");
211 _GL_WARN_ON_USE (recvfrom,
212 "recvfrom() used without including <sys/socket.h>");
213 _GL_WARN_ON_USE (sendto,
214 "sendto() used without including <sys/socket.h>");
215 _GL_WARN_ON_USE (setsockopt,
216 "setsockopt() used without including <sys/socket.h>");
217 _GL_WARN_ON_USE (shutdown,
218 "shutdown() used without including <sys/socket.h>");
219# endif
220# endif
221# if !defined _@GUARD_PREFIX@_SYS_SELECT_H
222# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
223# undef select
224# define select select_used_without_including_sys_select_h
225# else
226 _GL_WARN_ON_USE (select,
227 "select() used without including <sys/select.h>");
228# endif
229# endif
230#endif
231
232
233/* OS/2 EMX lacks these macros. */
234#ifndef STDIN_FILENO
235# define STDIN_FILENO 0
236#endif
237#ifndef STDOUT_FILENO
238# define STDOUT_FILENO 1
239#endif
240#ifndef STDERR_FILENO
241# define STDERR_FILENO 2
242#endif
243
244/* Ensure *_OK macros exist. */
245#ifndef F_OK
246# define F_OK 0
247# define X_OK 1
248# define W_OK 2
249# define R_OK 4
250#endif
251
252
253/* Declare overridden functions. */
254
255
c0c3707f
CB
256#if @GNULIB_ACCESS@
257# if @REPLACE_ACCESS@
258# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
259# undef access
260# define access rpl_access
261# endif
262_GL_FUNCDECL_RPL (access, int, (const char *file, int mode)
263 _GL_ARG_NONNULL ((1)));
264_GL_CXXALIAS_RPL (access, int, (const char *file, int mode));
265# else
266_GL_CXXALIAS_SYS (access, int, (const char *file, int mode));
267# endif
268_GL_CXXALIASWARN (access);
269#elif defined GNULIB_POSIXCHECK
270# undef access
271# if HAVE_RAW_DECL_ACCESS
8839a007 272/* The access() function is a security risk. */
c0c3707f
CB
273_GL_WARN_ON_USE (access, "access does not always support X_OK - "
274 "use gnulib module access for portability; "
275 "also, this function is a security risk - "
8839a007 276 "use the gnulib module faccessat instead");
c0c3707f 277# endif
8839a007
PA
278#endif
279
280
281#if @GNULIB_CHDIR@
282_GL_CXXALIAS_SYS (chdir, int, (const char *file) _GL_ARG_NONNULL ((1)));
283_GL_CXXALIASWARN (chdir);
284#elif defined GNULIB_POSIXCHECK
285# undef chdir
286# if HAVE_RAW_DECL_CHDIR
287_GL_WARN_ON_USE (chown, "chdir is not always in <unistd.h> - "
288 "use gnulib module chdir for portability");
289# endif
290#endif
291
292
293#if @GNULIB_CHOWN@
294/* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
295 to GID (if GID is not -1). Follow symbolic links.
296 Return 0 if successful, otherwise -1 and errno set.
297 See the POSIX:2008 specification
c0c3707f 298 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/chown.html. */
8839a007
PA
299# if @REPLACE_CHOWN@
300# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
301# undef chown
302# define chown rpl_chown
303# endif
304_GL_FUNCDECL_RPL (chown, int, (const char *file, uid_t uid, gid_t gid)
305 _GL_ARG_NONNULL ((1)));
306_GL_CXXALIAS_RPL (chown, int, (const char *file, uid_t uid, gid_t gid));
307# else
308# if !@HAVE_CHOWN@
309_GL_FUNCDECL_SYS (chown, int, (const char *file, uid_t uid, gid_t gid)
310 _GL_ARG_NONNULL ((1)));
311# endif
312_GL_CXXALIAS_SYS (chown, int, (const char *file, uid_t uid, gid_t gid));
313# endif
314_GL_CXXALIASWARN (chown);
315#elif defined GNULIB_POSIXCHECK
316# undef chown
317# if HAVE_RAW_DECL_CHOWN
318_GL_WARN_ON_USE (chown, "chown fails to follow symlinks on some systems and "
319 "doesn't treat a uid or gid of -1 on some systems - "
320 "use gnulib module chown for portability");
321# endif
322#endif
323
324
325#if @GNULIB_CLOSE@
326# if @REPLACE_CLOSE@
327/* Automatically included by modules that need a replacement for close. */
328# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
329# undef close
330# define close rpl_close
331# endif
332_GL_FUNCDECL_RPL (close, int, (int fd));
333_GL_CXXALIAS_RPL (close, int, (int fd));
334# else
335_GL_CXXALIAS_SYS (close, int, (int fd));
336# endif
337_GL_CXXALIASWARN (close);
338#elif @UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS@
339# undef close
340# define close close_used_without_requesting_gnulib_module_close
341#elif defined GNULIB_POSIXCHECK
342# undef close
343/* Assume close is always declared. */
344_GL_WARN_ON_USE (close, "close does not portably work on sockets - "
345 "use gnulib module close for portability");
346#endif
347
348
c0c3707f
CB
349#if @GNULIB_COPY_FILE_RANGE@
350# if !@HAVE_COPY_FILE_RANGE@
351_GL_FUNCDECL_SYS (copy_file_range, ssize_t, (int ifd, off_t *ipos,
352 int ofd, off_t *opos,
353 size_t len, unsigned flags));
354_GL_CXXALIAS_SYS (copy_file_range, ssize_t, (int ifd, off_t *ipos,
355 int ofd, off_t *opos,
356 size_t len, unsigned flags));
357# endif
358_GL_CXXALIASWARN (copy_file_range);
359#elif defined GNULIB_POSIXCHECK
360/* Assume copy_file_range is always declared. */
361_GL_WARN_ON_USE (copy_file_range,
362 "copy_file_range is unportable - "
363 "use gnulib module copy_file_range for portability");
364#endif
365
366
8839a007
PA
367#if @GNULIB_DUP@
368# if @REPLACE_DUP@
369# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
370# define dup rpl_dup
371# endif
372_GL_FUNCDECL_RPL (dup, int, (int oldfd));
373_GL_CXXALIAS_RPL (dup, int, (int oldfd));
374# else
375_GL_CXXALIAS_SYS (dup, int, (int oldfd));
376# endif
377_GL_CXXALIASWARN (dup);
378#elif defined GNULIB_POSIXCHECK
379# undef dup
380# if HAVE_RAW_DECL_DUP
381_GL_WARN_ON_USE (dup, "dup is unportable - "
382 "use gnulib module dup for portability");
383# endif
384#endif
385
386
387#if @GNULIB_DUP2@
388/* Copy the file descriptor OLDFD into file descriptor NEWFD. Do nothing if
389 NEWFD = OLDFD, otherwise close NEWFD first if it is open.
390 Return newfd if successful, otherwise -1 and errno set.
391 See the POSIX:2008 specification
c0c3707f 392 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/dup2.html>. */
8839a007
PA
393# if @REPLACE_DUP2@
394# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
395# define dup2 rpl_dup2
396# endif
397_GL_FUNCDECL_RPL (dup2, int, (int oldfd, int newfd));
398_GL_CXXALIAS_RPL (dup2, int, (int oldfd, int newfd));
399# else
400# if !@HAVE_DUP2@
401_GL_FUNCDECL_SYS (dup2, int, (int oldfd, int newfd));
402# endif
403_GL_CXXALIAS_SYS (dup2, int, (int oldfd, int newfd));
404# endif
405_GL_CXXALIASWARN (dup2);
406#elif defined GNULIB_POSIXCHECK
407# undef dup2
408# if HAVE_RAW_DECL_DUP2
409_GL_WARN_ON_USE (dup2, "dup2 is unportable - "
410 "use gnulib module dup2 for portability");
411# endif
412#endif
413
414
415#if @GNULIB_DUP3@
416/* Copy the file descriptor OLDFD into file descriptor NEWFD, with the
417 specified flags.
418 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
419 and O_TEXT, O_BINARY (defined in "binary-io.h").
420 Close NEWFD first if it is open.
421 Return newfd if successful, otherwise -1 and errno set.
422 See the Linux man page at
c0c3707f 423 <https://www.kernel.org/doc/man-pages/online/pages/man2/dup3.2.html>. */
8839a007
PA
424# if @HAVE_DUP3@
425# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
426# define dup3 rpl_dup3
427# endif
428_GL_FUNCDECL_RPL (dup3, int, (int oldfd, int newfd, int flags));
429_GL_CXXALIAS_RPL (dup3, int, (int oldfd, int newfd, int flags));
430# else
431_GL_FUNCDECL_SYS (dup3, int, (int oldfd, int newfd, int flags));
432_GL_CXXALIAS_SYS (dup3, int, (int oldfd, int newfd, int flags));
433# endif
434_GL_CXXALIASWARN (dup3);
435#elif defined GNULIB_POSIXCHECK
436# undef dup3
437# if HAVE_RAW_DECL_DUP3
438_GL_WARN_ON_USE (dup3, "dup3 is unportable - "
439 "use gnulib module dup3 for portability");
440# endif
441#endif
442
443
444#if @GNULIB_ENVIRON@
c0c3707f
CB
445# if defined __CYGWIN__ && !defined __i386__
446/* The 'environ' variable is defined in a DLL. Therefore its declaration needs
447 the '__declspec(dllimport)' attribute, but the system's <unistd.h> lacks it.
448 This leads to a link error on 64-bit Cygwin when the option
449 -Wl,--disable-auto-import is in use. */
450_GL_EXTERN_C __declspec(dllimport) char **environ;
451# endif
8839a007
PA
452# if !@HAVE_DECL_ENVIRON@
453/* Set of environment variables and values. An array of strings of the form
454 "VARIABLE=VALUE", terminated with a NULL. */
455# if defined __APPLE__ && defined __MACH__
4a626d0a
PA
456# include <TargetConditionals.h>
457# if !TARGET_OS_IPHONE && !TARGET_IPHONE_SIMULATOR
458# define _GL_USE_CRT_EXTERNS
459# endif
460# endif
461# ifdef _GL_USE_CRT_EXTERNS
8839a007
PA
462# include <crt_externs.h>
463# define environ (*_NSGetEnviron ())
464# else
465# ifdef __cplusplus
466extern "C" {
467# endif
468extern char **environ;
469# ifdef __cplusplus
470}
471# endif
472# endif
473# endif
474#elif defined GNULIB_POSIXCHECK
475# if HAVE_RAW_DECL_ENVIRON
476_GL_UNISTD_INLINE char ***
c0c3707f
CB
477_GL_WARN_ON_USE_ATTRIBUTE ("environ is unportable - "
478 "use gnulib module environ for portability")
8839a007
PA
479rpl_environ (void)
480{
481 return &environ;
482}
8839a007
PA
483# undef environ
484# define environ (*rpl_environ ())
485# endif
486#endif
487
488
489#if @GNULIB_EUIDACCESS@
490/* Like access(), except that it uses the effective user id and group id of
491 the current process. */
492# if !@HAVE_EUIDACCESS@
493_GL_FUNCDECL_SYS (euidaccess, int, (const char *filename, int mode)
494 _GL_ARG_NONNULL ((1)));
495# endif
496_GL_CXXALIAS_SYS (euidaccess, int, (const char *filename, int mode));
497_GL_CXXALIASWARN (euidaccess);
498# if defined GNULIB_POSIXCHECK
499/* Like access(), this function is a security risk. */
500_GL_WARN_ON_USE (euidaccess, "the euidaccess function is a security risk - "
501 "use the gnulib module faccessat instead");
502# endif
503#elif defined GNULIB_POSIXCHECK
504# undef euidaccess
505# if HAVE_RAW_DECL_EUIDACCESS
506_GL_WARN_ON_USE (euidaccess, "euidaccess is unportable - "
507 "use gnulib module euidaccess for portability");
508# endif
509#endif
510
511
512#if @GNULIB_FACCESSAT@
c0c3707f
CB
513# if @REPLACE_FACCESSAT@
514# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
515# undef faccessat
516# define faccessat rpl_faccessat
517# endif
518_GL_FUNCDECL_RPL (faccessat, int,
519 (int fd, char const *name, int mode, int flag)
520 _GL_ARG_NONNULL ((2)));
521_GL_CXXALIAS_RPL (faccessat, int,
522 (int fd, char const *name, int mode, int flag));
523# else
524# if !@HAVE_FACCESSAT@
8839a007
PA
525_GL_FUNCDECL_SYS (faccessat, int,
526 (int fd, char const *file, int mode, int flag)
527 _GL_ARG_NONNULL ((2)));
c0c3707f 528# endif
8839a007
PA
529_GL_CXXALIAS_SYS (faccessat, int,
530 (int fd, char const *file, int mode, int flag));
c0c3707f 531# endif
8839a007
PA
532_GL_CXXALIASWARN (faccessat);
533#elif defined GNULIB_POSIXCHECK
534# undef faccessat
535# if HAVE_RAW_DECL_FACCESSAT
536_GL_WARN_ON_USE (faccessat, "faccessat is not portable - "
537 "use gnulib module faccessat for portability");
538# endif
539#endif
540
541
542#if @GNULIB_FCHDIR@
543/* Change the process' current working directory to the directory on which
544 the given file descriptor is open.
545 Return 0 if successful, otherwise -1 and errno set.
546 See the POSIX:2008 specification
c0c3707f 547 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fchdir.html>. */
8839a007
PA
548# if ! @HAVE_FCHDIR@
549_GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/));
550
551/* Gnulib internal hooks needed to maintain the fchdir metadata. */
552_GL_EXTERN_C int _gl_register_fd (int fd, const char *filename)
553 _GL_ARG_NONNULL ((2));
554_GL_EXTERN_C void _gl_unregister_fd (int fd);
555_GL_EXTERN_C int _gl_register_dup (int oldfd, int newfd);
556_GL_EXTERN_C const char *_gl_directory_name (int fd);
557
558# else
559# if !@HAVE_DECL_FCHDIR@
560_GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/));
561# endif
562# endif
563_GL_CXXALIAS_SYS (fchdir, int, (int /*fd*/));
564_GL_CXXALIASWARN (fchdir);
565#elif defined GNULIB_POSIXCHECK
566# undef fchdir
567# if HAVE_RAW_DECL_FCHDIR
568_GL_WARN_ON_USE (fchdir, "fchdir is unportable - "
569 "use gnulib module fchdir for portability");
570# endif
571#endif
572
573
574#if @GNULIB_FCHOWNAT@
575# if @REPLACE_FCHOWNAT@
576# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
577# undef fchownat
578# define fchownat rpl_fchownat
579# endif
580_GL_FUNCDECL_RPL (fchownat, int, (int fd, char const *file,
581 uid_t owner, gid_t group, int flag)
582 _GL_ARG_NONNULL ((2)));
583_GL_CXXALIAS_RPL (fchownat, int, (int fd, char const *file,
584 uid_t owner, gid_t group, int flag));
585# else
586# if !@HAVE_FCHOWNAT@
587_GL_FUNCDECL_SYS (fchownat, int, (int fd, char const *file,
588 uid_t owner, gid_t group, int flag)
589 _GL_ARG_NONNULL ((2)));
590# endif
591_GL_CXXALIAS_SYS (fchownat, int, (int fd, char const *file,
592 uid_t owner, gid_t group, int flag));
593# endif
594_GL_CXXALIASWARN (fchownat);
595#elif defined GNULIB_POSIXCHECK
596# undef fchownat
597# if HAVE_RAW_DECL_FCHOWNAT
598_GL_WARN_ON_USE (fchownat, "fchownat is not portable - "
599 "use gnulib module openat for portability");
600# endif
601#endif
602
603
604#if @GNULIB_FDATASYNC@
605/* Synchronize changes to a file.
606 Return 0 if successful, otherwise -1 and errno set.
607 See POSIX:2008 specification
c0c3707f 608 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fdatasync.html>. */
8839a007
PA
609# if !@HAVE_FDATASYNC@ || !@HAVE_DECL_FDATASYNC@
610_GL_FUNCDECL_SYS (fdatasync, int, (int fd));
611# endif
612_GL_CXXALIAS_SYS (fdatasync, int, (int fd));
613_GL_CXXALIASWARN (fdatasync);
614#elif defined GNULIB_POSIXCHECK
615# undef fdatasync
616# if HAVE_RAW_DECL_FDATASYNC
617_GL_WARN_ON_USE (fdatasync, "fdatasync is unportable - "
618 "use gnulib module fdatasync for portability");
619# endif
620#endif
621
622
623#if @GNULIB_FSYNC@
624/* Synchronize changes, including metadata, to a file.
625 Return 0 if successful, otherwise -1 and errno set.
626 See POSIX:2008 specification
c0c3707f 627 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fsync.html>. */
8839a007
PA
628# if !@HAVE_FSYNC@
629_GL_FUNCDECL_SYS (fsync, int, (int fd));
630# endif
631_GL_CXXALIAS_SYS (fsync, int, (int fd));
632_GL_CXXALIASWARN (fsync);
633#elif defined GNULIB_POSIXCHECK
634# undef fsync
635# if HAVE_RAW_DECL_FSYNC
636_GL_WARN_ON_USE (fsync, "fsync is unportable - "
637 "use gnulib module fsync for portability");
638# endif
639#endif
640
641
642#if @GNULIB_FTRUNCATE@
643/* Change the size of the file to which FD is opened to become equal to LENGTH.
644 Return 0 if successful, otherwise -1 and errno set.
645 See the POSIX:2008 specification
c0c3707f 646 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/ftruncate.html>. */
8839a007
PA
647# if @REPLACE_FTRUNCATE@
648# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
649# undef ftruncate
650# define ftruncate rpl_ftruncate
651# endif
652_GL_FUNCDECL_RPL (ftruncate, int, (int fd, off_t length));
653_GL_CXXALIAS_RPL (ftruncate, int, (int fd, off_t length));
654# else
655# if !@HAVE_FTRUNCATE@
656_GL_FUNCDECL_SYS (ftruncate, int, (int fd, off_t length));
657# endif
658_GL_CXXALIAS_SYS (ftruncate, int, (int fd, off_t length));
659# endif
660_GL_CXXALIASWARN (ftruncate);
661#elif defined GNULIB_POSIXCHECK
662# undef ftruncate
663# if HAVE_RAW_DECL_FTRUNCATE
664_GL_WARN_ON_USE (ftruncate, "ftruncate is unportable - "
665 "use gnulib module ftruncate for portability");
666# endif
667#endif
668
669
670#if @GNULIB_GETCWD@
671/* Get the name of the current working directory, and put it in SIZE bytes
672 of BUF.
673 Return BUF if successful, or NULL if the directory couldn't be determined
674 or SIZE was too small.
675 See the POSIX:2008 specification
c0c3707f 676 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getcwd.html>.
8839a007
PA
677 Additionally, the gnulib module 'getcwd' guarantees the following GNU
678 extension: If BUF is NULL, an array is allocated with 'malloc'; the array
679 is SIZE bytes long, unless SIZE == 0, in which case it is as big as
680 necessary. */
681# if @REPLACE_GETCWD@
682# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
683# define getcwd rpl_getcwd
684# endif
685_GL_FUNCDECL_RPL (getcwd, char *, (char *buf, size_t size));
686_GL_CXXALIAS_RPL (getcwd, char *, (char *buf, size_t size));
687# else
688/* Need to cast, because on mingw, the second parameter is
689 int size. */
690_GL_CXXALIAS_SYS_CAST (getcwd, char *, (char *buf, size_t size));
691# endif
692_GL_CXXALIASWARN (getcwd);
693#elif defined GNULIB_POSIXCHECK
694# undef getcwd
695# if HAVE_RAW_DECL_GETCWD
696_GL_WARN_ON_USE (getcwd, "getcwd is unportable - "
697 "use gnulib module getcwd for portability");
698# endif
699#endif
700
701
702#if @GNULIB_GETDOMAINNAME@
703/* Return the NIS domain name of the machine.
704 WARNING! The NIS domain name is unrelated to the fully qualified host name
705 of the machine. It is also unrelated to email addresses.
706 WARNING! The NIS domain name is usually the empty string or "(none)" when
707 not using NIS.
708
709 Put up to LEN bytes of the NIS domain name into NAME.
710 Null terminate it if the name is shorter than LEN.
711 If the NIS domain name is longer than LEN, set errno = EINVAL and return -1.
712 Return 0 if successful, otherwise set errno and return -1. */
713# if @REPLACE_GETDOMAINNAME@
714# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
715# undef getdomainname
716# define getdomainname rpl_getdomainname
717# endif
718_GL_FUNCDECL_RPL (getdomainname, int, (char *name, size_t len)
719 _GL_ARG_NONNULL ((1)));
720_GL_CXXALIAS_RPL (getdomainname, int, (char *name, size_t len));
721# else
722# if !@HAVE_DECL_GETDOMAINNAME@
723_GL_FUNCDECL_SYS (getdomainname, int, (char *name, size_t len)
724 _GL_ARG_NONNULL ((1)));
725# endif
726_GL_CXXALIAS_SYS (getdomainname, int, (char *name, size_t len));
727# endif
728_GL_CXXALIASWARN (getdomainname);
729#elif defined GNULIB_POSIXCHECK
730# undef getdomainname
731# if HAVE_RAW_DECL_GETDOMAINNAME
732_GL_WARN_ON_USE (getdomainname, "getdomainname is unportable - "
733 "use gnulib module getdomainname for portability");
734# endif
735#endif
736
737
738#if @GNULIB_GETDTABLESIZE@
739/* Return the maximum number of file descriptors in the current process.
740 In POSIX, this is same as sysconf (_SC_OPEN_MAX). */
4a626d0a
PA
741# if @REPLACE_GETDTABLESIZE@
742# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
743# undef getdtablesize
744# define getdtablesize rpl_getdtablesize
745# endif
746_GL_FUNCDECL_RPL (getdtablesize, int, (void));
747_GL_CXXALIAS_RPL (getdtablesize, int, (void));
748# else
749# if !@HAVE_GETDTABLESIZE@
8839a007 750_GL_FUNCDECL_SYS (getdtablesize, int, (void));
4a626d0a 751# endif
c0c3707f
CB
752/* Need to cast, because on AIX, the parameter list is
753 (...). */
754_GL_CXXALIAS_SYS_CAST (getdtablesize, int, (void));
4a626d0a 755# endif
8839a007
PA
756_GL_CXXALIASWARN (getdtablesize);
757#elif defined GNULIB_POSIXCHECK
758# undef getdtablesize
759# if HAVE_RAW_DECL_GETDTABLESIZE
760_GL_WARN_ON_USE (getdtablesize, "getdtablesize is unportable - "
761 "use gnulib module getdtablesize for portability");
762# endif
763#endif
764
765
766#if @GNULIB_GETGROUPS@
767/* Return the supplemental groups that the current process belongs to.
768 It is unspecified whether the effective group id is in the list.
769 If N is 0, return the group count; otherwise, N describes how many
770 entries are available in GROUPS. Return -1 and set errno if N is
771 not 0 and not large enough. Fails with ENOSYS on some systems. */
772# if @REPLACE_GETGROUPS@
773# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
774# undef getgroups
775# define getgroups rpl_getgroups
776# endif
777_GL_FUNCDECL_RPL (getgroups, int, (int n, gid_t *groups));
778_GL_CXXALIAS_RPL (getgroups, int, (int n, gid_t *groups));
779# else
780# if !@HAVE_GETGROUPS@
781_GL_FUNCDECL_SYS (getgroups, int, (int n, gid_t *groups));
782# endif
783_GL_CXXALIAS_SYS (getgroups, int, (int n, gid_t *groups));
784# endif
785_GL_CXXALIASWARN (getgroups);
786#elif defined GNULIB_POSIXCHECK
787# undef getgroups
788# if HAVE_RAW_DECL_GETGROUPS
789_GL_WARN_ON_USE (getgroups, "getgroups is unportable - "
790 "use gnulib module getgroups for portability");
791# endif
792#endif
793
794
795#if @GNULIB_GETHOSTNAME@
796/* Return the standard host name of the machine.
797 WARNING! The host name may or may not be fully qualified.
798
799 Put up to LEN bytes of the host name into NAME.
800 Null terminate it if the name is shorter than LEN.
801 If the host name is longer than LEN, set errno = EINVAL and return -1.
802 Return 0 if successful, otherwise set errno and return -1. */
803# if @UNISTD_H_HAVE_WINSOCK2_H@
804# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
805# undef gethostname
806# define gethostname rpl_gethostname
807# endif
808_GL_FUNCDECL_RPL (gethostname, int, (char *name, size_t len)
809 _GL_ARG_NONNULL ((1)));
810_GL_CXXALIAS_RPL (gethostname, int, (char *name, size_t len));
811# else
812# if !@HAVE_GETHOSTNAME@
813_GL_FUNCDECL_SYS (gethostname, int, (char *name, size_t len)
814 _GL_ARG_NONNULL ((1)));
815# endif
816/* Need to cast, because on Solaris 10 and OSF/1 5.1 systems, the second
817 parameter is
818 int len. */
819_GL_CXXALIAS_SYS_CAST (gethostname, int, (char *name, size_t len));
820# endif
821_GL_CXXALIASWARN (gethostname);
822#elif @UNISTD_H_HAVE_WINSOCK2_H@
823# undef gethostname
824# define gethostname gethostname_used_without_requesting_gnulib_module_gethostname
825#elif defined GNULIB_POSIXCHECK
826# undef gethostname
827# if HAVE_RAW_DECL_GETHOSTNAME
828_GL_WARN_ON_USE (gethostname, "gethostname is unportable - "
829 "use gnulib module gethostname for portability");
830# endif
831#endif
832
833
834#if @GNULIB_GETLOGIN@
835/* Returns the user's login name, or NULL if it cannot be found. Upon error,
836 returns NULL with errno set.
837
c0c3707f 838 See <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getlogin.html>.
8839a007
PA
839
840 Most programs don't need to use this function, because the information is
841 available through environment variables:
842 ${LOGNAME-$USER} on Unix platforms,
843 $USERNAME on native Windows platforms.
844 */
c0c3707f 845# if !@HAVE_DECL_GETLOGIN@
8839a007
PA
846_GL_FUNCDECL_SYS (getlogin, char *, (void));
847# endif
848_GL_CXXALIAS_SYS (getlogin, char *, (void));
849_GL_CXXALIASWARN (getlogin);
850#elif defined GNULIB_POSIXCHECK
851# undef getlogin
852# if HAVE_RAW_DECL_GETLOGIN
853_GL_WARN_ON_USE (getlogin, "getlogin is unportable - "
854 "use gnulib module getlogin for portability");
855# endif
856#endif
857
858
859#if @GNULIB_GETLOGIN_R@
860/* Copies the user's login name to NAME.
861 The array pointed to by NAME has room for SIZE bytes.
862
863 Returns 0 if successful. Upon error, an error number is returned, or -1 in
864 the case that the login name cannot be found but no specific error is
865 provided (this case is hopefully rare but is left open by the POSIX spec).
866
c0c3707f 867 See <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getlogin.html>.
8839a007
PA
868
869 Most programs don't need to use this function, because the information is
870 available through environment variables:
871 ${LOGNAME-$USER} on Unix platforms,
872 $USERNAME on native Windows platforms.
873 */
874# if @REPLACE_GETLOGIN_R@
875# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
876# define getlogin_r rpl_getlogin_r
877# endif
878_GL_FUNCDECL_RPL (getlogin_r, int, (char *name, size_t size)
879 _GL_ARG_NONNULL ((1)));
880_GL_CXXALIAS_RPL (getlogin_r, int, (char *name, size_t size));
881# else
882# if !@HAVE_DECL_GETLOGIN_R@
883_GL_FUNCDECL_SYS (getlogin_r, int, (char *name, size_t size)
884 _GL_ARG_NONNULL ((1)));
885# endif
886/* Need to cast, because on Solaris 10 systems, the second argument is
887 int size. */
888_GL_CXXALIAS_SYS_CAST (getlogin_r, int, (char *name, size_t size));
889# endif
890_GL_CXXALIASWARN (getlogin_r);
891#elif defined GNULIB_POSIXCHECK
892# undef getlogin_r
893# if HAVE_RAW_DECL_GETLOGIN_R
894_GL_WARN_ON_USE (getlogin_r, "getlogin_r is unportable - "
895 "use gnulib module getlogin_r for portability");
896# endif
897#endif
898
899
900#if @GNULIB_GETPAGESIZE@
901# if @REPLACE_GETPAGESIZE@
902# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
903# define getpagesize rpl_getpagesize
904# endif
905_GL_FUNCDECL_RPL (getpagesize, int, (void));
906_GL_CXXALIAS_RPL (getpagesize, int, (void));
907# else
c0c3707f
CB
908/* On HP-UX, getpagesize exists, but it is not declared in <unistd.h> even if
909 the compiler options -D_HPUX_SOURCE -D_XOPEN_SOURCE=600 are used. */
910# if defined __hpux
911_GL_FUNCDECL_SYS (getpagesize, int, (void));
912# endif
8839a007
PA
913# if !@HAVE_GETPAGESIZE@
914# if !defined getpagesize
915/* This is for POSIX systems. */
916# if !defined _gl_getpagesize && defined _SC_PAGESIZE
917# if ! (defined __VMS && __VMS_VER < 70000000)
918# define _gl_getpagesize() sysconf (_SC_PAGESIZE)
919# endif
920# endif
921/* This is for older VMS. */
922# if !defined _gl_getpagesize && defined __VMS
923# ifdef __ALPHA
924# define _gl_getpagesize() 8192
925# else
926# define _gl_getpagesize() 512
927# endif
928# endif
929/* This is for BeOS. */
930# if !defined _gl_getpagesize && @HAVE_OS_H@
931# include <OS.h>
932# if defined B_PAGE_SIZE
933# define _gl_getpagesize() B_PAGE_SIZE
934# endif
935# endif
936/* This is for AmigaOS4.0. */
937# if !defined _gl_getpagesize && defined __amigaos4__
938# define _gl_getpagesize() 2048
939# endif
940/* This is for older Unix systems. */
941# if !defined _gl_getpagesize && @HAVE_SYS_PARAM_H@
942# include <sys/param.h>
943# ifdef EXEC_PAGESIZE
944# define _gl_getpagesize() EXEC_PAGESIZE
945# else
946# ifdef NBPG
947# ifndef CLSIZE
948# define CLSIZE 1
949# endif
950# define _gl_getpagesize() (NBPG * CLSIZE)
951# else
952# ifdef NBPC
953# define _gl_getpagesize() NBPC
954# endif
955# endif
956# endif
957# endif
958# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
959# define getpagesize() _gl_getpagesize ()
960# else
961# if !GNULIB_defined_getpagesize_function
962_GL_UNISTD_INLINE int
963getpagesize ()
964{
965 return _gl_getpagesize ();
966}
967# define GNULIB_defined_getpagesize_function 1
968# endif
969# endif
970# endif
971# endif
972/* Need to cast, because on Cygwin 1.5.x systems, the return type is size_t. */
973_GL_CXXALIAS_SYS_CAST (getpagesize, int, (void));
974# endif
975# if @HAVE_DECL_GETPAGESIZE@
976_GL_CXXALIASWARN (getpagesize);
977# endif
978#elif defined GNULIB_POSIXCHECK
979# undef getpagesize
980# if HAVE_RAW_DECL_GETPAGESIZE
981_GL_WARN_ON_USE (getpagesize, "getpagesize is unportable - "
982 "use gnulib module getpagesize for portability");
983# endif
984#endif
985
986
c0c3707f
CB
987#if @GNULIB_GETPASS@
988/* Function getpass() from module 'getpass':
989 Read a password from /dev/tty or stdin.
990 Function getpass() from module 'getpass-gnu':
991 Read a password of arbitrary length from /dev/tty or stdin. */
992# if @REPLACE_GETPASS@
993# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
994# undef getpass
995# define getpass rpl_getpass
996# endif
997_GL_FUNCDECL_RPL (getpass, char *, (const char *prompt)
998 _GL_ARG_NONNULL ((1)));
999_GL_CXXALIAS_RPL (getpass, char *, (const char *prompt));
1000# else
1001# if !@HAVE_GETPASS@
1002_GL_FUNCDECL_SYS (getpass, char *, (const char *prompt)
1003 _GL_ARG_NONNULL ((1)));
1004# endif
1005_GL_CXXALIAS_SYS (getpass, char *, (const char *prompt));
1006# endif
1007_GL_CXXALIASWARN (getpass);
1008#elif defined GNULIB_POSIXCHECK
1009# undef getpass
1010# if HAVE_RAW_DECL_GETPASS
1011_GL_WARN_ON_USE (getpass, "getpass is unportable - "
1012 "use gnulib module getpass or getpass-gnu for portability");
1013# endif
1014#endif
1015
1016
8839a007
PA
1017#if @GNULIB_GETUSERSHELL@
1018/* Return the next valid login shell on the system, or NULL when the end of
1019 the list has been reached. */
1020# if !@HAVE_DECL_GETUSERSHELL@
1021_GL_FUNCDECL_SYS (getusershell, char *, (void));
1022# endif
1023_GL_CXXALIAS_SYS (getusershell, char *, (void));
1024_GL_CXXALIASWARN (getusershell);
1025#elif defined GNULIB_POSIXCHECK
1026# undef getusershell
1027# if HAVE_RAW_DECL_GETUSERSHELL
1028_GL_WARN_ON_USE (getusershell, "getusershell is unportable - "
1029 "use gnulib module getusershell for portability");
1030# endif
1031#endif
1032
1033#if @GNULIB_GETUSERSHELL@
1034/* Rewind to pointer that is advanced at each getusershell() call. */
1035# if !@HAVE_DECL_GETUSERSHELL@
1036_GL_FUNCDECL_SYS (setusershell, void, (void));
1037# endif
1038_GL_CXXALIAS_SYS (setusershell, void, (void));
1039_GL_CXXALIASWARN (setusershell);
1040#elif defined GNULIB_POSIXCHECK
1041# undef setusershell
1042# if HAVE_RAW_DECL_SETUSERSHELL
1043_GL_WARN_ON_USE (setusershell, "setusershell is unportable - "
1044 "use gnulib module getusershell for portability");
1045# endif
1046#endif
1047
1048#if @GNULIB_GETUSERSHELL@
1049/* Free the pointer that is advanced at each getusershell() call and
1050 associated resources. */
1051# if !@HAVE_DECL_GETUSERSHELL@
1052_GL_FUNCDECL_SYS (endusershell, void, (void));
1053# endif
1054_GL_CXXALIAS_SYS (endusershell, void, (void));
1055_GL_CXXALIASWARN (endusershell);
1056#elif defined GNULIB_POSIXCHECK
1057# undef endusershell
1058# if HAVE_RAW_DECL_ENDUSERSHELL
1059_GL_WARN_ON_USE (endusershell, "endusershell is unportable - "
1060 "use gnulib module getusershell for portability");
1061# endif
1062#endif
1063
1064
1065#if @GNULIB_GROUP_MEMBER@
1066/* Determine whether group id is in calling user's group list. */
1067# if !@HAVE_GROUP_MEMBER@
1068_GL_FUNCDECL_SYS (group_member, int, (gid_t gid));
1069# endif
1070_GL_CXXALIAS_SYS (group_member, int, (gid_t gid));
1071_GL_CXXALIASWARN (group_member);
1072#elif defined GNULIB_POSIXCHECK
1073# undef group_member
1074# if HAVE_RAW_DECL_GROUP_MEMBER
1075_GL_WARN_ON_USE (group_member, "group_member is unportable - "
1076 "use gnulib module group-member for portability");
1077# endif
1078#endif
1079
1080
1081#if @GNULIB_ISATTY@
1082# if @REPLACE_ISATTY@
1083# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1084# undef isatty
1085# define isatty rpl_isatty
1086# endif
1087_GL_FUNCDECL_RPL (isatty, int, (int fd));
1088_GL_CXXALIAS_RPL (isatty, int, (int fd));
1089# else
1090_GL_CXXALIAS_SYS (isatty, int, (int fd));
1091# endif
1092_GL_CXXALIASWARN (isatty);
1093#elif defined GNULIB_POSIXCHECK
1094# undef isatty
1095# if HAVE_RAW_DECL_ISATTY
1096_GL_WARN_ON_USE (isatty, "isatty has portability problems on native Windows - "
1097 "use gnulib module isatty for portability");
1098# endif
1099#endif
1100
1101
1102#if @GNULIB_LCHOWN@
1103/* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
1104 to GID (if GID is not -1). Do not follow symbolic links.
1105 Return 0 if successful, otherwise -1 and errno set.
1106 See the POSIX:2008 specification
c0c3707f 1107 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/lchown.html>. */
8839a007
PA
1108# if @REPLACE_LCHOWN@
1109# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1110# undef lchown
1111# define lchown rpl_lchown
1112# endif
1113_GL_FUNCDECL_RPL (lchown, int, (char const *file, uid_t owner, gid_t group)
1114 _GL_ARG_NONNULL ((1)));
1115_GL_CXXALIAS_RPL (lchown, int, (char const *file, uid_t owner, gid_t group));
1116# else
1117# if !@HAVE_LCHOWN@
1118_GL_FUNCDECL_SYS (lchown, int, (char const *file, uid_t owner, gid_t group)
1119 _GL_ARG_NONNULL ((1)));
1120# endif
1121_GL_CXXALIAS_SYS (lchown, int, (char const *file, uid_t owner, gid_t group));
1122# endif
1123_GL_CXXALIASWARN (lchown);
1124#elif defined GNULIB_POSIXCHECK
1125# undef lchown
1126# if HAVE_RAW_DECL_LCHOWN
1127_GL_WARN_ON_USE (lchown, "lchown is unportable to pre-POSIX.1-2001 systems - "
1128 "use gnulib module lchown for portability");
1129# endif
1130#endif
1131
1132
1133#if @GNULIB_LINK@
1134/* Create a new hard link for an existing file.
1135 Return 0 if successful, otherwise -1 and errno set.
1136 See POSIX:2008 specification
c0c3707f 1137 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/link.html>. */
8839a007
PA
1138# if @REPLACE_LINK@
1139# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1140# define link rpl_link
1141# endif
1142_GL_FUNCDECL_RPL (link, int, (const char *path1, const char *path2)
1143 _GL_ARG_NONNULL ((1, 2)));
1144_GL_CXXALIAS_RPL (link, int, (const char *path1, const char *path2));
1145# else
1146# if !@HAVE_LINK@
1147_GL_FUNCDECL_SYS (link, int, (const char *path1, const char *path2)
1148 _GL_ARG_NONNULL ((1, 2)));
1149# endif
1150_GL_CXXALIAS_SYS (link, int, (const char *path1, const char *path2));
1151# endif
1152_GL_CXXALIASWARN (link);
1153#elif defined GNULIB_POSIXCHECK
1154# undef link
1155# if HAVE_RAW_DECL_LINK
1156_GL_WARN_ON_USE (link, "link is unportable - "
1157 "use gnulib module link for portability");
1158# endif
1159#endif
1160
1161
1162#if @GNULIB_LINKAT@
1163/* Create a new hard link for an existing file, relative to two
1164 directories. FLAG controls whether symlinks are followed.
1165 Return 0 if successful, otherwise -1 and errno set. */
1166# if @REPLACE_LINKAT@
1167# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1168# undef linkat
1169# define linkat rpl_linkat
1170# endif
1171_GL_FUNCDECL_RPL (linkat, int,
1172 (int fd1, const char *path1, int fd2, const char *path2,
1173 int flag)
1174 _GL_ARG_NONNULL ((2, 4)));
1175_GL_CXXALIAS_RPL (linkat, int,
1176 (int fd1, const char *path1, int fd2, const char *path2,
1177 int flag));
1178# else
1179# if !@HAVE_LINKAT@
1180_GL_FUNCDECL_SYS (linkat, int,
1181 (int fd1, const char *path1, int fd2, const char *path2,
1182 int flag)
1183 _GL_ARG_NONNULL ((2, 4)));
1184# endif
1185_GL_CXXALIAS_SYS (linkat, int,
1186 (int fd1, const char *path1, int fd2, const char *path2,
1187 int flag));
1188# endif
1189_GL_CXXALIASWARN (linkat);
1190#elif defined GNULIB_POSIXCHECK
1191# undef linkat
1192# if HAVE_RAW_DECL_LINKAT
1193_GL_WARN_ON_USE (linkat, "linkat is unportable - "
1194 "use gnulib module linkat for portability");
1195# endif
1196#endif
1197
1198
1199#if @GNULIB_LSEEK@
1200/* Set the offset of FD relative to SEEK_SET, SEEK_CUR, or SEEK_END.
1201 Return the new offset if successful, otherwise -1 and errno set.
1202 See the POSIX:2008 specification
c0c3707f 1203 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/lseek.html>. */
8839a007
PA
1204# if @REPLACE_LSEEK@
1205# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1206# define lseek rpl_lseek
1207# endif
1208_GL_FUNCDECL_RPL (lseek, off_t, (int fd, off_t offset, int whence));
1209_GL_CXXALIAS_RPL (lseek, off_t, (int fd, off_t offset, int whence));
1210# else
1211_GL_CXXALIAS_SYS (lseek, off_t, (int fd, off_t offset, int whence));
1212# endif
1213_GL_CXXALIASWARN (lseek);
1214#elif defined GNULIB_POSIXCHECK
1215# undef lseek
1216# if HAVE_RAW_DECL_LSEEK
1217_GL_WARN_ON_USE (lseek, "lseek does not fail with ESPIPE on pipes on some "
1218 "systems - use gnulib module lseek for portability");
1219# endif
1220#endif
1221
1222
1223#if @GNULIB_PIPE@
1224/* Create a pipe, defaulting to O_BINARY mode.
1225 Store the read-end as fd[0] and the write-end as fd[1].
1226 Return 0 upon success, or -1 with errno set upon failure. */
1227# if !@HAVE_PIPE@
1228_GL_FUNCDECL_SYS (pipe, int, (int fd[2]) _GL_ARG_NONNULL ((1)));
1229# endif
1230_GL_CXXALIAS_SYS (pipe, int, (int fd[2]));
1231_GL_CXXALIASWARN (pipe);
1232#elif defined GNULIB_POSIXCHECK
1233# undef pipe
1234# if HAVE_RAW_DECL_PIPE
1235_GL_WARN_ON_USE (pipe, "pipe is unportable - "
1236 "use gnulib module pipe-posix for portability");
1237# endif
1238#endif
1239
1240
1241#if @GNULIB_PIPE2@
1242/* Create a pipe, applying the given flags when opening the read-end of the
1243 pipe and the write-end of the pipe.
1244 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
1245 and O_TEXT, O_BINARY (defined in "binary-io.h").
1246 Store the read-end as fd[0] and the write-end as fd[1].
1247 Return 0 upon success, or -1 with errno set upon failure.
1248 See also the Linux man page at
c0c3707f 1249 <https://www.kernel.org/doc/man-pages/online/pages/man2/pipe2.2.html>. */
8839a007
PA
1250# if @HAVE_PIPE2@
1251# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1252# define pipe2 rpl_pipe2
1253# endif
1254_GL_FUNCDECL_RPL (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1)));
1255_GL_CXXALIAS_RPL (pipe2, int, (int fd[2], int flags));
1256# else
1257_GL_FUNCDECL_SYS (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1)));
1258_GL_CXXALIAS_SYS (pipe2, int, (int fd[2], int flags));
1259# endif
1260_GL_CXXALIASWARN (pipe2);
1261#elif defined GNULIB_POSIXCHECK
1262# undef pipe2
1263# if HAVE_RAW_DECL_PIPE2
1264_GL_WARN_ON_USE (pipe2, "pipe2 is unportable - "
1265 "use gnulib module pipe2 for portability");
1266# endif
1267#endif
1268
1269
1270#if @GNULIB_PREAD@
1271/* Read at most BUFSIZE bytes from FD into BUF, starting at OFFSET.
1272 Return the number of bytes placed into BUF if successful, otherwise
1273 set errno and return -1. 0 indicates EOF.
1274 See the POSIX:2008 specification
c0c3707f 1275 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/pread.html>. */
8839a007
PA
1276# if @REPLACE_PREAD@
1277# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1278# undef pread
1279# define pread rpl_pread
1280# endif
1281_GL_FUNCDECL_RPL (pread, ssize_t,
1282 (int fd, void *buf, size_t bufsize, off_t offset)
1283 _GL_ARG_NONNULL ((2)));
1284_GL_CXXALIAS_RPL (pread, ssize_t,
1285 (int fd, void *buf, size_t bufsize, off_t offset));
1286# else
1287# if !@HAVE_PREAD@
1288_GL_FUNCDECL_SYS (pread, ssize_t,
1289 (int fd, void *buf, size_t bufsize, off_t offset)
1290 _GL_ARG_NONNULL ((2)));
1291# endif
1292_GL_CXXALIAS_SYS (pread, ssize_t,
1293 (int fd, void *buf, size_t bufsize, off_t offset));
1294# endif
1295_GL_CXXALIASWARN (pread);
1296#elif defined GNULIB_POSIXCHECK
1297# undef pread
1298# if HAVE_RAW_DECL_PREAD
1299_GL_WARN_ON_USE (pread, "pread is unportable - "
1300 "use gnulib module pread for portability");
1301# endif
1302#endif
1303
1304
1305#if @GNULIB_PWRITE@
1306/* Write at most BUFSIZE bytes from BUF into FD, starting at OFFSET.
1307 Return the number of bytes written if successful, otherwise
1308 set errno and return -1. 0 indicates nothing written. See the
1309 POSIX:2008 specification
c0c3707f 1310 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/pwrite.html>. */
8839a007
PA
1311# if @REPLACE_PWRITE@
1312# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1313# undef pwrite
1314# define pwrite rpl_pwrite
1315# endif
1316_GL_FUNCDECL_RPL (pwrite, ssize_t,
1317 (int fd, const void *buf, size_t bufsize, off_t offset)
1318 _GL_ARG_NONNULL ((2)));
1319_GL_CXXALIAS_RPL (pwrite, ssize_t,
1320 (int fd, const void *buf, size_t bufsize, off_t offset));
1321# else
1322# if !@HAVE_PWRITE@
1323_GL_FUNCDECL_SYS (pwrite, ssize_t,
1324 (int fd, const void *buf, size_t bufsize, off_t offset)
1325 _GL_ARG_NONNULL ((2)));
1326# endif
1327_GL_CXXALIAS_SYS (pwrite, ssize_t,
1328 (int fd, const void *buf, size_t bufsize, off_t offset));
1329# endif
1330_GL_CXXALIASWARN (pwrite);
1331#elif defined GNULIB_POSIXCHECK
1332# undef pwrite
1333# if HAVE_RAW_DECL_PWRITE
1334_GL_WARN_ON_USE (pwrite, "pwrite is unportable - "
1335 "use gnulib module pwrite for portability");
1336# endif
1337#endif
1338
1339
1340#if @GNULIB_READ@
1341/* Read up to COUNT bytes from file descriptor FD into the buffer starting
1342 at BUF. See the POSIX:2008 specification
c0c3707f 1343 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/read.html>. */
8839a007
PA
1344# if @REPLACE_READ@
1345# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1346# undef read
1347# define read rpl_read
1348# endif
1349_GL_FUNCDECL_RPL (read, ssize_t, (int fd, void *buf, size_t count)
1350 _GL_ARG_NONNULL ((2)));
1351_GL_CXXALIAS_RPL (read, ssize_t, (int fd, void *buf, size_t count));
1352# else
1353/* Need to cast, because on mingw, the third parameter is
1354 unsigned int count
1355 and the return type is 'int'. */
1356_GL_CXXALIAS_SYS_CAST (read, ssize_t, (int fd, void *buf, size_t count));
1357# endif
1358_GL_CXXALIASWARN (read);
1359#endif
1360
1361
1362#if @GNULIB_READLINK@
1363/* Read the contents of the symbolic link FILE and place the first BUFSIZE
1364 bytes of it into BUF. Return the number of bytes placed into BUF if
1365 successful, otherwise -1 and errno set.
1366 See the POSIX:2008 specification
c0c3707f 1367 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/readlink.html>. */
8839a007
PA
1368# if @REPLACE_READLINK@
1369# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1370# define readlink rpl_readlink
1371# endif
1372_GL_FUNCDECL_RPL (readlink, ssize_t,
1373 (const char *file, char *buf, size_t bufsize)
1374 _GL_ARG_NONNULL ((1, 2)));
1375_GL_CXXALIAS_RPL (readlink, ssize_t,
1376 (const char *file, char *buf, size_t bufsize));
1377# else
1378# if !@HAVE_READLINK@
1379_GL_FUNCDECL_SYS (readlink, ssize_t,
1380 (const char *file, char *buf, size_t bufsize)
1381 _GL_ARG_NONNULL ((1, 2)));
1382# endif
1383_GL_CXXALIAS_SYS (readlink, ssize_t,
1384 (const char *file, char *buf, size_t bufsize));
1385# endif
1386_GL_CXXALIASWARN (readlink);
1387#elif defined GNULIB_POSIXCHECK
1388# undef readlink
1389# if HAVE_RAW_DECL_READLINK
1390_GL_WARN_ON_USE (readlink, "readlink is unportable - "
1391 "use gnulib module readlink for portability");
1392# endif
1393#endif
1394
1395
1396#if @GNULIB_READLINKAT@
4a626d0a
PA
1397# if @REPLACE_READLINKAT@
1398# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1399# define readlinkat rpl_readlinkat
1400# endif
1401_GL_FUNCDECL_RPL (readlinkat, ssize_t,
1402 (int fd, char const *file, char *buf, size_t len)
1403 _GL_ARG_NONNULL ((2, 3)));
1404_GL_CXXALIAS_RPL (readlinkat, ssize_t,
1405 (int fd, char const *file, char *buf, size_t len));
1406# else
1407# if !@HAVE_READLINKAT@
8839a007
PA
1408_GL_FUNCDECL_SYS (readlinkat, ssize_t,
1409 (int fd, char const *file, char *buf, size_t len)
1410 _GL_ARG_NONNULL ((2, 3)));
4a626d0a 1411# endif
8839a007
PA
1412_GL_CXXALIAS_SYS (readlinkat, ssize_t,
1413 (int fd, char const *file, char *buf, size_t len));
4a626d0a 1414# endif
8839a007
PA
1415_GL_CXXALIASWARN (readlinkat);
1416#elif defined GNULIB_POSIXCHECK
1417# undef readlinkat
1418# if HAVE_RAW_DECL_READLINKAT
1419_GL_WARN_ON_USE (readlinkat, "readlinkat is not portable - "
1420 "use gnulib module readlinkat for portability");
1421# endif
1422#endif
1423
1424
1425#if @GNULIB_RMDIR@
1426/* Remove the directory DIR. */
1427# if @REPLACE_RMDIR@
1428# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1429# define rmdir rpl_rmdir
1430# endif
1431_GL_FUNCDECL_RPL (rmdir, int, (char const *name) _GL_ARG_NONNULL ((1)));
1432_GL_CXXALIAS_RPL (rmdir, int, (char const *name));
1433# else
1434_GL_CXXALIAS_SYS (rmdir, int, (char const *name));
1435# endif
1436_GL_CXXALIASWARN (rmdir);
1437#elif defined GNULIB_POSIXCHECK
1438# undef rmdir
1439# if HAVE_RAW_DECL_RMDIR
1440_GL_WARN_ON_USE (rmdir, "rmdir is unportable - "
1441 "use gnulib module rmdir for portability");
1442# endif
1443#endif
1444
1445
1446#if @GNULIB_SETHOSTNAME@
1447/* Set the host name of the machine.
1448 The host name may or may not be fully qualified.
1449
1450 Put LEN bytes of NAME into the host name.
1451 Return 0 if successful, otherwise, set errno and return -1.
1452
1453 Platforms with no ability to set the hostname return -1 and set
1454 errno = ENOSYS. */
1455# if !@HAVE_SETHOSTNAME@ || !@HAVE_DECL_SETHOSTNAME@
1456_GL_FUNCDECL_SYS (sethostname, int, (const char *name, size_t len)
1457 _GL_ARG_NONNULL ((1)));
1458# endif
1459/* Need to cast, because on Solaris 11 2011-10, Mac OS X 10.5, IRIX 6.5
1460 and FreeBSD 6.4 the second parameter is int. On Solaris 11
1461 2011-10, the first parameter is not const. */
1462_GL_CXXALIAS_SYS_CAST (sethostname, int, (const char *name, size_t len));
1463_GL_CXXALIASWARN (sethostname);
1464#elif defined GNULIB_POSIXCHECK
1465# undef sethostname
1466# if HAVE_RAW_DECL_SETHOSTNAME
1467_GL_WARN_ON_USE (sethostname, "sethostname is unportable - "
1468 "use gnulib module sethostname for portability");
1469# endif
1470#endif
1471
1472
1473#if @GNULIB_SLEEP@
1474/* Pause the execution of the current thread for N seconds.
1475 Returns the number of seconds left to sleep.
1476 See the POSIX:2008 specification
c0c3707f 1477 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/sleep.html>. */
8839a007
PA
1478# if @REPLACE_SLEEP@
1479# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1480# undef sleep
1481# define sleep rpl_sleep
1482# endif
1483_GL_FUNCDECL_RPL (sleep, unsigned int, (unsigned int n));
1484_GL_CXXALIAS_RPL (sleep, unsigned int, (unsigned int n));
1485# else
1486# if !@HAVE_SLEEP@
1487_GL_FUNCDECL_SYS (sleep, unsigned int, (unsigned int n));
1488# endif
1489_GL_CXXALIAS_SYS (sleep, unsigned int, (unsigned int n));
1490# endif
1491_GL_CXXALIASWARN (sleep);
1492#elif defined GNULIB_POSIXCHECK
1493# undef sleep
1494# if HAVE_RAW_DECL_SLEEP
1495_GL_WARN_ON_USE (sleep, "sleep is unportable - "
1496 "use gnulib module sleep for portability");
1497# endif
1498#endif
1499
1500
1501#if @GNULIB_SYMLINK@
1502# if @REPLACE_SYMLINK@
1503# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1504# undef symlink
1505# define symlink rpl_symlink
1506# endif
1507_GL_FUNCDECL_RPL (symlink, int, (char const *contents, char const *file)
1508 _GL_ARG_NONNULL ((1, 2)));
1509_GL_CXXALIAS_RPL (symlink, int, (char const *contents, char const *file));
1510# else
1511# if !@HAVE_SYMLINK@
1512_GL_FUNCDECL_SYS (symlink, int, (char const *contents, char const *file)
1513 _GL_ARG_NONNULL ((1, 2)));
1514# endif
1515_GL_CXXALIAS_SYS (symlink, int, (char const *contents, char const *file));
1516# endif
1517_GL_CXXALIASWARN (symlink);
1518#elif defined GNULIB_POSIXCHECK
1519# undef symlink
1520# if HAVE_RAW_DECL_SYMLINK
1521_GL_WARN_ON_USE (symlink, "symlink is not portable - "
1522 "use gnulib module symlink for portability");
1523# endif
1524#endif
1525
1526
1527#if @GNULIB_SYMLINKAT@
4a626d0a
PA
1528# if @REPLACE_SYMLINKAT@
1529# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1530# undef symlinkat
1531# define symlinkat rpl_symlinkat
1532# endif
1533_GL_FUNCDECL_RPL (symlinkat, int,
1534 (char const *contents, int fd, char const *file)
1535 _GL_ARG_NONNULL ((1, 3)));
1536_GL_CXXALIAS_RPL (symlinkat, int,
1537 (char const *contents, int fd, char const *file));
1538# else
1539# if !@HAVE_SYMLINKAT@
8839a007
PA
1540_GL_FUNCDECL_SYS (symlinkat, int,
1541 (char const *contents, int fd, char const *file)
1542 _GL_ARG_NONNULL ((1, 3)));
4a626d0a 1543# endif
8839a007
PA
1544_GL_CXXALIAS_SYS (symlinkat, int,
1545 (char const *contents, int fd, char const *file));
4a626d0a 1546# endif
8839a007
PA
1547_GL_CXXALIASWARN (symlinkat);
1548#elif defined GNULIB_POSIXCHECK
1549# undef symlinkat
1550# if HAVE_RAW_DECL_SYMLINKAT
1551_GL_WARN_ON_USE (symlinkat, "symlinkat is not portable - "
1552 "use gnulib module symlinkat for portability");
1553# endif
1554#endif
1555
1556
c0c3707f
CB
1557#if @GNULIB_TRUNCATE@
1558/* Change the size of the file designated by FILENAME to become equal to LENGTH.
1559 Return 0 if successful, otherwise -1 and errno set.
1560 See the POSIX:2008 specification
1561 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/truncate.html>. */
1562# if @REPLACE_TRUNCATE@
1563# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1564# undef truncate
1565# define truncate rpl_truncate
1566# endif
1567_GL_FUNCDECL_RPL (truncate, int, (const char *filename, off_t length)
1568 _GL_ARG_NONNULL ((1)));
1569_GL_CXXALIAS_RPL (truncate, int, (const char *filename, off_t length));
1570# else
1571# if !@HAVE_DECL_TRUNCATE@
1572_GL_FUNCDECL_SYS (truncate, int, (const char *filename, off_t length)
1573 _GL_ARG_NONNULL ((1)));
1574# endif
1575_GL_CXXALIAS_SYS (truncate, int, (const char *filename, off_t length));
1576# endif
1577_GL_CXXALIASWARN (truncate);
1578#elif defined GNULIB_POSIXCHECK
1579# undef truncate
1580# if HAVE_RAW_DECL_TRUNCATE
1581_GL_WARN_ON_USE (truncate, "truncate is unportable - "
1582 "use gnulib module truncate for portability");
1583# endif
1584#endif
1585
1586
8839a007
PA
1587#if @GNULIB_TTYNAME_R@
1588/* Store at most BUFLEN characters of the pathname of the terminal FD is
1589 open on in BUF. Return 0 on success, otherwise an error number. */
1590# if @REPLACE_TTYNAME_R@
1591# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1592# undef ttyname_r
1593# define ttyname_r rpl_ttyname_r
1594# endif
1595_GL_FUNCDECL_RPL (ttyname_r, int,
1596 (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
1597_GL_CXXALIAS_RPL (ttyname_r, int,
1598 (int fd, char *buf, size_t buflen));
1599# else
1600# if !@HAVE_DECL_TTYNAME_R@
1601_GL_FUNCDECL_SYS (ttyname_r, int,
1602 (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
1603# endif
1604_GL_CXXALIAS_SYS (ttyname_r, int,
1605 (int fd, char *buf, size_t buflen));
1606# endif
1607_GL_CXXALIASWARN (ttyname_r);
1608#elif defined GNULIB_POSIXCHECK
1609# undef ttyname_r
1610# if HAVE_RAW_DECL_TTYNAME_R
1611_GL_WARN_ON_USE (ttyname_r, "ttyname_r is not portable - "
1612 "use gnulib module ttyname_r for portability");
1613# endif
1614#endif
1615
1616
1617#if @GNULIB_UNLINK@
1618# if @REPLACE_UNLINK@
1619# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1620# undef unlink
1621# define unlink rpl_unlink
1622# endif
1623_GL_FUNCDECL_RPL (unlink, int, (char const *file) _GL_ARG_NONNULL ((1)));
1624_GL_CXXALIAS_RPL (unlink, int, (char const *file));
1625# else
1626_GL_CXXALIAS_SYS (unlink, int, (char const *file));
1627# endif
1628_GL_CXXALIASWARN (unlink);
1629#elif defined GNULIB_POSIXCHECK
1630# undef unlink
1631# if HAVE_RAW_DECL_UNLINK
1632_GL_WARN_ON_USE (unlink, "unlink is not portable - "
1633 "use gnulib module unlink for portability");
1634# endif
1635#endif
1636
1637
1638#if @GNULIB_UNLINKAT@
1639# if @REPLACE_UNLINKAT@
1640# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1641# undef unlinkat
1642# define unlinkat rpl_unlinkat
1643# endif
1644_GL_FUNCDECL_RPL (unlinkat, int, (int fd, char const *file, int flag)
1645 _GL_ARG_NONNULL ((2)));
1646_GL_CXXALIAS_RPL (unlinkat, int, (int fd, char const *file, int flag));
1647# else
1648# if !@HAVE_UNLINKAT@
1649_GL_FUNCDECL_SYS (unlinkat, int, (int fd, char const *file, int flag)
1650 _GL_ARG_NONNULL ((2)));
1651# endif
1652_GL_CXXALIAS_SYS (unlinkat, int, (int fd, char const *file, int flag));
1653# endif
1654_GL_CXXALIASWARN (unlinkat);
1655#elif defined GNULIB_POSIXCHECK
1656# undef unlinkat
1657# if HAVE_RAW_DECL_UNLINKAT
1658_GL_WARN_ON_USE (unlinkat, "unlinkat is not portable - "
1659 "use gnulib module openat for portability");
1660# endif
1661#endif
1662
1663
1664#if @GNULIB_USLEEP@
1665/* Pause the execution of the current thread for N microseconds.
1666 Returns 0 on completion, or -1 on range error.
1667 See the POSIX:2001 specification
c0c3707f 1668 <https://pubs.opengroup.org/onlinepubs/009695399/functions/usleep.html>. */
8839a007
PA
1669# if @REPLACE_USLEEP@
1670# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1671# undef usleep
1672# define usleep rpl_usleep
1673# endif
1674_GL_FUNCDECL_RPL (usleep, int, (useconds_t n));
1675_GL_CXXALIAS_RPL (usleep, int, (useconds_t n));
1676# else
1677# if !@HAVE_USLEEP@
1678_GL_FUNCDECL_SYS (usleep, int, (useconds_t n));
1679# endif
c0c3707f
CB
1680/* Need to cast, because on Haiku, the first parameter is
1681 unsigned int n. */
1682_GL_CXXALIAS_SYS_CAST (usleep, int, (useconds_t n));
8839a007
PA
1683# endif
1684_GL_CXXALIASWARN (usleep);
1685#elif defined GNULIB_POSIXCHECK
1686# undef usleep
1687# if HAVE_RAW_DECL_USLEEP
1688_GL_WARN_ON_USE (usleep, "usleep is unportable - "
1689 "use gnulib module usleep for portability");
1690# endif
1691#endif
1692
1693
1694#if @GNULIB_WRITE@
1695/* Write up to COUNT bytes starting at BUF to file descriptor FD.
1696 See the POSIX:2008 specification
c0c3707f 1697 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/write.html>. */
8839a007
PA
1698# if @REPLACE_WRITE@
1699# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1700# undef write
1701# define write rpl_write
1702# endif
1703_GL_FUNCDECL_RPL (write, ssize_t, (int fd, const void *buf, size_t count)
1704 _GL_ARG_NONNULL ((2)));
1705_GL_CXXALIAS_RPL (write, ssize_t, (int fd, const void *buf, size_t count));
1706# else
1707/* Need to cast, because on mingw, the third parameter is
1708 unsigned int count
1709 and the return type is 'int'. */
1710_GL_CXXALIAS_SYS_CAST (write, ssize_t, (int fd, const void *buf, size_t count));
1711# endif
1712_GL_CXXALIASWARN (write);
1713#endif
1714
1715_GL_INLINE_HEADER_END
1716
1717#endif /* _@GUARD_PREFIX@_UNISTD_H */
4a626d0a 1718#endif /* _GL_INCLUDING_UNISTD_H */
8839a007 1719#endif /* _@GUARD_PREFIX@_UNISTD_H */
This page took 0.589584 seconds and 4 git commands to generate.