How to report bugs Good bug reports are a very valuable contribution to the development of any software project. But just like writing good software, good problem reports involve some work. Please realize that most developers are extremely busy and receive obscene amounts of email. So while your feedback is crucial in improving MPlayer and very much appreciated, please understand that you have to provide all of the information we request and follow the instructions in this document closely. Report security related bugs In case you have found an exploitable bug and you would like to do the right thing and let us fix it before you disclose it, we would be happy to get your security advisory at security@mplayerhq.hu. Please add [SECURITY] or [ADVISORY] in the subject. Be sure that your report contains complete and detailed analysis of the bug. Sending a fix is highly appreciated. Please don't delay your report to write proof-of-concept exploit, you can send that one with another mail. How to fix bugs OUTDATED CONTENT REMOVED How to do regression testing using Subversion OUTDATED CONTENT REMOVED How to report bugs OUTDATED CONTENT REMOVED Where to report bugs OUTDATED CONTENT REMOVED The language of this list is English. Please follow the standard Netiquette Guidelines and do not send HTML mail to any of our mailing lists. You will only get ignored or banned. If you do not know what HTML mail is or why it is evil, read this fine document. It explains all the details and has instructions for turning HTML off. Also note that we will not individually CC (carbon-copy) people so it is a good idea to subscribe to actually receive your answer. What to report OUTDATED CONTENT REMOVED System Information OUTDATED CONTENT REMOVED Hardware and drivers OUTDATED CONTENT REMOVED Configure problems If you get errors while running ./configure, or autodetection of something fails, read config.log. You may find the answer there, for example multiple versions of the same library mixed on your system, or you forgot to install the development package (those with the -dev suffix). If you think there is a bug, include config.log in your bug report. Compilation problems Please include these files: config.h config.mak Playback problems Please include the output of MPlayer at verbosity level 1, but remember to not truncate the output when you paste it into your mail. The developers need all of the messages to properly diagnose a problem. You can direct the output into a file like this: mplayer -v options filename > mplayer.log 2>&1 If your problem is specific to one or more files, then please upload the offender(s) to: Also upload a small text file having the same base name as your file with a .txt extension. Describe the problem you are having with the particular file there and include your email address as well as the output of MPlayer at verbosity level 1. Usually the first 1-5 MB of a file are enough to reproduce the problem, but to be sure we ask you to: dd if=yourfile of=smallfile bs=1024k count=5 It will take the first five megabytes of 'your-file' and write it to 'small-file'. Then try again on this small file and if the bug still shows up your sample is sufficient for us. Please do not ever send such files via mail! Upload it, and send only the path/filename of the file on the FTP-server. If the file is accessible on the net, then sending the exact URL is sufficient. Crashes You have to run MPlayer inside gdb and send us the complete output or if you have a core dump of the crash you can extract useful information from the Core file. Here's how: How to conserve information about a reproducible crash Recompile MPlayer with debugging code enabled: ./configure --enable-debug=3 make and then run MPlayer within gdb using: gdb ./mplayer You are now within gdb. Type: run -v options-to-mplayer filename and reproduce your crash. As soon as you did it, gdb will return you to the command line prompt where you have to enter bt disass $pc-32 $pc+32 info all-registers How to extract meaningful information from a core dump Create the following command file: bt disass $pc-32 $pc+32 info all-registers Then simply execute this command: gdb mplayer --core=core -batch --command=command_file > mplayer.bug