original/man1/stat.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH STAT "1" "March 2012" "GNU coreutils 8.16" "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.