1STAT(1) User Commands STAT(1)
2
3
4
6 stat - display file or file system status
7
9 stat [OPTION]... FILE...
10
12 Display file or file system status.
13
14 Mandatory arguments to long options are mandatory for short options
15 too.
16
17 -L, --dereference
18 follow links
19
20 -f, --file-system
21 display file system status instead of file status
22
23 -c --format=FORMAT
24 use the specified FORMAT instead of the default; output a new‐
25 line after each use of FORMAT
26
27 --printf=FORMAT
28 like --format, but interpret backslash escapes, and do not out‐
29 put a mandatory trailing newline; if you want a newline, include
30 \n in FORMAT
31
32 -t, --terse
33 print the information in terse form
34
35 --help display this help and exit
36
37 --version
38 output version information and exit
39
40 The valid format sequences for files (without --file-system):
41
42 %a access rights in octal
43
44 %A access rights in human readable form
45
46 %b number of blocks allocated (see %B)
47
48 %B the size in bytes of each block reported by %b
49
50 %C SELinux security context string
51
52 %d device number in decimal
53
54 %D device number in hex
55
56 %f raw mode in hex
57
58 %F file type
59
60 %g group ID of owner
61
62 %G group name of owner
63
64 %h number of hard links
65
66 %i inode number
67
68 %m mount point
69
70 %n file name
71
72 %N quoted file name with dereference if symbolic link
73
74 %o optimal I/O transfer size hint
75
76 %s total size, in bytes
77
78 %t major device type in hex, for character/block device special
79 files
80
81 %T minor device type in hex, for character/block device special
82 files
83
84 %u user ID of owner
85
86 %U user name of owner
87
88 %w time of file birth, human-readable; - if unknown
89
90 %W time of file birth, seconds since Epoch; 0 if unknown
91
92 %x time of last access, human-readable
93
94 %X time of last access, seconds since Epoch
95
96 %y time of last modification, human-readable
97
98 %Y time of last modification, seconds since Epoch
99
100 %z time of last change, human-readable
101
102 %Z time of last change, seconds since Epoch
103
104 Valid format sequences for file systems:
105
106 %a free blocks available to non-superuser
107
108 %b total data blocks in file system
109
110 %c total file nodes in file system
111
112 %d free file nodes in file system
113
114 %f free blocks in file system
115
116 %i file system ID in hex
117
118 %l maximum length of filenames
119
120 %n file name
121
122 %s block size (for faster transfers)
123
124 %S fundamental block size (for block counts)
125
126 %t file system type in hex
127
128 %T file system type in human readable form
129
130 NOTE: your shell may have its own version of stat, which usually super‐
131 sedes the version described here. Please refer to your shell's docu‐
132 mentation for details about the options it supports.
133
134 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
135 Report stat translation bugs to <http://translationproject.org/team/>
136
138 Written by Michael Meskes.
139
141 Copyright © 2013 Free Software Foundation, Inc. License GPLv3+: GNU
142 GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
143 This is free software: you are free to change and redistribute it.
144 There is NO WARRANTY, to the extent permitted by law.
145
147 stat(2)
148
149 The full documentation for stat is maintained as a Texinfo manual. If
150 the info and stat programs are properly installed at your site, the
151 command
152
153 info coreutils 'stat invocation'
154
155 should give you access to the complete manual.
156
157
158
159GNU coreutils 8.22 October 2018 STAT(1)