NAME

       pydf - report colourised filesystem disk space usage

SYNOPSIS

       pydf [options] [file]

DESCRIPTION

       pydf  is  a  python script that displays the amount of disk space available on the mounted
       filesystems, using different colours for different types of filesystems. Output format  is
       completely customizable.

       If an optional
              file  argument is given, pydf displays just information about filesystem containing
              the file(s), otherwise it displays information about all mounted filesystems.

OPTIONS

       --help Show summary of options.

       -v, --version
              Show version of program.

       -a, --all
              include filesystems having 0 blocks

       -h, --human-readable
              print sizes in human readable format (e.g., 133K 2341M 2448G)

       -H, --si
              likewise, but use powers of 1000 not 1024

       --block-size=SIZE
              use SIZE-byte blocks

       -k, --kilobytes
              like --block-size=1024

       -i, --inodes
              show information about inodes instead of blocks

       -l, --local
              limit listing to local filesystems

       -m, --megabytes
              like --block-size=1048576

       -g, --gigabytes
              like --block-size=1073741824

       --blocks
              use filesystem native block size

       --bw   do not use colours

       --mounts=FILE
              file to get mount information from.  On normal  linux  system,  only  /etc/mtab  or
              /proc/mounts   make  sense.   Use  /proc/mounts  when  /etc/mtab  is  corrupted  or
              inaccessible (the output looks a bit weird in this case though)

       -B, --show-binds
              Show also mount --bind mounted filesystems.

BUGS

       POSIX mandates to have f_blocks and f_bfree  to  be  the  number  in  units  of  f_frsize.
       However,  many  programs are buggy, including df(1) from coreutils, and Linux kernel often
       lies and reports f_frsize == f_bsize. Some filesystem and  some  other  operating  systems
       don't,  and  then the size reported by pydf is incorrect. As a stopgap measure, there is a
       parameter statvfs_block in /etc/pydfrc where you can force f_frsize or f_bsize.

FILES

       /etc/pydfrc
              main configuration file

       ~/.pydfrc
              per-user configuration file

SEE ALSO

       df(1)

AUTHOR

       Radovan Garabík <garabik@kassiopeia.juls.savba.sk>

                                                                                          PYDF(1)