Rechercher une page de manuel
gldb
Langue: en
Version: October 2007 (MeeGo - 06/11/10)
Section: 1 (Commandes utilisateur)
NAME
gldb - console-based OpenGL debuggerSYNOPSIS
- gldb your-program [argument...]
DESCRIPTION
- Note
-
gldb(1)
- has been almost entirely superseded by gldb-gui(1), and is not actively maintained. You should try gldb-gui(1) first and only use gldb(1) if gldb-gui(1) does not work.
gldb is a front-end debugger to bugle(3), modelled on gdb(1). It can set breakpoints on OpenGL functions, and by default will stop whenever the program causes a GL error. Pressing Ctrl+C will also cause the running program to stop.
COMMANDS
chain name
- Specifies the name of the filter-set chain to use from the configuration file ~/.bugle/filters. If name is none then the default (no filters) is used.
help
- Shows the list of commands, with brief descriptions.
run
- Starts the program.
continue
- Continues running the program.
step
- Runs the program until the next OpenGL call.
kill
- Kills the running program.
break function
- Sets a breakpoint on the OpenGL function function.
break error
- Breaks on OpenGL errors. This is the default behaviour.
unbreak function
- Clears a breakpoint on function.
unbreak error
- Prevents breaking on OpenGL errors.
quit
- Exits gldb.
backtrace
- Prints a stack trace using gdb(1)
gdb
- Starts gdb(1) and attaches it to the program.
-
Note
The program will be waiting for commands from gldb, so continuing the program will have no effect.
state state
- Queries the OpenGL state state. If state is omitted, all state for the current context is shown. Try first running the command without argument to see how the states are arranged, as some state is nested. For example, the width of the default 2D texture is referenced as GL_TEXTURE_2D.0.0.GL_TEXTURE_WIDTH. Tab completion is also supported.
screenshot filename.ppm
- Captures a screenshot from the back buffer, and saves it to filename.ppm in ppm(5) format. Since the back buffer is used, you are not guaranteed a complete picture. For a complete picture, put a breakpoint on glXSwapBuffers and call this command from there.
enable filter-set, disable filter-set
- Enables or disables a filter-set on the fly. This is still experimental, and won't work for most filter-sets (because they expect to perform initialisation when the context is created). Dependent filter-sets will automatically be enabled, but will not be automatically disabled.
ENVIRONMENT
BUGLE_CHAIN, BUGLE_DEBUGGER, BUGLE_DEBUGGER_FD_IN, BUGLE_DEBUGGER_FD_OUT
- Internal environment variables used to communicate between the debugger and the library.
LD_PRELOAD
- Used internally to force loading of the library.
BUGS
On some systems, the gdb command will cause some of the processes involved to be stopped. The cause is currently unknown. The work-around is to use another terminal to manually connect gdb(1) to the process.
AUTHOR
bugle is written and maintained by Bruce Merry.
SEE ALSO
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre