man-pages/man1/stat.1.html
2021-03-31 01:06:50 +01:00

217 lines
5.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of STAT</TITLE>
</HEAD><BODY>
<H1>STAT</H1>
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
stat - display file or file system status
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>stat</B>
[<I>,OPTION/</I>]... <I>,FILE/</I>...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
Display file or file system status.
<P>
Mandatory arguments to long options are mandatory for short options too.
<DL COMPACT>
<DT id="1"><B>-L</B>, <B>--dereference</B><DD>
follow links
<DT id="2"><B>-f</B>, <B>--file-system</B><DD>
display file system status instead of file status
<DT id="3"><B>-c</B> <B>--format</B>=<I>,FORMAT/</I><DD>
use the specified FORMAT instead of the default;
output a newline after each use of FORMAT
<DT id="4"><B>--printf</B>=<I>,FORMAT/</I><DD>
like <B>--format</B>, but interpret backslash escapes,
and do not output a mandatory trailing newline;
if you want a newline, include \n in FORMAT
<DT id="5"><B>-t</B>, <B>--terse</B><DD>
print the information in terse form
<DT id="6"><B>--help</B><DD>
display this help and exit
<DT id="7"><B>--version</B><DD>
output version information and exit
</DL>
<P>
The valid format sequences for files (without <B>--file-system</B>):
<DL COMPACT>
<DT id="8">%a<DD>
access rights in octal (note '#' and '0' printf flags)
<DT id="9">%A<DD>
access rights in human readable form
<DT id="10">%b<DD>
number of blocks allocated (see %B)
<DT id="11">%B<DD>
the size in bytes of each block reported by %b
<DT id="12">%C<DD>
SELinux security context string
<DT id="13">%d<DD>
device number in decimal
<DT id="14">%D<DD>
device number in hex
<DT id="15">%f<DD>
raw mode in hex
<DT id="16">%F<DD>
file type
<DT id="17">%g<DD>
group ID of owner
<DT id="18">%G<DD>
group name of owner
<DT id="19">%h<DD>
number of hard links
<DT id="20">%i<DD>
inode number
<DT id="21">%m<DD>
mount point
<DT id="22">%n<DD>
file name
<DT id="23">%N<DD>
quoted file name with dereference if symbolic link
<DT id="24">%o<DD>
optimal I/O transfer size hint
<DT id="25">%s<DD>
total size, in bytes
<DT id="26">%t<DD>
major device type in hex, for character/block device special files
<DT id="27">%T<DD>
minor device type in hex, for character/block device special files
<DT id="28">%u<DD>
user ID of owner
<DT id="29">%U<DD>
user name of owner
<DT id="30">%w<DD>
time of file birth, human-readable; - if unknown
<DT id="31">%W<DD>
time of file birth, seconds since Epoch; 0 if unknown
<DT id="32">%x<DD>
time of last access, human-readable
<DT id="33">%X<DD>
time of last access, seconds since Epoch
<DT id="34">%y<DD>
time of last data modification, human-readable
<DT id="35">%Y<DD>
time of last data modification, seconds since Epoch
<DT id="36">%z<DD>
time of last status change, human-readable
<DT id="37">%Z<DD>
time of last status change, seconds since Epoch
</DL>
<P>
Valid format sequences for file systems:
<DL COMPACT>
<DT id="38">%a<DD>
free blocks available to non-superuser
<DT id="39">%b<DD>
total data blocks in file system
<DT id="40">%c<DD>
total file nodes in file system
<DT id="41">%d<DD>
free file nodes in file system
<DT id="42">%f<DD>
free blocks in file system
<DT id="43">%i<DD>
file system ID in hex
<DT id="44">%l<DD>
maximum length of filenames
<DT id="45">%n<DD>
file name
<DT id="46">%s<DD>
block size (for faster transfers)
<DT id="47">%S<DD>
fundamental block size (for block counts)
<DT id="48">%t<DD>
file system type in hex
<DT id="49">%T<DD>
file system type in human readable form
</DL>
<A NAME="lbAE">&nbsp;</A>
<H3>--terse is equivalent to the following FORMAT:</H3>
<DL COMPACT>
<DT id="50"><DD>
%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o %C
</DL>
<A NAME="lbAF">&nbsp;</A>
<H3>--terse --file-system is equivalent to the following FORMAT:</H3>
<DL COMPACT>
<DT id="51"><DD>
%n %i %l %t %s %S %b %f %a %c %d
</DL>
<P>
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.
<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
Written by Michael Meskes.
<A NAME="lbAH">&nbsp;</A>
<H2>REPORTING BUGS</H2>
GNU coreutils online help: &lt;<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>&gt;
<BR>
Report stat translation bugs to &lt;<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>&gt;
<A NAME="lbAI">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later &lt;<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>&gt;.
<BR>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
<A NAME="lbAJ">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?2+stat">stat</A>(2), <A HREF="/cgi-bin/man/man2html?2+statfs">statfs</A>(2)
<P>
<BR>
Full documentation at: &lt;<A HREF="https://www.gnu.org/software/coreutils/stat">https://www.gnu.org/software/coreutils/stat</A>&gt;
<BR>
or available locally via: info '(coreutils) stat invocation'
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="52"><A HREF="#lbAB">NAME</A><DD>
<DT id="53"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="54"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT id="55"><A HREF="#lbAE">--terse is equivalent to the following FORMAT:</A><DD>
<DT id="56"><A HREF="#lbAF">--terse --file-system is equivalent to the following FORMAT:</A><DD>
</DL>
<DT id="57"><A HREF="#lbAG">AUTHOR</A><DD>
<DT id="58"><A HREF="#lbAH">REPORTING BUGS</A><DD>
<DT id="59"><A HREF="#lbAI">COPYRIGHT</A><DD>
<DT id="60"><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:27 GMT, March 31, 2021
</BODY>
</HTML>