set

The set command sets and displays environment variables.

Format

The format for this command is:

set [name [value]] where:

`name`	is the name of the environment variable to set.
`value`	is the string to which the environment variable is set.
nvram	causes the environment variables and stty settings to be copied into NVRAM.
`cmdlist`	is the list of PMON/2000 Monitor commands to be executed following reset.

Entering the set command with no arguments displays all the current environment variables.

Functional Description

The set command is used to set or display environment variable values, to copy the settings of environment variables and terminal options to NVRAM, and to specify a list of commands to be executed by the PMON/2000 Monitor following reset.

In some cases, when the Monitor displays a variable's current value, the Monitor prints a list of allowed values enclosed in square brackets; in other cases, no list is shown. In general, when the value is a numeric value, or when the value has an unlimited range of possible values, no list is shown.

The set command does not evaluate the specified value or check the specified value against a list of allowed values. Value checking is only performed when a command uses a variable.

To set a variable to a multiple-word value, enclose the value in single or double quotation marks.

When used with the nvram option, the set command copies the current settings of the environments variables and the terminal options as specified in the stty command into NVRAM. The optional command list permits the user to specify PMON/2000 Monitor commands that will be executed following reset. This option requires that the flash memories support sector erase.

To avoid reading the NVRAM during power-up, hold the console return key down while releasing reset. After repeating this process several times, you will see the following message:


Skip NVRAM read? (y/n)? >

