Telepathy debugging: Difference between revisions

From OLPC
Jump to navigation Jump to search
(core files)
(remove redundant Category:Software)
 
(12 intermediate revisions by 5 users not shown)
Line 1: Line 1:
This page explains how to enable Telepathy debug output on your XO.
== Enabling debug logs for Telepathy ==


When there are certain kinds of problems with collaboration on the XO, it is useful to developers to have log files for debugging purposes. Here is how to enable these log files.
* First you need to [http://wiki.laptop.org/go/Olpc-utils#.2Fhome.2Folpc.2F.xsession enable] your /home/olpc/.xsession file
mv /home/olpc/.xession-example /home/olpc/.xsession
* Then edit it and uncomment the lines about GABBLE_DEBUG, GABBLE_LOGFILE, SALUT_DEBUG and SALUT_LOGFILE
* LM_DEBUG and GIBBER_DEBUG can be useful to debug lower level problems but will produce really bigger log files
* reboot


'''If you haven't already seen [[Attaching Sugar logs to tickets]], see that page first''' to create a <tt>/home/olpc/.xsession</tt> file.
Telepathy log files are now available at /home/olpc/.sugar/default/logs/telepathy-gabble.log and /home/olpc/.sugar/default/logs/telepathy-salut.log .

Be sure to attach these files if you submit a ticket about a Telepathy issue.
* Edit .xsession and uncomment the lines about GABBLE_DEBUG, GABBLE_LOGFILE, SALUT_DEBUG, SALUT_LOGFILE, PRESENCESERVICE_DEBUG and '''SUGAR_LOGGER_LEVEL''' 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

Telepathy log files are now available in <tt>/home/olpc/.sugar/default/logs/</tt>. Be sure to attach <tt>presenceservice.log</tt>, <tt>telepathy-gabble.log</tt> and <tt>telepathy-salut.log</tt> if you submit a ticket about a Telepathy issue.


== Capturing core files ==
== Capturing core files ==


Core files are produced when a program crashes and contain useful debugging information.
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.


As root:
* As root:


echo /tmp/core-%p-%e > /proc/sys/kernel/core_pattern
echo /tmp/core-%p-%e > /proc/sys/kernel/core_pattern


This tells the kernel to put core files into the /tmp directory.
: This tells the kernel to put core files into the /tmp directory. This will only be effective until the laptop is rebooted. To make it persistent across reboots, add the following line to /etc/sysctl.conf:

To make this persist across reboots, add the following line to /etc/sysctl.conf:


kernel.core_pattern = /tmp/core-%p-%e
kernel.core_pattern = /tmp/core-%p-%e


Add the following line to /home/olpc/.xsession:
* Add the following line to <tt>/home/olpc/.xsession</tt>:


ulimit -c unlimited
ulimit -c unlimited


This turns off any limit on core file size.
This turns off any limit on core file size.

== Debugging scenarios ==

XXX

* no presence seen on (or of) other machines/laptops
* activity was shared but doesn't appear on other laptops
* invitation was sent but not received
* other sharing problems

[[category:developers]]
[[Category:Telepathy]]

Latest revision as of 09:54, 21 December 2008

Enabling debug logs for Telepathy

When there are certain kinds of problems with collaboration on the XO, 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 Attaching Sugar logs to tickets, see that page first to create a /home/olpc/.xsession file.

  • Edit .xsession and uncomment the lines about GABBLE_DEBUG, GABBLE_LOGFILE, SALUT_DEBUG, SALUT_LOGFILE, PRESENCESERVICE_DEBUG and SUGAR_LOGGER_LEVEL 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

Telepathy log files are now available in /home/olpc/.sugar/default/logs/. Be sure to attach presenceservice.log, telepathy-gabble.log and telepathy-salut.log if you submit a ticket about a Telepathy issue.

Capturing core files

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.

  • As root:
 echo /tmp/core-%p-%e > /proc/sys/kernel/core_pattern
This tells the kernel to put core files into the /tmp directory. This will only be effective until the laptop is rebooted. To make it persistent across reboots, add the following line to /etc/sysctl.conf:
 kernel.core_pattern = /tmp/core-%p-%e
  • Add the following line to /home/olpc/.xsession:
 ulimit -c unlimited

This turns off any limit on core file size.

Debugging scenarios

XXX

  • no presence seen on (or of) other machines/laptops
  • activity was shared but doesn't appear on other laptops
  • invitation was sent but not received
  • other sharing problems