mpv/DOCS/it/bugreports.html

241 lines
10 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<!-- Synced with english version 1.53 -->
<HEAD>
<TITLE>Segnalare bug - MPlayer - Movie Player per Linux</TITLE>
<LINK REL="stylesheet" TYPE="text/css" HREF="../default.css">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
</HEAD>
<BODY>
<H1><A NAME="appendix_b">Appendice B - Come segnalare i bug</A></H1>
<P>Buoni bug-report sono sempre un valido contributo nello sviluppo di qualsiasi
progetto software. Ma proprio come lo scrivere del buon software, anche il fare
una buona segnalazione di un problema include del lavoro.
Per favore, considerate che la maggior parte degli sviluppatori <20> molto occupata
e riceve una quantita' oscena di email. Quindi sebbene il vostro feedback sia
importantissimo per migliorare MPlayer e molto apprezzato, dovete capire che
ci dovete fornire <B>tutte</B> le informazioni che richiediamo e seguire esattamente
le istruzioni in questo documento.</P>
<H2><A NAME="fix">B.1 Come risolvere i bug</A></H2>
<P>Se pensate di avere le capacita' necessarie siete invitati a provare a risolvere
voi stessi il bug. O forse lo avete gia' fatto? Leggete
<A HREF="../tech/patches.txt">questo breve testo</A> (in inglese) per scoprire come
avere il proprio codice incluso in MPlayer. Le persone sulla mailing list
<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</A>
vi potranno aiutare se avete dei problemi.</P>
<H2><A NAME="report">B.2 Come segnalare i bug</A></H2>
<P>Prima, prova l'ultima versione CVS di mplayer, forse il tuo bug <20> gi<67> stato corretto.
Lo sviluppo avanza molto velocemente, la maggior parte dei problemi presenti nelle versioni
ufficiali sono segnalati entro ore o minuti, quindi utilizza <B>solo la versione CVS</B>
per segnalare i bug. Questo include anche le distribuzioni binarie di MPlayer.
Non segnalare bug utilizzando le versioni RPM o Debian.
Le istruzioni per scaricare tramite CVS si trovano in fondo a <A HREF="http://www.mplayerhq.hu/homepage/dload.html">questa pagina</A>
o nel file README.
Se questo non <20> d'aiuto fai riferimento alla <A HREF="documentation.html#known_bugs">lista dei bug noti</A>, ed al resto della documentazione.
Se il tuo problema non <20> conosciuto o non si risolve con le nostre istruzioni, allora per favore segnala il bug.</P>
<H2><A NAME="where">B.3 Dove si segnalano i bug?</A></H2>
<P>Iscriviti alla mailing list mplayer-users:<BR>
&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A><BR>
e manda la tua segnalazione a:<BR>
&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="mailto:mplayer-users@mplayerhq.hu">mplayer-users@mplayerhq.hu</A><BR>
Per favore nota che noi non manderemo le vostre mail in CC (carbon-copy) nella lista, quindi
<EFBFBD> una buona idea iscriversi alla mailing list per ricevere veramente una risposta.</P>
<P>Per favore non mandare segnalazioni di bug privatamente a singoli sviluppatori.
Il nostro <20> un lavoro di comunit<69> e quindi potrebbero esserci pi<70> persone interessate.
Inoltre a volte altri utenti hanno gi<67> avuto il tuo stesso problema e hanno una soluzione
per evitarlo anche quando <20> un bug del codice di mplayer.
La lingua di questa lista <20> l' <strong>Inglese</strong></P>
<P>Per favore descrivi il tuo problema in dettaglio, con esempi ecc, e non dimenticare di includere
queste importanti informazioni:</P>
<H2><A NAME="what">B.4 Cosa segnalare?</A></H2>
<P>Potrebbe essere necessario allegare file di log, di configurazione o esempi alla
tua segnalazione. Se questi sono grossi, <20> preferibile caricarli sul nostro
<A HREF="ftp://mplayerhq.hu/MPlayer/incoming">server FTP</A> in formato compresso
(preferibilmente gzip o bzip) ed includere solo il percorso ed il nome del file
nella segnalazione del bug. Le nostre mailing list hanno un limite di 80k sulla
dimensione dei messaggi, se hai qualcosa di pi<70> grosso devi comprimerlo o caricarlo.</P>
<H3><A NAME="system">B.4.1 Informazioni sul sistema</H3>
<UL>
<LI>La tua distribuzione Linux o il tuo sistema operativo indicando la versione es.:<BR>
<UL>
<LI>RedHat 7.1</LI>
<LI>Slackware 7.0 + pacchetti di sviluppo dalla 7.1 ...</LI>
</UL>
</LI>
<LI>versione kernel:<BR>
<CODE>uname -a</CODE></LI>
<LI>versione libc:<BR>
<CODE>ls -l /lib/libc[.-]*</CODE></LI>
<LI>versione X:<BR>
<CODE>X -version</CODE></LI>
<LI>versione gcc e ld:<BR>
<CODE>gcc -v<BR>
ld -v</CODE></LI>
<LI>versione binutils:<BR>
<CODE>as --version</CODE></LI>
<LI>Se hai problemi con la modalit<69> a pieno schermo:
<UL>
<LI>Tipo e versione del window manager</LI>
</UL>
</LI>
<LI>Se hai problemi con XVIDIX:
<UL>
<LI>Profondit<EFBFBD> di colore di X:<BR>
<CODE>xdpyinfo | grep "depth of root"</CODE></LI>
</UL>
</LI>
<LI>se solo la GUI <20> difettosa :
<UL>
<LI>versione GTK</LI>
<LI>versione GLIB</LI>
<LI>versione libpng</LI>
<LI>situazione della GUI in cui si manifesta il bug</LI>
</UL>
</LI>
</UL>
<H3><A NAME="hardware">B.4.2 Hardware e driver</A></H3>
<UL>
<LI>informazioni sulla CPU (questo funziona solo su Linux):<BR>
<CODE>cat /proc/cpuinfo</CODE></LI>
<LI>Produttore e modello della scheda video, es.:
<UL>
<LI>chip ASUS V3800U: nVidia TNT2 Ultra pro 32MB SDRAM</LI>
<LI>Matrox G400 DH 32MB SGRAM</LI>
</UL>
</LI>
<LI>Tipo e versione del driver video, es.:
<UL>
<LI>driver di X</LI>
<LI>nvidia 0.9.623</LI>
<LI>Utah-GLX CVS 2001-02-17</LI>
<LI>DRI di X 4.0.3</LI>
</UL>
</LI>
<LI>Tipo e driver della scheda sonora, es.:
<UL>
<LI>Creative SBLive! Gold con driver OSS da oss.creative.com</LI>
<LI>Creative SB16 con driver OSS del kernel</LI>
<LI>GUS PnP con emulazione OSS di ALSA</LI>
</UL>
</LI>
<LI>se non sei sicuro manda l'output di lspci -v</LI>
</UL>
<H3><A NAME="configure">B.4.3 Problemi con configure</A></H3>
<P>Se hai errori durante l'esecuzione di <CODE>./configure</CODE>, o il rilevamento
di qualche elemento non ha successo, leggi <CODE>configure.log</CODE>: potresti
tovarci la soluzione, ad esempio pi<70> versioni della stessa libreria presenti nel
sistema, oppure hai dimenticato di installare il pacchetto di sviluppo (quello con
il suffisso -dev). Se pensi sia un bug, includi <CODE>configure.log</CODE> nella
tua segnalazione.
<H3><A NAME="compilation">B.4.4 Problemi di compilazione</A></H3>
<P>Per favore includi questi file:</P>
<UL>
<LI><CODE>config.h</CODE></LI>
<LI><CODE>config.mak</CODE></LI>
</UL>
Includi questi file solo se la compilazione fallisce in una di queste directory:
<UL>
<LI><CODE>Gui/config.mak</CODE></LI>
<LI><CODE>libvo/config.mak</CODE></LI>
<LI><CODE>libao2/config.mak</CODE></LI>
</UL>
<H3><A NAME="playback">B.4.5 Problemi in riproduzione</A></H3>
<P>Per favore includi l'output di mplayer al livello di verbosit<69> 1 ma ricordati di
<B>non tagliare l'output</B> quando lo incolli nella tua mail. Gli sviluppatori hanno
bisogno di tutti i messaggi per scoprire il problema. Puoi ridirezionare l'output
in un file in questo modo:</P>
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -v [opzioni] [nomefile] &gt; mplayer.log 2&gt;&amp;1</CODE></P>
<P><B><I>Se il problema <20> specifico ad uno o pi<70> file,
allora per favore mandaci il file a:</I></B></P>
<P><CODE>&nbsp;&nbsp;&nbsp;ftp://mplayerhq.hu/MPlayer/incoming/</CODE></P>
Manda anche un piccolo file di testo con lo stesso nome del tuo file,
con estensione .txt. Descrivi qui il tuo problema e includi l'output del comando mplayer -v file e il tuo indirizzo e-mail.<BR>
Di solito i primi 1-5 MB del file sono abbastanza per riprodurre
il problema, ma per esserne sicuri ti chiediamo di fare questo:
<P><CODE>&nbsp;&nbsp;&nbsp;dd if=tuofile of=piccolofile bs=1024k count=5</CODE></P>
Questo taglier<65> i primi 5MB di 'tuofile' e lo salver<65> in 'piccolofile'.
Quindi riprova con il file piccolo, e se il bug <20> ancora presente
allora per noi <20> abbastanza quest'ultimo.<BR>
Per favore non <strong>mandare mai</strong> questi file via mail. Caricalo, e manda solo
il percorso/nomefile su FTP.
Se il file <20> presente sulla rete allora <20> sufficiente mandare l' URL
<strong>esatta</strong>.
<H3><A NAME="crash">B.4.6 Crash</A></H3>
<P>Devi eseguire MPlayer in <CODE>gdb</CODE> ed inviarci l'output completo o, se
hai un core dump del crash, puoi estrarre delle informazioni utili dal file
<CODE>Core</CODE>. Procedi cosi:</P>
<H3><A NAME="debug">B.4.6.1 Come conservare informazioni su un crash riproducibile</A></H3>
<P>Ri-compila mplayer col codice di debug abilitato:</P>
<P><CODE>./configure --enable-debug=3<BR>
make
</CODE></P>
<P>quindi esegui mplayer all'interno di gdb, in questo modo:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE># gdb mplayer</CODE></P>
<P>Ora sei all'interno di gdb. Scrivi:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>&gt; run -v [opzioni-per-mplayer] nomefile</CODE></P>
<P>e riproduci il tuo crash. Appena fatto, gdb ti rimander<65> al prompt, dove devi scrivere</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>&gt; bt<BR>
&nbsp;&nbsp;&nbsp;&nbsp;disass $pc-32 $pc+32<BR>
&nbsp;&nbsp;&nbsp;&nbsp;info all-registers</CODE></P>
<P>e mandaci l'output completo.
</P>
<H4><A NAME="core">B.4.6.2 Come estrarre informazioni significative da un core dump</A></H4>
<P>Per favore crea il seguente file di comandi:</P>
<P><CODE>disass $pc-32 $pc+32<BR>
info all-registers</CODE></P>
<P>Quindi semplicemente esegui la seguente linea di comando:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>gdb mplayer --core=core -batch --command=file_comandi &gt; mplayer.bug</CODE></P>
<H2><A NAME="advusers">B.5 So quello che sto facendo...</A></H2>
<P>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<67>
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<70> rapida risposta. Ma sei avvisato: se mandi
domande da newbie o con risposte presenti nella documentazione, sarai ignorato invece
di avere una risposta appropriata. 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.
Se hai queste caratteristiche non ti dovrebbe essere difficile scoprire come
iscriverti...
</P>
</BODY>
</HTML>