Vim est ton ami.

Oukiléleclavier ? Oukellélasouris ? (ou: la bonne blague de Xorg)

Jean-Seb — Wed, 05 May 2010 18:47:00 +0200

Je me suis aperçu qu'il manquait un tag à mes billets.
Comment caractériser toutes ces nuisances qui gachent la vie de l'honnête administrateur système ?
J'inaugure dès à présent le tag pénible avec Xorg

Situation de départ

Le but était de faire 'une mise à jour de Xorg sous Gentoo.
- Pour ma part, il s'agissait de passer le serveur Xorg de la version 1.3 à la version 1.6.5.

Avis aux mécréants utilisateurs d'autres unixeries que Gentoo : continuez à lire, ceci concerne au moins également FreeBSD et Arch-Linux.

Echauffement

Installer Xorg implique souvent la mise à jour d'autres paquets.
Avant même le passage au paquet xorg-server, nous rencontrons une erreur.
La libpciaccess (en update) essaie d'installer un exécutable (scanpci) mais refuse de remplacer la version précédente.
- Cet exécutable provoque un conflit, car c'est un autre ebuild qui a construit la version précédente.
- On ne peut donc pas le supprimer sans réfléchir, car cela risquerait de casser l'autre ebuild.

Laissez tomber la méthode de résolution suggérée dans les messages, et faites plutôt:
- equery b scanpci : vous obtenez le nom du paquet qui contient l'ancienne version à remplacer.
- Il s'agissait du Xorg que vous tentez d'updater. Ma méthode (votre avis peut varier) : emerge -C xorg-server

Une fois ceci rêglé, vous pouvez relancer la mise à jour de xorg-server.

Plus de clavier, plus de souris

Pour le reste, la compilation, se passe plutôt bien.
Un emerge -va nvidia-drivers plus tard, Xorg démarre enfin.
Et là, plus de souris (huho) ni de clavier (haha).

Rendez moi mon clavier! (et ma souris aussi!)

Sortie de Xorg

Alors là, attention, c'est technique.
- Appuyez pendant 5 secondes sur le bouton marche/arrêt du PC.
- Si vous avez ACPI dans le noyau avec un script sur le bouton marche/arrêt, vous êtes sauvé et la solution déplorable de la ligne du dessus ne sera pas nécessaire.
- Les heureux utilisateurs d'un réseau local pourront également faire un ssh sur la machine coincée. Beaucoup plus propre, mais nécessite un cable réseau et un autre PC (et un daemon sshd sur la machine bloquée).

Divination avec les logs

Après le reboot, et en supposant que vous n'avez pas eu de problème de journalisation, vous vous retrouvez à nouveau devant la console.
- Si vous n'avez pas de chance, X est relancé aussi sec. Dans ce cas, il va falloir changer le niveau de démarrage de votre Linux.

Dans le log de Xorg, nous trouvons la source du problème (je ne vous montre que la partie concernant le clavier, la même chose est observable pour la souris):


$~  less /var/log/Xorg.0.log
(II) LoadModule: "kbd"
(II) Loading /usr/lib/xorg/modules/input//kbd_drv.so
(II) Module kbd: vendor="X.Org Foundation"
        compiled for 1.3.0, module version = 1.1.0
        Module class: X.Org XInput Driver
        ABI class: X.Org XInput driver, version 0.7
(EE) module ABI major version (0) doesn't match the server's version (4)
(II) UnloadModule: "kbd"
(II) Unloading /usr/lib/xorg/modules/input//kbd_drv.so
(EE) Failed to load module "kbd" (module requirement mismatch, 0)

Parenthèse pour les paresseux

Si vous n'avez pas fait de mise à jour de Xorg depuis vraiment très longtemps, il se peut que vous ayez un autre problème.
En effet, dans la config de Xorg, les devices ont changé de nom à un moment donné.
Vérifiez donc que votre clavier et votre souris ont bien le driver convenable.


Section "InputDevice"

    Identifier  "Keyboard1"
    Driver      "kbd"

(snip)
    Identifier  "Mouse1"
    Driver      "mouse"

