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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 35ca7f1087870c6023ef7a3dd0248501741c8194 Maintainer: sammywg Status: ready -->
<refentry xml:id="function.openlog" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>openlog</refname>
  <refpurpose>Stellt eine Verbindung zum Log-Dienst des Systems her</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>
   Die Funktion <function>openlog</function> öffnet eine Verbindung zum
   System-Log-Dienst eines Programmes.
  </para>
  <para>
   Die Verwendung von <function>openlog</function> ist optional. Die Funktion
   wird - falls erforderlich - automatisch von <function>syslog</function>
   aufgerufen, dabei wird <parameter>prefix</parameter> standardmäßig mit
   der leeren Zeichenkette belegt.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>prefix</parameter></term>
     <listitem>
      <para>
       Die Zeichenkette <parameter>prefix</parameter> wird jeder Meldung
       hinzugefügt.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>flags</parameter></term>
     <listitem>
      <para>
       Eine Bitmaske der folgenden Konstanten:
       <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>
       Das Argument <parameter>facility</parameter> wird verwendet, um die Art
       des Programmes festzulegen, das die Nachricht loggt.
       Damit kann in der Konfigurationsdatei festgelegt werden, dass
       Nachrichten von verschiedenen Einrichtungen unterschiedlich behandelt
       werden.
       Muss eine der folgenden Konstanten sein:
       <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>
        Unter Windows wird dieser Parameter ignoriert.
       </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>
       Die Funktion gibt nun immer &true; zurück; zuvor gab sie bei einem
       Fehler &false; zurück.
      </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
-->