libc/sysdeps/linux/common/bits/stat.h

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