doc/exim: comparison short.txt

equal deleted inserted replaced

-:49b311800e28
+:5898f11d12c0
 und kein Wegleiter.
 == Typografische Konventionen
-////
-_italic_::
-Namen von Dateien, Programmen, Hosts, Domains, Mail-Header, URLS: _example.com_, _From:_
-o:fixed::
-Kommandos, Code-Beispiele, Exim-Konfigurations-Optionen: o:primary_hostname
-*+fixed bold+*::
-Hervorhebung von Kommandos, Nutzereingaben: *+exim -bV+*
-////
 d:bold::
 Exim Treibernamen im Text: Der driver:dnslookup Router
 o:fixed::
 Exim Konfigurationoptionen im Text: o:primary_hostname
 Wir unterscheiden zwei Typen von Konfigurationsfiles, die
 <<editme,Build Konfiguration>> und die <<runtime,Runtime Konfiguration>>.
 [[editme]]
-== Build-Konfiguration _EDITME_
+=== Build-Konfiguration _EDITME_
 * Maintainer pflegt die _EDITME_
 * Je nach Distro unterschiedliche Konfigurationen, teilweise sogar
 mehrere, wie 'fat', 'light', 'heavy'.
+* Wesentliche Daten der Features aus der Build-Konfiguration:
-$ exim -bV
+exim -bV
-listet wesentliche in der Buildkonfiguration gewählte Features auf.
 [[runtime]]
 === Runtime-Konfiguration _exim.conf_
 * Der Name der Runtime-Konfiguration wird in der Build-Konfiguration gestgelegt.
 * Es ist auch eine Liste von Konfigurationsfiles möglich, der erste Treffer gewinnt.
 Das verwendete File läßt sich ermitteln mit:
-$ exim -bP configure_file
+exim -bP configure_file
 Das aktive Konfigurationsfile kann auch auf der Kommandozeile festgelegt
 werden. Für einige Operationen muss der Pfad ein absoluter sein.  Auch
 _/dev/null_ ist eine gültige Konfiguration.
 CAUTION: Inhalt der Datei _exim.conf_
 und eventuell über o:.include eingelesener Files
 ist statisch. Dynamisch sind dann Expansionen, Lookups.
-=== Syntax
+== Aufbau der Runtime-Konfiguration _exim.conf_
-Der Parser der Konfigurationsdatei ist ziemlich einfach.
-. Kommentarzeilen werden entfernt
-. Führende und anhängige Leerzeichen werden entfernt
-. Forsetzungszeilen („\“ am Zeilenende) werden zusammengefasst
-. einfache Syntax-Checks
 Die Konfiguration besteht aus mehreren Abschnitten. Nicht alle Abschnitte
 sind identisch aufgebaut.
 Globale Optionen::
 Retry::
 Regeln für Wiederholungsversuche bei der Zustellung
 Authentifizierung::
 Parameter für die SMTP-Authentifizierung (sowohl Client als auch Server)
-== Syntax der Konfiguration
+== Syntax der Runtime-Konfiguration _exim.conf_
+. Führende und anhängige Leerzeichen werden entfernt
+. Kommentarzeilen werden entfernt
+. Forsetzungszeilen („\“ am Zeilenende) werden zusammengefasst
+. Macros werden ersetzt
 === Kommentare
 * Alle Zeilen, die mit einem „#“ beginnen (nach optionalem Whitespace), sind Kommentarzeilen.
 * An anderen Stellen der Konfiguration hat das „#“-Zeichen keine besondere Bedeutung.
 === Macros
 * Macros werden generell groß geschrieben.
 * Macros sind ein einfache  statischer Textersetzungsmechanismus (im Sinne
-* globaler „Konstanten“) und für das
+globaler „Konstanten“) und für das
 bedingte Parsen von Konfigurationsteilen.
 * Macros können in der Konfiguration definiert werden, aber
 auch auf der Kommandozeile. (Auf der Kommandozeile gibt es jedoch wegen eventueller Sicherheitsimplikationen
 einige Besonderheiten zu beachten.)
 Und beim Aufruf:
 exim -DTESTING -DTRANSPORT=foo …
