/[pkg-mixmaster]/trunk/Mix/mixmaster.1

Diff of /trunk/Mix/mixmaster.1

Parent Directory | Revision Log | View Patch Patch

-trunk/Mix/mix.1
revision 545 by weaselp,
Mon Jul  7 11:18:20 2003 UTC
+trunk/Mix/mixmaster.1
revision 967 by colin,
Mon Jan 14 17:28:37 2008 UTC
 Line 1
- .TH MIX 1 "Mixmaster Version 3.0 beta"
+ .TH MIXMASTER 1 "Mixmaster Version 3.0 beta"
- .\" $Id: mix.1,v 1.31 2003/07/07 11:18:20 weaselp Exp $
+ .\" $Id$
  .SH NAME
- mix \- anonymous remailer software
+ mixmaster \- anonymous remailer software
  .SH SYNOPSIS
- .B mix
+ .B mixmaster
  [\fB\-hpmdSvT\fR]
  [\fB\-t \fIuser@host\fR]
  [\fB\-g \fInewsgroup\fR]
  [\fB\-s \fIsubject\fR]
  [\fB\-a \fIfilename\fR]
- [\fB\-n \fInym\fR]
  [\fB\-l \fImix1,mix2,mix3,...\fR]
  [\fB\-c \fInum\fR]
  [\fIuser@host\fR]
  [\fIfilename\fR]
  .PP
- .B mix
+ .B mixmaster
  [\fB\-f\fR[\fBrfg\fR] \fIfilename\fR]
  .PP
- .B mix \-\-nym\-config=\fIyournym \fR[\fBname=\fIPseudonym\fR]
+ .B mixmaster \fR[\fB\-RGKSP\fR]
- [\fBopt=\fInymserver options\fR] [\fB\-\-latency=\fIhours\fR]
- [\fB\-\-reply\-chain=\fIrem1,rem2,...\fR]
- .PP
- .B mix \fR[\fB\-RGKSP\fR]
  .SH DESCRIPTION
  Mixmaster is an anonymous remailer. Remailers provide protection
  against traffic analysis and allow sending mail anonymously or
-Line 32 
 In the non-interactive mode, Mixmaster r
+Line 27 
 In the non-interactive mode, Mixmaster r
  standard input or from a file.  Destination address and input file can
  be specified in the command line.  If no address is given in the
  command line, the input file is expected to contain a message complete
- with mail headers.  Messages to be sent under a pseudonym must contain
+ with mail headers.
- a
- .I Nym:
- header rather than
- .IR From: .
  .SH OPTIONS
  .TP
  .B "\-h, \-\-help"
  Print a summary of command line options.
  .TP
+ .B "\-V, \-\-version"
+ Print version information.
+ .TP
+ .B "\-\-about"
+ Print authorship and copyright information.
+ .TP
  .B "\-\-config=\fIfilename"
  Read configuration from an alternate file.
  .TP
-Line 74 
 Attach
+Line 71 
 Attach
  .I file
  to the message.
  .TP
- .B "\-n, \-\-nym=\fIyournym"
- Use the given pseudonym to send the message.
- .TP
  .B \-\-encrypt
  Encrypt the message using the OpenPGP format.
  .TP
-Line 121 
 Post a follow-up to a message.
+Line 115 
 Post a follow-up to a message.
  .B "\-fg\fR [\fIfile\fR]"
  Send a group reply to a message.
  .TP
- .B "\-\-nym\-config=\fInym \fR[\fBname=\fIPseudonym\fR] [\fBopt=\fInymserver options\fR]"
+ .B "\-\-update-pinger-list"
- Generate a pseudonym.
+ Download an updated all pingers list file.
- For example, to set up a pseudonym with two mail reply blocks and nym
- server acknowledgment for successfully remailed messages:
- .PP
- mix --nym-config=yournym@nym.alias.net opt=+acksend --to=user@domain
- --reply-chain=privacy,hr13,hyper --to=user@domain
- --reply-chain=replay,squirrel,mix
- To use a message pool:
- .PP
- mix --nym-config=yournym@nym.alias.net
- --post-to=alt.anonymous.messages
- --subject="secret message" --reply-chain=base
  .TP
