diff options
Diffstat (limited to 'man/stat.1')
-rw-r--r-- | man/stat.1 | 223 |
1 files changed, 223 insertions, 0 deletions
diff --git a/man/stat.1 b/man/stat.1 new file mode 100644 index 0000000..29ffbe4 --- /dev/null +++ b/man/stat.1 @@ -0,0 +1,223 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH STAT "1" "April 2022" "GNU coreutils 9.1" "User Commands" +.SH NAME +stat \- display file or file system status +.SH SYNOPSIS +.B stat +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Display file or file system status. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-L\fR, \fB\-\-dereference\fR +follow links +.TP +\fB\-f\fR, \fB\-\-file\-system\fR +display file system status instead of file status +.TP +\fB\-\-cached\fR=\fI\,MODE\/\fR +specify how to use cached attributes; +useful on remote file systems. See MODE below +.TP +\fB\-c\fR \fB\-\-format\fR=\fI\,FORMAT\/\fR +use the specified FORMAT instead of the default; +output a newline after each use of FORMAT +.TP +\fB\-\-printf\fR=\fI\,FORMAT\/\fR +like \fB\-\-format\fR, but interpret backslash escapes, +and do not output a mandatory trailing newline; +if you want a newline, include \en in FORMAT +.TP +\fB\-t\fR, \fB\-\-terse\fR +print the information in terse form +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The MODE argument of \fB\-\-cached\fR can be: always, never, or default. +\&'always' will use cached attributes if available, while +\&'never' will try to synchronize with the latest attributes, and +\&'default' will leave it up to the underlying file system. +.PP +The valid format sequences for files (without \fB\-\-file\-system\fR): +.TP +%a +permission bits in octal (note '#' and '0' printf flags) +.TP +%A +permission bits and file type in human readable form +.TP +%b +number of blocks allocated (see %B) +.TP +%B +the size in bytes of each block reported by %b +.TP +%C +SELinux security context string +.TP +%d +device number in decimal (st_dev) +.TP +%D +device number in hex (st_dev) +.TP +%Hd +major device number in decimal +.TP +%Ld +minor device number in decimal +.TP +%f +raw mode in hex +.TP +%F +file type +.TP +%g +group ID of owner +.TP +%G +group name of owner +.TP +%h +number of hard links +.TP +%i +inode number +.TP +%m +mount point +.TP +%n +file name +.TP +%N +quoted file name with dereference if symbolic link +.TP +%o +optimal I/O transfer size hint +.TP +%s +total size, in bytes +.TP +%r +device type in decimal (st_rdev) +.TP +%R +device type in hex (st_rdev) +.TP +%Hr +major device type in decimal, for character/block device special files +.TP +%Lr +minor device type in decimal, for character/block device special files +.TP +%t +major device type in hex, for character/block device special files +.TP +%T +minor device type in hex, for character/block device special files +.TP +%u +user ID of owner +.TP +%U +user name of owner +.TP +%w +time of file birth, human\-readable; \- if unknown +.TP +%W +time of file birth, seconds since Epoch; 0 if unknown +.TP +%x +time of last access, human\-readable +.TP +%X +time of last access, seconds since Epoch +.TP +%y +time of last data modification, human\-readable +.TP +%Y +time of last data modification, seconds since Epoch +.TP +%z +time of last status change, human\-readable +.TP +%Z +time of last status change, seconds since Epoch +.PP +Valid format sequences for file systems: +.TP +%a +free blocks available to non\-superuser +.TP +%b +total data blocks in file system +.TP +%c +total file nodes in file system +.TP +%d +free file nodes in file system +.TP +%f +free blocks in file system +.TP +%i +file system ID in hex +.TP +%l +maximum length of filenames +.TP +%n +file name +.TP +%s +block size (for faster transfers) +.TP +%S +fundamental block size (for block counts) +.TP +%t +file system type in hex +.TP +%T +file system type in human readable form +.SS "--terse is equivalent to the following FORMAT:" +.IP +%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o %C +.SS "--terse --file-system is equivalent to the following FORMAT:" +.IP +%n %i %l %t %s %S %b %f %a %c %d +.PP +NOTE: your shell may have its own version of stat, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by Michael Meskes. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2022 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBstat\fP(2), \fBstatfs\fP(2), \fBstatx\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/stat> +.br +or available locally via: info \(aq(coreutils) stat invocation\(aq |