Wenn Mails scheitern
Ein falsches Passwort, ein Tippfehler im Servernamen, ein Anbieter, der Programme sperrt: Ein Mailprogramm trifft auf mehr Ärger als die meisten. Dieses Rezept sendet eine Testmail und sagt dem Spieler, wenn es nicht klappt, in einfachen Worten, was zu reparieren ist – das Programm, das du zuerst probierst, wenn du Mails einrichtest.
Funktionen: die Fehler von c0de net, SMTP_SEND, IMAP_CREATE und HAS_SECRET aus c0de/security
Was du brauchst
Die Mod c0de net, dein Mailkonto und dein App-Passwort wie in Mail von der Farm, einen Auslöserblock mit Knopf, einen Laptop und Variablenkarten server (STRING) und port (INTEGER). Für die Übung den IMAP-Server aus Der Bestellschalter.
Die Idee
Die Funktionen von c0de_net/mail lösen einen Fehler aus, wenn etwas schiefgeht. Ein CALL mit einer ERROR-Variablen fängt ihn ab, und ihr code sagt, was passiert ist:
| Code | Name | Was passiert ist | Was zu tun ist |
|---|---|---|---|
| 309 | INVALID_ARGUMENT | kein Server oder Absender, eine Adresse, die keine ist, unbekannte Kriterien | korrigiere das Programm |
| 311 | PERMISSION_DENIED | eine Verbindung zu Port 25 | nimm Port 465 oder 587 deines Anbieters |
| 1001 | CLIENT_UNAVAILABLE | der Spieler ist nicht online oder hat kein c0de net | nichts, später nochmal |
| 1003 | REQUEST_FAILED | keine Verbindung: unbekannter Server, abgewiesen, ein Zertifikatsproblem | prüfe Server, Port und security |
| 1004 | REQUEST_TIMEOUT | der Server hat nicht rechtzeitig geantwortet | später nochmal |
| 1005 | RESPONSE_TOO_LARGE | IMAP_FETCH würde zu viel lesen | weniger Nachrichten holen, oder ohne Text |
| 1006 | MAIL_DISABLED | der Server oder der Spieler hat Mails abgeschaltet | frag den Administrator, oder allowMail=true |
| 1007 | AUTHENTICATION_FAILED | Benutzername oder Passwort ist falsch | nimm ein App-Passwort |
| 1008 | MAIL_REJECTED | der Mailserver hat abgelehnt, etwa einen Empfänger oder einen Ordner | lies die Meldung des Fehlers |
| 1009 | MAIL_LIMIT | zu viele Empfänger, zu viel Text, zu viele Mails pro Minute | weniger senden, oder eine Minute warten |
INVALID_ARGUMENT und PERMISSION_DENIED sind Konstanten von c0de; die anderen kommen mit INCLUDE c0de_net/mail, als c0de_net/mail/AUTHENTICATION_FAILED und so weiter.
Die meisten Probleme eines neuen Mailprogramms sind AUTHENTICATION_FAILED: Viele Anbieter lassen Programme nicht mit dem Passwort des Kontos herein. Leg in den Sicherheitseinstellungen deines Kontos ein App-Passwort für c0de an und nimm dieses.
Das Programm
PROGRAM mailcheck
NOOP
INCLUDE c0de/security
INCLUDE c0de/strings
INCLUDE c0de_net/mail
NOOP
FUNCTION explain
PARAMETER code INTEGER
RESULT text STRING
BEGIN
ASSIGN text "Unexpected error " ⊕ code ;
IF code = INVALID_ARGUMENT ;
BEGIN
ASSIGN text "Check the server, the sender and the addresses" ;
END IF
IF code = PERMISSION_DENIED ;
BEGIN
ASSIGN text "Port 25 is blocked, use 465 or 587" ;
END IF
IF code = c0de_net/mail/CLIENT_UNAVAILABLE ;
BEGIN
ASSIGN text "Nobody with c0de net is online" ;
END IF
IF code = c0de_net/mail/MAIL_DISABLED ;
BEGIN
ASSIGN text "Mail is switched off" ;
END IF
IF code = c0de_net/mail/AUTHENTICATION_FAILED ;
BEGIN
ASSIGN text "Wrong user or password (an app password?)" ;
END IF
IF code = c0de_net/mail/MAIL_REJECTED ;
BEGIN
ASSIGN text "The mail server refused it" ;
END IF
IF code = c0de_net/mail/MAIL_LIMIT ;
BEGIN
ASSIGN text "Too much mail: send less or wait a minute" ;
END IF
IF code = c0de_net/mail/REQUEST_FAILED ;
BEGIN
ASSIGN text "The mail server can't be reached" ;
END IF
IF code = c0de_net/mail/REQUEST_TIMEOUT ;
BEGIN
ASSIGN text "The mail server is too slow" ;
END IF
END FUNCTION
NOOP
FUNCTION account
PARAMETER server STRING
PARAMETER port INTEGER
RESULT smtp STRUCT c0de_net/mail/SMTP_SERVER
BEGIN
SECRET mailPassword STRING
ASSIGN smtp.server server ;
ASSIGN smtp.port port ;
ASSIGN smtp.security "tls" ;
ASSIGN smtp.user "steve@example.com" ;
ASSIGN smtp.password mailPassword ;
ASSIGN smtp.from "Farm computer <steve@example.com>" ;
ASSIGN smtp.timeout 10 ;
END FUNCTION
NOOP
FUNCTION send
PARAMETER server STRING "smtp.example.com"
PARAMETER port INTEGER 0
PARAMETER to STRING "steve@example.com"
PARAMETER lines INTEGER 3
BEGIN
VARIABLE known BOOLEAN
VARIABLE smtp STRUCT c0de_net/mail/SMTP_SERVER
VARIABLE problem ERROR
VARIABLE text STRING
VARIABLE message STRING
VARIABLE nl CHAR
CALL CLS
CALL c0de/security/HAS_SECRET
PARAMETER name "mailPassword" ;
RESULT result known
IF NOT known ;
BEGIN
CALL PRINT
PARAMETER value "Put your password into the vault first" ;
EXIT 2 ;
END IF
CALL account
PARAMETER server server ;
PARAMETER port port ;
RESULT smtp smtp
CALL c0de/strings/CHR
PARAMETER code 10 ;
RESULT result nl
FOR i INTEGER 1 ; lines ;
BEGIN
ASSIGN text text ⊕ "Line " ⊕ i ⊕ ": the farm is fine." ⊕ nl ;
END FOR
CALL c0de_net/mail/SMTP_SEND problem
PARAMETER server smtp ;
PARAMETER to to ;
PARAMETER subject "A test from the farm" ;
PARAMETER text text ;
IF problem.code ≠ 0 ;
BEGIN
CALL explain
PARAMETER code problem.code ;
RESULT text message
CALL PRINT
PARAMETER value message ;
EXIT 1 ;
END IF
CALL PRINT
PARAMETER value "Sent to " ⊕ to ;
END FUNCTIONAufbauen und ausführen
- Stelle den Auslöserblock auf
mailcheck/send, leg deine Variablenkartenserverundporthinein und binde den Laptop daran. - Drück den Knopf. Wenn alles stimmt, zeigt der Laptop
Sent to steve@example.com– nimm deine eigene Adresse fürto– und eine Testmail kommt an. - Mach es jetzt absichtlich kaputt, immer nur eine Sache, und schau auf den Laptop:
| Du änderst | Der Laptop zeigt | Exit-Code |
|---|---|---|
| der Tresor ist leer oder geschlossen | Put your password into the vault first | 2 |
| ein falsches Passwort im Tresor | Wrong user or password (an app password?) | 1 |
server auf smtp.nothing.invalid | The mail server can't be reached | 1 |
port auf 25 | Port 25 is blocked, use 465 or 587 | 1 |
to auf nobody | Check the server, the sender and the addresses | 1 |
lines auf 3000 | Too much mail: send less or wait a minute | 1 |

