Mercurial > mplayer.hg

comparison DOCS/bugreports.html @ 1682:dba45a1aafad

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
*** empty log message ***
author gabucino
date Fri, 24 Aug 2001 18:48:13 +0000
parents a5cb1b1d47a8
children 390bbb52e371
comparison
equal deleted inserted replaced
1681:445ea1ce4180 1682:dba45a1aafad
1 <HTML> 1 <HTML>
2
3 <BODY> 2 <BODY>
4 3
5 <PRE> 4 <P><B><A NAME=C>Appendix C - How to report bugs</A></B></P>
6 5
7 <A NAME=C>Appendix C - How to report bugs</A> 6 <P><B>How to report bugs?</B></P>
8 7
9 How to report bugs? 8 <P>First read DOCS/BUGS, and other docs. If your problem isn't
10 ~~~~~~~~~~~~~~~~~~~ 9 known or isn't solved by our instructions, then report the bug:</P>
11 First read DOCS/BUGS, and other docs. If your problem isn't
12 known or isn't solved by our instructions, then report the bug:
13 10
14 Where? 11 <P><B>Where?</B></P>
15 ======
16 Subscribe to the mplayer-users mailing list:
17 http://lists.sourceforge.net/lists/listinfo/mplayer-users
18 and send your bugreport to:
19 mplayer-users@lists.sourceforge.net
20 We won't CC: so please subscribe!!!
21 12
22 Don't send bugreports private, directly to author's address!!! 13 <P>Subscribe to the mplayer-users mailing list:<BR>
14 &nbsp;&nbsp;&nbsp;&nbsp;<CODE>http://lists.sourceforge.net/lists/listinfo/mplayer-users</CODE><BR>
15 and send your bugreport to:<BR>
16 &nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer-users@lists.sourceforge.net</CODE><BR>
17 We won't CC: so please subscribe!!!</P>
18
19 <P>Don't send bugreports private, directly to author's address!!!
23 We are working together on code, so everyone is interested in it. 20 We are working together on code, so everyone is interested in it.
24 BTW many times other users know the solution (system config probs, 21 BTW many times other users know the solution (system config probs,
25 bad drivers etc), even when we think it's a bug in our code. 22 bad drivers etc), even when we think it's a bug in our code.
26 The language of this list is ENGLISH ! 23 The language of this list is ENGLISH!</P>
27 24
28 Please describe your problem in details, examples etc, and don't 25 <P>Please describe your problem in details, examples etc, and don't
29 forget to include these: 26 forget to include these:</P>
30 27
31 What? 28 <P><B>What?</B></P>
32 =====
33 29
34 1. The system info what we always want: 30 <P><B><I>1. The system info what we always want:</I></B></P>
35 - linux distribution
36 examples:
37 RedHat 7.1
38 Slackware 7.0 + devel packs from 7.1 ...
39 - kernel version:
40 uname -a
41 - libc version:
42 ls -l /lib/libc[.-]*
43 - X version:
44 X -version
45 - gcc and ld version:
46 gcc -v
47 ld -v
48 - binutils version:
49 as --version
50 31
51 2. Hardware &amp; drivers: 32 <UL>
52 - CPU info: 33 <LI>linux distribution<BR>
53 cat /proc/cpuinfo 34 examples:<UL>
54 - video card manufacturer and model 35 <LI>RedHat 7.1
55 examples: 36 <LI>Slackware 7.0 + devel packs from 7.1 ...</UL>
56 ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM 37 <LI>kernel version:<BR>
57 Matrox G400 DH 32MB SGRAM 38 <CODE>uname -a</CODE>
58 - video driver type &amp; version 39 <LI>libc version:<BR>
59 examples: 40 <CODE>ls -l /lib/libc[.-]*</CODE>
60 X built-in driver 41 <LI>X version:<BR>
61 nvidia 0.9.623 42 <CODE>X -version</CODE>
62 Utah-GLX CVS 2001-02-17 43 <LI>gcc and ld version:<BR>
63 DRI from X 4.0.3 44 <CODE>gcc -v<BR>
64 - sound card type &amp; driver 45 ld -v</CODE>
65 examples: 46 <LI>binutils version:<BR>
66 Creative SBLive! Gold with OSS driver from oss.creative.com 47 <CODE>as --version</CODE>
67 Creative SB16 with OSS drivers of kernel 48 </UL>
68 GUS PnP with ALSA OSS emulation
69 - if you are unsure, attach output of lspci -v
70 49
71 For compiling problems/errors: 50 <P><B><I>2. Hardware & drivers:</I></B></P>
72 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
73 3. output of configure/make:
74 make distclean
75 ./configure &amp;>config.log
76 ./make &amp;>make.log
77 4. these files:
78 config.h
79 config.mak
80 libvo/config.mak
81 51
82 For playback problems: 52 <UL>
83 ~~~~~~~~~~~~~~~~~~~~~~ 53 <LI>CPU info:<BR>
84 3. Output of mplayer at verbose level 1 (-v) 54 <CODE>cat /proc/cpuinfo</CODE>
85 mplayer -v [options] filename &amp;> mplayer.log 55 <LI>video card manufacturer and model<BR>
56 examples:<BR><UL>
57 <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM
58 <LI>Matrox G400 DH 32MB SGRAM</UL>
59 <LI>video driver type&version<BR>
60 examples:<UL>
61 <LI>X built-in driver
62 <LI>nvidia 0.9.623
63 <LI>Utah-GLX CVS 2001-02-17
64 <LI>DRI from X 4.0.3</UL>
65 <LI>sound card type & driver<BR>
66 examples:<BR><UL>
67 <LI>Creative SBLive! Gold with OSS driver from oss.creative.com
68 <LI>Creative SB16 with OSS drivers of kernel
69 <LI>GUS PnP with ALSA OSS emulation</UL>
70 <LI>if you are unsure, attach output of lspci -v
71 </UL>
72
73 <P><B>For compiling problems/errors</B></P>
74
75 <P><B><I>3. output of configure/make:</I></B></P>
76
77 <UL><LI><CODE>make distclean</CODE>
78 <LI><CODE>./configure &>config.log</CODE>
79 <LI><CODE> ./make &>make.log
80 </UL>
81
82 <P><B><I>4. these files:</I></B></P>
83 <UL><LI>config.h
84 <LI>config.mak
85 <LI>libvo/config.mak
86 </UL>
87
88 <P><B>For playback problems:</B></P>
89
90 <P><B><I>3. Output of mplayer at verbose level 1 (-v)</I></B></P>
91 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -v [options] filename &amp;&gt; mplayer.log</CODE></P>
86 92
87 4. If the problem is specific to one or a few files, 93 <P><B><I>4. If the problem is specific to one or a few files,
88 then please upload that file to: 94 then please upload that file to:</I></B></P>
89 ftp://mplayerhq.hu/MPlayer/incoming/ 95 <P><CODE>&nbsp;&nbsp;&nbsp;ftp://mplayerhq.hu/MPlayer/incoming/</CODE></P>
90 Usually first 1-5 MB of the file is enough to reproduce 96 Usually first 1-5 MB of the file is enough to reproduce
91 the problem, but first you should try it: 97 the problem, but first you should try it:
92 dd if=yourfile of=smallfile bs=1k count=1024 98 <P><CODE>&nbsp;&nbsp;&nbsp;dd if=yourfile of=smallfile bs=1k count=1024</CODE></P>
93 (it will cut first 1MB of 'yourfile' and save to 'smallfile') 99 (it will cut first 1MB of 'yourfile' and save to 'smallfile')
94 Then try again on this small file, and if bug still exists 100 Then try again on this small file, and if bug still exists
95 then it's enough to upload this small file. 101 then it's enough to upload this small file.
96 NEVER send such files via mail! Upload it, and send only 102 NEVER send such files via mail! Upload it, and send only
97 the path/filename of the file on the FTP. 103 the path/filename of the file on the FTP.
98 If the file is accessible on the net, then sending the 104 If the file is accessible on the net, then sending the
99 _exact_ URL is enough! 105 _exact_ URL is enough!
100 106
101 5. For crashes (segfault, SIGILL, signal 4 etc): 107 <P><B><I>5. For crashes (segfault, SIGILL, signal 4 etc):</I></B></P>
102 108
103 If you have coredump of the crash, see 5.a, else see 5.b: 109 <P><I>If you have coredump of the crash, see 5.a, else see 5.b:</I></P>
104 110
105 5.a: Please print us coredump (if it was created). 111 <P><B><I>5.a: Please print us coredump (if it was created).</I></B></P>
106 Howto:
107 please create following command file:
108 112
109 disass $eip-32 $eip+32 113 <P>Howto:
110 printf "eax=%08lX\n",$eax 114 please create following command file:</P>
111 printf "ebx=%08lX\n",$ebx
112 printf "ecx=%08lX\n",$ecx
113 printf "edx=%08lX\n",$edx
114 printf "esp=%08lX\n",$esp
115 printf "ebp=%08lX\n",$ebp
116 printf "edi=%08lX\n",$edi
117 printf "esi=%08lX\n",$esi
118 115
119 Then simply execute following command line: 116 <P><CODE>disass $eip-32 $eip+32<BR>
120 gdb mplayer --core=core -batch --command=command_file >mplayer.bug 117 printf "eax=%08lX\n",$eax<BR>
118 printf "ebx=%08lX\n",$ebx<BR>
119 printf "ecx=%08lX\n",$ecx<BR>
120 printf "edx=%08lX\n",$edx<BR>
121 printf "esp=%08lX\n",$esp<BR>
122 printf "ebp=%08lX\n",$ebp<BR>
123 printf "edi=%08lX\n",$edi<BR>
124 printf "esi=%08lX\n",$esi<BR>
125 </CODE></P>
121 126
122 5.b.: run <B>MPlayer</B> in gdb: 127 <P>Then simply execute following command line:</P>
123 [at root/user shell prompt:] 128 <P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>gdb mplayer --core=core -batch --command=command_file >mplayer.bug</CODE></P>
124 # gdb mplayer 129
125 [at gdb prompt:] 130 <P><B><I>5.b.: run MPlayer in gdb:</I></B></P>
126 > run -v [options-to-mplayer] filename 131 <P>[at root/user shell prompt:]<BR>
127 ... (wait until it will crash) 132 &nbsp;&nbsp;&nbsp;&nbsp;<CODE># gdb mplayer</CODE><BR>
128 > bt 133 [at gdb prompt:]<BR>
129 > disass $eip-32 $eip+32 134 &nbsp;&nbsp;&nbsp;&nbsp;<CODE>&gt; run -v [options-to-mplayer] filename</CODE><BR>
135 ... (wait until it will crash)<BR>
136 &nbsp;&nbsp;&nbsp;&nbsp;<CODE>&gt; bt</CODE><BR>
137 &nbsp;&nbsp;&nbsp;&nbsp;<CODE>&gt; disass $eip-32 $eip+32</CODE><BR>
130 Send us the full output of the above things! 138 Send us the full output of the above things!
139 </P>
131 140
132 In general: 141 <P><B>In general:</B></P>
133 ~~~~~~~~~~~
134 If something is big (logs etc) then it's better to upload to the ftp
135 (gzipped), and include only path/filename in the bugreport!
136 142
137 </PRE> 143 <P>If something is big (logs etc) then it's better to upload to the ftp
144 (gzipped), and include only path/filename in the bugreport!</P>
145
146 <BR>
147 <HR>
148 MPlayer documentation project
138 149
139 </BODY> 150 </BODY>
140
141 </HTML> 151 </HTML>