NAME¶
mixmaster-update - Fetch new reliability stats and keyrings for mixmaster
SYNOPSIS¶
- mixmaster-update [--verbose] [--source=SOURCE]
[ --configfile=FILE]
[--destination=DIRECTORY]
- 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=SOURCE
- Use this built in stats source.
- --configfile=FILE
- Also parse the configuration file FILE.
- --destination=DIRECTORY
- Write output to DIRECTORY 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
- MIXMASTER_UPDATE_CONF 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
- MIXMASTER_ALLPINGERS environment
- --allpingers parameter
These files are parsed in this order. Later definitions overwrite older ones.
The
allpingers.txt is a list of all pingers.
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 ("#") sign as their first non whitespace character.
Lines are always truncated at the first hash our pound ("#") 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 URL. 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¶
- MIXMASTER_UPDATE_CONF
- MIXMASTER_ALLPINGERS
- See the FILES section abobe.
- HOME
- Your homedirectory. Used for finding your user configuration file. Also
the default destination directory is $HOME/.Mix/
SEE ALSO¶
mixmaster(1)
BUGS¶
Please report them to the Debian Bug Tracking System as described at
"
http://bugs.debian.org/" or use a tool like
reportbug(1).
AUTHOR¶
Peter Palfrader <peter@palfrader.org>