So funktioniert es
explainmacht aus einem Code Worte, wie in Wenn das Netz ausfällt: Es beginnt mit einer Meldung für unbekannte Codes und überschreibt sie für jeden Code, den es kennt.- HAS_SECRET fragt zuerst den Tresor. Eine SECRET-Zeile für ein fehlendes Geheimnis löst SECRET_NOT_FOUND aus und hält das Programm an, deshalb ruft
senddie Funktionaccountmit der SECRET-Zeile nur auf, wenn das Passwort da ist. Ohne offenen Tresor sagt HAS_SECRET ebenfalls FALSE. accountgibt den SMTP_SERVER als Ergebnis zurück, sodass das Passwort nur darin und im Struct lebt. Seintimeoutvon 10 Sekunden lässt einen Test schnell scheitern, statt die vollen 30 zu warten.- Die FOR-Schleife schreibt
linesZeilen Text. 3000 Zeilen sind etwa 90 KiB, mehr als die 64 KiB, die eine Nachricht haben darf: SMTP_SEND löst MAIL_LIMIT aus, bevor es sich verbindet. Zu viele Empfänger oder mehr als 10 Mails pro Minute lösen ihn ebenso aus. - Die Exit-Codes sind 0 für gesendet, 1 für einen Fehler der Mail und 2 für ein fehlendes Passwort, sodass ein Komparator neben dem Auslöserblock sie anzeigen kann.
Anders als in Wenn das Netz ausfällt gibt es keine Wiederholung: Die meisten Mailfehler gehen nicht von selbst weg, und eine Wiederholung eines SMTP_SEND, das in den Timeout lief, könnte die Nachricht zweimal senden.
Probier es selbst
- Das Ordnerprogramm eines Freundes stürzt ab, wenn der Ordner schon existiert. Fang das ab.
Lösung
PROGRAM newfolder
NOOP
INCLUDE c0de_net/mail
NOOP
FUNCTION create
PARAMETER server STRING "imap.example.com"
PARAMETER port INTEGER 0
PARAMETER name STRING "Orders"
BEGIN
SECRET mailPassword STRING
VARIABLE imap STRUCT c0de_net/mail/IMAP_SERVER
VARIABLE problem ERROR
ASSIGN imap.server server ;
ASSIGN imap.port port ;
ASSIGN imap.user "steve@example.com" ;
ASSIGN imap.password mailPassword ;
CALL CLS
CALL c0de_net/mail/IMAP_CREATE problem
PARAMETER server imap ;
PARAMETER folder name ;
IF problem.code = c0de_net/mail/MAIL_REJECTED ;
BEGIN
CALL PRINT
PARAMETER value "The server refused: " ⊕ name ⊕ " exists already?" ;
EXIT 1 ;
END IF
IF problem.code ≠ 0 ;
BEGIN
CALL PRINT
PARAMETER value problem.message ;
EXIT 2 ;
END IF
CALL PRINT
PARAMETER value "Created " ⊕ name ;
END FUNCTIONIMAP_CREATE löst für einen Ordner, den es schon gibt, MAIL_REJECTED aus – der Mailserver lehnt den Befehl ab. Das Programm sagt das und endet mit Exit-Code 1. Mit dem Namen Invoices zeigt es Created Invoices. Jeder andere Fehler endet mit seiner Meldung und Exit-Code 2.
- Alex hat im eigenen Spiel
allowMail=falsegesetzt. Was passiert, wenn Alex den Knopf drückt? Und was, wenn ein Zeitgeberblock das Programm an einem Auslöserblock startet, der Alex gehört?
Lösung
Beide Male zeigt der Laptop Mail is switched off: MAIL_DISABLED. Die Mail ginge von Alex' Computer hinaus – wenn Alex den Knopf drückt, weil Alex den Prozess gestartet hat, und beim Zeitgeberblock, weil ein Prozess, den niemand gestartet hat, als Besitzer des Auslöserblocks läuft. Drückt Steve den Knopf, geht die Mail von Steves Computer hinaus und klappt. Ein Administrator, der enableMail=false in config/c0de_net.properties setzt, schaltet Mails für alle ab.
Mehr dazu
- Fehler von c0de net
- Einstellungen von c0de net
- Fehler im Pfad für Programmierer
- Exit-Codes