Back to index

glibc  2.9
stat.h
Go to the documentation of this file.
00001 /* Copyright (C) 1999,2000,2001,2002,2003 Free Software Foundation, Inc.
00002    This file is part of the GNU C Library.
00003 
00004    The GNU C Library is free software; you can redistribute it and/or
00005    modify it under the terms of the GNU Lesser General Public
00006    License as published by the Free Software Foundation; either
00007    version 2.1 of the License, or (at your option) any later version.
00008 
00009    The GNU C Library is distributed in the hope that it will be useful,
00010    but WITHOUT ANY WARRANTY; without even the implied warranty of
00011    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00012    Lesser General Public License for more details.
00013 
00014    You should have received a copy of the GNU Lesser General Public
00015    License along with the GNU C Library; if not, write to the Free
00016    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
00017    02111-1307 USA.  */
00018 
00019 #ifndef _SYS_STAT_H
00020 # error "Never include <bits/stat.h> directly; use <sys/stat.h> instead."
00021 #endif
00022 
00023 /* Versions of the `struct stat' data structure.  */
00024 #define _STAT_VER_KERNEL    0
00025 
00026 #if __WORDSIZE == 32
00027 # define _STAT_VER_SVR4            2
00028 # define _STAT_VER_LINUX    3
00029 
00030 /* i386 versions of the `xmknod' interface.  */
00031 # define _MKNOD_VER_LINUX   1
00032 # define _MKNOD_VER_SVR4    2
00033 # define _MKNOD_VER         _MKNOD_VER_LINUX /* The bits defined below.  */
00034 #else
00035 # define _STAT_VER_LINUX    1
00036 
00037 /* x86-64 versions of the `xmknod' interface.  */
00038 # define _MKNOD_VER_LINUX   0
00039 #endif
00040 
00041 #define _STAT_VER           _STAT_VER_LINUX
00042 
00043 struct stat
00044   {
00045     __dev_t st_dev;         /* Device.  */
00046 #if __WORDSIZE == 32
00047     unsigned short int __pad1;
00048 #endif
00049 #if __WORDSIZE == 64 || !defined __USE_FILE_OFFSET64
00050     __ino_t st_ino;         /* File serial number.      */
00051 #else
00052     __ino_t __st_ino;                     /* 32bit file serial number.       */
00053 #endif
00054 #if __WORDSIZE == 32
00055     __mode_t st_mode;                     /* File mode.  */
00056     __nlink_t st_nlink;                   /* Link count.  */
00057 #else
00058     __nlink_t st_nlink;            /* Link count.  */
00059     __mode_t st_mode;              /* File mode.  */
00060 #endif
00061     __uid_t st_uid;         /* User ID of the file's owner.    */
00062     __gid_t st_gid;         /* Group ID of the file's group.*/
00063 #if __WORDSIZE == 64
00064     int __pad0;
00065 #endif
00066     __dev_t st_rdev;        /* Device number, if device.  */
00067 #if __WORDSIZE == 32
00068     unsigned short int __pad2;
00069 #endif
00070 #if __WORDSIZE == 64 || !defined __USE_FILE_OFFSET64
00071     __off_t st_size;               /* Size of file, in bytes.  */
00072 #else
00073     __off64_t st_size;                    /* Size of file, in bytes.  */
00074 #endif
00075     __blksize_t st_blksize; /* Optimal block size for I/O.  */
00076 #if __WORDSIZE == 64 || !defined __USE_FILE_OFFSET64
00077     __blkcnt_t st_blocks;          /* Number 512-byte blocks allocated. */
00078 #else
00079     __blkcnt64_t st_blocks;        /* Number 512-byte blocks allocated. */
00080 #endif
00081 #ifdef __USE_MISC
00082     /* Nanosecond resolution timestamps are stored in a format
00083        equivalent to 'struct timespec'.  This is the type used
00084        whenever possible but the Unix namespace rules do not allow the
00085        identifier 'timespec' to appear in the <sys/stat.h> header.
00086        Therefore we have to handle the use of this header in strictly
00087        standard-compliant sources special.  */
00088     struct timespec st_atim;              /* Time of last access.  */
00089     struct timespec st_mtim;              /* Time of last modification.  */
00090     struct timespec st_ctim;              /* Time of last status change.  */
00091 # define st_atime st_atim.tv_sec   /* Backward compatibility.  */
00092 # define st_mtime st_mtim.tv_sec
00093 # define st_ctime st_ctim.tv_sec
00094 #else
00095     __time_t st_atime;                    /* Time of last access.  */
00096     unsigned long int st_atimensec;       /* Nscecs of last access.  */
00097     __time_t st_mtime;                    /* Time of last modification.  */
00098     unsigned long int st_mtimensec;       /* Nsecs of last modification.  */
00099     __time_t st_ctime;                    /* Time of last status change.  */
00100     unsigned long int st_ctimensec;       /* Nsecs of last status change.  */
00101 #endif
00102 #if __WORDSIZE == 64
00103     long int __unused[3];
00104 #else
00105 # ifndef __USE_FILE_OFFSET64
00106     unsigned long int __unused4;
00107     unsigned long int __unused5;
00108 # else
00109     __ino64_t st_ino;                     /* File serial number.      */
00110 # endif
00111 #endif
00112   };
00113 
00114 #ifdef __USE_LARGEFILE64
00115 /* Note stat64 has the same shape as stat for x86-64.  */
00116 struct stat64
00117   {
00118     __dev_t st_dev;         /* Device.  */
00119 #if __WORDSIZE == 64
00120     __ino64_t st_ino;              /* File serial number.  */
00121     __nlink_t st_nlink;            /* Link count.  */
00122     __mode_t st_mode;              /* File mode.  */
00123 #else
00124     unsigned int __pad1;
00125     __ino_t __st_ino;                     /* 32bit file serial number.       */
00126     __mode_t st_mode;                     /* File mode.  */
00127     __nlink_t st_nlink;                   /* Link count.  */
00128 #endif
00129     __uid_t st_uid;         /* User ID of the file's owner.    */
00130     __gid_t st_gid;         /* Group ID of the file's group.*/
00131 #if __WORDSIZE == 64
00132     int __pad0;
00133     __dev_t st_rdev;        /* Device number, if device.  */
00134     __off_t st_size;        /* Size of file, in bytes.  */
00135 #else
00136     __dev_t st_rdev;               /* Device number, if device.  */
00137     unsigned int __pad2;
00138     __off64_t st_size;                    /* Size of file, in bytes.  */
00139 #endif
00140     __blksize_t st_blksize; /* Optimal block size for I/O.  */
00141     __blkcnt64_t st_blocks; /* Nr. 512-byte blocks allocated.  */
00142 #ifdef __USE_MISC
00143     /* Nanosecond resolution timestamps are stored in a format
00144        equivalent to 'struct timespec'.  This is the type used
00145        whenever possible but the Unix namespace rules do not allow the
00146        identifier 'timespec' to appear in the <sys/stat.h> header.
00147        Therefore we have to handle the use of this header in strictly
00148        standard-compliant sources special.  */
00149     struct timespec st_atim;              /* Time of last access.  */
00150     struct timespec st_mtim;              /* Time of last modification.  */
00151     struct timespec st_ctim;              /* Time of last status change.  */
00152 # define st_atime st_atim.tv_sec   /* Backward compatibility.  */
00153 # define st_mtime st_mtim.tv_sec
00154 # define st_ctime st_ctim.tv_sec
00155 #else
00156     __time_t st_atime;                    /* Time of last access.  */
00157     unsigned long int st_atimensec;       /* Nscecs of last access.  */
00158     __time_t st_mtime;                    /* Time of last modification.  */
00159     unsigned long int st_mtimensec;       /* Nsecs of last modification.  */
00160     __time_t st_ctime;                    /* Time of last status change.  */
00161     unsigned long int st_ctimensec;       /* Nsecs of last status change.  */
00162 #endif
00163 #if __WORDSIZE == 64
00164     long int __unused[3];
00165 #else
00166     __ino64_t st_ino;                     /* File serial number.             */
00167 #endif
00168   };
00169 #endif
00170 
00171 /* Tell code we have these members.  */
00172 #define       _STATBUF_ST_BLKSIZE
00173 #define _STATBUF_ST_RDEV
00174 /* Nanosecond resolution time values are supported.  */
00175 #define _STATBUF_ST_NSEC
00176 
00177 /* Encoding of the file mode.  */
00178 
00179 #define       __S_IFMT      0170000       /* These bits determine file type.  */
00180 
00181 /* File types.  */
00182 #define       __S_IFDIR     0040000       /* Directory.  */
00183 #define       __S_IFCHR     0020000       /* Character device.  */
00184 #define       __S_IFBLK     0060000       /* Block device.  */
00185 #define       __S_IFREG     0100000       /* Regular file.  */
00186 #define       __S_IFIFO     0010000       /* FIFO.  */
00187 #define       __S_IFLNK     0120000       /* Symbolic link.  */
00188 #define       __S_IFSOCK    0140000       /* Socket.  */
00189 
00190 /* POSIX.1b objects.  Note that these macros always evaluate to zero.  But
00191    they do it by enforcing the correct use of the macros.  */
00192 #define __S_TYPEISMQ(buf)  ((buf)->st_mode - (buf)->st_mode)
00193 #define __S_TYPEISSEM(buf) ((buf)->st_mode - (buf)->st_mode)
00194 #define __S_TYPEISSHM(buf) ((buf)->st_mode - (buf)->st_mode)
00195 
00196 /* Protection bits.  */
00197 
00198 #define       __S_ISUID     04000  /* Set user ID on execution.  */
00199 #define       __S_ISGID     02000  /* Set group ID on execution.  */
00200 #define       __S_ISVTX     01000  /* Save swapped text after use (sticky).  */
00201 #define       __S_IREAD     0400   /* Read by owner.  */
00202 #define       __S_IWRITE    0200   /* Write by owner.  */
00203 #define       __S_IEXEC     0100   /* Execute by owner.  */
00204 
00205 #if defined __USE_ATFILE || defined __USE_GNU
00206 /* XXX This will change to the macro for the next 2008 POSIX revision.  */
00207 # define UTIME_NOW   ((1l << 30) - 1l)
00208 # define UTIME_OMIT  ((1l << 30) - 2l)
00209 #endif