1gt5(1)                      General Commands Manual                     gt5(1)
2
3
4

NAME

6       gt5 - a diff-capable 'du-browser'
7

SYNOPSIS

9       gt5 [ dir | file | dir file | file file2 ] [options]
10

DESCRIPTION

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

OPTIONS

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

HELPERS

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

TEXTBROWSERS

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

FILES

108       ~/.gt5.html
109              contains a copy of the last run
110       ~/.gt5-diffs/
111              compressed du-logs are stored here
112

ENVIRONMENT

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

BUGS

122       Directories  at  depth  max-depth  are  not  browsable and so look like
123       files.
124

AUTHOR

126       Thomas Sattler <gt5 at gmx dot net>
127

SEE ALSO

129       du(1), links(1), elinks(1), lynx(1)
130
131
132
133gt5 v1.4.0                        August 2007                           gt5(1)
Impressum