1gt5(1) General Commands Manual gt5(1)
2
3
4
6 gt5 - a diff-capable 'du-browser'
7
9 gt5 [ dir | file | dir file | file file2 ] [options]
10
12 gt5 reads the output of du, compares it with a du-log saved by the last
13 run, converts it into HTML and opens the resulting file with a
14 textbrowser.
15
16 If files are given on the commandline they are expected to be (option‐
17 ally gzip/bzip2-compressed) logfiles of du -akx /some/dir. It is up to
18 you to take care that the given directories/files represent the same
19 directory. gt5 will show lots of new files if you don't. ;-)
20
22 --cut-at float
23 Files and directories that are below float percent of their par‐
24 ents are not shown. Default is 0.1, gt5 will accept values
25 between 0.01 and 30.
26
27 --diff-dir directory
28 Use directory instead of ~/.gt5-diffs/ to read/store du-logs.
29 This switch is ignored if gt5 is only used with files.
30
31 --discard
32 Do not save the current state, in other words: be able to diff
33 against the old state again. This feature is disabled if gt5 is
34 only used with files.
35
36 --link-files
37 Also insert links to files to access them from within gt5. This
38 can be very handy if your browser is configured to handle the
39 files MIME-type correctly. This feature is disabled if gt5 is
40 only used with files.
41
42 --max-depth int
43 Do not show anything below a depth of int directories. Default
44 is 5 (also see BUGS below).
45
46 --max-lines int
47 Only consider the int biggest files and directories within the
48 output of du.
49
50 --no-diffs
51 Use this if you are not interested in the history of the direc‐
52 tories processed, for example in /tmp.
53
54 --save-as file
55 DEPRECATED, use du -akx or du -ak (see --with-mounts), save the
56 output to a file and run gt5 against one (ore two) of these
57 files later.
58
59 --save-state
60 Force saving current state, overwriting a previous --discard.
61 (Some people seem to have gt5 aliased to 'gt5 --discard'.)
62
63 --with-mounts
64 By default gt5 calls du with -akx to ignore mounted filesystems.
65 Use this to inspect mounted partitions too, i.e. call du with
66 -ak
67
69 If gawk or a textbrowser are missing and you want to install them into
70 ~/bin (or /usr/local/bin if you have write access there), gt5 comes
71 with the following helpers:
72
73 --get-gawk
74 Download, compile and install a copy of gawk.
75
76 --get-links
77 Download, compile and install a copy of links.
78
79 --get-links2
80 Download, compile and install a copy of links2.
81
82 --get-elinks
83 Download, compile and install a copy of elinks.
84
86 It is recommended to use links with gt5. Other textbrowsers are also
87 possible but there are several good reasons why links is given priority
88 over the others:
89
90 elinks:
91 links is much faster on startup/exit
92
93 lynx: does not honor a documents coloring
94
95 netrik:
96 no colors, unfavourable cursor navigation
97
98 retawq:
99 no colors, can't handle <a name>-tags
100
101 w3m: unfavourable handling of <a name>-tag, unfavourable cursor navi‐
102 gation and no colors
103
104 Only links/links2, elinks and lynx are now considered usable (and also
105 chosen in that order). See ENVIRONMENT/GT5_BROWSER below.
106
108 ~/.gt5.html
109 contains a copy of the last run
110 ~/.gt5-diffs/
111 compressed du-logs are stored here
112
114 GT5_BROWSER
115 force using a (specific) textbrowser
116
117 GT5_CHARSET
118 force using a (specific) charset for HTML header instead of
119 using $LANG
120
122 Directories at depth max-depth are not browsable and so look like
123 files.
124
126 Thomas Sattler <gt5 at gmx dot net>
127
129 du(1), links(1), elinks(1), lynx(1)
130
131
132
133gt5 v1.4.0 August 2007 gt5(1)