set¶
Evaluate expression and assign result.
set [SUBCOMMAND|VARIABLE] VAR = EXP
- SUBCOMMAND – One of the supported subcommand for the “set” command.
- VARIABLE – variable subcommand to set a variable which may have the same name as one of the subcommands.
- VAR – Name of the variable to set.
- EXP – Expression to evaluate and set VAR’s value to.
Evaluate expression EXP and assign result to variable VAR, using assignment syntax appropriate for the current language (VAR = EXP or VAR := EXP for example). VAR may be a debugger “convenience” variable (names starting with $), a register (a few standard names starting with $), or an actual variable in the program being debugged. EXP is any valid expression. Use “set variable” for variables with names identical to set subcommands.
With a subcommand, this command modifies parts of the wrdbg environment. You can see these environment settings with the “show” command.
List of set subcommands:
- set history – Generic command for setting command history parameters
- set history expansion – Set history expansion on command input
- set history filename – Set the filename in which to record the command history
- set history save – Set saving of the history record on exit
- set history size – Set the size of the command history
- set module – Generic command for setting module parameters
- set module load – Set module load options
- set module unload – Set module unload options
- set rtp – Generic command for setting VxWorks RTP parameters
- set rtp create – Set VxWorks RTP create options
- set step-mode – Set mode of the step operation
- set task – Generic command for setting VxWorks tasks parameters
- set task create – Set VxWorks kernel task create options
- set thread – Generic command for setting thread parameters
- set thread create – Set thread arguments
- set ui – Generic command for setting how WorkBench UI interacts
- set ui link – Command for setting WorkBench UI link mode
- set variable – Set program variable to the given value
Type “help set” followed by set subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.
set history – Generic command for setting command history parameters¶
Generic command for setting command history parameters.
set history [SUBCOMMAND] [ARGS]
- SUBCOMMAND – History subcommand to give ARGS to.
- ARGS - Arguments to pass to history SUBCOMMAND.
List of set history subcommands:
- set history expansion – Set history expansion on command input
- set history filename – Set the filename in which to record the command history
- set history save – Set saving of the history record on exit
- set history size – Set the size of the command history
Type “help set history” followed by history subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.
set history expansion – Set history expansion on command input¶
Set history expansion on command input.
set history expansion MODE
- MODE – The history expansion mode. Allowed values for MODE are “on” or “off”. If MODE is omitted, history expansion is turned on.
Examples:
- set history expansion on
- set history expansion
- set history expansion off
set history filename – Set the filename in which to record the command history¶
Set the filename in which to record the command history.
set history filename PATH
- PATH – A host path where the list of previous commands of which a record
is kept. Default is
~/wrdbg/history
Examples:
- set history filename /home/me/history
- set history filename C:homemehistory
set history save – Set saving of the history record on exit¶
Set saving of the history record on exit.
set history save MODE
- MODE – History save mode. Allowed values are “on” or “off”. Use “on” to enable the saving, and “off” to disable it. If MODE is omitted, history save is turned on.
Examples:
- set history save on
- set history save
- set history save off
set history size – Set the size of the command history¶
Set the size of the command history.
set history size SIZE
- SIZE – The number of previous commands to keep a record of. The given value should either be a positive value or 0.
Examples:
- set history size 256
- set history size 0
set module – Generic command for setting module parameters¶
Generic command for setting module parameters.
set module SUBCOMMAND ARGS
- SUBCOMMAND – The name of one of the supported “set module” subcommands. Supported subcommands so far are : load, unload.
- ARGS – Arguments to pass to the SUBCOMMAND.
List of set module subcommands:
Type “help set module” followed by module subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.
set module load – Set module load options¶
Set module load options.
set module load OPTION [VALUE]
- OPTION is module load option name.
- VALUE is module load option value.
set module unload – Set module unload options¶
Set module unload options.
set module unload OPTION [VALUE]
- OPTION is module unload option name.
- VALUE is module unload option value.
set rtp – Generic command for setting VxWorks RTP parameters¶
Generic command for setting VxWorks RTP parameters.
set rtp SUBCOMMAND ARGS
- SUBCOMMAND – The name of one of the supported “set rtp” subcommands. The only supported subcommands so far is : create.
- ARGS – Arguments to pass to the SUBCOMMAND.
List of set rtp subcommands:
Type “help set rtp” followed by rtp subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.
set rtp create – Set VxWorks RTP create options¶
Set VxWorks RTP create options.
set rtp create OPTION [VALUE]
- OPTION is RTP’s option name. Possible values for OPTION are:
- Priority – RTP’s initial task priority. VALUE should be an integer.
VALUE is RTP’s option value.
set step-mode – Set mode of the step operation¶
Set mode of the step operation.
set step-mode {on|off}
When set, doing a step over a function without debug line information will stop at the first instruction of that function. Otherwise, the function is skipped and the step command stops at a different source line.
set task – Generic command for setting VxWorks tasks parameters¶
Generic command for setting VxWorks tasks parameters.
set task SUBCOMMAND ARGS
- SUBCOMMAND – The name of one of the supported “set task” subcommands. The only supported subcommand so far is : create.
- ARGS – Arguments to pass to the SUBCOMMAND.
List of set task subcommands:
Type “help set task” followed by task subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.
set task create – Set VxWorks kernel task create options¶
Set VxWorks kernel task create options.
set task create OPTION [VALUE]
- OPTION is task create option name.
- VALUE is task create option value.
Available options are:
- name – task name. VALUE may be specified like : myTaskName.
- Priority – task priority. VALUE may be specified like : <int>.
set thread – Generic command for setting thread parameters¶
Generic command for setting thread parameters.
set thread SUBCOMMAND ARGS
- SUBCOMMAND – The name of one of the supported “set thread” subcommands. The only supported subcommand so far is : create.
- ARGS – Arguments to pass to the SUBCOMMAND.
List of set thread subcommands:
Type “help set thread” followed by thread subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.
set thread create – Set thread arguments¶
Set thread create options.
set thread create OPTION [VALUE]
- OPTION is thread create option name.
- VALUE is thread create option value.
Available options are:
- args – thread arguments. VALUE may be specified like :
- Example 1, one argument :
set thread create args arg
- Example 2, two arguments :
set thread create args "arg1 arg2"
. Use double-quotes to set multiple arguments with space between.- Example 3, a string argument :
set thread create args "\"my str\""
. Use backslash to escape a character.
name – thread name. VALUE may be specified like : myThreadName.
Priority – thread priority. VALUE may be specified like : <int>.
set ui – Generic command for setting how WorkBench UI interacts¶
Generic command for setting how WorkBench UI interacts.
set ui SUBCOMMAND ARGS
- SUBCOMMAND – The name of one of the supported “set ui” subcommands. The only supported subcommand so far is : link.
- ARGS – Arguments to pass to the SUBCOMMAND.
List of set ui subcommands:
Type “help set ui” followed by ui subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.
set ui link – Command for setting WorkBench UI link mode¶
Command for setting WorkBench UI link mode.
set ui link MODE
- MODE – The UI link mode to set. Allowed values are “on” or “off”.
When linked to the UI, some actions are not permitted as the UI is not able to mimic the shell behaviour.
For example, selecting a frame is not permitted as the UI does not get any event of newly selected frame.
set variable – Set program variable to the given value¶
Set program variable to the given value.
set variable VAR EXP
- VAR – Name of the variable to assign to result of EXP.
- EXP – Expression to evaluate and store result in a variable.
Evaluate expression EXP and assign result to variable VAR, using assignment syntax appropriate for the current language (VAR = EXP or VAR := EXP for example). VAR may be a debugger “convenience” variable (names starting with $), a register (a few standard names starting with $), or an actual variable in the program being debugged. EXP is any valid expression.
This may usually be abbreviated to simply “set”.