r4: Funkcije za slanje maila, cp_echo() i cp_mail().
[carnet-tools-cn.git] / README.CARNet
1 carnet-tools-cn
2 ~~~~~~~~~~~~~~~
3
4 Paket carnet-tools-cn sadrzi skripte i shell funkcije koje se cesto
5 koriste u CARNetovim paketima.
6
7 Trenutna verzija sadrzi:
8
9  - cp-update skriptu, koja se koristi u instalacijskim skriptama CARNet
10    paketa za dodavanje blokova teksta u konfiguracijske datoteke.
11
12  - /usr/share/carnet-tools/functions.sh datoteku koja sadrzi sljedece
13    shell funkcije:
14
15 cp_get_ifaddr <interface>
16
17         Funkcija vraca IP adresu mreznog sucelja. U slucaju da nije
18         naveden kao argument, vraca IP adresu od loopback sucelja (lo).
19
20 cp_get_ifmask <interface>
21
22         Funkcija vraca IP netmask mreznog sucelja. U slucaju da nije
23         naveden kao argument, vraca IP netmask od loopback sucelja (lo).
24
25 cp_get_cidr <interface>
26
27         Funkcija vraca podmrezu mreznog sucelja u CIDR obliku.  U slucaju
28         da nije naveden <interface> argument, vraca CIDR sucelja preko
29         kojeg ide default route, a ako isti nije definiran, vraca CIDR
30         loopback sucelja (lo).
31
32 cp_backup_conffile <file>
33
34         Funkcija backupira datoteku u /var/backups/ direktorij. Po
35         potrebi rotira, ako postoje neke razlike.
36
37 cp_check_and_sed <regexp> <sed> <file> [<file> ...]
38
39         Funkcija trazi regularni izraz <regexp> u datotekama, te ako
40         postoji, izvrsi sed program <sed> nad tim datotekama.  Najcesce se
41         koristi za zamjenu stare vrijednosti postavke novom.
42
43 cp_echo [-mailonly|-m] <string>
44
45 cp_mail [-q] <package> <version>
46
47         U kombinaciji, ove funkcije sluze za slanje poruka na stdout _i_ na
48         mail rootu.  Koristiti za informacije koje svakako treba dostaviti
49         sistemcu (passwordi, nekompatibilne izmjene u konfiguraciji
50         kriticnih servisa), cak i ako ne cita dokumentaciju niti prati
51         poruke kod upgradea. :->
52
53         cp_echo se koristi umjesto echo.  Uz -m salje poruku samo na mail.
54         cp_mail se poziva na kraju (postinsta), kad posalje mail.  Bez
55         -q opcije cp_mail ce ispisati obavijest o slanju tog maila.
56
57         Ove dvije funkcije koriste globalnu varijablu CP_NOTICE u koju se
58         spremaju poruke za mail.
59
60 Funkcije cije ime pocinje sa cp_get_ pohranjuju rezultat u varijabli $RET,
61 a one s prefiksom cp_check_ kao rezultat vracaju exit status.  U pozivnoj
62 skripti se mogu definirati sljedece varijable koje utjecu na rad svih
63 pomocnih funkcija:
64
65 $CP_SCRIPT_DEBUG
66
67         Potpomaze debugiranje (set -vx).
68
69 $CP_ECHO_RETURN
70
71         Vracanje rezultata na stdout i u varijabli $RET.
72
73 -- Ivan 'ico' Rako <irako@srce.hr>  Wed, 16 Mar 2005 14:25:14 +0100