# HG changeset patch # User viric@llimona # Date 1148986726 -7200 # Node ID a8776c046a530bf7665426108b6b501e2944645a # Parent c03287b2c3c13fd26825e38afb119e8dd215452d Readme adapted to the last version. diff -r c03287b2c3c1 -r a8776c046a53 README.txt --- a/README.txt Tue May 30 12:57:31 2006 +0200 +++ b/README.txt Tue May 30 12:58:46 2006 +0200 @@ -8,8 +8,8 @@ (Tiny C Compiler, http://fabrice.bellard.free.fr/tcc/ ): $ make -f Makefile.tcc -Per a testejar una mica el programa, hi ha un petit script de test que -requereix bash. +Per a testejar una mica el programa (no completament!), hi ha un petit script +de test que requereix bash. Per a execultar-lo: $ ./test.sh @@ -21,7 +21,7 @@ syslog_in_npipe Espera missatges per la named pipe (ha d'existir!) syslog_in_unix Crea i escolta el socket unix per missatges syslog_kernel Executa els anteriors programes, i llegeix de tots - alhora. + alhora. A més, inclou el tcp server. unix_writer Programa per escriure a un Unix socket @@ -34,8 +34,9 @@ from_udp=disabled to_udp_host=localhost to_udp_port=1235 -tcp_manager=1234 (No s'utilitza encara!) +tcp_manager=1234 (Port per on rebre els logs per tcp) log_file=file.log +pid_file=syslog.pid No hi poden haver espais; el format és = per cada línia. Si el fitxer de configuració "syslog.conf" no defineix res d'un paràmetre, @@ -49,8 +50,7 @@ El programa no gestiona bé lectures de múltiples missatges per cada crida read(). Només pot llegir un missatge per crida. -Això és perquè encara en prou feines he implementat alguna cosa de la -rfc 3164. +Això és perquè no he implementat completament l'especificació rfc3164. Els syslog_in_* entenen el missatge "close", cosa que fa que morin. Si moren tots els fills de syslog_kernel, el kernel també mor. @@ -69,7 +69,15 @@ El syslog_kernel pot passar missatges a un servidor udp. També pot escriure els missatges rebuts a un fitxer de log. -El syslog_kernel entén els senyals: +El syslog_kernel escriu el seu pid a pid_file. Si engeguem syslog_kernel i el +fitxer existeix amb el pid d'un syslog_kernel actiu, no s'engega un segon +syslog_kernel sino que s'envia SIGHUP a l'existent. + +El syslog_kernel inclou un servidor tcp per a poder consultar els logs. Quan +un client tcp es connecta a ell, s'envia el contingut del log_file (si +es fa servir), i es tanca la connexió. + +El syslog_kernel pare entén els senyals: - SIGHUP - rellegir i reaplicar el que digui el fitxer de configuració. - SIGTERM o SIGINT - matar els fills, i després morir ell. (Atenció - si apretem Control-C des d'un xterm, envia SIGINT al grup de