Provided by: manpages-fr-extra_20151231_all 
NOM
logger - Ajouter des messages au journal système
SYNOPSIS
logger [options] [message]
DESCRIPTION
logger ajoute des entrées dans le journal système.
Quand l’argument facultatif message est présent, il est écrit dans le journal. Sinon, et
si l’option -f n'est pas donnée non plus, l'entrée standard sera enregistrée.
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.
-e, --skip-empty
Lors du traitement des fichiers, les lignes vides seront ignorées. Une ligne vide
est définie comme une ligne sans caractère. Ainsi, une ligne ne contenant que des
espaces n’est pas considérée vide. Remarquez que si l’option --prio-prefix est
indiquée, la priorité ne fait pas partie de la ligne. Ainsi, une ligne vide dans ce
mode est une ligne qui n’a pas de caractère après la priorité (par exemple,
« <13> »).
-f, --file fichier
Enregistrer le contenu du fichier indiqué. Cette option ne peut pas être associée à
un message de ligne de commande.
-i Enregistrer le PID du processus logger sur chaque ligne.
--id[=id]
Enregistrer le PID du processus logger sur chaque ligne. Quand l’argument
facultatif id est indiqué, il est utilisé à la place du PID de la commande logger.
L’utilisation de --id=$$ (PPID) est recommandée dans les scripts qui envoient
plusieurs messages.
--journald[=fichier]
Écrire une entrée de journal systemd. L’entrée est lue du fichier donné s’il est
indiqué ou de l’entrée standard sinon. Chaque ligne doit commencer par un champ
accepté par journald, consultez systemd.journal-fields(7) pour plus de précisons.
L’utilisation du champ MESSAGE_ID est généralement une bonne idée car cela facilite
la recherche d’entrées. Exemples :
printf "%s\n%s\n%s\n" MESSAGE_ID=42 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.
--msgid MSGID
Définir le champ MSGID de la RFC 5424. Remarquez que le caractère espace n’est pas
permis à l’intérieur de MSGID. Cette option n’est utilisée que si --rfc5424 est
indiquée aussi. Sinon, elle est ignorée silencieusement.
--no-act
Forcer chaque chose à être faite à part l’écriture du message dans le journal
système et la fermeture de la connexion ou du journal. Cette option est utilisable
avec --stderr pour faire des tests.
--size taille
Définir la taille maximale permise par message. La valeur par défaut est de 1 kio
en caractères, qui est la limite traditionnelle telle qu’indiquée dans la RFC 3164.
Avec la RFC 5424, cette limite est devenue flexible. En général, les destinataires
RFC 5424 peuvent au moins traiter des messages de 4 kio.
La plupart des destinataires acceptent des messages plus grands que 1 kio sur tous
les types de protocole de journal système. Ainsi, l’option --size affecte logger
dans tous les cas (pas seulement quand --rfc5424 est utilisée).
Remarque : la taille maximale de message limite la taille totale du message, y
compris l’en-tête de journal système. Les tailles d’en-tête varient en fonction des
options sélectionnées et de la taille du nom d’hôte. En règle générale, les
en-têtes ne dépassent pas 50 ou 80 caractères. Lors de la sélection de la taille
maximale du message, s’assurer que le destinataire puisse recevoir des messages de
cette taille est important, sinon les messages pourraient être tronqués. Encore, en
règle générale, des messages de deux à quatre kilooctets devraient normalement
passer, alors que tout ce qui dépasse devrait être vérifié.
-n, --server serveur
Écrire sur le serveur syslog distant indiqué au lieu de la socket du journal
système. À 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é. Quand cette option n’est pas indiquée, le port par défaut
de syslog est utilisé pour les connexions UDP et celui de syslog-conn pour les
connexions TCP.
-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 le service 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 décimal entre chevrons qui encode à la fois le service et le
niveau. Le nombre est construit en multipliant le service par 8 et en ajoutant le
niveau. Par exemple, local0.info, signifiant de service 16 et de niveau 6, devient
<134>.
Si le préfixe ne contient pas de service, le service par défaut est celui indiqué
par l’option -p. De même, si aucun préfixe n’est fourni, la ligne est journalisée
en utilisant la priorité donnée avec -p.
Cette option n’affecte pas un message de ligne de commande.
--rfc3164
Utiliser le protocole syslog BSD RFC 3164 pour soumettre des messages à un serveur
distant.
--rfc5424[=sans]
Utiliser le protocole syslog RFC 5424 pour soumettre des messages à un serveur
distant. L’argument facultatif sans peut être une liste séparée par des virgules
des valeurs suivantes : notq, notime et nohost. La valeur notq supprime les données
structurées de qualité de temps du message soumis (les informations de qualité de
temps montrent si l’horloge locale était synchronisée, et le nombre maximal de
microsecondes de décalage possible de l’horodatage). La valeur notime (qui implique
notq) supprime tout l’horodatage de l’expéditeur au format ISO 8601, y compris les
microsecondes et le fuseau horaire. La valeur nohost supprime les informations de
gethostname(2) de l’en-tête du message.
Le protocole RFC 5424 est utilisé par défaut par logger depuis la version 2.26.
-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 la socket du journal système.
--socket-errors[=mode]
Afficher les erreurs sur les connexions de socket UNIX. Le mode peut prendre la
valeur off, on ou auto. En mode auto, logger détectera si le processus
d’initialisation est systemd, et si cette hypothèse est exacte, /dev/log peut être
utilisé tôt au démarrage. L’absence de /dev/log des autres systèmes
d’initialisation ne provoquera pas d’erreur, ce qui est identique à l’envoi de
messages en utilisant l’appel système openlog(3). logger(1) avant la version 2.26
utilisait openlog, et était donc incapable de détecter la perte de messages envoyés
aux sockets UNIX.
Le mode par défaut est auto. Quand les erreurs ne sont pas activées, les messages
perdus ne sont pas communiqués avec pour conséquence une valeur de retour indiquant
la réussite de l’appel de logger(1).
-- Terminer la liste des arguments. Cela permet au message de commencer avec un tiret
(« - »).
-V, --version
Afficher les informations sur la version et quitter.
-h, --help
Afficher un texte d'aide puis quitter.
VALEUR DE RETOUR
Le code de retour est 0 quand logger réussit et strictement supérieur à 0 en cas d'erreur.
SERVICES ET NIVEAU
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
syslog
user
uucp
local0
à
local7
security synonyme obsolète d’auth
Les noms de niveau possibles sont :
emerg
alert
crit
err
warning
notice
info
debug
panic synonyme obsolète d’emerg
error synonyme obsolète d’err
warn synonyme obsolète de warning
Pour l'ordre des priorités et les buts supposés de ces services et 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)
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 ⟨ftp://ftp.kernel.org/pub/linux/utils/util-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.