syslog

Descrizione

int syslog ( int priorità, string messaggio)

syslog() genera un messaggio di log che viene distribuito dal logger di sistema. priorità è la combinazione della facility e del livello, valori utilizzabili sono riportati nella prossima sezione. L'argomento rimanente è il messaggio da inviare, eccetto i due caratteri %m che vengono sostituiti dalla stringa del messaggio di errore (strerror) corrispondente all'attuale valore di errno.

Tabella 1. Priorità syslog() (in ordine discendente)

Costante	Descrizione
LOG_EMERG	sistema non utilizzabile
LOG_ALERT	azione da intraprendere immediatamente
LOG_CRIT	condizioni critiche
LOG_ERR	condizioni di errore
LOG_WARNING	condizioni di attenzione
LOG_NOTICE	condizione normale, ma significativa
LOG_INFO	messaggio di informazione
LOG_DEBUG	messaggio a livello di debug

Esempio 1. Uso di syslog()
<?php define_syslog_variables(); // apre il syslog, include l'ID del processo, invia il // log anche su standard error e fa uso di un meccanismo // di logging defiito dall'utente openlog("IlMioLog", LOG_PID | LOG_PERROR, LOG_LOCAL0); // un po' di codice if (client_autorizzato()) { // fa qualcosa } else { // client non autorizzato! // logga il tentativo $accesso = date("Y/m/d H:i:s"); syslog(LOG_WARNING,"Client non autorizzato: $accesso $REMOTE_ADDR ($HTTP_USER_AGENT)"); } closelog(); ?>
Per informazioni su come creare un gestore di log definito dall'utente, fare riferimento alla man page syslog.conf(5) di Unix. Ulteriori informazioni sulle facility di syslog e sulle sue opzioni possono essere trovate sulle macchine Unix nelle man page di syslog(3).

Su Windows NT, il servizio syslog è emulato usando Event Log.

Vedere anche define_syslog_variables(), openlog() e closelog().