<?xml version="1.0" encoding="UTF-8"?>

<refentry xml:id="function.openlog" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>openlog</refname>

<refpurpose>Apre una connessione al logger di sistema</refpurpose>

</refnamediv>

<refsect1>

<title>Descrizione</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>

<function>openlog</function> apre una connessione al logger di

sistema per un programma. La stringa <parameter>ident</parameter> viene

aggiunta a ogni messaggio. Valori per <parameter>option</parameter>

e <parameter>facility</parameter> sono dati di seguito.

L'argomento <parameter>option</parameter> viene usato per indicare

quali opzioni di loggin verranno usate durante la generazione di un messaggio di log.

L'argomento <parameter>facility</parameter> viene usato per specificare quale

tipo di programma sta loggando il messaggio. Questo permette di specificare

(nella comfigurazione del syslog della macchina) come trattare i messaggi provenienti dalle

diverse facility.

L'uso di <function>openlog</function> è opzionale. Viene

chiamato automaticamente da <function>syslog</function> se

necessario, in tal caso <parameter>ident</parameter> sarà di default

&false;.

</para>

<para>

<table>

<title>Opzioni di <function>openlog</function></title>

<tgroup cols="2">

<thead>

<row>

<entry>Costante</entry>

<entry>Descrizione</entry>

</row>

</thead>

<tbody>

<row>

<entry>LOG_CONS</entry>

<entry>

se si verifica un errore durante l'invio dei dati al logger di sistema,

scrive direttamente sulla console di sistema

</entry>

</row>

<row>

<entry>LOG_NDELAY</entry>

<entry>

apre immediatamente una connessione al logger

</entry>

</row>

<row>

<entry>LOG_ODELAY</entry>

<entry>

(default) ritarda l'apertura della connessione fino a quando non viene loggato

il primo messaggio

</entry>

</row>

<row>

<entry>LOG_PERROR</entry>

<entry>stampa un messaggio di log anche su standard error</entry>

</row>

<row>

<entry>LOG_PID</entry>

<entry>include il PID in ciascun messaggio</entry>

</row>

</tbody>

</tgroup>

</table>

Si possono usare una o più di queste opzioni. Usando opzioni multiple

è necessario usare <literal>OR</literal>, ad esempio per aprire la connessione

immediatamente, scrivere sulla console e il PID in ciascun messaggio,

si dovrà usare: <literal>LOG_CONS | LOG_NDELAY | LOG_PID</literal>

</para>

<para>

<table>

<title>Facility di <function>openlog</function></title>

<tgroup cols="2">

<thead>

<row>

<entry>Costante</entry>

<entry>Descrizione</entry>

</row>

</thead>

<tbody>

<row>

<entry>LOG_AUTH</entry>

<entry>

messaggi di sicurezza/autorizzazione (usa LOG_AUTHPRIV

nei sistemi dove è definita quella costante)

</entry>

</row>

<row>

<entry>LOG_AUTHPRIV</entry>

<entry>messaggi di sicurezza/autorizzazione (private)</entry>

</row>

<row>

<entry>LOG_CRON</entry>

<entry>clock daemon (cron e at)</entry>

</row>

<row>

<entry>LOG_DAEMON</entry>

<entry>altri demoni di sistema</entry>

</row>

<row>

<entry>LOG_KERN</entry>

<entry>messaggi del kernel</entry>

</row>

<row>

<entry>LOG_LOCAL0 ... LOG_LOCAL7</entry>

<entry>riservato per il locale</entry>

</row>

<row>

<entry>LOG_LPR</entry>

<entry>sottosistema line printer</entry>

</row>

<row>

<entry>LOG_MAIL</entry>

<entry>sottosistema mail</entry>

</row>

<row>

<entry>LOG_NEWS</entry>

<entry>sottosistema news di USENET</entry>

</row>

<row>

<entry>LOG_SYSLOG</entry>

<entry>messaggi generati internamente da syslogd</entry>

</row>

<row>

<entry>LOG_USER</entry>

<entry>messaggi generici user-level</entry>

</row>

<row>

<entry>LOG_UUCP</entry>

<entry>sottosistema UUCP</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

<para>

Vedere anche <function>define_syslog_variables</function>,

<function>syslog</function> e

<function>closelog</function>.

</para>

</refsect1>

</refentry>