.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "MIXMASTER-UPDATE 1" .TH MIXMASTER-UPDATE 1 "2017-08-10" "$Revision: 459 $" "mixmaster-update" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" mixmaster\-update \- Fetch new reliability stats and keyrings for mixmaster .SH "SYNOPSIS" .IX Header "SYNOPSIS" .IP "\fBmixmaster-update\fR [\fB\-\-verbose\fR] [\fB\-\-source\fR=\fI\s-1SOURCE\s0\fR] [\fB\-\-configfile\fR=\fI\s-1FILE\s0\fR] [\fB\-\-destination\fR=\fI\s-1DIRECTORY\s0\fR]" 4 .IX Item "mixmaster-update [--verbose] [--source=SOURCE] [--configfile=FILE] [--destination=DIRECTORY]" .PD 0 .IP "\fBmixmaster-update\fR \fB\-\-list\-sources\fR" 4 .IX Item "mixmaster-update --list-sources" .IP "\fBmixmaster-update\fR \fB\-\-help\fR" 4 .IX Item "mixmaster-update --help" .IP "\fBmixmaster-update\fR \fB\-\-version\fR" 4 .IX Item "mixmaster-update --version" .PD .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBmixmaster-update\fR is a simple yet configurable script that downloads latest remailer reliability statistics and keyrings for your mixmaster. .PP 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. .PP \&\fBmixmaster-update\fR has several built in stats sources. You can view the list of stats sources with the \fB\-\-list\-sources\fR parameter. .PP If you want to make use of another stats source which is not listed in the output of \fB\-\-list\-sources\fR you can do so by setting the location of \fBmlist\fR and others in your configuration file. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-verbose\fR" 4 .IX Item "--verbose" Print verbose output to standard output. May be given more than once to increase verbosity. .IP "\fB\-\-source\fR=\fI\s-1SOURCE\s0\fR" 4 .IX Item "--source=SOURCE" Use this built in stats source. .IP "\fB\-\-configfile\fR=\fI\s-1FILE\s0\fR" 4 .IX Item "--configfile=FILE" Also parse the configuration file \fI\s-1FILE\s0\fR. .IP "\fB\-\-destination\fR=\fI\s-1DIRECTORY\s0\fR" 4 .IX Item "--destination=DIRECTORY" Write output to \fI\s-1DIRECTORY\s0\fR rather than the directory given in the config file or ~/.Mix/. .IP "\fB\-\-list\-sources\fR" 4 .IX Item "--list-sources" List available stats sources. .IP "\fB\-\-help\fR" 4 .IX Item "--help" Print a brief help message and exit successfully. .IP "\fB\-\-version\fR" 4 .IX Item "--version" Print a version information and exit successfully. .SH "FILES" .IX Header "FILES" .IP "\fB/etc/mixmaster/update.conf\fR" 4 .IX Item "/etc/mixmaster/update.conf" .PD 0 .IP "\fB~/.Mix/update.conf\fR" 4 .IX Item "~/.Mix/update.conf" .IP "\s-1MIXMASTER_UPDATE_CONF\s0 environment" 4 .IX Item "MIXMASTER_UPDATE_CONF environment" .IP "\fB\-\-configfile\fR parameter" 4 .IX Item "--configfile parameter" .PD .PP 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 .IP "\fB/etc/mixmaster/allpingers.txt\fR" 4 .IX Item "/etc/mixmaster/allpingers.txt" .PD 0 .IP "\fB~/.Mix/allpingers.txt\fR" 4 .IX Item "~/.Mix/allpingers.txt" .IP "\s-1MIXMASTER_ALLPINGERS\s0 environment" 4 .IX Item "MIXMASTER_ALLPINGERS environment" .IP "\fB\-\-allpingers\fR parameter" 4 .IX Item "--allpingers parameter" .PD .PP These files are parsed in this order. Later definitions overwrite older ones. The \fBallpingers.txt\fR is a list of all pingers. .SH "FILEFORMAT" .IX Header "FILEFORMAT" The \fBupdate.conf\fR configuration file for \fBmixmaster-update\fR is simple. Lines with whitespace only are ignored as are lines that have the hash our pound (\f(CW\*(C`#\*(C'\fR) sign as their first non whitespace character. .PP Lines are always truncated at the first hash our pound (\f(CW\*(C`#\*(C'\fR) sign. .PP Lines are pairs of keys and values separated by a convenient amount of whitespace. The key is case insensitive. .PP Allowed keys: .IP "\fBsource\fR" 4 .IX Item "source" Use the builtin stats source with this name .IP "\fBdestination\fR" 4 .IX Item "destination" Write the downloaded data to this directory rather than ~/.Mix .IP "\fBproxy\fR" 4 .IX Item "proxy" Set proxies for different protocols. The value is split into two parts: protocol and proxy \s-1URL.\s0 They are separated by whitespace. .Sp .Vb 3 \& Example: \& PROXY http http://proxy.example.com:8080/ \& PROXY ftp http://proxy.example.com:8080/ .Ve .PP The format for \fBallpingers.txt\fR is simple too: .PP .Vb 10 \& [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 .Ve .PP The file may contain several such definitions. .SH "ENVIRONMENT" .IX Header "ENVIRONMENT" .IP "\s-1MIXMASTER_UPDATE_CONF\s0" 4 .IX Item "MIXMASTER_UPDATE_CONF" .PD 0 .IP "\s-1MIXMASTER_ALLPINGERS\s0" 4 .IX Item "MIXMASTER_ALLPINGERS" .PD See the \s-1FILES\s0 section abobe. .IP "\s-1HOME\s0" 4 .IX Item "HOME" Your homedirectory. Used for finding your user configuration file. Also the default destination directory is \f(CW$HOME\fR/.Mix/ .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBmixmaster\fR(1) .SH "BUGS" .IX Header "BUGS" Please report them to the Debian Bug Tracking System as described at \&\f(CW\*(C`http://bugs.debian.org/\*(C'\fR or use a tool like \fIreportbug\fR\|(1). .SH "AUTHOR" .IX Header "AUTHOR" Peter Palfrader