README:

This software is being distributed under the GNU Public License,
see the file GNU.license for more details.

Rsaref is copyright RSA Laboratories, and is distributed under
its own license. The text of that license is in the rsaref/doc directory.


Installation
============

Mixmaster uses the same source & binary for the remailer program and
the client program. Setting up a client, however, is significantly
easier.

You will need a directory to put your Mixmaster files. If your home
directory is bob, you may want to use bob/.mix as your directory, so
that it is hidden. In any case, you need to specify the FULL pathname
how Mixmaster should find your files.


Instructions for compiling Mixmaster
------------------------------------

To build Mixmaster, cd to Mix/Src and in the Makefile set MIXPATH to
the directory you are using. The default is $HOME/Mix.

Then type `make' or `make system' where system is one of: alpha, bsdi,
hpux, linux, solaris, sunos.

If you are compiling this for a remailer, you must specify the
passphrase at compile time.
Do this by running make with `make system PASS="your pass phrase"'.

You should now have a working version of Mixmaster.

Solaris 2.4 (SunOS 5.4):
   If you get an error about ranlib when compiling rsaref
   it is probably safe to ignore it.


Mixmaster as a client
---------------------

Put a list of Mixmaster remailers (type2.list) and their public keys
(pubring.mix) into your Mixmaster directory. You can get a list of
remailers and their keys from WWW page http://obscura.com/~loki
Or if you're paranoid, get them directly from the remailers and slap
them into the proper files yourself with your favorite editor.

If you are using a pre-compiled Mixmaster version, you will need to
set the environment variable MIXPATH to be the full path to the
directory with Mixmaster's files.

Put your mixmaster binary somewhere where you want to run it from.


See the manual page for instructions on using Mixmaster to create
remailer messages and README.remailer on setting up a remailer.


======================
Credit where credit is due:
   I have had help on this project from many people.
   Many uncredited ideas, and pieces of code were provided by the Mixmaster
   beta test team. They were:
      John A. Perry <perry@jpunix.com>
      L. McCarthy <lmccarth@opine.cs.umass.edu>
      John B. Fleming <jfleming@kether.alias.net>
      Andre' M. VanKlaveren vanklava@eniac.ac.siue.edu
      rfritz@spiff.ccs.carleton.ca (Ron Fritz)

   For asistance after the release of version 2.0:
      Patrick J. LoPresti <patl@lcs.mit.edu>
      Mark Hahn <hahn@neurocog.lrdc.pitt.edu>

   For significant contributions to release 2.0.3
      Jim Castleberry <jcastle@in-system.com>
      Ulf Moeller <Ulf.Moeller@hamburg.netsurf.de>

   Finally, I thank my wife Barbara for supporting me through all those nights
   in front of the computer.

Lance Cottrell     1 Oct 1995
<loki@obscura.com>
