% Copyright (C) 1999, Comité Réseau des Universités & Serge Aumont Olivier Salaün
%


    \usepackage {epsfig}
    \usepackage {xspace}
    \usepackage {makeidx}
    \usepackage {html}
    \usepackage {a4}                    % optional

    \usepackage {palatino}
    \renewcommand {\ttdefault} {cmtt}

    \setlength {\parskip} {5mm}
    \setlength {\parindent} {0mm}

    \pagestyle {headings}
    \makeindex

    \sloppy

    \usepackage [dvips] {changebar}
    % \begin {changebar} ... \end {changebar}
    % ou \cbstart ... \cbend   et \cbdelete

    %
    % Change bars are not well rendered by latex2html
    %

    \begin {htmlonly}
        \renewcommand {\cbstart} {}
        \renewcommand {\cbend} {}
        \renewcommand {\cbdelete} {}
    \end {htmlonly}

    % black text on a white background, links unread in red
    % \bodytext {TEXT="#000000" BGCOLOR="#ffffff" LINK="#ff0000"}
    % black text on a white background
    \bodytext {TEXT="#000000" BGCOLOR="#ffffff"}

    \newcommand {\fig} [2]
    {
        \begin {figure} [htbp]
            \hrule
            \vspace {3mm}
            \begin {center}
                \epsfig {figure=#1.ps}
%                \epsffile {figure=#1.ps}
            \end {center}
            \vspace {2mm}
            \caption {#2}
            \vspace {3mm}
            \hrule
            \label {fig:#1}
        \end {figure}
    }

    \newcommand {\version} {2.2.5}

    \newcommand {\samplelist} {toto}

    % #1 = text to index and to display
    \newcommand {\textindex} [1] {\index{#1}#1}

    % #1 = sort key, #2 displayed in text and index
    \newcommand {\textindexbis} [2] {\index{#1@#2}#2}

    \newcommand {\Sympa} {\textit {Sympa}\xspace}

    \newcommand {\WWSympa} {\textindexbis {World Wide Sympa}{\textit {World Wide Sympa}}\xspace}

    % #1 = sort key, #2 : displayed in text and index, #3 displayed in index
    \newcommand {\ttindex} [3]  {\index{#1@\texttt {#2} #3}\texttt {#2}}

    \newcommand {\example} [1] {Example: \texttt {#1}}

    \newcommand {\unixcmd} [1] {\ttindex {#1} {#1} {Unix command}}

    \newcommand {\mailcmd} [1] {\ttindex {#1} {#1} {mail command}}

    \newcommand {\cfkeyword} [1] {\ttindex {#1} {#1} {configuration keyword}}

    \newcommand {\default} [1]  {(Default value: \texttt {#1})}

    \newcommand {\lparam} [1] {\ttindex {#1} {#1} {list parameter}}

    \newcommand {\file} [1] {\ttindex {#1} {#1} {file}}

    \newcommand {\dir} [1]  {\ttindex {#1} {#1} {directory}}

    \newcommand {\tildefile} [1] {\ttindex {#1} {\~{}#1} {file}}

    \newcommand {\tildedir} [1] {\ttindex {#1} {\~{}#1} {directory}}

    \newcommand {\rfcheader} [1] {\ttindex {#1:} {#1:} {header}}

    % Notice: use {\at} when using \mailaddr
    \newcommand {\at} {\char64}
    \newcommand {\mailaddr} [1]         % mail address
%        {\ttindex {#1} {#1} {mail address}}
        {\texttt {#1}}


\begin {document}

    \title {\Huge\bf Sympa \\ \huge\bf Automatic Multi-posting System,
    pocket guide}
    \author {
        Olivier Sala\"un,
        Serge Aumont
        }
    \date {30 Juin 1999}

\maketitle


{
    \setlength {\parskip} {0cm}



    \cleardoublepage

    \tableofcontents
    % \listoffigures
    % \listoftables
}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Presentation
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\cleardoublepage


\section { \file {/etc/sympa.conf} }

format:
\begin {quote}
    \textit {keyword    value}
\end{quote}
\begin {itemize}
\item \cfkeyword {archives} \default {archives} ; archive directory
\item \cfkeyword {avg} \default {10} ; maximum number of different   domains per child  SMTP process
\item \cfkeyword {bye} \default {bye} ; filename  of message  sent for unsubscribtion
\item \cfkeyword {clean\_delay\_queue} \default {1} ; conservation time (in days) for ``bad'' messages 
\item \cfkeyword {clean\_delay\_queueauth}  \default {3} Expiration  delay (in days) in an authentication spool
\item \cfkeyword {clean\_delay\_queuemod} \default {10} Expiration  date (in days) in moderation spool
\item \cfkeyword {config} \default {config}
\item \cfkeyword {db\_host} Database host name.
\item \cfkeyword {db\_name} \default {sympa} Name of the database  containing user information
\item \cfkeyword {db\_passwd} Password for \cfkeyword {db\_user}.
\item \cfkeyword {db\_type} Database management system used
\item \cfkeyword {db\_user}  User with read access on the database.
\item \cfkeyword {email} \default {sympa}  ;[email]@[host] must be  replyable
\item \cfkeyword {help} \default {helpfile}  ; helpfile located in   \tildedir {sympa/expl/}
                 (\file { [helpfile].adanced } is added when replying
                 to list editor or owners
\item \cfkeyword {home} \default {\tildedir {sympa/}}  ; where  everything is located
\item \cfkeyword {host} ; hostname or domain where sympa is installed
\item \cfkeyword {listmaster}  ; super user email 
\item \cfkeyword {lists\_header} \default {list.header} ; header of  LISTS message
\item \cfkeyword {lists\_footer} \default {list.header} ; header of  LISTS message
\item \cfkeyword {log\_socket\_type} \default {inet} ;log method
\item \cfkeyword {maxsmtp} \default {20} ; maximum number of child  SMTP process
\item \cfkeyword {message\_header} \default {message.header} ;
  filename of header message added to list messages
\item \cfkeyword {message\_footer} \default {message.footer} ;
  filename of footer message added to list messages
\item \cfkeyword {msgcat}   \default{\tildedir {sympa/nls}} ; multilinguale catalogs location (nls)
\item \cfkeyword {nrcpt} \default {25} ; maximum number of recipients  per child  SMTP process
\item \cfkeyword {pidfile} \default {\tildefile {sympa/sympa.pid}}
\item \cfkeyword {queue} \default {\tildedir {sympa/spool/msg}} ;main spool
\item \cfkeyword {queueauth} \default {\tildedir {sympa/spool/auth}}   ;spool for md5 authentification process
\item \cfkeyword {queuedigest}  \default {\tildedir {sympa/spool/digest}}  ;spool for digest
\item \cfkeyword {queueexpire}  \default {\tildedir {sympa/spool/expire}} ; spool for expiration process
\item \cfkeyword {queuemod}  \default {\tildedir {sympa/spool/mod}}  ;spool for moderation
\item \cfkeyword {reminder} \default {reminder} ;  filename  of message  sent for a remind
\item \cfkeyword {removed} \default {removed} ;  filename  of message
  sent when a subscriber is removed
\item \cfkeyword {scenari}  \default {\tildedir {sympa/bin/scenari}} ;
  directory containing scenari files
\item \cfkeyword {sendmail} \default {/usr/sbin/sendmail} ;SMTP engine location
\item \cfkeyword {sleep}  \default {5} ; Waiting period (in seconds) between each scan of main queue.
\item \cfkeyword {stats} \default {stats}
\item \cfkeyword {subscribers} \default {subscribers}
\item \cfkeyword {syslog} \default {LOCAL1} ; syslog facility
\item \cfkeyword {umask} \default {027}
\item \cfkeyword {welcome} \default {welcome}  ; file name for welcome  messages.



\section {Aliases}
\begin {quote}
\begin{verbatim}
sympa:             "|/usr/local/sympa/bin/queue 0 sympa"
majordomo:         sympa
sympa-request:     postmaster
sympa-owner:       postmaster
foo:               "|/usr/local/sympa/bin/queue 1 foo"
foo-request:       "|/usr/local/sympa/bin/queue 1 foo-request"
foo-subscribe:     "|/usr/local/sympa/bin/queue 1 foo-subscribe"
foo-unsubscribe:   "|/usr/local/sympa/bin/queue 1 foo-unsubscribe"
foo-owner:         foo-request or pipe to  some error analysor such as anabounce
\end{verbatim}
\end{quote}


\section {List configuration file}

\begin {itemize}
   \item archive \texttt {day}|\texttt {week}|\texttt {month}|\texttt
     {quarter}|\texttt {year}
   \item cookie
   \item custom\_header
   \item custom\_subject
   \item digest 
   \item editor  paragraph, mandatory : "email", optional "gecos xxx"  and  "reception nomail"
   \item footer\_type \texttt {mime}|\texttt {append}
   \item host
   \item include\_list
   \item include\_sql\_query
   \item include\_ldap\_query
   \item owner  paragraph, mandatory : "email", optional "gecos xxx"  and  "reception nomail"
   \item max\_size
   \item reply-to \texttt {sender}|\texttt {list}
   \item review \texttt {public}|\texttt {private}|\texttt {owner}
   \item subject
   \item send \texttt {public}|\texttt {private}|\texttt {editor}|\texttt {editorkey}|\texttt {editorkeyonly}|\texttt {privatekey}|\texttt {publickey}|\texttt {privateorpublickey}|\texttt {privateoreditorkey}
   \item subscribe \texttt {open}|\texttt {owner}|\texttt {closed}|\texttt {auth}
   \item unsubscribe \texttt {open}|\texttt {closed}|\texttt {owner}|\texttt {auth}
   \item user\_data\_source \texttt {file}|\texttt {database}|\texttt {include}
   \item visibility \texttt {conceal}|\texttt {noconceal}
\end {itemize}

\end {document}
