Chapitre 12. Programmation

La commande « echo » doit être utilisée avec les précautions suivantes car son implémentation diffère selon que l’on utilise les commandes internes ou externes de l’interpréteur de commandes :

	Note
	Bien que l’option « -n » ne soit pas vraiment de la syntaxe POSIX, elle est généralement acceptée.

	Astuce
	Utilisez la commande « printf » plutôt que la commande « echo » si vous avez besoin d’intégrer des séquences d’échappement dans la chaîne de sortie.

Des paramètres spéciaux de l’interpréteur de commandes sont souvent utilisés dans les scripts de l’interpréteur de commandes.

Les expansions de paramètres les plus courants à retenir sont les suivants :

Ici, les deux points « : » dans tous ces opérateurs sont en fait optionnels.

Chaque commande retourne un état de sortie qui peut être utilisé pour des expressions conditionnelles.

	Note
	« 0 » dans le contexte conditionnel de l’interpréteur signifie « Vrai » alors que « 0 » dans le contexte conditionnel de C signifie « Faux ».

	Note
	« [ » est l’équivalent de la commande test, qui évalue, comme expression conditionnelle, les paramètres jusqu’à « ] ».

Les idiomes conditionnels de base à retenir sont les suivants :

if [ <expression_conditionnelle> ]; then
 <si_succès_lancer_cette_commande>
else
 <si_pas_de_succes_lancer_cette_commande>
fi

Ici, le « || true » était nécessaire pour s’assurer que ce script de l’interpréteur ne se termine pas accidentellement à cette ligne lorsque l’interpréteur est appelé avec l’indicateur « -e ».

Les opérateurs de comparaison arithmétique entière dans les expressions conditionnelles sont « -eq », « -ne », « -lt », « -le », « -gt » et « -ge ».

Il existe un certains nombre d’idiomes de boucles qu’on peut utiliser avec un interpréteur de commandes POSIX.

	Astuce
	Les itérations numériques semblables à celles du langage C peuvent être réalisées en utilisant seq(1) comme générateur de « toto1 toto2 … ».

	Astuce
	Consultez Section 9.3.9, « Répéter une commande en bouclant entre des fichiers ».

En gros, l’interpréteur de commandes traite un script de la manière suivante :

Des guillemets simples dans des guillemets doubles n’ont pas d’effet.

Exécuter « set -x » dans le script de l’interpréteur ou l’appel du script avec l’option « -x » fait imprimer par l’interpréteur de commandes toutes les commandes exécutées. C’est assez pratique pour le débogage.

De façon à rendre vos programmes de l’interpréteur de commandes aussi portables que possible dans tous les systèmes Debian, c’est une bonne idée de limiter les programmes utilitaires à ceux fournis par les paquets essentiels.

L’interface utilisateur d’un simple programme d’interpréteur de commandes peut être améliorée au-delà de l’interaction bête des commandes echo et read afin de devenir plus interactive en utilisant un des programmes appelés « dialogues », etc.

Voici un exemple simple qui crée une image ISO avec des données RS02 fournies par dvdisaster(1) :

