Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
STAT(1)				 User Commands			       STAT(1)

       stat - display file or file system status

       stat [OPTION]...	FILE...

       Display file or file system status.

       Mandatory  arguments  to	 long  options are mandatory for short options

       -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  new-
	      line after each use of FORMAT

	      like  --format, but interpret backslash escapes, and do not out-
	      put a mandatory trailing newline;	if you want a newline, include
	      \n in FORMAT

       -t, --terse
	      print the	information in terse form

       --help display this help	and exit

	      output version information and exit

       The valid format	sequences for files (without --file-system):

       %a     access rights in octal

       %A     access rights in human readable form

       %b     number of	blocks allocated (see %B)

       %B     the size in bytes	of each	block reported by %b

       %C     SELinux security context string

       %d     device number in decimal

       %D     device number in hex

       %f     raw mode in hex

       %F     file type

       %g     group ID of owner

       %G     group name of owner

       %h     number of	hard links

       %i     inode number

       %m     mount point

       %n     file name

       %N     quoted file name with dereference	if symbolic link

       %o     optimal I/O transfer size	hint

       %s     total size, in bytes

       %t     major  device  type  in  hex, for	character/block	device special

       %T     minor device type	in hex,	 for  character/block  device  special

       %u     user ID of owner

       %U     user name	of owner

       %w     time of file birth, human-readable; - if unknown

       %W     time of file birth, seconds since	Epoch; 0 if unknown

       %x     time of last access, human-readable

       %X     time of last access, seconds since Epoch

       %y     time of last data	modification, human-readable

       %Y     time of last data	modification, seconds since Epoch

       %z     time of last status change, human-readable

       %Z     time of last status change, seconds since	Epoch

       Valid format sequences for file systems:

       %a     free blocks available to non-superuser

       %b     total data blocks	in file	system

       %c     total file nodes in file system

       %d     free file	nodes in file system

       %f     free blocks in file system

       %i     file system ID in	hex

       %l     maximum length of	filenames

       %n     file name

       %s     block size (for faster transfers)

       %S     fundamental block	size (for block	counts)

       %t     file system type in hex

       %T     file system type in human	readable form

       NOTE: your shell	may have its own version of stat, which	usually	super-
       sedes the version described here.  Please refer to your	shell's	 docu-
       mentation for details about the options it supports.

       Written by Michael Meskes.

       GNU coreutils online help: <>
       Report stat translation bugs to <>

       Copyright  (C) 2014 Free	Software Foundation, Inc.  License GPLv3+: GNU
       GPL version 3 or	later <>.
       This is free software: you are free  to	change	and  redistribute  it.
       There is	NO WARRANTY, to	the extent permitted by	law.


       Full documentation at: <>
       or available locally via: info '(coreutils) stat	invocation'

GNU coreutils 8.23		  March	2015			       STAT(1)


Want to link to this manual page? Use this URL:

home | help