1STAT(1)                          User Commands                         STAT(1)
2
3
4

NAME

6       stat - display file or file system status
7

SYNOPSIS

9       stat [OPTION]... FILE...
10

DESCRIPTION

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

AUTHOR

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

SEE ALSO

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)
Impressum