]>
Commit | Line | Data |
---|---|---|
04277e02 | 1 | /* Copyright (C) 1992-2019 Free Software Foundation, Inc. |
54d79e99 | 2 | This file is part of the GNU C Library. |
28f540f4 | 3 | |
54d79e99 | 4 | The GNU C Library is free software; you can redistribute it and/or |
41bdb6e2 AJ |
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. | |
28f540f4 | 8 | |
54d79e99 UD |
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 | |
41bdb6e2 | 12 | Lesser General Public License for more details. |
28f540f4 | 13 | |
41bdb6e2 | 14 | You should have received a copy of the GNU Lesser General Public |
59ba27a6 | 15 | License along with the GNU C Library; if not, see |
5a82c748 | 16 | <https://www.gnu.org/licenses/>. */ |
28f540f4 | 17 | |
f095bb72 | 18 | #if !defined _SYS_STAT_H && !defined _FCNTL_H |
f4017d20 UD |
19 | # error "Never include <bits/stat.h> directly; use <sys/stat.h> instead." |
20 | #endif | |
28f540f4 | 21 | |
64c1f3af UD |
22 | #ifndef _BITS_STAT_H |
23 | #define _BITS_STAT_H 1 | |
24 | ||
5107cf1d | 25 | #include <bits/types.h> |
28f540f4 RM |
26 | |
27 | /* NOTE: The size of this structure (32 ints) is known in | |
28 | <hurd/hurd_types.defs>, since it is used in the `io_stat' RPC. MiG | |
29 | does not cope at all well with the passed C structure not being of | |
30 | the expected size. There are some filler words at the end to allow | |
31 | for future expansion. To increase the size of the structure used | |
32 | in the RPC and retain binary compatibility, we would need to assign | |
33 | a new message number. */ | |
34 | ||
35 | struct stat | |
36 | { | |
37 | int st_fstype; /* File system type. */ | |
38 | __fsid_t st_fsid; /* File system ID. */ | |
39 | #define st_dev st_fsid | |
40 | ||
dfd2257a | 41 | #ifndef __USE_FILE_OFFSET64 |
28f540f4 | 42 | __ino_t st_ino; /* File number. */ |
dfd2257a UD |
43 | #else |
44 | __ino64_t st_ino; /* File number. */ | |
45 | #endif | |
28f540f4 RM |
46 | unsigned int st_gen; /* To detect reuse of file numbers. */ |
47 | __dev_t st_rdev; /* Device if special file. */ | |
48 | __mode_t st_mode; /* File mode. */ | |
49 | __nlink_t st_nlink; /* Number of links. */ | |
50 | ||
51 | __uid_t st_uid; /* Owner. */ | |
52 | __gid_t st_gid; /* Owning group. */ | |
53 | ||
dfd2257a | 54 | #ifndef __USE_FILE_OFFSET64 |
28f540f4 | 55 | __off_t st_size; /* Size in bytes. */ |
dfd2257a UD |
56 | #else |
57 | __off64_t st_size; /* Size in bytes. */ | |
58 | #endif | |
28f540f4 | 59 | |
acd7f096 | 60 | #ifdef __USE_XOPEN2K8 |
8e41b99f TS |
61 | /* Nanosecond resolution timestamps are stored in a format |
62 | equivalent to 'struct timespec'. This is the type used | |
63 | whenever possible but the Unix namespace rules do not allow the | |
64 | identifier 'timespec' to appear in the <sys/stat.h> header. | |
65 | Therefore we have to handle the use of this header in strictly | |
66 | standard-compliant sources special. */ | |
67 | struct timespec st_atim; /* Time of last access. */ | |
68 | struct timespec st_mtim; /* Time of last modification. */ | |
69 | struct timespec st_ctim; /* Time of last status change. */ | |
70 | # define st_atime st_atim.tv_sec /* Backward compatibility. */ | |
71 | # define st_mtime st_mtim.tv_sec | |
72 | # define st_ctime st_ctim.tv_sec | |
73 | #else | |
74 | __time_t st_atime; /* Time of last access. */ | |
75 | unsigned long int st_atimensec; /* Nscecs of last access. */ | |
76 | __time_t st_mtime; /* Time of last modification. */ | |
77 | unsigned long int st_mtimensec; /* Nsecs of last modification. */ | |
78 | __time_t st_ctime; /* Time of last status change. */ | |
79 | unsigned long int st_ctimensec; /* Nsecs of last status change. */ | |
80 | #endif | |
28f540f4 | 81 | |
219aa9e9 | 82 | __blksize_t st_blksize; /* Optimal size for I/O. */ |
28f540f4 | 83 | |
dfd2257a UD |
84 | #ifndef __USE_FILE_OFFSET64 |
85 | __blkcnt_t st_blocks; /* Number of 512-byte blocks allocated. | |
86 | Not related to `st_blksize'. */ | |
87 | #else | |
88 | __blkcnt64_t st_blocks; /* Number of 512-byte blocks allocated. | |
89 | Not related to `st_blksize'. */ | |
90 | #endif | |
91 | ||
92 | __uid_t st_author; /* File author. */ | |
93 | ||
94 | unsigned int st_flags; /* User-defined flags. | |
95 | High 16 bits can be set only by root. */ | |
96 | ||
97 | #ifndef __USE_FILE_OFFSET64 | |
98 | # define _SPARE_SIZE ((sizeof (__fsid_t) == sizeof (int)) ? 12 : 11) | |
99 | #else | |
100 | # define _SPARE_SIZE ((sizeof (__fsid_t) == sizeof (int)) ? 9 : 8) | |
101 | #endif | |
102 | int st_spare[_SPARE_SIZE]; /* Room for future expansion. */ | |
103 | #undef _SPARE_SIZE | |
104 | }; | |
105 | ||
106 | #ifdef __USE_LARGEFILE64 | |
107 | struct stat64 | |
108 | { | |
109 | int st_fstype; /* File system type. */ | |
110 | __fsid_t st_fsid; /* File system ID. */ | |
111 | # define st_dev st_fsid | |
112 | ||
113 | __ino64_t st_ino; /* File number. */ | |
114 | unsigned int st_gen; /* To detect reuse of file numbers. */ | |
115 | __dev_t st_rdev; /* Device if special file. */ | |
116 | __mode_t st_mode; /* File mode. */ | |
117 | __nlink_t st_nlink; /* Number of links. */ | |
118 | ||
119 | __uid_t st_uid; /* Owner. */ | |
120 | __gid_t st_gid; /* Owning group. */ | |
121 | ||
122 | __off64_t st_size; /* Size in bytes. */ | |
123 | ||
acd7f096 | 124 | #ifdef __USE_XOPEN2K8 |
8e41b99f TS |
125 | /* Nanosecond resolution timestamps are stored in a format |
126 | equivalent to 'struct timespec'. This is the type used | |
127 | whenever possible but the Unix namespace rules do not allow the | |
128 | identifier 'timespec' to appear in the <sys/stat.h> header. | |
129 | Therefore we have to handle the use of this header in strictly | |
130 | standard-compliant sources special. */ | |
131 | struct timespec st_atim; /* Time of last access. */ | |
132 | struct timespec st_mtim; /* Time of last modification. */ | |
133 | struct timespec st_ctim; /* Time of last status change. */ | |
134 | #else | |
135 | __time_t st_atime; /* Time of last access. */ | |
136 | unsigned long int st_atimensec; /* Nscecs of last access. */ | |
137 | __time_t st_mtime; /* Time of last modification. */ | |
138 | unsigned long int st_mtimensec; /* Nsecs of last modification. */ | |
139 | __time_t st_ctime; /* Time of last status change. */ | |
140 | unsigned long int st_ctimensec; /* Nsecs of last status change. */ | |
141 | #endif | |
28f540f4 | 142 | |
219aa9e9 | 143 | __blksize_t st_blksize; /* Optimal size for I/O. */ |
dfd2257a UD |
144 | |
145 | __blkcnt64_t st_blocks; /* Number of 512-byte blocks allocated. | |
28f540f4 RM |
146 | Not related to `st_blksize'. */ |
147 | ||
148 | __uid_t st_author; /* File author. */ | |
149 | ||
150 | unsigned int st_flags; /* User-defined flags. | |
151 | High 16 bits can be set only by root. */ | |
152 | ||
dfd2257a | 153 | #define _SPARE_SIZE ((sizeof (__fsid_t) == sizeof (int)) ? 9 : 8) |
5107cf1d UD |
154 | int st_spare[_SPARE_SIZE]; /* Room for future expansion. */ |
155 | #undef _SPARE_SIZE | |
28f540f4 | 156 | }; |
dfd2257a UD |
157 | #endif |
158 | ||
8e41b99f TS |
159 | /* Tell code we have these members. */ |
160 | #define _STATBUF_ST_BLKSIZE | |
161 | /* Nanosecond resolution time values are supported. */ | |
162 | #define _STATBUF_ST_NSEC | |
28f540f4 RM |
163 | |
164 | /* Encoding of the file mode. */ | |
165 | ||
166 | #define __S_IFMT 0170000 /* These bits determine file type. */ | |
167 | ||
168 | /* File types. */ | |
169 | #define __S_IFDIR 0040000 /* Directory. */ | |
170 | #define __S_IFCHR 0020000 /* Character device. */ | |
171 | #define __S_IFBLK 0060000 /* Block device. */ | |
172 | #define __S_IFREG 0100000 /* Regular file. */ | |
173 | #define __S_IFLNK 0120000 /* Symbolic link. */ | |
174 | #define __S_IFSOCK 0140000 /* Socket. */ | |
175 | #define __S_IFIFO 0010000 /* FIFO. */ | |
176 | ||
2fcbf75b UD |
177 | /* POSIX.1b objects. */ |
178 | #define __S_TYPEISMQ(buf) (0) | |
179 | #define __S_TYPEISSEM(buf) (0) | |
180 | #define __S_TYPEISSHM(buf) (0) | |
181 | ||
28f540f4 RM |
182 | /* Protection bits. */ |
183 | ||
184 | #define __S_ISUID 04000 /* Set user ID on execution. */ | |
185 | #define __S_ISGID 02000 /* Set group ID on execution. */ | |
186 | #define __S_ISVTX 01000 /* Save swapped text after use (sticky). */ | |
187 | #define __S_IREAD 00400 /* Read by owner. */ | |
188 | #define __S_IWRITE 00200 /* Write by owner. */ | |
189 | #define __S_IEXEC 00100 /* Execute by owner. */ | |
190 | ||
191 | ||
192 | #ifdef __USE_GNU | |
193 | /* If set, there is no benefit in caching the contents of this file. */ | |
194 | #define S_INOCACHE 000000200000 | |
195 | ||
196 | /* If the S_IUSEUNK bit is set, then the S_IUNKNOWN bits (see below) | |
197 | control access for unknown users. If S_IUSEUNK is clear, then unknown | |
198 | users are treated as "others" for purposes of access control. */ | |
199 | #define S_IUSEUNK 000000400000 | |
200 | /* Mask of protection bits for unknown users (no effective IDs at all). */ | |
201 | #define S_IUNKNOWN 000007000000 | |
202 | /* Shift S_IREAD, S_IWRITE, S_IEXEC left this many bits to produce the | |
203 | protection bits for unknown users. */ | |
204 | #define S_IUNKSHIFT 12 | |
205 | ||
ebe3b3eb TBB |
206 | /* Read only bits: */ |
207 | ||
208 | /* There is a passive translator set for this file */ | |
209 | #define S_IPTRANS 000010000000 | |
210 | /* There is an active translator running on this file */ | |
211 | #define S_IATRANS 000020000000 | |
212 | /* This is the root of a filesystem (or single node translator) */ | |
213 | #define S_IROOT 000040000000 | |
214 | /* All the bits relevant to translators */ | |
215 | #define S_ITRANS 000070000000 | |
216 | ||
ce306528 RM |
217 | /* Definitely no mmaps to this. */ |
218 | #define S_IMMAP0 000100000000 | |
219 | ||
ebe3b3eb | 220 | /* ALL the unused bits. */ |
a04549c1 JM |
221 | #define S_ISPARE (~(S_IFMT|S_ITRANS|S_INOCACHE|S_IMMAP0 \ |
222 | |S_IUSEUNK|S_IUNKNOWN|07777)) | |
28f540f4 RM |
223 | #endif |
224 | ||
498afc54 | 225 | #ifdef __USE_MISC |
5d2556c4 | 226 | /* Default file creation mask (umask). */ |
64c1f3af | 227 | # define CMASK 0022 |
5d2556c4 ST |
228 | |
229 | /* Definitions of flags stored in file flags word. */ | |
230 | ||
231 | /* Super-user and owner changeable flags. */ | |
232 | # define UF_SETTABLE 0x0000ffff /* mask of owner changeable flags */ | |
233 | # define UF_NODUMP 0x00000001 /* do not dump file */ | |
234 | # define UF_IMMUTABLE 0x00000002 /* file may not be changed */ | |
235 | # define UF_APPEND 0x00000004 /* writes to file may only append */ | |
236 | # define UF_OPAQUE 0x00000008 /* directory is opaque wrt. union */ | |
237 | # define UF_NOUNLINK 0x00000010 /* file may not be removed or renamed */ | |
238 | ||
239 | /* Super-user changeable flags. */ | |
240 | # define SF_SETTABLE 0xffff0000 /* mask of superuser changeable flags */ | |
241 | # define SF_ARCHIVED 0x00010000 /* file is archived */ | |
242 | # define SF_IMMUTABLE 0x00020000 /* file may not be changed */ | |
243 | # define SF_APPEND 0x00040000 /* writes to file may only append */ | |
244 | # define SF_NOUNLINK 0x00100000 /* file may not be removed or renamed */ | |
245 | # define SF_SNAPSHOT 0x00200000 /* snapshot inode */ | |
246 | ||
247 | __BEGIN_DECLS | |
248 | ||
249 | /* Set file flags for FILE to FLAGS. */ | |
250 | extern int chflags (__const char *__file, unsigned long int __flags) __THROW; | |
251 | ||
252 | /* Set file flags of the file referred to by FD to FLAGS. */ | |
253 | extern int fchflags (int __fd, unsigned long int __flags) __THROW; | |
254 | ||
255 | __END_DECLS | |
28f540f4 | 256 | #endif |
64c1f3af | 257 | |
fa9e1555 ST |
258 | #ifdef __USE_ATFILE |
259 | # define UTIME_NOW -1 /* corresponds to the current time */ | |
260 | # define UTIME_OMIT -2 /* target time is omitted */ | |
261 | #endif | |
262 | ||
64c1f3af | 263 | #endif /* bits/stat.h */ |