Format
set [variable=expression]
Description
The set subcommand
defines a value, which is specified by the expression argument,
for the dbx debug program variable, which
is specified by the variable argument. The
name of the variable must not conflict with names in the program being
debugged. A variable is expanded to the corresponding expression within
other commands. If the set subcommand is
used without arguments, the variables currently set are displayed.
Variables
The following variables are set
with the
set subcommand:
- $asciichars
- Any dbx operation that displays the
value of a character will interpret the binary representation of the
character as ASCII.
- $asciistrings
- Any dbx operation that displays the
value of a string will interpret the binary representation of the
string as ASCII.
- $c<n>
- Condition variables
- $catchbp
- Catches breakpoints during the execution of the next command.
- $charset
- Converts character strings before displaying them. The character
strings are converted from the code page srcCodePage to destCodePage.
The destCodePage must be IBM-1047. The default setting is not to
convert the character strings.
- $commandedit
- Enables the command line facility.
- $current
- Defined as a constant with the value of the focus thread.
- $cv_events
- Notifies the user but does not stop when a condition variable
event is processed. The following trace information is sent to the
user for the different events:
(dbx) cont
.
.
cv initialize, object=0x2e04567
cv wait, object=0x2e04567, mutex=0x2d04567, thid=0x0102030405060708
cv unwait, object=0x2e04567, mutex=0x2d04567, thid=0x0102030405060708
cv destroy, object=0x2e04567
.
.
- $dll_loads
- Set by default. When set, dbx processes
symbolics for DLLs as they are loaded.
- $dll_loadstop
- Set by default. When set, dbx stops
the function call that caused the DLL to be loaded. If the DLL was
loaded due to a variable reference or an explicit load, dbx stops
at the source line that caused the DLL to be loaded.
- $expandunions
- Displays values of each part of variant records or unions.
- $expressionexhaustivesearch
- Searches all scopes in a user's program to determine and verify
the scope for an expression. Selecting this option might degrade performance.
- $flprecision
- Determines the precision in bytes of floating-point registers
when the values of the register are displayed; for example, in expressions
or during assignment. Valid values are 4, 8 or 16.
- $fr<n>
- Hexadecimal floating-point register.
- $frb<n>
- Binary floating-point register
- $frd<n>
- Decimal floating-point register
- $hexchars
- Prints characters in hexadecimal format.
- $hexin
- Input is interpreted in hexadecimal format.
Restriction: The $hexin variable
is only supported in dbx command-line mode
and does not affect the interpretation of GUI input. If the user
of the GUI debugger wants input to be interpreted in hexadecimal format,
the input must be prefixed with "0x".
- $hexints
- Prints integers in decimal format instead of hexadecimal format.
- $historypage
- Specifies the number of history items to be traversed when using
the page up and page down keys.
- $history_unique
- Prevents consecutive duplicate commands from being saved to the
history list.
- $historywindow
- Specifies the number of commands to display and retain in the
history list.
- $hold_next
- Automatically holds all threads except the focus thread during
the next, nexti, step,
or stepi command execution. If not set,
all threads resume execution and may reach the breakpoint set by the next, nexti, step,
or stepi command execution.
- $l<n>
- Read/write locks variables.
- $listwindow
- Specifies the number of lines to list around a function and to
list when the list subcommand is used without
parameters.
- $lv_events
- When set, dbx notifies the user but
does not stop when a read/write lock object event is processed. The
following trace information is sent to the user for the different
events:
(dbx) cont
.
.
lv initialize, object=0x2d04567
lv wait, object=0x2d04567, thid=0x0102030405060708
lv unwait, object=0x2d04567, thid=0x0102030405060708
lv lock, object=0x2d04567, thid=0x0102030405060708
lv unlock, object=0x2d04567, thid=0x0102030405060708
lv relock, object=0x2d04567, thid=0x0102030405060708
lv unrelock, object=0x2d04567, thid=0x0102030405060708
lv destroy, object=0x2d04567
.
.
- $m<n>
- Specifies mutex variables.
- $maxstring
- Specifies the maximum number of characters to be displayed when
printing a string. String printing stops when $maxstring characters
are printed. Set to zero to completely display strings. The default
value is zero.
- $mv_events
- When set, dbx notifies the user but
does not stop when a mutex object event is processed. The following
trace information is sent to the user for the different events:
(dbx) cont
.
.
mv initialize, object=0x2d04567
mv wait, object=0x2d04567, thid=0x0102030405060708
mv unwait, object=0x2d04567, thid=0x0102030405060708
mv lock, object=0x2d04567, thid=0x0102030405060708
mv unlock, object=0x2d04567, thid=0x0102030405060708
mv relock, object=0x2d04567, thid=0x0102030405060708
mv unrelock, object=0x2d04567, thid=0x0102030405060708
mv destroy, object=0x2d04567
.
.
- $noargs
- Omits arguments from subcommands, such as where, up, down,
and dump.
- $noflbregs
- Does not display the binary floating point representation of the
floating point registers with the registers subcommand.
- $nofldregs
- Does not display the decimal floating point representation of
the floating point registers with the registers subcommand.
- $noflregs
- Does not display the hexadecimal floating point representation
of the floating point registers with the registers subcommand.
- $novregs
- When set, omits the display of vector registers from the registers
subcommand.
- $octin
- Interprets input in octal format. The $octin variable
is only supported in dbx command-line mode
and does not affect the interpretation of GUI input. If the user
of the GUI debugger wants input to be interpreted in octal format,
the input must be prefixed with "0".
- $octints
- Prints integers in octal format.
- $pc
- Program counter register.
- $psw
- First word of the program status word register.
- $psw0
- First word of the program status word register.
- $psw1
- Second word of the program status word register.
- $r<n>
- General register.
- $r_precision
- Sets the amount of precision, in bytes, to use when displaying
an integer value. Possible values are 4 and 8.
- $repeat
- Repeats the previous command if no command was entered.
- $showbases
- Displays the base class data when a derived class is printed.
- $showcodelines
- Indicates the lines where the debugger can stop and where breakpoints
can be set.
- $sigblock
- Blocks all signals from reaching the program being debugged.
- $sticky_debug
- When set, dbx will recognize sticky
bit programs and DLLs in the loadmap.
- $t<n>
- Thread variables
- $tv_events
- Notifies the user but does not stop when a thread object event
is processed. Trace information similar to the following example is
sent to the user for the different events:
(dbx) cont
.
.
IPT create, thid=0x1234567890123456, stack=5200
IPT exit, thid=0x1234567890123456
tv create, thid=0x1234567890123456, created thid=0x1234567890123422,
stack=5200
tv created, thid=0x1234567890123456, stack=5200
tv exit, thid=0x1234567890123456
tv wait, thid=0x1234567890123456, joining thid=0x1234567890123422
tv unwait, thid=0x1234567890123456, joined thid=0x1234567890123422
- $unsafeassign
- Turns off strict type checking between the two sides of an assign subcommand.
- $unsafebounds
- Turns off subscript checking on arrays.
- $unsafegoto
- Turns off the goto subcommand destination
checking.
Usage notes
- The $unsafe variables limit the usefulness
of the dbx debug program in detecting errors.
- The set subcommand can be run only while
the dbx debug program is running.
Examples
- To change the default number of lines to be listed to 20, enter:
set $listwindow=20
- To disable type checking on the assign subcommand,
enter:
set $unsafeassign
Related information
The unset subcommand.