mu-server - En ligne dans le Cloud

PROGRAMME:

Nom

mu_server - le backend mu pour le client de messagerie mu4e

SYNOPSIS

mu serveur [choix]

DESCRIPTION

mu serveur démarre un shell simple dans lequel on peut interroger et manipuler la base de données mu. Les
la sortie des commandes est en termes d'expressions symboliques Lisp (s-exps). mu serveur n'est pas
destiné à être utilisé par les humains ; au lieu de cela, il est conçu spécifiquement pour le mu4e Client de messagerie.

Dans cette page de manuel, nous documentons les commandes mu serveur accepte, ainsi que leurs réponses.
En général, les commandes envoyées au serveur sont de la forme

cmd : [ ]*

où chacun des paramètres est précédé de son nom et de deux points. Par exemple, pour afficher un
certain message, la commande serait :

cmd:voir document:12345

Les paramètres peuvent être envoyés dans n'importe quel ordre, et les paramètres non utilisés par une certaine commande sont
simplement ignoré.

SORTIE Format

mu serveur accepte un certain nombre de commandes, et délivre ses résultats sous la forme :

\376 \377

\376 (un octet 0xfe), suivi de la longueur de l'expression s exprimée sous forme de
nombre hexadécimal, suivi d'un autre \377 (un octet 0xff), suivi du s- réel
expression.

En préfixant l'expression avec sa longueur, elle peut être traitée plus efficacement. Les
\376 et \377 ont été choisis car ils n'apparaissent jamais dans un UTF-8 valide (dans lequel le s-
expressions sont codées).

COMMAND ET RÉPONSE

ajouter

Le ajouter commande, nous pouvons ajouter un message à la base de données.

-> cmd:ajouter le chemin : rép mail :
<- (:info add :path :docid )

composer

Le composer commande, nous obtenons le message (original) et disons quoi faire avec
ce. L'interface utilisateur est alors censée pré-traiter le message, par exemple définir le
l'objet, l'expéditeur et le destinataire d'un message de réponse.

Les messages de type 'new' n'utilisent pas le paramètre docid:, les autres le font.

-> cmd:type de composition : [docid: ]
<- (:composer :original :comprendre (

Les est une expression s décrivant les pièces jointes à inclure
dans le message ; cela ne s'applique actuellement qu'aux messages que nous transférons. Ce s-
l'expression ressemble à :

(:nom de fichier :type mime :disposition )

Contacts

Le composer commande, nous pouvons récupérer une s-expression avec tous les contacts connus
(nom + adresse e-mail). Pour les détails, voir mu-ctrouver(1).

-> cmd:contacts [personnel:vrai|faux] [après : ]
<- (:contacts ((:name abc :mail [email protected] ...) ...)

extrait

Le extrait commande, nous pouvons enregistrer et ouvrir les pièces jointes.
-> cmd:action d'extraction : indice: [chemin: ] [Quel: [paramètre : ]]

Si l'action est 'sauvegarder', l'argument path est requis ; la pièce jointe sera
enregistré et un message
<- (:info save :message "... a été enregistré")
est envoyé.

Si l'action est « ouvrir », la pièce jointe sera enregistrée dans un fichier temporaire, après quoi
il sera ouvert avec le gestionnaire par défaut pour ce type de fichier (voir mu
extrait(1)) et un message
<- (:info open :message "... a été ouvert")
est envoyé.

Si l'action est 'temp', les arguments 'what' sont requis. La pièce jointe sera
enregistré dans un fichier temporaire, et le message suivant est envoyé :
<- (:temp :quoi :param
Le front-end peut alors prendre des mesures sur le fichier temporaire, en fonction de :what et :param
contenir. mu4e utilise ce mécanisme, par exemple pour rediriger une pièce jointe vers une commande shell.

trouver

Le trouver commande, nous pouvons rechercher des messages.
-> cmd:requête de recherche :" " [threads:true|false] [champ de tri : ]
[inverse:vrai|faux] [maxnum: ]
Le question-parameter fournit la requête de recherche ; les discussions-paramètre détermine
si les résultats seront retournés en mode thread ou non ; les champ de tri-
paramètre (une chaîne, "à", "de", "sujet", "date", "taille", "prio") définit le
champ de recherche, le inverser-parameter, si vrai, définit l'ordre de tri Z->A et,
Finalement, le num max-parameter limite le nombre de résultats à renvoyer (<= 0 signifie
'illimité').

Tout d'abord, cela renverra un 'effacement'-sexp, pour effacer le tampon des résultats possibles
d'une requête précédente.
<- (:effacer t)

Cela renverra une série de 0 jusqu'à s-expression correspondant à chaque
message trouvé (s'il n'y a pas de maxnum, tous les résultats seront renvoyés). L'information
le message s-exps que cette fonction renvoie ne contient pas le corps du message ; les vue
la commande est pour ça.
<- (...)
et enfin, nous recevons :
<- (:trouvé )

ruse Le ruse commande est réservée pour une utilisation future.

indice

Le indice commande, on peut (ré)indexer la base de données, comme quoi mu trouver
Est-ce que. le Mes adresses le paramètre (éventuellement) enregistre 'mes' adresses e-mail ; voir
la documentation pour mu_store_set_my_addresses.

-> cmd:chemin d'index : [Mes adresses: ]
En réponse, il enverra (pour chaque 500 messages) :
(:info index :état en cours d'exécution :traité :mis à jour )
et enfin:
(:info index :statut terminé :traité
:nettoyé )

mkdir

Le mkdir commande, nous pouvons créer un nouveau maildir.

-> cmd:mkdir chemin :
<- (:info mkdir :message " a été créé")

Bougez

Le Bougez commande, nous pouvons déplacer les messages vers un autre maildir ou changer ses indicateurs
(ce qui signifie en fin de compte qu'il est déplacé vers un nom de fichier différent), et mettez à jour le
base de données en conséquence. La fonction renvoie une s-exp décrivant la mise à jour
message, afin qu'il puisse être mis à jour dans l'interface utilisateur.

-> cmd:déplacer docid : |msgstr : [rép.mail : ] [drapeaux : ]
<- (:mise à jour : déplacez t)

L'un des éléments docid et msgid doit être spécifié pour identifier le message. Au moins un des
maildir et flags doivent être spécifiés.

ping

Le ping commande provoque un pong réponse. Il est utilisé pour la poignée de main initiale
jusqu'à XNUMX fois mu4e et mu serveur.
-> cmd:ping
<- (:pong "mu" :version :doccompte )

supprimez

Le supprimez commande, nous pouvons supprimer le message du disque et mettre à jour le
base de données en conséquence.

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

vue

Le vue commande, nous pouvons récupérer toutes les informations (y compris le corps) d'un
message électronique particulier.

Si le paramètre facultatif extrait-images is oui, extraire les images dans des fichiers temporaires et
inclure des liens vers eux dans le s-exp renvoyé.

Si le paramètre facultatif utiliser-agent is oui, Essayez d'utiliser agent-gpg lors de la vérification
Parties de message PGP/GPG.

Si le paramètre facultatif clé de récupération automatique is oui, tente de récupérer le public
clés en ligne automatiquement.

-> cmd:voir document : |msgstr : [extract-images:true] [use-agent:false] [auto-retrieve-key:false]
<- (:vue )

Ou bien:

-> cmd:voir chemin : [extract-images:true] [use-agent:false] [auto-retrieve-key:false]
<- (:vue )

Utiliser mu-server en ligne à l'aide des services onworks.net