carnet-tools-cn
~~~~~~~~~~~~~~~

Paket carnet-tools-cn sadrzi skripte i shell funkcije koje se cesto
koriste u CARNetovim paketima.

Trenutna verzija sadrzi:

 - cp-update skriptu, koja se koristi u instalacijskim skriptama CARNet
   paketa za dodavanje blokova teksta u konfiguracijske datoteke.

 - /usr/share/carnet-tools/functions.sh datoteku koja sadrzi sljedece
   shell funkcije:

cp_get_ifaddr <interface>

	Funkcija vraca IP adresu mreznog sucelja. U slucaju da nije
	naveden kao argument, vraca IP adresu od loopback sucelja (lo).

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_ifdefault [dev|addr]

	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>

	Funkcija backupira datoteku u /var/backups/ direktorij. Po
	potrebi rotira, ako postoje neke razlike.

cp_check_and_sed <regexp> <sed> <file> [<file> ...]

	Funkcija trazi regularni izraz <regexp> u datotekama, te ako
	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.

	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

	Potpomaze debugiranje (set -vx).

$CP_ECHO_RETURN

	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