22.5 Output Styling

GDB can style its output on a capable terminal. This is enabled by default on most systems, but disabled by default when in batch mode (see Mode Options). Various style settings are available; and styles can also be disabled entirely.

set style enabled ‘on|off’

Enable or disable all styling. The default is host-dependent, with most hosts defaulting to ‘on’.

show style enabled

Show the current state of styling.

set style sources ‘on|off’

Enable or disable source code styling. This affects whether source code, such as the output of the list command, is styled. The default is ‘on’. Note that source styling only works if styling in general is enabled, and if a source highlighting library is available to GDB.

There are two ways that highlighting can be done. First, if GDB was linked with the GNU Source Highlight library, then it is used. Otherwise, if GDB was configured with Python scripting support, and if the Python Pygments package is available, then it will be used.

show style sources

Show the current state of source code styling.

set style disassembler enabled ‘on|off’

Enable or disable disassembler styling. This affects whether disassembler output, such as the output of the disassemble command, is styled. Disassembler styling only works if styling in general is enabled (with set style enabled on), and if a source highlighting library is available to GDB.

To highlight disassembler output, GDB must be compiled with Python support, and the Python Pygments package must be available. If these requirements are not met then GDB will not highlight disassembler output, even when this option is ‘on’.

show style disassembler enabled

Show the current state of disassembler styling.

Subcommands of set style control specific forms of styling. These subcommands all follow the same pattern: each style-able object can be styled with a foreground color, a background color, and an intensity.

For example, the style of file names can be controlled using the set style filename group of commands:

set style filename background color

Set the background to color. Valid colors are ‘none’ (meaning the terminal’s default color), ‘black’, ‘red’, ‘green’, ‘yellow’, ‘blue’, ‘magenta’, ‘cyan’, and‘white’.

set style filename foreground color

Set the foreground to color. Valid colors are ‘none’ (meaning the terminal’s default color), ‘black’, ‘red’, ‘green’, ‘yellow’, ‘blue’, ‘magenta’, ‘cyan’, and‘white’.

set style filename intensity value

Set the intensity to value. Valid intensities are ‘normal’ (the default), ‘bold’, and ‘dim’.

The show style command and its subcommands are styling a style name in their output using its own style. So, use show style to see the complete list of styles, their characteristics and the visual aspect of each style.

The style-able objects are:

filename

Control the styling of file names. By default, this style’s foreground color is green.

function

Control the styling of function names. These are managed with the set style function family of commands. By default, this style’s foreground color is yellow.

variable

Control the styling of variable names. These are managed with the set style variable family of commands. By default, this style’s foreground color is cyan.

address

Control the styling of addresses. These are managed with the set style address family of commands. By default, this style’s foreground color is blue.

version

Control the styling of GDB’s version number text. By default, this style’s foreground color is magenta and it has bold intensity. The version number is displayed in two places, the output of show version, and when GDB starts up.

In order to control how GDB styles the version number at startup, add the set style version family of commands to the early initialization command file (see Initialization Files).

title

Control the styling of titles. These are managed with the set style title family of commands. By default, this style’s intensity is bold. Commands are using the title style to improve the readability of large output. For example, the commands apropos and help are using the title style for the command names.

highlight

Control the styling of highlightings. These are managed with the set style highlight family of commands. By default, this style’s foreground color is red. Commands are using the highlight style to draw the user attention to some specific parts of their output. For example, the command apropos -v REGEXP uses the highlight style to mark the documentation parts matching regexp.

tui-border

Control the styling of the TUI border. Note that, unlike other styling options, only the color of the border can be controlled via set style. This was done for compatibility reasons, as TUI controls to set the border’s intensity predated the addition of general styling to GDB. See TUI Configuration.

tui-active-border

Control the styling of the active TUI border; that is, the TUI window that has the focus.