|
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
|
|
|
77 <P><B><I>3. output of configure/make:</I></B></P>
|
|
|
78
|
|
|
79 <UL><LI><CODE>make distclean</CODE>
|
|
2143
|
80 <LI><CODE>./configure & > config.log</CODE>
|
|
|
81 <LI><CODE> ./make & > make.log</CODE>
|
|
1682
|
82 </UL>
|
|
1612
|
83
|
|
1682
|
84 <P><B><I>4. these files:</I></B></P>
|
|
3011
|
85 <UL><LI>configure.log
|
|
|
86 <LI>config.h
|
|
1682
|
87 <LI>config.mak
|
|
|
88 <LI>libvo/config.mak
|
|
|
89 </UL>
|
|
|
90
|
|
|
91 <P><B>For playback problems:</B></P>
|
|
|
92
|
|
|
93 <P><B><I>3. Output of mplayer at verbose level 1 (-v)</I></B></P>
|
|
|
94 <P><CODE> mplayer -v [options] filename &> mplayer.log</CODE></P>
|
|
1612
|
95
|
|
1682
|
96 <P><B><I>4. If the problem is specific to one or a few files,
|
|
|
97 then please upload that file to:</I></B></P>
|
|
|
98 <P><CODE> ftp://mplayerhq.hu/MPlayer/incoming/</CODE></P>
|
|
1868
|
99 Also upload a small .txt file with the same name as your file,
|
|
|
100 describing the problem!<BR>
|
|
1612
|
101 Usually first 1-5 MB of the file is enough to reproduce
|
|
|
102 the problem, but first you should try it:
|
|
1682
|
103 <P><CODE> dd if=yourfile of=smallfile bs=1k count=1024</CODE></P>
|
|
1612
|
104 (it will cut first 1MB of 'yourfile' and save to 'smallfile')
|
|
|
105 Then try again on this small file, and if bug still exists
|
|
1868
|
106 then it's enough to upload this small file.<BR>
|
|
1612
|
107 NEVER send such files via mail! Upload it, and send only
|
|
|
108 the path/filename of the file on the FTP.
|
|
|
109 If the file is accessible on the net, then sending the
|
|
|
110 _exact_ URL is enough!
|
|
|
111
|
|
1682
|
112 <P><B><I>5. For crashes (segfault, SIGILL, signal 4 etc):</I></B></P>
|
|
1612
|
113
|
|
1682
|
114 <P><I>If you have coredump of the crash, see 5.a, else see 5.b:</I></P>
|
|
1612
|
115
|
|
1682
|
116 <P><B><I>5.a: Please print us coredump (if it was created).</I></B></P>
|
|
|
117
|
|
|
118 <P>Howto:
|
|
|
119 please create following command file:</P>
|
|
1612
|
120
|
|
1682
|
121 <P><CODE>disass $eip-32 $eip+32<BR>
|
|
|
122 printf "eax=%08lX\n",$eax<BR>
|
|
|
123 printf "ebx=%08lX\n",$ebx<BR>
|
|
|
124 printf "ecx=%08lX\n",$ecx<BR>
|
|
|
125 printf "edx=%08lX\n",$edx<BR>
|
|
|
126 printf "esp=%08lX\n",$esp<BR>
|
|
|
127 printf "ebp=%08lX\n",$ebp<BR>
|
|
|
128 printf "edi=%08lX\n",$edi<BR>
|
|
|
129 printf "esi=%08lX\n",$esi<BR>
|
|
|
130 </CODE></P>
|
|
1612
|
131
|
|
1682
|
132 <P>Then simply execute following command line:</P>
|
|
|
133 <P> <CODE>gdb mplayer --core=core -batch --command=command_file >mplayer.bug</CODE></P>
|
|
1612
|
134
|
|
1682
|
135 <P><B><I>5.b.: run MPlayer in gdb:</I></B></P>
|
|
1868
|
136 <P>Re-compile mplayer with debugging code enabled:<BR>
|
|
|
137 ./configure --enable-debug<BR>
|
|
|
138 make
|
|
|
139 </P>
|
|
1682
|
140 <P>[at root/user shell prompt:]<BR>
|
|
|
141 <CODE># gdb mplayer</CODE><BR>
|
|
|
142 [at gdb prompt:]<BR>
|
|
|
143 <CODE>> run -v [options-to-mplayer] filename</CODE><BR>
|
|
|
144 ... (wait until it will crash)<BR>
|
|
|
145 <CODE>> bt</CODE><BR>
|
|
|
146 <CODE>> disass $eip-32 $eip+32</CODE><BR>
|
|
1612
|
147 Send us the full output of the above things!
|
|
1682
|
148 </P>
|
|
1612
|
149
|
|
1682
|
150 <P><B>In general:</B></P>
|
|
1612
|
151
|
|
1682
|
152 <P>If something is big (logs etc) then it's better to upload to the ftp
|
|
|
153 (gzipped), and include only path/filename in the bugreport!</P>
|
|
|
154
|
|
1612
|
155 </BODY>
|
|
|
156 </HTML>
|
