Minor redisplay cleanups.
[bpt/emacs.git] / lib / unistd.in.h
CommitLineData
e275c824
PE
1/* Substitute for and wrapper around <unistd.h>.
2 Copyright (C) 2003-2011 Free Software Foundation, Inc.
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
15 along with this program; if not, write to the Free Software Foundation,
16 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
17
18#if __GNUC__ >= 3
19@PRAGMA_SYSTEM_HEADER@
20#endif
21@PRAGMA_COLUMNS@
22
23/* Special invocation convention:
24 - On mingw, several headers, including <winsock2.h>, include <unistd.h>,
25 but we need to ensure that both the system <unistd.h> and <winsock2.h>
26 are completely included before we replace gethostname. */
27#if @GNULIB_GETHOSTNAME@ && @UNISTD_H_HAVE_WINSOCK2_H@ \
e765a388 28 && !defined _GL_WINSOCK2_H_WITNESS && defined _WINSOCK2_H
e275c824
PE
29/* <unistd.h> is being indirectly included for the first time from
30 <winsock2.h>; avoid declaring any overrides. */
31# if @HAVE_UNISTD_H@
32# @INCLUDE_NEXT@ @NEXT_UNISTD_H@
33# else
34# error unexpected; report this to bug-gnulib@gnu.org
35# endif
e765a388 36# define _GL_WINSOCK2_H_WITNESS
e275c824
PE
37
38/* Normal invocation. */
e765a388 39#elif !defined _GL_UNISTD_H
e275c824
PE
40
41/* The include_next requires a split double-inclusion guard. */
42#if @HAVE_UNISTD_H@
43# @INCLUDE_NEXT@ @NEXT_UNISTD_H@
44#endif
45
46/* Get all possible declarations of gethostname(). */
47#if @GNULIB_GETHOSTNAME@ && @UNISTD_H_HAVE_WINSOCK2_H@ \
e765a388
PE
48 && !defined _GL_INCLUDING_WINSOCK2_H
49# define _GL_INCLUDING_WINSOCK2_H
e275c824 50# include <winsock2.h>
e765a388 51# undef _GL_INCLUDING_WINSOCK2_H
e275c824
PE
52#endif
53
e765a388
PE
54#if !defined _GL_UNISTD_H && !defined _GL_INCLUDING_WINSOCK2_H
55#define _GL_UNISTD_H
e275c824
PE
56
57/* NetBSD 5.0 mis-defines NULL. Also get size_t. */
58#include <stddef.h>
59
60/* mingw doesn't define the SEEK_* or *_FILENO macros in <unistd.h>. */
61/* Cygwin 1.7.1 declares symlinkat in <stdio.h>, not in <unistd.h>. */
62/* But avoid namespace pollution on glibc systems. */
63#if (!(defined SEEK_CUR && defined SEEK_END && defined SEEK_SET) \
64 || ((@GNULIB_SYMLINKAT@ || defined GNULIB_POSIXCHECK) \
65 && defined __CYGWIN__)) \
66 && ! defined __GLIBC__
67# include <stdio.h>
68#endif
69
70/* Cygwin 1.7.1 declares unlinkat in <fcntl.h>, not in <unistd.h>. */
71/* But avoid namespace pollution on glibc systems. */
72#if (@GNULIB_UNLINKAT@ || defined GNULIB_POSIXCHECK) && defined __CYGWIN__ \
73 && ! defined __GLIBC__
74# include <fcntl.h>
75#endif
76
77/* mingw fails to declare _exit in <unistd.h>. */
78/* mingw, BeOS, Haiku declare environ in <stdlib.h>, not in <unistd.h>. */
79/* Solaris declares getcwd not only in <unistd.h> but also in <stdlib.h>. */
80/* But avoid namespace pollution on glibc systems. */
81#ifndef __GLIBC__
82# include <stdlib.h>
83#endif
84
85/* mingw declares getcwd in <io.h>, not in <unistd.h>. */
86#if ((@GNULIB_GETCWD@ || defined GNULIB_POSIXCHECK) \
87 && ((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__))
88# include <io.h>
89#endif
90
91/* AIX and OSF/1 5.1 declare getdomainname in <netdb.h>, not in <unistd.h>.
92 NonStop Kernel declares gethostname in <netdb.h>, not in <unistd.h>. */
93/* But avoid namespace pollution on glibc systems. */
94#if ((@GNULIB_GETDOMAINNAME@ && (defined _AIX || defined __osf__)) \
95 || (@GNULIB_GETHOSTNAME@ && defined __TANDEM)) \
96 && !defined __GLIBC__
97# include <netdb.h>
98#endif
99
100#if (@GNULIB_WRITE@ || @GNULIB_READLINK@ || @GNULIB_READLINKAT@ \
101 || @GNULIB_PREAD@ || @GNULIB_PWRITE@ || defined GNULIB_POSIXCHECK)
102/* Get ssize_t. */
103# include <sys/types.h>
104#endif
105
106/* Get getopt(), optarg, optind, opterr, optopt.
107 But avoid namespace pollution on glibc systems. */
108#if @GNULIB_UNISTD_H_GETOPT@ && !defined __GLIBC__ && !defined _GL_SYSTEM_GETOPT
109# include <getopt.h>
110#endif
111
112/* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
113
114/* The definition of _GL_ARG_NONNULL is copied here. */
115
116/* The definition of _GL_WARN_ON_USE is copied here. */
117
118
119#if @GNULIB_GETHOSTNAME@
120/* Get all possible declarations of gethostname(). */
121# if @UNISTD_H_HAVE_WINSOCK2_H@
e765a388 122# if !defined _GL_SYS_SOCKET_H
e275c824
PE
123# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
124# undef socket
125# define socket socket_used_without_including_sys_socket_h
126# undef connect
127# define connect connect_used_without_including_sys_socket_h
128# undef accept
129# define accept accept_used_without_including_sys_socket_h
130# undef bind
131# define bind bind_used_without_including_sys_socket_h
132# undef getpeername
133# define getpeername getpeername_used_without_including_sys_socket_h
134# undef getsockname
135# define getsockname getsockname_used_without_including_sys_socket_h
136# undef getsockopt
137# define getsockopt getsockopt_used_without_including_sys_socket_h
138# undef listen
139# define listen listen_used_without_including_sys_socket_h
140# undef recv
141# define recv recv_used_without_including_sys_socket_h
142# undef send
143# define send send_used_without_including_sys_socket_h
144# undef recvfrom
145# define recvfrom recvfrom_used_without_including_sys_socket_h
146# undef sendto
147# define sendto sendto_used_without_including_sys_socket_h
148# undef setsockopt
149# define setsockopt setsockopt_used_without_including_sys_socket_h
150# undef shutdown
151# define shutdown shutdown_used_without_including_sys_socket_h
152# else
153 _GL_WARN_ON_USE (socket,
154 "socket() used without including <sys/socket.h>");
155 _GL_WARN_ON_USE (connect,
156 "connect() used without including <sys/socket.h>");
157 _GL_WARN_ON_USE (accept,
158 "accept() used without including <sys/socket.h>");
159 _GL_WARN_ON_USE (bind,
160 "bind() used without including <sys/socket.h>");
161 _GL_WARN_ON_USE (getpeername,
162 "getpeername() used without including <sys/socket.h>");
163 _GL_WARN_ON_USE (getsockname,
164 "getsockname() used without including <sys/socket.h>");
165 _GL_WARN_ON_USE (getsockopt,
166 "getsockopt() used without including <sys/socket.h>");
167 _GL_WARN_ON_USE (listen,
168 "listen() used without including <sys/socket.h>");
169 _GL_WARN_ON_USE (recv,
170 "recv() used without including <sys/socket.h>");
171 _GL_WARN_ON_USE (send,
172 "send() used without including <sys/socket.h>");
173 _GL_WARN_ON_USE (recvfrom,
174 "recvfrom() used without including <sys/socket.h>");
175 _GL_WARN_ON_USE (sendto,
176 "sendto() used without including <sys/socket.h>");
177 _GL_WARN_ON_USE (setsockopt,
178 "setsockopt() used without including <sys/socket.h>");
179 _GL_WARN_ON_USE (shutdown,
180 "shutdown() used without including <sys/socket.h>");
181# endif
182# endif
e765a388 183# if !defined _GL_SYS_SELECT_H
e275c824
PE
184# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
185# undef select
186# define select select_used_without_including_sys_select_h
187# else
188 _GL_WARN_ON_USE (select,
189 "select() used without including <sys/select.h>");
190# endif
191# endif
192# endif
193#endif
194
195
196/* OS/2 EMX lacks these macros. */
197#ifndef STDIN_FILENO
198# define STDIN_FILENO 0
199#endif
200#ifndef STDOUT_FILENO
201# define STDOUT_FILENO 1
202#endif
203#ifndef STDERR_FILENO
204# define STDERR_FILENO 2
205#endif
206
207/* Ensure *_OK macros exist. */
208#ifndef F_OK
209# define F_OK 0
210# define X_OK 1
211# define W_OK 2
212# define R_OK 4
213#endif
214
215
216/* Declare overridden functions. */
217
218
219#if defined GNULIB_POSIXCHECK
220/* The access() function is a security risk. */
221_GL_WARN_ON_USE (access, "the access function is a security risk - "
222 "use the gnulib module faccessat instead");
223#endif
224
225
226#if @GNULIB_CHOWN@
227/* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
228 to GID (if GID is not -1). Follow symbolic links.
229 Return 0 if successful, otherwise -1 and errno set.
230 See the POSIX:2001 specification
231 <http://www.opengroup.org/susv3xsh/chown.html>. */
232# if @REPLACE_CHOWN@
233# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
234# undef chown
235# define chown rpl_chown
236# endif
237_GL_FUNCDECL_RPL (chown, int, (const char *file, uid_t uid, gid_t gid)
238 _GL_ARG_NONNULL ((1)));
239_GL_CXXALIAS_RPL (chown, int, (const char *file, uid_t uid, gid_t gid));
240# else
241# if !@HAVE_CHOWN@
242_GL_FUNCDECL_SYS (chown, int, (const char *file, uid_t uid, gid_t gid)
243 _GL_ARG_NONNULL ((1)));
244# endif
245_GL_CXXALIAS_SYS (chown, int, (const char *file, uid_t uid, gid_t gid));
246# endif
247_GL_CXXALIASWARN (chown);
248#elif defined GNULIB_POSIXCHECK
249# undef chown
250# if HAVE_RAW_DECL_CHOWN
251_GL_WARN_ON_USE (chown, "chown fails to follow symlinks on some systems and "
252 "doesn't treat a uid or gid of -1 on some systems - "
253 "use gnulib module chown for portability");
254# endif
255#endif
256
257
258#if @GNULIB_CLOSE@
259# if @REPLACE_CLOSE@
260/* Automatically included by modules that need a replacement for close. */
261# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
262# undef close
263# define close rpl_close
264# endif
265_GL_FUNCDECL_RPL (close, int, (int fd));
266_GL_CXXALIAS_RPL (close, int, (int fd));
267# else
268_GL_CXXALIAS_SYS (close, int, (int fd));
269# endif
270_GL_CXXALIASWARN (close);
271#elif @UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS@
272# undef close
273# define close close_used_without_requesting_gnulib_module_close
274#elif defined GNULIB_POSIXCHECK
275# undef close
276/* Assume close is always declared. */
277_GL_WARN_ON_USE (close, "close does not portably work on sockets - "
278 "use gnulib module close for portability");
279#endif
280
281
282#if @REPLACE_DUP@
283# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
284# define dup rpl_dup
285# endif
286_GL_FUNCDECL_RPL (dup, int, (int oldfd));
287_GL_CXXALIAS_RPL (dup, int, (int oldfd));
288#else
289_GL_CXXALIAS_SYS (dup, int, (int oldfd));
290#endif
291_GL_CXXALIASWARN (dup);
292
293
294#if @GNULIB_DUP2@
295/* Copy the file descriptor OLDFD into file descriptor NEWFD. Do nothing if
296 NEWFD = OLDFD, otherwise close NEWFD first if it is open.
297 Return newfd if successful, otherwise -1 and errno set.
298 See the POSIX:2001 specification
299 <http://www.opengroup.org/susv3xsh/dup2.html>. */
300# if @REPLACE_DUP2@
301# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
302# define dup2 rpl_dup2
303# endif
304_GL_FUNCDECL_RPL (dup2, int, (int oldfd, int newfd));
305_GL_CXXALIAS_RPL (dup2, int, (int oldfd, int newfd));
306# else
307# if !@HAVE_DUP2@
308_GL_FUNCDECL_SYS (dup2, int, (int oldfd, int newfd));
309# endif
310_GL_CXXALIAS_SYS (dup2, int, (int oldfd, int newfd));
311# endif
312_GL_CXXALIASWARN (dup2);
313#elif defined GNULIB_POSIXCHECK
314# undef dup2
315# if HAVE_RAW_DECL_DUP2
316_GL_WARN_ON_USE (dup2, "dup2 is unportable - "
317 "use gnulib module dup2 for portability");
318# endif
319#endif
320
321
322#if @GNULIB_DUP3@
323/* Copy the file descriptor OLDFD into file descriptor NEWFD, with the
324 specified flags.
325 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
326 and O_TEXT, O_BINARY (defined in "binary-io.h").
327 Close NEWFD first if it is open.
328 Return newfd if successful, otherwise -1 and errno set.
329 See the Linux man page at
330 <http://www.kernel.org/doc/man-pages/online/pages/man2/dup3.2.html>. */
331# if @HAVE_DUP3@
332# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
333# define dup3 rpl_dup3
334# endif
335_GL_FUNCDECL_RPL (dup3, int, (int oldfd, int newfd, int flags));
336_GL_CXXALIAS_RPL (dup3, int, (int oldfd, int newfd, int flags));
337# else
338_GL_FUNCDECL_SYS (dup3, int, (int oldfd, int newfd, int flags));
339_GL_CXXALIAS_SYS (dup3, int, (int oldfd, int newfd, int flags));
340# endif
341_GL_CXXALIASWARN (dup3);
342#elif defined GNULIB_POSIXCHECK
343# undef dup3
344# if HAVE_RAW_DECL_DUP3
345_GL_WARN_ON_USE (dup3, "dup3 is unportable - "
346 "use gnulib module dup3 for portability");
347# endif
348#endif
349
350
351#if @GNULIB_ENVIRON@
352# if !@HAVE_DECL_ENVIRON@
353/* Set of environment variables and values. An array of strings of the form
354 "VARIABLE=VALUE", terminated with a NULL. */
355# if defined __APPLE__ && defined __MACH__
356# include <crt_externs.h>
357# define environ (*_NSGetEnviron ())
358# else
359# ifdef __cplusplus
360extern "C" {
361# endif
362extern char **environ;
363# ifdef __cplusplus
364}
365# endif
366# endif
367# endif
368#elif defined GNULIB_POSIXCHECK
369# if HAVE_RAW_DECL_ENVIRON
370static inline char ***
371rpl_environ (void)
372{
373 return &environ;
374}
375_GL_WARN_ON_USE (rpl_environ, "environ is unportable - "
376 "use gnulib module environ for portability");
377# undef environ
378# define environ (*rpl_environ ())
379# endif
380#endif
381
382
383#if @GNULIB_EUIDACCESS@
384/* Like access(), except that it uses the effective user id and group id of
385 the current process. */
386# if !@HAVE_EUIDACCESS@
387_GL_FUNCDECL_SYS (euidaccess, int, (const char *filename, int mode)
388 _GL_ARG_NONNULL ((1)));
389# endif
390_GL_CXXALIAS_SYS (euidaccess, int, (const char *filename, int mode));
391_GL_CXXALIASWARN (euidaccess);
392# if defined GNULIB_POSIXCHECK
393/* Like access(), this function is a security risk. */
394_GL_WARN_ON_USE (euidaccess, "the euidaccess function is a security risk - "
395 "use the gnulib module faccessat instead");
396# endif
397#elif defined GNULIB_POSIXCHECK
398# undef euidaccess
399# if HAVE_RAW_DECL_EUIDACCESS
400_GL_WARN_ON_USE (euidaccess, "euidaccess is unportable - "
401 "use gnulib module euidaccess for portability");
402# endif
403#endif
404
405
406#if @GNULIB_FACCESSAT@
407# if !@HAVE_FACCESSAT@
408_GL_FUNCDECL_SYS (faccessat, int,
409 (int fd, char const *file, int mode, int flag)
410 _GL_ARG_NONNULL ((2)));
411# endif
412_GL_CXXALIAS_SYS (faccessat, int,
413 (int fd, char const *file, int mode, int flag));
414_GL_CXXALIASWARN (faccessat);
415#elif defined GNULIB_POSIXCHECK
416# undef faccessat
417# if HAVE_RAW_DECL_FACCESSAT
418_GL_WARN_ON_USE (faccessat, "faccessat is not portable - "
419 "use gnulib module faccessat for portability");
420# endif
421#endif
422
423
424#if @GNULIB_FCHDIR@
425/* Change the process' current working directory to the directory on which
426 the given file descriptor is open.
427 Return 0 if successful, otherwise -1 and errno set.
428 See the POSIX:2001 specification
429 <http://www.opengroup.org/susv3xsh/fchdir.html>. */
430# if ! @HAVE_FCHDIR@
431_GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/));
432
433/* Gnulib internal hooks needed to maintain the fchdir metadata. */
434_GL_EXTERN_C int _gl_register_fd (int fd, const char *filename)
435 _GL_ARG_NONNULL ((2));
436_GL_EXTERN_C void _gl_unregister_fd (int fd);
437_GL_EXTERN_C int _gl_register_dup (int oldfd, int newfd);
438_GL_EXTERN_C const char *_gl_directory_name (int fd);
439
440# else
441# if !@HAVE_DECL_FCHDIR@
442_GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/));
443# endif
444# endif
445_GL_CXXALIAS_SYS (fchdir, int, (int /*fd*/));
446_GL_CXXALIASWARN (fchdir);
447#elif defined GNULIB_POSIXCHECK
448# undef fchdir
449# if HAVE_RAW_DECL_FCHDIR
450_GL_WARN_ON_USE (fchdir, "fchdir is unportable - "
451 "use gnulib module fchdir for portability");
452# endif
453#endif
454
455
456#if @GNULIB_FCHOWNAT@
457# if @REPLACE_FCHOWNAT@
458# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
459# undef fchownat
460# define fchownat rpl_fchownat
461# endif
462_GL_FUNCDECL_RPL (fchownat, int, (int fd, char const *file,
463 uid_t owner, gid_t group, int flag)
464 _GL_ARG_NONNULL ((2)));
465_GL_CXXALIAS_RPL (fchownat, int, (int fd, char const *file,
466 uid_t owner, gid_t group, int flag));
467# else
468# if !@HAVE_FCHOWNAT@
469_GL_FUNCDECL_SYS (fchownat, int, (int fd, char const *file,
470 uid_t owner, gid_t group, int flag)
471 _GL_ARG_NONNULL ((2)));
472# endif
473_GL_CXXALIAS_SYS (fchownat, int, (int fd, char const *file,
474 uid_t owner, gid_t group, int flag));
475# endif
476_GL_CXXALIASWARN (fchownat);
477#elif defined GNULIB_POSIXCHECK
478# undef fchownat
479# if HAVE_RAW_DECL_FCHOWNAT
480_GL_WARN_ON_USE (fchownat, "fchownat is not portable - "
481 "use gnulib module openat for portability");
482# endif
483#endif
484
485
486#if @GNULIB_FSYNC@
487/* Synchronize changes to a file.
488 Return 0 if successful, otherwise -1 and errno set.
489 See POSIX:2001 specification
490 <http://www.opengroup.org/susv3xsh/fsync.html>. */
491# if !@HAVE_FSYNC@
492_GL_FUNCDECL_SYS (fsync, int, (int fd));
493# endif
494_GL_CXXALIAS_SYS (fsync, int, (int fd));
495_GL_CXXALIASWARN (fsync);
496#elif defined GNULIB_POSIXCHECK
497# undef fsync
498# if HAVE_RAW_DECL_FSYNC
499_GL_WARN_ON_USE (fsync, "fsync is unportable - "
500 "use gnulib module fsync for portability");
501# endif
502#endif
503
504
505#if @GNULIB_FTRUNCATE@
506/* Change the size of the file to which FD is opened to become equal to LENGTH.
507 Return 0 if successful, otherwise -1 and errno set.
508 See the POSIX:2001 specification
509 <http://www.opengroup.org/susv3xsh/ftruncate.html>. */
510# if !@HAVE_FTRUNCATE@
511_GL_FUNCDECL_SYS (ftruncate, int, (int fd, off_t length));
512# endif
513_GL_CXXALIAS_SYS (ftruncate, int, (int fd, off_t length));
514_GL_CXXALIASWARN (ftruncate);
515#elif defined GNULIB_POSIXCHECK
516# undef ftruncate
517# if HAVE_RAW_DECL_FTRUNCATE
518_GL_WARN_ON_USE (ftruncate, "ftruncate is unportable - "
519 "use gnulib module ftruncate for portability");
520# endif
521#endif
522
523
524#if @GNULIB_GETCWD@
525/* Get the name of the current working directory, and put it in SIZE bytes
526 of BUF.
527 Return BUF if successful, or NULL if the directory couldn't be determined
528 or SIZE was too small.
529 See the POSIX:2001 specification
530 <http://www.opengroup.org/susv3xsh/getcwd.html>.
531 Additionally, the gnulib module 'getcwd' guarantees the following GNU
532 extension: If BUF is NULL, an array is allocated with 'malloc'; the array
533 is SIZE bytes long, unless SIZE == 0, in which case it is as big as
534 necessary. */
535# if @REPLACE_GETCWD@
536# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
537# define getcwd rpl_getcwd
538# endif
539_GL_FUNCDECL_RPL (getcwd, char *, (char *buf, size_t size));
540_GL_CXXALIAS_RPL (getcwd, char *, (char *buf, size_t size));
541# else
542/* Need to cast, because on mingw, the second parameter is
543 int size. */
544_GL_CXXALIAS_SYS_CAST (getcwd, char *, (char *buf, size_t size));
545# endif
546_GL_CXXALIASWARN (getcwd);
547#elif defined GNULIB_POSIXCHECK
548# undef getcwd
549# if HAVE_RAW_DECL_GETCWD
550_GL_WARN_ON_USE (getcwd, "getcwd is unportable - "
551 "use gnulib module getcwd for portability");
552# endif
553#endif
554
555
556#if @GNULIB_GETDOMAINNAME@
557/* Return the NIS domain name of the machine.
558 WARNING! The NIS domain name is unrelated to the fully qualified host name
559 of the machine. It is also unrelated to email addresses.
560 WARNING! The NIS domain name is usually the empty string or "(none)" when
561 not using NIS.
562
563 Put up to LEN bytes of the NIS domain name into NAME.
564 Null terminate it if the name is shorter than LEN.
565 If the NIS domain name is longer than LEN, set errno = EINVAL and return -1.
566 Return 0 if successful, otherwise set errno and return -1. */
567# if @REPLACE_GETDOMAINNAME@
568# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
569# undef getdomainname
570# define getdomainname rpl_getdomainname
571# endif
572_GL_FUNCDECL_RPL (getdomainname, int, (char *name, size_t len)
573 _GL_ARG_NONNULL ((1)));
574_GL_CXXALIAS_RPL (getdomainname, int, (char *name, size_t len));
575# else
576# if !@HAVE_DECL_GETDOMAINNAME@
577_GL_FUNCDECL_SYS (getdomainname, int, (char *name, size_t len)
578 _GL_ARG_NONNULL ((1)));
579# endif
580_GL_CXXALIAS_SYS (getdomainname, int, (char *name, size_t len));
581# endif
582_GL_CXXALIASWARN (getdomainname);
583#elif defined GNULIB_POSIXCHECK
584# undef getdomainname
585# if HAVE_RAW_DECL_GETDOMAINNAME
586_GL_WARN_ON_USE (getdomainname, "getdomainname is unportable - "
587 "use gnulib module getdomainname for portability");
588# endif
589#endif
590
591
592#if @GNULIB_GETDTABLESIZE@
593/* Return the maximum number of file descriptors in the current process.
594 In POSIX, this is same as sysconf (_SC_OPEN_MAX). */
595# if !@HAVE_GETDTABLESIZE@
596_GL_FUNCDECL_SYS (getdtablesize, int, (void));
597# endif
598_GL_CXXALIAS_SYS (getdtablesize, int, (void));
599_GL_CXXALIASWARN (getdtablesize);
600#elif defined GNULIB_POSIXCHECK
601# undef getdtablesize
602# if HAVE_RAW_DECL_GETDTABLESIZE
603_GL_WARN_ON_USE (getdtablesize, "getdtablesize is unportable - "
604 "use gnulib module getdtablesize for portability");
605# endif
606#endif
607
608
609#if @GNULIB_GETGROUPS@
610/* Return the supplemental groups that the current process belongs to.
611 It is unspecified whether the effective group id is in the list.
612 If N is 0, return the group count; otherwise, N describes how many
613 entries are available in GROUPS. Return -1 and set errno if N is
614 not 0 and not large enough. Fails with ENOSYS on some systems. */
615# if @REPLACE_GETGROUPS@
616# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
617# undef getgroups
618# define getgroups rpl_getgroups
619# endif
620_GL_FUNCDECL_RPL (getgroups, int, (int n, gid_t *groups));
621_GL_CXXALIAS_RPL (getgroups, int, (int n, gid_t *groups));
622# else
623# if !@HAVE_GETGROUPS@
624_GL_FUNCDECL_SYS (getgroups, int, (int n, gid_t *groups));
625# endif
626_GL_CXXALIAS_SYS (getgroups, int, (int n, gid_t *groups));
627# endif
628_GL_CXXALIASWARN (getgroups);
629#elif defined GNULIB_POSIXCHECK
630# undef getgroups
631# if HAVE_RAW_DECL_GETGROUPS
632_GL_WARN_ON_USE (getgroups, "getgroups is unportable - "
633 "use gnulib module getgroups for portability");
634# endif
635#endif
636
637
638#if @GNULIB_GETHOSTNAME@
639/* Return the standard host name of the machine.
640 WARNING! The host name may or may not be fully qualified.
641
642 Put up to LEN bytes of the host name into NAME.
643 Null terminate it if the name is shorter than LEN.
644 If the host name is longer than LEN, set errno = EINVAL and return -1.
645 Return 0 if successful, otherwise set errno and return -1. */
646# if @UNISTD_H_HAVE_WINSOCK2_H@
647# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
648# undef gethostname
649# define gethostname rpl_gethostname
650# endif
651_GL_FUNCDECL_RPL (gethostname, int, (char *name, size_t len)
652 _GL_ARG_NONNULL ((1)));
653_GL_CXXALIAS_RPL (gethostname, int, (char *name, size_t len));
654# else
655# if !@HAVE_GETHOSTNAME@
656_GL_FUNCDECL_SYS (gethostname, int, (char *name, size_t len)
657 _GL_ARG_NONNULL ((1)));
658# endif
659/* Need to cast, because on Solaris 10 and OSF/1 5.1 systems, the second
660 parameter is
661 int len. */
662_GL_CXXALIAS_SYS_CAST (gethostname, int, (char *name, size_t len));
663# endif
664_GL_CXXALIASWARN (gethostname);
665#elif @UNISTD_H_HAVE_WINSOCK2_H@
666# undef gethostname
667# define gethostname gethostname_used_without_requesting_gnulib_module_gethostname
668#elif defined GNULIB_POSIXCHECK
669# undef gethostname
670# if HAVE_RAW_DECL_GETHOSTNAME
671_GL_WARN_ON_USE (gethostname, "gethostname is unportable - "
672 "use gnulib module gethostname for portability");
673# endif
674#endif
675
676
677#if @GNULIB_GETLOGIN@
678/* Returns the user's login name, or NULL if it cannot be found. Upon error,
679 returns NULL with errno set.
680
681 See <http://www.opengroup.org/susv3xsh/getlogin.html>.
682
683 Most programs don't need to use this function, because the information is
684 available through environment variables:
685 ${LOGNAME-$USER} on Unix platforms,
686 $USERNAME on native Windows platforms.
687 */
688# if !@HAVE_GETLOGIN@
689_GL_FUNCDECL_SYS (getlogin, char *, (void));
690# endif
691_GL_CXXALIAS_SYS (getlogin, char *, (void));
692_GL_CXXALIASWARN (getlogin);
693#elif defined GNULIB_POSIXCHECK
694# undef getlogin
695# if HAVE_RAW_DECL_GETLOGIN
696_GL_WARN_ON_USE (getlogin, "getlogin is unportable - "
697 "use gnulib module getlogin for portability");
698# endif
699#endif
700
701
702#if @GNULIB_GETLOGIN_R@
703/* Copies the user's login name to NAME.
704 The array pointed to by NAME has room for SIZE bytes.
705
706 Returns 0 if successful. Upon error, an error number is returned, or -1 in
707 the case that the login name cannot be found but no specific error is
708 provided (this case is hopefully rare but is left open by the POSIX spec).
709
710 See <http://www.opengroup.org/susv3xsh/getlogin.html>.
711
712 Most programs don't need to use this function, because the information is
713 available through environment variables:
714 ${LOGNAME-$USER} on Unix platforms,
715 $USERNAME on native Windows platforms.
716 */
717# if @REPLACE_GETLOGIN_R@
718# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
719# define getlogin_r rpl_getlogin_r
720# endif
721_GL_FUNCDECL_RPL (getlogin_r, int, (char *name, size_t size)
722 _GL_ARG_NONNULL ((1)));
723_GL_CXXALIAS_RPL (getlogin_r, int, (char *name, size_t size));
724# else
725# if !@HAVE_DECL_GETLOGIN_R@
726_GL_FUNCDECL_SYS (getlogin_r, int, (char *name, size_t size)
727 _GL_ARG_NONNULL ((1)));
728# endif
729/* Need to cast, because on Solaris 10 systems, the second argument is
730 int size. */
731_GL_CXXALIAS_SYS_CAST (getlogin_r, int, (char *name, size_t size));
732# endif
733_GL_CXXALIASWARN (getlogin_r);
734#elif defined GNULIB_POSIXCHECK
735# undef getlogin_r
736# if HAVE_RAW_DECL_GETLOGIN_R
737_GL_WARN_ON_USE (getlogin_r, "getlogin_r is unportable - "
738 "use gnulib module getlogin_r for portability");
739# endif
740#endif
741
742
743#if @GNULIB_GETPAGESIZE@
744# if @REPLACE_GETPAGESIZE@
745# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
746# define getpagesize rpl_getpagesize
747# endif
748_GL_FUNCDECL_RPL (getpagesize, int, (void));
749_GL_CXXALIAS_RPL (getpagesize, int, (void));
750# else
751# if !@HAVE_GETPAGESIZE@
752# if !defined getpagesize
753/* This is for POSIX systems. */
754# if !defined _gl_getpagesize && defined _SC_PAGESIZE
755# if ! (defined __VMS && __VMS_VER < 70000000)
756# define _gl_getpagesize() sysconf (_SC_PAGESIZE)
757# endif
758# endif
759/* This is for older VMS. */
760# if !defined _gl_getpagesize && defined __VMS
761# ifdef __ALPHA
762# define _gl_getpagesize() 8192
763# else
764# define _gl_getpagesize() 512
765# endif
766# endif
767/* This is for BeOS. */
768# if !defined _gl_getpagesize && @HAVE_OS_H@
769# include <OS.h>
770# if defined B_PAGE_SIZE
771# define _gl_getpagesize() B_PAGE_SIZE
772# endif
773# endif
774/* This is for AmigaOS4.0. */
775# if !defined _gl_getpagesize && defined __amigaos4__
776# define _gl_getpagesize() 2048
777# endif
778/* This is for older Unix systems. */
779# if !defined _gl_getpagesize && @HAVE_SYS_PARAM_H@
780# include <sys/param.h>
781# ifdef EXEC_PAGESIZE
782# define _gl_getpagesize() EXEC_PAGESIZE
783# else
784# ifdef NBPG
785# ifndef CLSIZE
786# define CLSIZE 1
787# endif
788# define _gl_getpagesize() (NBPG * CLSIZE)
789# else
790# ifdef NBPC
791# define _gl_getpagesize() NBPC
792# endif
793# endif
794# endif
795# endif
796# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
797# define getpagesize() _gl_getpagesize ()
798# else
59578570 799# if !GNULIB_defined_getpagesize_function
e275c824
PE
800static inline int
801getpagesize ()
802{
803 return _gl_getpagesize ();
804}
59578570
PE
805# define GNULIB_defined_getpagesize_function 1
806# endif
e275c824
PE
807# endif
808# endif
809# endif
810/* Need to cast, because on Cygwin 1.5.x systems, the return type is size_t. */
811_GL_CXXALIAS_SYS_CAST (getpagesize, int, (void));
812# endif
813# if @HAVE_DECL_GETPAGESIZE@
814_GL_CXXALIASWARN (getpagesize);
815# endif
816#elif defined GNULIB_POSIXCHECK
817# undef getpagesize
818# if HAVE_RAW_DECL_GETPAGESIZE
819_GL_WARN_ON_USE (getpagesize, "getpagesize is unportable - "
820 "use gnulib module getpagesize for portability");
821# endif
822#endif
823
824
825#if @GNULIB_GETUSERSHELL@
826/* Return the next valid login shell on the system, or NULL when the end of
827 the list has been reached. */
828# if !@HAVE_DECL_GETUSERSHELL@
829_GL_FUNCDECL_SYS (getusershell, char *, (void));
830# endif
831_GL_CXXALIAS_SYS (getusershell, char *, (void));
832_GL_CXXALIASWARN (getusershell);
833#elif defined GNULIB_POSIXCHECK
834# undef getusershell
835# if HAVE_RAW_DECL_GETUSERSHELL
836_GL_WARN_ON_USE (getusershell, "getusershell is unportable - "
837 "use gnulib module getusershell for portability");
838# endif
839#endif
840
841#if @GNULIB_GETUSERSHELL@
842/* Rewind to pointer that is advanced at each getusershell() call. */
843# if !@HAVE_DECL_GETUSERSHELL@
844_GL_FUNCDECL_SYS (setusershell, void, (void));
845# endif
846_GL_CXXALIAS_SYS (setusershell, void, (void));
847_GL_CXXALIASWARN (setusershell);
848#elif defined GNULIB_POSIXCHECK
849# undef setusershell
850# if HAVE_RAW_DECL_SETUSERSHELL
851_GL_WARN_ON_USE (setusershell, "setusershell is unportable - "
852 "use gnulib module getusershell for portability");
853# endif
854#endif
855
856#if @GNULIB_GETUSERSHELL@
857/* Free the pointer that is advanced at each getusershell() call and
858 associated resources. */
859# if !@HAVE_DECL_GETUSERSHELL@
860_GL_FUNCDECL_SYS (endusershell, void, (void));
861# endif
862_GL_CXXALIAS_SYS (endusershell, void, (void));
863_GL_CXXALIASWARN (endusershell);
864#elif defined GNULIB_POSIXCHECK
865# undef endusershell
866# if HAVE_RAW_DECL_ENDUSERSHELL
867_GL_WARN_ON_USE (endusershell, "endusershell is unportable - "
868 "use gnulib module getusershell for portability");
869# endif
870#endif
871
872
873#if @GNULIB_LCHOWN@
874/* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
875 to GID (if GID is not -1). Do not follow symbolic links.
876 Return 0 if successful, otherwise -1 and errno set.
877 See the POSIX:2001 specification
878 <http://www.opengroup.org/susv3xsh/lchown.html>. */
879# if @REPLACE_LCHOWN@
880# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
881# undef lchown
882# define lchown rpl_lchown
883# endif
884_GL_FUNCDECL_RPL (lchown, int, (char const *file, uid_t owner, gid_t group)
885 _GL_ARG_NONNULL ((1)));
886_GL_CXXALIAS_RPL (lchown, int, (char const *file, uid_t owner, gid_t group));
887# else
888# if !@HAVE_LCHOWN@
889_GL_FUNCDECL_SYS (lchown, int, (char const *file, uid_t owner, gid_t group)
890 _GL_ARG_NONNULL ((1)));
891# endif
892_GL_CXXALIAS_SYS (lchown, int, (char const *file, uid_t owner, gid_t group));
893# endif
894_GL_CXXALIASWARN (lchown);
895#elif defined GNULIB_POSIXCHECK
896# undef lchown
897# if HAVE_RAW_DECL_LCHOWN
898_GL_WARN_ON_USE (lchown, "lchown is unportable to pre-POSIX.1-2001 systems - "
899 "use gnulib module lchown for portability");
900# endif
901#endif
902
903
904#if @GNULIB_LINK@
905/* Create a new hard link for an existing file.
906 Return 0 if successful, otherwise -1 and errno set.
907 See POSIX:2001 specification
908 <http://www.opengroup.org/susv3xsh/link.html>. */
909# if @REPLACE_LINK@
910# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
911# define link rpl_link
912# endif
913_GL_FUNCDECL_RPL (link, int, (const char *path1, const char *path2)
914 _GL_ARG_NONNULL ((1, 2)));
915_GL_CXXALIAS_RPL (link, int, (const char *path1, const char *path2));
916# else
917# if !@HAVE_LINK@
918_GL_FUNCDECL_SYS (link, int, (const char *path1, const char *path2)
919 _GL_ARG_NONNULL ((1, 2)));
920# endif
921_GL_CXXALIAS_SYS (link, int, (const char *path1, const char *path2));
922# endif
923_GL_CXXALIASWARN (link);
924#elif defined GNULIB_POSIXCHECK
925# undef link
926# if HAVE_RAW_DECL_LINK
927_GL_WARN_ON_USE (link, "link is unportable - "
928 "use gnulib module link for portability");
929# endif
930#endif
931
932
933#if @GNULIB_LINKAT@
934/* Create a new hard link for an existing file, relative to two
935 directories. FLAG controls whether symlinks are followed.
936 Return 0 if successful, otherwise -1 and errno set. */
937# if @REPLACE_LINKAT@
938# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
939# undef linkat
940# define linkat rpl_linkat
941# endif
942_GL_FUNCDECL_RPL (linkat, int,
943 (int fd1, const char *path1, int fd2, const char *path2,
944 int flag)
945 _GL_ARG_NONNULL ((2, 4)));
946_GL_CXXALIAS_RPL (linkat, int,
947 (int fd1, const char *path1, int fd2, const char *path2,
948 int flag));
949# else
950# if !@HAVE_LINKAT@
951_GL_FUNCDECL_SYS (linkat, int,
952 (int fd1, const char *path1, int fd2, const char *path2,
953 int flag)
954 _GL_ARG_NONNULL ((2, 4)));
955# endif
956_GL_CXXALIAS_SYS (linkat, int,
957 (int fd1, const char *path1, int fd2, const char *path2,
958 int flag));
959# endif
960_GL_CXXALIASWARN (linkat);
961#elif defined GNULIB_POSIXCHECK
962# undef linkat
963# if HAVE_RAW_DECL_LINKAT
964_GL_WARN_ON_USE (linkat, "linkat is unportable - "
965 "use gnulib module linkat for portability");
966# endif
967#endif
968
969
970#if @GNULIB_LSEEK@
971/* Set the offset of FD relative to SEEK_SET, SEEK_CUR, or SEEK_END.
972 Return the new offset if successful, otherwise -1 and errno set.
973 See the POSIX:2001 specification
974 <http://www.opengroup.org/susv3xsh/lseek.html>. */
975# if @REPLACE_LSEEK@
976# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
977# define lseek rpl_lseek
978# endif
979_GL_FUNCDECL_RPL (lseek, off_t, (int fd, off_t offset, int whence));
980_GL_CXXALIAS_RPL (lseek, off_t, (int fd, off_t offset, int whence));
981# else
982_GL_CXXALIAS_SYS (lseek, off_t, (int fd, off_t offset, int whence));
983# endif
984_GL_CXXALIASWARN (lseek);
985#elif defined GNULIB_POSIXCHECK
986# undef lseek
987# if HAVE_RAW_DECL_LSEEK
988_GL_WARN_ON_USE (lseek, "lseek does not fail with ESPIPE on pipes on some "
989 "systems - use gnulib module lseek for portability");
990# endif
991#endif
992
993
994#if @GNULIB_PIPE@
995/* Create a pipe, defaulting to O_BINARY mode.
996 Store the read-end as fd[0] and the write-end as fd[1].
997 Return 0 upon success, or -1 with errno set upon failure. */
998# if !@HAVE_PIPE@
999_GL_FUNCDECL_SYS (pipe, int, (int fd[2]) _GL_ARG_NONNULL ((1)));
1000# endif
1001_GL_CXXALIAS_SYS (pipe, int, (int fd[2]));
1002_GL_CXXALIASWARN (pipe);
1003#elif defined GNULIB_POSIXCHECK
1004# undef pipe
1005# if HAVE_RAW_DECL_PIPE
1006_GL_WARN_ON_USE (pipe, "pipe is unportable - "
1007 "use gnulib module pipe-posix for portability");
1008# endif
1009#endif
1010
1011
1012#if @GNULIB_PIPE2@
1013/* Create a pipe, applying the given flags when opening the read-end of the
1014 pipe and the write-end of the pipe.
1015 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
1016 and O_TEXT, O_BINARY (defined in "binary-io.h").
1017 Store the read-end as fd[0] and the write-end as fd[1].
1018 Return 0 upon success, or -1 with errno set upon failure.
1019 See also the Linux man page at
1020 <http://www.kernel.org/doc/man-pages/online/pages/man2/pipe2.2.html>. */
1021# if @HAVE_PIPE2@
1022# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1023# define pipe2 rpl_pipe2
1024# endif
1025_GL_FUNCDECL_RPL (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1)));
1026_GL_CXXALIAS_RPL (pipe2, int, (int fd[2], int flags));
1027# else
1028_GL_FUNCDECL_SYS (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1)));
1029_GL_CXXALIAS_SYS (pipe2, int, (int fd[2], int flags));
1030# endif
1031_GL_CXXALIASWARN (pipe2);
1032#elif defined GNULIB_POSIXCHECK
1033# undef pipe2
1034# if HAVE_RAW_DECL_PIPE2
1035_GL_WARN_ON_USE (pipe2, "pipe2 is unportable - "
1036 "use gnulib module pipe2 for portability");
1037# endif
1038#endif
1039
1040
1041#if @GNULIB_PREAD@
1042/* Read at most BUFSIZE bytes from FD into BUF, starting at OFFSET.
1043 Return the number of bytes placed into BUF if successful, otherwise
1044 set errno and return -1. 0 indicates EOF. See the POSIX:2001
1045 specification <http://www.opengroup.org/susv3xsh/pread.html>. */
1046# if @REPLACE_PREAD@
1047# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1048# define pread rpl_pread
1049# endif
1050_GL_FUNCDECL_RPL (pread, ssize_t,
1051 (int fd, void *buf, size_t bufsize, off_t offset)
1052 _GL_ARG_NONNULL ((2)));
1053_GL_CXXALIAS_RPL (pread, ssize_t,
1054 (int fd, void *buf, size_t bufsize, off_t offset));
1055# else
1056# if !@HAVE_PREAD@
1057_GL_FUNCDECL_SYS (pread, ssize_t,
1058 (int fd, void *buf, size_t bufsize, off_t offset)
1059 _GL_ARG_NONNULL ((2)));
1060# endif
1061_GL_CXXALIAS_SYS (pread, ssize_t,
1062 (int fd, void *buf, size_t bufsize, off_t offset));
1063# endif
1064_GL_CXXALIASWARN (pread);
1065#elif defined GNULIB_POSIXCHECK
1066# undef pread
1067# if HAVE_RAW_DECL_PREAD
1068_GL_WARN_ON_USE (pread, "pread is unportable - "
1069 "use gnulib module pread for portability");
1070# endif
1071#endif
1072
1073
1074#if @GNULIB_PWRITE@
1075/* Write at most BUFSIZE bytes from BUF into FD, starting at OFFSET.
1076 Return the number of bytes written if successful, otherwise
1077 set errno and return -1. 0 indicates nothing written. See the
1078 POSIX:2001 specification
1079 <http://www.opengroup.org/susv3xsh/pwrite.html>. */
1080# if @REPLACE_PWRITE@
1081# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1082# define pwrite rpl_pwrite
1083# endif
1084_GL_FUNCDECL_RPL (pwrite, ssize_t,
1085 (int fd, const void *buf, size_t bufsize, off_t offset)
1086 _GL_ARG_NONNULL ((2)));
1087_GL_CXXALIAS_RPL (pwrite, ssize_t,
1088 (int fd, const void *buf, size_t bufsize, off_t offset));
1089# else
1090# if !@HAVE_PWRITE@
1091_GL_FUNCDECL_SYS (pwrite, ssize_t,
1092 (int fd, const void *buf, size_t bufsize, off_t offset)
1093 _GL_ARG_NONNULL ((2)));
1094# endif
1095_GL_CXXALIAS_SYS (pwrite, ssize_t,
1096 (int fd, const void *buf, size_t bufsize, off_t offset));
1097# endif
1098_GL_CXXALIASWARN (pwrite);
1099#elif defined GNULIB_POSIXCHECK
1100# undef pwrite
1101# if HAVE_RAW_DECL_PWRITE
1102_GL_WARN_ON_USE (pwrite, "pwrite is unportable - "
1103 "use gnulib module pwrite for portability");
1104# endif
1105#endif
1106
1107
1108#if @GNULIB_READLINK@
1109/* Read the contents of the symbolic link FILE and place the first BUFSIZE
1110 bytes of it into BUF. Return the number of bytes placed into BUF if
1111 successful, otherwise -1 and errno set.
1112 See the POSIX:2001 specification
1113 <http://www.opengroup.org/susv3xsh/readlink.html>. */
1114# if @REPLACE_READLINK@
1115# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1116# define readlink rpl_readlink
1117# endif
1118_GL_FUNCDECL_RPL (readlink, ssize_t,
1119 (const char *file, char *buf, size_t bufsize)
1120 _GL_ARG_NONNULL ((1, 2)));
1121_GL_CXXALIAS_RPL (readlink, ssize_t,
1122 (const char *file, char *buf, size_t bufsize));
1123# else
1124# if !@HAVE_READLINK@
1125_GL_FUNCDECL_SYS (readlink, ssize_t,
1126 (const char *file, char *buf, size_t bufsize)
1127 _GL_ARG_NONNULL ((1, 2)));
1128# endif
1129_GL_CXXALIAS_SYS (readlink, ssize_t,
1130 (const char *file, char *buf, size_t bufsize));
1131# endif
1132_GL_CXXALIASWARN (readlink);
1133#elif defined GNULIB_POSIXCHECK
1134# undef readlink
1135# if HAVE_RAW_DECL_READLINK
1136_GL_WARN_ON_USE (readlink, "readlink is unportable - "
1137 "use gnulib module readlink for portability");
1138# endif
1139#endif
1140
1141
1142#if @GNULIB_READLINKAT@
1143# if !@HAVE_READLINKAT@
1144_GL_FUNCDECL_SYS (readlinkat, ssize_t,
1145 (int fd, char const *file, char *buf, size_t len)
1146 _GL_ARG_NONNULL ((2, 3)));
1147# endif
1148_GL_CXXALIAS_SYS (readlinkat, ssize_t,
1149 (int fd, char const *file, char *buf, size_t len));
1150_GL_CXXALIASWARN (readlinkat);
1151#elif defined GNULIB_POSIXCHECK
1152# undef readlinkat
1153# if HAVE_RAW_DECL_READLINKAT
1154_GL_WARN_ON_USE (readlinkat, "readlinkat is not portable - "
1155 "use gnulib module readlinkat for portability");
1156# endif
1157#endif
1158
1159
1160#if @GNULIB_RMDIR@
1161/* Remove the directory DIR. */
1162# if @REPLACE_RMDIR@
1163# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1164# define rmdir rpl_rmdir
1165# endif
1166_GL_FUNCDECL_RPL (rmdir, int, (char const *name) _GL_ARG_NONNULL ((1)));
1167_GL_CXXALIAS_RPL (rmdir, int, (char const *name));
1168# else
1169_GL_CXXALIAS_SYS (rmdir, int, (char const *name));
1170# endif
1171_GL_CXXALIASWARN (rmdir);
1172#elif defined GNULIB_POSIXCHECK
1173# undef rmdir
1174# if HAVE_RAW_DECL_RMDIR
1175_GL_WARN_ON_USE (rmdir, "rmdir is unportable - "
1176 "use gnulib module rmdir for portability");
1177# endif
1178#endif
1179
1180
1181#if @GNULIB_SLEEP@
1182/* Pause the execution of the current thread for N seconds.
1183 Returns the number of seconds left to sleep.
1184 See the POSIX:2001 specification
1185 <http://www.opengroup.org/susv3xsh/sleep.html>. */
1186# if @REPLACE_SLEEP@
1187# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1188# undef sleep
1189# define sleep rpl_sleep
1190# endif
1191_GL_FUNCDECL_RPL (sleep, unsigned int, (unsigned int n));
1192_GL_CXXALIAS_RPL (sleep, unsigned int, (unsigned int n));
1193# else
1194# if !@HAVE_SLEEP@
1195_GL_FUNCDECL_SYS (sleep, unsigned int, (unsigned int n));
1196# endif
1197_GL_CXXALIAS_SYS (sleep, unsigned int, (unsigned int n));
1198# endif
1199_GL_CXXALIASWARN (sleep);
1200#elif defined GNULIB_POSIXCHECK
1201# undef sleep
1202# if HAVE_RAW_DECL_SLEEP
1203_GL_WARN_ON_USE (sleep, "sleep is unportable - "
1204 "use gnulib module sleep for portability");
1205# endif
1206#endif
1207
1208
1209#if @GNULIB_SYMLINK@
1210# if @REPLACE_SYMLINK@
1211# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1212# undef symlink
1213# define symlink rpl_symlink
1214# endif
1215_GL_FUNCDECL_RPL (symlink, int, (char const *contents, char const *file)
1216 _GL_ARG_NONNULL ((1, 2)));
1217_GL_CXXALIAS_RPL (symlink, int, (char const *contents, char const *file));
1218# else
1219# if !@HAVE_SYMLINK@
1220_GL_FUNCDECL_SYS (symlink, int, (char const *contents, char const *file)
1221 _GL_ARG_NONNULL ((1, 2)));
1222# endif
1223_GL_CXXALIAS_SYS (symlink, int, (char const *contents, char const *file));
1224# endif
1225_GL_CXXALIASWARN (symlink);
1226#elif defined GNULIB_POSIXCHECK
1227# undef symlink
1228# if HAVE_RAW_DECL_SYMLINK
1229_GL_WARN_ON_USE (symlink, "symlink is not portable - "
1230 "use gnulib module symlink for portability");
1231# endif
1232#endif
1233
1234
1235#if @GNULIB_SYMLINKAT@
1236# if !@HAVE_SYMLINKAT@
1237_GL_FUNCDECL_SYS (symlinkat, int,
1238 (char const *contents, int fd, char const *file)
1239 _GL_ARG_NONNULL ((1, 3)));
1240# endif
1241_GL_CXXALIAS_SYS (symlinkat, int,
1242 (char const *contents, int fd, char const *file));
1243_GL_CXXALIASWARN (symlinkat);
1244#elif defined GNULIB_POSIXCHECK
1245# undef symlinkat
1246# if HAVE_RAW_DECL_SYMLINKAT
1247_GL_WARN_ON_USE (symlinkat, "symlinkat is not portable - "
1248 "use gnulib module symlinkat for portability");
1249# endif
1250#endif
1251
1252
1253#if @GNULIB_TTYNAME_R@
1254/* Store at most BUFLEN characters of the pathname of the terminal FD is
1255 open on in BUF. Return 0 on success, otherwise an error number. */
1256# if @REPLACE_TTYNAME_R@
1257# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1258# undef ttyname_r
1259# define ttyname_r rpl_ttyname_r
1260# endif
1261_GL_FUNCDECL_RPL (ttyname_r, int,
1262 (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
1263_GL_CXXALIAS_RPL (ttyname_r, int,
1264 (int fd, char *buf, size_t buflen));
1265# else
1266# if !@HAVE_DECL_TTYNAME_R@
1267_GL_FUNCDECL_SYS (ttyname_r, int,
1268 (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
1269# endif
1270_GL_CXXALIAS_SYS (ttyname_r, int,
1271 (int fd, char *buf, size_t buflen));
1272# endif
1273_GL_CXXALIASWARN (ttyname_r);
1274#elif defined GNULIB_POSIXCHECK
1275# undef ttyname_r
1276# if HAVE_RAW_DECL_TTYNAME_R
1277_GL_WARN_ON_USE (ttyname_r, "ttyname_r is not portable - "
1278 "use gnulib module ttyname_r for portability");
1279# endif
1280#endif
1281
1282
1283#if @GNULIB_UNLINK@
1284# if @REPLACE_UNLINK@
1285# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1286# undef unlink
1287# define unlink rpl_unlink
1288# endif
1289_GL_FUNCDECL_RPL (unlink, int, (char const *file) _GL_ARG_NONNULL ((1)));
1290_GL_CXXALIAS_RPL (unlink, int, (char const *file));
1291# else
1292_GL_CXXALIAS_SYS (unlink, int, (char const *file));
1293# endif
1294_GL_CXXALIASWARN (unlink);
1295#elif defined GNULIB_POSIXCHECK
1296# undef unlink
1297# if HAVE_RAW_DECL_UNLINK
1298_GL_WARN_ON_USE (unlink, "unlink is not portable - "
1299 "use gnulib module unlink for portability");
1300# endif
1301#endif
1302
1303
1304#if @GNULIB_UNLINKAT@
1305# if @REPLACE_UNLINKAT@
1306# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1307# undef unlinkat
1308# define unlinkat rpl_unlinkat
1309# endif
1310_GL_FUNCDECL_RPL (unlinkat, int, (int fd, char const *file, int flag)
1311 _GL_ARG_NONNULL ((2)));
1312_GL_CXXALIAS_RPL (unlinkat, int, (int fd, char const *file, int flag));
1313# else
1314# if !@HAVE_UNLINKAT@
1315_GL_FUNCDECL_SYS (unlinkat, int, (int fd, char const *file, int flag)
1316 _GL_ARG_NONNULL ((2)));
1317# endif
1318_GL_CXXALIAS_SYS (unlinkat, int, (int fd, char const *file, int flag));
1319# endif
1320_GL_CXXALIASWARN (unlinkat);
1321#elif defined GNULIB_POSIXCHECK
1322# undef unlinkat
1323# if HAVE_RAW_DECL_UNLINKAT
1324_GL_WARN_ON_USE (unlinkat, "unlinkat is not portable - "
1325 "use gnulib module openat for portability");
1326# endif
1327#endif
1328
1329
1330#if @GNULIB_USLEEP@
1331/* Pause the execution of the current thread for N microseconds.
1332 Returns 0 on completion, or -1 on range error.
1333 See the POSIX:2001 specification
1334 <http://www.opengroup.org/susv3xsh/sleep.html>. */
1335# if @REPLACE_USLEEP@
1336# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1337# undef usleep
1338# define usleep rpl_usleep
1339# endif
1340_GL_FUNCDECL_RPL (usleep, int, (useconds_t n));
1341_GL_CXXALIAS_RPL (usleep, int, (useconds_t n));
1342# else
1343# if !@HAVE_USLEEP@
1344_GL_FUNCDECL_SYS (usleep, int, (useconds_t n));
1345# endif
1346_GL_CXXALIAS_SYS (usleep, int, (useconds_t n));
1347# endif
1348_GL_CXXALIASWARN (usleep);
1349#elif defined GNULIB_POSIXCHECK
1350# undef usleep
1351# if HAVE_RAW_DECL_USLEEP
1352_GL_WARN_ON_USE (usleep, "usleep is unportable - "
1353 "use gnulib module usleep for portability");
1354# endif
1355#endif
1356
1357
1358#if @GNULIB_WRITE@
1359/* Write up to COUNT bytes starting at BUF to file descriptor FD.
1360 See the POSIX:2001 specification
1361 <http://www.opengroup.org/susv3xsh/write.html>. */
1362# if @REPLACE_WRITE@ && @GNULIB_UNISTD_H_SIGPIPE@
1363# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1364# undef write
1365# define write rpl_write
1366# endif
1367_GL_FUNCDECL_RPL (write, ssize_t, (int fd, const void *buf, size_t count)
1368 _GL_ARG_NONNULL ((2)));
1369_GL_CXXALIAS_RPL (write, ssize_t, (int fd, const void *buf, size_t count));
1370# else
1371/* Need to cast, because on mingw, the third parameter is
1372 unsigned int count
1373 and the return type is 'int'. */
1374_GL_CXXALIAS_SYS_CAST (write, ssize_t, (int fd, const void *buf, size_t count));
1375# endif
1376_GL_CXXALIASWARN (write);
1377#endif
1378
1379
e765a388
PE
1380#endif /* _GL_UNISTD_H */
1381#endif /* _GL_UNISTD_H */