X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmh-tailor.man;h=f1d0f6572c0906d6736ac471d1a7d073cc55e74b;hp=ea95045a3e977ac33ba0f63c33192698cdb4d21e;hb=2c1aaf8b1495d2c7368b47edb04e9a2b7628377b;hpb=98c25edae52fb18c950c6d9626b4f8434e59d08c diff --git a/man/mh-tailor.man b/man/mh-tailor.man index ea95045..f1d0f65 100644 --- a/man/mh-tailor.man +++ b/man/mh-tailor.man @@ -5,7 +5,7 @@ .\" include the -mh macro file .so %etcdir%/tmac.h .\" -.TH MH-TAILOR %manext5% MH.6.8 [%nmhversion%] +.TH MH-TAILOR %manext5% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME mh-tailor, mts.conf \- mail transport customization for nmh message handler @@ -27,6 +27,21 @@ default values and a description of their meanings are listed below: .in +.5i .ti -.5i +mts: +.br +The mail transport method to use. The two acceptable options are \fBsmtp\fP +(which is the default), and \fBsendmail\fP. + +If you use \fBsmtp\fP, this will enable a direct SMTP (simple mail transport +protocol) interface in \fInmh\fR. When sending mail, instead of passing the +message to the mail transport agent, \fIpost\fR will open a socket connection +to the mail port on the machine specified in the \fIservers\fR entry. + +If you use \fBsendmail\fP, then \fIpost\fR will send messages by forking a +local copy of sendmail. Currently it will still speak SMTP with this local +copy of sendmail. + +.ti -.5i localname: .br The hostname \fInmh\fR considers local. It should typically be a fully @@ -99,12 +114,18 @@ mmdelim2: \\001\\001\\001\\001\\n The end-of-message delimiter for maildrops. .ti -.5i -mmailid: 0 +masquerade: .br -If this is non-zero, two different types of email address masquerading are -allowed ("mmailid" = "masquerade mail ID"). The first type is GECOS-based -masquerading. \fInmh\fR will check if the user's pw_gecos field in the passwd -file is of the form: +This directive controls three different types of email address masquerading. +The three possible values, which may be specified in any combination on the +line, separated by spaces, are "draft_from", "mmailid", and +"username_extension". + +"mmailid" was the only type of masquerading in the original MH package, and +apparently stands for "masquerade mail identification". This type of +masquerading keys off of the GECOS field of the passwd file. When enabled, +\fInmh\fR will check if the user's pw_gecos field in the passwd file is of the +form: .ti +.5i Full Name @@ -119,15 +140,34 @@ the case, the GECOS field for each user should look like: .ti +.5i First [Middle] Last -The other type of masquerading that mmailid turns on is envelope "From:" -masquerading based on draft contents. When a user explicitly specifies a -"From:" header in a message, \fInmh\fR uses it rather than constructing its own. -However, the SMTP envelope "From:" and the "Sender:" header are set to the -user's real address. Turning on mmailid prevents this latter behavior. This is -useful when the user wants to pretend to be sending mail "directly" from a -remote POP3 account, or when remote mail robots incorrectly use the envelope -"From:" in preference to the body "From:" (or refuse to take action when the two -don't match). +"username_extension", when specified on the "masquerade:" line, allows a second +type of username masquerading. If the user sets the \fB$USERNAME_EXTENSION\fR +environment variable, its value will be appended to the actual login name. For +instance, if I am dan@company.com, and I set \fB$USERNAME_EXTENSION\fR to +"\-www", my mail will appear to come from "dan\-www@company.com". This is meant +to interact with qmail's "user\-extension" feature, where mail sent to +\fIuser\fR\-\fIstring\fR will be delivered to \fIuser\fR. Likewise, those using +versions of sendmail for which "plussed user" processing is active can set +\fB$USERNAME_EXTENSION\fR to "+\fIstring\fR". These MTA features are useful +because they allow one to use different email addresses in different situations +(to aid in automatic mail filtering or in determining where spammers got one's +address) while only actually having a single account. Note that +\fB$USERNAME_EXTENSION\fR is only appended to the username when \fIpost\fR is +generating "[Resent\-]From:" lines and the SMTP envelope "From:". \fIinc\fR, +for instance, will not try to read from a maildrop file called "dan\-www" (to +recall the earlier example). + +"draft_from" controls the most powerful type of address masquerading. Normally, +when a user explicitly specifies a "From:" header in a draft, \fInmh\fR uses it +rather than constructing its own. However, to discourage email forgery, the +SMTP envelope "From:" and a "Sender:" header are set to the user's real address. +When "draft_from" is turned on, though, the envelope "From:" will use the +address specified in the draft, and there will be no "Sender:" header. This is +useful when a user wants to pretend to be sending mail "directly" from a remote +POP3 account, or when remote mail robots incorrectly use the envelope "From:" in +preference to the body "From:" (or refuse to take action when the two don't +match). Note that the MTA may still reveal the user's real identity (e.g. +sendmail's "X\-Authentication\-Warning:" header). .ti -.5i maildelivery: %libdir%/maildelivery @@ -151,8 +191,7 @@ This is useful for handling admin, dummy, and guest logins. .in -.5i .Uh "SMTP support" -These options are only available if you compiled \fInmh\fP with the -\*(lq/smtp\*(rq support. +These options are only available if you set \fImts\fR to \fBsmtp\fP. .in +.5i .ti -.5i @@ -187,8 +226,7 @@ ignored (sorry, the interface went away under BIND). .in -.5i .Uh "SendMail" -This option is only available if you compiled \fInmh\fP to use -\fISendMail\fP as your delivery agent. +This option is only available if you set \fImts\fR to \fBsendmail\fP. .in +.5i .ti -.5i @@ -199,7 +237,7 @@ The pathname to the \fIsendmail\fR program. .in -.5i .Uh "Post Office Protocol" This option is only available if you have compiled \fInmh\fP with POP -support enabled (i.e., \*(lq--enable-nmh-pop\*(rq). +support enabled (i.e., \*(lq--enable-pop\*(rq). .in +.5i .ti -.5i @@ -290,7 +328,7 @@ your site, and set the appropriate values. .Pr None .Sa -mh\-mts(8) +mh\-mts(8), post(8) .De As listed above .Co