Je ne saurais en dire plus à ce sujet, car je n'ai que de vagues souvenirs de ce problème.
- De toutes façons, le problème a dû disparaitre de lui-même, depuis le temps. (l'optimisme est rare de nos jours, sachons le cultiver.)

Revenons à nos moutons

Il vous manque simplement deux mises à jour, oubliées par emerge.
emerge -va xf86-input-keyboard
emerge -va xf86-input-mouse

A noter que le problème se posera probablement également avec votre joystick, votre tablette graphique, et autres périphériques d'entrée.
- Un simple eix xf86-input vous en convaincra aisément.

Keyboard not found. Press F1 to continue.

J'ai profité de mon clavier retrouvé pour écrire ce billet.
Comme je ne vais pas non plus tout faire, je vous laisse écrire les commentaires.

MPD : le stream était presque parfait

Jean-Seb — Wed, 28 Apr 2010 00:11:00 +0200

Aujourd'hui, ce sont mes aventures pour streamer de la musique avec mpd.
Car mpd est beau, mpd est grand, mpd streame!
Merci à Frédéric Jolliton pour le coup de main lors de la mise au point. (et il a relu et clarifié, en plus)
MàJ 13 mai 2010 : gagner trois ko de bande passante avec shh

Résumé des épisodes précédents

Ce n'était pas forcément le plus intéressant, mais le premier billet est ici:
- MPD - musique par le daemon

Le streaming n'était pas le sujet de ce billet. Dans ma grande bonté, j'en refais donc un complet.

Comprenons-nous bien

Ce titre légèrement menaçant fait un peu vendeur de savonnettes dé-régulées cherchant à forcer l'entrée de votre habitation. Cette fois, il ne s'agit que d' une nécessaire introduction à ce qu'est réellement mpd.

De l'avantage du stream

Pourquoi écouter un stream , et ne pas décoder en local ?
- Vous ne compilerez qu'une fois le player.
- Vous ne dupliquez pas vos fichiers, vous n'avez pas besoin de les promener sur une clé usb ou un disque externe.
- Vous allez faire l'envie de vos voisins (en général, cet argument suffit à emporter la décision).

mpd n'est pas forcément ce que l'on croit

mpd est un player dont la sortie sonore se fait en local par défaut (c'est à dire, sur la machine où mpd est lancé).
- Les clients de mpd, tels que ncmpc ou gmpc (client Gnome) ne sont rien d'autre que des télécommandes pour mpd.
- Aucun d'entre eux ne permet d'écouter un stream.
- Ils ne savent qu'envoyer des commandes au daemon mpd.

Un client mpd est une télécommande ... donc cela signifie que seul le PC faisant tourner le serveur est en mesure de sortir du son, et que tous les clients associés à mpd ne servent qu'à contrôler celui-ci à distance ?
- Exactement ! Je n'aurais su mieux le dire !

mais mpd peut streamer

Néanmoins, si les clients spécifiques à mpd ne peuvent que le contrôler, mpd est capable de différents rendus.
- Les sorties locales, avec la configuration OSS , Alsa ou ... null (qui est bien un rendu local)
- Des sorties streamées, avec entre autres un serveur shoutcast, ou son serveur interne httpd.

Nous allons utiliser le serveur intégré à mpd, qui streame sans fioritures, tel une web-radio.

Dès à présent, il est utile de préciser que nous allons utiliser deux ports.
- Le port de commande de mpd, sur lequel nous pouvons connecter un client, ou lancer un telnet.
- Le port utilisé par mpd pour servir le stream. Celui-ci n'est actif que quand de la musique est jouée. Il est fermé dès que la musique est stoppée.

Préparation et configuration de mpd

Flags de compilation Gentoo


media-sound/mpd -alsa -ffmpeg mikmod musepack ogg vorbis lame

Votre avis concernant ffmpeg pourra varier, mais j'ai préféré limiter les temps de compilation sur une machine un peu limitée.
J'ai bien sûr retiré toute référence à Alsa (OSS étant inactif par défaut), vu que la machine hébergeant le serveur n'a même pas de carte son.

Création des répertoires nécessaires

mpd peut être lancé par un utilisateur lambda.
- Vous devriez mettre sa configuration dans le home de celui-ci, et ajuster le paramètre user dans le fichier de configuration.

Fichier de configuration

Voici mon fichier de configuration.
- Je n'ai pas inclu tout ce qui ne sert pas, reportez vous au fichier /etc/mpd.conf pour plus de précisions.
- Pour vos essais, vous pouvez simplifier la situation en ne mettant pas de mot de passe, par exemple.


music_directory  "/home/toto/music"
playlist_directory  "/home/toto/mpd/playlists"
db_file  "/home/toto/mpd/database"
log_file  "/home/toto/mpd/mpd.log"
pid_file  "/home/toto/mpd/mpd.pid"
state_file  "/home/toto/mpd/state"
user  "toto"
bind_to_address  "0.0.0.0"
port  "1234"
password  "password@read,add,control,admin"
default_permissions  "" #pas de bras, pas de chocolat.

input {
        plugin "curl"
}

audio_output {
        type  "httpd"
       name  "My HTTP Stream"
        encoder  "lame"  # optional, vorbis or lame
        port  "5678"
        bitrate  "128"  # do not define if quality is defined
        format  "44100:16:1"
}
filesystem_charset "UTF-8"

bind_to_address : ne mettez surtout pas localhost ou 127.0.0.1 :
- Cela provoquerait un bind de mpd sur l'interface loopback. Toute connexion externe serait alors impossible.
- A la place de 0.0.0.0 on peut mettre l'IP d'une carte réseau. Par exemple pour une machine directement sur le net (avec une IP publique) on veut pas forcément rendre mpd accessible. Alors qu'en mettant l'IP de la machine sur le LAN (disons 192.168.1.1) ça ne sera accessible que sur le réseau local.

default_permissions : pour vos essais en connexion anonyme (sans mot de passe), vous pouvez mettre les permissions à fond avec read,add,control,admin.

Premier lancement

Placez quelques fichiers musicaux dans le répertoire définit comme music_directory dans le fichier de configuration.

Le premier lancement se fera en local, avec l'utilisateur configuré dans mpd.conf

Au passage, nous allons créer la base de données.
- Par la suite, la commande update sera envoyée par un client mpd.


toto@serveur ~$ mpd --create-db

En cas d'erreur, ou de modification de la base, vous pouvez tuer le serveur avec :
- kill $(pidof mpd)

Par la suite, vous pourrez utiliser les scripts Gentoo (ou de votre distrib) pour demander le démarrage de mpd au boot.

Test rapide avec telnet

Plus qu'à tenter un telnet sur le port de votre serveur

Vous pouvez trouver toutes les commandes comprises par mpd ici:
- commandes mpd


toto@serveur ~/.ncmpc $ telnet localhost 1234
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
OK MPD 0.15.0
status
volume: -1
repeat: 0
random: 0
single: 0
consume: 0
playlist: 3
playlistlength: 0
xfade: 0
state: stop
OK
close
Connection closed by foreign host.

status vous permettra d'obtenir rapidement confirmation du fonctionnement de mpd.
- Même si la simple réussite de la connexion telnet devrait suffire.

Pour fermer proprement la session, utilisez close.

mpc dépanne certes bien...

Maintenant que le daemon mpd fonctionne, il est temps de tester avec un logiciel un peu plus évolué, et à distance.
- Je vous conseille de rester sur le réseau local de mpd, ceci limitera les ports à ouvrir dans le firewall, et vous pourrez toujours vous passer d'authentification.

L'informatique aime les acronymes, et les doublons aussi.
- mpc = music player client
- ne confondez pas avec les vieux fichiers musepack (extension mpc) que l'on peut jouer avec mpd.

mpc est un utilitaire indispensable pour vous éviter des telnet rapidement saoulants sur le port du daemon mpd.

Je vous laisse faire man mpc , le fonctionnement est trivial.

...mais ncmpc est toujours le plus beau

Maintenant que tout semble bien tourner, il est temps de passer au client qui ne nous quittera plus.
Avec un nom à coucher dehors, ncmpc est néanmoins le plus agréable des clients mpd.
Interprétation personnelle du nom:
- nc = ncurses
- mpc = music player client

Version dans Portage (avril 2010)

0.14
- un peu vieille, mais que voulez-vous ...

Flags Gentoo


media-sound/ncmpc artist-screen colors help-screen key-screen lyrics-screen search-screen song-screen

Beaucoup de possibilités dans les versions récentes de ncmpc , y compris la possibilité d'afficher les paroles des chansons.
- J'ai activé toutes les options, ça ne mange pas de pain (ni de ressources).

Erreur possible à la compilation de ncmpc


match.c:43: attention : implicit declaration of function ‘g_regex_match_simple’
match.c:45: erreur: ‘G_REGEX_CASELESS’ undeclared (first use in this function)

Dans ce cas, il faut mettre à jour votre glib (pas la glibc , je parle bien de la glib tout court) et recommencer l'emerge de ncmpc.

Fichier de configuration de ncmpc

Il se trouve dans ~/ncmpc/config
Celui-ci est donné juste pour information. Je n'ai pas encore pris le temps de fignoler.


port = 1234
password = "password"
scroll = yes
scroll-sep = " ***** "
enable-colors = yes
color background = black
color list = brightwhite

Diagnostics

Lancez la lecture d'un fichier avec mpc, ncmpc, telnet, ou ce que vous voudrez.
- Ceci doit produire l'envoi du stream sur le port défini pour httpd dans la configuration de mpd.
- Le port stream ne sera ouvert que pendant la génération d'un stream.


toto@serveur ~$ netstat -pln | grep mpd
tcp        0      0 0.0.0.0:1234            0.0.0.0:*               LISTEN      3694/mpd
tcp        0      0 0.0.0.0:5678            0.0.0.0:*               LISTEN      3694/mpd

Les ports utilisés sont ceux définis dans mpd.conf
- Le port de commande de mpd est 1234.
- Le stream est joué sur 5678.

La config du pauvre, mais qui marche tellement bien

Et encore j'avais un titre plus long pour cette partie, mais il faut savoir rester raisonnable.

Nous allons utiliser un tunnel ssh dans lequel nous ferons passer le flux.
- Ceci nous évitera de partager nos disques avec la terre entière, ce qui serait non seulement illégal, mais très consommateur en bande passante.

Tunnel ssh

Ce n'est pas le sujet de ce billet, je vous donne donc la commande pour créer un tunnel ssh.
- Il y a pas mal d'explications à ce sujet un peu partout, les curieux devraient trouver leur compte facilement.
- Sous MS-Windows, vous pouvez créer facilement des tunnels avec Putty.

pour créer un tunnel ssh entre votre machine et le serveur mpd


ssh -C -L 5678:localhost:5678 a.b.c.d

5678 : port configuré sur mpd pour exporter le stream httpd (ce n'est pas le port de commande de mpd)
localhost : car vous allez vous connecter sur votre machine pour la redirection de port.
a.b.c.d : ip de la machine distante faisant tourner mpd.

En prime, vous récupérez un shell où vous pourrez lancer ncmpc pour controler mpd.

mpd

Exporte le flux httpd.
Les façons de le lancer ont été vues plus haut:
- en user : mpd
- au démarrage : voir la doc de votre distrib. Avec Gentoo, vous pourrez utiliser /etc/init.d/mpd start

ncmpc

à installer sur le serveur pour controler mpd
- on peut également l'installer sur le client (dans ce cas, pensez à définir un login/password et à ouvrir le port de commande mpd dans le firewall).

mplayer

Reçoit le stream et assure son rendu.
mplayer http://192.168.1.1:5678
- 192.168.1.1 est l'ip de la machine faisant tourner mpd.
- 5678 est le numéro de port utilisé pour envoyer le stream.

Inconvénients de la config du pauvre (mais qui marche tellement bien)

Je ne vous le cache pas, il y a quelques inconvénients.

Overhead du tunnel

Si vous êtes vraiment court côté débit, sachez qu'un flux à 128kbs (minimum pour une qualité acceptable) vous pompe 16ko/s de bande passante.
- Avec le tunneling, vous allez passer à environ 22ko/s de moyenne.
Je n'ai pas testé avec quelque chose de plus compliqué, à base de OpenVPN par exemple.
- Si quelqu'un l'a fait, qu'il n'hésite pas à partager son expérience.

Pour gagner un peu de bande passante sur la session SSH, vous pouvez passer l'option -N à la connexion.
- Cette option désactive le shell interactif et ne fait qu'établir le tunnel.
- Vous ne pourrez donc plus controler la playlist directement, mais pour un streaming tout simple, cela suffit. Vous gagnez environ trois Ko/s.

Latence

C'est inhérent au streaming. Pour assurer une liaison sans saccades, tout est bufferisé.
- Les modifications côté serveurs (changement de chanson, ou arrêt pur et simple) mettront quelques secondes avant d'être répercutées à votre client.

Quand à l'avance/retour rapide dans un morceau, mieux vaut oublier tout de suite.

Une idée pourrait être de réduire la taille du buffer , sur une liaison de bonne qualité bien entendu.

Allez, c'est pas si mal finalement

De toutes façons, vous n'auriez guère mieux avec un serveur shoutcast, alors pourquoi se compliquer la vie ?

Allez hop. Et profitez-en pour mettre Audacious à la poubelle avant de sortir.

La plomberie facile avec mtrace

Jean-Seb — Mon, 22 Feb 2010 21:37:00 +0100

Le C et les fuites mémoires, c'est comme une vieille complainte sentimentale.
Avec mtrace, et sa couche maxi-absorbante, finissez-en avec l'incontinence de vos programmes.
mtrace n'est pas disponible en pharmacie, uniquement dans les bonnes libc.

Ma mémoire prend la fuite!

Je ne vous fait pas une tartine sur les problèmes de gestion mémoire en C.
- Si vous avez approché un compilateur C un jour de votre vie, vous savez de quoi je parle.

Pour prévenir les problèmes de fuite mémoire, il existe plusieurs méthodes.

Je ne fais rien

Ne rigolez pas, un OS bien conçu est censé vous rendre la mémoire à la sortie de votre programme.
Bon alors, on fait comme ça ?
- Non, on ne fait pas comme ça. On passe toujours un coup de balai avant de quitter un programme, question de savoir-vivre et d'éducation.
- Il y a également le fait qu'on ne sait jamais vraiment où le programme finira par tourner, ni si l'OS réussira réellement à récuperer toute la mémoire.

J'écris mon gestionnaire mémoire

Allez, on l'a tous fait un jour ou l'autre.
- Ou comment finir avec un wrapper de malloc/free plus ou moins élaboré, qui génère de jolies listes d'alllocations/libérations.
Ce n'est pas forcément une mauvaise idée. C'est surtout délicat à gérer pour toutes sortes de raisons (je ne développe pas, si vous ne comprenez pas, essayez de faire le votre).
L'insensé tenant vraiment à explorer la Voie de l'Insomnie pourra toujours commencer par : man malloc_hook.

J'utilise mtrace

Et c'est la prise de conscience sur un titre judicieusement choisi.

mtrace, principe et utilisation

Prérequis

Une libc GNU.
Un compilateur GNU.

Principe

Le principe consiste à intercepter les appels à malloc et à free, et à tenir registre des allocations/libérations de mémoire.
Pour cela, vous initialiserez le wrapper de la libc avec mtrace() , et vous appellerez en sortie muntrace().

Utilisation

Il suffit d'inclure mcheck.h et vous pourrez utiliser les deux fonctions requises.
- mtrace : avant tout malloc().
- muntrace : après le dernier free().

Vous aurez également besoin d'une variable shell, pour indiquer où écrire le fichier de log.
- export MALLOC_TRACE = /path/to/log.txt

Une autre variable shell peut être utilisée: MALLOC_CHECK
- Normalement, son usage est d'indiquer le niveau de log.
- export MALLOC_CHECK = 2 : fait planter le programme si erreur malloc (je tenais à vous faire partager cette découverte).

Un script Perl (mtrace) pour mettre en forme le fichier de log.

L'exemple tant attendu

Source pour nos essais

/* mtrace.c */

#include <stdio.h>
#include <stdlib.h>
#include <mcheck.h>

int main(void)
{
  mtrace();

  char *freed = malloc(1024);
  char *leaked = malloc(1024);

  if (freed) free(freed);

  muntrace();
  return 0;
}

Pour compiler ce source, rien de spécial.
- gcc -g -Wall mtrace.c -o mtrace
- N'oubliez pas -g pour avoir les symboles dans la sortie de mtrace.

Et pour le lancer:
- MALLOC_TRACE=/tmp/mtrace.log ./mtrace
- Le prompt revient, pas de plantages, donc, pas de problèmes.
- Vraiment ?

Utilisation du script Perl mtrace

Tout d'abord, voyons à quoi ressemble le fichier log.


~test$ cat /tmp/mtrace.log 
= Start
@ ./mtrace:[0x40060f] + 0x1ea7460 0x400
@ ./mtrace:[0x40061d] + 0x1ea7870 0x400
@ ./mtrace:[0x400631] - 0x1ea7460
= End

De ce qui précède, on peut deviner aisément que le bloc mémoire situé à 0x1ea7870 n'a pas été libéré.
- Nous allons cependant rendre plus parlant ce fichier.

Le script mtrace s'invoque avec en paramètres l'exécutable à analyser (pour ses symboles), et le fichier log.


~test$ MALLOC_TRACE="/tmp/mtrace.log" mtrace ./mtrace /tmp/mtrace.log 

Memory not freed:
-----------------
           Address     Size     Caller
0x0000000001cb6870    0x400  at /home/jseb/test/mtrace.c:12

Voila qui est plus parlant.
- La ligne indiquée correspond au malloc() sans free() correspondant.

mtrace n'est cependant pas Dieu le Père Tout Puissant

mtrace ne vous protégera bien sûr pas des écrasements mémoire durant l'exécution de votre programme.
De même, les problèmes de gestion mémoire ne seront pas détectés. Il peut cependant vous signaler des free multiples.
Sa facilité d'emploi devrait toutefois inciter tout codeur un tant soit peu consciencieux à l'utiliser.
Une alternative consiste à laisser tomber malloc et free, mais je laisse ça aux gens qui ont des problèmes de mémoire.

Unison et MSYS sont dans le même bateau

Jean-Seb — Mon, 21 Dec 2009 19:07:00 +0100

Vous utilisez MS-Windows, comme des millions d'autre victimes (et moi, et moi, et moi).
Vous utilisez également MSYS (comme... euh... moi.)
Mais avec MSYS, Unison (le synchroniseur de fichiers) est rétif.
MSYS va apprendre que l'ordinateur est fait pour servir l'homme, et non l'inverse (muhaHAHAHAA!)

Il y a ce qu'on a ...

Ce qu'on a

Pour le moment, nous pouvons utiliser uniquement Unison sous la forme d'un serveur lancé avec la commande
- unison --socket <port en écoute>

Le client Unison est le même programme, mais lancé avec des paramètres différents. Il sera utilisé depuis une autre machine pour se connecter à son serveur.

Ce n'est pas une bonne solution, pour trois raisons:
- Il faut lancer Unison en écoute le serveur à chaque utilisation, ou pire, le laisser tourner en permanence en écoute.
- Les communications ne sont pas chiffrées.
- Il n'y a pas d'authentification, et changer de port pour l'écoute du serveur n'est qu'un pis-aller.

Ce qu'on aimerait que ça devienne

Utiliser le mode commandes ssh de Unison, qui lance lui même le serveur, et fait transiter les données dans un canal crypté.
- Les inconvénients de la situation où Unison est figé en écoute sont supprimés.

Configuration logicielle

openssh de MSYS

Ma version de openssh est la 4.7
- Sans vouloir gâcher un long suspense, nous n'utiliserons pas openssh, mais plink de putty.
- Je laisse toutefois mon cheminement avec openssh. Un courageux pourra peut être compléter dans les commentaires.

putty 0.59

Uniquement pour utiliser plink (mais putty est également un excellent émulateur de terminal).
- La version 0.60 est disponible sur le site officiel.

Unison en interface texte

Il s'agit de la version 2.27
Pour nos tests, nous allons utiliser la version interface texte de Unison.
- Le passage à l'interface graphique de Unison sera abordé à la fin de cet article.

Profil pour les tests

Le client d'où est lancé la commande est un banal Windows.
Le serveur est un banal Linux, avec Unison correctement installé. (ip: 192.168.1.1)
Un fichier profile se trouvera dans votre home, dans le sous-répertoire .unison
Exemple de fichier profile valide, situé dans ~/.unison/default.prf


# Unison preferences file
root = c:\msys\home\jseb\coding
root = ssh://jseb@192.168.1.1//home/jseb/coding

Vous remarquerez que l'encodage des répertoires côté Windows se fait avec des antislashes, ce qui est logique quand on réfléchit trente secondes.
- Je dis ça, car mon premier essai m'a pris exactement vingt neuf secondes.

Premier lancement

Unison est lancé avec les paramètres suivants:
- ./"Unison-2.27.57 Text.exe" -debug verbose

Je passe le début du log. La fin est intéressante:


Contacting server...
[remote] Shell connection: ssh (ssh, -l, jseb, 192.168.1.1, -e, none, unison, -server)
Uncaught exception Unix.Unix_error(20, "create_process", "ssh")

On dirait un problème avec ssh, pas vrai Holmes ?
- Watson, vous m'étonnerez toujours.

Utiliser ssh avec Unison

Vérification (sur l'air de ne négligeons aucune possibilité)

La commande ssh existe pourtant dans MSYS.
Première chose, s'assurer de son bon fonctionnement.


$ ssh jseb@192.168.1.1 ls
Password: 
(et une jolie liste de fichiers s'affiche)

Pas de problèmes de ce côté là.
Les paramètres passés par Unison ne sont probablement pas compris par ssh.

Voyons voir ces paramètres...

Pour rappel, voici la chaine de paramètres utilisée par Unison (vu dans les logs plus haut)
- ssh, -l, jseb, 192.168.1.1, -e, none, unison, -server

Nous allons faire un essai à la main


$ ssh jseb@192.168.1.1 unison -server
Password: 
bash: unison: command not found

Ahah! Effectivement, Unison ne s'appelle pas Unison sur mon serveur, pour des raisons historiques (aheeeem!).
- Son vrai petit nom est unison-2.27

Hola! Stop! Je vous ai vu! Pas de renommage du binaire sur le serveur, espèce de sauvage!
- Le fichier profile peut se configurer afin de préciser la commande à lancer.
- Il suffit d'ajouter: servercmd = unison-2.27 dans le profil.

Avec les nouveaux paramètres...

On relance Unison, toujours en mode debug


$ ./Unison-2.27.57\ Text.exe -debug verbose
 (...)
[remote] Shell connection: ssh (ssh, -l, jseb, 192.168.1.1, -e, none, unison-2.27, -server)
Uncaught exception Unix.Unix_error(20, "create_process", "ssh")

C'est un peu mieux, mais ce n'est toujours pas ça.

Passer différemment les paramètres à ssh

Tout ça sent à plein nez un problème de paramètres passés n'importe comment à ssh.
Nous savons comment nous voulons les passer (ligne de commande ci-dessus).
Unison est un programme bien fait, il permet de spécifier la commande ssh.
Il suffit d'utiliser sshcmd dans le profil.
Nous ajoutons donc:
- sshcmd = c:\msys\home\jseb\.unison\sshcmd.bat

Bien sûr, il faut un fichier sshcmd qui va contenir la commande ssh correctement paramétrée.
- A des fins de test, nous utilisons une commande qui va afficher les paramètres passés.

sshcmd.bat contient donc pour l'instant:
- @echo 0=%0 1=%1 2=%2 3=%3 4=%4 5=%5 6=%6 7=%7 8=%8 9=%9
- Notez l'arobase au début de la commande, c'est obligatoire.

Plus qu'à relancer Unison pour voir ce que cela donne.


$ ./Unison-2.27.57\ Text.exe 
Contacting server...
Fatal error: Received unexpected header from the server:
 expected "Unison 2.27\n" but received "0=c:\\msys\\home\\jseb\.unison\\sshcmd.bat 1=-l 2=jseb 3=192.168.1.1 4=-e 5=none 6=unison-2.27 7=-server 8= 9=\013\n", which differs at "0".

Les paramètres importants sont donc le second et le troisième (le nom d'utilisateur et l'ip), ainsi que le sixième et le septième (commande

Nous pouvons tout de suite modifier la commande ssh.
sshcmd.bat devient donc:
- @c:\msys\bin\ssh -l %2 %3 -e none %6 %7

Et alors ? Rien à tirer de openssh

Quand on relance Unison, la connexion reste en attente et ssh tourne dans le vide sur le poste client.

Il y a bien du dialogue avec le serveur, une écoute avec tcpdump le montre.

Il s'agit d'un problème d'attente du mot de passe ssh, qui n'est pas transmis sur le shell msys par ssh.

Nous pourrions tenter des générer une clé privé et de nous connecter sans mot de passe, mais je trouve cette solution dangereuse.
- Vous n'êtes pas obligé d'être d'accord. Vous pourriez stocker votre clé privé sur une clé USB qui ne vous quitterait pas, résolvant les problèmes de stockage de la clé sur un ordinateur en accès libre.

Pour ma part, j'ai une approche différente : utiliser plink en lieu et place de openssh.

Attention aux essais avec openssh et unison. Quand ssh reste dans un état bloqué, un ctrl+c rend la main au shell, mais ssh reste en mémoire. Pensez à le tuer avec le gestionnaire des tâches.

plink, mon sauveur

plink ?

plink est un utilitaire livré avec putty (un émulateur de terminal déja évoqué ci-dessus).
Son fonctionnement est analogue à la fonction ssh, il peut même servir pour des sessions interactives.

En avant avec plink

Pour l'utiliser, il suffit de modifier le fichier sshcmd.bat et d'adapter les paramètres.
- Voici le nouveau contenu du fichier:


REM fichier sshcmd.bat
REM %2 = nom d'utilisateur , %7 = mot de passe ssh
REM %3 = ip serveur, %8 = unison-2.27, %9 = -server

@C:\putty\plink -ssh -l %2 -pw %7 %3 %8 %9

-pw : ce paramètre sert à spécifier un mot de passe en ligne de commande, et à éviter le lock rencontré avec OpenSSH.

Il faut préciser que la commande ssh aura des arguments, on lance donc Unison avec ces paramètres:
- ./"Unison-2.27.57 Text.exe" -sshargs "-pw mot_de_passe"

Si vous rencontrez des problèmes, vous pouvez relancer la commande ci-dessus en debug verbose.
- ./"Unison-2.27.57 Text.exe" -sshargs "-pw mot_de_passe" -debug verbose
- Il s'agira probablement d'un problème d'ordre de paramètres (vérifiez bien la chaine de connexion ssh).

Bon et cette interface ?

L'interface texte est pratique, mais l'interface GTK est encore plus pratique.
- Oui je sais. clic clic clic. Bon. Personne n'est parfait.

Si vous avez la lib GTK installée, passer à l'interface graphique de Unison ne devrait pas poser trop de problèmes.

Il suffit de préciser son path dans le script d'invocation de Unison.

Voici un exemple de script, que j'ai appellé unison, et que j'ai placé dans le /bin de msys.


#!/bin/sh
#nom de ce script: /bin/unison

stty -echo
echo -n "entrez votre mot de passe: "
read p
stty echo

#echo $PATH
"$unison_gtk" -sshargs "-pw $p"

Vous remarquerez qu'on passe le mot de passe dans une variable, après l'avoir demandé au lancement.
- L'écho local du clavier est bloqué pendant la saisie, au cas où un malfaisant vous regarderait taper.
- Un script plus complet (pour ceux qui comme moi n'ont pas GTK dans le PATH) est proposé à la fin de cet article.

Synchro : ok

A ce stade, vous êtes normalement un codeur heureux.

Terminé les fichiers qui se promènent en clair sur le réseau.

Et pour ceux qui n'aiment ni lire, ni comprendre, voici le résumé du résumé.

Le profil

Il se trouve dans ~/.unison/votre_profil_unison.prf
- C'est ici qu'on précise le nom de l'exécutable Unison côté serveur, ainsi que la commande de remplacement ssh.
- Par défaut, Unison utilise le profil nommé default.prf


# Unison preferences file
servercmd = unison-2.27
sshcmd = c:\msys\home\jseb\.unison\sshcmd.bat@@
root = c:\msys\home\jseb\coding
root = ssh://jseb@192.168.1.1//home/jseb/coding

La commande de remplacement ssh

Ce batch MS-DOS est invoqué par Unison, qui utilise le contenu du paramètre sshcmd, défini dans le profil.
- N'oubliez pas l'arobase avant la commande.


@C:\putty\plink -ssh -l %2 -pw %7 %3 %8 %9

Script de lancement (avec support GTK)

Placez le dans votre path, ou dans /bin, il s'y trouvera fort bien.


#!/bin/sh
#nom de ce script: /bin/unison

stty -echo
echo -n "entrez votre mot de passe: "
read p
stty echo

#attention , pas d'espace autour de '=' dans une affectation!
unison_gtk="/c/Unison-2.27.57/Unison-2.27.57 Gtk+.exe"
lib_gtk="/c/Program Files/Fichiers communs/GTK/2.0/bin/"
PATH="$PATH":"$lib_gtk"

#les gens qui ont une espace dans leur mot de passe protègeront la variable $p :
# -sshargs "-pw \"$p\""
# Merci Fred pour la remarque.
"$unison_gtk" -sshargs "-pw $p"

Du neuf sans œufs

Jean-Seb — Sat, 03 Oct 2009 11:41:00 +0200

Un gâteau ?
Oui, mais celui-ci, il a quelque chose de plus en moins.

Le gâteau sans œufs

Certaines personnes sont allergiques aux œufs, les malheureux.
Ce n'est pas mon cas, mais je n'en avais plus à portée de main.
Une recherche internet, et une correction des valeurs saupoudrée de personnalisation... voici le résultat.

Évoquons les ingrédients.

Ingrédients (pour 4 à 6 personnes) :

200 g de farine
1 pincée de sel
150 g de sucre en poudre
150 g de chocolat en morceaux
120 g de beurre
20 cl de lait
1 sachet de levure dite chimique (en fait, c'est du bicarbonate)
1 boite de fruits en conserve

Saladier, mélanger, und so weiter

Dans un saladier, verser la farine, le sel, la levure et le sucre. Mélanger.

Faire fondre le beurre et le chocolat dans une casserole, avec un peu d'eau au fond (pour éviter que cela n'attache).

Ajouter le lait dans la casserole, bien mélanger.
- Ne vous inquiétez pas, le mélange n'est pas très miscible mais ça ne porte pas à conséquences.

Ajouter le contenu de la casserole en trois fois dans le saladier. Mélanger à chaque étape.
- A la dernière étape, vous devez obtenir un mélange lisse et onctueux.
- La spirale tracée par la cuillère dans la pâte doit évoquer le nombre d'or. Continuez à mélanger si ce n'est pas le cas.

Badigeonnez un plat en pyrex avec de l'huile (un filet suffit).

Versez dans le plat en pyrex le contenu du saladier.

Placez les fruits en conserve soigneusement égouttés dans le plat.
- N'hésitez pas à appuyer un peu sur ceux-ci, pour faciliter l'immersion (noyé dans une mer de chocolat ! Quel destin à la fois horrible et tentant !)

Bon ça y est ? On peut mettre au four ?

Mettre dans le four préchauffé à 200°.

Cuisson: 30mn à 200°, puis éventuellement 5mn à 180°.
- Vérifiez la cuisson à 30mn!

Vous pouvez vérifier la cuisson en enfoncant la lame d'un couteau au centre du gâteau.
- Elle doit ressortir sans emporter de la pate avec elle.

La poule qui a fait l'œuf ou l'œuf qui fit la poule ?

Je remercie mes collègues qui ont bien voulu servir de cobayes.
- Et qui ont aimé ça (c'est pour ça que je les remercie).

OSS4 : Alsa ne répond plus.

Jean-Seb — Thu, 17 Sep 2009 20:17:00 +0200

Plus fort que OSS-117 et Alsa réunis.
Voici ... OSS4 !
Et dire qu'on l'enterrait déja dans l'indifférence générale.

Alsa prête le flanc à la critique

OSS4 est le dernier avatar de la lignée presque éteinte OSS. Comme quoi, tout arrive.
Alsa rêgne en maître incontesté sur nos cartes sons depuis quelques années.
Pourquoi remplacer Alsa par OSS4 ?
- Alsa n'est pas exempt de bugs.
- Je dirais même plus, mon cher Dupont, de bugs Alsa n'est pas exempt.
- De curieux comportements après une hibernation (plantage de la couche son pour moi).
- D'autres comportements non moins étranges lors d'un shutdown. (cf bugs.gentoo.org)
Bref, Alsa peut vous laisser comme deux ronds de flan.
- Il est temps de passer à la concurrence. Cela stimule l'innovation et l'inventivité, comme disent les adeptes de la concurrence (chez les autres).

Installation

Tout ce qui suit est pour Gentoo.
Vous aurez peut être besoin d'installer mercurial (layman vous le signalera, si c'est le cas)

Overlay

Il faut passer par un overlay Gentoo.
La question des overlays a déja été discutée sur ce blog
- J'en parlais justement ici

Pour les décideurs pressés, voici le résumé du résumé:
- installer: layman -a oss-overlay
- juste pour voir: ls /usr/local/portage/layman/oss-overlay/

package.keywords

C'est encore assez expérimental, donc:
- media-sound/oss ~amd64 (ou ~x86 ou ...)

Emerge

Rien de spécial
- emerge -va oss

Kernel

Enlevez les références à Alsa dans le noyau.
- Ou au minimum, le support Alsa devra être sous forme de modules.
- J'ai tout viré.
Pas la peine d'activer OSS dans le kernel, cela ne sert à rien.

make.conf

ajouter à USE oss et oss4, laisser alsa (on n'est pas des sauvages, et on ne sait jamais).
- Voici mon USE:
- USE="-qt3 -qt4 -gnome -kde -ipv6 gtk unicode opengl jpeg truetype type1 oss oss4 alsa"

Lancer OSS4

Initialiser

/etc/init.d/oss start
- C'est super long. Vous pouvez faire un modprobe à la main également.

N'oubliez pas de baisser le son, par défaut, ça explose les enceintes.


~$ ossmix vol 15
Value of mixer control vol set to 15.0:15.0
~$ ossmix pcm.main 15
Value of mixer control pcm.main set to 15.0

Tester

osstest
- Vous devez entendre un piano à droite, à gauche, en stéréo.
- Voire ailleurs si vous avez un système 5.1
- Moi, j'en suis resté là en tant que salaud de pauvre.

Utilitaires amusants

ossxmix
- Un mixer très complet. Enfin complet. Enfin y'a plein de boutons qui doivent servir à quelque chose.

Et maintenant ?

Haha! Vous croyiez vous en tirer à si bon compte ?
- Il faut recompiler maintenant!

Soit emerge -DuvaN world (bon courage)

Soit y aller petit à petit: dosbox, sdl, mplayer, mpd, xine, audacious, wine ...
- Il ne faudra pas oublier de modifier les fichiers de configuration des programmes recompilés pour utiliser OSS si vous compilez avec le support OSS et Alsa.
- Certains programmes feront automatiquement le bon choix, d'autres auront besoin d'être un peu aidés.
- Comment savoir ? Lancez le programme, et si il n'y a pas de son, c'est qu'il a besoin d'être un peu aidé. Muhahhaaahaa!

Bon d'accord, arrêtez les tomates. Je vous aide un peu avec mpd.
- Si après compilation avec le double support alsa et oss, vous obtenez cette erreur au lancement:


jseb # /etc/init.d/mpd start
 * Loading ALSA modules ...
 *   Could not detect custom ALSA settings.  Loading all detected alsa drivers.
 *   Unable to find any ALSA drivers. Have you compiled alsa-drivers correctly?
 *   ERROR: Failed to load necessary drivers                              [ ok ]
 * ALSA failed to load.                                                   [ !! ]
 * ERROR:  cannot start mpd as alsasound could not start

Dans ce cas, éditez le fichier suivant /etc/init.d/mpd
- Et enlevez la référence à alsasound à la ligne need
- Crade ? Of course. N'oubliez pas de remettre la référence si vous réinstallez Alsa.

OSS et l'hibernation

hibernation, le mot qui fait trembler tout linuxien qui se respecte.
- Comme on n'est pas sous Windows, ça ne fait pas partie du cahier des charges.

Pas de bol, OSS a un peu de mal à sortir du caisson cryogénique.
- Remarquez, Alsa, c'était pas tellement mieux.

La bonne nouvelle, c'est qu'un simple restart de la couche OSS suffit.
- /etc/init.d/mpd restart

La mauvaise nouvelle, c'est qu'avant, il faudra tuer tous les programmes qui dépendent de OSS.
- Oui, y compris gkrellm et son mixer magique.
- OSS étant sympa, il prévient des applications qui le gênent.


jseb # /etc/init.d/oss restart
 * Stopping OSS ...
Some applications are still using OSS - cannot unload

3311 gkrellm
5591 /usr/bin/mpd --no-create-db /home/jseb/.mpd/mpd.conf

Please stop these applications and run soundoff again
 * Failed to stop OSS                                                     [ !! ]

Si vous avez compilé le noyau avec CONFIG_MODULE_FORCE_UNLOAD, vous pouvez peut être procéder autrement...
- ... mais je ne vous ai rien dit!

Un peu de lecture pour finir

Mes années de fac m'ont appris de multiples choses, comme par exemple qu'il ne faut pas mettre les pieds en fac.
- J'ai également appris qu'une bonne bibliographie, ça vous pose son homme.
- Normalement, on colle des pages et des pages de bouquins poussiéreux que personne n'a lu.

Comme nous sommes entre gens de bonne compagnie, voici l'essentiel.
- la doc d'OSS4

N'hésitez pas à repasser, il y aura surement des mises à jour au fur et à mesure de mes découvertes.

Google Analytics, c'est chic

Jean-Seb — Mon, 03 Aug 2009 19:38:00 +0200

Voici venu le meilleur moment de l'année.
Je parle bien sûr du renouvellement du domaine finiderire.com.
Le renouvellement, tout le monde s'en moque. Mais ... il y a le bla-bla annuel !

Bilan de l'année passée et enseignements qu'il convient d'en tirer.

Quel magnifique titre à rallonge en guise d' introduction.
Avouez que vous adorez ça, le bla-bla, le futile, l' inutile, le mec qui se répand dans son blog.
Mais ceci n'est pas une tentative pour faire remonter mes stats.
- Les stats ? Elles étaient ... holala ... au moins à ça il y a trois mois.
- Crise financière ? Dégoût de Vim ? Sectateurs Emacs au travail de sape efficace ? Toujours est-il que les stats ont plus que chutées.

Ca bugge, c'est sûr!

Le module stats du blog Gandi étant à peu près aussi digne de confiance que les résultats d'une élection dans une république bananière, j'ai commencé par incriminer celui-ci.
C'est décidé, je passe à la roll's : Google Analytics !
Après installation de la chose, deux constatations:
- Wahh qu'est-ce que c'est précis !
- Tiens... les chiffres sont pratiquement les mêmes que ceux des stats pourries de Gandi.

L'analytique, c'est chic.

Les stats fournies par Google sont d'une précision confondante et terrifiante.
Pour tout dire, c'est tout juste si on n'a pas la marque du slip du visiteur.
Vous disposez bien sûr d'un droit d'accès et de rectification de vos données chez Google et muhahahaaa! Pardon excusez-moi, c'est nerveux.
Toujours est-il que les statistiques sont tellement détaillées que j'envisage de débarquer à l'improviste chez mon visiteur fidèle, une bouteille de champagne et quelques biscuits de Reims à la main.
Le seul problème, c'est qu'il faut que le javascript soit activé sur le navigateur du visiteur. Alors soyez sympas, faites pas comme moi, et activez l'exécution des scripts !

La voila, la triste vérité.

En vérité mes frères, je vous le dis: Google Analytics est si détaillé que l' épluchage des statistiques me prend tout mon temps disponible.
La mise à jour du blog va donc continuer son bonhomme de chemin, au gré de mes envies, de mes disponibilités, et de mon taux de motivation.

Tada et Pan (dans l'ordre, mais sans rapport).

Tada!

L'article sur Freeglut et cygwin va être intégré dans la documentation officielle du projet Freeglut, après traduction bien sûr.
- Voila des gens au goût raffiné.
- Freeglut est ici

Pan!

Par ailleurs, je vous en prie: cessez de remplir les commentaires avec des fécilications si élogieuses qu'elles en deviennent impubliables.
- Quand de plus, elles se trouvent associées à un site web sans aucun rapport, vous comprendrez que je tire à vue.
- Les vrais commentaires sont par contre les bienvenus.

Une Page de Python

Jean-Seb — Sat, 25 Jul 2009 13:13:00 +0200

Pour utiliser nativement des interfaces avec Python, il y a Tkinter.
Pour ceux qui n'aiment pas coder les GUI à la main, il reste les générateurs d'interface.
Ici, je parle de la mise en oeuvre de Page.

Revue de détail

La revue sera rapide, j'ai testé uniquement GuiBuilder et Page

GuiBuilder

Anciennement nommé SpecTcl.
+1 : il permet de générer des interfaces proportionnelles (le principal intêret de Tk).
-1 : ne semble plus maintenu, le code généré est assez horrible.
-1 : les sources ne semblent pas disponibles

IInstallation de Page

Prérequis

Comme d'habitude, je parle pour les possesseurs de Gentoo.

Il faut un Tk récent: au moins la version 8.5
- Attention, c'est une version test pour l'instant. Je n'ai pas eu de problèmes en l'installant, cependant.


# eix dev-lang/tk
[I] dev-lang/tk
     Available versions:  8.4.15-r1 8.4.18 8.4.18-r1 (~)8.4.19-r1 (~)8.5.7 {debug threads truetype}
     Installed versions:  8.5.7(20:24:53 24.07.2009)(truetype -debug -threads)

Ce qui au passage va vous coller un Tcl d'un niveau de version à peu près équivalent.

Si vous n'étiez pas à niveau pour Tk, n'oubliez pas de recompiler Python avec le flag tk

Il vous faudra également la lib pyttk
- Pour l'instant, disponible en version 0.3
- On la trouve ici
- Reprenez l'archive tgz, ça suffira.

Installation

Dépliez l'archive Page, obtenue sur le site officiel (url donnée plus haut).

Dépliez l'archive pyttk dans le répertoire racine Page.
- Vous devez obtenir un sous-répertoire pyttk-0.3 (selon votre version de ''pyttk', bien sûr)

Lancez le script configure de Page, qui va positionner quelques variables dans le script de lancement de Page.

Editez le script de lancement de Page.
- Ajoutez le chemin de pyttk, juste avant le exec
- export PYTHONPATH="$PYTHONPATH":"$PAGE_HOME"/pyttk-0.3/
- Cela permettra de tester le code Python au sein de Page.

Test avec code généré

Cela ne devrait pas vous poser de problèmes, il faut juste prendre garde à pyttk
Soit utiliser la variable globale python indiquant le chemin des modules:
- export PYTHONPATH = chemin/vers/pyttk/

Soit utliser sys.path dans votre script Python.
- sys.path donne l'emplacement des modules au script.


#à mettre au début du script Python
import sys
sys.path.insert (0, '/chemin/vers/pyttk/')

Attention : ce n'est pas une bonne idée que de modifier un fichier qui a été généré.
- Il faudra donc passer par un fichier main qui importera à son tour les fichiers générés.
- De toutes façons, vous devrez en passer par là pour écrire les fonctions de l'interface.

We thrash with all the rest

Et le reste ? demanda le jeune padahouane.
RTFM répondit Iota en se reprenant un pastis.

Glut alors!

Jean-Seb — Fri, 10 Jul 2009 00:18:00 +0200

Freeglut est une évolution open-source de Glut.
Sous Windows, on peut l'utiliser avec Cygwin.
Facile ? Oui, si on accepte de distribuer cygwin1.dll.
Et si on ne veut pas ? On lit cet article.
m.à.j 10/7/2009 : génération d'une librairie pour linker depuis la dll.
m.à.j 25/11/2009 : correction de la partie utilisation de la librairie.

Récupération des sources

Reprenez les sources de la version 2.6.0 qui intègre les changements récents.
Pour l'instant, il s'agit d'une RC (Release Candidate), mais la version finale ne saurait tarder.
L'utilisation de la 2.6 est préférable à la branche 2.4-stable, de nombreux bugs étant corrigés.
Vous trouverez les sources sur le site de Freeglut:
- Site freeglut

Objectifs et préparation

Objectifs

Nous allons créer une dll liée à Cygwin, et une bibliothèque statique indépendante
Nous créerons également une librairie dynamique, permettant de linker avec la dll.

Liste des fichiers générés

freeglut.dll : une dll classique pour le linkage dynamique.
libfreeglut.a : la bibliothèque statique. Le programme final est autonome (du moins pour OpenGL).
libfreeglutdll.a : la bibliothèque dynamique. Le programme final a besoin de freeglut.dll.

Préparation

Dépliez l'archive freeglut.
Allez dans le répertoire src (situé à la racine du répertoire Freeglut), et créez un sous-répertoire Gl
- Dans ce sous-répertoire, copiez les fichiers du répertoire include/Gl

Pourquoi faut-il créer un répertoire Gl pour la compilation ?
- C'était juste pour simplifier les choses lors de mes essais.
- Sinon vous pouvez créer directement les répertoires, et copier les fichiers comme indiqué au point installation (lire plus loin).

Faites un peu de ménage dans /lib :
- Effacez toutes les références à la glut, pour ne pas avoir de conflit au linkage.
- Cette étape est facultative, vous pouvez également choisir de ne faire le ménage qu' après une compilation réussie de Freeglut.
- Attention à ne pas effacer, dans un enthousiasme rédempteur, la bibliothèque glu32.lib (à ne pas confondre avec glut32.lib).

Compilation

Oubliez le triptyque ./configure , make , make install.
- Ca ne marche pas du tout avec Cygwin.

Voici un Makefile qui fera l'affaire:


#Makefile pour Freeglut 2.6.0-rc et Cygwin
#A placer dans le répertoire "src"

sources=$(wildcard *.c)
objs=$(sources:.c=.o)
libname=freeglut


CFLAGS=-O2 -DTARGET_HOST_MS_WINDOWS -DX_DISPLAY_MISSING -DFREEGLUT_STATIC -I./
LDFLAGS=-lopengl32 -lgdi32 -lwinmm

nocyg=-mno-cygwin -mwindows

all: $(objs)
        #construction dll liée à cygwin1.dll
        gcc $(nocyg) $(objs) -shared $(LDFLAGS) -o $(libname).dll
        nm $(libname).dll  | awk 'BEGIN { print "EXPORTS" } /T _glut/ {sub( /^.*T _/, "\t"); print}' > $(libname).def
        dlltool --dllname $(libname).dll --input-def $(libname).def --output-lib lib$(libname)dll.a

        #construction bibliothèque statique indépendante de cygwin
        ar cr lib$(libname).a $(objs)
        #pas forcément obligatoire (création d'un index pour accélérer les accès)
        ranlib lib$(libname).a

%.o: %.c
        gcc $(nocyg) -c $(CFLAGS) $<

clean:
        rm -f *.o $(libname).dll $(libname).def lib$(libname)dll.a lib$(libname).a

Quelques remarques sur le makefile

Ce makefile crée une dll, une bibliothèque statique (une archive, en d'autres termes) et la bibliothèque dynamique qui permettra l'utilisation de la dll.

Ne cherchez pas à stripper la bibliothèque statique! Vous ne pourriez plus compiler en statique.
- Par contre, vous pouvez stripper l'exécutable final obtenu lors de la compilation de votre application.

J'ai choisi d'appeller la dll et les bibliothèques par leurs vrais noms: freeglut.dll libfreeglutdll.a et libfreeglut.a.
- Le script configure recréait (pour des raisons de compatibilité avec l'ancienne bibliothèque Glut) glut.dll et libglut.a.
- Lors des mes essais, j'ai eu des conflits avec une authentique glut qui trainait dans mon /lib. J'ai décidé d'appeller les choses par leur nom, afin d'éviter les confusions.
- Rien ne vous empêche de renommer la dll, si vous avez besoin d'utiliser des programmes Glut que vous ne pouvez pas recompiler.

La bibliothèque dynamique est générée à partir de la dll.
- Par souci de concision, j'ai utilisé awk. Il génère le fichier d'exports utilisé par dlltool.
- La seule chose notable est la sélection des fonctions dont le nom commence par _glut, afin d'éviter d'inclure dans la librairie dynamique des fonctions sans rapport avec freeglut.
- ensuite, on utilise dlltool de façon très classique.


nm $(libname).dll  | awk 'BEGIN { print "EXPORTS" } /T _glut/ {sub( /^.*T _/, "\t"); print}' > $(libname).def
dlltool --dllname $(libname).dll --input-def $(libname).def --output-lib lib$(libname)dll.a

Installation

Copiez libfreeglut.a, libfreeglutdll.a dans le répertoire /lib de Cygwin.
Copiez freglut.dll dans le system32 de Windows (ce qui est pratique, mais pas propre!).
Copiez les fichiers headers de Freeglut (/include/gl) dans /usr/include/Gl de Cygwin.
Copiez les fichiers headers (toujours /include/gl) dans /usr/include/mingw/Gl : ceci sert aux compilations avec le flag -mno-cygwin, qui utilise alors les includes de mingw.
- Vous aurez éventuellement besoin d'écraser d'anciens fichiers include, correspondants à Glut, si vous l'avez installé avec Cygwin.

Utilisation de la librairie

Nous allons tester avec le programme shapes, présent dans progs/demos/shapes
- -mno-cygwin sert à forcer l'utilisation de Mingw sans la grosse dépendance cygwin1.dll.
- -mwindows sert uniquement à enlever l'horrible fenêtre shell (très utile pour la mise au point, par contre).
- -L. (notez le point après le L) : j'ai laissé libfreeglut.a, libfreeglutdll.a et freeglut.dll dans le répertoire de test, le temps des tests justement.

Compilation en librairie statique freeglut, sans cygwin

Toute l'astuce réside dans le define : -DFREEGLUT_STATIC
- Il sert à obtenir la bonne décoration des noms de fonctions dans les imports de la lib Freeglut.
- Vous pouvez essayer sans et prendre un éditeur hexa pour voir les différences dans l'objet.
attention à l'ordre des bibliothèques : -lfreeglut (statique) doit se trouver avant la déclaration des bibliothèques dynamiques.

gcc shapes.c -L. -lfreeglut -lopengl32 -lwinmm -lgdi32 -mno-cygwin -mwindows -DFREEGLUT_STATIC

Compilation avec dll freeglut, sans cygwin

Pour le define, même remarque que ci-dessus
L'ordre des bibliothèques n'a plus d'importance.

gcc shapes.c -L. -lopengl32 -lwinmm -lgdi32 ./freeglut.dll -mno-cygwin -DFREEGLUT_STATIC
- On précise le chemin de la dll, ainsi que son extension (./freeglut.dll)
- Le chemin de la dll (si la dll n'est pas dans le path) doit être précisé, car le flag -L ne la concerne plus.

Compilation avec dll freeglut, avec Cygwin

Cet exemple est donné uniquement pour référence, le thème de ce billet étant de se débarrasser de Cygwin.
- Disons que ça peut servir pendant la mise au point (et encore).

gcc shapes.c -L. -lopengl32 -lwinmm -lgdi32 ./freeglut.dll

Où sont les dooooocs ?

Freeglut est livré avec sa documentation, plus très à jour.
- Il semble qu'il y ait un problème avec la doc Glut originale. Non seulement elle ne correspond pas forcément au fonctionnement de Freeglut, mais de plus, son auteur (Mark Kilgard) l'a copyrighté. Sa distribution est donc difficile.

Jocelyn Fréchot a entrepris une mise à niveau des docs pour la version 2.6.0. On peut les trouver sur son site pour l'instant:
- Docs Freeglut 2.6.0rc

Quelque chose a survécu ...

J'ai également testé la recompilation des démos de la lib Glut originelle (paix à ses cendres).
- Rien de particulier à signaler.

Merci à tous les mainteneurs courageux de Freeglut, qu'on croyait mort, mais qui bouge encore.

Et un fichier exe pour les gouverner tous!

Jean-Seb — Tue, 09 Jun 2009 00:07:00 +0200

La question du fichier ressources regroupant toutes les données est récurrente.
Les solutions sont multiples et ont fait couler beaucoup d'encre.
Voici une solution sans développement, ce qui est toujours intéressant.

Inclure vos données dans un seul fichier

Principe

Lorsque votre programme contient des données séparées, l'amour de l'esthétisme et un légitime souci d'exclusivité peuvent conduire à distribuer un minimum de fichiers.

Fichier ressources

Une solution courante est de distribuer un fichier exécutable, et un fichier ressources qui contiendra l'ensemble des données.
Le fichier ressources peut être une simple concaténation des données, une archive ou une base de données.
- La concaténation de données nécessite de maintenir un index, et souvent de recréer l'ensemble du fichier à la moindre modification. C'est par contre la plus rapide à l'exécution.
- L' utilisation d'un fichier ressources est également rapide (moins les temps de décompression éventuelle), mais aura au moins une dépendance (si vous projetez d'écrire un nouveau packer/depacker... c'est une mauvaise idée). Par contre, vous aurez des possibilités proches d'un système de fichier pour la gestion de votre fichier ressources.
- L' utilisation d'une base de données est à réserver aux gros projets et sort largement du cadre de ce billet.

Les codeurs n'ont pas froid aux oreilles

On peut faire encore plus fort, et tout coller dans le même fichier.
Dans ce cas, on n'a plus trop le choix, et il s'agit bien sûr de l'exécutable.

Choix retenu

Ici nous allons utiliser le fichier exe pour stocker nos données.
- avantages : un seul fichier executable à distribuer. On ne risque pas de se tromper quand on distribue les mises à jour.
- inconvénients : il faut tout redistribuer à chaque modification de l'exécutable. Les temps de linkage sont allongés.

Options techniques

xxd : solution la plus portable

xxd -i data.dat : génère un dump de data.dat au format C.
Nous n'étudierons pas cette possibilité.
En deux mots, elle consiste à définir les datas dans le code source, et à compiler celui-ci.
Son inconvénient principal est la lourdeur des codes sources générés.

Injection des données dans l'exécutable

Utilisation de objdump et objcopy (ou ld en remplacement de objcopy).
Nous allons utiliser les fichiers suivants:
- data.txt : données à insérer dans l'exécutable (ici, ça sera du texte).
- main.c : le source C de l'exécutable.

objcopy, objdump

objcopy

Il s'agit tout d'abord de transformer le fichier data.txt en un fichier objet.

Formats d'entrée et de sortie de objcopy
- objcopy --info : informations sur les formats d'entrée/sortie pour objcopy.

Linux et Windows:
- objcopy -I binary -O elf32-i386 --binary-architecture i386 data.txt data.o

Explication des flags
- -I : (attention il s'agit d'un i majuscule) input target
- -O : output target
- rappel : objcopy --info donne une liste des input/output potentiels.

Parenthèse sur ld

Une manipulation équivalente à la commande objcopy ci-dessus:
- ld -r -b binary data.txt -o data.o data.txt

Explication des flags
- -r : link incrémental. Le fichier généré en sortie par ld pourra reservir comme entrée à ld.
- -b : input format (et non pas binary, je sais, le raccourci est tentant).

objdump

Permet d'obtenir toutes sortes d'informations sur vos objets.
Nous l'utilisons pour avoir le nom des symboles du fichier objet.

objdump -s data.o
- donne le format du fichier , et le contenu des sections

objdump -x data.o
- montre tous les headers.

Pour avoir uniquement la table des symboles, utiliser le flag -t


$ objdump.exe -t data.o

data.o:     file format pe-i386

SYMBOL TABLE:
[  0](sec  1)(fl 0x00)(ty   0)(scl   2) (nx 0) 0x00000000 _binary_data_txt_start
[  1](sec -1)(fl 0x00)(ty   0)(scl   2) (nx 0) 0x0000001c _binary_data_txt_size
[  2](sec  1)(fl 0x00)(ty   0)(scl   2) (nx 0) 0x0000001c _binary_data_txt_end

plus court, même chose:


$ nm data.o
0000001c D _binary_data_txt_end
0000001c A _binary_data_txt_size
00000000 D _binary_data_txt_start

Utilisation des symboles dans le source

Maintenant que nous avons la liste des symboles, nous pouvons y faire référence dans le source en C.
Les symboles seront traités comme de vulgaires buffers.
Ils sont faciles à utiliser, voici un source d'exemple:

/* main.c */

#include <stdio.h>

extern int binary_data_txt_end;
extern int binary_data_txt_size;
extern int binary_data_txt_start;

int main(void)
{
  int size = (int)&binary_data_txt_size;
  char *data = (char *)&binary_data_txt_start;
  char *end = (char *)&binary_data_txt_end;
    
  printf("taille: %d\n", size);
  printf("buffer: %s", data);
  printf("start: 0x%p ; end: 0x%p\n",data,end);

  return 0;
}

Juste une petite remarque pour Windows.
* Sous Windows, la décoration des noms n'est pas la même que sous Unix.
- Par exemple: _extern int binary_stdout_txt_start deviendra extern int binary_stdout_txt_start
- Il faut enlever le premier underscore pour chaque symbole.

Et qu'est-ce qu'on fait maintenant ?

Il faut simplement compiler le source, et ajouter au linkage notre fichier précédemment pré-linké.
Cela va plus vite à écrire qu'à expliquer:
- gcc -W -Wall main.c data.o

Je vous laisse la joie d'exécuter tout ça, et vous épargne le screenshot.

Docteur Hacker et Monsieur Lamer

Bien entendu, la contre-mesure est assez évidente pour qui a compris tout ce qui précède.
Je ne doute pas que Docteur Hacker, qui me lit (et je j'en suis fort honoré) a déja deviné.
Dans le cas où Monsieur Lamer me lirait également, je n'en dirai pas plus.

Toc toc token

Jean-Seb — Fri, 01 May 2009 20:38:00 +0200

Un billet sur la fonction strtok...
... avec en prime une petite devinette.

man strtok

définition très personnelle du token

La première fois que l'on m'a parlé du token, je me suis bien demandé ce que c'était.

Une définition courte et lapidaire serait:
- un token est un élément indivisible.

Je tente donc de préciser quelque peu:
- un token est un élément atomique d'un surensemble.
- par exemple: dans une phrase, on admet généralement que le mot est l'élément atomique (on ne descend pas au caractère).
- la notion de token suppose celle de séparateur, pour différencier les token du surensemble.

strtok dans la bibliothèque standard

strtok : fonction de la bibliothèque string.h. Elle extrait des token d'une chaine.
- strtok (char *chaine, char *separateurs)

une invocation singulière
- le premier appel de strtok doit comporter un pointeur sur la chaine à découper en token.
- les appels suivant à strtok doivent comporter un pointeur NULL en lieu et place de la chaine à découper.


char *chaine="ceci;est;une;chaine'';
char *token = strtok(chaine,";"); //premier appel
while (token = strtok(NULL,";"); //appels suivant

La devinette

Maintenant que vous savez tout sur les token, voici la devinette.

Ce source provoque un core-dump sous Linux.


#include <stdio.h>
#include <string.h>

char * get_token(char *string, char *sep)
{
  static char *token = 0;
  if (token) string=NULL;
  token = strtok (string, "sep");

  return token;
}


int main(void)
{
  char *token = 0;
  while (token=get_token("ceci;est;une;chaine",";")) {
    printf("token = %s\n",token);
  }

  return 0;
}

strace est ton ami

chaine littérale et strtok

Tout réside dans l'appel de la fonction get_token.
- Le paramètre passé à cette fonction est une chaine définie à la compilation (une chaine littérale).
- Cette chaine est donc placée dans un segment read-only.

Sans même débugger, on peut le vérifier avec un strace qui indiquera la violation mémoire lors de l'appel à strtok :

gcc -Wall -W token_test.c && strace ./a.out
- mmap2(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0xb7dde000

résolution

Il ne faut donc jamais passer de chaines en dur dans votre code à strtok.
- Il faut soit recopier la chaine dans la fonction d'arrivée, soit passer un pointeur sur un buffer contenant votre chaine.

Attention! Passer un pointeur sur une chaine définie à la compilation provoquera également un plantage.
- char *chaine="ceci;est;une;chaine"; : core-dump
- char chaine[]="ceci;est;une;chaine"; : ok , car ce n'est pas une chaine littérale, mais une liste d'initialisation de tableau ( (c) Fred. J. )

Encore une chose: strtok modifie la chaine source passée en paramètre. En voici la preuve:


#include <stdio.h>
#include <string.h>

int main(void)
{
  char chaine[]="ma;chaine";

  printf("origine: %s\n",chaine);
  strtok(chaine,";");
  for (int i=0; i<sizeof(chaine); i++) 
    printf("[0x%X]%c ",chaine[i],chaine[i]);

  return 0;
}

Ce programme donne en sortie:


/tmp$ ./a.out 
origine: ma;chaine
[0x6D]m [0x61]a [0x0] [0x63]c [0x68]h [0x61]a [0x69]i [0x6E]n [0x65]e [0x0]

Notez que le point-virgule a été remplacé par la valeur zéro, ce qui risque de donner des résultats assez comiques si vous réutilisez le buffer par la suite.

Et tok.

A noter qu'aux dernières nouvelles, MS-Windows ne passait pas ses chaines dans un segment en lecture seule.
- Encore un bon exemple des pièges qui attendent les courageux adeptes du multiplateforme.
- On peut certe remplacer courageux par les fous qui font tout en C.

La libc, c'est la bonne humeur au quotidien. Alors mangez-en, et parlez-en à vos amis.

Arrêtez vos cloneries.

Jean-Seb — Thu, 02 Apr 2009 18:38:00 +0200

Vous changez de disque dur, et ne voulez pas réinstaller votre OS
Exigence ô combien légitime!
Avec Linux, c'est simple, il suffit de tout recopier d'un disque à l'autre.
Mais avec MS-Windows ... rien n'est jamais simple.

Terrifiant comme un ghost, beau comme un Adonis.

Le problème est simple : recopier un MS-Windows d'un disque vers un autre, en gardant les réglages d'origine.

La plupart des utilisateurs font appel pour cela à Ghost ou à Adonis True Image.
- Ghost pose problème lors du démarrage de MS-Window, au login : tous les comptes sont désactivés. Pas de message d'erreur, ni de demande de réactivation, on ne peut simplement plus se logger.
- Adonis semble mieux fonctionner, mais c'est également un logiciel payant.

Heureusement, il reste dd , le meilleur ami de vos disques durs.

Merci à Frédéric Jolliton qui m'a incité à utiliser dd, et qui m'a expliqué l'astuce du mode LBA.

Avant de passer aux choses sérieuses, veuillez lire le disclaimer de rigueur, qui suit.

Comme d'habituuudeuhh...

Rien n'est garanti.

Vous opérez en toute connaissance de cause.

Vous avez lu le manuel, vous l'avez compris, et vous assumez les conséquences des manipulations.

Les plaintes concernant les pertes de données, consécutives à de mauvaises manipulations, ne recueilleront qu'un rire moqueur.

Dédé à la rescousse

Le principe est simple:
- Nous allons profiter du fait que les problèmes de géométrie de disques ont disparus depuis l'arrivée du LBA.
- Avec le LBA, les disques sont vus comme une simple succession de secteurs, ce qui convient très bien à dd.

Le disque dur de destination peut avoir une taille supérieure ou égale au disque source.
- Cependant, il est préférable que la partition MS-Windows à cloner corresponde physiquement au premier secteur du disque.
- C'est le cas si votre partition d'installation correspond à la première partition physique du disque dur.
- La manipulation est faisable si MS-Windows est intallé sur la 6ème partition logique de la 4ème partition étendue. Il faudra copier tout ce qui se trouve auparavant, et éventuellement pas la suite, utiliser un utilitaire de redimensionnement de disque.

Pour l'exemple qui suit, nous nous plaçons dans le cas le plus courant:
- MS-Windows est installé sur la première partition physique du disque.

L'exemple que nous attendions tous.

Structure du disque source

J'ai coupé un peu la sortie du fdisk pour garder ce qui est intéressant

#~ fdisk -l /dev/sda

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/hda1   *           1        3851     8192984    c  W95 FAT32 (LBA)
/dev/hda2            3852      114781   236003575    f  W95 Etendu (LBA)
/dev/hda5            3852       17623    29299911+   b  W95 FAT32
/dev/hda6           17624      114539   206188771+   7  HPFS/NTFS

Première étape: copie brute avec dd

Nous voulons donc copier la partition primaire numéro un du disque sda vers sdb.

Nous utilisons dd, et nous faisons fi des notions de partitions. Ici, nous n'allons copier que des secteurs.
- la MBR sera donc bien sûr copiée au passage, et le disque restera parfaitement bootable avec son menu d'origine.

Pour copier les 9 premiers gigas du disque sda, vers le disque sdb:
- dd if=/dev/sda of=/dev/sdb bs=1k count=8500

Seconde étape: fignolage avec fdisk

La première partition physique est copiée entièrement (si vous avez bien calculé la taille).
- Mais dd ne s'est pas arrêté à la fin de la première partition physique, et a commencé à vous ramener le reste.
- Nous allons utiliser le fdisk de Linux pour corriger cela.

Attention : ne pas rebooter sous MS-Windows avant d'avoir procédé à la correction.
- Si à ce stade vous utilisez un utilitaire MS-Windows (tel que diskmgmt.msc) pour manipuler les partitions, vous allez fusiller votre disque (pas physiquement, rassurez-vous), et vous serez bon pour recommencer depuis le début.

fdisk version Linux, donc:
- Virez les parititions surnuméraires.
- Recréez les.
- Eventuellement, formatez les nouvelles partitions (mais vous pourrez le faire sans risque depuis MS-Windows).

Reboot

Il ne vous reste plus qu'à rebooter sur votre nouveau disque, et achever la copie des données de l'ancien disque sur celui-ci
- Seule la partition système nécessite d'être copiée avec dd.

A force de beurrer des tartines (chachacha!)

C'est tellement simple en fait que je me demande si ça valait le coup d'en faire une telle tartine.

Je vous ai quand même épargné les screenshots du shell, contrairement à une certaine presse Linux.

Du pain et ... c'est tout.

Jean-Seb — Tue, 10 Mar 2009 18:52:00 +0100

Du pain et des jeux ?
Ah, mais nous sommes sous Linux.
Il n'y a pas de jeux.
MàJ 24 mars 2009 : ajustement proportions, plus astuce gonflante.

C'est dans la STL ?

Une recette de cuisine! Enfin!
Il est vrai que ce n'est pas le thême de ce blog.
Aujourd'hui, nous faisons notre pain.

Ingrédients

10 doigts et deux avant-bras qui n'ont pas peur.

450 g de farine (j'ai pris une marque distributeur).
1 sachet de levure de boulanger (8 g).
1 cuillère de sel (rase).
24 cl d'eau pure du robinet (2 verres à moutarde).
1 pincée de sucre.
Du papier cuisson.

C'est parti.

Préparation de la levure

Versez tout de suite la levure dans un verre d'eau tempérée (12 cl environ).
Ajoutez dans le verre une pincée de sucre.
Remuez légèrement et laissez reposer le temps de préparer le reste.

Préparation de la farine

Versez 450 g de farine dans un plat.
Ajoutez la cuillère rase de sel.
Remuez avec une spatule pour mélanger le sel à la farine.

NB : si il fait moins de 20 degrés chez vous, allumez votre four à la température la plus basse.

Partie pénible

Ajoutez le verre de levure diluée à la farine.
Sans lui laissez le temps de se reprendre, ajoutez tout de suite un autre verre d'eau.
Mélangez le tout avec une spatule.
Dès que c'est vaguement mélangé, plongez vos mains pleines de doigts et pétrissez.
- Si de la farine ne veut pas s'incorporer au mélange et reste au fond du plat, enlevez la pate, et tapissez le fond d'un peu d'eau. Remettez ensuite la pate et incorporez.
- Vous pouvez arrêter de pétrir dès que la pate ne vous colle plus au main (il ne faut pas non plus que ce soit trop friable, si c'est le cas, ajoutez quelques centilitres d'eau). Ceci prend (selon la quantité d'eau) de 5mn à 25mn. D'où l'intêret de ne pas trop mettre d'eau et d'en rajouter si besoin est.

Premier arrêt

Couvrez le plat, et laissez reposer au moins une heure.
Si il fait froid chez vous, coupez le four préchauffé au minimum et placez le plat à l'intérieur.
Quelques minutes avant de passer au second pétrissage, préparez votre grille de cuisson en étalant dessus du papier cuisson, légèrement fariné.

Repétrissage et gonflage magique

Une fois le papier cuisson disposé et fariné, il faut pétrir à nouveau la pate.
Dès qu'elle a un bel aspect lisse et pas collant, faites en une boule.
Centrez cette boule sur votre papier cuisson, et saupoudrez la légèrement de farine.
Couvrez cette boule d' un saladier en plastique.
- J'utilise le saladier qui a servi à la préparation (pas de vaisselle inutile), mais tout récipient de taille convenable suffira.
- Cette astuce permet de ne plus avoir à manipuler le pain, et de le passer directement au four une fois la seconde levée achevée.

Second arrêt

Laissez reposer 1h30.

Mise au four

Retirez le saladier en plastique, et mettez la grille au four, préchauffé à 180°.
Cuisson: 210° pendant 35 minutes (surveillez la cuisson à partir de 30 minutes).

Et c'est tout

Une fois cuit, laissez refroidir un peu.
Prévoyez au moins 3/4h avant dégustation.
Même si vous êtes pressé, attendez 15mn avant de couper votre pain. Plus il est chaud, plus il est dur.

Economie appréciable

Si vous avez un grand four, vous pouvez préparer deux pains afin de rentabiliser les 40 minutes d'electricité nécessaires à la cuisson.

La mort du petit commerce.

Terminé les excursions matinales dans une aube blême, à la recherche d'une improbable baguette.
- Vous allez pouvoir coder toute la nuit sans arrière pensée, et profiter d'un pain excellent.

Vu que le prix du pain semble indexé sur un matériau rare qui augmenterait sans cesse, de notables économies sont à la clé.
- Plus besoin d'aller vous faire ratisser chez le boulanger poujadiste du coin.

Et il est bon au moins ce pain ?
- Admirez la belle tenue. N'a-t-il pas l'air appétissant ?

GCC passe la seconde

Jean-Seb — Sun, 22 Feb 2009 22:27:00 +0100

Insupportable attente des compilations !
Le quad-core refroidi à l'azote tire la langue. Son remplacement est envisagé.
Avant de courir à mon-galet, lisez ce qui suit.

Vroum ?

Quelques secondes de compilation ? C'est toujours trop long.

Nous avons déja vu comment utiliser un cache de compilation avec Gentoo, voici quelques astuces supplémentaires.

La situation de départ est celle-ci:

~$ time g++ test.cpp -lIrrlicht -lpng -ljpeg -lGL -lXv -lXxf86vm -I/usr/include/irrlicht 

real    0m1.513s
user    0m1.298s
sys     0m0.204s

Les gens attentifs auront remarqué que la causerie de ce jour va utiliser Irrlicht en guise d'exemple.
- Irrlicht est un moteur 3D très sympathique, qui charge fortement le processeur à la compilation.
- Les principes énoncés sont bien sûr universels (c'est beau ce que je raconte, on croirait du Zéro-Nain Informatique).

Au menu:
- Précompilation des entêtes.
- Utilisation de librairies dynamiques, par opposition à la compilation statique.

Quelques précisions sur les libs

Rappel:
- libIrrlicht.a : lib statique , liée à la compilation (les objets de la lib dont les symboles sont référencés dans le code seront intégrés à l'exécutable)
- libIrrlicht.so : lib dynamique (shared object) , liée à l'exécution (le code est externe à l'exécutable, équivalent des DLLs de MS-Windows)

Par défaut, si GCC trouve à la fois une librairie statique et une librairie dynamique du même nom, il choisira la librairie dynamique.
- On peut forcer l'utilisation de la librairie statique avec -static

Ajouter temporairement un chemin de recherche pour les librairies dynamiques:
- utiliser la variable d'environnement du shell : LD_LIBRARY_PATH
- pour les changements permanents : man ldconfig

Pour les tests sur une machine donnée, on peut se simplifier la vie en utilisant le flag -rpath .
- ce flag sert à spécifier en dur dans l'exécutable le chemin de recherche des librairies dynamiques.
- ceci n'a aucune influence sur le temps de linkage.
- g++ test.cpp -lIrrlicht -lpng -ljpeg -lGL -lXv -lXxf86vm -I/usr/include/irrlicht -L"$HOME"/sources/irrlicht-1.5/lib/Linux/ -Wl,-rpath="$HOME"/sources/irrlicht-1.5/lib/Linux/

Préparation du moteur

Par défaut, Irrlicht est compilé en statique.
- c'est à dire, une simple archive qui sera intégrée dans l'exécutable à la compilation.
- c'est à dire également, quelques megaoctets de choses inutiles pour le développement.
- pour en savoir plus sur la préparation d'une bibliothèque statique: man ar

Bien sûr, tout ceci est surtout valable pour le développement.
- Pour la distribution, je vous conseille de repasser en statique, afin d'être sûr de la version distribuée.

Aller dans les sources de Irrlicht
- make sharedlib

Par défaut, Irrlicht est construit avec les symboles de debug.
- Il peut être utile de ne pas les avoir (on ne débuggera pas forcément tout le temps).

Aller dans le répertoire libs.
- Vous devez trouver un fichier de ce type: libIrrlicht.so.1.5 (ou un autre numéro de version).
- mv libIrrlicht.so.1.5 libIrrlicht_debug.so.1.5

Retourner dans le répertoire source de Irrlicht
- make clean
- make NDEBUG=1 sharedlib

Ne pas oublier de créer les liens
- ln -s libIrrlicht_debug.so.1.5 libIrrlicht_debug.so
- ln -s libIrrlicht.so.1.5 libIrrlicht.so

Nous pouvons déja tester le progrès avec la librairie dynamique
- Nous indiquons le chemin de la lib dynamique avec le flag -L de GCC
- Si nous ne faisons pas cela, les chemins par défaut seront utilisés, et Irrlicht sera linké en statique.

~$ time g++ test.cpp -lIrrlicht -lpng -ljpeg -lGL -lXv -lXxf86vm -I/usr/include/irrlicht -L"$HOME"/sources/irrlicht-1.5/lib/Linux/

real    0m0.879s
user    0m0.770s
sys     0m0.101s

Compilation des entêtes

On ne dirait pas, mais un include peut augmenter significativement le temps de compilation.
- de même que VisualC++, GCC peut les précompiler pour gagner du temps.

Le fichier source doit débuter par un include qui contiendra lui même tous les includes du projet.
- Ex: #include "projet.h"
- projet.h contiendra:

#include <math.h>
#include <irrlicht.h>

On le compile de cette façon:
- g++ projet.h -I/usr/include/irrlicht

Normalement, vous devez obtenir un gros fichier nommé projet.h.gch
- Si vos entêtes ne sont pas dans le chemin de recherche de gcc, n'oubliez pas d'utiliser le flag -I , comme je l'ai fait ci-dessus.

Plus qu'à tester:

~/coding/irrlicht$ time g++ test.cpp -lIrrlicht -lpng -ljpeg -lGL -lXv -lXxf86vm -I/usr/include/irrlicht -L"$HOME"/sources/irrlicht-1.5/lib/Linux/ -Wl,-rpath="$HOME"/sources/irrlicht-1.5/lib/Linux/

real    0m0.519s
user    0m0.444s
sys     0m0.069s

Le gain par rapport au temps mis par la compilation en introduction est sans appel.

Un makefile sera tout de même appréciable, ne serait-ce que pour gérer les dépendances des entêtes.
- Sa conception est laissée à titre d'exercice au lecteur.

Vroum!

Et voila, avec quelques manoeuvres simples, nous nous retrouvons avec une machine à la nouvelle jeunesse.

Avec l'argent économisé, vous pouvez faire un don ~~sur mon compte offshore~~ à ma fondation pour la réinsertion des Anciens de l'AS/400.

Passons la brosse au délégué

Jean-Seb — Sat, 17 Jan 2009 09:37:00 +0100

Aujourd'hui, on passe la brosse.
Rassurez-vous, il ne s'agit pas d'un vil fayotage de bas étage.
Le délégué en question est un filtre ImageMagick

Etendre ImageMagick

ImageMagick présente une pléthore de formats.
- Malgré tout, il arrive que certains formats ne soient pas supportés.
- Vous pouvez aussi avoir envie de voir votre propre format supporté.

A titre d' exemple, je vous propose le format gbr (Gimp Brush, ce sont les brosses de Gimp).

La doc du format se trouve dans les sources de Gimp (cherchez le fichier gbr.txt ).

gbr est supporté depuis la version 6.4.6-5 de ImageMagick.
- L'arbre portage de Gentoo ne contient pas une version supportant le format gbr.
- Vous pouvez évidemment récupérer une version plus récente, ou vous servir sur le cvs de ImageMagick.

Mise au point

Je vous présente ici quelques pièges classiques , rencontrés lors du développement de filtres.

Problèmes de conversion

En C, une erreur redoutable est le problème de conversion signed/unsigned lors de la copie de données.
- -Wall signale pas mal de choses, mais pas ces problèmes de conversions.
- -Wconversion vous le signalera, et devrait être obligatoire pour arrêter les tractions capillaires lors de la mise au point !

Cas typique signalé par -Wconversion :
- Débordement des valeurs envoyées dans un buffer de type char *buffer
- En effet, ce buffer est signed (déclaration par défaut du type char), ce qui n'est probablement pas ce que vous voulez.

Chargement et sauvegarde de structures

Les structures sont la plaie du C, quand il s'agit de les charger ou les décharger.
- Pas d'autres choix que de sauver distinctement chacun des membres.
- Le chargement se fait également membre par membre.
- Ne vous amusez pas à packer vos structures afin d'éviter le padding du compilateur. C'est une très mauvaise idée pour la portabilité, même au sein d'une même architecture.

Problèmes liés au format TGA

Attention, le format TGA est codé en BGR, et non pas en RGB.
Exemple d'une conversion avec la source en 24 bits, et la destination en 32 bits (on ajoute juste le channel alpha, bloqué à 255).

 for (i=0; i < tga_i->tga_x * tga_i->tga_y * 3; i+=3) {
   b_dst[j] = b_src[i+2]; //RGB -> BGR
   b_dst[j+1] = b_src[i+1];
   b_dst[j+2] = b_src[i];
   b_dst[j+3] = 255; //alpha
   j+=4;
}

Problèmes liés au format GBR

Les entiers (type int) de Gimp sont au format Motorola (Big-Endian).

La conversion vers le format Little-Endian se fera à l'aide de deux fonctions.

Une fonction pour lire les entiers :

int read_uint32 (unsigned char *p)
{
  return p[3] + (p[2]*256) + (p[1]*65536) + (p[0]*16777216);
}

Une fonction pour écrire les entiers :

void write_uint32 (int i, FILE *fp)
{
  unsigned char c[4]={0};
  c[0] = (i>>24)&0xff;
  c[1] = (i>>16)&0xff;
  c[2] = (i>>8)&0xff;
  c[3] = i&0xff;

  writebuf (c, sizeof(int), fp);
}

Pour mes conversions, j'ai été obligé de faire un flip horizontal et vertical de l'image, avant de l'enregistrer au format gbr
- Il suffit de reprendre le contenu du buffer TGA, et de le recopier en l'inversant, et en tenant compte du fait qu'il est stocké au format BGR (BlueGreenRed).
- Pour info :

//gbr->datas[] est le buffer source
// flipped_pic est le buffer destination (qui contient les données flippées de la brosse)

 for (h = 0; h < gbr->height; h++) {
   h_beg=h*gbr->width*4;
   h_end=(gbr->height*gbr->width*4)-(h*gbr->width*4);

   for (w = 0; w < gbr->width*4; w+=4) {
      flipped_pic[h_end-1-(w+3)] = gbr->datas[h_beg+(gbr->width*4)-w-4];
      flipped_pic[h_end-1-(w+2)] = gbr->datas[h_beg+(gbr->width*4)-w-3];
      flipped_pic[h_end-1-(w+1)] = gbr->datas[h_beg+(gbr->width*4)-w-2];
      flipped_pic[h_end-1-(w)] =   gbr->datas[h_beg+(gbr->width*4)-w-1];
   }
}

delegates.xml

Principe

Le fichier delegates.xml sert à la configuration des filtres ImageMagick.
- Ces filtres sont appellés des delegates dans la terminologie ImageMagick.

Vous pouvez le trouver avec un locate. Pour ma part, il se trouve ici:
- /usr/lib64/ImageMagick-6.3.7/config/delegates.xml

Dans ce fichier, vous trouverez la description des filtres et leur paramétrage.
- Plutot que de vous livrer une longue liste de paramètres, je vous invite à lire ce fichier : tout ce qui est important est décrit en commentaires, au début du fichier.

Le delegate le plus simple du monde

renommez l'extension d'un fichier png en pong
créez un fichier "pong_convert", rendez le exécutable, et insérez-y ces lignes:

#!/bin/bash

if [[ x"$1" != x"" && x"$2" != x"" ]]
then
  cp $1 $2
  echo "$1" a été converti en "$2"
else
  echo "Usage: $0 source.pong dest.png"
fi

Ajoutez dans votre fichier fichier delegates.xml la ligne suivante:

<delegate decode="pong" encode="png" command='"/tmp/pong_convert "%i" "%o"'/>

Vous pouvez maintenant utiliser votre convertisseur
- convert source.pong dest.png

Utiliser tout ça ensemble

Mais tout a déja été dit

Je pense que l'essentiel a été dit.

Je pourrais bien sûr reprendre les paragraphes précédents, et détailler la méthode pour la conversion des fichiers gbr.

Mais je ne ferais que répéter ce que vous avez déja lu, sans apporter grand chose d'intéressant.
- Si vous avez des questions, n'hésitez pas, les commentaires sont là pour ça.

Et les sources ?

Je ne publie pas mes sources, car:
- la partie TGA est assez ancienne (2002) et mériterait un bon nettoyage.
- Un filtre gbr est disponible dans le cvs de ImageMagick, et ne tardera donc pas à être intégré aux releases.

Le post des sources dans ce billet est donc sans intêret.
- Si néanmoins, et pour une raison qui m'échappe, vous désirez les sources du convertisseur, demandez les en commentaire et je les posterai.

Coup de bash sur les alias

Jean-Seb — Tue, 23 Dec 2008 23:05:00 +0100

Le blog n'est pas abandonné!
Un (tout) petit billet pour vous le prouver, fidèles lecteurs anonymes et desespérés.
Aujourd'hui, les alias.

Votre shell et les alias

Si vous utilisez un shell Unix, il y a fort à parier que celui-ci supporte les alias.
Un alias est un raccourci pour une commande.
- Par exemple, fusck pourrait être un alias pour rm -rf /. (ceci est un exemple. Ne faites pas ça chez vous, les enfants).

.bashrc et les alias

Bash ne déroge pas à la rêgle, en tant que shell le plus répandu.
Ce n'est pas le meilleur, mais c'est celui que j'utilise.

Jetons un coup d'oeil dans son fichier de configuration, .bashrc

export PS1='\w\$ '
alias ls="ls --color -hs"
export LESSCHARSET='latin1'

Il n'y a pas grand chose, mais je l'aime bien.

On remarque un alias sur ls
- Cet alias est incorrect, et pourtant, je le traine depuis un bout de temps (depuis mes débuts sous Linux en fait.)

Que fait ls --color -hs

--color sert à coloriser la sortie (ça se paramètre, mais ce n'est pas le sujet ici).
-hs : size , human readable (la taille en octet est convertie dans une unité plus parlante).

Que fait la police ?!

La grosse erreur ici consiste dans les paramètres.
Vous allez me dire que c'est ennuyeux, vu qu'une commande aliasée sans paramètres, ça ne sert pas à grand chose.
Pour corriger:
- --color=auto : va supprimer la coloration automatique si la commande passe à travers un pipe.
- enlever le -hs qui perturbe aussi les pipes.

Testons

sans les modifications du .bashrc :

~$ ls / | head -1
total 56K

avec les modifications du .bashrc:

~$ ls / | head -1
bin

Et si on veut garder ses alias pourris ?

Deux solutions:
- appeller la commande avec le path complet: /bin/ls
- préfixer la commande avec un slash: \ls

Ces deux méthodes empêche l'aliasing par le shell.
- Il vaut mieux cependant créer de nouvelles commandes pour les alias paramétrés.
- Ex: alias lls='ls --lh'

La morale de cette histoire

La morale de cette histoire, c'est qu'il faut pas gonfler Gérald Lambert quand il aliase son shell.
- C'est la morale de ce billet, moi j'la trouve chouette, pas vous ? Ah bon.

Sur ce: joyeux noel, paix dans le monde, et à l'année prochaine.

Prototypons, petit patapon

Jean-Seb — Sun, 23 Nov 2008 23:16:00 +0100

Prototypons! Avec Python!
Mais pourquoi donc avec Python ?
Parce que ça rime!

Remerciements à Frédéric Jolliton pour son aide permanente.

Prototyper: quoi, quand, où, pourquoi, avec qui ?

quoi : prototyper, c'est écrire du code vite fait pour vérifier qu'une idée est bonne (ou mauvaise, ce qui peut aussi s'avérer utile).

quand : quand vous voulez ! Le plus tôt est peut être le mieux.

où : dans vos projets dont la taille du listing dépasse une feuille A4.

pourquoi : parce qu'il faut tester! ( (c) F.J.)

avec qui : avec un langage faisant office de glue , et collant rapidement les morceaux.

Ah bon! Et en clair ?

L'idée est d'utiliser Python pour tester rapidement des routines en C.

Cela évite d'avoir à écrire un cadre d'exécution complet en C.

Cela permet également de continuer à exécuter le programme, tout en faisant des modifications à la volée.
- Avec un squelette python de boucle principale, on peut modifier les routines satellites écrites en C sans tout réinitialiser à chaque fois.

Différence entre extending et embedding.

Extending

extending : consiste à appeller du C depuis Python. Nous avons deux possibilités:
- Créer un module Python, utilisé ensuite avec un simple import module. Ce module aura le même comportement que les modules Python habituels.
- Utiliser ctypes pour appeller des fonctions C depuis Python. Ceci ne nécessite pas la création d'un module Python.

ctypes est beaucoup plus simple à mettre en oeuvre que la création d'un module.

De plus, ctypes est intégré à Python depuis la version 2.5

Embedding

embedding : consiste à faire tourner une machine virtuelle Python dans un programme C.
- non traité dans ce billet.

Principe de l'extending avec ctypes

Comme il faut bien commencer par quelque chose, autant faire au plus simple.
- Nous utiliserons donc ctypes.

On va utiliser une dll ou un .so (selon votre OS), que nous allons écrire en C.

On importe cette bibliothèque depuis Python, qu'on peut ensuite utiliser comme n'importe quel module importé.

Nous allons également écrire un wrapper dans Python, ce qui présentera plusieurs avantages:
- Ne pas afficher les valeurs de retour de chaque sous-fonctions, lors de l'appel d'une fonction. En effet, les fonctions Python vont retourner "None" , ce qui ne sera pas affiché dans le shell interactif. Ceci est valable pour mon exemple, et n'est pas forcément souhaitable. Bien entendu, les valeurs renvoyées par la bibliothèque C sont renvoyées au wrapper, à charge pour lui de les traiter.
- Simplifier l'initialisation depuis Python: le wrapper comprendra du code d'initialisation.
- Masquer la complexité des appels en C: le wrapper se chargera de passer les paramètres éventuels, et de tester les codes de retour.

Faire appel au bon type

Définir un type

ctypes permet de définir des types compatibles avec ceux du C.

De manière générale, il suffit de rajouter le préfixe c_ au type C.
- Quelques exemples (voir la doc de ctypes) : c_char , c_int, c_long, c_float

Cas des pointeurs

Les pointeurs :
c_char_p et c_wchar_p : char * et wchar_t *
c_void_p : void *

Les types définis par ctypes sont tous mutables.
- Cela signifie que vous pouvez les modifier à la volée dans Python.

Attention : la modification d'une zone mémoire déréférencée par un pointeur ctypes crée une copie du contenu du pointeur, et non pas une modification de la zone précédemment pointé.
- Pourquoi ? Parce que les strings ne sont pas mutables en Python (c_void_p est logé à la même enseigne que les strings).

Si vous utilisez une fonction C qui a besoin d'un pointeur sur une zone mémoire modifiable, il faut utiliser create_string_buffer
- L'objet créé est accédé via les méthodes raw et string , selon que vous voulez la représentation string ou pas (string : chaine terminée par zéro).
- Je sens qu'un exemple serait le bienvenu:


#string python : pas mutable
>>> buffer_python="Jean-Seb"
>>> buffer_python[2]="x"
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'str' object does not support item assignment


#buffer ctypes : mutable
>>> buffer_c=ctypes.create_string_buffer("Jean-Seb")
>>> type(buffer_c)
<class 'ctypes.c_char_Array_9'>
>>> buffer_c.raw
'Jean-Seb\x00'
>>> buffer_c.raw="0wned"
>>> buffer_c.raw
'0wnedSeb\x00'

Les structures

Vous pouvez directement définir et adresser des structures C en Python.
- Pour cela, il faut utiliser ctypes.Structure
- Il faut dériver de ctypes.Structure une nouvelle classe, et définir un attribut _fields_.
- _fields_ est un tuple contenant un champs nom et un champs type.
- Tous les types de ctypes peuvent être utilisés.

Voici le code en C qui définit, puis affiche une structure


typedef struct {
  char *name;
  int age;
} MASTRUCT;

void print_struct(MASTRUCT *mastruct)
{
  printf("je suis %s et j'ai %d ans\n", 
          mastruct->name, mastruct->age);
}

Et voici comment créer une structure avec Python, pour la passer ensuite à la fonction en C.
- On passe le pointeur à la structure en utilisant ctypes.byref . Cette fonction retourne un pointeur, mais ce pointeur est uniquement utilisable en tant qu'argument de fonction. Sinon, il faudra utiliser ctypes.pointer.


>>> import ctypes
>>> dll = ctypes.CDLL("./malib.so")

>>> class mastruct(ctypes.Structure) :
        _fields_ = [ ("nom", ctypes.c_char_p),
                            ("age", ctypes.c_int) ]
        
>>> ms = mastruct("Marcel", 42)
>>> print ms
<__main__.mastruct object at 0x2abfcecf6af0>
>>> print ms.age , ms.nom
42 Marcel
>>> dll.print_struct(ctypes.byref(ms))
je suis Marcel et j'ai 42 ans

Module util de ctypes

ctypes possède un module fort utile, judicieusement nommé util
- import ctypes.util

La fonction la plus utile de ce module est find_library, qui permet d'avoir le nom complet d'une bibliothèque.
- Attention à ne pas ajouter lib sous Linux, sinon, la fonction ne trouvera rien.


>>> ctypes.util.find_library("c")
'libc.so.6'

La grande ruse du rechargement de bibliothèque.

Avertissement façon Java

Pour recharger une bibliothèque, on utilise normalement un module python, que l'on rechargera en cas de modification de la bibliothèque.

Bien que ce soit la méthode habituelle et recommandée, elle a pour inconvénient d'être plus contraignante que la méthode que je vais vous présenter.

Pour le développement d'une DLL de centrale nucléaire ou d'un accélérateur de particule, je vous conseille toutefois la méthode classique.

Concernant ce passage, Fred souhaite ajouter cela : bon, en tout cas, je ne veux pas être associé a tes bidouilles avec dlopen/dlclose

Le problème

Normalement, on ne peut importer une bibliothèque qu'une seule fois.

malib = ctypes.CDLL("./malib.so")
- malib ne sera pas rechargée si vous appellez à nouveau le code ci-dessus.

Ce comportement peut poser problème, notamment dans le cas d'une bibliothèque en développement, ce qui est souvent le cas quand on fait du prototypage.
- En effet, l'ajout ou la modification de fonctions dans la bibliothèque n'est pas pris en compte dans la même session Python.
- Cela ne pose pas de problèmes dans le cas d'un script Python, mais est très gênant si vous souhaitez garder un shell Python ouvert, et faire des modifications à la volée.

La solution

Alors, on pleure ? Non. On ruse.

L'astuce consiste à passer à ctypes.CDLL un handle sur une bibliothèque déja ouverte.
- En cas de modification de cette bibliothèque, rien n'empêche de la fermer, puis de la recharger de la même manière.
- Les modifications seront bien prises en compte.

Tout ceci nécessite l'utilisation de la bibliothèque libdl
- Nous l'initialisons de façon classique, et nous récupérons des pointeurs sur les fonctions que nous allons utiliser.
- Il convient de préciser le type de retour pour la fonction dlopen , qui par défaut est un type long. Nous voulons à la place un pointeur void, ce qui correspond au prototype de dlopen.


>>> import ctypes
>>> libdl = ctypes.CDLL("libdl.so.2")
>>> dlopen = libdl.dlopen   #récupère un pointeur de fonction
>>> dlclose = libdl.dlclose

>>> print dlopen.restype
<class 'ctypes.c_long'>
>>> dlopen.restype = ctypes.c_void_p

L'initialisation est terminée, nous allons maintenant utiliser dlopen.
- dlopen sert à ouvrir une bibliothèque, et récupérer son handle.
- Le premier paramètre est évident: c'est le nom de la bibliothèque à ouvrir.
- Le second l'est moins, et correspond à un flag. Nous allons utiliser RTLD_NOW.
- La valeur des flags de la fonction est défini ici: /usr/include/bits/dlfcn.h
- Je vais rentrer en dur la valeur du flag, qui a l'air universelle. En cas de problèmes, vérifiez cette valeur.
- En résumé: #define RTLD_NOW 0x00002 /* Immediate function call binding */


>>> monhandle = dlopen("./hello_extend.so", 2)

Maintenant que nous avons obtenu un handle sur notre bibliothèque, nous pouvons l'utiliser avec ctypes.CDLL
- Par défaut, CDLL s'occupe de l'ouverture de la bibliothèque.
- On peut toutefois lui passer en paramètre le handle d'une bibliothèque déja ouverte. Ainsi, il ne s'occupera pas de l'ouverture de la bibliothèque, et nous pourrons demander sa fermeture (ce qui est impossible si on délègue l'ouverture à CDLL).


>>> malib = ctypes.CDLL("./hello_extend.so", handle = monhandle)

Voila, vous pouvez à présent utiliser normalement la bibliothèque.

Procédure pour recharger la bibliothèque :
- faire un dlclose avec le handle de cette bibliothèque.
- obtenir un nouvea handle sur cette bibliothèque avec dlopen.
- utiliser ctypes.CDLL avec le nouveau handle en paramètre.


>>> dlclose(monhandle)
>>> monhandle = dlopen("./hello_extend.so",2)
>>> malib = ctypes.CDLL("./hello_extend.so", handle = monhandle)

Et pour MS-Windows ?

Je n'ai pas testé. Voici quelques pistes pour ceux qui voudront s'y atteler.

Le principe est le même que pour Unix, à part pour les noms de fonctions de gestion de bibliothèque.
- Par exemple, dlopen deviendra LoadLibrary
- Bien entendu, les paramètres ne seront pas les mêmes, je vous laisse consulter le MSDN.

Si vous faites le test, merci d'écrire un commentaire ou de m'envoyer un mail. Je complèterai le billet.

Mise en oeuvre : bibliothèque C utilisable depuis Python via un wrapper.

bibliothèque C : hello_extend.c

Rien de particulier à signaler dans le fichier source qui exporte ces fonctions:
- get_version() : retourne un entier correspondant au numéro de version
- print_persion() : imprime sur la sortie standard le numéro de version.
- test_version(int version_attendue) : teste la version de la bibliothèque.
- print_struct (MASTRUCT *mastruct) : affiche une structure (détails dans la partie consacrée aux types).

Compilez avec:
- gcc -shared -fPIC -Wall -W hello_extend.c -o hello_extend.so
- Pour les systèmes MS-Windows, enlevez le paramètre -fPIC

Le source en lui même est du C de base, je n'encombre pas le billet avec.
- Vous trouverez le fichier source dans l'archive en annexe.

Module d'importation Python : dll.py

Ce module a été amplement décrit plus haut.

Il sera appelé automatiquement lors de l'initialisation du wrapper Python.
- Vous n'avez donc pas à vous soucier de son initialisation.

Par la suite, en cas de modification de la bibliothèque C, il faudra la recharger
- depuis le module dll: dll.restart()
- ou depuis le wrapper (voir plus loin): hello_wrapper.restart()

Wrapper Python : hello_wrapper.py

Important : le nom du module Python doit être différent du nom de la bibliothèque C (les extensions ne comptent pas pour la différenciation).
- Dans le cas contraire, vous obtiendrez une erreur assez cryptique lors de l'import du wrapper dans Python.

Le wrapper va appeler pour vous les fonctions de la bibliothèque, et tester les paramètres, ainsi que les codes de retour.

Il est important de tester les paramètres depuis le code Python. Prenons pour exemple la fonction d' affichage de structure.
- Le strict minimum dans le code C serait de tester un pointeur null et de ne pas exécuter la fonction en cas de pointeur invalide.
- Ce genre de test ne sert pas à grand chose. Même si le pointeur nul n'est pas exclu, il y a plus de probabilités pour qu'un objet d'un type invalide soit passé. Ce dernier cas passerait le test du pointeur nul, mais provoquera probablement un beau plantage.
- Il faut donc tester depuis Python que l'on passe bien une structure valide, afin de limiter les dégats potentiels. Je dis limiter les dégats, car le fait de passer une structure valide ne présume en rien de son contenu.
- Voici un exemple de test de paramètre, pour la fonction d'affichage de structure: on teste si l'objet est bien la structure réglementaire.


def print_struct(obj):
   if isinstance (obj, mastruct):
     dll.malib.print_struct (ctypes.byref(obj))
   else:
     print "Objet invalide, ce n'est pas une structure <mastruct>"
     print "type de l'objet :", type(obj)

Les tests sur les codes de retour sont évidents, et n'appelent pas de commentaires particuliers.

Et enfin, appel du code depuis Python

import hello_wrapper
- ensuite, vous pouvez appeller classiquement les fonctions.
- Par exemple: hello_wrapper.print_version()

En cas de modification de la bibliothèque, rechargez la depuis python avec hello_wrapper.restart()

C'est terminé, mais quelle est donc cette perplexité ?

Voici la fin d'un gros morceau. J'espère que c'était clair et que ça vous a plu.

Je n'ai rien inventé, et tout se trouve dans le lien qui suit. Lisez au moins le tutorial, très bien fait:
- La doc de ctypes
- Une autre approche

Après toute cette partie théorique, nous allons nous pencher sur la mise en pratique des connaissances acquises.
- Cela fera l'objet d'un projet billet, je vous laisse digérer celui-ci en attendant

Conversion rituelle d'un fichier textuel

Jean-Seb — Thu, 23 Oct 2008 21:33:00 +0200

Halte au paganisme chez les fichiers texte!
Convertissez les tous, Vim reconnaitra les siens!

Oecuménisme débridé

Dans l'informatique, il n'est plus question de tolérance ni de droit à la différence.

Et pourtant, quelle pire jungle que les fichiers textes ?

Nous allons nous faire les apôtres d'une conversion de masse, et plus jamais aucun fichier ne vous narguera.

Le Dos au mur.

L'édition d'un fichier venant de Dos/Windows est très pénible.

Notamment si vous le rendez exécutable, et que vous ajoutez une ligne de ce style en guise d'entête:
- #!/usr/bin/python
- Si votre fichier est enregistré au format Dos/Windows, c'est à dire avec 0xD 0xA en guise de terminateur de ligne, vous allez vous faire insulter à l'exécution:
- /usr/bin/python^M: bad interpreter

Vous pouvez toujours courir pour éliminer le caractère 0xD sous Vim.
- :%s/^M//g : no matches (comment ça "no matches" ?!)

Vous pourriez le convertir avec Sed
- cat foo.py | sed 's/^M/g' >foo2.py && mv foo2.py foo.py : un peu lourdingue, mais fonctionne

Il y a plus simple. Il suffit de prévenir Vim que vous utilisez un OS de Vrai Mec.
- :set ff=unix , puis sauvez le fichier.
- et voila. Le fichier est converti.

La conversion inverse est possible (quelle idée bizarre):
- :set ff=dos : pour faire des farces à vos camarades.

Définition du format de fichier au démarrage de Vim

Pour choisir le format de fichier adapté au démarrage de Vim, il vous suffit de placer dans .vimrc :
- set ff=x (avec x = dos, unix ou mac )

Le problème est que vous ne pouvez plus reprendre votre .vimrc sur un OS différent sans modifier la ligne positionnant le format.

Il vaut mieux détecter l'OS au démarrage, et faire le ff correspondant.

Vim est un curieux, et il peut vous dire beaucoup de chose sur sa plate-forme d'exécution: help feature-list
- Il faut que Vim ait été compilé avec +feature-list (c'est le cas des versions MS-Windows précompilées).

Pour tester, créez un fichier .detecte_os.vim , et insérez le code ci-dessous.
- Pour charger ce fichier depuis Vim: :so .detecte_os.vim
- Pour exécuter la fonction: :call Detecte_OS()

"fichier: .detecte_os.vim
"doc: help feature-list

"les noms de fonction commencent par une majuscule
function! Detecte_OS()

if has("unix")
   echo "version Unix detectée"
   set ff=unix
elseif has("macunix")
   echo "MacOS X detecté"
   set ff=mac
else
   echo "Version de Vim inconnue. Surement Windows."
   set ff=dos
endif

endfunction

Vous pouvez appeller cette fonction au démarrage de Vim, en insérant ceci dans votre .vimrc

so ~/.detecte_os.vim
autocmd VimEnter * call Detecte_OS()

L'encodage des fichiers

Le format de fichier est une chose, l'encodage en est une autre.
- La phrase précédente n'apportant pas grand chose dans ce grand cri numérique qu'est Internet, je précise ma pensée.

le format de fichier: il concerne la structure du fichier, c'est à dire la façon dont sont encodées les fins de lignes (0x0D0A pour la famille Dos, 0x0A pour le reste du monde).

l' encodage des fichiers : il concerne les tables de caractères utilisés pour les fichiers (UTF-8, iso-8859-x etc.).

Typiquement, les problèmes d'encodages se repèrent avec les accents dans les fichiers texte.
- un bel accent ascii tel que celui ci: é , sera encodé sous cette forme en UTF-8: Ã©

l'encodage des fichiers se règle sous Vim avec les variables encoding , fileencoding et fileencodings
- encoding détermine l'encodage des caractères utilisé au sein de Vim.
- fileencoding détermine l'encodage à utiliser lors de la sauvegarde d'un fichier (eh oui, c'est subtil)
- fileencodings (avec un s final) donne une liste de tables d'encodage à utiliser lors de l'édition d'un nouveau fichier. Vim tente d'utiliser la première de la liste, puis la seconde, etc.

Sans plus attendre, sautons au paragraphe suivant pour nous vautrer dans le concret.

Illustration des problèmes d'encodage de fichiers

Un exemple type des problèmes que vous allez rencontrer avec les encodages de fichier est le mapping des touches dans Vim.
Pour remapper une touche, vous utilisez la commande map, généralement placée dans votre .vimrc (si vous voulez un comportement permanent).
- Ex: map µ :set cursorline! cursorcolumn!<CR>

Dans l'exemple précédent, on utilise une touche qui va être encodée sur deux caractères en UTF-8.
- Si votre fichier .vimrc est encodée en latin1et que votre terminal fonctionne en Unicode, le code caractère ne correspondra pas.
- Si vous avez un doute, hexdump peut vous aider à être sûr de l'encodage utilisé.
- Le plus simple est de vérifier avec :set fileencoding

Dans mon cas, j'utilise un terminal unicode (c'est urxvt, que je vous recommande).
- J'ai simplement choisi l'encodage des fichiers en UTF-8, et j'ai sauvé le fichier.
- Résultat: plus de problèmes pour la prise en compte de mes raccourcis claviers.
- la commande magique: set fileencoding=UTF-8 (suivi d'un write, bien sûr).

Baptême de masse avec Skippy (et iconv)

Tout cela est bien beau, mais vous pourriez vous retrouver avec une masse de fichiers à convertir.

Dans ce cas, hors de question des les ouvrir un par un avec Vim.

Heureusement, Skippy pense à vous, et vous propose un baptême de masse. Avec siphonnage des comptes bancaires associés, bien sûr.

Pour ce faire:
- rasez-vous le crane.
- mettez vos lunettes noires.
- ressortez votre peignoir.
- et, j'allais l'oublier, n'oubliez pas iconv

Voici un exemple de commande pour vous montrer la bête en action.
- Ceci converti les sources C d'un répertoire et de ses descendants de iso-8859-1 vers UTF-8.
- find . -iname "*.c" | while read filename; do iconv -f iso-8859-1 -t UTF-8 "$filename" > ${filename%.*}_utf8.c ; done

Quelques remarques sur l'exemple précédent:
- On utilise l'astuce du while (merci Frédéric) : ceci permets de traiter les résultats du find avec une redirection.
- Sans redirection (nécessaire dans le cas de iconv pour créer le fichier cible), nous aurions pu utiliser xargs.
- n'oubliez pas que iconv -l va vous lister les jeux de caractères supportés en entrée et en sortie de iconv.

Parenthèse en guise de conclusion

Une astuce que je viens de découvrir avec xargs (merci Frédéric)
- xargs -I{} echo {} {}
- Cela sert à réutiliser plusieurs fois le nom que l'on passe par le tube. On met ce qu'on veut comme identifiant (-I), bien sûr.
- Mais nous nous éloignons carrément du sujet. Fermons là le ban.

Make Mayday

Jean-Seb — Fri, 03 Oct 2008 19:03:00 +0200

On ne présente plus Make, le gestionnaire de projets.
D'ailleurs, je ne vais pas le présenter.
Sans plus attendre, le livre de cuisine de Make
Mise à jour 14 oct. : ajout d'une rêgle de génération de noms de fichiers.

Les points sur les i en guise d'introduction

Ce texte ne reprend pas les explications de base.

Prenez le comme un condensé de rêgles et d'astuces utiles, découvertes au fur et à mesure de mes développements.

La doc complète se trouve ici

Comme d'habitude, j' enrichirai ce billet à mesure de mes découvertes et de vos nombreux commentaires.

Rêgles génériques

La plus courante: compiler les fichiers *.c.
- %.o: %.c : définition de la boucle de compilation
- $< : substituer avec le fichier à droite des deux points de la rêgle (ici: %.c )

%.o: %.c
         gcc -c $<

Quelques autres variables internes à Make:
- $@ = cible (valeur à gauche des deux points de la rêgle).
- $^ = affiche la valeur source avec tout ses prérequis (peut servir à obtenir le path complet d'un fichier)
- Pour les autres: 10.5.3 Automatic Variables dans la page info de Make.

La cible .PHONY

La cible .PHONY sert à spécifier une rêgle qui ne correspond pas à la génération d'un fichier.

Elle correspond à une commande à exécuter quand on le demande explicitement.
- Les rêgles PHONY sont généralement utilisées pour les opérations de nettoyage et d'installation.
- Corollaire: elles permettent donc d'exécuter une rêgle Make si un fichier porte le même nom.

Exemple (avec les rêgles all et clean) :
- .PHONY: all clean
- Dans l'exemple précédent, on déclare deux cibles all et clean. Si des fichiers de même nom existent, il n'y aura pas conflit.

Détection d'une plateforme

Utiliser la commande shell qui permet de lancer des commandes.
Une fois la variable win32 positionnée (ou non), on peut faire un test avec ifdef / else / endif

OS=$(shell uname | cut -f1 -d'_')
ifeq ($(OS),MINGW32)
win32=1
endif

Fonction d'affichage coloré

Définition d'une fonction print colorée (Fred adore).
- Définir les codes couleurs au format ANSI.

info=\033[40;33;01m
warn=\033[41;36;01m
help=\033[41;33;01m
rem=\033[40;34;01m
define print
        @echo -e "$($(2)) $(1) \033[0m"
endef

Utilisation de la fonction print
- $(call print,"all done",warn) : une chaine toute simple.
- $(call print,Construction de $(exe),info) : on peut également substituer des variables.

Génération des dépendances

J'en parle dans un autre post de ce blog :
- génération des dépendances avec GCC

En bref:

deps:
        @echo génération des dépendances
        @rm -f mes_deps
        @$(CC) -MM *.c* >>mes_deps

-include mes_deps

Fichiers sources situés dans plusieurs répertoires

On peut éviter de préfixer chaque fichier source par son répertoire.

VPATH permet d'indiquer où chercher les fichiers sources.
- Syntaxe: VPATH=foo:bar:baz

Comment utiliser un fichier qui n'est pas dans le répertoire courant ?
- Il faut utiliser la variable automatique $^

Pour la compilation, nous allons donc utiliser cette variable automatique.

 %.o : %.c
        $(CC) -c $^ -o $@ $(CFLAGS)

pour linker , même principe:

$(exe): $(obj)
        $(CC) $^ -o $@ $(LDFLAGS) $(libs)

Et pour générer les dépendances:

deps:
        @rm -f mes_deps
        @$(CC) -I$(VPATH) -MM *.c* $(VPATH)/*.c* >>mes_deps

Fichiers sources dispersés, objets dans un répertoire spécifique

Dans le cas précédent, les objets vont se retrouver dans le répertoire racine de Make.
Il est plus agréable de les regrouper dans un répertoire dédié.

On utilise toujours la variable VPATH pour indiquer les répertoires.

Préparation des variables:
- path_obj est le répertoire où les obj seront placés
- objets_avec_chemin sera utilisé par le linker (ce sont les objets préfixés par leur chemin complet)

OBJS=morph_dots.o cglfw.o memory.o
path_obj=./objets
objets_avec_chemin=$(patsubst %,$(path_obj)/%,$(OBJS))

Vous pouvez insérer cette rêgle dans votre makefile, pour créer le répertoire des objets si il n'existe pas.
- __dummy := $(shell mkdir -p $(path_obj))

Pour compiler et linker:
- Notez que pour linker, on peut utiliser la variable automatique $< , car les fichiers objets sont préfixés par leur répertoire dans la définition de la cible.

$(exe): $(objets_avec_chemin)
        $(CC) $^ $(libs) -o $(exe)

$(path_obj)/%.o: %.cpp
        $(CC) $(CXXFLAGS) -c $< -o $@

Pour générer les dépendances, on utilisera toujours la même méthode.
- Il faut juste insérer le répertoire de destination des objets. Il faut le faire à la main avec sed

deps:
        @rm -f mes_deps
        @$(CC) -I$(VPATH) -MM *.c* $(VPATH)/*.c* >>mes_deps

#rajoute $(path_obj) sur les lignes qui ne commencent pas par \t ou space
        @sed 's:^\([^\t\ ]\):$(path_obj)/\1:g' < mes_deps >mes_deps.tmp
        @mv mes_deps.tmp mes_deps

Quelques fonctions.

La fonction wildcard permet de récupérer les noms de fichiers satisfaisants à une rêgle.
- ex: SOURCES=$(wildcard *.c)

La fonction basename récupère la racine d'un nom de fichier.
- $(basename toto.c) : renvoie toto

Vous voulez compiler tous les fichiers d'un répertoire, mais vous ne savez pas à l'avance leur nom.
- Ici, j'utilise un fichier texte qui va être transformé en fichier html après un petit traitement.
- SOURCES utilise un wildcard pour ramener tous les fichiers avec l'extension txt.
- DESTS est le résultat d'une substitution de chaine sur la variable SOURCES

SOURCES=$(wildcard *.txt)
DESTS=$(SOURCES:.txt=.html)

all: $(DESTS)
        @echo Terminé

%.html: %.txt
        @crock $< >$@

Salut Make

make clean
make all
make install

JH rech. un bug mortel.

Jean-Seb — Mon, 29 Sep 2008 21:35:00 +0200

Vous recherchez un bug ?
Faites confiance à GDB, spécialiste de la mise en relation.

GDB

C'est le debugger GNU.

Il n'y a pas vraiment de concurrence, à part peut être IDA-Pro (mais c'est payant).

GDB est rebutant au premier abord, ne vous découragez pas. Il devient rapidement très agréable à utiliser.

Si votre principal reproche est l'absence d'interface, vous pouvez commencer par lire le paragraphe: un secret bien gardé: le mode TUI.

Ici, je ne vais qu'effleurer le sujet, mais je mettrai à jour au fur et à mesure de mes expérimentations.

Trouver l'aide

help ou help domaine : donne les commandes de domaine.
apropos domaine : donne toutes les commandes liées à domaine (y compris les alias).
info domaine : tout le paramétrage d'un domaine. Exemple:
- info breakpoints : liste des breakpoints.
- info display : liste des variables en display (voir plus bas).
- info function : prototypage des fonctions + symboles.
help commande : la documentation complète d'une commande appartenant à un domaine.

Fichier de configuration

Il n'y a pas de configuration à proprement parler.
Au démarrage, GDB recherche un fichier .gdbinit dans le home, puis dans le répertoire courant.
Si le fichier existe dans les deux répertoires, il sera évalué à chaque fois.
Ce fichier va contenir des commandes GDB.
- Vous pouvez vous en servir pour personnaliser votre GDB (type de base désirée, messages à afficher, etc..)
- Vous pouvez aussi l'utiliser pour démarrer plus rapidement une session de debuggage.
- Le fichier suivant change le prompt de GDB, charge le fichier a.out (compilé avec les symboles de debug), pose un point d'arrêt sur main, lance l'exécution et liste le programme à l'endroit où GDB a stoppé.

~/temp$ cat .gdbinit 
set prompt debug-test.elf > 
file a.out
break main
run test.c
list

La base

Compiler avec les symboles de debug: gcc -ggdb foo.c
- On peut également compiler avec le plus classique -g, mais -ggdb est spécifique à GDB.

Lancer gdb: gdb votre_programme

Lancer le programme depuis gdb: run "argument 1" ... "argument n"
- on peut également jouer sur les arguments avec show / set args liste arguments
- kill pour stopper GDB ou ctrl+c si vous êtes pris dans une boucle.
- continue pour continuer le programme à partir de la position courante, jusqu'à le terminer ou à atteindre le prochain breakpoint.
- quit pour sortir de GDB.

Exécuter le programme en mode run
- step : passe à l'instruction suivante, rentre dans les appels de fonctions.
- next : passe à l'instruction suivante, et exécute les fonctions d'un bloc.
- nexti et stepi : même chose que précédemment, mais au niveau désassemblage.
- On peut également ajouter un nombre d'occurrences pour next et step
- step 10 : va exécuter 10 fois step, éventuellement en partant dans un sous-programme.
- next 10 : avance 10 fois, les sous-programmes comptent pour une avancée.
- continue éventuellement suivi d'un nombre, qui correspondra au nombre de fois où GDB ignorera le breakpoint d'où nous sommes reparti.
- call fonction() : appeler directement un sous-programme (exemple: pour nettoyer et sortir).
- finish : appelle step de façon continue, jusqu'à la fin de la fonction, et retour à l'appelant (affiche la valeur de retour).

list : lister le programme.
- list début,fin : lister de la ligne début à la ligne fin.
- list ,n : lister n lignes à partir de l'instruction courante.
- list fonction : lister une fonction.

file foo.exe : pour charger foo.exe. Si ce n'est pas le premier chargement, il est rechargé. Dans ce dernier cas, le source sera également rechargé.

Manipuler les variables
- print var : examiner une variable (le $ suivi d'un nombre est juste un compteur de référence).
- display var : même comportement que print, mais affiche la variable à chaque retour au prompt.
- undisplay var : annuler l'affichage automatique de var.
- set var = x : modifier une variable.
- whatis var : obtenir le type d'une variable.
- ptype struc : détail d'une structure
- show values : réafficher les 10 dernières valeurs affichées

Les dumps

Si on demande un print du pointeur char *buffer, on obtient une sortie peu agréable.
- print buffer affichera l'adresse du buffe et un dump sour forme de char.
- print *buffer : pour afficher le premier caractère du buffer.

Pour dumper une zone mémoire, il vaut mieux utiliser la commande x.

La commande x : x/(itérations)(format et taille) (adresse)
- itérations : facultatif, 1 par défaut.
- Format = o(octal), x(hex), d(decimal), u(unsigned decimal), t(binary), f(float), a(address), i(instruction), c(char), s(string).
- Taille = b(byte), h(halfword), w(word), g(giant, 8 bytes).

Exemple (le mieux étant de faire quelques essais vous-même)

debug-test.elf > x/c buffer
0x602250:       35 '#'

debug-test.elf > x/8c buffer
0x602250:       35 '#'  105 'i' 110 'n' 99 'c'  108 'l' 117 'u' 100 'd' 101 'e'

debug-test.elf > x/2s buffer
0x602250:        "#include <stdio.h>\n#include <stdlib.h>\n\nchar *buffer=0;\n\nint lecture(const char *file)\n{\n  FILE *fp=0;\n  int fsize=0;\n#define TAILLE_MAX 1024*1024\n\n  fp=fopen(file,\"rb\");\n  if (fp) {\n    fseek(fp,0,SE"...
0x602318:        "EK_END);\n    fsize=ftell(fp);\n    fseek(fp,0,SEEK_SET);\n\n    if (fsize>TAILLE_MAX) {\n      printf(\"Taille fichier trop important: %d octets.\\n\\\n", ' ' <repeats 14 times>, "Taille maximum autorisée: %d octets.\\n\",\n"...

debug-test.elf > x/2xw buffer
0x602250:       0x636e6923      0x6564756c

debug-test.elf > x/2xg buffer
0x602250:       0x6564756c636e6923      0x2e6f696474733c20

Les points d'arrêts

help breakpoints : tout ce qu'il faut savoir sur les points d'arrêt.
break nom fonction / num ligne : poser un breakpoint sur l'entrée d'une fonction, ou sur un numéro de ligne (ligne en cours, si pas de paramètre spécifié)
- on peut ajouter le nom du fichier où se trouve le code à interrompre : break nom_fichier:nom_fonction
delete n : efface le breakpoint numéro n . Si n est omis, tous les breakpoints sont effacés.
clear fonction/numero de ligne/adresse mémoire : efface le breakpoint en donnant sa ligne, le nom d'une fonction ou une adresse mémoire (précédée par *0x).
info breakpoints : donne la liste des breakpoints.
tbreak : même fonction que break, mais le breakpoint est temporaire.
break line if cond : arrêt à la ligne line si la condition cond est remplie. Conditions multiples (avec des booléens) admises.
- break pixel_test if x==1 && y==1
- On remarquera que les comparaisons se font avec la double égalité == (comme en C).

Parcourons la pile d'appel

La pile d'appel, ou call stack, sert à stocker les stacks frames (ou cadres de piles, traduction médiocre de l'espace utilisé pour sauver le contexte lors de l'appel d'une fonction).

Une stack frame contient les registres sauvés lors de l'appel d'une fonction, les arguments passés à la fonction ainsi que les variables locales.

where (ou backtrace , au choix) : sort le contenu de la call stack.
- Attention au sens de lecture: la frame la plus récente se trouve à la position zéro.

info frame

info locals

up , down (éventuellement suivi du nombre de positions) : se déplacer dans la pile des appels.
- permet d'afficher les variables locales d'un contexte.

Gestion de l'historique des commandes

Pour ne pas tout retaper à chaque session debug identique.

Sauvegarde de l'historique de commandes
- set history filename fname : choisir le nom du fichier historique (par défaut: ./.gdb_history)
- set history save on/off : activer/désactiver la sauvegarde de l'historique (par défaut, on ne sauve rien).
- set history size taille : taille de l'historique (par défaut : 256 commandes)
- show history : état des paramètres ci-dessus.

Charger et exécuter un fichier de commandes
- source commandes : commandes contient des commandes GDB
- avec l'option -v , on active le mode verbose : source -v commandes
- pas de demande de confirmation pour les commandes qui en demandent habituellement une.

readline en quelques mots

GDB utilise la bibliothèque readline pour la gestion du clavier.
Plutôt que de tout détailler, je vous renvoie à la doc de GDB.

Voici le minimum vital:
- alt+f , alt+b : curseur en avant/arrière d'un mot.
- ctrl+f , ctrl+b : curseur en avant/arrière d'un caractère.
- ctrl+w : effacer un mot avant le curseur.
- alt+d : effacer un mot après le curseur.
- ctrl+k : effacer du curseur jusqu'à la fin de la ligne.
- ctrl+y : yank (coller) d'un mot ou d'une séquence de mots précédemment effacé(s).
- tab : complétion automatique.
- ctrl+p , ctrl+n : historique arrière/avant des commandes.
- ctrl+r , ctrl+s : chercher en arrière/avant dans l'historique des commandes.

La liste est longue, mais passer un peu de temps sur readline en vaut la peine, car le shell utilise également cette bibliotheque.

Un secret bien gardé: le mode TUI

Un certain nombre de projets destinés à donner une interface à GDB existent.
- Citons en vrac DDD, divers front-ends ncurses revampant la sortie de GDB, le mode natif pour Emacs etc.
- En réalité, même si certains de ces développements apportent un plus à GDB (notamment DDD avec ses graphes d'appels), la majorité des personnes les utilisant ne s'intéressent qu'au côté GUI.
- Réjouissez-vous, GDB possède un GUI intégré. Seul pré-requis: le compiler avec le support ncurses. Pour le build msys, vous pouvez oublier, par contre, il est linké par défaut avec ncurses dans Cygwin.
- Ce mode s'appelle le mode TUI (Text User Interface). Il permet d'afficher plusieurs fenêtres sur le même écran.
- Les fenêtres affichables sont: commandes, source, désassemblage, registres (avec possibilité de choisir la famille de registres)
- On ne peut pas afficher plus de 3 fenêtres, sachant que la fenêtre "commandes" est toujours présente.

Pour activer/désactiver le mode TUI:
- ctrl-x puis a
- ou encore (équivalent): ctrl-xa (x, puis a sans relacher ctrl)

Affichage des différentes fenêtres:
- ctrl-x 1 , ctrl-x 2 : afficher une ou deux fenêtres (en plus de la fenêtre commandes).
- ctrl-x o : pour cycler entre les fenêtres.
- help layout
- layout next / prev pour passer entre les différentes configurations d'affichage.

Personnalisation de la fenêtre registres
- On peut choisir la famille de registres que l'on souhaite afficher : help tui reg
- Paramètres possibles à tui reg : float, general, system, next

Focus sur une fenêtre:
- focus src / asm / regs / cmd
- note: si on n'a pas le focus sur la fenêtre commandes, on peut toujours rappeller les commandes avec ctrl+p et ctrl+n

Changer la taille d'une fenêtre: winheight nom +-nbr lignes

Mise à jour:
- de l'écran: ctrl+l
- de la fenêtre source: update

Cosmétique:
- help set tui border-mode / active-border-mode / border-kind
- On peut également voir les paramètres avec show à la place de set

Mode single
- ctrl-x s pour entrer dans le mode single. Toutes les commandes nécessitent désormais l'appui d'une seule touche.
- c : continue , d : frame down , u : frame up , f : finish ,s : step , n : next , r : run , v : affiche les locales, w : where
- q : quitter le mode single. (ctrl-x s à nouveau fonctionne également)

Bien entendu, les raccourcis claviers de readline s'appliquent toujours, sauf en mode single.

Sortie d'un programme sur un tty différent

Les sorties textes qui se mélangent aux données GDB ne sont pas pratiques. Il faut donc les rediriger vers un autre terminal.

La commande tty dev positionne le stdin & stdout pour la prochaine exécution.

Sous un Unix, pas de problème, il sufit de lancer la commande tty sous GDB, en indiquant le tty désiré (/dev/tty1 par exemple)

Sous Cygwin, avant de pouvoir utiliser cette commande, il faut ajouter à la variable locale CYGWIN le paramètre tty
- Cette opération est à faire avant de lancer le shell Cygwin.
- Le mieux est de copier cygwin.bat et d'ajouter dedans: set CYGWIN=tty
- Je vous conseille de copier le cygwin, car dans certains cas, il peut être préférable de ne pas utiliser le support termio de Cygwin.
- Notamment, il semble qu'il ne faille pas l'utiliser avec xterm ou rxvt.
- On peut très bien utiliser screen en mode tty : les sessions créées dans screen ont un tty tout à fait valide.
- Si tout s'est bien passé, une fois le shell lancé, vous pouvez tester:

~$ tty
/dev/tty0

Je ne savais pas où coller ça

-mno-cygwin : argument du gcc Cygwin pour ne pas compiler avec les dépendances Cygwin.
- C'est dans la faq de Cygwin, mais ma bonté me perdra.

N'hésitez pas à abuser des abréviations
- par exemple: info breakpoints s'abrège en i b
- en général, une seule lettre suffit pour les commandes les plus courantes.

Choisir/afficher la base utilisée pour les entrées/sorties.
- set/show input-radix : pour les entrées, à faire suivre de la base désirée (8, 10 ou 16)
- set/show output-radix : idem que ci-dessus, pour les sorties de GDB.
- set/show radix : idem que ci-dessus, pour les entrées/sorties de GDB.

Coredump et puis s'en va

C'est un billet qui a demandé pas mal de synthèse. Je pense avoir fait le tour du plus important. N'hésitez pas à compléter en commentaire si je suis passé à côté de quelque chose.

GDB possède bien plus de possibilités que ce qui a été évoqué ici. Le mieux est de lire la doc GNU officielle, très claire et agréable. Près de 450 pages tout de même, et pas de blabla inutile.