X-Git-Url: http://ftp.carnet.hr/carnet-debian/scm?p=carnet-tools-cn.git;a=blobdiff_plain;f=carnet-tools.7;h=6847069adca1d0dcb01fde740a887be3e945c28b;hp=35f5702e8eb4da43f460164319be4872be7de06f;hb=31f85c4552a2420027d09f016d66a3bbd3706834;hpb=4ddc4c05aa1777c5c489a9ef73c4ce039f14c329 diff --git a/carnet-tools.7 b/carnet-tools.7 index 35f5702..6847069 100644 --- a/carnet-tools.7 +++ b/carnet-tools.7 @@ -62,7 +62,7 @@ naveden kao argument, vraca IP adresu od loopback sucelja (lo). Funkcija vraca IP netmask mreznog sucelja. U slucaju da nije naveden kao argument, vraca IP netmask od loopback sucelja (lo). .TP -\fBcp_get_ifdefault\fR [\fBdev\fR|\fBaddr\fR] +\fBcp_get_ifdefault\fR <\fBdev\fR|\fBaddr\fR> Funkcija vraca naziv uredjaj ili adresu podrazumne rute (default route). .TP @@ -72,9 +72,30 @@ da nije naveden \fIinterface\fR argument, vraca CIDR sucelja preko kojeg ide default route, a ako isti nije definiran, vraca CIDR loopback sucelja (lo). .TP -\fBcp_backup_conffile\fR \fIfile\fR -Funkcija backupira datoteku u /var/backups/ direktorij. Po -potrebi rotira, ako postoje neke razlike. +\fBcp_backup_conffile\fR [\fB-n\fR] [[\fB-p\fR] \fB-d\fR \fIbackup_dir\fR] \fIfile\fR [\fIbackup_file\fR] +.TP +\fBcp_check_and_backup\fR [\fB-n\fR] [[\fB-p\fR] \fB-d\fR \fIbackup_dir\fR] \fIfile\fR [\fIbackup_file\fR] +Funkcije backupiraju datoteku, kopija originala se sprema +u /var/backups/ direktorij sa dodanim .bak nastavkom. Po potrebi se vrsi +rotacija prethodno spremljenih kopija ako postoje neke razlike. Opcionalni +argument \fIbackup_file\fR zamjenuje ime backup datoteke u /var/backups +nekim drugim. Opcijom \fB-d\fR se moze podesiti alternativno odrediste, bilo +apsolutnom putanjom do zeljenog direktorija ili relativnom unutar /var/backups. +\fB-p\fR ce automatski stvoriti odredisni direktorij ako ne postoji. +Opcija \fB-n\fR sprecava dodavanje .bak nastavka. Na primjer: +.nf +cp_backup_conffile config.php +.fi + - backup ide u /var/backups/config.php.bak +.nf +cp_backup_conffile apache.conf squirrelmail-apache.conf +.fi + - backup ide u /var/backups/squirrelmail-apache.conf.bak +cp_backup_conffile -n -d aai preinstall.ldif +.fi + - backup ide u /var/backups/aai/preinstall.ldif +cp_backup_conffile uspjesno zavrsi ako nije bilo potrebno izvrsiti backup, +dok cp_check_and_backup u tom slucaju vraca status 3. .TP \fBcp_check_and_sed\fR \fIregexp\fR \fIsed\fR \fIfile\fR [\fIfile\fR ...] Funkcija trazi (egrep) regularni izraz \fIregexp\fR u datotekama, te ako @@ -83,13 +104,13 @@ koristi za zamjenu stare vrijednosti postavke novom. .TP \fBcp_echo\fR [\fB-mailonly\fR|\fB-m\fR] \fIstring\fR .TP -\fBcp_mail\fR [\fB-q\fR] \fIpackage\fR \fIversion\fR +\fBcp_mail\fR [\fB-q\fR] \fIpackage\fR [\fIversion\fR] U kombinaciji, ove funkcije sluze za slanje poruka na stdout \fUi\fR 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. :\-> Ova funkcija nece raditi bez nekog -mail-transport-agenta (kao sendmail, postfix, ...). +poruke kod upgradea. :\-> Paket koji koristi cp_mail() mora imati +Depends: mail-transport-agent. .PP cp_echo se koristi umjesto echo. Uz \fB-m\fR salje poruku samo na mail. cp_mail se poziva na kraju (postinsta), kad posalje mail. Bez @@ -125,6 +146,15 @@ Funkcija vraca LDAP suffix kojeg cita iz \fI/etc/ldap/slapd.conf\fR. .TP \fBcp_get_ldap_realm\fR Funkcija vraca LDAP realm kojeg cita iz \fI/etc/ldap/slapd.conf\fR. +.TP +\fBcp_get_mx_domain\fR +Funkcija vraca najopcenitiju domenu ciji MX zapis pokazuje +na ovo racunalo. Na primjer, ako se racunalo zove fly.srk.fer.hr +i MX zapisi u DNS-u za srk.fer.hr i fer.hr pokazuju na nj, +funkcija ce vratiti niz "fer.hr". Ako nije pronadjena ni jedna +domena, vraca se FQDN racunala, pa se usporedbom vracene vrijednosti +i izlaza `hostname -f` moze ustanoviti je li ovo racunalo MX za +domenu. .PP U pravilu, funkcije cije ime pocinje sa \fBcp_get_\fR pohranjuju rezultat u varijabli \fB$RET\fR, a one s prefiksom cp_check_ kao rezultat vracaju @@ -145,32 +175,45 @@ Poziv \fBcp_check_\fRxxx funkcije i nastavak toka programa: .Vb 6 \& . /usr/share/carnet-tools/functions.sh \& -\& if ! cp_check_and_sed watter 's/watter/ice/' \\ +\& if ! cp_check_and_sed water 's/water/ice/' \\ \& /dev/fridge; then \& cp_echo "Clean the /dev/fridge!" \& fi .Ve .\" -.SH ENVIRONMENT -\fBCP_ECHO_RETURN\fR - kontrola nacina povrata vrijednosti -.br -.PP -\fBCP_SCRIPT_DEBUG\fR - potpomaze debugiranje (set -vx) -.br -.PP -\fBCP_NOTICE\fR - tijelo poruke koja se salje na mail -.br -.PP -\fBRET\fR - povrat vrijednosti iz \fBcp_get_\fRxxx funkcija +.SH ENVIRONMENT +.TP +\fBCP_ECHO_RETURN\fR +.nf +kontrola nacina povrata vrijednosti, postaviti na 1 +\fUnakon\fR ucitavanja datoteke s funkcijama da bi rezultat +\fBcp_get_*\fR funkcija isao i na stdout pored postavljanja \fB$RET\fR. +.fi +.TP +\fBCP_SCRIPT_DEBUG\fR +.nf +potpomaze debugiranje (set -vx) +.fi +.TP +\fBCP_NOTICE\fR +.nf +tijelo poruke koja se salje na mail +.fi +.TP +\fBRET\fR +.nf +povratna vrijednost iz \fBcp_get_\fRxxx funkcija +.fi .\" .SH DATOTEKE Ne koriste se nikakve posebne datoteke. .\" .SH BUGOVI -Nema poznatih. +cp_get_mx_domain ovisi o ispravnom radu DNS sustava. .\" .SH AUTORI -Ivan 'ico' Rako, Zoran Dzelajlija, Damir Dzeko. SRCE . +Ivan 'ico' Rako, Zoran Dzelajlija, Damir Dzeko, +Grupa za izradu paketa . .\" .SH "VEZANO" .BR cp-update(1)