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

the make variable MODE must be set to debug, as in:
make ARCH=i686-linux MODE=debug          # for a i686-linux arch

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.