comparison DOCS/Polish/bugreports.html @ 3523:dadab20dc2b4

began updated translation by <nell@skrzynka.pl> (work-in-progress)
author gabucino
date Sun, 16 Dec 2001 11:51:02 +0000
parents
children dc8fe516de8f
comparison
equal deleted inserted replaced
3522:34df0f546afc 3523:dadab20dc2b4
1 <HTML>
2 <BODY BGCOLOR=white>
3
4 <FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
5
6 <P><B><A NAME=C>Appendix C - How to report bugs</A></B></P>
7
8 <P><B>How to report bugs?</B></P>
9
10 <P>First read <A HREF="documentation.html#D">Appendix D</A>, and other docs. If your problem isn't
11 known or isn't solved by our instructions, then report the bug:</P>
12
13 <P><B>Where?</B></P>
14
15 <P>Subscribe to the mplayer-users mailing list:<BR>
16 &nbsp;&nbsp;&nbsp;&nbsp;<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A><BR>
17 and send your bugreport to:<BR>
18 &nbsp;&nbsp;&nbsp;&nbsp;<A HREF="mailto:mplayer-users@mplayehq.hu">mplayer-users@mplayerhq.hu</A><BR>
19 We won't CC: so please subscribe!!!</P>
20
21 <P>Don't send bugreports private, directly to author's address!!!
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.
25 The language of this list is ENGLISH!</P>
26
27 <P>Please describe your problem in details, examples etc, and don't
28 forget to include these:</P>
29
30 <P><B>What?</B></P>
31
32 <P><B><I>1. The system info what we always want:</I></B></P>
33
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>
53
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>
74
75 <P><B>For compiling problems/errors</B></P>
76
77 <P><B><I>3. these files:</I></B></P>
78 <UL><LI>configure.log
79 <LI>config.h
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>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -v [options] filename &amp;&gt; mplayer.log</CODE></P>
88
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>&nbsp;&nbsp;&nbsp;ftp://mplayerhq.hu/MPlayer/incoming/</CODE></P>
92 Also upload a small .txt file with the same name as your file,
93 describing the problem!<BR>
94 Usually first 1-5 MB of the file is enough to reproduce
95 the problem, but first you should try it:
96 <P><CODE>&nbsp;&nbsp;&nbsp;dd if=yourfile of=smallfile bs=1k count=1024</CODE></P>
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
99 then it's enough to upload this small file.<BR>
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
105 <P><B><I>5. For crashes (segfault, SIGILL, signal 4 etc):</I></B></P>
106
107 <P><I>If you have coredump of the crash, see 5.a, else see 5.b:</I></P>
108
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>
113
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>
124
125 <P>Then simply execute following command line:</P>
126 <P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>gdb mplayer --core=core -batch --command=command_file >mplayer.bug</CODE></P>
127
128 <P><B><I>5.b.: run MPlayer in gdb:</I></B></P>
129 <P>Re-compile mplayer with debugging code enabled:<BR>
130 ./configure --enable-debug<BR>
131 make
132 </P>
133 <P>[at root/user shell prompt:]<BR>
134 &nbsp;&nbsp;&nbsp;&nbsp;<CODE># gdb mplayer</CODE><BR>
135 [at gdb prompt:]<BR>
136 &nbsp;&nbsp;&nbsp;&nbsp;<CODE>&gt; run -v [options-to-mplayer] filename</CODE><BR>
137 ... (wait until it will crash)<BR>
138 &nbsp;&nbsp;&nbsp;&nbsp;<CODE>&gt; bt</CODE><BR>
139 &nbsp;&nbsp;&nbsp;&nbsp;<CODE>&gt; disass $eip-32 $eip+32</CODE><BR>
140 Send us the full output of the above things!
141 </P>
142
143 <P><B>In general:</B></P>
144
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
148 <P><B>I know what am I doing...</B></P>
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
162 </BODY>
163 </HTML>