lib/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 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, 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 */