-Macros können neu definiert werden („==“ statt „=“). Macros von der Kommandozeile haben Vorrang.
+* Macros können neu definiert werden („==“ statt „=“).
+* Macros von der Kommandozeile haben Vorrang.
 === Optionen
 * Optionen werden generell klein geschrieben.
 * Es gibt ca. 250 globale Optionen, hinzu kommen noch weitere Optionen für Router,
 Transports, Authenticators, usw.
-* Optionen haben einen bestimmten <<types,Datentyp>>.
+* Optionen haben einen Werte von bestimmten <<types,Datentypen>>.
 .Beispiel
 primary_hostname = foo.example.com
 === Listen
 Hosts oder IP-Adressen, z.B. für vertrauenswürdige Absender-Netze
 hostlist trusted_hosts = 192.168.0.0/24 : 127.0.0.1
 Mail-Adressen::
-Mailadressen
+Mail-Adressen von Absender oder Empfänger
 addresslist blocked_senders = ad@bestholiday.de : *@mailgun.com
 Local Parts::
-Local Parts von Mail-Adressen, z.B. von ACL-Checks ausgenommene lokale Empfänger
+Local Parts von Mail-Adressen
 localpartlist rfc = postmaster : abuse
 Listen-Lookups werden nur gecacht, wenn die Liste keine Expansions-Items entält
 (also kein '$'). Um ein Caching zu erwzingen, kann dem Listentyp ein
 domainlist_cache local_domain = ${lookup …}
 .Beispiel Debugging
 exim -bP +local_domains
-=== Instanzen von Routern, Transports, Authentificators
+=== Instanzen von Routern, Transports, Authenticators
-* Router, Transports und Authenificators werden in einzelnen „Funktionsblöcken“ definiert.
+* Router, Transports und Authenticators werden in einzelnen „Funktionsblöcken“ definiert.
-* Diese Blöcke haben selbstgewählte Namen und eine Liste von
+* Diese Blöcke haben selbstgewählte Namen, einen Treiber, der das generelle
-Optionen, die das Verhalten des jeweiligen Routers, Transports oder
+Verhalten des Blocks festlegt und Optionen,
-Authenticators bestimmen.
+die das Verhalten des jeweiligen Routers, Transports oder
+Authenticators weiter bestimmen.
+* _Generische_ Optionen gelten für alle Router, Transports
+* Jeder Treiber hat zusätzlich spezifische Optionen
 .Beispiel
 begin transports
 …
 remote_smtp:
 Diese Teile der Konfiguration haben ihre jeweils eigene Syntax.
 [[types]]
 == Werte und ihre Typen
-ALle Optionen der Konfigurationsdatei haben einen spezifischen Daten-Typ.
+Alle Optionen der Konfigurationsdatei haben einen spezifischen Daten-Typ.
 * _bool_, _integer_, _fixed-point_, _time_ und _string_
 * Listen sind immer String-Listen
-* Werte, die der Expansion unterliegen, sind immer vom Typ _string_
+* Werte, die der späteren Expansion unterliegen, sind immer vom Typ _string_
 === Bool
 Werte vom Typ _bool_ sind einfache Schalter.
 .Format
-<option> = true|yes
+... = true|yes|false|no
-<option> = false|no
 <option>
 no_<option>
 not_<option>
 .Beispiel
 Zahlen. Ganze Zahlen.
 .Format
 … = <digits>[<suffix>]
-= 0<oct digts>[<suffix>]
+… = 0<oct digts>[<suffix>]
-= 0x<hex digts>[<suffix>]
+… = 0x<hex digts>[<suffix>]
 Erlaubte Suffixe sind 'K' (2^10^) und 'M' (2^20^).
 .Beipiel
 check_spool_space = 10M
