Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / sam / docs / ui-cmds / cmd_load.html
CommitLineData
920dae64
AT
1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2<html>
3<head>
4<title>SPARC Architectural Model: User Commands</title>
5</head>
6<body bgcolor="#FFFFFF" LANG="en-US">
7<div STYLE="margin-bottom: 0cm"></div>&nbsp;
8
9<h2>
10load
11</h2>
12
13<h4>
14NAME
15</h4>
16<ul>
17load - load a file and write it to memory
18</ul>
19
20<h4>SYNOPSIS</h4>
21<tt>
22<ul>
23load <i>elf-file</i>
24<p>
25load bin <i>binary-file</i> <i>physical-address</i>
26<p>
27load image <i>image-file</i>
28</ul>
29</tt>
30
31<h4>DESCRIPTION</h4>
32<ul>
33Load a file containing a memory image in various formats and store it
34to memory.
35<p>
36In the form "load <i>elf-file</i>", the simulator will load the
37contents of the ELF file, <i>elf-file</i>, into physical memory using
38the information in the ELF files's section header table. This
39information can specify several different locations in physical
40memory. Note that only the .text, .rodata, .rodata1, .data, and
41.data1 sections are loaded. .bss is implicitly initialized to zero.
42<p>
43In the form "load bin <i>binary-file</i> <i>physical-address</i>", the
44simulator will load the entire raw contents of <i>binary-file</i> at the
45physical address <i>physical-address</i>.
46<p>
47In the form "load image <i>image-file</i>", the
48simulator will load the memory image of <i>image-file</i>.
49These files are in the form:
50<br>
51<div>
52@<i>address</i><br>
53<i>[8-byte-hex-value</i> | <i>4-byte-hex-value</i> ...]
54</div>
55<p>
56Each line that begins with '@' sets the starting address for
57subsequent value lines. Each value line writes its 4- or 8-value the
58current address and advances the current address by 4 or 8 bytes
59respectively. For both 4- and 8-byte value lines, the value is
60specified in hex without any leading 0x or 0X base selector and must
61consist of 8 or 16 hexadecimal characters, respectively.
62Multiple values may appear on a single line separated by spaces or tabs.
63</ul>
64
65<h4>RETURN VALUES</h4>
66<ul>
67None.
68</ul>
69
70<h4>SEE ALSO</h4>
71
72<hr>
73</body>
74</html>