dpkg-source - Online na nuvem

PROGRAMA:

NOME

dpkg-source - Ferramenta de manipulação de pacote fonte Debian (.dsc)

SINOPSE

fonte dpkg [opção...] comando

DESCRIÇÃO

fonte dpkg compacta e descompacta os arquivos fonte do Debian.

Nenhum desses comandos permite que várias opções sejam combinadas em uma, e eles não
permite que o valor de uma opção seja especificado em um argumento separado.

COMANDOS

-x, --extrair nome do arquivo.dsc[diretório de saída]
Extraia um pacote fonte (--extrair desde dpkg 1.17.14). Um argumento não opcional
deve ser fornecido, o nome do arquivo de controle de fonte Debian (.dsc) Um opcional
o segundo argumento não opcional pode ser fornecido para especificar o diretório para extrair o
pacote de origem para, isso não deve existir. Se nenhum diretório de saída for especificado, o
pacote de origem é extraído em um diretório chamado fonte-versão sob a corrente
diretório de trabalho.

fonte dpkg irá ler os nomes dos outros arquivos que compõem o pacote fonte
do arquivo de controle; eles são considerados no mesmo diretório que o .dsc.

Os arquivos no pacote extraído terão suas permissões e propriedades definidas
para aqueles que seriam esperados se os arquivos e diretórios tivessem simplesmente
foi criado - os diretórios e arquivos executáveis ​​serão 0777 e os arquivos simples serão
ser 0666, ambos modificados pelo umask dos extratores; se o diretório pai for setgid
então os diretórios extraídos também serão, e todos os arquivos e diretórios serão
herdar sua propriedade de grupo.

Se o pacote fonte usa um formato não padrão (atualmente isto significa todos os formatos
exceto “1.0”), seu nome será armazenado em debian / fonte / formato para que o
As seguintes compilações do pacote de origem usam o mesmo formato por padrão.

-b, --construir anuário [parâmetros específicos de formato]
Construir um pacote fonte (--construir desde dpkg 1.17.14). O primeiro argumento não opcional
é tomado como o nome do diretório que contém a árvore de fontes debianizada (ou seja
com um subdiretório debian e talvez mudanças nos arquivos originais). Dependendo
o formato do pacote de origem usado para construir o pacote, parâmetros adicionais podem ser
aceito.

fonte dpkg irá construir o pacote fonte com o primeiro formato encontrado neste
lista ordenada: o formato indicado com o --formato opção de linha de comando, o
formato indicado em debian / fonte / formato, “1.0”. O fallback para “1.0” é
descontinuado e será removido em algum momento no futuro, você deve sempre
documente o formato de fonte desejado em debian / fonte / formato. Veja a seção FONTE
PACKAGE FORMATOS para uma descrição abrangente dos vários formatos de pacote de origem.

--formato de impressão anuário
Imprime o formato de origem que seria usado para construir o pacote de origem se
fonte dpkg --construir anuário foi chamado (nas mesmas condições e com o mesmo
parâmetros; desde dpkg 1.15.5).

--antes de construir anuário
Execute o gancho correspondente do formato do pacote fonte (desde dpkg 1.15.8). Isto
o gancho é chamado antes de qualquer construção do pacote (dpkg-buildpackage chama muito
cedo mesmo antes debian / rules limpar) Este comando é idempotente e pode ser chamado
várias vezes. Nem todos os formatos de origem implementam algo neste gancho, e aqueles
que geralmente preparam a árvore de origem para a construção, por exemplo, garantindo que
os patches do Debian são aplicados.

--após-construção anuário
Execute o gancho correspondente do formato do pacote fonte (desde dpkg 1.15.8). Isto
o gancho é chamado após qualquer compilação do pacote (dpkg-buildpackage chama por último).
Este comando é idempotente e pode ser chamado várias vezes. Nem todos os formatos de origem
implementar algo neste gancho, e aqueles que o fazem geralmente o usam para desfazer o que
--antes de construir foi feito.

--comprometer-se [anuário] ...
Registre as alterações na árvore de origem descompactada em anuário (desde dpkg 1.16.1). Esse
O comando pode ter parâmetros suplementares dependendo do formato da fonte. Ele vai
erro para formatos onde esta operação não significa nada.

