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.

       -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

       %n     File name

       %N     Quoted file name with dereference	if symbolic link

       %o     I/O block	size

       %s     Total size, in bytes

       %t     Major device type	in hex

       %T     Minor device type	in hex

       %u     User ID of owner

       %U     User name	of owner

       %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

       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

       %C     SELinux security context string

       %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     Type in hex

       %T     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.

       Report stat bugs	to
       GNU coreutils home page:	<>
       General help using GNU software:	<>

       Copyright (C) 2009 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.


       The full	documentation for stat is maintained as	a Texinfo manual.   If
       the  info  and  stat  programs are properly installed at	your site, the

	      info coreutils 'stat invocation'

       should give you access to the complete manual.

GNU coreutils 7.1		   July	2010			       STAT(1)


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

home | help