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