Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / sam / docs / ui-cmds / cmd_load.html
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<title>SPARC Architectural Model: User Commands</title>
</head>
<body bgcolor="#FFFFFF" LANG="en-US">
<div STYLE="margin-bottom: 0cm"></div>&nbsp;
<h2>
load
</h2>
<h4>
NAME
</h4>
<ul>
load - load a file and write it to memory
</ul>
<h4>SYNOPSIS</h4>
<tt>
<ul>
load <i>elf-file</i>
<p>
load bin <i>binary-file</i> <i>physical-address</i>
<p>
load image <i>image-file</i>
</ul>
</tt>
<h4>DESCRIPTION</h4>
<ul>
Load a file containing a memory image in various formats and store it
to memory.
<p>
In the form "load <i>elf-file</i>", the simulator will load the
contents of the ELF file, <i>elf-file</i>, into physical memory using
the information in the ELF files's section header table. This
information can specify several different locations in physical
memory. Note that only the .text, .rodata, .rodata1, .data, and
.data1 sections are loaded. .bss is implicitly initialized to zero.
<p>
In the form "load bin <i>binary-file</i> <i>physical-address</i>", the
simulator will load the entire raw contents of <i>binary-file</i> at the
physical address <i>physical-address</i>.
<p>
In the form "load image <i>image-file</i>", the
simulator will load the memory image of <i>image-file</i>.
These files are in the form:
<br>
<div>
@<i>address</i><br>
<i>[8-byte-hex-value</i> | <i>4-byte-hex-value</i> ...]
</div>
<p>
Each line that begins with '@' sets the starting address for
subsequent value lines. Each value line writes its 4- or 8-value the
current address and advances the current address by 4 or 8 bytes
respectively. For both 4- and 8-byte value lines, the value is
specified in hex without any leading 0x or 0X base selector and must
consist of 8 or 16 hexadecimal characters, respectively.
Multiple values may appear on a single line separated by spaces or tabs.
</ul>
<h4>RETURN VALUES</h4>
<ul>
None.
</ul>
<h4>SEE ALSO</h4>
<hr>
</body>
</html>