-?, --Socorro
Mostra a mensagem de uso e sai.

--versão
Mostre a versão e saia.

OPÇÕES

Generic construir opções
-carquivo de controle
Especifica o arquivo de controle de origem principal do qual ler as informações. O padrão é
debian / control. Se fornecido com o caminho relativo, é interpretado começando em
o diretório de nível superior da árvore de origem.

-larquivo de log de mudanças
Especifica o arquivo changelog do qual ler as informações. O padrão é
debian / changelog. Se fornecido com o caminho relativo, é interpretado começando em
o diretório de nível superior da árvore de origem.

-Fformato changelog
Especifica o formato do changelog. Ver dpkg-parsechangelog(1) para informação
sobre formatos alternativos.

--format =valor
Use o formato fornecido para construir o pacote fonte (desde dpkg 1.14.17). Faz
sobrescrever qualquer formato fornecido em debian / fonte / formato.

-Vnome=valor
Defina uma variável de substituição de saída. Ver deb-substvars(5) para uma discussão sobre
substituição de saída.

-Tarquivo substvars
Leia as variáveis ​​de substituição em arquivo substvars; o padrão é não ler nenhum arquivo.
Esta opção pode ser usada várias vezes para ler variáveis ​​de substituição de vários
arquivos (desde dpkg 1.15.6).

-Dcampo=valor
Substitua ou adicione um campo de arquivo de controle de saída.

-Ucampo
Remova um campo de arquivo de controle de saída.

-Zcompressão, --compressão=compressão
Especifique a compressão a ser usada para tarballs e arquivos diff criados (--compressão
desde dpkg 1.15.5). Observe que esta opção não fará com que os tarballs existentes sejam
recompactado, afeta apenas novos arquivos. Os valores suportados são: gzip, bzip2, lzma
e xz. O padrão é xz para formatos 2.0 e mais recentes, e gzip para o formato 1.0. xz
só é suportado a partir do dpkg 1.15.5.

-znível, - nível de compressão=nível
Nível de compressão a ser usado (- nível de compressão desde dpkg 1.15.5). Como com -Z it
afeta apenas os arquivos recém-criados. Os valores suportados são: 1 para 9, melhor e rápido.
O padrão é 9 para gzip e bzip2, 6 para xz e lzma.

-i[regex], --diff-ignorar[=regex]
Você pode especificar uma expressão regular perl para corresponder aos arquivos dos quais deseja filtrar
a lista de arquivos para o diff (--diff-ignorar desde dpkg 1.15.6). (Esta lista é
gerado por um comando find.) (Se o pacote fonte estiver sendo construído como uma versão 3
pacote de origem usando um VCS, isso pode ser usado para ignorar alterações não confirmadas em
arquivos específicos. Usar -i. * Irá ignorar todos eles.)

A -i opção por si só habilita esta configuração com um regex padrão (preservando qualquer
modificação da regex padrão feita por um uso anterior de --extend-diff-ignorar)
que filtrará os arquivos de controle e diretórios da revisão mais comum
sistemas de controle, backup e arquivos de troca e diretórios de saída de compilação Libtool. Lá
só pode ser um regex ativo, de vários -i opções que apenas a última tomará
efeito.

Isso é muito útil para cortar arquivos estranhos que são incluídos no diff,
por exemplo, se você mantém sua fonte em um sistema de controle de revisão e deseja usar um
checkout para construir um pacote fonte sem incluir os arquivos adicionais e
diretórios que ele geralmente contém (por exemplo, CVS /, .cvsignore, .svn /). O
regex padrão já é muito exaustivo, mas se você precisar substituí-lo, por favor
observe que, por padrão, ele pode corresponder a qualquer parte de um caminho, portanto, se você deseja corresponder ao
início de um nome de arquivo ou apenas nomes de arquivo completos, você precisará fornecer o necessário
âncoras (por exemplo, '(^ | /)', '($ | /)') você mesmo.

--extend-diff-ignorar=regex
A expressão regular perl especificada irá estender o valor padrão usado por
--diff-ignorar e seu valor atual, se definido (desde o dpkg 1.15.6). Ele faz isso por
concatenando “|regex”Ao valor existente. Esta opção é conveniente para usar em
debian / fonte / opções para excluir alguns arquivos gerados automaticamente do patch automático
geração.

