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 column, 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, network, 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, inodes_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, inaccessible 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, inodes_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, inodes_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 yellow, 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.