SYNOPSIS

mixmaster-update [--verbose] [--source=\s-1SOURCE\s0] [--configfile=\s-1FILE\s0] [--destination=\s-1DIRECTORY\s0]
mixmaster-update --list-sources
mixmaster-update --help
mixmaster-update --version

DESCRIPTION

mixmaster-update is a simple yet configurable script that downloads latest remailer reliability statistics and keyrings for your mixmaster.

As having uptodate reliability statistics is imperative if you want to make use of remailers it is recommended that you always update this data should it be older that twelve or twentyfour hours and you intent to use mixmaster.

mixmaster-update has several built in stats sources. You can view the list of stats sources with the --list-sources parameter.

If you want to make use of another stats source which is not listed in the output of --list-sources you can do so by setting the location of mlist and others in your configuration file.

OPTIONS

--verbose

Print verbose output to standard output. May be given more than once to increase verbosity.

--source=\s-1SOURCE\s0

Use this built in stats source.

--configfile=\s-1FILE\s0

Also parse the configuration file \s-1FILE\s0.

--destination=\s-1DIRECTORY\s0

Write output to \s-1DIRECTORY\s0 rather than the directory given in the config file or ~/.Mix/.

--list-sources

List available stats sources.

--help

Print a brief help message and exit successfully.

--version

Print a version information and exit successfully.

FILES

/etc/mixmaster/update.conf
~/.Mix/update.conf
\s-1MIXMASTER_UPDATE_CONF\s0 environment
--configfile parameter

These files are parsed in this order. Later definitions overwrite older ones. This config file defines proxy settings, where to write the results to and which stats source to use

/etc/mixmaster/allpingers.txt
~/.Mix/allpingers.txt
\s-1MIXMASTER_ALLPINGERS\s0 environment
--allpingers parameter

These files are parsed in this order. Later definitions overwrite older ones. The allpingers.txt is a list of all pingers.

FILEFORMAT

The update.conf configuration file for mixmaster-update is simple. Lines with whitespace only are ignored as are lines that have the hash our pound (\*(C`#\*(C') sign as their first non whitespace character.

Lines are always truncated at the first hash our pound (\*(C`#\*(C') sign.

Lines are pairs of keys and values separated by a convenient amount of whitespace. The key is case insensitive.

Allowed keys:

source

Use the builtin stats source with this name

destination

Write the downloaded data to this directory rather than ~/.Mix

proxy

Set proxies for different protocols. The value is split into two parts: protocol and proxy \s-1URL\s0. They are separated by whitespace.

  Example:
    PROXY  http  http://proxy.example.com:8080/
    PROXY  ftp   http://proxy.example.com:8080/

The format for allpingers.txt is simple too:

[example] base = http://stats.example.net/ rlist = http://stats.example.net/rlist.txt mlist = http://stats.example.net/mlist.txt rlist2 = http://stats.example.net/rlist2.txt mlist2 = http://stats.example.net/mlist2.txt rlist_html = http://stats.example.net/rlist.html mlist_html = http://stats.example.net/mlist.html rlist2_html = http://stats.example.net/rlist2.html mlist2_html = http://stats.example.net/mlist2.html rchain_html = http://stats.example.net/mlist2.html pgpring = http://stats.example.net/pgp-all.asc pgpring_rsa = http://stats.example.net/pgp-rsa.asc mixring = http://stats.example.net/pubring.mix type2list = http://stats.example.net/type2.list

The file may contain several such definitions.

ENVIRONMENT

\s-1MIXMASTER_UPDATE_CONF\s0
\s-1MIXMASTER_ALLPINGERS\s0

See the \s-1FILES\s0 section abobe.

\s-1HOME\s0

Your homedirectory. Used for finding your user configuration file. Also the default destination directory is $HOME/.Mix/

RELATED TO mixmaster-update…

BUGS

Please report them to the Debian Bug Tracking System as described at \*(C`http://bugs.debian.org/\*(C' or use a tool like reportbug\|(1).

AUTHOR

Peter Palfrader <[email protected]>