-I[padrão de arquivo], --tar-ignorar[=padrão de arquivo]
Se esta opção for especificada, o padrão será passado para alcatrão(1) de --excluir
opção quando é chamado para gerar um arquivo .orig.tar ou .tar (--tar-ignorar desde
dpkg 1.15.6). Por exemplo, -IO CVS fará o tar pular os diretórios CVS quando
gerando um arquivo .tar.gz. A opção pode ser repetida várias vezes para listar
vários padrões para excluir.

-I por si só adiciona padrão --excluir opções que filtrarão os arquivos de controle e
diretórios dos sistemas de controle de revisão mais comuns, arquivos de backup e troca e
Diretórios de saída de compilação do Libtool.

Observação: Embora tenham finalidades semelhantes, -i e -I têm sintaxe muito diferente e
semântica. -i só pode ser especificado uma vez e usa uma expressão regular compatível com perl
que é comparado com o caminho relativo completo de cada arquivo. -I pode especificar múltiplos
vezes e recebe um padrão de nome de arquivo com curingas de shell. O padrão é aplicado ao
caminho relativo completo, mas também para cada parte do caminho individualmente. A semântica exata de
alcatrão --excluir opção é um pouco complicada, veja
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

O regex padrão e os padrões para ambas as opções podem ser vistos na saída do --Socorro
comando.

