dfc(1) - f37

1dfc(1)                           USER COMMANDS                          dfc(1)
2
3
4

NAME

6       dfc - report file system space usage information with style
7

SYNOPSIS

9       dfc  [OPTION(S)]  [-c  WHEN]  [-e  FORMAT]  [-p FSNAME] [-q SORTBY] [-t
10       FSTYPE] [-u UNIT]
11

DESCRIPTION

13       dfc(1) is a tool similar to df(1) except that it  is  able  to  show  a
14       graph  along  with  the  data  and  is able to use color (color mode is
15       "color-auto" by default but you can change this with "-c" option).
16
17       The available size corresponds to the space available from a user point
18       of  view  and  not from root's perspective (ie: use f_bavail instead of
19       f_bfree).
20
21       Without any argument, size is displayed in human-readable  format.   Be
22       aware that when using human-readable format, there might be some round‐
23       ing when computing the size. If you want  maximum  precision,  use  the
24       "-u" option and choose the unit.
25
26       dfc(1)  also  has  a built in feature that makes the output auto adjust
27       based on terminal width. If you want to override this behavior, use the
28       "-f" option.
29
30

OPTIONS

32       -a     Show all (do not omit any file system).
33
34       -b     Do not show the graph bar.
35
36       -c [WHEN]
37              Choose color mode where WHEN is one of the following sub-option:
38
39              "always": Color will always be used, no matter what "stdout" is.
40
41              "auto":  This  is  default  when "-c" is not activated. Color is
42              used only if "stdout" is a terminal. For instance, color will be
43              disabled  with this option if you pipe the output of dfc(1) into
44              another command.
45
46              "never": Color will never be used.
47
48
49       -d     Show used size.
50
51       -e [FORMAT]
52              Allows you to export dfc(1) output to specified FORMAT.   FORMAT
53              is one of the following:
54
55              "csv":  Output as "comma separated value" file type. Example us‐
56              age:
57
58                   dfc -e csv > foo.csv
59
60              "html": Output is HTML formated. Example usage:
61
62                   dfc -e html -Tadiso -c always > index.html
63
64              "json": Output is JSON formated. Example usage:
65
66                   dfc -e json -Tisod > report.json
67
68              "tex": Output is TeX formated. Example usage:
69
70                   dfc -e tex -c always > report.tex
71
72              "text": Text output (default).
73
74
75       -f     Override auto-adjust behavior by forcing information to be  dis‐
76              played.   This option can be useful when redirecting dfc(1) out‐
77              put.
78
79       -h     Show a short help text.
80
81       -i     Show information about inodes.
82
83       -l     Only show information about locally mount file systems.
84
85       -m     Use SI units (metric) (ie: size is computed using powers  of  10
86              instead of powers of 2).
87
88       -M     Do not print "mounted on".
89
90       -n     Do not print header.
91
92       -o     Show mount options.
93
94       -p [FSNAME]
95              Allows  you to perform filtering on file system name. FSNAME can
96              be anything.  For instance, if you want to see only file  system
97              which name starts with "/dev", you would use the following:
98
99                   dfc -p /dev
100
101              This  will  output  only  file  systems which names are, for in‐
102              stance, "/dev/sda1", "/dev/root", "/dev", etc.
103
104              Multiple selection is supported. In this case, FSNAME  needs  to
105              be a comma separated list (without spaces). For instance, if you
106              want to filter "/dev" and "tmpfs", you would use the following:
107
108                   dfc -p /dev,tmpfs
109
110              You can also use negative matching to filter the output.  To  do
111              so,  you  just need to prepend a "-" to FSNAME. In the following
112              example, dfc(1) will display all file system names except  those
113              mentioned:
114
115                   dfc -p -proc,/dev/sdc,run
116
117
118       -q [SORTBY]
119              Allows you to sort the output based on SORTBY.
120
121              SORTBY  can  take  one  of  those  three values: "name", "type",
122              "mount".
123
124              When using "name", the output is sorted  by  file  system  name.
125              When  using  "type",  the  output is sorted by file system type.
126              When using "mount", the output is sorted by mount points.
127
128
129       -s     Sum the total usage.
130
131       -t [FSTYPE]
132              Allows you to perform filtering  on  file  system  type.  FSTYPE
133              could  take  any  known file system value. For instance, "ext4",
134              "ufs", "tmpfs", "reiserfs", etc.  You can also use wildcard fil‐
135              tering, just as with the -p option. For instance, if you use the
136              following:
137
138                  dfc -t ext
139
140              This will allow any file system type  with  name  starting  with
141              "ext"  to  pass through the filter, for instance, "ext2", "ext3"
142              and "ext4".
143
144              Multiple selection on file system  is  also  possible.  In  this
145              case,  FSTYPE  needs  to be a comma separated list (without spa‐
146              ces). For instance, if you want to filter  "ext4"  and  "tmpfs",
147              you would use the following:
148
149                   dfc -t ext4,tmpfs
150
151              You  can  also use negative matching to filter the output. To do
152              so, you just need to prepend a "-" to FSTYPE. In  the  following
153              example,  dfc(1) will display all file system types except those
154              mentioned:
155
156                   dfc -t -rootfs,tmpfs
157
158
159       -T     Show file system type.
160
161       -u [UNIT]
162              Show size using the unit specified. UNIT can  take  one  of  the
163              following values:
164
165              "h":      Human readable (default when not using "-u" option).
166
167              "b":      Show bytes.
168
169              "k":      Show size using Kio.
170
171              "m":      Show size using Mio.
172
173              "g":      Show size using Gio.
174
175              "t":      Show size using Tio.
176
177              "p":      Show size using Pio.
178
179              "e":      Show size using Eio.
180
181              "z":      Show size using Zio.
182
183              "y":      Show size using Yio.
184
185              NOTE:  When using "-u" option along with "-m" option, those sub‐
186              options are replaced by their SI counterparts.
187
188       -v     Print dfc(1) version and exit.
189
190       -w     Use a wider bar for the graph.
191
192       -W     Wide path name (avoid truncation of file name).  May  require  a
193              larger display.
194

CONFIGURATION FILE

196       The  configuration file is optional. It allows you to change dfc(1) de‐
197       fault colors, values when colors change and graph symbol in  text  mode
198       and modify colors used in html export.
199
200       If you want to use it, place it here:
201
202            $XDG_CONFIG_HOME/dfc/dfcrc
203
204       If your operating system does not support XDG Base Directory Specifica‐
205       tion, it should then be placed here:
206
207            $HOME/.config/dfc/dfcrc
208
209       Or, last choice:
210
211            $HOME/.dfcrc
212
213       NOTE: The last two choices can be chosen only if your OS does not  sup‐
214       port XDG Base Directory Specification.
215

BUGS

217       If  you  find  one,  please contact the author and explain what you en‐
218       counter.
219

AUTHORS

221       Robin Hahling <robin.hahling@gw-computing.net>
222

COPYRIGHT

224       Copyright © 2012-2017 Robin Hahling
225

LICENSE

227       BSD 3-clause
228