Back to index

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