/[pkg-mixmaster]/trunk/Mix/README
ViewVC logotype

Diff of /trunk/Mix/README

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 647 by weasel, Sat Oct 25 23:34:13 2003 UTC revision 695 by ulf, Sun Jan 11 15:47:27 2004 UTC
# Line 8  This program consists of Line 8  This program consists of
8  * a remailer client:  * a remailer client:
9    
10    The remailer client supports sending anonymous mail using Cypherpunk    The remailer client supports sending anonymous mail using Cypherpunk
11    and Mixmaster remailers, managing pseudonyms at Newnym nym servers    and Mixmaster remailers. It supports OpenPGP encryption (compatible
12    and receiving mail anonymously from Cypherpunk remailers. It supports    with PGP 2, PGP 5 and up, and GnuPG).
   OpenPGP encryption (compatible with PGP 2, PGP 5 and up, and GnuPG).  
13    
14    The client can be used with a menu-based user interface and with    The client can be used with a menu-based user interface and with
15    command line options.    command line options.
# Line 31  Installation: Line 30  Installation:
30    
31  Libraries:  Libraries:
32    
33    Mixmaster uses the cryptographic library OpenSSL. If you want to use    Mixmaster requires the libraries OpenSSL, zlib, and pcre.
34    the menu-based user interface, you also need the ncurses library. If  
35    these libraries are not installed on your system, get them from    If you want to use the menu-based user interface, you also need the
36    ftp://mixmaster.anonymizer.com/ and extract them in the Src    ncurses library. If these libraries are not installed on your
37    directory first.    system, you will need to obtain the latest versions from the
38      sources below and extract them in the the Src/ directory first.
39    
40      OpenSSL is available from http://www.openssl.org/source/
41    
42      Ncurses can be obtained from http://ftp.gnu.org/pub/gnu/ncurses/
43    
44    The Perl Compatable Regular Expressions library can be obtained from    The Perl Compatable Regular Expressions library can be obtained from
45    ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/    ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/
46    
47    The zlib compression libraries can be obtained at    The zlib compression libraries can be obtained from
48    http://www.gzip.org/zlib/    http://www.gzip.org/zlib/
49    
50  To install or upgrade Mixmaster, type `./Install'.  To install or upgrade Mixmaster, type `./Install'.
# Line 56  finger from nym.alias.net: Line 60  finger from nym.alias.net:
60    mlist.txt      List of reliable type 2 remailers    mlist.txt      List of reliable type 2 remailers
61    type2.list     List of known type 2 remailers (optional)    type2.list     List of known type 2 remailers (optional)
62    
63  If you wish to participate in the Remailer Abuse Blocklist, you will need  If you wish to participate in the Remailer Abuse Blocklist[1], you will need
64  to obtain the blocklist file from http://www.paracrypt.com/remailerabuse/  to obtain the blocklist file from http://www.paracrypt.com/remailerabuse/
65  and place it in your Mix directory. This may be automated with cron.  and place it in your Mix directory. This may be automated with cron.
66    
# Line 66  and add additional block files to the ex Line 70  and add additional block files to the ex
70  #define DESTBLOCK "dest.blk rab.blk rab2.blk rab3.blk"  #define DESTBLOCK "dest.blk rab.blk rab2.blk rab3.blk"
71    
72  Note that only the first file should the the local block list, as it is the  Note that only the first file should the the local block list, as it is the
73  only file mix will open for writing. Most users will not need to edit  only file mixmaster will open for writing. Most users will not need to edit
74  config.h.  config.h.
75    
76    [1] Update: As of the release of Mixmaster 3.0, the Paracrypt RAB site is
77    defunct. This information has been left in the documentation should
78    another service take its place.
79    
80  Using the remailer client:  Using the remailer client:
81  -------------------------  -------------------------
82    
83  To use the menu-based user interface, simply run `mix'. To send an  To use the menu-based user interface, simply run `mixmaster'. To send an
84  anonymous or pseudonymous reply to a message from within your mail or  anonymous or pseudonymous reply to a message from within your mail or
85  news reader, you can pipe it to `mix'.  news reader, you can pipe it to `mixmaster'.
86    
87  The interactive mode supports sending mail, manages pseudonymous  The interactive mode supports sending mail and contains a simple
88  accounts at nym servers and contains a simple mail reading function.  mail reading function. OpenPGP messages are encrypted and decrypted
89  OpenPGP messages are encrypted and decrypted automatically. It can  automatically.
 also decrypt messages encrypted to ordinary non-anonymous OpenPGP keys  
 if you use the same passphrase for the nyms as for the OpenPGP key.  
90    
91  In the non-interactive mode, Mixmaster reads a message from a file or  In the non-interactive mode, Mixmaster reads a message from a file or
92  from its standard input. The command line options are described in the  from its standard input. The command line options are described in the
93  manual page (mix.1).  manual page (mixmaster.1).
94    
95    
96  Mixmaster as a remailer:  Mixmaster as a remailer:
# Line 98  you have root access, you may want to cr Line 103  you have root access, you may want to cr
103    
104  The Install script provides a simple way to set up the remailer. More  The Install script provides a simple way to set up the remailer. More
105  information about configuring Mixmaster can be found in the manual  information about configuring Mixmaster can be found in the manual
106  page. Typically, incoming mail is piped to "mix -RM". In a UUCP  page. Typically, incoming mail is piped to "mixmaster -RM". In a UUCP
107  setting, it may be useful to use just "mix -R", and run "mix -S" once  setting, it may be useful to use just "mixmaster -R", and run
108  all messages have arrived.  "mixmaster -S" once all messages have arrived.
109    
110  Announcing a new remailer to the public is most commonly done by posting  Announcing a new remailer to the public is most commonly done by posting
111  the remailer keys and capabilities to alt.privacy.anon-server as well as  the remailer keys and capabilities to alt.privacy.anon-server as well as
112  the "remops" mailing list. Information about the remops list can be found  the "remops" mailing list. Information about the remops list can be found
113  here: http://lexx.shinn.net/mailman/listinfo/remops  here: http://lexx.shinn.net/mailman/listinfo/remops
114    
 To upgrade from a Mixmaster 2.0.* remailer installation, make a  
 backup of your keys and configuration files before you run Install.  
   
115    
116  Installation problems:  Installation problems:
117  ---------------------  ---------------------
118    
119  In case one of the libraries Mixmaster uses is installed incorrectly  In case one of the libraries Mixmaster uses is installed incorrectly
120  on your system, place the library source code (available from  on your system, place the library source code (available from
121  ftp://mixmaster.anonymizer.com) in the Src directory, remove the old  the locations listed above) in the Src directory, remove the old
122  Makefile, run the Install script again and answer `y' when asked  Makefile, run the Install script again and answer `y' when asked
123  whether to use the source code.  whether to use the source code.
124    
Legend:
Removed from v.647  
changed lines
  Added in v.695
  ViewVC Help
Powered by ViewVC 1.1.5