man/stat.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH STAT "1" "March 2007" "GNU coreutils 6.9" "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 %d
  52 Device number in decimal
  53 .TP
  54 %D
  55 Device number in hex
  56 .TP
  57 %f
  58 Raw mode in hex
  59 .TP
  60 %F
  61 File type
  62 .TP
  63 %g
  64 Group ID of owner
  65 .TP
  66 %G
  67 Group name of owner
  68 .TP
  69 %h
  70 Number of hard links
  71 .TP
  72 %i
  73 Inode number
  74 .TP
  75 %n
  76 File name
  77 .TP
  78 %N
  79 Quoted file name with dereference if symbolic link
  80 .TP
  81 %o
  82 I/O block size
  83 .TP
  84 %s
  85 Total size, in bytes
  86 .TP
  87 %t
  88 Major device type in hex
  89 .TP
  90 %T
  91 Minor device type in hex
  92 .TP
  93 %u
  94 User ID of owner
  95 .TP
  96 %U
  97 User name of owner
  98 .TP
  99 %x
 100 Time of last access
 101 .TP
 102 %X
 103 Time of last access as seconds since Epoch
 104 .TP
 105 %y
 106 Time of last modification
 107 .TP
 108 %Y
 109 Time of last modification as seconds since Epoch
 110 .TP
 111 %z
 112 Time of last change
 113 .TP
 114 %Z
 115 Time of last change as seconds since Epoch
 116 .PP
 117 Valid format sequences for file systems:
 118 .TP
 119 %a
 120 Free blocks available to non\-superuser
 121 .TP
 122 %b
 123 Total data blocks in file system
 124 .TP
 125 %c
 126 Total file nodes in file system
 127 .TP
 128 %d
 129 Free file nodes in file system
 130 .TP
 131 %f
 132 Free blocks in file system
 133 .TP
 134 %i
 135 File System ID in hex
 136 .TP
 137 %l
 138 Maximum length of filenames
 139 .TP
 140 %n
 141 File name
 142 .TP
 143 %s
 144 Block size (for faster transfers)
 145 .TP
 146 %S
 147 Fundamental block size (for block counts)
 148 .TP
 149 %t
 150 Type in hex
 151 .TP
 152 %T
 153 Type in human readable form
 154 .PP
 155 NOTE: your shell may have its own version of stat, which usually supersedes
 156 the version described here.  Please refer to your shell's documentation
 157 for details about the options it supports.
 158 .SH AUTHOR
 159 Written by Michael Meskes.
 160 .SH "REPORTING BUGS"
 161 Report bugs to <bug\-coreutils@gnu.org>.
 162 .SH COPYRIGHT
 163 Copyright \(co 2007 Free Software Foundation, Inc.
 164 .br
 165 This is free software.  You may redistribute copies of it under the terms of
 166 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
 167 There is NO WARRANTY, to the extent permitted by law.
 168 .SH "SEE ALSO"
 169 stat(2)
 170 .PP
 171 The full documentation for
 172 .B stat
 173 is maintained as a Texinfo manual.  If the
 174 .B info
 175 and
 176 .B stat
 177 programs are properly installed at your site, the command
 178 .IP
 179 .B info stat
 180 .PP
 181 should give you access to the complete manual.