summaryrefslogtreecommitdiffstats
path: root/DOCS/xml/it/bugreports.xml
blob: 690d09ae5d42abc4f3b161ed238c85b4fb55ad50 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
<?xml version="1.0" encoding="utf-8"?>
<!-- synced with r23225 -->
<appendix id="bugreports">
<title>Come segnalare i bug (errori)</title>

<para>
Buone segnalazioni di errori sono un contributo molto valido per lo sviluppo di
un qualsiasi progetto software. Ma proprio come nello scrivere un buon
software, scrivere buoni rapporti sui problemi richiede dell'impegno. Per favore
considera che molti sviluppatori sono estremamente impegnati e ricevono immensi
volumi di email. Perciò, mentre da un lato il tuo feedback è cruciale per
migliorare <application>MPlayer</application> e molto apprezzato, per favore
cerca di capire che devi fornire <emphasis role="bold">tutte</emphasis> le
informazioni che chiediamo e seguire fedelmente le istruzioni qui documentate.
</para>


<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->


<sect1 id="bugreports_security">
<title>Come segnalare i bug di sicurezza (errori)</title>

<para>
Nel caso in cui tu abbia trovato un bug pericoloso e vuoi fare la cosa giusta e
lasciarcelo correggere prima di sfruttarlo, saremmo felici di avere la tua
segnalazione di sicurezza a
<ulink url="mailto:&#115;&#101;&#99;&#117;&#114;&#105;&#116;&#121;&#64;&#109;&#112;&#108;&#97;&#121;&#101;&#114;&#104;&#113;&#46;&#104;&#117;">&#115;&#101;&#99;&#117;&#114;&#105;&#116;&#121;&#64;&#109;&#112;&#108;&#97;&#121;&#101;&#114;&#104;&#113;&#46;&#104;&#117;</ulink>.
Per favore aggiungi nell'oggetto [SECURITY] o [ADVISORY].
Assicurati che il rapporto contenga l'analisi completa e dettagliata del bug.
L'invio di una correzione è decisamente apprezzato.
Per piacere non ritardare la segnalazione per scrivere un exploit che la provi,
puoi inviarlo eventualmente con un'altra mail.
</para>
</sect1>


<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->


<sect1 id="bugreports_fix">
<title>Come correggere i bug</title>

<para>
Se pensi di avere le capacità necessarie, sei esortato a provare a correggere
il bug per conto tuo. O forse lo hai già fatto? Leggi per favore
<ulink url="../../tech/patches.txt">questo breve documento</ulink> per scoprire
come far sì che il tuo codice venga incluso in
<application>MPlayer</application>. Le persone sulla mailing list
<ulink url="http://lists.mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">MPlayer-dev-eng</ulink>
ti aiuteranno se avrai dei dubbi.
</para>
</sect1>


<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->


<sect1 id="bugreports_regression_test">
<title>Come fare delle prove retroattive usando Subversion</title>

<para>
Un problema che può capitare delle volte è 'prima funzionava, ora non
funziona più...'.
C'è una procedura passo passo per cercare di scoprire dove il problema si sia
presentato. <emphasis role="bold">Non</emphasis> è destinata agli utenti
casuali.
</para>

<para>
Per prima cosa, dovresti scaricare l'alberatura dei sorgenti di MPlayer da
Subversion. Le istruzioni si possono trovare nella
<ulink url="http://www.mplayerhq.hu/design7/dload.html#svn">sezione su Subversion nella pagina dei download</ulink>.
</para>

<para>
Troverai ora un immagine dell'archivio Subversion dentro alla directory
mplayer/, dal lato client.
Ora aggiorna questa immagine alla data che desideri:
<screen>
cd mplayer/
svn update -r {"2004-08-23"}
</screen>
Il formato della data è YYYY-MM-DD HH:MM:SS.
Usando questo formato di data ti garantisce di essere in grado di estrarre le
path in base alla data in cui sono state applicate, come
nell'<ulink url="http://lists.mplayerhq.hu/pipermail/mplayer-cvslog/">archivio
MPlayer-cvslog</ulink>.
</para>

