%
% msmtp.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel mSMTP %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{msmtp - SMTP client}
\index{mSMTP}


\section{Allgemeines}

    Das \emph{'msmtp'} Paket stellt einen SMTP Klient zum senden von Mail
    im 'SendOnly' Betrieb bereit.


    In der \emph{msmtp}-Konfiguration werden die f"ur den Dienst notwendigen
    Einstellungen vorgenommen.



\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \mbox{}

    \begin{tabular}{llll}
    & 4. &  Service administration
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & x. &  msmtp - SMTP client
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}ll}
    & 1. & View documentation\\
    & 2. & Edit configuration\\
    & 3. & Advanced configuration file handling\\
    & 4. & Send test mail \\
    & 5. & Logfile view \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt \glqq{}Edit configuration\grqq{}
    ge"andert werden.

    Nachdem der Editor beendet wurde, wird abgefragt, ob die Konfiguration
    aktiviert werden soll. Wird dies best"atigt, so werden "uber ein Skript
    die Anpassungen umgehend wirksam gemacht.


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will, findet sie
    unter\\
    \texttt{/etc/config.d/msmtp}


\section{Die Parameter}


\begin{description}

\config{START\_MSTMP}
{START\_MSMTP}
{STARTMSMTP}
{
    F"ur die Aktivierung des 'msmtp' Dienstes muss dieser Parameter
    lediglich auf den Wert 'yes' gestellt werden. Die Einstellung 'no'
    schaltet den 'msmtp' Dienst ab.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_MSTMP='no'}
}


\config{MSMTP\_MAIL\_SND\_FROM}
{MSMTP\_MAIL\_SND\_EROM}
{MSMTPMAILSNDFROM}
{
    Bei diesem Parameter wird der Sender der Mail angegeben.

    G"ultige Werte: Mailadresse

    Standardeinstellung: \texttt{MSMTP\_MAIL\_SND\_FROM='root@home.lan'}
}


\config{MSMTP\_MAIL\_SND\_TO}
{MSMTP\_MAIL\_SND\_TO}
{MSMTPMAILSNDTO}
{
    Bei diesem Parameter wird der Empfanger der Testmail angegeben.

    G"ultige Werte: Mailadresse

    Standardeinstellung: \texttt{MSMTP\_MAIL\_SND\_TO='root@home.lan'}
}


\config{MSMTP\_MAIL\_HOST}
{MSMTP\_MAIL\_HOST}
{MSMTPMAILHOST}
{
    Bei diesem Parameter wird der Mailhost angegeben, "uber den die
    Mails versandt werden sollen.

    G"ultige Werte: Mailhost

    Standardeinstellung: \texttt{MSMTP\_MAIL\_HOST='mail.home.lan'}
}


\config{MSMTP\_QUALIFY\_DOMAIN}
{MSMTP\_QUALIFY\_DOMAIN}
{MSMTPQUALIFYDOMAIN}
{
    Bei diesem Parameter wird der Vollst"andige Domainname angegeben.

    G"ultige Werte: FQDN

    Standardeinstellung: \texttt{MSMTP\_QUALIFY\_DOMAIN='fax.home.lan'}
}


\config{MSMTP\_MAIL\_PORT}
{MSMTP\_MAIL\_PORT}
{MSMTPMAILPORT}
{
    "Uber diesen Parameter wird der Port f"ur den Mailhost festgelegt,
    Standard ist der SMTP Port '25'.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{MSMTP\_MAIL\_PORT='{}'}
}


\config{MSMTP\_USE\_AUTH}
{MSMTP\_USE\_AUTH}
{MSMTPUSEAUTH}
{
    "Uber diesen Parameter wird angegeben, ob der Server eine
    Authentifizierung verlangt.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{MSMTP\_USE\_AUTH='no'}
}

\newpage

\config{MSMTP\_AUTH\_USER}
{MSMTP\_AUTH\_USER}
{MSMTPAUTHUSER}
{
    "Uber diesen Parameter wird der user eingestellt, der f"ur die
    Authentifizierung ben"otigt wird. \\
    Nur bei \texttt{MSMTP\_USE\_AUTH='yes'}.

    G"ultige Werte: Name

    Standardeinstellung: \texttt{MSMTP\_AUTH\_USER='{}'}
}


