NOM¶
logger - Interface en ligne de commande pour le module de journalisation
système
syslog(3)
SYNOPSIS¶
logger [
options] [
message]
DESCRIPTION¶
logger crée des entrées dans le fichier journal du
système. Il fournit une interface en ligne de commande pour le module
de journalisation système de
syslog(3).
OPTIONS¶
- -d, --udp
- N’utiliser que les datagrammes (UDP). Par défaut la
connexion est tentée sur le port de syslog défini
dans /etc/services, qui est généralement
514.
- -h, --help
- Afficher un texte d'aide puis quitter.
- -i, --id
- Enregistrer l'identifiant du processus logger sur chaque
ligne.
- -n, --server serveur
- Écrire sur le serveur syslog distant indiqué au lieu
des routines syslog intégrées. À moins que
--udp ou --tcp ne soient indiquées, logger
essayera d’abord d’utiliser UDP, mais si cela échoue,
une connexion TCP sera tentée.
- -P, --port port
- Utiliser le port indiqué.
- -f, --file fichier
- Enregistrer le contenu du fichier indiqué. Cette option ne
peut pas être associée à un message de ligne de
commande.
- -p, --priority priorité
- Enregistrer le message dans le journal avec la priorité
indiquée. La priorité peut être donnée
numériquement ou bien avec un couple
service.niveau. Par exemple, -p
local3.info enregistre le message comme informationnel dans la
ressource local3. La valeur par défaut est
user.notice.
- --prio-prefix
- Chercher un préfixe syslog sur toutes les lignes lues sur
l’entrée standard. Ce préfixe est un nombre entre
chevrons qui contient à la fois la ressource et le niveau. Ce
préfixe décimal est construit en multipliant la ressource
par 8 et en ajoutant le niveau. Ainsi, par exemple,
local0.info, de ressource 16 de niveau 6, devient
<134>.
Si le préfixe ne contient pas de ressource, la ressource pas
défaut est celle indiquée par l’option -p. De
même, si aucun préfixe n’est fourni, la ligne est
journalisée en utilisant la -p priorité.
Cette option n’affecte pas un message de ligne de commande.
- -s, --stderr
- Afficher le message sur la sortie d'erreur standard en plus de
l'enregistrer dans le journal système.
- -T, --tcp
- N’utiliser que les flux (TCP). Par défaut la connexion est
tentée sur le port de syslog-conn défini dans
/etc/services, qui est généralement 601.
- -t, --tag étiquette
- Marquer chaque ligne à journaliser avec
l’étiquette indiquée.
- -u, --socket socket
- Écrire dans la socket indiquée au lieu d'utiliser les
routines internes à syslog.
- --journald [fichier]
- Écrire une entrée de journal systemd. L’entrée
est lue depuis l’entrée standard ou du fichier
d’entrée. Chaque nouvelle ligne doit commencer avec un champ
accepté par journald, consultez systemd.journal-fields(7)
pour plus de précisons. Utiliser le champ MESSAGE_ID est
généralement une bonne idée car cela facilite la
recherche d’entrées.
-
$ printf "%s\n%s\n%s\n" MESSAGE_ID=86184c3b1aa444f58ebe7b30fec1438b CHIENS=aboient "CARAVANE=passe" | logger --journald
$ logger --journald=entry.txt
- Remarquez que --journald ignorera les valeurs des autres options,
comme la priorité. Si la priorité est nécessaire,
elle doit être dans l’entrée et utiliser le champ
PRIORITY. La simple exécution de journalctl affichera le
champ MESSAGE. Utilisez journalctl --output json-pretty pour voir
le reste des champs.
- -V, --version
- Afficher les informations sur la version et quitter.
- --
- Terminer la liste des arguments. Cela permet au message de
commencer avec un tiret (« - »).
- message
- Écrire ce message dans le journal ; si aucun message
n'est fourni et que l’attribut -f n'est pas utilisé,
l'entrée standard sera enregistrée.
Le code de retour est 0 quand
logger réussit et strictement
supérieur à 0 en cas d'erreur.
Les noms de service possibles sont :
auth,
authpriv (pour
les informations de sécurité de nature sensible),
cron,
daemon,
ftp,
kern (ne peut pas être
créé depuis un processus utilisateur),
lpr,
mail,
news,
security (synonyme obsolète d’
auth),
syslog,
user,
uucp et de
local0 à
local7 inclus.
Les noms de niveau possibles sont :
alert,
crit,
debug,
emerg,
err,
error (synonyme obsolète
d’
err),
info,
notice,
panic (synonyme
obsolète d’
emerg),
warning,
warn (synonyme
obsolète de
warning). Pour l'ordre des priorités et les
intentions de ces niveaux, consultez
syslog(3).
EXEMPLES¶
logger Système redémarré
logger -p local0.notice -t HOSTIDM -f /dev/idmc
logger -n hôtejournal.example.com Système redémarré
VOIR AUSSI¶
journalctl(1),
syslog(3),
systemd.journal-fields(7),
syslogd(8)
NORMES¶
La commande
logger est prévue pour être compatible avec
IEEE Std 1003.2 (« POSIX.2 »).
DISPONIBILITɶ
La commande
logger fait partie du paquet util-linux, elle est disponible
sur
l’archive
du noyau Linux
TRADUCTION¶
Cette page de manuel a été traduite et est maintenue par Nicolas
Haller <nicolas AT boiteameuh DOT org> et les membres de la liste
<debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler
toute erreur de traduction par un rapport de bogue sur le paquet
manpages-fr-extra.