dfc(1)								   USER COMMANDS							    dfc(1)

NAME

       dfc - display file system space usage using graph and colors

SYNOPSIS

       dfc [OPTION(S)] [-c WHEN] [-u UNIT] [-t FILESYSTEM]

DESCRIPTION

       dfc(1)  is  a  tool  similar  to  df(1)	except that it is able to show a graph along with the data and is able to use color (color mode is
       "color-auto" by default but you can change this with "-c" option).

       The available size correspond to the space available to a user point of view and not from root's perspective (ie: use f_bavail  instead	of
       f_bfree).  In the same idea, used space is computed simply by substracting the available space from the total size.

       Without	any  argument,	size  is  displayed in human readable format.  Be aware that when using human-readable format, there might be some
       rounding when computing the size. If you want maximum precision, use the "-u" option and choose the unit.

       dfc(1) also has a built in feature that makes the output auto adjust based on terminal width. If you want to override  this  behavior,  use
       the "-f" option.

OPTIONS

       -a     Show information about all file systems found in the mtab file.

       -b     Do not show the graph bar.

       -c [WHEN]
	      Choose color mode where WHEN is one of the following sub-option:

	      "always":      Color will always be used, no matter what stdout is.

	      "auto":	    This  is default when "-c" is not activated. Color is used only if "stdout" is a terminal. For instance, color will be
	      disabled with this option if you pipe the output of dfc(1) into another command.

	      "never":	    Color will never be used.

       -f     Override auto-adjust behavior by forcing information to be displayed.  You probably do not want to activate this option  but  choice
	      is yours.  This option may be useful if you pipe the output of dfc(1) though.

       -h     Show a short help text.

       -i     Show information about inodes.

       -m     Use SI units (metric) (ie: size is computed using powers of 10 instead of powers of 2).

       -n     Do not print header.

       -o     Show mount options.

       -s     Sum the total usage.

       -t [FILESYSTEM]
	      Allows you to perform filtering on file system type. FILESYSTEM could take any known file system value. For instance, "ext4", "ufs",
	      "tmpfs", "reiserfs", etc.

	      Multiple selection on file system is also possible. In this case, FILESYSTEM needs to  be  comma	separated  (without  spaces).  For
	      instance, if you want to filter "ext4" and "tmpfs", you would use the following:

		   dfc -t ext4,tmpfs

	      You  can	also  use negative matching to filter the output. To do so, you just need to prepend a "-" to FILESYSTEM. In the following
	      example, dfc(1) will display all file system type except those mentionned:

		   dfc -t -rootfs,tmpfs

       -T     Show filesystem type.

       -u [UNIT]
	      Show size using unit specified. UNIT can take one of the following value:

	      "h":	Human readable (default when not using "-u" option).

	      "b":	Show bytes.

	      "k":	Show size using Kio.

	      "m":	Show size using Mio.

	      "g":	Show size using Gio.

	      "t":	Show size using Tio.

	      "p":	Show size using Pio.

	      "e":	Show size using Eio.

	      "z":	Show size using Zio.

	      "y":	Show size using Yio.

	      NOTE: When using "-u" option along with "-m" option, those suboptions are replaced by their SI counterparts.

       -v     Print dfc(1) version and exit.

       -w     Use a wider bar.

       -W     Wide path name (avoid truncation of file name). May require a larger display.

BUGS

       If you find one, please contact the author and explain what you encounter.

AUTHORS

       Robin Hahling (robin.hahling (at) gw-computing.net)

COPYRIGHT

       Copyright (C) 2012 Robin Hahling

LICENSE

       3 Clauses BSD

SEE ALSO

       df(1), du(1)

version 2.5.0							   April 3, 2012							    dfc(1)