r107:
[carnet-tools-cn.git] / carnet-tools.7
index 37d10f8..6847069 100644 (file)
@@ -62,7 +62,7 @@ naveden kao argument, vraca IP adresu od loopback sucelja (lo).
 Funkcija vraca IP netmask mreznog sucelja. U slucaju da nije\r
 naveden kao argument, vraca IP netmask od loopback sucelja (lo).\r
 .TP\r
-\fBcp_get_ifdefault\fR [\fBdev\fR|\fBaddr\fR]\r
+\fBcp_get_ifdefault\fR <\fBdev\fR|\fBaddr\fR>\r
 Funkcija vraca naziv uredjaj ili adresu podrazumne rute (default\r
 route).\r
 .TP\r
@@ -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\r
 loopback sucelja (lo).\r
 .TP\r
-\fBcp_backup_conffile\fR \fIfile\fR\r
-Funkcija backupira datoteku u /var/backups/ direktorij. Po\r
-potrebi rotira, ako postoje neke razlike.\r
+\fBcp_backup_conffile\fR [\fB-n\fR] [[\fB-p\fR] \fB-d\fR \fIbackup_dir\fR] \fIfile\fR [\fIbackup_file\fR]\r
+.TP\r
+\fBcp_check_and_backup\fR [\fB-n\fR] [[\fB-p\fR] \fB-d\fR \fIbackup_dir\fR] \fIfile\fR [\fIbackup_file\fR]\r
+Funkcije backupiraju datoteku, kopija originala se sprema\r
+u /var/backups/ direktorij sa dodanim .bak nastavkom.  Po potrebi se vrsi\r
+rotacija prethodno spremljenih kopija ako postoje neke razlike.  Opcionalni\r
+argument \fIbackup_file\fR zamjenuje ime backup datoteke u /var/backups \r
+nekim drugim.  Opcijom \fB-d\fR se moze podesiti alternativno odrediste, bilo \r
+apsolutnom putanjom do zeljenog direktorija ili relativnom unutar /var/backups.\r
+\fB-p\fR ce automatski stvoriti odredisni direktorij ako ne postoji.\r
+Opcija \fB-n\fR sprecava dodavanje .bak nastavka.  Na primjer:\r
+.nf\r
+cp_backup_conffile config.php\r
+.fi\r
+  - backup ide u /var/backups/config.php.bak\r
+.nf\r
+cp_backup_conffile apache.conf squirrelmail-apache.conf\r
+.fi\r
+  - backup ide u /var/backups/squirrelmail-apache.conf.bak\r
+cp_backup_conffile -n -d aai preinstall.ldif\r
+.fi\r
+  - backup ide u /var/backups/aai/preinstall.ldif\r
+cp_backup_conffile uspjesno zavrsi ako nije bilo potrebno izvrsiti backup, \r
+dok cp_check_and_backup u tom slucaju vraca status 3.\r
 .TP\r
 \fBcp_check_and_sed\fR \fIregexp\fR \fIsed\fR \fIfile\fR [\fIfile\fR ...]\r
 Funkcija trazi (egrep) regularni izraz \fIregexp\fR u datotekama, te ako\r
@@ -83,12 +104,13 @@ koristi za zamjenu stare vrijednosti postavke novom.
 .TP\r
 \fBcp_echo\fR [\fB-mailonly\fR|\fB-m\fR] \fIstring\fR\r
 .TP\r
-\fBcp_mail\fR [\fB-q\fR] \fIpackage\fR \fIversion\fR\r
+\fBcp_mail\fR [\fB-q\fR] \fIpackage\fR [\fIversion\fR]\r
 U kombinaciji, ove funkcije sluze za slanje poruka na stdout \fUi\fR na\r
 mail rootu.  Koristiti za informacije koje svakako treba dostaviti\r
 sistemcu (passwordi, nekompatibilne izmjene u konfiguraciji\r
 kriticnih servisa), cak i ako ne cita dokumentaciju niti prati\r
-poruke kod upgradea. :\->\r
+poruke kod upgradea. :\-> Paket koji koristi cp_mail() mora imati\r
+Depends: mail-transport-agent.\r
 .PP\r
 cp_echo se koristi umjesto echo.  Uz \fB-m\fR salje poruku samo na mail.\r
 cp_mail se poziva na kraju (postinsta), kad posalje mail.  Bez\r
