mu-server – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

mu_server – das mu-Backend für den mu4e-E-Mail-Client

ZUSAMMENFASSUNG

mu Server [Optionen]

BESCHREIBUNG

mu Server startet eine einfache Shell, in der man die mu-Datenbank abfragen und bearbeiten kann. Der
Die Ausgabe der Befehle erfolgt in Form symbolischer Lisp-Ausdrücke (s-exps). mu Server ist nicht
für den Gebrauch durch Menschen bestimmt; Stattdessen ist es speziell für die entwickelt mu4e E-Mail-Client.

In dieser Manpage dokumentieren wir die Befehle mu Server akzeptiert, sowie ihre Antworten.
Im Allgemeinen haben die an den Server gesendeten Befehle die Form

cmd: [ ]*

Dabei wird jedem Parameter sein Name und ein Doppelpunkt vorangestellt. Um beispielsweise a anzuzeigen
Bestimmte Nachricht, der Befehl wäre:

cmd:docid anzeigen:12345

Parameter können in beliebiger Reihenfolge gesendet werden. Parameter, die von einem bestimmten Befehl nicht verwendet werden, werden jedoch gesendet
einfach ignoriert.

AUSGABE FORMAT

mu Server akzeptiert eine Reihe von Befehlen und liefert seine Ergebnisse in der Form:

\376 \377

\376 (ein Byte 0xfe), gefolgt von der Länge des S-Ausdrucks, ausgedrückt als
Hexadezimalzahl, gefolgt von einem weiteren \377 (ein Byte 0xff), gefolgt von der eigentlichen s-
Ausdruck.

Indem dem Ausdruck seine Länge vorangestellt wird, kann er effizienter verarbeitet werden. Der
\376 und \377 wurden ausgewählt, da sie in gültigem UTF-8 (in dem die s-
Ausdrücke werden kodiert).

COMMAND UND RESPONSE

hinzufügen

Verwendung der hinzufügen Mit dem Befehl können wir der Datenbank eine Nachricht hinzufügen.

-> cmd:Pfad hinzufügen: Mailverzeichnis:
<- (:info add :path :docid )

komponieren

Verwendung der komponieren Befehl erhalten wir die (ursprüngliche) Nachricht und sagen, was wir damit tun sollen
Es. Von der Benutzeroberfläche wird dann erwartet, dass sie die Nachricht vorverarbeitet, z. B. festlegt
Betreff, Absender und Empfänger einer Antwortnachricht.

Nachrichten vom Typ „new“ verwenden den Parameter „docid:“ nicht, die anderen tun dies.

