original/man1/stat.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH STAT "1" "April 2010" "GNU coreutils 8.5" "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 %n
  79 File name
  80 .TP
  81 %N
  82 Quoted file name with dereference if symbolic link
  83 .TP
  84 %o
  85 I/O block size
  86 .TP
  87 %s
  88 Total size, in bytes
  89 .TP
  90 %t
  91 Major device type in hex
  92 .TP
  93 %T
  94 Minor device type in hex
  95 .TP
  96 %u
  97 User ID of owner
  98 .TP
  99 %U
 100 User name of owner
 101 .TP
 102 %x
 103 Time of last access
 104 .TP
 105 %X
 106 Time of last access as seconds since Epoch
 107 .TP
 108 %y
 109 Time of last modification
 110 .TP
 111 %Y
 112 Time of last modification as seconds since Epoch
 113 .TP
 114 %z
 115 Time of last change
 116 .TP
 117 %Z
 118 Time of last change as seconds since Epoch
 119 .PP
 120 Valid format sequences for file systems:
 121 .TP
 122 %a
 123 Free blocks available to non\-superuser
 124 .TP
 125 %b
 126 Total data blocks in file system
 127 .TP
 128 %c
 129 Total file nodes in file system
 130 .TP
 131 %d
 132 Free file nodes in file system
 133 .TP
 134 %f
 135 Free blocks in file system
 136 .TP
 137 %C
 138 SELinux security context string
 139 .TP
 140 %i
 141 File System ID in hex
 142 .TP
 143 %l
 144 Maximum length of filenames
 145 .TP
 146 %n
 147 File name
 148 .TP
 149 %s
 150 Block size (for faster transfers)
 151 .TP
 152 %S
 153 Fundamental block size (for block counts)
 154 .TP
 155 %t
 156 Type in hex
 157 .TP
 158 %T
 159 Type in human readable form
 160 .PP
 161 NOTE: your shell may have its own version of stat, which usually supersedes
 162 the version described here.  Please refer to your shell's documentation
 163 for details about the options it supports.
 164 .SH AUTHOR
 165 Written by Michael Meskes.
 166 .SH "REPORTING BUGS"
 167 Report stat bugs to bug\-coreutils@gnu.org
 168 .br
 169 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
 170 .br
 171 General help using GNU software: <http://www.gnu.org/gethelp/>
 172 .br
 173 Report stat translation bugs to <http://translationproject.org/team/>
 174 .SH COPYRIGHT
 175 Copyright \(co 2010 Free Software Foundation, Inc.
 176 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 177 .br
 178 This is free software: you are free to change and redistribute it.
 179 There is NO WARRANTY, to the extent permitted by law.
 180 .SH "SEE ALSO"
 181 stat(2)
 182 .PP
 183 The full documentation for
 184 .B stat
 185 is maintained as a Texinfo manual.  If the
 186 .B info
 187 and
 188 .B stat
 189 programs are properly installed at your site, the command
 190 .IP
 191 .B info coreutils \(aqstat invocation\(aq
 192 .PP
 193 should give you access to the complete manual.