
meillo@26: \chapter{Introduction}
meillo@42: \label{chap:introduction}
meillo@26: 
meillo@96: << say what you want to say >>
meillo@92: 
meillo@96: << the overall goal of the book >>
meillo@92: 
meillo@92: 
meillo@92: 
meillo@92: \section{The \masqmail\ project}
meillo@96: 
meillo@96: << about masqmail (some history) >>
meillo@96: 
meillo@96: (include history of email, definition of MTA and sendmail-compatibility in text)
meillo@96: 
meillo@96: 
meillo@92: 
meillo@92: \subsubsection{Target field}
meillo@92: Its original author, Oliver Kurth, sees \masqmail\ so:
meillo@92: \begin{quote}
meillo@92: 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.
meillo@92: \end{quote}
meillo@92: 
meillo@92: \masqmail\ is inteded to cover a specific niche: non-permanent internet connection and different \NAME{ISP}s.
meillo@92: 
meillo@92: 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:
meillo@92: \begin{quote}
meillo@92: In these cases, MasqMail is a slim replacement for full-blown MTAs such as sendmail, exim, qmail or postfix.
meillo@92: \end{quote}
meillo@92: \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.
meillo@92: 
meillo@92: 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.
meillo@92: 
meillo@92: 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.
meillo@92: 
meillo@92: 
meillo@92: 
meillo@92: \subsubsection{Typical usage}
meillo@92: This section describes situations that make senseful use of \masqmail.
meillo@92: 
meillo@92: 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.
meillo@92: 
meillo@92: 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.
meillo@92: 
meillo@92: 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.
meillo@92: 
meillo@92: A better setup is to run \masqmail\ on every machine %FIXME
meillo@92: 
meillo@92: 
meillo@92: 
meillo@92: \subsubsection{What makes it special}
meillo@92: 
meillo@92: 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.
meillo@92: 
meillo@92: Workstations use %FIXME
meillo@92: 
meillo@96: \textbf{Alternatives?}
meillo@92: % http://anfi.homeunix.org/sendmail/dialup10.html
meillo@92: 
meillo@92: 
meillo@92: 
meillo@96: << explain why masqmail is old and why it is interesting/important however! >> %FIXME
meillo@96: 
meillo@96: 
meillo@96: 
meillo@92: \section{Problems to solve}
meillo@92: 
meillo@96: << what problems has masqmail? >>  %FIXME
meillo@96: 
meillo@96: << what's the intention of this document? >>  %FIXME
meillo@96: 
meillo@96: << why is it worth the effort? >>  %FIXME
meillo@96: 
meillo@96: 
meillo@96: 
meillo@96: 
meillo@97: \section{How to read this document}
meillo@96: 
meillo@96: \subsubsection*{Conventions used}
meillo@96: %TODO: check if this tells what is really used!
meillo@96: %FIXME: make it complete!
meillo@96: %FIXME: remove everything not needed. Maybe write only a few sentences text.
meillo@96: The following typographic conventions are used in this book:
meillo@96: 
meillo@96: \begin{tabular}{ p{0.15\textwidth} p{0.8\textwidth} }
meillo@96: \emph{Italic} &
meillo@96: is used for names, including command names, file name, hostnames, usernames and email addresses.
meillo@96: Further more it is used to emphasize text.
meillo@96: \\ &\\
meillo@96: 
meillo@96: \texttt{Constant Width} &
meillo@96: is used for source code, contents of files and output from programs.
meillo@96: \\ &\\
meillo@96: 
meillo@96: \texttt{\$} &
meillo@96: indicates the the user shell prompt.
meillo@96: \\ &\\
meillo@96: 
meillo@96: \texttt{\#} &
meillo@96: indicates the the root shell prompt.
meillo@96: \\
meillo@96: \end{tabular}
meillo@96: 
meillo@96: 
meillo@96: 
meillo@96: 
meillo@96: \section{Further reading}
meillo@96: 
meillo@96: << specify the really important external documents here >> %FIXME
meillo@96: 
meillo@96: << write about the bundled CD, and tell what's included >> %FIXME
meillo@96: 
meillo@96: \NAME{RFC}s, other books, source code, websites
meillo@96: 
meillo@96: 




