Files
doc-fr/reference/gearman/constants.xml
2021-06-03 01:59:22 +01:00

595 lines
17 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: gui Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="gearman.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&extension.constants;
<para>
Valeurs de retour. Cherchez toujours une chaîne de caractères d'erreur dans
<methodname>GearmanClient::error</methodname> ou <methodname>GearmanWorker</methodname> car
davantage de détails peuvent être disponibles :
</para>
<para>
<variablelist>
<varlistentry xml:id="constant.gearman-success">
<term>
<constant>GEARMAN_SUCCESS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Quelque soit l'action entreprise, elle a été couronnée de succès.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-io-wait">
<term>
<constant>GEARMAN_IO_WAIT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
En mode non-bloquant, un événement qui aurait été bloquant a été atteint.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-errno">
<term>
<constant>GEARMAN_ERRNO</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Une erreur système. Cherchez dans <methodname>GearmanClient::errno</methodname> ou
<methodname>GearmanWorker::errno</methodname> le code d'erreur système qui a été
retourné.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-no-active-fds">
<term>
<constant>GEARMAN_NO_ACTIVE_FDS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<methodname>GearmanClient::wait</methodname> ou <methodname>GearmanWorker</methodname> a
été appelé sans connexion.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-unexpected-packet">
<term>
<constant>GEARMAN_UNEXPECTED_PACKET</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Indique que quelque chose de grave est survenu dans gearmand. S'applique seulement à
<classname>GearmanWorker</classname>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-getaddrinfo">
<term>
<constant>GEARMAN_GETADDRINFO</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
La résolution DNS a échoué (hôte ou port invalide, etc).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-no-servers">
<term>
<constant>GEARMAN_NO_SERVERS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Aucun appel à <methodname>GearmanClient::addServer</methodname> n'a été fait avant de soumettre une
tâche.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-lost-connection">
<term>
<constant>GEARMAN_LOST_CONNECTION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Perte de connexion pendant une requête.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-memory-allocation-failure">
<term>
<constant>GEARMAN_MEMORY_ALLOCATION_FAILURE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
L'allocation mémoire a échoué (plus de mémoire disponible).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-server-error">
<term>
<constant>GEARMAN_SERVER_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Quelque chose s'est mal passé avec le serveur Gearman qui n'a pas pu traiter
la requête comme il se doit.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-work-data">
<term>
<constant>GEARMAN_WORK_DATA</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Un code d'erreur de notification obtenu avec <methodname>GearmanClient::returnCode</methodname>
lors de l'utilisation de <methodname>GearmanClient::do</methodname>. Envoyé pour mettre à jour le
cliet avec les données de la tâche courante. Un agent l'utilise quand il a besoin d'envoyer des
mises à jour, d'envoyer des résultats partiels ou pour évacuer les données lors de tâches longues.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-work-warning">
<term>
<constant>GEARMAN_WORK_WARNING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Un code d'erreur de notification obtenu avec <methodname>GearmanClient::returnCode</methodname>
lors de l'utilisation de <methodname>GearmanClient::do</methodname>. Met à jour le client avec
un avertissement. Le comportement est le même qu'avec <constant>GEARMAN_WORK_DATA</constant>, sauf
qu'il devrait être traité comme un avertissement plutôt que comme les données d'une réponse normale.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-work-status">
<term>
<constant>GEARMAN_WORK_STATUS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Un code d'erreur de notification obtenu avec <methodname>GearmanClient::returnCode</methodname>
lors de l'utilisation de <methodname>GearmanClient::do</methodname>. Envoyé pour mettre à jour le statut
d'une tâche longue. Utilisez <methodname>GearmanClient::doStatus</methodname> pour obtenir le pourcentage
de complétion de la tâche.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-work-exception">
<term>
<constant>GEARMAN_WORK_EXCEPTION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Un code d'erreur de notification obtenu avec <methodname>GearmanClient::returnCode</methodname>
lors de l'utilisation de <methodname>GearmanClient::do</methodname>. Indique qu'une tâche a échoué
en levant une exception donnée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-work-fail">
<term>
<constant>GEARMAN_WORK_FAIL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Un code d'erreur de notification obtenu avec <methodname>GearmanClient::returnCode</methodname>
lors de l'utilisation de <methodname>GearmanClient::do</methodname>. Indique qu'une tâche a échoué.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-could-not-connect">
<term>
<constant>GEARMAN_COULD_NOT_CONNECT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Echec de la connexion aux serveurs.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-invalid-function-name">
<term>
<constant>GEARMAN_INVALID_FUNCTION_NAME</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Tentative de référencement d'une fonction avec un nom NULL ou utilisation de l'interface de rappel
sans spécifier les rappels.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-invalid-worker-function">
<term>
<constant>GEARMAN_INVALID_WORKER_FUNCTION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Tentative de référencement d'une fonction avec une fonction de rappel NULL.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-no-registered-functions">
<term>
<constant>GEARMAN_NO_REGISTERED_FUNCTIONS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Quand un agent reçoit une tâche pour une fonction qu'il n'a pas référencée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-no-jobs">
<term>
<constant>GEARMAN_NO_JOBS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Pour un agent non-bloquant, quand <methodname>GearmanWorker::work</methodname> n'a aucune tâche
active.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-echo-data-corruption">
<term>
<constant>GEARMAN_ECHO_DATA_CORRUPTION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Après <methodname>GearmanClient::echo</methodname> ou <methodname>GearmanWorker::echo</methodname>,
les données retournées ne correspondent pas aux données envoyées.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-need-workload-fn">
<term>
<constant>GEARMAN_NEED_WORKLOAD_FN</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Quand le client a fait le choix de diffuser la charge de travail sur une tâche, mais n'a pas
spécifié de fonction de retour de la charge de travail.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-pause">
<term>
<constant>GEARMAN_PAUSE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Pour l'interface de tâche cliente non-bloquante, peut être retourné à partir du retour de la tâche
pour "mettre en pause" l'appel et le retour de <methodname>GearmanClient::runTasks</methodname>.
Appelez de nouveau <methodname>GearmanClient::runTasks</methodname> pour continuer.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-unknown-state">
<term>
<constant>GEARMAN_UNKNOWN_STATE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Erreur d'état client/agent interne.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-send-buffer-too-small">
<term>
<constant>GEARMAN_SEND_BUFFER_TOO_SMALL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Erreur interne : a essayé d'évacuer davantage de données que possible dans un paquet atomique,
à cause de tailles de tampons codées en dur.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-timeout">
<term>
<constant>GEARMAN_TIMEOUT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
La limite de temps de l'agent/du client a été atteinte.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Les options <classname>GearmanClient</classname> :
</para>
<para>
<variablelist>
<varlistentry xml:id="constant.gearman-client-generate-unique">
<term>
<constant>GEARMAN_CLIENT_GENERATE_UNIQUE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Génère un identifiant unique (UUID) pour chaque tache.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-client-non-blocking">
<term>
<constant>GEARMAN_CLIENT_NON_BLOCKING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Lance le client en mode non-bloquant.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-client-unbuffered-result">
<term>
<constant>GEARMAN_CLIENT_UNBUFFERED_RESULT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Permet au client de lire les données par paquets plutôt que ce soit la bibliothèque qui mette
en tampon les données et les transmette.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-client-free-tasks">
<term>
<constant>GEARMAN_CLIENT_FREE_TASKS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Libère automatiquement les objets des tâches une fois celles-ci effectées. C'est le paramétrage par
défaut de cette extension pour éviter les fuites de mémoire.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Les options <classname>GearmanWorker</classname> :
</para>
<para>
<variablelist>
<varlistentry xml:id="constant.gearman-worker-non-blocking">
<term>
<constant>GEARMAN_WORKER_NON_BLOCKING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Lance l'agent en mode non-bloquant.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-worker-grab-uniq">
<term>
<constant>GEARMAN_WORKER_GRAB_UNIQ</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Retourne l'identifiant unique alloué au client en plus du descripteur de tâche.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Configuration de base de Gearman :
</para>
<para>
<variablelist>
<varlistentry xml:id="constant.gearman-default-tcp-host">
<term>
<constant>GEARMAN_DEFAULT_TCP_HOST</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-default-tcp-port">
<term>
<constant>GEARMAN_DEFAULT_TCP_PORT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-default-socket-timeout">
<term>
<constant>GEARMAN_DEFAULT_SOCKET_TIMEOUT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-default-socket-send-size">
<term>
<constant>GEARMAN_DEFAULT_SOCKET_SEND_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-default-socket-recv-size">
<term>
<constant>GEARMAN_DEFAULT_SOCKET_RECV_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-max-error-size">
<term>
<constant>GEARMAN_MAX_ERROR_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-packet-header-size">
<term>
<constant>GEARMAN_PACKET_HEADER_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-job-handle-size">
<term>
<constant>GEARMAN_JOB_HANDLE_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-option-size">
<term>
<constant>GEARMAN_OPTION_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-unique-size">
<term>
<constant>GEARMAN_UNIQUE_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-max-command-args">
<term>
<constant>GEARMAN_MAX_COMMAND_ARGS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-args-buffer-size">
<term>
<constant>GEARMAN_ARGS_BUFFER_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-send-buffer-size">
<term>
<constant>GEARMAN_SEND_BUFFER_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-recv-buffer-size">
<term>
<constant>GEARMAN_RECV_BUFFER_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.gearman-worker-wait-timeout">
<term>
<constant>GEARMAN_WORKER_WAIT_TIMEOUT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->