forked from garabik/pydf
-
Notifications
You must be signed in to change notification settings - Fork 0
/
pydf.1
88 lines (87 loc) · 2.16 KB
/
pydf.1
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
.TH PYDF 1
.SH NAME
pydf \- report colourised filesystem disk space usage
.SH SYNOPSIS
.B pydf
.I "[options]"
.I "[file]"
.SH "DESCRIPTION"
.B pydf
is a python script that displays the amount of disk space available
on the mounted filesystems, using different colours for different
types of filesystems. Output format is completely customizable.
.TP
If an optional
.I "file"
argument is given, pydf displays just information about filesystem
containing the file(s), otherwise it displays information about all
mounted filesystems.
.SH OPTIONS
.TP
.B \-\-help
Show summary of options.
.TP
.B \-v, \-\-version
Show version of program.
.TP
.B \-a, \-\-all
include filesystems having 0 blocks
.TP
.B \-h, \-\-human-readable
print sizes in human readable format (e.g., 133K 2341M 2448G)
.TP
.B \-H, \-\-si
likewise, but use powers of 1000 not 1024
.TP
.B \-\-block-size=SIZE
use SIZE-byte blocks
.TP
.B \-k, \-\-kilobytes
like --block-size=1024
.TP
.B \-i, \-\-inodes
show information about inodes instead of blocks
.TP
.B \-l, \-\-local
limit listing to local filesystems
.TP
.B \-m, \-\-megabytes
like --block-size=1048576
.TP
.B \-g, \-\-gigabytes
like --block-size=1073741824
.TP
.B \-\-blocks
use filesystem native block size
.TP
.B \-\-bw
do not use colours
.TP
.B --mounts=FILE
file to get mount information from.
On normal linux system, only /etc/mtab or /proc/mounts make sense.
Use /proc/mounts when /etc/mtab is corrupted or inaccessible
(the output looks a bit weird in this case though)
.TP
.B \-B, \-\-show\-binds
Show also mount --bind mounted filesystems.
.SH "BUGS"
POSIX mandates to have f_blocks and f_bfree to be the number in units of f_frsize. However,
many programs are buggy, including df(1) from coreutils, and Linux kernel often lies and reports
f_frsize == f_bsize. Some filesystem and some other operating systems don't, and then the size
reported by pydf is incorrect. As a stopgap measure, there is a parameter
.I statvfs_block
in
.B /etc/pydfrc
where you can force f_frsize or f_bsize.
.SH "FILES"
.TP
.B /etc/pydfrc
main configuration file
.TP
.B ~/.pydfrc
per-user configuration file
.SH "SEE ALSO"
.BR df "(1)
.SH AUTHOR
Radovan Garab\('ik <[email protected]>