<para>
Ora procedi come per un normale aggiornamento:
<screen>
./configure
make
</screen>
</para>

<para>
Per chi sta leggendo e non è un programmatore, il modo più veloce di trovare
il punto dove si è presentato il problema è effettuare una ricerca binaria
&mdash; che significa cercare la data della 'rottura' dividendo ripetutamente a
metà l'intervallo di ricerca.
Per esempio, se il problema si è presentato nel 2003, inizia da metà anno,
poi chiediti "C'è già il problema qui?".
Se sì, retrocedi fino al primo di aprile; se no, vai al primo di ottobre, e
così via.
</para>

<para>
Se hai tanto spazio libero sul disco rigido (una compilazione completa occupa
attualmente 100 MB, e circa 300-350 MB se si abilitano i simboli di debug),
copiati la versione funzionante più vecchia prima di aggiornarla; questo ti
farà risparmiare tempo se devi retrocedere.
(Solitamente bisogna eseguire 'make distclean' prima di ricompilare una versione
precedente, perciò se non ne hai una salvata, dovrai ricompilare tutto quanto
quando ritorni alla verisone attuale.)
</para>

<para>
Dopo aver trovato il giorno in cui è nato l'errore, continua a cercare usando
l'archivio mplayer-cvslog (ordinato per data) e un più preciso aggiornamento
su svn con ora, minuto e secondo:
<screen>
svn update -r {"2004-08-23 15:17:25"}
</screen>
Questo ti permetterà di trovare facilmente la patch esatta che lo ha generato.
</para>

<para>
Se trovi la patch che è stata la causa del problema, hai quasi vinto;
fai un rapporto su
<ulink url="http://bugzilla.mplayerhq.hu/">MPlayer Bugzilla</ulink> o
iscriviti a
<ulink url="http://lists.mplayerhq.hu/mailman/listinfo/mplayer-users">MPlayer-users</ulink>
e postalo là.
C'è anche la possibilità che l'autore intervenga consigliando una correzione.
Puoi anche controllare attentamente la patch fino a quando la costringi a
rivelarti dove stia il bug :-).
</para>
</sect1>


<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->


<sect1 id="bugreports_report">
<title>Come segnalare i bug</title>

<para>
Per prima cosa per favore prova la versione Subversion di
<application>MPlayer</application> più recente visto che in essa il tuo bug
potrebbe già essere stato risolto. Lo sviluppo avanza velocemente, la maggior
parte dei problemi nei rilasci ufficiali sono segnalati in pochi giorni o poche
ore, perciò parti <emphasis role="bold">solo da Subversion</emphasis> per
segnalare i bug. Ciò include i pacchetti compilati di
<application>MPlayer</application>. Le istruzioni per Subversion si possono
trovare in fondo a
<ulink url="http://www.mplayerhq.hu/dload.html">questa pagina</ulink> o nel
README. Se ciò non ti è stato di aiuto, per favore fai riferimento
al resto della
documentazione. Se il tuo problema è sconosciuto oppure non risolvibile con le
nostre indicazioni, allora per favore segnala il bug.
</para>

<para>
Per piacere non inviare segnalazioni di bug ai singoli sviluppatori in privato.
Questo è un lavoro di comunità e quindi ci possono essere varie persone
interessate ad esso. Alcune volte altri utenti hanno già avuto i tuoi problemi
e sanno come aggirare un problema anche quando è un bug nel codice di
<application>MPlayer</application>.
</para>

<para>
Per favore descrivi il tuo problema il più dettagliatamente possibile. Fai un
piccolo lavoro di ricerca per evidenziare le circostanze in cui succede il
problema. Il bug si presenta solo in alcune occasioni? E' specifico per certi
file o tipi di file? Capita solo con un codec e è indipendente dal codec? Puoi
riprodurlo con tutti i driver di uscita? Più informazioni fornisci, maggiori
sono le nostre possibilità di correggere il tuo problema. Per favore non
dimenticare di includere anche le importanti informazioni richieste qui sotto,
altrimenti non saremo in grado di diagnosticare il problema.
</para>

