Changing the preferences

To customize WinGDB use the "Preferences" command available in WinGDB menu. The following dialog will appear:

General preferences

Default debugger path points to location where gdb is. Default value for this setting is 'gdb'. If it is available on $PATH on the host you run your application on, then it is unnecessary to provide the full path.
Log session to file: enable it only if you have found bug or experience any problems with WinGDB. Diagnostic data will be dumped to log file at each debugging session. This option influences performance, so it should be enabled only if it is really necessary.
Enable disassembly dignostic mode: extended diagnostic mode concerning Disassembly View. It may be very slow, so enable it only if you experience any problems with that kind of view. It doesn't diagnose other features.
Always use manual shell configuration: in case of trouble with shell communication (e.g. if remote account needs some user interaction after login) WinGDB displays a console. By default WinGDB displays it only once and stores all user's input. If this option is enabled, then console will be displayed every time it is needed.
Maximum displayed stack depth: maximal number of frames showed in call-stack
Options concerning Cygwin are described in separated section Debugging Cygwin programs.
Suppress init files: if enabled debugger will not execute commands found in any standard initialization files like .gdbinit (it doesn't affect WinGDB custom initialization script).

Disassembly preferences

By default assembler syntax visible in "Disassembly view" depends on debugger and platform you run your application on. If you prefer other syntax then choose favourable one from the list in that dialog. If debugger supports other syntax that AT&T or Intel and simultaneously it is not default, then choose option "Custom" and put specified qualifier.

In most cases 'Default' is appropriate choice and gives expected results.

All changes take effect at next debugging session.

Table of Contents