# HG changeset patch # User meillo@marmaro.de # Date 1273233023 -7200 # Node ID 8ea86ac25658d816d872c07eb96717449ff3991a # Parent e1004fcc93c99b2818256eef742e1cc775b0b647 reformating of man page sources with some typographic improvements diff -r e1004fcc93c9 -r 8ea86ac25658 docs/README --- a/docs/README Thu May 06 13:31:57 2010 +0200 +++ b/docs/README Fri May 07 13:50:23 2010 +0200 @@ -1,2 +1,2 @@ -Since masqmail-0.3, documentation is maintained in troff (man page) format. +Since masqmail-0.3, documentation is maintained in troff (man page) format directly. The old XML sources are no longer used. diff -r e1004fcc93c9 -r 8ea86ac25658 docs/masqmail.8 --- a/docs/masqmail.8 Thu May 06 13:31:57 2010 +0200 +++ b/docs/masqmail.8 Fri May 07 13:50:23 2010 +0200 @@ -1,185 +1,265 @@ -.TH masqmail 8 User Manuals +.TH masqmail 8 2010-05-07 masqmail-0.2.21 "Maintenance Commands" + .SH NAME masqmail \- An offline Mail Transfer Agent + .SH SYNOPSIS -\fB/usr/sbin/masqmail [\-C \fIfile\f1\fB] [\-odq] [\-bd] [\-q\fIinterval\f1\fB] +\fB/usr/sbin/masqmail \fR[\fB\-C \fIfile\fR] [\fB\-odq\fR] [\fB\-bd\fR] [\fB\-q\fIinterval\fR] -\fB/usr/sbin/masqmail [\-odq] [\-bs] +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-bs\fR] -\fB/usr/sbin/masqmail [\-bp] +\fB/usr/sbin/masqmail \fR[\fB\-bp\fR] -\fB/usr/sbin/masqmail [\-q] +\fB/usr/sbin/masqmail \fR[\fB\-q\fR] -\fB/usr/sbin/masqmail [\-qo [\fIname\f1\fB]] +\fB/usr/sbin/masqmail \fR[\fB\-qo \fR[\fIname\fR]] -\fB/usr/sbin/masqmail [\-odq] [\-g [\fIname\f1\fB]] +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-g \fR[\fIname\fR]] -\fB/usr/sbin/masqmail [\-odq] [\-go [\fIname\f1\fB]] +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-go \fR[\fIname\fR]] -\fB/usr/sbin/masqmail [\-t] [\-oi] [\-f \fIaddress\f1\fB] [\-\-] \fIaddress...\f1\fB +\fB/usr/sbin/masqmail \fR[\fB\-t\fR] [\fB\-oi\fR] [\fB\-f \fIaddress\fR] [\fB\-\-\fR] \fIaddress... -\fB/usr/sbin/mailq +\fB/usr/sbin/mailq\fR -\fB + .SH DESCRIPTION -MasqMail is a mail server designed for hosts that do not have a permanent internet connection eg. a home network or a single host at home. It has special support for connections to different ISPs. It replaces sendmail or other MTAs such as qmail or exim. It can also act as a pop3 client. +Masqmail is a mail server designed for hosts that do not have a permanent internet connection +e.g. a home network or a single host at home. +It has special support for connections to different ISPs. +It replaces sendmail or other MTAs such as qmail or exim. +It can also act as a pop3 client. + .SH OPTIONS -Since masqmail is intended to replace sendmail, it uses the same command line options, but not all are implemented. There are also two additional options, which are unique to masqmail (\-qo \fIconnection\f1 and \-g) +Since masqmail is intended to replace sendmail, it uses the same command line options, +but not all are implemented. +There are also two additional options, which are unique to masqmail +(\fB\-qo \fIconnection\fR and \fB\-g\fR) + .TP +\fB\-\-\fR -\fB\-\-\f1 +Not a `real' option, it means that all following arguments are to be understood +as arguments and not as options even if they begin with a leading dash `\-'. +Mutt is known to call sendmail with this option. -Not a 'real' option, it means that all following arguments are to be understood as arguments and not as options even if they begin with a leading dash '\-'. Mutt is known to call sendmail with this option. .TP +\fB\-bd\fR -\fB\-bd\f1 +Run as daemon, accepting connections, usually on port 25 if not configured differently. +This is usually used in the startup script at system boot and together with +the \fB\-q\fR option (see below). -Run as daemon, accepting connections, usually on port 25 if not configured differently. This is usually used in the startup script at system boot and together with the \-q option (see below). .TP +\fB\-bi\fR -\fB\-bi\f1 +Old sendmail rebuilds its alias database when invoked with this option. +Masqmail ignores it. +Masqmail reads directly from the file given with `alias_file' in the config file. -Old sendmail rebuilds its alias database when invoked with this option. Masqmail ignores it. Masqmail reads directly from the file given with alias_file in the config file. .TP +\fB\-bp\fR -\fB\-bp\f1 +Show the messages in the queue. Same as calling masqmail as `mailq'. -Show the messages in the queue. Same as calling masqmail as 'mailq'. .TP +\fB\-bs\fR -\fB\-bs\f1 +Accept SMTP commands from stdin. +Some mailers (e.g. pine) use this option as an interface. +It can also be used to call masqmail from inetd. -Accept SMTP commands from stdin. Some mailers (eg pine) use this option as an interface. It can also be used to call masqmail from inetd. .TP +\fB\-B \fIarg\fR -\fB\-B \fIarg\f1\fB\f1 +\fIarg\fR is usually 8BITMIME. +Some mailers use this to indicate that the message contains characters > 127. +Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm, +which is very painful ;-). +Note though that this violates some conventions: +masqmail does not convert 8 bit messages to any MIME format if it encounters +a mail server which does not advertise its 8BITMIME capability, +masqmail does not advertise this itself. +This is the same practice as that of exim (but different to sendmail). -\fIarg\f1 is usually 8BITMIME. Some mailers use this to indicate that the message contains characters > 127. Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm, which is very painful ;-). Note though that this violates some conventions: masqmail does not convert 8 bit messages to any MIME format if it encounters a mail server which does not advertise its 8BITMIME capability, masqmail does not advertise this itself. This is the same practice as that of exim (but different to sendmail). .TP - -\fB\-bV \f1 +\fB\-bV \fR Show version information. + .TP +\fB\-C \fIfilename\fR -\fB\-C \f1\fIfilename\f1 +Use another configuration than \fI/etc/masqmail/masqmail.conf\fR. +Useful for debugging purposes. +If not invoked by a privileged user, masqmail will drop all privileges. -Use another configuration than \fI/etc/masqmail/masqmail.conf\f1. Useful for debugging purposes. If not invoked by a privileged user, masqmail will drop all privileges. .TP +\fB\-d \fInumber\fR -\fB\-d \fInumber\f1\fB\f1 +Set the debug level. +This takes precedence before the value of `debug_level' in the configuration file. +Read the warning in the description of the latter. -Set the debug level. This takes precedence before the value ofdebug_level in the configuration file. Read the warning in the description of the latter. .TP +\fB\-f [\fIaddress\fB]\fR -\fB\-f [\fIaddress\f1\fB]\f1 +Set the return path address to \fIaddress\fR. +Only root, the user mail and anyone in group mail is allowed to do that. -Set the return path address to \fIaddress\f1. Only root, the user mail and anyone in group mail is allowed to do that. .TP +\fB\-F [\fIstring\fB]\fR -\fB\-F [\fIstring\f1\fB]\f1 +Set the full sender name (in the From: header) to \fIstring\fR. -Set the full sender name (in the From: header) to \fIstring\f1. .TP +\fB\-g [\fIname\fB]\fR -\fB\-g [\fIname\f1\fB]\f1 +Get mail (using pop3 or apop), +using the configurations given with get.\fIname\fR in the main configuration. +Without \fIname\fR, all get configurations will be used. +See also \fBmasqmail.get(5)\fR -Get mail (using pop3 or apop), using the configurations given with get.\fIname\f1 in the main configuration. Without \fIname\f1, all get configurations will be used. See also \fBmasqmail.get (5)\f1 .TP +\fB\-go [\fIinterval\fB] [\fIname\fB]\fR -\fB\-go [\fIinterval\f1\fB] [\fIname\f1\fB]\f1 +Can be followed by a connection name. +Use this option in your script which starts as soon as a link to the internet +has been set up (usually ip-up). +When masqmail is called with this option, the specified get configuration(s) +is(are) read and mail will be retrieved from servers on the internet. +The \fIname\fR is defined in the configuration (see \fBonline_gets.\fIname\fR). -Can be followed by a connection name. Use this option in your script which starts as soon as a link to the internet has been set up (usually ip-up). When masqmail is called with this option, the specified get configuration(s) is(are) read and mail will be retrieved from servers on the internet. The \fIname\f1 is defined in the configuration (see \fBonline_gets.\fIname\f1\fB\f1). +If called with an interval option (recognized by a digit as the first characater), +masqmail starts as a daemon and tries to get mail in these intervals. +It checks for the online status first. +Example: `masqmail \-go 5m' will retrieve mail every five minutes. -If called with an interval option (recognized by a digit as the first characater), masqmail starts as a daemon and tries to get mail in these intervals. It checks for the online status first. Example: masqmail \-go 5m will retrieve mail every five minutes. +If called without \fIname\fR the online status is determined with the configured method +(see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR). -If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in \fBmasqmail.conf (5)\f1). .TP +\fB\-i\fR -\fB\-i\f1 +Same as \fB\-oi\fR, see below. -Same as \-oi, see below. .TP +\fB\-Mrm \fIlist\fR -\fB\-Mrm \fIlist\f1\fB\f1 +Remove given messages from the queue. +Only allowed for privileged users. -Remove given messages from the queue. Only allowed for privileged users. .TP +\fB\-oem\fR -\fB\-oem\f1 +If the \fB\-oi\fR ist not also given, always return with a non zero return code. +Maybe someone tells me what this is good for... -If the \-oi ist not also given, always return with a non zero return code. Maybe someone tells me what this is good for... .TP +\fB\-odb\fR -\fB\-odb\f1 +Deliver in background. +Masqmail always does this, which makes this option pretty much useless. -Deliver in background. Masqmail always does this, which makes this option pretty much useless. .TP +\fB\-odq\fR -\fB\-odq\f1 +Do not attempt to deliver immediately. +Any messages will be queued until the next queue running process picks them up and delivers them. +You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf. -Do not attempt to deliver immediately. Any messages will be queued until the next queue running process picks them up and delivers them. You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf. .TP - -\fB\-oi\f1 +\fB\-oi\fR A dot as a single character in a line does not terminate the message. + .TP +\fB\-q [\fIinterval\fB]\fR -\fB\-q [\fIinterval\f1\fB]\f1 +If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue. +Masqmail sends only to those addresses that are on the local net, not to those that are outside. +Use \fB\-qo\fR for those. -If not given with an argument, run a queue process, ie. try to deliver all messages in the queue. Masqmail sends only to those addresses that are on the local net, not to those that are outside. Use \-qo for those. +If you have configured inetd to start masqmail, +you can use this option in a cron job which starts in regular time intervals, +to mimic the same effect as starting masqmail with \fB\-bd \-q30m\fR. -If you have configured inetd to start masqmail, you can use this option in a cron job which starts in regular time intervals, to mimic the same effect as starting masqmail with \-bd \-q30m. +An argument may be a time interval i.e. a numerical value followed by one of the letters. +s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively. +Example: \fB\-q30m\fR. +Masqmail starts as a daemon and a queue runner process will be started automatically +once in this time interval. +This is usually used together with \fB\-bd\fR (see above). -An argument may be a time interval ie. a numerical value followed by one of the letters. s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively. Example: \-q30m. Masqmail starts as a daemon and a queue runner process will be started automatically once in this time interval. This is usually used together with \-bd (see above). .TP +\fB\-qo [\fIname\fB]\fR -\fB\-qo [\fIname\f1\fB]\f1 +Can be followed by a connection name. +Use this option in your script which starts as soon as a link to the internet +has been set up (usually ip-up). +When masqmail is called with this option, the specified route configuration +is read and the queued mail with destinations on the internet will be sent. +The \fIname\fR is defined in the configuration (see \fBonline_routes.\fIname\fR). -Can be followed by a connection name. Use this option in your script which starts as soon as a link to the internet has been set up (usually ip-up). When masqmail is called with this option, the specified route configuration is read and the queued mail with destinations on the internet will be sent. The \fIname\f1 is defined in the configuration (see \fBonline_routes.\fIname\f1\fB\f1). +If called without \fIname\fR the online status is determined with the configured +method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR) -If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in \fBmasqmail.conf (5)\f1) .TP +\fB\-t\fR -\fB\-t\f1 +Read recipients from headers. +Delete `Bcc:' headers. +If any arguments are given, these are interpreted as recipient addresses +and the message will not be sent to these. -Read recipients from headers. Delete 'Bcc:' headers. If any arguments are given, these are interpreted as recipient addresses and the message will not be sent to these. .TP +\fB\-v\fR -\fB\-v\f1 +Log also to stdout. +Currently, some log messages are marked as `write to stdout' and additionally, +all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout +if this option is given. It is disabled in daemon mode. -Log also to stdout. Currently, some log messages are marked as 'write to stdout' and additionally, all messages with priority 'LOG_ALERT' and 'LOG_WARNING' will be written to stdout if this option is given. It is disabled in daemon mode. + .SH ENVIRONMENT FOR PIPES AND MDAS -For security reasons, before any pipe command from an alias expansion or an mda is called, the environment variables will be completely discarded and newly set up. These are: +For security reasons, before any pipe command from an alias expansion or an mda is called, +the environment variables will be completely discarded and newly set up. These are: -SENDER, RETURN_PATH - the return path. +SENDER, RETURN_PATH \(en the return path. -SENDER_DOMAIN - the domain part of the return path. +SENDER_DOMAIN \(en the domain part of the return path. -SENDER_LOCAL - the local part of the return path. +SENDER_LOCAL \(en the local part of the return path. -RECEIVED_HOST - the host the message was received from (unless local). +RECEIVED_HOST \(en the host the message was received from (unless local). -LOCAL_PART, USER, LOGNAME - the local part of the (original) recipient. +LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient. -MESSAGE_ID - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header. +MESSAGE_ID \(en the unique message id. +This is not necessarily identical with the Message ID as given in the Message ID: header. -QUALIFY_DOMAIN - the domain which will be appended to unqualified addresses. +QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses. + .SH FILES -\fI/etc/masqmail/masqmail.conf\f1 is the main configuration for masqmail. Depending on the settings in this file, you will also have other configuration files in \fI/etc/masqmail/\f1. +\fI/etc/masqmail/masqmail.conf\fR is the main configuration for masqmail. +Depending on the settings in this file, you will also have other configuration +files in \fI/etc/masqmail/\fR. -\fI/var/spool/masqmail/\f1 is the spool directory where masqmail stores its spooled messages and the uniq pop ids. +\fI/var/spool/masqmail/\fR is the spool directory where masqmail stores +its spooled messages and the uniq pop ids. -\fI/var/spool/mail/\f1 is the directory where locally delivered mail will be put, if not configured differently in \fImasqmail.conf\f1. +\fI/var/spool/mail/\fR is the directory where locally delivered mail will be put, +if not configured differently in \fImasqmail.conf\fR. -\fI/var/log/masqmail/\f1 is the directory where masqmail stores its log mesages. This can also be somewhere else if configured differently by your sysadmin or the package mantainer. +\fI/var/log/masqmail/\fR is the directory where masqmail stores its log mesages. +This can also be somewhere else if configured differently by your sysadmin or the package mantainer. + .SH CONFORMING TO @@ -191,22 +271,21 @@ RFC 2195 (CRAM-MD5) + .SH AUTHOR -masqmail was written by Oliver Kurth. It is now maintained by Markus Schnalke . +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\f1. +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. There is also a mailing list, you will find information about it at masqmail's main site. + .SH BUGS -You should report them to the mailing list. +Please report them to the mailing list. + .SH SEE ALSO -\fBmasqmail.conf (5)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1, \fBmasqmail.aliases (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - +\fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR, \fBmasqmail.aliases(5)\fR diff -r e1004fcc93c9 -r 8ea86ac25658 docs/masqmail.aliases.5 --- a/docs/masqmail.aliases.5 Thu May 06 13:31:57 2010 +0200 +++ b/docs/masqmail.aliases.5 Fri May 07 13:50:23 2010 +0200 @@ -1,42 +1,54 @@ -.TH masqmail.aliases 5 User Manuals +.TH masqmail.aliases 5 2010-05-07 masqmail-0.2.21 "File Formats" + .SH NAME masqmail.aliases \- masqmail alias file format + + .SH DESCRIPTION -This man page describes the format of the masqmail alias file. Its usual location is \fI/etc/aliases\f1. +This man page describes the format of the masqmail alias file. +Its usual location is \fI/etc/aliases\fR. + .SH FILE FORMAT The alias file consists of lines of the form: local_part: item1, item2, ... -Items can be surrounded by quotes '"'. If within the quotes other quotes are needed for an address they can be escaped with a leading backslash '\'. +Items can be surrounded by double quotes `"'. +If within the quotes other quotes are needed for an address they can be +escaped with a leading backslash `\\'. -A leading '\' indicates that this address shall not be further expanded. +A leading backslash `\\' indicates that this address shall not be further expanded. -A leading pipe symbol '|' indicates that the item shall be treated as a pipe command. The content of the message will then be sent to the standard input of a command. The command will run under the user id and group id masqmail is running as. If quotes are needed, the pipe symbol must appear within the quotes. +A leading pipe symbol `|' indicates that the item shall be treated as a pipe command. +The content of the message will then be sent to the standard input of a command. +The command will run under the user id and group id masqmail is running as. +If quotes are needed, the pipe symbol must appear within the quotes. Loops will be detected, the offending address will be ignored. -Aliases will be expanded at delivery time. This means that if there is a message still in the queue and you change any alias which matches one of the recipient addresses, the change will have effect next time a delivery is attemped. +Aliases will be expanded at delivery time. +This means that if there is a message still in the queue and you change +any alias which matches one of the recipient addresses, +the change will have effect next time a delivery is attemped. There is no need to restart masqmail or run any command when the alias file has been changed. + .SH AUTHOR -masqmail was written by Oliver Kurth. It is now maintained by Markus Schnalke . +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\f1. +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. There is also a mailing list, you will find information about it at masqmail's main site. + .SH BUGS -You should report them to the mailing list. +Please report bugs to the mailing list. + .SH SEE ALSO -\fBmasqmail.conf (5)\f1, \fBmasqmail (8)\f1, - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - +\fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR, diff -r e1004fcc93c9 -r 8ea86ac25658 docs/masqmail.conf.5 --- a/docs/masqmail.conf.5 Thu May 06 13:31:57 2010 +0200 +++ b/docs/masqmail.conf.5 Fri May 07 13:50:23 2010 +0200 @@ -1,200 +1,290 @@ -.TH masqmail.conf 5 User Manuals +.TH masqmail.conf 5 2010-05-07 masqmail-0.2.21 "File Formats" + .SH NAME masqmail.conf \- masqmail configuration file + + .SH DESCRIPTION -This man page describes the syntax of the main configuration file of masqmail. Its usual location is \fI/etc/masqmail/masqmail.conf\f1 +This man page describes the syntax of the main configuration file of masqmail. +Its usual location is \fI/etc/masqmail/masqmail.conf\fR The configuration consists of lines of the form -\fBval\f1 = \fIexpression\f1 +\fBval\fR = \fIexpression\fR -Where \fBval\f1 is a variable name and \fIexpression\f1 a string, which can be quoted with '"'. If the expression is on multiple lines or contains characters other than letters, digits or the characters '.', '-', '_', '/', it must be quoted. You can use quotes inside quotes by escaping them with a backslash. +Where \fBval\fR is a variable name and \fIexpression\fR a string, +which can be quoted with double quotes `"'. +If the expression is on multiple lines or contains characters other than letters, +digits or the characters `.', `-', `_', `/', it must be quoted. +You can use quotes inside quotes by escaping them with a backslash. -Each val has a type, which can be boolean, numeric, string or list. A boolean variable can be set with one of the values 'on', 'yes', and 'true' or 'off', 'no' and 'false'. List items are separated with ';'. For some values patterns (like '*','?') can be used. The spaces before and after the '=' are optional. +Each val has a type, which can be boolean, numeric, string or list. +A boolean variable can be set with one of the values `on', `yes', and `true' or `off', `no' and `false'. +List items are separated with semicolons `;'. +For some values patterns (like `*',`?') can be used. +The spaces before and after the equal sign `=' are optional. -Most lists (exceptions: \fBlocal_hosts\f1,\fBlocal_nets\f1, \fBlisten_addresses\f1, \fBonline_routes\f1 and \fBonline_gets\f1) accept files. These will be recognized by a leading slash '/'. The contents of these files will be included at the position of the file name, there can be items or other files before and after the file entry. The format of the files is different though, within these files each entry is on another line. (And not separated by semicolons). This makes it easy to include large lists which are common in different configuration files, so they do not have to appear in every configuration file. +Most lists (exceptions: \fBlocal_hosts\fR, \fBlocal_nets\fR, \fBlisten_addresses\fR, +\fBonline_routes\fR, and \fBonline_gets\fR) accept files. +These will be recognized by a leading slash `/'. +The contents of these files will be included at the position of the file name, +there can be items or other files before and after the file entry. +The format of the files is different though, within these files each entry is on another line. +(And not separated by semicolons). +This makes it easy to include large lists which are common in different configuration files, +so they do not have to appear in every configuration file. -Blank lines and lines starting with '#' are ignored. +Blank lines and lines starting with a hash `#' are ignored. + .SH OPTIONS + .TP +\fBrun_as_user = \fIboolean\fR -\fBrun_as_user = \fIboolean\f1\fB\f1 +If this is set, masqmail runs with the user id of the user who invoked it and never changes it. +This is for debugging purposes only. +If the user is not root, masqmail will not be able to listen on a port < 1024 +and will not be able to deliver local mail to others than the user. -If this is set, masqmail runs with the user id of the user who invoked it and never changes it. This is for debugging purposes only. If the user is not root, masqmail will not be able to listen on a port < 1024 and will not be able to deliver local mail to others than the user. .TP +\fBuse_syslog = \fIboolean\fR -\fBuse_syslog = \fIboolean\f1\fB\f1 +If this is set, masqmail uses syslogd for logging. +It uses facility MAIL. +You still have to set \fBlog_dir\fR for debug files. -If this is set, masqmail uses syslogd for logging. It uses facility MAIL. You still have to set \fBlog_dir\f1 for debug files. .TP +\fBdebug_level = \fIn\fR -\fBdebug_level = \fIn\f1\fB\f1 +Set the debug level. +Valid values are 0 to 6, increasing it further makes no difference. +Be careful if you set this as high as 5 or higher, the logs may very soon fill your hard drive. -Set the debug level. Valid values are 0 to 6, increasing it further makes no difference. Be careful if you set this as high as 5 or higher, the logs may very soon fill your hard drive. .TP +\fBmail_dir = \fIfile\fR -\fBmail_dir = \fIfile\f1\fB\f1 +The directory where local mail is stored, usually \fI/var/spool/mail\fR or \fI/var/mail\fR. -The directory where local mail is stored, usually \fI/var/spool/mail\f1 or \fI/var/mail\f1. .TP +\fBspool_dir = \fIfile\fR -\fBspool_dir = \fIfile\f1\fB\f1 +The directory where masqmail stores its spool files (and later also other stuff). +It must have a subdirectory \fIinput\fR. +Masqmail needs read and write permissions for this directory. +I suggest to use \fI/var/spool/masqmail\fR. -The directory where masqmail stores its spool files (and later also other stuff). It must have a subdirectory \fIinput\f1. Masqmail needs read and write permissions for this directory. I suggest to use \fI/var/spool/masqmail\f1. .TP +\fBhost_name = \fIstring\fR -\fBhost_name = \fIstring\f1\fB\f1 +This is used in different places: Masqmail identifies itself in the greeting banner +on incoming connections and in the HELO/EHLO command for outgoing connections with this name, +it is used in the Received: header and to qualify the sender of a locally originating message. -This is used in different places: Masqmail identifies itself in the greeting banner on incoming connections and in the HELO/EHLO command for outgoing connections with this name, it is used in the Received: header and to qualify the sender of a locally originating message. +If the string begins with a slash `/', it it assumed that it is a filename, +and the first line of this file will be used. +Usually this will be `/etc/mailname' to make masqmail conform to Debian policies. -If the string begins with a slash '/', it it assumed that it is a filename, and the first line of this file will be used. Usually this will be '/etc/mailname' to make masqmail conform to Debian policies. +It is not used to find whether an address is local. Use \fBlocal_hosts\fR for that. -It is not used to find whether an address is local. Use \fBlocal_hosts\f1 for that. .TP - -\fBremote_port = \fIn\f1\fB\f1 +\fBremote_port = \fIn\fR The remote port number to be used. This defaults to port 25. -This option is deprecated. Use \fBhost_name\f1 in the route configuration instead. See \fBmasqmail.route (5)\f1. +This option is deprecated. +Use \fBhost_name\fR in the route configuration instead. +See \fBmasqmail.route(5)\fR. + .TP +\fBlocal_hosts = \fIlist\fR -\fBlocal_hosts = \fIlist\f1\fB\f1 +A semicolon `;' separated list of hostnames which are considered local. +Normally you set it to "localhost;foo;foo.bar.com" if your host has the +fully qualified domain name `foo.bar.com'. -A semicolon ';' separated list of hostnames which are considered local. Normally you set it to "localhost;foo;foo.bar.com" if your host has the fully qualified domain name 'foo.bar.com'. .TP +\fBlocal_nets = \fIlist\fR -\fBlocal_nets = \fIlist\f1\fB\f1 +A semicolon `;' separated list of hostnames which are on the `local' net. +Delivery to these hosts is attempted immediately. +You can use patterns with `*', e.g. "*.bar.com". -A semicolon ';' separated list of hostnames which are on the 'local' net. Delivery to these hosts is attempted immediately. You can use patterns with '*', eg. "*.bar.com". .TP +\fBlocal_addresses = \fIlist\fR -\fBlocal_addresses = \fIlist\f1\fB\f1 +A semicolon `;' separated list of fully qualified email-addresses which are +considered local although their domain name part is not in the list of \fBlocal_hosts\fR. -A semicolon ';' separated list of fully qualified email-addresses which are considered local although their domain name part is not in the list of \fBlocal_hosts\f1. - -For example: There are two people working at your LAN: person1@yourdomain and person2@yourdomain. But there are other persons @yourdomain which are NOT local. So you can not put yourdomain to the list of local_hosts. If person1 now wants to write to person2@yourdomain and this mail should not leave the LAN then you can put +For example: There are two people working at your LAN: person1@yourdomain and person2@yourdomain. +But there are other persons @yourdomain which are NOT local. +So you can not put yourdomain to the list of local_hosts. +If person1 now wants to write to person2@yourdomain and this mail should not leave the LAN then you can put local_addresses = "person1@yourdomain;person2@yourdomain" to your masqmail.conf. + .TP +\fBnot_local_addresses = \fIlist\fR -\fBnot_local_addresses = \fIlist\f1\fB\f1 +A semicolon `;' separated list of fully qualified email-addresses which are +considered not local although their domain name part is in the list of \fBlocal_hosts\fR. -A semicolon ';' separated list of fully qualified email-addresses which are considered not local although their domain name part is in the list of \fBlocal_hosts\f1. - -This is the opposite of the previous case. The majority of addresses of a specific domain are local. But some users are not. With this option you can easily exclude these users. +This is the opposite of the previous case. +The majority of addresses of a specific domain are local. +But some users are not. +With this option you can easily exclude these users. Example: local_hosts = "localhost;myhost;mydomain.net" not_local_addresses = "eric@mydomain.net" + .TP +\fBlisten_addresses = \fIlist\fR -\fBlisten_addresses = \fIlist\f1\fB\f1 +A semicolon `;' separated list of interfaces on which connections will be accepted. +An interface ist defined by a hostname, optionally followed by a colon `:' and a number for the port. +If this is left out, port 25 will be used. -A semicolon ';' separated list of interfaces on which connections will be accepted. An interface ist defined by a hostname, optionally followed by a colon ':' and a number for the port. If this is left out, port 25 will be used. +You can set this to "localhost:25;foo:25" if your hostname is `foo'. -You can set this to "localhost:25;foo:25" if your hostname is 'foo'. +Note that the names are resolved to IP addreses. +If your host has different names which resolve to the same IP, +use only one of them, otherwise you will get an error message. -Note that the names are resolved to IP addreses. If your host has different names which resolve to the same IP, use only one of them, otherwise you will get an error message. .TP +\fBdo_save_envelope_to = \fIboolean\fR -\fBdo_save_envelope_to = \fIboolean\f1\fB\f1 +If this is set to true, a possibly existing Envelope-to: header in an incoming mail +which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header. -If this is set to true, a possibly existing Envelope-to: header in an incoming mail which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header. - -This is useful if you retrieve mail from a pop3 server with either masqmail or fetchmail, and the server supports Envelope-to: headers, and you want to make use of those with a mail filtering tool, eg. procmail. It cannot be preserved because masqmail sets such a header by itself. +This is useful if you retrieve mail from a pop3 server with either masqmail or fetchmail, +and the server supports Envelope-to: headers, +and you want to make use of those with a mail filtering tool, e.g. procmail. +It cannot be preserved because masqmail sets such a header by itself. Default is false. + .TP +\fBdo_relay = \fIboolean\fR -\fBdo_relay = \fIboolean\f1\fB\f1 +If this is set to false, mail with a return path that is not local and a destination +that is also not local will not be accepted via smtp and a 550 reply will be given. +Default is true. -If this is set to false, mail with a return path that is not local and a destination that is also not local will not be accepted via smtp and a 550 reply will be given. Default is true. +Note that this will not protect you from spammers using open relays, +but from users unable to set their address in their mail clients. -Note that this will not protect you from spammers using open relays, but from users unable to set their address in their mail clients. .TP +\fBdo_queue = \fIboolean\fR -\fBdo_queue = \fIboolean\f1\fB\f1 +If this is set, mail will not be delivered immediately when accepted. +Same as calling masqmail with the \fB\-odq\fR option. -If this is set, mail will not be delivered immediately when accepted. Same as calling masqmail with the \fB\-odq\f1 option. .TP +\fBonline_routes.\fIname\fR = \fIlist\fR -\fBonline_routes.\fIname\f1\fB = \fIlist\f1\fB\f1 +Replace \fIname\fR with a name to identify a connection. +Set this to a filename (or a list of filenames) for the special route configuration for that connection. +You will use that name to call masqmail with the \fB\-qo\fR option every time a +connection to your ISP is set up. -Replace \fIname\f1 with a name to identify a connection. Set this to a filename (or a list of filenames) for the special route configuration for that connection. You will use that name to call masqmail with the \fB\-qo\f1 option every time a connection to your ISP is set up. +Example: Your ISP has the name FastNet. +Then you write the following line in the main configuration: -Example: Your ISP has the name FastNet. Then you write the following line in the main configuration: +\fBonline_routes.FastNet\fR = \fI"/etc/masqmail/fastnet.route"\fR -\fBonline_routes.FastNet\f1 = \fI"/etc/masqmail/fastnet.route"\f1 +\fI/etc/masqmail/fastnet.route\fR is the route configuration file, see \fBmasqmail.route(5)\fR. +As soon as a link to FastNet has been set up, you call masqmail \fB\-qo \fIFastNet\fR. +Masqmail will then read the specified file and send the mails. -\fI/etc/masqmail/fastnet.route\f1 is the route configuration file, see \fBmasqmail.route (5)\f1. As soon as a link to FastNet has been set up, you call masqmail \fB\-qo\f1 \fIFastNet\f1. Masqmail will then read the specified file and send the mails. .TP +\fBconnect_route.\fIname\fR = \fIlist\fR -\fBconnect_route.\fIname\f1\fB = \fIlist\f1\fB\f1 +Old name for \fBonline_routes\fR. -Old name for \fBonline_routes\f1. .TP +\fBlocal_net_route = \fIfile\fR -\fBlocal_net_route = \fIfile\f1\fB\f1 +This is similar to \fBonline_routes.\fIname\fR but for the local net. +Recipient addresses that are in local_nets will be routed using this route configuration. +Main purpose is to define a mail server with mail_host in your local network. +In simple environments this can be left unset. +If unset, a default route configuration will be used. -This is similar to \fBonline_routes.\fIname\f1\fB\f1 but for the local net. Recipient addresses that are in local_nets will be routed using this route configuration. Main purpose is to define a mail server with mail_host in your local network. In simple environments this can be left unset. If unset, a default route configuration will be used. .TP +\fBalias_file = \fIfile\fR -\fBalias_file = \fIfile\f1\fB\f1 +Set this to the location of your alias file. +If unset, no aliasing will be done. -Set this to the location of your alias file. If unset, no aliasing will be done. .TP - -\fBalias_local_caseless = \fIboolean\f1\fB\f1 +\fBalias_local_caseless = \fIboolean\fR If this is set, local parts in the alias file will be matched disregarding upper/lower case. + .TP +\fBpipe_fromline = \fIboolean\fR -\fBpipe_fromline = \fIboolean\f1\fB\f1 +If this is set, a from line will be prepended to the output stream whenever +a pipe command is called after an alias expansion. +Default is false. -If this is set, a from line will be prepended to the output stream whenever a pipe command is called after an alias expansion. Default is false. .TP +\fBpipe_fromhack = \fIboolean\fR -\fBpipe_fromhack = \fIboolean\f1\fB\f1 +If this is set, each line beginning with `From ' is replaced with `>From ' +whenever a pipe command is called after an alias expansion. +You probably want this if you have set \fBpipe_fromline\fR above. +Default is false. -If this is set, each line beginning with 'From ' is replaced with '>From ' whenever a pipe command is called after an alias expansion. You probably want this if you have set \fBpipe_fromline\f1 above. Default is false. .TP +\fBmbox_default = \fIstring\fR -\fBmbox_default = \fIstring\f1\fB\f1 +The default local delivery method. +Can be one of mbox, mda or maildir (the latter only if maildir support is enabled at compile time). +Default is mbox. +You can override this for each user by using the \fBmbox_users\fR, \fBmda_users\fR, +or \fBmaildir_users\fR options (see below). -The default local delivery method. Can be one of mbox, mda or maildir (the latter only if maildir support is enabled at compile time). Default is mbox. You can override this for each user by using the \fBmbox_users\f1, \fBmda_users\f1 or \fBmaildir_users\f1 options (see below). .TP - -\fBmbox_users = \fIlist\f1\fB\f1 +\fBmbox_users = \fIlist\fR A list of users which wish delivery to an mbox style mail folder. + .TP +\fBmda_users = \fIlist\fR -\fBmda_users = \fIlist\f1\fB\f1 +A list of users which wish local delivery to an mda. +You have to set \fBmda\fR (see below) as well. -A list of users which wish local delivery to an mda. You have to set \fBmda\f1 (see below) as well. .TP +\fBmaildir_users = \fIlist\fR -\fBmaildir_users = \fIlist\f1\fB\f1 +A list of users which wish delivery to a qmail style maildir. +The path to maildir is ~/Maildir/. +The maildir will be created if it does not exist. -A list of users which wish delivery to a qmail style maildir. The path to maildir is ~/Maildir/. The maildir will be created if it does not exist. .TP +\fBmda = \fIexpand string\fR -\fBmda = \fIexpand string\f1\fB\f1 +If you want local delivery to be transferred to an mda (Mail Delivery Agent), +set this to a command. +The argument will be expanded on delivery time, +you can use variables beginning with a dolloar sign `$', optionally enclosed in curly braces. +Variables you can use are: -If you want local delivery to be transferred to an mda (Mail Delivery Agent), set this to a command. The argument will be expanded on delivery time, you can use variables beginning with a '$' sign, optionally enclosed in curly braces. Variables you can use are: - -uid - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header. +uid - the unique message id. +This is not necessarily identical with the Message ID as given in the Message ID: header. received_host - the host the mail was received from -ident - the ident, this is either the ident delivered by the ident protocol or the user id of the sender if the message was received locally. +ident - the ident, this is either the ident delivered by the ident protocol +or the user id of the sender if the message was received locally. return_path_local - the local part of the return path (sender). @@ -212,46 +302,69 @@ mda="/usr/bin/procmail \-Y \-d ${rcpt_local}" -For the mda, as for pipe commands, a few environment variables will be set as well. See \fBmasqmail (8)\f1. To use environment variables for the mda, the '$' sign has to be escaped with a backslash, otherwise they will be tried to be expanded with the internal variables. +For the mda, as for pipe commands, a few environment variables will be set as well. +See \fBmasqmail(8)\fR. +To use environment variables for the mda, the dollar sign `$' has to be escaped with a backslash, +otherwise they will be tried to be expanded with the internal variables. + .TP +\fBmda_fromline = \fIboolean\fR -\fBmda_fromline = \fIboolean\f1\fB\f1 +If this is set, a from line will be prepended to the output stream whenever +a message is delivered to an mda. +Default is false. -If this is set, a from line will be prepended to the output stream whenever a message is delivered to an mda. Default is false. .TP +\fBmda_fromhack = \fIboolean\fR -\fBmda_fromhack = \fIboolean\f1\fB\f1 +If this is set, each line beginning with `From ' is replaced with `>From ' +whenever a message is delivered to an mda. +You probably want this if you have set \fBmda_fromline\fR above. +Default is false. -If this is set, each line beginning with 'From ' is replaced with '>From ' whenever a message is delivered to an mda. You probably want this if you have set \fBmda_fromline\f1 above. Default is false. .TP +\fBonline_detect = \fIstring\fR -\fBonline_detect = \fIstring\f1\fB\f1 +Defines the method masqmail uses to detect whether there is currently an online connection. +It can have the values \fBfile\fR, \fBpipe\fR, or \fBmserver\fR. -Defines the method MasqMail uses to detect whether there is currently an online connection. It can have the values \fBfile\f1, \fBpipe\f1 or \fBmserver\f1. +When it is set to \fBfile\fR, masqmail first checks for the existence of \fBonline_file\fR +(see below) and if it exists, it reads it. +The content of the file should be the name of the current connection as defined +with \fBconnect_route.\fIname\fR (trailing whitespace is removed). -When it is set to \fBfile\f1, MasqMail first checks for the existence of \fBonline_file\f1 (see below) and if it exists, it reads it. The content of the file should be the name of the current connection as defined with \fBconnect_route.\fIname\f1\fB\f1 (trailing whitespace is removed). +When it is set to \fBpipe\fR, masqmail calls the executable given by the +\fBonline_pipe\fR option (see below) and reads the current online status from its standard output. -When it is set to \fBpipe\f1, MasqMail calls the executable given by the \fBonline_pipe\f1 option (see below) and reads the current online status from its standard output. +When it is set to \fBmserver\fR, masqmail connects to the masqdialer server +using the value of \fBmserver_iface\fR and asks it whether a connection exists and for the name, +which should be the name of the current connection as defined with \fBconnect_route.\fIname\fR. -When it is set to \fBmserver\f1, MasqMail connects to the masqdialer server using the value of \fBmserver_iface\f1 and asks it whether a connection exists and for the name, which should be the name of the current connection as defined with \fBconnect_route.\fIname\f1\fB\f1. +No matter how masqmail detects the online status, +only messages that are accepted at online time will be delivered using the connection. +The spool still has to be emptied with masqmail \fB\-qo\fIconnection\fR. -No matter how MasqMail detects the online status, only messages that are accepted at online time will be delivered using the connection. The spool still has to be emptied with masqmail \fB\-qo\f1\fIconnection\f1. .TP +\fBonline_file = \fIfile\fR -\fBonline_file = \fIfile\f1\fB\f1 - -This is the name of the file checked for when MasqMail determines whether it is online. The file should only exist when there is currently a connection. Create it in your ip-up script with eg. +This is the name of the file checked for when masqmail determines whether it is online. +The file should only exist when there is currently a connection. +Create it in your ip-up script with e.g. echo \-n > /tmp/connect_route chmod 0644 /tmp/connect_route Do not forget to delete it in your ip-down script. + .TP +\fBonline_pipe = \fIfile\fR -\fBonline_pipe = \fIfile\f1\fB\f1 - -This is the name of the executable which will be called to determine the online status. This executable should just print the name of the current connection to the standard output and return a zero status code. masqmail assumes it is offline if the script returns with a non zero status. Simple example: +This is the name of the executable which will be called to determine the online status. +This executable should just print the name of the current connection to +the standard output and return a zero status code. +masqmail assumes it is offline if the script returns with a non zero status. +Simple example: #!/bin/sh @@ -261,84 +374,109 @@ exit 0 -Of course, instead of the example above you could as well use \fBfile\f1 as the online detection method, but you can do something more sophisticated. +Of course, instead of the example above you could as well use \fBfile\fR as +the online detection method, but you can do something more sophisticated. + .TP +\fBmserver_iface = \fIinterface\fR -\fBmserver_iface = \fIinterface\f1\fB\f1 +The interface the masqdialer server is listening to. +Usually this will be "localhost:224" if mserver is running on the same host as masqmail. +But using this option, you can also let masqmail run on another host by setting +\fBmserver_iface\fR to another hostname, e.g. "foo:224". -The interface the masqdialer server is listening to. Usually this will be "localhost:224" if mserver is running on the same host as masqmail. But using this option, you can also let masqmail run on another host by setting \fBmserver_iface\f1 to another hostname, eg. "foo:224". .TP +\fBget.\fIname\fR = \fIfile\fR -\fBget.\fIname\f1\fB = \fIfile\f1\fB\f1 +Replace \fIname\fR with a name to identify a get configuration. +Set this to a filename for the get configuration. +These files will be used to retrieve mail when called with the \-g option. -Replace \fIname\f1 with a name to identify a get configuration. Set this to a filename for the get configuration. These files will be used to retrieve mail when called with the \-g option. .TP +\fBonline_gets.\fIname\fR = \fIlist\fR -\fBonline_gets.\fIname\f1\fB = \fIlist\f1\fB\f1 +Replace \fIname\fR with a name to identify an online configuration. +Set this to a filename (or a list of filenames) for the get configuration. +These files will be used to retrieve mail when called with the \-go option. -Replace \fIname\f1 with a name to identify an online configuration. Set this to a filename (or a list of filenames) for the get configuration. These files will be used to retrieve mail when called with the \-go option. .TP +\fBident_trusted_nets = \fIlist\fR -\fBident_trusted_nets = \fIlist\f1\fB\f1 +\fIlist\fR is a list of networks of the form a.b.c.d/e (e.g. 192.168.1.0/24), +from which the ident given by the ident protocol will be trusted, +so a user can delete his mail from the queue if the ident is identical to his login name. -\fIlist\f1 is a list of networks of the form a.b.c.d/e (eg. 192.168.1.0/24), from which the ident given by the ident protocol will be trusted, so a user can delete his mail from the queue if the ident is identical to his login name. .TP +\fBerrmsg_file = \fIfile\fR -\fBerrmsg_file = \fIfile\f1\fB\f1 - -Set this to a template which will be used to generate delivery failure reports. Variable parts within the template begin with a dollar sign and are identical to those which can be used as arguments for the mda command, see \fBmda\f1 above. Additional information can be included with @failed_rcpts, @msg_headers and @msg_body, these must be at the beginning of a line and will be replaced with the list of the failed recipients, the message headers and the message body of the failed message. +Set this to a template which will be used to generate delivery failure reports. +Variable parts within the template begin with a dollar sign and are identical +to those which can be used as arguments for the mda command, see \fBmda\fR above. +Additional information can be included with @failed_rcpts, @msg_headers and @msg_body, +these must be at the beginning of a line and will be replaced with the list of the failed recipients, +the message headers and the message body of the failed message. Default is /usr/share/masqmail/tpl/failmsg.tpl. + .TP +\fBwarnmsg_file = \fIfile\fR -\fBwarnmsg_file = \fIfile\f1\fB\f1 - -Set this to a template which will be used to generate delivery warning reports. It uses the same mechanisms for variables as \fBerrmsg_file\f1, see above. +Set this to a template which will be used to generate delivery warning reports. +It uses the same mechanisms for variables as \fBerrmsg_file\fR, see above. Default is /usr/share/masqmail/tpl/warnmsg.tpl. + .TP +\fBwarn_intervals\fR = \fIlist\fR -\fBwarn_intervals\f1 = \fIlist\f1 +Set this to a list of time intervals, at which delivery warnings +(starting with the receiving time of the message) shall be generated. -Set this to a list of time intervals, at which delivery warnings (starting with the receiving time of the message) shall be generated. - -A warning will only be generated just after an attempt to deliver the mail and if that attempt failed temporarily. So a warning may be generated after a longer time, if there was no attempt before. +A warning will only be generated just after an attempt to deliver the mail +and if that attempt failed temporarily. +So a warning may be generated after a longer time, if there was no attempt before. Default is "1h;4h;8h;1d;2d;3d" + .TP +\fBmax_defer_time\fR = \fItime\fR -\fBmax_defer_time\f1 = \fItime\f1 +This is the maximum time, in which a temporarily failed mail will be kept in the spool. +When this time is exceeded, it will be handled as a delivery failure, +and the message will be bounced. -This is the maximum time, in which a temporarily failed mail will be kept in the spool. When this time is exceeded, it will be handled as a delivery failure, and the message will be bounced. - -The excedence of this time will only be noticed if the message was actually tried to be delivered. If, for example, the message can only be delivered when online, but you have not been online for that time, no bounce will be generated. +The excedence of this time will only be noticed if the message was actually tried to be delivered. +If, for example, the message can only be delivered when online, +but you have not been online for that time, no bounce will be generated. Default is 4d (4 days) + .TP +\fBlog_user = \fIname\fR -\fBlog_user = \fIname\f1\fB\f1 +Replace \fIname\fR with a valid local or remote mail address. -Replace \fIname\f1 with a valid local or remote mail address. +If this option is not empty, then a copy of every mail, +that passes trough the masqmail system will also be sent to the given mail address. -If this option is not empty, then a copy of every mail, that passes trough the masqmail system will also be sent to the given mail address. +For example you can feed your mails into a program like hypermail +for archiving purpose by placing an appropriate pipe command in masqmail.alias -For example you can feed your mails into a program like hypermail for archiving purpose by placing an appropriate pipe command in masqmail.alias + .SH AUTHOR -masqmail was written by Oliver Kurth. It is now maintained by Markus Schnalke . +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\f1. +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. There is also a mailing list, you will find information about it at masqmail's main site. + .SH BUGS -You should report them to the mailing list. +Please report bugs to the mailing list. + .SH SEE ALSO -\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - +\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR diff -r e1004fcc93c9 -r 8ea86ac25658 docs/masqmail.get.5 --- a/docs/masqmail.get.5 Thu May 06 13:31:57 2010 +0200 +++ b/docs/masqmail.get.5 Fri May 07 13:50:23 2010 +0200 @@ -1,100 +1,134 @@ -.TH masqmail.get 5 User Manuals +.TH masqmail.get 5 2010-05-07 masqmail-0.2.21 "File Formats" + .SH NAME masqmail.get \- masqmail get configuration file + + .SH DESCRIPTION This man page describes the options available for the masqmail get configuration. + .SH OPTIONS + .TP +\fBprotocol\fR = \fIstring\fR -\fBprotocol\f1 = \fIstring\f1 +The protocol with which you retrieve your mail. +Currently only `pop3' and `apop' are supported. +There is no default. -The protocol with which you retrieve your mail. Currently only 'pop3' and 'apop' are supported. There is no default. .TP - -\fBserver\f1 = \fIstring\f1 +\fBserver\fR = \fIstring\fR The server you get your mail from. + .TP +\fBresolve_list\fR = \fIlist\fR -\fBresolve_list\f1 = \fIlist\f1 +Specify the method how the domain of the server is resolved. +Possible values are dns_mx, dns_a, byname. +For `dns_mx', the domain is assumed to be an MX pointer to a list of host names, +these will be tried each in order +(lowest preference value first, equal preference values in random order). +For `dns_a', the domain is assumed to be an A pointer. +For `byname', the library function \fBgethostbyname(3)\fR will be used. -Specify the method how the domain of the server is resolved. Possible values are dns_mx, dns_a, byname. For 'dns_mx', the domain is assumed to be an MX pointer to a list of host names, these will be tried each in order (lowest preference value first, equal preference values in random order). For 'dns_a', the domain is assumed to be an A pointer. For 'byname', the library function \fBgethostbyname (3)\f1 will be used. +The default is "dns_a;byname". +It does not make much sense here to use `dns_mx'. -The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'. .TP - -\fBuser\f1 = \fIstring\f1 +\fBuser\fR = \fIstring\fR Your login name. + .TP - -\fBpass\f1 = \fIstring\f1 +\fBpass\fR = \fIstring\fR Your password. + .TP +\fBaddress\fR = \fIaddress\fR -\fBaddress\f1 = \fIaddress\f1 +The address where the retrieved mail should be sent to. +It can be any address, but you probably want to set this to a local address on your LAN. -The address where the retrieved mail should be sent to. It can be any address, but you probably want to set this to a local address on your LAN. .TP +\fBreturn_path\fR = \fIaddress\fR -\fBreturn_path\f1 = \fIaddress\f1 +If set, masqmail sets the return path to this address. +Bounces generated during further delivery will be sent to this address. +If unset, masqmail looks for the Return-Path: header in the mail, +if this does not exist it uses the From: address and if this fails, postmaster will be used. -If set, masqmail sets the return path to this address. Bounces generated during further delivery will be sent to this address. If unset, masqmail looks for the Return-Path: header in the mail, if this does not exist it uses the From: address and if this fails, postmaster will be used. +It is in most cases not useful to set this to the same address as the `address' +option as this may generate multiple bounces. +postmaster is recommended. -It is in most cases not useful to set this to the same address as the 'address' option as this may generate multiple bounces. postmaster is recommended. .TP +\fBdo_keep\fR = \fIboolean\fR -\fBdo_keep\f1 = \fIboolean\f1 +If you want to keep your mail on the server after you retrieved it, set this to true. +It is recommended that you also set do_uidl, +otherwise you will get the mail again each time you connect to the server. +Masqmail does not check any headers before it retrieves mail, which may mark it as already fetched. +Note that this behaviour is different to that of fetchmail. +The default is false. -If you want to keep your mail on the server after you retrieved it, set this to true. It is recommended that you also set do_uidl, otherwise you will get the mail again each time you connect to the server. Masqmail does not check any headers before it retrieves mail, which may mark it as already fetched. Note that this behaviour is different to that of fetchmail. The default is false. .TP +\fBdo_uidl\fR = \fIboolean\fR -\fBdo_uidl\f1 = \fIboolean\f1 +If set, masqmail keeps a list of unique IDs of mails already fetched, +so that they will not be retrieved again. +Default is false. -If set, MasqMail keeps a list of unique IDs of mails already fetched, so that they will not be retrieved again. Default is false. .TP +\fBdo_uidl_dele\fR = \fIboolean\fR -\fBdo_uidl_dele\f1 = \fIboolean\f1 +If set, and \fBdo_uidl\fR is also set, MasqMail sends a delete (DELE) command +to the server for each message uid in the uid listing at the beginning of the session. +This prevents mail to be left on the server if masqmail gets interrupted during +a session before it can send the QUIT command to the server. +Default is false. -If set, and \fBdo_uidl\f1 is also set, MasqMail sends a delete (DELE) command to the server for each message uid in the uid listing at the beginning of the session. This prevents mail to be left on the server if masqmail gets interrupted during a session before it can send the QUIT command to the server. Default is false. .TP +\fBmax_size\fR = \fInumeric\fR -\fBmax_size\f1 = \fInumeric\f1 +If set to a value > 0, only messages smaller than this in bytes will be retrieved. +The default is 0. -If set to a value > 0, only messages smaller than this in bytes will be retrieved. The default is 0. .TP +\fBmax_count\fR = \fInumeric\fR -\fBmax_count\f1 = \fInumeric\f1 +If set to a value > 0, only \fBmax_count\fR messages will be retrieved. +The default is 0. -If set to a value > 0, only \fBmax_count\f1 messages will be retrieved. The default is 0. .TP +\fBwrapper\fR = \fIcommand\fR -\fBwrapper\f1 = \fIcommand\f1 - -If set, instead of opening a connection to a remote server, \fIcommand\f1 will be called and all traffic will be piped to its stdin and from its stdout. Purpose is to tunnel ip traffic, eg. for ssl. +If set, instead of opening a connection to a remote server, +\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout. +Purpose is to tunnel ip traffic, e.g. for ssl. Example for ssl tunneling: wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null" + + .SH AUTHOR -masqmail was written by Oliver Kurth. It is now maintained by Markus Schnalke . +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\f1. +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. There is also a mailing list, you will find information about it at masqmail's main site. + .SH BUGS -You should report them to the mailing list. +Please report bugs to the mailing list. + .SH SEE ALSO -\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.conf (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - +\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.conf(5)\fR diff -r e1004fcc93c9 -r 8ea86ac25658 docs/masqmail.route.5 --- a/docs/masqmail.route.5 Thu May 06 13:31:57 2010 +0200 +++ b/docs/masqmail.route.5 Fri May 07 13:50:23 2010 +0200 @@ -1,213 +1,308 @@ -.TH masqmail.route 5 User Manuals +.TH masqmail.route 5 2010-05-07 masqmail-0.2.21 "File Formats" + .SH NAME masqmail.route \- masqmail route configuration file + + .SH DESCRIPTION -This man page describes the syntax of the route configuration files of \fBmasqmail (8)\f1. Their usual locations are in \fI/etc/masqmail/\f1. +This man page describes the syntax of the route configuration files of \fBmasqmail (8)\fR. +Their usual locations are in \fI/etc/masqmail/\fR. .SH OPTIONS + .TP +\fBprotocol\fR = \fIstring\fR -\fBprotocol\f1 = \fIstring\f1 +\fIstring\fR can be one of `smtp' or `pipe', default is `smtp'. +If set to `smtp', mail will be sent with the SMTP protocol to its destination. +If set to `pipe', you also have to set `pipe' to a command, the message will then be piped to a program. +See option `pipe' below. -\fIstring\f1 can be one of 'smtp' or 'pipe', default is 'smtp'. If set to 'smtp', mail will be sent with the SMTP protocol to its destination. If set to 'pipe', you also have to set 'pipe' to a command, the message will then be piped to a program. See option 'pipe' below. .TP +\fBmail_host\fR = \fIstring\fR -\fBmail_host\f1 = \fIstring\f1 - -This is preferably the mail server of your ISP. All outgoing messages will be sent to this host which will distribute them to their destinations. If you do not set this mails will be sent directly. Because the mail server is probably 'near' to you, mail transfer will be much faster if you use it. +This is preferably the mail server of your ISP. +All outgoing messages will be sent to this host which will distribute them to their destinations. +If you do not set this mails will be sent directly. +Because the mail server is probably `near' to you, mail transfer will be much faster if you use it. You can optionally give a port number following the host name and a colon, eg mail_host="mail.foo.com:25". + .TP +\fBresolve_list\fR = \fIlist\fR -\fBresolve_list\f1 = \fIlist\f1 - -Specify the method how the domain of the server is resolved. Possible values are dns_mx, dns_a, byname. For 'dns_mx', the domain is assumed to be an MX pointer to a list of host names, these will be tried each in order (lowest preference value first, equal preference values in random order). For 'dns_a', the domain is assumed to be an A pointer. For 'byname', the library function \fBgethostbyname (3)\f1 will be used. +Specify the method how the domain of the server is resolved. +Possible values are dns_mx, dns_a, byname. +For `dns_mx', the domain is assumed to be an MX pointer to a list of host names, +these will be tried each in order (lowest preference value first, equal preference values in random order). +For `dns_a', the domain is assumed to be an A pointer. +For `byname', the library function \fBgethostbyname(3)\fR will be used. The default is "dns_mx;dns_a;byname". + .TP +\fBconnect_error_fail\fR = \fIboolean\fR -\fBconnect_error_fail\f1 = \fIboolean\f1 +If this is set, a connection error will cause a mail delivery to fail, ie. it will be bounced. +If it is unset, it will just be defered. -If this is set, a connection error will cause a mail delivery to fail, ie. it will be bounced. If it is unset, it will just be defered. - -Default is false. The reason for this is that masqmail is designed for non permanent internet connections, where such errors may occur quite often, and a bounce would be annoying. +Default is false. +The reason for this is that masqmail is designed for non permanent internet connections, +where such errors may occur quite often, and a bounce would be annoying. For the default local_net route is is set to true. + .TP +\fBhelo_name\fR = \fIstring\fR -\fBhelo_name\f1 = \fIstring\f1 +Set the name given with the HELO/EHLO command. If this is not set, +\fBhost_name\fR from \fImasqmail.conf\fR will be used, +if the \fBdo_correct_helo\fR option (see below) is unset. -Set the name given with the HELO/EHLO command. If this is not set, \fBhost_name\f1 from \fImasqmail.conf\f1 will be used, if the \fBdo_correct_helo\f1 option (see below) is unset. .TP +\fBdo_correct_helo\fR = \fIboolean\fR -\fBdo_correct_helo\f1 = \fIboolean\f1 +If this is set, masqmail tries to look up your host name as it appears +on the internet and sends this in the HELO/EHLO command. +Some servers are so picky that they want this. +Which is really crazy. +It just does not make any sense to lie about ones own identity, +because it can always be looked up by the server. +Nobody should believe in the name given by HELO/EHLO anyway. +If this is not set, \fBhost_name\fR from \fImasqmail.conf\fR or as given with +the \fBhelo_name\fR (see above) will be used. -If this is set, masqmail tries to look up your host name as it appears on the internet and sends this in the HELO/EHLO command. Some servers are so picky that they want this. Which is really crazy. It just does not make any sense to lie about ones own identity, because it can always be looked up by the server. Nobody should believe in the name given by HELO/EHLO anyway. If this is not set, \fBhost_name\f1 from \fImasqmail.conf\f1 or as given with the \fBhelo_name\f1 (see above) will be used. .TP +\fBdo_pipelining\fR = \fIboolean\fR -\fBdo_pipelining\f1 = \fIboolean\f1 +If this is set to false, masqmail will not use ESMTP PIPELINING, +even if the server announces that it is able to cope with it. +Default is true. -If this is set to false, masqmail will not use ESMTP PIPELINING, even if the server announces that it is able to cope with it. Default is true. +You do not want to set this to false unless the mail setup on the +remote server side is really broken. +Keywords: wingate. -You do not want to set this to false unless the mail setup on the remote server side is really broken. Keywords: wingate. .TP +\fBallowed_mail_locals\fR = \fIlist\fR -\fBallowed_mail_locals\f1 = \fIlist\f1 +This is a semicolon `;' separated list of local parts which will be allowed +to send mail through this connection. +If unset and \fBnot_allowed_mail_locals\fR is also unset, all users are allowed. -This is a semicolon ';' separated list of local parts which will be allowed to send mail through this connection. If unset and \fBnot_allowed_mail_locals\f1 is also unset, all users are allowed. .TP +\fBnot_allowed_mail_locals\fR = \fIlist\fR -\fBnot_allowed_mail_locals\f1 = \fIlist\f1 +This is a semicolon `;' separated list of local parts which will be not allowed +to send mail through this connection. +Local parts in this list will not be allowed to use this route even if they +are part of \fBallowed_mail_locals\fR (see above). -This is a semicolon ';' separated list of local parts which will be not allowed to send mail through this connection. Local parts in this list will not be allowed to use this route even if they are part of \fBallowed_mail_locals\f1 (see above). .TP +\fBallowed_return_paths\fR = \fIlist\fR -\fBallowed_return_paths\f1 = \fIlist\f1 +This is a semicolon `;' separated list of addresses. +Messages which have one one of these addresses as the return path will be used using this route +(if not also in \fBnot_allowed_return_paths\fR or an item in \fBnot_allowed_mail_locals\fR matches). -This is a semicolon ';' separated list of addresses. Messages which have one one of these addresses as the return path will be used using this route (if not also in \fBnot_allowed_return_paths\f1 or an item in \fBnot_allowed_mail_locals\f1 matches). +Patterns containing `?' and `*' can be used. +The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). -Patterns containing '?' and '*' can be used. The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). .TP +\fBnot_allowed_return_paths\fR = \fIlist\fR -\fBnot_allowed_return_paths\f1 = \fIlist\f1 +This is a semicolon `;' separated list of addresses. +Messages which have one one of these addresses as the return path will not +be used using this route (even if also in \fBallowed_return_paths\fR +or an item in \fBallowed_mail_locals\fR matches). -This is a semicolon ';' separated list of addresses. Messages which have one one of these addresses as the return path will not be used using this route (even if also in \fBallowed_return_paths\f1 or an item in \fBallowed_mail_locals\f1 matches). +Patterns containing `?' and `*' can be used. +The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). -Patterns containing '?' and '*' can be used. The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). .TP +\fBallowed_rcpt_domains\fR = \fIlist\fR -\fBallowed_rcpt_domains\f1 = \fIlist\f1 +A list of recipient domains where mail will be sent to. +This is for example useful if you use this route configuration when connected to another LAN via ppp. +Patterns containing `?' and `*' can be used. -A list of recipient domains where mail will be sent to. This is for example useful if you use this route configuration when connected to another LAN via ppp. Patterns containing '?' and '*' can be used. .TP +\fBnot_allowed_rcpt_domains\fR = \fIlist\fR -\fBnot_allowed_rcpt_domains\f1 = \fIlist\f1 +A list of recipient domains where mail will not be sent to. +This is for example useful if you send mail directly (\fBmail_host\fR is not set) +and you know of hosts that will not accept mail from you because they use a dialup list +(eg. \fBhttp://maps.vix.com/dul/\fR). +If any domain matches both \fBallowed_rcpt_domains\fR and \fBnot_allowed_rcpt_domains\fR, +mail will not be sent to this domain. +Patterns containing `?' and `*' can be used. -A list of recipient domains where mail will not be sent to. This is for example useful if you send mail directly (\fBmail_host\f1 is not set) and you know of hosts that will not accept mail from you because they use a dialup list (eg. \fBhttp://maps.vix.com/dul/\f1. If any domain matches both \fBallowed_rcpt_domains\f1 and \fBnot_allowed_rcpt_domains\f1, mail will not be sent to this domain. Patterns containing '?' and '*' can be used. .TP +\fBset_h_from_domain\fR = \fIstring\fR -\fBset_h_from_domain\f1 = \fIstring\f1 +Replace the domain part in `From:' headers with this value. +This may be useful if you use a private, outside unknown address on your local LAN +and want this to be replaced by the domain of the address of your email addrsss on the internet. +Note that this is different to \fBset_return_path_domain\fR, see below. -Replace the domain part in 'From:' headers with this value. This may be useful if you use a private, outside unknown address on your local LAN and want this to be replaced by the domain of the address of your email addrsss on the internet. Note that this is different to \fBset_return_path_domain\f1, see below. .TP +\fBset_return_path_domain\fR = \fIstring\fR -\fBset_return_path_domain\f1 = \fIstring\f1 +Sets the domain part of the envelope from address. +Some hosts check whether this is the same as the net the connection is coming from. +If not, they reject the mail because they suspect spamming. +It should be a valid address, because some mail servers also check that. +You can also use this to set it to your usual address on the internet +and put a local address only known on your LAN in the configuration of your mailer. +Only the domain part will be changed, the local part remains unchanged. +Use \fBmap_return_path_addresses\fR for rewriting local parts. -Sets the domain part of the envelope from address. Some hosts check whether this is the same as the net the connection is coming from. If not, they reject the mail because they suspect spamming. It should be a valid address, because some mail servers also check that. You can also use this to set it to your usual address on the internet and put a local address only known on your LAN in the configuration of your mailer. Only the domain part will be changed, the local part remains unchanged. Use \fBmap_return_path_addresses\f1 for rewriting local parts. .TP +\fBmap_h_from_addresses\fR = \fIlist\fR -\fBmap_h_from_addresses\f1 = \fIlist\f1 - -This is similar to \fBset_h_from_domain\f1, but more flexible. Set this to a list which maps local parts to a full RFC 822 compliant email address, the local parts (the keys) are separated from the addresses (the values) by colons (':'). +This is similar to \fBset_h_from_domain\fR, but more flexible. +Set this to a list which maps local parts to a full RFC 822 compliant email address, +the local parts (the keys) are separated from the addresses (the values) by colons (`:'). Example: map_h_from_addresses = "john: John Smith ; charlie: Charlie Miller " You can use patterns, eg. * as keys. + .TP +\fBmap_h_reply_to_addresses\fR = \fIlist\fR -\fBmap_h_reply_to_addresses\f1 = \fIlist\f1 +Same as \fBmap_h_from_addresses\fR, but for the `Reply-To:' header. -Same as \fBmap_h_from_addresses\f1, but for the 'Reply-To:' header. .TP +\fBmap_h_mail_followup_to_addresses\fR = \fIlist\fR -\fBmap_h_mail_followup_to_addresses\f1 = \fIlist\f1 +Same as \fBmap_h_from_addresses\fR, but for the `Mail-Followup-To:' header. +Useful when replying to mailing lists. -Same as \fBmap_h_from_addresses\f1, but for the 'Mail-Followup-To:' header. Useful when replying to mailing lists. .TP +\fBmap_return_path_addresses\fR = \fIlist\fR -\fBmap_return_path_addresses\f1 = \fIlist\f1 - -This is similar to \fBset_return_path_domain\f1, but more flexible. Set this to a list which maps local parts to a full RFC 821 compliant email address, the local parts (the keys) are separated from the addresses (the values) by colons (':'). Note that this option takes RFC 821 addresses while \fBmap_h_from_addresses\f1 takes RFC 822 addresses. The most important difference is that RFC 821 addresses have no full name. +This is similar to \fBset_return_path_domain\fR, but more flexible. +Set this to a list which maps local parts to a full RFC 821 compliant email address, +the local parts (the keys) are separated from the addresses (the values) by colons (`:'). +Note that this option takes RFC 821 addresses while \fBmap_h_from_addresses\fR takes RFC 822 addresses. +The most important difference is that RFC 821 addresses have no full name. Example: map_return_path_addresses = "john: ; charlie: " You can use patterns, eg. * as keys. + .TP +\fBexpand_h_sender_address\fR = \fIboolean\fR -\fBexpand_h_sender_address\f1 = \fIboolean\f1 +This sets the domain of the sender address as given by the Sender: header +to the same address as in the envelope return path address +(which can be set by either \fBset_return_path_domain\fR or \fBmap_return_path_addresses\fR). +This is for mail clients (eg. Microsoft Outlook) which use this address as the sender address. +Though they should use the From: address, see RFC 821. +If \fBfetchmail(1)\fR encounters an unqualified Sender: address, +it will be expanded to the domain of the pop server, which is almost never correct. +Default is true. -This sets the domain of the sender address as given by the Sender: header to the same address as in the envelope return path address (which can be set by either \fBset_return_path_domain\f1 or \fBmap_return_path_addresses\f1). This is for mail clients (eg. Microsoft Outlook) which use this address as the sender address. Though they should use the From: address, see RFC 821. If \fBfetchmail (1)\f1 encounters an unqualified Sender: address, it will be expanded to the domain of the pop server, which is almost never correct. Default is true. .TP +\fBexpand_h_sender_domain\fR = \fIboolean\fR -\fBexpand_h_sender_domain\f1 = \fIboolean\f1 +Like \fBexpand_h_sender_address\fR, but sets the domain only. +Deprecated, will be removed in a later version. -Like \fBexpand_h_sender_address\f1, but sets the domain only. Deprecated, will be removed in a later version. .TP +\fBlast_route\fR = \fIboolean\fR -\fBlast_route\f1 = \fIboolean\f1 +If this is set, a mail which would have been delivered using this route, +but has failed temporarily, will not be tried to be delivered using the next route. -If this is set, a mail which would have been delivered using this route, but has failed temporarily, will not be tried to be delivered using the next route. - -If you have set up a special route with filters using the lists 'allowed_rcpt_domains', 'allowed_return_paths', and 'allowed_mail_locals' or their complements (not_), and the mail passing these rules should be delivered using this route only, you should set this to 'true'. Otherwise the mail would be passed to the next route (if any), unless that route has rules which prevent that. +If you have set up a special route with filters using the lists `allowed_rcpt_domains', +`allowed_return_paths', and `allowed_mail_locals' or their complements (not_), +and the mail passing these rules should be delivered using this route only, +you should set this to `true'. +Otherwise the mail would be passed to the next route (if any), +unless that route has rules which prevent that. Default is false. + .TP +\fBauth_name\fR = \fIstring\fR -\fBauth_name\f1 = \fIstring\f1 +Set the authentication type for ESMTP AUTH authentication. +Currently only `cram-md5' and `login' are supported. -Set the authentication type for ESMTP AUTH authentication. Currently only 'cram-md5' and 'login' are supported. .TP - -\fBauth_login\f1 = \fIstring\f1 +\fBauth_login\fR = \fIstring\fR Your account name for ESMTP AUTH authentication. + .TP - -\fBauth_secret\f1 = \fIstring\f1 +\fBauth_secret\fR = \fIstring\fR Your secret for ESMTP AUTH authentication. + .TP +\fBpop3_login\fR = \fIfile\fR -\fBpop3_login\f1 = \fIfile\f1 +If your Mail server requires SMTP-after-POP, +set this to a get configuration (see \fBmasqmail.get(5)\fR). +If you login to the POP server before you send, this is not necessary. -If your Mail server requires SMTP-after-POP, set this to a get configuration (see \fBmasqmail.get (5)\f1). If you login to the POP server before you send, this is not necessary. .TP +\fBwrapper\fR = \fIcommand\fR -\fBwrapper\f1 = \fIcommand\f1 - -If set, instead of opening a connection to a remote server, \fIcommand\f1 will be called and all traffic will be piped to its stdin and from its stdout. Purpose is to tunnel ip traffic, eg. for ssl. +If set, instead of opening a connection to a remote server, +\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout. +Purpose is to tunnel ip traffic, eg. for ssl. Example for ssl tunneling: wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null" + .TP +\fBpipe\fR = \fIcommand\fR -\fBpipe\f1 = \fIcommand\f1 +If set, and protocol is set to `pipe', +\fIcommand\fR will be called and the message will be piped to its stdin. +Purpose is to use gateways to uucp, fax, sms or whatever else. -If set, and protocol is set to 'pipe', \fIcommand\f1 will be called and the message will be piped to its stdin. Purpose is to use gateways to uucp, fax, sms or whatever else. +You can use variables to give as arguments to the command, +these are the same as for the mda in the main configuration, see \fBmasqmail.conf(5)\fR. -You can use variables to give as arguments to the command, these are the same as for the mda in the main configuration, see \fBmasqmail.conf (5)\f1. .TP +\fBpipe_fromline = \fIboolean\fR -\fBpipe_fromline = \fIboolean\f1\fB\f1 +If this is set, and protocol is set to `pipe', +a from line will be prepended to the output stream whenever a pipe command is called. +Default is false. -If this is set, and protocol is set to 'pipe', a from line will be prepended to the output stream whenever a pipe command is called. Default is false. .TP +\fBpipe_fromhack = \fIboolean\fR -\fBpipe_fromhack = \fIboolean\f1\fB\f1 +If this is set, and protocol is set to `pipe', +each line beginning with `From ' is replaced with `>From ' whenever a pipe command is called. +You probably want this if you have set \fBpipe_fromline\fR above. +Default is false. -If this is set, and protocol is set to 'pipe', each line beginning with 'From ' is replaced with '>From ' whenever a pipe command is called. You probably want this if you have set \fBpipe_fromline\f1 above. Default is false. + .SH AUTHOR -masqmail was written by Oliver Kurth. It is now maintained by Markus Schnalke . +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\f1. +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. There is also a mailing list, you will find information about it at masqmail's main site. + .SH BUGS -You should report them to the mailing list. +Please report bugs to the mailing list. .SH SEE ALSO -\fBmasqmail (8)\f1, \fBmasqmail.conf (5)\f1, \fBmasqmail.get (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - +\fBmasqmail(8)\fR, \fBmasqmail.conf(5)\fR, \fBmasqmail.get(5)\fR diff -r e1004fcc93c9 -r 8ea86ac25658 docs/mservdetect.8 --- a/docs/mservdetect.8 Thu May 06 13:31:57 2010 +0200 +++ b/docs/mservdetect.8 Fri May 07 13:50:23 2010 +0200 @@ -1,43 +1,49 @@ -.TH mservdetect 8 User Manuals +.TH mservdetect 8 2010-05-07 masqmail-0.2.21 "Maintenance Commands" + .SH NAME mservdetect \- Helper for masqmail and masqdialer + + .SH SYNOPSIS -\fB/usr/bin/masqmail \fIhost\f1\fB \fIport\f1\fB +\fB/usr/bin/masqmail \fIhost port\fR -\fB + .SH DESCRIPTION -mservdetect is a small helper application for masqmail to detect its online status if the modem server masqdialer is used. It connects to the\fIhost\f1 at \fIport\f1 and prints the connection name to stdout. +Mservdetect is a small helper application for masqmail to detect its online status +if the modem server masqdialer is used. +It connects to the\fIhost\fR at \fIport\fR and prints the connection name to stdout. -If you want to use it, set \fBonline_detect\f1=\fIpipe\f1 and \fBonline_pipe\f1=\fI"/usr/bin/mservdetect host port"\f1. +If you want to use it, set \fBonline_detect\fR=\fIpipe\fR and +\fBonline_pipe\fR=\fI"/usr/bin/mservdetect host port"\fR. .SH OPTIONS + .TP - -\fBhost\f1 +\fBhost\fR The hostname where the masqdialer server is running. + .TP - -\fBport\f1 +\fBport\fR The port number where the masqdialer server is listening. + + .SH AUTHOR -masqmail was written by Oliver Kurth. It is now maintained by Markus Schnalke . +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\f1. +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. There is also a mailing list, you will find information about it at masqmail's main site. + .SH BUGS -You should report them to the mailing list. +Please report bugs to the mailing list. + .SH SEE ALSO -\fBmasqmail.conf (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - +\fBmasqmail.conf(5)\fR