8.17 syslog --- Fonctions de la librairie syslog d'Unix

Disponibilité: Unix

Ce module fournit une interface pour les fonctions de la librairie syslog d'Unix. Il faut se reporter aux pages des manuels Unixpour une description détaillée des services de syslog, le mécanisme d'audit d'Unix.

Le module définit les fonctions suivantes:

syslog([priorité, ]message)
Envoie la chaîne message à l'audit du système. Un retour chariot de fin de chaîne est ajouté si nécessaire. Chaque message est étiqueté avec un niveau de priorité composé de service et niveau. L'argument optionel priorité, dont la valeur par défaut est LOG_INFO, donne la priorité du message. Si le service n'est pas codé en priorité en utilisant un ou-logique (LOG_INFO | LOG_USER), la valeur donnée dans openlog()est utilisée.

openlog(ident[, logopt[, service]])
Les fonctions d'audit autres que les fonctions par défaut peuvent être explicitement utilisées en ouvrant le fichier de log avec openlog(), avant tout appel à syslog(). Les valeurs par défauts sont généralement ident = 'syslog', logopt = 0, service = LOG_USER. L'argument ident est une chaîne qui est ajoutée à chaque message. L'argument optionnel logopt est un champ de bit obtenu par combinaison logique des options décrites ci-après. L'argument service déclare le service par défaut pour les messages qui n'ont pas de service explicitement déclaré.

closelog()
Ferme le fichier de log.

setlogmask(maskpri)
Affecte le masque de priorité à la valeur maskpri et retourne le masque précédent. Les appels à syslog() dont la priorité n'est pas définie dans maskpri sont ignorées. Par défaut, toutes les priorités font partie de l'audit. La fonction LOG_MASK(pri)permet de calculer le masque pour la priorité pri. La fonction LOG_UPTO(pri) calcule le masque pour toutes les prioritées jusqu'à pri incluse.

Le module définit les constantes suivantes:

Niveaux de priorité (du plus élevé au plus bas):

LOG_EMERG, LOG_ALERT, LOG_CRIT, LOG_ERR, LOG_WARNING, LOG_NOTICE, LOG_INFO, LOG_DEBUG.

Services:

LOG_KERN, LOG_USER, LOG_MAIL, LOG_DAEMON, LOG_AUTH, LOG_LPR, LOG_NEWS, LOG_UUCP, LOG_CRON et LOG_LOCAL0 à LOG_LOCAL7.

Options:

LOG_PID, LOG_CONS, LOG_NDELAY, LOG_NOWAIT et LOG_PERROR si définis dans <syslog.h>.