#!/bin/sh -e
# gmkrs02 : Copyright (C) 2007 Osamu Aoki <osamu@debian.org>, Public Domain
#set -x
error_exit()
{
  echo "$1" >&2
  exit 1
}
# Initialiser les variables
DATA_ISO="$HOME/Desktop/iso-$$.img"
LABEL=$(date +%Y%m%d-%H%M%S-%Z)
if [ $# != 0 ] && [ -d "$1" ]; then
  DATA_SRC="$1"
else
  # Sélectionner le répertoire pour la création de l’image ISO à partir d'un dossier du bureau
  DATA_SRC=$(zenity --file-selection --directory  \
    --title="Sélectionner la racine de l’arborescence de répertoires pour créer l’image ISO") \
    || error_exit "Quitter lors de la sélection du répertoire"
fi
# Vérifier la taille de l’archive
xterm -T "Check size $DATA_SRC" -e du -s $DATA_SRC/*
SIZE=$(($(du -s $DATA_SRC | awk '{print $1}')/1024))
if [ $SIZE -le 520 ] ; then
  zenity --info --title="Dvdisaster RS02" --width 640  --height 400 \
    --text="La taille des données convient à pour une sauvegarde sur CD :\\n $SIZE Mo"
elif [ $SIZE -le 3500 ]; then
  zenity --info --title="Dvdisaster RS02" --width 640  --height 400 \
    --text="La taille des données convient à pour une sauvegarde sur DVD :\\n $SIZE Mo"
else
  zenity --info --title="Dvdisaster RS02" --width 640  --height 400 \
    --text="La taille des données est trop grande pour une sauvegarde : $SIZE Mo"
  error_exit "Taille de données trop importante pour la sauvegarde :\\n $SIZE Mo"
fi
# on n'est certain d'avoir une option -e fonctionnelle uniquement avec xterm
# Créer une image ISO brute
rm -f "$DATA_ISO" || true
xterm -T "genisoimage $DATA_ISO" \
  -e genisoimage -r -J -V "$LABEL" -o "$DATA_ISO" "$DATA_SRC"
# Créer la redondance RS02 supplémentaire
xterm -T "dvdisaster $DATA_ISO" -e  dvdisaster -i "$DATA_ISO" -mRS02 -c
zenity --info --title="Dvdisaster RS02" --width 640  --height 400 \
  --text="Données ISO/RS02 ($SIZE Mo) \\n créées sur : $DATA_ISO"
# EOF

Vous désirerez peut-être créer un lanceur sur le bureau avec une commande définie comme « /usr/local/bin/gmkrs02 %d ».

Un exemple simple « example.c » peut être compilé avec la bibliothèque « libm » pour donner l’exécutable « run_example » par ce qui suit :

$ cat > example.c << EOF
#include <stdio.h>
#include <math.h>
#include <string.h>

int main(int argc, char **argv, char **envp){
        double x;
        char y[11];
        x=sqrt(argc+7.5);
        strncpy(y, argv[0], 10); /* évite les débordements de tampon */
        y[10] = '\0'; /* remplir afin d'être certain que la chaîne se termine par'\0' */
        printf("%5i, %5.3f, %10s, %10s\n", argc, x, y, argv[1]);
        return 0;
}
EOF
$ gcc -Wall -g -o run_example example.c -lm
$ ./run_example
        1, 2.915, ./run_exam,     (null)
$ ./run_example 1234567890qwerty
        2, 3.082, ./run_exam, 1234567890qwerty

Ici, « -lm » est nécessaire pour lier la bibliothèque « /usr/lib/libm.so » depuis le paquet libc6 pour sqrt(3). La bibliothèque réelle se trouve dans « /lib/ » avec le nom de fichier « libm.so.6 » avec un lien symbolique vers « libm-2.7.so ».

Regardez le dernier paramètre du texte en sortie. Il y a plus de 10 caractères bien que « %10s » soit indiqué.

L’utilisation de fonctions effectuant des opérations sur des pointeurs en mémoire sans vérification des limites, telles que sprintf(3) et strcpy(3) a été rendue obsolète afin d’éviter les exploits de débordements de tampons qui utilisent les effets des débordements ci-dessus. Utilisez snprintf(3) et strncpy(3) en remplacement..

Comme, par défaut, sous Debian, tous les paquets binaires sont « strippés » (dépouillés de leurs symboles de débogage), la plupart des symboles de débogage sont supprimés des paquets normaux. Pour pouvoir déboguer des paquets Debian à l’aide de gdb(1), les paquets *-dbg correspondants doivent être installés (par exemple libc6-dbg dans le cas de libc6).

Si un paquet à déboguer ne possède pas de paquet *-dbg correspondant, vous devrez l’installer après l’avoir reconstruit comme suit :

$ mkdir /chemin/nouveau ; cd /chemin/nouveau
$ sudo apt-get update
$ sudo apt-get dist-upgrade
$ sudo apt-get install fakeroot devscripts build-essential
$ sudo apt-get build-dep nom_paquet_source
$ apt-get source nom_paquet
$ cd nom_paquet*

