dpkg-source - Online nel cloud

PROGRAMMA:

NOME

dpkg-source - Strumento di manipolazione del pacchetto sorgente Debian (.dsc)

SINOSSI

dpkg-source [opzione...] command

DESCRIZIONE

dpkg-source comprime e decomprime gli archivi dei sorgenti Debian.

Nessuno di questi comandi consente di combinare più opzioni in una e non lo fanno
consente di specificare il valore di un'opzione in un argomento separato.

COMANDI

-x, --estratto Nome del file.dsc [cartella di destinazione]
Estrai un pacchetto sorgente (--estratto da dpkg 1.17.14). Un argomento di non opzione
deve essere fornito, il nome del file di controllo del codice sorgente Debian (.dsc). Un optional
secondo argomento non-opzione può essere fornito per specificare la directory in cui estrarre il
pacchetto sorgente a, questo non deve esistere. Se non viene specificata alcuna directory di output, il
il pacchetto sorgente viene estratto in una directory denominata source-versione sotto la corrente
directory di lavoro.

dpkg-source leggerà i nomi degli altri file che compongono il pacchetto sorgente
dal file di controllo; si presume che si trovino nella stessa directory del .dsc.

I file nel pacchetto estratto avranno i loro permessi e proprietà impostati
a quelli che ci si aspetterebbe se i file e le directory fossero semplicemente
stato creato - le directory e i file eseguibili saranno 0777 e i file semplici lo saranno
be 0666, entrambi modificati dall'umask degli estrattori; se la directory padre è setgid
lo saranno anche le directory estratte e tutti i file e le directory
ereditare la proprietà del gruppo.

Se il pacchetto sorgente usa un formato non standard (attualmente questo significa tutti i formati
tranne "1.0"), il suo nome verrà memorizzato in debian/sorgente/formato In modo che la
le build successive del pacchetto sorgente utilizzano lo stesso formato per impostazione predefinita.

-b, --costruire elenco [parametri specifici del formato]
Crea un pacchetto sorgente (--costruire da dpkg 1.17.14). Il primo argomento di non opzione
è preso come il nome della directory che contiene l'albero dei sorgenti debianizzato (cioè
con una sottodirectory debian e forse modifiche ai file originali). A seconda di
il formato del pacchetto sorgente utilizzato per creare il pacchetto, potrebbero essere parametri aggiuntivi
accettato.

dpkg-source creerà il pacchetto sorgente con il primo formato trovato in questo
elenco ordinato: il formato indicato con il --formato opzione della riga di comando, il
formato indicato in debian/sorgente/formato, “1.0”. Il fallback a "1.0" è
deprecato e verrà rimosso in futuro, dovresti sempre
documenta il formato sorgente desiderato in debian/sorgente/formato. Vedi sezione FONTE
PACCHETTO FORMATI per un'ampia descrizione dei vari formati dei pacchetti sorgente.

--formato di stampa elenco
Stampa il formato sorgente che verrebbe utilizzato per creare il pacchetto sorgente se
dpkg-source --costruire elenco è stato chiamato (nelle stesse condizioni e con le stesse
parametri; da dpkg 1.15.5).

--prima della compilazione elenco
Esegui l'hook corrispondente del formato del pacchetto sorgente (a partire da dpkg 1.15.8). Questo
hook viene chiamato prima di qualsiasi build del pacchetto (dpkg-buildpackage lo chiama molto
presto anche prima debian/regole cavedano). Questo comando è idempotente e può essere chiamato
più volte. Non tutti i formati sorgente implementano qualcosa in questo hook e quelli
che di solito preparano l'albero dei sorgenti per la compilazione, ad esempio assicurandosi che
vengono applicate le patch Debian.

--dopo-costruzione elenco
Esegui l'hook corrispondente del formato del pacchetto sorgente (a partire da dpkg 1.15.8). Questo
hook viene chiamato dopo ogni build del pacchetto (dpkg-buildpackage lo chiama ultimo).
Questo comando è idempotente e può essere chiamato più volte. Non tutti i formati di origine
implementare qualcosa in questo hook e quelli che lo fanno di solito lo usano per annullare cosa
--prima della compilazione ha fatto.

--commettere [elenco]...
Registra le modifiche nell'albero di origine decompresso in elenco (da dpkg 1.16.1). Questo
Il comando può assumere parametri supplementari a seconda del formato di origine. Lo farà
errore per i formati in cui questa operazione non significa nulla.

