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