-> cmd:compose-Typ: [Dokument: ]
<- (:compose :Original :enthalten (

Der ist ein S-Ausdruck, der die einzuschließenden Anhänge beschreibt
in der Nachricht; Dies gilt derzeit nur für Nachrichten, die wir weiterleiten. Das ist-
Ausdruck sieht so aus:

(:Dateinamen :Mime Typ :Anordnung )

Kontakte

Verwendung der komponieren Mit dem Befehl können wir einen S-Ausdruck mit allen bekannten Kontakten abrufen
(Name + E-Mail-Adresse). Einzelheiten finden Sie unter mu-cfind(1).

-> cmd:contacts [personal:true|false] [nach: ]
<- (:Kontakte ((:Name abc :mail [E-Mail geschützt] ...) ...)

Extrakt

Verwendung der Extrakt Mit dem Befehl können wir Anhänge speichern und öffnen.
-> cmd:Aktion extrahieren: Index: [Weg: ] [Was: [Parameter: ]]

Wenn die Aktion „Speichern“ lautet, ist das Pfadargument erforderlich; der Anhang wird sein
gespeichert und eine Nachricht
<- (:info save :message „... wurde gespeichert“)
ist fühlt.

Wenn die Aktion „Öffnen“ ist, wird der Anhang anschließend in einer temporären Datei gespeichert
Es wird mit dem Standardhandler für diese Art von Datei geöffnet (siehe Mu-
Extrakt(1)) und eine Nachricht
<- (:info open :message „... wurde geöffnet“)
ist fühlt.

Wenn die Aktion „temp“ ist, sind die Argumente „what“ erforderlich. Der Anhang wird
in einer temporären Datei gespeichert und die folgende Nachricht wird gesendet:
<- (:temp :was :param
Das Front-End kann dann auf der Grundlage von „:what“ und „:param“ Maßnahmen für die temporäre Datei ergreifen
enthalten. mu4e nutzt diesen Mechanismus beispielsweise zum Weiterleiten eines Anhangs an einen Shell-Befehl.

gefunden

Verwendung der gefunden Mit dem Befehl können wir nach Nachrichten suchen.
-> cmd:find query:" " [threads:true|false] [sortfield: ]
[reverse:true|false] [maxnum: ]
Die query-parameter stellt die Suchabfrage bereit; Die Themen-Parameter bestimmt
ob die Ergebnisse im Thread-Modus zurückgegeben werden oder nicht; Die Sortierfeld-
Parameter (eine Zeichenfolge, „to“, „from“, „subject“, „date“, „size“, „prio“) legt die fest
Suchfeld, das rückgängig machen-Parameter, wenn wahr, legt die Sortierreihenfolge Z->A fest und,
Endlich, das max-Parameter begrenzt die Anzahl der zurückzugebenden Ergebnisse (<= 0 bedeutet).
'unbegrenzt').

Zunächst wird ein „erase“-sexp zurückgegeben, um den Puffer von möglichen Ergebnissen zu befreien
aus einer früheren Abfrage.
<- (:t löschen)

Dies gibt eine Reihe von 0 bis zurück S-Ausdruck, der jedem entspricht
Nachricht gefunden (wenn kein Maximum vorhanden ist, werden alle Ergebnisse zurückgegeben). Die Information
Die von dieser Funktion zurückgegebenen Nachrichten-S-Exps enthalten nicht den Nachrichtentext. Die view
Der Befehl ist dafür.
<- (...)
und schließlich erhalten wir:
<- (:gefunden )

Arglist Die Arglist Der Befehl ist für die zukünftige Verwendung reserviert.

Index

Verwendung der Index Mit dem Befehl können wir die Datenbank (neu) indizieren, ähnlich wie bei what mu gefunden
tut. Das Meine Adressen Parameter (optional) registriert „meine“ E-Mail-Adressen; sehen
die Dokumentation für mu_store_set_my_addresses.

-> cmd:indexpfad: [Meine Adressen: ]
Als Antwort sendet es (für jeweils 500 Nachrichten):
(:info index:status läuft:verarbeitet :Aktualisiert )
und schlussendlich:
(:Info-Index:Status abgeschlossen:verarbeitet
:aufgeräumt )

mkdir

Verwendung der mkdir Mit dem Befehl können wir ein neues Maildir erstellen.

-> cmd:mkdir-Pfad:
<- (:info mkdir :message " wurde erschaffen")

schlauer bewegen

Verwendung der schlauer bewegen Mit dem Befehl können wir Nachrichten in ein anderes Mailverzeichnis verschieben oder dessen Flags ändern
(was letztendlich bedeutet, dass es in einen anderen Dateinamen verschoben wird) und aktualisieren Sie die
Datenbank entsprechend. Die Funktion gibt einen S-Exp zurück, der die Aktualisierung beschreibt
Nachricht, damit sie in der Benutzeroberfläche aktualisiert werden kann.

-> cmd:move docid: |msgstr: [Mailverzeichnis: ] [Flaggen: ]
<- (:aktualisieren :bewege t)

Zur Identifizierung der Nachricht muss entweder docid oder msgid angegeben werden. Zumindest einer davon
Maildir und Flags müssen angegeben werden.

Klingeln

Die Klingeln Befehl provoziert a pong Antwort. Es wird für den ersten Handshake verwendet
zwischen mu4e und mu Server.
-> cmd:ping
<- (:pong "mu" :version :doccount )

entfernen

Verwendung der entfernen Mit dem Befehl können wir die Nachricht von der Festplatte entfernen und aktualisieren
Datenbank entsprechend.

-> cmd:docid entfernen:
<- (:entfernen )

view

Verwendung der view Mit dem Befehl können wir alle Informationen (einschließlich des Körpers) von a abrufen
bestimmte E-Mail-Nachricht.

Wenn der optionale Parameter Bilder extrahieren is was immer dies auch sein sollte., Bilder in temporäre Dateien extrahieren und
Fügen Sie Links zu ihnen in den zurückgegebenen S-Exp ein.

Wenn der optionale Parameter Verwendungsagent is was immer dies auch sein sollte., versuchen zu benutzen GPG-Agent bei der Überprüfung
PGP/GPG-Nachrichtenteile.

Wenn der optionale Parameter Auto-Retrieve-Key is was immer dies auch sein sollte., versuchen Sie, die Öffentlichkeit abzurufen
Schlüssel automatisch online.

-> cmd:docid anzeigen: |msgstr: [extract-images:true] [use-agent:false] [auto-retrieve-key:false]
<- (:ansicht )

oder alternativ:

-> cmd:Pfad anzeigen: [extract-images:true] [use-agent:false] [auto-retrieve-key:false]
<- (:ansicht )

Nutzen Sie mu-server online über die Dienste von onworks.net