\config{MSMTP\_AUTH\_PASS}
{MSMTP\_AUTH\_PASS}
{MSMTPAUTHPASS}
{
    Bei diesem Parameter wird das Passwort f"ur die Authentifizierung
    angegeben. \\
    Nur bei \texttt{MSMTP\_USE\_AUTH='yes'}.

    G"ultige Werte: Passwort

    Standardeinstellung: \texttt{MSMTP\_AUTH\_PASS='{}'}
}


\config{MSMTP\_AUTH\_METHOD}
{MSMTP\_AUTH\_METHOD}
{MSMTPAUTHMETHOD}
{
    "Uber diesen Parameter wird die Methode zur Authentifizierung
    angegeben. \\
    Nur bei \texttt{MSMTP\_USE\_AUTH='yes'}.

    G"ultige Werte: plain, login, cram-md5

    Standardeinstellung: \texttt{MSMTP\_AUTH\_METHOD='plain'}
}


\config{MSMTP\_USE\_TLS}
{MSMTP\_USE\_TLS}
{MSMTPUSETLS}
{
    "Uber diesen Parameter wird angeben, ob eine Verbindung "uber
    'tls' zum Mailserver aufgebaut werden soll. Diese Funktion
    ist bisher noch nicht ausgetestet.

    G"ultige Werte: no, tls, starttls

    Standardeinstellung: \texttt{MSMTP\_USE\_TLS=no'}
}


\config{MSMTP\_ALIAS\_N}
{MSMTP\_ALIAS\_N}
{MSMTPALIASN}
{
    Bei diesen Parameter wird angegeben,  wie viele Aliase
    angelegt werden sollen.

    G"ultige Werte: Anzahl

    Standardeinstellung: \texttt{MSMTP\_ALIAS\_N='2'}
}


\config{MSMTP\_ALIAS\_x\_NAME}
{MSMTP\_ALIAS\_x\_NAME}
{MSMTPALIASxNAME}
{
    Bei diesem Paramter wird der Name des Aliases angegeben,
    ohne ':'.

    G"ultige Werte: alias

    Standardeinstellung: \texttt{MSMTP\_ALIAS\_x\_NAME='root'}
}


\config{MSMTP\_ALIAS\_x\_ACTIVE}
{MSMTP\_ALIAS\_x\_ACTIVE}
{MSMTPALIASxACTIVE}
{
    "Uber diesen Parameter wird eingestellt, ob der Datensatz aktiv
    sein soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{MSMTP\_ALIAS\_x\_ACTIVE='no'}
}


\config{MSMTP\_ALIAS\_x\_RECIPIENT}
{MSMTP\_ALIAS\_x\_RECIPIENT}
{MSMTPALIASxRECIPIENT}
{
    Bei diesem Parameter wird die Mailadresse der Weiterleitung
    f"ur den Alias angeben.

    G"ultige Werte: Mailadresse

    Standardeinstellung: \texttt{MSMTP\_ALIAS\_x\_RECIPIENT='user@home.lan'}
}


\config{MSMTP\_LOGROTATE\_COUNT}
{MSMTP\_LOGROTATE\_COUNT}
{MSMTPLOGROTATECOUNT}
{
    "Uber diesen Parameter wird eingestellt, wie viele Logdateien
    vorgehalten werden sollen. Wird dieser Wert "uberschritten, so
    wird die "alteste Logdatei gel"oscht.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{MSMTP\_LOGROTATE\_COUNT='6'}
}


\config{MSMTP\_LOGROTATE\_INTERVAL}
{MSMTP\_LOGROTATE\_INTERVAL}
{MSMTPLOGROTATEINTERVAL}
{
    Dieser Parameter bestimmt in welchen Intervallen die
    Logdateien archiviert werden sollen. Zur Auswahl stehen die
    Schl"usselw"orter. \\
    'daily' - t"aglich\\
    'weekly' - w"ochentlich\\
    'monthly' - monatlich

    G"ultige Werte: daily, weekly, monthly

    Standardeinstellung: \texttt{MSMTP\_LOGROTATE\_INTERVAL='monthly'}
}
\end{description}

