sysdeps/unix/sysv/linux/bits/stat.h

   1 /* Copyright (C) 1992, 1995-2001, 2002 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3
   4    The GNU C Library is free software; you can redistribute it and/or
   5    modify it under the terms of the GNU Lesser General Public
   6    License as published by the Free Software Foundation; either
   7    version 2.1 of the License, or (at your option) any later version.
   8
   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    Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public
  15    License along with the GNU C Library; if not, write to the Free
  16    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  17    02111-1307 USA.  */
  18
  19 #ifndef _SYS_STAT_H
  20 # error "Never include <bits/stat.h> directly; use <sys/stat.h> instead."
  21 #endif
  22
  23 /* Versions of the `struct stat' data structure.  */
  24 #define _STAT_VER_LINUX_OLD     1
  25 #define _STAT_VER_KERNEL        1
  26 #define _STAT_VER_SVR4          2
  27 #define _STAT_VER_LINUX         3
  28 #define _STAT_VER               _STAT_VER_LINUX /* The one defined below.  */
  29
  30 /* Versions of the `xmknod' interface.  */
  31 #define _MKNOD_VER_LINUX        1
  32 #define _MKNOD_VER_SVR4         2
  33 #define _MKNOD_VER              _MKNOD_VER_LINUX /* The bits defined below.  */
  34
  35
  36 struct stat
  37   {
  38     __dev_t st_dev;                     /* Device.  */
  39     unsigned short int __pad1;
  40 #ifndef __USE_FILE_OFFSET64
  41     __ino_t st_ino;                     /* File serial number.  */
  42 #else
  43     __ino_t __st_ino;                   /* 32bit file serial number.    */
  44 #endif
  45     __mode_t st_mode;                   /* File mode.  */
  46     __nlink_t st_nlink;                 /* Link count.  */
  47     __uid_t st_uid;                     /* User ID of the file's owner. */
  48     __gid_t st_gid;                     /* Group ID of the file's group.*/
  49     __dev_t st_rdev;                    /* Device number, if device.  */
  50     unsigned short int __pad2;
  51 #ifndef __USE_FILE_OFFSET64
  52     __off_t st_size;                    /* Size of file, in bytes.  */
  53 #else
  54     __off64_t st_size;                  /* Size of file, in bytes.  */
  55 #endif
  56     __blksize_t st_blksize;             /* Optimal block size for I/O.  */
  57
  58 #ifndef __USE_FILE_OFFSET64
  59     __blkcnt_t st_blocks;               /* Number 512-byte blocks allocated. */
  60 #else
  61     __blkcnt64_t st_blocks;             /* Number 512-byte blocks allocated. */
  62 #endif
  63 #ifdef __USE_MISC
  64     /* Nanosecond resolution timestamps are stored in a format
  65        equivalent to 'struct timespec'.  This is the type used
  66        whenever possible but the Unix namespace rules do not allow the
  67        identifier 'timespec' to appear in the <sys/stat.h> header.
  68        Therefore we have to handle the use of this header in strictly
  69        standard-compliant sources special.  */
  70     struct timespec st_atim;            /* Time of last access.  */
  71     struct timespec st_mtim;            /* Time of last modification.  */
  72     struct timespec st_ctim;            /* Time of last status change.  */
  73 # define st_atime st_atim.tv_sec        /* Backward compatibility.  */
  74 # define st_mtime st_mtim.tv_sec
  75 # define st_ctime st_ctim.tv_sec
  76 #else
  77     __time_t st_atime;                  /* Time of last access.  */
  78     unsigned long int st_atimensec;     /* Nscecs of last access.  */
  79     __time_t st_mtime;                  /* Time of last modification.  */
  80     unsigned long int st_mtimensec;     /* Nsecs of last modification.  */
  81     __time_t st_ctime;                  /* Time of last status change.  */
  82     unsigned long int st_ctimensec;     /* Nsecs of last status change.  */
  83 #endif
  84 #ifndef __USE_FILE_OFFSET64
  85     unsigned long int __unused4;
  86     unsigned long int __unused5;
  87 #else
  88     __ino64_t st_ino;                   /* File serial number.  */
  89 #endif
  90   };
  91
  92 #ifdef __USE_LARGEFILE64
  93 struct stat64
  94   {
  95     __dev_t st_dev;                     /* Device.  */
  96     unsigned int __pad1;
  97
  98     __ino_t __st_ino;                   /* 32bit file serial number.    */
  99     __mode_t st_mode;                   /* File mode.  */
 100     __nlink_t st_nlink;                 /* Link count.  */
 101     __uid_t st_uid;                     /* User ID of the file's owner. */
 102     __gid_t st_gid;                     /* Group ID of the file's group.*/
 103     __dev_t st_rdev;                    /* Device number, if device.  */
 104     unsigned int __pad2;
 105     __off64_t st_size;                  /* Size of file, in bytes.  */
 106     __blksize_t st_blksize;             /* Optimal block size for I/O.  */
 107
 108     __blkcnt64_t st_blocks;             /* Number 512-byte blocks allocated. */
 109 #ifdef __USE_MISC
 110     /* Nanosecond resolution timestamps are stored in a format
 111        equivalent to 'struct timespec'.  This is the type used
 112        whenever possible but the Unix namespace rules do not allow the
 113        identifier 'timespec' to appear in the <sys/stat.h> header.
 114        Therefore we have to handle the use of this header in strictly
 115        standard-compliant sources special.  */
 116     struct timespec st_atim;            /* Time of last access.  */
 117     struct timespec st_mtim;            /* Time of last modification.  */
 118     struct timespec st_ctim;            /* Time of last status change.  */
 119 #else
 120     __time_t st_atime;                  /* Time of last access.  */
 121     unsigned long int st_atimensec;     /* Nscecs of last access.  */
 122     __time_t st_mtime;                  /* Time of last modification.  */
 123     unsigned long int st_mtimensec;     /* Nsecs of last modification.  */
 124     __time_t st_ctime;                  /* Time of last status change.  */
 125     unsigned long int st_ctimensec;     /* Nsecs of last status change.  */
 126 #endif
 127     __ino64_t st_ino;                   /* File serial number.          */
 128   };
 129 #endif
 130
 131 /* Tell code we have these members.  */
 132 #define _STATBUF_ST_BLKSIZE
 133 #define _STATBUF_ST_RDEV
 134 /* Nanosecond resolution time values are supported.  */
 135 #define _STATBUF_ST_NSEC
 136
 137 /* Encoding of the file mode.  */
 138
 139 #define __S_IFMT        0170000 /* These bits determine file type.  */
 140
 141 /* File types.  */
 142 #define __S_IFDIR       0040000 /* Directory.  */
 143 #define __S_IFCHR       0020000 /* Character device.  */
 144 #define __S_IFBLK       0060000 /* Block device.  */
 145 #define __S_IFREG       0100000 /* Regular file.  */
 146 #define __S_IFIFO       0010000 /* FIFO.  */
 147 #define __S_IFLNK       0120000 /* Symbolic link.  */
 148 #define __S_IFSOCK      0140000 /* Socket.  */
 149
 150 /* POSIX.1b objects.  Note that these macros always evaluate to zero.  But
 151    they do it by enforcing the correct use of the macros.  */
 152 #define __S_TYPEISMQ(buf)  ((buf)->st_mode - (buf)->st_mode)
 153 #define __S_TYPEISSEM(buf) ((buf)->st_mode - (buf)->st_mode)
 154 #define __S_TYPEISSHM(buf) ((buf)->st_mode - (buf)->st_mode)
 155
 156 /* Protection bits.  */
 157
 158 #define __S_ISUID       04000   /* Set user ID on execution.  */
 159 #define __S_ISGID       02000   /* Set group ID on execution.  */
 160 #define __S_ISVTX       01000   /* Save swapped text after use (sticky).  */
 161 #define __S_IREAD       0400    /* Read by owner.  */
 162 #define __S_IWRITE      0200    /* Write by owner.  */
 163 #define __S_IEXEC       0100    /* Execute by owner.  */
 164
 165 #if defined __USE_ATFILE || defined __USE_GNU
 166 /* XXX This will change to the macro for the next 2008 POSIX revision.  */
 167 # define UTIME_NOW      ((1l << 30) - 1l)
 168 # define UTIME_OMIT     ((1l << 30) - 2l)
 169 #endif