archived-doc-es/reference/network/functions/openlog.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 35ca7f1087870c6023ef7a3dd0248501741c8194 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.openlog" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>openlog</refname>
  <refpurpose>Abre la conexión al historial del sistema</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>true</type><methodname>openlog</methodname>
   <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
   <methodparam><type>int</type><parameter>flags</parameter></methodparam>
   <methodparam><type>int</type><parameter>facility</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>openlog</function> abre la conexión al historial
   del sistema.
  </para>
  <para>
   El uso de <function>openlog</function> es opcional. Esta
   función será llamada automáticamente por la función <function>syslog</function>
   si es necesario, en cuyo caso <parameter>prefix</parameter> valdrá por omisión
   &false;.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>prefix</parameter></term>
     <listitem>
      <para>
       El string <parameter>prefix</parameter> será
       añadido a cada mensaje.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>flags</parameter></term>
     <listitem>
      <para>
       Máscara de bits de las constantes siguientes:
       <simplelist>
        <member><constant>LOG_CONS</constant></member>
        <member><constant>LOG_NDELAY</constant></member>
        <member><constant>LOG_ODELAY</constant></member>
        <member><constant>LOG_NOWAIT</constant></member>
        <member><constant>LOG_PERROR</constant></member>
        <member><constant>LOG_PID</constant></member>
       </simplelist>
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>facility</parameter></term>
     <listitem>
      <para>
       El argumento <parameter>facility</parameter> se utiliza para especificar
       el tipo de programa que registra el mensaje.
       Esto permite al fichero de configuración especificar que los mensajes provenientes de diferentes
       instalaciones serán tratados de manera distinta.
       Debe ser una de las constantes siguientes:
       <simplelist>
        <member><constant>LOG_AUTH</constant></member>
        <member><constant>LOG_AUTHPRIV</constant></member>
        <member><constant>LOG_CRON</constant></member>
        <member><constant>LOG_DAEMON</constant></member>
        <member><constant>LOG_KERN</constant></member>
        <member><constant>LOG_LOCAL<replaceable>[0-7]</replaceable></constant></member>
        <member><constant>LOG_LPR</constant></member>
        <member><constant>LOG_MAIL</constant></member>
        <member><constant>LOG_NEWS</constant></member>
        <member><constant>LOG_SYSLOG</constant></member>
        <member><constant>LOG_USER</constant></member>
        <member><constant>LOG_UUCP</constant></member>
       </simplelist>
      </para>
      <note>
       <simpara>
        Este parámetro es ignorado en Windows.
       </simpara>
      </note>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.true.always;
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.2.0</entry>
      <entry>
       La función ahora siempre retorna &true;. Anteriormente, retornaba &false; en caso de fallo.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>syslog</function></member>
    <member><function>closelog</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>
<!-- 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
-->