r31: ...

[carnet-tools-cn.git] / README.CARNet

diff --git a/README.CARNet b/README.CARNet
index e8f8179..1ec6ee1 100644 (file)
--- a/README.CARNet
+++ b/README.CARNet
@@ -22,10 +22,17 @@ cp_get_ifmask <interface>
        Funkcija vraca IP netmask mreznog sucelja. U slucaju da nije
        naveden kao argument, vraca IP netmask od loopback sucelja (lo).
 
-cp_get_cidr <interface>
+cp_get_ifdefault [dev|addr]
 
-       Funkcija vraca CIDR mreznog sucelja. U slucaju da nije
-       naveden kao argument, vraca CIDR od loopback sucelja (lo).
+       Funkcija vraca naziv uredjaj ili adresu podrazumne rute (default
+       route).
+
+cp_get_netaddr <interface>
+
+       Funkcija vraca podmrezu mreznog sucelja u CIDR obliku.  U slucaju
+       da nije naveden <interface> argument, vraca CIDR sucelja preko
+       kojeg ide default route, a ako isti nije definiran, vraca CIDR
+       loopback sucelja (lo).
 
 cp_backup_conffile <file>
 
@@ -38,17 +45,61 @@ cp_check_and_sed <regexp> <sed> <file> [<file> ...]
        postoji, izvrsi sed program <sed> nad tim datotekama.  Najcesce se
        koristi za zamjenu stare vrijednosti postavke novom.
 
+cp_echo [-mailonly|-m] <string>
+
+cp_mail [-q] <package> <version>
+
+       U kombinaciji, ove funkcije sluze za slanje poruka na stdout _i_ na
+       mail rootu.  Koristiti za informacije koje svakako treba dostaviti
+       sistemcu (passwordi, nekompatibilne izmjene u konfiguraciji
+       kriticnih servisa), cak i ako ne cita dokumentaciju niti prati
+       poruke kod upgradea. :->
+
+       cp_echo se koristi umjesto echo.  Uz -m salje poruku samo na mail.
+       cp_mail se poziva na kraju (postinsta), kad posalje mail.  Bez
+       -q opcije cp_mail ce ispisati obavijest o slanju tog maila.
+
+       Ove dvije funkcije koriste globalnu varijablu CP_NOTICE u koju se
+       spremaju poruke za mail.
+
+cp_mv <new-file> <target-file>
 
+       Funkcija cija je namjena da novu datoteku <new-file> instalira kao
+       zadanu <target-file> datoteku, koja moze i/ili ne postojati. Ako ta
+       datoteka postoji onda se novoj dodjeljuje njeno vlasnistvo i modovi
+       pristupa. Operacija je atomicna.
 
-Svaka funkcija vraca argument u varijabli $RET, dok se prije startanja bilo
-koje funkcije mogu definirati varijable:
+       Funkcija cp_safe_file_replace je prikladna za koristenje kod raznih
+       sed-like izmjena neke postojece datoteke iako se za samo sed-anje
+       preporuca koristiti funkciju cp_check_and_sed.
+
+cp_yes_no [<prompt>]
+
+        Funkcija za jednostavni (y)es/(n)o dijalog. Odgovor y/n vraca u RET.
+       Valja napomenuti da je kao i sve ostalo sto trosi stdin/stdout 
+        nekompatibilan s debconfom (doticnog treba pogasiti prvo).
+
+cp_db_get_wrap <package>/<variable>
+
+        Wrapper za debconfovu funkciju db_get koji umjesto neke neocekivane
+        greske vrati prazni RET. Kome treba greska neka ga ne koristi.
+
+
+Funkcije cije ime pocinje sa cp_get_ pohranjuju rezultat u varijabli $RET,
+a one s prefiksom cp_check_ kao rezultat vracaju exit status.  U pozivnoj
+skripti se mogu definirati sljedece varijable koje utjecu na rad svih
+pomocnih funkcija:
 
 $CP_SCRIPT_DEBUG
 
-       Ukljucuje debugiranje (set -vx).
+       Potpomaze debugiranje (set -vx).
 
 $CP_ECHO_RETURN
 
-       Vracanje rezultata na STDIN i u varijabli $RET.
+       Vracanje rezultata na stdout i u varijabli $RET.
+       Ako se cp_ funkcija koja vraca string poziva unutar neke druge cp_
+       funkcije, treba iskljucivo koristiti $RET konvenciju, i sacuvati
+       prethodno stanje varijable CP_ECHO_RETURN.
+
 
 -- Ivan 'ico' Rako <irako@srce.hr>  Wed, 16 Mar 2005 14:25:14 +0100