-=== Fixed-Point
+=== Festkomma-Zahlen
-Fixkomma-Zahlen, maximal 3 Nachkommastellen
+Festkomma-Zahlen, maximal 3 Nachkommastellen
 .Format
 … = <digits>[.<max 3 digits>]
 Diese Werte erlauben *keine* Einheitensuffixe.
 zweifelsfrei in Sekunden umrechnen lassen.
 .Beispiel
 auto_thaw = 3d12h
-CAUTION: Bei der Ausgabe von Intervall-Optionen werden die Zeiten normalisiert.
 === Zeichenketten
-* Zeichenketten gibt es in zwei Formen: Literale Zeichenketten und gequotete
+* Zeichenketten gibt es in zwei Formen: *literale* Zeichenketten und *gequotete*
 Zeichenketten..
 * Zeichenketten, die später noch expandiert werden, werden _immer_ als gequotete
 Zeichenketten behandelt.
 .Format
 === Reguläre Ausdrücke
 * Reguläre Ausdrücke werden durch 'libpcre' ausgewertet, sie sind also kompatibel
 mit den von Perl bekannten regulären Ausdrücken.
-* Reguläre Ausdrücke werden immer zuerst als String evaluiert, eventuelle Backslash-Sequenzen müssen also ggf. geschützt
+* Reguläre Ausdrücke werden immer zuerst als String evaluiert und normalerweise
+dort, wo Expansion stattfindet, eventuelle Backslash-Sequenzen müssen also ggf. geschützt
 werden.
+* Dort wo Reguläre Ausdrücke mit anderen Syntaxelementen verwechselt werden
+könnten, beginnen sie zwingend mit „^“.
 .Format
 … = ^<regexp>
 .Beispiel
 Im Beispiel wird der Backslash verdoppelt, da die o:domains Option zuerst
 expandiert wird.
 == Expansion von Zeichenketten
-* Viele Stellen der Konfiguration verwenden String-Expansion (Typ 'string*' im
+* Viele Stellen der Konfiguration verwenden Zeichenketten-Expansion (Typ 'string*' im
-_spec.txt_). String-Expansion wird von '$' getriggert.  Das Ergebnis ist dann
+_spec.txt_). Zeichenketten-Expansion wird von '$' getriggert.  Das Ergebnis ist dann
-ein neuer String oder 'forced failure'.
+ein neuer String oder 'forced failure', dieses ist vergleichbar mit 'undef' oder
-* Die Expansion der Strings erfolgt in der Regel erst im Bedarfsfall („late
+'NULL'.
-binding“).
+* Die Expansion der Strings erfolgt erst im Bedarfsfall („late binding“).
 CAUTION: Es stehen aber nicht in jeder Phase alle Expansions-Items zur Verfügung. (z.B.
 wird der Wert der globalen Option o:message_size_limit expandiert, aber bereits
 während der Antwort auf das SMTP-HELO. In dieser Phase gibt es noch keinen
 i:$local_part).
 exim -be '$tod_full'
 exim -bem <(echo 'Subject: Hi') '$h_subject:'
 === Expansions-Items
-* Aus Sicht des Expanders ist alles, was mit einem '$' beginnt, ein
+* Aus Sicht des Expanders ist jedes Token, das mit einem '$' beginnt, ein
 Expansions-Item.
+Diese Expansions-Items lassen sich unterteilen:
 Variablen::
 Das sind operative Parameter, Information über die aktuelle Nachricht,
 den aktuellen Systemzustand, Rückgabewerte.
 http://www.exim.org/exim-html-current/doc/html/spec_html/ch-string_expansions.html#SECTexpvar[spec]
 ==== Implizite Syntax
 * Der Key ergibt sich aus dem Kontext, das Lookup wird dennoch durch den
 String-Expander behandelt. Wenn das Lookup erfolgreich ist, wird als Resultat
-der Key zurückgeliefert, nicht ein eventuell vorhandener Wert!
+der Key zurückgeliefert, und *nicht* ein eventuell vorhandener Wert!
-* Analogie: +exists($key) ? $key : ''+
+* Analogie: ++exists($key) ? $key : ''++
 .Format
 … = <type>;<file>
 … = <type>;<query>
 === Style
 ==== Single Key
