1DUF(1) Disk Usage/Free Utility DUF(1)
2
6 duf - Disk Usage/Free Utility
7
9 duf [options...] [argument...]
10
12 Simple Disk Usage/Free Utility.
13 Features:
15 • User-friendly, colorful output.
17 • Adjusts to your terminal's theme & width.
19 • Sort the results according to your needs.
21 • Groups & filters devices.
23 • Can conveniently output JSON.
25
27 -all include pseudo, duplicate, inaccessible file systems
28 -avail-threshold
30 specifies the coloring threshold (yellow, red) of the avail col‐
31 umn, must be integer with optional SI prefixes
32 -hide hide specific devices, separated with commas: local, network,
34 fuse, special, loops, binds
35 -hide-fs
37 hide specific filesystems, separated with commas
38 -hide-mp
40 hide specific mount points, separated with commas (supports
41 wildcards)
42 -inodes
44 list inode information instead of block usage
45 -json output all devices in JSON format
47 -only show only specific devices, separated with commas: local, net‐
49 work, fuse, special, loops, binds
50 -only-fs
52 only specific filesystems, separated with commas
53 -only-mp
55 only specific mount points, separated with commas (supports
56 wildcards)
57 -output
59 output fields: mountpoint, size, used, avail, usage, inodes, in‐
60 odes_used, inodes_avail, inodes_usage, type, filesystem
61 -sort sort output by: mountpoint, size, used, avail, usage, inodes,
63 inodes_used, inodes_avail, inodes_usage, type, filesystem
64 -style style: unicode, ascii
66 -theme color themes: dark, light, ansi
68 -usage-threshold
70 specifies the coloring threshold (yellow, red) of the usage bars
71 as a floating point number from 0 to 1
72 -version
74 display version
75 -warnings
77 output all warnings to STDERR
78 -width max output width
80
82 You can simply start duf without any command-line arguments:
83 $ duf
85 If you supply arguments, duf will only list specific devices & mount
87 points:
88 $ duf /home /some/file
90 If you want to list everything (including pseudo, duplicate, inaccessi‐
92 ble file systems):
93 $ duf --all
95 You can show and hide specific tables:
97 $ duf --only local,network,fuse,special,loops,binds
99 $ duf --hide local,network,fuse,special,loops,binds
101 You can also show and hide specific filesystems:
103 $ duf --only-fs tmpfs,vfat
105 $ duf --hide-fs tmpfs,vfat
107 ...or specific mount points:
109 $ duf --only-mp /,/home,/dev
111 $ duf --hide-mp /,/home,/dev
113 Wildcards inside quotes work:
115 $ duf --only-mp '/sys/*,/dev/*'
117 Sort the output:
119 $ duf --sort size
121 Valid keys are: mountpoint, size, used, avail, usage, inodes, in‐
123 odes_used, inodes_avail, inodes_usage, type, filesystem.
124 Show or hide specific columns:
126 $ duf --output mountpoint,size,usage
128 Valid keys are: mountpoint, size, used, avail, usage, inodes, in‐
130 odes_used, inodes_avail, inodes_usage, type, filesystem.
131 List inode information instead of block usage:
133 $ duf --inodes
135 If duf doesn't detect your terminal's colors correctly, you can set a
137 theme:
138 $ duf --theme light
140 duf highlights the availability & usage columns in red, green, or yel‐
142 low, depending on how much space is still available. You can set your
143 own thresholds:
144 $ duf --avail-threshold="10G,1G"
146 $ duf --usage-threshold="0.5,0.9"
148 If you prefer your output as JSON:
150 $ duf --json
152
154 Portions of duf's code are copied and modified from
155 https://github.com/shirou/gopsutil.
156 gopsutil was written by WAKAYAMA Shirou and is distributed under
158 BSD-3-Clause.
159
161 duf was written by Christian Muehlhaeuser
162 <https://github.com/muesli/duf>
163
165 Copyright (C) 2020-2022 Christian Muehlhaeuser
166 <https://github.com/muesli>
167 Released under MIT license.
169duf 2022-02-08 DUF(1)