'\" t .\" Title: logger .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.23 .\" Date: 2025-03-29 .\" Manual: Comenzi utilizator .\" Source: util-linux 2.41 .\" Language: English .\" .TH "LOGGER" "1" "2025-03-29" "util\-linux 2.41" "Comenzi utilizator" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l .de URL \fI\\$2\fP <\\$1>\\$3 .. .als MTO URL .if \n[.g] \{\ . mso www.tmac . am URL . ad l . . . am MTO . ad l . . . LINKSTYLE blue R < > .\} .SH "NUME" logger \- introduce mesaje în jurnalul sistemului .SH "REZUMAT" .sp \fBlogger\fP [opțiuni] \fImesaj\fP .SH "DESCRIERE" .sp \fBlogger\fP face înregistrări în jurnalul sistemului. .sp Atunci când este prezent argumentul opțional \fImesaj\fP, acesta este scris în jurnal. Dacă acesta nu este prezent și nici opțiunea \fB\-f\fP nu este furnizată, atunci se înregistrează intrarea standard. .SH "OPȚIUNI" .sp \fB\-d\fP, \fB\-\-udp\fP .RS 4 Utilizează numai datagrame (UDP). În mod implicit, conexiunea este încercată în portul syslog definit în \fI/etc/services\fP, care este adesea 514. .sp A se vedea, de asemenea, \fB\-\-server\fP și \fB\-\-socket\fP pentru a specifica unde să se conecteze. .RE .sp \fB\-e\fP, \fB\-\-skip\-empty\fP .RS 4 Ignoră liniile goale la procesarea fișierelor. O linie goală este definită ca fiind o linie fără niciun caracter. Astfel, o linie compusă numai din spații albe NU este considerată goală. Rețineți că atunci când este specificată opțiunea \fB\-\-prio\-prefix\fP, prioritatea nu face parte din linie. Astfel, o linie goală în acest mod este o linie care nu are niciun caracter după prefixul de prioritate (de exemplu, \fB<13>\fP). .RE .sp \fB\-f\fP, \fB\-\-file\fP \fIfișier\fP .RS 4 Înregistrează conținutul fișierului \fIfilșier\fP specificat. Această opțiune nu poate fi combinată cu un mesaj din linia de comandă. .RE .sp \fB\-i\fP .RS 4 Înregistrează PID\-ul procesului \fBlogger\fP la fiecare linie. .RE .sp \fB\-\-id\fP[\fB=\fP\fIid\fP] .RS 4 Înregistrează PID\-ul procesului \fBlogger\fP la fiecare linie. Atunci când se specifică argumentul opțional \fIid\fP, acesta este utilizat în locul PID\-ului comenzii \fBlogger\fP. Utilizarea lui \fB\-\-id=$$\fP (PPID) este recomandată în scripturile care trimit mai multe mesaje. .sp Rețineți că infrastructura de jurnalizare a sistemului (de exemplu, \fBsystemd\fP atunci când ascultă pe \fI/dev/log\fP) poate urma acreditările locale ale soclului pentru a suprascrie PID\-ul specificat în mesaj. \fBlogger\fP(1) este capabil să definească aceste acreditări de soclu la \fIid\-ul\fP dat, dar numai dacă aveți permisiuni de root și dacă există un proces cu PID\-ul specificat, altfel acreditările de soclu nu sunt modificate și problema este ignorată în tăcere. .RE .sp \fB\-\-journald\fP[\fB=\fP\fIfișier\fP] .RS 4 Scrieți o intrare în jurnalul \fBsystemd\fP. Intrarea este citită din \fIfișierul\fP dat, atunci când este specificat, în caz contrar de la intrarea standard. Fiecare linie trebuie să înceapă cu un câmp acceptat de \fBjournald\fP; a se vedea \fBsystemd.journal\-fields\fP(7) pentru detalii. Utilizarea unui câmp MESSAGE_ID este, în general, o idee bună, deoarece facilitează găsirea intrărilor. Exemple: .RS 3 .ll -.6i .sp .if n .RS 4 .nf .fam C logger \-\-journald <\fP. .sp Dacă prefixul nu conține nicio facilitate, facilitatea este cea specificată în mod implicit de opțiunea \fB\-p\fP. În mod similar, dacă nu este furnizat niciun prefix, linia este înregistrată folosind \fIprioritatea\fP dată cu \fB\-p\fP. .sp Această opțiune nu afectează un mesaj din linia de comandă. .RE .sp \fB\-\-rfc3164\fP .RS 4 Utilizează protocolul BSD syslog \c .URL "https://tools.ietf.org/html/rfc3164" "RFC 3164" "" BSD pentru a trimite mesaje către un server la distanță. .RE .sp \fB\-\-rfc5424\fP[\fB=\fP\fIfără\fP] .RS 4 Utilizează protocolul syslog \c .URL "https://tools.ietf.org/html/rfc5424" "RFC 5424" "" pentru a trimite mesaje către un server la distanță. Argumentul opțional \fIfără\fP poate fi o listă separată prin virgule cu următoarele valori: \fBnotq\fP, \fBnotime\fP, \fBnohost\fP. .sp Valoarea \fBnotq\fP suprimă datele structurate de calitate temporală din mesajul transmis. Informațiile referitoare la calitatea timpului arată dacă ceasul local a fost sincronizat plus numărul maxim de microsecunde cu care marcajul temporal poate fi deplasat. Calitatea timpului este, de asemenea, suprimată automat atunci când se specifică \fB\-\-sd\-id timeQuality\fP. .sp Valoarea \fBnotime\fP (care implică \fBnotq\fP) suprimă marca de timp completă a expeditorului care este în format ISO\-8601, inclusiv microsecundele și fusul orar. .sp Valoarea \fBnohost\fP suprimă informațiile \fBgethostname\fP(2) din antetul mesajului. .sp Protocolul RFC 5424 este protocolul implicit pentru \fBlogger\fP începând cu versiunea 2.26. .RE .sp \fB\-s\fP, \fB\-\-stderr\fP .RS 4 Afișează mesajul la iețirea de eroare standard, precum și în jurnalul sistemului. .RE .sp \fB\-\-sd\-id\fP \fIname\fP[\fB@\fP\fIcifre\fP] .RS 4 Specifies a structured data element ID for an RFC 5424 message header. The option has to be used before \fB\-\-sd\-param\fP to introduce a new element. The number of structured data elements is unlimited. The ID (\fIname\fP plus possibly \fB@\fP\fIdigits\fP) is case\-sensitive and uniquely identifies the type and purpose of the element. The same ID must not exist more than once in a message. The \fB@\fP\fIdigits\fP part is required for user\-defined non\-standardized IDs. .sp \fBlogger\fP generează în prezent numai elementul standardizat \fBtimeQuality\fP. RFC 5424 descrie, de asemenea, elementele \fBorigin\fP (cu parametrii \fBip\fP, \fBenterpriseId\fP, \fBsoftware\fP și \fBswVersion\fP) și \fBmeta\fP (cu parametrii \fBsequenceId\fP, \fBsysUpTime\fP și \fBlanguage\fP). ID\-urile acestor elemente pot fi specificate fără sufixul \fB@\fP\fIcifre\fP. .RE .sp \fB\-\-sd\-param\fP \fIname\fP=\fIvaloare\fP .RS 4 Specifică un parametru de element de date structurat, o pereche de nume și valoare. Opțiunea trebuie utilizată după \fB\-\-sd\-id\fP și poate fi specificată de mai multe ori pentru același element. Rețineți că ghilimelele din jurul lui \fIvaloare\fP sunt obligatorii și trebuie să fie eliminate din linia de comandă. .sp .if n .RS 4 .nf .fam C logger \-\-rfc5424 \-\-sd\-id zoo@123\& \(rs \-\-sd\-param tigrul="flămând"\& \(rs \-\-sd\-param zebra="aleargă"\& \(rs \-\-sd\-id manager@123\& \(rs \-\-sd\-param onMeeting="yes"\& \(rs "acesta este mesajul" .fam .fi .if n .RE .sp produce: .sp \fB<13>1 2015\-10\-01T14:07:59.168662+02:00 ws kzak \- \- [timeQuality tzKnown="1" isSynced="1" syncAccuracy="218616"][zoo@123 tigrul="flămând" zebra="aleargă"][manager@123 onMeeting="yes"] acesta este mesajul\fP .RE .sp \fB\-S\fP, \fB\-\-size\fP \fIdimensiunea\fP .RS 4 Stabilește dimensiunea maximă permisă a mesajului la \fIdimensiunea\fP. Valoarea implicită este de 1KiB caractere, care este limita utilizată în mod tradițional și specificată în RFC 3164. Odată cu RFC 5424, această limită a devenit flexibilă. O presupunere bună este că receptorii RFC 5424 pot procesa cel puțin mesaje de 4KiB. .sp Majoritatea receptoarelor acceptă mesaje mai mari de 1KiB prin orice tip de protocol syslog. Ca atare, opțiunea \fB\-\-size\fP afectează \fBlogger\fP în toate cazurile (nu numai atunci când a fost utilizată opțiunea \fB\-\-rfc5424\fP). .sp Notă: limita de dimensiune a mesajului limitează dimensiunea totală a mesajului, inclusiv antetul syslog. Dimensiunile antetului variază în funcție de opțiunile selectate și de lungimea numelui de gazdă. Ca regulă generală, de obicei, antetele nu depășesc 50\-80 de caractere. Atunci când se selectează o dimensiune maximă a mesajului, este important să se asigure că și receptorul acceptă dimensiunea maximă, altfel mesajele pot fi trunchiate. Din nou, ca regulă generală, o dimensiune a mesajului de doi până la patru Kio ar trebui să fie în general OK, în timp ce orice dimensiune mai mare trebuie verificată pentru a se asigura că funcționează. .RE .sp \fB\-\-socket\-errors\fP \fImod\fP .RS 4 Afișează erorile legate de conexiunile de soclu Unix. \fImod\fP poate fi \fBoff\fP, \fBon\fP sau \fBauto\fP. Atunci când modul este \fBauto\fP (valoarea implicită), \fBlogger\fP va detecta dacă procesul de inițiere este \fBsystemd\fP(1), iar dacă este așa, se presupune că \fI/dev/log\fP poate fi utilizat la începutul procesului de inițiere. Lipsa \fI/dev/log\fP pe alte sisteme de pornire nu va cauza erori, la fel ca atunci când se utilizează apelul de sistem \fBopenlog\fP(3). \fBlogger\fP(1) înainte de versiunea 2.26 folosea \fBopenlog\fP(3) și, prin urmare, nu putea detecta pierderea mesajelor trimise către soclurile Unix. .sp Atunci când erorile nu sunt activate, mesajele pierdute nu sunt comunicate și vor avea ca rezultat o stare de ieșire cu succes a invocării \fBlogger\fP(1). .RE .sp \fB\-T\fP, \fB\-\-tcp\fP .RS 4 Utilizează numai fluxul (TCP). În mod implicit, conexiunea este încercată la portul \fIsyslog\-conn\fP definit în \fI/etc/services\fP, care este adesea \fI601\fP. .sp A se vedea, de asemenea, \fB\-\-server\fP și \fB\-\-socket\fP pentru a specifica unde să se conecteze. .RE .sp \fB\-t\fP, \fB\-\-tag\fP \fImarcaj\fP .RS 4 Marchează fiecare linie care urmează să fie înregistrată cu \fImarcajul\fP specificat. Marcajul implicit este numele utilizatorului conectat la terminal (sau un nume de utilizator bazat pe ID\-ul efectiv al utilizatorului). .RE .sp \fB\-u\fP, \fB\-\-socket\fP \fIsoclu\fP .RS 4 Scrie pe \fIsoclul\fP specificat în loc să scrie pe soclul de jurnal de sistem. .RE .sp \fB\-\-\fP .RS 4 Încheie lista de argumente. Acest lucru permite ca \fImesajul\fP să înceapă cu o cratimă (\-). .RE .sp \fB\-h\fP, \fB\-\-help\fP .RS 4 Afișează acest mesaj de ajutor și iese. .RE .sp \fB\-V\fP, \fB\-\-version\fP .RS 4 Afișează versiunea și iese. .RE .SH "STARE DE IEȘIRE" .sp Aplicația \fBlogger\fP iese cu 0 în caz de succes și >0 dacă apare o eroare. .SH "FACILITĂȚI ȘI NIVELE" .sp Numele de facilități valide sunt: .sp \fBauth\fP + .br \fBauthpriv\fP pentru informații de securitate de natură sensibilă + .br \fBcron\fP .br .sp \fBdaemon\fP + .br \fBftp\fP + .br \fBkern\fP nu poate fi generat de un proces din spațiul utilizatorului, este convertit automat în \fBuser\fP .br .sp \fBlpr\fP .br \fBmail\fP .br \fBnews\fP .br \fBsyslog\fP .br \fBuser\fP .br \fBuucp\fP .br \fBlocal0\fP .br to .br \fBlocal7\fP .br \fBsecurity\fP sinonim depreciat pentru \fBauth\fP .sp Numele de nivele valide sunt: .sp \fBemerg\fP + .br \fBalert\fP + .br \fBcrit\fP + .br \fBerr\fP + .br \fBwarning\fP + .br \fBnotice\fP + .br \fBinfo\fP + .br \fBdebug\fP + .br \fBpanic\fP sinonim depreciat pentru \fBemerg\fP + .br \fBerror\fP sinonim depreciat pentru \fBerr\fP + .br \fBwarn\fP sinonim depreciat pentru \fBwarning\fP .br .sp Pentru ordinea de prioritate și scopurile prevăzute pentru aceste facilități și nivele, a se vedea \fBsyslog\fP(3). .SH "ÎN CONFORMITATE CU" .sp Se așteaptă ca instrumentul \fBlogger\fP să fie compatibil cu IEEE Std 1003.2 ("POSIX.2"). .SH "EXEMPLE" .RS 3 .ll -.6i .sp logger Sistemul a fost repornit .sp logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc .sp logger \-n loghost.exemplu.com Sistemul a fost repornit .br .RE .ll .SH "AUTORI" .sp Comanda \fBlogger\fP a fost scrisă inițial de Universitatea din California în 1983\-1993 și rescrisă ulterior de \c .MTO "kzak\(atredhat.com" "Karel Zak" "," .MTO "rgerhards\(atadiscon.com" "Rainer Gerhards" "" și .MTO "kerolasa\(atiki.fi" "Sami Kerola" "." .SH "CONSULTAȚI ȘI" .sp \fBjournalctl\fP(1), \fBsyslog\fP(3), \fBsystemd.journal\-fields\fP(7) .SH "RAPORTAREA ERORILOR" .sp Pentru rapoarte de eroare, folosiți \c .URL "https://github.com/util\-linux/util\-linux/issues" "sistemul de urmărire al erorilor" "." .SH "DISPONIBILITATE" .sp Comanda \fBlogger\fP face parte din pachetul util\-linux care poate fi descărcat de la \c .URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."