4 Paket carnet-tools-cn sadrzi skripte i shell funkcije koje se cesto
5 koriste u CARNetovim paketima.
7 Trenutna verzija sadrzi:
9 - cp-update skriptu, koja se koristi u instalacijskim skriptama CARNet
10 paketa za dodavanje blokova teksta u konfiguracijske datoteke.
12 - /usr/share/carnet-tools/functions.sh datoteku koja sadrzi sljedece
15 cp_get_ifaddr <interface>
17 Funkcija vraca IP adresu mreznog sucelja. U slucaju da nije
18 naveden kao argument, vraca IP adresu od loopback sucelja (lo).
20 cp_get_ifmask <interface>
22 Funkcija vraca IP netmask mreznog sucelja. U slucaju da nije
23 naveden kao argument, vraca IP netmask od loopback sucelja (lo).
25 cp_get_ifdefault [dev|addr]
27 Funkcija vraca naziv uredjaj ili adresu podrazumne rute (default
30 cp_get_netaddr <interface>
32 Funkcija vraca podmrezu mreznog sucelja u CIDR obliku. U slucaju
33 da nije naveden <interface> argument, vraca CIDR sucelja preko
34 kojeg ide default route, a ako isti nije definiran, vraca CIDR
35 loopback sucelja (lo).
37 cp_backup_conffile <file>
39 Funkcija backupira datoteku u /var/backups/ direktorij. Po
40 potrebi rotira, ako postoje neke razlike.
42 cp_check_and_sed <regexp> <sed> <file> [<file> ...]
44 Funkcija trazi regularni izraz <regexp> u datotekama, te ako
45 postoji, izvrsi sed program <sed> nad tim datotekama. Najcesce se
46 koristi za zamjenu stare vrijednosti postavke novom.
48 cp_echo [-mailonly|-m] <string>
50 cp_mail [-q] <package> <version>
52 U kombinaciji, ove funkcije sluze za slanje poruka na stdout _i_ na
53 mail rootu. Koristiti za informacije koje svakako treba dostaviti
54 sistemcu (passwordi, nekompatibilne izmjene u konfiguraciji
55 kriticnih servisa), cak i ako ne cita dokumentaciju niti prati
56 poruke kod upgradea. :->
58 cp_echo se koristi umjesto echo. Uz -m salje poruku samo na mail.
59 cp_mail se poziva na kraju (postinsta), kad posalje mail. Bez
60 -q opcije cp_mail ce ispisati obavijest o slanju tog maila.
62 Ove dvije funkcije koriste globalnu varijablu CP_NOTICE u koju se
63 spremaju poruke za mail.
65 cp_mv <new-file> <target-file>
67 Funkcija cija je namjena da novu datoteku <new-file> instalira kao
68 zadanu <target-file> datoteku, koja moze i/ili ne postojati. Ako ta
69 datoteka postoji onda se novoj dodjeljuje njeno vlasnistvo i modovi
70 pristupa. Operacija je atomicna.
72 Funkcija cp_safe_file_replace je prikladna za koristenje kod raznih
73 sed-like izmjena neke postojece datoteke iako se za samo sed-anje
74 preporuca koristiti funkciju cp_check_and_sed.
78 Funkcija za jednostavni (y)es/(n)o dijalog. Odgovor y/n vraca u RET.
79 Valja napomenuti da je kao i sve ostalo sto trosi stdin/stdout
80 nekompatibilan s debconfom (doticnog treba pogasiti prvo).
82 cp_db_get_wrap <package>/<variable>
84 Wrapper za debconfovu funkciju db_get koji umjesto neke neocekivane
85 greske vrati prazni RET. Kome treba greska neka ga ne koristi.
88 Funkcije cije ime pocinje sa cp_get_ pohranjuju rezultat u varijabli $RET,
89 a one s prefiksom cp_check_ kao rezultat vracaju exit status. U pozivnoj
90 skripti se mogu definirati sljedece varijable koje utjecu na rad svih
95 Potpomaze debugiranje (set -vx).
99 Vracanje rezultata na stdout i u varijabli $RET.
100 Ako se cp_ funkcija koja vraca string poziva unutar neke druge cp_
101 funkcije, treba iskljucivo koristiti $RET konvenciju, i sacuvati
102 prethodno stanje varijable CP_ECHO_RETURN.
105 -- Ivan 'ico' Rako <irako@srce.hr> Wed, 16 Mar 2005 14:25:14 +0100