A.6. Was berichtet werden soll
Zurück | Anhang A. Wie Fehler (Bugs) berichtet werden | Weiter

## A.6. Was berichtet werden soll

Du wirst wahrscheinlich Logdateien, Konfigurationsinformationen und Beispieldateien in deinen Fehlerbericht aufnehmen müssen. Werden einige von ihnen ziemlich groß, ist es besser, wenn du sie auf unseren FTP-Server hochlädst, und zwar in komprimierter Form (gzip und bzip2 bevorzugt). Gib dann in deinem Fehlerbericht nur den Pfad- und den Dateinamen an. Unsere Mailinglisten haben ein Nachrichten-Größenlimit von 80k, wenn du etwas größeres hast, musst du es komprimieren und hochladen.

### A.6.1. Systeminformationen

- Deine Linuxdistribution, Betriebssystem und Version, z.B.:

  - Red Hat 7.1

  - Slackware 7.0 + Entwicklerpakete von 7.1 ...

- Kernelversion:

      uname -a

- libc-Version:

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

- gcc- und ld-Versionen:

      gcc -v
      ld -v

- binutils-Version:

      as --version

- Wenn du Probleme mit dem Vollbildmodus hast:

  - Window-Manager-Typ und Version

- Wenn du Probleme mit XVIDIX hast:

  - Farbtiefe von X:

        xdpyinfo | grep "depth of root"

- Wenn nur die GUI fehlerhaft ist:

  - GTK-Version

  - GLIB-Version

  - GUI-Situation, in welcher der Fehler auftritt

### A.6.2. Hardware und Treiber

- CPU-Info (funktioniert nur unter Linux):

      cat /proc/cpuinfo

- Videokartenhersteller und -modell, z.B.:

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

  - Matrox G400 DH 32MB SGRAM

- Videotreibertyp und -version, .z.B.:

  - eingebauter Treiber von X

  - nVidia 0.9.623

  - Utah-GLX CVS 2001-02-17

  - DRI von X 4.0.3

- Soundkartentyp und -treiber, z.B.:

  - Creative SBLive! Gold mit OSS-Treiber von oss.creative.com

  - Creative SB16 mit Kernel-OSS-Treibern

  - GUS PnP mit OSS-Emulation von ALSA

- Füge bei Linuxsystemen im Zweifel die Ausgabe von lspci -vv bei.

### A.6.3. Configure-Probleme

Wenn du Fehlermeldungen beim Aufruf von ./configure bekommst oder die automatische Erkennung von etwas fehlschlägt, so lies `config.log`. Du könntest dort die Antwort finden, zum Beispiel mehrere Versionen derselben Bibliothek, die gemischt auf deinem System vorliegen, oder du hast vergessen, das Entwicklerpaket (die mit dem Suffix -dev) zu installieren. Wenn du denkst, dass es sich um einen Fehler handelt, binde `config.log` in deinen Fehlerbericht ein.

### A.6.4. Compilierungsprobleme

Bitte füge diese Dateien an:

- config.h

- config.mak

### A.6.5. Wiedergabeprobleme

Bitte füge die Ausgabe von MPlayer im ausführlichen Modus bei Level 1 an, denke aber daran, die Ausgabe nicht zu kürzen, wenn du sie in deine Mail einfügst. Die Entwickler benötigen alle Ausgaben, um das Problem angemessen zu untersuchen. Du kannst die Ausgabe folgendermaßen in eine Datei ausgeben:

    mplayer -v Optionen Dateiname > mplayer.log 2>&1

Wenn dein Problem speziell mit einer oder mehreren Dateien zu tun hat, lade diese bitte hoch nach: ftp://upload.mplayerhq.hu/MPlayer/incoming/

Lade bitte auch eine kleine Textdatei hoch, die denselben Basisnamen wie deine Datei hat, mit der Erweiterung .txt. Beschreibe dort das Problem, das du mit dieser speziellen Datei hast und gib sowohl deine Emailadresse als auch die Ausgabe von MPlayer im ausführlichen Modus bei Level 1 an. Normalerweise reichen die ersten 1-5 MB einer Datei aus, um das Problem zu reproduzieren. Um ganz sicher zu gehen, bitten wir dich, folgendes zu tun:

    dd if=deine-datei of=kleine-datei bs=1024k count=5

Dies wird die ersten fünf Megabyte von 'deine-datei' nehmen und nach 'kleine-datei' schreiben. Probiere es dann erneut mit dieser kleinen Datei, und wenn der Fehler noch immer auftritt, ist dieses Beispiel für uns ausreichend. Bitte sende niemals solche Dateien via Mail! Lade sie hoch und schicke nur den Pfad/Dateinamen der Datei auf dem FTP-Server. Ist die Datei im Netz verfügbar, reicht es, die exakte URL zu schicken.

### A.6.6. Abstürze

Du musst MPlayer in gdb aufrufen und uns die komplette Ausgabe schicken, oder du kannst, wenn du ein `core`-Dump des Absturzes hast, nützliche Informationen aus der Core-Datei extrahieren, und zwar folgendermaßen:

#### A.6.6.1. Wie man Informationen eines reproduzierbaren Absturzes erhält

Compiliere MPlayer neu mit Debugging-Code aktiviert:

    ./configure --enable-debug=3
    make

und rufe dann MPlayer innerhalb gdb auf mit:

    gdb ./mplayer

Du befindest dich nun innerhalb gdb. Gib ein

    run -v Optionen-an-mplayer Dateiname

und reproduziere den Absturz. Sobald du das getan hast, wird gdb zur Eingabeaufforderung zurückkehren, wo du folgendes eingeben musst:

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

#### A.6.6.2. Wie man aussagekräftige Informationen aus einem Core-Dump extrahiert

Erzeuge die folgende Befehlsdatei:

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

Führe dann einfach folgenden Befehl aus:

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

Zurück | Nach oben | Weiter
A.5. Wo Fehler berichtet werden sollen | Zum Anfang | A.7. Ich weiß, was ich tue...