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