|
1612
|
1 <HTML>
|
|
|
2
|
|
|
3 <BODY>
|
|
|
4
|
|
|
5 <PRE>
|
|
|
6
|
|
1668
|
7 <A NAME=C>Appendix C - How to report bugs</A>
|
|
1612
|
8
|
|
|
9 How to report bugs?
|
|
|
10 ~~~~~~~~~~~~~~~~~~~
|
|
|
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
|
|
|
14 Where?
|
|
|
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
|
|
|
22 Don't send bugreports private, directly to author's address!!!
|
|
|
23 We are working together on code, so everyone is interested in it.
|
|
|
24 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.
|
|
|
26 The language of this list is ENGLISH !
|
|
|
27
|
|
|
28 Please describe your problem in details, examples etc, and don't
|
|
|
29 forget to include these:
|
|
|
30
|
|
|
31 What?
|
|
|
32 =====
|
|
|
33
|
|
|
34 1. The system info what we always want:
|
|
|
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
|
|
1668
|
51 2. Hardware & drivers:
|
|
1612
|
52 - CPU info:
|
|
|
53 cat /proc/cpuinfo
|
|
|
54 - video card manufacturer and model
|
|
|
55 examples:
|
|
|
56 ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM
|
|
|
57 Matrox G400 DH 32MB SGRAM
|
|
1668
|
58 - video driver type & version
|
|
1612
|
59 examples:
|
|
|
60 X built-in driver
|
|
|
61 nvidia 0.9.623
|
|
|
62 Utah-GLX CVS 2001-02-17
|
|
|
63 DRI from X 4.0.3
|
|
1668
|
64 - sound card type & driver
|
|
1612
|
65 examples:
|
|
|
66 Creative SBLive! Gold with OSS driver from oss.creative.com
|
|
|
67 Creative SB16 with OSS drivers of kernel
|
|
|
68 GUS PnP with ALSA OSS emulation
|
|
|
69 - if you are unsure, attach output of lspci -v
|
|
|
70
|
|
|
71 For compiling problems/errors:
|
|
|
72 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
73 3. output of configure/make:
|
|
|
74 make distclean
|
|
1668
|
75 ./configure &>config.log
|
|
|
76 ./make &>make.log
|
|
1612
|
77 4. these files:
|
|
|
78 config.h
|
|
|
79 config.mak
|
|
|
80 libvo/config.mak
|
|
|
81
|
|
|
82 For playback problems:
|
|
|
83 ~~~~~~~~~~~~~~~~~~~~~~
|
|
|
84 3. Output of mplayer at verbose level 1 (-v)
|
|
1668
|
85 mplayer -v [options] filename &> mplayer.log
|
|
1612
|
86
|
|
|
87 4. If the problem is specific to one or a few files,
|
|
|
88 then please upload that file to:
|
|
|
89 ftp://mplayerhq.hu/MPlayer/incoming/
|
|
|
90 Usually first 1-5 MB of the file is enough to reproduce
|
|
|
91 the problem, but first you should try it:
|
|
|
92 dd if=yourfile of=smallfile bs=1k count=1024
|
|
|
93 (it will cut first 1MB of 'yourfile' and save to 'smallfile')
|
|
|
94 Then try again on this small file, and if bug still exists
|
|
|
95 then it's enough to upload this small file.
|
|
|
96 NEVER send such files via mail! Upload it, and send only
|
|
|
97 the path/filename of the file on the FTP.
|
|
|
98 If the file is accessible on the net, then sending the
|
|
|
99 _exact_ URL is enough!
|
|
|
100
|
|
|
101 5. For crashes (segfault, SIGILL, signal 4 etc):
|
|
|
102
|
|
|
103 If you have coredump of the crash, see 5.a, else see 5.b:
|
|
|
104
|
|
|
105 5.a: Please print us coredump (if it was created).
|
|
|
106 Howto:
|
|
|
107 please create following command file:
|
|
|
108
|
|
|
109 disass $eip-32 $eip+32
|
|
|
110 printf "eax=%08lX\n",$eax
|
|
|
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
|
|
|
119 Then simply execute following command line:
|
|
|
120 gdb mplayer --core=core -batch --command=command_file >mplayer.bug
|
|
|
121
|
|
|
122 5.b.: run <B>MPlayer</B> in gdb:
|
|
|
123 [at root/user shell prompt:]
|
|
|
124 # gdb mplayer
|
|
|
125 [at gdb prompt:]
|
|
|
126 > run -v [options-to-mplayer] filename
|
|
|
127 ... (wait until it will crash)
|
|
|
128 > bt
|
|
|
129 > disass $eip-32 $eip+32
|
|
|
130 Send us the full output of the above things!
|
|
|
131
|
|
|
132 In general:
|
|
|
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
|
|
|
137 </PRE>
|
|
|
138
|
|
|
139 </BODY>
|
|
|
140
|
|
|
141 </HTML>
|
