X-Git-Url: http://ftp.carnet.hr/carnet-debian/scm?p=carnet-tools-cn.git;a=blobdiff_plain;f=README.CARNet;h=f9c60b573a46a847295d7d40a2c71381d2035c8c;hp=8ee99b4b7f9fa7ac5eb9f452113d4aed3d069b26;hb=HEAD;hpb=faaf01a6e019eadf76bfb8960cbbffa7f1c4c921 diff --git a/README.CARNet b/README.CARNet deleted file mode 100644 index 8ee99b4..0000000 --- a/README.CARNet +++ /dev/null @@ -1,107 +0,0 @@ -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 - - Funkcija vraca IP adresu mreznog sucelja. U slucaju da nije - naveden kao argument, vraca IP adresu od loopback sucelja (lo). - -cp_get_ifmask - - 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 - - Funkcija vraca podmrezu mreznog sucelja u CIDR obliku. U slucaju - da nije naveden argument, vraca CIDR sucelja preko - kojeg ide default route, a ako isti nije definiran, vraca CIDR - loopback sucelja (lo). - -cp_backup_conffile - - Funkcija backupira datoteku u /var/backups/ direktorij. Po - potrebi rotira, ako postoje neke razlike. - -cp_check_and_sed [ ...] - - Funkcija trazi regularni izraz u datotekama, te ako - postoji, izvrsi sed program nad tim datotekama. Najcesce se - koristi za zamjenu stare vrijednosti postavke novom. - -cp_echo [-mailonly|-m] - -cp_mail [-q] - - 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 - - Funkcija cija je namjena da novu datoteku instalira kao - zadanu 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 [] - - 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 / - - Wrapper za debconfovu funkciju db_get koji umjesto neke neocekivane - greske vrati prazni RET. Kome treba greska neka ga ne koristi. - Funkcija je namijenjena koristenju na mjestu gdje se inace poziva - db_get, sto znaci da korisnik mora sam napraviti sve potrebne - predradnje, od . /usr/share/debconf/confmodule nadalje. - -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 Wed, 16 Mar 2005 14:25:14 +0100