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

Contents of /trunk/Mix/mixmaster.1

Parent Directory Parent Directory | Revision Log Revision Log


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

  ViewVC Help
Powered by ViewVC 1.1.5