[thirdparty/glibc.git] / bits / fcntl.h

/* O_*, F_*, FD_* bit values. 4.4BSD/Generic version.
   Copyright (C) 1991-2012 Free Software Foundation, Inc.
   This file is part of the GNU C Library.

   The GNU C Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   The GNU C Library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with the GNU C Library; if not, see
   <http://www.gnu.org/licenses/>.  */

#ifndef	_FCNTL_H
#error "Never use <bits/fcntl.h> directly; include <fcntl.h> instead."
#endif


/* File access modes for `open' and `fcntl'.  */
#define	O_RDONLY	0	/* Open read-only.  */
#define	O_WRONLY	1	/* Open write-only.  */
#define	O_RDWR		2	/* Open read/write.  */


/* Bits OR'd into the second argument to open.  */
#define	O_CREAT		0x0200	/* Create file if it doesn't exist.  */
#define	O_EXCL		0x0800	/* Fail if file already exists.  */
#define	O_TRUNC		0x0400	/* Truncate file to zero length.  */
#define	O_NOCTTY	0x8000	/* Don't assign a controlling terminal.  */
#define	O_ASYNC		0x0040	/* Send SIGIO to owner when data is ready.  */
#define	O_FSYNC		0x0080	/* Synchronous writes.  */
#define	O_SYNC		O_FSYNC
#ifdef	__USE_MISC
#define	O_SHLOCK	0x0010	/* Open with shared file lock.  */
#define	O_EXLOCK	0x0020	/* Open with shared exclusive lock.  */
#endif
#ifdef __USE_XOPEN2K8
# define O_DIRECTORY	0x00200000	/* Must be a directory.	 */
# define O_NOFOLLOW	0x00000100	/* Do not follow links.	 */
# define O_CLOEXEC	0x00400000      /* Set close_on_exec.  */
#endif

/* All opens support large file sizes, so there is no flag bit for this.  */
#ifdef __USE_LARGEFILE64
# define O_LARGEFILE	0
#endif

/* File status flags for `open' and `fcntl'.  */
#define	O_APPEND	0x0008	/* Writes append to the file.  */
#define	O_NONBLOCK	0x0004	/* Non-blocking I/O.  */

#ifdef __USE_BSD
# define O_NDELAY	O_NONBLOCK
#endif

#ifdef __USE_BSD
/* Bits in the file status flags returned by F_GETFL.
   These are all the O_* flags, plus FREAD and FWRITE, which are
   independent bits set by which of O_RDONLY, O_WRONLY, and O_RDWR, was
   given to `open'.  */
# define FREAD		1
# define FWRITE		2

/* Traditional BSD names the O_* bits.  */
# define FASYNC		O_ASYNC
# define FFSYNC		O_FSYNC
# define FSYNC		O_SYNC
# define FAPPEND	O_APPEND
# define FNDELAY	O_NDELAY
#endif

/* Mask for file access modes.  This is system-dependent in case
   some system ever wants to define some other flavor of access.  */
#define	O_ACCMODE	(O_RDONLY|O_WRONLY|O_RDWR)

/* Values for the second argument to `fcntl'.  */
#define	F_DUPFD	  	0	/* Duplicate file descriptor.  */
#define	F_GETFD		1	/* Get file descriptor flags.  */
#define	F_SETFD		2	/* Set file descriptor flags.  */
#define	F_GETFL		3	/* Get file status flags.  */
#define	F_SETFL		4	/* Set file status flags.  */
#if defined __USE_BSD || defined __USE_UNIX98 || defined __USE_XOPEN2K8
#define	F_GETOWN	5	/* Get owner (receiver of SIGIO).  */
#define	F_SETOWN	6	/* Set owner (receiver of SIGIO).  */
#endif
#define	F_GETLK		7	/* Get record locking info.  */
#define	F_SETLK		8	/* Set record locking info (non-blocking).  */
#define	F_SETLKW	9	/* Set record locking info (blocking).  */
/* Not necessary, we always have 64-bit offsets.  */
#define F_GETLK64	F_GETLK	/* Get record locking info.  */
#define F_SETLK64	F_SETLK	/* Set record locking info (non-blocking).  */
#define F_SETLKW64	F_SETLKW/* Set record locking info (blocking).	*/
#ifdef __USE_XOPEN2K8
# define F_DUPFD_CLOEXEC 12	/* Duplicate file descriptor with
				   close-on-exit set.  */
#endif

/* File descriptor flags used with F_GETFD and F_SETFD.  */
#define	FD_CLOEXEC	1	/* Close on exec.  */


#include <bits/types.h>

/* The structure describing an advisory lock.  This is the type of the third
   argument to `fcntl' for the F_GETLK, F_SETLK, and F_SETLKW requests.  */
