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