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