-?, --Aiuto
Mostra il messaggio di utilizzo ed esci.

--versione
Mostra la versione ed esci.

VERSIONI

Generico costruire Opzioni
-cfile di controllo
Specifica il file di controllo del codice sorgente principale da cui leggere le informazioni. L'impostazione predefinita è
debian / control. Se dato con un percorso relativo questo viene interpretato a partire da
la directory di primo livello dell'albero dei sorgenti.

-lfile di log delle modifiche
Specifica il file changelog da cui leggere le informazioni. L'impostazione predefinita è
debian/log delle modifiche. Se dato con un percorso relativo questo viene interpretato a partire da
la directory di primo livello dell'albero dei sorgenti.

-Fchangelog-formato
Specifica il formato del log delle modifiche. Vedere dpkg-parsechangelog(1) per informazioni
sui formati alternativi.

--formato=APPREZZIAMO
Usa il formato indicato per compilare il pacchetto sorgente (a partire da dpkg 1.14.17). lo fa
sovrascrivere qualsiasi formato dato in debian/sorgente/formato.

-VNome=APPREZZIAMO
Imposta una variabile di sostituzione dell'output. Vedere deb-substvars(5) per una discussione di
sostituzione dell'uscita.

-Tfile-substvars
Leggi le variabili di sostituzione in file-substvars; l'impostazione predefinita è non leggere alcun file.
Questa opzione può essere utilizzata più volte per leggere le variabili di sostituzione da più
file (a partire da dpkg 1.15.6).

-Dcampo=APPREZZIAMO
Sostituisci o aggiungi un campo del file di controllo dell'output.

-Ucampo
Rimuovere un campo del file di controllo dell'output.

-Zcompressione, --compressione=compressione
Specificare la compressione da utilizzare per i tarball creati e i file diff (--compressione
da dpkg 1.15.5). Nota che questa opzione non farà sì che i tarball esistenti siano
ricompresso, interessa solo i nuovi file. I valori supportati sono: gzip, bzip2, lzma
ed xz. L'impostazione predefinita è xz per i formati 2.0 e successivi e gzip per il formato 1.0. xz
è supportato solo da dpkg 1.15.5.

-zlivello, --livello di compressione=livello
Livello di compressione da usare (--livello di compressione da dpkg 1.15.5). come con -Z it
interessa solo i file appena creati. I valori supportati sono: 1 a 9, miglioree veloce.
L'impostazione predefinita è 9 per gzip e bzip2, 6 per xz e lzma.

