-
Notifications
You must be signed in to change notification settings - Fork 1
/
loader.h
150 lines (128 loc) · 5.43 KB
/
loader.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
/* loader.h - program loader interfaces */
/* SimpleScalar(TM) Tool Suite
* Copyright (C) 1994-2003 by Todd M. Austin, Ph.D. and SimpleScalar, LLC.
* All Rights Reserved.
*
* THIS IS A LEGAL DOCUMENT, BY USING SIMPLESCALAR,
* YOU ARE AGREEING TO THESE TERMS AND CONDITIONS.
*
* No portion of this work may be used by any commercial entity, or for any
* commercial purpose, without the prior, written permission of SimpleScalar,
* LLC (info@simplescalar.com). Nonprofit and noncommercial use is permitted
* as described below.
*
* 1. SimpleScalar is provided AS IS, with no warranty of any kind, express
* or implied. The user of the program accepts full responsibility for the
* application of the program and the use of any results.
*
* 2. Nonprofit and noncommercial use is encouraged. SimpleScalar may be
* downloaded, compiled, executed, copied, and modified solely for nonprofit,
* educational, noncommercial research, and noncommercial scholarship
* purposes provided that this notice in its entirety accompanies all copies.
* Copies of the modified software can be delivered to persons who use it
* solely for nonprofit, educational, noncommercial research, and
* noncommercial scholarship purposes provided that this notice in its
* entirety accompanies all copies.
*
* 3. ALL COMMERCIAL USE, AND ALL USE BY FOR PROFIT ENTITIES, IS EXPRESSLY
* PROHIBITED WITHOUT A LICENSE FROM SIMPLESCALAR, LLC (info@simplescalar.com).
*
* 4. No nonprofit user may place any restrictions on the use of this software,
* including as modified by the user, by any other authorized user.
*
* 5. Noncommercial and nonprofit users may distribute copies of SimpleScalar
* in compiled or executable form as set forth in Section 2, provided that
* either: (A) it is accompanied by the corresponding machine-readable source
* code, or (B) it is accompanied by a written offer, with no time limit, to
* give anyone a machine-readable copy of the corresponding source code in
* return for reimbursement of the cost of distribution. This written offer
* must permit verbatim duplication by anyone, or (C) it is distributed by
* someone who received only the executable form, and is accompanied by a
* copy of the written offer of source code.
*
* 6. SimpleScalar was developed by Todd M. Austin, Ph.D. The tool suite is
* currently maintained by SimpleScalar LLC (info@simplescalar.com). US Mail:
* 2395 Timbercrest Court, Ann Arbor, MI 48105.
*
* Copyright (C) 1994-2003 by Todd M. Austin, Ph.D. and SimpleScalar, LLC.
*/
#ifndef LOADER_H
#define LOADER_H
#include <stdio.h>
#include "host.h"
#include "misc.h"
#include "machine.h"
#include "regs.h"
#include "memory.h"
/*
* This module implements program loading. The program text (code) and
* initialized data are first read from the program executable. Next, the
* program uninitialized data segment is initialized to all zero's. Finally,
* the program stack is initialized with command line arguments and
* environment variables. The format of the top of stack when the program
* starts execution is as follows:
*
* 0x7fffffff +----------+
* | unused |
* 0x7fffc000 +----------+
* | envp |
* | strings |
* +----------+
* | argv |
* | strings |
* +----------+
* | envp |
* | array |
* +----------+
* | argv |
* | array |
* +----------+
* | argc |
* regs_R[29] +----------+
* (stack ptr)
*
* NOTE: the start of envp is computed in crt0.o (C startup code) using the
* value of argc and the computed size of the argv array, the envp array size
* is not specified, but rather it is NULL terminated, so the startup code
* has to scan memory for the end of the string.
*/
/*
* program segment ranges, valid after calling ld_load_prog()
*/
/* program text (code) segment base */
extern md_addr_t ld_text_base;
/* program text (code) size in bytes */
extern unsigned int ld_text_size;
/* program initialized data segment base */
extern md_addr_t ld_data_base;
/* program initialized ".data" and uninitialized ".bss" size in bytes */
extern unsigned int ld_data_size;
/* top of the data segment */
extern md_addr_t ld_brk_point;
/* program stack segment base (highest address in stack) */
extern md_addr_t ld_stack_base;
/* program initial stack size */
extern unsigned int ld_stack_size;
/* lowest address accessed on the stack */
extern md_addr_t ld_stack_min;
/* program file name */
extern char *ld_prog_fname;
/* program entry point (initial PC) */
extern md_addr_t ld_prog_entry;
/* program environment base address address */
extern md_addr_t ld_environ_base;
/* target executable endian-ness, non-zero if big endian */
extern int ld_target_big_endian;
/* register simulator-specific statistics */
void
ld_reg_stats(struct stat_sdb_t *sdb); /* stats data base */
/* load program text and initialized data into simulated virtual memory
space and initialize program segment range variables */
void
ld_load_prog(char *fname, /* program to load */
int argc, char **argv, /* simulated program cmd line args */
char **envp, /* simulated program environment */
struct regs_t *regs, /* registers to initialize for load */
struct mem_t *mem, /* memory space to load prog into */
int zero_bss_segs); /* zero uninit data segment? */
#endif /* LOADER_H */