variables: "Set" variables
The following variables for the set subcommand
have special meanings:
- $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="destCodePage,srcCodePage"
- 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 current 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. dbx processes symbolics for DLLs as they are loaded.
- $dll_loadstop
- Set by default. 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.
- $fl_precison
- Determines the precision in bytes of floating-point registers when used in expressions, displays and 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 as hexadecimal values.
- $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 hexadecimal format instead of decimal 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 current thread during next, nexti, step or stepi command execution. If not set, all threads resume execution and might hit the breakpoint set by the next, nexti, step, or step 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
- 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
- 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.
- $sigblock
- Blocks all signals from reaching the program being debugged.
- $sticky_debug
- Recognizes 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.