STAT(1)

NAME
stat - display file or filesystem status

SYNOPSIS
stat [-l] [-f] [-s] [-v] [-t] [-c format] file-name [file-name]...

DESCRIPTION

This command displays information about the specified file(s). You do not need any access rights to the file to get this information but you need search rights to all directories named in the path leading to the file.

stat stats the file pointed to by file-name

stat -l is identical to stat, only that for links information about the files that are obtained by tracing the links is displayed.

stat -f does not stat the file itself but instead stats the filesystem where file-name is located.

stat -s also shows security context information for SE Linux if available.

stat -v prints version information.

stat -t prints the information in terse form, suitable for parsing by other programs

stat -c format displays the information in the format specified.

DISPLAY
stat and stat -l both display the following information:

Device number

Inode number

Access rights

Number of hard links

User ID (and name if available) of owner

Group ID (and name if available) of owner

Device type (if inode device)

Total size, in bytes

Number of blocks allocated

IO block size

Time of last access

Time of last modification

Time of last change

Security Context for SE Linux if applicable

If -f is specified the following information is displayed:

Filesystem type

Block size of the filesystem

Total blocks in the filesystem

Free blocks

Free blocks for non-root user(s)

Total inodes

Free inodes

Maximum length of filenames

If -c format is specified the following interpreted sequences are available for format :
    %n - File name

    %N - Quoted File name with dereference if symbolic link

    %d - Device number in decimal

    %D - Device number in hex

    %i - Inode number

    %a - Access rights in octal

    %A - Access rights in human readable form

    %f - raw mode in hex

    %F - File type

    %h - Number of hard links

    %u - User Id of owner

    %U - User name of owner

    %g - Group Id of owner

    %G - Group name of owner

    %t - Major device type in hex

    %T - Minor device type in hex

    %s - Total size, in bytes

    %b - Number of blocks allocated

    %o - IO block size

    %S - SE Linux SID

    %c - SE Linux security context

    %x - Time of last access

    %X - Time of last access as seconds since Epoch

    %y - Time of last modification

    %Y - Time of last modification as seconds since Epoch

    %z - Time of last change

    %Z - Time of last change as seconds since Epoch

If -c format and -f are specified the following interpreted sequences are available for format :

    %n - File name

    %i - File System id, __val[0] in hex

    %I - File System id, __val[1] in hex

    %l - Maximum length of filenames

    %t - Type in hex

    %T - Type in human readable form

    %b - Total data blocks in file system

    %f - Free blocks in file system

    %a - Free blocks available to non-superuser

    %s - Optimal transfer block size

    %c - Total file nodes in file system

    %d - Free file nodes in file system

The printf(3) flag characters '#', '0', '-', ' ', and '+', as well as the field width, and presision options can be used in format. For example, `stat -c "%010b" file' will print the number of blocks allocated zero padded and a minimum of 10 characters wide.

BUGS
None known so far.

AUTHORS
Written by Michael Meskes <meskes@debian.org>, -f added from statfs by Radovan Garabik <garabik@melkor.dnp.fmph.uniba.sk>

SEE ALSO
stat(2), statfs(2)