Source Locations¶
- class gccjit.Location¶
A gccjit.Location encapsulates a source code location, so that you can (optionally) associate locations in your language with statements in the JIT-compiled code, allowing the debugger to single-step through your language.
You can construct them using gccjit.Context.new_location().
You need to enable gccjit.BoolOption.DEBUGINFO on the gccjit.Context for these locations to actually be usable by the debugger:
ctxt.set_bool_option(gccjit.BoolOption.DEBUGINFO, True)
gccjit.Location instances are optional; most API entrypoints accepting one default to None.
Faking it¶
If you don’t have source code for your internal representation, but need to debug, you can generate a C-like representation of the functions in your context using gccjit.Context.dump_to_file():
ctxt.dump_to_file(b'/tmp/something.c', True)
This will dump C-like code to the given path. If the update_locations argument is True, this will also set up gccjit.Location information throughout the context, pointing at the dump file as if it were a source file, giving you something you can step through in the debugger.