Prva inačica za bullseye
[carnet-tools-cn.git] / carnet-tools.7
index 69d27e2..d737d2d 100644 (file)
@@ -38,7 +38,7 @@
 .if n .na\r
 .\"
 .IX Title "carnet-tools 7"
-.TH carnet-tools 7 "March 2005" CARNet "CARNet Packaging Tools"
+.TH carnet-tools 7 "March 2005" CARNET "CARNET Packaging Tools"
 .SH NAME\r
 carnet-tools \- pomocni alati za laksi zivot package maintainera\r
 .\"\r
@@ -47,7 +47,7 @@ carnet-tools \- pomocni alati za laksi zivot package maintainera
 .\"\r
 .SH OPIS
 Paket carnet-tools-cn sadrzi skripte i shell funkcije koje se cesto\r
-koriste u CARNetovim paketima. To sluzi tome da se postinst skripte\r
+koriste u CARNETovim paketima. To sluzi tome da se postinst skripte\r
 pisu lakse, brze i pouzdanije temeljene na vec isprobanom kodu. Tu \r
 su i primjeri provjerenih rjesenja za shell-skriptiranje da se nadju\r
 pri ruci kad zatreba.\r
@@ -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,14 +72,17 @@ 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 [\fIbackup_file\fR]\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 \fIfile\fR [\fIbackup_file\fR]\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.  Na primjer:\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
@@ -88,6 +91,9 @@ cp_backup_conffile config.php
 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
@@ -98,7 +104,7 @@ 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
@@ -136,10 +142,21 @@ Funkcija je namijenjena koristenju na mjestu gdje se inace poziva
 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
+Funkcija vraca LDAP suffix kojeg cita iz \fI/etc/ldap/slapd.d/\fR\r
+(ako ne postoji, onda 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
+Funkcija vraca LDAP suffix kojeg cita iz \fI/etc/ldap/slapd.d/\fR\r
+(ako ne postoji, onda 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
 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
@@ -160,32 +177,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