2005-03-15 Jakub Jelinek <jakub@redhat.com>
[kopensolaris-gnu/glibc.git] / io / fcntl.h
index 894c3d4..ef9d5f9 100644 (file)
-/* Copyright (C) 1991, 1992 Free Software Foundation, Inc.
-This file is part of the GNU C Library.
+/* Copyright (C) 1991,1992,1994-2001,2003,2004 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 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
-Library General Public License for more details.
+   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 Library General Public
-License along with the GNU C Library; see the file COPYING.LIB.  If
-not, write to the Free Software Foundation, Inc., 675 Mass Ave,
-Cambridge, MA 02139, USA.  */
+   You should have received a copy of the GNU Lesser General Public
+   License along with the GNU C Library; 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
 
 /*
  *     POSIX Standard: 6.5 File Control Operations     <fcntl.h>
  */
 
 #ifndef        _FCNTL_H
-
 #define        _FCNTL_H        1
 #define        _FCNTL_H        1
-#include <features.h>
-
-#include <gnu/fcntl.h>
-#include <filebits.h>
-
-
-/* Values for the second argument to fcntl.  */
-#define        F_DUPFD         __F_DUPFD       /* Duplicate file descriptor.  */
-#define        F_GETFD         __F_GETFD       /* Get file descriptor flags.  */
-#define        F_SETFD         __F_SETFD       /* Set file descriptor flags.  */
-#define        F_GETFL         __F_GETFL       /* Get file status flags.  */
-#define        F_SETFL         __F_SETFL       /* Set file status flags.  */
-#define        F_SETLK         __F_SETLK       /* Set record locking info.  */
-#define        F_SETLKW        __F_SETLKW      /* Set record locking, block.  */
-
-#ifdef __USE_BSD
-#define        F_GETOWN        __F_GETOWN      /* Get owner (receiver of SIGIO).  */
-#define        F_SETOWN        __F_SETOWN      /* Set owner (receiver of SIGIO).  */
-#endif
 
 
+#include <features.h>
 
 
-/* File descriptor flags used with F_GETFD and F_SETFD.  */
-#define        FD_CLOEXEC      __FD_CLOEXEC    /* Close on exec.  */
-
-
-/* File access modes for open and fcntl.  */
-#define        O_RDONLY        __O_RDONLY      /* Open read-only.  */
-#define        O_WRONLY        __O_WRONLY      /* Open write-only.  */
-#define        O_RDWR          __O_RDWR        /* Open read/write.  */
-
-
-/* Bits OR'd into the second argument to open.  */
-#define        O_CREAT         __O_CREAT       /* Create file if it doesn't exist.  */
-#define        O_EXCL          __O_EXCL        /* Fail if file already exists.  */
-#define        O_TRUNC         __O_TRUNC       /* Truncate file to zero length.  */
-#define        O_NOCTTY        __O_NOCTTY      /* Don't assign a controlling tty.  */
-
+/* This must be early so <bits/fcntl.h> can define types winningly.  */
+__BEGIN_DECLS
 
 
-/* File status flags for `open' and `fcntl'.  */
-#define        O_APPEND        __O_APPEND      /* Writes append to the file.  */
-#define        O_NONBLOCK      __O_NONBLOCK    /* No delay when opening the file.  */
+/* Get the definitions of O_*, F_*, FD_*: all the
+   numbers and flag bits for `open', `fcntl', et al.  */
+#include <bits/fcntl.h>
 
 
-#ifdef __USE_BSD
-#define        O_NDELAY        __O_NDELAY
+/* For XPG all symbols from <sys/stat.h> should also be available.  */
+#ifdef __USE_XOPEN
+# include <sys/stat.h>
 #endif
 
 #ifdef __USE_MISC
 #endif
 
 #ifdef __USE_MISC
-/* Unix-style flags for `fcntl' F_GETFL and F_SETFL.  */
-#define        FREAD           0x1             /* Read access.  */
-#define        FWRITE          0x2             /* Write access.  */
-#define        FNDELAY         O_NONBLOCK
-#define        FAPPEND         O_APPEND
-#define        FASYNC          0x40            /* Send SIGIO when data is ready.  */
-#define        FCREAT          O_CREAT
-#define        FTRUNC          O_TRUNC
-#define        FEXCL           O_EXCL
-#define        FSYNC           0x2000          /* Synchronous writes.  */
-
-#ifndef        R_OK    /* Verbatim from <unistd.h>.  Ugh.  */
+# ifndef R_OK                  /* Verbatim from <unistd.h>.  Ugh.  */
 /* Values for the second argument to access.
    These may be OR'd together.  */
 /* 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.  */
