aboutsummaryrefslogtreecommitdiffhomepage
path: root/DOCS/bugreports.html
diff options
context:
space:
mode:
authorGravatar gabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2>2001-08-21 21:01:54 +0000
committerGravatar gabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2>2001-08-21 21:01:54 +0000
commitc10396e50ff2aafa4bcc480f8391927425f3bb2d (patch)
tree0498a88de8e547e6b17b13c4b1c5305b54fdc451 /DOCS/bugreports.html
parent1af8d58c0bf4a4cbac5fa9e5cfb8bc382c047b8c (diff)
new, splitted, etc dox
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@1613 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS/bugreports.html')
-rw-r--r--DOCS/bugreports.html141
1 files changed, 141 insertions, 0 deletions
diff --git a/DOCS/bugreports.html b/DOCS/bugreports.html
new file mode 100644
index 0000000000..5c4f47a387
--- /dev/null
+++ b/DOCS/bugreports.html
@@ -0,0 +1,141 @@
+<HTML>
+
+<BODY>
+
+<PRE>
+
+ <A NAME=C>Appendix C - How to report bugs
+
+How to report bugs?
+~~~~~~~~~~~~~~~~~~~
+First read DOCS/BUGS, and other docs. If your problem isn't
+known or isn't solved by our instructions, then report the bug:
+
+Where?
+======
+Subscribe to the mplayer-users mailing list:
+ http://lists.sourceforge.net/lists/listinfo/mplayer-users
+and send your bugreport to:
+ mplayer-users@lists.sourceforge.net
+We won't CC: so please subscribe!!!
+
+Don't send bugreports private, directly to author's address!!!
+We are working together on code, so everyone is interested in it.
+BTW many times other users know the solution (system config probs,
+bad drivers etc), even when we think it's a bug in our code.
+The language of this list is ENGLISH !
+
+Please describe your problem in details, examples etc, and don't
+forget to include these:
+
+What?
+=====
+
+1. The system info what we always want:
+- linux distribution
+ examples:
+ RedHat 7.1
+ Slackware 7.0 + devel packs from 7.1 ...
+- kernel version:
+ uname -a
+- libc version:
+ ls -l /lib/libc[.-]*
+- X version:
+ X -version
+- gcc and ld version:
+ gcc -v
+ ld -v
+- binutils version:
+ as --version
+
+2. Hardware & drivers:
+- CPU info:
+ cat /proc/cpuinfo
+- video card manufacturer and model
+ examples:
+ ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM
+ Matrox G400 DH 32MB SGRAM
+- video driver type&version
+ examples:
+ X built-in driver
+ nvidia 0.9.623
+ Utah-GLX CVS 2001-02-17
+ DRI from X 4.0.3
+- sound card type & driver
+ examples:
+ Creative SBLive! Gold with OSS driver from oss.creative.com
+ Creative SB16 with OSS drivers of kernel
+ GUS PnP with ALSA OSS emulation
+- if you are unsure, attach output of lspci -v
+
+For compiling problems/errors:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+3. output of configure/make:
+ make distclean
+ ./configure &>config.log
+ ./make &>make.log
+4. these files:
+ config.h
+ config.mak
+ libvo/config.mak
+
+For playback problems:
+~~~~~~~~~~~~~~~~~~~~~~
+3. Output of mplayer at verbose level 1 (-v)
+ mplayer -v [options] filename &> mplayer.log
+
+4. If the problem is specific to one or a few files,
+ then please upload that file to:
+ ftp://mplayerhq.hu/MPlayer/incoming/
+ Usually first 1-5 MB of the file is enough to reproduce
+ the problem, but first you should try it:
+ dd if=yourfile of=smallfile bs=1k count=1024
+ (it will cut first 1MB of 'yourfile' and save to 'smallfile')
+ Then try again on this small file, and if bug still exists
+ then it's enough to upload this small file.
+ NEVER send such files via mail! Upload it, and send only
+ the path/filename of the file on the FTP.
+ If the file is accessible on the net, then sending the
+ _exact_ URL is enough!
+
+5. For crashes (segfault, SIGILL, signal 4 etc):
+
+If you have coredump of the crash, see 5.a, else see 5.b:
+
+5.a: Please print us coredump (if it was created).
+Howto:
+please create following command file:
+
+disass $eip-32 $eip+32
+printf "eax=%08lX\n",$eax
+printf "ebx=%08lX\n",$ebx
+printf "ecx=%08lX\n",$ecx
+printf "edx=%08lX\n",$edx
+printf "esp=%08lX\n",$esp
+printf "ebp=%08lX\n",$ebp
+printf "edi=%08lX\n",$edi
+printf "esi=%08lX\n",$esi
+
+Then simply execute following command line:
+gdb mplayer --core=core -batch --command=command_file >mplayer.bug
+
+5.b.: run <B>MPlayer</B> in gdb:
+[at root/user shell prompt:]
+ # gdb mplayer
+[at gdb prompt:]
+ > run -v [options-to-mplayer] filename
+ ... (wait until it will crash)
+ > bt
+ > disass $eip-32 $eip+32
+Send us the full output of the above things!
+
+In general:
+~~~~~~~~~~~
+ If something is big (logs etc) then it's better to upload to the ftp
+ (gzipped), and include only path/filename in the bugreport!
+
+</PRE>
+
+</BODY>
+
+</HTML>