-i[regex], --diff-ignora[=regex]
Puoi specificare un'espressione regolare perl per abbinare i file da cui vuoi filtrare
l'elenco dei file per il diff (--diff-ignora da dpkg 1.15.6). (Questa lista è
generato da un comando find.) (Se il pacchetto sorgente viene compilato come versione 3
pacchetto sorgente utilizzando un VCS, questo può essere usato per ignorare le modifiche non salvate su
file specifici. L'uso di -i.* li ignorerà tutti.)

I -i l'opzione da sola abilita questa impostazione con un'espressione regolare predefinita (conservando qualsiasi
modifica alla regex predefinita eseguita da un precedente utilizzo di --extend-diff-ignora)
che filtrerà i file di controllo e le directory della revisione più comune
sistemi di controllo, backup e scambio di file e directory di output di build di Libtool. Là
può essere solo una regex attiva, di più -i opzioni prenderà solo l'ultima
effetto.

Questo è molto utile per eliminare i file estranei che vengono inclusi nel diff,
ad esempio se mantieni la tua fonte in un sistema di controllo di revisione e vuoi usare a
checkout per creare un pacchetto sorgente senza includere i file aggiuntivi e
directory che normalmente conterrà (es. CVS/, .cvsignore, .svn/). Il
l'espressione regolare predefinita è già molto esaustiva, ma se è necessario sostituirla, per favore
nota che per impostazione predefinita può corrispondere a qualsiasi parte di un percorso, quindi se vuoi abbinare il
inizio di un nome di file o solo nomi di file completi, dovrai fornire il necessario
ancore (es. '(^|/)', '($|/)') te stesso.

--extend-diff-ignora=regex
L'espressione regolare perl specificata estenderà il valore predefinito utilizzato da
--diff-ignora e il suo valore corrente, se impostato (a partire da dpkg 1.15.6). Lo fa da
concatenando”|regex” al valore esistente. Questa opzione è comoda da usare in
debian/sorgente/opzioni per escludere alcuni file generati automaticamente dalla patch automatica
generazione.

-I[modello di file], --tar-ignora[=modello di file]
Se viene specificata questa opzione, il modello verrà passato a tar(1)'s --escludere
opzione quando viene chiamato per generare un file .orig.tar o .tar (--tar-ignora da
dpkg 1.15.6). Per esempio, -ICVS farà saltare tar le directory CVS quando
generando un file .tar.gz. L'opzione può essere ripetuta più volte per elencare
più modelli da escludere.

-I da solo aggiunge default --escludere opzioni che filtreranno i file di controllo e
directory dei più comuni sistemi di controllo di revisione, file di backup e scambio e
Libtool crea directory di output.

Nota: Sebbene abbiano scopi simili, -i ed -I hanno una sintassi molto diversa e
semantica. -i può essere specificato solo una volta e accetta un'espressione regolare compatibile con perl
che viene confrontato con il percorso relativo completo di ciascun file. -I può specificare più
volte e prende un modello di nome file con caratteri jolly della shell. Il modello viene applicato al
percorso relativo completo ma anche a ciascuna parte del percorso individualmente. L'esatta semantica di
catrame --escludere l'opzione è un po' complicata, vedi
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

L'espressione regolare e i modelli predefiniti per entrambe le opzioni possono essere visualizzati nell'output di --Aiuto
comando.

Generico estratto Opzioni
--no-copia
Non copiare i tarball originali vicino al pacchetto sorgente estratto (poiché dpkg
1.14.17).

--nessun controllo
Non controllare firme e checksum prima di disimballare (da dpkg 1.14.17).

--richiede-firma-valida
Rifiuta di decomprimere il pacchetto sorgente se non contiene una firma OpenPGP che
può essere verificato (a partire da dpkg 1.15.0) sia con l'utente trustkeys.gpg portachiavi,
uno dei portachiavi specifici del fornitore o uno dei portachiavi Debian ufficiali
(/usr/share/keyrings/debian-keyring.gpg ed
/usr/share/keyrings/debian-maintainers.gpg).

--ignora-versione-cattiva
Trasforma il controllo della versione del pacchetto sorgente non valido in un avviso non fatale (dal momento che dpkg
1.17.7). Questa opzione dovrebbe essere necessaria solo quando si estrae una fonte antica
pacchetti con versioni danneggiate, solo per retrocompatibilità.

FONTE PACCHETTO FORMATI

Se non sai quale formato di origine utilizzare, probabilmente dovresti scegliere "3.0 (quilt)"
o "3.0 (nativo)". Vedere https://wiki.debian.org/Projects/DebSrc3.0 per informazioni sul
distribuzione di quei formati all'interno di Debian.

Formato: 1.0
Un pacchetto sorgente in questo formato consiste di a .orig.tar.gz associato a .diff.gz
o un singolo .tar.gz (in tal caso si dice che il pacco sia nativo).

Estrazione

L'estrazione di un pacchetto nativo è una semplice estrazione del singolo tarball nel target
directory. L'estrazione di un pacchetto non nativo viene eseguita decomprimendo prima il .orig.tar.gz ed
quindi applicando la patch contenuta nel .diff.gz file. Il timestamp di tutti i file con patch
viene reimpostato all'ora di estrazione del pacchetto sorgente (questo evita che le differenze di timestamp portino all'inizio
a problemi quando i file generati automaticamente vengono corretti). Il diff può creare nuovi file (il
l'intera directory Debian viene creata in questo modo) ma non è possibile rimuovere i file (i file vuoti saranno
rimasto).

Costruzione

La creazione di un pacchetto nativo è semplicemente la creazione di un singolo tarball con la directory dei sorgenti.
La creazione di un pacchetto non nativo implica l'estrazione del tarball originale in un file separato
directory “.orig” e rigenerando il .diff.gz confrontando il pacchetto sorgente elenco
con la directory .orig.

Costruire Opzioni (con --costruire):

Se viene fornito un secondo argomento non di opzione, dovrebbe essere il nome della fonte originale
directory o tarfile o la stringa vuota se il pacchetto è specifico di Debian e così
non ha differenze di debianizzazione. Se non viene fornito alcun secondo argomento, allora dpkg-source sarà
per il tarfile sorgente originale pacchetto_versione-upstream.orig.tar.gz o l'originale
directory di origine elenco.origine dipende da -sX argomenti.

