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

/* Copyright (C) 1991, 92, 94, 95, 96, 97 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 Library General Public License as
   published by the Free Software Foundation; either version 2 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
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with the GNU C Library; see the file COPYING.LIB.  If not,
   write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.  */

/*
 *	POSIX Standard: 6.5 File Control Operations	<fcntl.h>
 */

#ifndef	_FCNTL_H
#define	_FCNTL_H	1

#include <features.h>

/* This must be early so <bits/fcntl.h> can define types winningly.  */
__BEGIN_DECLS

/* Get the definitions of O_*, F_*, FD_*: all the
   numbers and flag bits for `open', `fcntl', et al.  */
#include <bits/fcntl.h>

/* For Unix98 all symbols from <sys/stat.h> should also be available.  */
#ifdef __USE_UNIX98
# include <sys/stat.h>
#endif

#ifdef	__USE_MISC
# ifndef R_OK			/* Verbatim from <unistd.h>.  Ugh.  */
/* Values for the second argument to access.
   These may be OR'd together.  */
#  define R_OK	4		/* Test for read permission.  */
#  define W_OK	2		/* Test for write permission.  */
#  define X_OK	1		/* Test for execute permission.  */
#  define F_OK	0		/* Test for existence.  */
# endif
#endif /* Use misc.  */

/* Do the file control operation described by CMD on FD.
   The remaining arguments are interpreted depending on CMD.  */
extern int __fcntl __P ((int __fd, int __cmd, ...));
extern int fcntl __P ((int __fd, int __cmd, ...));

/* Open FILE and return a new file descriptor for it, or -1 on error.
   OFLAG determines the type of access used.  If O_CREAT is on OFLAG,
   the third argument is taken as a `mode_t', the mode of the created file.  */
extern int __open __P ((__const char *__file, int __oflag, ...));
extern int __open64 __P ((__const char *__file, int __oflag, ...));
#ifndef __USE_FILE_OFFSET64
extern int open __P ((__const char *__file, int __oflag, ...));
#else
extern int open __P ((__const char *__file, int __oflag, ...))
     __asm__ ("open64");
#endif
#ifdef __USE_LARGEFILE64
extern int open64 __P ((__const char *__file, int __oflag, ...));
#endif

/* Create and open FILE, with mode MODE.
   This takes an `int' MODE argument because that is
   what `mode_t' will be widened to.  */
#ifndef __USE_FILE_OFFSET64
extern int creat __P ((__const char *__file, __mode_t __mode));
#else
extern int creat __P ((__const char *__file, __mode_t __mode))
     __asm__ ("creat64");
#endif
#ifdef __USE_LARGEFILE64
extern int creat64 __P ((__const char *__file, __mode_t __mode));
#endif

#if !defined F_LOCK && (defined __USE_MISC || (defined __USE_XOPEN_EXTENDED \
					       && !defined __USE_POSIX))
/* NOTE: These declarations also appear in <unistd.h>; be sure to keep both
   files consistent.  Some systems have them there and some here, and some
   software depends on the macros being defined without including both.  */

/* `lockf' is a simpler interface to the locking facilities of `fcntl'.
   LEN is always relative to the current file position.
   The CMD argument is one of the following.  */

# define F_ULOCK 0	/* Unlock a previously locked region.  */
# define F_LOCK  1	/* Lock a region for exclusive use.  */
# define F_TLOCK 2	/* Test and lock a region for exclusive use.  */
# define F_TEST  3	/* Test a region for other processes locks.  */

# ifndef __USE_FILE_OFFSET64
extern int lockf __P ((int __fd, int __cmd, __off_t __len));
# else
extern int lockf __P ((int __fd, int __cmd, __off64_t __len))
     __asm__ ("lockf64");
# endif
# ifdef __USE_LARGEFILE64
extern int lockf64 __P ((int __fd, int __cmd, __off64_t __len));
# endif
#endif

__END_DECLS

#endif /* fcntl.h  */
Commit	Line	Data
dfd2257a	1	/* Copyright (C) 1991, 92, 94, 95, 96, 97 Free Software Foundation, Inc.
54d79e99	2	This file is part of the GNU C Library.
28f540f4	3
54d79e99 UD	4	The GNU C Library is free software; you can redistribute it and/or
	5	modify it under the terms of the GNU Library General Public License as
	6	published by the Free Software Foundation; either version 2 of the
	7	License, or (at your option) any later version.
28f540f4	8
54d79e99 UD	9	The GNU C Library is distributed in the hope that it will be useful,
	10	but WITHOUT ANY WARRANTY; without even the implied warranty of
	11	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	12	Library General Public License for more details.
28f540f4	13
54d79e99 UD	14	You should have received a copy of the GNU Library General Public
	15	License along with the GNU C Library; see the file COPYING.LIB. If not,
	16	write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
	17	Boston, MA 02111-1307, USA. */
