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

Contents of /trunk/Mix/mixmaster.1

Parent Directory Parent Directory | Revision Log Revision Log


Revision 682 - (show annotations) (download)
Sun Nov 9 20:54:22 2003 UTC (9 years, 6 months ago) by rabbi
File size: 24422 byte(s)
Updated some documentation for key rotation features.
1 .TH MIX 1 "Mixmaster Version 3.0 beta"
2 .\" $Id$
3 .SH NAME
4 mix \- anonymous remailer software
5 .SH SYNOPSIS
6 .B mix
7 [\fB\-hpmdSvT\fR]
8 [\fB\-t \fIuser@host\fR]
9 [\fB\-g \fInewsgroup\fR]
10 [\fB\-s \fIsubject\fR]
11 [\fB\-a \fIfilename\fR]
12 [\fB\-l \fImix1,mix2,mix3,...\fR]
13 [\fB\-c \fInum\fR]
14 [\fIuser@host\fR]
15 [\fIfilename\fR]
16 .PP
17 .B mix
18 [\fB\-f\fR[\fBrfg\fR] \fIfilename\fR]
19 .PP
20 .B mix \fR[\fB\-RGKSP\fR]
21 .SH DESCRIPTION
22 Mixmaster is an anonymous remailer. Remailers provide protection
23 against traffic analysis and allow sending mail anonymously or
24 pseudonymously.
25 .PP
26 In the non-interactive mode, Mixmaster reads a message from its
27 standard input or from a file. Destination address and input file can
28 be specified in the command line. If no address is given in the
29 command line, the input file is expected to contain a message complete
30 with mail headers.
31 .SH OPTIONS
32 .TP
33 .B "\-h, \-\-help"
34 Print a summary of command line options.
35 .TP
36 .B "\-\-config=\fIfilename"
37 Read configuration from an alternate file.
38 .TP
39 .B "\-t, \-\-to=\fIuser@host"
40 Add the destination address(es) to the message header. The input file
41 contains the message body without headers.
42 .TP
43 .B "\-g, \-\-post-to=\fInewsgroup"
44 Add the newsgroup(s) to the message header. The input file
45 contains the message body without headers.
46 .TP
47 .B
48 \-p, \-\-post
49 Post the message to Usenet.
50 .TP
51 .B
52 \-m, \-\-mail
53 Send the message as electronic mail. (This is the default.)
54 .TP
55 .B "\-s, \-\-subject=\fIsubject"
56 Add the
57 .I subject
58 to the message header.
59 .TP
60 .B "\-\-header=\fI'Header: text'
61 Add the header line to the message header.
62 .TP
63 .B "\-a, \-\-attachment=\fIfilename"
64 Attach
65 .I file
66 to the message.
67 .TP
68 .B \-\-encrypt
69 Encrypt the message using the OpenPGP format.
70 .TP
71 .B \-\-sign
72 Sign the message using the OpenPGP format.
73 .TP
74 .B "\-l, \-\-chain=\fImix1,mix2,mix3,..."
75 Use this remailer chain to send the message. Alternatively, the input
76 message may contain a pseudo-header
77 .BR Chain: .
78 If no chain is specified, Mixmaster will use a chain of four random
79 remailers.
80 .TP
81 .B "\-T, \-\-type\-list"
82 Display the contents of the
83 .BR type2.list
84 file.
85 .TP
86 .B "\-c, \-\-copies=\fInum"
87 Send
88 .I num
89 copies of the message to increase reliability.
90 .TP
91 .B \-d, \-\-dummy
92 Generate a dummy message as protection against traffic analysis.
93 .TP
94 .B \-S, \-\-send
95 Send the message(s) from the pool.
96 .TP
97 .B \-v, \-\-verbose
98 Output informational messages.
99 .TP
100 .B "\-f\fR [\fIfile\fR]"
101 Read a mail folder or news article. This function requires ncurses support.
102 .TP
103 .B "\-fr\fR [\fIfile\fR]"
104 Reply to a message.
105 .TP
106 .B "\-ff\fR [\fIfile\fR]"
107 Post a follow-up to a message.
108 .TP
109 .B "\-fg\fR [\fIfile\fR]"
110 Send a group reply to a message.
111 .SS Remailer options:
112 .TP
113 .B "\-\-config=\fIfilename"
114 Read configuration from an alternate file.
115 .TP
116 .B \-R, \-\-read\-mail
117 Read a remailer message from standard input and store it in the pool.
118 .TP
119 .B \-I, \-\-store\-mail
120 Read a remailer message from standard input and store it in the pool
121 without decrypting it immediately. It will be processed the next time
122 Mixmaster processes the queue (called with \fP-M\fP or in daemon mode).
123 .TP
124 .B \-P, \-\-pop-mail
125 Read mail from the POP3 servers listed in
126 .BR pop3.cfg .
127 .TP
128 .B \-M, \-\-remailer
129 Check if it is time to perform the regular remailer actions:
130 Send messages from the pool, get mail from POP3 servers and keep the
131 internal files up\-to\-date.
132 .TP
133 .B \-D, \-\-daemon
134 Detach from the console and process the pool, get mail and update the
135 internal files at regular intervals.
136 .TP
137 .B \-\-no-detach
138 Run as daemon but do not detach from the terminal (This option is
139 only useful together with \fB--daemon\fP).
140 .TP
141 .B -G, \-\-generate\-key
142 Generate a new remailer key.
143 .TP
144 .B \-K, \-\-update\-keys
145 Generate remailer keys if necessary.
146 .TP
147 .B \-S, \-\-send
148 Force sending the message(s) from the pool.
149 .TP
150 .B \-\-install\-svc
151 Install the Mixmaster Service on Win32.
152 .TP
153 .B \-\-remove\-svc
154 Remove the Mixmaster Service on Win32.
155 .TP
156 .B \-\-run\-svc
157 Run the Mixmaster Service on Win32.
158 .TP
159 .B \-\-redirect
160 Read a mixmaster packet from stdin and route it through a chain given with
161 \fB\-\-chain\fP.
162 Note that this may corrupt the packet if there is not enough space in the
163 headers (that is, if there are more than 20 hops total). This function is
164 not normaly needed but may come in handy in certain cases.
165 .SH CONFIGURATION
166 Mixmaster reads its configuration from the file
167 .B mix.cfg
168 in its working directory. The configuration file consists of lines of
169 the type
170 .PP
171 .I VARIABLE values
172 .PP
173 and of comments, which begin with a
174 .B #
175 character. The variables have reasonable default values, but it is
176 useful to create a configuration file using the
177 .B Install
178 script when setting up a remailer.
179 .PP
180 All configuration variables can be overridden from the command line,
181 e.g.
182 .B mix -S --POOLSIZE=0 --RATE=100
183 will send all messages currently in the message pool.
184 .SS Client configuration:
185 .TP
186 .B ADDRESS
187 Your address for sending non-anonymous messages.
188 .TP
189 .B NAME
190 Your real name (used for sending non-anonymous messages).
191 .TP
192 .B MAILtoNEWS
193 Address of a mail-to-news gateway. Default:
194 .BR mail2news@nym.alias.net .
195 .TP
196 .B CHAIN
197 Default chain for anonymous messages to be sent.
198 .B CHAIN
199 is a comma-separated list of remailer names or addresses.
200 A
201 .B *
202 represents a random reliable remailer. Default:
203 .BR *,*,*,* .
204 .TP
205 .B NUMCOPIES
206 Number of redundant copies of an anonymous message to be
207 sent, unless specified otherwise on the command line.
208 Default:
209 .BR 1 .
210 .TP
211 .B DISTANCE
212 When selecting random remailers, the chain will contain
213 .I DISTANCE
214 other remailers between two occurrences of the
215 same remailer in the chain. Default:
216 .BR 2 .
217 .TP
218 .B MINREL
219 Only select remailers with a reliability of at least
220 .IR MINREL %.
221 Default:
222 .BR 98 .
223 .TP
224 .B RELFINAL
225 Only select a remailer with a reliability of at least
226 .IR RELFINAL %
227 as the final remailer. Default:
228 .BR 99 .
229 .TP
230 .B MAXLAT
231 Only select remailers with a latency of at most
232 .IR MAXLAT .
233 Default:
234 .BR 36h .
235 .TP
236 .B PGPPUBRING
237 Path to your public PGP key ring. Default:
238 .BR ~/.pgp/pubring.pkr .
239 (Windows default: PGP registry value.)
240 .TP
241 .B PGPSECRING
242 Path to your secret PGP key ring. Default:
243 .BR ~/.pgp/secring.skr .
244 (Windows default: PGP registry value.)
245 .TP
246 .B CLIENTAUTOFLUSH
247 If
248 .B REMAIL
249 is set to
250 .BR n
251 automatically flush the pool every time mixmaster is run. Default:
252 .BR n .
253 .TP
254 .B SENDMAIL
255 Path to the
256 .BR sendmail (1)
257 program. If set to
258 .BR outfile ,
259 Mixmaster will create text files named
260 .BI out * .txt
261 in the
262 .B pool
263 directory instead of sending mail.
264 Default:
265 .BR "/usr/lib/sendmail -t" .
266 .TP
267 .B SMTPRELAY
268 Name of SMTP relay. If set, mail will be delivered to the relay
269 rather than by
270 .BR sendmail (1).
271 .TP
272 .B HELONAME
273 Host name used in the SMTP dialogue.
274 Default: The
275 .I ENVFROM
276 host name or the current network name associated with the socket.
277 .TP
278 .B SMTPUSERNAME
279 Some mail servers require authentication for sending mail. This is
280 the authenticated SMTP user name.
281 .B SMTPPASSWORD
282 Password for authenticated SMTP.
283 .TP
284 .B ENVFROM
285 Envelope from address used in the SMTP dialogue. (When the client is
286 used to send non-anonymous messages,
287 .I ADDRESSS
288 is used instead.)
289 Default:
290 .IR ANONADDR .
291 .SS Remailer configuration:
292 .TP
293 .B NEWS
294 Path to the news posting program, or address of a
295 mail-to-news gateway. Default: no news posting.
296 (When using a news posting program,
297 .I ORGANIZATION
298 contains
299 an Organization line for anonymous messages. Default:
300 .BR "Anonymous Posting Service" .)
301 .TP
302 .B SENDANONMAIL
303 Path to a program for sending anonymous mail. Default:
304 .IR SENDMAIL .
305 .B SENDANONMAIL
306 can be used to invoke an external mail filter for anonymized messages.
307 .TP
308 .B SHORTNAME
309 A short name for the remailer to be used in lists. Defaults to the host name.
310 .TP
311 .B REMAILERADDR
312 The remailer mail address.
313 .TP
314 .B ANONADDR
315 An address to be inserted in the
316 .B From:
317 line of anonymous messages. Default:
318 .IR REMAILERADDR .
319 .TP
320 .B REMAILERNAME
321 A name to be inserted in the
322 .B From:
323 line of remailer status
324 messages. Default:
325 .BR "Anonymous Remailer" .
326 .TP
327 .B ANONNAME
328 A name to be inserted in the
329 .B From:
330 line of anonymous messages.
331 Default:
332 .BR "Anonymous" .
333 .TP
334 .B COMPLAINTS
335 An address for complaints to be sent to. Default:
336 .IR REMAILERADDR .
337 .TP
338 .B ERRLOG
339 Name of a file to log error messages, or
340 .B stdout
341 or
342 .BR stderr .
343 Default:
344 .BR stderr .
345 (When run from a tty, Mixmaster will always print a copy of error
346 messages to
347 .BR stderr .)
348 .TP
349 .B MAILBOX
350 A generic mail folder for non-remailer messages that are not stored in
351 any of the following folders.
352 If
353 .B MAILBOX
354 begins with a
355 .BR | ,
356 it specifies the path to a program. If it contains an
357 .B @
358 sign, the message is forwarded to the given address (with an
359 .B X-Loop:
360 header to prevent mail loops). If it ends with a
361 .B /
362 it is treated as a Maildir, otherwise the message is appended
363 to the given file name or written to standard output if
364 .B MAILBOX
365 is
366 .BR stdout .
367 Default:
368 .BR mbox .
369 .TP
370 .B MAILABUSE
371 Mail folder for messages sent to the
372 .I COMPLAINTS
373 address.
374 Default:
375 .IR MAILBOX .
376 .TP
377 .B MAILBLOCK
378 Mail folder for messages sent to the remailer address with a
379 .B DESTINATION-BLOCK
380 line.
381 Default:
382 .IR MAILBOX .
383 .TP
384 .B MAILUSAGE
385 Mail folder for messages sent to the remailer address that do not
386 contain any valid remailer commands. Default:
387 .BR /dev/null .
388 .TP
389 .B MAILANON
390 Mail folder for replies sent to the
391 .I ANONADDR
392 address.
393 Default:
394 .BR /dev/null .
395 .TP
396 .B MAILERROR
397 Mail folder for messages that cannot be decrypted or contain other
398 errors. Default:
399 .BR /dev/null .
400 .TP
401 .B MAILBOUNCE
402 Mail folder for bounce messages. Default:
403 .IR MAILBOX .
404 .TP
405 .B MAILIN
406 If defined an additional mail folder where Mixmaster should read messages from
407 when processing its pool. If it ends with a
408 .B /
409 it is treated as a Maildir, otherwise a standard mbox format file
410 is expected. All messages are removed from the folder after reading.
411 .B MAILIN
412 is not set by default.
413 It is an incredibly bad idea to set this the same as \fBMAILBOX\fP.
414 .TP
415 .B VERBOSE
416 If
417 .B VERBOSE
418 is set to
419 .BR 0 ,
420 Mixmaster will log error
421 messages only. If it is set to
422 .BR 1 ,
423 error messages and warnings are logged. If
424 .B VERBOSE
425 is set to
426 .BR 2 ,
427 successful operation is logged as well.
428 If set to
429 .BR 3 ,
430 a log file entry is created whenever a message
431 enters or leaves the pool. Default:
432 .BR 2 .
433 .TP
434 .B PASSPHRASE
435 A passphrase used to protect the remailer secret keys from
436 casual attackers. This setting overrides the compile-time
437 defined
438 .B COMPILEDPASS
439 which is now deprecated.
440 This should
441 .I not
442 be the same as the client passphrase.
443 .TP
444 .B EXTFLAGS
445 Additional flags you want to set in the remailer's capabilities string.
446 Defaults to the empty string, which means none. Example:
447 .BR testing .
448 .TP
449 .B PRECEDENCE
450 Sets the header Precedence: to this value for all outgoing mail.
451 Defaults to the empty string, which means no such header is added.
452 Example:
453 .BR anon .
454 If you use this you might want to block user supplied precedence
455 headers in your header block file.
456 .PP
457 The following variables can be set to
458 .B y
459 or
460 .BR n :
461 .TP
462 .B REMAIL
463 Enable remailer functionality. Default:
464 .BR n .
465 .TP
466 .B MIDDLEMAN
467 Act as an intermediate hop only, forward anonymized
468 messages to another remailer. This mode can be used
469 where complaints about anonymous messages must be
470 avoided. (The variable
471 .B FORWARDTO
472 specifies the remailer
473 chain to be used; default:
474 .BR * .)
475 Default:
476 .BR n .
477 .TP
478 .B AUTOREPLY
479 Send help files in response to non-remailer messages. Explicit
480 .B remailer-help
481 requests are always served.
482 Default:
483 .BR n .
484 .TP
485 .B MIX
486 Accept Mixmaster messages. Default:
487 .BR y .
488 .TP
489 .B PGP
490 Accept OpenPGP-encrypted Cypherpunk remailer messages.
491 Default:
492 .BR y .
493 .TP
494 .B UNENCRYPTED
495 Accept unencrypted Cypherpunk remailer messages.
496 Default:
497 .BR n .
498 .TP
499 .B REMIX
500 Re-encrypt Type I messages to other remailers in the Mixmaster format
501 .RB ( x
502 = only when requested by user explicitly).
503 Default:
504 .BR y .
505 .TP
506 .B BINFILTER
507 Filter out binary attachments. Default:
508 .BR n .
509 .TP
510 .B LISTSUPPORTED
511 List known remailers and their keys in remailer-conf reply. Default:
512 .BR y .
513 .TP
514 .B MID
515 Use a hash of the message body as Message-ID, to avoid
516 Usenet spam. Default:
517 .BR y .
518 If
519 .B MID
520 is set to a string
521 beginning with
522 .BR @ ,
523 that string is used as the domain part of the message ID.
524 .TP
525 .B AUTOBLOCK
526 Allow users to add their address to the
527 .B dest.blk
528 file by sending the remailer a message containing the line
529 .BR destination-block .
530 Default:
531 .BR y .
532 .TP
533 .B STATSDETAILS
534 List statistics on intermediate vs. final delivery in remailer-stats.
535 Default:
536 .BR y .
537 .PP
538 The following variables have numeric values:
539 .TP
540 .B POOLSIZE
541 The size of the Mixmaster reordering pool. Larger sizes
542 imply higher security and longer delays. Remailer default:
543 .BR 20 .
544 Client default:
545 .BR 0 .
546 .TP
547 .B RATE
548 Percentage of messages from the pool to be sent. Remailer default:
549 .BR 95 .
550 Client default:
551 .BR 100 .
552 Lower values cause the pool to increase in size when
553 many messages are received at a time, reducing the effect
554 of flooding attacks.
555 .TP
556 .B INDUMMYP
557 Probability that Mixmaster will generate dummy messages upon
558 receipt of incoming mail. Larger numbers mean more dummy
559 messages on average. For instance,
560 .B 10
561 means that on average one in nine incoming messages will trigger
562 a dummy generation, and
563 .B 20
564 means that one in four will.
565 .B 0
566 means no dummy messages. Remailer default:
567 .BR 20 .
568 Client default:
569 .BR 3 .
570 .TP
571 .B OUTDUMMYP
572 Probability that Mixmaster will generate dummy messages at
573 .B SENDPOOL
574 time. If the pool is processed frequently, this should be a lower value
575 than if there are long intervals between pool processing. Examples:
576 .B 50
577 means on average, one dummy message will be generated per pool
578 processing.
579 .B 80
580 means four will be generated.
581 .B 0
582 means no dummy messages. Remailer default:
583 .BR 67 .
584 Client default:
585 .BR 3 .
586 .TP
587 .B SIZELIMIT
588 Maximum size for anonymous messages in kB.
589 .B 0
590 means no limit.
591 Default:
592 .BR 0 .
593 .TP
594 .B POP3SIZELIMIT
595 Maximum size for incoming messages in kB when using POP3.
596 .B 0
597 means no limit.
598 Default:
599 .BR 0 .
600 Larger messages are deleted unread if
601 .B POP3DEL
602 is set to
603 .BR y ,
604 and left on the server otherwise.
605 .TP
606 .B INFLATEMAX
607 Maximum size for
608 .B Inflate:
609 padding in kB.
610 .B 0
611 means padding is not allowed.
612 Default:
613 .B 50
614 .BR kB .
615 .TP
616 .B MAXRANDHOPS
617 Maximum chain length for message forwarding requested by
618 .B Rand-Hop
619 directives.
620 Default:
621 .BR 4 .
622 .TP
623 .B MAXRECIPIENTS
624 limits the number of allowed recipients in outgoing mail. Anything that exceeds this
625 number is dropped silently. Default:
626 .BR 5 .
627 .PP
628 The following are time variables. They can be given as years (
629 .BR y
630 ), months (
631 .BR b
632 ), days (
633 .BR d
634 ), hours (
635 .BR h
636 ), minutes (
637 .BR m
638 ), or seconds (
639 .BR s
640 ).
641 .TP
642 .B SENDPOOLTIME
643 How often Mixmaster should check the pool for messages
644 to be sent. Remailer default:
645 .BR 1h .
646 Client default:
647 .BR 0h .
648 .TP
649 .B POP3TIME
650 How often Mixmaster should check the POP3 accounts
651 listed in
652 .B pop3.cfg
653 for new mail.
654 Default:
655 .BR 1h .
656 .TP
657 .B MAILINTIME
658 How often Mixmaster should read mail from
659 .BR MAILIN
660 and process mails fetched via POP3. Processing here means to
661 answer remailer-xxx requests and decrypt messages to the Mixmaster
662 and place them in the pool. No other processing of the pool is
663 done. This action is always performed sending out messages from the pool (at
664 .BR SENDPOOLTIME
665 intervals) or receiving mail via POP3 (at
666 .BR POP3TIME
667 intervals). Default:
668 .BR 5m .
669 .TP
670 .B PACKETEXP
671 How long to store parts of incomplete multipart messages and other
672 temporary pool files.
673 Default:
674 .BR 7d .
675 .TP
676 .B IDEXP
677 Mixmaster keeps a log of packet IDs to prevent replay
678 attacks.
679 .B IDEXP
680 specifies after which period of time old
681 IDs are expired. Default:
682 .BR 7d ,
683 minimum:
684 .BR 5d .
685 If set to
686 .BR 0 ,
687 no log is kept.
688 .TP
689 .B KEYLIFETIME
690 Mixmaster sets an expiration date on its remailer keys
691 .B KEYLIFETIME
692 after the key creation date. Default:
693 .BR 13b .
694 .TP
695 .B KEYGRACEPERIOD
696 Mixmaster will continue to decrypt messages encrypted to an expired key
697 for
698 .B KEYGRACEPERIOD
699 period of time after the expiration. This is done to ensure that messages
700 already injected into the network are allowed to exit. Do not change this
701 value unless you know what you are doing, or you will risk partitioning
702 attacks. Default:
703 .BR 7d .
704 .TP
705 .B KEYOVERLAPPERIOD
706 Mixmaster will generate and advertise a new key
707 .BR KEYOVERLAPPERIOD
708 period of time before the expiration of the key. Clients should always use
709 the most recently created valid key. Clients that deviate from this
710 recommended behavior risk partitioning attacks. Default:
711 .BR 1b .
712 .PP
713 The following strings must be specified at compile-time in
714 .BR config.h .
715 It is not usually necessary to modify any of these:
716 .TP
717 .B
718 DISCLAIMER
719 A default string to be inserted in the header of all anonymous
720 messages if no
721 .B disclaim.txt
722 file is available. If
723 .B DISCLAIMER
724 contains the substring
725 .BR "%s" ,
726 it will be substituted with the
727 .I COMPLAINTS
728 address.
729 .TP
730 .B FROMDISCLAIMER
731 A default string to be inserted at the top of the message body
732 if an anonymous message contains a user-supplied
733 .B From:
734 line and no
735 .B fromdscl.txt
736 file is available.
737 .TP
738 .B MSGFOOTER
739 A default string to be inserted at the bottom of the message body
740 of all anonymous messages if no
741 .B footer.txt
742 file is available.
743 .TP
744 .B BINDISCLAIMER
745 A string to replace the body of a binary attachment when
746 the remailer is configured to filter out binaries.
747 .TP
748 .B CHARSET
749 The character set used for MIME-encoded header lines.
750 .TP
751 .B DESTBLOCK
752 A quoted list of files that contain blocked addresses.
753 Files must be separated by one space. Mixmaster will choose
754 the first file for writing if
755 .B AUTOBLOCK
756 is enabled.
757 .PP
758 The following variables can be set in the
759 .B Makefile
760 or in
761 .BR config.h :
762 .TP
763 .B COMPILEDPASS
764 A passphrase used to protect the remailer secret keys from
765 casual attackers. You can use
766 .B `make PASS="\fIyour passphrase\fB"'
767 to set a passphrase. This should
768 .I not
769 be the same as the client passphrase. This option is now deprecated in
770 favor of the configuration file option
771 .BR PASSPHRASE .
772 .TP
773 .B SPOOL
774 Set
775 .B SPOOL
776 if you want to use a default directory other than
777 .B ~/Mix
778 or if Mixmaster is run in an environment where
779 .B $HOME
780 is not set, e.g. when invoked via
781 .BR .forward .
782 This value can be overridden by use of the environment variable
783 .BR $MIXPATH .
784 .TP
785 .B USE_SSLEAY
786 Use the SSLeay/OpenSSL cryptographic library. Currently this is the
787 only cryptographic library supported by Mixmaster.
788 .TP
789 .B USE_IDEA
790 Use the IDEA encryption algorithm. A license is required to use IDEA
791 for commercial purposes. See file
792 .B idea.txt
793 for details.
794 .TP
795 .B USE_PGP
796 Support the OpenPGP encryption format. Mixmaster does not call any
797 external encryption program.
798 .TP
799 .B USE_PCRE
800 Use the regular expression library.
801 .TP
802 .B USE_ZLIB
803 Use the
804 .B zlib
805 compression library.
806 .TP
807 .B USE_NCURSES
808 Use the
809 .B ncurses
810 library.
811 .TP
812 .B USE_SOCK
813 Use sockets to transfer mail by POP3 and SMTP.
814 .TP
815 .B USE_WINGUI
816 Use the
817 .B Win32
818 GUI.
819 .TP
820 .B HAVE_GETDOMAINNAME
821 The
822 .BR getdomainname (2)
823 function is available.
824 .SH FILES
825 These filenames can be overridden by setting the corresponding configuration
826 option (given in parentheses).
827 .TP
828 .B mix.cfg
829 Mixmaster configuration file.
830 .TP
831 .B pubring.asc
832 Type 1 remailer keys (\fBPGPREMPUBASC\fP).
833 .TP
834 .B pubring.mix
835 Type 2 remailer keys (\fBPUBRING\fP).
836 .TP
837 .B rlist.txt
838 List of reliable type 1 remailers (\fBTYPE1LIST\fP).
839 .TP
840 .B mlist.txt
841 List of reliable type 2 remailers (\fBTYPE2REL\fP).
842 .TP
843 .B type2.list
844 List of known type 2 remailers (optional) (\fBTYPE2LIST\fP).
845 .TP
846 .B starex.txt
847 List of remailers which should not be used in randomly generated
848 remailer chains (\fBSTAREX\fP).
849 .SS Remailer files:
850 .TP
851 .B disclaim.txt
852 A string to be inserted in the header of all anonymous
853 messages (\fBDISCLAIMFILE\fP).
854 .TP
855 .B fromdscl.txt
856 A string to be inserted at the top of the message body
857 if an anonymous message contains a user-supplied
858 .B From:
859 line (\fBFROMDSCLFILE\fP).
860 .TP
861 .TP
862 .B footer.txt
863 A string to be inserted at the bottom of the message body
864 of all anonymous messages (\fBMSGFOOTERFILE\fP).
865 .TP
866 .B help.txt
867 Help file sent in response to
868 .B remailer-help
869 requests (\fBHELPFILE\fP).
870 .TP
871 .B adminkey.txt
872 The PGP key of the remailer operator sent in response to
873 .B remailer-adminkey
874 requests (\fBADMKEYFILE\fP).
875 .TP
876 .B abuse.txt
877 File sent in response to mail to the
878 .I COMPLAINTS
879 address if
880 .B AUTOREPLY
881 is set (\fBABUSEFILE\fP).
882 .TP
883 .B reply.txt
884 Help file sent in response to replies to anonymous messages if
885 .B AUTOREPLY
886 is set (\fBREPLYFILE\fP).
887 .TP
888 .B usage.txt
889 Help file sent in response to non-remailer message sent to
890 .I REMAILERADDR
891 if
892 .B AUTOREPLY
893 is set. If
894 .B usage.log
895 exists, recipients are logged and a reply is sent only once to avoid
896 mail loops (\fBUSAGEFILE\fP).
897 .TP
898 .B blocked.txt
899 Information sent in response to automatically processed blocking requests if
900 .B AUTOREPLY
901 is set (\fBBLOCKFILE\fP).
902 .TP
903 .B pop3.cfg
904 List of POP3 accounts with lines of the form
905 .I account@host.domain password
906 to get remailer messages from. The lines may optionally contain the
907 keyword "apop" or "pass" to select an authentication method (\fBPOP3CONF\fP).
908 .TP
909 .B dest.alw
910 List of addresses to which Mixmaster will deliver, even in middleman mode (\fBDESTALLOW\fP).
911 .TP
912 .B dest.blk
913 List of blocked destination addresses.
914 Mixmaster does not send mail to the blocked addresses listed in this file (\fBDESTBLOCK\fP).
915 .TP
916 .B rab.blk
917 Identical to
918 .BR dest.blk ,
919 except Mixmaster will not write to this file.
920 For use with external remailer abuse blocklists.
921 .TP
922 .B source.blk
923 List of blocked source addresses. If an incoming message originates
924 from an address or IP in this list, it will be ignored. This
925 feature can be used to avoid spam and other abusive mail (\fBSOURCEBLOCK\fP).
926 .TP
927 .B header.blk
928 List of unwanted header fields. The file is used to delete unwanted
929 header lines (e.g. lines that indicate a false identity, or Usenet
930 control messages), and do other header filtering (\fBHDRFILTER\fP).
931
932 A destination address or header line is left out if it contains a
933 search string or matches a regular expression specified in the block
934 file. Lines in the block file that begin and end with a slash
935 .RB ( /\fIregexp\fB/ )
936 are interpreted as regular expressions. Lines without
937 slashes are used for case-independent substring search.
938
939 If a message contains a header line that matches a
940 .B /\fIregexp\fB/q
941 entry in
942 .BR header.blk ,
943 the entire message is deleted.
944
945 In addition, regular expressions can be substituted. Back-references
946 are supported. For example
947
948 /^From: *([^@]*) <.*>/From: $1/
949 /^From:.* \\(([^@]*)\)/From: $1/
950 /^From: *([^@]*).*$/From: $1 <\fInobody@remailer.domain\fR>/
951
952 would allow user-defined names in the
953 .B From:
954 line, while replacing any given address with the remailer address.
955 .SS
956 Mixmaster uses the following files internally:
957 .TP
958 .B mixrand.bin
959 Random seed file (\fBMIXRAND\fP).
960 .TP
961 .B secring.pgp
962 Remailer type 1 secret keys (\fBPGPREMSECRING\fP).
963 .TP
964 .B secring.mix
965 Remailer type 2 secret keys (\fBSECRING\fP).
966 .TP
967 .B pgpkey.txt
968 The public type 1 remailer key (\fBPGPKEY\fP).
969 .TP
970 .B key.txt
971 The public type 2 remailer key (\fBKEYFILE\fP).
972 .TP
973 .B id.log
974 Log file of messages already processed (\fBKEYFILE\fP).
975 .TP
976 .B stats.log
977 Log file for remailer statistics (\fBSTATS\fP).
978 .TP
979 .B pgpmaxcount.log
980 Log file for PGP Max-Count statistics (\fBPGPMAXCOUNT\fP).
981 .TP
982 .B time.log
983 Time for periodic remailer actions (\fBREGULAR\fP).
984 .TP
985 .B dhparam.mix
986 Public Diffie-Hellman parameters used for El-Gamal key generation (\fBDHPARAMS\fP).
987 .TP
988 .B dsaparam.mix
989 Public DSA parameters used for DSA key generation (\fBDSAPARAMS\fP).
990 .TP
991 .B mix.pid
992 Pid file in daemon mode (\fBPIDFILE\fP).
993 .TP
994 .BI pool/
995 Message pool directory (\fBPOOL\fP).
996 .TP
997 .BI pool/m *
998 Message pool files.
999 .TP
1000 .BI pool/p *
1001 Partial messages.
1002 .TP
1003 .BI pool/l *
1004 Latent messages.
1005 .TP
1006 .BI pool/s *
1007 Messages to be sent.
1008 .TP
1009 .BI pool/t *
1010 Temporary files.
1011 .SH ENVIRONMENT
1012 .TP
1013 .I MIXPATH
1014 The path to the Mixmaster directory. The default is
1015 .BR ~/Mix .
1016 .TP
1017 .I MIXPASS
1018 The passphrase used to protect your nyms and PGP keys.
1019 (The remailer uses a different passphrase.) If
1020 .I MIXPASS
1021 is not set, the client will ask for a passphrase.
1022 .SH SEE ALSO
1023 .BR pgp (1),
1024 .BR procmail (1),
1025 .BR sendmail (8).
1026 .SH COPYRIGHT
1027 (C) 1999 Anonymizer Inc.
1028 Mixmaster may be redistributed and modified under certain conditions.
1029 This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF
1030 ANY KIND, either express or implied. See the file COPYRIGHT for
1031 details.

Properties

Name Value
svn:keywords Id

  ViewVC Help
Powered by ViewVC 1.1.5