Parametry
| logname | jmΘno logu, velikost pφsmen se ignoruje |
| pathname | jmΘno souboru, do n∞ho₧ se bude log zapisovat |
| format | formßt °ßdky v logu |
Od verze
7.0
Hodnota funkce
Funkce vrßtφ TRUE pokud usp∞je. Vracφ FALSE p°i chyb∞, kterß m∙₧e b²t zp∙sobena tφm, ₧e log zadanΘho jmΘna ji₧ existuje, ₧e se nepoda°φ vytvo°it Φi otev°φt soubor na zadanΘm mφst∞, nebo nedostatkem pam∞ti.
Popis
Funkce vytvo°φ nov² log a p°id∞lφ mu jmΘno logname, kterΘ lze vyu₧φvat ve funkci _sqp_trace. Log se zapisuje do souboru zadanΘho parametrem pathname. Pokud je pathname prßzdnΘ, soubor se vytvo°φ ve stejnΘm adresß°i jako zßkladnφ log serveru, pod jmΘnem logname a s p°φponou txt. Pokud zadan² soubor ji₧ existuje, bude se log zapisovat na jeho konec.
Zßkladnφ log serveru (oznaΦovan² prßzdn²m jmΘnem) je definovßn automaticky p°i startu serveru a nenφ t°eba pro n∞j tuto funkci volat.
Pokud je parametr format prßzdn², pak se log vytvß°φ ve standardnφm formßtu. OdliÜn² formßt lze zadat tak, ₧e se v parametru format uvede formßtovacφ °et∞zec znak∙ podle pravidel pro funkce sprinf jazyka C, v n∞m₧ se mφsta, do nich₧ majφ b²t dopln∞ny prom∞nnΘ informace, oznaΦφ takto:
%d - datum, den a m∞sφc%D- datum, den, m∞sφc a rok %t - Φas, hodina a minuta %T - Φas, hodina, minuta a sekunda %s - oznaΦenφ situace (jedno pφsmeno) %u - jmΘno u₧ivatele nebo slu₧ebnφho procesu %c - Φφslo klienta%m - text hlßÜenφ
Nap°φklad standardnφmu formßtu logu odpovφdß formßt "%d %t %s %u %m". Ve formßtovacφm °et∞zci lze uvΘst nejv²Üe 8 takov²ch parametr∙, dΘlka formßtovacφho °et∞zce je nejv²Üe 50 znak∙.
Pokud mß b²t obsah logu zarovnßn do sloupc∙ pevnΘ Üφ°ky, lze pou₧φt nap°φklad tento formßt:
"%D %t %s %4c %-31u %m"
Viz