Capítulo 5. Empacotamento simples

Aqui está um exemplo de criar um pacote Debian simples a partir duma fonte C simples usando o Makefile como seu sistema de compilação.

Let’s assume this upstream tarball to be debhello-0.0.tar.xz.

Este tipo de fonte destina-se a ser instalado como ficheiro não-sistema como:

Bases para a instalação a partir do tarball do autor. 

[base_dir] $ tar --xz -xmf debhello-0.0.tar.xz
[base_dir] $ cd debhello-0.0
[debhello-0.0] $ make
[debhello-0.0] $ make install

O empacotamento Debian requer alterar este processo “make install” para instalar ficheiros na localização imagem do sistema alvo em vez de na localização normal sob /usr/local.

	Nota
	Exemplos de criar um pacote Debian a partir de outros sistemas de compilação complicados estão descritos em “Capítulo 14, Mais Exemplos”.

The big picture for building a single non-native Debian package from the upstream tarball debhello-0.0.tar.xz can be summarized as:

O grande panorama de compilação de pacote. 

[base_dir] $ tar --xz -xmf debhello-0.0.tar.xz
[base_dir] $ cd debhello-0.0
[debhello-0.0] $ debmake
I: debmake (version: 5.1.4)
I: Copyright © 2014-2026 Osamu Aoki <osamu@debian.org>
   ...