<para>
Una guida eccellente e ben scritta su come fare domande in forum pubblici è
<ulink url="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</ulink>
(<ulink url="http://xoomer.virgilio.it/army1987k">Come porre domande in modo intelligente</ulink>)
di <ulink url="http://www.catb.org/~esr/">Eric S. Raymond</ulink>.
Ce n'è un'altra chiamata
<ulink url="http://www.chiark.greenend.org.uk/~sgtatham/bugs-it.html">Come
segnalare bug efficacemente</ulink>
di <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/">Simon Tatham</ulink>.
Se segui queste linee guida dovresti poter ottenere aiuto.. Ma per favore tieni
conto che tutti noi seguiamo le mailing list volontariamente nel tempo libero.
Siamo molto occupati e non possiamo garantire che otterrai una soluzione per il
tuo problema o anche solo una risposta.
</para>
</sect1>


<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->


<sect1 id="bugreports_where">
<title>Dove segnalare i bug</title>

<para>
Iscriviti alla mailing list MPlayer-users:
<ulink url="http://lists.mplayerhq.hu/mailman/listinfo/mplayer-users"/>
e invia il tuo rapporto sul bug a
<ulink url="mailto:mplayer-users@mplayerhq.hu"/> dove puoi discuterlo.
</para>

<para>
Se preferisci puoi invece usare il nostro bel nuovo
<ulink url="http://bugzilla.mplayerhq.hu/">Bugzilla</ulink>.
</para>

<para>
La lingua di questa lista è l'<emphasis role="bold">inglese</emphasis>.
Per favore segui gli standard delle
<ulink url="http://www.ietf.org/rfc/rfc1855.txt">Linee guida della Netiquette</ulink>
e <emphasis role="bold">non inviare email in HTML</emphasis> ad alcuna delle
nostre mailing list. Verrai semplicemente ignorato bandito. Se non sai cosa sia
una mail in HTML o perché sia il male, leggi questo
<ulink url="http://efn.no/html-bad.html">buon documento</ulink>.
Ti spiega tutto in dettaglio e contiene le istruzioni per disabilitare l'HTML.
Inoltre nota che non rispondiamo in CC (copia carbone) alle persone, quindi è
una buona idea iscriversi per poter effettivamente ricevere la risposta.
</para>
</sect1>


<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->


<sect1 id="bugreports_what">
<title>Cosa riportare</title>

<para>
Potrebbe servire che tu includa nel tuo rapporto sul bug registrazioni,
configurazioni o file di esempio. Se alcune di queste cose sono abbastanza
grandi, è meglio caricarle sul nostro
<ulink url="ftp://upload.mplayerhq.hu/MPlayer/incoming/">server FTP</ulink> in
un formato compresso (si preferiscono gzip e bzip2) e inserisci nel rapporto
solo il nome e il percorso del file. Le nostre mailing list hanno un limite
sulla dimensione di 80k, se hai qualcosa di più grande devi comprimerlo o
caricarlo.
</para>

<!-- ********** -->

<sect2 id="bugreports_system">
<title>Informazioni di Sistema</title>

<para>
<itemizedlist>
<listitem><para>
  La tua distribuzione Linux o il sistema operativo e la versione, per es.:
  <itemizedlist>
    <listitem><para>Red Hat 7.1</para></listitem>
    <listitem><para>Slackware 7.0 + pacchetti sviluppo dalla 7.1 ...</para></listitem>
  </itemizedlist>
</para></listitem>
<listitem><para>
  La versione del kernel:
  <screen>uname -a</screen>
</para></listitem>
<listitem><para>
  La versione di libc:
  <screen>ls -l /lib/libc[.-]*</screen>
</para></listitem>
<listitem><para>
  Le versioni di gcc e di ld:
  <screen>
gcc -v
ld -v<!--
  --></screen>
</para></listitem>
<listitem><para>
  La versione di binutils:
  <screen>as --version</screen>
