constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cf0a919c126e45b5df583d188e77fa62015b714a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="gearman.constants">
 &reftitle.constants;
 &extension.constants;
 <simpara>
  Valores de retorno. Siempre se debe buscar una cadena de caracteres de error en
  <methodname>GearmanClient::error</methodname> o <methodname>GearmanWorker</methodname> ya que
  pueden estar disponibles más detalles:
 </simpara>
 <variablelist>
  <varlistentry xml:id="constant.gearman-success">
   <term>
    <constant>GEARMAN_SUCCESS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Cualquier acción realizada ha sido exitosa.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-io-wait">
   <term>
    <constant>GEARMAN_IO_WAIT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     En modo no bloqueante, se ha alcanzado un evento que habría sido bloqueante.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-errno">
   <term>
    <constant>GEARMAN_ERRNO</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Un error del sistema. Se debe buscar en <methodname>GearmanClient::errno</methodname> o
     <methodname>GearmanWorker::errno</methodname> el código de error del sistema que se ha
     devuelto.
    </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> o <methodname>GearmanWorker</methodname> ha
     sido llamado sin conexión.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-unexpected-packet">
   <term>
    <constant>GEARMAN_UNEXPECTED_PACKET</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Indica que algo grave ha ocurrido en gearmand. Solo se aplica a
     <classname>GearmanWorker</classname>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-getaddrinfo">
   <term>
    <constant>GEARMAN_GETADDRINFO</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     La resolución DNS ha fallado (host o puerto inválido, etc).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-no-servers">
   <term>
    <constant>GEARMAN_NO_SERVERS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     No se ha realizado ninguna llamada a <methodname>GearmanClient::addServer</methodname> antes de enviar una
     tarea.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-lost-connection">
   <term>
    <constant>GEARMAN_LOST_CONNECTION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Se ha perdido la conexión durante una solicitud.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-memory-allocation-failure">
   <term>
    <constant>GEARMAN_MEMORY_ALLOCATION_FAILURE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     La asignación de memoria ha fallado (no hay memoria disponible).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-server-error">
   <term>
    <constant>GEARMAN_SERVER_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Algo ha salido mal con el servidor Gearman que no ha podido procesar
     la solicitud como debería.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-work-data">
   <term>
    <constant>GEARMAN_WORK_DATA</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Un código de error de notificación obtenido con <methodname>GearmanClient::returnCode</methodname>
     al utilizar <methodname>GearmanClient::do</methodname>. Se envía para actualizar al
     cliente con los datos de la tarea actual. Un agente lo utiliza cuando necesita enviar actualizaciones,
     enviar resultados parciales o vaciar datos durante tareas largas.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-work-warning">
   <term>
    <constant>GEARMAN_WORK_WARNING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Un código de error de notificación obtenido con <methodname>GearmanClient::returnCode</methodname>
     al utilizar <methodname>GearmanClient::do</methodname>. Actualiza al cliente con
     un aviso. El comportamiento es el mismo que con <constant>GEARMAN_WORK_DATA</constant>, excepto
     que debería ser tratado como un aviso en lugar de los datos de una respuesta normal.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-work-status">
   <term>
    <constant>GEARMAN_WORK_STATUS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Un código de error de notificación obtenido con <methodname>GearmanClient::returnCode</methodname>
     al utilizar <methodname>GearmanClient::do</methodname>. Se envía para actualizar el estado
     de una tarea larga. Utilice <methodname>GearmanClient::doStatus</methodname> para obtener el porcentaje
     de completación de la tarea.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-work-exception">
   <term>
    <constant>GEARMAN_WORK_EXCEPTION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Un código de error de notificación obtenido con <methodname>GearmanClient::returnCode</methodname>
     al utilizar <methodname>GearmanClient::do</methodname>. Indica que una tarea ha fallado
     al lanzar una excepción dada.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-work-fail">
   <term>
    <constant>GEARMAN_WORK_FAIL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Un código de error de notificación obtenido con <methodname>GearmanClient::returnCode</methodname>
     al utilizar <methodname>GearmanClient::do</methodname>. Indica que una tarea ha fallado.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-could-not-connect">
   <term>
    <constant>GEARMAN_COULD_NOT_CONNECT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Fallo al conectar con los servidores.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-invalid-function-name">
   <term>
    <constant>GEARMAN_INVALID_FUNCTION_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Intento de referencia a una función con un nombre NULL o uso de la interfaz de devolución de llamada
     sin especificar las devoluciones de llamada.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-invalid-worker-function">
   <term>
    <constant>GEARMAN_INVALID_WORKER_FUNCTION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Intento de referencia a una función con una función de devolución de llamada 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>
     Cuando un agente recibe una tarea para una función que no ha referenciado.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-no-jobs">
   <term>
    <constant>GEARMAN_NO_JOBS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Para un agente no bloqueante, cuando <methodname>GearmanWorker::work</methodname> no tiene ninguna tarea
     activa.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-echo-data-corruption">
   <term>
    <constant>GEARMAN_ECHO_DATA_CORRUPTION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Después de <methodname>GearmanClient::echo</methodname> o <methodname>GearmanWorker::echo</methodname>,
     los datos devueltos no coinciden con los datos enviados.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-need-workload-fn">
   <term>
    <constant>GEARMAN_NEED_WORKLOAD_FN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Cuando el cliente ha optado por distribuir la carga de trabajo en una tarea, pero no ha
     especificado una función de retorno de la carga de trabajo.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-pause">
   <term>
    <constant>GEARMAN_PAUSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Para la interfaz de tarea cliente no bloqueante, puede ser devuelto desde el retorno de la tarea
     para "pausar" la llamada y el retorno de <methodname>GearmanClient::runTasks</methodname>.
     Llame de nuevo a <methodname>GearmanClient::runTasks</methodname> para continuar.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-unknown-state">
   <term>
    <constant>GEARMAN_UNKNOWN_STATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Error de estado interno del cliente/agente.
    </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>
     Error interno: intentó vaciar más datos de los posibles en un paquete atómico,
     debido a tamaños de búfer codificados en el código.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-timeout">
   <term>
    <constant>GEARMAN_TIMEOUT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Se ha alcanzado el límite de tiempo del agente/cliente.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <simpara>
  Las opciones <classname>GearmanClient</classname>:
 </simpara>
 <variablelist>
  <varlistentry xml:id="constant.gearman-client-generate-unique">
   <term>
    <constant>GEARMAN_CLIENT_GENERATE_UNIQUE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Genera un identificador único (UUID) para cada tarea.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.gearman-client-non-blocking">
   <term>
    <constant>GEARMAN_CLIENT_NON_BLOCKING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Inicia el cliente en modo no bloqueante.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-client-unbuffered-result">
   <term>
    <constant>GEARMAN_CLIENT_UNBUFFERED_RESULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Permite al cliente leer los datos por paquetes en lugar de que la biblioteca los almacene
     en búfer y los transmita.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-client-free-tasks">
   <term>
    <constant>GEARMAN_CLIENT_FREE_TASKS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Libera automáticamente los objetos de las tareas una vez que estas se han completado. Es la configuración por
     defecto de esta extensión para evitar fugas de memoria.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <simpara>
  Las opciones <classname>GearmanWorker</classname>:
 </simpara>
 <variablelist>
  <varlistentry xml:id="constant.gearman-worker-non-blocking">
   <term>
    <constant>GEARMAN_WORKER_NON_BLOCKING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Inicia el agente en modo no bloqueante.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.gearman-worker-grab-uniq">
   <term>
    <constant>GEARMAN_WORKER_GRAB_UNIQ</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Devuelve el identificador único asignado al cliente además del descriptor de tarea.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <simpara>
  Configuración base de Gearman:
 </simpara>
 <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>
</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
-->