-sa, -sp, -sk, -la sua ed -sr non sovrascriverà i file tar o le directory esistenti. Se questo è
desiderato allora -sa, -sP, -SK, -SU ed -sR dovrebbe essere usato invece.

-sk Specifica di aspettarsi il sorgente originale come un file tar, per impostazione predefinita pacchetto_upstream-
versione.tar.orig.estensione. Lascerà questa fonte originale al suo posto come a
tarfile, o copialo nella directory corrente se non è già lì. Il tarball
sarà decompresso in elenco.origine per la generazione del diff.

-sp Come -sk ma rimuoverà nuovamente la directory in seguito.

-la sua Specifica che la fonte originale è prevista come directory, per impostazione predefinita pacchetto-
versione upstream.origine ed dpkg-source creerà un nuovo archivio sorgente originale
da.

-sr Come -la sua ma rimuoverà quella directory dopo che è stata utilizzata.

-ss Specifica che il sorgente originale è disponibile sia come directory che come a
tarfile. dpkg-source userà la directory per creare il diff, ma il file tar per
creare il .dsc. Questa opzione deve essere usata con cautela - se la directory e il file tar
non corrispondono verrà generato un archivio di origine errato.

-sn Specifica di non cercare alcuna fonte originale e di non generare un diff. Il
il secondo argomento, se fornito, deve essere la stringa vuota. Questo è usato per Debian-
pacchetti specifici che non hanno una fonte a monte separata e quindi hanno
nessuna differenza di debianizzazione.

-sa or -sa
Specifica di cercare l'archivio sorgente originale come file tar o come directory -
il secondo argomento, se presente, può essere o o la stringa vuota (questo è equivalente
all'utilizzo -sn). Se viene trovato un file tar, lo scompatterà per creare il diff e
rimuoverlo in seguito (questo equivale a -sp); se viene trovata una directory, lo farà
comprimerlo per creare la fonte originale e rimuoverlo in seguito (questo è equivalente
a -sr); se nessuno dei due viene trovato, si presumerà che il pacchetto non abbia debianizzazione
diffs, solo un semplice archivio di sorgenti (questo equivale a -sn). Se entrambi
si trovano allora dpkg-source ignorerà la directory, sovrascrivendola, se -sa Prima
specificato (equivale a -sP) o genera un errore se -sa è stato specificato. -sa
è l'impostazione predefinita.

--abort-on-upstream-changes
Il processo fallisce se il diff generato contiene modifiche ai file al di fuori del
sottodirectory debian (a partire da dpkg 1.15.8). Questa opzione non è consentita in
debian/sorgente/opzioni ma può essere utilizzato in debian/source/opzioni-locali.

Estratto Opzioni (con --estratto):

In tutti i casi qualsiasi albero dei sorgenti originale esistente verrà rimosso.

-sp Utilizzato durante l'estrazione, il sorgente originale (se presente) verrà lasciato come file tar.
Se non si trova già nella directory corrente o se esiste un ma
file diverso è lì verrà copiato lì. (La sezione is , il difetto).

-la sua Decomprime l'albero dei sorgenti originale.

-sn Assicura che la sorgente originale non venga né copiata nella directory corrente né
disimballato. Qualsiasi albero dei sorgenti originale che si trovava nella directory corrente è ancora
rimosso.

Tutto l' -sX le opzioni si escludono a vicenda. Se specifichi più di uno solo l'ultimo
verrà utilizzato.

--skip-debianizzazione
Salta l'applicazione del diff debian sopra i sorgenti upstream (dal momento che dpkg
1.15.1).

Formato: 2.0
Estrazione supportata da dpkg 1.13.9, costruzione supportata da dpkg 1.14.8. Anche conosciuto
come parrucca e penna. Questo formato non è raccomandato per un uso diffuso, il formato "3.0 (quilt)"
lo sostituisce. Wig&pen è stata la prima specifica di un pacchetto sorgente di nuova generazione
formato.

Il comportamento di questo formato è lo stesso del formato "3.0 (quilt)" tranne per il fatto che
non usa un elenco esplicito di patch. Tutti i file in debian/patch/ abbinando il perl
espressione regolare [\w-]+ devono essere patch valide: vengono applicate al momento dell'estrazione.

Quando si compila un nuovo pacchetto sorgente, qualsiasi modifica al sorgente upstream viene memorizzata in una patch
detto zz_debian-diff-auto.

