Maintainer’s Name and
Email Address
Most of the programs involved in package maintenance will look for your name and
email address in the
DEBFULLNAME
and
DEBEMAIL
or
EMAIL
environment variables.
Defining them, once and for all, prevents re-typing them multiple times. If your usual
shell is Bash, it is a simple matter of adding the following two lines in your
~/.bashrc
file. For example:
270
Kali Linux Revealed
export EMAIL=”buxy@kali.org”
export DEBFULLNAME=”Raphael Hertzog”
The
dh_make
command created a
debian
subdirectory containing many files. Some are required,
in particular
rules
,
control
,
changelog
, and
copyright
. Files with the
.ex
extension are ex-
ample files that can be used by modifying them and removing the extension. When they are not
needed, we recommend removing them. The
compat
file should be kept, since it is required for
the correct functioning of the debhelper suite of programs (all beginning with the
dh_
prefix) used
at various stages of the package build process.
The
copyright
file must contain information about the authors of the documents included in the
package, and the related license. If the default license selected by
dh_make
does not suit you, then
you must edit this file. Here is the modified version of the copyright file:
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: offsec-defaults
Files: *
Copyright: 2020 Offensive Security
License: GPL-3.0+
License: GPL-3.0+
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the
GNU General Public License for more details.
.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
.
On Debian systems, the complete text of the GNU General
Public License version 3 can be found in ”/usr/share/common-licenses/GPL-3”.
The default
changelog
file is generally appropriate; replacing the “Initial release” with a more
verbose explanation should be enough:
offsec-defaults (1.0) unstable; urgency=medium
* Add salt minion’s configuration file.
* Add an APT’s sources.list entry and an APT’s trusted GPG key.
271
Chapter 10 — Kali Linux in the Enterprise
* Override the gsettings schema defining the background picture.
-- Raphaël Hertzog
Thu, 16 Jun 2020 18:04:21 +0200
In the example, we will make changes to the
control
file. We will change the Section field to misc
and remove the Homepage, Vcs-Git, and Vcs-Browser fields. Lastly, we will fill in the Description
field:
Source: offsec-defaults
Section: misc
Priority: optional
Maintainer: Raphaël Hertzog
Build-Depends: debhelper (>= 9)
Standards-Version: 3.9.8
Package: offsec-defaults
Architecture: all
Depends: ${misc:Depends}
Description: Default settings for Offensive Security
This package contains multiple files to configure computers
owned by Offensive Security.
.
It notably modifies:
- APT’s configuration
- salt-minion’s configuration
- the default desktop settings
The
rules
file usually contains a set of rules used to configure, build, and install the software
in a dedicated subdirectory (named after the generated binary package). The contents of this
subdirectory are then archived within the Debian package as if it were the root of the filesystem.
In this case, files will be installed in the
debian/offsec-defaults/
subdirectory. For example,
to end up with a package installing
/etc/apt/sources.list.d/offsec.list
, install the file in
debian/offsec-defaults/etc/apt/sources.list.d/offsec.list
. The
rules
file is used as a
Makefile
, with a few standard targets (including clean and binary, used respectively to clean the
source directory and generate the binary package).
|