</para></listitem>
<listitem><para>
  Se hai dei problemi con la modalità a schermo intero:
  <itemizedlist>
    <listitem><para>Il tipo di gestore di finestre e la versione</para></listitem>
  </itemizedlist>
</para></listitem>
<listitem><para>
  Se hai dei problemi con XVIDIX:
  <itemizedlist>
  <listitem><para>
    La profondità colore di X:
    <screen>xdpyinfo | grep "depth of root"</screen>
  </para></listitem>
  </itemizedlist>
</para></listitem>
<listitem><para>
  Se i bug sono solo nella GUI:
  <itemizedlist>
    <listitem><para>La versione di GTK</para></listitem>
    <listitem><para>La versione di GLIB</para></listitem>
    <listitem><para>La situazione della GUI in cui il bug si presenta</para></listitem>
  </itemizedlist>
</para></listitem>
</itemizedlist>
</para>
</sect2>

<!-- ********** -->

<sect2 id="bugreports_hardware">
<title>Hardware e driver</title>

<para>
<itemizedlist>
<listitem><para>
  Informazioni CPU (questo funziona solo in Linux):
  <screen>cat /proc/cpuinfo</screen>
</para></listitem>
<listitem><para>
  La marca della scheda video ed il modello, per es.:
  <itemizedlist>
    <listitem><para>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</para></listitem>
    <listitem><para>Matrox G400 DH 32MB SGRAM</para></listitem>
  </itemizedlist>
</para></listitem>
<listitem><para>
  Il tipo di driver video &amp; la versione, per es.:
  <itemizedlist>
    <listitem><para>X built-in driver</para></listitem>
    <listitem><para>nVidia 0.9.623</para></listitem>
    <listitem><para>Utah-GLX CVS 2001-02-17</para></listitem>
    <listitem><para>DRI from X 4.0.3</para></listitem>
  </itemizedlist>
</para></listitem>
<listitem><para>
  Il tipo di scheda video &amp; driver, per es.:
  <itemizedlist>
    <listitem><para>Creative SBLive! Gold with OSS driver from oss.creative.com</para></listitem>
    <listitem><para>Creative SB16 with kernel OSS drivers</para></listitem>
    <listitem><para>GUS PnP with ALSA OSS emulation</para></listitem>
  </itemizedlist>
</para></listitem>
<listitem><para>
  Se hai dei dubbi includi l'emissione di <command>lspci -vv</command> su
  sitemi Linux.
</para></listitem>
</itemizedlist>
</para>
</sect2>

<!-- ********** -->

<sect2 id="bugreports_configure">
<title>Problemi del configure</title>

<para>
Se ricevi degli errori eseguendo <command>./configure</command>, o se fallisce
la rilevazione automatica di qualcosa, leggi <filename>config.log</filename>.
Puoi travarci la soluzione, per esempio varie versioni della stessa libreria
mescolate sul tuo sistema, o hai dimenticato di installare il pacchetto di
scviluppo (quelli con il suffisso -dev). Se pensi ci sia un bug, includi
<filename>config.log</filename> nel tuo rapporto sul bug stesso.
</para>
</sect2>

<sect2 id="bugreports_compilation">
<title>Problemi di compilazione</title>

<para>
Per favore includi questi file:
<itemizedlist>
  <listitem><para>config.h</para></listitem>
  <listitem><para>config.mak</para></listitem>
</itemizedlist>
</para>
</sect2>

<!-- ********** -->

<sect2 id="bugreports_playback">
<title>Problemi in riproduzione</title>

<para>
Per favore includi l'output di <application>MPlayer</application> al livello
di verbosità 1, ma ricorda di
<emphasis role="bold">non troncare tale output</emphasis> quando lo incolli
nella tua mail. Agli sviluppatori servono tutti i messaggi per diagnosticare
correttamente un problema. Puoi redirigere l'output in un file in questo modo:
<screen>
mplayer -v <replaceable>options</replaceable> <replaceable>filename</replaceable> &gt; mplayer.log 2&gt;&amp;1
</screen>
</para>

