1 /* Copyright (C) 1991,1992,1994-2001,2003,2004,2005,2006,2007, 2009 2 Free Software Foundation, Inc. 3 This file is part of the GNU C Library. 4 5 The GNU C Library is free software; you can redistribute it and/or 6 modify it under the terms of the GNU Lesser General Public 7 License as published by the Free Software Foundation; either 8 version 2.1 of the License, or (at your option) any later version. 9 10 The GNU C Library 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 GNU 13 Lesser General Public License for more details. 14 15 You should have received a copy of the GNU Lesser General Public 16 License along with the GNU C Library; if not, see 17 <http://www.gnu.org/licenses/>. */ 18 19 /* 20 * POSIX Standard: 6.5 File Control Operations <fcntl.h> 21 */ 22 23 #ifndef _FCNTL_H 24 #define _FCNTL_H 1 25 26 #include <features.h> 27 28 /* This must be early so <bits/fcntl.h> can define types winningly. */ 29 __BEGIN_DECLS 30 31 /* Get the definitions of O_*, F_*, FD_*: all the 32 numbers and flag bits for `open', `fcntl', et al. */ 33 #include <bits/fcntl.h> 34 35 /* For XPG all symbols from <sys/stat.h> should also be available. */ 36 #ifdef __USE_XOPEN 37 # include <sys/stat.h> 38 #endif 39 40 #ifdef __USE_MISC 41 # ifndef R_OK /* Verbatim from <unistd.h>. Ugh. */ 42 /* Values for the second argument to access. 43 These may be OR'd together. */ 44 # define R_OK 4 /* Test for read permission. */ 45 # define W_OK 2 /* Test for write permission. */ 46 # define X_OK 1 /* Test for execute permission. */ 47 # define F_OK 0 /* Test for existence. */ 48 # endif 49 #endif /* Use misc. */ 50 51 /* XPG wants the following symbols. */ 52 #ifdef __USE_XOPEN /* <stdio.h> has the same definitions. */ 53 # define SEEK_SET 0 /* Seek from beginning of file. */ 54 # define SEEK_CUR 1 /* Seek from current position. */ 55 # define SEEK_END 2 /* Seek from end of file. */ 56 #endif /* XPG */ 57 58 #ifdef __USE_ATFILE 59 # define AT_FDCWD -100 /* Special value used to indicate 60 the *at functions should use the 61 current working directory. */ 62 # define AT_SYMLINK_NOFOLLOW 0x100 /* Do not follow symbolic links. */ 63 # define AT_REMOVEDIR 0x200 /* Remove directory instead of 64 unlinking file. */ 65 # define AT_SYMLINK_FOLLOW 0x400 /* Follow symbolic links. */ 66 # define AT_EACCESS 0x200 /* Test access permitted for 67 effective IDs, not real IDs. */ 68 #endif 69 70 /* Do the file control operation described by CMD on FD. 71 The remaining arguments are interpreted depending on CMD. 72 73 This function is a cancellation point and therefore not marked with 74 __THROW. */ 75 #if !defined(__USE_FILE_OFFSET64) || defined(__LP64__) 76 extern int fcntl (int __fd, int __cmd, ...); 77 # ifdef _LIBC 78 extern int __fcntl_nocancel(int, int, long) attribute_hidden; 79 libc_hidden_proto(fcntl) 80 # endif 81 #else 82 # ifdef __REDIRECT 83 extern int __REDIRECT (fcntl, (int __fd, int __cmd, ...), fcntl64); 84 # else 85 # define fcntl fcntl64 86 # endif 87 #endif 88 #if defined(__USE_LARGEFILE64) && !defined(__LP64__) 89 extern int fcntl64 (int __fd, int __cmd, ...); 90 # ifdef _LIBC 91 extern int __fcntl64_nocancel(int, int, long) attribute_hidden; 92 libc_hidden_proto(fcntl64) 93 # endif 94 #endif 95 96 /* Open FILE and return a new file descriptor for it, or -1 on error. 97 OFLAG determines the type of access used. If O_CREAT is on OFLAG, 98 the third argument is taken as a `mode_t', the mode of the created file. 99 100 This function is a cancellation point and therefore not marked with 101 __THROW. */ 102 #ifndef __USE_FILE_OFFSET64 103 extern int open (const char *__file, int __oflag, ...) __nonnull ((1)); 104 libc_hidden_proto(open) 105 # ifdef _LIBC 106 extern int __open2_nocancel(const char *, int) __nonnull ((1)) attribute_hidden; 107 extern int __open_nocancel(const char *, int, mode_t) __nonnull ((1)) attribute_hidden; 108 # endif 109 #else 110 # ifdef __REDIRECT 111 extern int __REDIRECT (open, (const char *__file, int __oflag, ...), open64) 112 __nonnull ((1)); 113 # else 114 # define open open64 115 # endif 116 #endif 117 #ifdef __USE_LARGEFILE64 118 extern int open64 (const char *__file, int __oflag, ...) __nonnull ((1)); 119 libc_hidden_proto(open64) 120 #endif 121 122 #ifdef __USE_ATFILE 123 /* Similar to `open' but a relative path name is interpreted relative to 124 the directory for which FD is a descriptor. 125 126 NOTE: some other `openat' implementation support additional functionality 127 through this interface, especially using the O_XATTR flag. This is not 128 yet supported here. 129 130 This function is a cancellation point and therefore not marked with 131 __THROW. */ 132 # ifndef __USE_FILE_OFFSET64 133 extern int openat (int __fd, const char *__file, int __oflag, ...) 134 __nonnull ((2)); 135 libc_hidden_proto(openat) 136 # else 137 # ifdef __REDIRECT 138 extern int __REDIRECT (openat, (int __fd, const char *__file, int __oflag, 139 ...), openat64) __nonnull ((2)); 140 # else 141 # define openat openat64 142 # endif 143 # endif 144 145 extern int openat64 (int __fd, const char *__file, int __oflag, ...) 146 __nonnull ((2)); 147 #endif 148 149 /* Create and open FILE, with mode MODE. This takes an `int' MODE 150 argument because that is what `mode_t' will be widened to. 151 152 This function is a cancellation point and therefore not marked with 153 __THROW. */ 154 #ifndef __USE_FILE_OFFSET64 155 extern int creat (const char *__file, __mode_t __mode) __nonnull ((1)); 156 #else 157 # ifdef __REDIRECT 158 extern int __REDIRECT (creat, (const char *__file, __mode_t __mode), 159 creat64) __nonnull ((1)); 160 # else 161 # define creat creat64 162 # endif 163 #endif 164 #ifdef __USE_LARGEFILE64 165 extern int creat64 (const char *__file, __mode_t __mode) __nonnull ((1)); 166 #endif 167 168 #if !defined F_LOCK && (defined __USE_MISC || (defined __USE_XOPEN_EXTENDED \ 169 && !defined __USE_POSIX)) 170 /* NOTE: These declarations also appear in <unistd.h>; be sure to keep both 171 files consistent. Some systems have them there and some here, and some 172 software depends on the macros being defined without including both. */ 173 174 /* `lockf' is a simpler interface to the locking facilities of `fcntl'. 175 LEN is always relative to the current file position. 176 The CMD argument is one of the following. */ 177 178 # define F_ULOCK 0 /* Unlock a previously locked region. */ 179 # define F_LOCK 1 /* Lock a region for exclusive use. */ 180 # define F_TLOCK 2 /* Test and lock a region for exclusive use. */ 181 # define F_TEST 3 /* Test a region for other processes locks. */ 182 183 # ifndef __USE_FILE_OFFSET64 184 extern int lockf (int __fd, int __cmd, __off_t __len); 185 libc_hidden_proto(lockf) 186 # else 187 # ifdef __REDIRECT 188 extern int __REDIRECT (lockf, (int __fd, int __cmd, __off64_t __len), lockf64); 189 # else 190 # define lockf lockf64 191 # endif 192 # endif 193 # ifdef __USE_LARGEFILE64 194 extern int lockf64 (int __fd, int __cmd, __off64_t __len); 195 # endif 196 #endif 197 198 #if defined __USE_XOPEN2K && defined __UCLIBC_HAS_ADVANCED_REALTIME__ 199 /* Advice the system about the expected behaviour of the application with 200 respect to the file associated with FD. */ 201 # ifndef __USE_FILE_OFFSET64 202 extern int posix_fadvise (int __fd, __off_t __offset, __off_t __len, 203 int __advise) __THROW; 204 # else 205 # ifdef __REDIRECT_NTH 206 extern int __REDIRECT_NTH (posix_fadvise, (int __fd, __off64_t __offset, 207 __off64_t __len, int __advise), 208 posix_fadvise64); 209 # else 210 # define posix_fadvise posix_fadvise64 211 # endif 212 # endif 213 # ifdef __USE_LARGEFILE64 214 extern int posix_fadvise64 (int __fd, __off64_t __offset, __off64_t __len, 215 int __advise) __THROW; 216 # endif 217 218 #endif 219 220 #if defined __UCLIBC_HAS_ADVANCED_REALTIME__ 221 222 /* Reserve storage for the data of the file associated with FD. 223 224 This function is a possible cancellation points and therefore not 225 marked with __THROW. */ 226 # ifndef __USE_FILE_OFFSET64 227 extern int posix_fallocate (int __fd, __off_t __offset, __off_t __len); 228 # else 229 # ifdef __REDIRECT 230 extern int __REDIRECT (posix_fallocate, (int __fd, __off64_t __offset, 231 __off64_t __len), 232 posix_fallocate64); 233 # else 234 # define posix_fallocate posix_fallocate64 235 # endif 236 # endif 237 # ifdef __USE_LARGEFILE64 238 extern int posix_fallocate64 (int __fd, __off64_t __offset, __off64_t __len); 239 # endif 240 #endif 241 242 __END_DECLS 243 244 #endif /* fcntl.h */ 245