C függelék - Hogyan jelezd a hibákat

Hogyan küldj bugreport-ot?

Először is nézd meg a CVS verziót, mert lehet hogy az általad talált hibát már kijavítottuk. A CVS letöltésére vonatkozó utasításokat a honlapunkon, a ``download" szekcióban találhatod meg.

Ha ez nem segített a probléma megoldásában, akkor olvasd el a D fejezetet, és a dokumentáció többi részét. Ha a problémád nem ismert, vagy a mi tanácsaink alapján nem oldódik meg, akkor jelentsd be:

Hol jelentheted be?

Iratkozz fel az mplayer-users levelezési listára:

    http://mplayerhq.hu/mailman/listinfo/mplayer-users

és küldd a bugreportot a

    mplayer-users@mplayerhq.hu

címre. Nem fogunk CC-zni, légy szíves iratkozz fel a listára!!!

Ne küldj bugreportot közvetlenül valamelyik készítőnek!!! Együtt dolgozunk a kódon, ezért mindenkit érdekelhet a hiba. Előfordulhat, hogy más felhasználók már tudják a megoldást a problémádra, (konfigurációs hiba, rossz driver stb.). Ha a levelezési listára írsz hamarabb juthatsz segítséghez, hiszen azt több ember olvassa.

Kérlek részletesen írd le a problémádat, példákkal, magyarázatokkal, stb., és ne felejtsd el ezeket se mellékelni:

Mit tartalmazzon a bugreport?

1. Mindenképpen küldj _részletes_ adatokat a rendszeredről:

2. Hardver adatok és eszközmeghajtók:

Fordítási problémákhoz, hibákhoz:

3. Kérlek küldd el az alábbi file-okat:

Lejátszási problémákhoz:

3. Az MPlayer outputot 1-es debug szinten (-v)

    mplayer -v [options] filenév &> mplayer.log

4. Ha a probléma csak egy, vagy néhány file-nál jelentkezik, töltsd fel a file-t (file-okat) ide:

   ftp://mplayerhq.hu/MPlayer/incoming/

Tölts fel egy (a fájloddal azonos nevű) kis .txt fájlt, amiben leírod hogy mi a baj, plusz egy mplayer -v kimenet, és az email címed!
Általában az első 1-5 MB elég, hogy reprodulkáljuk a problémát, de először probáld ki:

   dd if=a_file of=kis_file bs=1024k count=5

(ez az 'a_file' első 5 MB-ját elmenti 'kis_file' néven') Ekkor probáld lejátszani a keletkező file-t, és ha a bug jelentkezik, akkor elég lesz csak ennyit feltölteni.

SOHA ne küldj file-t levélben! Töltsd fel, és csak a file nevét küldd el! Ha a file a neten hozzaférhető, akkor a _pontos_ URL elküldése is elég!

5. Segfault, SIGILL, signal 4, stb esetén:

Ha keletkezett coredump, akkor lásd 5.a pont, máskülönben 5.b:

5.a. Küldd el a coredump tartalmát (ha volt).

Hogyan: Hozd létre a következő parancs file-t:

disass $eip-32 $eip+32
printf "eax=%08lX\n",$eax
printf "ebx=%08lX\n",$ebx
printf "ecx=%08lX\n",$ecx
printf "edx=%08lX\n",$edx
printf "esp=%08lX\n",$esp
printf "ebp=%08lX\n",$ebp
printf "edi=%08lX\n",$edi
printf "esi=%08lX\n",$esi

Aztán írd be a következőt:

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

5.b.: futtasd MPlayert gdb-n keresztül:

Fordítsd újra az MPlayer-t engedélyezve a hibakereső módot:
./configure --enable-debug=3
make

[a promptnál:]

    # gdb mplayer
[a gdb promptnál:]
   > run -v [mplayer opciói] filenév
... (várj amíg össze nem omlik)
    > bt
    > disass $eip-32 $eip+32
A fenti parancsok teljes kimenetét küldd el nekünk!

Általánosan:

Ha valami nagy reportot akarsz küldeni (pl.: log-ok, stb.), akkor jobb ha FTP-re töltöd fel (gzip -9 ..), és csak a file nevét, elérhetőségét írod bele a bugreportba!