Formato: 3.0 (nativo)
Supportato da dpkg 1.14.17. Questo formato è un'estensione del formato del pacchetto nativo come
definito nel formato 1.0. Supporta tutti i metodi di compressione e ignorerà per impostazione predefinita
qualsiasi file e directory specifici di VCS così come molti file temporanei (vedi valore predefinito
associato a -I opzione nel --Aiuto produzione).

Formato: 3.0 (trapunta)
Supportato da dpkg 1.14.17. Un pacchetto sorgente in questo formato contiene almeno un
tarball originale (.tar.orig.ext where ext può essere gz, bz2, lzma ed xz) e una debian
tarball (.debian.tar.ext). Può anche contenere tarball originali aggiuntivi
(.origin-componente.catrame.ext). componente può contenere solo caratteri alfanumerici e trattini
('-').

Estrazione

Il tarball originale principale viene estratto per primo, quindi vengono estratti tutti i tarball originali aggiuntivi
estratto in sottodirectory che prendono il nome dal componente parte del loro nome file (qualsiasi pre-
directory esistente viene sostituita). Il tarball debian viene estratto sopra il sorgente
directory previa rimozione di eventuali preesistenti debian directory. Nota che Debian
il tarball deve contenere a debian sottodirectory ma può anche contenere file binari all'esterno
di quella directory (vedi --include-binari opzione).

Tutte le patch elencate in debian/patch/debian.series or debian/patch/series sono quindi
applicato. Se viene utilizzato il primo file e il secondo non esiste (o è un collegamento simbolico),
quindi quest'ultimo viene sostituito con un collegamento simbolico al primo. Questo ha lo scopo di semplificare l'uso
of trapunta per gestire il set di patch. Si noti tuttavia che mentre dpkg-source analizza
serie correttamente i file con le opzioni esplicite usate per l'applicazione delle patch (memorizzati su ciascuno
riga dopo il nome del file della patch e uno o più spazi), ignora quelle opzioni e
aspettati sempre patch che possono essere applicate con il -p1 possibilità di patch. Emetterà così
un avviso quando incontra tali opzioni ed è probabile che la build fallisca.

Il timestamp di tutti i file con patch viene reimpostato sull'ora di estrazione del pacchetto sorgente
(questo evita differenze di timestamp che portano a problemi quando i file generati automaticamente vengono corretti).

Contrario a trapuntacomportamento predefinito, le patch dovrebbero essere applicate senza alcun fuzz.
Quando ciò non è il caso, dovresti aggiornare tali patch con trapunta, o dpkg-source volere
errore durante il tentativo di applicarli.

Analogamente a trapuntacomportamento predefinito, le patch possono anche rimuovere i file.

Il file .pc/applicato-patch viene creato se sono state applicate alcune patch durante il
estrazione.

Costruzione

Tutti i tarball originali trovati nella directory corrente vengono estratti in modo temporaneo
directory seguendo la stessa logica dell'unpack, la directory debian viene copiata
nella directory temporanea e tutte le patch tranne la patch automatica
(debian-cambiamenti-versione or modifiche-debian, a seconda di --single-debian-patch) siamo
applicato. La directory temporanea viene confrontata con la directory del pacchetto di origine. Quando il
diff non è vuoto, la compilazione fallisce a meno che --single-debian-patch or --auto-commit è stata
utilizzato, nel qual caso il diff viene memorizzato nella patch automatica. Se la patch automatica è
creato/cancellato, viene aggiunto/rimosso dal file series e dal trapunta metadati.

Qualsiasi modifica su un file binario non è rappresentabile in un diff e quindi porterà a un errore
a meno che il manutentore non abbia deliberatamente deciso di includere quel file binario modificato nel
debian tarball (elencandolo in debian/source/include-binaries). Anche la build fallirà
se trova file binari nella sottodirectory debian a meno che non siano stati inseriti nella whitelist
attraverso debian/source/include-binaries.

La directory Debian aggiornata e l'elenco dei binari modificati vengono quindi utilizzati per generare
il tarball di Debian.

La differenza generata automaticamente non include modifiche su file specifici VCS così come
molti file temporanei (vedi il valore predefinito associato a -i opzione nel --Aiuto produzione). In
particolare, il .PC directory usata da trapunta viene ignorato durante la generazione dell'automatico
patch.

