SYSLOG(3)

NOME
closelog, openlog, syslog - envia mensagens para o relator do sistema

SINÓPSE
#include <syslog.h>

void openlog( char *ident, int option, int facility)

void syslog( int priority, char *format, ...)

void closelog( void )

DESCRIÇÃO
closelog() fecha o descritor usado para escrever para o relator do sistema. O uso de closelog() é opcional.

openlog() abre uma conexão entre o relator do sistema e um programa. A cadeia de caracteres apontada por ident é adicionada em cada mensagem e é tipicamente configurada para o nome do programa. Valores para option e facility são dados na próxima seção. O uso de openlog() é opcional; Ela será automaticamente chamado por syslog() se necessário, caso em que ident será NULL por padrão.

syslog() gera uma mensagem de relatório, a qual será distribuída por syslogd(8). priority é uma combinação dos valores de facility e level, os quais serão dados na próxima seção. Os argumentos restante são um formato, como em printf(3) e outros argumentos requeridos pelo format, exceto pelso dois caracteres %m, que serão substituído pela mensagem de erro (strerror) correspondente ao valor atual de errno.

PARÂMETROS
Esta seção lista os argumentos usados para configurar os valores de option, facility, e priority.

  option
O argumento option para openlog() é um OR de qualquer destes:

LOG_CONS
    escreve diretamente no console do sistema se ocorrer um erro durante o envio da mensagem ao relator do sistema

LOG_NDELAY
    abre a conexão imediatamente (normalmente, a conexão é aberta quando a primeira mensagem é relatada)

LOG_PERROR
    escreve também no erro padrão (stderr)

LOG_PID
    inclui PID em cada mensagem

  facility
O argumento facility é usado para especificar que tipo de programa está relatando a mensagem. Isto deixa o arquivo de configuração especificar que mensagens de diferentes facilities serão manipuladas de maneira diferenciada.

LOG_AUTH
    mensagens de segurança/autorização (DEPRECIADO Use LOG_AUTHPRIV no lugar)

LOG_AUTHPRIV
    mensagens de segurança/autorização (privadas)

LOG_CRON
    daemon de relógio (cron e at)

LOG_DAEMON
    outros daemons de sistema

LOG_KERN
    mensagens do núcleo

LOG_KERN
    mensagens do Kernel

LOG_LOCAL0 até LOG_LOCAL7
    resevadas para uso local

LOG_LPR
    subsistema de impressora de linha

LOG_MAIL
    subsistema de correio

LOG_NEWS
    subsistema de notícias USENET

LOG_SYSLOG
    mensagens geradas internamente por syslogd

LOG_USER(padrão)
    mensagens genéricas de nível de usuário

LOG_UUCP
    subsistema UUCP

  level
Isto determina a importância da mensagem. Os níveis (levels) são, em ordem de importância decrescente:

LOG_EMERG
    o sistema está inoperante

LOG_ALERT
    ação deve ser tomada imediatamente

LOG_CRIT
    condições críticas

LOG_ERR
    condições de erro

LOG_WARNING
    condições de aviso

LOG_NOTICE
    condição normal mas significante

LOG_INFO
    mensagem informativa

LOG_DEBUG
    mensagem em nível de depuração

HISTÓRICO
Uma chamada de função syslog apareceu no BSD 4.2.

VEJA TAMBÉM
logger(1), syslog.conf(5), syslogd(8).

TRADUZIDO POR LDP-BR EM 02/07/2001.

  Tradução:
Valter Ferraz Sanches <vfs@ezlinux.cjb.net>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>