/[pkg-mixmaster]/branches/mixmaster_2_9_STABLE/Mix/mix.1
ViewVC logotype

Contents of /branches/mixmaster_2_9_STABLE/Mix/mix.1

Parent Directory Parent Directory | Revision Log Revision Log


Revision 354 - (show annotations) (download)
Thu Oct 10 13:18:45 2002 UTC (10 years, 7 months ago) by weaselp
File size: 22369 byte(s)
The Mixmaster daemon now writes a pid file.
Mixmaster in daemon mode now catches SIGTERM and
  SIGINT and finishes its current queue run and then
  exits successfully.
1 .TH MIX 1 "Mixmaster Version 3.0 beta"
2 .\" $Id: mix.1,v 1.6.2.5 2002/10/10 13:18:42 weaselp 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 -G, \-\-generate\-key
172 Generate a new remailer key.
173 .TP
174 .B \-K, \-\-update\-keys
175 Generate remailer keys if necessary.
176 .TP
177 .B \-S, \-\-send
178 Force sending the message(s) from the pool.
179 .TP
180 .B \-\-install\-svc
181 Install the Mixmaster Service on Win32.
182 .TP
183 .B \-\-remove\-svc
184 Remove the Mixmaster Service on Win32.
185 .TP
186 .B \-\-run\-svc
187 Run the Mixmaster Service on Win32.
188 .SH CONFIGURATION
189 Mixmaster reads its configuration from the file
190 .B mix.cfg
191 in its working directory. The configuration file consists of lines of
192 the type
193 .PP
194 .I VARIABLE values
195 .PP
196 and of comments, which begin with a
197 .B #
198 character. The variables have reasonable default values, but it is
199 useful to create a configuration file using the
200 .B Install
201 script when setting up a remailer.
202 .PP
203 All configuration variables can be overridden from the command line,
204 e.g.
205 .B mix -S --POOLSIZE=0 --RATE=100
206 will send all messages currently in the message pool.
207 .SS Client configuration:
208 .TP
209 .B ADDRESS
210 Your address for sending non-anonymous messages.
211 .TP
212 .B NAME
213 Your real name (used for sending non-anonymous messages).
214 .TP
215 .B MAILtoNEWS
216 Address of a mail-to-news gateway. Default:
217 .BR mail2news@nym.alias.net .
218 .TP
219 .B CHAIN
220 Default chain for anonymous messages to be sent.
221 .B CHAIN
222 is a comma-separated list of remailer names or addresses.
223 A
224 .B *
225 represents a random reliable remailer. Default:
226 .BR *,*,*,* .
227 .TP
228 .B NUMCOPIES
229 Number of redundant copies of an anonymous message to be
230 sent, unless specified otherwise on the command line.
231 Default:
232 .BR 1 .
233 .TP
234 .B DISTANCE
235 When selecting random remailers, the chain will contain
236 .I DISTANCE
237 other remailers between two occurrences of the
238 same remailer in the chain. Default:
239 .BR 2 .
240 .TP
241 .B MINREL
242 Only select remailers with a reliability of at least
243 .IR MINREL %.
244 Default:
245 .BR 98 .
246 .TP
247 .B RELFINAL
248 Only select a remailer with a reliability of at least
249 .IR RELFINAL %
250 as the final remailer. Default:
251 .BR 99 .
252 .TP
253 .B MAXLAT
254 Only select remailers with a latency of maximally
255 .IR MAXLAT .
256 Default:
257 .BR 36h .
258 .TP
259 .B PGPPUBRING
260 Path to your public PGP key ring. Default:
261 .BR ~/.pgp/pubring.pkr .
262 (Windows default: PGP registry value.)
263 .TP
264 .B PGPSECRING
265 Path to your secret PGP key ring. Default:
266 .BR ~/.pgp/secring.skr .
267 (Windows default: PGP registry value.)
268 .SS Remailer configuration:
269 .TP
270 .B SENDMAIL
271 Path to the
272 .BR sendmail (1)
273 program. If set to
274 .BR outfile ,
275 Mixmaster will create text files named
276 .BI out * .txt
277 in the
278 .B pool
279 directory instead of sending mail.
280 Default:
281 .BR "/usr/lib/sendmail -t" .
282 .TP
283 .B SMTPRELAY
284 Name of SMTP relay. If set, mail will be delivered to the relay
285 rather than by
286 .BR sendmail (1).
287 .TP
288 .B HELONAME
289 Host name used in the SMTP dialogue.
290 Default: The
291 .I ENVFROM
292 host name or the current network name associated with the socket.
293 .TP
294 .B SMTPUSERNAME
295 Some mail servers require authentication for sending mail. This is
296 the authenticated SMTP user name.
297 .B SMTPPASSWORD
298 Password for authenticated SMTP.
299 .TP
300 .B ENVFROM
301 Envelope from address used in the SMTP dialogue. (When the client is
302 used to send non-anonymous messages,
303 .I ADDRESSS
304 is used instead.)
305 Default:
306 .IR ANONADDR .
307 .TP
308 .B NEWS
309 Path to the news posting program, or address of a
310 mail-to-news gateway. Default: no news posting.
311 (When using a news posting program,
312 .I ORGANIZATION
313 contains
314 an Organization line for anonymous messages. Default:
315 .BR "Anonymous Posting Service" .)
316 .TP
317 .B SENDANONMAIL
318 Path to a program for sending anonymous mail. Default:
319 .IR SENDMAIL .
320 .B SENDANONMAIL
321 can be used to invoke an external mail filter for anonymized messages.
322 .TP
323 .B SHORTNAME
324 A short name for the remailer to be used in lists. Defaults to the host name.
325 .TP
326 .B REMAILERADDR
327 The remailer mail address.
328 .TP
329 .B ANONADDR
330 An address to be inserted in the
331 .B From:
332 line of anonymous messages. Default:
333 .IR REMAILERADDR .
334 .TP
335 .B REMAILERNAME
336 A name to be inserted in the
337 .B From:
338 line of remailer status
339 messages. Default:
340 .BR "Anonymous Remailer" .
341 .TP
342 .B ANONNAME
343 A name to be inserted in the
344 .B From:
345 line of anonymous messages.
346 Default:
347 .BR "Anonymous" .
348 .TP
349 .B COMPLAINTS
350 An address for complaints to be sent to. Default:
351 .IR REMAILERADDR .
352 .TP
353 .B ERRLOG
354 Name of a file to log error messages, or
355 .B stdout
356 or
357 .BR stderr .
358 Default:
359 .BR stderr .
360 (When run from a tty, Mixmaster will always print a copy of error
361 messages to
362 .BR stderr .)
363 .TP
364 .B MAILBOX
365 A generic mail folder for non-remailer messages that are not stored in
366 any of the following folders.
367 If
368 .B MAILBOX
369 begins with a
370 .BR | ,
371 it specifies the path to a program. If it contains an
372 .B @
373 sign, the message is forwarded to the given address (with an
374 .B X-Loop:
375 header to prevent mail loops), otherwise the message is appended
376 to the given file name or written to standard output if
377 .B MAILBOX
378 is
379 .BR stdout .
380 Default:
381 .BR mbox .
382 .TP
383 .B MAILABUSE
384 Mail folder for messages sent to the
385 .I COMPLAINTS
386 address.
387 Default:
388 .IR MAILBOX .
389 .TP
390 .B MAILBLOCK
391 Mail folder for messages sent to the remailer address with a
392 .B DESTINATION-BLOCK
393 line.
394 Default:
395 .IR MAILBOX .
396 .TP
397 .B MAILUSAGE
398 Mail folder for messages sent to the remailer address that do not
399 contain any valid remailer commands. Default:
400 .BR /dev/null .
401 .TP
402 .B MAILANON
403 Mail folder for replies sent to the
404 .I ANONADDR
405 address.
406 Default:
407 .BR /dev/null .
408 .TP
409 .B MAILERROR
410 Mail folder for messages that cannot be decrypted or contain other
411 errors. Default:
412 .BR /dev/null .
413 .TP
414 .B MAILBOUNCE
415 Mail folder for bounce messages. Default:
416 .IR MAILBOX .
417 .TP
418 .B MAILIN
419 If defined an additional mail folder where Mixmaster should read messages from
420 when processing its pool. If it ends with a
421 .B /
422 it is treated as a Maildir, otherwise a standard mbox format file
423 is expected. All messages are removed from the folder after reading.
424 .B MAILIN
425 is not set by default.
426 It is an incredible bad idea to set this the same as \fBMAILBOX\fP.
427 .TP
428 .B VERBOSE
429 If
430 .B VERBOSE
431 is set to
432 .BR 0 ,
433 Mixmaster will log error
434 messages only. If it is set to
435 .BR 1 ,
436 error message and warnings are logged. If
437 .B VERBOSE
438 is set to
439 .BR 2 ,
440 successful operation is logged as well.
441 If set to
442 .BR 3 ,
443 a log file entry is created whenever a message
444 enters or leaves the pool. Default:
445 .BR 2 .
446 .TP
447 .B PASSPHRASE
448 A passphrase used to protect the remailer secret keys from
449 casual attackers. This setting overrides the compile-time
450 defined
451 .B COMPILEDPASS
452 which is now deprecated.
453 This should
454 .I not
455 be the same as the client passphrase.
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 an other 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 .PP
533 The following variables have numeric values:
534 .TP
535 .B POOLSIZE
536 The size of the Mixmaster reordering pool. Larger sizes
537 imply higher security and longer delays. Default:
538 .BR 0 .
539 .TP
540 .B RATE
541 Percentage of messages from the pool to be sent. Default:
542 .BR 100 .
543 Lower values cause the pool to increase in size when
544 many messages are received at a time, reducing the effect
545 of flooding attacks.
546 .TP
547 .B SIZELIMIT
548 Maximal size for anonymous messages in kB.
549 .B 0
550 means no limit.
551 Default:
552 .BR 0 .
553 .TP
554 .B POP3SIZELIMIT
555 Maximal size for incoming messages in kB when using POP3.
556 .B 0
557 means no limit.
558 Default:
559 .BR 0 .
560 Larger messages are deleted unread if
561 .B POP3DEL
562 is set to
563 .BR y ,
564 and left on the server otherwise.
565 .TP
566 .B INFLATEMAX
567 Maximal size for
568 .B Inflate:
569 padding in kB.
570 .B 0
571 means padding is not allowed.
572 Default:
573 .B 50
574 .BR kB .
575 .TP
576 .B MAXRANDHOPS
577 Maximal chain length for message forwarding requested by
578 .B Rand-Hop
579 directives.
580 Default:
581 .BR 20 .
582 .PP
583 The following are time variables. They can be given as days, hours, or
584 minutes.
585 .TP
586 .B SENDPOOLTIME
587 How often Mixmaster should check the pool for messages
588 to be sent. Default:
589 .BR 1h .
590 .TP
591 .B POP3TIME
592 How often Mixmaster should check the POP3 accounts
593 listed in
594 .B pop3.cfg
595 for new mail.
596 Default:
597 .BR 1h .
598 .TP
599 .B MAILINTIME
600 How often Mixmaster should read mail from
601 .BR MAILIN
602 and process mails fetched via POP3. Processing here means to
603 answer remailer-xxx requests and decrypt messages to the Mixmaster
604 and place them in the pool. No other processing of the pool is
605 done. This action is always performed sending out messages from the pool (at
606 .BR SENDPOOLTIME
607 intervals) or receiving mail via POP3 (at
608 .BR POP3TIME
609 intervals). Default:
610 .BR 5m .
611 .TP
612 .B PACKETEXP
613 How long to store parts of incomplete multipart messages and other
614 temporary pool files.
615 Default:
616 .BR 7d .
617 .TP
618 .B IDEXP
619 Mixmaster keeps a log of packet IDs to prevent replay
620 attacks.
621 .B IDEXP
622 specifies after which period of time old
623 IDs are expired. Default:
624 .BR 7d ,
625 minimum:
626 .BR 5d .
627 If set to
628 .BR 0 ,
629 no log is kept.
630 .PP
631 The following strings must be specified at compile-time in
632 .BR config.h .
633 Usually it is not necessary to modify any of these:
634 .TP
635 .B
636 DISCLAIMER
637 A default string to be inserted in the header of all anonymous
638 messages if no
639 .B disclaim.txt
640 file is available. If
641 .B DISCLAIMER
642 contains the substring
643 .BR "%s" ,
644 it will be substituted with the
645 .I COMPLAINTS
646 address.
647 .TP
648 .B FROMDISCLAIMER
649 A default string to be inserted at the top of the message body
650 if an anonymous message contains a user-supplied
651 .B From:
652 line and no
653 .B fromdscl.txt
654 file is available.
655 .TP
656 .B MSGFOOTER
657 A default string to be inserted at the bottom of the message body
658 of all anonymous messages and no
659 .B footer.txt
660 file is available.
661 .TP
662 .B BINDISCLAIMER
663 A string to replace the body of a binary attachment when
664 the remailer is configured to filter out binaries.
665 .TP
666 .B CHARSET
667 The character set used for MIME-encoded header lines.
668 .TP
669 .B DESTBLOCK
670 A quoted list of files that contain blocked addresses.
671 Files must be separated by one space. Mixmaster will choose
672 the first file for writing
673 .B AUTOBLOCK
674 is enabled.
675 .PP
676 The following variables can be set in the
677 .B Makefile
678 or in
679 .BR config.h :
680 .TP
681 .B COMPILEDPASS
682 A passphrase used to protect the remailer secret keys from
683 casual attackers. You can use
684 .B `make PASS="\fIyour passphrase\fB"'
685 to set a passphrase. This should
686 .I not
687 be the same as the client passphrase. This option is now deprecated in
688 favor of the configuration file option
689 .BR PASSPHRASE .
690 .TP
691 .B SPOOL
692 Set
693 .B SPOOL
694 if you want to use a default directory other than
695 .B ~/Mix
696 or if Mixmaster is run in an environment where
697 .B $HOME
698 is not set, e.g. when invoked via
699 .BR .forward .
700 This value can be overridden by use of the environment variable
701 .BR $MIXPATH .
702 .TP
703 .B USE_SSLEAY
704 Use the SSLeay/OpenSSL cryptographic library. Currently this is the
705 only cryptographic library supported by Mixmaster.
706 .TP
707 .B USE_IDEA
708 Use the IDEA encryption algorithm. A license is required to use IDEA
709 for commercial purposes. See file
710 .B idea.txt
711 for details.
712 .TP
713 .B USE_PGP
714 Support the OpenPGP encryption format. Mixmaster does not call any
715 external encryption program.
716 .TP
717 .B USE_PCRE
718 Use the regular expression library.
719 .TP
720 .B USE_ZLIB
721 Use the
722 .B zlib
723 compression library.
724 .TP
725 .B USE_NCURSES
726 Use the
727 .B ncurses
728 library.
729 .TP
730 .B USE_SOCK
731 Use sockets to transfer mail by POP3 and SMTP.
732 .TP
733 .B USE_WINGUI
734 Use the
735 .B Win32
736 GUI.
737 .TP
738 .B HAVE_GETDOMAINNAME
739 The
740 .BR getdomainname (2)
741 function is available.
742 .SH FILES
743 These filenames can be overridden by setting the corresponding configuration
744 option (given in parentheses).
745 .TP
746 .B mix.cfg
747 Mixmaster configuration file.
748 .TP
749 .B pubring.asc
750 Type 1 remailer keys (\fBPGPREMPUBASC\fP).
751 .TP
752 .B pubring.mix
753 Type 2 remailer keys (\fBPUBRING\fP).
754 .TP
755 .B rlist.txt
756 List of reliable type 1 remailers (\fBTYPE1LIST\fP).
757 .TP
758 .B mlist.txt
759 List of reliable type 2 remailers (\fBTYPE2REL\fP).
760 .TP
761 .B type2.list
762 List of known type 2 remailers (optional) (\fBTYPE2LIST\fP).
763 .SS Remailer files:
764 .TP
765 .B disclaim.txt
766 A string to be inserted in the header of all anonymous
767 messages (\fBDISCLAIMFILE\fP).
768 .TP
769 .B fromdscl.txt
770 A string to be inserted at the top of the message body
771 if an anonymous message contains a user-supplied
772 .B From:
773 line (\fBFROMDSCLFILE\fP).
774 .TP
775 .TP
776 .B footer.txt
777 A string to be inserted at the bottom of the message body
778 of all anonymous messages (\fBMSGFOOTERFILE\fP).
779 .TP
780 .B help.txt
781 Help file sent in response to
782 .B remailer-help
783 requests (\fBHELPFILE\fP).
784 .TP
785 .B adminkey.txt
786 The PGP key of the remailer operator sent in response to
787 .B remailer-adminkey
788 requests (\fBADMKEYFILE\fP).
789 .TP
790 .B abuse.txt
791 File sent in response to mail to the
792 .I COMPLAINTS
793 address if
794 .B AUTOREPLY
795 is set (\fBABUSEFILE\fP).
796 .TP
797 .B reply.txt
798 Help file sent in response to replies to anonymous messages if
799 .B AUTOREPLY
800 is set (\fBREPLYFILE\fP).
801 .TP
802 .B usage.txt
803 Help file sent in response to non-remailer message sent to
804 .I REMAILERADDR
805 if
806 .B AUTOREPLY
807 is set. If
808 .B usage.log
809 exists, recipients are logged and a reply is sent only once to avoid
810 mail loops (\fBUSAGEFILE\fP).
811 .TP
812 .B blocked.txt
813 Information sent in response to automatically processed blocking requests if
814 .B AUTOREPLY
815 is set (\fBBLOCKFILE\fP).
816 .TP
817 .B pop3.cfg
818 List of POP3 accounts with lines of the form
819 .I account@host.domain password
820 to get remailer messages from. The lines may optionally contain the
821 keyword "apop" or "pass" to select an authentication method (\fBPOP3CONF\fP).
822 .TP
823 .B dest.alw
824 List of addresses to which Mixmaster will deliver, even in middleman mode (\fBDESTALLOW\fP).
825 .TP
826 .B dest.blk
827 List of blocked destination addresses.
828 Mixmaster does not send mail to the blocked addresses listed in this file (\fBDESTBLOCK\fP).
829 .TP
830 .B rab.blk
831 Identical to
832 .BR dest.blk ,
833 except that Mixmaster will not write to this file.
834 For use with external remailer abuse blocklists.
835 .TP
836 .B source.blk
837 List of blocked source addresses. If an incoming message originates
838 from an address or IP in this in this list, it will be ignored. This
839 feature can be used to avoid spam and other abusive mail (\fBSOURCEBLOCK\fP).
840 .TP
841 .B header.blk
842 List of unwanted header fields. The file is used to delete unwanted
843 header lines (e.g. lines that indicate a false identity, or Usenet
844 control messages), and do other header filtering (\fBHDRFILTER\fP).
845 .PP
846 A destination address or header line is left out if it contains a
847 search string or matches a regular expression specified in the block
848 file. Lines in the block file that begin and end with a slash
849 .RB ( /\fIregexp\fB/ )
850 are interpreted as regular expressions. Lines without
851 slashes are used for case-independent substring search.
852
853 If a message contains a header line that matches a
854 .B /\fIregexp\fB/q
855 entry in
856 .BR header.blk ,
857 the entire message is deleted.
858
859 In addition, regular expressions can be substituted. Back-references
860 are supported. For example
861
862 /^From: *([^@]*) <.*>/From: $1/
863 /^From:.* \\(([^@]*)\)/From: $1/
864 /^From: *([^@]*).*$/From: $1 <\fInobody@remailer.domain\fR>/
865
866 would allow user-defined names in the
867 .B From:
868 line, while replacing any given address with the remailer address.
869 .SS
870 Mixmaster uses the following files internally:
871 .TP
872 .B mixrand.bin
873 Random seed file (\fBMIXRAND\fP).
874 .TP
875 .B secrets.mix
876 List of your nyms with configuration data (encrypted) (\fBNYMDB\fP).
877 .TP
878 .B nymsec.pgp
879 Your nyms' secret PGP keys (encrypted) (\fBNYMSECRING\fP).
880 .TP
881 .B secring.pgp
882 Remailer type 1 secret keys (\fBPGPREMSECRING\fP).
883 .TP
884 .B secring.mix
885 Remailer type 2 secret keys (\fBSECRING\fP).
886 .TP
887 .B pgpkey.txt
888 The public type 1 remailer key (\fBPGPKEY\fP).
889 .TP
890 .B key.txt
891 The public type 2 remailer key (\fBKEYFILE\fP).
892 .TP
893 .B id.log
894 Log file of messages already processed (\fBKEYFILE\fP).
895 .TP
896 .B stats.log
897 Log file for remailer statistics (\fBSTATS\fP).
898 .TP
899 .B time.log
900 Time for periodic remailer actions (\fBREGULAR\fP).
901 .TP
902 .B dhparam.mix
903 Public Diffie-Hellman parameters used for El-Gamal key generation (\fBDHPARAMS\fP).
904 .TP
905 .B dsaparam.mix
906 Public DSA parameters used for DSA key generation (\fBDSAPARAMS\fP).
907 .TP
908 .B mix.pid
909 Pid file in daemon mode (\fBPIDFILE\fP).
910 .TP
911 .BI pool/
912 Message pool directory (\fBPOOL\fP).
913 .TP
914 .BI pool/m *
915 Message pool files.
916 .TP
917 .BI pool/p *
918 Partial messages.
919 .TP
920 .BI pool/l *
921 Latent messages.
922 .TP
923 .BI pool/s *
924 Messages to be sent.
925 .TP
926 .BI pool/t *
927 Temporary files.
928 .SH ENVIRONMENT
929 .TP
930 .I MIXPATH
931 The path to the Mixmaster directory. The default is
932 .BR ~/Mix .
933 .TP
934 .I MIXPASS
935 The passphrase used to protect your nyms and PGP keys.
936 (The remailer uses a different passphrase.) If
937 .I MIXPASS
938 is not set, the client will ask for a passphrase.
939 .SH SEE ALSO
940 .BR pgp (1),
941 .BR procmail (1),
942 .BR sendmail (8).
943 .SH COPYRIGHT
944 (C) 1999 Anonymizer Inc.
945 Mixmaster may be redistributed and modified under certain conditions.
946 This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF
947 ANY KIND, either express or implied. See the file COPYRIGHT for
948 details.

  ViewVC Help
Powered by ViewVC 1.1.5