1.1 --- a/thesis/tex/1-Masqmail.tex	Tue Nov 04 11:33:15 2008 +0100
     1.2 +++ b/thesis/tex/1-Masqmail.tex	Tue Nov 04 11:34:30 2008 +0100
     1.3 @@ -4,13 +4,53 @@
     1.4  
     1.5  
     1.6  \section{Target field}
     1.7 +Its original author, Oliver Kurth, sees \masqmail\ so:
     1.8 +\begin{quotation}
     1.9 +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.
    1.10 +\end{quotation}
    1.11 +
    1.12 +\masqmail\ is inteded to cover a specific niche: non-permanent internet connection and different \NAME{ISP}s.
    1.13 +
    1.14 +Although it can basically replace other \MTA{}s, it is not generally aimed to do so. The package description of \debian\citeweb{packages.debian:masqmail} states this more clearly by changing the last sentence to:
    1.15 +\begin{quotation}
    1.16 +In these cases, MasqMail is a slim replacement for full-blown MTAs such as sendmail, exim, qmail or postfix.
    1.17 +\end{quotation}
    1.18 +\masqmail\ is a good replacement ``in these cases'', but not generally, since is lacks features essential for running on mail servers. It is primarily not secure enough for being accessable from untrusted locations. %Nevertheless has \masqmail\ this field of action, where it is better suited for than other \MTA{}s.
    1.19 +
    1.20 +The program is best used in home networks, which are non-permanently connected to the internet. \masqmail\ sends mail to local destinations, like users on the same machine and on other machines in the local net, immediately. Email to recipients outside the local net are queued when offline and sent when a online connection gets established.
    1.21 +
    1.22 +Further more does \masqmail\ respect online connections through different \NAME{ISP}s; a common thing for dial-up connections. In particular can different sender addresses be set, dependent on the \NAME{ISP} that is used. This prevents mail to be likely classified as spam.
    1.23 +
    1.24  
    1.25  
    1.26  \section{Typical usage}
    1.27 +This section describes situations that make senseful use of \masqmail.
    1.28 +
    1.29 +A home network consisting of some workstations without a server. The network is connected to the internet by dial-up or broadband. Going online is initiated by computers inside the local net. \NAME{IP} addresses change at least once every day.
    1.30 +
    1.31 +Every workstation would be equiped with \masqmail. Mail transfer within the same machine or within the local net works straight forward. Outgoing mail to the internet is sent, to the concerning \NAME{ISP} for relaying, whenever the router goes online. Receiving of mail from outside needs to be done by a mail fetch program, like the \masqmail\ internal \NAME{POP3} client or \name{fetchmail} for example. The configuration for \masqmail\ would be the same on every computer, except the hostname.
    1.32 +
    1.33 +For the same network but having a server, one could have \masqmail\ running on the server and using simple forwarders (see \ref{subsec:relay-only}) to the server on the workstations. This setup does only support mail transfer to the server, but not back to a workstation; also sending mail to another user on the same workstation is not possible.
    1.34 +
    1.35 +A better setup is to run \masqmail\ on every machine %FIXME
    1.36 +
    1.37 +%How it works
    1.38 +%
    1.39 +%When offline, MasqMail queues all mail with a destination outside of the local network. When you connect to the internet, masqmail will be called with a connection name as an argument. MasqMail then sends the queued mail to the configured mailserver for that ISP. When a message from the local net is received when online, MasqMail delivers it immediately. If there is no mail server for that ISP, MasqMail can also send the mails directly to their destinations.
    1.40 +%
    1.41 +%For each ISP different return addresses can be configured. This makes it possible to get around spam traps which desire your return address to be from the same domain as the host the mail is coming from. This is not a problem if you always connect to a single ISP, but is one if you use different ones from time to time. It also makes it possible to configure your mailer to a return address on your local network which maybe totally unknown outside. So delivery failure messages originating on your local net can be sent directly to you, while those that occur outside will be sent to the configured address. (Note that the return path is different from the From: address or the Reply-to: address. You can still have a single address where you want replys to be sent to).
    1.42 +%
    1.43 +%When offline, MasqMail behaves just like any other ordinary mail server (with a few limitations, but these will be fixed in the future).
    1.44 +%
    1.45 +%To detect its online status, MasqMail can take advantage of the masqdialer system. But it also works well without it.
    1.46 +
    1.47  
    1.48  
    1.49  \section{What makes it special}
    1.50  
    1.51 +As main advantage, \masqmail\ makes it easy to set up an \MTA\ on workstations or notebooks without the need to do complex configuration or to be an mail server expert.
    1.52 +
    1.53 +Workstations use
    1.54  
    1.55  \section{Alternatives?}
    1.56  % http://anfi.homeunix.org/sendmail/dialup10.html
    1.57 @@ -19,6 +59,21 @@
    1.58  
    1.59  
    1.60  \section{Features}
    1.61 +\begin{itemize}
    1.62 +	\item Delivers only when online to a destination 'outside' your LAN
    1.63 +	\item Support for multiple Providers (ie. Mail Servers, or direct delivery)
    1.64 +	\item Rewriting of Return addresses (Return-Path:, From:, Reply-To:), configurable for each Provider separately
    1.65 +	\item can also be used as a Mail Server on a LAN
    1.66 +	\item alias support
    1.67 +	\item delivery to pipes
    1.68 +	\item delivery to MDAs (eg. procmail)
    1.69 +	\item Maildir support (version >= 0.2.5)
    1.70 +	\item routing depending on sender
    1.71 +	\item AUTH (RFC 2554) support (as client, since version 0.1.0)
    1.72 +	\item SMTP-after-POP
    1.73 +	\item POP3 client
    1.74 +	\item POP3 client daemon (fetch mail in regular intervals if online)
    1.75 +\begin{itemize}
    1.76  
    1.77  
    1.78  \section{History}