28f540f4 RM	18
	19	/*
	20	* POSIX Standard: 6.5 File Control Operations <fcntl.h>
	21	*/
	22
	23	#ifndef _FCNTL_H
28f540f4	24	#define _FCNTL_H 1
5107cf1d	25
28f540f4 RM	26	#include <features.h>
28f540f4 RM	27
5107cf1d	28	/* This must be early so <bits/fcntl.h> can define types winningly. */
28f540f4 RM	29	__BEGIN_DECLS
	30
	31	/* Get the definitions of O_, F_, FD_*: all the
	32	numbers and flag bits for `open', `fcntl', et al. */
5107cf1d	33	#include <bits/fcntl.h>
28f540f4	34
9756dfe1 UD	35	/* For Unix98 all symbols from <sys/stat.h> should also be available. */
	36	#ifdef __USE_UNIX98
	37	# include <sys/stat.h>
	38	#endif
	39
28f540f4	40	#ifdef __USE_MISC
dfd2257a	41	# ifndef R_OK /* Verbatim from <unistd.h>. Ugh. */
28f540f4 RM	42	/* Values for the second argument to access.
28f540f4 RM	43	These may be OR'd together. */
dfd2257a UD	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
28f540f4 RM	49	#endif /* Use misc. */
28f540f4 RM	50
28f540f4 RM	51	/* Do the file control operation described by CMD on FD.
	52	The remaining arguments are interpreted depending on CMD. */
	53	extern int __fcntl __P ((int __fd, int __cmd, ...));
	54	extern int fcntl __P ((int __fd, int __cmd, ...));
	55
	56	/* Open FILE and return a new file descriptor for it, or -1 on error.
	57	OFLAG determines the type of access used. If O_CREAT is on OFLAG,
	58	the third argument is taken as a `mode_t', the mode of the created file. */
23396375	59	extern int __open __P ((__const char *__file, int __oflag, ...));
dfd2257a UD	60	extern int __open64 __P ((__const char *__file, int __oflag, ...));
dfd2257a UD	61	#ifndef __USE_FILE_OFFSET64
23396375	62	extern int open __P ((__const char *__file, int __oflag, ...));
dfd2257a UD	63	#else
	64	extern int open __P ((__const char *__file, int __oflag, ...))
	65	__asm__ ("open64");
	66	#endif
	67	#ifdef __USE_LARGEFILE64
	68	extern int open64 __P ((__const char *__file, int __oflag, ...));
	69	#endif
28f540f4 RM	70
	71	/* Create and open FILE, with mode MODE.
	72	This takes an `int' MODE argument because that is
	73	what `mode_t' will be widened to. */
dfd2257a	74	#ifndef __USE_FILE_OFFSET64
28f540f4	75	extern int creat __P ((__const char *__file, __mode_t __mode));
dfd2257a UD	76	#else
	77	extern int creat __P ((__const char *__file, __mode_t __mode))
	78	__asm__ ("creat64");
	79	#endif
	80	#ifdef __USE_LARGEFILE64
	81	extern int creat64 __P ((__const char *__file, __mode_t __mode));
	82	#endif
28f540f4	83
9756dfe1 UD	84	#if !defined F_LOCK && (defined __USE_MISC \|\| (defined __USE_XOPEN_EXTENDED \
9756dfe1 UD	85	&& !defined __USE_POSIX))
28f540f4 RM	86	/* NOTE: These declarations also appear in <unistd.h>; be sure to keep both
	87	files consistent. Some systems have them there and some here, and some
	88	software depends on the macros being defined without including both. */
	89
	90	/* `lockf' is a simpler interface to the locking facilities of `fcntl'.
	91	LEN is always relative to the current file position.
	92	The CMD argument is one of the following. */
	93
dfd2257a UD	94	# define F_ULOCK 0 /* Unlock a previously locked region. */
	95	# define F_LOCK 1 /* Lock a region for exclusive use. */
	96	# define F_TLOCK 2 /* Test and lock a region for exclusive use. */
	97	# define F_TEST 3 /* Test a region for other processes locks. */
28f540f4	98
dfd2257a	99	# ifndef __USE_FILE_OFFSET64
28f540f4	100	extern int lockf __P ((int __fd, int __cmd, __off_t __len));
dfd2257a	101	# else
b9b49b44	102	extern int lockf __P ((int __fd, int __cmd, __off64_t __len))
dfd2257a UD	103	__asm__ ("lockf64");
	104	# endif
	105	# ifdef __USE_LARGEFILE64
	106	extern int lockf64 __P ((int __fd, int __cmd, __off64_t __len));
	107	# endif
28f540f4 RM	108	#endif
	109
	110	__END_DECLS
	111
	112	#endif /* fcntl.h */