Fix problem in tramp.texi
[emacs.git] / lib / fcntl.in.h
blobb94397307e937a03cd2610ef49106833f0967653
1 /* Like <fcntl.h>, but with non-working flags defined to 0.
3 Copyright (C) 2006-2016 Free Software Foundation, Inc.
5 This program is free software: you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <http://www.gnu.org/licenses/>. */
18 /* written by Paul Eggert */
20 #if __GNUC__ >= 3
21 @PRAGMA_SYSTEM_HEADER@
22 #endif
23 @PRAGMA_COLUMNS@
25 #if defined __need_system_fcntl_h
26 /* Special invocation convention. */
28 /* Needed before <sys/stat.h>.
29 May also define off_t to a 64-bit type on native Windows. */
30 #include <sys/types.h>
31 /* On some systems other than glibc, <sys/stat.h> is a prerequisite of
32 <fcntl.h>. On glibc systems, we would like to avoid namespace pollution.
33 But on glibc systems, <fcntl.h> includes <sys/stat.h> inside an
34 extern "C" { ... } block, which leads to errors in C++ mode with the
35 overridden <sys/stat.h> from gnulib. These errors are known to be gone
36 with g++ version >= 4.3. */
37 #if !(defined __GLIBC__ || defined __UCLIBC__) || (defined __cplusplus && defined GNULIB_NAMESPACE && (defined __ICC || !(__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))))
38 # include <sys/stat.h>
39 #endif
40 #@INCLUDE_NEXT@ @NEXT_FCNTL_H@
42 #else
43 /* Normal invocation convention. */
45 #ifndef _@GUARD_PREFIX@_FCNTL_H
47 /* Needed before <sys/stat.h>.
48 May also define off_t to a 64-bit type on native Windows. */
49 #include <sys/types.h>
50 /* On some systems other than glibc, <sys/stat.h> is a prerequisite of
51 <fcntl.h>. On glibc systems, we would like to avoid namespace pollution.
52 But on glibc systems, <fcntl.h> includes <sys/stat.h> inside an
53 extern "C" { ... } block, which leads to errors in C++ mode with the
54 overridden <sys/stat.h> from gnulib. These errors are known to be gone
55 with g++ version >= 4.3. */
56 #if !(defined __GLIBC__ || defined __UCLIBC__) || (defined __cplusplus && defined GNULIB_NAMESPACE && (defined __ICC || !(__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))))
57 # include <sys/stat.h>
58 #endif
59 /* The include_next requires a split double-inclusion guard. */
60 #@INCLUDE_NEXT@ @NEXT_FCNTL_H@
62 #ifndef _@GUARD_PREFIX@_FCNTL_H
63 #define _@GUARD_PREFIX@_FCNTL_H
65 #ifndef __GLIBC__ /* Avoid namespace pollution on glibc systems. */
66 # include <unistd.h>
67 #endif
69 /* Native Windows platforms declare open(), creat() in <io.h>. */
70 #if (@GNULIB_OPEN@ || defined GNULIB_POSIXCHECK) \
71 && ((defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__)
72 # include <io.h>
73 #endif
76 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
78 /* The definition of _GL_ARG_NONNULL is copied here. */
80 /* The definition of _GL_WARN_ON_USE is copied here. */
83 /* Declare overridden functions. */
85 #if @GNULIB_FCNTL@
86 # if @REPLACE_FCNTL@
87 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
88 # undef fcntl
89 # define fcntl rpl_fcntl
90 # endif
91 _GL_FUNCDECL_RPL (fcntl, int, (int fd, int action, ...));
92 _GL_CXXALIAS_RPL (fcntl, int, (int fd, int action, ...));
93 # else
94 # if !@HAVE_FCNTL@
95 _GL_FUNCDECL_SYS (fcntl, int, (int fd, int action, ...));
96 # endif
97 _GL_CXXALIAS_SYS (fcntl, int, (int fd, int action, ...));
98 # endif
99 _GL_CXXALIASWARN (fcntl);
100 #elif defined GNULIB_POSIXCHECK
101 # undef fcntl
102 # if HAVE_RAW_DECL_FCNTL
103 _GL_WARN_ON_USE (fcntl, "fcntl is not always POSIX compliant - "
104 "use gnulib module fcntl for portability");
105 # endif
106 #endif
108 #if @GNULIB_OPEN@
109 # if @REPLACE_OPEN@
110 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
111 # undef open
112 # define open rpl_open
113 # endif
114 _GL_FUNCDECL_RPL (open, int, (const char *filename, int flags, ...)
115 _GL_ARG_NONNULL ((1)));
116 _GL_CXXALIAS_RPL (open, int, (const char *filename, int flags, ...));
117 # else
118 _GL_CXXALIAS_SYS (open, int, (const char *filename, int flags, ...));
119 # endif
120 /* On HP-UX 11, in C++ mode, open() is defined as an inline function with a
121 default argument. _GL_CXXALIASWARN does not work in this case. */
122 # if !defined __hpux
123 _GL_CXXALIASWARN (open);
124 # endif
125 #elif defined GNULIB_POSIXCHECK
126 # undef open
127 /* Assume open is always declared. */
128 _GL_WARN_ON_USE (open, "open is not always POSIX compliant - "
129 "use gnulib module open for portability");
130 #endif
132 #if @GNULIB_OPENAT@
133 # if @REPLACE_OPENAT@
134 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
135 # undef openat
136 # define openat rpl_openat
137 # endif
138 _GL_FUNCDECL_RPL (openat, int,
139 (int fd, char const *file, int flags, /* mode_t mode */ ...)
140 _GL_ARG_NONNULL ((2)));
141 _GL_CXXALIAS_RPL (openat, int,
142 (int fd, char const *file, int flags, /* mode_t mode */ ...));
143 # else
144 # if !@HAVE_OPENAT@
145 _GL_FUNCDECL_SYS (openat, int,
146 (int fd, char const *file, int flags, /* mode_t mode */ ...)
147 _GL_ARG_NONNULL ((2)));
148 # endif
149 _GL_CXXALIAS_SYS (openat, int,
150 (int fd, char const *file, int flags, /* mode_t mode */ ...));
151 # endif
152 _GL_CXXALIASWARN (openat);
153 #elif defined GNULIB_POSIXCHECK
154 # undef openat
155 # if HAVE_RAW_DECL_OPENAT
156 _GL_WARN_ON_USE (openat, "openat is not portable - "
157 "use gnulib module openat for portability");
158 # endif
159 #endif
162 /* Fix up the FD_* macros, only known to be missing on mingw. */
164 #ifndef FD_CLOEXEC
165 # define FD_CLOEXEC 1
166 #endif
168 /* Fix up the supported F_* macros. Intentionally leave other F_*
169 macros undefined. Only known to be missing on mingw. */
171 #ifndef F_DUPFD_CLOEXEC
172 # define F_DUPFD_CLOEXEC 0x40000000
173 /* Witness variable: 1 if gnulib defined F_DUPFD_CLOEXEC, 0 otherwise. */
174 # define GNULIB_defined_F_DUPFD_CLOEXEC 1
175 #else
176 # define GNULIB_defined_F_DUPFD_CLOEXEC 0
177 #endif
179 #ifndef F_DUPFD
180 # define F_DUPFD 1
181 #endif
183 #ifndef F_GETFD
184 # define F_GETFD 2
185 #endif
187 /* Fix up the O_* macros. */
189 /* AIX 7.1 with XL C 12.1 defines O_CLOEXEC, O_NOFOLLOW, and O_TTY_INIT
190 to values outside 'int' range, so omit these misdefinitions.
191 But avoid namespace pollution on non-AIX systems. */
192 #ifdef _AIX
193 # include <limits.h>
194 # if defined O_CLOEXEC && ! (INT_MIN <= O_CLOEXEC && O_CLOEXEC <= INT_MAX)
195 # undef O_CLOEXEC
196 # endif
197 # if defined O_NOFOLLOW && ! (INT_MIN <= O_NOFOLLOW && O_NOFOLLOW <= INT_MAX)
198 # undef O_NOFOLLOW
199 # endif
200 # if defined O_TTY_INIT && ! (INT_MIN <= O_TTY_INIT && O_TTY_INIT <= INT_MAX)
201 # undef O_TTY_INIT
202 # endif
203 #endif
205 #if !defined O_DIRECT && defined O_DIRECTIO
206 /* Tru64 spells it 'O_DIRECTIO'. */
207 # define O_DIRECT O_DIRECTIO
208 #endif
210 #if !defined O_CLOEXEC && defined O_NOINHERIT
211 /* Mingw spells it 'O_NOINHERIT'. */
212 # define O_CLOEXEC O_NOINHERIT
213 #endif
215 #ifndef O_CLOEXEC
216 # define O_CLOEXEC 0
217 #endif
219 #ifndef O_DIRECT
220 # define O_DIRECT 0
221 #endif
223 #ifndef O_DIRECTORY
224 # define O_DIRECTORY 0
225 #endif
227 #ifndef O_DSYNC
228 # define O_DSYNC 0
229 #endif
231 #ifndef O_EXEC
232 # define O_EXEC O_RDONLY /* This is often close enough in older systems. */
233 #endif
235 #ifndef O_IGNORE_CTTY
236 # define O_IGNORE_CTTY 0
237 #endif
239 #ifndef O_NDELAY
240 # define O_NDELAY 0
241 #endif
243 #ifndef O_NOATIME
244 # define O_NOATIME 0
245 #endif
247 #ifndef O_NONBLOCK
248 # define O_NONBLOCK O_NDELAY
249 #endif
251 /* If the gnulib module 'nonblocking' is in use, guarantee a working non-zero
252 value of O_NONBLOCK. Otherwise, O_NONBLOCK is defined (above) to O_NDELAY
253 or to 0 as fallback. */
254 #if @GNULIB_NONBLOCKING@
255 # if O_NONBLOCK
256 # define GNULIB_defined_O_NONBLOCK 0
257 # else
258 # define GNULIB_defined_O_NONBLOCK 1
259 # undef O_NONBLOCK
260 # define O_NONBLOCK 0x40000000
261 # endif
262 #endif
264 #ifndef O_NOCTTY
265 # define O_NOCTTY 0
266 #endif
268 #ifndef O_NOFOLLOW
269 # define O_NOFOLLOW 0
270 #endif
272 #ifndef O_NOLINK
273 # define O_NOLINK 0
274 #endif
276 #ifndef O_NOLINKS
277 # define O_NOLINKS 0
278 #endif
280 #ifndef O_NOTRANS
281 # define O_NOTRANS 0
282 #endif
284 #ifndef O_RSYNC
285 # define O_RSYNC 0
286 #endif
288 #ifndef O_SEARCH
289 # define O_SEARCH O_RDONLY /* This is often close enough in older systems. */
290 #endif
292 #ifndef O_SYNC
293 # define O_SYNC 0
294 #endif
296 #ifndef O_TTY_INIT
297 # define O_TTY_INIT 0
298 #endif
300 #if ~O_ACCMODE & (O_RDONLY | O_WRONLY | O_RDWR | O_EXEC | O_SEARCH)
301 # undef O_ACCMODE
302 # define O_ACCMODE (O_RDONLY | O_WRONLY | O_RDWR | O_EXEC | O_SEARCH)
303 #endif
305 /* For systems that distinguish between text and binary I/O.
306 O_BINARY is usually declared in fcntl.h */
307 #if !defined O_BINARY && defined _O_BINARY
308 /* For MSC-compatible compilers. */
309 # define O_BINARY _O_BINARY
310 # define O_TEXT _O_TEXT
311 #endif
313 #if defined __BEOS__ || defined __HAIKU__
314 /* BeOS 5 and Haiku have O_BINARY and O_TEXT, but they have no effect. */
315 # undef O_BINARY
316 # undef O_TEXT
317 #endif
319 #ifndef O_BINARY
320 # define O_BINARY 0
321 # define O_TEXT 0
322 #endif
324 /* Fix up the AT_* macros. */
326 /* Work around a bug in Solaris 9 and 10: AT_FDCWD is positive. Its
327 value exceeds INT_MAX, so its use as an int doesn't conform to the
328 C standard, and GCC and Sun C complain in some cases. If the bug
329 is present, undef AT_FDCWD here, so it can be redefined below. */
330 #if 0 < AT_FDCWD && AT_FDCWD == 0xffd19553
331 # undef AT_FDCWD
332 #endif
334 /* Use the same bit pattern as Solaris 9, but with the proper
335 signedness. The bit pattern is important, in case this actually is
336 Solaris with the above workaround. */
337 #ifndef AT_FDCWD
338 # define AT_FDCWD (-3041965)
339 #endif
341 /* Use the same values as Solaris 9. This shouldn't matter, but
342 there's no real reason to differ. */
343 #ifndef AT_SYMLINK_NOFOLLOW
344 # define AT_SYMLINK_NOFOLLOW 4096
345 #endif
347 #ifndef AT_REMOVEDIR
348 # define AT_REMOVEDIR 1
349 #endif
351 /* Solaris 9 lacks these two, so just pick unique values. */
352 #ifndef AT_SYMLINK_FOLLOW
353 # define AT_SYMLINK_FOLLOW 2
354 #endif
356 #ifndef AT_EACCESS
357 # define AT_EACCESS 4
358 #endif
361 #endif /* _@GUARD_PREFIX@_FCNTL_H */
362 #endif /* _@GUARD_PREFIX@_FCNTL_H */
363 #endif