projects / binutils-gdb.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
history | raw | HEAD
Emit a note warning the user that creating an executable stack because of a missing...
[binutils-gdb.git] / gnulib / import / unistd.in.h
1 /* Substitute for and wrapper around <unistd.h>.
2 Copyright (C) 2003-2022 Free Software Foundation, Inc.
3
4 This file is free software: you can redistribute it and/or modify
5 it under the terms of the GNU Lesser General Public License as
6 published by the Free Software Foundation; either version 2.1 of the
7 License, or (at your option) any later version.
8
9 This file 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 Lesser General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public License
15 along with this program. If not, see <https://www.gnu.org/licenses/>. */
16
17 #ifndef _@GUARD_PREFIX@_UNISTD_H
18
19 #if __GNUC__ >= 3
20 @PRAGMA_SYSTEM_HEADER@
21 #endif
22 @PRAGMA_COLUMNS@
23
24 #if @HAVE_UNISTD_H@ && defined _GL_INCLUDING_UNISTD_H
25 /* Special invocation convention:
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. */
30
31 #@INCLUDE_NEXT@ @NEXT_UNISTD_H@
32
33 #else
34 /* Normal invocation convention. */
35
36 /* The include_next requires a split double-inclusion guard. */
37 #if @HAVE_UNISTD_H@
38 # define _GL_INCLUDING_UNISTD_H
39 # @INCLUDE_NEXT@ @NEXT_UNISTD_H@
40 # undef _GL_INCLUDING_UNISTD_H
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. */
55 /* But avoid namespace pollution on glibc systems. */
56 #ifndef __GLIBC__
57 # include <stddef.h>
58 #endif
59
60 /* mingw doesn't define the SEEK_* or *_FILENO macros in <unistd.h>. */
61 /* MSVC declares 'unlink' in <stdio.h>, not in <unistd.h>. We must include
62 it before we #define unlink rpl_unlink. */
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) \
66 || ((@GNULIB_UNLINK@ || defined GNULIB_POSIXCHECK) \
67 && (defined _WIN32 && ! defined __CYGWIN__)) \
68 || ((@GNULIB_SYMLINKAT@ || defined GNULIB_POSIXCHECK) \
69 && defined __CYGWIN__)) \
70 && ! defined __GLIBC__
71 # include <stdio.h>
72 #endif
73
74 /* Cygwin 1.7.1 and Android 4.3 declare unlinkat in <fcntl.h>, not in
75 <unistd.h>. */
76 /* But avoid namespace pollution on glibc systems. */
77 #if (@GNULIB_UNLINKAT@ || defined GNULIB_POSIXCHECK) \
78 && (defined __CYGWIN__ || defined __ANDROID__) \
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>. */
87 /* OSF Tru64 Unix cannot see gnulib rpl_strtod when system <stdlib.h> is
88 included here. */
89 /* But avoid namespace pollution on glibc systems. */
90 #if !defined __GLIBC__ && !defined __osf__
91 # define __need_system_stdlib_h
92 # include <stdlib.h>
93 # undef __need_system_stdlib_h
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 defined _WIN32 && !defined __CYGWIN__
101 # include <io.h>
102 # include <direct.h>
103 #endif
104
105 /* Native Windows platforms declare _execl*, _execv* in <process.h>. */
106 #if defined _WIN32 && !defined __CYGWIN__
107 # include <process.h>
108 #endif
109
110 /* AIX and OSF/1 5.1 declare getdomainname in <netdb.h>, not in <unistd.h>.
111 NonStop Kernel declares gethostname in <netdb.h>, not in <unistd.h>. */
112 /* But avoid namespace pollution on glibc systems. */
113 #if ((@GNULIB_GETDOMAINNAME@ && (defined _AIX || defined __osf__)) \
114 || (@GNULIB_GETHOSTNAME@ && defined __TANDEM)) \
115 && !defined __GLIBC__
116 # include <netdb.h>
117 #endif
118
119 /* Mac OS X 10.13, Solaris 11.4, and Android 9.0 declare getentropy in
120 <sys/random.h>, not in <unistd.h>. */
121 /* But avoid namespace pollution on glibc systems. */
122 #if (@GNULIB_GETENTROPY@ || defined GNULIB_POSIXCHECK) \
123 && ((defined __APPLE__ && defined __MACH__) || defined __sun \
124 || defined __ANDROID__) \
125 && @UNISTD_H_HAVE_SYS_RANDOM_H@ \
126 && !defined __GLIBC__
127 # include <sys/random.h>
128 #endif
129
130 /* Android 4.3 declares fchownat in <sys/stat.h>, not in <unistd.h>. */
131 /* But avoid namespace pollution on glibc systems. */
132 #if (@GNULIB_FCHOWNAT@ || defined GNULIB_POSIXCHECK) && defined __ANDROID__ \
133 && !defined __GLIBC__
134 # include <sys/stat.h>
135 #endif
136
137 /* MSVC defines off_t in <sys/types.h>.
138 May also define off_t to a 64-bit type on native Windows. */
139 /* Get off_t, ssize_t, mode_t. */
140 #include <sys/types.h>
141
142 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
143
144 /* The definition of _GL_ARG_NONNULL is copied here. */
145
146 /* The definition of _GL_WARN_ON_USE is copied here. */
147
148
149 /* Get getopt(), optarg, optind, opterr, optopt. */
150 #if @GNULIB_GETOPT_POSIX@ && @GNULIB_UNISTD_H_GETOPT@ && !defined _GL_SYSTEM_GETOPT
151 # include <getopt-cdefs.h>
152 # include <getopt-pfx-core.h>
153 #endif
154
155 #ifndef _GL_INLINE_HEADER_BEGIN
156 #error "Please include config.h first."
157 #endif
158 _GL_INLINE_HEADER_BEGIN
159 #ifndef _GL_UNISTD_INLINE
160 # define _GL_UNISTD_INLINE _GL_INLINE
161 #endif
162
163 /* Hide some function declarations from <winsock2.h>. */
164
165 #if @GNULIB_GETHOSTNAME@ && @UNISTD_H_HAVE_WINSOCK2_H@
166 # if !defined _@GUARD_PREFIX@_SYS_SOCKET_H
167 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
168 # undef socket
169 # define socket socket_used_without_including_sys_socket_h
170 # undef connect
171 # define connect connect_used_without_including_sys_socket_h
172 # undef accept
173 # define accept accept_used_without_including_sys_socket_h
174 # undef bind
175 # define bind bind_used_without_including_sys_socket_h
176 # undef getpeername
177 # define getpeername getpeername_used_without_including_sys_socket_h
178 # undef getsockname
179 # define getsockname getsockname_used_without_including_sys_socket_h
180 # undef getsockopt
181 # define getsockopt getsockopt_used_without_including_sys_socket_h
182 # undef listen
183 # define listen listen_used_without_including_sys_socket_h
184 # undef recv
185 # define recv recv_used_without_including_sys_socket_h
186 # undef send
187 # define send send_used_without_including_sys_socket_h
188 # undef recvfrom
189 # define recvfrom recvfrom_used_without_including_sys_socket_h
190 # undef sendto
191 # define sendto sendto_used_without_including_sys_socket_h
192 # undef setsockopt
193 # define setsockopt setsockopt_used_without_including_sys_socket_h
194 # undef shutdown
195 # define shutdown shutdown_used_without_including_sys_socket_h
196 # else
197 _GL_WARN_ON_USE (socket,
198 "socket() used without including <sys/socket.h>");
199 _GL_WARN_ON_USE (connect,
200 "connect() used without including <sys/socket.h>");
201 _GL_WARN_ON_USE (accept,
202 "accept() used without including <sys/socket.h>");
203 _GL_WARN_ON_USE (bind,
204 "bind() used without including <sys/socket.h>");
205 _GL_WARN_ON_USE (getpeername,
206 "getpeername() used without including <sys/socket.h>");
207 _GL_WARN_ON_USE (getsockname,
208 "getsockname() used without including <sys/socket.h>");
209 _GL_WARN_ON_USE (getsockopt,
210 "getsockopt() used without including <sys/socket.h>");
211 _GL_WARN_ON_USE (listen,
212 "listen() used without including <sys/socket.h>");
213 _GL_WARN_ON_USE (recv,
214 "recv() used without including <sys/socket.h>");
215 _GL_WARN_ON_USE (send,
216 "send() used without including <sys/socket.h>");
217 _GL_WARN_ON_USE (recvfrom,
218 "recvfrom() used without including <sys/socket.h>");
219 _GL_WARN_ON_USE (sendto,
220 "sendto() used without including <sys/socket.h>");
221 _GL_WARN_ON_USE (setsockopt,
222 "setsockopt() used without including <sys/socket.h>");
223 _GL_WARN_ON_USE (shutdown,
224 "shutdown() used without including <sys/socket.h>");
225 # endif
226 # endif
227 # if !defined _@GUARD_PREFIX@_SYS_SELECT_H
228 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
229 # undef select
230 # define select select_used_without_including_sys_select_h
231 # else
232 _GL_WARN_ON_USE (select,
233 "select() used without including <sys/select.h>");
234 # endif
235 # endif
236 #endif
237
238
239 /* OS/2 EMX lacks these macros. */
240 #ifndef STDIN_FILENO
241 # define STDIN_FILENO 0
242 #endif
243 #ifndef STDOUT_FILENO
244 # define STDOUT_FILENO 1
245 #endif
246 #ifndef STDERR_FILENO
247 # define STDERR_FILENO 2
248 #endif
249
250 /* Ensure *_OK macros exist. */
251 #ifndef F_OK
252 # define F_OK 0
253 # define X_OK 1
254 # define W_OK 2
255 # define R_OK 4
256 #endif
257
258
259 /* Declare overridden functions. */
260
261
262 #if @GNULIB_ACCESS@
263 # if @REPLACE_ACCESS@
264 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
265 # undef access
266 # define access rpl_access
267 # endif
268 _GL_FUNCDECL_RPL (access, int, (const char *file, int mode)
269 _GL_ARG_NONNULL ((1)));
270 _GL_CXXALIAS_RPL (access, int, (const char *file, int mode));
271 # elif defined _WIN32 && !defined __CYGWIN__
272 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
273 # undef access
274 # define access _access
275 # endif
276 _GL_CXXALIAS_MDA (access, int, (const char *file, int mode));
277 # else
278 _GL_CXXALIAS_SYS (access, int, (const char *file, int mode));
279 # endif
280 _GL_CXXALIASWARN (access);
281 #elif defined GNULIB_POSIXCHECK
282 # undef access
283 # if HAVE_RAW_DECL_ACCESS
284 /* The access() function is a security risk. */
285 _GL_WARN_ON_USE (access, "access does not always support X_OK - "
286 "use gnulib module access for portability; "
287 "also, this function is a security risk - "
288 "use the gnulib module faccessat instead");
289 # endif
290 #elif @GNULIB_MDA_ACCESS@
291 /* On native Windows, map 'access' to '_access', so that -loldnames is not
292 required. In C++ with GNULIB_NAMESPACE, avoid differences between
293 platforms by defining GNULIB_NAMESPACE::access always. */
294 # if defined _WIN32 && !defined __CYGWIN__
295 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
296 # undef access
297 # define access _access
298 # endif
299 _GL_CXXALIAS_MDA (access, int, (const char *file, int mode));
300 # else
301 _GL_CXXALIAS_SYS (access, int, (const char *file, int mode));
302 # endif
303 _GL_CXXALIASWARN (access);
304 #endif
305
306
307 #if @GNULIB_CHDIR@
308 # if defined _WIN32 && !defined __CYGWIN__
309 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
310 # undef chdir
311 # define chdir _chdir
312 # endif
313 _GL_CXXALIAS_MDA (chdir, int, (const char *file));
314 # else
315 _GL_CXXALIAS_SYS (chdir, int, (const char *file) _GL_ARG_NONNULL ((1)));
316 # endif
317 _GL_CXXALIASWARN (chdir);
318 #elif defined GNULIB_POSIXCHECK
319 # undef chdir
320 # if HAVE_RAW_DECL_CHDIR
321 _GL_WARN_ON_USE (chown, "chdir is not always in <unistd.h> - "
322 "use gnulib module chdir for portability");
323 # endif
324 #elif @GNULIB_MDA_CHDIR@
325 /* On native Windows, map 'chdir' to '_chdir', so that -loldnames is not
326 required. In C++ with GNULIB_NAMESPACE, avoid differences between
327 platforms by defining GNULIB_NAMESPACE::chdir always. */
328 # if defined _WIN32 && !defined __CYGWIN__
329 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
330 # undef chdir
331 # define chdir _chdir
332 # endif
333 _GL_CXXALIAS_MDA (chdir, int, (const char *file));
334 # else
335 _GL_CXXALIAS_SYS (chdir, int, (const char *file) _GL_ARG_NONNULL ((1)));
336 # endif
337 _GL_CXXALIASWARN (chdir);
338 #endif
339
340
341 #if @GNULIB_CHOWN@
342 /* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
343 to GID (if GID is not -1). Follow symbolic links.
344 Return 0 if successful, otherwise -1 and errno set.
345 See the POSIX:2008 specification
346 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/chown.html. */
347 # if @REPLACE_CHOWN@
348 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
349 # undef chown
350 # define chown rpl_chown
351 # endif
352 _GL_FUNCDECL_RPL (chown, int, (const char *file, uid_t uid, gid_t gid)
353 _GL_ARG_NONNULL ((1)));
354 _GL_CXXALIAS_RPL (chown, int, (const char *file, uid_t uid, gid_t gid));
355 # else
356 # if !@HAVE_CHOWN@
357 _GL_FUNCDECL_SYS (chown, int, (const char *file, uid_t uid, gid_t gid)
358 _GL_ARG_NONNULL ((1)));
359 # endif
360 _GL_CXXALIAS_SYS (chown, int, (const char *file, uid_t uid, gid_t gid));
361 # endif
362 _GL_CXXALIASWARN (chown);
363 #elif defined GNULIB_POSIXCHECK
364 # undef chown
365 # if HAVE_RAW_DECL_CHOWN
366 _GL_WARN_ON_USE (chown, "chown fails to follow symlinks on some systems and "
367 "doesn't treat a uid or gid of -1 on some systems - "
368 "use gnulib module chown for portability");
369 # endif
370 #endif
371
372
373 #if @GNULIB_CLOSE@
374 # if @REPLACE_CLOSE@
375 /* Automatically included by modules that need a replacement for close. */
376 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
377 # undef close
378 # define close rpl_close
379 # endif
380 _GL_FUNCDECL_RPL (close, int, (int fd));
381 _GL_CXXALIAS_RPL (close, int, (int fd));
382 # elif defined _WIN32 && !defined __CYGWIN__
383 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
384 # undef close
385 # define close _close
386 # endif
387 _GL_CXXALIAS_MDA (close, int, (int fd));
388 # else
389 _GL_CXXALIAS_SYS (close, int, (int fd));
390 # endif
391 _GL_CXXALIASWARN (close);
392 #elif @UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS@
393 # undef close
394 # define close close_used_without_requesting_gnulib_module_close
395 #elif defined GNULIB_POSIXCHECK
396 # undef close
397 /* Assume close is always declared. */
398 _GL_WARN_ON_USE (close, "close does not portably work on sockets - "
399 "use gnulib module close for portability");
400 #elif @GNULIB_MDA_CLOSE@
401 /* On native Windows, map 'close' to '_close', so that -loldnames is not
402 required. In C++ with GNULIB_NAMESPACE, avoid differences between
403 platforms by defining GNULIB_NAMESPACE::close always. */
404 # if defined _WIN32 && !defined __CYGWIN__
405 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
406 # undef close
407 # define close _close
408 # endif
409 _GL_CXXALIAS_MDA (close, int, (int fd));
410 # else
411 _GL_CXXALIAS_SYS (close, int, (int fd));
412 # endif
413 _GL_CXXALIASWARN (close);
414 #endif
415
416
417 #if @GNULIB_COPY_FILE_RANGE@
418 # if @REPLACE_COPY_FILE_RANGE@
419 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
420 # undef copy_file_range
421 # define copy_file_range rpl_copy_file_range
422 # endif
423 _GL_FUNCDECL_RPL (copy_file_range, ssize_t, (int ifd, off_t *ipos,
424 int ofd, off_t *opos,
425 size_t len, unsigned flags));
426 _GL_CXXALIAS_RPL (copy_file_range, ssize_t, (int ifd, off_t *ipos,
427 int ofd, off_t *opos,
428 size_t len, unsigned flags));
429 # else
430 # if !@HAVE_COPY_FILE_RANGE@
431 _GL_FUNCDECL_SYS (copy_file_range, ssize_t, (int ifd, off_t *ipos,
432 int ofd, off_t *opos,
433 size_t len, unsigned flags));
434 # endif
435 _GL_CXXALIAS_SYS (copy_file_range, ssize_t, (int ifd, off_t *ipos,
436 int ofd, off_t *opos,
437 size_t len, unsigned flags));
438 # endif
439 _GL_CXXALIASWARN (copy_file_range);
440 #elif defined GNULIB_POSIXCHECK
441 # undef copy_file_range
442 # if HAVE_RAW_DECL_COPY_FILE_RANGE
443 _GL_WARN_ON_USE (copy_file_range,
444 "copy_file_range is unportable - "
445 "use gnulib module copy_file_range for portability");
446 # endif
447 #endif
448
449
450 #if @GNULIB_DUP@
451 # if @REPLACE_DUP@
452 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
453 # define dup rpl_dup
454 # endif
455 _GL_FUNCDECL_RPL (dup, int, (int oldfd));
456 _GL_CXXALIAS_RPL (dup, int, (int oldfd));
457 # elif defined _WIN32 && !defined __CYGWIN__
458 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
459 # undef dup
460 # define dup _dup
461 # endif
462 _GL_CXXALIAS_MDA (dup, int, (int oldfd));
463 # else
464 _GL_CXXALIAS_SYS (dup, int, (int oldfd));
465 # endif
466 _GL_CXXALIASWARN (dup);
467 #elif defined GNULIB_POSIXCHECK
468 # undef dup
469 # if HAVE_RAW_DECL_DUP
470 _GL_WARN_ON_USE (dup, "dup is unportable - "
471 "use gnulib module dup for portability");
472 # endif
473 #elif @GNULIB_MDA_DUP@
474 /* On native Windows, map 'dup' to '_dup', so that -loldnames is not
475 required. In C++ with GNULIB_NAMESPACE, avoid differences between
476 platforms by defining GNULIB_NAMESPACE::dup always. */
477 # if defined _WIN32 && !defined __CYGWIN__
478 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
479 # undef dup
480 # define dup _dup
481 # endif
482 _GL_CXXALIAS_MDA (dup, int, (int oldfd));
483 # else
484 _GL_CXXALIAS_SYS (dup, int, (int oldfd));
485 # endif
486 _GL_CXXALIASWARN (dup);
487 #endif
488
489
490 #if @GNULIB_DUP2@
491 /* Copy the file descriptor OLDFD into file descriptor NEWFD. Do nothing if
492 NEWFD = OLDFD, otherwise close NEWFD first if it is open.
493 Return newfd if successful, otherwise -1 and errno set.
494 See the POSIX:2008 specification
495 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/dup2.html>. */
496 # if @REPLACE_DUP2@
497 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
498 # define dup2 rpl_dup2
499 # endif
500 _GL_FUNCDECL_RPL (dup2, int, (int oldfd, int newfd));
501 _GL_CXXALIAS_RPL (dup2, int, (int oldfd, int newfd));
502 # elif defined _WIN32 && !defined __CYGWIN__
503 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
504 # undef dup2
505 # define dup2 _dup2
506 # endif
507 _GL_CXXALIAS_MDA (dup2, int, (int oldfd, int newfd));
508 # else
509 _GL_CXXALIAS_SYS (dup2, int, (int oldfd, int newfd));
510 # endif
511 _GL_CXXALIASWARN (dup2);
512 #elif defined GNULIB_POSIXCHECK
513 # undef dup2
514 # if HAVE_RAW_DECL_DUP2
515 _GL_WARN_ON_USE (dup2, "dup2 is unportable - "
516 "use gnulib module dup2 for portability");
517 # endif
518 #elif @GNULIB_MDA_DUP2@
519 /* On native Windows, map 'dup2' to '_dup2', so that -loldnames is not
520 required. In C++ with GNULIB_NAMESPACE, avoid differences between
521 platforms by defining GNULIB_NAMESPACE::dup2 always. */
522 # if defined _WIN32 && !defined __CYGWIN__
523 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
524 # undef dup2
525 # define dup2 _dup2
526 # endif
527 _GL_CXXALIAS_MDA (dup2, int, (int oldfd, int newfd));
528 # else
529 _GL_CXXALIAS_SYS (dup2, int, (int oldfd, int newfd));
530 # endif
531 _GL_CXXALIASWARN (dup2);
532 #endif
533
534
535 #if @GNULIB_DUP3@
536 /* Copy the file descriptor OLDFD into file descriptor NEWFD, with the
537 specified flags.
538 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
539 and O_TEXT, O_BINARY (defined in "binary-io.h").
540 Close NEWFD first if it is open.
541 Return newfd if successful, otherwise -1 and errno set.
542 See the Linux man page at
543 <https://www.kernel.org/doc/man-pages/online/pages/man2/dup3.2.html>. */
544 # if @HAVE_DUP3@
545 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
546 # define dup3 rpl_dup3
547 # endif
548 _GL_FUNCDECL_RPL (dup3, int, (int oldfd, int newfd, int flags));
549 _GL_CXXALIAS_RPL (dup3, int, (int oldfd, int newfd, int flags));
550 # else
551 _GL_FUNCDECL_SYS (dup3, int, (int oldfd, int newfd, int flags));
552 _GL_CXXALIAS_SYS (dup3, int, (int oldfd, int newfd, int flags));
553 # endif
554 _GL_CXXALIASWARN (dup3);
555 #elif defined GNULIB_POSIXCHECK
556 # undef dup3
557 # if HAVE_RAW_DECL_DUP3
558 _GL_WARN_ON_USE (dup3, "dup3 is unportable - "
559 "use gnulib module dup3 for portability");
560 # endif
561 #endif
562
563
564 #if @GNULIB_ENVIRON@
565 # if defined __CYGWIN__ && !defined __i386__
566 /* The 'environ' variable is defined in a DLL. Therefore its declaration needs
567 the '__declspec(dllimport)' attribute, but the system's <unistd.h> lacks it.
568 This leads to a link error on 64-bit Cygwin when the option
569 -Wl,--disable-auto-import is in use. */
570 _GL_EXTERN_C __declspec(dllimport) char **environ;
571 # endif
572 # if !@HAVE_DECL_ENVIRON@
573 /* Set of environment variables and values. An array of strings of the form
574 "VARIABLE=VALUE", terminated with a NULL. */
575 # if defined __APPLE__ && defined __MACH__
576 # include <TargetConditionals.h>
577 # if !TARGET_OS_IPHONE && !TARGET_IPHONE_SIMULATOR
578 # define _GL_USE_CRT_EXTERNS
579 # endif
580 # endif
581 # ifdef _GL_USE_CRT_EXTERNS
582 # include <crt_externs.h>
583 # define environ (*_NSGetEnviron ())
584 # else
585 # ifdef __cplusplus
586 extern "C" {
587 # endif
588 extern char **environ;
589 # ifdef __cplusplus
590 }
591 # endif
592 # endif
593 # endif
594 #elif defined GNULIB_POSIXCHECK
595 # if HAVE_RAW_DECL_ENVIRON
596 _GL_UNISTD_INLINE char ***
597 _GL_WARN_ON_USE_ATTRIBUTE ("environ is unportable - "
598 "use gnulib module environ for portability")
599 rpl_environ (void)
600 {
601 return &environ;
602 }
603 # undef environ
604 # define environ (*rpl_environ ())
605 # endif
606 #endif
607
608
609 #if @GNULIB_EUIDACCESS@
610 /* Like access(), except that it uses the effective user id and group id of
611 the current process. */
612 # if !@HAVE_EUIDACCESS@
613 _GL_FUNCDECL_SYS (euidaccess, int, (const char *filename, int mode)
614 _GL_ARG_NONNULL ((1)));
615 # endif
616 _GL_CXXALIAS_SYS (euidaccess, int, (const char *filename, int mode));
617 _GL_CXXALIASWARN (euidaccess);
618 # if defined GNULIB_POSIXCHECK
619 /* Like access(), this function is a security risk. */
620 _GL_WARN_ON_USE (euidaccess, "the euidaccess function is a security risk - "
621 "use the gnulib module faccessat instead");
622 # endif
623 #elif defined GNULIB_POSIXCHECK
624 # undef euidaccess
625 # if HAVE_RAW_DECL_EUIDACCESS
626 _GL_WARN_ON_USE (euidaccess, "euidaccess is unportable - "
627 "use gnulib module euidaccess for portability");
628 # endif
629 #endif
630
631
632 #if @GNULIB_EXECL@
633 # if @REPLACE_EXECL@
634 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
635 # undef execl
636 # define execl rpl_execl
637 # endif
638 _GL_FUNCDECL_RPL (execl, int, (const char *program, const char *arg, ...)
639 _GL_ARG_NONNULL ((1)));
640 _GL_CXXALIAS_RPL (execl, int, (const char *program, const char *arg, ...));
641 # else
642 _GL_CXXALIAS_SYS (execl, int, (const char *program, const char *arg, ...));
643 # endif
644 _GL_CXXALIASWARN (execl);
645 #elif defined GNULIB_POSIXCHECK
646 # undef execl
647 # if HAVE_RAW_DECL_EXECL
648 _GL_WARN_ON_USE (execl, "execl behaves very differently on mingw - "
649 "use gnulib module execl for portability");
650 # endif
651 #elif @GNULIB_MDA_EXECL@
652 /* On native Windows, map 'execl' to '_execl', so that -loldnames is not
653 required. In C++ with GNULIB_NAMESPACE, avoid differences between
654 platforms by defining GNULIB_NAMESPACE::execl always. */
655 # if defined _WIN32 && !defined __CYGWIN__
656 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
657 # undef execl
658 # define execl _execl
659 # endif
660 _GL_CXXALIAS_MDA (execl, intptr_t, (const char *program, const char *arg, ...));
661 # else
662 _GL_CXXALIAS_SYS (execl, int, (const char *program, const char *arg, ...));
663 # endif
664 _GL_CXXALIASWARN (execl);
665 #endif
666
667 #if @GNULIB_EXECLE@
668 # if @REPLACE_EXECLE@
669 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
670 # undef execle
671 # define execle rpl_execle
672 # endif
673 _GL_FUNCDECL_RPL (execle, int, (const char *program, const char *arg, ...)
674 _GL_ARG_NONNULL ((1)));
675 _GL_CXXALIAS_RPL (execle, int, (const char *program, const char *arg, ...));
676 # else
677 _GL_CXXALIAS_SYS (execle, int, (const char *program, const char *arg, ...));
678 # endif
679 _GL_CXXALIASWARN (execle);
680 #elif defined GNULIB_POSIXCHECK
681 # undef execle
682 # if HAVE_RAW_DECL_EXECLE
683 _GL_WARN_ON_USE (execle, "execle behaves very differently on mingw - "
684 "use gnulib module execle for portability");
685 # endif
686 #elif @GNULIB_MDA_EXECLE@
687 /* On native Windows, map 'execle' to '_execle', so that -loldnames is not
688 required. In C++ with GNULIB_NAMESPACE, avoid differences between
689 platforms by defining GNULIB_NAMESPACE::execle always. */
690 # if defined _WIN32 && !defined __CYGWIN__
691 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
692 # undef execle
693 # define execle _execle
694 # endif
695 _GL_CXXALIAS_MDA (execle, intptr_t,
696 (const char *program, const char *arg, ...));
697 # else
698 _GL_CXXALIAS_SYS (execle, int, (const char *program, const char *arg, ...));
699 # endif
700 _GL_CXXALIASWARN (execle);
701 #endif
702
703 #if @GNULIB_EXECLP@
704 # if @REPLACE_EXECLP@
705 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
706 # undef execlp
707 # define execlp rpl_execlp
708 # endif
709 _GL_FUNCDECL_RPL (execlp, int, (const char *program, const char *arg, ...)
710 _GL_ARG_NONNULL ((1)));
711 _GL_CXXALIAS_RPL (execlp, int, (const char *program, const char *arg, ...));
712 # else
713 _GL_CXXALIAS_SYS (execlp, int, (const char *program, const char *arg, ...));
714 # endif
715 _GL_CXXALIASWARN (execlp);
716 #elif defined GNULIB_POSIXCHECK
717 # undef execlp
718 # if HAVE_RAW_DECL_EXECLP
719 _GL_WARN_ON_USE (execlp, "execlp behaves very differently on mingw - "
720 "use gnulib module execlp for portability");
721 # endif
722 #elif @GNULIB_MDA_EXECLP@
723 /* On native Windows, map 'execlp' to '_execlp', so that -loldnames is not
724 required. In C++ with GNULIB_NAMESPACE, avoid differences between
725 platforms by defining GNULIB_NAMESPACE::execlp always. */
726 # if defined _WIN32 && !defined __CYGWIN__
727 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
728 # undef execlp
729 # define execlp _execlp
730 # endif
731 _GL_CXXALIAS_MDA (execlp, intptr_t,
732 (const char *program, const char *arg, ...));
733 # else
734 _GL_CXXALIAS_SYS (execlp, int, (const char *program, const char *arg, ...));
735 # endif
736 _GL_CXXALIASWARN (execlp);
737 #endif
738
739
740 #if @GNULIB_EXECV@
741 # if @REPLACE_EXECV@
742 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
743 # undef execv
744 # define execv rpl_execv
745 # endif
746 _GL_FUNCDECL_RPL (execv, int, (const char *program, char * const *argv)
747 _GL_ARG_NONNULL ((1, 2)));
748 _GL_CXXALIAS_RPL (execv, int, (const char *program, char * const *argv));
749 # else
750 _GL_CXXALIAS_SYS (execv, int, (const char *program, char * const *argv));
751 # endif
752 _GL_CXXALIASWARN (execv);
753 #elif defined GNULIB_POSIXCHECK
754 # undef execv
755 # if HAVE_RAW_DECL_EXECV
756 _GL_WARN_ON_USE (execv, "execv behaves very differently on mingw - "
757 "use gnulib module execv for portability");
758 # endif
759 #elif @GNULIB_MDA_EXECV@
760 /* On native Windows, map 'execv' to '_execv', so that -loldnames is not
761 required. In C++ with GNULIB_NAMESPACE, avoid differences between
762 platforms by defining GNULIB_NAMESPACE::execv always. */
763 # if defined _WIN32 && !defined __CYGWIN__
764 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
765 # undef execv
766 # define execv _execv
767 # endif
768 _GL_CXXALIAS_MDA_CAST (execv, intptr_t,
769 (const char *program, char * const *argv));
770 # else
771 _GL_CXXALIAS_SYS (execv, int, (const char *program, char * const *argv));
772 # endif
773 _GL_CXXALIASWARN (execv);
774 #endif
775
776 #if @GNULIB_EXECVE@
777 # if @REPLACE_EXECVE@
778 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
779 # undef execve
780 # define execve rpl_execve
781 # endif
782 _GL_FUNCDECL_RPL (execve, int,
783 (const char *program, char * const *argv, char * const *env)
784 _GL_ARG_NONNULL ((1, 2)));
785 _GL_CXXALIAS_RPL (execve, int,
786 (const char *program, char * const *argv, char * const *env));
787 # else
788 _GL_CXXALIAS_SYS (execve, int,
789 (const char *program, char * const *argv, char * const *env));
790 # endif
791 _GL_CXXALIASWARN (execve);
792 #elif defined GNULIB_POSIXCHECK
793 # undef execve
794 # if HAVE_RAW_DECL_EXECVE
795 _GL_WARN_ON_USE (execve, "execve behaves very differently on mingw - "
796 "use gnulib module execve for portability");
797 # endif
798 #elif @GNULIB_MDA_EXECVE@
799 /* On native Windows, map 'execve' to '_execve', so that -loldnames is not
800 required. In C++ with GNULIB_NAMESPACE, avoid differences between
801 platforms by defining GNULIB_NAMESPACE::execve always. */
802 # if defined _WIN32 && !defined __CYGWIN__
803 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
804 # undef execve
805 # define execve _execve
806 # endif
807 _GL_CXXALIAS_MDA_CAST (execve, intptr_t,
808 (const char *program, char * const *argv,
809 char * const *env));
810 # else
811 _GL_CXXALIAS_SYS (execve, int,
812 (const char *program, char * const *argv, char * const *env));
813 # endif
814 _GL_CXXALIASWARN (execve);
815 #endif
816
817 #if @GNULIB_EXECVP@
818 # if @REPLACE_EXECVP@
819 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
820 # undef execvp
821 # define execvp rpl_execvp
822 # endif
823 _GL_FUNCDECL_RPL (execvp, int, (const char *program, char * const *argv)
824 _GL_ARG_NONNULL ((1, 2)));
825 _GL_CXXALIAS_RPL (execvp, int, (const char *program, char * const *argv));
826 # else
827 _GL_CXXALIAS_SYS (execvp, int, (const char *program, char * const *argv));
828 # endif
829 _GL_CXXALIASWARN (execvp);
830 #elif defined GNULIB_POSIXCHECK
831 # undef execvp
832 # if HAVE_RAW_DECL_EXECVP
833 _GL_WARN_ON_USE (execvp, "execvp behaves very differently on mingw - "
834 "use gnulib module execvp for portability");
835 # endif
836 #elif @GNULIB_MDA_EXECVP@
837 /* On native Windows, map 'execvp' to '_execvp', so that -loldnames is not
838 required. In C++ with GNULIB_NAMESPACE, avoid differences between
839 platforms by defining GNULIB_NAMESPACE::execvp always. */
840 # if defined _WIN32 && !defined __CYGWIN__
841 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
842 # undef execvp
843 # define execvp _execvp
844 # endif
845 _GL_CXXALIAS_MDA_CAST (execvp, intptr_t,
846 (const char *program, char * const *argv));
847 # else
848 _GL_CXXALIAS_SYS (execvp, int, (const char *program, char * const *argv));
849 # endif
850 _GL_CXXALIASWARN (execvp);
851 #endif
852
853 #if @GNULIB_EXECVPE@
854 # if @REPLACE_EXECVPE@
855 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
856 # undef execvpe
857 # define execvpe rpl_execvpe
858 # endif
859 _GL_FUNCDECL_RPL (execvpe, int,
860 (const char *program, char * const *argv, char * const *env)
861 _GL_ARG_NONNULL ((1, 2)));
862 _GL_CXXALIAS_RPL (execvpe, int,
863 (const char *program, char * const *argv, char * const *env));
864 # else
865 # if !@HAVE_DECL_EXECVPE@
866 _GL_FUNCDECL_SYS (execvpe, int,
867 (const char *program, char * const *argv, char * const *env)
868 _GL_ARG_NONNULL ((1, 2)));
869 # endif
870 _GL_CXXALIAS_SYS (execvpe, int,
871 (const char *program, char * const *argv, char * const *env));
872 # endif
873 _GL_CXXALIASWARN (execvpe);
874 #elif defined GNULIB_POSIXCHECK
875 # undef execvpe
876 # if HAVE_RAW_DECL_EXECVPE
877 _GL_WARN_ON_USE (execvpe, "execvpe behaves very differently on mingw - "
878 "use gnulib module execvpe for portability");
879 # endif
880 #elif @GNULIB_MDA_EXECVPE@
881 /* On native Windows, map 'execvpe' to '_execvpe', so that -loldnames is not
882 required. In C++ with GNULIB_NAMESPACE, avoid differences between
883 platforms by defining GNULIB_NAMESPACE::execvpe on all platforms that have
884 it. */
885 # if defined _WIN32 && !defined __CYGWIN__
886 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
887 # undef execvpe
888 # define execvpe _execvpe
889 # endif
890 _GL_CXXALIAS_MDA_CAST (execvpe, intptr_t,
891 (const char *program, char * const *argv,
892 char * const *env));
893 # elif @HAVE_EXECVPE@
894 # if !@HAVE_DECL_EXECVPE@
895 _GL_FUNCDECL_SYS (execvpe, int,
896 (const char *program, char * const *argv, char * const *env)
897 _GL_ARG_NONNULL ((1, 2)));
898 # endif
899 _GL_CXXALIAS_SYS (execvpe, int,
900 (const char *program, char * const *argv, char * const *env));
901 # endif
902 # if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_EXECVPE@
903 _GL_CXXALIASWARN (execvpe);
904 # endif
905 #endif
906
907
908 #if @GNULIB_FACCESSAT@
909 # if @REPLACE_FACCESSAT@
910 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
911 # undef faccessat
912 # define faccessat rpl_faccessat
913 # endif
914 _GL_FUNCDECL_RPL (faccessat, int,
915 (int fd, char const *name, int mode, int flag)
916 _GL_ARG_NONNULL ((2)));
917 _GL_CXXALIAS_RPL (faccessat, int,
918 (int fd, char const *name, int mode, int flag));
919 # else
920 # if !@HAVE_FACCESSAT@
921 _GL_FUNCDECL_SYS (faccessat, int,
922 (int fd, char const *file, int mode, int flag)
923 _GL_ARG_NONNULL ((2)));
924 # endif
925 _GL_CXXALIAS_SYS (faccessat, int,
926 (int fd, char const *file, int mode, int flag));
927 # endif
928 _GL_CXXALIASWARN (faccessat);
929 #elif defined GNULIB_POSIXCHECK
930 # undef faccessat
931 # if HAVE_RAW_DECL_FACCESSAT
932 _GL_WARN_ON_USE (faccessat, "faccessat is not portable - "
933 "use gnulib module faccessat for portability");
934 # endif
935 #endif
936
937
938 #if @GNULIB_FCHDIR@
939 /* Change the process' current working directory to the directory on which
940 the given file descriptor is open.
941 Return 0 if successful, otherwise -1 and errno set.
942 See the POSIX:2008 specification
943 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fchdir.html>. */
944 # if ! @HAVE_FCHDIR@
945 _GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/));
946
947 /* Gnulib internal hooks needed to maintain the fchdir metadata. */
948 _GL_EXTERN_C int _gl_register_fd (int fd, const char *filename)
949 _GL_ARG_NONNULL ((2));
950 _GL_EXTERN_C void _gl_unregister_fd (int fd);
951 _GL_EXTERN_C int _gl_register_dup (int oldfd, int newfd);
952 _GL_EXTERN_C const char *_gl_directory_name (int fd);
953
954 # else
955 # if !@HAVE_DECL_FCHDIR@
956 _GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/));
957 # endif
958 # endif
959 _GL_CXXALIAS_SYS (fchdir, int, (int /*fd*/));
960 _GL_CXXALIASWARN (fchdir);
961 #elif defined GNULIB_POSIXCHECK
962 # undef fchdir
963 # if HAVE_RAW_DECL_FCHDIR
964 _GL_WARN_ON_USE (fchdir, "fchdir is unportable - "
965 "use gnulib module fchdir for portability");
966 # endif
967 #endif
968
969
970 #if @GNULIB_FCHOWNAT@
971 # if @REPLACE_FCHOWNAT@
972 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
973 # undef fchownat
974 # define fchownat rpl_fchownat
975 # endif
976 _GL_FUNCDECL_RPL (fchownat, int, (int fd, char const *file,
977 uid_t owner, gid_t group, int flag)
978 _GL_ARG_NONNULL ((2)));
979 _GL_CXXALIAS_RPL (fchownat, int, (int fd, char const *file,
980 uid_t owner, gid_t group, int flag));
981 # else
982 # if !@HAVE_FCHOWNAT@
983 _GL_FUNCDECL_SYS (fchownat, int, (int fd, char const *file,
984 uid_t owner, gid_t group, int flag)
985 _GL_ARG_NONNULL ((2)));
986 # endif
987 _GL_CXXALIAS_SYS (fchownat, int, (int fd, char const *file,
988 uid_t owner, gid_t group, int flag));
989 # endif
990 _GL_CXXALIASWARN (fchownat);
991 #elif defined GNULIB_POSIXCHECK
992 # undef fchownat
993 # if HAVE_RAW_DECL_FCHOWNAT
994 _GL_WARN_ON_USE (fchownat, "fchownat is not portable - "
995 "use gnulib module fchownat for portability");
996 # endif
997 #endif
998
999
1000 #if @GNULIB_FDATASYNC@
1001 /* Synchronize changes to a file.
1002 Return 0 if successful, otherwise -1 and errno set.
1003 See POSIX:2008 specification
1004 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fdatasync.html>. */
1005 # if !@HAVE_FDATASYNC@ || !@HAVE_DECL_FDATASYNC@
1006 _GL_FUNCDECL_SYS (fdatasync, int, (int fd));
1007 # endif
1008 _GL_CXXALIAS_SYS (fdatasync, int, (int fd));
1009 _GL_CXXALIASWARN (fdatasync);
1010 #elif defined GNULIB_POSIXCHECK
1011 # undef fdatasync
1012 # if HAVE_RAW_DECL_FDATASYNC
1013 _GL_WARN_ON_USE (fdatasync, "fdatasync is unportable - "
1014 "use gnulib module fdatasync for portability");
1015 # endif
1016 #endif
1017
1018
1019 #if @GNULIB_FSYNC@
1020 /* Synchronize changes, including metadata, to a file.
1021 Return 0 if successful, otherwise -1 and errno set.
1022 See POSIX:2008 specification
1023 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fsync.html>. */
1024 # if !@HAVE_FSYNC@
1025 _GL_FUNCDECL_SYS (fsync, int, (int fd));
1026 # endif
1027 _GL_CXXALIAS_SYS (fsync, int, (int fd));
1028 _GL_CXXALIASWARN (fsync);
1029 #elif defined GNULIB_POSIXCHECK
1030 # undef fsync
1031 # if HAVE_RAW_DECL_FSYNC
1032 _GL_WARN_ON_USE (fsync, "fsync is unportable - "
1033 "use gnulib module fsync for portability");
1034 # endif
1035 #endif
1036
1037
1038 #if @GNULIB_FTRUNCATE@
1039 /* Change the size of the file to which FD is opened to become equal to LENGTH.
1040 Return 0 if successful, otherwise -1 and errno set.
1041 See the POSIX:2008 specification
1042 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/ftruncate.html>. */
1043 # if @REPLACE_FTRUNCATE@
1044 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1045 # undef ftruncate
1046 # define ftruncate rpl_ftruncate
1047 # endif
1048 _GL_FUNCDECL_RPL (ftruncate, int, (int fd, off_t length));
1049 _GL_CXXALIAS_RPL (ftruncate, int, (int fd, off_t length));
1050 # else
1051 # if !@HAVE_FTRUNCATE@
1052 _GL_FUNCDECL_SYS (ftruncate, int, (int fd, off_t length));
1053 # endif
1054 _GL_CXXALIAS_SYS (ftruncate, int, (int fd, off_t length));
1055 # endif
1056 _GL_CXXALIASWARN (ftruncate);
1057 #elif defined GNULIB_POSIXCHECK
1058 # undef ftruncate
1059 # if HAVE_RAW_DECL_FTRUNCATE
1060 _GL_WARN_ON_USE (ftruncate, "ftruncate is unportable - "
1061 "use gnulib module ftruncate for portability");
1062 # endif
1063 #endif
1064
1065
1066 #if @GNULIB_GETCWD@
1067 /* Get the name of the current working directory, and put it in SIZE bytes
1068 of BUF.
1069 Return BUF if successful, or NULL if the directory couldn't be determined
1070 or SIZE was too small.
1071 See the POSIX:2008 specification
1072 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getcwd.html>.
1073 Additionally, the gnulib module 'getcwd' guarantees the following GNU
1074 extension: If BUF is NULL, an array is allocated with 'malloc'; the array
1075 is SIZE bytes long, unless SIZE == 0, in which case it is as big as
1076 necessary. */
1077 # if @REPLACE_GETCWD@
1078 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1079 # define getcwd rpl_getcwd
1080 # endif
1081 _GL_FUNCDECL_RPL (getcwd, char *, (char *buf, size_t size));
1082 _GL_CXXALIAS_RPL (getcwd, char *, (char *buf, size_t size));
1083 # elif defined _WIN32 && !defined __CYGWIN__
1084 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1085 # undef getcwd
1086 # define getcwd _getcwd
1087 # endif
1088 _GL_CXXALIAS_MDA (getcwd, char *, (char *buf, size_t size));
1089 # else
1090 /* Need to cast, because on mingw, the second parameter is
1091 int size. */
1092 _GL_CXXALIAS_SYS_CAST (getcwd, char *, (char *buf, size_t size));
1093 # endif
1094 _GL_CXXALIASWARN (getcwd);
1095 #elif defined GNULIB_POSIXCHECK
1096 # undef getcwd
1097 # if HAVE_RAW_DECL_GETCWD
1098 _GL_WARN_ON_USE (getcwd, "getcwd is unportable - "
1099 "use gnulib module getcwd for portability");
1100 # endif
1101 #elif @GNULIB_MDA_GETCWD@
1102 /* On native Windows, map 'getcwd' to '_getcwd', so that -loldnames is not
1103 required. In C++ with GNULIB_NAMESPACE, avoid differences between
1104 platforms by defining GNULIB_NAMESPACE::getcwd always. */
1105 # if defined _WIN32 && !defined __CYGWIN__
1106 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1107 # undef getcwd
1108 # define getcwd _getcwd
1109 # endif
1110 /* Need to cast, because on mingw, the second parameter is either
1111 'int size' or 'size_t size'. */
1112 _GL_CXXALIAS_MDA_CAST (getcwd, char *, (char *buf, size_t size));
1113 # else
1114 _GL_CXXALIAS_SYS_CAST (getcwd, char *, (char *buf, size_t size));
1115 # endif
1116 _GL_CXXALIASWARN (getcwd);
1117 #endif
1118
1119
1120 #if @GNULIB_GETDOMAINNAME@
1121 /* Return the NIS domain name of the machine.
1122 WARNING! The NIS domain name is unrelated to the fully qualified host name
1123 of the machine. It is also unrelated to email addresses.
1124 WARNING! The NIS domain name is usually the empty string or "(none)" when
1125 not using NIS.
1126
1127 Put up to LEN bytes of the NIS domain name into NAME.
1128 Null terminate it if the name is shorter than LEN.
1129 If the NIS domain name is longer than LEN, set errno = EINVAL and return -1.
1130 Return 0 if successful, otherwise set errno and return -1. */
1131 # if @REPLACE_GETDOMAINNAME@
1132 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1133 # undef getdomainname
1134 # define getdomainname rpl_getdomainname
1135 # endif
1136 _GL_FUNCDECL_RPL (getdomainname, int, (char *name, size_t len)
1137 _GL_ARG_NONNULL ((1)));
1138 _GL_CXXALIAS_RPL (getdomainname, int, (char *name, size_t len));
1139 # else
1140 # if !@HAVE_DECL_GETDOMAINNAME@
1141 _GL_FUNCDECL_SYS (getdomainname, int, (char *name, size_t len)
1142 _GL_ARG_NONNULL ((1)));
1143 # endif
1144 _GL_CXXALIAS_SYS (getdomainname, int, (char *name, size_t len));
1145 # endif
1146 _GL_CXXALIASWARN (getdomainname);
1147 #elif defined GNULIB_POSIXCHECK
1148 # undef getdomainname
1149 # if HAVE_RAW_DECL_GETDOMAINNAME
1150 _GL_WARN_ON_USE (getdomainname, "getdomainname is unportable - "
1151 "use gnulib module getdomainname for portability");
1152 # endif
1153 #endif
1154
1155
1156 #if @GNULIB_GETDTABLESIZE@
1157 /* Return the maximum number of file descriptors in the current process.
1158 In POSIX, this is same as sysconf (_SC_OPEN_MAX). */
1159 # if @REPLACE_GETDTABLESIZE@
1160 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1161 # undef getdtablesize
1162 # define getdtablesize rpl_getdtablesize
1163 # endif
1164 _GL_FUNCDECL_RPL (getdtablesize, int, (void));
1165 _GL_CXXALIAS_RPL (getdtablesize, int, (void));
1166 # else
1167 # if !@HAVE_GETDTABLESIZE@
1168 _GL_FUNCDECL_SYS (getdtablesize, int, (void));
1169 # endif
1170 /* Need to cast, because on AIX, the parameter list is
1171 (...). */
1172 _GL_CXXALIAS_SYS_CAST (getdtablesize, int, (void));
1173 # endif
1174 _GL_CXXALIASWARN (getdtablesize);
1175 #elif defined GNULIB_POSIXCHECK
1176 # undef getdtablesize
1177 # if HAVE_RAW_DECL_GETDTABLESIZE
1178 _GL_WARN_ON_USE (getdtablesize, "getdtablesize is unportable - "
1179 "use gnulib module getdtablesize for portability");
1180 # endif
1181 #endif
1182
1183
1184 #if @GNULIB_GETENTROPY@
1185 /* Fill a buffer with random bytes. */
1186 # if !@HAVE_GETENTROPY@
1187 _GL_FUNCDECL_SYS (getentropy, int, (void *buffer, size_t length));
1188 # endif
1189 _GL_CXXALIAS_SYS (getentropy, int, (void *buffer, size_t length));
1190 _GL_CXXALIASWARN (getentropy);
1191 #elif defined GNULIB_POSIXCHECK
1192 # undef getentropy
1193 # if HAVE_RAW_DECL_GETENTROPY
1194 _GL_WARN_ON_USE (getentropy, "getentropy is unportable - "
1195 "use gnulib module getentropy for portability");
1196 # endif
1197 #endif
1198
1199
1200 #if @GNULIB_GETGROUPS@
1201 /* Return the supplemental groups that the current process belongs to.
1202 It is unspecified whether the effective group id is in the list.
1203 If N is 0, return the group count; otherwise, N describes how many
1204 entries are available in GROUPS. Return -1 and set errno if N is
1205 not 0 and not large enough. Fails with ENOSYS on some systems. */
1206 # if @REPLACE_GETGROUPS@
1207 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1208 # undef getgroups
1209 # define getgroups rpl_getgroups
1210 # endif
1211 _GL_FUNCDECL_RPL (getgroups, int, (int n, gid_t *groups));
1212 _GL_CXXALIAS_RPL (getgroups, int, (int n, gid_t *groups));
1213 # else
1214 # if !@HAVE_GETGROUPS@
1215 _GL_FUNCDECL_SYS (getgroups, int, (int n, gid_t *groups));
1216 # endif
1217 _GL_CXXALIAS_SYS (getgroups, int, (int n, gid_t *groups));
1218 # endif
1219 _GL_CXXALIASWARN (getgroups);
1220 #elif defined GNULIB_POSIXCHECK
1221 # undef getgroups
1222 # if HAVE_RAW_DECL_GETGROUPS
1223 _GL_WARN_ON_USE (getgroups, "getgroups is unportable - "
1224 "use gnulib module getgroups for portability");
1225 # endif
1226 #endif
1227
1228
1229 #if @GNULIB_GETHOSTNAME@
1230 /* Return the standard host name of the machine.
1231 WARNING! The host name may or may not be fully qualified.
1232
1233 Put up to LEN bytes of the host name into NAME.
1234 Null terminate it if the name is shorter than LEN.
1235 If the host name is longer than LEN, set errno = EINVAL and return -1.
1236 Return 0 if successful, otherwise set errno and return -1. */
1237 # if @UNISTD_H_HAVE_WINSOCK2_H@
1238 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1239 # undef gethostname
1240 # define gethostname rpl_gethostname
1241 # endif
1242 _GL_FUNCDECL_RPL (gethostname, int, (char *name, size_t len)
1243 _GL_ARG_NONNULL ((1)));
1244 _GL_CXXALIAS_RPL (gethostname, int, (char *name, size_t len));
1245 # else
1246 # if !@HAVE_GETHOSTNAME@
1247 _GL_FUNCDECL_SYS (gethostname, int, (char *name, size_t len)
1248 _GL_ARG_NONNULL ((1)));
1249 # endif
1250 /* Need to cast, because on Solaris 10 and OSF/1 5.1 systems, the second
1251 parameter is
1252 int len. */
1253 _GL_CXXALIAS_SYS_CAST (gethostname, int, (char *name, size_t len));
1254 # endif
1255 _GL_CXXALIASWARN (gethostname);
1256 #elif @UNISTD_H_HAVE_WINSOCK2_H@
1257 # undef gethostname
1258 # define gethostname gethostname_used_without_requesting_gnulib_module_gethostname
1259 #elif defined GNULIB_POSIXCHECK
1260 # undef gethostname
1261 # if HAVE_RAW_DECL_GETHOSTNAME
1262 _GL_WARN_ON_USE (gethostname, "gethostname is unportable - "
1263 "use gnulib module gethostname for portability");
1264 # endif
1265 #endif
1266
1267
1268 #if @GNULIB_GETLOGIN@
1269 /* Returns the user's login name, or NULL if it cannot be found. Upon error,
1270 returns NULL with errno set.
1271
1272 See <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getlogin.html>.
1273
1274 Most programs don't need to use this function, because the information is
1275 available through environment variables:
1276 ${LOGNAME-$USER} on Unix platforms,
1277 $USERNAME on native Windows platforms.
1278 */
1279 # if !@HAVE_DECL_GETLOGIN@
1280 _GL_FUNCDECL_SYS (getlogin, char *, (void));
1281 # endif
1282 _GL_CXXALIAS_SYS (getlogin, char *, (void));
1283 _GL_CXXALIASWARN (getlogin);
1284 #elif defined GNULIB_POSIXCHECK
1285 # undef getlogin
1286 # if HAVE_RAW_DECL_GETLOGIN
1287 _GL_WARN_ON_USE (getlogin, "getlogin is unportable - "
1288 "use gnulib module getlogin for portability");
1289 # endif
1290 #endif
1291
1292
1293 #if @GNULIB_GETLOGIN_R@
1294 /* Copies the user's login name to NAME.
1295 The array pointed to by NAME has room for SIZE bytes.
1296
1297 Returns 0 if successful. Upon error, an error number is returned, or -1 in
1298 the case that the login name cannot be found but no specific error is
1299 provided (this case is hopefully rare but is left open by the POSIX spec).
1300
1301 See <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getlogin.html>.
1302
1303 Most programs don't need to use this function, because the information is
1304 available through environment variables:
1305 ${LOGNAME-$USER} on Unix platforms,
1306 $USERNAME on native Windows platforms.
1307 */
1308 # if @REPLACE_GETLOGIN_R@
1309 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1310 # define getlogin_r rpl_getlogin_r
1311 # endif
1312 _GL_FUNCDECL_RPL (getlogin_r, int, (char *name, size_t size)
1313 _GL_ARG_NONNULL ((1)));
1314 _GL_CXXALIAS_RPL (getlogin_r, int, (char *name, size_t size));
1315 # else
1316 # if !@HAVE_DECL_GETLOGIN_R@
1317 _GL_FUNCDECL_SYS (getlogin_r, int, (char *name, size_t size)
1318 _GL_ARG_NONNULL ((1)));
1319 # endif
1320 /* Need to cast, because on Solaris 10 systems, the second argument is
1321 int size. */
1322 _GL_CXXALIAS_SYS_CAST (getlogin_r, int, (char *name, size_t size));
1323 # endif
1324 _GL_CXXALIASWARN (getlogin_r);
1325 #elif defined GNULIB_POSIXCHECK
1326 # undef getlogin_r
1327 # if HAVE_RAW_DECL_GETLOGIN_R
1328 _GL_WARN_ON_USE (getlogin_r, "getlogin_r is unportable - "
1329 "use gnulib module getlogin_r for portability");
1330 # endif
1331 #endif
1332
1333
1334 #if @GNULIB_GETPAGESIZE@
1335 # if @REPLACE_GETPAGESIZE@
1336 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1337 # define getpagesize rpl_getpagesize
1338 # endif
1339 _GL_FUNCDECL_RPL (getpagesize, int, (void));
1340 _GL_CXXALIAS_RPL (getpagesize, int, (void));
1341 # else
1342 /* On HP-UX, getpagesize exists, but it is not declared in <unistd.h> even if
1343 the compiler options -D_HPUX_SOURCE -D_XOPEN_SOURCE=600 are used. */
1344 # if defined __hpux
1345 _GL_FUNCDECL_SYS (getpagesize, int, (void));
1346 # endif
1347 # if !@HAVE_GETPAGESIZE@
1348 # if !defined getpagesize
1349 /* This is for POSIX systems. */
1350 # if !defined _gl_getpagesize && defined _SC_PAGESIZE
1351 # if ! (defined __VMS && __VMS_VER < 70000000)
1352 # define _gl_getpagesize() sysconf (_SC_PAGESIZE)
1353 # endif
1354 # endif
1355 /* This is for older VMS. */
1356 # if !defined _gl_getpagesize && defined __VMS
1357 # ifdef __ALPHA
1358 # define _gl_getpagesize() 8192
1359 # else
1360 # define _gl_getpagesize() 512
1361 # endif
1362 # endif
1363 /* This is for BeOS. */
1364 # if !defined _gl_getpagesize && @HAVE_OS_H@
1365 # include <OS.h>
1366 # if defined B_PAGE_SIZE
1367 # define _gl_getpagesize() B_PAGE_SIZE
1368 # endif
1369 # endif
1370 /* This is for AmigaOS4.0. */
1371 # if !defined _gl_getpagesize && defined __amigaos4__
1372 # define _gl_getpagesize() 2048
1373 # endif
1374 /* This is for older Unix systems. */
1375 # if !defined _gl_getpagesize && @HAVE_SYS_PARAM_H@
1376 # include <sys/param.h>
1377 # ifdef EXEC_PAGESIZE
1378 # define _gl_getpagesize() EXEC_PAGESIZE
1379 # else
1380 # ifdef NBPG
1381 # ifndef CLSIZE
1382 # define CLSIZE 1
1383 # endif
1384 # define _gl_getpagesize() (NBPG * CLSIZE)
1385 # else
1386 # ifdef NBPC
1387 # define _gl_getpagesize() NBPC
1388 # endif
1389 # endif
1390 # endif
1391 # endif
1392 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1393 # define getpagesize() _gl_getpagesize ()
1394 # else
1395 # if !GNULIB_defined_getpagesize_function
1396 _GL_UNISTD_INLINE int
1397 getpagesize ()
1398 {
1399 return _gl_getpagesize ();
1400 }
1401 # define GNULIB_defined_getpagesize_function 1
1402 # endif
1403 # endif
1404 # endif
1405 # endif
1406 /* Need to cast, because on Cygwin 1.5.x systems, the return type is size_t. */
1407 _GL_CXXALIAS_SYS_CAST (getpagesize, int, (void));
1408 # endif
1409 # if @HAVE_DECL_GETPAGESIZE@
1410 _GL_CXXALIASWARN (getpagesize);
1411 # endif
1412 #elif defined GNULIB_POSIXCHECK
1413 # undef getpagesize
1414 # if HAVE_RAW_DECL_GETPAGESIZE
1415 _GL_WARN_ON_USE (getpagesize, "getpagesize is unportable - "
1416 "use gnulib module getpagesize for portability");
1417 # endif
1418 #endif
1419
1420
1421 #if @GNULIB_GETPASS@
1422 /* Function getpass() from module 'getpass':
1423 Read a password from /dev/tty or stdin.
1424 Function getpass() from module 'getpass-gnu':
1425 Read a password of arbitrary length from /dev/tty or stdin. */
1426 # if (@GNULIB_GETPASS@ && @REPLACE_GETPASS@) \
1427 || (@GNULIB_GETPASS_GNU@ && @REPLACE_GETPASS_FOR_GETPASS_GNU@)
1428 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1429 # undef getpass
1430 # define getpass rpl_getpass
1431 # endif
1432 _GL_FUNCDECL_RPL (getpass, char *, (const char *prompt)
1433 _GL_ARG_NONNULL ((1)));
1434 _GL_CXXALIAS_RPL (getpass, char *, (const char *prompt));
1435 # else
1436 # if !@HAVE_GETPASS@
1437 _GL_FUNCDECL_SYS (getpass, char *, (const char *prompt)
1438 _GL_ARG_NONNULL ((1)));
1439 # endif
1440 _GL_CXXALIAS_SYS (getpass, char *, (const char *prompt));
1441 # endif
1442 _GL_CXXALIASWARN (getpass);
1443 #elif defined GNULIB_POSIXCHECK
1444 # undef getpass
1445 # if HAVE_RAW_DECL_GETPASS
1446 _GL_WARN_ON_USE (getpass, "getpass is unportable - "
1447 "use gnulib module getpass or getpass-gnu for portability");
1448 # endif
1449 #endif
1450
1451
1452 #if @GNULIB_MDA_GETPID@
1453 /* On native Windows, map 'getpid' to '_getpid', so that -loldnames is not
1454 required. In C++ with GNULIB_NAMESPACE, avoid differences between
1455 platforms by defining GNULIB_NAMESPACE::getpid always. */
1456 # if defined _WIN32 && !defined __CYGWIN__
1457 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1458 # undef getpid
1459 # define getpid _getpid
1460 # endif
1461 _GL_CXXALIAS_MDA (getpid, int, (void));
1462 # else
1463 _GL_CXXALIAS_SYS (getpid, pid_t, (void));
1464 # endif
1465 _GL_CXXALIASWARN (getpid);
1466 #endif
1467
1468
1469 #if @GNULIB_GETUSERSHELL@
1470 /* Return the next valid login shell on the system, or NULL when the end of
1471 the list has been reached. */
1472 # if !@HAVE_DECL_GETUSERSHELL@
1473 _GL_FUNCDECL_SYS (getusershell, char *, (void));
1474 # endif
1475 _GL_CXXALIAS_SYS (getusershell, char *, (void));
1476 _GL_CXXALIASWARN (getusershell);
1477 #elif defined GNULIB_POSIXCHECK
1478 # undef getusershell
1479 # if HAVE_RAW_DECL_GETUSERSHELL
1480 _GL_WARN_ON_USE (getusershell, "getusershell is unportable - "
1481 "use gnulib module getusershell for portability");
1482 # endif
1483 #endif
1484
1485 #if @GNULIB_GETUSERSHELL@
1486 /* Rewind to pointer that is advanced at each getusershell() call. */
1487 # if !@HAVE_DECL_GETUSERSHELL@
1488 _GL_FUNCDECL_SYS (setusershell, void, (void));
1489 # endif
1490 _GL_CXXALIAS_SYS (setusershell, void, (void));
1491 _GL_CXXALIASWARN (setusershell);
1492 #elif defined GNULIB_POSIXCHECK
1493 # undef setusershell
1494 # if HAVE_RAW_DECL_SETUSERSHELL
1495 _GL_WARN_ON_USE (setusershell, "setusershell is unportable - "
1496 "use gnulib module getusershell for portability");
1497 # endif
1498 #endif
1499
1500 #if @GNULIB_GETUSERSHELL@
1501 /* Free the pointer that is advanced at each getusershell() call and
1502 associated resources. */
1503 # if !@HAVE_DECL_GETUSERSHELL@
1504 _GL_FUNCDECL_SYS (endusershell, void, (void));
1505 # endif
1506 _GL_CXXALIAS_SYS (endusershell, void, (void));
1507 _GL_CXXALIASWARN (endusershell);
1508 #elif defined GNULIB_POSIXCHECK
1509 # undef endusershell
1510 # if HAVE_RAW_DECL_ENDUSERSHELL
1511 _GL_WARN_ON_USE (endusershell, "endusershell is unportable - "
1512 "use gnulib module getusershell for portability");
1513 # endif
1514 #endif
1515
1516
1517 #if @GNULIB_GROUP_MEMBER@
1518 /* Determine whether group id is in calling user's group list. */
1519 # if !@HAVE_GROUP_MEMBER@
1520 _GL_FUNCDECL_SYS (group_member, int, (gid_t gid));
1521 # endif
1522 _GL_CXXALIAS_SYS (group_member, int, (gid_t gid));
1523 _GL_CXXALIASWARN (group_member);
1524 #elif defined GNULIB_POSIXCHECK
1525 # undef group_member
1526 # if HAVE_RAW_DECL_GROUP_MEMBER
1527 _GL_WARN_ON_USE (group_member, "group_member is unportable - "
1528 "use gnulib module group-member for portability");
1529 # endif
1530 #endif
1531
1532
1533 #if @GNULIB_ISATTY@
1534 # if @REPLACE_ISATTY@
1535 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1536 # undef isatty
1537 # define isatty rpl_isatty
1538 # endif
1539 # define GNULIB_defined_isatty 1
1540 _GL_FUNCDECL_RPL (isatty, int, (int fd));
1541 _GL_CXXALIAS_RPL (isatty, int, (int fd));
1542 # elif defined _WIN32 && !defined __CYGWIN__
1543 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1544 # undef isatty
1545 # define isatty _isatty
1546 # endif
1547 _GL_CXXALIAS_MDA (isatty, int, (int fd));
1548 # else
1549 _GL_CXXALIAS_SYS (isatty, int, (int fd));
1550 # endif
1551 _GL_CXXALIASWARN (isatty);
1552 #elif defined GNULIB_POSIXCHECK
1553 # undef isatty
1554 # if HAVE_RAW_DECL_ISATTY
1555 _GL_WARN_ON_USE (isatty, "isatty has portability problems on native Windows - "
1556 "use gnulib module isatty for portability");
1557 # endif
1558 #elif @GNULIB_MDA_ISATTY@
1559 /* On native Windows, map 'isatty' to '_isatty', so that -loldnames is not
1560 required. In C++ with GNULIB_NAMESPACE, avoid differences between
1561 platforms by defining GNULIB_NAMESPACE::isatty always. */
1562 # if defined _WIN32 && !defined __CYGWIN__
1563 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1564 # undef isatty
1565 # define isatty _isatty
1566 # endif
1567 _GL_CXXALIAS_MDA (isatty, int, (int fd));
1568 # else
1569 _GL_CXXALIAS_SYS (isatty, int, (int fd));
1570 # endif
1571 _GL_CXXALIASWARN (isatty);
1572 #endif
1573
1574
1575 #if @GNULIB_LCHOWN@
1576 /* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
1577 to GID (if GID is not -1). Do not follow symbolic links.
1578 Return 0 if successful, otherwise -1 and errno set.
1579 See the POSIX:2008 specification
1580 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/lchown.html>. */
1581 # if @REPLACE_LCHOWN@
1582 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1583 # undef lchown
1584 # define lchown rpl_lchown
1585 # endif
1586 _GL_FUNCDECL_RPL (lchown, int, (char const *file, uid_t owner, gid_t group)
1587 _GL_ARG_NONNULL ((1)));
1588 _GL_CXXALIAS_RPL (lchown, int, (char const *file, uid_t owner, gid_t group));
1589 # else
1590 # if !@HAVE_LCHOWN@
1591 _GL_FUNCDECL_SYS (lchown, int, (char const *file, uid_t owner, gid_t group)
1592 _GL_ARG_NONNULL ((1)));
1593 # endif
1594 _GL_CXXALIAS_SYS (lchown, int, (char const *file, uid_t owner, gid_t group));
1595 # endif
1596 _GL_CXXALIASWARN (lchown);
1597 #elif defined GNULIB_POSIXCHECK
1598 # undef lchown
1599 # if HAVE_RAW_DECL_LCHOWN
1600 _GL_WARN_ON_USE (lchown, "lchown is unportable to pre-POSIX.1-2001 systems - "
1601 "use gnulib module lchown for portability");
1602 # endif
1603 #endif
1604
1605
1606 #if @GNULIB_LINK@
1607 /* Create a new hard link for an existing file.
1608 Return 0 if successful, otherwise -1 and errno set.
1609 See POSIX:2008 specification
1610 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/link.html>. */
1611 # if @REPLACE_LINK@
1612 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1613 # define link rpl_link
1614 # endif
1615 _GL_FUNCDECL_RPL (link, int, (const char *path1, const char *path2)
1616 _GL_ARG_NONNULL ((1, 2)));
1617 _GL_CXXALIAS_RPL (link, int, (const char *path1, const char *path2));
1618 # else
1619 # if !@HAVE_LINK@
1620 _GL_FUNCDECL_SYS (link, int, (const char *path1, const char *path2)
1621 _GL_ARG_NONNULL ((1, 2)));
1622 # endif
1623 _GL_CXXALIAS_SYS (link, int, (const char *path1, const char *path2));
1624 # endif
1625 _GL_CXXALIASWARN (link);
1626 #elif defined GNULIB_POSIXCHECK
1627 # undef link
1628 # if HAVE_RAW_DECL_LINK
1629 _GL_WARN_ON_USE (link, "link is unportable - "
1630 "use gnulib module link for portability");
1631 # endif
1632 #endif
1633
1634
1635 #if @GNULIB_LINKAT@
1636 /* Create a new hard link for an existing file, relative to two
1637 directories. FLAG controls whether symlinks are followed.
1638 Return 0 if successful, otherwise -1 and errno set. */
1639 # if @REPLACE_LINKAT@
1640 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1641 # undef linkat
1642 # define linkat rpl_linkat
1643 # endif
1644 _GL_FUNCDECL_RPL (linkat, int,
1645 (int fd1, const char *path1, int fd2, const char *path2,
1646 int flag)
1647 _GL_ARG_NONNULL ((2, 4)));
1648 _GL_CXXALIAS_RPL (linkat, int,
1649 (int fd1, const char *path1, int fd2, const char *path2,
1650 int flag));
1651 # else
1652 # if !@HAVE_LINKAT@
1653 _GL_FUNCDECL_SYS (linkat, int,
1654 (int fd1, const char *path1, int fd2, const char *path2,
1655 int flag)
1656 _GL_ARG_NONNULL ((2, 4)));
1657 # endif
1658 _GL_CXXALIAS_SYS (linkat, int,
1659 (int fd1, const char *path1, int fd2, const char *path2,
1660 int flag));
1661 # endif
1662 _GL_CXXALIASWARN (linkat);
1663 #elif defined GNULIB_POSIXCHECK
1664 # undef linkat
1665 # if HAVE_RAW_DECL_LINKAT
1666 _GL_WARN_ON_USE (linkat, "linkat is unportable - "
1667 "use gnulib module linkat for portability");
1668 # endif
1669 #endif
1670
1671
1672 #if @GNULIB_LSEEK@
1673 /* Set the offset of FD relative to SEEK_SET, SEEK_CUR, or SEEK_END.
1674 Return the new offset if successful, otherwise -1 and errno set.
1675 See the POSIX:2008 specification
1676 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/lseek.html>. */
1677 # if @REPLACE_LSEEK@
1678 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1679 # define lseek rpl_lseek
1680 # endif
1681 _GL_FUNCDECL_RPL (lseek, off_t, (int fd, off_t offset, int whence));
1682 _GL_CXXALIAS_RPL (lseek, off_t, (int fd, off_t offset, int whence));
1683 # elif defined _WIN32 && !defined __CYGWIN__
1684 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1685 # undef lseek
1686 # define lseek _lseek
1687 # endif
1688 _GL_CXXALIAS_MDA (lseek, off_t, (int fd, off_t offset, int whence));
1689 # else
1690 _GL_CXXALIAS_SYS (lseek, off_t, (int fd, off_t offset, int whence));
1691 # endif
1692 _GL_CXXALIASWARN (lseek);
1693 #elif defined GNULIB_POSIXCHECK
1694 # undef lseek
1695 # if HAVE_RAW_DECL_LSEEK
1696 _GL_WARN_ON_USE (lseek, "lseek does not fail with ESPIPE on pipes on some "
1697 "systems - use gnulib module lseek for portability");
1698 # endif
1699 #elif @GNULIB_MDA_LSEEK@
1700 /* On native Windows, map 'lseek' to '_lseek', so that -loldnames is not
1701 required. In C++ with GNULIB_NAMESPACE, avoid differences between
1702 platforms by defining GNULIB_NAMESPACE::lseek always. */
1703 # if defined _WIN32 && !defined __CYGWIN__
1704 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1705 # undef lseek
1706 # define lseek _lseek
1707 # endif
1708 _GL_CXXALIAS_MDA (lseek, long, (int fd, long offset, int whence));
1709 # else
1710 _GL_CXXALIAS_SYS (lseek, off_t, (int fd, off_t offset, int whence));
1711 # endif
1712 _GL_CXXALIASWARN (lseek);
1713 #endif
1714
1715
1716 #if @GNULIB_PIPE@
1717 /* Create a pipe, defaulting to O_BINARY mode.
1718 Store the read-end as fd[0] and the write-end as fd[1].
1719 Return 0 upon success, or -1 with errno set upon failure. */
1720 # if !@HAVE_PIPE@
1721 _GL_FUNCDECL_SYS (pipe, int, (int fd[2]) _GL_ARG_NONNULL ((1)));
1722 # endif
1723 _GL_CXXALIAS_SYS (pipe, int, (int fd[2]));
1724 _GL_CXXALIASWARN (pipe);
1725 #elif defined GNULIB_POSIXCHECK
1726 # undef pipe
1727 # if HAVE_RAW_DECL_PIPE
1728 _GL_WARN_ON_USE (pipe, "pipe is unportable - "
1729 "use gnulib module pipe-posix for portability");
1730 # endif
1731 #endif
1732
1733
1734 #if @GNULIB_PIPE2@
1735 /* Create a pipe, applying the given flags when opening the read-end of the
1736 pipe and the write-end of the pipe.
1737 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
1738 and O_TEXT, O_BINARY (defined in "binary-io.h").
1739 Store the read-end as fd[0] and the write-end as fd[1].
1740 Return 0 upon success, or -1 with errno set upon failure.
1741 See also the Linux man page at
1742 <https://www.kernel.org/doc/man-pages/online/pages/man2/pipe2.2.html>. */
1743 # if @HAVE_PIPE2@
1744 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1745 # define pipe2 rpl_pipe2
1746 # endif
1747 _GL_FUNCDECL_RPL (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1)));
1748 _GL_CXXALIAS_RPL (pipe2, int, (int fd[2], int flags));
1749 # else
1750 _GL_FUNCDECL_SYS (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1)));
1751 _GL_CXXALIAS_SYS (pipe2, int, (int fd[2], int flags));
1752 # endif
1753 _GL_CXXALIASWARN (pipe2);
1754 #elif defined GNULIB_POSIXCHECK
1755 # undef pipe2
1756 # if HAVE_RAW_DECL_PIPE2
1757 _GL_WARN_ON_USE (pipe2, "pipe2 is unportable - "
1758 "use gnulib module pipe2 for portability");
1759 # endif
1760 #endif
1761
1762
1763 #if @GNULIB_PREAD@
1764 /* Read at most BUFSIZE bytes from FD into BUF, starting at OFFSET.
1765 Return the number of bytes placed into BUF if successful, otherwise
1766 set errno and return -1. 0 indicates EOF.
1767 See the POSIX:2008 specification
1768 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/pread.html>. */
1769 # if @REPLACE_PREAD@
1770 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1771 # undef pread
1772 # define pread rpl_pread
1773 # endif
1774 _GL_FUNCDECL_RPL (pread, ssize_t,
1775 (int fd, void *buf, size_t bufsize, off_t offset)
1776 _GL_ARG_NONNULL ((2)));
1777 _GL_CXXALIAS_RPL (pread, ssize_t,
1778 (int fd, void *buf, size_t bufsize, off_t offset));
1779 # else
1780 # if !@HAVE_PREAD@
1781 _GL_FUNCDECL_SYS (pread, ssize_t,
1782 (int fd, void *buf, size_t bufsize, off_t offset)
1783 _GL_ARG_NONNULL ((2)));
1784 # endif
1785 _GL_CXXALIAS_SYS (pread, ssize_t,
1786 (int fd, void *buf, size_t bufsize, off_t offset));
1787 # endif
1788 _GL_CXXALIASWARN (pread);
1789 #elif defined GNULIB_POSIXCHECK
1790 # undef pread
1791 # if HAVE_RAW_DECL_PREAD
1792 _GL_WARN_ON_USE (pread, "pread is unportable - "
1793 "use gnulib module pread for portability");
1794 # endif
1795 #endif
1796
1797
1798 #if @GNULIB_PWRITE@
1799 /* Write at most BUFSIZE bytes from BUF into FD, starting at OFFSET.
1800 Return the number of bytes written if successful, otherwise
1801 set errno and return -1. 0 indicates nothing written. See the
1802 POSIX:2008 specification
1803 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/pwrite.html>. */
1804 # if @REPLACE_PWRITE@
1805 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1806 # undef pwrite
1807 # define pwrite rpl_pwrite
1808 # endif
1809 _GL_FUNCDECL_RPL (pwrite, ssize_t,
1810 (int fd, const void *buf, size_t bufsize, off_t offset)
1811 _GL_ARG_NONNULL ((2)));
1812 _GL_CXXALIAS_RPL (pwrite, ssize_t,
1813 (int fd, const void *buf, size_t bufsize, off_t offset));
1814 # else
1815 # if !@HAVE_PWRITE@
1816 _GL_FUNCDECL_SYS (pwrite, ssize_t,
1817 (int fd, const void *buf, size_t bufsize, off_t offset)
1818 _GL_ARG_NONNULL ((2)));
1819 # endif
1820 _GL_CXXALIAS_SYS (pwrite, ssize_t,
1821 (int fd, const void *buf, size_t bufsize, off_t offset));
1822 # endif
1823 _GL_CXXALIASWARN (pwrite);
1824 #elif defined GNULIB_POSIXCHECK
1825 # undef pwrite
1826 # if HAVE_RAW_DECL_PWRITE
1827 _GL_WARN_ON_USE (pwrite, "pwrite is unportable - "
1828 "use gnulib module pwrite for portability");
1829 # endif
1830 #endif
1831
1832
1833 #if @GNULIB_READ@
1834 /* Read up to COUNT bytes from file descriptor FD into the buffer starting
1835 at BUF. See the POSIX:2008 specification
1836 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/read.html>. */
1837 # if @REPLACE_READ@
1838 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1839 # undef read
1840 # define read rpl_read
1841 # endif
1842 _GL_FUNCDECL_RPL (read, ssize_t, (int fd, void *buf, size_t count)
1843 _GL_ARG_NONNULL ((2)));
1844 _GL_CXXALIAS_RPL (read, ssize_t, (int fd, void *buf, size_t count));
1845 # elif defined _WIN32 && !defined __CYGWIN__
1846 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1847 # undef read
1848 # define read _read
1849 # endif
1850 _GL_CXXALIAS_MDA (read, ssize_t, (int fd, void *buf, size_t count));
1851 # else
1852 _GL_CXXALIAS_SYS (read, ssize_t, (int fd, void *buf, size_t count));
1853 # endif
1854 _GL_CXXALIASWARN (read);
1855 #elif @GNULIB_MDA_READ@
1856 /* On native Windows, map 'read' to '_read', so that -loldnames is not
1857 required. In C++ with GNULIB_NAMESPACE, avoid differences between
1858 platforms by defining GNULIB_NAMESPACE::read always. */
1859 # if defined _WIN32 && !defined __CYGWIN__
1860 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1861 # undef read
1862 # define read _read
1863 # endif
1864 # ifdef __MINGW32__
1865 _GL_CXXALIAS_MDA (read, int, (int fd, void *buf, unsigned int count));
1866 # else
1867 _GL_CXXALIAS_MDA (read, ssize_t, (int fd, void *buf, unsigned int count));
1868 # endif
1869 # else
1870 _GL_CXXALIAS_SYS (read, ssize_t, (int fd, void *buf, size_t count));
1871 # endif
1872 _GL_CXXALIASWARN (read);
1873 #endif
1874
1875
1876 #if @GNULIB_READLINK@
1877 /* Read the contents of the symbolic link FILE and place the first BUFSIZE
1878 bytes of it into BUF. Return the number of bytes placed into BUF if
1879 successful, otherwise -1 and errno set.
1880 See the POSIX:2008 specification
1881 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/readlink.html>. */
1882 # if @REPLACE_READLINK@
1883 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1884 # define readlink rpl_readlink
1885 # endif
1886 _GL_FUNCDECL_RPL (readlink, ssize_t,
1887 (const char *restrict file,
1888 char *restrict buf, size_t bufsize)
1889 _GL_ARG_NONNULL ((1, 2)));
1890 _GL_CXXALIAS_RPL (readlink, ssize_t,
1891 (const char *restrict file,
1892 char *restrict buf, size_t bufsize));
1893 # else
1894 # if !@HAVE_READLINK@
1895 _GL_FUNCDECL_SYS (readlink, ssize_t,
1896 (const char *restrict file,
1897 char *restrict buf, size_t bufsize)
1898 _GL_ARG_NONNULL ((1, 2)));
1899 # endif
1900 _GL_CXXALIAS_SYS (readlink, ssize_t,
1901 (const char *restrict file,
1902 char *restrict buf, size_t bufsize));
1903 # endif
1904 _GL_CXXALIASWARN (readlink);
1905 #elif defined GNULIB_POSIXCHECK
1906 # undef readlink
1907 # if HAVE_RAW_DECL_READLINK
1908 _GL_WARN_ON_USE (readlink, "readlink is unportable - "
1909 "use gnulib module readlink for portability");
1910 # endif
1911 #endif
1912
1913
1914 #if @GNULIB_READLINKAT@
1915 # if @REPLACE_READLINKAT@
1916 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1917 # define readlinkat rpl_readlinkat
1918 # endif
1919 _GL_FUNCDECL_RPL (readlinkat, ssize_t,
1920 (int fd, char const *restrict file,
1921 char *restrict buf, size_t len)
1922 _GL_ARG_NONNULL ((2, 3)));
1923 _GL_CXXALIAS_RPL (readlinkat, ssize_t,
1924 (int fd, char const *restrict file,
1925 char *restrict buf, size_t len));
1926 # else
1927 # if !@HAVE_READLINKAT@
1928 _GL_FUNCDECL_SYS (readlinkat, ssize_t,
1929 (int fd, char const *restrict file,
1930 char *restrict buf, size_t len)
1931 _GL_ARG_NONNULL ((2, 3)));
1932 # endif
1933 _GL_CXXALIAS_SYS (readlinkat, ssize_t,
1934 (int fd, char const *restrict file,
1935 char *restrict buf, size_t len));
1936 # endif
1937 _GL_CXXALIASWARN (readlinkat);
1938 #elif defined GNULIB_POSIXCHECK
1939 # undef readlinkat
1940 # if HAVE_RAW_DECL_READLINKAT
1941 _GL_WARN_ON_USE (readlinkat, "readlinkat is not portable - "
1942 "use gnulib module readlinkat for portability");
1943 # endif
1944 #endif
1945
1946
1947 #if @GNULIB_RMDIR@
1948 /* Remove the directory DIR. */
1949 # if @REPLACE_RMDIR@
1950 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1951 # define rmdir rpl_rmdir
1952 # endif
1953 _GL_FUNCDECL_RPL (rmdir, int, (char const *name) _GL_ARG_NONNULL ((1)));
1954 _GL_CXXALIAS_RPL (rmdir, int, (char const *name));
1955 # elif defined _WIN32 && !defined __CYGWIN__
1956 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1957 # undef rmdir
1958 # define rmdir _rmdir
1959 # endif
1960 _GL_CXXALIAS_MDA (rmdir, int, (char const *name));
1961 # else
1962 _GL_CXXALIAS_SYS (rmdir, int, (char const *name));
1963 # endif
1964 _GL_CXXALIASWARN (rmdir);
1965 #elif defined GNULIB_POSIXCHECK
1966 # undef rmdir
1967 # if HAVE_RAW_DECL_RMDIR
1968 _GL_WARN_ON_USE (rmdir, "rmdir is unportable - "
1969 "use gnulib module rmdir for portability");
1970 # endif
1971 #elif @GNULIB_MDA_RMDIR@
1972 /* On native Windows, map 'rmdir' to '_rmdir', so that -loldnames is not
1973 required. In C++ with GNULIB_NAMESPACE, avoid differences between
1974 platforms by defining GNULIB_NAMESPACE::rmdir always. */
1975 # if defined _WIN32 && !defined __CYGWIN__
1976 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1977 # undef rmdir
1978 # define rmdir _rmdir
1979 # endif
1980 _GL_CXXALIAS_MDA (rmdir, int, (char const *name));
1981 # else
1982 _GL_CXXALIAS_SYS (rmdir, int, (char const *name));
1983 # endif
1984 _GL_CXXALIASWARN (rmdir);
1985 #endif
1986
1987
1988 #if @GNULIB_SETHOSTNAME@
1989 /* Set the host name of the machine.
1990 The host name may or may not be fully qualified.
1991
1992 Put LEN bytes of NAME into the host name.
1993 Return 0 if successful, otherwise, set errno and return -1.
1994
1995 Platforms with no ability to set the hostname return -1 and set
1996 errno = ENOSYS. */
1997 # if !@HAVE_SETHOSTNAME@ || !@HAVE_DECL_SETHOSTNAME@
1998 _GL_FUNCDECL_SYS (sethostname, int, (const char *name, size_t len)
1999 _GL_ARG_NONNULL ((1)));
2000 # endif
2001 /* Need to cast, because on Solaris 11 2011-10, Mac OS X 10.5, IRIX 6.5
2002 and FreeBSD 6.4 the second parameter is int. On Solaris 11
2003 2011-10, the first parameter is not const. */
2004 _GL_CXXALIAS_SYS_CAST (sethostname, int, (const char *name, size_t len));
2005 _GL_CXXALIASWARN (sethostname);
2006 #elif defined GNULIB_POSIXCHECK
2007 # undef sethostname
2008 # if HAVE_RAW_DECL_SETHOSTNAME
2009 _GL_WARN_ON_USE (sethostname, "sethostname is unportable - "
2010 "use gnulib module sethostname for portability");
2011 # endif
2012 #endif
2013
2014
2015 #if @GNULIB_SLEEP@
2016 /* Pause the execution of the current thread for N seconds.
2017 Returns the number of seconds left to sleep.
2018 See the POSIX:2008 specification
2019 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/sleep.html>. */
2020 # if @REPLACE_SLEEP@
2021 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2022 # undef sleep
2023 # define sleep rpl_sleep
2024 # endif
2025 _GL_FUNCDECL_RPL (sleep, unsigned int, (unsigned int n));
2026 _GL_CXXALIAS_RPL (sleep, unsigned int, (unsigned int n));
2027 # else
2028 # if !@HAVE_SLEEP@
2029 _GL_FUNCDECL_SYS (sleep, unsigned int, (unsigned int n));
2030 # endif
2031 _GL_CXXALIAS_SYS (sleep, unsigned int, (unsigned int n));
2032 # endif
2033 _GL_CXXALIASWARN (sleep);
2034 #elif defined GNULIB_POSIXCHECK
2035 # undef sleep
2036 # if HAVE_RAW_DECL_SLEEP
2037 _GL_WARN_ON_USE (sleep, "sleep is unportable - "
2038 "use gnulib module sleep for portability");
2039 # endif
2040 #endif
2041
2042
2043 #if @GNULIB_MDA_SWAB@
2044 /* On native Windows, map 'swab' to '_swab', so that -loldnames is not
2045 required. In C++ with GNULIB_NAMESPACE, avoid differences between
2046 platforms by defining GNULIB_NAMESPACE::swab always. */
2047 # if defined _WIN32 && !defined __CYGWIN__
2048 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2049 # undef swab
2050 # define swab _swab
2051 # endif
2052 /* Need to cast, because in old mingw the arguments are
2053 (const char *from, char *to, size_t n). */
2054 _GL_CXXALIAS_MDA_CAST (swab, void, (char *from, char *to, int n));
2055 # else
2056 # if defined __hpux /* HP-UX */
2057 _GL_CXXALIAS_SYS (swab, void, (const char *from, char *to, int n));
2058 # elif defined __sun && !defined _XPG4 /* Solaris */
2059 _GL_CXXALIAS_SYS (swab, void, (const char *from, char *to, ssize_t n));
2060 # else
2061 _GL_CXXALIAS_SYS (swab, void, (const void *from, void *to, ssize_t n));
2062 # endif
2063 # endif
2064 _GL_CXXALIASWARN (swab);
2065 #endif
2066
2067
2068 #if @GNULIB_SYMLINK@
2069 # if @REPLACE_SYMLINK@
2070 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2071 # undef symlink
2072 # define symlink rpl_symlink
2073 # endif
2074 _GL_FUNCDECL_RPL (symlink, int, (char const *contents, char const *file)
2075 _GL_ARG_NONNULL ((1, 2)));
2076 _GL_CXXALIAS_RPL (symlink, int, (char const *contents, char const *file));
2077 # else
2078 # if !@HAVE_SYMLINK@
2079 _GL_FUNCDECL_SYS (symlink, int, (char const *contents, char const *file)
2080 _GL_ARG_NONNULL ((1, 2)));
2081 # endif
2082 _GL_CXXALIAS_SYS (symlink, int, (char const *contents, char const *file));
2083 # endif
2084 _GL_CXXALIASWARN (symlink);
2085 #elif defined GNULIB_POSIXCHECK
2086 # undef symlink
2087 # if HAVE_RAW_DECL_SYMLINK
2088 _GL_WARN_ON_USE (symlink, "symlink is not portable - "
2089 "use gnulib module symlink for portability");
2090 # endif
2091 #endif
2092
2093
2094 #if @GNULIB_SYMLINKAT@
2095 # if @REPLACE_SYMLINKAT@
2096 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2097 # undef symlinkat
2098 # define symlinkat rpl_symlinkat
2099 # endif
2100 _GL_FUNCDECL_RPL (symlinkat, int,
2101 (char const *contents, int fd, char const *file)
2102 _GL_ARG_NONNULL ((1, 3)));
2103 _GL_CXXALIAS_RPL (symlinkat, int,
2104 (char const *contents, int fd, char const *file));
2105 # else
2106 # if !@HAVE_SYMLINKAT@
2107 _GL_FUNCDECL_SYS (symlinkat, int,
2108 (char const *contents, int fd, char const *file)
2109 _GL_ARG_NONNULL ((1, 3)));
2110 # endif
2111 _GL_CXXALIAS_SYS (symlinkat, int,
2112 (char const *contents, int fd, char const *file));
2113 # endif
2114 _GL_CXXALIASWARN (symlinkat);
2115 #elif defined GNULIB_POSIXCHECK
2116 # undef symlinkat
2117 # if HAVE_RAW_DECL_SYMLINKAT
2118 _GL_WARN_ON_USE (symlinkat, "symlinkat is not portable - "
2119 "use gnulib module symlinkat for portability");
2120 # endif
2121 #endif
2122
2123
2124 #if @GNULIB_TRUNCATE@
2125 /* Change the size of the file designated by FILENAME to become equal to LENGTH.
2126 Return 0 if successful, otherwise -1 and errno set.
2127 See the POSIX:2008 specification
2128 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/truncate.html>. */
2129 # if @REPLACE_TRUNCATE@
2130 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2131 # undef truncate
2132 # define truncate rpl_truncate
2133 # endif
2134 _GL_FUNCDECL_RPL (truncate, int, (const char *filename, off_t length)
2135 _GL_ARG_NONNULL ((1)));
2136 _GL_CXXALIAS_RPL (truncate, int, (const char *filename, off_t length));
2137 # else
2138 # if !@HAVE_DECL_TRUNCATE@
2139 _GL_FUNCDECL_SYS (truncate, int, (const char *filename, off_t length)
2140 _GL_ARG_NONNULL ((1)));
2141 # endif
2142 _GL_CXXALIAS_SYS (truncate, int, (const char *filename, off_t length));
2143 # endif
2144 _GL_CXXALIASWARN (truncate);
2145 #elif defined GNULIB_POSIXCHECK
2146 # undef truncate
2147 # if HAVE_RAW_DECL_TRUNCATE
2148 _GL_WARN_ON_USE (truncate, "truncate is unportable - "
2149 "use gnulib module truncate for portability");
2150 # endif
2151 #endif
2152
2153
2154 #if @GNULIB_TTYNAME_R@
2155 /* Store at most BUFLEN characters of the pathname of the terminal FD is
2156 open on in BUF. Return 0 on success, otherwise an error number. */
2157 # if @REPLACE_TTYNAME_R@
2158 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2159 # undef ttyname_r
2160 # define ttyname_r rpl_ttyname_r
2161 # endif
2162 _GL_FUNCDECL_RPL (ttyname_r, int,
2163 (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
2164 _GL_CXXALIAS_RPL (ttyname_r, int,
2165 (int fd, char *buf, size_t buflen));
2166 # else
2167 # if !@HAVE_DECL_TTYNAME_R@
2168 _GL_FUNCDECL_SYS (ttyname_r, int,
2169 (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
2170 # endif
2171 _GL_CXXALIAS_SYS (ttyname_r, int,
2172 (int fd, char *buf, size_t buflen));
2173 # endif
2174 _GL_CXXALIASWARN (ttyname_r);
2175 #elif defined GNULIB_POSIXCHECK
2176 # undef ttyname_r
2177 # if HAVE_RAW_DECL_TTYNAME_R
2178 _GL_WARN_ON_USE (ttyname_r, "ttyname_r is not portable - "
2179 "use gnulib module ttyname_r for portability");
2180 # endif
2181 #endif
2182
2183
2184 #if @GNULIB_UNLINK@
2185 # if @REPLACE_UNLINK@
2186 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2187 # undef unlink
2188 # define unlink rpl_unlink
2189 # endif
2190 _GL_FUNCDECL_RPL (unlink, int, (char const *file) _GL_ARG_NONNULL ((1)));
2191 _GL_CXXALIAS_RPL (unlink, int, (char const *file));
2192 # elif defined _WIN32 && !defined __CYGWIN__
2193 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2194 # undef unlink
2195 # define unlink _unlink
2196 # endif
2197 _GL_CXXALIAS_MDA (unlink, int, (char const *file));
2198 # else
2199 _GL_CXXALIAS_SYS (unlink, int, (char const *file));
2200 # endif
2201 _GL_CXXALIASWARN (unlink);
2202 #elif defined GNULIB_POSIXCHECK
2203 # undef unlink
2204 # if HAVE_RAW_DECL_UNLINK
2205 _GL_WARN_ON_USE (unlink, "unlink is not portable - "
2206 "use gnulib module unlink for portability");
2207 # endif
2208 #elif @GNULIB_MDA_UNLINK@
2209 /* On native Windows, map 'unlink' to '_unlink', so that -loldnames is not
2210 required. In C++ with GNULIB_NAMESPACE, avoid differences between
2211 platforms by defining GNULIB_NAMESPACE::unlink always. */
2212 # if defined _WIN32 && !defined __CYGWIN__
2213 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2214 # undef unlink
2215 # define unlink _unlink
2216 # endif
2217 _GL_CXXALIAS_MDA (unlink, int, (char const *file));
2218 # else
2219 _GL_CXXALIAS_SYS (unlink, int, (char const *file));
2220 # endif
2221 _GL_CXXALIASWARN (unlink);
2222 #endif
2223
2224
2225 #if @GNULIB_UNLINKAT@
2226 # if @REPLACE_UNLINKAT@
2227 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2228 # undef unlinkat
2229 # define unlinkat rpl_unlinkat
2230 # endif
2231 _GL_FUNCDECL_RPL (unlinkat, int, (int fd, char const *file, int flag)
2232 _GL_ARG_NONNULL ((2)));
2233 _GL_CXXALIAS_RPL (unlinkat, int, (int fd, char const *file, int flag));
2234 # else
2235 # if !@HAVE_UNLINKAT@
2236 _GL_FUNCDECL_SYS (unlinkat, int, (int fd, char const *file, int flag)
2237 _GL_ARG_NONNULL ((2)));
2238 # endif
2239 _GL_CXXALIAS_SYS (unlinkat, int, (int fd, char const *file, int flag));
2240 # endif
2241 _GL_CXXALIASWARN (unlinkat);
2242 #elif defined GNULIB_POSIXCHECK
2243 # undef unlinkat
2244 # if HAVE_RAW_DECL_UNLINKAT
2245 _GL_WARN_ON_USE (unlinkat, "unlinkat is not portable - "
2246 "use gnulib module unlinkat for portability");
2247 # endif
2248 #endif
2249
2250
2251 #if @GNULIB_USLEEP@
2252 /* Pause the execution of the current thread for N microseconds.
2253 Returns 0 on completion, or -1 on range error.
2254 See the POSIX:2001 specification
2255 <https://pubs.opengroup.org/onlinepubs/009695399/functions/usleep.html>. */
2256 # if @REPLACE_USLEEP@
2257 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2258 # undef usleep
2259 # define usleep rpl_usleep
2260 # endif
2261 _GL_FUNCDECL_RPL (usleep, int, (useconds_t n));
2262 _GL_CXXALIAS_RPL (usleep, int, (useconds_t n));
2263 # else
2264 # if !@HAVE_USLEEP@
2265 _GL_FUNCDECL_SYS (usleep, int, (useconds_t n));
2266 # endif
2267 /* Need to cast, because on Haiku, the first parameter is
2268 unsigned int n. */
2269 _GL_CXXALIAS_SYS_CAST (usleep, int, (useconds_t n));
2270 # endif
2271 _GL_CXXALIASWARN (usleep);
2272 #elif defined GNULIB_POSIXCHECK
2273 # undef usleep
2274 # if HAVE_RAW_DECL_USLEEP
2275 _GL_WARN_ON_USE (usleep, "usleep is unportable - "
2276 "use gnulib module usleep for portability");
2277 # endif
2278 #endif
2279
2280
2281 #if @GNULIB_WRITE@
2282 /* Write up to COUNT bytes starting at BUF to file descriptor FD.
2283 See the POSIX:2008 specification
2284 <https://pubs.opengroup.org/onlinepubs/9699919799/functions/write.html>. */
2285 # if @REPLACE_WRITE@
2286 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2287 # undef write
2288 # define write rpl_write
2289 # endif
2290 _GL_FUNCDECL_RPL (write, ssize_t, (int fd, const void *buf, size_t count)
2291 _GL_ARG_NONNULL ((2)));
2292 _GL_CXXALIAS_RPL (write, ssize_t, (int fd, const void *buf, size_t count));
2293 # elif defined _WIN32 && !defined __CYGWIN__
2294 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2295 # undef write
2296 # define write _write
2297 # endif
2298 _GL_CXXALIAS_MDA (write, ssize_t, (int fd, const void *buf, size_t count));
2299 # else
2300 _GL_CXXALIAS_SYS (write, ssize_t, (int fd, const void *buf, size_t count));
2301 # endif
2302 _GL_CXXALIASWARN (write);
2303 #elif @GNULIB_MDA_WRITE@
2304 /* On native Windows, map 'write' to '_write', so that -loldnames is not
2305 required. In C++ with GNULIB_NAMESPACE, avoid differences between
2306 platforms by defining GNULIB_NAMESPACE::write always. */
2307 # if defined _WIN32 && !defined __CYGWIN__
2308 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
2309 # undef write
2310 # define write _write
2311 # endif
2312 # ifdef __MINGW32__
2313 _GL_CXXALIAS_MDA (write, int, (int fd, const void *buf, unsigned int count));
2314 # else
2315 _GL_CXXALIAS_MDA (write, ssize_t, (int fd, const void *buf, unsigned int count));
2316 # endif
2317 # else
2318 _GL_CXXALIAS_SYS (write, ssize_t, (int fd, const void *buf, size_t count));
2319 # endif
2320 _GL_CXXALIASWARN (write);
2321 #endif
2322
2323 _GL_INLINE_HEADER_END
2324
2325 #endif /* _@GUARD_PREFIX@_UNISTD_H */
2326 #endif /* _GL_INCLUDING_UNISTD_H */
2327 #endif /* _@GUARD_PREFIX@_UNISTD_H */