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

/* O_*, F_*, FD_* bit values. 4.4BSD/Generic version.
   Copyright (C) 1991-2017 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
#if defined __USE_POSIX199309 || defined __USE_UNIX98
# define O_DSYNC	0x00010000	/* Synchronize data.  */
# define O_RSYNC	0x00020000	/* Synchronize read operations.	 */
#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_MISC
# define O_NDELAY	O_NONBLOCK
#endif

#ifdef __USE_MISC
/* 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_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	1	/* O_, F_, FD_* bit values. 4.4BSD/Generic version.
bfff8b1b	2	Copyright (C) 1991-2017 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
e04e272d RM	47	#if defined __USE_POSIX199309 \|\| defined __USE_UNIX98
	48	# define O_DSYNC 0x00010000 /* Synchronize data. */
	49	# define O_RSYNC 0x00020000 /* Synchronize read operations. */
	50	#endif
22895b47 RM	51
	52	/* All opens support large file sizes, so there is no flag bit for this. */
	53	#ifdef __USE_LARGEFILE64
	54	# define O_LARGEFILE 0
	55	#endif
28f540f4 RM	56
	57	/* File status flags for `open' and `fcntl'. */
	58	#define O_APPEND 0x0008 /* Writes append to the file. */
	59	#define O_NONBLOCK 0x0004 /* Non-blocking I/O. */
	60
498afc54	61	#ifdef __USE_MISC
01ed6c51	62	# define O_NDELAY O_NONBLOCK
28f540f4 RM	63	#endif
28f540f4 RM	64
498afc54	65	#ifdef __USE_MISC
22895b47 RM	66	/* Bits in the file status flags returned by F_GETFL.
	67	These are all the O_* flags, plus FREAD and FWRITE, which are
	68	independent bits set by which of O_RDONLY, O_WRONLY, and O_RDWR, was
	69	given to `open'. */
	70	# define FREAD 1
	71	# define FWRITE 2
	72
	73	/* Traditional BSD names the O_* bits. */
	74	# define FASYNC O_ASYNC
	75	# define FFSYNC O_FSYNC
	76	# define FSYNC O_SYNC
	77	# define FAPPEND O_APPEND
	78	# define FNDELAY O_NDELAY
	79	#endif
	80
28f540f4 RM	81	/* Mask for file access modes. This is system-dependent in case
	82	some system ever wants to define some other flavor of access. */
	83	#define O_ACCMODE (O_RDONLY\|O_WRONLY\|O_RDWR)
	84
	85	/* Values for the second argument to `fcntl'. */
	86	#define F_DUPFD 0 /* Duplicate file descriptor. */
	87	#define F_GETFD 1 /* Get file descriptor flags. */
	88	#define F_SETFD 2 /* Set file descriptor flags. */
	89	#define F_GETFL 3 /* Get file status flags. */
	90	#define F_SETFL 4 /* Set file status flags. */
acd7f096	91	#if defined __USE_UNIX98 \|\| defined __USE_XOPEN2K8
22895b47 RM	92	#define F_GETOWN 5 /* Get owner (receiver of SIGIO). */
22895b47 RM	93	#define F_SETOWN 6 /* Set owner (receiver of SIGIO). */
28f540f4 RM	94	#endif
28f540f4 RM	95	#define F_GETLK 7 /* Get record locking info. */
22895b47 RM	96	#define F_SETLK 8 /* Set record locking info (non-blocking). */
	97	#define F_SETLKW 9 /* Set record locking info (blocking). */
	98	/* Not necessary, we always have 64-bit offsets. */
	99	#define F_GETLK64 F_GETLK /* Get record locking info. */
	100	#define F_SETLK64 F_SETLK /* Set record locking info (non-blocking). */
	101	#define F_SETLKW64 F_SETLKW/* Set record locking info (blocking). */
	102	#ifdef __USE_XOPEN2K8
	103	# define F_DUPFD_CLOEXEC 12 /* Duplicate file descriptor with
	104	close-on-exit set. */
	105	#endif
28f540f4 RM	106
	107	/* File descriptor flags used with F_GETFD and F_SETFD. */
	108	#define FD_CLOEXEC 1 /* Close on exec. */
	109
	110
5107cf1d	111	#include <bits/types.h>
28f540f4 RM	112
	113	/* The structure describing an advisory lock. This is the type of the third
	114	argument to `fcntl' for the F_GETLK, F_SETLK, and F_SETLKW requests. */
	115	struct flock
	116	{
22895b47 RM	117	__off_t l_start; /* Offset where the lock begins. */
	118	__off_t l_len; /* Size of the locked area; zero means until EOF. */
	119	__pid_t l_pid; /* Process holding the lock. */
28f540f4 RM	120	short int l_type; /* Type of lock: F_RDLCK, F_WRLCK, or F_UNLCK. */
28f540f4 RM	121	short int l_whence; /* Where `l_start' is relative to (like `lseek'). */
22895b47 RM	122	};
	123
	124	#ifdef __USE_LARGEFILE64
	125	/* Note this matches struct flock exactly. */
	126	struct flock64
	127	{
28f540f4 RM	128	__off_t l_start; /* Offset where the lock begins. */
	129	__off_t l_len; /* Size of the locked area; zero means until EOF. */
	130	__pid_t l_pid; /* Process holding the lock. */
22895b47 RM	131	short int l_type; /* Type of lock: F_RDLCK, F_WRLCK, or F_UNLCK. */
22895b47 RM	132	short int l_whence; /* Where `l_start' is relative to (like `lseek'). */
28f540f4	133	};
22895b47	134	#endif
28f540f4 RM	135
	136	/* Values for the `l_type' field of a `struct flock'. */
	137	#define F_RDLCK 1 /* Read lock. */
	138	#define F_WRLCK 2 /* Write lock. */
	139	#define F_UNLCK 3 /* Remove lock. */
bb8e0116 UD	140
	141	/* Advise to `posix_fadvise'. */
	142	#ifdef __USE_XOPEN2K
	143	# define POSIX_FADV_NORMAL 0 /* No further special treatment. */
	144	# define POSIX_FADV_RANDOM 1 /* Expect random page references. */
	145	# define POSIX_FADV_SEQUENTIAL 2 /* Expect sequential page references. */
	146	# define POSIX_FADV_WILLNEED 3 /* Will need these pages. */
	147	# define POSIX_FADV_DONTNEED 4 /* Don't need these pages. */
	148	# define POSIX_FADV_NOREUSE 5 /* Data will be accessed once. */
	149	#endif