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	[-agklmn] [-G |	-i | -P] [-t type] [file | file_system ...]

DESCRIPTION
     df	displays statistics about the amount of	free disk space	on the speci-
     fied file_system or on the	file system of which file is a part.  By de-
     fault, all	sizes are reported in 512-byte block counts.  If neither a
     file or a file_system operand is specified, statistics for	all mounted
     file systems are displayed	(subject to the	-l and -t options below).

     Note that the printed count of available blocks takes minfree into	ac-
     count, and	thus will be negative when the number of free blocks on	the
     filesystem	is less	than minfree.

     The following options are available:

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

     -G	     Display all the fields of the structure(s)	returned by
	     statvfs(2).  This option cannot be	used with the -i or -P op-
	     tions, and	it is modelled after the Solaris -g option.  This op-
	     tion will override	the -g,	-h, -k,	and -m options,	as well	as any
	     setting of	BLOCKSIZE.

     -g	     The -g option causes the numbers to be reported in	gigabytes
	     (1024*1024*1024 bytes).

     -h	     "Human-readable" output.  Use unit	suffixes: Byte,	Kilobyte,
	     Megabyte, Gigabyte, Terabyte, Petabyte, Exabyte in	order to re-
	     duce the number of	digits to four or less.

     -i	     Include statistics	on the number of free inodes.

     -k	     By	default, all sizes are reported	in 512-byte block counts.  The
	     -k	option causes the numbers to be	reported in kilobytes (1024
	     bytes).

     -l	     Display statistics	only about mounted file	systems	with the
	     MNT_LOCAL flag set.  If a non-local file system is	given as an
	     argument, a warning is issued and no information is given on that
	     file system.

     -m	     The -m option causes the numbers to be reported in	megabytes
	     (1024*1024	bytes).

     -n	     Print out the previously obtained statistics from the file	sys-
	     tems.  This option	should be used if it is	possible that one or
	     more file systems 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 file sys-
	     tems, but will respond with the possibly stale statistics that
	     were previously obtained.

     -P	     Produce output in the following portable format:

	     If	both the -P and	-k option are specified, the output will be
	     preceded by the following header line, formatted to match the
	     data following it:

	     "Filesystem 1024-blocks Used Available Capacity Mounted on\n"

	     If	the -P option is specified without the -k options, the output
	     will be preceded by the following header line, formatted to match
	     the data following	it:

	     "Filesystem <blksize>-blocks Used Available Capacity Mounted on\n"

	     The header	line is	followed by data formatted as follows:

	     "%s %d %d %d %d%% %s\n", <file system name>, <total space>,
		 <space	used>, <space free>, <percentage used>,
		 <file system root>

	     Note that the -i option may not be	specified with -P.

     -t	type
	     Is	used to	indicate the actions should only be taken on filesys-
	     tems of the specified type.  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 ac-
	     tion should not be	taken.	If a file system is given on the com-
	     mand line that is not of the specified type, a warning is issued
	     and no information	is given on that file system.

ENVIRONMENT
     BLOCKSIZE	If the environment variable BLOCKSIZE is set, and the -g, -h,
		-k and -m options are not specified, the block counts will be
		displayed in units of that size	block.

SEE ALSO
     quota(1), fstatvfs(2), getvfsstat(2), statvfs(2), getbsize(3),
     getmntinfo(3), fs(5), fstab(5), mount(8), quot(8),	tunefs(8)

HISTORY
     A df utility appeared in Version 6	AT&T UNIX.

BSD				 March 4, 2008				   BSD

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | 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=NetBSD+6.0>

home | help