|
1612
|
1 <HTML>
|
|
|
2 <BODY>
|
|
|
3
|
|
1682
|
4 <P><B><A NAME=C>Appendix C - How to report bugs</A></B></P>
|
|
1612
|
5
|
|
1682
|
6 <P><B>How to report bugs?</B></P>
|
|
|
7
|
|
|
8 <P>First read DOCS/BUGS, and other docs. If your problem isn't
|
|
|
9 known or isn't solved by our instructions, then report the bug:</P>
|
|
1612
|
10
|
|
1682
|
11 <P><B>Where?</B></P>
|
|
1612
|
12
|
|
1682
|
13 <P>Subscribe to the mplayer-users mailing list:<BR>
|
|
|
14 <CODE>http://lists.sourceforge.net/lists/listinfo/mplayer-users</CODE><BR>
|
|
|
15 and send your bugreport to:<BR>
|
|
|
16 <CODE>mplayer-users@lists.sourceforge.net</CODE><BR>
|
|
|
17 We won't CC: so please subscribe!!!</P>
|
|
|
18
|
|
|
19 <P>Don't send bugreports private, directly to author's address!!!
|
|
1612
|
20 We are working together on code, so everyone is interested in it.
|
|
|
21 BTW many times other users know the solution (system config probs,
|
|
|
22 bad drivers etc), even when we think it's a bug in our code.
|
|
1682
|
23 The language of this list is ENGLISH!</P>
|
|
1612
|
24
|
|
1682
|
25 <P>Please describe your problem in details, examples etc, and don't
|
|
|
26 forget to include these:</P>
|
|
1612
|
27
|
|
1682
|
28 <P><B>What?</B></P>
|
|
|
29
|
|
|
30 <P><B><I>1. The system info what we always want:</I></B></P>
|
|
1612
|
31
|
|
1682
|
32 <UL>
|
|
|
33 <LI>linux distribution<BR>
|
|
|
34 examples:<UL>
|
|
|
35 <LI>RedHat 7.1
|
|
|
36 <LI>Slackware 7.0 + devel packs from 7.1 ...</UL>
|
|
|
37 <LI>kernel version:<BR>
|
|
|
38 <CODE>uname -a</CODE>
|
|
|
39 <LI>libc version:<BR>
|
|
|
40 <CODE>ls -l /lib/libc[.-]*</CODE>
|
|
|
41 <LI>X version:<BR>
|
|
|
42 <CODE>X -version</CODE>
|
|
|
43 <LI>gcc and ld version:<BR>
|
|
|
44 <CODE>gcc -v<BR>
|
|
|
45 ld -v</CODE>
|
|
|
46 <LI>binutils version:<BR>
|
|
|
47 <CODE>as --version</CODE>
|
|
|
48 </UL>
|
|
|
49
|
|
|
50 <P><B><I>2. Hardware & drivers:</I></B></P>
|
|
1612
|
51
|
|
1682
|
52 <UL>
|
|
|
53 <LI>CPU info:<BR>
|
|
|
54 <CODE>cat /proc/cpuinfo</CODE>
|
|
|
55 <LI>video card manufacturer and model<BR>
|
|
|
56 examples:<BR><UL>
|
|
|
57 <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM
|
|
|
58 <LI>Matrox G400 DH 32MB SGRAM</UL>
|
|
|
59 <LI>video driver type&version<BR>
|
|
|
60 examples:<UL>
|
|
|
61 <LI>X built-in driver
|
|
|
62 <LI>nvidia 0.9.623
|
|
|
63 <LI>Utah-GLX CVS 2001-02-17
|
|
|
64 <LI>DRI from X 4.0.3</UL>
|
|
|
65 <LI>sound card type & driver<BR>
|
|
|
66 examples:<BR><UL>
|
|
|
67 <LI>Creative SBLive! Gold with OSS driver from oss.creative.com
|
|
|
68 <LI>Creative SB16 with OSS drivers of kernel
|
|
|
69 <LI>GUS PnP with ALSA OSS emulation</UL>
|
|
|
70 <LI>if you are unsure, attach output of lspci -v
|
|
|
71 </UL>
|
|
1612
|
72
|
|
1682
|
73 <P><B>For compiling problems/errors</B></P>
|
|
|
74
|
|
|
75 <P><B><I>3. output of configure/make:</I></B></P>
|
|
|
76
|
|
|
77 <UL><LI><CODE>make distclean</CODE>
|
|
|
78 <LI><CODE>./configure &>config.log</CODE>
|
|
|
79 <LI><CODE> ./make &>make.log
|
|
|
80 </UL>
|
|
1612
|
81
|
|
1682
|
82 <P><B><I>4. these files:</I></B></P>
|
|
|
83 <UL><LI>config.h
|
|
|
84 <LI>config.mak
|
|
|
85 <LI>libvo/config.mak
|
|
|
86 </UL>
|
|
|
87
|
|
|
88 <P><B>For playback problems:</B></P>
|
|
|
89
|
|
|
90 <P><B><I>3. Output of mplayer at verbose level 1 (-v)</I></B></P>
|
|
|
91 <P><CODE> mplayer -v [options] filename &> mplayer.log</CODE></P>
|
|
1612
|
92
|
|
1682
|
93 <P><B><I>4. If the problem is specific to one or a few files,
|
|
|
94 then please upload that file to:</I></B></P>
|
|
|
95 <P><CODE> ftp://mplayerhq.hu/MPlayer/incoming/</CODE></P>
|
|
1612
|
96 Usually first 1-5 MB of the file is enough to reproduce
|
|
|
97 the problem, but first you should try it:
|
|
1682
|
98 <P><CODE> dd if=yourfile of=smallfile bs=1k count=1024</CODE></P>
|
|
1612
|
99 (it will cut first 1MB of 'yourfile' and save to 'smallfile')
|
|
|
100 Then try again on this small file, and if bug still exists
|
|
|
101 then it's enough to upload this small file.
|
|
|
102 NEVER send such files via mail! Upload it, and send only
|
|
|
103 the path/filename of the file on the FTP.
|
|
|
104 If the file is accessible on the net, then sending the
|
|
|
105 _exact_ URL is enough!
|
|
|
106
|
|
1682
|
107 <P><B><I>5. For crashes (segfault, SIGILL, signal 4 etc):</I></B></P>
|
|
1612
|
108
|
|
1682
|
109 <P><I>If you have coredump of the crash, see 5.a, else see 5.b:</I></P>
|
|
1612
|
110
|
|
1682
|
111 <P><B><I>5.a: Please print us coredump (if it was created).</I></B></P>
|
|
|
112
|
|
|
113 <P>Howto:
|
|
|
114 please create following command file:</P>
|
|
1612
|
115
|
|
1682
|
116 <P><CODE>disass $eip-32 $eip+32<BR>
|
|
|
117 printf "eax=%08lX\n",$eax<BR>
|
|
|
118 printf "ebx=%08lX\n",$ebx<BR>
|
|
|
119 printf "ecx=%08lX\n",$ecx<BR>
|
|
|
120 printf "edx=%08lX\n",$edx<BR>
|
|
|
121 printf "esp=%08lX\n",$esp<BR>
|
|
|
122 printf "ebp=%08lX\n",$ebp<BR>
|
|
|
123 printf "edi=%08lX\n",$edi<BR>
|
|
|
124 printf "esi=%08lX\n",$esi<BR>
|
|
|
125 </CODE></P>
|
|
1612
|
126
|
|
1682
|
127 <P>Then simply execute following command line:</P>
|
|
|
128 <P> <CODE>gdb mplayer --core=core -batch --command=command_file >mplayer.bug</CODE></P>
|
|
1612
|
129
|
|
1682
|
130 <P><B><I>5.b.: run MPlayer in gdb:</I></B></P>
|
|
|
131 <P>[at root/user shell prompt:]<BR>
|
|
|
132 <CODE># gdb mplayer</CODE><BR>
|
|
|
133 [at gdb prompt:]<BR>
|
|
|
134 <CODE>> run -v [options-to-mplayer] filename</CODE><BR>
|
|
|
135 ... (wait until it will crash)<BR>
|
|
|
136 <CODE>> bt</CODE><BR>
|
|
|
137 <CODE>> disass $eip-32 $eip+32</CODE><BR>
|
|
1612
|
138 Send us the full output of the above things!
|
|
1682
|
139 </P>
|
|
1612
|
140
|
|
1682
|
141 <P><B>In general:</B></P>
|
|
1612
|
142
|
|
1682
|
143 <P>If something is big (logs etc) then it's better to upload to the ftp
|
|
|
144 (gzipped), and include only path/filename in the bugreport!</P>
|
|
|
145
|
|
|
146 <BR>
|
|
|
147 <HR>
|
|
|
148 MPlayer documentation project
|
|
1612
|
149
|
|
|
150 </BODY>
|
|
|
151 </HTML>
|
