Traceglasses : A Trace-Based Debugger

Traceglasses : A Trace-Based Debugger

Menu

Research Projects

Contact

Mail

sakurai_at_ec.t.kanazawa-u.ac.jp

Affiliation

[
Japanese ]

  1. Overview
  2. Download
    1. Trying with an example
    2. traceglasses-pta
  3. License
  4. Publications
  5. Links

Overview

Traceglasses is an implementation of trace-based debugger for Java.

Contact: Kouhei Sakurai <sakurai_at_graco.c.u-tokyo.ac.jp>

  • Recording history of a program execution, and showing it in format similar to source code.
  • GUI for setting of target programs and so on.
  • Searching events that use specific values, from recorded history.

Download

(2011.9.29 updated)

The software requires Java 6 for execution.

For detail usage, please read a manual contained in the archive (doc/manual/manual-jp.html). (Sorry currently available only in Japanese…)

Trying with an example

  • First, expand the archive to a directory, and double click traceglasses.jar contained in the directory.
  • Open an example project: Click “Open” button of the toolbar, and select doc/examples/hello-trace contained in the archive.
  • The example already contains recorded traces data. So, you can show the data by clicking “Show” button in the toolbar.

traceglasses-pta

 % java -Xmx1000m -jar traceglasses-pta-1.0.0.jar

To test the analysis:

  • download
    FileLister.zip and expand it.
  • launch traceglasses-pta by the above command line.
  • click the “Open” tool button and select and open the expanded “FileLister” directory in the dialog.
  • The directory already contains recorded traces. So click the “Show” button to open the trace browser.
  • expand tree nodes “root”, “thread-1”, “FileLister.main(<String[]:1>”, “.run()”, “this:.printList()”. Then the node ” = this:.list” will appear.
  • To analyse the object “”, open the context menu for the node (right click the node) and select “” > ” : Analyze Potential Events (Max 5 Hops)”. (See the following screenshot.)

License

 Traceglasses License: (BSD style)
    Copyright (c) 2009-2010, Kouhei Sakurai <sakurai_at_graco.c.u-tokyo.ac.jp>
    All rights reserved.

    Redistribution and use in source and binary forms, with or without modification,
    are permitted provided that the following conditions are met:

       1. Redistributions of source code must retain the above copyright notice,
          this list of conditions and the following disclaimer.
       2. Redistributions in binary form must reproduce the above copyright notice,
          this list of conditions and the following disclaimer in the documentation
          and/or other materials provided with the distribution.
       3. The name of the author may not be used to endorse or promote products
          derived from this software without specific prior written permission.

    THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
    WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
    AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
    LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
    LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Publications

  • (In Japanese) Kouhei Sakurai, Hidehiko Masuhara, Seiichi Komiya, “Traceglasses: A Trace-based Debugger for Realizing Efficient Navigation”
    • PDF
    • IPSJ PRO (Information Processing Society of Japan, Transaction of Programming), 3(3),1-17 (2010-06-16) , 1882-7802

Links