Mercurial > mplayer.hg
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 <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 <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> mplayer -v [options] filename &> 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> 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> 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> <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 <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> | |
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> |