465 lines
14 KiB
Groff
465 lines
14 KiB
Groff
.TH AUTOSPEC "9" "@date_my@" "@package@ @version@" "User Commands"
|
|
.SH NOME
|
|
\fB@package@\fR - script di frontend per la creazione e l'aggiornamento e la verifica di pacchetti rpm.
|
|
.br
|
|
\fBconfig-getvar\fR - plugin per la visualizzazione di variabili presenti nei file di configurazione.
|
|
.br
|
|
\fBpck-extract\fR - plugin per l'estrazione di file da archivi srpm.
|
|
.br
|
|
\fBpck-update\fR - plugin per l'aggiornamento di archivi rpm.
|
|
.br
|
|
\fBspec-create\fR - plugin per la creazione di archivi rpm.
|
|
.br
|
|
\fB@pck_lib@\fR - libreria di funzioni per l'analisi degli specfile.
|
|
|
|
.SH VERSIONE
|
|
Questo documento e' aggiornato alla versione 1.12.0 di
|
|
.B @package@.
|
|
|
|
.SH DESCRIZIONE
|
|
.B @package@
|
|
e' una suite di script che permette di \fIvelocizzare\fP ed \fIautomatizzare\fP una parte
|
|
delle operazioni necessarie alla creazione, al mantenimento (aggiornamento) dei pacchetti
|
|
rpm di una intera distribuzione ed al controllo di comuni errori e vulnerabilita'.
|
|
|
|
.B @package@
|
|
e' modulare ed altamente \fIconfigurabile\fP e quindi facilmente adattabile alle
|
|
particolarita' specifiche di ogni distribuzione basata su pacchetti rpm.
|
|
|
|
.B @package@
|
|
fornisce inoltre la libreria \fB@pck_lib@\fR, utilizzabile anche da script di shell
|
|
esterni per ricavare in modo semplice informazioni su un qualsiasi specfile dato in input.
|
|
|
|
.B @package@
|
|
e' stato utilizzato con successo dagli sviluppatori della distribuzione
|
|
.B QiLinux
|
|
(\fIhttp://www.qilinux.org\fP), permettendo la creazione di specfile standard e
|
|
l'aggiornamento (semi)automatico dei pacchetti.
|
|
E' utilizzato attualmente nello sviluppo di
|
|
.B openmamba GNU/Linux
|
|
(\fIhttp://www.openmamba.org\fP) per creare specfile, per aggiornare i pacchetti dei branch
|
|
di sviluppo e dei contributors e per effettuare il porting (amche in cross-compilazione)
|
|
dei pacchetti in architetture diverse.
|
|
|
|
.SH FILE DI CONFIGURAZIONE
|
|
.B @package@
|
|
legge all'avvio i file globali \fI@sysconfdir@/@package@.conf\fR
|
|
e \fI@sysconfdir@/@package@.d/*.conf\fR e quindi i file privati dell'utente:
|
|
\fI~/.@package@\fR e/o \fI~/.@package@.d/*.conf\fR.
|
|
|
|
E' buona norma non modificare direttamente i file globali.
|
|
Utilizzare i file privati per ridefinire variabili oppure modularizzare la configurazione.
|
|
.TP
|
|
Qui di seguito e' presentato un esempio di file di configurazione utente per \fB@package@\fR che potra' essere utilizzato da un contributore come fac-simile per creare il proprio file di configurazione personale.
|
|
.if t .sp 0.5
|
|
.if n .sp 1
|
|
.RS
|
|
.PD 0
|
|
.TP
|
|
[~/.@package@]
|
|
.TP
|
|
# [configuration file for `@package@']
|
|
.TP
|
|
proxy=
|
|
.TP
|
|
proxy_user=
|
|
.TP
|
|
packager_fullname="<Your Name>"
|
|
.TP
|
|
packager_email="<email>@openmamba.org"
|
|
.TP
|
|
ftp_rw_user[1]="<user>"
|
|
.TP
|
|
ftp_rw_passwd[1]="<passwd>"
|
|
.TP
|
|
arch_list=(i586 ppc arm x86_64)
|
|
.TP
|
|
curl_opts_netlink="--connect-timeout 15 --retry 3 --limit-rate 250k"
|
|
.PD
|
|
.RE
|
|
.TP
|
|
Ecco un esempio di modularizzazione possibile:
|
|
.if t .sp 0.5
|
|
.if n .sp 1
|
|
.RS
|
|
.PD 0
|
|
.TP
|
|
~/.@package@.d/00-devel.conf
|
|
.TP
|
|
~/.@package@.d/01-devel-my.conf
|
|
.TP
|
|
~/.@package@.d/02-devel-kde4.conf
|
|
.TP
|
|
~/.@package@.d/03-devel-makedist.conf
|
|
.TP
|
|
~/.@package@.d/04-devel-autodist.conf
|
|
.TP
|
|
~/.@package@.d/05-devel-future.conf
|
|
.PD
|
|
.RE
|
|
.TP
|
|
In ogni file vi sono le informazioni di connessione al \fIrepository\fP specificato dal nome del file. Ad esempio (repository in sola lettura):
|
|
.if t .sp 0.5
|
|
.if n .sp 1
|
|
.RS
|
|
.PD 0
|
|
.TP
|
|
$ cat ~/.@package@.d/05-devel-autodist.conf
|
|
.TP
|
|
ftp_alias[5]="autodist"
|
|
.TP
|
|
ftpurl_ro_rpms[5]="http://www.openmamba.org/pub/openmamba/devel-autodist/RPMS.@arch@"
|
|
.TP
|
|
ftpurl_ro_srpms[5]="http://www.openmamba.org/pub/openmamba/devel-autodist/SRPMS.base"
|
|
.TP
|
|
ftp_enable[5]="1"
|
|
.PD
|
|
.RE
|
|
.TP
|
|
e (repository personale in lettura e scrittura):
|
|
.if t .sp 0.5
|
|
.if n .sp 1
|
|
.RS
|
|
.PD 0
|
|
.TP
|
|
$ cat ~/.@package@.d/01-devel-my.conf
|
|
.TP
|
|
ftp_alias[2]="\fI<myrepos>\fP"
|
|
.TP
|
|
ftpurl_ro_rpms[2]="http://www.openmamba.org/pub/openmamba/devel-\fI<my_alias>\fP/RPMS.@arch@"
|
|
.TP
|
|
ftpurl_ro_srpms[2]="http://www.openmamba.org/pub/openmamba/devel-\fI<my_alias>\fP/SRPMS.base"
|
|
.TP
|
|
ftp_rw_server[2]="ftp://ftpaccounts.openmamba.org"
|
|
.TP
|
|
ftp_rw_passive_mode[2]=on
|
|
.TP
|
|
ftp_rw_user[2]="\fI<my_repository_alias>\fP"
|
|
.TP
|
|
ftp_rw_passwd[2]="\fI<passwd>\fP"
|
|
.TP
|
|
ftp_rw_rpms_dir[2]="/RPMS.@arch@"
|
|
.TP
|
|
ftp_rw_srpms_dir[2]="/SRPMS.base"
|
|
.TP
|
|
arch_list[2]="i586"
|
|
.TP
|
|
arch_noarch_upload[2]="@arch@"
|
|
.TP
|
|
ftp_enable[2]="1"
|
|
.PD
|
|
.RE
|
|
|
|
.SH SINTASSI
|
|
\fB@package@\fR e' lo script principale ed ha funzione di \fIfrontend\fP per una serie di script e
|
|
librerie specializzate.
|
|
Per questo motivo sono possibili differenti modalita' distinte di utilizzo.
|
|
Si ricorda che le opzioni indicate tra parentesi quadre sono opzionali.
|
|
|
|
.SS "Creazione di specfile"
|
|
\fB@package@\fR \
|
|
\fB\-s\fR \fItarball\fR \
|
|
[\fB\-n\fR \fIname\fR] \
|
|
[\fB\-v\fR \fIver\fR] \
|
|
[\fB\-t\fR \fItype\fR] \
|
|
[\fB\-o\fR \fIoutfile\fR]
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-source\fR
|
|
cerca di creare uno specfile per il \fItarball\fR indicato
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-pck\-name\fR
|
|
nome del pacchetto (default: ricavato dal nome del tarball)
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-pck\-version\fR
|
|
versione del pacchetto (default: ricavato dal nome del tarball)
|
|
.TP
|
|
\fB\-t\fR, \fB\-\-type\fR
|
|
categoria dello specfile da generare:
|
|
.br
|
|
\fIstandard\fR : specfile standard (default)
|
|
.br
|
|
\fIgnome\fR : specfile per pacchetti gnome
|
|
.br
|
|
\fIkde3\fR : specfile per pacchetti kde3
|
|
.br
|
|
\fIkde4\fR : specfile per pacchetti kde4
|
|
.br
|
|
\fIlibrary\fR : specfile per librerie
|
|
.br
|
|
\fIperl\fR : specfile per singoli moduli perl
|
|
.br
|
|
\fIpython\fR : specfile per moduli python
|
|
.br
|
|
\fIstandard-daemon\fR : specfile per servizi di sistema/rete
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-output\fR
|
|
redirige lo standard output sul file \fIoutfile\fR
|
|
.TP
|
|
\fIEsempi\fR
|
|
.TP
|
|
.PD 0
|
|
\fB@package@\fR \fB\-s\fR ~/software/@package@-@version@.tar.bz2 \fB\-t\fR standard \fB\-o\fR @package@.spec
|
|
.TP
|
|
\fB@package@\fR \fB\-s\fR ftp://ftp.gnu.org/pub/gnu/bash/bash-4.2.tar.gz
|
|
.TP
|
|
\fB@package@\fR \fB\-s\fR \\
|
|
.TP
|
|
http://ovh.dl.sourceforge.net/sourceforge/avifile/avifile-0.7-0.7.45.tar.bz2 \\
|
|
\fB\-t\fR library \fB\-n\fR libavifile \fB\-v\fR 0.7.45 \\
|
|
\fB\-o\fR /usr/src/RPM/SPECS/libavifile.spec
|
|
.TP
|
|
\fB@package@\fR \fB\-s\fR \fB\-\-help\fR
|
|
.PD
|
|
.RE
|
|
|
|
.SS "Aggiornamento di pacchetti rpm"
|
|
\fB@package@\fR \
|
|
\fB\-u\fR \fIpck\fR \fB\-a\fR \fIazioni\fR [\fIver\fR] [\fIrel\fR] \
|
|
[\fB\-d\fR \fIv1=r1\fR[,\fIv2=r2\fR,...]] \
|
|
[\fB\-\-server\-download\fR \fIint\fR] \
|
|
[\fB\-\-server\-upload\fR \fIint\fR] \
|
|
[\fB\-l\fR \fIutente\fR:\fIpasswd\fR] \
|
|
[\fB\-S\fR \fIspecfile\fR] \
|
|
[\fB\-A\fR \fIarch\fR] \
|
|
[\fB\-\-changelog\fR "\fImsg\fR" ] \
|
|
[\fB\-\-nosrpm\fR|\fB\-\-norpm\fR] \
|
|
[\fB\-\-force-update\fR] [\fB\-\-force-build\fR] [\fB\-\-force-install\fR] \
|
|
[\fB\-\-ignore-test \fIt1\fR[,\fIt2\fR,...]\fR] \
|
|
[\fB\-c\fR] [\fB\-f\fR] [\fB\-L\fR] [\fB\-R\fR]
|
|
.TP
|
|
\fB\-u\fR, \fB\-\-update\fR
|
|
aggiorna il pacchetto \fIpck\fR, versione \fIver\fR,
|
|
release \fIrel\fR
|
|
.TP
|
|
\fB\-a\fR, \fB\-\-action\fR
|
|
Esegue la lista di azioni separate da virgole \fIazioni\fR:
|
|
.br
|
|
\fI0\fR. indica le versioni del pacchetto disponibili nei repository
|
|
.br
|
|
\fI1\fR. download ed installazione del pacchetto srpm
|
|
.br
|
|
\fI2\fR. controlla se e' disponibile un aggiornamento
|
|
.br
|
|
\fI3\fR. download dei nuovi file sorgente
|
|
.br
|
|
\fI4\fR. aggiornamento e controllo dello specfile
|
|
.br
|
|
\fI5\fR. creazione dei pacchetti rpm e srpm
|
|
.br
|
|
\fI6\fR. creazione della lista dei build requirement
|
|
.br
|
|
\fI7\fR. simulazione dell'installazione dei pacchetti rpm
|
|
.br
|
|
\fI8\fR. esecuzione dei test di qualita' e sicurezza
|
|
.br
|
|
\fI9\fR. calcolo dei valori di hashing md5 e sha1
|
|
.br
|
|
\fI10\fR. upload dei nuovi pacchetti sul sito ftp,
|
|
rimozione dei vecchi pacchetti dal sito ftp
|
|
(backup in `$ftp_rw_old_dir', se la variabile e' definita)
|
|
.br
|
|
\fI11\fR. installazione dei nuovi pacchetti rpm
|
|
.TP
|
|
\fB\-\-force-update\fR
|
|
forza l'aggiornamento dei pacchetti rpm e srpm
|
|
.TP
|
|
\fB\-\-force-build\fR
|
|
ricrea comunque i pacchetti rpm e srpm
|
|
.TP
|
|
\fB\-\-force-install\fR
|
|
installa i nuovi pacchetti anche in caso di errori rpm
|
|
.TP
|
|
\fB\-\-force\-download
|
|
scarica i file sorgente anche se presenti in SOURCE
|
|
.TP
|
|
\fB\-\-force\fR
|
|
cerca di eseguire comunque le azioni specificate
|
|
.TP
|
|
\fB\-\-ignore-test
|
|
non esegue i test indicati (\fIt1\fR, \fIt2\fR,...)
|
|
.TP
|
|
\fB\-d\fR, \fB\-\-define\fR
|
|
assegna alle variabili \fIv1\fR, \fIv2\fR,... i valori \fIr1\fR, \fIr2\fR,...
|
|
.TP
|
|
\fB\-\-server\-download\fR
|
|
server da utilizzare nel download dei pacchetti
|
|
.TP
|
|
\fB\-\-server-upload\fR
|
|
server dove effettuare l'upload dei pacchetti
|
|
.TP
|
|
\fB\-\-server\fR
|
|
server per l'upload e il download dei pacchetti
|
|
.TP
|
|
\fB\-l\fR, \fB\-\-login\fR
|
|
user \fIutente\fR e password \fIpasswd\fR per effettuare l'upload sul sito FTP
|
|
.TP
|
|
\fB\-S\fR, \fB\-\-specfile\fR
|
|
nome dello specfile (default: \fIname\fR.spec)
|
|
.TP
|
|
\fB\-A\fR, \fB\-\-arch\fR
|
|
forza un valore per l'architettura
|
|
.TP
|
|
\fB\-\-changelog\fR
|
|
scrive il messaggio \fImsg\fR nel changelog del pacchetto
|
|
(utilizzare `\en' come terminatore di linea in caso di messaggi multilinea)
|
|
.TP
|
|
\fB\-\-nosrpm\fR
|
|
crea soltanto i pacchetti rpm (azione 5)
|
|
.br
|
|
non effettua l'upload del pacchetto srpm (azione 10)
|
|
.TP
|
|
\fB\-\-norpm\fR
|
|
crea soltanto il pacchetto srpm (azione 5)
|
|
.br
|
|
non effettua l'upload dei pacchetti rpm (azione 10)
|
|
.TP
|
|
\fB\-\-list-check\fR
|
|
esegue un controllo dei file non pacchettizzati (azione 5)
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-clear\fR
|
|
rimuove tutti i file temporanei
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-format\fR
|
|
abilita la riformattazione dello specfile
|
|
.TP
|
|
\fB\-L\fR, \fB\-\-log\fR
|
|
abilita il log su file (nella directory: `$logging_dir')
|
|
.TP
|
|
\fB\-R\fR, \fB\-\-rebuild\fR
|
|
attiva modalita' ed impostazioni di rebuild (azione 4)
|
|
.TP
|
|
\fB\-R\fR, \fB\-\-root\fR
|
|
definisce una root directory alternativa per rpm
|
|
.TP
|
|
\fIEsempi\fR
|
|
.TP
|
|
.PD 0
|
|
\fB@package@\fR \fB\-u\fR @package@ @version@ \fB\-a\fR4 \fB\-\-changelog\fR "update to @version@"
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR4 \fB\-\-rebuild\fR
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR @package@ \fB\-\-log\fR \fB\-a\fR5,6:9 \fB\-\-define\fR addons_ver=0.9
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR @package@ \fB\-r\fR \fB\-a\fR5 \fB\-\-force-build\fR
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR1,4,5,8 \fB\-\-arch\fR=noarch \fB\-\-rebuild\fR
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR6
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR \fB\-c\fR \fB\-l\fR usr:pswd @package@ @version@ \fB\-a\fR10 \fB--server-upload\fR=0
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR @package@ @version@ \fB\-a\fR10 \fB--server-upload\fR=myrepos
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR10 \fB\-\-norpm\fR \fB\-S\fR /var/tmp/specs/@package@.spec
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR11 \fB\-\-force\fR
|
|
.TP
|
|
\fB@package@\fR \fB\-u\fR \fB\-\-help\fR
|
|
.PD
|
|
.RE
|
|
|
|
.SS "Estrazione di file da pacchetti srpm"
|
|
\fB@package@\fR \
|
|
\fB\-x\fR \fB\-F\fR \fIfile(s)\fR [\fB\-\-destdir\fR=\fIdir\fR] \fIsrpm_pck\fR
|
|
.TP
|
|
\fB\-x\fR, \fB\-\-extract\fR
|
|
estrae dal pacchetto srpm \fIsrpm_pck\fR...
|
|
.TP
|
|
\fB\-F\fR, \fB\-\-files\fR
|
|
\&...il file o la lista di file \fIfile(s)\fR
|
|
.TP
|
|
\fB\-\-destdir\fR
|
|
salva i file estratti nella cartella \fIdir\fR
|
|
.TP
|
|
\fIEsempi\fR
|
|
.TP
|
|
.PD 0
|
|
\fB@package@\fR \fB\-x\fR @package@\-@version@\-1mamba.src.rpm \fB\-\-destdir=\fR/tmp/
|
|
.TP
|
|
\fB@package@\fR \fB\-x\fR @package@\-@version@\-1mamba.src.rpm \fB\-F\fR \e*.spec \fB\-\-destdir=\fR/tmp/
|
|
.TP
|
|
\fB@package@\fR \fB\-x\fR \fB\-\-help\fR
|
|
.PD
|
|
.RE
|
|
|
|
.SS "Richiesta del valore di variabili presenti nei file di configurazione"
|
|
\fB@package@\fR \
|
|
[\fB\-C\fR \fIconf_file\fR] \fB\-\-eval\fR=\fIvar\fR
|
|
.TP
|
|
\fB\-C\fR, \fB\-\-config\fR
|
|
utilizza un file di configurazione alternativo \fIconf_file\fR
|
|
.br
|
|
file di default: vedere alla sezione \fBFILE DI CONFIGURAZIONE\fR
|
|
.TP
|
|
\fB\-\-eval\fR
|
|
stampa il valore che \fIvar\fR assume nei file di configurazione
|
|
.TP
|
|
\fIEsempi\fR
|
|
.TP
|
|
.PD 0
|
|
\fB@package@\fR \fB\-q\fR \fB\-\-eval\fR="logging_dir"
|
|
.TP
|
|
\fB@package@\fR -C /etc/@package@.d/02-specfile-rpm-groups.conf \fB\-\-eval\fR=rpm_allowed_groups
|
|
.TP
|
|
\fB@package@\fR \fB\-\-eval\fR \fB\-\-help\fR
|
|
.PD
|
|
.RE
|
|
|
|
.SS "Modalita' operative"
|
|
Sono inoltre disponibili alcune opzioni standard ed alcune opzioni di uso generale
|
|
che influenzano il tipo di output generato.
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
stampa una schermata di aiuto e termina il programma
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
stampa il numero di versione e termina il programma
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
non stampa alcun dettaglio delle operazioni in esecuzione
|
|
.TP
|
|
\fB\-r\fR, \fB\-\-colorize\fR
|
|
abilita l'output colorato
|
|
.TP
|
|
\fB\-D\fR, \fB\-\-debug\fR
|
|
attiva la modalita' di debugging (output prolisso)
|
|
|
|
.SH AUTORI
|
|
Davide Madrisan <davide.madrisan@gmail.com>
|
|
.br
|
|
Creatore e sviluppatore principale di @package@ (frontend, plugin, libspec.lib, documentazione).
|
|
|
|
Stefano Cotta Ramusino (whitone) <stefano.cotta@openmamba.org>
|
|
.br
|
|
Patch varie. Controllo delle licenze indicati negli specfile.
|
|
Modulo \fIAPSE\fR (Autospec Package Search Engine).
|
|
Modularizzare dei file di configurazione personali di @package@.
|
|
|
|
Silvan Calarco <silvan.calarco@mambasoft.it>
|
|
.br
|
|
Diverse patch, attivita' diffusa di beta testing.
|
|
Codice per la generazione automatica della lista dei build requirements.
|
|
Mofiche per permettere l'utilizzo di autospec in multi-architettura.
|
|
|
|
.SH "BACHI"
|
|
Inviare patch, segnalazioni di bachi, richieste di funzionalita' a <davide.madrisan@gmail.com>.
|
|
.br
|
|
Nel caso di bachi riscontrati, effettuarne una descrizione accurata e possibilmente un modo per
|
|
riprodurli.
|
|
|
|
Per il debugging di un problema e' spesso utile il log completo dell'esecuzione
|
|
di \fBautospec\fR con l'opzione \fB\-\-debug\fR, disattivando anche la traduzione dei messaggi,
|
|
cioe' eseguendo:
|
|
|
|
\fBLC_ALL=C autospec\fR ...
|
|
|
|
.SH COPYRIGHT
|
|
Copyright (C) 2004\-2012 Davide Madrisan <davide.madrisan@gmail.com>
|
|
.br
|
|
.br
|
|
Questo e' software libero. E' possibile redistribuirlo e/o modificarlo nei termini
|
|
della GNU General Public License versione 2 cosi' come pubblicata dalla
|
|
Free Software Foundation.
|
|
Non e' fornita ALCUNA garanzia, neppure di NEGOZIABILITA' o di APPLICABILITA'
|
|
PER UN PARTICOLARE SCOPO.
|