If you type `y', the booting process will proceed without reading the NVRAM.

Examples illustrating the use of the set command follow.


	PMON> set                Display all current values.

	    brkcmd = "l @cpc 1"
	    datasz = -b          [-b -h -w]
	   inalpha = hex         [hex symbol]
	    inbase = 16          [auto 8 10 16]
	    moresz = 10        
	  regstyle = sw          [hw sw]
	    rptcmd = trace       [off on trace]
	   trabort = ^K        
	     uleof = %         
	      ulcr = off         [off on]
	   validpc = "_ftext etext"
	   heaptop = 80020000  
	    dlecho = off         [off on lfeed]
	   dlproto = EtxAck      [none XonXoff EtxAck]
	  hostport = tty1      
	    prompt = "PMON> "
	 etheraddr = aa:bb:cc:00:00:00
	    ipaddr = 71.0.0.211
       vxWorks = 
	      diag = 0           [N[:dev]]


	PMON> set moresz        Display current moresz.

	moresz = 10 



	PMON> set moresz 20     Set moresz to 20 decimal.

Display instruction at current pc and display all general-purpose registers:


	PMON> set brkcmd "l @cpc 1;r"

Environment Variables and Default Values

Environment Variable	Default Value	Options
bootp	no	[no\|sec\|pri\|save]
brkcmd	"l @cpc 1"	command list
busclock	target depenent	external/bus clock
cpuclock	target dependent	cpu pipeline clock
datasz	-b	[-b\|-h\|-w]
dlecho	off	[off\|on\|lfeed]
dlproto	EtxAck	[none\|XonXoff\|EtxAck]
ethaddr	target dependent	string
ipaddr	none	string
heaptop	target dependent	string
hostport	tty1	tty0-9
inalpha	hex	hex symbol
inbase	16	[auto\|8\|10\|16]
memsize	target dependent	memory size in MBytes
moresz	10	0-n
prompt	"PMON> "	string
regstyle	sw	[hw\|sw]
rptcmd	trace	[off\|on\|trace]
showsym	yes	[yes\|no]
trabort	^K	char
ulcr	off	[off\|on]
uleof	off	string
validpc	"_ftext etext"	string

Environment variables can be set and displayed using the set command.

Brief descriptions of each of the variables follow, together with references to their complete descriptions.

Variable   Description

brkcmd   This variable specifies a sequence of Monitor commands that are executed when a breakpoint halts program execution. See the b command.

busclock   Set to the value of the bus/timing clock frequency. Useful for programs that needs to know this for timing purposes. Not applicable to all targets.

cpuclock   Set to the pipleine clock frequency of the target processor.

datasz   This variable controls whether data is displayed in byte, half-word, or word groups. See the d command.

dlecho   This variable controls whether the target board echoes on downloads. An entire line can be echoed, a single line-feed character can be echoed, or there can be no echo at all. See the load command and the section on flow control.

dlproto   This variable selects the download protocol for transfers via RS-232C. The Monitor supports Xon/Xoff and EtxAck download protocols. See the load command and the section on flow control.

bootp   Enable bootp protocol for setting IP address and download/boot.

ethaddr   This variable specifies the hardware Ethernet address. See the section on downloading via Ethernet.

ipaddr   This variable specifies the Internet Protocol address. See the section on downloading via Ethernet.

heaptop   This variable specifies the highest allowable address in the heap maintained by the PROM Monitor. See the load command.

hostport   This variable selects whether tty0, tty1, or ethernet is the host port. See the load command and the section on flow control.

inalpha   This variable selects whether strings starting with the ASCII characters a, b, c, d, e, and f are interpreted as symbols or hexadecimal numbers. See the sh command.

inbase   This variable selects the default input base for numeric values. Users can input octal, decimal, or hexadecimal numbers by changing this variable. See the sh command.

memsize   The probed total RAM memory size in MBytes.

moresz   This variable specifies how many lines to display during screen-at-a-time display. See the more command.
prompt
This variable defines the Monitor prompt. An example of using this command is when you need to set the prompt to "PMON> " for compatibility with a source-level debugger. To do this use the following command:
PMON2000> set prompt "PMON> "
This will set the prompt to "PMON> " (note the space) and save this new value in the non-volatile memory (if supported).
regstyle   This variable defines whether hardware or software names are displayed in the l command. See the l command.

rptcmd   When this variable is set to "on," the previous command is executed again when the user enters an empty line. See the sh command.

showsym   Show or don't show symbols when doing trace and disassembly.

trabort   This variable selects the character that terminates transparent mode and returns the Monitor to command mode. See the tr command.

ulcr   This variable defines whether there is a carriage return or both a carriage return and a linefeed character at the end of the line during dumps. See the dump command.

uleof   This variable specifies a string that is sent to the host after a dump to the target has completed. See the dump command.

validpc   This variable specifies the range of valid PC values during program tracing. See the trace command.

vxWorks   This string variable is passed to a VxWorks kernel at boot time. It contains host and target IP address, user name and other required parameters. See Wind River documentation for details.

Variable	Description
brkcmd	This variable specifies a sequence of Monitor commands that are executed when a breakpoint halts program execution. See the b command.
busclock	Set to the value of the bus/timing clock frequency. Useful for programs that needs to know this for timing purposes. Not applicable to all targets.
cpuclock	Set to the pipleine clock frequency of the target processor.
datasz	This variable controls whether data is displayed in byte, half-word, or word groups. See the d command.
dlecho	This variable controls whether the target board echoes on downloads. An entire line can be echoed, a single line-feed character can be echoed, or there can be no echo at all. See the load command and the section on flow control.
dlproto	This variable selects the download protocol for transfers via RS-232C. The Monitor supports Xon/Xoff and EtxAck download protocols. See the load command and the section on flow control.
bootp	Enable bootp protocol for setting IP address and download/boot.
ethaddr	This variable specifies the hardware Ethernet address. See the section on downloading via Ethernet.
ipaddr	This variable specifies the Internet Protocol address. See the section on downloading via Ethernet.
heaptop	This variable specifies the highest allowable address in the heap maintained by the PROM Monitor. See the load command.
hostport	This variable selects whether tty0, tty1, or ethernet is the host port. See the load command and the section on flow control.
inalpha	This variable selects whether strings starting with the ASCII characters a, b, c, d, e, and f are interpreted as symbols or hexadecimal numbers. See the sh command.
inbase	This variable selects the default input base for numeric values. Users can input octal, decimal, or hexadecimal numbers by changing this variable. See the sh command.
memsize	The probed total RAM memory size in MBytes.
moresz	This variable specifies how many lines to display during screen-at-a-time display. See the more command.
prompt	This variable defines the Monitor prompt. An example of using this command is when you need to set the prompt to "PMON> " for compatibility with a source-level debugger. To do this use the following command: PMON2000> set prompt "PMON> " This will set the prompt to "PMON> " (note the space) and save this new value in the non-volatile memory (if supported).
regstyle	This variable defines whether hardware or software names are displayed in the l command. See the l command.
rptcmd	When this variable is set to "on," the previous command is executed again when the user enters an empty line. See the sh command.
showsym	Show or don't show symbols when doing trace and disassembly.
trabort	This variable selects the character that terminates transparent mode and returns the Monitor to command mode. See the tr command.
ulcr	This variable defines whether there is a carriage return or both a carriage return and a linefeed character at the end of the line during dumps. See the dump command.
uleof	This variable specifies a string that is sent to the host after a dump to the target has completed. See the dump command.
validpc	This variable specifies the range of valid PC values during program tracing. See the trace command.
vxWorks	This string variable is passed to a VxWorks kernel at boot time. It contains host and target IP address, user name and other required parameters. See Wind River documentation for details.

set

Format

Functional Description

See Also: