SYNOPSIS

golo-debug [options] command [arguments]

DESCRIPTION

This programm is just a wrapper around golo(1) that additionnaly sets some environment options to ease debugging.

More specifically, the golo.debug property is set to true, and the JVM is run with a debugging JDWP agent option listening on the port 6666 (namely -agentlib:jdwp=transport=dt_socket,server=y,address=6666,suspend=y -Xdiag).

ENVIRONMENT VARIABLES AND PROPERTIES

The behavior of the golo compiler or runtime can be tuned using some environment variables or java properties.

GOLO_DEBUG_OPTS or JAVA_OPTS

Defines additional JVM options. For instance, to trace the class loaded, one can define GOLO_DEBUG_OPTS="-verbose:class"

CLASSPATH

Defines the search path for java classes. Also used for golo modules.

Other environment variables and properties that are used by golo(1).

EXAMPLES

First, run the programm in debug mode:

$ golo-debug golo --files samples/coin-change.golo
Listening for transport dt_socket at address: 6666

Attach a debugger:

$ jdb -sourcepath sample -attach 6666

See the JDB documentation[1] for more information.

Graphical debuggers can also be used.

SEE ALSO

java(1), golo(1)

NOTES

BUGS

AUTHOR

See https://github.com/eclipse/golo-lang/graphs/contributors or the CONTRIBUTORS file in the golo source distribution.

This work is made available under the terms of the Eclipse Public License 2.0. See http://www.eclipse.org/legal/epl-2.0 or the LICENCE file in the golo source distribution.