Maman, j'ai patché Debian

Mathieu — Thu, 19 Mar 2020 15:33:00 +0100

Un billet en forme de note à moi-même sur ce qu'il faut faire pour correctement :

Récupérer un package depuis upstream
Appliquer un ou plusieurs patches
Le signer et le re-déployer en production

Préparer l'environnement

Pour compiler et signer un paquet simplement il vous faut :

Un utilisateur (non root)
Une clé GPG
Les build-essentials et les devscripts (parce qu'on est feignasse)

Créez un utilisateur non-root et loguez-vous avec. N'utilisez pas "su" à partir de root, parce que sinon GPG ne pourra pas vous demander la phrase de passe (des histoires de droits sur les TTY).

Créez une clé GPG, et paramétrez-la :

gpg --full-generate-key

Récupérez l'identifiant de clé à la fin de la procédure, ou avec gpg --list-keys si vous l'avez loupé.

Modifiez ou créez le fichier ~/.devscripts et ajoutez :

DEBUILD_SET_ENVVAR_DEBSIGN_KEYID=xxxxxxxx

Avec le xxxxxx qui correspond à votre identifiant de clé.

Récupérer le paquet et les dépendances de compilation

Le plus simple c'est quand le paquet existe déjà et qu'il faut simplement patcher. S'il n'existe aucun paquet, il faut créer un nouveau paquet, éventuellement debianizer la configuration, et c'est une autre paire de manches (et c'est pas le sujet ici).

Pour récupérer le paquet upstream :

apt-get source nomdupaquet

Si le paquet est introuvable, ajoutez les dépôts src à votre sources.list :

deb-src http://deb.debian.org/debian/ buster main contrib
deb-src http://security.debian.org/debian-security buster/updates main contrib
deb-src http://deb.debian.org/debian/ buster-updates main contrib

Il faut ensuite récupérer les paquets nécessaires à la compilation. Coup de bol, si vous avez pu avoir le paquet source à l'étape précédente, c'est facile :

apt-get build-dep nomdupaquet

Patcher le paquet

Le format dpatch est obsolète, en principe votre package utilise quilt comme tout paquet récent. Il suffit de télécharger le patch depuis git et le placer dans le dossier debian/patches.

Ensuite, ajoutez le nom du fichier que vous avez ajouté au fichier debian/patches/series . Attention, l'ordre dans series est important.

Déclarer les changements

Ce n'est pas nécessaire la première fois, mais si vous re-compilez un paquet, il faut ajouter un commentaire dans le Changelog. Le plus simple : utilisez la commande dch -i et modifiez la ligne de changelog, en changeant bien la version du paquet pour qu'elle soit consécutive à la précédente.

Compiler le paquet

Rendez-vous dans le dossier du paquet, et lancez la commande debuild . C'est tout. Rentrez votre phrase de passe pour la clé à la fin de la procédure.

Déployer en production

Pour déployer un paquet, deux solutions :

Envoyer le paquet puis l'installer avec dpkg -i lefichier.deb ou un outil d'orchestration
Installer un DPA (Debian Private Repository) et l'ajouter au sources.list

L'installation du serveur DPA fera l'objet d'un autre billet (un jour).

Sources

How to compile Kurso de Esperanto from source with Debian and Ubuntu

Mathieu — Sun, 23 Jun 2013 14:58:00 +0200

Pre-compiled version for Ubuntu 16.04 : Ubuntu PPA

Because there is no documentation on how to compile Kurso de Esperanto from source, here is how to do it.

This tutorial works with Ubuntu and Debian, if you run windows you probably wouldn't do it that way .

Read also : [In French] - [In Esperanto]

Download

Download source from : http://www.kurso.com.br/elshuto.php?en
(Command line : wget http://kurso.com.br/kurso4_source.tar.gz )
Extract tarball : tar -xzf kurso4_source.tar.gz

Install dependencies

Install Qt header files, compiler, and compilation tools : sudo apt-get install build-essential qt4-qmake libqt4-dev g++ make libphonon-dev libqt4-xml-dev libqt4-opengl-dev

Particular case : Ubuntu 12.04

To compile with Ubuntu 12.04, you need to install Qt module mobility in order to us the Qt module multimedia.

Add qtmobility-dev to dependencies : sudo apt-get install qtmobility-dev
Make the following symbolic link (as root) : sudo ln -s /usr/include/QtMultimediaKit/ /usr/include/QtMultimedia
Edit the file kurso4.pro from source folder :
Find :

QT += core gui phonon multimedia

Replace with :

QT += core gui phonon CONFIG += mobility MOBILITY += multimedia

Compile program

Enter in source folder : cd kurso4
Run command qt4-qmake to generate the Makefile.
Run command make to compile the program.

Run program

To run the program, simply run the file kurso4 wich is now in your source folder, or install it by running the command make install .

Note that you will need the Qt executable libraries in order to run the program (the libraries are dynamically linked) (sudo apt-get install libqt4 phonon qtmobility libqtcore4 libqt4-dbus libqt4-xml libqt4-opengl)

The program is crashing at startup (segmentation fault)

The source archive does not contains audio and video files, (sonoj and video folders). The program is crashing while trying to say "hello" at startup. You have to get these directories in an other archive (the executable versions of Kurso de Esperanto from the download page), and copy these directories in the source folder before starting kurso4.

That's all ! If you encounter any problem while trying to compile Kurso, don't hesitate to comment that post.

# uname -a - Mot-clé - compile