X-Git-Url: http://ftp.carnet.hr/carnet-debian/scm?a=blobdiff_plain;f=README.CARNet;h=1ec6ee1821a9ee1538fc5d1b08affd8c07b484f8;hb=06bf55ad6430db2ba3fd0f4155b5cb36fbfff646;hp=e8f8179d9fad8e7d759efe6500015ff60cdec65c;hpb=28c409ef063bcd7161227dd4985e1df0c5cb8359;p=carnet-tools-cn.git

diff --git a/README.CARNet b/README.CARNet
index e8f8179..1ec6ee1 100644
--- 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