Support :keylist and :crlfiles options to `gnutls-boot' and use them.
[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
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@
e765a388 123# if !defined _GL_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
e765a388 184# if !defined _GL_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
874#if @GNULIB_LCHOWN@
875/* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
876 to GID (if GID is not -1). Do not follow symbolic links.
877 Return 0 if successful, otherwise -1 and errno set.
878 See the POSIX:2001 specification
879 <http://www.opengroup.org/susv3xsh/lchown.html>. */
880# if @REPLACE_LCHOWN@
881# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
882# undef lchown
883# define lchown rpl_lchown
884# endif
885_GL_FUNCDECL_RPL (lchown, int, (char const *file, uid_t owner, gid_t group)
886 _GL_ARG_NONNULL ((1)));
887_GL_CXXALIAS_RPL (lchown, int, (char const *file, uid_t owner, gid_t group));
888# else
889# if !@HAVE_LCHOWN@
890_GL_FUNCDECL_SYS (lchown, int, (char const *file, uid_t owner, gid_t group)
891 _GL_ARG_NONNULL ((1)));
892# endif
893_GL_CXXALIAS_SYS (lchown, int, (char const *file, uid_t owner, gid_t group));
894# endif
895_GL_CXXALIASWARN (lchown);
896#elif defined GNULIB_POSIXCHECK
897# undef lchown
898# if HAVE_RAW_DECL_LCHOWN
899_GL_WARN_ON_USE (lchown, "lchown is unportable to pre-POSIX.1-2001 systems - "
900 "use gnulib module lchown for portability");
901# endif
902#endif
903
904
905#if @GNULIB_LINK@
906/* Create a new hard link for an existing file.
907 Return 0 if successful, otherwise -1 and errno set.
908 See POSIX:2001 specification
909 <http://www.opengroup.org/susv3xsh/link.html>. */
910# if @REPLACE_LINK@
911# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
912# define link rpl_link
913# endif
914_GL_FUNCDECL_RPL (link, int, (const char *path1, const char *path2)
915 _GL_ARG_NONNULL ((1, 2)));
916_GL_CXXALIAS_RPL (link, int, (const char *path1, const char *path2));
917# else
918# if !@HAVE_LINK@
919_GL_FUNCDECL_SYS (link, int, (const char *path1, const char *path2)
920 _GL_ARG_NONNULL ((1, 2)));
921# endif
922_GL_CXXALIAS_SYS (link, int, (const char *path1, const char *path2));
923# endif
924_GL_CXXALIASWARN (link);
925#elif defined GNULIB_POSIXCHECK
926# undef link
927# if HAVE_RAW_DECL_LINK
928_GL_WARN_ON_USE (link, "link is unportable - "
929 "use gnulib module link for portability");
930# endif
931#endif
932
933
934#if @GNULIB_LINKAT@
935/* Create a new hard link for an existing file, relative to two
936 directories. FLAG controls whether symlinks are followed.
937 Return 0 if successful, otherwise -1 and errno set. */
938# if @REPLACE_LINKAT@
939# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
940# undef linkat
941# define linkat rpl_linkat
942# endif
943_GL_FUNCDECL_RPL (linkat, int,
944 (int fd1, const char *path1, int fd2, const char *path2,
945 int flag)
946 _GL_ARG_NONNULL ((2, 4)));
947_GL_CXXALIAS_RPL (linkat, int,
948 (int fd1, const char *path1, int fd2, const char *path2,
949 int flag));
950# else
951# if !@HAVE_LINKAT@
952_GL_FUNCDECL_SYS (linkat, int,
953 (int fd1, const char *path1, int fd2, const char *path2,
954 int flag)
955 _GL_ARG_NONNULL ((2, 4)));
956# endif
957_GL_CXXALIAS_SYS (linkat, int,
958 (int fd1, const char *path1, int fd2, const char *path2,
959 int flag));
960# endif
961_GL_CXXALIASWARN (linkat);
962#elif defined GNULIB_POSIXCHECK
963# undef linkat
964# if HAVE_RAW_DECL_LINKAT
965_GL_WARN_ON_USE (linkat, "linkat is unportable - "
966 "use gnulib module linkat for portability");
967# endif
968#endif
969
970
971#if @GNULIB_LSEEK@
972/* Set the offset of FD relative to SEEK_SET, SEEK_CUR, or SEEK_END.
973 Return the new offset if successful, otherwise -1 and errno set.
974 See the POSIX:2001 specification
975 <http://www.opengroup.org/susv3xsh/lseek.html>. */
976# if @REPLACE_LSEEK@
977# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
978# define lseek rpl_lseek
979# endif
980_GL_FUNCDECL_RPL (lseek, off_t, (int fd, off_t offset, int whence));
981_GL_CXXALIAS_RPL (lseek, off_t, (int fd, off_t offset, int whence));
982# else
983_GL_CXXALIAS_SYS (lseek, off_t, (int fd, off_t offset, int whence));
984# endif
985_GL_CXXALIASWARN (lseek);
986#elif defined GNULIB_POSIXCHECK
987# undef lseek
988# if HAVE_RAW_DECL_LSEEK
989_GL_WARN_ON_USE (lseek, "lseek does not fail with ESPIPE on pipes on some "
990 "systems - use gnulib module lseek for portability");
991# endif
992#endif
993
994
995#if @GNULIB_PIPE@
996/* Create a pipe, defaulting to O_BINARY mode.
997 Store the read-end as fd[0] and the write-end as fd[1].
998 Return 0 upon success, or -1 with errno set upon failure. */
999# if !@HAVE_PIPE@
1000_GL_FUNCDECL_SYS (pipe, int, (int fd[2]) _GL_ARG_NONNULL ((1)));
1001# endif
1002_GL_CXXALIAS_SYS (pipe, int, (int fd[2]));
1003_GL_CXXALIASWARN (pipe);
1004#elif defined GNULIB_POSIXCHECK
1005# undef pipe
1006# if HAVE_RAW_DECL_PIPE
1007_GL_WARN_ON_USE (pipe, "pipe is unportable - "
1008 "use gnulib module pipe-posix for portability");
1009# endif
1010#endif
1011
1012
1013#if @GNULIB_PIPE2@
1014/* Create a pipe, applying the given flags when opening the read-end of the
1015 pipe and the write-end of the pipe.
1016 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
1017 and O_TEXT, O_BINARY (defined in "binary-io.h").
1018 Store the read-end as fd[0] and the write-end as fd[1].
1019 Return 0 upon success, or -1 with errno set upon failure.
1020 See also the Linux man page at
1021 <http://www.kernel.org/doc/man-pages/online/pages/man2/pipe2.2.html>. */
1022# if @HAVE_PIPE2@
1023# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1024# define pipe2 rpl_pipe2
1025# endif
1026_GL_FUNCDECL_RPL (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1)));
1027_GL_CXXALIAS_RPL (pipe2, int, (int fd[2], int flags));
1028# else
1029_GL_FUNCDECL_SYS (pipe2, int, (int fd[2], int flags) _GL_ARG_NONNULL ((1)));
1030_GL_CXXALIAS_SYS (pipe2, int, (int fd[2], int flags));
1031# endif
1032_GL_CXXALIASWARN (pipe2);
1033#elif defined GNULIB_POSIXCHECK
1034# undef pipe2
1035# if HAVE_RAW_DECL_PIPE2
1036_GL_WARN_ON_USE (pipe2, "pipe2 is unportable - "
1037 "use gnulib module pipe2 for portability");
1038# endif
1039#endif
1040
1041
1042#if @GNULIB_PREAD@
1043/* Read at most BUFSIZE bytes from FD into BUF, starting at OFFSET.
1044 Return the number of bytes placed into BUF if successful, otherwise
1045 set errno and return -1. 0 indicates EOF. See the POSIX:2001
1046 specification <http://www.opengroup.org/susv3xsh/pread.html>. */
1047# if @REPLACE_PREAD@
1048# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1049# define pread rpl_pread
1050# endif
1051_GL_FUNCDECL_RPL (pread, ssize_t,
1052 (int fd, void *buf, size_t bufsize, off_t offset)
1053 _GL_ARG_NONNULL ((2)));
1054_GL_CXXALIAS_RPL (pread, ssize_t,
1055 (int fd, void *buf, size_t bufsize, off_t offset));
1056# else
1057# if !@HAVE_PREAD@
1058_GL_FUNCDECL_SYS (pread, ssize_t,
1059 (int fd, void *buf, size_t bufsize, off_t offset)
1060 _GL_ARG_NONNULL ((2)));
1061# endif
1062_GL_CXXALIAS_SYS (pread, ssize_t,
1063 (int fd, void *buf, size_t bufsize, off_t offset));
1064# endif
1065_GL_CXXALIASWARN (pread);
1066#elif defined GNULIB_POSIXCHECK
1067# undef pread
1068# if HAVE_RAW_DECL_PREAD
1069_GL_WARN_ON_USE (pread, "pread is unportable - "
1070 "use gnulib module pread for portability");
1071# endif
1072#endif
1073
1074
1075#if @GNULIB_PWRITE@
1076/* Write at most BUFSIZE bytes from BUF into FD, starting at OFFSET.
1077 Return the number of bytes written if successful, otherwise
1078 set errno and return -1. 0 indicates nothing written. See the
1079 POSIX:2001 specification
1080 <http://www.opengroup.org/susv3xsh/pwrite.html>. */
1081# if @REPLACE_PWRITE@
1082# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1083# define pwrite rpl_pwrite
1084# endif
1085_GL_FUNCDECL_RPL (pwrite, ssize_t,
1086 (int fd, const void *buf, size_t bufsize, off_t offset)
1087 _GL_ARG_NONNULL ((2)));
1088_GL_CXXALIAS_RPL (pwrite, ssize_t,
1089 (int fd, const void *buf, size_t bufsize, off_t offset));
1090# else
1091# if !@HAVE_PWRITE@
1092_GL_FUNCDECL_SYS (pwrite, ssize_t,
1093 (int fd, const void *buf, size_t bufsize, off_t offset)
1094 _GL_ARG_NONNULL ((2)));
1095# endif
1096_GL_CXXALIAS_SYS (pwrite, ssize_t,
1097 (int fd, const void *buf, size_t bufsize, off_t offset));
1098# endif
1099_GL_CXXALIASWARN (pwrite);
1100#elif defined GNULIB_POSIXCHECK
1101# undef pwrite
1102# if HAVE_RAW_DECL_PWRITE
1103_GL_WARN_ON_USE (pwrite, "pwrite is unportable - "
1104 "use gnulib module pwrite for portability");
1105# endif
1106#endif
1107
1108
cc2e7b46
PE
1109#if @GNULIB_READ@
1110/* Read up to COUNT bytes from file descriptor FD into the buffer starting
1111 at BUF. See the POSIX:2001 specification
1112 <http://www.opengroup.org/susv3xsh/read.html>. */
1113# if @REPLACE_READ@ && @GNULIB_UNISTD_H_NONBLOCKING@
1114# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1115# undef read
1116# define read rpl_read
1117# endif
1118_GL_FUNCDECL_RPL (read, ssize_t, (int fd, void *buf, size_t count)
1119 _GL_ARG_NONNULL ((2)));
1120_GL_CXXALIAS_RPL (read, ssize_t, (int fd, void *buf, size_t count));
1121# else
1122/* Need to cast, because on mingw, the third parameter is
1123 unsigned int count
1124 and the return type is 'int'. */
1125_GL_CXXALIAS_SYS_CAST (read, ssize_t, (int fd, void *buf, size_t count));
1126# endif
1127_GL_CXXALIASWARN (read);
1128#endif
1129
1130
e275c824
PE
1131#if @GNULIB_READLINK@
1132/* Read the contents of the symbolic link FILE and place the first BUFSIZE
1133 bytes of it into BUF. Return the number of bytes placed into BUF if
1134 successful, otherwise -1 and errno set.
1135 See the POSIX:2001 specification
1136 <http://www.opengroup.org/susv3xsh/readlink.html>. */
1137# if @REPLACE_READLINK@
1138# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1139# define readlink rpl_readlink
1140# endif
1141_GL_FUNCDECL_RPL (readlink, ssize_t,
1142 (const char *file, char *buf, size_t bufsize)
1143 _GL_ARG_NONNULL ((1, 2)));
1144_GL_CXXALIAS_RPL (readlink, ssize_t,
1145 (const char *file, char *buf, size_t bufsize));
1146# else
1147# if !@HAVE_READLINK@
1148_GL_FUNCDECL_SYS (readlink, ssize_t,
1149 (const char *file, char *buf, size_t bufsize)
1150 _GL_ARG_NONNULL ((1, 2)));
1151# endif
1152_GL_CXXALIAS_SYS (readlink, ssize_t,
1153 (const char *file, char *buf, size_t bufsize));
1154# endif
1155_GL_CXXALIASWARN (readlink);
1156#elif defined GNULIB_POSIXCHECK
1157# undef readlink
1158# if HAVE_RAW_DECL_READLINK
1159_GL_WARN_ON_USE (readlink, "readlink is unportable - "
1160 "use gnulib module readlink for portability");
1161# endif
1162#endif
1163
1164
1165#if @GNULIB_READLINKAT@
1166# if !@HAVE_READLINKAT@
1167_GL_FUNCDECL_SYS (readlinkat, ssize_t,
1168 (int fd, char const *file, char *buf, size_t len)
1169 _GL_ARG_NONNULL ((2, 3)));
1170# endif
1171_GL_CXXALIAS_SYS (readlinkat, ssize_t,
1172 (int fd, char const *file, char *buf, size_t len));
1173_GL_CXXALIASWARN (readlinkat);
1174#elif defined GNULIB_POSIXCHECK
1175# undef readlinkat
1176# if HAVE_RAW_DECL_READLINKAT
1177_GL_WARN_ON_USE (readlinkat, "readlinkat is not portable - "
1178 "use gnulib module readlinkat for portability");
1179# endif
1180#endif
1181
1182
1183#if @GNULIB_RMDIR@
1184/* Remove the directory DIR. */
1185# if @REPLACE_RMDIR@
1186# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1187# define rmdir rpl_rmdir
1188# endif
1189_GL_FUNCDECL_RPL (rmdir, int, (char const *name) _GL_ARG_NONNULL ((1)));
1190_GL_CXXALIAS_RPL (rmdir, int, (char const *name));
1191# else
1192_GL_CXXALIAS_SYS (rmdir, int, (char const *name));
1193# endif
1194_GL_CXXALIASWARN (rmdir);
1195#elif defined GNULIB_POSIXCHECK
1196# undef rmdir
1197# if HAVE_RAW_DECL_RMDIR
1198_GL_WARN_ON_USE (rmdir, "rmdir is unportable - "
1199 "use gnulib module rmdir for portability");
1200# endif
1201#endif
1202
1203
1204#if @GNULIB_SLEEP@
1205/* Pause the execution of the current thread for N seconds.
1206 Returns the number of seconds left to sleep.
1207 See the POSIX:2001 specification
1208 <http://www.opengroup.org/susv3xsh/sleep.html>. */
1209# if @REPLACE_SLEEP@
1210# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1211# undef sleep
1212# define sleep rpl_sleep
1213# endif
1214_GL_FUNCDECL_RPL (sleep, unsigned int, (unsigned int n));
1215_GL_CXXALIAS_RPL (sleep, unsigned int, (unsigned int n));
1216# else
1217# if !@HAVE_SLEEP@
1218_GL_FUNCDECL_SYS (sleep, unsigned int, (unsigned int n));
1219# endif
1220_GL_CXXALIAS_SYS (sleep, unsigned int, (unsigned int n));
1221# endif
1222_GL_CXXALIASWARN (sleep);
1223#elif defined GNULIB_POSIXCHECK
1224# undef sleep
1225# if HAVE_RAW_DECL_SLEEP
1226_GL_WARN_ON_USE (sleep, "sleep is unportable - "
1227 "use gnulib module sleep for portability");
1228# endif
1229#endif
1230
1231
1232#if @GNULIB_SYMLINK@
1233# if @REPLACE_SYMLINK@
1234# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1235# undef symlink
1236# define symlink rpl_symlink
1237# endif
1238_GL_FUNCDECL_RPL (symlink, int, (char const *contents, char const *file)
1239 _GL_ARG_NONNULL ((1, 2)));
1240_GL_CXXALIAS_RPL (symlink, int, (char const *contents, char const *file));
1241# else
1242# if !@HAVE_SYMLINK@
1243_GL_FUNCDECL_SYS (symlink, int, (char const *contents, char const *file)
1244 _GL_ARG_NONNULL ((1, 2)));
1245# endif
1246_GL_CXXALIAS_SYS (symlink, int, (char const *contents, char const *file));
1247# endif
1248_GL_CXXALIASWARN (symlink);
1249#elif defined GNULIB_POSIXCHECK
1250# undef symlink
1251# if HAVE_RAW_DECL_SYMLINK
1252_GL_WARN_ON_USE (symlink, "symlink is not portable - "
1253 "use gnulib module symlink for portability");
1254# endif
1255#endif
1256
1257
1258#if @GNULIB_SYMLINKAT@
1259# if !@HAVE_SYMLINKAT@
1260_GL_FUNCDECL_SYS (symlinkat, int,
1261 (char const *contents, int fd, char const *file)
1262 _GL_ARG_NONNULL ((1, 3)));
1263# endif
1264_GL_CXXALIAS_SYS (symlinkat, int,
1265 (char const *contents, int fd, char const *file));
1266_GL_CXXALIASWARN (symlinkat);
1267#elif defined GNULIB_POSIXCHECK
1268# undef symlinkat
1269# if HAVE_RAW_DECL_SYMLINKAT
1270_GL_WARN_ON_USE (symlinkat, "symlinkat is not portable - "
1271 "use gnulib module symlinkat for portability");
1272# endif
1273#endif
1274
1275
1276#if @GNULIB_TTYNAME_R@
1277/* Store at most BUFLEN characters of the pathname of the terminal FD is
1278 open on in BUF. Return 0 on success, otherwise an error number. */
1279# if @REPLACE_TTYNAME_R@
1280# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1281# undef ttyname_r
1282# define ttyname_r rpl_ttyname_r
1283# endif
1284_GL_FUNCDECL_RPL (ttyname_r, int,
1285 (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
1286_GL_CXXALIAS_RPL (ttyname_r, int,
1287 (int fd, char *buf, size_t buflen));
1288# else
1289# if !@HAVE_DECL_TTYNAME_R@
1290_GL_FUNCDECL_SYS (ttyname_r, int,
1291 (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
1292# endif
1293_GL_CXXALIAS_SYS (ttyname_r, int,
1294 (int fd, char *buf, size_t buflen));
1295# endif
1296_GL_CXXALIASWARN (ttyname_r);
1297#elif defined GNULIB_POSIXCHECK
1298# undef ttyname_r
1299# if HAVE_RAW_DECL_TTYNAME_R
1300_GL_WARN_ON_USE (ttyname_r, "ttyname_r is not portable - "
1301 "use gnulib module ttyname_r for portability");
1302# endif
1303#endif
1304
1305
1306#if @GNULIB_UNLINK@
1307# if @REPLACE_UNLINK@
1308# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1309# undef unlink
1310# define unlink rpl_unlink
1311# endif
1312_GL_FUNCDECL_RPL (unlink, int, (char const *file) _GL_ARG_NONNULL ((1)));
1313_GL_CXXALIAS_RPL (unlink, int, (char const *file));
1314# else
1315_GL_CXXALIAS_SYS (unlink, int, (char const *file));
1316# endif
1317_GL_CXXALIASWARN (unlink);
1318#elif defined GNULIB_POSIXCHECK
1319# undef unlink
1320# if HAVE_RAW_DECL_UNLINK
1321_GL_WARN_ON_USE (unlink, "unlink is not portable - "
1322 "use gnulib module unlink for portability");
1323# endif
1324#endif
1325
1326
1327#if @GNULIB_UNLINKAT@
1328# if @REPLACE_UNLINKAT@
1329# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1330# undef unlinkat
1331# define unlinkat rpl_unlinkat
1332# endif
1333_GL_FUNCDECL_RPL (unlinkat, int, (int fd, char const *file, int flag)
1334 _GL_ARG_NONNULL ((2)));
1335_GL_CXXALIAS_RPL (unlinkat, int, (int fd, char const *file, int flag));
1336# else
1337# if !@HAVE_UNLINKAT@
1338_GL_FUNCDECL_SYS (unlinkat, int, (int fd, char const *file, int flag)
1339 _GL_ARG_NONNULL ((2)));
1340# endif
1341_GL_CXXALIAS_SYS (unlinkat, int, (int fd, char const *file, int flag));
1342# endif
1343_GL_CXXALIASWARN (unlinkat);
1344#elif defined GNULIB_POSIXCHECK
1345# undef unlinkat
1346# if HAVE_RAW_DECL_UNLINKAT
1347_GL_WARN_ON_USE (unlinkat, "unlinkat is not portable - "
1348 "use gnulib module openat for portability");
1349# endif
1350#endif
1351
1352
1353#if @GNULIB_USLEEP@
1354/* Pause the execution of the current thread for N microseconds.
1355 Returns 0 on completion, or -1 on range error.
1356 See the POSIX:2001 specification
1357 <http://www.opengroup.org/susv3xsh/sleep.html>. */
1358# if @REPLACE_USLEEP@
1359# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1360# undef usleep
1361# define usleep rpl_usleep
1362# endif
1363_GL_FUNCDECL_RPL (usleep, int, (useconds_t n));
1364_GL_CXXALIAS_RPL (usleep, int, (useconds_t n));
1365# else
1366# if !@HAVE_USLEEP@
1367_GL_FUNCDECL_SYS (usleep, int, (useconds_t n));
1368# endif
1369_GL_CXXALIAS_SYS (usleep, int, (useconds_t n));
1370# endif
1371_GL_CXXALIASWARN (usleep);
1372#elif defined GNULIB_POSIXCHECK
1373# undef usleep
1374# if HAVE_RAW_DECL_USLEEP
1375_GL_WARN_ON_USE (usleep, "usleep is unportable - "
1376 "use gnulib module usleep for portability");
1377# endif
1378#endif
1379
1380
1381#if @GNULIB_WRITE@
1382/* Write up to COUNT bytes starting at BUF to file descriptor FD.
1383 See the POSIX:2001 specification
1384 <http://www.opengroup.org/susv3xsh/write.html>. */
cc2e7b46 1385# if @REPLACE_WRITE@ && (@GNULIB_UNISTD_H_NONBLOCKING@ || @GNULIB_UNISTD_H_SIGPIPE@)
e275c824
PE
1386# if !(defined __cplusplus && defined GNULIB_NAMESPACE)
1387# undef write
1388# define write rpl_write
1389# endif
1390_GL_FUNCDECL_RPL (write, ssize_t, (int fd, const void *buf, size_t count)
1391 _GL_ARG_NONNULL ((2)));
1392_GL_CXXALIAS_RPL (write, ssize_t, (int fd, const void *buf, size_t count));
1393# else
1394/* Need to cast, because on mingw, the third parameter is
1395 unsigned int count
1396 and the return type is 'int'. */
1397_GL_CXXALIAS_SYS_CAST (write, ssize_t, (int fd, const void *buf, size_t count));
1398# endif
1399_GL_CXXALIASWARN (write);
1400#endif
1401
1402
e765a388
PE
1403#endif /* _GL_UNISTD_H */
1404#endif /* _GL_UNISTD_H */