- .B "\-\-latency=\fIhours"
+ .B "\-\-update-stats\fI[=source\fR]"
- Reply chain latency.
+ Download updated stats.
- .TP
- .B "\-\-reply\-chain=\fIrem1,rem2,..."
- Reply chain for the pseudonym.
  .SS Remailer options:
  .TP
  .B "\-\-config=\fIfilename"
-Line 189 
 Remove the Mixmaster Service on Win32.
+Line 167 
 Remove the Mixmaster Service on Win32.
  .TP
  .B \-\-run\-svc
  Run the Mixmaster Service on Win32.
+ .TP
+ .B \-\-redirect
+ Read a Mixmaster packet from stdin and route it through a chain given with
+ .B \-\-no\-ask\-passphrase
+ Do not ask for the remailer passphrase even if we don't have it compiled in,
+ don't have it in the config file, don't have it in the environment and we are
+ on a tty.
+ \fB\-\-chain\fP.
+ Note that this may corrupt the packet if there is not enough space in the
+ headers (that is, if there are more than 20 hops total).  This function is
+ not normally needed but may come in handy in certain cases.
  .SH CONFIGURATION
  Mixmaster reads its configuration from the file
  .B mix.cfg
-Line 206 
 script when setting up a remailer.
+Line 195 
 script when setting up a remailer.
  .PP
  All configuration variables can be overridden from the command line,
  e.g.
- .B mix -S --POOLSIZE=0 --RATE=100
+ .B mixmaster -S --POOLSIZE=0 --RATE=100
  will send all messages currently in the message pool.
  .SS Client configuration:
  .TP
-Line 260 
 Only select remailers with a latency of
+Line 249 
 Only select remailers with a latency of
  Default:
  .BR 36h .
  .TP
+ .B MINLAT
+ Only select remailers with a latency of at least
+ .IR MINLAT .
+ Default:
+ .BR 5m .
+ .TP
  .B PGPPUBRING
  Path to your public PGP key ring. Default:
  .BR ~/.pgp/pubring.pkr .
-Line 275 
 If
+Line 270 
 If
  .B REMAIL
  is set to
  .BR n
- automatically flush the pool every time mixmaster is run. Default:
+ automatically flush the pool every time Mixmaster is run. Default:
  .BR n .
  .TP
  .B SENDMAIL
-Line 315 
 used to send non-anonymous messages,
+Line 310 
 used to send non-anonymous messages,
  is used instead.)
  Default:
  .IR ANONADDR .
+ .TP
+ .B ALLPINGERSURL
+ URL from which to download the
+ .IR ALLPINGERSFILE .
+ Default:
+ .BR http://www.noreply.org/allpingers/allpingers.txt .
+ .TP
+ .B WGET
+ Define the http protocol download tool. Default:
+ .BR wget .
  .SS Remailer configuration:
  .TP
  .B NEWS
-Line 467 
 which is now deprecated.
+Line 472 
 which is now deprecated.
  This should
  .I not
  be the same as the client passphrase.
+ .TP
+ .B EXTFLAGS
+ Additional flags you want to set in the remailer's capabilities string.
+ Defaults to the empty string, which means none.  Example:
+ .BR testing .
+ .TP
+ .B PRECEDENCE
+ Sets the header Precedence: to this value for all outgoing mail.
+ Defaults to the empty string, which means no such header is added.
+ Example:
+ .BR anon .
+ If you use this you might want to block user supplied precedence
+ headers in your header block file.
  .PP
  The following variables can be set to
  .B y
-Line 503 
 Accept Mixmaster messages. Default:
+Line 521 
 Accept Mixmaster messages. Default:
  .B PGP
  Accept OpenPGP-encrypted Cypherpunk remailer messages.
  Default:
- .BR y .
+ .BR n .
  .TP
  .B UNENCRYPTED
  Accept unencrypted Cypherpunk remailer messages.
-Line 554 
 The following variables have numeric val
+Line 572 
 The following variables have numeric val
  .B POOLSIZE
  The size of the Mixmaster reordering pool. Larger sizes
  imply higher security and longer delays. Remailer default:
