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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./de/functions/network.xml, last change in rev 1.2 -->
<!-- last change to 'openlog' in en/ tree in rev 1.2 -->
<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready -->
<!-- OLD-Revision: 1.26/EN.1.2 -->
  <refentry id="function.openlog">
   <refnamediv>
    <refname>openlog</refname>
    <refpurpose>
     Stellt eine Verbindung zu einem Log-Dienst des Systems her
    </refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>openlog</methodname>
      <methodparam><type>string</type><parameter>ident</parameter></methodparam>
      <methodparam><type>int</type><parameter>option</parameter></methodparam>
      <methodparam><type>int</type><parameter>facility</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>openlog</function> kontaktiert die
     System-Log-Dienste eines Programms. Die Zeichenkette
     <parameter>ident</parameter> wird jeder Meldung angefügt. Werte
     für die Parameter <parameter>option</parameter> und
     <parameter>facility</parameter> werden unten erläutert. Das
     Argument <parameter>option</parameter> wird verwendet, um
     festzulegen, welche Log-Optionen bei der Erzeugung von 
     Log-Nachrichten verwendet werden sollen. Das Argument 
     <parameter>facility</parameter> wird verwendet, um die Art des
     Programmes festzulegen, das die Nachricht loggt. Dies erlaubt
     ihnen (in ihrer speziellen SysLog-Konfiguartion) die Festlegung
     der Behandlungsweise von Log-Nachrichten. Der Gebrauch von
     <function>openlog</function> ist optional. Er wird - falls 
     erforderlich - automatisch aufgerufen von
     <function>syslog</function>. Dann ist der Vorgabewert von
     <parameter>ident</parameter> falsch / &false;.
    </para>
    <para>
     <table>
      <title><function>openlog</function> Options</title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>Konstante</entry>
         <entry>Beschreibung</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>LOG_CONS</entry>
         <entry>
          Tritt ein Fehler auf beim Senden von Daten an den
          System-Logging-Service, wird direkt an die System-Konsole
          ausgegeben.
         </entry>
        </row>
        <row>
         <entry>LOG_NDELAY</entry>
         <entry>
          Öffnet sofort die Verbindung zum Log-Service.
         </entry>
        </row>
        <row>
         <entry>LOG_ODELAY</entry>
         <entry>
          (Voreinstellung); öffne die Verbindung erst, wenn die erste
          Meldung geloggt werden soll.
         </entry>
        </row>
        <row>
         <entry>LOG_PERROR</entry>
         <entry>
          Gib die Log-Meldungen auch an der Standard-Ausgabe für Fehler
          aus.
         </entry>
        </row>
        <row>
         <entry>LOG_PID</entry>
         <entry>Schließe die PID bei jeder Meldung ein.</entry>
        </row>
       </tbody>
      </tgroup>
     </table>
     Sie können eine oder mehrere dieser Optionen verwenden. Benutzen
     Sie mehrere, müssen diese per <literal>OR</literal> getrennt
     werden. Um die Verbindung sofort herzu stellen, auch auf die 
     Konsole zu schreiben und die PID in jede Meldung auf zu nehmen,
     müssen Sie folgendes angeben: <literal>LOG_CONS | LOG_NDELAY | 
     LOG_PID</literal>.
    </para>
    <para>
     <table>
      <title><function>openlog</function>-Möglichkeiten</title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>Konstante</entry>
         <entry>Beschreibung</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>LOG_AUTH</entry>
         <entry>
          Security- / Authorization-Meldungen (benutzt statt dessen
          LOG_AUTHPRIV in Systemen, wo diese Konstante definiert ist).
         </entry>
        </row>
        <row>
         <entry>LOG_AUTHPRIV</entry>
         <entry>
          Security- / Authorization-Meldungen (private).
         </entry>
        </row>
        <row>
         <entry>LOG_CRON</entry>
         <entry>
          Zeitabhängig gestartete Dienste (Dämonen wie cron and at).
         </entry>
        </row>
        <row>
         <entry>LOG_DAEMON</entry>
         <entry>Andere System-Dienste (Dämonen).</entry>
        </row>
        <row>
         <entry>LOG_KERN</entry>
         <entry>Kernel-Meldungen.</entry>
        </row>
        <row>
         <entry>LOG_LOCAL0 ... LOG_LOCAL7</entry>
         <entry>Reserviert für lokale Benutzung.</entry>
        </row>
        <row>
         <entry>LOG_LPR</entry>
         <entry>Zeilen-Drucker Subsystem.</entry>
        </row>
        <row>
         <entry>LOG_MAIL</entry>
         <entry>Mailing-Subsystem.</entry>
        </row>
        <row>
         <entry>LOG_NEWS</entry>
         <entry>USENET-News-Subsystem.</entry>
        </row>
        <row>
         <entry>LOG_SYSLOG</entry>
         <entry>
          Meldungen die intern von syslogd erzeugt wurden.
         </entry>
        </row>
        <row>
         <entry>LOG_USER</entry>
         <entry>Generische User-Level-Meldungen.</entry>
        </row>
        <row>
         <entry>LOG_UUCP</entry>
         <entry>UUCP-Subsystem</entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
    <para>
     Siehe auch <function>define_syslog_variables</function>,
     <function>syslog</function> und <function>closelog</function>.
    </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:"../../../../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
-->