Nota: dpkg-source --prima della compilazione (E --costruire) assicurerà che tutte le patch elencate nel
series vengono applicati in modo che una build del pacchetto abbia sempre tutte le patch applicate. lo fa
questo trovando le patch non applicate (sono elencate nella sezione serie file ma non in
.pc/applicato-patch), e se la prima patch di quel set può essere applicata senza errori, è
li applicherà tutti. L'opzione --no-preparazione può essere utilizzato per disabilitare questo comportamento.

Registrazione i cambiamenti

--commettere [elenco] [nome-patch] [file-patch]
Genera una patch corrispondente alle modifiche locali che non sono gestite dal
trapunta sistema di patch e lo integra nel sistema di patch sotto il nome nome-patch.
Se manca il nome, verrà chiesto in modo interattivo. Se file-patch è dato, è
viene utilizzato come patch corrispondente alle modifiche locali da integrare. Una volta
integrato, viene lanciato un editor in modo da poter modificare le meta-informazioni nel
intestazione della patch.

Di passaggio file-patch è utile principalmente dopo un errore di compilazione che lo ha pregenerato
file, e per questo motivo il file fornito viene rimosso dopo l'integrazione. Nota anche
che le modifiche contenute nel file patch devono essere già applicate sull'albero
e che i file modificati dalla patch non devono avere non registrati supplementari
modifiche.

Se la generazione della patch rileva file binari modificati, verranno automaticamente
aggiunto a debian/source/include-binaries in modo che finiscano nel tarball di Debian
(esattamente come dpkg-source --include-binari --costruire farebbe).

Costruire Opzioni

--allow-versione-di-quilt-db=versione
Consentire dpkg-source per compilare il pacchetto sorgente se la versione del trapunta metadati
è quello specificato, anche se dpkg-source non lo sa (dal momento che dpkg
1.15.5.4). In effetti questo dice che la versione data del trapunta i metadati sono
compatibile con la versione 2 che dpkg-source attualmente supporta. La versione di
, il trapunta i metadati sono memorizzati in .pc/.versione.

--include-rimozione
Non ignorare i file rimossi e includerli nella patch generata automaticamente.

--include-timestamp
Includere il timestamp nella patch generata automaticamente.

--include-binari
Aggiungere tutti i binari modificati nel tarball di Debian. Aggiungili anche a
debian/source/include-binaries: verranno aggiunti di default nelle build successive
e questa opzione quindi non è più necessaria.

--no-preparazione
Non cercare di preparare l'albero di build applicando patch che apparentemente sono
non applicato (da dpkg 1.14.18).

--single-debian-patch
Usa il debian/patch/debian-changes invece di debian/patch/debian-changes-versione
per il nome della patch automatica generata durante la compilazione (a partire da dpkg 1.15.5.4).
Questa opzione è particolarmente utile quando il pacchetto è mantenuto in un VCS e a
il set di patch non può essere generato in modo affidabile. Invece l'attuale diff con upstream
devono essere conservati in un'unica patch. L'opzione sarebbe stata inserita
debian/source/opzioni-locali e sarebbe accompagnato da a
debian/source/local-patch-header file che spiega come le modifiche Debian possono essere migliori
rivisto, ad esempio nel VCS utilizzato.

--crea-vuoto-orig
Crea automaticamente il tarball originale principale come vuoto se manca e se
ci sono tarball originali supplementari (a partire da dpkg 1.15.6). Questa opzione è
pensato per essere utilizzato quando il pacchetto sorgente è solo un insieme di più upstream
software e dove non esiste un software "principale".

--no-unapply-patch, --unapply-patch
Per impostazione predefinita, dpkg-source annullerà automaticamente le patch nel --dopo-costruzione
gancio se li ha applicati durante --prima della compilazione (--unapply-patch dal momento che dpkg
1.15.8 --no-unapply-patch da dpkg 1.16.5). Queste opzioni ti consentono di
disabilitare o abilitare forzatamente il processo di disapplicazione della patch. Queste opzioni sono
consentito solo in debian/source/opzioni-locali in modo che tutti i pacchetti sorgente generati
hanno lo stesso comportamento per impostazione predefinita.

--abort-on-upstream-changes
Il processo fallisce se è stata generata una patch automatica (a partire da dpkg 1.15.8).
Questa opzione può essere utilizzata per garantire che tutte le modifiche siano state registrate correttamente in
separato trapunta patch prima della compilazione del pacchetto sorgente. Questa opzione non lo è
ammessi debian/sorgente/opzioni ma può essere utilizzato in debian/source/opzioni-locali.