- .BR 20 .
+ .BR 45 .
  Client default:
  .BR 0 .
  .TP
  .B RATE
  Percentage of messages from the pool to be sent. Remailer default:
- .BR 95 .
+ .BR 65 .
  Client default:
  .BR 100 .
  Lower values cause the pool to increase in size when
-Line 578 
 a dummy generation, and
+Line 596 
 a dummy generation, and
  means that one in four will.
  .B 0
  means no dummy messages. Remailer default:
- .BR 20 .
+ .BR 10 .
  Client default:
  .BR 3 .
  .TP
-Line 594 
 processing.
+Line 612 
 processing.
  means four will be generated.
  .B 0
  means no dummy messages. Remailer default:
- .BR 67 .
+ .BR 90 .
  Client default:
  .BR 3 .
  .TP
-Line 638 
 Default:
+Line 656 
 Default:
  limits the number of allowed recipients in outgoing mail.  Anything that exceeds this
  number is dropped silently.  Default:
  .BR 5 .
+ .TP
+ .B TEMP_FAIL
+ exit with this exit code when a timeskew problem is suspected.  Also see
+ .BR TIMESKEW_BACK
+ and
+ .BR TIMESKEW_FORWARD .
+ The default of
+ .B 75
+ should cause your MTA to requeue the message if you are running
+ mixmaster from a
+ .BR .forward
+ file.
+ .TP
+ .B STATSAUTOUPDATE
+ Set non-zero to enable Daemon stats download mode. Default:
+ .BR 0 .
  .PP
- The following are time variables. They can be given as days, hours, or
+ The following are time variables. They can be given as years (
- minutes.
+ .BR y
+ ), months (
+ .BR b
+ ), days (
+ .BR d
+ ), hours (
+ .BR h
+ ), minutes (
+ .BR m
+ ), or seconds (
+ .BR s
+ ).
  .TP
  .B SENDPOOLTIME
  How often Mixmaster should check the pool for messages
  to be sent. Remailer default:
- .BR 1h .
+ .BR 15m .
  Client default:
  .BR 0h .
  .TP
-Line 688 
 minimum:
+Line 733 
 minimum:
  If set to
  .BR 0 ,
  no log is kept.
+ .TP
+ .B KEYLIFETIME
+ Mixmaster sets an expiration date on its remailer keys
+ .B KEYLIFETIME
+ after the key creation date. Default:
+ .BR 13b .
+ .TP
+ .B KEYGRACEPERIOD
+ Mixmaster will continue to decrypt messages encrypted to an expired key
+ for
+ .B KEYGRACEPERIOD
+ period of time after the expiration. This is done to ensure that messages
+ already injected into the network are allowed to exit. Do not change this
+ value unless you know what you are doing, or you will risk partitioning
+ attacks. Default:
+ .BR 7d .
+ .TP
+ .B KEYOVERLAPPERIOD
+ Mixmaster will generate and advertise a new key
+ .BR KEYOVERLAPPERIOD
+ period of time before the expiration of the key. Clients should always use
+ the most recently created valid key. Clients that deviate from this
+ recommended behavior risk partitioning attacks. Default:
+ .BR 7d .
+ .TP
+ .B TIMESKEW_BACK
+ Allow going back up to
+ .BR TIMESKEW_BACK
+ in time.  If the time moved further back mixmaster will assume
+ there is a problem with your clock and refuse to start as a remailer.
+ This is done by comparing the latest timestamp in
+ .BR time.log
+ with the current timestamp.  If set to
+ .BR 0
+ then this test is skipped.  If the system time is indeed correct, simply
+ remove
+ .BR time.log .
+ Default:
+ .BR 12h .
+ .TP
+ .B TIMESKEW_FORWARD
+ Similar to
+ .BR TIMESKEW_BACK
+ but allow jumping this far into the future.
+ Default:
+ .BR 2w .
+ .TP
+ .B STATSINTERVAL
+ Time interval between daemon downloads of stats files. Enabled by
+ .BR STATSAUTOUPDATE .
+ Default:
+ .BR 2h .
  .PP
  The following strings must be specified at compile-time in
  .BR config.h .
-Line 888 
 keyword "apop" or "pass" to select an au
