table of contents
other versions
- jessie 1.17.27
deb-substvars(5) | utilità dpkg | deb-substvars(5) |
NOME¶
deb-substvars - variabili sostituite nei sorgenti DebianSINTASSI¶
substvarsDESCRIZIONE¶
Prima che dpkg-source, dpkg-gencontrol e dpkg-genchanges scrivano le loro informazioni di controllo (nel file sorgente di controllo .dsc per quanto riguarda dpkg-source e sullo standard output per dpkg-gencontrol e dpkg-genchanges), effettuano alcune sostituzioni di variabili nel file di output. Una sostituzione di variabile ha la forma ${nome-variabile}. I nomi di variabile sono formati da caratteri alfanumerici, trattini («-») e due punti («:») e iniziano con un carattere alfanumerico. Le sostituzioni di variabili vengono eseguite ripetutamente fino a che non ne rimangono più; il testo completo del campo dopo la sostituzione viene analizzato di nuovo per cercare nuove sostituzioni. Una volta fatte tutte le sostituzioni, ciascuna occorrenza della stringa ${} (che non è una sostituzione permessa) viene sostituita da un carattere $. Sebbene la sostituzione delle variabili viene fatta in tutti i campi di controllo, alcuni di tali campi sono usati e necessari durante la compilazione, quando la sostituzione non è ancora avvenuta. Questo è il motivo per cui non si possono usare variabili nei campi Package, Source e Architecture. La sostituzione delle variabili avviene nel contenuto dei campi dopo che sono stati analizzati, perciò se si desidera che una variabile si estenda su più righe non si deve aggiungere uno spazio dopo il ritorno a capo. Ciò viene fatto implicitamente quando il campo viene prodotto in output. Per esempio, se la variabile ${Description} è impostata a «pinco è questo.${Newline}pinco è quest'altro.» e se si ha il campo seguente:Description: applicazione pinco
${Description}
.
Altro testo. Il risultato è:
Description: applicazione pinco
pinco è questo.
pinco è quest'altro.
.
Altro testo. Le variabili possono essere impostate usando l'opzione comune -V. Possono anche essere specificate nel file debian/substvars (o qualsiasi altro file venga specificato usando l'opzione -T). Il file è formato da righe nella forma nome=valore. Gli spazi bianchi alla fine di ogni riga, le righe vuote e le righe che iniziano con un simbolo # (commenti) vengono ignorati. In aggiunta, sono disponibili le seguenti variabili standard:
- Arch
- L'attuale architettura di compilazione (da dpkg --print-architecture).
- source:Version
- La versione del pacchetto sorgente.
- source:Upstream-Version
- La versione del pachetto sorgente originale, inclusa l'epoca di versione Debian se presente.
- binary:Version
- La versione del pacchetto binario (che può essere diversa da source:Version ad esempio in un NMU binario).
- Source-Version
- La versione del pacchetto sorgente (dal file changelog). Questa variabile è ora deprecata dato che il suo significato è diverso dalla sua funzione; usare source:Version o binary:Version a seconda delle necessità.
- Installed-Size
- La dimensione totale dei file installati del pacchetto. Questo valore viene copiato nel campo corrispondente del file di controllo; impostandolo si modifica il valore di tale campo. Se questa variabile non è impostata dpkg-gencontrol viene usato du -k debian/tmp per trovare il valore predefinito.
- Extra-Size
- Lo spazio su disco aggiuntivo usato quando il pacchetto viene installato. Se questa variabile viene impostata, il suo valore viene sommato a quello della variabile Installed-Size (usando il valore impostato esplicitamente oppure quello predefinito), prima di essere copiato nel campo Installed-Size del file di controllo.
- F:nomecampo
- Il valore in output del campo nomecampo (che deve essere specificato usando le minuscole e maiuscole appropriate). L'impostazione di queste variabili non ha effetto, tranne dove esse vengono esplicitamente espanse.
- Format
- Il formato del file .changes generato da questa versione degli script di pacchettizzazione dei sorgenti. Se si imposta questa variabile, anche il contenuto del campo Format nel file .changes cambia.
- Newline, Space, Tab
- Queste variabili contengono ciascuna il carattere corrispondente: nuova riga, spazio e tabulazione.
- shlibs:campodipendenza
- L'impostazione di variabili con nomi in questa forma è generata da dpkg-shlibdeps.
- dpkg:Upstream-Version
- La versione originale di dpkg.
- dpkg:Version
- La versione completa di dpkg.
FILE¶
- debian/substvars
- Elenco di variabili da sostituire e di valori.
VEDERE ANCHE¶
dpkg(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-shlibdeps(1), dpkg-source(1).15 luglio 2009 | Progetto Debian |