Appendice C - Come segnalare i bug

Come si segnalano i bug?

Prima, prova l'ultimo CVS, forse il tuo bug è già stato corretto. Le istruzioni per scaricare tramite CVS (facili) si trovano sulla nostra homepage.

Se non è d'aiuto: leggi Appendice D, e altri documenti. Se il tuo problema non è conosciuto o non si risolve con le nostre istruzioni, allora segnala il bug:

Dove?

Iscriviti alla mailing list mplayer-users:
    http://mplayerhq.hu/mailman/listinfo/mplayer-users
e manda la tua segnalazione a:
    mplayer-users@mplayerhq.hu
Non accettiamo CC: quindi per favore iscriviti!!!

Non mandare segnalazioni di bug direttamente all'indirizzo privato degli autori!!! Stiamo lavorando insieme sul codice, quindi tutti sono interessati. Comunque molte volte gli utenti conoscono la soluzione (problemi di configurazione del sistema, cattivi driver ecc), perfino quando noi pensiamo sia un bug nel nostro codice. La lingua di questa lista è l' INGLESE!

Per favore descrivi il tuo problema in dettaglio, con esempi ecc, e non dimenticare di includere queste:

Cosa?

1. Le informazioni sul sistema, cosa vogliamo sempre sapere:

2. Hardware & driver:

Per problemi/errori di compilazione

3. questi file:

Per problemi di riproduzione:

3. L'output di mplayer al livello di verbosità 1 (-v)

    mplayer -v [opzioni] nomefile &> mplayer.log

4. Se il problema è specifico ad uno o più file, allora per favore mandaci il file a:

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

Manda anche un piccolo file .txt con lo stesso nome dell'altro file, dove descrivi il tuo problema!
Di solito i primi 1-5 MB del file sono abbastanza per riprodurre il problema, ma prima dovresti provare questo:

   dd if=tuofile of=piccolofile bs=1k count=1024

(questo taglierà il primo 1MB di 'tuofile' e lo salverà in 'piccolofile') Quindi riprova con il file piccolo, e se il bug è ancora presente allora è abbastanza mandare quest'ultimo.
Non mandare MAI questi file via mail! Caricalo, e manda solo il percorso/nomefile su FTP. Se il file è presente sulla rete allora è sufficiente mandare l' URL _esatta_ !

5. Per crash (segfault, SIGILL, signal 4 ecc):

Se hai il coredump del crash, vedi 5.a, altrimenti 5.b:

5.a: Per favore stampaci il coredump (se è stato creato).

Come: per favore crea il seguente file di comandi:

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

Quindi semplicemente esegui la seguente linea di comando:

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

5.b.: esegui MPlayer in gdb:

Ri-compila mplayer col codice di debug abilitato:
./configure --enable-debug
make

[al prompt di shell root/utente]
    # gdb mplayer
[al prompt gdb:]
    > run -v [opzioni-per-mplayer] nomefile
... (aspetta finche va in crash)
    > bt
    > disass $eip-32 $eip+32
Mandaci tutto l'output delle cose sopra!

In generale:

Se qualcosa è grande (log ecc) allora è meglio caricarlo sull' ftp (gzippato), e includere solo il percorso/nomefile nella segnalazione di bug!

So quello che sto facendo...

Se hai fatto un appropriata segnalazione seguendo i passi sopra, e sei sicuro che sia un bug di mplayer, non un problema del compilatore o un file danneggiato, hai già letto la documentazione e non hai trovato la soluzione, i tuoi driver del suono sono ok, allora puoi voler iscriverti alla lista mplayer-advusers e mandare lì la tua segnalazione per avere una migliore e più rapida risposta. Ma SEI AVVISATO: se mandi domande da newbie o con risposte presenti nella documentazione, sarai cacciato immediatamente, invece di avere una risposta!!! Quindi non ti arrabbiare con noi, iscriviti a -advusers solo se sai veramente cosa stai facendo e ti senti un utente o sviluppatore avanzato di mplayer. (e su come iscriversi: scoprilo! se sei veramente un utente avanzato, non dovrebbe essere un problema per te...)