-
Notifications
You must be signed in to change notification settings - Fork 9
/
README
executable file
·103 lines (78 loc) · 3.09 KB
/
README
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
HOW TO setup sesc
-----------------
building sesc
-------------
1) create a build directory
Now you can create a directory for the build process:
> cd ../
> mkdir build
We recommend that you have one build directory per simulator
set of options. You may create as many directories as you want and
compile the simulator with different combinations of options (see
step 7).
2) go to the build directory
> cd build
3) configure esesc from build
Run esesc/configure from the build directory (if you don't specify
any options, the default configuration will be built; to see all
options, type configure --help).
> ../esesc/configure
4) to build all sesc directories:
> make
5) to build the simulator executable:
> make sesc
# Examples of configure parameters:
#
# Activate all the checks, but do not have verbose dump
# ./configure --enable-debug-silent
#
# Activate version memory (taskscalar included in vmem) with silent debug mode
# ./configure --enable-debug-silent --enable-vmem
#
Check docs/README.compile for more detailed examples
modifying and testing the simulator
-----------------------------------
testing
-------
If you modify the simulator in esesc, PLEASE test it before you
commit the code. To test it in the default configuration, you can
simply type make testsim (in the build directory). Please also try
testsim-tls.
commiting
---------
Don't forget to do a cvs add for new files and cvs commit in the
esesc directory to commit your changes (but before you do that,
please make sure the simulator is still working ;o)
ChangeLog
---------
To see the activity, regenerate the ChangeLog by typing gmake ChangeLog
esesc directory structure
-------------------------
configure - script to create the Makefiles for build
configure.ac - input file for autoconf, to create configure
confs - directory that contains several configuration files for
the simulator runs
COPYING - copyright notice
MAINTAINERS - who is responsible for what description
scripts - report and run scripts for sesc
src - all real code for sesc is in this
directory (description below)
TODO - if you have some time available and you want to have
some fun, check this file and help improve sesc
src directory structure
-----------------------
libapp - patched calls from sesc (these are stubs for system
calls emulated by the simulator - the real
implementation is in mint/subst.c)
libcore - main processor structures
libmem - cache/memory backend
libnet - multiprocessor networking
libpower - power estimation (includes cacti, orion and wattch)
libsuc - general purpose code (specially useful code)
libvmem - versioning cache backend
libmint - functional simulator
libcc - Cache Coherence (directory based)
libsmp - Cache Coherence (bus snooping)
librst - RST SUN traces interface (check docs/README.rst)
misc - miscellaneous files
The other files are mainly associated to the build process.