fdwalk should return 0 on an empty directory
[kopensolaris-gnu/glibc.git] / 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