Debian Codegraph @

upstream/debian-unstable/man1/stat.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH STAT "1" "February 2026" "GNU coreutils 9.10" "User Commands"
3 .SH NAME
4 stat \- display file or file system status
5 .SH SYNOPSIS
6 .B stat
7 [\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 .PP
11 Display file or file system status.
12 .PP
13 Mandatory arguments to long options are mandatory for short options too.
14 .TP
15 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat-L'\fB\-L, \-\-dereference\fP\X'tty: link'
16 follow links
17 .TP
18 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat-f'\fB\-f, \-\-file\-system\fP\X'tty: link'
19 display file system status instead of file status
20 .TP
21 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat--cached'\fB\-\-cached=MODE\fP\X'tty: link'
22 specify how to use cached attributes;
23 useful on remote file systems. See MODE below
24 .TP
25 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat-c'\fB\-c, \-\-format=\,FORMAT\fP\X'tty: link'\/\fR
26 use the specified FORMAT instead of the default;
27 output a newline after each use of FORMAT
28 .TP
29 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat--printf'\fB\-\-printf=FORMAT\fP\X'tty: link'
30 like \fB\-\-format\fR, but interpret backslash escapes,
31 and do not output a mandatory trailing newline;
32 if you want a newline, include \en in FORMAT
33 .TP
34 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#stat-t'\fB\-t, \-\-terse\fP\X'tty: link'
35 print the information in terse form
36 .TP
37 \X'tty: link https://www.gnu.org/software/coreutils/stat#stat--help'\fB\-\-help\fP\X'tty: link'
38 display this help and exit
39 .TP
40 \X'tty: link https://www.gnu.org/software/coreutils/stat#stat--version'\fB\-\-version\fP\X'tty: link'
41 output version information and exit
42 .PP
43 The MODE argument of \fB\-\-cached\fR can be: always, never, or default.
44 \&'always' will use cached attributes if available, while
45 \&'never' will try to synchronize with the latest attributes, and
46 \&'default' will leave it up to the underlying file system.
47 .PP
48 The valid format sequences for files (without \fB\-\-file\-system\fR):
49 .TP
50 %a
51 permission bits in octal (see '#' and '0' printf flags)
52 .TP
53 %A
54 permission bits and file type in human readable form
55 .TP
56 %b
57 number of blocks allocated (see %B)
58 .TP
59 %B
60 the size in bytes of each block reported by %b
61 .TP
62 %C
63 SELinux security context string
64 .TP
65 %d
66 device number in decimal (st_dev)
67 .TP
68 %D
69 device number in hex (st_dev)
70 .TP
71 %Hd
72 major device number in decimal
73 .TP
74 %Ld
75 minor device number in decimal
76 .TP
77 %f
78 raw mode in hex
79 .TP
80 %F
81 file type
82 .TP
83 %g
84 group ID of owner
85 .TP
86 %G
87 group name of owner
88 .TP
89 %h
90 number of hard links
91 .TP
92 %i
93 inode number
94 .TP
95 %m
96 mount point
97 .TP
98 %n
99 file name
100 .TP
101 %N
102 quoted file name with dereference if symbolic link
103 .TP
104 %o
105 optimal I/O transfer size hint
106 .TP
107 %s
108 total size, in bytes
109 .TP
110 %r
111 device type in decimal (st_rdev)
112 .TP
113 %R
114 device type in hex (st_rdev)
115 .TP
116 %Hr
117 major device type in decimal, for character/block device special files
118 .TP
119 %Lr
120 minor device type in decimal, for character/block device special files
121 .TP
122 %t
123 major device type in hex, for character/block device special files
124 .TP
125 %T
126 minor device type in hex, for character/block device special files
127 .TP
128 %u
129 user ID of owner
130 .TP
131 %U
132 user name of owner
133 .TP
134 %w
135 time of file birth, human\-readable; \- if unknown
136 .TP
137 %W
138 time of file birth, seconds since Epoch; 0 if unknown
139 .TP
140 %x
141 time of last access, human\-readable
142 .TP
143 %X
144 time of last access, seconds since Epoch
145 .TP
146 %y
147 time of last data modification, human\-readable
148 .TP
149 %Y
150 time of last data modification, seconds since Epoch
151 .TP
152 %z
153 time of last status change, human\-readable
154 .TP
155 %Z
156 time of last status change, seconds since Epoch
157 .PP
158 Valid format sequences for file systems:
159 .TP
160 %a
161 free blocks available to non\-superuser
162 .TP
163 %b
164 total data blocks in file system
165 .TP
166 %c
167 total file nodes in file system
168 .TP
169 %d
170 free file nodes in file system
171 .TP
172 %f
173 free blocks in file system
174 .TP
175 %i
176 file system ID in hex
177 .TP
178 %l
179 maximum length of filenames
180 .TP
181 %n
182 file name
183 .TP
184 %s
185 block size (for faster transfers)
186 .TP
187 %S
188 fundamental block size (for block counts)
189 .TP
190 %t
191 file system type in hex
192 .TP
193 %T
194 file system type in human readable form
195 .SS "--terse is equivalent to the following FORMAT:"
196 .IP
197 %n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o %C
198 .SS "--terse --file-system is equivalent to the following FORMAT:"
199 .IP
200 %n %i %l %t %s %S %b %f %a %c %d
201 .PP
202 Your shell may have its own version of stat, which usually supersedes
203 the version described here. Please refer to your shell's documentation
204 for details about the options it supports.
205 .SH AUTHOR
206 Written by Michael Meskes.
207 .SH "REPORTING BUGS"
208 Report bugs to: bug\[email protected]
209 .br
210 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
211 .br
212 General help using GNU software: <https://www.gnu.org/gethelp/>
213 .br
214 Report any translation bugs to <https://translationproject.org/team/>
215 .SH "SEE ALSO"
216 \fBstat\fP(2), \fBstatfs\fP(2), \fBstatx\fP(2)
217 .PP
218 .br
219 Full documentation <https://www.gnu.org/software/coreutils/stat>
220 .br
221 or available locally via: info \(aq(coreutils) stat invocation\(aq
222 .PP
223 .br
224 Packaged by Debian (9.10\-1)
225 .br
226 Copyright \(co 2026 Free Software Foundation, Inc.
227 .br
228 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
229 .br
230 This is free software: you are free to change and redistribute it.
231 .br
232 There is NO WARRANTY, to the extent permitted by law.