1 .\" Copied from from Pod::Man template
\r
2 .\" Wed, 23 Mar 2005 11:51:08 +0100
\r
4 .\" Standard preamble:
\r
5 .\" ======================================================================
\r
6 .de Sh \" Subsection heading
\r
14 .de Sp \" Vertical space (when we can't use .PP)
\r
20 .ie \\n(.$>=3 .ne \\$3
\r
24 .de Vb \" Begin verbatim text
\r
29 .de Ve \" End verbatim text
\r
35 .\" For nroff, turn off justification. Always turn off hyphenation; it
\r
36 .\" makes way too many mistakes in technical documents.
\r
40 .IX Title "carnet-tools 8"
41 .TH carnet-tools 8 "March 2005" CARNet "CARNet Packaging Tools"
43 carnet-tools \- pomocni alati za laksi zivot package maintainera
\r
46 .B . /usr/share/carnet-tools/functions.sh
\r
49 Paket carnet-tools-cn sadrzi skripte i shell funkcije koje se cesto
\r
50 koriste u CARNetovim paketima. To sluzi tome da se postinst skripte
\r
51 pisu lakse, brze i pouzdanije temeljene na vec isprobanom kodu. Tu
\r
52 su i primjeri provjerenih rjesenja za shell-skriptiranje da se nadju
\r
53 pri ruci kad zatreba.
\r
57 \fBcp_get_ifaddr\fR \fIinterface\fR
\r
58 Funkcija vraca IP adresu mreznog sucelja. U slucaju da nije
\r
59 naveden kao argument, vraca IP adresu od loopback sucelja (lo).
\r
61 \fBcp_get_ifmask\fR \fIinterface\fR
\r
62 Funkcija vraca IP netmask mreznog sucelja. U slucaju da nije
\r
63 naveden kao argument, vraca IP netmask od loopback sucelja (lo).
\r
65 \fBcp_get_ifdefault\fR [\fBdev\fR|\fBaddr\fR]
\r
66 Funkcija vraca naziv uredjaj ili adresu podrazumne rute (default
\r
69 \fBcp_get_netaddr\fR \fIinterface\fR
\r
70 Funkcija vraca podmrezu mreznog sucelja u CIDR obliku. U slucaju
\r
71 da nije naveden \fIinterface\fR argument, vraca CIDR sucelja preko
\r
72 kojeg ide default route, a ako isti nije definiran, vraca CIDR
\r
73 loopback sucelja (lo).
\r
75 \fBcp_backup_conffile\fR \fIfile\fR
\r
76 Funkcija backupira datoteku u /var/backups/ direktorij. Po
\r
77 potrebi rotira, ako postoje neke razlike.
\r
79 \fBcp_check_and_sed\fR \fIregexp\fR \fIsed\fR \fIfile\fR [\fIfile\fR ...]
\r
80 Funkcija trazi (egrep) regularni izraz \fIregexp\fR u datotekama, te ako
\r
81 postoji, izvrsi sed program \fIsed\fR nad tim datotekama. Najcesce se
\r
82 koristi za zamjenu stare vrijednosti postavke novom.
\r
84 \fBcp_echo\fR [\fB-mailonly\fR|\fB-m\fR] \fIstring\fR
\r
86 \fBcp_mail\fR [\fB-q\fR] \fIpackage\fR \fIversion\fR
\r
87 U kombinaciji, ove funkcije sluze za slanje poruka na stdout \fUi\fR na
\r
88 mail rootu. Koristiti za informacije koje svakako treba dostaviti
\r
89 sistemcu (passwordi, nekompatibilne izmjene u konfiguraciji
\r
90 kriticnih servisa), cak i ako ne cita dokumentaciju niti prati
\r
91 poruke kod upgradea. :\->
\r
93 cp_echo se koristi umjesto echo. Uz \fB-m\fR salje poruku samo na mail.
\r
94 cp_mail se poziva na kraju (postinsta), kad posalje mail. Bez
\r
95 \fB-q\fR opcije \fBcp_mail\fR ce ispisati obavijest o slanju tog maila.
\r
97 Ove dvije funkcije koriste globalnu varijablu \fBCP_NOTICE\fR u koju se
\r
98 spremaju poruke za mail.
\r
100 \fBcp_mv\fR \fInew-file\fR \fItarget-file\fR
\r
101 Funkcija cija je namjena da novu datoteku \fInew-file\fR instalira kao
\r
102 zadanu \fItarget-file\fR datoteku, koja moze i/ili ne postojati. Ako ta
\r
103 datoteka postoji onda se novoj dodjeljuje njeno vlasnistvo i modovi
\r
104 pristupa. Operacija je atomicna.
\r
106 Funkcija \fBcp_safe_file_replace\fR je prikladna za koristenje kod raznih
\r
107 sed-like izmjena neke postojece datoteke iako se za samo sed-anje
\r
108 preporuca koristiti funkciju \fBcp_check_and_sed\fR.
\r
110 \fBcp_yes_no\fR [\fIprompt\fR]
\r
111 Funkcija za jednostavni \fUy\fRes/\fUn\fRo dijalog. Odgovor '\fBy\fR' | '\fBn\fR'
\r
112 vraca u RET. Valja napomenuti da je kao i sve ostalo sto koristi stdin/stdout
\r
113 nekompatibilan s debconfom (doticnog treba ugasiti prvo).
\r
115 \fBcp_db_get_wrap\fR \fIpackage\fR\fB/\fR\fIvariable\fR
\r
116 Wrapper za debconfovu funkciju db_get koji umjesto neke neocekivane
\r
117 greske vrati prazni \fBRET\fR. Kome treba greska neka ga ne koristi.
\r
119 Funkcije cije ime pocinje sa \fBcp_get_\fR pohranjuju rezultat u varijabli \fB$RET\fR,
\r
120 a one s prefiksom cp_check_ kao rezultat vracaju exit status. U pozivnoj
\r
121 skripti se mogu definirati sljedece varijable koje utjecu na rad svih
\r
125 Poziv \fBcp_get_\fRxxx funkcije i preuzimanje rezultata:
\r
128 \& . /usr/share/carnet-tools/functions.sh
130 \& cp_get_ifaddr ppp0
\r
133 Poziv \fBcp_check_\fRxxx funkcije i nastavak toka programa:
\r
136 \& . /usr/share/carnet-tools/functions.sh
138 \& if ! cp_check_and_sed watter 's/watter/ice/' \\
\r
139 \& /dev/fridge; then
\r
140 \& cp_echo "Clean the /dev/fridge!"
\r
145 \fBCP_ECHO_RETURN\fR - kontrola nacina povrata vrijednosti
\r
148 \fBCP_SCRIPT_DEBUG\fR - potpomaze debugiranje (set -vx)
\r
151 \fBCP_NOTICE\fR - tijelo poruke koja se salje na mail
\r
154 \fBRET\fR - povrat vrijednosti iz \fBcp_get_\fRxxx funkcija
157 Ne koriste se nikakve posebne datoteke.
163 Ivan 'ico' Rako, Zoran Dzelajlija, Damir Dzeko. SRCE <paketi@srce.hr>.
\r