A.6. 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 HTTP en format compressé (gzip et bzip2 préférés) et indiquer uniquement leur chemin et nom dans le rapport de bogue. 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.

A.6.1. Information Système

  • Votre distribution Linux ou système d'exploitation et version, ex. :

    • 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 seul le GUI (ou IHM - Interface Homme Machine) est boguée :

    • Version de GTK

    • Version de GLIB

    • Position dans le GUI au moment où le bogue se produit

A.6.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. :

    • Puce 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 avec X 4.0.3

  • Type de carte son et pilote, 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.

A.6.3. Problèmes de configuration

Si vous rencontrez des erreurs pendant l'éxecution de ./configure, ou si l'auto-détection ou autre chose échoue, lisez config.log. Vous pourriez y trouver la réponse, par exemple des versions multiples mélangées de la même librairie 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 config.log dans votre rapport de bogue.

A.6.4. Problèmes de compilation

Veuillez inclure ces fichiers :

  • config.h

  • config.mak

A.6.5. 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 : http://streams.videolan.org/upload/

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 Mo sont suffisants pour reproduire le problème, mais pour être sûrs nous vous demandons de faire :

dd if=votre_fichier of=petit_fichier bs=1024k count=5

Cela coupera les 5 premiers Mo de 'votre_fichier' et les sauvera dans 'petit_fichier'. 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 le chemin/nom des fichiers sur le serveur FTP. Si le fichier est accessible en téléchargement à partir d'Internet, alors envoyez seulement son adresse URL exacte.

A.6.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 :

A.6.6.1. Comment conserver les informations sur un plantage reproductible

Recompilez MPlayer avec les instructions de déboguage activées :

./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

Utilise disass $pc-32 $pc+32 avec les anciennes versions de gdb.

A.6.6.2. Comment extraire les informations significatives d'un core dump

Créer le fichier de commande suivant :

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

Ensuite exécutez simplement la commande :

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