+Line 985 
 keyword "apop" or "pass" to select an au
  .B dest.alw
  List of addresses to which Mixmaster will deliver, even in middleman mode (\fBDESTALLOW\fP).
  .TP
+ .B dest.alw.nonpublished
+ Similar to
+ .BR dest.alw ,
+ with the only difference that this list is not published in remailer-conf replies (\fBDESTALLOW2\fP).
+ .TP
  .B dest.blk
  List of blocked destination addresses.
  Mixmaster does not send mail to the blocked addresses listed in this file (\fBDESTBLOCK\fP).
-Line 931 
 are supported. For example
+Line 1033 
 are supported. For example
  would allow user-defined names in the
  .B From:
  line, while replacing any given address with the remailer address.
+ .TP
+ .B allpingers.txt
+ Information on all known pingers (\fBALLPINGERSFILE\fP).
  .SS
  Mixmaster uses the following files internally:
  .TP
  .B mixrand.bin
  Random seed file (\fBMIXRAND\fP).
  .TP
- .B secrets.mix
- List of your nyms with configuration data (encrypted) (\fBNYMDB\fP).
- .TP
- .B nymsec.pgp
- Your nyms' secret PGP keys (encrypted) (\fBNYMSECRING\fP).
- .TP
  .B secring.pgp
  Remailer type 1 secret keys (\fBPGPREMSECRING\fP).
  .TP
-Line 956 
 The public type 1 remailer key (\fBPGPKE
+Line 1055 
 The public type 1 remailer key (\fBPGPKE
  The public type 2 remailer key (\fBKEYFILE\fP).
  .TP
  .B id.log
- Log file of messages already processed (\fBKEYFILE\fP).
+ Log file of messages already processed (\fBIDLOG\fP).
  .TP
  .B stats.log
  Log file for remailer statistics (\fBSTATS\fP).
  .TP
+ .B stats-src.txt
+ File for name of most recent statistics source (\fBSTATSSRC\fP).
+ .TP
  .B pgpmaxcount.log
  Log file for PGP Max-Count statistics (\fBPGPMAXCOUNT\fP).
  .TP
-Line 973 
 Public Diffie-Hellman parameters used fo
+Line 1075 
 Public Diffie-Hellman parameters used fo
  .B dsaparam.mix
  Public DSA parameters used for DSA key generation (\fBDSAPARAMS\fP).
  .TP
- .B mix.pid
+ .B mixmaster.pid
  Pid file in daemon mode (\fBPIDFILE\fP).
  .TP
  .BI pool/
-Line 1005 
 The passphrase used to protect your nyms
+Line 1107 
 The passphrase used to protect your nyms
  .I MIXPASS
  is not set, the client will ask for a passphrase.
  .SH SEE ALSO
+ .BR mpgp (1),
  .BR pgp (1),
  .BR procmail (1),
  .BR sendmail (8).
+ .SH HISTORY
+ Mixmaster is an implementation of a Chaumian mix-net system.
+ Versions 1.0 through 2.0.3 of the
+ .BR mixmaster
+ remailer were originally written by Lance Cottrell. Mixmaster was first
+ released in 1995. Ulf Moeller collaborated on version 2.0.4, and began an
+ entire rewrite of
+ .BR mixmaster
+ in 1999. This rewrite was released in 2002 as version 2.9.0, with major
+ contributions from Janis Jagars, Peter Palfrader, and Len Sassaman.
+ Mixmaster 3.0 is based on the 2.9 codebase. Peter Palfrader and Len
+ Sassaman are the principal maintainers. For more information on
+ contributing authors, please see the file THANKS for details.
  .SH COPYRIGHT
- (C) 1999 Anonymizer Inc.
+ (C) 1999 - 2006 Anonymizer Inc. and others.
  Mixmaster may be redistributed and modified under certain conditions.
  This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF
  ANY KIND, either express or implied. See the file COPYRIGHT for

 Legend:



Removed from v.545
 


changed lines


 
Added in v.967
 Legend:



Removed from v.545
 


changed lines


 
Added in v.967
-Removed from v.545
+Added in v.967

	ViewVC Help
Powered by ViewVC 1.1.5