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       -L, --dereference
15              follow links
16
17       -f, --file-system
18              display file system status instead of file status
19
20       -c  --format=FORMAT
21              use  the  specified FORMAT instead of the default; output a new‐
22              line after each use of FORMAT
23
24       --printf=FORMAT
25              like --format, but interpret backslash escapes, and do not  out‐
26              put  a  mandatory  trailing  newline.   If  you  want a newline,
27              include \n in FORMAT.
28
29       -t, --terse
30              print the information in terse form
31
32       -Z, --context
33              print security context information for SELinux if available.
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       %d     Device number in decimal
51
52       %C     SELinux security context
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       %n     File name
69
70       %N     Quoted file name with dereference if symbolic link
71
72       %o     I/O block size
73
74       %s     Total size, in bytes
75
76       %t     Major device type in hex
77
78       %T     Minor device type in hex
79
80       %u     User ID of owner
81
82       %U     User name of owner
83
84       %x     Time of last access
85
86       %X     Time of last access as seconds since Epoch
87
88       %y     Time of last modification
89
90       %Y     Time of last modification as seconds since Epoch
91
92       %z     Time of last change
93
94       %Z     Time of last change as seconds since Epoch
95
96       Valid format sequences for file systems:
97
98       %a     Free blocks available to non-superuser
99
100       %b     Total data blocks in file system
101
102       %c     Total file nodes in file system
103
104       %d     Free file nodes in file system
105
106       %f     Free blocks in file system
107
108       %i     File System ID in hex
109
110       %l     Maximum length of filenames
111
112       %n     File name
113
114       %s     Block size (for faster transfers)
115
116       %S     Fundamental block size (for block counts)
117
118       %t     Type in hex
119
120       %T     Type in human readable form
121
122       NOTE: your shell may have its own version of stat, which usually super‐
123       sedes  the  version described here.  Please refer to your shell's docu‐
124       mentation for details about the options it supports.
125

AUTHOR

127       Written by Michael Meskes.
128

REPORTING BUGS

130       Report bugs to <bug-coreutils@gnu.org>.
131

133       Copyright © 2007 Free Software Foundation, Inc.
134       This is free software.  You may redistribute copies  of  it  under  the
135       terms       of       the      GNU      General      Public      License
136       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY,  to  the
137       extent permitted by law.
138

SEE ALSO

140       stat(2)
141
142       The  full documentation for stat is maintained as a Texinfo manual.  If
143       the info and stat programs are properly installed  at  your  site,  the
144       command
145
146              info stat
147
148       should give you access to the complete manual.
149
150
151
152GNU coreutils 6.9                 March 2007                           STAT(1)
Impressum