-
-
-/* Mask for file access modes.  */
-#define        O_ACCMODE       __O_ACCMODE
-
+#  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.  */
+
+/* XPG wants the following symbols.  */
+#ifdef __USE_XOPEN             /* <stdio.h> has the same definitions.  */
+# define SEEK_SET      0       /* Seek from beginning of file.  */
+# define SEEK_CUR      1       /* Seek from current position.  */
+# define SEEK_END      2       /* Seek from end of file.  */
+#endif /* XPG */
 
 /* Do the file control operation described by CMD on FD.
 
 /* Do the file control operation described by CMD on FD.
-   The remaining arguments are interpreted depending on CMD.  */
-extern int EXFUN(__fcntl, (int __fd, int __cmd, ...));
+   The remaining arguments are interpreted depending on CMD.
+
+   This function is a cancellation point and therefore not marked with
+   __THROW.  */
+extern int fcntl (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,
 
 /* 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 EXFUN(__open, (CONST char *__file, int __oflag, ...));
-
-#define        fcntl   __fcntl
-#define        open    __open
+   the third argument is taken as a `mode_t', the mode of the created file.
+
+   This function is a cancellation point and therefore not marked with
+   __THROW.  */
+#ifndef __USE_FILE_OFFSET64
+extern int open (__const char *__file, int __oflag, ...) __nonnull ((1));
+#else
+# ifdef __REDIRECT
+extern int __REDIRECT (open, (__const char *__file, int __oflag, ...), open64)
+     __nonnull ((1));
+# else
+#  define open open64
+# endif
+#endif
+#ifdef __USE_LARGEFILE64
+extern int open64 (__const char *__file, int __oflag, ...) __nonnull ((1));
+#endif
 
 
-/* Create and open FILE, with mode MODE.
-   This takes an `int' MODE argument because that is
-   what `mode_t' will be widened to.  */
-extern int EXFUN(creat, (CONST char *__file, __mode_t __mode));
+/* Create and open FILE, with mode MODE.  This takes an `int' MODE
+   argument because that is what `mode_t' will be widened to.
+
+   This function is a cancellation point and therefore not marked with
+   __THROW.  */
+#ifndef __USE_FILE_OFFSET64
+extern int creat (__const char *__file, __mode_t __mode) __nonnull ((1));
+#else
+# ifdef __REDIRECT
+extern int __REDIRECT (creat, (__const char *__file, __mode_t __mode),
+                      creat64) __nonnull ((1));
+# else
+#  define creat creat64
+# endif
+#endif
+#ifdef __USE_LARGEFILE64
+extern int creat64 (__const char *__file, __mode_t __mode) __nonnull ((1));
+#endif
 
 
-#ifdef __OPTIMIZE__
-#define        creat(file, m)  __open((file), O_WRONLY|O_CREAT|O_TRUNC, (m))
-#endif /* Optimizing.  */
+#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 (int __fd, int __cmd, __off_t __len);
+# else
+# ifdef __REDIRECT
+extern int __REDIRECT (lockf, (int __fd, int __cmd, __off64_t __len), lockf64);
+# else
+#  define lockf lockf64
+# endif
+# endif
+# ifdef __USE_LARGEFILE64
+extern int lockf64 (int __fd, int __cmd, __off64_t __len);
+# endif
+#endif
 
 
-#define        flock   __flock
-#define        F_RDLCK __F_RDLCK
-#define        F_WRLCK __F_WRLCK
-#define        F_UNLCK __F_UNLCK
+#ifdef __USE_XOPEN2K
+/* Advice the system about the expected behaviour of the application with
+   respect to the file associated with FD.  */
+# ifndef __USE_FILE_OFFSET64
+extern int posix_fadvise (int __fd, __off_t __offset, __off_t __len,
+                         int __advise) __THROW;
+# else
+# ifdef __REDIRECT_NTH
+extern int __REDIRECT_NTH (posix_fadvise, (int __fd, __off64_t __offset,
+                                          __off64_t __len, int __advise),
+                          posix_fadvise64);
+# else
+#  define posix_fadvise posix_fadvise64
+# endif
+# endif
+# ifdef __USE_LARGEFILE64
+extern int posix_fadvise64 (int __fd, __off64_t __offset, __off64_t __len,
+                           int __advise) __THROW;
+# endif
+
+
+/* Reserve storage for the data of the file associated with FD.
+
+   This function is a possible cancellation points and therefore not
+   marked with __THROW.  */
+# ifndef __USE_FILE_OFFSET64
+extern int posix_fallocate (int __fd, __off_t __offset, __off_t __len);
+# else
+# ifdef __REDIRECT
+extern int __REDIRECT (posix_fallocate, (int __fd, __off64_t __offset,
+                                        __off64_t __len),
+                      posix_fallocate64);
+# else
+#  define posix_fallocate posix_fallocate64
+# endif
+# endif
+# ifdef __USE_LARGEFILE64
+extern int posix_fallocate64 (int __fd, __off64_t __offset, __off64_t __len);
+# endif
+#endif
 
 
+__END_DECLS
 
 
-#endif /* fcntl.h  */
+#endif /* fcntl.h  */