openlog

(PHP 3, PHP 4 )

openlog -- A rendszer naplózóval való kapcsolat nyitása

Leírás

int openlog ( string ident, int option, int facility)

Az openlog() függvény segítségéval nyithatunk egy program számára kapcsolatot a rendszer naplózóval. Az ident argumentumban megadott szöveg minden naplóüzenet elejére kerül. Az option és a facility lehetséges értékei alant találhatóak. Az option paraméterrel jelezhetőek a különleges opciók, amik belejáthszhatnak a naplózás mikéntjébe. Kicsit lejjebb található róluk táblázat. A facility paraméterben adható meg, milyen csoporthoz tartozó program küldte ezt a naplóüzenetet. Azt, hogy milyen facility típussal hogy bánjon a syslog, azt a gépünk syslog konfigurációjában lehet részletezni. Az openlog() függvény használata nem szükségszerű, mivel a syslog() ezt amúgy is megteszi, ha szükség van rá. Ebben az esetben az ident paraméter FALSE lesz.

Táblázat 1. openlog() Opciók

KonstansLeírás
LOG_CONS bárminemű hiba esetén, ami a rendszer naplózó felé adatot küldés folyamán felmerül, küldje azt egyenesen a rendszer konzoljára
LOG_NDELAY azonnali kapcsolatnyitás a rendszer-naplózóhoz
LOG_ODELAY (alapértelmezett) várjon a csatlakozással, amíg az első naplóüzenet meg nem érkezik
LOG_PERRORa naplóüzeneteket az alapértelmezett hibakimenetre is küldje
LOG_PIDminden üzenethez mellékelje a processzazonosítót (PID) is
Ezen opciók közül egyet, de akár többet is fel lehet használni. Több opció megadása esetén az opciók közt 'vagy' kapcsolatot kell létrehozni. Amennyiben például egy azonnal nyitandó kapcsolat kell, ami írjon a konzolra és a PID-eket is mellékelje, azt igy kell megadni: LOG_CONS | LOG_NDELAY | LOG_PID

Táblázat 2. openlog() Szolgáltatás csoportok (facility paraméter)

KonstansLeírás
LOG_AUTH biztonsági/authorizációs üzenetek (ehelyett a LOG_AUTHPRIV-et használja, amely rendszerekben ez lehetséges)
LOG_AUTHPRIVbiytonsági/authorizációs üzenetek (privát)
LOG_CRONclock daemon (cron és at)
LOG_DAEMONegyéb rendszer daemon-ok
LOG_KERNkernel üzenetek
LOG_LOCAL0 ... LOG_LOCAL7helyi használatra fentartott
LOG_LPRsoros nyomtató alrendszer
LOG_MAILlevél alrendszer
LOG_NEWSUSENET news alrendszer
LOG_SYSLOGa syslogd saját belső üzenetei
LOG_USERáltalános, felhasználó szinten történt bejegyzés
LOG_UUCPUUCP alrendszer

Lásd még: define_syslog_variables(), syslog() és closelog()!