[debhello-0.0] $ ... manual customization of debian/* files
[debhello-0.0] $ debuild
   ...

	Dica
	O comando debuild neste e nos exemplos seguintes pode ser substituído por comandos equivalentes tais como o comando sbuild.

	Dica
	If the upstream tarball in the .tar.xz format is available, use it instead of the one in the .tar.xz and .tar.bz2 formats. The xz compression format offers the better compression than the gzip and bzip2 compressions.

Aqui está um sumário de comandos semelhantes ao comando debuild.

Vamos obter a fonte do autor.

Download debhello-0.0.tar.xz. 

[base_dir] $ wget http://www.example.org/download/debhello-0.0.tar.xz
 ...
[base_dir] $ tar --xz -xmf debhello-0.0.tar.xz
[base_dir] $ tree
.
├── debhello-0.0
│   ├── Makefile
│   ├── README.md
│   └── src
│       └── hello.c
└── debhello-0.0.tar.xz

3 directories, 4 files

Aqui, a fonte C hello.c é uma muito simples.

hello.c. 

[base_dir] $ cat debhello-0.0/src/hello.c
#include <stdio.h>
int
main()
{
        printf("Hello, world!\n");
        return 0;
}

Os resultados do comando debmake é muito detalhado e explica o que faz como se segue.

The output from the debmake command with -x1 option. 

[base_dir] $ cd debhello-0.0
[debhello-0.0] $ debmake -x1
I: debmake (version: 5.1.4)
I: Copyright © 2014-2026 Osamu Aoki <osamu@debian.org>
I: [debhello-0.0] $ cd ..
I: Non-native Debian package pkg="debhello", ver="0.0", rev="1" method="dir_d...
I: already in the package-version form: "debhello-0.0"
I: [base_dir] $ ln -sf debhello-0.0.tar.xz debhello_0.0.orig.tar.xz
I: [base_dir] $ cd debhello-0.0
I: parsing option -b ""
I: binary package=debhello Type=bin / Arch=any M-A=foreign
I: build_type = make
I: ext_type = c                       1 files
I: ext_type = md                      1 files
I: creating debian/* files with "-x 1" option
I: [debhello-0.0] $ licensecheck --recursive --copyright --deb-machine  . > d...
I: creating debian/copyright by licensecheck.
I: creating debian/control from control.py
I: creating debian/control by control.py
I: creating debian/changelog from extra0_changelog
I: creating debian/rules from extra0_rules
I: creating debian/source/format from extra0source_format
I: creating debian/README.Debian from extra1_README.Debian
I: creating debian/README.source from extra1_README.source
I: creating debian/clean from extra1_clean
I: creating debian/dirs from extra1_dirs
I: creating debian/docs from extra1_docs
I: creating debian/examples from extra1_examples
I: creating debian/gbp.conf from extra1_gbp.conf
I: creating debian/links from extra1_links
I: creating debian/manpages from extra1_manpages
I: creating debian/salsa-ci.yml from extra1_salsa-ci.yml
I: creating debian/watch from extra1nn_watch
I: creating debian/tests/control from extra1tests_control
I: creating debian/upstream/metadata from extra1upstream_metadata
I: creating debian/patches/series from extra1patches_series
I: creating debian/install from extra1bin_install
I: [debhello-0.0] $ wrap-and-sort -ast
I: debian/* may have a blank line at the top.

O comando debmake gera todos estes ficheiros modelo baseado nas opções da linha de comandos. Como nenhuma opção é especificada, o comando debmake escolhe valores predefinidos razoáveis por si:

	Nota
	Here, the debmake command is invoked with the -x1 option to keep this tutorial simple. Use of default -x2 or more extensive -x3 option is highly recommended.

Vamos inspecionar os ficheiros modelo gerados.

A árvore fonte após a execução básica do debmake. 

[debhello-0.0] $ cd ..
[base_dir] $ tree
.
├── debhello-0.0
│   ├── Makefile
│   ├── README.md
│   ├── debian
│   │   ├── README.Debian
│   │   ├── README.source
│   │   ├── changelog
│   │   ├── clean
│   │   ├── control
│   │   ├── copyright
│   │   ├── dirs
│   │   ├── docs
│   │   ├── examples
│   │   ├── gbp.conf
│   │   ├── install
│   │   ├── links
│   │   ├── manpages
│   │   ├── patches
│   │   │   └── series
│   │   ├── rules
│   │   ├── salsa-ci.yml
│   │   ├── source
│   │   │   └── format
│   │   ├── tests
│   │   │   └── control
│   │   ├── upstream
│   │   │   └── metadata
│   │   └── watch
│   └── src
│       └── hello.c
├── debhello-0.0.tar.xz
└── debhello_0.0.orig.tar.xz -> debhello-0.0.tar.xz

8 directories, 25 files

O ficheiro debian/rules é o script de compilação fornecido pelo maintainer do pacote. Aqui está o seu ficheiro modelo gerado pelo comando debmake.

debian/rules (ficheiro modelo): 

[base_dir] $ cd debhello-0.0
[debhello-0.0] $ cat debian/rules
#!/usr/bin/make -f
# You must remove unused comment lines for the released package.
# See debhelper(7) (un-comment to enable)
# This is an autogenerated template for debian/rules.
#
# Output every command that modifies files on the build system.
#export DH_VERBOSE = 1
#
# Copy some variable definitions from pkg-info.mk and vendor.mk
# under /usr/share/dpkg/ to here if they are useful.
#
# See FEATURE AREAS/ENVIRONMENT in dpkg-buildflags(1)
# Apply all hardening options
#export DEB_BUILD_MAINT_OPTIONS = hardening=+all
# Package maintainers to append CFLAGS
#export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
# Package maintainers to append LDFLAGS
#export DEB_LDFLAGS_MAINT_APPEND = -Wl,-O1
#
# With debhelper version 9 or newer, the dh command exports
# all buildflags.  So there is no need to include the
# /usr/share/dpkg/buildflags.mk file here if compat is 9 or newer.
#
# These are rarely used code. (START)
#
# The following include for *.mk magically sets miscellaneous
# variables while honoring existing values of pertinent
# environment variables:
#
# Architecture-related variables such as DEB_TARGET_MULTIARCH:
#include /usr/share/dpkg/architecture.mk
# Vendor-related variables such as DEB_VENDOR:
#include /usr/share/dpkg/vendor.mk
# Package-related variables such as DEB_DISTRIBUTION
#include /usr/share/dpkg/pkg-info.mk
#
# You may alternatively set them susing a simple script such as:
# DEB_VENDOR ?= $(shell dpkg-vendor --query  Vendor)
#
# These are rarely used code. (END)
#

### main packaging script based on post dh7 syntax
%:
        dh $@

# debmake generated override targets
# Use "make prefix=/usr" (override prefix=/usr/local in Makefile)
#override_dh_auto_install:
#       dh_auto_install -- prefix=/usr

# Do not install python .pyc .pyo if they exist
#override_dh_install:
#       dh_install --list-missing -X.pyc -X.pyo

# Multiarch package requires library files to be installed to
# /usr/lib/<triplet>/ .  If the build system does not support
# $(DEB_HOST_MULTIARCH), you may need to override some targets such as
# dh_auto_configure or dh_auto_install to use $(DEB_HOST_MULTIARCH) .

Isto é essencialmente o ficheiro debian/rules standard com o comando dh. (Existem alguns conteúdos comentados para você personalizar.)

O ficheiro debian/control fornece os meta-dados principais para o pacote Debian. Aqui está o seu ficheiro modelo gerado pelo comando debmake.

debian/control (ficheiro modelo): 

[debhello-0.0] $ cat debian/control
Source: debhello
Section: unknown
Priority: optional
Maintainer: "Osamu Aoki" <osamu@debian.org>
Build-Depends:
 debhelper-compat (= 13),
Standards-Version: 4.7.3
Homepage: <insert the upstream URL, if relevant>
Rules-Requires-Root: no
#Vcs-Git: https://salsa.debian.org/debian/debhello.git
#Vcs-Browser: https://salsa.debian.org/debian/<project_site>

Package: debhello
Section: unknown
Architecture: any
Multi-Arch: foreign
Depends:
 ${misc:Depends},
 ${shlibs:Depends},
Description: auto-generated package by debmake
 This Debian binary package was auto-generated by the
 debmake(1) command provided by the debmake package.
 .
 ===== This comes from the unmodified template file =====
 .
 Please edit this template file (debian/control) and other package files
 (debian/*) to make them meet all the requirements of the Debian Policy
 before uploading this package to the Debian archive.
 .
 See
  * https://www.debian.org/doc/manuals/developers-reference/best-pkging-pract...
  * https://www.debian.org/doc/manuals/debmake-doc/ch05.en.html#control
 .
 The synopsis description at the top should be about 60 characters and
 written as a phrase.  No extra capital letters or a final period.  No
 articles — "a", "an", or "the".
 .
 The package description for general-purpose applications should be
 written for a less technical user.  This means that we should avoid
 jargon.  GNOME or KDE is fine but GTK+ is probably not.
 .
 Use the canonical forms of words:
  * Use X Window System, X11, or X; not X Windows, X-Windows, or X Window.
  * Use GTK+, not GTK or gtk.
  * Use GNOME, not Gnome.
  * Use PostScript, not Postscript or postscript.

	Atenção
	Se você deixar “Section: unknown” no ficheiro modelo debian/control não modificado, o erro do lintian pode fazer a compilação falhar.

É requerida alguma modificação manual para fazer o pacote Debian apropriado como um maintainer.

De modo a instalar ficheiros como parte dos ficheiros do sistema, o valor $(prefix) de /usr/local em Makefile deve ser sobreposto para ser /usr. Isto pode ser acomodado no ficheiro debian/rules com o alvo override_dh_auto_install a definir “prefix=/usr”.

debian/rules (versão do maintainer): 

[base_dir] $ cd debhello-0.0
[debhello-0.0] $ vim debian/rules
 ... hack, hack, hack, ...
[debhello-0.0] $ cat debian/rules
#!/usr/bin/make -f
export DH_VERBOSE = 1
export DEB_BUILD_MAINT_OPTIONS = hardening=+all
export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed

%:
        dh $@

override_dh_auto_install:
        dh_auto_install -- prefix=/usr

Exportar a variável de ambiente DH_VERBOSE no ficheiro debian/rules como em cima força a ferramenta debhelper a fazer um relatório de compilação afinado.

O exemplo de cima não tocou na fonte do autor para criar o próprio pacote Debian. Uma abordagem alternativa como maintainer é modificar os ficheiros na fonte do autor. Por exemplo, o Makefile pode ser modificado para definir o valor $(prefix) para /usr.

	Nota
	O “Secção 5.7, “Passo 3: Modificação dos ficheiros modelo”” em cima usando o ficheiro debian/rules é a melhor abordagem para empacotamento para este exemplo. Mas vamos continuar com estas abordagens alternativas como inclinação à experiência.

Aqui, o ficheiro patch 000-prefix-usr.patch é criado usando o comando diff.

Patch por “diff -u”. 

[base_dir] $ cp -a debhello-0.0 debhello-0.0.orig
[debhello-0.0] $ vim debhello-0.0/Makefile
 ... hack, hack, hack, ...
[base_dir] $ diff -Nru debhello-0.0.orig debhello-0.0 >000-prefix-usr.patch
[base_dir] $ cat 000-prefix-usr.patch
diff -Nru debhello-0.0.orig/Makefile debhello-0.0/Makefile
--- debhello-0.0.orig/Makefile  2026-02-11 09:50:54.416710230 +0000
+++ debhello-0.0/Makefile       2026-02-11 09:50:54.498291151 +0000
@@ -1,4 +1,4 @@
-prefix = /usr/local
+prefix = /usr

 all: src/hello

[base_dir] $ rm -rf debhello-0.0
[base_dir] $ mv -f debhello-0.0.orig debhello-0.0

Por favor note que a árvore fonte do autor é restaurada ao seu estado original após de gerar um ficheiro patch 000-prefix-usr.patch.

Aqui, o ficheiro patch 000-prefix-usr.patch é criado usando o comando dquilt.

dquilt é um invólucro simples do programa quilt. A sintaxe e função do comando dquilt é a mesma que do comando quilt(1), excepto para o facto que a patch gerada é guardada no directório debian/patches/.

Patch por dquilt. 

[debhello-0.0] $ dquilt new 000-prefix-usr.patch
Patch debian/patches/000-prefix-usr.patch is now on top
[debhello-0.0] $ dquilt add Makefile
File Makefile added to patch debian/patches/000-prefix-usr.patch
 ... hack, hack, hack, ...
[debhello-0.0] $ head -1 Makefile
prefix = /usr
[debhello-0.0] $ dquilt refresh
Refreshed patch debian/patches/000-prefix-usr.patch
[debhello-0.0] $ dquilt header -e --dep3
 ... edit the DEP-3 patch header with editor
[debhello-0.0] $ tree -a
.
├── .pc
│   ├── .quilt_patches
│   ├── .quilt_series
│   ├── .version
│   ├── 000-prefix-usr.patch
│   │   ├── .timestamp
│   │   └── Makefile
│   └── applied-patches
├── Makefile
├── README.md
├── debian
│   ├── README.Debian
│   ├── README.source
│   ├── changelog
│   ├── clean
│   ├── control
│   ├── copyright
│   ├── dirs
│   ├── docs
│   ├── examples
│   ├── gbp.conf
│   ├── install
│   ├── links
│   ├── manpages
│   ├── patches
│   │   ├── 000-prefix-usr.patch
│   │   └── series
│   ├── rules
│   ├── salsa-ci.yml
│   ├── source
│   │   └── format
│   ├── tests
│   │   └── control
│   ├── upstream
│   │   └── metadata
│   └── watch
└── src
    └── hello.c

9 directories, 30 files
[debhello-0.0] $ cat debian/patches/series
000-prefix-usr.patch
[debhello-0.0] $ cat debian/patches/000-prefix-usr.patch
Description: set prefix=/usr patch
Author: Osamu Aoki <osamu@debian.org>
Index: debhello-0.0/Makefile
===================================================================
--- debhello-0.0.orig/Makefile
+++ debhello-0.0/Makefile
@@ -1,4 +1,4 @@
-prefix = /usr/local
+prefix = /usr

 all: src/hello

Aqui, Makefile na árvore fonte do autor não precisa de ser restaurada para o estado original para o empacotamento.

	Nota
	Quando se gera o pacote fonte Debian por dpkg-source via dpkg-buildpackage no passo seguinte de “Secção 5.8, “Passo 4: Compilar pacote com debuild””, o comando dpkg-source assume que patches foram aplicadas à fonte do autor, pois o .pc/applied-patches existe.

A árvore fonte do autor pode ser restaurada para o estado original para o empacotamento.

A árvore fonte do autor (restaurada): 

[debhello-0.0] $ dquilt pop -a
Removing patch debian/patches/000-prefix-usr.patch
Restoring Makefile

No patches applied
[debhello-0.0] $ head -1 Makefile
prefix = /usr/local
[debhello-0.0] $ tree -a .pc
.pc
├── .quilt_patches
├── .quilt_series
└── .version

1 directory, 3 files

Aqui, Makefile é restaurado e o .pc/applied-patches está em falta.