Provided by: dpkg-dev_1.22.18ubuntu3_all 
NOME
deb-changes - Formato Debian de ficheiro de controle de envio de alterações
RESUMO
filename.changes
DESCRIÇÃO
Cada envio Debian é composto de um ficheiro de controle .changes, o qual contém um número de campos em
formato deb822(5).
Cada campo começa com uma etiqueta, tal como Source ou Binary (insensível a maiúsculas/minúsculas),
seguida do símbolo dois pontos, e o corpo do campo (sensível a maiúsculas/minúsculas a menos que
declarado o contrário). Os campos são delimitados apenas por etiquetas de campos. Por outras palavras, o
texto do campo pode ter várias linhas de comprimento, mas as ferramentas de instalação irão geralmente
juntar as linhas quando processam o corpo do campo (excepto no caso de Description, Changes, Files,
Checksums-Sha1 e Checksums-Sha256 de múltiplos campos, ver abaixo).
Os dados de controle podem estar inclusos numa assinatura OpenPGP ASCII Armored, como especificado em
RFC9580.
CAMPOS
Format: format-version (necessário)
O valor deste campo declara a versão de formato do ficheiro. A sintaxe do valor do campo é um número
de versão com um componente maior ou menor. Alterações incompatíveis com versões anteriores ao
formato irão colidir com a versão maior, e alterações compatíveis com versões anteriores (tais como
adições de campos) irão colidir com a versão menor. A versão de formato actual é 1.8.
Date: release-date (necessário)
A data em que o pacote foi compilado ou editado pela última vez. Tem de estar no mesmo formato que a
data duma entrada em deb-changelog(5).
O valor deste campo é geralmente extraído do ficheiro debian/changelog.
Source: source-name [(source-version)] (necessário)
O nome do pacote fonte. Se a versão de fonte diferir da versão binária, então o source-name será
seguido por um source-version em parêntesis. Isto pode acontecer quando o envio ao arquivo é um envio
de não-maintainer apenas-binário.
Binary: binary-package-list (necessário em contexto)
Este campo dobrado é uma lista de pacotes binários separados por espaços para enviar. Se o envio for
de "apenas-fonte", então o campo é omitido (desde dpkg 1.19.3).
Architecture: arch-list
Lista as arquitecturas dos ficheiros actualmente a serem enviados ao arquivo. Arquitecturas comuns
são amd64, armel, i386, etc. Note que o valor all destina-se a pacotes que são independentes da
arquitectura. Se a fonte do pacote estiver também a ser enviada, a entrada especial source está
também presente. Wildcards de arquitectura nunca devem estar presentes na lista.
Version: string-de-versão (obrigatório)
Tipicamente, isto é o número de versão do pacote original seja em que formato o autor do programa
usa. Pode também incluir um número de revisão Debian (para pacotes não-nativos). O formato exacto e
algoritmo de ordenação estão descritos em deb-version(7).
Distribution: distributions (necessário)
Lista uma ou mais distribuições separadas por espaços onde esta versão deve ser instalada quando é
enviada para o arquivo.
Urgency: urgency (recomendado)
A urgência do envio. Os valores presentemente conhecidos, em ordem ascendente de prioridade, são:
low, medium, high, critical e emergency.
Maintainer: fullname-email (necessário)
Deverá estar no formato “Joe Bloggs <jbloggs@example.org>”, e é tipicamente a pessoa que criou o
pacote, e não o autor do software que foi empacotado.
Changed-By: fullname-email
Deverá estar no formato “Joe Bloggs <jbloggs@example.org>”, e é tipicamente a pessoa que preparou as
alterações no pacote para este lançamento.
Description: (recomendado)
binary-package-name - binary-package-summary
Este campo multi-linha contem uma lista de nomes de pacotes binários seguida por um espaço, um traço
(‘-’) a as suas descrições curtas possivelmente truncadas. Se o envio for apenas-fonte, então o campo
é omitido (desde dpkg 1.19.3).
Closes: bug-number-list
Uma lista separada por espaços de números de relatórios de bugs para relatórios de bugs que foram
resolvidos com este envio. Os software do arquivo da distribuição pode usar este campo para fechar
automaticamente os bugs com os números referenciados no sistema de acompanhamento de bugs da
distribuição.
Binary-Only: yes
Este campo indica que o envio é uma compilação de não-maintainer apenas-binário. É originado a partir
da chave/valor binary-only=yes da entrada de meta-dados do changelog.
Built-For-Profiles: profile-list
Este campo especifica uma lista de perfis de compilação separados por espaços em branco, do que com
que este envio foi compilado.
Changes: (necessário)
changelog-entries
Este campo multi-linha contem o texto concatenado de todas as entradas changelog que fazem parte do
envio. Para tornar isto numa entrada multi-linha válida as linhas vazias são substituídas com um
único ponto final (‘.’) e todas as linhas são indentadas por um caractere de espaço. O conteúdo
exacto depende do formato do changelog.
Files: (necessário)
md5sum size section priority filename
Este campo multi-linha contem uma lista de ficheiros com um md5sum, tamanho, secção e prioridade para
cada um.
A primeira linha do campo valor (a parte na mesma linha que tem o campo nome seguido de dois pontos)
é sempre vazia. O conteúdo do campo é expressado como linhas de continuação, uma linha por ficheiro.
Cada linha consiste de entradas separadas por espaços que descrevem o ficheiro: o md5sum, o tamanho
do ficheiro, a secção do ficheiro, a prioridade do ficheiro, e o nome do ficheiro.
If the section or priority are omitted from the package, these default to unknown and optional
respectively (since dpkg 1.22.13).
Este campo lista todos os ficheiros que fizeram o envio. A lista de ficheiros neste campo tem de
corresponder à lista de ficheiros nos outros campos Checksums relacionados.
Nota: O sumário de verificação MD5 é considerado fraco, e nunca deve ser assumido como suficiente
para verificação de segurança, mas este campo não pode ser omitido pois fornece metadados não
disponíveis em mais nenhum lado.
Checksums-Sha1: (necessário, fraco)
Checksums-Sha256: (necessário, forte)
checksum size filename
Estes campos multi-linha contêm uma lista de ficheiros com um sumário de verificação e tamanho para
cada um deles. Estes campos têm a mesma sintaxe e diferem apenas no algoritmo de checksum usado:
SHA-1 para Checksums-Sha1 e SHA-256 parar Checksums-Sha256.
A primeira linha do campo valor (a parte na mesma linha que tem o campo nome seguido de dois pontos)
é sempre vazia. O conteúdo do campo é expressado como linhas de continuação, uma linha por ficheiro.
Cada linha consiste de entradas separadas por espaços que descrevem o ficheiro: o sumário de
verificação (checksum), o tamanho do ficheiro, e o nome do ficheiro.
Estes campos listam todos os ficheiros que fizeram o envio. A lista de ficheiros nestes campos tem de
corresponder à lista de ficheiros no campo Files e aos outros campos Checksums relacionados.
Nota: O sumário de verificação SHA-1 é considerado fraco, e nunca deve ser assumido com suficiente
para verificação de segurança.
BUGS
O campo Files é inconsistente com os outros campos Checksums. Os campos Changed-By e Maintainer têm nomes
confusos. O campo Distribution contem informação acerca do que é comum referir-se como uma suite.
VEJA TAMBÉM
deb822(5), deb-src-control(5), deb-version(7).
TRADUÇÃO
Américo Monteiro
Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro
<a_monteiro@gmx.com>.
1.22.18 2025-04-28 deb-changes(5)