master
1/* Definition for struct stat.
2 Copyright (C) 2020-2025 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
4
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
9
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
14
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library. If not, see
17 <https://www.gnu.org/licenses/>. */
18
19#if !defined _SYS_STAT_H && !defined _FCNTL_H
20# error "Never include <bits/struct_stat.h> directly; use <sys/stat.h> instead."
21#endif
22
23#ifndef _BITS_STRUCT_STAT_H
24#define _BITS_STRUCT_STAT_H 1
25
26struct stat
27 {
28#ifdef __USE_TIME64_REDIRECTS
29# include <bits/struct_stat_time64_helper.h>
30#else
31 __dev_t st_dev; /* Device. */
32 unsigned short int __pad1;
33# ifndef __USE_FILE_OFFSET64
34 __ino_t st_ino; /* File serial number. */
35# else
36 __ino_t __st_ino; /* 32bit file serial number. */
37# endif
38 __mode_t st_mode; /* File mode. */
39 __nlink_t st_nlink; /* Link count. */
40 __uid_t st_uid; /* User ID of the file's owner. */
41 __gid_t st_gid; /* Group ID of the file's group.*/
42 __dev_t st_rdev; /* Device number, if device. */
43 unsigned short int __pad2;
44# ifndef __USE_FILE_OFFSET64
45 __off_t st_size; /* Size of file, in bytes. */
46# else
47 __off64_t st_size; /* Size of file, in bytes. */
48# endif
49 __blksize_t st_blksize; /* Optimal block size for I/O. */
50
51# ifndef __USE_FILE_OFFSET64
52 __blkcnt_t st_blocks; /* Number 512-byte blocks allocated. */
53# else
54 __blkcnt64_t st_blocks; /* Number 512-byte blocks allocated. */
55# endif
56# ifdef __USE_XOPEN2K8
57 /* Nanosecond resolution timestamps are stored in a format
58 equivalent to 'struct timespec'. This is the type used
59 whenever possible but the Unix namespace rules do not allow the
60 identifier 'timespec' to appear in the <sys/stat.h> header.
61 Therefore we have to handle the use of this header in strictly
62 standard-compliant sources special. */
63 struct timespec st_atim; /* Time of last access. */
64 struct timespec st_mtim; /* Time of last modification. */
65 struct timespec st_ctim; /* Time of last status change. */
66# define st_atime st_atim.tv_sec /* Backward compatibility. */
67# define st_mtime st_mtim.tv_sec
68# define st_ctime st_ctim.tv_sec
69# else
70 __time_t st_atime; /* Time of last access. */
71 unsigned long int st_atimensec; /* Nscecs of last access. */
72 __time_t st_mtime; /* Time of last modification. */
73 unsigned long int st_mtimensec; /* Nsecs of last modification. */
74 __time_t st_ctime; /* Time of last status change. */
75 unsigned long int st_ctimensec; /* Nsecs of last status change. */
76# endif
77# ifndef __USE_FILE_OFFSET64
78 unsigned long int __glibc_reserved4;
79 unsigned long int __glibc_reserved5;
80# else
81 __ino64_t st_ino; /* File serial number. */
82# endif
83#endif /* __USE_TIME64_REDIRECTS */
84 };
85
86#ifdef __USE_LARGEFILE64
87struct stat64
88 {
89# ifdef __USE_TIME64_REDIRECTS
90# include <bits/struct_stat_time64_helper.h>
91# else
92 __dev_t st_dev; /* Device. */
93 unsigned short int __pad1;
94
95 __ino_t __st_ino; /* 32bit file serial number. */
96 __mode_t st_mode; /* File mode. */
97 __nlink_t st_nlink; /* Link count. */
98 __uid_t st_uid; /* User ID of the file's owner. */
99 __gid_t st_gid; /* Group ID of the file's group.*/
100 __dev_t st_rdev; /* Device number, if device. */
101 unsigned short int __pad2;
102 __off64_t st_size; /* Size of file, in bytes. */
103 __blksize_t st_blksize; /* Optimal block size for I/O. */
104
105 __blkcnt64_t st_blocks; /* Number 512-byte blocks allocated. */
106# ifdef __USE_XOPEN2K8
107 /* Nanosecond resolution timestamps are stored in a format
108 equivalent to 'struct timespec'. This is the type used
109 whenever possible but the Unix namespace rules do not allow the
110 identifier 'timespec' to appear in the <sys/stat.h> header.
111 Therefore we have to handle the use of this header in strictly
112 standard-compliant sources special. */
113 struct timespec st_atim; /* Time of last access. */
114 struct timespec st_mtim; /* Time of last modification. */
115 struct timespec st_ctim; /* Time of last status change. */
116# else
117 __time_t st_atime; /* Time of last access. */
118 unsigned long int st_atimensec; /* Nscecs of last access. */
119 __time_t st_mtime; /* Time of last modification. */
120 unsigned long int st_mtimensec; /* Nsecs of last modification. */
121 __time_t st_ctime; /* Time of last status change. */
122 unsigned long int st_ctimensec; /* Nsecs of last status change. */
123# endif
124 __ino64_t st_ino; /* File serial number. */
125# endif /* __USE_TIME64_REDIRECTS */
126 };
127#endif
128
129/* Tell code we have these members. */
130#define _STATBUF_ST_BLKSIZE
131#define _STATBUF_ST_RDEV
132/* Nanosecond resolution time values are supported. */
133#define _STATBUF_ST_NSEC
134
135#endif /* _BITS_STRUCT_STAT_H */