Scroll to navigation

syslog(3) Library Functions Manual syslog(3)

NUME

trimite mesaje către jurnalul de sistem

BIBLIOTECA

Biblioteca C standard (libc, -lc)

SINOPSIS

#include <syslog.h>
void openlog(const char *ident, int option, int facility);
void syslog(int priority, const char *format, ...);
void closelog(void);
void vsyslog(int priority, const char *format, va_list ap);

Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați feature_test_macros(7)):

vsyslog():



    Începând cu glibc 2.19:


        _DEFAULT_SOURCE


    glibc 2.19 și versiunile anterioare:


        _BSD_SOURCE

DESCRIERE

openlog()

openlog() deschide o conexiune la jurnalul de sistem pentru un program.

Șirul indicat de ident este atașat fiecărui mesaj și este de obicei stabilit la numele programului. Dacă ident este NULL, se utilizează numele programului. (POSIX.1-2008 nu specifică comportamentul atunci când ident este NULL).

Argumentul option specifică fanioanele care controlează funcționarea openlog() și apelurile ulterioare la syslog(). Argumentul facility stabilește o valoare implicită care va fi utilizată în cazul în care nu este specificată niciuna în apelurile ulterioare la syslog(). Valorile care pot fi specificate pentru option și facility sunt descrise mai jos.

Utilizarea lui openlog() este opțională; acesta va fi apelat automat de syslog() dacă este necesar, caz în care ident va fi implicit NULL.

syslog() și vsyslog()

syslog() generează un mesaj de jurnal, care va fi distribuit de syslogd(8).

Argumentul priority este format prin asocierea OR logic a unei valori facility și a unei valori level (descrisă mai jos). În cazul în care nicio valoare facility nu este combinată prin OR logic în priority, se utilizează valoarea implicită stabilită de openlog() sau, dacă nu a existat niciun apel openlog() anterior, se utilizează valoarea implicită LOG_USER.

Argumentele rămase sunt un format, ca în printf(3), și orice argumente cerute de format, cu excepția faptului că secvența de două caractere %m va fi înlocuită de șirul de mesaje de eroare strerror(errno). Șirul de formate nu trebuie să includă un caracter de sfârșit de linie nouă.

Funcția vsyslog() îndeplinește aceeași sarcină ca și funcția syslog(), cu diferența că aceasta preia un set de argumente care au fost obținute utilizând macroinstrucțiunile de listă de argumente variabile stdarg(3).

closelog()

closelog() închide descriptorul de fișier utilizat pentru a scrie în jurnalul sistemului. Utilizarea closelog() este opțională.

Valori pentru option (opțiune)

Argumentul option pentru openlog() este o mască de biți construită prin asocierea pri OR logic a oricăreia dintre următoarele valori:

Scrie direct în consola sistemului dacă există o eroare la trimiterea către jurnalul de sistem.
Deschide conexiunea imediat (în mod normal, conexiunea este deschisă atunci când este înregistrat primul mesaj). Acest lucru poate fi util, de exemplu, în cazul în care un chroot(2) ulterior ar face ca numele de rută utilizat intern de facilitatea de jurnalizare să fie inaccesibil.
Nu așteaptă procesele copil care ar fi putut fi create în timpul înregistrării mesajului; (biblioteca GNU C nu creează un proces copil, deci această opțiune nu are niciun efect în Linux).
Reciproca lui LOG_NDELAY; deschiderea conexiunii este amânată până la apelarea lui syslog(); (aceasta este valoarea implicită și nu este necesar să fie specificată).
(Nu în POSIX.1-2001 sau POSIX.1-2008.) De asemenea, înregistrează mesajul la stderr.
Include PID-ul apelantului cu fiecare mesaj.

Valori pentru facility (facilitate)

Argumentul facility este utilizat pentru a specifica ce tip de program înregistrează mesajul. Acest lucru permite fișierului de configurare să specifice că mesajele de la diferite facilități vor fi tratate diferit.

mesaje de securitate/autorizare
mesaje de securitate/autorizare (private)
demonul ceasului (cron și at)
demoni de sistem fără valoare de facilitate(facility) separată
demon FTP
mesaje ale nucleului (acestea nu pot fi generate de procesele utilizatorului)
rezervate pentru uz local
subsistem de imprimantă de linie
subsistemul de poștă electronică
subsistemul de știri USENET
mesaje generate intern de syslogd(8)
mesaje generice la nivel de utilizator
subsistemul UUCP

Valori pentru level (nivel)

Acesta determină importanța mesajului. Nivelurile sunt, în ordinea descrescătoare a importanței:

sistemul este inutilizabil
trebuie să se ia imediat măsuri
condiții critice
condiții de eroare
condiții de avertizare
condiție normală, dar semnificativă
mesaj informativ
mesaj de nivel de depanare

Funcția setlogmask(3) poate fi utilizată pentru a restricționa înregistrarea numai la nivelurile specificate.

ATRIBUTE

Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

Interfață Atribut Valoare
openlog(), closelog() Siguranța firelor MT-Safe
syslog(), vsyslog() Siguranța firelor MT-Safe env locale

STANDARDE

POSIX.1-2008.
Niciunul.

ISTORIC

4.2BSD, SUSv2, POSIX.1-2001.
4.3BSD, SUSv2, POSIX.1-2001.
4.3BSD-Reno.

POSIX.1-2001 specifică doar valorile LOG_USER și LOG_LOCAL* pentru facility. Cu toate acestea, cu excepția valorilor LOG_AUTHPRIV și LOG_FTP, celelalte valori facility apar în majoritatea sistemelor UNIX.

Valoarea LOG_PERROR pentru option nu este specificată de POSIX.1-2001 sau POSIX.1-2008, dar este disponibilă în majoritatea versiunilor de UNIX.

NOTE

Argumentul ident în apelul lui openlog() este probabil stocat ca atare. Astfel, dacă șirul la care indică este modificat, syslog() poate începe să antepună șirul modificat, iar dacă șirul la care indică încetează să mai existe, rezultatele sunt nedefinite. Cel mai portabil mod este să se utilizeze o constantă de șir de caractere.

Nu treceți niciodată un șir de caractere cu date furnizate de utilizator ca format, utilizați în schimb următorul format:


syslog(priority, "%s", string);

CONSULTAȚI ȘI

journalctl(1), logger(1), setlogmask(3), syslog.conf(5), syslogd(8)

TRADUCERE

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.

2 mai 2024 Pagini de manual de Linux 6.9.1