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

Contents of /trunk/Mix/mixmaster.1

Parent Directory Parent Directory | Revision Log Revision Log


Revision 183 - (show annotations) (download)
Mon Aug 26 18:08:05 2002 UTC (10 years, 8 months ago) by weaselp
Original Path: trunk/Mix/mix.1
File size: 22061 byte(s)
Previosly when we ran Mixmaster in daemon mode and injected mail either
via pop3 or the MAILIN method (reading a Maildir or an mbox), Mixmaster
only processed remailer-xxx requests at SENDPOOLTIME intervalls.

It might be in the interest of an operator to have a high SENDPOOLTIME -
like say an hour or two - to provide better security to their user.

However it is also important to answer remailer-xxx requests in a timely
manner.

This conflict of interests can be solved by adding yet another config
option: MAILINTIME.

MAILINTIME specifies the amount of time between reading MAILIN and
processing those mails (as well as those injected via POP3). Processing
here means to answer -xxx requests and to add remailer mails to the
pool.

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

  ViewVC Help
Powered by ViewVC 1.1.5