Generic extrato opções
--sem cópia
Não copie os tarballs originais perto do pacote fonte extraído (uma vez que o dpkg


- não verificar
Não verifique as assinaturas e somas de verificação antes de desempacotar (desde o dpkg 1.14.17).

--require-assinatura válida
Recuse-se a descompactar o pacote fonte se ele não contiver uma assinatura OpenPGP que
pode ser verificado (desde o dpkg 1.15.0) tanto com o usuário trustkeys.gpg chaveiro,
um dos chaveiros específicos do fornecedor ou um dos chaveiros oficiais do Debian
(/usr/share/keyrings/debian-keyring.gpg e
/usr/share/keyrings/debian-maintainers.gpg).

--ignore-versão-ruim
Transforma a verificação da versão incorreta do pacote em um aviso não fatal (uma vez que o dpkg
1.17.7). Esta opção só deve ser necessária ao extrair fonte antiga
pacotes com versões quebradas, apenas para compatibilidade com versões anteriores.

FONTE PACKAGE FORMATOS

Se você não sabe qual formato de fonte usar, você provavelmente deve escolher “3.0 (quilt)”
ou “3.0 (nativo)”. Veja https://wiki.debian.org/Projects/DebSrc3.0 para informações sobre o
implantação desses formatos dentro do Debian.

Formato: 1.0
Um pacote de origem neste formato consiste em um .orig.tar.gz associado a um .diff.gz
ou um único .tar.gz (nesse caso, diz-se que o pacote é nativo).

Extraindo

Extrair um pacote nativo é uma extração simples do tarball único no destino
diretório. Extrair um pacote não nativo é feito primeiro descompactando o .orig.tar.gz e
em seguida, aplicar o patch contido no .diff.gz Arquivo. O carimbo de data / hora de todos os arquivos corrigidos
é redefinido para o tempo de extração do pacote de origem (isto evita distorções do carimbo de data / hora à frente
problemas quando os arquivos gerados automaticamente são corrigidos). O diff pode criar novos arquivos (o
todo o diretório debian é criado dessa forma), mas não pode remover arquivos (arquivos vazios serão
sobrou).

Prédio

Construir um pacote nativo é apenas criar um único tarball com o diretório de origem.
Construir um pacote não nativo envolve extrair o tarball original em um pacote separado
Diretório “.orig” e regenerando o .diff.gz comparando o pacote fonte anuário
com o diretório .orig.

Construa opções (com --Construir):

Se um segundo argumento não opcional for fornecido, ele deve ser o nome da fonte original
diretório ou tarfile ou a string vazia se o pacote for específico do Debian e assim
não tem diffs de Debianização. Se nenhum segundo argumento for fornecido, então fonte dpkg olharão
para o tarfile fonte original pacote_versão-upstream.orig.tar.gz ou o original
diretório fonte anuário.orig dependendo do -sX argumentos.

-sa, -sp, -sk, -seu e -sr não sobrescreverá tarfiles ou diretórios existentes. Se isso é
desejado então -sA, -sP, -sK, -dele e -Senhor deve ser usado em seu lugar.

-sk Especifica esperar a fonte original como um arquivo tar, por padrão pacote_upstream-
versão.orig.tar.extensão. Isso deixará esta fonte original no lugar como um
tarfile ou copie-o para o diretório atual se ainda não estiver lá. O tarball
será descompactado em anuário.orig para a geração do diff.

-sp Como -sk mas irá remover o diretório novamente depois.

-seu Especifica que a fonte original é esperada como um diretório, por padrão pacote-
versão upstream.orig e fonte dpkg irá criar um novo arquivo fonte original
a partir dele.

-sr Como -seu mas irá remover esse diretório após ele ter sido usado.

-ss Especifica que a fonte original está disponível como um diretório e como um
arquivo tar. fonte dpkg irá usar o diretório para criar o diff, mas o tarfile para
crie o .dsc. Esta opção deve ser usada com cuidado - se o diretório e o tarfile
não corresponder, um arquivo de origem incorreto será gerado.

-sn Especifica para não procurar por nenhuma fonte original e para não gerar um diff. O
o segundo argumento, se fornecido, deve ser a string vazia. Isso é usado para Debian-
pacotes específicos que não têm uma fonte upstream separada e, portanto, têm
sem diferenças de debianização.

-sa or -sA
Especifica para procurar o arquivo fonte original como um tarfile ou como um diretório -
o segundo argumento, se houver, pode ser qualquer um, ou a string vazia (istoéequivalente
para usando -sn) Se um arquivo tar for encontrado, ele irá descompactá-lo para criar o diff e
remova-o depois (isto é equivalente a -sp); se um diretório for encontrado, ele irá
empacote-o para criar a fonte original e remova-o depois (isto é equivalente
para -sr); se nenhum for encontrado irá assumir que o pacote não tem debianização
diffs, apenas um arquivo fonte simples (isto é equivalente a -sn) Se ambos
são encontrados então fonte dpkg irá ignorar o diretório, sobrescrevendo-o, se -sA foi
especificado (isto é equivalente a -sP) ou gerar um erro se -sa foi especificado. -sA
é o padrão.

--abort-on-upstream-changes
O processo falha se o diff gerado contém alterações em arquivos fora do
subdiretório debian (desde dpkg 1.15.8). Esta opção não é permitida em
debian / fonte / opções mas pode ser usado em debian / source / local-options.

Extrair opções (com --extrair):

Em todos os casos, qualquer árvore de origem original existente será removida.

-sp Usado na extração, a fonte original (se houver) será deixada como um arquivo tar.
Se ainda não estiver localizado no diretório atual ou se houver um
arquivo diferente está lá, ele será copiado para lá. (Esta is que o omissão).

-seu Descompacta a árvore de origem original.

-sn Garante que a fonte original não seja copiada para o diretório atual nem
descompactado. Qualquer árvore de fonte original que estava no diretório atual ainda está
removido.

Todos os -sX as opções são mutuamente exclusivas. Se você especificar mais de um, apenas o último
será usada.

--skip-debianização
Pula a aplicação do debian diff no topo dos fontes originais (desde o dpkg


Formato: 2.0
Extração suportada desde dpkg 1.13.9, construção suportada desde dpkg 1.14.8. Também conhecido
como peruca e caneta. Este formato não é recomendado para uso generalizado, o formato “3.0 (quilt)”
o substitui. Wig & pen foi a primeira especificação de um pacote fonte de nova geração
formato.

O comportamento deste formato é o mesmo do formato “3.0 (quilt)”, exceto que
não usa uma lista explícita de patches. Todos os arquivos em debian / patches / combinando com o perl
expressão regular [\ w -] + devem ser patches válidos: eles são aplicados no momento da extração.

Ao construir um novo pacote fonte, qualquer mudança na fonte upstream é armazenada em um patch
nomeado zz_debian-diff-auto.

Formato: 3.0 (nativo)
Suportado desde dpkg 1.14.17. Este formato é uma extensão do formato de pacote nativo como
definido no formato 1.0. Ele suporta todos os métodos de compressão e irá ignorar por padrão
quaisquer arquivos e diretórios específicos do VCS, bem como muitos arquivos temporários (veja o valor padrão
Associado a -I opção no --Socorro resultado).

Formato: 3.0 (colcha)
Suportado desde dpkg 1.14.17. Um pacote de origem neste formato contém pelo menos um
tarball original (.orig.tar.ext onde ext pode ser gz, bz2, lzma e xz) e um debian
tarball (.debian.tar.ext) Também pode conter tarballs originais adicionais
(.ori-componente.alcatrão.ext). componente só pode conter caracteres alfanuméricos e hifens
('-').

Extraindo

O tarball original principal é extraído primeiro e, em seguida, todos os tarballs originais adicionais são
extraído em subdiretórios nomeados após o componente parte de seu nome de arquivo (qualquer pré-
diretório existente é substituído). O debian tarball é extraído no topo do código-fonte
diretório após a remoção prévia de qualquer debian diretório. Observe que o debian
tarball deve conter um debian subdiretório, mas também pode conter arquivos binários fora
desse diretório (ver --include-binários opção).

Todos os patches listados em debian / patches / debian.series or debian / patches / series São então
aplicado. Se o arquivo anterior for usado e o último não existir (ou for um link simbólico),
então, o último é substituído por um link simbólico para o primeiro. Isso visa simplificar o uso
of colcha para gerenciar o conjunto de patches. Observe, entretanto, que enquanto fonte dpkg analisa
arquivos corretamente em série com opções explícitas usadas para aplicação de patch (armazenados em cada
linha após o nome do arquivo patch e um ou mais espaços), ele ignora essas opções e
sempre espere patches que podem ser aplicados com o -p1 opção de remendo. Assim, emitirá
um aviso quando encontrar tais opções, e a compilação provavelmente falhará.

O carimbo de data / hora de todos os arquivos corrigidos é redefinido para o tempo de extração do pacote de origem
(isso evita distorções de carimbo de data / hora, levando a problemas quando os arquivos gerados automaticamente são corrigidos).

Contrário a colchacomportamento padrão do, espera-se que os patches sejam aplicados sem qualquer distorção.
Quando esse não for o caso, você deve atualizar esses patches com colchaou fonte dpkg precisarão
erro ao tentar aplicá-los.

similarmente a colchacomportamento padrão do, os patches também podem remover arquivos.

O arquivo .pc / patches aplicados é criado se alguns patches foram aplicados durante o
Extração.

Prédio

Todos os tarballs originais encontrados no diretório atual são extraídos temporariamente
diretório seguindo a mesma lógica para descompactar, o diretório debian é copiado
no diretório temporário, e todos os patches, exceto o patch automático
(mudanças debian-versão or mudanças debian, dependendo --single-debian-patch) estamos
aplicado. O diretório temporário é comparado ao diretório do pacote de origem. Quando o
diff não está vazio, a compilação falha a menos que --single-debian-patch or --auto-commit foi
usado, caso em que o diff é armazenado no patch automático. Se o patch automático é
criado / excluído, é adicionado / removido do arquivo de série e do colcha metadados.

Qualquer mudança em um arquivo binário não é representável em uma comparação e, portanto, levará a uma falha
a menos que o mantenedor deliberadamente decidiu incluir esse arquivo binário modificado no
debian tarball (listando-o em debian / source / include-binaries) A compilação também falhará
se encontrar arquivos binários no subdiretório debian a menos que eles tenham sido incluídos na lista de permissões
NFT`s debian / source / include-binaries.

O diretório debian atualizado e a lista de binários modificados são então usados ​​para gerar
o debian tarball.

O diff gerado automaticamente não inclui mudanças em arquivos VCS específicos, bem como
muitos arquivos temporários (veja o valor padrão associado a -i opção no --Socorro saída). Dentro
particular, o .pc diretório usado por colcha é ignorado durante a geração do automático
patch.

Observação: fonte dpkg --antes de construir (E --construir) irá garantir que todos os patches listados no
Os arquivos de série são aplicados de forma que uma compilação de pacote sempre tenha todos os patches aplicados. Faz
isso encontrando patches não aplicados (eles estão listados no série arquivo, mas não em
.pc / patches aplicados), e se o primeiro patch desse conjunto puder ser aplicado sem erros, ele
irá aplicá-los todos. A opção - sem preparação pode ser usado para desativar esse comportamento.

Gravação alterar

--comprometer-se [anuário] [nome do patch] [arquivo de patch]
Gera um patch correspondente às mudanças locais que não são gerenciadas pelo
colcha sistema de patch e o integra ao sistema de patch sob o nome nome do patch.
Se o nome estiver faltando, ele será solicitado de forma interativa. Se arquivo de patch é dado, isso
é usado como o patch correspondente às mudanças locais a serem integradas. Uma vez
integrado, um editor é lançado para que você possa editar as meta-informações no
cabeçalho do patch.

Passagem arquivo de patch é útil principalmente após uma falha de compilação que pré-gerou este
arquivo e, com base nisso, o arquivo fornecido é removido após a integração. Observe também
que as mudanças contidas no arquivo de patch já devem ser aplicadas na árvore
e que os arquivos modificados pelo patch não devem ter dados suplementares não registrados
alterações.

Se a geração do patch detectar arquivos binários modificados, eles serão automaticamente
Adicionado a debian / source / include-binaries para que eles acabem no debian tarball
(exatamente como fonte dpkg --include-binários --construir faria).

Construa opções

--allow-version-of-quilt-db =versão
Permitir fonte dpkg para construir o pacote de origem se a versão do colcha metadados
é aquele especificado, mesmo se fonte dpkg não sabe sobre isso (desde o dpkg
1.15.5.4). Efetivamente, isso diz que a versão dada do colcha metadados são
compatível com a versão 2 que fonte dpkg atualmente suporta. A versão de
que o colcha metadados são armazenados em .pc / .version.

--include-remoção
Não ignore os arquivos removidos e inclua-os no patch gerado automaticamente.

--include-timestamp
Inclui carimbo de data / hora no patch gerado automaticamente.

--include-binários
Adicione todos os binários modificados no tarball do debian. Adicione-os também a
debian / source / include-binaries: eles serão adicionados por padrão nas compilações subsequentes
e esta opção não é mais necessária.

- sem preparação
Não tente preparar a árvore de construção aplicando patches que são aparentemente
não aplicado (desde dpkg 1.14.18).

--single-debian-patch
Use debian / patches / debian-changes em vez de debian / patches / debian-changes-versão
para o nome do patch automático gerado durante a compilação (desde o dpkg 1.15.5.4).
Esta opção é particularmente útil quando o pacote é mantido em um VCS e um
conjunto de patches não pode ser gerado de forma confiável. Em vez disso, o diff atual com o upstream
deve ser armazenado em um único patch. A opção seria colocada em
debian / source / local-options e seria acompanhado por um
debian / source / local-patch-header arquivo explicando como as mudanças do Debian podem ser melhores
revisado, por exemplo, no VCS que é usado.

--create-vazio-origem
Crie automaticamente o tarball original principal como vazio se estiver faltando e se
existem tarballs originais suplementares (desde dpkg 1.15.6). Esta opção é
deve ser usado quando o pacote fonte é apenas um pacote de múltiplos upstream
software e onde não há software “principal”.

--no-unapply-patches, --unapply-patches
Por padrão, o fonte dpkg irá automaticamente desaplicar os patches no --após-construção
gancho se os aplicou durante --antes de construir (--unapply-patches desde dpkg
1.15.8, --no-unapply-patches desde dpkg 1.16.5). Essas opções permitem que você
desabilite ou habilite forçosamente o processo de desaplicação do patch. Essas opções são
permitido apenas em debian / source / local-options para que todos os pacotes fonte gerados
têm o mesmo comportamento por padrão.

--abort-on-upstream-changes
O processo falha se um patch automático for gerado (desde dpkg 1.15.8).
Esta opção pode ser usada para garantir que todas as alterações foram devidamente registradas em
separado colcha patches antes da construção do pacote fonte. Esta opção não é
permitido em debian / fonte / opções mas pode ser usado em debian / source / local-options.

--auto-commit
O processo não falha se um patch automático foi gerado, em vez disso, é
imediatamente gravado no colcha série.

Extrair opções

--skip-debianização
Pula a extração do tarball debian no topo dos fontes originais (desde o dpkg


--skip-patches
Não aplique patches no final da extração (desde dpkg 1.14.18).

Formato: 3.0 (personalizadas)
Suportado desde dpkg 1.14.17. Este formato é especial. Não representa uma fonte real
formato de pacote, mas pode ser usado para criar pacotes de origem com arquivos arbitrários.

Construa opções

Todos os argumentos não opcionais são considerados arquivos para integração no pacote de origem gerado.
Eles devem existir e estão preferencialmente no diretório atual. Pelo menos um arquivo deve ser
dado.

--target-format =valor
Exigido. Define o formato real do pacote fonte gerado. O gerado
O arquivo .dsc conterá este valor em seu Formato campo e não “3.0 (personalizado)”.

Formato: 3.0 (git)
Suportado desde dpkg 1.14.17. Este formato é experimental.

Um pacote de origem neste formato consiste em um único pacote de um repositório git .ir para
segure a fonte de um pacote. Também pode haver um .gitshallow revisões de lista de arquivos para
um clone git raso.

Extraindo

O pacote é clonado como um repositório git para o diretório de destino. Se houver um
arquivo gitshallow, ele é instalado como .git / raso dentro do repositório git clonado.

Observe que, por padrão, o novo repositório terá o mesmo branch verificado que foi
verificado na fonte original. (Normalmente "master", mas pode ser qualquer coisa.) Qualquer
outras filiais estarão disponíveis em controles remotos / origem /.

Prédio

Antes de prosseguir, algumas verificações são feitas para garantir que não tenhamos
ignorou mudanças não confirmadas.

pacote git(1) é usado para gerar um pacote do repositório git. Por padrão, todos
ramos e tags no repositório são incluídos no pacote.

Construa opções

--git-ref =ref
Permite especificar um git ref para incluir no pacote git. Use desativa o padrão
comportamento de incluir todos os ramos e tags. Pode ser especificado várias vezes. O
ref pode ser o nome de um branch ou tag a ser incluído. Também pode ser qualquer parâmetro
que pode ser passado para lista de rev-git(1). Por exemplo, para incluir apenas o mestre
ramo, use --git-ref =mestre. Para incluir todas as tags e ramos, exceto para o
filial privada, use --git-ref =--tudo --git-ref =^ privado

--git-depth =número
Cria um clone superficial com um histórico truncado para o número especificado de
revisões.

Formato: 3.0 (bzr)
Suportado desde dpkg 1.14.17. Este formato é experimental. Ele gera um único tarball
contendo o repositório bzr.

Extraindo

O tarball é descompactado e então bzr é usado para verificar o branch atual.

Prédio

Antes de prosseguir, algumas verificações são feitas para garantir que não tenhamos
ignorou mudanças não confirmadas.

Em seguida, a parte específica do VCS do diretório de origem é copiada para um temporário
diretório. Antes que este diretório temporário seja compactado em um tarball, várias limpezas são
feito para economizar espaço.

DIAGNÓSTICO

não fonte formato especificada in debian / fonte / formato
O arquivo debian / fonte / formato deve sempre existir e indicar o formato de origem desejado.
Para compatibilidade com versões anteriores, o formato "1.0" é assumido quando o arquivo não existe, mas você
não deve confiar nisso: em algum momento no futuro fonte dpkg será modificado para falhar
quando esse arquivo não existe.

A justificativa é que o formato "1.0" não é mais o formato recomendado, você geralmente deve
escolha um dos formatos mais novos (“3.0 (quilt)”, “3.0 (nativo)”), mas fonte dpkg não vai fazer
isso automaticamente para você. Se você quiser continuar usando o formato antigo, você deve
explícito sobre isso e coloque "1.0" em debian / fonte / formato.

que o diff modifica que o seguinte rio acima arquivos
Ao usar o formato de origem "1.0", geralmente é uma má ideia modificar os arquivos upstream diretamente
como as alterações acabam escondidas e principalmente não documentadas no arquivo .diff.gz. Em vez de você
deve armazenar suas mudanças como patches no diretório debian e aplicá-las em tempo de construção.
Para evitar essa complexidade, você também pode usar o formato “3.0 (quilt)” que oferece este
nativamente.

não podes representar alterar para lima
Mudanças nas fontes upstream são geralmente armazenadas com arquivos de patch, mas nem todas as mudanças podem
ser representados com patches: eles só podem alterar o conteúdo de arquivos de texto simples. Se vocês
tente substituir um arquivo por algo de tipo diferente (por exemplo, substituir um arquivo simples
arquivo com um link simbólico ou um diretório), você receberá esta mensagem de erro.

recentemente criado vazio lima lima precisarão não be representado in diff
Arquivos vazios não podem ser criados com arquivos de patch. Portanto, essa alteração não é registrada no
pacote fonte e você é avisado sobre isso.

executável modo permanentes of lima precisarão não be representado in diff
Arquivos de patch não registram permissões de arquivos e, portanto, as permissões executáveis ​​não são
armazenado no pacote de origem. Este aviso lembra você desse fato.

especial modo permanentes of lima precisarão não be representado in diff
Arquivos de patch não registram permissões de arquivos e, portanto, as permissões modificadas não são
armazenado no pacote de origem. Este aviso lembra você desse fato.

ARQUIVO FORMATOS

debian / fonte / formato
Este arquivo contém em uma única linha o formato que deve ser usado para construir o código-fonte
pacote (os formatos possíveis são descritos acima). Não são permitidos espaços à esquerda ou à direita.

debian / source / include-binaries
Este arquivo contém uma lista de arquivos binários (um por linha) que devem ser incluídos no
debian tarball. Espaços à esquerda e à direita são eliminados. Linhas começando com '#' são
comentários e são ignorados. Linhas vazias são ignoradas.

debian / fonte / opções
Este arquivo contém uma lista de opções longas que devem ser anexadas automaticamente ao
conjunto de opções de linha de comando de um fonte dpkg --construir or fonte dpkg --formato de impressão ligar.
Opções como --compressão e - nível de compressão são adequados para este arquivo.

Cada opção deve ser colocada em uma linha separada. Linhas vazias e linhas começando com '#' são
ignorado. A liderança '--'deve ser eliminado e opções curtas não são permitidas. Opcional
espaços são permitidos em torno do '='símbolo e aspas opcionais são permitidos em torno do valor.
Aqui está um exemplo de tal arquivo:

# deixe dpkg-source criar um debian.tar.bz2 com compressão máxima
compressão = "bzip2"
nível de compressão = 9
# use debian / patches / debian-changes como patch automático
patch debian único
# ignorar as alterações na configuração. {sub, suponho}
extend-diff-ignore = "(^ | /) (config.sub | config.guess) $"

Observação: formato opções não são aceitas neste arquivo, você deve usar debian / fonte / formato
ao invés.

debian / source / local-options
Exatamente como debian / fonte / opções exceto que o arquivo não está incluído no
pacote fonte. Pode ser útil armazenar uma preferência ligada ao mantenedor ou ao
Repositório VCS onde o pacote fonte é mantido.

debian / source / local-patch-header e debian / source / patch-header
Texto de forma livre que é colocado em cima do patch automático gerado nos formatos “2.0” ou
“3.0 (colcha)”. cabeçalho de patch local não está incluído no pacote de origem gerado enquanto
cabeçalho de remendo é.

debian / patches / series
Este arquivo lista todos os patches que devem ser aplicados (na ordem dada) no topo do
pacote fonte upstream. Espaços à esquerda e à direita são eliminados. Linhas começando com
'#'são comentários e são ignorados. Linhas vazias são ignoradas. As linhas restantes começam com um
nome do arquivo do patch (relativo ao debian / patches / diretório) até o primeiro caractere de espaço
ou o fim da linha. Opcional colcha as opções podem seguir até o fim da linha ou o primeiro
'#'precedido por um ou mais espaços (que marca o início de um comentário até o final de
linha).

Use dpkg-source online usando serviços onworks.net