load

Load a user program into target memory.

Syntax

[[px]] load filename [init] [nocode] [nosym] [AT address | OFFSET expr]

Where:

[px]	specifies an optional viewpoint override. If the viewpoint override is omitted, the current viewpoint is used.
filename	specifies a filename.  See Filenames for details.
init	specifies that registers are to be initialized from values in the loaded file.
nocode	specifies that object code is not loaded into memory during a load operation.
address	specifies the load address for a non-relocatable file.
expr	specifies a relocation offset for a relocatable file.
nosym	specifies that symbols are not loaded into SourcePoint.

Discussion

The following table shows the supported file types.  Use the load command to read an executable file into target memory and/or to load a file's symbols onto the host for symbolic display.

Memory writes are verified depending on the state of the verify control variable.

	elf	aout	bin	exe	hex	omf86	omf386	PE	textsym
load symbols	x	x					x	x	x
load target	x		x	x	x	x	x	x
relocate address			x					x
relocate offset	x			x	x				x
initialize	*						x

*Limited processor initialization

Note: If both nosymbols and nocode options are specified, the file gets loaded as if nocode were specified (symbols only).

Example 1

To load text.elf and initialize processor registers:

Command input:

load c:\test\test.elf init

Example 2

To load text.elf onto processor 1:

Command input:

[p1] load c:\test\test.elf  

Related Topics:

reload

unload

verify