struct flock
  {
    __off_t l_start;	/* Offset where the lock begins.  */
    __off_t l_len;	/* Size of the locked area; zero means until EOF.  */
    __pid_t l_pid;	/* Process holding the lock.  */
    short int l_type;	/* Type of lock: F_RDLCK, F_WRLCK, or F_UNLCK.  */
    short int l_whence;	/* Where `l_start' is relative to (like `lseek').  */
  };

#ifdef __USE_LARGEFILE64
/* Note this matches struct flock exactly.  */
struct flock64
  {
    __off_t l_start;	/* Offset where the lock begins.  */
    __off_t l_len;	/* Size of the locked area; zero means until EOF.  */
    __pid_t l_pid;	/* Process holding the lock.  */
    short int l_type;	/* Type of lock: F_RDLCK, F_WRLCK, or F_UNLCK.  */
    short int l_whence;	/* Where `l_start' is relative to (like `lseek').  */
  };
#endif

/* Values for the `l_type' field of a `struct flock'.  */
#define	F_RDLCK	1	/* Read lock.  */
#define	F_WRLCK	2	/* Write lock.  */
#define	F_UNLCK	3	/* Remove lock.  */

/* Advise to `posix_fadvise'.  */
#ifdef __USE_XOPEN2K
# define POSIX_FADV_NORMAL	0 /* No further special treatment.  */
# define POSIX_FADV_RANDOM	1 /* Expect random page references.  */
# define POSIX_FADV_SEQUENTIAL	2 /* Expect sequential page references.  */
# define POSIX_FADV_WILLNEED	3 /* Will need these pages.  */
# define POSIX_FADV_DONTNEED	4 /* Don't need these pages.  */
# define POSIX_FADV_NOREUSE	5 /* Data will be accessed once.  */
#endif
Commit	Line	Data
22895b47 RM	1	/* O_, F_, FD_* bit values. 4.4BSD/Generic version.
22895b47 RM	2	Copyright (C) 1991-2012 Free Software Foundation, Inc.
0d8733c4 UD	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
41bdb6e2 AJ	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.
0d8733c4 UD	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
41bdb6e2	13	Lesser General Public License for more details.
0d8733c4	14
41bdb6e2	15	You should have received a copy of the GNU Lesser General Public
59ba27a6 PE	16	License along with the GNU C Library; if not, see
59ba27a6 PE	17	<http://www.gnu.org/licenses/>. */
28f540f4	18
5107cf1d	19	#ifndef _FCNTL_H
22895b47	20	#error "Never use <bits/fcntl.h> directly; include <fcntl.h> instead."
5107cf1d	21	#endif
28f540f4 RM	22
	23
	24	/* File access modes for `open' and `fcntl'. */
	25	#define O_RDONLY 0 /* Open read-only. */
	26	#define O_WRONLY 1 /* Open write-only. */
	27	#define O_RDWR 2 /* Open read/write. */
	28
	29
	30	/* Bits OR'd into the second argument to open. */
	31	#define O_CREAT 0x0200 /* Create file if it doesn't exist. */
	32	#define O_EXCL 0x0800 /* Fail if file already exists. */
	33	#define O_TRUNC 0x0400 /* Truncate file to zero length. */
22895b47 RM	34	#define O_NOCTTY 0x8000 /* Don't assign a controlling terminal. */
	35	#define O_ASYNC 0x0040 /* Send SIGIO to owner when data is ready. */
	36	#define O_FSYNC 0x0080 /* Synchronous writes. */
	37	#define O_SYNC O_FSYNC
	38	#ifdef __USE_MISC
	39	#define O_SHLOCK 0x0010 /* Open with shared file lock. */
	40	#define O_EXLOCK 0x0020 /* Open with shared exclusive lock. */
	41	#endif
	42	#ifdef __USE_XOPEN2K8
	43	# define O_DIRECTORY 0x00200000 /* Must be a directory. */
	44	# define O_NOFOLLOW 0x00000100 /* Do not follow links. */
	45	# define O_CLOEXEC 0x00400000 /* Set close_on_exec. */
	46	#endif
	47
	48	/* All opens support large file sizes, so there is no flag bit for this. */
	49	#ifdef __USE_LARGEFILE64
	50	# define O_LARGEFILE 0
	51	#endif
28f540f4 RM	52
	53	/* File status flags for `open' and `fcntl'. */
	54	#define O_APPEND 0x0008 /* Writes append to the file. */
	55	#define O_NONBLOCK 0x0004 /* Non-blocking I/O. */
	56
	57	#ifdef __USE_BSD
