gt5(1)gt5(1)NAMEgt5 - a diff-capable 'du-browser'
SYNOPSISgt5 [ dir | file | dir file | file file2 ] [options]
DESCRIPTIONgt5 reads the output of du, compares it with a du-log saved by the last
run, converts it into HTML and opens the resulting file with a
textbrowser.
If files are given on the commandline they are expected to be (option‐
ally gzip/bzip2-compressed) logfiles of du -akx /some/dir. It is up to
you to take care that the given directories/files represent the same
directory. gt5 will show lots of new files if you don't. ;-)
OPTIONS--cut-at float
Files and directories that are below float percent of their par‐
ents are not shown. Default is 0.1, gt5 will accept values
between 0.01 and 30.
--debug
Turn on debug. Generate HTML files and do not run browser.
--diff-dir directory
Use directory instead of ~/.gt5-diffs/ to read/store du-logs.
This switch is ignored if gt5 is only used with files.
--discard
Do not save the current state, in other words: be able to diff
against the old state again. This feature is disabled if gt5 is
only used with files.
--help Display brief help.
--link-files
Also insert links to files to access them from within gt5. This
can be very handy if your browser is configured to handle the
files MIME-type correctly. This feature is disabled if gt5 is
only used with files.
--max-depth int
Do not show anything below a depth of int directories. Default
is 5 (also see BUGS below).
--max-lines int
Only consider the int biggest files and directories within the
output of du.
--no-diffs
Use this if you are not interested in the history of the direc‐
tories processed, for example in /tmp.
--save-as file
DEPRECATED, use du -akx or du -ak (see --with-mounts), save the
output to a file and run gt5 against one (ore two) of these
files later.
--save-state
Force saving current state, overwriting a previous --discard.
(Some people seem to have gt5 aliased to 'gt5 --discard'.)
--verbose
Display messages.
--with-mounts
By default gt5 calls du with -akx to ignore mounted filesystems.
Use this to inspect mounted partitions too, i.e. call du with
-ak
HELPERS
If gawk or a textbrowser are missing and you want to install them into
~/bin (or /usr/local/bin if you have write access there), gt5 comes
with the following helpers:
--get-gawk
Download, compile and install a copy of gawk.
--get-links
Download, compile and install a copy of links.
--get-links2
Download, compile and install a copy of links2.
--get-elinks
Download, compile and install a copy of elinks.
TEXTBROWSERS
It is recommended to use links with gt5. Other textbrowsers are also
possible but there are several good reasons why links is given priority
over the others:
elinks:
links is much faster on startup/exit
lynx: does not honor a documents coloring
netrik:
no colors, unfavourable cursor navigation
retawq:
no colors, can't handle <a name>-tags
w3m: Version 0.5.2 and later are known to work. Older versions expe‐
rienced unfavourable handling of <a name>-tag, unfavourable cur‐
sor navigation and no colors
Only links/links2, elinks and lynx are now considered usable (and also
chosen in that order). See ENVIRONMENT/GT5_BROWSER below.
FILES
~/.gt5.html
contains a copy of the last run
~/.gt5-diffs/
compressed du-logs are stored here
ENVIRONMENT
GT5_BROWSER
force using a (specific) textbrowser
GT5_CHARSET
force using a (specific) charset for HTML header instead of
using $LANG
GT5_DEBUG_DIR
Directory where to write gt5.debug* data if --debug option is
set.
BUGS
Directories at depth max-depth are not browsable and so look like
files.
AUTHOR
Thomas Sattler <gt5 at gmx dot net>
SEE ALSOdu(1), links(1), elinks(1), lynx(1)gt5 v1.4.0.1 July 2009 gt5(1)
