SIMPLE SOLUTIONS

GT5(1) - Linux man page online | User commands

A diff-capable 'du-browser'.

Chapter
July 2009
gt5(1) General Commands Manual gt5(1)

NAME

gt5 - a diff-capable 'du-browser'

SYNOPSIS

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

DESCRIPTION

gt5 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 (optionally gzip/bzip2-com‐ pressed) 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 parents 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 fea‐ ture 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 directories 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 experienced unfavourable handling of <a name>-tag, unfavourable cursor 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 ALSO

du(1), links(1), elinks(1), lynx(1)
gt5 v1.4.0.1 July 2009 gt5(1)
This manual Reference Other manuals
gt5(1) referred by
refer to du(1) | elinks(1) | links(1) | lynx(1)
Download raw manual
Main page General Commands Manual (+12866) gt5 v1.4.0.1 (+1) № 1 (+39907)
Go top