--auto-commit
Il processo non fallisce se è stata generata una patch automatica, invece è
immediatamente registrato nel trapunta serie.

Estratto Opzioni

--skip-debianizzazione
Salta l'estrazione del tarball debian sopra i sorgenti upstream (dal momento che dpkg
1.15.1).

--skip-patch
Non applicare patch alla fine dell'estrazione (da dpkg 1.14.18).

Formato: 3.0 (personalizzato)
Supportato da dpkg 1.14.17. Questo formato è speciale. Non rappresenta una vera fonte
formato del pacchetto, ma può essere utilizzato per creare pacchetti sorgente con file arbitrari.

Costruire Opzioni

Tutti gli argomenti non di opzione vengono presi come file da integrare nel pacchetto sorgente generato.
Devono esistere e si trovano preferibilmente nella directory corrente. Almeno un file deve essere
dato.

--formato-destinazione=APPREZZIAMO
Obbligatorio. Definisce il formato reale del pacchetto sorgente generato. Il generato
Il file .dsc conterrà questo valore nella sua Formato campo e non “3.0 (personalizzato)”.

Formato: 3.0 (idiota)
Supportato da dpkg 1.14.17. Questo formato è sperimentale.

Un pacchetto sorgente in questo formato è costituito da un singolo pacchetto di un repository git .idiota a
contenere l'origine di un pacchetto. Potrebbe esserci anche un .gitshallow revisioni dell'elenco dei file per
un clone git superficiale.

Estrazione

Il bundle viene clonato come repository git nella directory di destinazione. Se c'è un
gitshallow, è installato come .git/superficiale all'interno del repository git clonato.

Nota che per impostazione predefinita il nuovo repository avrà lo stesso ramo estratto che era
verificato nella fonte originale. (In genere "master", ma potrebbe essere qualsiasi cosa.) Any
altre filiali saranno disponibili sotto telecomandi/origine/.

Costruzione

Prima di procedere oltre, vengono effettuati alcuni controlli per garantire che non ci siano
ignorate le modifiche non salvate.

pacchetto git(1) viene utilizzato per generare un bundle del repository git. Per impostazione predefinita, tutto
rami e tag nel repository sono inclusi nel bundle.

Costruire Opzioni

--git-ref=ref
Consente di specificare un git ref da includere nel pacchetto git. Usa disabilita l'impostazione predefinita
comportamento di includere tutti i rami e i tag. Può essere specificato più volte. Il
ref può essere il nome di un ramo o di un tag da includere. Potrebbe anche essere qualsiasi parametro
che può essere passato a elenco-git-rev(1). Ad esempio, per includere solo il master
ramo, uso --git-ref=maestro. Per includere tutti i tag e i rami, ad eccezione di
ramo privato, uso --git-ref=--tutti --git-ref=^privato

--git-profondità=numero
Crea un clone superficiale con una cronologia troncata al numero specificato di
revisioni.

Formato: 3.0 (azz)
Supportato da dpkg 1.14.17. Questo formato è sperimentale. Genera un singolo tarball
contenente il repository bzr.

Estrazione

Il tarball viene decompresso e quindi bzr viene utilizzato per estrarre il ramo corrente.

Costruzione

Prima di procedere oltre, vengono effettuati alcuni controlli per garantire che non ci siano
ignorate le modifiche non salvate.

Quindi la parte specifica di VCS della directory di origine viene copiata in un file temporaneo
directory. Prima che questa directory temporanea venga compressa in un tarball, vengono eseguite varie operazioni di pulizia
fatto per risparmiare spazio.

DIAGNOSTICA

no source formato specificato in debian/sorgente/formato
Il file debian/sorgente/formato dovrebbe sempre esistere e indicare il formato di origine desiderato.
Per compatibilità con le versioni precedenti, si assume il formato "1.0" quando il file non esiste ma tu
non dovrebbe fare affidamento su questo: ad un certo punto in futuro dpkg-source verrà modificato per fallire
quando quel file non esiste.

La logica è che il formato "1.0" non è più il formato consigliato, di solito dovresti
scegli uno dei formati più recenti ("3.0 (quilt)", "3.0 (nativo)") ma dpkg-source non va bene
questo automaticamente per te. Se vuoi continuare a utilizzare il vecchio formato, dovresti essere
esplicito a riguardo e metti "1.0" in debian/sorgente/formato.

