original/man1/stat.1

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