cdu Home Page

Download

cdu-0.38.tar.gz (12Ko)

For building and installation instructions please see the INSTALL file.

Presentation

cdu (for Color du) is a perl script which call du and display a pretty histogram with optional colors which allow to imediatly see the directories which take disk space.

With no arguments, cdu reports the disk space for all subdirectories of the current directory.
With only one directory argument, cdu reports the disk space for all subdirectories of the given directory.
You can also call du with no predefined options. For more documentation about available options, see the manpage below.

cdu is free software. Please see the GNU public licence for details

Example

Manpage

CDU(1)                                                                  CDU(1)



NAME
       cdu - estimate file space usage

SYNOPSIS
       cdu [options] [files...]

DESCRIPTION
       cdu reports the amount of disk space used by the specified files and
       display a color histogram.

       With no arguments, cdu reports the disk space for all subdirectories of
       the current directory.

       With only one directory argument, cdu reports the disk space for all
       subdirectories of the given directory.

       NB: cdu use the du command.

OPTIONS
       -b, --nocolor
               don't uses color.

       -B, --bold
               uses bold font and high intensity colors (only if color is
               activated).

       -c, --char character
               The character to use to display line.  This character is
               visible when color isn't used.  The default is '_'.

       -d, --du option
               A list of option to pass to the du command.  To avoid some
               errors, if option -n is not given, the only available options
               are "bDhklLmx" (e.g.: to use the -h option of du to have sizes
               in human readable format: -dh).

       -F, --file
               take recursivly all files from given directories.  Total size
               is only the size of all files without the size of the
               directories.

       -i, --intelligent
               colors according to the size.

       -l, --log
               use a logaritmic histogram.

       -M, --max-depth N
               Like the du --max-depth option: print the total for a directory
               (or file, with --all) only if it is N or fewer levels below the
               command line argument.

       -n, --normal
               call du with no predefined options. It means that cdu will act
               exactely like du. You can give options to the du command with
               the option -d (e.g.: to do a du -h, type cdu -ndh).

       -p, --percent
               Show percentage instead of size.

       -P, --limit-percent SIZE
               Only display directories which size in % is greater than SIZE.

       -r, --reverse
               With option "-s", reverse sort.

       -R, --recursive
               Show all directories and subdirectories.  The size of each
               directory include the size of all its subdirectories.  There is
               only one exception for the directory ".".  Its size don't
               include its subdirectories (the total size is given by the
               "Total" line).

       -s, --sort
               sort by size

       -S, --recursive-no-S
               Show all directories and subdirectories.  Report the size of
               each directory separately, not including the sizes of
               subdirectories.

       -z, --limit-size SIZE
               Only display directories which size is greater than SIZE.

       Options -F -R -S and -n must be used separately.

GNU STANDARD OPTIONS
       --help  Print a usage message on standard output and  exit
               successfully.

       --version
               Print version information on standard output, then exit
               successfully.

       --      Terminate option list.

OTHERS OPTIONS
       -m, --man
               Print the manual page and exit.

SEE ALSO
       du

AUTHOR
       Stephane Levant <stephane.levant@gmail.com>



0.37                              2010-05-18                            CDU(1)