Skip to Content
gnux

statx

Display file or file system status.

Mirrors GNU stat. Run it as statx, or as gnux statx.

Synopsis

statx [OPTION]... FILE...

GNU reference

Description

statx prints everything the system records about each FILE: its type, size, blocks, device, inode, links, permissions, owner and group, and its access, modification, change and birth times. A symbolic link is described itself unless -L follows it. -f describes the file system holding FILE instead: its type, block sizes, and total, free and available blocks and inodes. -t prints the same fields on one line, for scripts. -c FORMAT prints only what FORMAT asks for, followed by a newline; --printf FORMAT does the same but interprets backslash escapes (\n, \t, \x41, \101) and adds no newline; when both are given, the last wins. FORMAT takes GNU's directives: %n (name), %N (quoted name, with its target for a link), %s (size), %F (file type), %a and %A (permissions in octal and as rwx), %u %U %g %G (owner and group), %h (links), %i (inode), %b %B %o (blocks, block unit, I/O size), %d %D %Hd %Ld (device), %r %R %t %T %Hr %Lr (device type of a special file), %m (mount point), %w %x %y %z (birth, access, modification and change times) and %W %X %Y %Z (the same as seconds since the epoch, which take a precision: %.3Y), with printf flags and widths (%-10s, %04a). With -f: %n %i %l %t %T %s %S %b %f %a %c %d. %N quotes a name (and a link's target) in the style the QUOTING_STYLE variable names, as lsx --quoting-style takes it, or else for the shell, always ('a.txt', 'a b', "it's", 'a'$'\n''b'); the default formats name files as they are. The device is shown as major,minor, as GNU stat 9 shows it. Missing data is reported honestly rather than invented: the birth time prints '-' where the system does not record it (Linux without statx), and on Windows, which has no numeric owners, %u and %g print '?'. SELinux contexts (%C) are not supported. --cached is accepted for compatibility and has no effect. On a terminal, gnux's terminal view (--pretty=auto, the default) shows each file, in place of the default format, as a box titled with its name: one labeled line a value (type, size, mode painted as lsx paints it, owner, group, links, inode, the four times) and, with -f, a bar of the blocks in use. A format given with -c, --printf or -t is printed as it is, and piped or redirected output is exactly GNU's; --pretty=never or GNUX_PRETTY=never turns the view off.

Permissions

Needs search permission on the directories leading to each FILE; the FILE itself need not be readable. Owner and group names are read from the system's account databases.

Use cases

  • Finding out exactly when a file was last modified, accessed or created.
  • Getting a file's size or permissions in a script without parsing lsx -l.
  • Checking which file system, and how much free space, a path is on.
  • Comparing inodes and devices to tell whether two paths are the same file.
  • Auditing ownership and permissions of sensitive files.

Flags

      --cached string            specify how to use cached attributes (always, never or default); accepted, no effect
  -L, --dereference              follow links
  -f, --file-system              display file system status instead of file status
  -c, --format FORMAT            use the specified FORMAT instead of the default; output a newline after each use of FORMAT
      --help                     display this help and exit
      --pretty WHEN[="always"]   the gnux terminal view WHEN: 'always' (the default when WHEN is omitted), 'auto' (the default: on a terminal only), or 'never'; GNUX_PRETTY sets the default
      --printf FORMAT            like --format, but interpret backslash escapes, and do not output a mandatory trailing newline
  -t, --terse                    print the information in terse form
      --theme NAME               color the view with the built-in theme NAME (gnux theme picks and saves one); GNUX_THEME sets the default
      --version                  output version information and exit

Examples

See everything about a config file before editing it

statx /etc/hosts
Output
  File: /etc/hosts
  Size: 221       	Blocks: 8          IO Block: 4096   regular file
Device: 259,2	Inode: 1835014     Links: 1
Access: (0644/-rw-r--r--)  Uid: (    0/    root)   Gid: (    0/    root)
Access: 2026-10-12 08:02:11.120375871 +0000
Modify: 2026-09-30 17:44:02.006417455 +0000
Change: 2026-09-30 17:44:02.006417455 +0000
 Birth: 2026-03-01 10:15:40.773102148 +0000

Get a file's size in bytes in a script, without parsing lsx -l

size=$(statx -c %s backup.tar.gz)
Output
1073741824

Check that an SSH key is private before ssh refuses to use it

statx -c '%a %U %n' ~/.ssh/id_ed25519
Output
600 alice /home/alice/.ssh/id_ed25519

Find out when a log file last changed, as seconds since the epoch, to alert if it went quiet

[ $(( $(datex +%s) - $(statx -c %Y app.log) )) -gt 600 ] && echox 'app.log silent for 10 minutes'

List several files with their permissions and owners, aligned

statx -c '%-25n %A %U:%G' /etc/passwd /etc/shadow /etc/sudoers
Output
/etc/passwd               -rw-r--r-- root:root
/etc/shadow               -rw-r----- root:shadow
/etc/sudoers              -r--r----- root:root

Tell whether two paths are the same file (same device and inode)

[ "$(statx -L -c %d:%i a)" = "$(statx -L -c %d:%i b)" ] && echox 'same file'
statx -c %N /usr/bin/python3
Output
/usr/bin/python3 -> python3.12

Check the file system type and free space under a directory

statx -f /var/lib/docker
statx --printf '%n\t%.3Y\n' *.csv
Output
jan.csv	1767225600.123
feb.csv	1769904000.456

Find a file's mount point

statx -c %m ~/Downloads/movie.mkv
Output
/home

Record a file's full status on one line, for a log or a diff

statx -t release.zip >> inventory.txt

Show file details in the portable gnux shell, the same on every OS

gnux shell -c 'statx -c "%n: %s bytes, modified %y" report.pdf'

Options

Each option has a page of its own, with its usage and examples.

  • --cached: Specify how to use cached attributes (always, never or default); accepted, no effect.
  • -L, --dereference: Follow links.
  • -f, --file-system: Display file system status instead of file status.
  • -c, --format: Use the specified FORMAT instead of the default; output a newline after each use of FORMAT.
  • --pretty: The gnux terminal view WHEN: 'always' (the default when WHEN is omitted), 'auto' (the default: on a terminal only), or 'never'; GNUX_PRETTY sets the default.
  • --printf: Like --format, but interpret backslash escapes, and do not output a mandatory trailing newline.
  • -t, --terse: Print the information in terse form.
  • --theme: Color the view with the built-in theme NAME (gnux theme picks and saves one); GNUX_THEME sets the default.

Exit status

StatusMeaning
0success: every operand was processed
1failure: an operand could not be processed (diagnosed on standard error), or a command-line mistake

Help in the terminal

statx --help                # options, first examples, exit status
gnux help statx             # this page: the full manual
gnux help statx --OPTION    # one option in depth, with its examples

See also

On this page