95.1.21. pepsi-stage-list-post¶
moderate, transform and fan out a post to a mailing list
- Handbuchabschnitt:
1
95.1.21.1.1. Name¶
pepsi-stage-list-post - die Mailinglisten-Beitrags-Stage der Pepsi-Pipeline.
95.1.21.1.2. Übersicht¶
pepsi-stage-list-post [GLOBAL-OPTIONS] worker
95.1.21.1.3. Beschreibung¶
pepsi-stage-list-post ist ein Stage-Programm, das von pepsi-dispatch(1) ausgeführt wird. Eine Nachricht, die pepsi-stage-list(1) als Beitrag an eine Liste eingestuft hat, kommt hier an, und mit ihr geschehen zwei Dinge, in dieser Reihenfolge und unter diesen Namen:
eine Chain aus Rules entscheidet, ob der Beitrag angenommen, zurückgehalten, abgelehnt oder verworfen wird;
eine Pipeline aus Handlers entscheidet, wie ein angenommener Beitrag umgeformt und zugestellt wird.
Moderation und Verarbeitung sind verschiedene Stufen mit verschiedenem Vokabular, und wer sie vermengt, erhält etwas, das nicht Mailman ist. Die Namen der Rules, Chains, Handlers und Pipelines sind ein Kompatibilitätsbezeichner: Die REST-API meldet sie, und posting_chain und posting_pipeline einer Liste nennen sie.
Die Stage liest die Datenbank einmal, zu Beginn; berechnet alles im Speicher; und schreibt einmal, in einer einzigen Transaktion, die auch den eigenen Abschluss der Nachricht übernimmt. Ein Absturz irgendwo dazwischen spielt das Ganze erneut ab.
95.1.21.1.4. Chains und Rules¶
Die Standard-Posting-Chain führt der Reihe nach aus: die DMARC-Abschwächungsprüfung, die Prüfung auf fehlende Absender, die Umgehung per Moderatorpasswort (approved), die Schleifen- und Sperradressen-Rules, Pepsis dmarc-failure-Rule, die standortweiten und listenbezogenen Header-Abgleiche, das Notfall-Flag sowie die Moderations-Rules für Mitglieder und Nichtmitglieder. Danach vermerken acht Rules nur, was sie finden, und ein abschließendes any hält den Beitrag zurück, wenn eine davon angeschlagen hat. Diese acht sind administrivia, implicit-dest, max-recipients, max-size, news-moderation, no-subject, digests und suspicious-header. Die achtzehn Rules von Upstream sind die siebzehn hier genannten und truth, die immer zutrifft. Pepsi fügt eine Rule hinzu, dmarc-failure, und es gibt vier terminale Chains (accept, hold, reject, discard).
Die DMARC-Abschwächungsprüfung schlägt die Richtlinie nicht erneut nach: Sie verwendet die Richtlinie, die der Ingress für die From:-Domain festgehalten hat (state.auth.dmarc_policy). Eine Domain, die quarantine oder reject veröffentlicht, wird abgeschwächt, eine, die none oder gar keinen Eintrag veröffentlicht, nicht, und ein Beitrag, für den nichts festgehalten wurde (eine lokale Einlieferung), wird abgeschwächt, wie es Upstream tut, wenn seine Abfrage fehlschlägt. dmarc_mitigate_unconditionally schwächt jeden Beitrag ab.
dmarc-failure hält einen Beitrag zurück, dessen From:-Domain bei der Annahme DMARC nicht bestanden hat (state.auth.dmarc ist fail), auf einer Liste, deren Einstellung hold_dmarc_failures eingeschaltet ist. Diese Einstellung ist standardmäßig für jede Liste eingeschaltet, die Pepsi anlegt; aus GNU Mailman importierte Listen erhalten no. Sie hält zurück, gleich welche Richtlinie die Domain veröffentlicht und ob der Einsender Mitglied ist oder nicht, mit dem Grund „The message failed DMARC“. Ein Fehlschlag, für den ein vertrauenswürdiger ARC-Versiegler beim Ingress gebürgt hat (state.auth.arc_override), zählt als Pass, und ein hier von einem authentifizierten Absender eingelieferter Beitrag (state.local_origin) wird von dieser Rule nie zurückgehalten, gleich welches Urteil der Ingress daneben festgehalten hat: SMTP AUTH hat den Absender bewiesen, und der Client eines reisenden Mitglieds steht in niemandes SPF-Eintrag. Eine Liste signiert jeden Beitrag, den sie verteilt, neu und sendet ihn erneut, sodass ohne diese Rule ein gefälschter Beitrag jedes Mitglied authentifiziert aussehend erreichen würde. Wie jedes andere Zurückhalten gibt ihn das Approved:-Passwort eines Moderators frei.
Ein korrektes Moderatorpasswort umgeht die Sperrliste. Das ist das Verhalten von Upstream, und die Kompatibilität verlangt es, aber es ist eine scharfe Kante, und es wird hier gesagt statt drei Kapitel weiter: Ein Approved:-Header mit dem Moderatorpasswort der Liste springt direkt zu accept, über die Sperrliste, die Header-Abgleiche, das Notfall-Flag und beide Moderations-Rules hinweg.
95.1.21.1.5. Die Invariante des Freigabepassworts¶
Ein Moderator kann einen Beitrag freigeben, indem er das Moderatorpasswort der Liste in einen Approved:-Header oder in die erste Zeile des Nachrichtentexts schreibt. In welcher Form es auch ankam, es wird entfernt, bevor die Nachricht archiviert oder zugestellt wird: aus dem Header, aus dem Klartext-Nachrichtentext und aus der HTML-Alternative, die ein Mailprogramm daneben erzeugt hat. Ein Passwort, das bis in ein öffentliches Archiv überlebt, ist dauerhaft veröffentlicht, und das Löschen der archivierten Nachricht holt die Kopien, die bereits in fünftausend Postfächern liegen, nicht zurück.
Die Rule entfernt, was sie gefunden hat; cleanse löscht danach alle vier Header-Namen (Approve, Approved, X-Approve, X-Approved) bedingungslos, und nur das entfernt ein falsches Passwort.
Wenn sich ein Passwort gegen einen gespeicherten Hash verifizieren lässt, der mit schwächeren Argon2id-Parametern erstellt wurde, als neue Hashes erhalten, hasht die Stage es mit den aktuellen Parametern erneut und speichert das Ergebnis, so wie eine Konsolen- oder Mitgliederanmeldung ihren eigenen aufrüstet. Sie speichert es nur, solange der gespeicherte Hash noch der ist, gegen den es verifiziert wurde. Der Approved:-Header ist der einzige Moment, in dem die Stage den Klartext sieht.
95.1.21.1.6. Handlers¶
Die Pipeline ist die von Upstream, in der Reihenfolge von Upstream: validate-authenticity, mime-delete, tagger, member-recipients, avoid-duplicates, cleanse, cleanse-dkim, cook-headers, subject-prefix, rfc-2369, to-archive, to-digest, to-usenet, after-delivery, acknowledge, dmarc, to-outgoing.
Ein Beitrag, aus dem mime-delete alles entfernt, geht in der Pipeline nicht weiter, und filter_action der Liste entscheidet, was mit ihm geschieht. Jede Aktion geht vom Beitrag aus, wie er eingetroffen ist:
holdDer Beitrag wartet wie jeder zurückgehaltene Beitrag auf einen Moderator, und die Moderatoren und der Absender werden benachrichtigt, abhängig von
admin_immed_notifyundrespond_to_post_requests.preserveDer Beitrag wird ebenso aufbewahrt, aber der Absender erfährt es nicht. Moderatoren finden ihn unter den zurückgehaltenen Nachrichten der Liste, in der Besitzer-Konsole und unter
/lists/<id>/heldder REST-API, mit einem Grund, der sagt, dass er bewahrt wurde.max_days_to_holdgilt auch für ihn.rejectDer Absender erhält eine DSN, die den Grund nennt.
forwardDie Besitzer der Liste erhalten eine Mitteilung mit dem Beitrag als Anhang, und der Absender erfährt es nicht. Eine Liste ohne Besitzer behält den Beitrag wie bei
preserve.discardDer Beitrag wird gelöscht, und niemand erfährt es. Das ist der Standard.
Ein Moderator, der einen von hold oder preserve zurückgehaltenen Beitrag freigibt, hat entschieden, daher wird der Beitrag ohne den Filter so zugestellt, wie er eingetroffen ist. Ein Beitrag, der aus einem anderen Grund zurückgehalten wurde, durchläuft den Filter trotzdem, und bleibt unter reject oder discard nichts von ihm übrig, erhalten ihn die Besitzer wie bei forward, weil es bei einem freigegebenen Beitrag keinen Absender zu benachrichtigen gibt. accept und defer werden für eine neue Einstellung abgelehnt. Eine Liste, die bereits einen dieser Werte trägt, verhält sich wie bei hold. Steht die Moderationswarteschlange bei MAX_HELD_MESSAGES, können hold und preserve den Beitrag nicht behalten, und der Absender erhält stattdessen eine DSN.
decorate und arc-sign fehlen, weil Upstreams eigene Standard-Pipeline sie auskommentiert hat, mit Upstreams Begründung: Die gesamte Dekoration geschieht bei der Zustellung, und Dekoration bei der Zustellung würde eine hier angebrachte Signatur zerstören. Beides ist Sache von pepsi-stage-list-deliver(1) und des Signier-Endes der Pipeline.
to-usenet ist eine explizite, protokollierte Nulloperation: gateway_to_news bleibt setzbar, weil sein Entfernen die Ressource verändern würde, die ein REST-Client sieht, aber Pepsi leitet nicht an NNTP weiter, und eine stille Nulloperation ließe einen Betreiber glauben, sein Gateway funktioniere.
95.1.21.1.7. Geschriebene Header¶
Mailmans X-Mailman-*-Namensraum wird umbenannt. Nichts in Postorius oder HyperKitty liest etwas davon, und der einzige Konsument irgendeines davon ist ein Mensch, der einen zurückgehaltenen Beitrag liest:
Mailman 3 |
Pepsi |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(kein Gegenstück) |
|
|
|
Message-ID-Hash und seine ältere X--Schreibweise behalten ihre Namen: Sie tragen den Namen keines Projekts, aus ihnen wird jede Archiv-URL abgeleitet, und auf ihnen hat ein Dritter am ehesten etwas aufgebaut.
X-Pepsi-List-Hops ist der einzige, den die Software je wieder einliest. Er ist die Rückfallsicherung gegen einen Abonnementzyklus über zwei oder mehr Listen, denn die loop-Rule erkennt nur eine Nachricht, die zur selben Liste zurückkehrt. Er reist in einem Header, weil ein Geschwister-Datensatz per SMTP hinausgeht und als gewöhnliche Mail wieder hereinkommt, wobei der Datensatz-State nicht überlebt. Ein Beitrag, dessen Zählung [pepsi-list] MAX_LIST_HOPS (Standardwert 5) erreicht hat, wird für die Moderatoren zurückgehalten statt zugestellt, weil ein zugestellter Zyklus ein wachsender Zyklus ist. Weil ein Header fälschbar ist, entfernt pepsi-ingress(1) eine eingehende Kopie davon aus Mail, die nicht über einen authentifizierten oder lokalen Einlieferungsweg kam.
95.1.21.1.8. Das Fan-out¶
Jedes reguläre Mitglied mit eingeschalteter Zustellung, das keine Sammelnachrichten bezieht, erhält bedingungslos einen Datensatz. Jeder trägt seinen eigenen einzigen Empfänger und seinen eigenen VERP-Umschlagabsender, <list>-bounces+<local>=<domain>=<code>@<host>. Das ist die Form von Upstream mit einem angehängten Authentifizierungscode, verschlüsselt mit [pepsi-list] VERP_SECRET (ohne es verweigert die Stage den Start). Sie lässt den Bounce-Pfad einen Fehlschlag genau einem Abonnement zuordnen, ohne den Bounce zu parsen, und eine Adresse ablehnen, die sich jemand ausgedacht hat. Jeder Datensatz beginnt paused bei DELIVERY_STAGE für eine zufällige Zeit von bis zu [pepsi] REFLECTION_HOLD_MAX (Standardwert 30 s; pepsi.conf(5)), je Kopie gezogen, und der Dispatcher gibt jede Kopie frei, wenn ihre Zeit kommt. Ein Beitrag ist reflektierte Mail, und das Auffächern über das Fenster zu verteilen hindert einen Fremden daran, Beiträge an viele Listen so zu takten, dass sie gleichzeitig bei einem Host ankommen.
Über die Leitung geht die Empfängerliste, nicht die Nachricht: Die Header werden innerhalb der Datenbank kopiert und der Nachrichtentext per Referenz geteilt, sodass ein Beitrag an fünftausend Mitglieder eine Nachricht und fünftausend kleine JSON-Objekte an PostgreSQL sendet statt fünftausend Nachrichten.
Das Fan-out erfolgt in Stapeln: Es werden höchstens [pepsi-list] LIST_FANOUT_BATCH Datensätze (Standard 256) auf einmal angelegt, und die Nachricht pausiert zwischen den Stapeln, mit den verbleibenden Empfängern in ihrem eigenen state. Jeder Geschwister-Datensatz verweist auf eine gespeicherte Kopie des (aufbereiteten) Nachrichtentexts in pepsi.workqueue_body, statt eine eigene zu tragen, sodass das Fan-out eines Beitrags an 5 000 Mitglieder mit einem 5-MB-Anhang den Anhang einmal speichert, nicht 5 000-mal (die Kopie eines Mitglieds erhält nur dann einen eigenen Nachrichtentext, wenn pepsi-stage-list-deliver(1) sie umschreibt). Die Stapelung begrenzt, wie viele Datensätze jeder Schritt hinzufügt, und pepsi-queue(1) zeigt ein laufendes Fan-out statt einer Warteschlange, die plötzlich gewachsen ist.
Das Fan-out beachtet außerdem die Aufnahmegrenzen der Warteschlange ([pepsi] MAX_QUEUE_ROWS, MAX_QUEUE_BYTES, MIN_FREE_SPACE; siehe pepsi.conf(5)). Steht die Warteschlange an einer davon, gibt die Stage einen leeren Stapel aus, wobei der ganze Rest in state bleibt, und pausiert für [pepsi] QUEUE_THROTTLE_DELAY (Standard 60 s), bevor sie erneut nachsieht, sodass ein Beitrag an eine große Liste nicht weiter eine Warteschlange füllen kann, für die pepsi-ingress(1) bereits Mail ablehnt. Ein erster Stapel, der zurückgehalten wird, archiviert den Beitrag trotzdem und bewegt seine Zähler, genau einmal, wie üblich. Die Empfängerliste wird beim ersten Stapel als Momentaufnahme festgehalten, sodass eine Abmeldung mitten in einem großen Versand keinen Nachbarn überspringen oder verdoppeln kann, und die Quellzeile wird erst von dem Stapel gelöscht, der die Liste abschließt, sodass ein Absturz diesen Stapel erneut abspielt und nicht mehr.
Eine Digest-Ausgabe nimmt ab ihrem zweiten Schritt denselben Weg. pepsi-list digest injiziert jede Ausgabe hier (als [pepsi-list] RELEASE_STAGE) mit ihren Digest-Mitgliedern bereits in state als Momentaufnahme der Empfänger, sodass die Stage sie Stapel für Stapel genau wie einen pausierten Beitrag auffächert und nichts von der Posting-Chain ausführt: Eine Ausgabe wird nicht moderiert, archiviert, der nächsten Sammelnachricht angehängt oder gezählt. Jedes Geschwister wird als Digest markiert, was pepsi-stage-list-deliver(1) sagt, die eigene Kopf- und Fußzeile der Ausgabe in Ruhe zu lassen.
95.1.21.1.9. Der Beitrags-Autoresponder¶
autorespond_postings beantwortet Beiträge über die Kulanzfristmechanik je Liste (autoresponse_grace_period, beansprucht über list_autoresponse_claim), die auch die Ergebnismail von pepsi-stage-list-command(1) ratenbegrenzt. Es ist dasjenige, über das man lesen sollte: Es feuert auf der Beitrags-Adresse, sodass ein falsch konfiguriertes jedem antwortet, der an die Liste schreibt. (Die Geschwister-Attribute autorespond_requests und autorespond_owner werden gespeichert und über REST gemeldet, aber keine Stage handelt danach.)
Drei Werte, wie überall: none, respond_and_continue und respond_and_discard. Auf einer Beitragsadresse bedeutet der letzte, dass der Beitrag beantwortet und nicht verteilt wird: Die Liste verwirft jeden Beitrag und antwortet dabei jedem Absender höflich. Das will ein Eigentümer gelegentlich (eine stillgelegte Liste, die „wir sind umgezogen“ antwortet), aber nie aus Versehen, daher wird das Verwerfen auf warn protokolliert, und die Eigentümerkonsole beschriftet den Wert unmissverständlich.
Zwei Regeln, die nicht offensichtlich sind:
Ein unbekannter Wert ist ``none``. Eine Antwortaktion, die niemand buchstabieren kann, ist keine Erlaubnis, eine ganze Mitgliedschaft anzuschreiben.
Ein Beitrag, der nicht beantwortet werden konnte, wird trotzdem zugestellt. Wenn der Autoresponder ablehnt (weil RFC 3834 nein sagte, die Karenzzeit nicht abgelaufen war oder der Umschlagabsender leer war), verwirft
respond_and_discardnicht. Eine Liste, die jede Nachricht eines Autoresponders stillschweigend verwirft, wäre ein schlimmeres Versagen als eine fehlende Antwort.
Jede automatische Antwort durchläuft zuerst den RFC-3834-Regelsatz von pepsi_common::autoreply: der Null-Absender, ein Auto-Submitted, das nicht no ist, Precedence: bulk|list|junk, jedes List-*, ein multipart/report, Mail an sich selbst, ein Beitrag, den eine vorgelagerte Stage als Spam eingestuft hat, und ein Beitrag, dessen Absender SPF oder DMARC eindeutig nicht bestanden hat (state.auth.spf oder state.auth.dmarc ist fail). Dieser Regelsatz wird gemeinsam genutzt statt hier neu formuliert, weil ein Autoresponder genau durch Fehler darin eine Mailschleife baut, und eine Schleife auf einer Beitragsadresse ist eine Schleife mit einer ganzen Mitgliedschaft darin.
95.1.21.1.10. Konfiguration¶
- DELIVERY_STAGE (erforderlich)
Wohin die Kopie jedes Mitglieds geht. Sie muss pepsi-stage-list-deliver(1) ausführen, und pepsi-setup prüft das.
- BOUNCE_STAGE (erforderlich)
Wo ein abgelehnter Beitrag in eine DSN für seinen Absender umgewandelt wird. Die DSN nennt den Grund der Liste und folgt dem
NOTIFYjedes Empfängers,NOTIFY=NEVERbedeutet also keine DSN. Hier bedeutet dies, was es überall außer bei pepsi-stage-list(1) bedeutet.- RESPONSE_STAGE (erforderlich)
Wohin Hinweise eingespeist werden: die Benachrichtigung der Moderatoren über einen zurückgehaltenen Beitrag, der Hinweis „Ihre Nachricht wird zurückgehalten“ und die Empfangsbestätigung an den Einsender sowie die automatische Antwort auf Beiträge. Das Signier-Ende der Pipeline, nicht die Listen-Zustell-Stage: pepsi-stage-list-deliver(1) nimmt nur die Kopie eines Mitglieds aus dem Fan-out an und lässt alles andere fehlschlagen, sodass ein dorthin gesendeter Hinweis nie hinausgeht. pepsi-setup(1) weist den falschen Wert zurück.
- REMOVE_DKIM_HEADERS (Standard
no) Entfernt
DKIM-Signature,DomainKey-SignatureundAuthentication-Resultsdes Urhebers. Upstreams[mailman] remove_dkim_headers. Standardmäßig aus: Eine Liste, die nichts umschreibt, hinterlässt eine gültige Signatur, und sie zu entfernen verwirft echte Beweise. Schalten Sie es für Listen ein, die eine Fußzeile oder ein Betreff-Präfix hinzufügen, bei denen die verbleibende Signatur scheitern würde. Eine scheiternde Signatur ist schlimmer als keine, weil ein Fehlschlag ein Beweis für Manipulation ist und ein Fehlen nicht.- SITE_HEADER_MATCH_CHAIN (Standard
hold) Zu welcher Chain ein standortweiter Header-Abgleich springt; Upstreams
[antispam] jump_chain. Standortweit, weil die Abgleiche, für die er gilt, die des Standorts sind, und ein Listeneigentümer die Spam-Regeln des Standorts nicht in ein Verwerfen verwandeln können darf.- SENDER_POSTS_PER_HOUR (Standard
30) Wie viele Beiträge eines Absenders eine Liste pro Stunde verteilt. Ein Beitrag über der Grenze, den die Kette angenommen hätte, wird stattdessen für den Moderator zurückgehalten, mit einer entsprechenden Begründung; eine Freigabe durch einen Moderator wird nie gezählt. Das Zeitfenster beginnt mit dem ersten Beitrag des Absenders und dauert eine Stunde (
pepsi.list_post_rate). Seitenweit statt als Listenattribut, weil es eine Verfügbarkeitsgrenze ist: Eine Liste vervielfacht jeden angenommenen Beitrag mit ihrer Mitgliederzahl.0deaktiviert sie.- MAX_HELD_MESSAGES (Standard
1000) Wie viele Nachrichten eine Liste zur Moderation zurückhalten darf. Ein Beitrag, der darüber hinaus zurückgehalten würde, wird mit einer DSN und einer Warnung im Log abgelehnt und nicht gespeichert. Zurückgehaltene Beiträge werden als ihre vollständigen Wire-Bytes aufbewahrt, bis ein Moderator handelt oder
max_days_to_holdder Liste (Standard: nie) sie verfallen lässt, sodass eine offene Liste ohne Obergrenze alles speichern würde, was ihr irgendjemand schickt. Der neue Beitrag wird abgelehnt statt des ältesten, damit eine Flut nicht die Beiträge hinausspülen kann, die noch auf einen Moderator warten. Gleichzeitige Worker können die Grenze um einige überschreiten.0deaktiviert sie.
Ein zurückgehaltener Beitrag wird unter dem Hash seiner Message-ID gespeichert. Dieses Feld wählt der Absender, daher wird ein zweiter Beitrag mit derselben Message-ID und anderem Inhalt unter einem Schlüssel gespeichert, der auch von seinem Inhalt abhängt, und er erhält eine eigene Moderationsanfrage.
Beide Grenzen, die Hop-Obergrenze und die Zulassungsdrosselung des Fan-outs, sind die Mailinglisten-Einträge von „Loops and amplification“ im Kapitel zum Bedrohungsmodell des Pepsi-Handbuchs; „Resource limits“ in seinem Sicherheitskapitel sagt, wo jede durchgesetzt wird.
NEXT_STAGE ist hier bedeutungslos, und pepsi-setup weist einen Abschnitt zurück, der es setzt: Jeder Weg aus dieser Stage heraus ist ein Abschluss.
95.1.21.1.11. State¶
Eingaben: state.list.id (geschrieben von pepsi-stage-list(1)), state.auth (die SPF/DKIM/DMARC-Urteile, die pepsi-ingress(1) festgehalten hat), state.list.pending_rcpt bei einem wiederaufgenommenen Fan-out und state.list.moderator_approved bei einem zurückgehaltenen Beitrag, den ein Moderator freigegeben hat.
Ausgaben: ein state.list-Deskriptor auf jeder Geschwisterzeile: die Mitglieds-ID, seine Sprache, seine Abmelde-Seriennummer und das Duplikat-Flag.
Übergänge: beendet (der letzte Stapel eines Fan-outs, ein Zurückhalten, ein Verwerfen), beendet mit einem Nebenklon (die DSN einer Ablehnung) oder pausiert (ein Fan-out mit verbleibenden Empfängern).
95.1.21.1.12. Befehle¶
- worker
Läuft als persistenter pepsi-dispatch(1)-Worker, der Nachrichten-IDs von der Standardeingabe liest.
95.1.21.1.13. Globale Optionen¶
Die übliche Gruppe — -c/–config, -L/–log, -v/–verbose, -h/–help und -V/–version —, die sich wie bei jedem Pepsi-Programm verhält; siehe pepsi-config(1).
95.1.21.1.14. Fehler und Wiederholungen¶
Ein Beitrag, der eine nicht mehr existierende Liste nennt (sie wurde gelöscht, nachdem der Router die Nachricht geroutet hatte), wird dem Absender gemeldet: eine DSN pro Empfänger über BOUNCE_STAGE, die besagt, dass die Mailingliste nicht mehr existiert, und der Beitrag ist fort. Eine Nachricht, die der MIME-Parser ablehnt (zu tief verschachtelt oder aufgeteilt, um sie zu verarbeiten), oder eine, die die Stage ohne das state.list.id des Routers erreicht hat (eine von Hand verdrahtete Stage), schlägt sofort fehl. Jeder andere Fehler, etwa aus der Datenbank, einer Vorlage oder dem Archiv, ist ein Fehler des Hosts: Der Beitrag wird pausiert und mit Backoff bis MAX_LIFETIME wiederholt (siehe pepsi-dispatch(1)). Ein Abschnitt, der sich nicht parsen lässt, hindert den Worker überhaupt am Start, sodass die Warteschlange auf die Korrektur wartet, statt einen Beitrag nach dem anderen fehlschlagen zu lassen.
Eine Wiederholung darf nicht ändern, was der Beitrag bewirkt. SENDER_POSTS_PER_HOUR und die Karenzzeit des Beitrags-Autoresponders sind beides Ansprüche, die festgehalten werden, bevor der Beitrag festgeschrieben wird, und sind daher beide an das Warteschlangen-Token der Nachricht gebunden: Ein Beitrag, der wiederholt wird, nachdem sein Festschreiben fehlschlug, erhält dieselben Antworten wie bei seinem ersten Versuch. Er wird weder doppelt gezählt (und wegen unserer eigenen Wiederholung zurückgehalten) noch erhält er die Auskunft, er sei heute bereits beantwortet worden. Die automatische Antwort selbst wird in derselben Transaktion wie der Beitrag festgeschrieben, sodass ein Beitrag nie beantwortet wird, ohne behandelt zu werden, oder behandelt, ohne seine Antwort. Das ist die Transaktion mit dem ersten Fan-out-Stapel oder die, die einen respond_and_discard-Beitrag löscht.
95.1.21.1.15. Exit-Status¶
Das Ergebnis jeder Nachricht wird pepsi-dispatch(1) auf der Statuszeile des Workers gemeldet, nicht als Exit-Status.
- 0
Der Worker lief, bis seine Standardeingabe geschlossen wurde.
- 1
Ein fataler Fehler ist aufgetreten (unlesbare Konfiguration, die Datenbank konnte nicht geöffnet werden, oder Standardein-/-ausgabe schlug fehl). Der Grund wird in das Journal geschrieben.
- 78
Der Worker hat den Start verweigert: Ein
[stage-*]-Abschnitt, den er bedient, oder[pepsi-list]lässt sich nicht parsen (z. B. ein fehlendes DELIVERY_STAGE). Der Dispatcher reiht erneut ein, was er übergeben hatte, und versucht die Stage später wieder.
95.1.21.1.16. Beispiele¶
[stage-list-post]
PROGRAM = pepsi-stage-list-post
DELIVERY_STAGE = list-deliver
BOUNCE_STAGE = bounce
RESPONSE_STAGE = dkim-sign
REMOVE_DKIM_HEADERS = no
95.1.21.1.17. Siehe auch¶
pepsi-list(1), pepsi-stage-list(1), pepsi-stage-list-deliver(1), pepsi-stage-dkim-sign(1), pepsi-ingress(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)
95.1.21.1.18. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.