| 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. |