<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"
>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>mplayer - bugreports</title>
<style type="text/css">
<!--
body { font-family: Arial, Helvetica, sans-serif; }
-->
</style>
</head>
<body>
<h1><a name="appendix_c">Appendix C - How to report bugs</a></h1>
<h2>How to report bugs?</h2>
<p>
First of all you might want to try the latest CVS as your bug
might already be fixed there. CVS instructions can be found on
our homepage.
</p>
<p>
If it didn't help please refer to <a
href="documentation.html#appendix_d">Appendix D</a> and the rest of the
documentation. If your problem is not known or not solveable by our
instructions, then please report the bug.
</p>
<h2>Where to report bugs?</h2>
<p>
Subscribe to the mplayer-users mailing list: <br />
<a href="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</a> <br />
and after that you may send your bugreport to: <br />
<a href="mailto:mplayer-users@mplayerhq.hu">mplayer-users@mplayerhq.hu</a> <br/>
Please note that we won't individually carbon-copy people so it's a
clever idea to subscribe to actually receive your answer.
</p>
<p>
Please don't send bugreports privately to individual developers. This is
community work and thus there might be several people interested in it.
Also sometimes other users already experienced your troubles and have a
solution in hand how to circumvent a problem even if it's a bug in mplayers
code. <br />
The language of this list is <strong>english</strong>.
</p>
<p>
Please describe your problem as detailed as possible with examples etc.
and don't forget to include this valuable information:
</p>
<h2>What to report?</h2>
<h3>System information</h3>
<ul>
<li>Your linux distribution or operating system eg.:
        <ul>
         <li>RedHat 7.1</li>
         <li>Slackware 7.0 + devel packs from 7.1 ...</li>
        </ul>
</li>
<li>
        kernel version:<br />
        <code>uname -a</code>
</li>
<li>
        libc version:<br />
        <code>ls -l /lib/libc[.-]*</code>
</li>
<li>
        X version:<br />
        <code>X -version</code>
</li>
<li>
        gcc and ld versions:<br />
        <code>gcc -v</code><br />
        <code>ld -v</code>
</li>
<li>
        binutils version:<br />
        <code>as --version</code>
</li>
</ul>
<h3>Hardware & drivers</h3>
<ul>
<li>
        CPU info (linux only):<br />
        <code>cat /proc/cpuinfo</code>
</li>
<li>
        Videocard manufacturer and model e.g.:<br />
        <ul>
         <li>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</li>
         <li>Matrox G400 DH 32MB SGRAM</li>
        </ul>
</li>
<li>
        Videodriver types & versions, eg.:
        <ul>
         <li>X built-in driver</li>
         <li>nvidia 0.9.623</li>
         <li>Utah-GLX CVS 2001-02-17</li>
         <li>DRI from X 4.0.3</li>
        </ul>
</li>
<li>
        Soundcard type & driver, eg.: <br />
        <ul>
         <li>Creative SBLive! Gold with OSS driver from oss.creative.com</li>
         <li>Creative SB16 with OSS drivers of kernel</li>
         <li>GUS PnP with ALSA OSS emulation</li>
        </ul>
</li>
<li>
        if in doubt include <code>lspci -vv</code> output on linux systems
</li>
</ul>
<h3>For compiling problems/errors</h3>
<p>
Please include these files:
</p>
<ul>
<li>configure.log</li>
<li>config.h</li>
<li>config.mak</li>
<li>libvo/config.mak</li>
</ul>
<h3>For playback problems</h3>
<p>
Please include the output of mplayer at verbosity level 1<br />
<code>mplayer -v [options] filename &> mplayer.log</code>
</p>
<p>
If your problem is specific to one or more files, then please upload the
offfender(s) to:<br />
<a href="ftp://mplayerhq.hu/MPlayer/incoming/">ftp://mplayerhq.hu/MPlayer/incoming/</a><br />
Also upload a small .txt file having the same basename as your file,
which describes the problem you're having with the particular file.<br />
Usually the first 1-5 MB of a file are enough to reproduce the problem,
but to be on the sure side we ask you to to: <br />
<code>dd if=yourfile of=smallfile bs=1k count=1024</code> it will take
the first megabyte of <strong>'yourfile'</strong> and write it to
<strong>'smallfile'</strong>.<br />
Then try again on this small file and if the bug still shows up
your sample is sufficient for us.<br />
Please <strong>do not ever</strong> send such files via mail! Upload it,
and send only the path/filename of the file on the FTP-server.<br />
If the file is accessible on the net, then sending the
<strong>exact</strong> URL is sufficient.
</p>
<h3>For crashes</h3>
<p>
If you have a coredump of the crash continue reading the next
paragraph, otherwise skip it.
</p>
<h4>How to receive meaningful information from a coredump</h4>
<p>
Please create the following command file:
</p>
<pre>
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
</pre>
<p>
Then simply execute the following on your commandline:<br />
<code>gdb mplayer --core=core -batch --command=command_file > mplayer.bug
</code>
</p>
<h4>How to conserve information about a reproducible crash</h4>
<p>
Re-compile mplayer with debugging code enabled:<br />
<code>./configure --enable-debug</code><br />
<code>make</code> <br />
and then run mplayer within gdb using:<br />
<code>gdb mplayer</code><br />
</p>
<p>
You're now within gdb<br />
Type: <br />
<code>run -v [options-to-mplayer] filename</code><br />
and reproduce your crash. As soon as you did it, gdb will
return you to the commandline prompt where you'll enter<br />
<code>bt</code><br />
<code>disass $eip-32 $eip+32</code><br />
and send the complete output to us.
</p>
<h4>General note:</h4>
<p>
If something is quite big (logs for instance) then it's better to upload
it to the ftp-server in a gzipped format and include only the path and
filename in your bugreport.
</p>
<h3>I know what I am doing...</h3>
<p>
If you created a proper bugreport following the steps above and you are
confident it's a mplayer bug, not a compiler problem or broken file,
you've already read the documentation and you couldn't find a solution,
your sound drivers are ok, then you might want to subscribe to the
mplayer-advusers list and send your bugreport there to get a better and
faster answer.<br />
<br />
Please be advised that if you post newbie questions or questions answered
in the manual there, you'll be ignored or flamed instead of getting an
appropriate answer.<br />
So don't flame us and subscribe to -advusers only if you really know
what you are doing and feel like being an advanced mplayer user or
developer. If you meet these criteria it shouldn't be difficult to find
out how to subscribe...
</p>
</body>
</html>