File: dfc.1

package info (click to toggle)
dfc 2.5.0-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 160 kB
  • sloc: ansic: 1,043; makefile: 41
file content (144 lines) | stat: -rw-r--r-- 3,623 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
.TH dfc 1  "April 3, 2012" "version 2.5.0" "USER COMMANDS"
.SH NAME
dfc \- display file system space usage using graph and colors
.SH SYNOPSIS
.B dfc [OPTION(S)] [-c WHEN] [-u UNIT] [-t FILESYSTEM]
.SH DESCRIPTION
dfc(1) is a tool similar to df(1) except that it is able to show a graph along with the
data and is able to use color (color mode is "color-auto" by default but you
can change this with "\-c" option).

The available size correspond to the space available to a user point of
view and not from root's perspective (ie: use f_bavail instead of f_bfree).
In the same idea, used space is computed simply by substracting the available
space from the total size.

Without any argument, size is displayed in human readable format.
Be aware that when using human-readable format, there might be some rounding
when computing the size. If you want maximum precision, use the "\-u"
option and choose the unit.

dfc(1) also has a built in feature that makes the output auto adjust based on
terminal width. If you want to override this behavior, use the "\-f" option.

.SH OPTIONS
.TP
\-a
Show information about all file systems found in the mtab file.
.TP
\-b
Do not show the graph bar.
.TP
\-c [WHEN]
Choose color mode where WHEN is one of the following sub-option:

"always":
	Color will always be used, no matter what stdout is.

"auto":
	This is default when "\-c" is not activated. Color is used only if "stdout"
is a terminal. For instance, color will be disabled with this option if you
pipe the output of dfc(1) into another command.

"never":
	Color will never be used.

.TP
\-f
Override auto-adjust behavior by forcing information to be displayed.
You probably do not want to activate this option but choice is yours.
This option may be useful if you pipe the output of dfc(1) though.
.TP
\-h
Show a short help text.
.TP
\-i
Show information about inodes.
.TP
\-m
Use SI units (metric) (ie: size is computed using powers of 10 instead of powers
of 2).
.TP
\-n
Do not print header.
.TP
\-o
Show mount options.
.TP
\-s
Sum the total usage.
.TP
\-t [FILESYSTEM]
Allows you to perform filtering on file system type. FILESYSTEM could take any
known file system value. For instance, "ext4", "ufs", "tmpfs", "reiserfs", etc.

Multiple selection on file system is also possible. In this case, FILESYSTEM
needs to be comma separated (without spaces). For instance, if you want to
filter "ext4" and "tmpfs", you would use the following:

	dfc \-t ext4,tmpfs

You can also use negative matching to filter the output. To do so, you just
need to prepend a "-" to FILESYSTEM. In the following example, dfc(1) will
display all file system type except those mentionned:

	dfc \-t \-rootfs,tmpfs

.TP
\-T
Show filesystem type.
.TP
\-u [UNIT]
Show size using unit specified. UNIT can take one of the following value:

"h":
	Human readable (default when not using "\-u" option).

"b":
	Show bytes.

"k":
	Show size using Kio.

"m":
	Show size using Mio.

"g":
	Show size using Gio.

"t":
	Show size using Tio.

"p":
	Show size using Pio.

"e":
	Show size using Eio.

"z":
	Show size using Zio.

"y":
	Show size using Yio.

NOTE: When using "\-u" option along with "\-m" option, those suboptions are
replaced by their SI counterparts.
.TP
\-v
Print dfc(1) version and exit.
.TP
\-w
Use a wider bar.
.TP
\-W
Wide path name (avoid truncation of file name). May require a larger display.
.SH BUGS
If you find one, please contact the author and explain what you encounter.
.SH AUTHORS
Robin Hahling (robin.hahling (at) gw-computing.net)
.SH COPYRIGHT
Copyright \(co 2012 Robin Hahling
.SH LICENSE
3 Clauses BSD
.SH SEE ALSO
df(1), du(1)