01ed6c51	58	# define O_NDELAY O_NONBLOCK
28f540f4 RM	59	#endif
28f540f4 RM	60
22895b47 RM	61	#ifdef __USE_BSD
	62	/* Bits in the file status flags returned by F_GETFL.
	63	These are all the O_* flags, plus FREAD and FWRITE, which are
	64	independent bits set by which of O_RDONLY, O_WRONLY, and O_RDWR, was
	65	given to `open'. */
	66	# define FREAD 1
	67	# define FWRITE 2
	68
	69	/* Traditional BSD names the O_* bits. */
	70	# define FASYNC O_ASYNC
	71	# define FFSYNC O_FSYNC
	72	# define FSYNC O_SYNC
	73	# define FAPPEND O_APPEND
	74	# define FNDELAY O_NDELAY
	75	#endif
	76
28f540f4 RM	77	/* Mask for file access modes. This is system-dependent in case
	78	some system ever wants to define some other flavor of access. */
	79	#define O_ACCMODE (O_RDONLY\|O_WRONLY\|O_RDWR)
	80
	81	/* Values for the second argument to `fcntl'. */
	82	#define F_DUPFD 0 /* Duplicate file descriptor. */
	83	#define F_GETFD 1 /* Get file descriptor flags. */
	84	#define F_SETFD 2 /* Set file descriptor flags. */
	85	#define F_GETFL 3 /* Get file status flags. */
	86	#define F_SETFL 4 /* Set file status flags. */
22895b47 RM	87	#if defined __USE_BSD \|\| defined __USE_UNIX98 \|\| defined __USE_XOPEN2K8
	88	#define F_GETOWN 5 /* Get owner (receiver of SIGIO). */
	89	#define F_SETOWN 6 /* Set owner (receiver of SIGIO). */
28f540f4 RM	90	#endif
28f540f4 RM	91	#define F_GETLK 7 /* Get record locking info. */
22895b47 RM	92	#define F_SETLK 8 /* Set record locking info (non-blocking). */
	93	#define F_SETLKW 9 /* Set record locking info (blocking). */
	94	/* Not necessary, we always have 64-bit offsets. */
	95	#define F_GETLK64 F_GETLK /* Get record locking info. */
	96	#define F_SETLK64 F_SETLK /* Set record locking info (non-blocking). */
	97	#define F_SETLKW64 F_SETLKW/* Set record locking info (blocking). */
	98	#ifdef __USE_XOPEN2K8
	99	# define F_DUPFD_CLOEXEC 12 /* Duplicate file descriptor with
	100	close-on-exit set. */
	101	#endif
28f540f4 RM	102
	103	/* File descriptor flags used with F_GETFD and F_SETFD. */
	104	#define FD_CLOEXEC 1 /* Close on exec. */
	105
	106
5107cf1d	107	#include <bits/types.h>
28f540f4 RM	108
	109	/* The structure describing an advisory lock. This is the type of the third
	110	argument to `fcntl' for the F_GETLK, F_SETLK, and F_SETLKW requests. */
	111	struct flock
	112	{
22895b47 RM	113	__off_t l_start; /* Offset where the lock begins. */
	114	__off_t l_len; /* Size of the locked area; zero means until EOF. */
	115	__pid_t l_pid; /* Process holding the lock. */
28f540f4 RM	116	short int l_type; /* Type of lock: F_RDLCK, F_WRLCK, or F_UNLCK. */
28f540f4 RM	117	short int l_whence; /* Where `l_start' is relative to (like `lseek'). */
22895b47 RM	118	};
	119
	120	#ifdef __USE_LARGEFILE64
	121	/* Note this matches struct flock exactly. */
	122	struct flock64
	123	{
28f540f4 RM	124	__off_t l_start; /* Offset where the lock begins. */
	125	__off_t l_len; /* Size of the locked area; zero means until EOF. */
	126	__pid_t l_pid; /* Process holding the lock. */
22895b47 RM	127	short int l_type; /* Type of lock: F_RDLCK, F_WRLCK, or F_UNLCK. */
22895b47 RM	128	short int l_whence; /* Where `l_start' is relative to (like `lseek'). */
28f540f4	129	};
22895b47	130	#endif
28f540f4 RM	131
	132	/* Values for the `l_type' field of a `struct flock'. */
	133	#define F_RDLCK 1 /* Read lock. */
	134	#define F_WRLCK 2 /* Write lock. */
	135	#define F_UNLCK 3 /* Remove lock. */
bb8e0116 UD	136
	137	/* Advise to `posix_fadvise'. */
	138	#ifdef __USE_XOPEN2K
	139	# define POSIX_FADV_NORMAL 0 /* No further special treatment. */
	140	# define POSIX_FADV_RANDOM 1 /* Expect random page references. */
	141	# define POSIX_FADV_SEQUENTIAL 2 /* Expect sequential page references. */
	142	# define POSIX_FADV_WILLNEED 3 /* Will need these pages. */
	143	# define POSIX_FADV_DONTNEED 4 /* Don't need these pages. */
	144	# define POSIX_FADV_NOREUSE 5 /* Data will be accessed once. */
	145	#endif