jMax jMax documentation

Debugging jMax


Introduction

This document explains how to run FTS (the real time engine of jMax) under a debugger. This is usefull for instance if you want to debug your objects. 


Running FTS under the debugger

In order to run FTS under a debugger, the following steps must be taken:
a) recompile FTS with debug options
        ./configure --enable-debug
        make
        make install
b) start the Java GUI
the following options must be used:
jmax -jmaxConnection udpclient -jmaxMode debug -jmaxPort 
The console window should appear, but remains almost empty.

Note: you can pass also a -jmaxHost HOST_NAME option to jmax.

c) start the debuggger
for instance with gdb:
$ cd /home/francois/jmax/fts/bin/i686-linux/debug
$ gdb fts
d) start fts under the debugger
the following options must be passed to FTS:
run udp MY_MACHINE:MY_PORT_NUMBER
where:
  MY_MACHINE is the name of the host running FTS (can be 127.0.0.1)
  MY_PORT_NUMBER is the port number that you gave to the -jmaxPort option when starting jmax.

The console window should now be filled with normal startup messages. You can then stop fts under the debugger, put breakpoints, continue, as usual in a debugger session.

Copyright © 1995,1999 IRCAM.
All rights reserved.