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

FreeBSD Manual Pages

  
 
  

home | help
DF(1)			  BSD General Commands Manual			 DF(1)

NAME
     df	-- display free	disk space

SYNOPSIS
     df	[-b | -h | -H |	-k | -m	| -P] [-ailn] [-t] [-T type]
	[file |	filesystem ...]

LEGACY SYNOPSIS
     df	[-b | -h | -H |	-k | -m	| -P] [-ailn] [-t type]	[-T type] [file	|
     filesystem	...]

DESCRIPTION
     The df utility displays statistics	about the amount of free disk space on
     the specified filesystem or on the	filesystem of which file is a part.
     Values are	displayed in 512-byte per block	counts.	 If neither a file or
     a filesystem operand is specified,	statistics for all mounted filesystems
     are displayed (subject to the -t option below).

     The following options are available:

     -a	     Show all mount points, including those that were mounted with the
	     MNT_IGNORE	flag.

     -b	     Use 512-byte blocks rather	than the default.  Note	that this
	     overrides the BLOCKSIZE specification from	the environment.

     -g	     Use 1073741824-byte (1-Gbyte) blocks rather than the default.
	     Note that this overrides the BLOCKSIZE specification from the en-
	     vironment.

     -H	     "Human-readable" output.  Use unit	suffixes: Byte,	Kilobyte,
	     Megabyte, Gigabyte, Terabyte and Petabyte in order	to reduce the
	     number of digits to three or less using base 10 for sizes.

     -h	     "Human-readable" output.  Use unit	suffixes: Byte,	Kilobyte,
	     Megabyte, Gigabyte, Terabyte and Petabyte in order	to reduce the
	     number of digits to three or less using base 2 for	sizes.

     -i	     Include statistics	on the number of free inodes.

     -k	     Use 1024-byte (1-Kbyte) blocks rather than	the default.  Note
	     that this overrides the BLOCKSIZE specification from the environ-
	     ment.

     -l	     Only display information about locally-mounted filesystems.

     -m	     Use 1048576-byte (1-Mbyte)	blocks rather than the default.	 Note
	     that this overrides the BLOCKSIZE specification from the environ-
	     ment.

     -n	     Print out the previously obtained statistics from the filesys-
	     tems.  This option	should be used if it is	possible that one or
	     more filesystems are in a state such that they will not be	able
	     to	provide	statistics without a long delay.  When this option is
	     specified,	df will	not request new	statistics from	the filesys-
	     tems, but will respond with the possibly stale statistics that
	     were previously obtained.

     -P	     Use POSIX compliant output	of 512-byte blocks rather than the de-
	     fault.  Note that this overrides the BLOCKSIZE specification from
	     the environment.

     -t	     In	legacy mode (see compat(5) for details)	acts like -T otherwise
	     it	is a no-op.

     -T	     Only print	out statistics for filesystems of the specified	types.
	     More than one type	may be specified in a comma separated list.
	     The list of filesystem types can be prefixed with "no" to specify
	     the filesystem types for which action should not be taken.	 For
	     example, the df command:

		   df -t nonfs,mfs

	     lists all filesystems except those	of type	NFS and	MFS.  The
	     lsvfs(1) command can be used to find out the types	of filesystems
	     that are available	on the system.

ENVIRONMENT
     BLOCKSIZE	If the environment variable BLOCKSIZE is set, the block	counts
		will be	displayed in units of that size	block.

BUGS
     The -n and	-t flags are ignored if	a file or filesystem is	specified.

SEE ALSO
     lsvfs(1), quota(1), fstatfs(2), getfsstat(2), statfs(2), getmntinfo(3),
     compat(5) fstab(5), mount(8), quot(8)

HISTORY
     A df command appeared in Version 1	AT&T UNIX.

BSD				  May 8, 1995				   BSD

NAME | SYNOPSIS | LEGACY SYNOPSIS | DESCRIPTION | ENVIRONMENT | BUGS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=df&sektion=1&manpath=Darwin+8.0.1%2fppc>

home | help