@@ -118,12 +140,27 @@ greske vrati prazni \fBRET\fR. Kome treba greska neka ga ne koristi.
 Funkcija je namijenjena koristenju na mjestu gdje se inace poziva\r
 \fBdb_get\fR, sto znaci da korisnik mora sam napraviti sve potrebne\r
 predradnje, od \fB. /usr/share/debconf/confmodule\fR nadalje.\r
+.TP\r
+\fBcp_get_ldap_suffix\fR\r
+Funkcija vraca LDAP suffix kojeg cita iz \fI/etc/ldap/slapd.conf\fR.\r
+.TP\r
+\fBcp_get_ldap_realm\fR\r
+Funkcija vraca LDAP realm kojeg cita iz \fI/etc/ldap/slapd.conf\fR.\r
+.TP\r
+\fBcp_get_mx_domain\fR\r
+Funkcija vraca najopcenitiju domenu ciji MX zapis pokazuje\r
+na ovo racunalo. Na primjer, ako se racunalo zove fly.srk.fer.hr\r
+i MX zapisi u DNS-u za srk.fer.hr i fer.hr pokazuju na nj,\r
+funkcija ce vratiti niz "fer.hr". Ako nije pronadjena ni jedna\r
+domena, vraca se FQDN racunala, pa se usporedbom vracene vrijednosti\r
+i izlaza `hostname -f` moze ustanoviti je li ovo racunalo MX za\r
+domenu.\r
 .PP\r
-Funkcije cije ime pocinje sa \fBcp_get_\fR pohranjuju rezultat u varijabli \fB$RET\fR,\r
-a one s prefiksom cp_check_ kao rezultat vracaju exit status.  U pozivnoj\r
-skripti se mogu definirati sljedece varijable koje utjecu na rad svih\r
-pomocnih funkcija:\r
-\r
+U pravilu, funkcije cije ime pocinje sa \fBcp_get_\fR pohranjuju rezultat\r
+u varijabli \fB$RET\fR, a one s prefiksom cp_check_ kao rezultat vracaju \r
+exit status.  Pogledajte dolje koje se varijable okruzja mogu upotrijebiti\r
+za utjecaj na nacin vracanja povratne vrijednosti.\r
+.\"\r
 .SH PRIMJER\r
 Poziv \fBcp_get_\fRxxx funkcije i preuzimanje rezultata:\r
 .Sp\r
@@ -138,32 +175,45 @@ Poziv \fBcp_check_\fRxxx funkcije i nastavak toka programa:
 .Vb 6\r
 \&    . /usr/share/carnet-tools/functions.sh
 \&\r
-\&    if ! cp_check_and_sed watter 's/watter/ice/' \\\r
+\&    if ! cp_check_and_sed water 's/water/ice/' \\\r
 \&                          /dev/fridge; then\r
 \&      cp_echo "Clean the /dev/fridge!"\r
 \&    fi\r
 .Ve
 .\"
-.SH ENVIRONMENT
-\fBCP_ECHO_RETURN\fR   - kontrola nacina povrata vrijednosti\r
-.br\r
-.PP\r
-\fBCP_SCRIPT_DEBUG\fR  - potpomaze debugiranje (set -vx)\r
-.br\r
-.PP\r
-\fBCP_NOTICE\fR        - tijelo poruke koja se salje na mail\r
-.br\r
-.PP\r
-\fBRET\fR              - povrat vrijednosti iz \fBcp_get_\fRxxx funkcija
+.SH ENVIRONMENT\r
+.TP
+\fBCP_ECHO_RETURN\fR\r
+.nf\r
+kontrola nacina povrata vrijednosti, postaviti na 1\r
+\fUnakon\fR ucitavanja datoteke s funkcijama da bi rezultat\r
+\fBcp_get_*\fR funkcija isao i na stdout pored postavljanja \fB$RET\fR.\r
+.fi\r
+.TP\r
+\fBCP_SCRIPT_DEBUG\fR\r
+.nf\r
+potpomaze debugiranje (set -vx)\r
+.fi\r
+.TP\r
+\fBCP_NOTICE\fR\r
+.nf\r
+tijelo poruke koja se salje na mail\r
+.fi\r
+.TP\r
+\fBRET\fR\r
+.nf\r
+povratna vrijednost iz \fBcp_get_\fRxxx funkcija\r
+.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 <paketi@srce.hr>.\r
+Ivan 'ico' Rako, Zoran Dzelajlija, Damir Dzeko,\r
+Grupa za izradu paketa <paketi-team@CARNet.hr>.\r
 .\"
 .SH "VEZANO"\r
 .BR cp-update(1)\r