Documentation/devtools/maemo5

(Debugging)
Line 201: Line 201:
$ apt-get source <src pkg name>                         
$ apt-get source <src pkg name>                         
</pre>
</pre>
 +
 +
[[Category:Devtools]]

Revision as of 11:03, 12 February 2010

These tools are available in the official maemo 5 Fremantle tools repository at repository.maemo.org. Some of them may have already been available unofficially, but these versions are tested for functionality.

You can propose new tools by filing an enhancement request in Bugzilla.

Installation instructions are available below.


Contents

Categories

The tools are arranged into different categories so that you can easily see what tools are available for specific kinds of tasks. The same tool can be present in multiple categories.

Code Analysis

doxygen a source code documentation generator tool
gtk-doc an API documentation generator

Debugging

crash-reporter user-friendly graphical user interface for sp-rich-core
gdb GDB is the GNU debugger
functracer an allocation backtrace tool
functracer-postproc a post-processing tool for functracer output data
latrace display a program's dynamic library calls
ltrace a library call tracer
maemo-debug-scripts a set of scripts to help with debugging tasks
sp-error-visualizer displays log messages as banners
sp-rich-core a core dump data saver
sp-rich-core-postproc contains rich-core-extract to examine *.rcore.lzo files created by sp-rich-core
sp-response-time a library for monitoring UI response times
sp-startup-time a library for calculating application startup times
strace a system call tracer
syslog a log message collecting service
valgrind a suite of tools for debugging and profiling programs
x11-utils a collection of X Window System debugging tools; xev, xwininfo, xprop, xlsatoms and xlsclients.

Miscellaneous

less a text file viewer/pager
osso-xterm a terminal emulator
man-db manual page infrastructure
screen provides access to detachable console sessions

Editors

nano a friendly text editor
vi a text editor

Graphics

screenshot-tool a command line utility to take screenshots
xresponse measures the time taken to update the screen after user action
xresponse-visualize scripts for visualizing xresponse logs

Networking

iputils a collection of TCP/IP related utilities
netcat a utility to read and write data across network connections
tcpdump a network traffic capturing utility
traceroute print the route packets take to a network host
wget a utility to non-interactively download files from the Web

Performance

oprofile a low overhead system wide profiler
oprofileui a user interface to oprofile
sp-startup-time a library for calculating application startup times
valgrind a suite of tools for debugging and profiling programs
xresponse measures the time taken to update the screen after user action
xresponse-visualize scripts for visualizing xresponse logs

Resource Usage

functracer an allocation backtrace tool
functracer-postproc a post-processing tool for functracer output data
htop an interactive process viewer
sp-endurance tools to collect system endurance related information
sp-endurance-postproc postprocessing scripts to parse and generate a report from endurance measurement data
sp-memusage a collection of memory usage monitoring tools and scripts
sp-smaps-measure utilities for taking snapshots of smaps memory information
sp-smaps-visualize utilities for analyzing smaps memory information
sysstat tools for collecting and reporting system activity information
valgrind a suite of tools for debugging and profiling programs
xrestop shows X clients' X resource usage

Test Automation

check a unit test framework for C
sp-stress tools to create artificial system load
xnee automate user actions under X11
xresponse measures the time taken to update the screen after user action

Wireless Tools

bluez-hcidump a tool to monitor Bluetooth activity
wireless-tools tools for manipulating Linux Wireless Extensions

Installation

These tools can be installed in the device by activating the Fremantle tools repository in the Application manager. Developers can also install them to the device or in Scratchbox using the command line interface.

To activate the tools repository with the Application manager, open this single-click install file, or manually create a new catalogue like this:


Catalogue name: fremantle tools
Web address: http://repository.maemo.org
Distribution: fremantle/tools
Components: free non-free
Disabled: leave unchecked


If you prefer to edit configuration files yourself instead of using the Application manager, add these lines to your /etc/apt/sources.list

# fremantle tools
deb http://repository.maemo.org fremantle/tools free non-free
# fremantle tools sources
deb-src http://repository.maemo.org fremantle/tools free non-free


To install a binary package in Scratchbox:

$ fakeroot apt-get install <bin pkg name>

To install a binary package to the device (as root):

$ apt-get install <bin pkg name>   

To install a source package in Scratchbox or to the device:

$ apt-get source <src pkg name>