, il diff modifica , il i seguenti a monte file
Quando si utilizza il formato sorgente "1.0" di solito è una cattiva idea modificare direttamente i file upstream
poiché le modifiche finiscono per essere nascoste e per lo più non documentate nel file .diff.gz. invece tu
dovrebbe memorizzare le modifiche come patch nella directory debian e applicarle in fase di compilazione.
Per evitare questa complessità puoi anche utilizzare il formato “3.0 (quilt)” che offre questo
nativamente.

non può rappresentare il cambiamento a filetto
Le modifiche alle fonti upstream vengono solitamente memorizzate con file di patch, ma non tutte le modifiche possono
essere rappresentati con patch: possono alterare solo il contenuto dei file di testo normale. Se tu
prova a sostituire un file con qualcosa di tipo diverso (ad esempio sostituendo un semplice
file con un collegamento simbolico o una directory), riceverai questo messaggio di errore.

recentemente creato vuoto filetto filetto volere non be rappresentato in diff
I file vuoti non possono essere creati con i file di patch. Quindi questo cambiamento non è registrato nel
pacchetto sorgente e ne sei avvisato.

eseguibile modo permanenti of filetto volere non be rappresentato in diff
I file di patch non registrano i permessi dei file e quindi i permessi eseguibili non lo sono
memorizzato nel pacchetto sorgente. Questo avvertimento ti ricorda questo fatto.

la nostra speciale modo permanenti of filetto volere non be rappresentato in diff
I file di patch non registrano i permessi dei file e quindi i permessi modificati non lo sono
memorizzato nel pacchetto sorgente. Questo avvertimento ti ricorda questo fatto.

RISORSE FORMATI

debian/sorgente/formato
Questo file contiene su una singola riga il formato che dovrebbe essere usato per costruire il sorgente
pacchetto (i possibili formati sono descritti sopra). Non sono consentiti spazi iniziali o finali.

debian/source/include-binaries
Questo file contiene un elenco di file binari (uno per riga) che dovrebbero essere inclusi nel
tarball debian. Gli spazi iniziali e finali vengono eliminati. Righe che iniziano con '#' sono
commenti e vengono saltati. Le righe vuote vengono ignorate.

debian/sorgente/opzioni
Questo file contiene un elenco di opzioni lunghe che dovrebbero essere automaticamente anteposte a
set di opzioni della riga di comando di a dpkg-source --costruire or dpkg-source --formato di stampa chiamata.
Opzioni come --compressione ed --livello di compressione sono adatti per questo file.

Ogni opzione dovrebbe essere messa su una riga separata. Righe vuote e righe che iniziano con '#' sono
ignorato. Il principale '--' dovrebbe essere rimosso e le opzioni brevi non sono consentite. Opzionale
gli spazi sono consentiti intorno al '=' Il simbolo e le virgolette opzionali sono consentiti intorno al valore.
Ecco un esempio di tale file:

# lascia che dpkg-source crei un debian.tar.bz2 con la massima compressione
compressione = "bzip2"
livello di compressione = 9
# usa debian/patches/debian-changes come patch automatica
patch-debian-singola
# ignora le modifiche alla configurazione.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

Nota: formato le opzioni non sono accettate in questo file, dovresti usare debian/sorgente/formato
anziché.

debian/source/opzioni-locali
Esattamente come debian/sorgente/opzioni tranne che il file non è incluso nel generato
pacchetto sorgente. Può essere utile memorizzare una preferenza legata al manutentore o al
Repository VCS in cui viene mantenuto il pacchetto sorgente.

debian/source/local-patch-header ed debian/source/patch-header
Testo in formato libero che viene inserito sopra la patch automatica generata nei formati "2.0" o
“3.0 (piumino)”. intestazione della patch locale non è incluso nel pacchetto sorgente generato mentre
intestazione della patch è.

debian/patch/series
Questo file elenca tutte le patch che devono essere applicate (nell'ordine dato) in cima a
pacchetto sorgente a monte. Gli spazi iniziali e finali vengono eliminati. Righe che iniziano con
'#' sono commenti e vengono ignorati. Le righe vuote vengono ignorate. Le righe rimanenti iniziano con a
nome file patch (relativo a debian/patch/ directory) fino al primo carattere di spazio
o la fine della riga. Opzionale trapunta le opzioni possono seguire fino alla fine della riga o alla prima
'#' preceduto da uno o più spazi (che segna l'inizio di un commento fino alla fine di
linea).

Usa dpkg-source online usando i servizi onworks.net