B.4. Que rapporter
Précédent | Annexe B. Comment rapporter les bogues | Suivant

## B.4. Que rapporter

Vous pouvez avoir besoin d'inclure des fichiers de log, de configuration ou d'échantillon. Si certains sont très gros alors il vaut mieux les uploader sur notre serveur FTP en format compressé (gzip et bzip2 préférés) et indiquer uniquement leur chemin et nom dans le rapport de bug. Nos listes de diffusion ont une taille de message limite de 80k, si vous avez quelque chose de plus gros vous devrez le compresser ou l'uploader.

### B.4.1. Information Système

- Votre distribution Linux ou système d'exploitation et version c-a-d:

  - Red Hat 7.1

  - Slackware 7.0 + paquets de développement de la 7.1 ...

- version du noyau:

      uname -a

- version de la libc:

      ls -l /lib/libc[.-]*

- versions de gcc et ld :

      gcc -v
      ld -v

- version des binutils:

      as --version

- Si vous avez des problèmes avec le mode plein-écran:

  - Type de gestionnaire de fenêtre et version

- Si vous avez des problèmes avec XVIDIX:

  - profondeur de couleur de X:

        xdpyinfo | grep "depth of root"

- Si seule la GUI est boguée:

  - version de GTK

  - version de GLIB

  - version de libpng

  - Endroit de la GUI où le bogue se produit

### B.4.2. Matériel et pilotes

- Info CPU (cela ne fonctionne que sous Linux):

      cat /proc/cpuinfo

- Fabricant et modèle de votre carte vidéo, ex.:

  - chip ASUS V3800U: nVidia TNT2 Ultra pro 32Mo SDRAM

  - Matrox G400 DH 32Mo SGRAM

- Type et version des drivers vidéo, ex.:

  - Pilote X intégré

  - nVidia 0.9.623

  - Utah-GLX CVS 2001-02-17

  - DRI de X 4.0.3

- Type et version des drivers son, ex.:

  - Creative SBLive! Gold avec pilote OSS de oss.creative.com

  - Creative SB16 avec pilotes noyau OSS

  - GUS PnP avec émulation OSS ALSA

- En cas de doute, joignez y le résultat de lspci -vv sur les systèmes Linux.

### B.4.3. Problèmes de configuration

Si vous rencontrez des erreurs pendant l'éxecution de ./configure, ou si l'autodetection ou autre chose échoue, lisez `configure.log`. Vous pouvez y trouver la réponse, par exemple des versions multiples de la même librairie mélangés dans votre système, ou vous avez oublié d'installer les paquets de développement (ceux avec le suffixe -dev). Si vous pensez que c'est un bogue, incluez `configure.log` dans votre rapport de bogue.

### B.4.4. Problèmes de compilation

Veuillez inclure ces fichiers:

- config.h

- config.mak

Uniquement si la compilation échoue à partir d'un de ces répertoires, incluez ces fichiers:

- Gui/config.mak

- libvo/config.mak

- libao2/config.mak

### B.4.5. Pour les problèmes de lecture

Merci d'inclure la sortie de MPlayer en verbosité niveau 1, mais rappelez-vous de ne pas tronquer la sortie en le copiant dans votre mail. Les développeurs ont besoin de tous les messages pour diagnostiquer correctement un problème. Vous pouvez rediriger la sortie dans un fichier comme ceci:

    mplayer -v options nomfichier > mplayer.log 2>&1

Si votre problème est spécifique à un ou plusieurs fichiers, alors merci d'uploader le(s) fautif(s) sur: ftp://mplayerhq.hu/MPlayer/incoming/

Uploadez aussi un petit fichier texte ayant le même nom que votre fichier mais avec une extension .txt. Décrivez le problème que vous avez avec ce fichier et incluez votre adresse e-mail ainsi que la sortie de MPlayer en verbosité niveau 1. Généralement les premiers 1-5 MB sont suffisants pour reproduire le problème, mais pour être sûrs nous vous demandons de faire:

    dd if=votrefichier of=petitfichier bs=1024k count=5

Cela coupera les 5 premiers Mo de 'votrefichier' et les sauvera dans 'petitfichier'. Essayez alors de lire le petit fichier, et si le bogue persiste vous pouvez envoyer le petit fichier par ftp. N'envoyez jamais ces fichiers par e-mail SVP ! Envoyez les par FTP, et postez seulement leur nom/adresse sur ce FTP. Si le fichier est accessible en téléchargement, envoyez seulement son adresse exacte.

### B.4.6. Plantages

Vous devez lancer MPlayer à l'intérieur de gdb et nous envoyer le résultat complet ou si vous avez un core dump du plantage vous pouvez extraire des informations utiles du fichier `core`. Voici comment:

#### B.4.6.1. Comment conserver les informations avec un plantage reproduisible

Recompilez MPlayer avec les instructions de déboguage:

    ./configure --enable-debug=3
    make

et ensuite lancez MPlayer à l'intérieur de gdb en utilisant:

    gdb ./mplayer

Vous êtes maintenant à l'intérieur de gdb. Tapez:

    run -v options-pour-mplayer nomfichier

et reproduisez votre plantage. Aussitôt que vous l'avez fait, gdb va vous renvoyer à la ligne de commande où vous devrez entrer

    bt
    disass $pc-32 $pc+32
    info all-registers

#### B.4.6.2. Comment extraire les informations significatives d'un core dump

Veuillez créer le fichier de commande suivant:

    bt
    disass $pc-32 $pc+32
    info all-registers

Ensuite exécutez simplement:

    gdb mplayer --core=core -batch --command=fichier_de_commande > mplayer.bug

Précédent | Niveau supérieur | Suivant
B.3. Où rapporter les bogues | Sommaire | B.5. Je sais ce que je fait...