Mercurial > mplayer.hg
annotate DOCS/bugreports.html @ 6906:3274d0725fde
Changed all link names from the section number to a sensible label.
Section numbers were 2.3.2.1. in the section names and 2.3.2.1 in the TOC.
I settled for the former everywhere. "Misc OS" is now called "Ports".
Checked all internal links, some of them were falsely pointing to renumbered
sections. This should no longer happen.
And in case some of you think "This must have been a lot of work!", that
does not even begin to describe it...
author | diego |
---|---|
date | Sun, 04 Aug 2002 22:13:09 +0000 |
parents | f3f87f6bf5cf |
children | 9e641d749832 |
rev | line source |
---|---|
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
1612 | 2 <HTML> |
4982
6cb9d9a1716d
HTML: different font handling - idea from new hp dezign
gabucino
parents:
4058
diff
changeset
|
3 |
6cb9d9a1716d
HTML: different font handling - idea from new hp dezign
gabucino
parents:
4058
diff
changeset
|
4 <HEAD> |
6882
f3f87f6bf5cf
Added a uniform title: something - MPlayer - The Movie Player for Linux.
diego
parents:
6866
diff
changeset
|
5 <TITLE>Bug reporting - MPlayer - The Movie Player for Linux</TITLE> |
6391 | 6 <LINK REL="stylesheet" TYPE="text/css" HREF="default.css"> |
6409 | 7 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> |
4982
6cb9d9a1716d
HTML: different font handling - idea from new hp dezign
gabucino
parents:
4058
diff
changeset
|
8 </HEAD> |
6cb9d9a1716d
HTML: different font handling - idea from new hp dezign
gabucino
parents:
4058
diff
changeset
|
9 |
6409 | 10 <BODY> |
1704 | 11 |
1612 | 12 |
1682 | 13 <P><B><A NAME=C>Appendix C - How to report bugs</A></B></P> |
1612 | 14 |
6866
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
15 <P><B>How to fix bugs</B></P> |
1612 | 16 |
6445 | 17 <P>If you feel have the necessary skills you are invited to have a go at fixing |
18 the bug yourself. Or maybe you already did that? Please read | |
19 <A HREF="tech/patches.txt">this short document</A> to find out how to get your | |
6470 | 20 code included in <B>MPlayer</B>. The people on the |
6445 | 21 <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</A> |
6866
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
22 mailing list will assist you if you have questions.</P> |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
23 |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
24 <P><B>How to report bugs</B></P> |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
25 |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
26 <P>First of all please try the latest CVS version of <B>MPlayer</B> as your bug |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
27 might already be fixed there. CVS instructions can be found at the bottom of |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
28 <A HREF="http://www.mplayerhq.hu/homepage/dload.html">this page</A> or in the |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
29 README. If this did not help please refer to |
6906
3274d0725fde
Changed all link names from the section number to a sensible label.
diego
parents:
6882
diff
changeset
|
30 <A HREF="documentation.html#known_bugs">the list of known bugs</A> and the rest of the |
6866
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
31 documentation. If your problem is not known or not solvable by our instructions, |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
32 then please report the bug.</P> |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
33 |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
34 <P>Please do not send bug reports privately to individual developers. This is |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
35 community work and thus there might be several people interested in it. |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
36 Sometimes other users already experienced your troubles and know how to |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
37 circumvent a problem even if it is a bug in <B>MPlayer</B> code.</P> |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
38 |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
39 <P>Please describe your problem in as much detail as possible. Do a little |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
40 detective work to narrow down the circumstances under which the problem occurs. |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
41 Does the bug only show up in certain situations? Is it specific to certain files |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
42 or file types? Does it occur with only one codec or is it codec independent? |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
43 Can you reproduce it with all output drivers? The more information you provide |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
44 the better are our chances at fixing your problem. Please do not forget to |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
45 also include the valuable information requested below, we will be unable to |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
46 properly diagnose your problem otherwise.</P> |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
47 |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
48 <P>An excellent and well written guide to asking questions in public forums is |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
49 <A HREF="http://www.tuxedo.org/~esr/faqs/smart-questions.html">How To Ask |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
50 Questions The Smart Way</A> by Eric S. Raymond. If you follow these guidelines |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
51 you should be safe. But please understand that we all follow the mailing lists |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
52 voluntarily in our free time. We are very busy and cannot guarantee that you |
1a5858256659
The endless quest to force people into writing good bug reports part 2342:
diego
parents:
6783
diff
changeset
|
53 will get a solution for your problem or even an answer. </P> |
6445 | 54 |
5237 | 55 <P><B>Where to report bugs?</B></P> |
1612 | 56 |
1682 | 57 <P>Subscribe to the mplayer-users mailing list:<BR> |
2130 | 58 <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A><BR> |
5237 | 59 and send your bug report to:<BR> |
6470 | 60 <A HREF="mailto:mplayer-users@mplayerhq.hu">mplayer-users@mplayerhq.hu</A></P> |
61 | |
62 <P>The language of this list is <B>English</B>. Please follow the standard | |
63 <A HREF="http://www.ietf.org/rfc/rfc1855.txt">Netiquette Guidelines</A> and | |
6472 | 64 <B>do not send HTML mail</B> to any of our mailing lists. You will only get |
6470 | 65 ignored or banned. Also note that we will not individually CC (carbon-copy) |
66 people so it is a good idea to subscribe to actually receive your answer.</P> | |
1682 | 67 |
5237 | 68 <P><B>What to report?</B></P> |
1682 | 69 |
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
70 <P><B>System Information</B></P> |
1612 | 71 |
1682 | 72 <UL> |
5237 | 73 <LI>Your Linux distribution or operating system e.g.: |
74 <UL> | |
6055 | 75 <LI>Red Hat 7.1</LI> |
76 <LI>Slackware 7.0 + devel packs from 7.1 ...</LI> | |
5237 | 77 </UL> |
6055 | 78 </LI> |
1682 | 79 <LI>kernel version:<BR> |
6055 | 80 <CODE>uname -a</CODE></LI> |
1682 | 81 <LI>libc version:<BR> |
6055 | 82 <CODE>ls -l /lib/libc[.-]*</CODE></LI> |
1682 | 83 <LI>X version:<BR> |
6055 | 84 <CODE>X -version</CODE></LI> |
5237 | 85 <LI>gcc and ld versions:<BR> |
1682 | 86 <CODE>gcc -v<BR> |
6055 | 87 ld -v</CODE></LI> |
1682 | 88 <LI>binutils version:<BR> |
6055 | 89 <CODE>as --version</CODE></LI> |
90 <LI>If you have problems with fullscreen mode: | |
91 <UL> | |
92 <LI>Window manager type and version</LI> | |
93 </UL> | |
94 </LI> | |
95 <LI>If only the GUI is buggy: | |
5705
53dde2c75c17
more stuff required when GUI bugreporting (nobody reads it anyway)
gabucino
parents:
5347
diff
changeset
|
96 <UL> |
53dde2c75c17
more stuff required when GUI bugreporting (nobody reads it anyway)
gabucino
parents:
5347
diff
changeset
|
97 <LI>GTK version</LI> |
53dde2c75c17
more stuff required when GUI bugreporting (nobody reads it anyway)
gabucino
parents:
5347
diff
changeset
|
98 <LI>GLIB version</LI> |
53dde2c75c17
more stuff required when GUI bugreporting (nobody reads it anyway)
gabucino
parents:
5347
diff
changeset
|
99 <LI>libpng version</LI> |
53dde2c75c17
more stuff required when GUI bugreporting (nobody reads it anyway)
gabucino
parents:
5347
diff
changeset
|
100 <LI>GUI situation in which the bug occurs</LI> |
53dde2c75c17
more stuff required when GUI bugreporting (nobody reads it anyway)
gabucino
parents:
5347
diff
changeset
|
101 </UL> |
53dde2c75c17
more stuff required when GUI bugreporting (nobody reads it anyway)
gabucino
parents:
5347
diff
changeset
|
102 </LI> |
1682 | 103 </UL> |
104 | |
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
105 <P><B>Hardware & drivers</B></P> |
1612 | 106 |
1682 | 107 <UL> |
5237 | 108 <LI>CPU info (this works on Linux only):<BR> |
6055 | 109 <CODE>cat /proc/cpuinfo</CODE></LI> |
110 <LI>Video card manufacturer and model, e.g.: | |
5237 | 111 <UL> |
6055 | 112 <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</LI> |
113 <LI>Matrox G400 DH 32MB SGRAM</LI> | |
5237 | 114 </UL> |
6055 | 115 </LI> |
116 <LI>Video driver type & version, e.g.: | |
5237 | 117 <UL> |
6055 | 118 <LI>X built-in driver</LI> |
119 <LI>nVidia 0.9.623</LI> | |
120 <LI>Utah-GLX CVS 2001-02-17</LI> | |
121 <LI>DRI from X 4.0.3</LI> | |
5237 | 122 </UL> |
6055 | 123 </LI> |
124 <LI>Sound card type & driver, e.g.: | |
5237 | 125 <UL> |
6055 | 126 <LI>Creative SBLive! Gold with OSS driver from oss.creative.com</LI> |
127 <LI>Creative SB16 with kernel OSS drivers</LI> | |
128 <LI>GUS PnP with ALSA OSS emulation</LI> | |
5237 | 129 </UL> |
6055 | 130 </LI> |
131 <LI>If in doubt include <CODE>lspci -vv</CODE> output on Linux systems.</LI> | |
1682 | 132 </UL> |
1612 | 133 |
5237 | 134 <P><B>For compilation problems/errors</B></P> |
1682 | 135 |
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
136 <P><B>Please include these files:</B></P> |
6055 | 137 <UL> |
138 <LI>configure.log</LI> | |
139 <LI>config.h</LI> | |
140 <LI>config.mak</LI> | |
141 <LI>libvo/config.mak</LI> | |
1682 | 142 </UL> |
143 | |
5237 | 144 <P><B>For playback problems</B></P> |
1682 | 145 |
6470 | 146 <P>Please include the output of <B>MPlayer</B> at verbosity level 1, but |
147 remember to <B>not truncate the output</B> when you paste it into your mail. The | |
148 developers need all of the messages to properly diagnose a problem. You can | |
149 direct the output into a file like this:</P> | |
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
150 |
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
151 <P><CODE> mplayer -v [options] [filename] &> mplayer.log</CODE></P> |
5237 | 152 |
153 <P>If your problem is specific to one or more files, then please upload the | |
154 offender(s) to:</P> | |
155 | |
156 <P> <A HREF="ftp://mplayerhq.hu/MPlayer/incoming/">ftp://mplayerhq.hu/MPlayer/incoming/</A></P> | |
157 | |
158 <P>Also upload a small text file having the same base name as your file | |
159 with a .txt extension. Describe the problem you are having with the | |
160 particular file there and include your email address as well as the output | |
6470 | 161 of <B>MPlayer</B> at verbosity level 1.<BR> |
5237 | 162 Usually the first 1-5 MB of a file are enough to reproduce the problem, |
163 but to be sure we ask you to: | |
164 <P><CODE> dd if=yourfile of=smallfile bs=1024k count=5</CODE></P> | |
1612 | 165 |
5237 | 166 <P>It will take the first five megabytes of <STRONG>'your-file'</STRONG> and |
167 write it to <STRONG>'small-file'</STRONG>.<BR> | |
168 Then try again on this small file and if the bug still shows up | |
169 your sample is sufficient for us.<BR> | |
170 Please <STRONG>do not ever</STRONG> send such files via mail! Upload it, | |
171 and send only the path/filename of the file on the FTP-server.<BR> | |
172 If the file is accessible on the net, then sending the | |
173 <STRONG>exact</STRONG> URL is sufficient.</P> | |
1612 | 174 |
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
175 <P><B>For crashes</B></P> |
5237 | 176 |
6470 | 177 <P>If you have a core dump of the crash continue reading the next paragraph, |
178 otherwise skip it.</P> | |
1682 | 179 |
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
180 <P><B>How to extract meaningful information from a core dump</B></P> |
5237 | 181 |
182 <P>Please create following command file:</P> | |
1612 | 183 |
1682 | 184 <P><CODE>disass $eip-32 $eip+32<BR> |
185 printf "eax=%08lX\n",$eax<BR> | |
186 printf "ebx=%08lX\n",$ebx<BR> | |
187 printf "ecx=%08lX\n",$ecx<BR> | |
188 printf "edx=%08lX\n",$edx<BR> | |
189 printf "esp=%08lX\n",$esp<BR> | |
190 printf "ebp=%08lX\n",$ebp<BR> | |
191 printf "edi=%08lX\n",$edi<BR> | |
192 printf "esi=%08lX\n",$esi<BR> | |
193 </CODE></P> | |
1612 | 194 |
5237 | 195 <P>Then simply execute the following on your command line:</P> |
196 <P> <CODE>gdb mplayer --core=core -batch --command=command_file > mplayer.bug</CODE></P> | |
197 | |
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
198 <P><B>How to conserve information about a reproducible crash</B></P> |
6470 | 199 <P>Recompile <B>MPlayer</B> with debugging code enabled:</P> |
5347 | 200 <P><CODE> ./configure --enable-debug=3<BR> |
5237 | 201 make</CODE></P> |
6470 | 202 and then run <B>MPlayer</B> within gdb using: |
5237 | 203 <P><CODE> gdb mplayer</CODE></P> |
1612 | 204 |
5237 | 205 <P>You are now within gdb. Type:</P> |
206 <P><CODE> run -v [options-to-mplayer] filename</code></P> | |
207 and reproduce your crash. As soon as you did it, gdb will | |
208 return you to the command line prompt where you have to enter | |
209 <P><CODE> bt<BR> | |
210 disass $eip-32 $eip+32</CODE></P> | |
211 and send the complete output to us. | |
212 | |
213 <P><B>General note</B></P> | |
1612 | 214 |
5237 | 215 <P>If something is quite big (logs for instance) then it is better to upload |
6387
26c35aa7e1d8
Remind people to NOT cut mplayer output, removed italics that make text
diego
parents:
6055
diff
changeset
|
216 it to the FTP server in a compressed format (gzip and bzip preferred) and |
5237 | 217 include only the path and filename in your bug report.</P> |
1612 | 218 |
5237 | 219 <P><B>I know what I am doing...</B></P> |
3228 | 220 |
5237 | 221 <P>If you created a proper bug report following the steps above and you are |
6470 | 222 confident it is a bug in <B>MPlayer</B>, not a compiler problem or broken file, |
5237 | 223 you have already read the documentation and you could not find a solution, |
224 your sound drivers are OK, then you might want to subscribe to the | |
225 mplayer-advusers list and send your bug report there to get a better and | |
226 faster answer.<BR><BR> | |
227 Please be advised that if you post newbie questions or questions answered | |
228 in the manual there, you will be ignored or flamed instead of getting an | |
229 appropriate answer.<BR> | |
230 So do not flame us and subscribe to -advusers only if you really know | |
6470 | 231 what you are doing and feel like being an advanced <B>MPlayer</B> user or |
5237 | 232 developer. If you meet these criteria it should not be difficult to find |
233 out how to subscribe... | |
3228 | 234 </P> |
235 | |
1612 | 236 </BODY> |
237 </HTML> |