sysdeps/unix/sysv/linux/s390/bits/fcntl.h

   1 /* O_*, F_*, FD_* bit values for Linux.
   2    Copyright (C) 2000-2002,2004,2006,2007,2009,2010,2011
   3    Free Software Foundation, Inc.
   4    This file is part of the GNU C Library.
   5
   6    The GNU C Library is free software; you can redistribute it and/or
   7    modify it under the terms of the GNU Lesser General Public
   8    License as published by the Free Software Foundation; either
   9    version 2.1 of the License, or (at your option) any later version.
  10
  11    The GNU C Library is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14    Lesser General Public License for more details.
  15
  16    You should have received a copy of the GNU Lesser General Public
  17    License along with the GNU C Library; if not, see
  18    <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef _FCNTL_H
  21 # error "Never use <bits/fcntl.h> directly; include <fcntl.h> instead."
  22 #endif
  23
  24 #include <sys/types.h>
  25 #include <bits/wordsize.h>
  26 #ifdef __USE_GNU
  27 # include <bits/uio.h>
  28 #endif
  29
  30
  31 /* open/fcntl - O_SYNC is only implemented on blocks devices and on files
  32    located on a few file systems.  */
  33 #define O_ACCMODE          0003
  34 #define O_RDONLY             00
  35 #define O_WRONLY             01
  36 #define O_RDWR               02
  37 #define O_CREAT            0100 /* not fcntl */
  38 #define O_EXCL             0200 /* not fcntl */
  39 #define O_NOCTTY           0400 /* not fcntl */
  40 #define O_TRUNC           01000 /* not fcntl */
  41 #define O_APPEND          02000
  42 #define O_NONBLOCK        04000
  43 #define O_NDELAY        O_NONBLOCK
  44 #define O_SYNC         04010000
  45 #define O_FSYNC          O_SYNC
  46 #define O_ASYNC          020000
  47
  48 #ifdef __USE_XOPEN2K8
  49 # define O_DIRECTORY    0200000 /* Must be a directory.  */
  50 # define O_NOFOLLOW     0400000 /* Do not follow links.  */
  51 # define O_CLOEXEC     02000000 /* Set close_on_exec.  */
  52 #endif
  53 #ifdef __USE_GNU
  54 # define O_DIRECT        040000 /* Direct disk access.  */
  55 # define O_NOATIME     01000000 /* Do not set atime.  */
  56 # define O_PATH       010000000 /* Resolve pathname but do not open file.  */
  57 #endif
  58
  59 #ifdef __USE_LARGEFILE64
  60 # if __WORDSIZE == 64
  61 /* Not necessary, files are always with 64bit off_t.  */
  62 #  define O_LARGEFILE   0
  63 # else
  64 #  define O_LARGEFILE   0100000
  65 # endif
  66 #endif
  67
  68 /* For now Linux has synchronisity options for data and read operations.
  69    We define the symbols here but let them do the same as O_SYNC since
  70    this is a superset.  */
  71 #if defined __USE_POSIX199309 || defined __USE_UNIX98
  72 # define O_DSYNC        010000  /* Synchronize data.  */
  73 # define O_RSYNC        O_SYNC  /* Synchronize read operations.  */
  74 #endif
  75
  76 /* Values for the second argument to `fcntl'.  */
  77 #define F_DUPFD         0       /* Duplicate file descriptor.  */
  78 #define F_GETFD         1       /* Get file descriptor flags.  */
  79 #define F_SETFD         2       /* Set file descriptor flags.  */
  80 #define F_GETFL         3       /* Get file status flags.  */
  81 #define F_SETFL         4       /* Set file status flags.  */
  82 #if __WORDSIZE == 64
  83 # define F_GETLK        5       /* Get record locking info.  */
  84 # define F_SETLK        6       /* Set record locking info (non-blocking).  */
  85 # define F_SETLKW       7       /* Set record locking info (blocking).  */
  86 /* Not necessary, we always have 64-bit offsets.  */
  87 # define F_GETLK64      5       /* Get record locking info.  */
  88 # define F_SETLK64      6       /* Set record locking info (non-blocking).  */
  89 # define F_SETLKW64     7       /* Set record locking info (blocking).  */
  90 #else
  91 # ifndef __USE_FILE_OFFSET64
  92 #  define F_GETLK       5       /* Get record locking info.  */
  93 #  define F_SETLK       6       /* Set record locking info (non-blocking).  */
  94 #  define F_SETLKW      7       /* Set record locking info (blocking).  */
  95 # else
  96 #  define F_GETLK       F_GETLK64  /* Get record locking info.  */
  97 #  define F_SETLK       F_SETLK64  /* Set record locking info (non-blocking).*/
  98 #  define F_SETLKW      F_SETLKW64 /* Set record locking info (blocking).  */
  99 # endif
 100 # define F_GETLK64      12      /* Get record locking info.  */
 101 # define F_SETLK64      13      /* Set record locking info (non-blocking).  */
 102 # define F_SETLKW64     14      /* Set record locking info (blocking).  */
 103 #endif
 104
 105 #if defined __USE_BSD || defined __USE_UNIX98 || defined __USE_XOPEN2K8
 106 # define F_SETOWN       8       /* Get owner (process receiving SIGIO).  */
 107 # define F_GETOWN       9       /* Set owner (process receiving SIGIO).  */
 108 #endif
 109
 110 #ifdef __USE_GNU
 111 # define F_SETSIG       10      /* Set number of signal to be sent.  */
 112 # define F_GETSIG       11      /* Get number of signal to be sent.  */
 113 # define F_SETOWN_EX    15      /* Get owner (thread receiving SIGIO).  */
 114 # define F_GETOWN_EX    16      /* Set owner (thread receiving SIGIO).  */
 115 #endif
 116
 117 #ifdef __USE_GNU
 118 # define F_SETLEASE     1024    /* Set a lease.  */
 119 # define F_GETLEASE     1025    /* Enquire what lease is active.  */
 120 # define F_NOTIFY       1026    /* Request notfications on a directory.  */
 121 # define F_SETPIPE_SZ   1031    /* Set pipe page size array.  */
 122 # define F_GETPIPE_SZ   1032    /* Set pipe page size array.  */
 123 #endif
 124 #ifdef __USE_XOPEN2K8
 125 # define F_DUPFD_CLOEXEC 1030   /* Duplicate file descriptor with
 126                                    close-on-exit set.  */
 127 #endif
 128
 129 /* For F_[GET|SET]FD.  */
 130 #define FD_CLOEXEC      1       /* actually anything with low bit set goes */
 131
 132 /* For posix fcntl() and `l_type' field of a `struct flock' for lockf().  */
 133 #define F_RDLCK         0       /* Read lock.  */
 134 #define F_WRLCK         1       /* Write lock.  */
 135 #define F_UNLCK         2       /* Remove lock.  */
 136
 137 /* for old implementation of bsd flock () */
 138 #define F_EXLCK         4       /* or 3 */
 139 #define F_SHLCK         8       /* or 4 */
 140
 141 #ifdef __USE_BSD
 142 /* Operations for bsd flock(), also used by the kernel implementation */
 143 # define LOCK_SH        1       /* shared lock */
 144 # define LOCK_EX        2       /* exclusive lock */
 145 # define LOCK_NB        4       /* or'd with one of the above to prevent
 146                                    blocking */
 147 # define LOCK_UN        8       /* remove lock */
 148 #endif
 149
 150 #ifdef __USE_GNU
 151 # define LOCK_MAND      32      /* This is a mandatory flock:   */
 152 # define LOCK_READ      64      /* ... which allows concurrent read operations.  */
 153 # define LOCK_WRITE     128     /* ... which allows concurrent write operations.  */
 154 # define LOCK_RW        192     /* ... Which allows concurrent read & write operations.  */
 155 #endif
 156
 157 #ifdef __USE_GNU
 158 /* Types of directory notifications that may be requested with F_NOTIFY.  */
 159 # define DN_ACCESS      0x00000001      /* File accessed.  */
 160 # define DN_MODIFY      0x00000002      /* File modified.  */
 161 # define DN_CREATE      0x00000004      /* File created.  */
 162 # define DN_DELETE      0x00000008      /* File removed.  */
 163 # define DN_RENAME      0x00000010      /* File renamed.  */
 164 # define DN_ATTRIB      0x00000020      /* File changed attibutes.  */
 165 # define DN_MULTISHOT   0x80000000      /* Don't remove notifier.  */
 166 #endif
 167
 168 struct flock
 169   {
 170     short int l_type;   /* Type of lock: F_RDLCK, F_WRLCK, or F_UNLCK.  */
 171     short int l_whence; /* Where `l_start' is relative to (like `lseek').  */
 172 #if __WORDSIZE == 64 || !defined __USE_FILE_OFFSET64
 173     __off_t l_start;    /* Offset where the lock begins.  */
 174     __off_t l_len;      /* Size of the locked area; zero means until EOF.  */
 175 #else
 176     __off64_t l_start;  /* Offset where the lock begins.  */
 177     __off64_t l_len;    /* Size of the locked area; zero means until EOF.  */
 178 #endif
 179     __pid_t l_pid;      /* Process holding the lock.  */
 180   };
 181
 182 #ifdef __USE_LARGEFILE64
 183 struct flock64
 184   {
 185     short int l_type;   /* Type of lock: F_RDLCK, F_WRLCK, or F_UNLCK.  */
 186     short int l_whence; /* Where `l_start' is relative to (like `lseek').  */
 187     __off64_t l_start;  /* Offset where the lock begins.  */
 188     __off64_t l_len;    /* Size of the locked area; zero means until EOF.  */
 189     __pid_t l_pid;      /* Process holding the lock.  */
 190   };
 191 #endif
 192
 193 #ifdef __USE_GNU
 194 /* Owner types.  */
 195 enum __pid_type
 196   {
 197     F_OWNER_TID = 0,            /* Kernel thread.  */
 198     F_OWNER_PID,                /* Process.  */
 199     F_OWNER_PGRP,               /* Process group.  */
 200     F_OWNER_GID = F_OWNER_PGRP  /* Alternative, obsolete name.  */
 201   };
 202
 203 /* Structure to use with F_GETOWN_EX and F_SETOWN_EX.  */
 204 struct f_owner_ex
 205   {
 206     enum __pid_type type;       /* Owner type of ID.  */
 207     __pid_t pid;                /* ID of owner.  */
 208   };
 209 #endif
 210
 211 /* Define some more compatibility macros to be backward compatible with
 212    BSD systems which did not managed to hide these kernel macros.  */
 213 #ifdef  __USE_BSD
 214 # define FAPPEND        O_APPEND
 215 # define FFSYNC         O_FSYNC
 216 # define FASYNC         O_ASYNC
 217 # define FNONBLOCK      O_NONBLOCK
 218 # define FNDELAY        O_NDELAY
 219 #endif /* Use BSD.  */
 220
 221 /* Advise to `posix_fadvise'.  */
 222 #ifdef __USE_XOPEN2K
 223 # define POSIX_FADV_NORMAL      0 /* No further special treatment.  */
 224 # define POSIX_FADV_RANDOM      1 /* Expect random page references.  */
 225 # define POSIX_FADV_SEQUENTIAL  2 /* Expect sequential page references.  */
 226 # define POSIX_FADV_WILLNEED    3 /* Will need these pages.  */
 227 # if __WORDSIZE == 64
 228 #  define POSIX_FADV_DONTNEED   6 /* Don't need these pages.  */
 229 #  define POSIX_FADV_NOREUSE    7 /* Data will be accessed once.  */
 230 # else
 231 #  define POSIX_FADV_DONTNEED   4 /* Don't need these pages.  */
 232 #  define POSIX_FADV_NOREUSE    5 /* Data will be accessed once.  */
 233 # endif
 234 #endif
 235
 236
 237 #ifdef __USE_GNU
 238 /* Flags for SYNC_FILE_RANGE.  */
 239 # define SYNC_FILE_RANGE_WAIT_BEFORE    1 /* Wait upon writeout of all pages
 240                                              in the range before performing the
 241                                              write.  */
 242 # define SYNC_FILE_RANGE_WRITE          2 /* Initiate writeout of all those
 243                                              dirty pages in the range which are
 244                                              not presently under writeback.  */
 245 # define SYNC_FILE_RANGE_WAIT_AFTER     4 /* Wait upon writeout of all pages in
 246                                              the range after performing the
 247                                              write.  */
 248
 249 /* Flags for SPLICE and VMSPLICE.  */
 250 # define SPLICE_F_MOVE          1       /* Move pages instead of copying.  */
 251 # define SPLICE_F_NONBLOCK      2       /* Don't block on the pipe splicing
 252                                            (but we may still block on the fd
 253                                            we splice from/to).  */
 254 # define SPLICE_F_MORE          4       /* Expect more data.  */
 255 # define SPLICE_F_GIFT          8       /* Pages passed in are a gift.  */
 256
 257
 258 /* File handle structure.  */
 259 struct file_handle
 260 {
 261   unsigned int handle_bytes;
 262   int handle_type;
 263   /* File identifier.  */
 264   unsigned char f_handle[0];
 265 };
 266
 267 /* Maximum handle size (for now).  */
 268 # define MAX_HANDLE_SZ  128
 269 #endif
 270
 271 __BEGIN_DECLS
 272
 273 #ifdef __USE_GNU
 274
 275 /* Provide kernel hint to read ahead.  */
 276 extern ssize_t readahead (int __fd, __off64_t __offset, size_t __count)
 277     __THROW;
 278
 279
 280 /* Selective file content synch'ing.
 281
 282    This function is a possible cancellation point and therefore not
 283    marked with __THROW.  */
 284 extern int sync_file_range (int __fd, __off64_t __offset, __off64_t __count,
 285                             unsigned int __flags);
 286
 287
 288 /* Splice address range into a pipe.
 289
 290    This function is a possible cancellation point and therefore not
 291    marked with __THROW.  */
 292 extern ssize_t vmsplice (int __fdout, const struct iovec *__iov,
 293                          size_t __count, unsigned int __flags);
 294
 295 /* Splice two files together.
 296
 297    This function is a possible cancellation point and therefore not
 298    marked with __THROW.  */
 299 extern ssize_t splice (int __fdin, __off64_t *__offin, int __fdout,
 300                        __off64_t *__offout, size_t __len,
 301                        unsigned int __flags);
 302
 303 /* In-kernel implementation of tee for pipe buffers.
 304
 305    This function is a possible cancellation point and therefore not
 306    marked with __THROW.  */
 307 extern ssize_t tee (int __fdin, int __fdout, size_t __len,
 308                     unsigned int __flags);
 309
 310 /* Reserve storage for the data of the file associated with FD.
 311
 312    This function is a possible cancellation point and therefore not
 313    marked with __THROW.  */
 314 # ifndef __USE_FILE_OFFSET64
 315 extern int fallocate (int __fd, int __mode, __off_t __offset, __off_t __len);
 316 # else
 317 #  ifdef __REDIRECT
 318 extern int __REDIRECT (fallocate, (int __fd, int __mode, __off64_t __offset,
 319                                    __off64_t __len),
 320                        fallocate64);
 321 #  else
 322 #   define fallocate fallocate64
 323 #  endif
 324 # endif
 325 # ifdef __USE_LARGEFILE64
 326 extern int fallocate64 (int __fd, int __mode, __off64_t __offset,
 327                         __off64_t __len);
 328 # endif
 329
 330
 331 /* Map file name to file handle.  */
 332 extern int name_to_handle_at (int __dfd, const char *__name,
 333                               struct file_handle *__handle, int *__mnt_id,
 334                               int __flags) __THROW;
 335
 336 /* Open file using the file handle.
 337
 338    This function is a possible cancellation point and therefore not
 339    marked with __THROW.  */
 340 extern int open_by_handle_at (int __mountdirfd, struct file_handle *__handle,
 341                               int __flags);
 342
 343 #endif
 344
 345 __END_DECLS