Things we want from EVERY report:
- FULL Debug Log (Please use your favourite paste site! See below.) << NOT OPTIONAL!
- If you can, get screenshots to illustrate problems (See below)
- "Latest" is NOT a revision, of ANYTHING! (See below)
- Linux Distribution and Version (See below)
- Architecture (e.g.. i686, x86_64, etc. (See below)
- Install Method (PPA, RPM, build.sh, manual, other)
- GIT Revision (See below.)
- Detailed Instructions to Reproduce the Problem (The more specific the better.)
- Backtrace (Only attainable if XBMC has crashed. See below.)
- Compiler Output (Only useful if XBMC doesn't build. See below.)
GUI Problems (Navigation, Finding options, Setup, Labels, etc):
- Skin name
- Video codec and container.
- Audio codec and container.
- You may also be asked for a sample. << Use sites like Dropbox or Mediafire and do not post copyrighted materials.
Other things that may be useful:
- System hardware specs (CPU, RAM, Chipset, etc.)
- Kernel Version
"Latest" is a completely useless version!
When referring to the version of something, ALWAYS be as detailed as possible. Saying you're using the latest version of something is wrong the second it is updated, and completely useless to someone looking for help on a similar problem in the future. (NOTE: It is perfectly fine to tell someone to upgrade to the latest version of something as this is nearly always a good idea.) Some good examples...
- Kubuntu 8.04 up to date as of 2008-06-29
- XBMC for Mac r14000
- libsmbclient 3.0.27
How do I find my architecture?
How do I find my GIT revision number?
From home screen in default Confluence skin...
- Choose "System Info" (submenu item)
- GIT Revision is at the bottom of each page (XBMC 12.0-"tag" Git:20130104-de8789a)
Where is my debug log?
- Read http://wiki.xbmc.org/?title=Log_file thoroughly.
- Don't forget to enable debugging!
- Don't forget to use a paste site!
sudo apt-get install pastebinit -y
cat $HOME/.xbmc/temp/xbmc.log | pastebinit
How do I obtain a backtrace? (Only obtainable if XBMC has crashed out completely to the desktop or terminal)
- Open terminal
- Run "ulimit -c unlimited" (You only need to do this if no core file is created automatically)
- Run "xbmc"
- Reproduce the crash.
- Install gdb if you don't have it "sudo apt-get install gdb"
- Run "gdb /path/to/xbmc.bin /path/to/core" (xbmc.bin path is in the debug log (see above), core file should be in the current directory (may have the process ID number appended))
- Once gdb has loaded up type "thread apply all bt" and press enter.
- Press return until you're back at the prompt then copy and paste the output to your favorite paste site.
- Type "q" then enter to quit GDB.
- Delete the core file to avoid confusion later.
How do I obtain useful compiler output?
First things first, wait 24hrs. Just as the police don't care if your kids are missing, we don't care if you can't compile! XBMC is in a constant state of flux and it is VERY likely that any compile errors will be resolved in a much shorter time than this. That being said, what not to post. "make: *** [some target] Error #", I'm sure we can all agree that this tells us nothing other than something bad happened while building "some target", so don't waste your time posting it.
Now, there probably isn't actually a problem. Try this from a terminal.
git clean -xfd && git reset --hard && git pull --rebase
If the failure occurs again (and the 24hr timer is up!), run "make" and only "make" (no -j# option especially), and paste this output to your favourite paste site.
File Hosting sites: