~ubuntu-branches/ubuntu/utopic/coreutils/utopic-proposed

« back to all changes in this revision

Viewing changes to man/stat.1

  • Committer: Colin Watson
  • Date: 2013-10-30 15:48:33 UTC
  • mfrom: (8.3.5 sid)
  • Revision ID: cjwatson@canonical.com-20131030154833-xdt6e1yfffqom1c4
merge from Debian 8.21-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2
 
.TH STAT "1" "October 2012" "GNU coreutils 8.20" "User Commands"
3
 
.SH NAME
4
 
stat \- display file or file system status
5
 
.SH SYNOPSIS
6
 
.B stat
7
 
[\fIOPTION\fR]... \fIFILE\fR...
8
 
.SH DESCRIPTION
9
 
.\" Add any additional description here
10
 
.PP
11
 
Display file or file system status.
12
 
.TP
13
 
\fB\-L\fR, \fB\-\-dereference\fR
14
 
follow links
15
 
.TP
16
 
\fB\-f\fR, \fB\-\-file\-system\fR
17
 
display file system status instead of file status
18
 
.TP
19
 
\fB\-c\fR  \fB\-\-format\fR=\fIFORMAT\fR
20
 
use the specified FORMAT instead of the default;
21
 
output a newline after each use of FORMAT
22
 
.TP
23
 
\fB\-\-printf\fR=\fIFORMAT\fR
24
 
like \fB\-\-format\fR, but interpret backslash escapes,
25
 
and do not output a mandatory trailing newline.
26
 
If you want a newline, include \en in FORMAT
27
 
.TP
28
 
\fB\-t\fR, \fB\-\-terse\fR
29
 
print the information in terse form
30
 
.TP
31
 
\fB\-\-help\fR
32
 
display this help and exit
33
 
.TP
34
 
\fB\-\-version\fR
35
 
output version information and exit
36
 
.PP
37
 
The valid format sequences for files (without \fB\-\-file\-system\fR):
38
 
.TP
39
 
%a
40
 
access rights in octal
41
 
.TP
42
 
%A
43
 
access rights in human readable form
44
 
.TP
45
 
%b
46
 
number of blocks allocated (see %B)
47
 
.TP
48
 
%B
49
 
the size in bytes of each block reported by %b
50
 
.TP
51
 
%C
52
 
SELinux security context string
53
 
.TP
54
 
%d
55
 
device number in decimal
56
 
.TP
57
 
%D
58
 
device number in hex
59
 
.TP
60
 
%f
61
 
raw mode in hex
62
 
.TP
63
 
%F
64
 
file type
65
 
.TP
66
 
%g
67
 
group ID of owner
68
 
.TP
69
 
%G
70
 
group name of owner
71
 
.TP
72
 
%h
73
 
number of hard links
74
 
.TP
75
 
%i
76
 
inode number
77
 
.TP
78
 
%m
79
 
mount point
80
 
.TP
81
 
%n
82
 
file name
83
 
.TP
84
 
%N
85
 
quoted file name with dereference if symbolic link
86
 
.TP
87
 
%o
88
 
optimal I/O transfer size hint
89
 
.TP
90
 
%s
91
 
total size, in bytes
92
 
.TP
93
 
%t
94
 
major device type in hex
95
 
.TP
96
 
%T
97
 
minor device type in hex
98
 
.TP
99
 
%u
100
 
user ID of owner
101
 
.TP
102
 
%U
103
 
user name of owner
104
 
.TP
105
 
%w
106
 
time of file birth, human\-readable; \- if unknown
107
 
.TP
108
 
%W
109
 
time of file birth, seconds since Epoch; 0 if unknown
110
 
.TP
111
 
%x
112
 
time of last access, human\-readable
113
 
.TP
114
 
%X
115
 
time of last access, seconds since Epoch
116
 
.TP
117
 
%y
118
 
time of last modification, human\-readable
119
 
.TP
120
 
%Y
121
 
time of last modification, seconds since Epoch
122
 
.TP
123
 
%z
124
 
time of last change, human\-readable
125
 
.TP
126
 
%Z
127
 
time of last change, seconds since Epoch
128
 
.PP
129
 
Valid format sequences for file systems:
130
 
.TP
131
 
%a
132
 
free blocks available to non\-superuser
133
 
.TP
134
 
%b
135
 
total data blocks in file system
136
 
.TP
137
 
%c
138
 
total file nodes in file system
139
 
.TP
140
 
%d
141
 
free file nodes in file system
142
 
.TP
143
 
%f
144
 
free blocks in file system
145
 
.TP
146
 
%i
147
 
file system ID in hex
148
 
.TP
149
 
%l
150
 
maximum length of filenames
151
 
.TP
152
 
%n
153
 
file name
154
 
.TP
155
 
%s
156
 
block size (for faster transfers)
157
 
.TP
158
 
%S
159
 
fundamental block size (for block counts)
160
 
.TP
161
 
%t
162
 
file system type in hex
163
 
.TP
164
 
%T
165
 
file system type in human readable form
166
 
.PP
167
 
NOTE: your shell may have its own version of stat, which usually supersedes
168
 
the version described here.  Please refer to your shell's documentation
169
 
for details about the options it supports.
170
 
.SH AUTHOR
171
 
Written by Michael Meskes.
172
 
.SH "REPORTING BUGS"
173
 
Report stat bugs to bug\-coreutils@gnu.org
174
 
.br
175
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
176
 
.br
177
 
General help using GNU software: <http://www.gnu.org/gethelp/>
178
 
.br
179
 
Report stat translation bugs to <http://translationproject.org/team/>
180
 
.SH COPYRIGHT
181
 
Copyright \(co 2012 Free Software Foundation, Inc.
182
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
183
 
.br
184
 
This is free software: you are free to change and redistribute it.
185
 
There is NO WARRANTY, to the extent permitted by law.
186
 
.SH "SEE ALSO"
187
 
stat(2)
188
 
.PP
189
 
The full documentation for
190
 
.B stat
191
 
is maintained as a Texinfo manual.  If the
192
 
.B info
193
 
and
194
 
.B stat
195
 
programs are properly installed at your site, the command
196
 
.IP
197
 
.B info coreutils \(aqstat invocation\(aq
198
 
.PP
199
 
should give you access to the complete manual.