-Single-Key Lookups beziehen sich auf einfach (und meist schnelle) Key/Value
+Single-Key Lookups beziehen sich auf einfache (und meist schnelle) Key/Value
 Daten. Das sind Dateien im Format der _/etc/aliases_, das sind Verzeichnisse und
 DBM-Files.
 http://www.exim.org/exim-html-current/doc/html/spec_html/ch-file_and_database_lookups.html#SECTsinglekeylookups[spec]
 .Wichtige Single Key Lookups
 Ziel der ACL-Operations sollte es sein, möglichst viele Dinge zur SMTP-Zeit zu
 entscheiden und dann die SMTP-Verbindung mit 5xx zu beenden. Damit bleibt die
 Verantwortung für die Bounce beim Absender.
+.Beispiel
+acl_check_recipient:
+accept local_parts = postmaster
+domains     = +local_domains
+require message    = sender verification failed
+verify     = sender
+…
 == Router
 Im Router-Abschnitt wird durch einzelne Blöcke das Routing-Verhalten gesteuert.
 Die Reihenfolge der Blöcke ist wichtig. Das Verhalten eines jeden Blocks wird
 durch den Treiber bestimmt.
 case NEW ADDRESS: goto FIRST ROUTER
 case PASS:        goto NEXT ROUTER
 case FAIL:        generate bounce
 case DEFER:       back to queue
 case DECLINE:     if (more?) goto NEXT ROUTER
-generate bounce
+default:          generate bounce
 .Beispiel
 external:
 driver = dnslookup
 domains = !+local_domains
 Exim legt alle wichtigen Daten in Text-Dateien ab. Trotzdem sind einige Optionen
 und Tools hilfreich im Umgang mit den operativen Daten des Exim.
 === Prozesse
-Mit
+Für eine gute Übersicht über die aktuellen Aktivitäten des Exim:
 exiwhat
-erhält man eine gute Übersicht über die aktuellen Aktivitäten des Exim.
 === Queue
 Alle operativen Daten liegen unter dem Spool-Directory:
 > d
 deleted
 'exim_tidydb'::
 Wird regelmäßig über Cron aufgerufen um die Inhalte der Datenbankfiles
-aufzuräumen. Die Files werden dabei nicht zwangsläufig kleiner!
+aufzuräumen. Die Files werden dabei nicht zwangsläufig kleiner, aber
+es werden alte Einträge gelöscht.
 == Debugging
 === Konfiguration
 CAUTION: Viele Fehler treten erst später bei der Expansion auf!
 Teile der Konfiguration können mit:
+exim -bP
 exim -bP <option>
-exim -bP
 exim -bP transports
 exim -bP routers
 ausgelesen werden.
 === Routing im Trockentest
 Das nützlichste Werkzeug ist sicher der Routing-Trockentest.
-Mit
+Ein Address-Test kann gestartet werden. Das entspricht dem Routing-Vorgang:
 exim -bt <address>
-wird ein Address-Test gemacht. Das entspricht dem Routing-Vorgang. Im
+IUnterschied zum echten Routing-Vorgang stehen diesem Test aber keine
-Unterschied zum echten Routing-Vorgang stehen diesem Test aber keine
 Header-Daten zur Verfügung. Die Absender-Adresse kann mit _-f <sender>_
 eingesetzt werden:
 exim -f <sender> -bt <address>
 === String-Expansion
 Der String-Expander steht auf der Kommandozeile zur Verfügung:
 exim -be <string>
+Ohne die Angabe eines zu expandierenden Strings wird eine interaktive
+Expander-Sitzung gestaret, wenn der Exim mit Readline-Unterstützung übersetzt
+wurde, steht diese hier zur Verfügung.
 .Beispiel
 exim -be '${lookup{root}lsearch{/etc/aliases}}'

changeset 24	5898f11d12c0
parent 23	49b311800e28