<para>
Se il tuo problema è specifico per uno o più file,
allora per favore carica quello/i incriminato/i in:
<ulink url="ftp://upload.mplayerhq.hu/MPlayer/incoming/"/>
</para>

<para>
Carica anche un piccolo file di testo con lo stesso nome di base del file, con
un'estensione .txt. Descrivi il problema che hai con quel particolare file e
includi il tuo indirizzo email così come ll'ouptut di
<application>MPlayer</application> all livello 1 di verbosità.
Solitamente i primi 1-5 MB di un file sono abbastanza per riprodurre il
problema, ma per esserne certi ti chiediamo di fare:
<screen>
dd if=<replaceable>tuo_file</replaceable> of=<replaceable>piccolo_file</replaceable> bs=1024k count=5
</screen>
Questo copierà i primi 5 mega di '<emphasis role="bold">tuo_file</emphasis>'
e li scriverà su '<emphasis role="bold">piccolo_file</emphasis>'. Dopo prova
di nuovo con il file piccolo e se il problema si presenta ancora per noi è
sufficiente. Per piacere <emphasis role="bold">non inviare mai</emphasis> questi
file via mail! Caricali sull'FTP, e manda solo il percorso/nome del file nel
server FTP. Se il file è raggiungibile in rete, allora è sufficiente inviare
l'URL <emphasis role="bold">preciso</emphasis>.
</para>
</sect2>

<!-- ********** -->

<sect2 id="bugreports_crash">
<title>Crash</title>

<para>
Devi eseguire <application>MPlayer</application> dentro a <command>gdb</command>
e mandarci l'output completo oppure se hai un <filename>core</filename> dump
del crash puoi ricavare informazioni utili dal Core file. Qui spiega come:
</para>


<sect3 id="bugreports_debug">
<title>Come conservare le informazioni di un crash riproducibile</title>

<para>
Ricompila <application>MPlayer</application> con il codice di debug abilitato:
<screen>
./configure --enable-debug=3
make
</screen>
e poi esegui <application>MPlayer</application> da dentro gdb usando:
<screen>gdb ./mplayer</screen>
Ora sei dentro gdb, Scrivi:
<screen>
run -v <replaceable>opzioni-per-mplayer</replaceable> <replaceable>nomefile</replaceable>
</screen>
e riproduci il tuo crash. Appena ci sei riuscito, gdb ti ripresenterà il
prompt dei comandi, dove devi digitare
<screen>
bt
disass $pc-32 $pc+32
info all-registers
</screen>
</para>
</sect3>


<sect3 id="bugreports_core">
<title>Come ricavare informazioni significative da un core dump</title>

<para>
Genera il file di comandi seguente:
<screen>
bt
disass $pc-32 $pc+32
info all-registers
</screen>
Poi lancia semplicemente questo comando:
<screen>
gdb mplayer --core=core -batch --command=file_comandi &gt; mplayer.bug
</screen>
</para>
</sect3>
</sect2>
</sect1>


<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->


<sect1 id="bugreports_advusers">
<title>So quello che sto facendo...</title>

<para>
Se hai generato un rapporto adeguato sul bug seguendo i passi suddetti e sei
certo che sia un bug in <application>MPlayer</application> e non un problema
del compilatore o di un file danneggiato, se hai già letto la documentazione
non sei riuscito a trovare una soluzione, i tuoi driver audio sono OK, allora
potresti voler iscriverti alla lista MPlayer-advusers e inviare lì il tuo
rapporto per ottenere una riposta migliore e più rapida.
</para>

<para>
Renditi per favore conto che se invii lì domande da niubbo o domande che hanno
già una risposta nel manuale, sarai ignorato o alimenterai un flame, invece
di ottenere una risposta adeguata. Non generare flame contro di noi e iscriviti
a -advusers solo se sai davvero cosa stai facendo e senti di essere un utente
avanzato di <application>MPlayer</application> o uno sviuppatore. Se rientri in
questi ranghi non dovrebbe esserti difficile scoprire come iscriverti...
</para>
</sect1>

</appendix>