STAT(1) User Commands STAT(1)
NAME
stat - display file or file system status
SYNOPSIS
stat [OPTION]... FILE...
DESCRIPTION
Display file or file system status.
Mandatory arguments to long options are mandatory for short options
too.
-L, --dereference
follow links
-f, --file-system
display file system status instead of file status
--cached=MODE
specify how to use cached attributes; useful on remote file sys-
tems. See MODE below
-c --format=FORMAT
use the specified FORMAT instead of the default; output a new-
line after each use of FORMAT
--printf=FORMAT
like --format, but interpret backslash escapes, and do not out-
put a mandatory trailing newline; if you want a newline, include
\n in FORMAT
-t, --terse
print the information in terse form
--help display this help and exit
--version
output version information and exit
The --cached MODE argument can be; always, never, or default. `always`
will use cached attributes if available, while `never` will try to syn-
chronize with the latest attributes, and `default` will leave it up to
the underlying file system.
The valid format sequences for files (without --file-system):
%a access rights in octal (note '#' and '0' printf flags)
%A access rights in human readable form
%b number of blocks allocated (see %B)
%B the size in bytes of each block reported by %b
%C SELinux security context string
%d device number in decimal
%D device number in hex
%f raw mode in hex
%F file type
%g group ID of owner
%G group name of owner
%h number of hard links
%i inode number
%m mount point
%n file name
%N quoted file name with dereference if symbolic link
%o optimal I/O transfer size hint
%s total size, in bytes
%t major device type in hex, for character/block device special
files
%T minor device type in hex, for character/block device special
files
%u user ID of owner
%U user name of owner
%w time of file birth, human-readable; - if unknown
%W time of file birth, seconds since Epoch; 0 if unknown
%x time of last access, human-readable
%X time of last access, seconds since Epoch
%y time of last data modification, human-readable
%Y time of last data modification, seconds since Epoch
%z time of last status change, human-readable
%Z time of last status change, seconds since Epoch
Valid format sequences for file systems:
%a free blocks available to non-superuser
%b total data blocks in file system
%c total file nodes in file system
%d free file nodes in file system
%f free blocks in file system
%i file system ID in hex
%l maximum length of filenames
%n file name
%s block size (for faster transfers)
%S fundamental block size (for block counts)
%t file system type in hex
%T file system type in human readable form
--terse is equivalent to the following FORMAT:
%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o %C
--terse --file-system is equivalent to the following FORMAT:
%n %i %l %t %s %S %b %f %a %c %d
NOTE: your shell may have its own version of stat, which usually super-
sedes the version described here. Please refer to your shell's docu-
mentation for details about the options it supports.
AUTHOR
Written by Michael Meskes.
REPORTING BUGS
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
Report stat translation bugs to <https://translationproject.org/team/>
COPYRIGHT
Copyright (C) 2018 Free Software Foundation, Inc. License GPLv3+: GNU
GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
SEE ALSO
stat(2), statfs(2), statx(2)
Full documentation at: <https://www.gnu.org/software/coreutils/stat>
or available locally via: info '(coreutils) stat invocation'
GNU coreutils 8.30 July 2018 STAT(1)