1DUF(1)                      Disk Usage/Free Utility                     DUF(1)
2
3
4

NAME

6       duf - Disk Usage/Free Utility
7

SYNOPSIS

9       duf [options...] [argument...]
10

DESCRIPTION

12       Simple Disk Usage/Free Utility.
13
14       Features:
15
16              •  User-friendly, colorful output.
17
18              •  Adjusts to your terminal's theme & width.
19
20              •  Sort the results according to your needs.
21
22              •  Groups & filters devices.
23
24              •  Can conveniently output JSON.
25

OPTIONS

27       -all   include pseudo, duplicate, inaccessible file systems
28
29       -avail-threshold
30              specifies the coloring threshold (yellow, red) of the avail col‐
31              umn, must be integer with optional SI prefixes
32
33       -hide  hide specific devices, separated with  commas:  local,  network,
34              fuse, special, loops, binds
35
36       -hide-fs
37              hide specific filesystems, separated with commas
38
39       -hide-mp
40              hide  specific  mount  points,  separated  with commas (supports
41              wildcards)
42
43       -inodes
44              list inode information instead of block usage
45
46       -json  output all devices in JSON format
47
48       -only  show only specific devices, separated with commas:  local,  net‐
49              work, fuse, special, loops, binds
50
51       -only-fs
52              only specific filesystems, separated with commas
53
54       -only-mp
55              only  specific  mount  points,  separated  with commas (supports
56              wildcards)
57
58       -output
59              output fields: mountpoint, size, used, avail, usage, inodes, in‐
60              odes_used, inodes_avail, inodes_usage, type, filesystem
61
62       -sort  sort  output  by:  mountpoint, size, used, avail, usage, inodes,
63              inodes_used, inodes_avail, inodes_usage, type, filesystem
64
65       -style style: unicode, ascii
66
67       -theme color themes: dark, light, ansi
68
69       -usage-threshold
70              specifies the coloring threshold (yellow, red) of the usage bars
71              as a floating point number from 0 to 1
72
73       -version
74              display version
75
76       -warnings
77              output all warnings to STDERR
78
79       -width max output width
80

USAGE

82       You can simply start duf without any command-line arguments:
83
84         $ duf
85
86       If  you  supply  arguments, duf will only list specific devices & mount
87       points:
88
89         $ duf /home /some/file
90
91       If you want to list everything (including pseudo, duplicate, inaccessi‐
92       ble file systems):
93
94         $ duf --all
95
96       You can show and hide specific tables:
97
98         $ duf --only local,network,fuse,special,loops,binds
99
100         $ duf --hide local,network,fuse,special,loops,binds
101
102       You can also show and hide specific filesystems:
103
104         $ duf --only-fs tmpfs,vfat
105
106         $ duf --hide-fs tmpfs,vfat
107
108       ...or specific mount points:
109
110         $ duf --only-mp /,/home,/dev
111
112         $ duf --hide-mp /,/home,/dev
113
114       Wildcards inside quotes work:
115
116         $ duf --only-mp '/sys/*,/dev/*'
117
118       Sort the output:
119
120         $ duf --sort size
121
122       Valid  keys  are:  mountpoint,  size,  used,  avail, usage, inodes, in‐
123       odes_used, inodes_avail, inodes_usage, type, filesystem.
124
125       Show or hide specific columns:
126
127         $ duf --output mountpoint,size,usage
128
129       Valid keys are: mountpoint,  size,  used,  avail,  usage,  inodes,  in‐
130       odes_used, inodes_avail, inodes_usage, type, filesystem.
131
132       List inode information instead of block usage:
133
134         $ duf --inodes
135
136       If  duf  doesn't detect your terminal's colors correctly, you can set a
137       theme:
138
139         $ duf --theme light
140
141       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
145         $ duf --avail-threshold="10G,1G"
146
147         $ duf --usage-threshold="0.5,0.9"
148
149       If you prefer your output as JSON:
150
151         $ duf --json
152

NOTES

154       Portions   of   duf's   code   are    copied    and    modified    from
155       https://github.com/shirou/gopsutil.
156
157       gopsutil  was  written  by  WAKAYAMA  Shirou  and  is distributed under
158       BSD-3-Clause.
159

AUTHORS

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
168       Released under MIT license.
169
170
171
172duf                               2022-02-08                            DUF(1)
Impressum