Changes

Jump to navigation Jump to search
m
Line 1: Line 1:  +
<noinclude>
 +
[[Category:Testing]]
 +
[[Category:BugSquad]]
 +
[[Category:HowTo]]
 +
</noinclude>
 
== Enabling debug logs for Telepathy ==
 
== Enabling debug logs for Telepathy ==
   −
When there are certain kinds of problems with collaboration, it is useful to developers to have log files for debugging purposes. Here is how to enable these log files. If you haven't already seen [[BugSquad/GetLogs]], see that page first.
+
When there are certain kinds of problems with collaboration, it is useful to developers to have log files for debugging purposes. Here is how to enable these log files. If you haven't already seen [[BugSquad/Get Logs]], see that page first.
 +
 
 +
=== Fedora 20 through Fedora 35/rawhide ===
   −
* Enable your <tt>~/.xsession</tt> file]
+
Starting with Fedora 20, to enable debug logging of Salut and Gabble:
  cp ~/.xsession-example ~/.xsession
+
* Edit the /etc/environment file
* Edit .xsession and uncomment the lines about GABBLE_DEBUG, GABBLE_LOGFILE, SALUT_DEBUG, SALUT_LOGFILE and PRESENCESERVICE_DEBUG by removing the initial '#' character
+
G_MESSAGES_DEBUG="all"
* For debugging lower level problems in the Telepathy connection managers, enable LM_DEBUG (for [[telepathy-gabble]]) or GIBBER_DEBUG (for [[telepathy-salut]]). Note that these will produce much bigger log files.
+
SALUT_DEBUG="all"
 +
SALUT_LOGFILE=/home/olpc/salut.log
 +
GABBLE_DEBUG=all
 +
GABBLE_LOGFILE=/home/olpc/gabble.log
 
* Reboot
 
* Reboot
 +
 +
=== Fedora 18 ===
 +
* Edit the ~/.sugar/debug file (default version shown below in the gray box) and uncomment the lines about GABBLE_DEBUG, GABBLE_LOGFILE, SALUT_DEBUG, SALUT_LOGFILE and PRESENCESERVICE_DEBUG by removing the initial '#' character
 +
* For debugging lower level problems in the Telepathy connection managers, enable LM_DEBUG (for telepathy-gabble) or GIBBER_DEBUG (for telepathy-salut). Note that these will produce much bigger log files.
 +
* Reboot (or restart the display manager).
 +
 +
<pre>
 +
# Uncomment the following lines to turn on many sugar debugging
 +
# log files and features
 +
#export LM_DEBUG=net
 +
#export GABBLE_DEBUG=all
 +
#export GABBLE_LOGFILE=$HOME/.sugar/default/logs/telepathy-gabble.log
 +
#export SALUT_DEBUG=all
 +
#export SALUT_LOGFILE=$HOME/.sugar/default/logs/telepathy-salut.log
 +
#export GIBBER_DEBUG=all
 +
#export PRESENCESERVICE_DEBUG=1
 +
#export SUGAR_LOGGER_LEVEL=debug
 +
 +
# Uncomment the following line to enable core dumps
 +
#ulimit -c unlimited
 +
</pre>
    
Telepathy log files are now available at <tt>~/.sugar/default/logs/telepathy-gabble.log</tt> and <tt>~/.sugar/default/logs/telepathy-salut.log</tt> .
 
Telepathy log files are now available at <tt>~/.sugar/default/logs/telepathy-gabble.log</tt> and <tt>~/.sugar/default/logs/telepathy-salut.log</tt> .
 
Be sure to attach these files if you submit a ticket about a Telepathy issue.
 
Be sure to attach these files if you submit a ticket about a Telepathy issue.
   −
== Capturing core files ==
+
== Capturing core files (XO specific) ==
    
Core files are produced when a program crashes and contain useful debugging information. By default, core files are disabled on the XO. Here is how to enable them.
 
Core files are produced when a program crashes and contain useful debugging information. By default, core files are disabled on the XO. Here is how to enable them.
Line 24: Line 55:  
   kernel.core_pattern = /tmp/core-%p-%e
 
   kernel.core_pattern = /tmp/core-%p-%e
   −
* Add the following line to <tt>~/.xsession</tt>:
+
* Add the following line to <tt>./sugar/debug</tt>:
    
   ulimit -c unlimited
 
   ulimit -c unlimited
Line 31: Line 62:     
== Debugging scenarios ==
 
== Debugging scenarios ==
  −
XXX
      
* no presence seen on (or of) other machines/laptops
 
* no presence seen on (or of) other machines/laptops
Line 39: Line 68:  
* other sharing problems
 
* other sharing problems
   −
[[Category:BugSquad]]
+
===Troubleshooting example===
 +
See this discussion thread, http://www.mail-archive.com/devel@lists.laptop.org/msg24799.html

Navigation menu