Ce document est une spécification du protocole Relay de WeeChat : le protocole utilisé pour relayer les données de WeeChat aux clients, qui sont surtout des interfaces distantes.
1. Introduction
1.1. Terminologie
Les termes suivants sont utilisés dans ce document :
-
relay : il s’agit de l’extension "relay" de WeeChat, qui agit comme un "serveur" et autorise les clients à se connecter
-
client : il s’agit d’un autre logiciel, connecté au relay via une connexion réseau; dans la plupart des cas, ce client est une interface distante.
1.2. Diagramme réseau
Les clients sont connectés au relay comme dans le diagramme ci-dessous :
┌──────────┐ Station de travail ┌────────┐ ┌───┤ client 1 │ (Linux, Windows, │ irc │◄──┐ ╔═══════════╤═══════╗ │ └──────────┘ BSD, Mac OS X ...) └────────┘ └──╢ │ ║◄───┘ ┌──────────┐ ...... ║ WeeChat │ Relay ║◄───────┤ client 2 │ Appareil mobile ┌────────┐ ┌──╢ │ ║◄───┐ └──────────┘ (Android, iPhone ...) │ jabber │◄──┘ ╚═══════════╧═══════╝ │ ...... └────────┘ │ ┌──────────┐ ...... └───┤ client N │ Autres appareils └──────────┘ └────────────┘ └───────────────────┘╘══════╛└────────────────────────────────┘ serveurs interface ncurses protocole interfaces distantes relay
Tous les clients ici utilisent le protocole weechat dans l’extension relay. L’extension relay autorise aussi des clients IRC, et relay agit alors comme un proxy IRC (non décrit dans ce document). |
2. Généralités sur le protocole
-
Les connexions du client vers relay sont faites avec des sockets TCP sur l’IP/port utilisé par relay pour écouter les nouvelles connexions.
-
Le nombre de clients est limité par l’option relay.network.max_clients.
-
Chaque client est indépendant des autres clients.
-
Les messages du client vers relay sont appelés commandes, elles sont envoyées sous forme de texte (une chaîne de caractères).
-
Les messages de relay vers le client sont appelés des messages, ils sont envoyés sous forme de données binaires.
3. Commandes (client → relay)
Les commandes ont le format :
(id) commande paramètres\n
Les champs sont :
-
id : identifiant du message (facultatif) qui sera envoyée dans la réponse de relay; elle doit être entre parenthèses, et ne doit pas commencer par un underscore (les identifiants commençant par un underscore sont réservés pour les messages évènements de WeeChat)
-
commande : une commande (voir le tableau ci-dessous)
-
paramètres : paramètres facultatifs pour la commande (plusieurs paramètres sont séparés par des espaces).
Liste des commandes disponibles (détail dans les chapitres suivants) :
Commande | Description |
---|---|
|
Initialiser la connexion avec relay. |
|
Demander un hdata. |
|
Demander une info. |
|
Demander une infolist. |
|
Demander une nicklist (liste de pseudos). |
|
Envoyer des données à un tampon (texte ou commande). |
|
Synchroniser un/des tampon(s) : recevoir les mises à jour pour le(s) tampon(s). |
|
Désynchroniser un/des tampon(s) : stopper les mises à jour pour le(s) tampon(s). |
|
Se déconnecter de relay. |
3.1. init
Initialiser la connexion avec relay. Il doit s’agir de la première commande envoyée à relay. Si elle n’est pas envoyée, relay coupera la connexion à la première commande reçue, sans avertissement.
Syntaxe :
init [<option>=<valeur>,[<option>=<valeur>,...]]
Paramètres :
-
option : une des options suivantes :
-
password : mot de passe utilisé pour s’authentifier avec relay (option relay.network.password dans WeeChat)
-
compression : type de compression :
-
zlib : activer la compression zlib pour les messages envoyés par relay (activée par défaut si relay supporte la compression zlib)
-
off : désactiver la compression
-
-
Avec WeeChat ≥ 1.6, les virgules peuvent être échappées dans la valeur,
par exemple init password=foo\,bar pour envoyer le mot de passe "foo,bar".
|
Exemples :
# initialiser et utiliser la compression zlib par défaut (si WeeChat la supporte) init password=mypass # initialiser avec des virgules dans le mot de passe (WeeChat ≥ 1.6) init password=mypass\,avec\,virgules # initialiser et désactiver la compression init password=mypass,compression=off
3.2. hdata
Demander un hdata.
Syntaxe :
(id) hdata <chemin> [<clés>]
Paramètres :
-
chemin : chemin vers le hdata, avec le format : "hdata:pointeur/var/var/…/var", la dernière variable est le hdata retourné :
-
hdata : nom du hdata
-
pointeur : pointeur ("0x12345") ou nom de liste (par exemple : "gui_buffers") (nombre autorisé, voir ci-dessous)
-
var : un nom de variable dans le hdata parent (nom précédent dans le chemin) (nombre autorisé, voir ci-dessous)
-
-
clés : liste de clés (séparées par des virgules) à retourner dans le hdata (si non spécifié, toutes les clés sont retournées, ce qui n’est pas recommandé avec les grosses structures hdata)
Un nombre est autorisé après le pointeur et les variables, avec le format "(N)". Les valeurs possibles sont :
-
nombre positif : itérer en utilisant l’élément suivant, N fois
-
nombre négatif : itérer en utilisant l’élément précédent, N fois
-
* : itérer en utilisant l’élément suivant, jusqu’à la fin de la liste
Avec WeeChat ≥ 1.6, si le chemin vers le hdata est invalide ou si un pointeur
NULL est trouvé, un hdata vide est retourné (voir l’exemple dans
l’objet hdata). Avec des versions plus anciennes, rien n’était retourné. |
Exemples :
# demander tous les tampons, un hdata de type "buffer" est retourné # les clés "number" et "name" sont retournées pour chaque tampon hdata buffer:gui_buffers(*) number,name # demander toutes les lignes de tous les tampons, un hdata de type "line_data" # est retourné # toutes les clés sont retournées hdata buffer:gui_buffers(*)/lines/first_line(*)/data # demander le nom complet du premier tampon hdata buffer:gui_buffers full_name # demander le contenu de la hotlist hdata hotlist:gui_hotlist(*)
3.3. info
Demander une info.
Syntaxe :
(id) info <nom> [<paramètres>]
Paramètres :
-
nom : nom de l’info à obtenir
-
paramètres : paramètres pour l’info (facultatif)
Exemple :
info version
3.4. infolist
Demander une infolist.
Le contenu de l’infolist est une duplication des données. Dans la mesure du possible, utilisez plutôt la commande hdata, qui est un accès direct aux données (cela est plus rapide, utilise moins de mémoire et retourne des objets plus petits dans le message). |
Syntaxe :
(id) infolist <nom> [<pointeur> [<paramètres>]]
Paramètres :
-
nom : nom de l’infolist à obtenir
-
pointeur : pointeur (facultatif)
-
paramètres : paramètres (facultatif)
Exemple :
infolist buffer
3.5. nicklist
Demander une nicklist (liste de pseudos), pour un ou tous les tampons.
Syntaxe :
(id) nicklist [<tampon>]
Paramètres :
-
tampon : pointeur (0x12345) ou nom complet du tampon (par exemple : core.weechat ou irc.freenode.#weechat)
Exemples :
# demander la liste de pseudos pour tous les tampons nicklist # demander la liste de pseudos pour irc.freenode.#weechat nicklist irc.freenode.#weechat
3.6. input
Envoyer des données à un tampon.
Syntaxe :
input <tampon> <données>
Paramètres :
-
tampon : pointeur (0x12345) ou nom complet du tampon (par exemple : core.weechat ou irc.freenode.#weechat)
-
données : données à envoyer au tampon : si elles commencent par
/
, cela sera exécuté comme une commande sur le tampon, sinon le texte est envoyé comme entrée sur le tampon
Exemples :
input core.weechat /help filter input irc.freenode.#weechat bonjour !
3.7. sync
Mis à jour dans la version 0.4.1.
Synchroniser un ou plusieurs tampons, pour obtenir les mises à jour.
Il est recommandé d’utiliser cette commande immédiatement après avoir demandé les données des tampons (lignes, …). Elle peut être envoyée dans le même message (après un caractère de nouvelle ligne : "\n"). |
Syntaxe :
sync [<tampon>[,<tampon>...] <option>[,<option>...]]
Paramètres :
-
tampon : pointeur (0x12345) ou nom complet du tampon (par exemple : core.weechat ou irc.freenode.#weechat); le nom "*" peut être utilisé pour spécifier tous les tampons
-
options : un ou plusieurs mots-clés, séparés par des virgules (par défaut buffers,upgrade,buffer,nicklist pour "*" et buffer,nicklist pour un tampon) :
-
buffers : recevoir les signaux à propos des tampons (ouverts/fermés, déplacés, renommés, mélangés, masqués/démasqués); peut être utilisé seulement avec "*" (WeeChat ≥ 0.4.1)
-
upgrade : recevoir les signaux à propos de la mise à jour de WeeChat (mise à jour, fin de mise à jour); peut être utilisé seulement avec "*" (WeeChat ≥ 0.4.1)
-
buffer : recevoir les signaux à propos du tampon (nouvelles lignes, type changé, titre changé, variable locale ajoutée/supprimée, et les même signaux que buffers pour le tampon) (mis à jour dans la version 0.4.1)
-
nicklist : recevoir la liste de pseudos après des changements
-
Exemples :
# synchroniser tous les tampons avec la liste de pseudos # (les 3 commandes sont équivalentes, mais la première est recommandée pour une # compatibilité avec les futures versions) sync sync * sync * buffers,upgrade,buffer,nicklist # synchroniser le tampon "core" sync core.buffer # synchroniser le canal #weechat, sans la liste de pseudos sync irc.freenode.#weechat buffer # obtenir les signaux généraux + tous les signaux pour le canal #weechat sync * buffers,upgrade sync irc.freenode.#weechat
3.8. desync
Mis à jour dans la version 0.4.1.
Désynchroniser un ou plusieurs tampons, pour stopper les mises à jour.
Ceci retirera les options pour les tampons. Si des options sont toujours actives pour les tampons, le client recevra toujours les mises à jour pour ces tampons. |
Syntaxe :
desync [<tampon>[,<tampon>...] <option>[,<option>...]]
Paramètres :
-
tampon : pointeur (0x12345) ou nom complet du tampon (par exemple : core.weechat ou irc.freenode.#weechat); le nom "*" peut être utilisé pour spécifier tous les tampons
-
options : un ou plusieurs mots-clés, séparés par des virgules (le défaut est buffers,upgrade,buffer,nicklist pour "*" et buffer,nicklist pour un tampon); voir la commande sync pour les valeurs
En utilisant le tampon "*", les autres tampons synchronisés (en utilisant un
nom) sont gardés. Donc si vous envoyez : "sync *", puis "sync irc.freenode.#weechat", puis "desync *", les mises à jour sur le canal #weechat seront toujours envoyées par WeeChat (vous devez le retirer explicitement pour stopper les mises à jour). |
Exemples :
# désynchroniser tous les tampons # (les 3 commandes sont équivalentes, mais la première est recommandée pour une # compatibilité avec les futures versions) desync desync * desync * buffers,upgrade,buffer,nicklist # désynchroniser la liste de pseudos pour le canal #weechat # (garder les mises à jour du tampon) desync irc.freenode.#weechat nicklist # désynchroniser le canal #weechat desync irc.freenode.#weechat
3.9. test
Commande de test : WeeChat répondra avec différents objets.
Cette commande est utile pour tester le décodage d’objets binaires retournés par WeeChat.
Vous ne devez pas utiliser les pointeurs retournés par cette commande, ils ne sont pas valides. Cette commande doit être utilisée seulement pour tester le décodage d’un message envoyé par WeeChat. |
Syntaxe :
test
Exemple :
test
Objets retournés (dans cet ordre) :
Type | Type (dans le message) | Valeur |
---|---|---|
caractère |
|
|
entier |
|
|
entier |
|
|
long |
|
|
long |
|
|
chaîne |
|
|
chaîne |
|
|
chaîne |
|
|
tampon de données |
|
|
tampon de données |
|
|
pointeur |
|
|
pointeur |
|
|
date/heure |
|
|
tableau de chaînes |
|
|
tableau d’entiers |
|
|
4. Messages (relay → client)
Les messages sont envoyés sous forme de données binaires, en utilisant le format suivant (avec la taille en octets) :
┌────────╥─────────────╥─────────╥────────┬─────────╥───────╥────────┬─────────┐ │ taille ║ compression ║ id ║ type 1 │ objet 1 ║ ... ║ type N │ objet N │ └────────╨─────────────╨─────────╨────────┴─────────╨───────╨────────┴─────────┘ └──────┘ └───────────┘ └───────┘ └──────┘ └───────┘ └──────┘ └───────┘ 4 1 4 + str 3 ?? 3 ?? └────────────────────┘ └─────────────────────────────────────────────────────┘ en-tête (5) données compressées (??) └────────────────────────────────────────────────────────────────────────────┘ 'taille' octets
-
taille (entier non signé, 4 octets) : nombre d’octets du message entier (en incluant ce champ)
-
compression (octet) : drapeau :
-
0x00 : les données qui suivent ne sont pas compressées
-
0x01 : les données qui suivent sont compressées avec zlib
-
-
id (chaîne, 4 octets + contenu) : l’identifiant envoyé par le client (avant le nom de la commande); il peut être vide (chaîne avec une longueur de zéro sans contenu) si l’identifiant n’était pas donné dans la commande
-
type (3 caractères) : un type : 3 lettres (voir le tableau ci-dessous)
-
objet : un objet (voir tableau ci-dessous)
4.1. Compression
Si le drapeau de compression est égal à 0x01, alors toutes les données après sont compressées avec zlib, et par conséquent doivent être décompressées avant d’être utilisées.
4.2. Identifiant
Il y a deux types d’identifiants (id) :
-
id envoyé par le client : relay répondra avec le même id dans sa réponse
-
id d’un évènement : pour certains évènements, relay enverra un message au client en utilisant un id spécifique, commençant par underscore (voir le tableau ci-dessous)
Les identifiants réservés par WeeChat :
Identifiant | Reçu avec sync | Données envoyées | Description | Action recommandée dans le client |
---|---|---|---|---|
|
buffers / buffer |
hdata : buffer |
Tampon ouvert. |
Ouvrir le tampon. |
|
buffers / buffer |
hdata : buffer |
Type de tampon changé. |
Changer le type de tampon. |
|
buffers / buffer |
hdata : buffer |
Tampon déplacé. |
Déplacer le tampon. |
|
buffers / buffer |
hdata : buffer |
Tampon mélangé. |
Mélanger le tampon. |
|
buffers / buffer |
hdata : buffer |
Tampon sorti du mélange. |
Sortir le tampon du mélange. |
|
buffers / buffer |
hdata : buffer |
Tampon masqué. |
Masquer le le tampon. |
|
buffers / buffer |
hdata : buffer |
Tampon démasqué. |
Démasquer le tampon. |
|
buffers / buffer |
hdata : buffer |
Tampon renommé. |
Renommer le tampon. |
|
buffers / buffer |
hdata : buffer |
Titre du tampon changé. |
Changer le titre du tampon. |
|
buffers / buffer |
hdata : buffer |
Variable locale ajoutée. |
Ajouter la variable locale dans le tampon. |
|
buffers / buffer |
hdata : buffer |
Variable locale changée. |
Changer la variable locale dans le tampon. |
|
buffers / buffer |
hdata : buffer |
Variable locale supprimée. |
Supprimer la variable locale du tampon. |
|
buffers / buffer |
hdata : buffer |
Tampon qui se ferme. |
Fermer le tampon. |
|
buffer |
hdata : buffer |
Tampon qui est vidé. |
Vider le tampon. |
|
buffer |
hdata : line |
Ligne ajoutée dans le tampon. |
Afficher la ligne dans le tampon. |
|
nicklist |
hdata : nicklist_item |
Liste de pseudos pour un tampon. |
Remplacer la liste de pseudos. |
|
nicklist |
hdata : nicklist_item |
Différence de liste de pseudos pour un tampon . |
Mettre à jour la liste de pseudos. |
|
(always) |
chaîne : paramètres du ping |
Réponse à un "ping". |
Mesurer le temps de réponse. |
|
upgrade |
(vide) |
WeeChat se met à jour. |
Se désynchroniser de WeeChat (ou quitter). |
|
upgrade |
(vide) |
WeeChat a été mis à jour. |
(Re)synchroniser avec WeeChat. |
4.2.1. _buffer_opened
Ce message est envoyé au client lorsque le signal "buffer_opened" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
chaîne |
Nom court (exemple : #weechat). |
|
entier |
1 si le tampon a une liste de pseudos, sinon 0. |
|
chaîne |
Titre du tampon. |
|
table de hachage |
Variables locales. |
|
pointeur |
Pointeur vers le tampon précédent. |
|
pointeur |
Pointeur vers le tampon suivant. |
Exemple : canal #weechat rejoint sur freenode, nouveau tampon irc.freenode.#weechat :
id: '_buffer_opened'
hda:
keys: {'number': 'int', 'full_name': 'str', 'short_name': 'str', 'nicklist': 'int',
'title': 'str', 'local_variables': 'htb', 'prev_buffer': 'ptr', 'next_buffer': 'ptr'}
path: ['buffer']
item 1:
__path: ['0x35a8a60']
number: 3
full_name: 'irc.freenode.#weechat'
short_name: None
nicklist: 0
title: None
local_variables: {'plugin': 'irc', 'name': 'freenode.#weechat'}
prev_buffer: '0x34e7400'
next_buffer: '0x0'
4.2.2. _buffer_moved
Ce message est envoyé au client lorsque le signal "buffer_moved" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
pointeur |
Pointeur vers le tampon précédent. |
|
pointeur |
Pointeur vers le tampon suivant. |
Exemple : tampon irc.freenode.#weechat déplacé vers le numéro 2 :
id: '_buffer_moved'
hda:
keys: {'number': 'int', 'full_name': 'str', 'prev_buffer': 'ptr', 'next_buffer': 'ptr'}
path: ['buffer']
item 1:
__path: ['0x34588c0']
number: 2
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x347b9f0'
next_buffer: '0x3471bc0'
4.2.3. _buffer_merged
Ce message est envoyé au client lorsque le signal "buffer_merged" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
pointeur |
Pointeur vers le tampon précédent. |
|
pointeur |
Pointeur vers le tampon suivant. |
Exemple : tampon irc.freenode.#weechat mélangé avec le tampon n°2 :
id: '_buffer_merged'
hda:
keys: {'number': 'int', 'full_name': 'str', 'prev_buffer': 'ptr', 'next_buffer': 'ptr'}
path: ['buffer']
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
4.2.4. _buffer_unmerged
Ce message est envoyé au client lorsque le signal "buffer_unmerged" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
pointeur |
Pointeur vers le tampon précédent. |
|
pointeur |
Pointeur vers le tampon suivant. |
Exemple : tampon irc.freenode.#weechat sorti du mélange :
id: '_buffer_unmerged'
hda:
keys: {'number': 'int', 'full_name': 'str', 'prev_buffer': 'ptr', 'next_buffer': 'ptr'}
path: ['buffer']
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
4.2.5. _buffer_hidden
WeeChat ≥ 1.0.
Ce message est envoyé au client lorsque le signal "buffer_hidden" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
pointeur |
Pointeur vers le tampon précédent. |
|
pointeur |
Pointeur vers le tampon suivant. |
Exemple : tampon irc.freenode.#weechat masqué :
id: '_buffer_hidden'
hda:
keys: {'number': 'int', 'full_name': 'str', 'prev_buffer': 'ptr', 'next_buffer': 'ptr'}
path: ['buffer']
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
4.2.6. _buffer_unhidden
WeeChat ≥ 1.0.
Ce message est envoyé au client lorsque le signal "buffer_unhidden" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
pointeur |
Pointeur vers le tampon précédent. |
|
pointeur |
Pointeur vers le tampon suivant. |
Exemple : tampon irc.freenode.#weechat démasqué :
id: '_buffer_unhidden'
hda:
keys: {'number': 'int', 'full_name': 'str', 'prev_buffer': 'ptr', 'next_buffer': 'ptr'}
path: ['buffer']
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
4.2.7. _buffer_renamed
Ce message est envoyé au client lorsque le signal "buffer_renamed" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
chaîne |
Nom court (exemple : #weechat). |
|
table de hachage |
Variables locales. |
Exemple : tampon privé renommé de FlashCode en Flash2 :
id: '_buffer_renamed'
hda:
keys: {'number': 'int', 'full_name': 'str', 'short_name': 'str', 'local_variables': 'htb'}
path: ['buffer']
item 1:
__path: ['0x4df7b80']
number: 5
full_name: 'irc.freenode.Flash2'
short_name: 'Flash2'
local_variables: {'server': 'freenode', 'plugin': 'irc', 'type': 'private',
'channel': 'FlashCode', 'nick': 'test', 'name': 'local.Flash2'}
4.2.8. _buffer_title_changed
Ce message est envoyé au client lorsque le signal "buffer_title_changed" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
chaîne |
Titre du tampon. |
Exemple : titre changé sur le canal #weechat :
id: '_buffer_title_changed'
hda:
keys: {'number': 'int', 'full_name': 'str', 'title': 'str'}
path: ['buffer']
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
title: 'Welcome on #weechat! https://weechat.org/'
4.2.9. _buffer_cleared
WeeChat ≥ 1.0.
Ce message est envoyé au client lorsque le signal "buffer_cleared" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
Exemple : tampon irc.freenode.#weechat vidé :
id: '_buffer_cleared'
hda:
keys: {'number': 'int', 'full_name': 'str'}
path: ['buffer']
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
4.2.10. _buffer_type_changed
Ce message est envoyé au client lorsque le signal "buffer_type_changed" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
entier |
Type de tampon : 0 = formaté (par défaut), 1 = contenu libre. |
Exemple : type de tampon script.scripts changé de formaté (0) à contenu libre (1) :
id: '_buffer_type_changed'
hda:
keys: {'number': 'int', 'full_name': 'str', 'type': 'int'}
path: ['buffer']
item 1:
__path: ['0x27c9a70']
number: 4
full_name: 'script.scripts'
type: 1
4.2.11. _buffer_localvar_added
Ce message est envoyé au client lorsque le signal "buffer_localvar_added" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
table de hachage |
Variables locales. |
Exemple : variable locale test ajoutée dans le tampon irc.freenode.#weechat :
id='_buffer_localvar_added', objects:
hda:
keys: {'number': 'int', 'full_name': 'str', 'local_variables': 'htb'}
path: ['buffer']
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
local_variables: {'server': 'freenode', 'test': 'value', 'plugin': 'irc',
'type': 'channel', 'channel': '#weechat', 'nick': 'test',
'name': 'freenode.#weechat'}
4.2.12. _buffer_localvar_changed
Ce message est envoyé au client lorsque le signal "buffer_localvar_changed" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
table de hachage |
Variables locales. |
Exemple : variable locale test mise à jour dans le tampon irc.freenode.#weechat :
id='_buffer_localvar_changed', objects:
hda:
keys: {'number': 'int', 'full_name': 'str', 'local_variables': 'htb'}
path: ['buffer']
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
local_variables: {'server': 'local', 'test': 'value2', 'plugin': 'irc',
'type': 'channel', 'channel': '#weechat', 'nick': 'test',
'name': 'freenode.#weechat'}
4.2.13. _buffer_localvar_removed
Ce message est envoyé au client lorsque le signal "buffer_localvar_removed" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
|
table de hachage |
Variables locales. |
Exemple : variable locale test supprimée du tampon irc.freenode.#weechat :
id: '_buffer_localvar_removed'
hda:
keys: {'number': 'int', 'full_name': 'str', 'local_variables': 'htb'}
path: ['buffer']
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#prout'
local_variables: {'server': 'local', 'plugin': 'irc', 'type': 'channel',
'channel': '#weechat', 'nick': 'test', 'name': 'freenode.#weechat'}
4.2.14. _buffer_line_added
Ce message est envoyé au client lorsque le signal "buffer_line_added" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
pointeur |
Pointeur vers le tampon. |
|
date/heure |
Date du message. |
|
date/heure |
Date d’affichage du message. |
|
caractère |
1 si le message est affiché, 0 si le message est filtré (caché). |
|
caractère |
1 si la ligne a un highlight, sinon 0. |
|
tableau de chaînes |
Liste des étiquettes de la ligne. |
|
chaîne |
Préfixe. |
|
chaîne |
Message. |
Exemple : nouveau message hello! du pseudo FlashCode sur le tampon irc.freenode.#weechat :
id: '_buffer_line_added'
hda:
keys: {'buffer': 'ptr', 'date': 'tim', 'date_printed': 'tim', 'displayed': 'chr',
'highlight': 'chr', 'tags_array': 'arr', 'prefix': 'str', 'message': 'str'}
path: ['line_data']
item 1:
__path: ['0x4a49600']
buffer: '0x4a715d0'
date: 1362728993
date_printed: 1362728993
displayed: 1
highlight: 0
tags_array: ['irc_privmsg', 'notify_message', 'prefix_nick_142', 'nick_FlashCode', 'log1']
prefix: 'F06@F@00142FlashCode'
message: 'hello!'
4.2.15. _buffer_closing
Ce message est envoyé au client lorsque le signal "buffer_closing" est envoyé par WeeChat.
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
entier |
Numéro de tampon (≥ 1). |
|
chaîne |
Nom complet (exemple : irc.freenode.#weechat). |
Exemple : tampon irc.freenode.#weechat en cours de fermeture par WeeChat :
id: '_buffer_closing'
hda:
keys: {'number': 'int', 'full_name': 'str'}
path: ['buffer']
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
4.2.16. _nicklist
Ce message est envoyé au client lorsque de grosses mises à jour sont effectuées sur la liste de pseudos (groupes/pseudos ajoutés/supprimés/changés). Le message contient la liste complète des pseudos.
Lorsque de petites mises à jour sont faites sur la liste de pseudos (par exemple l’ajout d’un seul pseudo), un autre message avec l’identifiant _nicklist_diff est envoyé (voir ci-dessous).
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
caractère |
1 pour un groupe, 0 pour un pseudo. |
|
caractère |
1 si le groupe/pseudo est affiché, sinon 0. |
|
entier |
Niveau du groupe (0 pour un pseudo). |
|
chaîne |
Nom du groupe/pseudo. |
|
chaîne |
Couleur du nom. |
|
chaîne |
Préfixe (seulement pour un pseudo). |
|
chaîne |
Couleur du préfixe (seulement pour un pseudo). |
Exemple : liste de pseudos pour le tampon irc.freenode.#weechat :
id: '_nicklist'
hda:
keys: {'group': 'chr', 'visible': 'chr', 'level': 'int', 'name': 'str', 'color': 'str',
'prefix': 'str', 'prefix_color': 'str'}
path: ['buffer', 'nicklist_item']
item 1:
__path: ['0x4a75cd0', '0x31e95d0']
group: 1
visible: 0
level: 0
name: 'root'
color: None
prefix: None
prefix_color: None
item 2:
__path: ['0x4a75cd0', '0x41247b0']
group: 1
visible: 1
level: 1
name: '000|o'
color: 'weechat.color.nicklist_group'
prefix: None
prefix_color: None
item 3:
__path: ['0x4a75cd0', '0x4a60d20']
group: 0
visible: 1
level: 0
name: 'FlashCode'
color: '142'
prefix: '@'
prefix_color: 'lightgreen'
item 4:
__path: ['0x4a75cd0', '0x4aafaf0']
group: 1
visible: 1
level: 1
name: '001|v'
color: 'weechat.color.nicklist_group'
prefix: None
prefix_color: None
item 5:
__path: ['0x4a75cd0', '0x4a48d80']
group: 1
visible: 1
level: 1
name: '999|...'
color: 'weechat.color.nicklist_group'
prefix: None
prefix_color: None
item 6:
__path: ['0x4a75cd0', '0x4a5f560']
group: 0
visible: 1
level: 0
name: 'test'
color: 'weechat.color.chat_nick_self'
prefix: ' '
prefix_color: ''
4.2.17. _nicklist_diff
WeeChat ≥ 0.4.1.
Ce message est envoyé au client lorsque de petites mises à jour sont effectuées sur la liste de pseudos (groupes/pseudos ajoutés/supprimés/changés). Le message contient les différences de la liste de pseudos (entre l’ancienne liste de pseudos et la nouvelle).
Données envoyées dans le hdata :
Nom | Type | Description |
---|---|---|
|
caractère |
Type de différence (voir ci-dessous). |
|
caractère |
1 pour un groupe, 0 pour un pseudo. |
|
caractère |
1 si le groupe/pseudo est affiché, sinon 0. |
|
entier |
Niveau du groupe (0 pour un pseudo). |
|
chaîne |
Nom du groupe/pseudo. |
|
chaîne |
Couleur du nom. |
|
chaîne |
Préfixe (seulement pour un pseudo). |
|
chaîne |
Couleur du préfixe (seulement pour un pseudo). |
La valeur de _diff peut être :
-
^
: le groupe parent : le(s) groupe(s)/pseudo(s) après celui-ci sont liés à ce groupe -
+
: groupe/pseudo ajouté dans le groupe parent -
-
: groupe/pseudo supprimé du groupe parent -
*
: groupe/pseudo mis à jour dans le groupe parent
Exemple : pseudo master ajouté dans le groupe 000|o (opérateurs de canel sur un canal IRC), pseudos nick1 et nick2 ajoutés dans le groupe 999|… (utilisateurs standard sur un canal IRC) :
id: '_nicklist_diff'
hda:
keys: {'_diff': 'chr', 'group': 'chr', 'visible': 'chr', 'level': 'int', 'name': 'str',
'color': 'str', 'prefix': 'str', 'prefix_color': 'str'}
path: ['buffer', 'nicklist_item']
item 1:
__path: ['0x46f2ee0', '0x343c9b0']
_diff: 94 ('^')
group: 1
visible: 1
level: 1
name: '000|o'
color: 'weechat.color.nicklist_group'
prefix: None
prefix_color: None
item 2:
__path: ['0x46f2ee0', '0x47e7f60']
_diff: 43 ('+')
group: 0
visible: 1
level: 0
name: 'master'
color: 'magenta'
prefix: '@'
prefix_color: 'lightgreen'
item 3:
__path: ['0x46f2ee0', '0x46b8e70']
_diff: 94 ('^')
group: 1
visible: 1
level: 1
name: '999|...'
color: 'weechat.color.nicklist_group'
prefix: None
prefix_color: None
item 4:
__path: ['0x46f2ee0', '0x3dba240']
_diff: 43 ('+')
group: 0
visible: 1
level: 0
name: 'nick1'
color: 'green'
prefix: ' '
prefix_color: ''
item 5:
__path: ['0x46f2ee0', '0x3c379d0']
_diff: 43 ('+')
group: 0
visible: 1
level: 0
name: 'nick2'
color: 'lightblue'
prefix: ' '
prefix_color: ''
4.2.18. _pong
WeeChat ≥ 0.4.2.
Ce message est envoyé au client lorsque relay reçoit un message "ping".
Données envoyées dans la chaîne : paramètres reçus dans le message "ping".
L’action recommandée dans le client est de mesurer le temps dé réponse et se déconnecter si le temps est très long.
4.2.19. _upgrade
WeeChat ≥ 0.3.8.
Ce message est envoyé au client lorsque WeeChat commence sa mise à jour.
Il n’y a pas de données dans le message.
L’action recommandée dans le client est de se désynchroniser de WeeChat (envoi de la commande desync), ou de se déconnecter de WeeChat (car après la mise à jour, tous les pointeurs changeront).
Pendant la mise à jour de WeeChat, le socket reste ouvert (sauf si la connexion utilise SSL). |
4.3. Objets
Les objets sont identifiés par 3 lettres, appelées type. Les types suivants sont utilisés :
Type | Valeur | Longueur |
---|---|---|
|
Caractère signé |
1 octet |
|
Entier signé |
4 octets |
|
Entier long signé |
1 octet + longueur de l’entier sous forme de chaîne |
|
Chaîne |
4 octets + longueur de la chaîne (sans le \0 final) |
|
Tampon d’octets |
4 octets + longueur des données |
|
Pointeur |
1 octet + longueur du pointeur sous forme de chaîne |
|
Date/heure |
1 octet + longueur de la date/heure sous forme de chaîne |
|
Table de hachage |
Variable |
|
Contenu du hdata |
Variable |
|
Info : nom + contenu |
Variable |
|
Contenu de l’infolist |
Variable |
|
Tableau d’objets |
3 octets (type) + nombre d’objets + données |
4.3.1. Caractère
Un caractère signé est un octet.
Exemple :
┌────┐ │ 41 │ ────► 65 (0x41: "A") └────┘
4.3.2. Entier
Un entier signé est stocké sur 4 octets, encodé au format "big-endian" (octet le plus significatif en premier).
Intervalle : -2147483648 à 2147483647.
Exemples :
┌────┬────┬────┬────┐ │ 00 │ 01 │ E2 │ 40 │ ────► 123456 └────┴────┴────┴────┘ ┌────┬────┬────┬────┐ │ FF │ FE │ 1D │ C0 │ ────► -123456 └────┴────┴────┴────┘
4.3.3. Entier long
Un entier long signé est encodé sous forme de chaîne de caractères, avec la longueur sur un octet.
Intervalle : -9223372036854775808 à 9223372036854775807.
Exemples :
┌────╥────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐ │ 0A ║ 31 │ 32 │ 33 │ 34 │ 35 │ 36 │ 37 │ 38 │ 39 │ 30 │ ────► 1234567890 └────╨────┴────┴────┴────┴────┴────┴────┴────┴────┴────┘ └──┘ └───────────────────────────────────────────────┘ long. '1' '2' '3' '4' '5' '6' '7' '8' '9' '0' ┌────╥────┬────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐ │ 0B ║ 2D │ 31 │ 32 │ 33 │ 34 │ 35 │ 36 │ 37 │ 38 │ 39 │ 30 │ ────► -1234567890 └────╨────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┘ └──┘ └────────────────────────────────────────────────────┘ long. '-' '1' '2' '3' '4' '5' '6' '7' '8' '9' '0'
4.3.4. Chaîne de caractères
Une chaîne de caractère est une longueur (un entier sur 4 octets) + le contenu de la chaîne (sans le \0 final).
Exemple :
┌────┬────┬────┬────╥────┬────┬────┬────┬────┐ │ 00 │ 00 │ 00 │ 05 ║ 68 │ 65 │ 6C │ 6C │ 6F │ ────► "hello" └────┴────┴────┴────╨────┴────┴────┴────┴────┘ └─────────────────┘ └──────────────────────┘ longueur 'h' 'e' 'l' 'l' 'o'
Une chaîne vide a une longueur de zéro :
┌────┬────┬────┬────┐ │ 00 │ 00 │ 00 │ 00 │ ────► "" └────┴────┴────┴────┘ └─────────────────┘ longueur
Une chaîne NULL (pointeur NULL en C) a une longueur de -1 :
┌────┬────┬────┬────┐ │ FF │ FF │ FF │ FF │ ────► NULL └────┴────┴────┴────┘ └─────────────────┘ longueur
4.3.5. Tampon de données
Même format que l’objet chaîne; le contenu est simplement un tableau d’octets.
4.3.6. Pointeur
Un pointeur est encodé sous forme de chaîne de caractère (hexadécimal), avec la longueur sur un octet.
Exemple :
┌────╥────┬────┬────┬────┬────┬────┬────┬────┬────┐ │ 09 ║ 31 │ 61 │ 32 │ 62 │ 33 │ 63 │ 34 │ 64 │ 35 │ ────► 0x1a2b3c4d5 └────╨────┴────┴────┴────┴────┴────┴────┴────┴────┘ └──┘ └──────────────────────────────────────────┘ long. '1' 'a' '2' 'b' '3' 'c' '4' 'd' '5'
Un pointeur NULL a une longueur de 1 avec la valeur 0 :
┌────╥────┐ │ 01 ║ 00 │ ────► NULL (0x0) └────╨────┘ └──┘ └──┘ long. 0
4.3.7. Date/heure
La date/heure (nombre de secondes) est encodé sous forme de chaîne de caractères, avec la longueur sur un octet.
Exemple :
┌────╥────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐ │ 0A ║ 31 │ 33 │ 32 │ 31 │ 39 │ 39 │ 33 │ 34 │ 35 │ 36 │ ────► 1321993456 └────╨────┴────┴────┴────┴────┴────┴────┴────┴────┴────┘ └──┘ └───────────────────────────────────────────────┘ long. '1' '3' '2' '1' '9' '9' '3' '4' '5' '6'
4.3.8. Table de hachage
Une table de hachage contient le type pour les clés, le type pour les valeurs, le nombre d’éléments dans la table de hachage (entier sur 4 octets), et les clés et valeurs de chaque élément.
┌───────────┬─────────────┬───────╥───────┬─────────╥─────╥───────┬─────────┐ │ type_keys │ type_values │ count ║ key 1 │ value 1 ║ ... ║ key N │ value N │ └───────────┴─────────────┴───────╨───────┴─────────╨─────╨───────┴─────────┘
Exemple :
┌─────┬─────┬───╥──────┬─────╥──────┬─────┐ │ str │ str │ 2 ║ key1 │ abc ║ key2 │ def │ ────► { 'key1' => 'abc', └─────┴─────┴───╨──────┴─────╨──────┴─────┘ 'key2' => 'def' } └───┘ └───┘ └─┘ └──────────┘ └──────────┘ type type nombre élément 1 élément 2 clés valeurs
4.3.9. Hdata
Un hdata contient un chemin avec les noms de hdata, une liste de clés, le nombre d’objets, et l’ensemble des objets (chemin avec les pointeurs, puis les objets).
┌────────┬──────┬───────╥────────┬─────────────────────╥── │ h-path │ keys │ count ║ p-path │ value 1 ... value N ║ ... └────────┴──────┴───────╨────────┴─────────────────────╨── ──╥────────┬─────────────────────╥─────┐ ... ║ p-path │ value 1 ... value N ║ ... │ ──╨────────┴─────────────────────╨─────┘
-
h-path (chaîne) : chemin utilise pour atteindre le hdata (exemple : buffer/lines/line/line_data); le dernier élément du chemin est le hdata retourné
-
keys (chaînes) : chaîne avec une liste de clé:type (séparés par des virgules), exemple : number:int,name:str
-
count (entier) : nombre d’objets
-
p-path : chemin avec les pointeurs vers les objets (le nombre de pointeurs ici est le nombre d’éléments dans le chemin)
-
values : liste de valeurs (le nombre de valeurs est le nombre de clés retournées pour le hdata)
Exemple de hdata avec deux tampons (tampon "core" weechat et le serveur freenode) et deux clés (number et full_name) :
# commande hdata buffer:gui_buffers(*) number,full_name # réponse ┌────────┬──────────────────────────┬───╥── │ buffer │ number:int,full_name:str │ 2 ║ ... └────────┴──────────────────────────┴───╨── └──────┘ └────────────────────────┘ └─┘ h-path clés nombre ──╥─────────┬───┬──────────────╥─────────┬───┬────────────────────┐ ... ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │irc.server.freenode │ ──╨─────────┴───┴──────────────╨─────────┴───┴────────────────────┘ └──────────────────────────┘ └────────────────────────────────┘ tampon 1 tampon 2
Exemple de hdata avec les lignes du tampon "core" :
# commande hdata buffer:gui_buffers(*)/lines/first_line(*)/data # réponse ┌─────────────────────────────┬─────┬────╥── │ buffer/lines/line/line_data │ ... │ 50 ║ ... └─────────────────────────────┴─────┴────╨── └───────────────────────────┘ └───┘ └──┘ h-path (noms de hdata) clés nombre ──╥───────────┬───────────┬───────────┬───────────┬───────╥── ... ║ 0x23cf970 │ 0x23cfb60 │ 0x23d5f40 │ 0x23d8a10 │ ..... ║ ... ──╨───────────┴───────────┴───────────┴───────────┴───────╨── └─────────────────────────────────────────────┘ └─────┘ p-path (pointeurs) objets └─────────────────────────────────────────────────────┘ ligne 1 ──╥───────────┬───────────┬───────────┬───────╥──────────────┐ ... ║ 0x23cf970 │ 0x23cfb60 │ 0x23d6110 │ ..... ║ ............ │ ──╨───────────┴───────────┴───────────┴───────╨──────────────┘ └─────────────────────────────────┘ └─────┘ p-path (pointeurs) objets └─────────────────────────────────────────┘ └────────────┘ ligne 2 lignes 3-50
Exemple de hdata avec la liste des pseudos :
# commande nicklist # réponse ┌───────────────────┬── │ buffer/nick_group │ ... └───────────────────┴── └─────────────────┘ h-path ──╥───────────────────────────────────────────────────────────┬────╥── ... ║ group:chr,visible:chr,name:str,color:str,prefix:str,(...) │ 12 ║ ... ──╨───────────────────────────────────────────────────────────┴────╨── └─────────────────────────────────────────────────────────┘ └──┘ clés nombre ──╥─────────┬─────────┬───┬───┬──────┬─┬─┬─┬───╥── ... ║ 0x12345 │ 0x6789a │ 1 │ 0 │ root │ │ │ │ 0 ║ ... ──╨─────────┴─────────┴───┴───┴──────┴─┴─┴─┴───╨── └─────────────────┘ └──────────────────────┘ p-path objets └──────────────────────────────────────────┘ groupe (racine de la liste des pseudos) ──╥─────────┬─────────┬───┬───┬───────┬─┬─┬─┬───╥── ... ║ 0x123cf │ 0x678d4 │ 1 │ 0 │ 000|o │ │ │ │ 1 ║ ... ──╨─────────┴─────────┴───┴───┴───────┴─┴─┴─┴───╨── └─────────────────┘ └───────────────────────┘ p-path objets └───────────────────────────────────────────┘ groupe (ops du canal) ──╥─────────┬─────────┬───┬───┬──────────┬──────┬───┬────────────┬───╥── ... ║ 0x128a7 │ 0x67ab2 │ 0 │ 1 │ ChanServ │ blue │ @ │ lightgreen │ 0 ║ ... ──╨─────────┴─────────┴───┴───┴──────────┴──────┴───┴────────────┴───╨── └─────────────────┘ └────────────────────────────────────────────┘ p-path objets └────────────────────────────────────────────────────────────────┘ pseudo (@ChanServ)
Exemple de hdata vide (la hotlist est vide dans WeeChat) :
# commande hdata hotlist:gui_hotlist(*) # réponse ┌────────┬────────┬───┐ │ (NULL) │ (NULL) │ 0 │ └────────┴────────┴───┘ └──────┘ └──────┘ └─┘ h-path clés nombre
4.3.10. Info
Une info contient un nom et une valeur (les deux sont des chaînes de caractères).
┌──────┬───────┐ │ name │ value │ └──────┴───────┘
-
nom (chaîne) : nom de l’info
-
value (chaîne) : valeur
Exemple de l’info version :
┌─────────┬───────────────────┐ │ version │ WeeChat 0.3.7-dev │ └─────────┴───────────────────┘
4.3.11. Infolist
Une infolist contient un nom, nombre d’éléments, et les éléments (ensemble de variables).
┌──────┬───────╥────────╥─────╥────────┐ │ name │ count ║ item 1 ║ ... ║ item N │ └──────┴───────╨────────╨─────╨────────┘
Un élément est :
┌───────╥────────┬────────┬─────────╥─────╥────────┬────────┬─────────┐ │ count ║ name 1 │ type 1 │ value 1 ║ ... ║ name N │ type N │ value N │ └───────╨────────┴────────┴─────────╨─────╨────────┴────────┴─────────┘
-
name (chaîne) : nom de l’infolist (buffer, window, bar, …)
-
count (entier) : nombre d’éléments
-
item :
-
count : nombre de variables dans l’élément
-
name : nom de variable
-
type : type de variable (int, str, …)
-
value : valeur de la variable
-
Exemple d’infolist avec deux tampons (tampon "core" weechat et le serveur freenode) :
# commande infolist buffer # réponse ┌────────┬───╥────┬─────────┬─────┬─────────┬─────╥── │ buffer │ 2 ║ 42 │ pointer │ ptr │ 0x12345 │ ... ║ ... └────────┴───╨────┴─────────┴─────┴─────────┴─────╨── └──────┘ └─┘ └──────────────────────────────────┘ nom nombre élément 1 ──╥────┬─────────┬─────┬─────────┬─────┐ ... ║ 42 │ pointer │ ptr │ 0x6789a │ ... │ ──╨────┴─────────┴─────┴─────────┴─────┘ └──────────────────────────────────┘ élément 2
4.3.12. Tableau
Un tableau est un type (3 octets) + nombre d’objets (entier sur 4 octets) + les données.
Exemple de tableau avec deux chaînes de caractères :
┌─────╥────┬────┬────┬────╥────┬────┬────┬────╥── │ str ║ 00 │ 00 │ 00 │ 02 ║ 00 │ 00 │ 00 │ 03 ║ ... └─────╨────┴────┴────┴────╨────┴────┴────┴────╨── └───┘ └─────────────────┘ └─────────────────┘ type nombre de chaînes longueur ──╥────┬────┬────╥────┬────┬────┬────╥────┬────┐ ... ║ 61 │ 62 │ 63 ║ 00 │ 00 │ 00 │ 02 ║ 64 │ 65 │ ────► [ "abc", "de" ] ──╨────┴────┴────╨────┴────┴────┴────╨────┴────┘ └────────────┘ └─────────────────┘ └───────┘ 'a' 'b' 'c' longueur 'd' 'e'
Exemple de tableau avec trois entiers :
┌─────╥────┬────┬────┬────╥────┬────┬────┬────╥── │ int ║ 00 │ 00 │ 00 │ 03 ║ 00 │ 00 │ 00 │ 7B ║ ... └─────╨────┴────┴────┴────╨────┴────┴────┴────╨── └───┘ └─────────────────┘ └─────────────────┘ type nombre d'entiers 123 (0x7B) ──╥────┬────┬────┬────╥────┬────┬────┬────┐ ... ║ 00 │ 00 │ 01 │ C8 ║ 00 │ 00 │ 03 │ 15 │ ────► [ 123, 456, 789 ] ──╨────┴────┴────┴────╨────┴────┴────┴────┘ └─────────────────┘ └─────────────────┘ 456 (0x1C8) 789 (0x315)
Un tableau NULL :
┌─────╥────┬────┬────┬────┐ │ str ║ 00 │ 00 │ 00 │ 00 │ ────► NULL └─────╨────┴────┴────┴────┘ └───┘ └─────────────────┘ type nombre de chaînes
5. Session typique
┌────────┐ ┌───────┐ ┌─────────┐ │ Client ├ ─ ─ ─ ─ (réseau)─ ─ ─ ─ ┤ Relay ├────────────────┤ WeeChat │ └────────┘ └───────┘ └─────────┘ ║ ║ ║ ╟───────────────────────────────► ║ ║ ║ ouverture socket ║ ajout du client ║ ║ ║ ║ ╟───────────────────────────────► ║ ║ ║ cmd: init password=xxx,... ║ init/autoriser client ║ ║ ║ ║ ╟───────────────────────────────► ║ ║ ║ cmd: hdata buffer ... ╟───────────────────────► ║ ║ sync ... ║ demande de hdata ║ lecture ║ ║ ║ valeurs ║ ║ ◄───────────────────────╢ hdata ║ ◄───────────────────────────────╢ hdata ║ créat° ║ msg: hda buffer ║ ║ tampons ║ ║ ║ ║ ........ ║ ........ ║ ║ ║ ║ ╟───────────────────────────────► ║ ║ ║ cmd: input ... ╟───────────────────────► ║ ║ ║ envoi données au tampon ║ envoi données ║ ║ ║ au tampon ║ ........ ║ ........ ║ ║ ║ ║ signal ║ ║ ◄───────────────────────╢ reçu ║ ◄───────────────────────────────╢ signal XXX ║ (accroché MAJ ║ msg: id: "_buffer_..." ║ ║ par relay) tampons ║ ║ ║ ║ ........ ║ ........ ║ ║ ║ ║ ╟───────────────────────────────► ║ ║ ║ cmd: ping ... ║ ║ ║ ║ ║ ║ ◄───────────────────────────────╢ ║ mesure ║ msg: id: "_pong" ... ║ ║ temps ║ ║ ║ réponse ║ ........ ║ ........ ║ ║ ║ ║ ╟───────────────────────────────► ║ ║ ║ cmd: quit ║ déconnexion du client ║ ║ ║ ║