dwww Home | Manual pages | Find package

DUF(1)                      Disk Usage/Free Utility                     DUF(1)

NAME
       duf - Disk Usage/Free Utility

SYNOPSIS
       duf [options...] [argument...]

DESCRIPTION
       Simple Disk Usage/Free Utility.

       Features:

              •  User-friendly, colorful output.

              •  Adjusts to your terminal's theme & width.

              •  Sort the results according to your needs.

              •  Groups & filters devices.

              •  Can conveniently output JSON.

OPTIONS
       -all   include pseudo, duplicate, inaccessible file systems

       -avail-threshold
              specifies the coloring threshold (yellow, red) of the avail col-
              umn, must be integer with optional SI prefixes

       -hide  hide specific devices, separated with  commas:  local,  network,
              fuse, special, loops, binds

       -hide-fs
              hide specific filesystems, separated with commas

       -hide-mp
              hide  specific  mount  points,  separated  with commas (supports
              wildcards)

       -inodes
              list inode information instead of block usage

       -json  output all devices in JSON format

       -only  show only specific devices, separated with commas:  local,  net-
              work, fuse, special, loops, binds

       -only-fs
              only specific filesystems, separated with commas

       -only-mp
              only  specific  mount  points,  separated  with commas (supports
              wildcards)

       -output
              output fields: mountpoint, size, used, avail, usage, inodes, in-
              odes_used, inodes_avail, inodes_usage, type, filesystem

       -sort  sort  output  by:  mountpoint, size, used, avail, usage, inodes,
              inodes_used, inodes_avail, inodes_usage, type, filesystem

       -style style: unicode, ascii

       -theme color themes: dark, light, ansi

       -usage-threshold
              specifies the coloring threshold (yellow, red) of the usage bars
              as a floating point number from 0 to 1

       -version
              display version

       -warnings
              output all warnings to STDERR

       -width max output width

USAGE
       You can simply start duf without any command-line arguments:

         $ duf

       If  you  supply  arguments, duf will only list specific devices & mount
       points:

         $ duf /home /some/file

       If you want to list everything (including pseudo, duplicate, inaccessi-
       ble file systems):

         $ duf --all

       You can show and hide specific tables:

         $ duf --only local,network,fuse,special,loops,binds

         $ duf --hide local,network,fuse,special,loops,binds

       You can also show and hide specific filesystems:

         $ duf --only-fs tmpfs,vfat

         $ duf --hide-fs tmpfs,vfat

       ...or specific mount points:

         $ duf --only-mp /,/home,/dev

         $ duf --hide-mp /,/home,/dev

       Wildcards inside quotes work:

         $ duf --only-mp '/sys/*,/dev/*'

       Sort the output:

         $ duf --sort size

       Valid  keys  are:  mountpoint,  size,  used,  avail, usage, inodes, in-
       odes_used, inodes_avail, inodes_usage, type, filesystem.

       Show or hide specific columns:

         $ duf --output mountpoint,size,usage

       Valid keys are: mountpoint,  size,  used,  avail,  usage,  inodes,  in-
       odes_used, inodes_avail, inodes_usage, type, filesystem.

       List inode information instead of block usage:

         $ duf --inodes

       If  duf  doesn't detect your terminal's colors correctly, you can set a
       theme:

         $ duf --theme light

       duf highlights the availability & usage columns in red, green, or  yel-
       low,  depending  on how much space is still available. You can set your
       own thresholds:

         $ duf --avail-threshold="10G,1G"

         $ duf --usage-threshold="0.5,0.9"

       If you prefer your output as JSON:

         $ duf --json

NOTES
       Portions   of   duf's   code   are    copied    and    modified    from
       https://github.com/shirou/gopsutil.

       gopsutil  was  written  by  WAKAYAMA  Shirou  and  is distributed under
       BSD-3-Clause.

AUTHORS
       duf       was       written       by       Christian       Muehlhaeuser
       <https://github.com/muesli/duf>

COPYRIGHT
       Copyright        (C)       2020-2022       Christian       Muehlhaeuser
       <https://github.com/muesli>

       Released under MIT license.

duf                               2022-02-08                            DUF(1)

Generated by dwww version 1.15 on Sat Jun 29 01:55:29 CEST 2024.