r85: Dodane -d i -n opcije za cp_backup_conffile.

[carnet-tools-cn.git] / carnet-tools.7

diff --git a/carnet-tools.7 b/carnet-tools.7
index bb694de..ac445ec 100644 (file)
--- 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\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,29 @@ 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-d\fR \fIbackup_dir\fR] \fIfile\fR [\fIbackup_file\fR]\r
+.TP\r
+\fBcp_check_and_backup\fR [\fB-n\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
+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 +103,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,6 +139,12 @@ 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
 .PP\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
@@ -144,17 +171,29 @@ Poziv \fBcp_check_\fRxxx funkcije i nastavak toka programa:
 \&    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.