wiki:BugReporting

Version 6 (modified by gbooker, 6 years ago) (diff)

--

If you are going to submit a bug report, there are a few steps to follow.

  1. Search for an existing tickets. If you find one that matches your report, comment there (if you have something to add)
  2. State whether you are on on AppleTV or Leopard
  3. Examine the last part of the console. On the AppleTV, you can execute tail /Library/Logs/Console/501/console.log. On Leopard, open /Applications/Utilities/Console.app. This is important even if it crashed, because it may have thrown an exception earlier in the code which caused the crash.
  4. If the console says that a crash log was written, examine that file. The console tells you the location of this file.
    1. If this file says that that it crashed due to an uncaught exception, there is no reason to post it, although there are few lines which would be useful to post. They are lines which state where in memory Sapphire and its components are located. Search the crash log for lines like the following (You may not have all lines, and they may look different. Also, I have removed data from these lines which is not necessary for debugging):
       0x14cf000 -  0x14d2fff  com.apple.frontrow.appliance.Sapphire.CompatClasses ??? (1.0)
       0x152b000 -  0x155bfff  com.apple.frontrow.appliance.Sapphire ??? (1.0b4.2 (408))
      0x14ba2000 - 0x14ba2ff8  com.apple.frontrow.appliance.Sapphire.LeopardOnly ??? (1.0)
      
  5. Prune the information.
    1. Console log information need only have data about exceptions, errors, and the like that came from Front Row (Finder on the AppleTV).
    2. Crash logs need only the last log, from the last set of * to the end.
  6. Post the above information here.
    1. Upload the file to a trac ticket (a new one if yours is not a duplicate, with the existing one if you found a ticket just like yours). If you upload a file, please use plain text files.
    2. Alternatively, you can post the info in your comment. Posting information looks best if it is enclosed in triple curly brackets, like the following:
      {{{
      Log contents
      }}}