Corriger les bogues si nécessaire.

Modifier la version du paquet pour ne pas entrer en collision avec les versions officielles de Debian, par exemple, en ajoutant « +debug1 » pour la compilation d’une version de paquet existante, ou « ~pre1 » pour la compilation d’une version de paquet qui n’est pas encore diffusée de la manière suivante :

$ dch -i

Compiler et installer les paquets avec les symboles de débogage comme suit :

$ export DEB_BUILD_OPTIONS=nostrip,noopt
$ debuild
$ cd ..
$ sudo debi nom_paquet*.changes

Vous devrez vérifier les scripts de construction du paquet et vous assurer que les options « CFLAGS=-g -Wall » sont positionnées pour la compilation des binaires.

Si vous rencontrez un plantage de programme, signaler le bogue avec un copier-coller des informations de trace est une bonne idée.

La trace peut être obtenue de la manière suivante :

Si le programme se fige, vous pouvez le planter en pressant Ctrl-C dans le terminal où tourne gdb pour récupérer l’invite de gdb ;

Astuce

Souvent, vous voyez une trace où une ou plusieurs des lignes de départ se trouvent dans « malloc() » ou « g_malloc() ». Lorsque cela arrive, il y a des chances pour que votre trace ne soit pas très utile. La meilleure façon de trouver des informations utiles est de définir la variable d’environnement « $MALLOC_CHECK_ » à la valeur 2 (malloc(3)). Vous pouvez le faire en lançant gdb de la manière suivante :

 $ MALLOC_CHECK_=2 gdb hello

Si un programme apercu1 de GNOME a reçu une erreur X, vous devriez obtenir un message comme suit :

Le programme 'apercu1' a reçu une erreur du système X Window.

Dans ce cas, vous pouvez essayer de faire tourner le programme avec « --sync » et arrêter sur la fonction « gdk_x_error » de manière à obtenir une trace.

Utilisez ldd(1) pour trouver les dépendances d’un programme avec des bibliothèques :

$ ldd /bin/ls
        librt.so.1 => /lib/librt.so.1 (0x4001e000)
        libc.so.6 => /lib/libc.so.6 (0x40030000)
        libpthread.so.0 => /lib/libpthread.so.0 (0x40153000)
        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)

Pour que ls(1) fonctionne dans un environnement `chroot`é, les bibliothèques ci-dessus doivent être disponibles dans votre environnement `chroot`é.

Il y a plusieurs outils de détection des fuites de mémoire disponibles sous Debian.

Vous pouvez désassembler du code binaire avec objdump(1) en faisant ce qui suit :

$  objdump -m i386 -b binary -D /usr/lib/grub/x86_64-pc/stage1

	Note
	gdb(1) peut être utilisé pour désassembler du code de manière interactive

	Avertissement
	Ne pas écraser les fichiers du système avec les programmes que vous avez compilés en les installant.

Debian ne touche pas aux fichiers se trouvant dans « /usr/local/ » ou « /opt ». Donc, si vous compilez un programme depuis ses sources, installez-le dans « /usr/local/ » de manière à ce qu’il n’interfère pas avec Debian.

$ cd src
$ ./configure --prefix=/usr/loca
$ make
$ make install # cela met les fichiers dans le système

Si vous avez les sources d’origine et s’ils utilisent autoconf(1) et automake(1) et si vous-vous souvenez comment vous l’avez configuré, exécutez-le comme suit pour désinstaller le programme :

$ ./configure « toutes-les-options-que-vous-lui-avez-passé »
# make uninstall

Sinon, si vous êtes absolument certain que le processus d’installation n’a mis des fichiers que sous « /usr/local/ » et qu’il n’y a là rien d’important, vous pouvez supprimer tout son contenu avec :

# find /usr/local -type f -print0 | xargs -0 rm -f

Si vous n’êtes pas certain de l’emplacement où les fichiers ont été installés, vous devriez envisager d’utiliser checkinstall(8) du paquet checkinstall qui fournit une voie propre pour la désinstallation. Il prend maintenant en charge la création d’un paquet Debian à l’aide de l’option « -D ».