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