[G-inspector-devel] |ANNOUNCE| GTracer-0.0.10

[Masatake Y. <je...@gy...>]

GTracer is updated to ginspector-200505029.
It is available from http://sourceforge.net/projects/gtracer/.
porting guide is also available, too.

A GNU Arch archive is at sourcefroge. See below.

Masatake YAMATO

gtracer: a g-inspector extension to inspect periodic aspects
============================================================

What is gtracer?
----------------

This is the private version of gtracer, a plugin and a preload set for
g-inspector. gtracer may help you to inspect periodic aspects of gtk+
applications.

gtracer provides follwoing functions:

    1. tracing gsignal's `connect', `emit', `disconnect' 
       and `callback invocations' in gtk application, and
       about `connect', `emit' and `disconnect', backtracing
       of function calls is also provided.

    2. tracing the invocations of `g_timeout_add_full' and
       `g_idle_add_full'. It also traces the sources detaching 
       from contexts. About invocations of `g_timeout_add_full' 
       and `g_idle_add_full', backtracing of function calls is 
       also provided.

Above two are the main functions of gtracer. gtracer provides
follwoing functions as the bonus:

    3. listing opend files in the target process, 

    4. listing unix signal handlers, and

    5. listing memory mapping of the target process.

Requirements
------------

* glib/gtk+ (2.0 or higher)
* g-inspector (*20050529*)

* i386 pc(inline assemble code and runtime function generator)
* glibc(ld.so)
* linux kernel(proc file system)
* GNU binutils(nm and readelf)

In addition, the binary format of the target application and libraries
linked to it must be ELF.

Installation
------------

    $ ./configure 
    $ make
    $ su
    # make install

Then gtracer-plugin.so and gtracer-preload.so are installed.
Make symbolic links from them to ~/.g-inspector/*/:

    $ mkdir -p ~/.g-inspector/plugins/
    $ mkdir -p ~/.g-inspector/preloads/
    $ ln -s /usr/local/lib/gtracer-plugin.so ~/.g-inspector/plugins/
    $ ln -s /usr/local/lib/gtracer-preload.so ~/.g-inspector/preloads/

Then run g-inspector. You will find some new menu items in "View" menu.

Limitation
----------

Current implementation of GTracer heavily depends on gtk's main loop.
GTracer cannot trace applications which don't use gtk's main loop.
The latest gimp(2.2 or higher) is one of such applications.

Development version
-------------------

You can get the latest development with GNUarch version control
system. GTracer's archive is at 

	http://gtracer.sourceforge.net/arch

archive/category--branch--version is

        je...@gy...--gtracer/gtracer--devo--0.0

Acknowledgment
--------------
This development is supported by Information-technology Promotion
Agency, Japan(IPA). We would like to appreciate the supports.

The original idea of gtracer comes from GTK TRACE which is mainly
developed by Masatake YAMATO.  GTK TRACE project is funded by
Information Science Fund for Young Researchers; IF of Graduate School
of Information Science, Nara Institute of Science and
Technology(NAIST). However, gtracer is completely rewritten from
scratch. GTK TRACE requires the recompile of the target gtk+
application. In other hands, gtracer doesn't.

Conctact
--------
Masatake YAMATO<ya...@re...>


# arch-tag: 02b06d25-6314-40dd-80d0-d4c73789018c