1 /* Copyright (C) 1991,1992,1994-2001,2003,2004,2005,2006,2007,2009,2010,2011 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, write to the Free 17 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 18 02111-1307 USA. */ 19 20 /* 21 * POSIX Standard: 6.5 File Control Operations <fcntl.h> 22 */ 23 24 #ifndef _FCNTL_H 25 #define _FCNTL_H 1 26 27 #include <features.h> 28 29 /* This must be early so <bits/fcntl.h> can define types winningly. */ 30 __BEGIN_DECLS 31 32 /* Get the definitions of O_*, F_*, FD_*: all the 33 numbers and flag bits for `open', `fcntl', et al. */ 34 #include <bits/fcntl.h> 35 36 /* For XPG all symbols from <sys/stat.h> should also be available. */ 37 #if defined __USE_XOPEN || defined __USE_XOPEN2K8 38 # include <bits/types.h> /* For __mode_t and __dev_t. */ 39 # define __need_timespec 40 # include <time.h> 41 # include <bits/stat.h> 42 43 # define S_IFMT __S_IFMT 44 # define S_IFDIR __S_IFDIR 45 # define S_IFCHR __S_IFCHR 46 # define S_IFBLK __S_IFBLK 47 # define S_IFREG __S_IFREG 48 # ifdef __S_IFIFO 49 # define S_IFIFO __S_IFIFO 50 # endif 51 # ifdef __S_IFLNK 52 # define S_IFLNK __S_IFLNK 53 # endif 54 # if (defined __USE_UNIX98 || defined __USE_XOPEN2K8) && defined __S_IFSOCK 55 # define S_IFSOCK __S_IFSOCK 56 # endif 57 58 /* Protection bits. */ 59 60 # define S_ISUID __S_ISUID /* Set user ID on execution. */ 61 # define S_ISGID __S_ISGID /* Set group ID on execution. */ 62 63 # if defined __USE_BSD || defined __USE_MISC || defined __USE_XOPEN 64 /* Save swapped text after use (sticky bit). This is pretty well obsolete. */ 65 # define S_ISVTX __S_ISVTX 66 # endif 67 68 # define S_IRUSR __S_IREAD /* Read by owner. */ 69 # define S_IWUSR __S_IWRITE /* Write by owner. */ 70 # define S_IXUSR __S_IEXEC /* Execute by owner. */ 71 /* Read, write, and execute by owner. */ 72 # define S_IRWXU (__S_IREAD|__S_IWRITE|__S_IEXEC) 73 74 # define S_IRGRP (S_IRUSR >> 3) /* Read by group. */ 75 # define S_IWGRP (S_IWUSR >> 3) /* Write by group. */ 76 # define S_IXGRP (S_IXUSR >> 3) /* Execute by group. */ 77 /* Read, write, and execute by group. */ 78 # define S_IRWXG (S_IRWXU >> 3) 79 80 # define S_IROTH (S_IRGRP >> 3) /* Read by others. */ 81 # define S_IWOTH (S_IWGRP >> 3) /* Write by others. */ 82 # define S_IXOTH (S_IXGRP >> 3) /* Execute by others. */ 83 /* Read, write, and execute by others. */ 84 # define S_IRWXO (S_IRWXG >> 3) 85 #endif 86 87 #ifdef __USE_MISC 88 # ifndef R_OK /* Verbatim from <unistd.h>. Ugh. */ 89 /* Values for the second argument to access. 90 These may be OR'd together. */ 91 # define R_OK 4 /* Test for read permission. */ 92 # define W_OK 2 /* Test for write permission. */ 93 # define X_OK 1 /* Test for execute permission. */ 94 # define F_OK 0 /* Test for existence. */ 95 # endif 96 #endif /* Use misc. */ 97 98 /* XPG wants the following symbols. <stdio.h> has the same definitions. */ 99 #if defined __USE_XOPEN || defined __USE_XOPEN2K8 100 # define SEEK_SET 0 /* Seek from beginning of file. */ 101 # define SEEK_CUR 1 /* Seek from current position. */ 102 # define SEEK_END 2 /* Seek from end of file. */ 103 #endif /* XPG */ 104 105 /* Do the file control operation described by CMD on FD. 106 The remaining arguments are interpreted depending on CMD. 107 108 This function is a cancellation point and therefore not marked with 109 __THROW. */ 110 extern int fcntl (int __fd, int __cmd, ...); 111 112 /* Open FILE and return a new file descriptor for it, or -1 on error. 113 OFLAG determines the type of access used. If O_CREAT is on OFLAG, 114 the third argument is taken as a `mode_t', the mode of the created file. 115 116 This function is a cancellation point and therefore not marked with 117 __THROW. */ 118 #ifndef __USE_FILE_OFFSET64 119 extern int open (__const char *__file, int __oflag, ...) __nonnull ((1)); 120 #else 121 # ifdef __REDIRECT 122 extern int __REDIRECT (open, (__const char *__file, int __oflag, ...), open64) 123 __nonnull ((1)); 124 # else 125 # define open open64 126 # endif 127 #endif 128 #ifdef __USE_LARGEFILE64 129 extern int open64 (__const char *__file, int __oflag, ...) __nonnull ((1)); 130 #endif 131 132 #ifdef __USE_ATFILE 133 /* Similar to `open' but a relative path name is interpreted relative to 134 the directory for which FD is a descriptor. 135 136 NOTE: some other `openat' implementation support additional functionality 137 through this interface, especially using the O_XATTR flag. This is not 138 yet supported here. 139 140 This function is a cancellation point and therefore not marked with 141 __THROW. */ 142 # ifndef __USE_FILE_OFFSET64 143 extern int openat (int __fd, __const char *__file, int __oflag, ...) 144 __nonnull ((2)); 145 # else 146 # ifdef __REDIRECT 147 extern int __REDIRECT (openat, (int __fd, __const char *__file, int __oflag, 148 ...), openat64) __nonnull ((2)); 149 # else 150 # define openat openat64 151 # endif 152 # endif 153 # ifdef __USE_LARGEFILE64 154 extern int openat64 (int __fd, __const char *__file, int __oflag, ...) 155 __nonnull ((2)); 156 # endif 157 #endif 158 159 /* Create and open FILE, with mode MODE. This takes an `int' MODE 160 argument because that is what `mode_t' will be widened to. 161 162 This function is a cancellation point and therefore not marked with 163 __THROW. */ 164 #ifndef __USE_FILE_OFFSET64 165 extern int creat (__const char *__file, __mode_t __mode) __nonnull ((1)); 166 #else 167 # ifdef __REDIRECT 168 extern int __REDIRECT (creat, (__const char *__file, __mode_t __mode), 169 creat64) __nonnull ((1)); 170 # else 171 # define creat creat64 172 # endif 173 #endif 174 #ifdef __USE_LARGEFILE64 175 extern int creat64 (__const char *__file, __mode_t __mode) __nonnull ((1)); 176 #endif 177 178 #if !defined F_LOCK && (defined __USE_MISC || (defined __USE_XOPEN_EXTENDED \ 179 && !defined __USE_POSIX)) 180 /* NOTE: These declarations also appear in <unistd.h>; be sure to keep both 181 files consistent. Some systems have them there and some here, and some 182 software depends on the macros being defined without including both. */ 183 184 /* `lockf' is a simpler interface to the locking facilities of `fcntl'. 185 LEN is always relative to the current file position. 186 The CMD argument is one of the following. */ 187 188 # define F_ULOCK 0 /* Unlock a previously locked region. */ 189 # define F_LOCK 1 /* Lock a region for exclusive use. */ 190 # define F_TLOCK 2 /* Test and lock a region for exclusive use. */ 191 # define F_TEST 3 /* Test a region for other processes locks. */ 192 193 # ifndef __USE_FILE_OFFSET64 194 extern int lockf (int __fd, int __cmd, __off_t __len); 195 # else 196 # ifdef __REDIRECT 197 extern int __REDIRECT (lockf, (int __fd, int __cmd, __off64_t __len), lockf64); 198 # else 199 # define lockf lockf64 200 # endif 201 # endif 202 # ifdef __USE_LARGEFILE64 203 extern int lockf64 (int __fd, int __cmd, __off64_t __len); 204 # endif 205 #endif 206 207 #ifdef __USE_XOPEN2K 208 /* Advice the system about the expected behaviour of the application with 209 respect to the file associated with FD. */ 210 # ifndef __USE_FILE_OFFSET64 211 extern int posix_fadvise (int __fd, __off_t __offset, __off_t __len, 212 int __advise) __THROW; 213 # else 214 # ifdef __REDIRECT_NTH 215 extern int __REDIRECT_NTH (posix_fadvise, (int __fd, __off64_t __offset, 216 __off64_t __len, int __advise), 217 posix_fadvise64); 218 # else 219 # define posix_fadvise posix_fadvise64 220 # endif 221 # endif 222 # ifdef __USE_LARGEFILE64 223 extern int posix_fadvise64 (int __fd, __off64_t __offset, __off64_t __len, 224 int __advise) __THROW; 225 # endif 226 227 228 /* Reserve storage for the data of the file associated with FD. 229 230 This function is a possible cancellation point and therefore not 231 marked with __THROW. */ 232 # ifndef __USE_FILE_OFFSET64 233 extern int posix_fallocate (int __fd, __off_t __offset, __off_t __len); 234 # else 235 # ifdef __REDIRECT 236 extern int __REDIRECT (posix_fallocate, (int __fd, __off64_t __offset, 237 __off64_t __len), 238 posix_fallocate64); 239 # else 240 # define posix_fallocate posix_fallocate64 241 # endif 242 # endif 243 # ifdef __USE_LARGEFILE64 244 extern int posix_fallocate64 (int __fd, __off64_t __offset, __off64_t __len); 245 # endif 246 #endif 247 248 249 /* Define some inlines helping to catch common problems. */ 250 #if __USE_FORTIFY_LEVEL > 0 && defined __extern_always_inline \ 251 && defined __va_arg_pack_len 252 # include <bits/fcntl2.h> 253 #endif 254 255 __END_DECLS 256 257 #endif /* fcntl.h */ 258