diff options
author | Sebastien Helleu <flashcode@flashtux.org> | 2010-01-04 23:40:07 +0100 |
---|---|---|
committer | Sebastien Helleu <flashcode@flashtux.org> | 2010-01-04 23:40:07 +0100 |
commit | d64aaed29bd6cd9f812c11103d965e505357d804 (patch) | |
tree | 4c973a1cfc4ed5dfe8ca57a35ca2800d676dcb2f /doc/fr/weechat_plugin_api.fr.txt | |
parent | 6d211de00d48627517476420aabedfc13ec05921 (diff) | |
download | weechat-d64aaed29bd6cd9f812c11103d965e505357d804.zip |
Add missing arguments for hook_connect in plugin API reference
Diffstat (limited to 'doc/fr/weechat_plugin_api.fr.txt')
-rw-r--r-- | doc/fr/weechat_plugin_api.fr.txt | 31 |
1 files changed, 24 insertions, 7 deletions
diff --git a/doc/fr/weechat_plugin_api.fr.txt b/doc/fr/weechat_plugin_api.fr.txt index 599eb7178..353835db0 100644 --- a/doc/fr/weechat_plugin_api.fr.txt +++ b/doc/fr/weechat_plugin_api.fr.txt @@ -5218,25 +5218,35 @@ Prototype : [source,C] ---------------------------------------- -struct t_hook *weechat_hook_connect (const char *address, +struct t_hook *weechat_hook_connect (const char *proxy, + const char *address, int port, int sock, int ipv6, void *gnutls_sess, + void *gnutls_cb, + int gnutls_dhkey_size, const char *local_hostname, int (*callback)(void *data, int status, + int gnutls_rc, + const char *error, const char *ip_address), void *callback_data); ---------------------------------------- Paramètres : +* 'proxy': nom du proxy à utiliser pour la connexion (optionnel, NULL signifie + une connexion sans proxy) * 'address' : nom ou adresse IP de la machine à laquelle se connecter * 'port' : numéro de port * 'sock' : socket utilisée pour la connexion * 'ipv6' : 1 pour utiliser IPv6, 0 pour utiliser IPv4 * 'gnutls_sess' : GnuTLS session (optionnel) +* 'gnutls_cb' : callback pour GnuTLS (optionnel) +* 'gnutls_dhkey_size': taille de clé utilisée pour l'échange de clé + Diffie-Hellman (GnuTLS) * 'callback' : fonction appelée lorsque la connexion est ok ou a échoué, paramètres : ** 'void *data' : pointeur @@ -5251,6 +5261,8 @@ Paramètres : *** 'WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR' : erreur avec la "poignée de main" GnuTLS *** 'WEECHAT_HOOK_CONNECT_MEMORY_ERROR' : mémoire insuffisante +** 'gnutls_rc' : valeur retour de 'gnutls_handshake()' +** 'const char *error' : valeur retour de 'gnutls_strerror(gnutls_rc)' ** 'const char *ip_address' : adresse IP trouvée * 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat @@ -5264,7 +5276,8 @@ Exemple en C : [source,C] ---------------------------------------- int -my_connect_cb (void *data, int status, const char *ip_address) +my_connect_cb (void *data, int status, int gnutls_rc, const char *error, + const char *ip_address) { switch (status) { @@ -5299,8 +5312,11 @@ my_connect_cb (void *data, int status, const char *ip_address) return WEECHAT_RC_OK; } -struct t_hook *my_connect_hook = weechat_hook_connect ("my.server.org", 1234, - sock, 0, NULL, NULL, +struct t_hook *my_connect_hook = weechat_hook_connect (NULL, + "my.server.org", 1234, + sock, 0, + NULL, NULL, 0, /* GnuTLS */ + NULL, &my_connect_cb, NULL); ---------------------------------------- @@ -5309,11 +5325,11 @@ Script (Python): [source,python] ---------------------------------------- # prototype -hook = weechat.hook_connect(address, port, sock, ipv6, local_hostname, +hook = weechat.hook_connect(proxy, address, port, sock, ipv6, local_hostname, callback, callback_data) # exemple -def my_connect_cb(data, status, ip_address): +def my_connect_cb(data, status, gnutls_rc, error, ip_address): if status == WEECHAT_HOOK_CONNECT_OK: # ... elif status == WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND: @@ -5334,7 +5350,8 @@ def my_connect_cb(data, status, ip_address): # ... return weechat.WEECHAT_RC_OK -hook = weechat.hook_connect("my.server.org", 1234, sock, 0, "", "my_connect_cb", "") +hook = weechat.hook_connect("", "my.server.org", 1234, sock, 0, "", + "my_connect_cb", "") ---------------------------------------- weechat_hook_print |