DUF
Section: Disk Usage/Free Utility (1)
Updated: 2022-02-08
Index
Return to Main Contents
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.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- USAGE
-
- NOTES
-
- AUTHORS
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
Time: 22:53:13 GMT, April 27, 2024