LOGGER(1) Comenzi utilizator LOGGER(1) NUME logger - introduce mesaje in jurnalul sistemului REZUMAT logger [opiuni] mesaj DESCRIERE logger face inregistrari in jurnalul sistemului. Atunci cand este prezent argumentul opional mesaj, acesta este scris in jurnal. Daca acesta nu este prezent i nici opiunea -f nu este furnizata, atunci se inregistreaza intrarea standard. OPIUNI -d, --udp Utilizeaza numai datagrame (UDP). In mod implicit, conexiunea este incercata in portul syslog definit in /etc/services, care este adesea 514. A se vedea, de asemenea, --server i --socket pentru a specifica unde sa se conecteze. -e, --skip-empty Ignora liniile goale la procesarea fiierelor. O linie goala este definita ca fiind o linie fara niciun caracter. Astfel, o linie compusa numai din spaii albe NU este considerata goala. Reinei ca atunci cand este specificata opiunea --prio-prefix, prioritatea nu face parte din linie. Astfel, o linie goala in acest mod este o linie care nu are niciun caracter dupa prefixul de prioritate (de exemplu, <13>). -f, --file fiier Inregistreaza coninutul fiierului filier specificat. Aceasta opiune nu poate fi combinata cu un mesaj din linia de comanda. -i Inregistreaza PID-ul procesului logger la fiecare linie. --id[=id] Inregistreaza PID-ul procesului logger la fiecare linie. Atunci cand se specifica argumentul opional id, acesta este utilizat in locul PID-ului comenzii logger. Utilizarea lui --id=$$ (PPID) este recomandata in scripturile care trimit mai multe mesaje. Reinei ca infrastructura de jurnalizare a sistemului (de exemplu, systemd atunci cand asculta pe /dev/log) poate urma acreditarile locale ale soclului pentru a suprascrie PID-ul specificat in mesaj. logger(1) este capabil sa defineasca aceste acreditari de soclu la id-ul dat, dar numai daca avei permisiuni de root i daca exista un proces cu PID-ul specificat, altfel acreditarile de soclu nu sunt modificate i problema este ignorata in tacere. --journald[=fiier] Scriei o intrare in jurnalul systemd. Intrarea este citita din fiierul dat, atunci cand este specificat, in caz contrar de la intrarea standard. Fiecare linie trebuie sa inceapa cu un camp acceptat de journald; a se vedea systemd.journal-fields(7) pentru detalii. Utilizarea unui camp MESSAGE_ID este, in general, o idee buna, deoarece faciliteaza gasirea intrarilor. Exemple: logger --journald <i ca --journald va ignora valorile altor opiuni, cum ar fi prioritatea. Daca este nevoie de prioritate, aceasta trebuie sa fie in cadrul datelor de intrare i sa se utilizeze campul PRIORITY. Simpla execuie a journalctl(1) va afia campul MESSAGE. Utilizai journalctl --output json-pretty pentru a vedea restul campurilor. Pentru a include linii noi in MESSAGE, specificai MESSAGE de mai multe ori. Acest lucru este tratat ca un caz special, alte campuri vor fi stocate ca o matrice in jurnal daca apar de mai multe ori. --msgid id-mesaj Definete campul MSGID RFC 5424 . Reinei ca nu este permis caracterul spaiu in interiorul lui msgid. Aceasta opiune este utilizata numai daca este specificat i --rfc5424; in caz contrar, este ignorata in mod silenios. -n, --server server Scrie pe serverul syslog de la distana specificat in loc sa scrie pe soclul de jurnal de sistem. Cu excepia cazului in care se specifica --udp sau --tcp, logger va incerca mai intai sa foloseasca UDP, dar daca acest lucru eueaza, se incearca o conexiune TCP. --no-act Determina efectuarea tuturor operaiilor, cu excepia scrierii mesajului de jurnal in jurnalul sistemului i a eliminarii conexiunii cu jurnalul. Aceasta opiune poate fi utilizata impreuna cu --stderr in scopuri de testare. --octet-count Utilizeaza metoda de incadrare RFC 6587 de numarare a octeilor pentru trimiterea mesajelor. Atunci cand aceasta opiune nu este utilizata, valoarea implicita este ca nu exista incadrare pentru UDP, iar pentru TCP, se utilizeaza incadrarea netransparenta RFC6587 (cunoscuta i sub numele de ,,octet stuffing"). -P, --port port Utilizeaza portul specificat. Atunci cand aceasta opiune nu este specificata, portul este implicit syslog pentru conexiunile udp i syslog-conn pentru conexiunile tcp. -p, --priority prioritatea Introduce mesajul in jurnal cu prioritatea specificata. Prioritatea poate fi specificata numeric sau ca o pereche facilitate.nivel. De exemplu, -p local3.info inregistreaza mesajul ca fiind informativ in facilitatea local3. Valoarea implicita este user.notice. --prio-prefix Cauta un prefix syslog pe fiecare linie citita de la intrarea standard. Acest prefix este un numar zecimal intre paranteze unghiulare care codifica atat facilitatea, cat i nivelul. Numarul este construit prin inmulirea facilitaii cu 8 i apoi prin adaugarea nivelului. De exemplu, local0.info, care inseamna facilitate=16 i nivel=6, devine <134>. Daca prefixul nu conine nicio facilitate, facilitatea este cea specificata in mod implicit de opiunea -p. In mod similar, daca nu este furnizat niciun prefix, linia este inregistrata folosind prioritatea data cu -p. Aceasta opiune nu afecteaza un mesaj din linia de comanda. --rfc3164 Utilizeaza protocolul BSD syslog RFC 3164 BSD pentru a trimite mesaje catre un server la distana. --rfc5424[=fara] Utilizeaza protocolul syslog RFC 5424 pentru a trimite mesaje catre un server la distana. Argumentul opional fara poate fi o lista separata prin virgule cu urmatoarele valori: notq, notime, nohost. Valoarea notq suprima datele structurate de calitate temporala din mesajul transmis. Informaiile referitoare la calitatea timpului arata daca ceasul local a fost sincronizat plus numarul maxim de microsecunde cu care marcajul temporal poate fi deplasat. Calitatea timpului este, de asemenea, suprimata automat atunci cand se specifica --sd-id timeQuality. Valoarea notime (care implica notq) suprima marca de timp completa a expeditorului care este in format ISO-8601, inclusiv microsecundele i fusul orar. Valoarea nohost suprima informaiile gethostname(2) din antetul mesajului. Protocolul RFC 5424 este protocolul implicit pentru logger incepand cu versiunea 2.26. -s, --stderr Afieaza mesajul la ieirea de eroare standard, precum i in jurnalul sistemului. --sd-id name[@cifre] Specifies a structured data element ID for an RFC 5424 message header. The option has to be used before --sd-param to introduce a new element. The number of structured data elements is unlimited. The ID (name plus possibly @digits) 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 @digits part is required for user-defined non-standardized IDs. logger genereaza in prezent numai elementul standardizat timeQuality. RFC 5424 descrie, de asemenea, elementele origin (cu parametrii ip, enterpriseId, software i swVersion) i meta (cu parametrii sequenceId, sysUpTime i language). ID-urile acestor elemente pot fi specificate fara sufixul @cifre. --sd-param name=valoare Specifica un parametru de element de date structurat, o pereche de nume i valoare. Opiunea trebuie utilizata dupa --sd-id i poate fi specificata de mai multe ori pentru acelai element. Reinei ca ghilimelele din jurul lui valoare sunt obligatorii i trebuie sa fie eliminate din linia de comanda. logger --rfc5424 --sd-id zoo@123 \ --sd-param tigrul="flamand" \ --sd-param zebra="alearga" \ --sd-id manager@123 \ --sd-param onMeeting="yes" \ "acesta este mesajul" produce: <13>1 2015-10-01T14:07:59.168662+02:00 ws kzak - - [timeQuality tzKnown="1" isSynced="1" syncAccuracy="218616"][zoo@123 tigrul="flamand" zebra="alearga"][manager@123 onMeeting="yes"] acesta este mesajul -S, --size dimensiunea Stabilete dimensiunea maxima permisa a mesajului la dimensiunea. Valoarea implicita este de 1KiB caractere, care este limita utilizata in mod tradiional i specificata in RFC 3164. Odata cu RFC 5424, aceasta limita a devenit flexibila. O presupunere buna este ca receptorii RFC 5424 pot procesa cel puin mesaje de 4KiB. Majoritatea receptoarelor accepta mesaje mai mari de 1KiB prin orice tip de protocol syslog. Ca atare, opiunea --size afecteaza logger in toate cazurile (nu numai atunci cand a fost utilizata opiunea --rfc5424). Nota: limita de dimensiune a mesajului limiteaza dimensiunea totala a mesajului, inclusiv antetul syslog. Dimensiunile antetului variaza in funcie de opiunile selectate i de lungimea numelui de gazda. Ca regula generala, de obicei, antetele nu depaesc 50-80 de caractere. Atunci cand se selecteaza o dimensiune maxima a mesajului, este important sa se asigure ca i receptorul accepta dimensiunea maxima, altfel mesajele pot fi trunchiate. Din nou, ca regula generala, o dimensiune a mesajului de doi pana la patru Kio ar trebui sa fie in general OK, in timp ce orice dimensiune mai mare trebuie verificata pentru a se asigura ca funcioneaza. --socket-errors mod Afieaza erorile legate de conexiunile de soclu Unix. mod poate fi off, on sau auto. Atunci cand modul este auto (valoarea implicita), logger va detecta daca procesul de iniiere este systemd(1), iar daca este aa, se presupune ca /dev/log poate fi utilizat la inceputul procesului de iniiere. Lipsa /dev/log pe alte sisteme de pornire nu va cauza erori, la fel ca atunci cand se utilizeaza apelul de sistem openlog(3). logger(1) inainte de versiunea 2.26 folosea openlog(3) i, prin urmare, nu putea detecta pierderea mesajelor trimise catre soclurile Unix. Atunci cand erorile nu sunt activate, mesajele pierdute nu sunt comunicate i vor avea ca rezultat o stare de ieire cu succes a invocarii logger(1). -T, --tcp Utilizeaza numai fluxul (TCP). In mod implicit, conexiunea este incercata la portul syslog-conn definit in /etc/services, care este adesea 601. A se vedea, de asemenea, --server i --socket pentru a specifica unde sa se conecteze. -t, --tag marcaj Marcheaza fiecare linie care urmeaza sa fie inregistrata cu marcajul specificat. Marcajul implicit este numele utilizatorului conectat la terminal (sau un nume de utilizator bazat pe ID-ul efectiv al utilizatorului). -u, --socket soclu Scrie pe soclul specificat in loc sa scrie pe soclul de jurnal de sistem. -- Incheie lista de argumente. Acest lucru permite ca mesajul sa inceapa cu o cratima (-). -h, --help Afieaza acest mesaj de ajutor i iese. -V, --version Afieaza versiunea i iese. STARE DE IEIRE Aplicaia logger iese cu 0 in caz de succes i >0 daca apare o eroare. FACILITAI I NIVELE Numele de facilitai valide sunt: auth + authpriv pentru informaii de securitate de natura sensibila + cron daemon + ftp + kern nu poate fi generat de un proces din spaiul utilizatorului, este convertit automat in user lpr mail news syslog user uucp local0 to local7 security sinonim depreciat pentru auth Numele de nivele valide sunt: emerg + alert + crit + err + warning + notice + info + debug + panic sinonim depreciat pentru emerg + error sinonim depreciat pentru err + warn sinonim depreciat pentru warning Pentru ordinea de prioritate i scopurile prevazute pentru aceste facilitai i nivele, a se vedea syslog(3). IN CONFORMITATE CU Se ateapta ca instrumentul logger sa fie compatibil cu IEEE Std 1003.2 ("POSIX.2"). EXEMPLE logger Sistemul a fost repornit logger -p local0.notice -t HOSTIDM -f /dev/idmc logger -n loghost.exemplu.com Sistemul a fost repornit AUTORI Comanda logger a fost scrisa iniial de Universitatea din California in 1983-1993 i rescrisa ulterior de Karel Zak , Rainer Gerhards i Sami Kerola . CONSULTAI I journalctl(1), syslog(3), systemd.journal-fields(7) RAPORTAREA ERORILOR Pentru rapoarte de eroare, folosii sistemul de urmarire al erorilor . DISPONIBILITATE Comanda logger face parte din pachetul util-linux care poate fi descarcat de la Linux Kernel Archive . util-linux 2.41 2025-03-29 LOGGER(1)