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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
|
LINUX INSTALLATION INSTRUCTIONS
tkisem-4.5.12.tgz contains the source distribution of version 4.5.12 of
tkisem, an instructional SPARC emulator with a Tcl/Tk GUI.
This file describes how to build and install the tkisem-4.5.12 package
on relatively recent vintage Linux systems. As of Sat Jan 20 11:55:55
2001, there has been no attempt to install tkisem-4.5.12 anywhere else.
It is likely to install successfully on many Linux systems, depending
mostly on what version of Tcl/Tk is installed. It is less likely to
install cleanly on any other Unix system (including solaris) unless
the GNU versions of make, cc, c++, and ld are all used.
INSTALLATION UNDER ANY OTHER OPERATING SYSTEM IS UNLIKELY TO SUCCEED,
UNTESTED, UNRECOMMENDED, AND UTTERLY UNSUPPORTED.
If you run into problems please send mail to isem@cs.unm.edu
You need to do both 'PART I', and 'PART II', below.
===============================================================================
PART I --- Building isem_as and isem_ld for Linux
===============================================================================
We need to be able to assemble and link SPARC code to feed to isem.
To avoid any chance of name conflicts with the Linux native tools, we
require the SPARC cross assembler be named 'isem_as', and the linker
be named 'isem_ld'.
To build them, follow these steps:
(0) You'll need something like a peak of about 64Mb of free space,
more or less, to build the binutils package. When you get done
you'll need probably less than 4Mb to hold isem_as and isem_ld.
(1) Obtain a recent version of the 'GNU binutils' package.
You might be able to find a suitable version whereever you
found the tkisem-4.5.12.tgz. If not, follow these steps:
(1.1) FTP to prep.ai.mit.edu and log in as anonymous
(1.2) cd to pub/gnu
(1.3) Get the latest version of binutils
(2) Unzip and untar the binutils source code, e.g.,
% tar xvzf binutils-2.10.1.tgz
if that's the file you got.
(3) cd to the binutils directory, e.g.,
% cd binutils-2.10.1/
if that's the version you got.
(4) Configure binutils to generate SPARC code as follows:
% ./configure --target=sun4
This is basically the KEY STEP to the WHOLE PROCESS!
(5) Make the entire tree -- this takes quite a while. There should
be no errors:
% make
(Note that depending on what version of binutils you got, you
might be able to do just:
% make all-ld
% make all-gas
instead of making the whole tree. If this works you can save a
little time and reduce your peak disk usage by about 10Mb.
Building the whole tree, however, is likely to be less
version-dependent.)
(6) cd to the ld/ directory. There you will find a file name
'ld-new' (unless you have a particularly old version of the
binutils, in which case it might be called 'ld.new').
'ld-new' should be installed as 'isem_ld' (note NOT 'isem-ld' as
used in prior versions!) You can put it anywhere convenient, so
long as it is in the PATH in Part II when you go to build tkisem.
E.g.:
% cd ld/
% su -c "cp ld-new /usr/local/bin/isem_ld"
(7) If you want a manual for ld:
% cd doc
% make ld.ps
(Deal with ld.ps however you print)
% cd ..
You PROBABLY DON'T want a manual for ld, unless
perhaps you're going to hack on linker scripts like
'generic/isem_ld.txt' in the tkisem 4.5.12 distribution
(8) cd to the gas/ directory, and install 'as-new' as 'isem_as' (note
NOT 'isem-as' as used in prior versions!) following the pattern
of step (6), e.g.,:
% cd ../gas/
% su -c "cp as-new /usr/local/bin/isem_as"
(9) If you want a manual for gas:
% cd doc
% make as.ps
(Deal with as.ps however you print)
% cd ..
You POSSIBLY MIGHT want a manual for gas.
(10) Clean up. If everything worked, you can now delete the entire
binutils tree you unpacked, and recover some 64Mb or so of disk
space.
(If you get stuck, or this advice is wrong, please send mail
to isem@cs.unm.edu.)
===============================================================================
PART II --- Building tkisem for Linux
===============================================================================
After you have completed Part I, you're ready to try building tkisem.
Follow these steps:
(-1) Check that isem_as and isem_ld are in your PATH:
% which isem_as
% which isem_ld
If either of these commands fail to find the corresponding
program, something went wrong with Part I. (Or perhaps you're
using a 'csh' type shell, and you need to give the 'rehash'
command after doing Part I.)
(0) Unzip and untar tkisem-4.5.12.tgz. (You probably already did this)
% tar xvzf tkisem-4.5.12.tgz
(1) cd into the tkisem directory:
% cd tkisem-4.5.12/
(2) Configure tkisem. The only decision you may need to make at this
point is where you want to install the executables. By default
the configuration will set up to put them in the same place it
finds 'isem_ld'. If, for example, isem_ld is located at
/usr/local/bin/isem_ld, then by default the configure script with
setup to install into /usr/local/bin and /usr/local/lib.
To install in the default location as just described, do:
% ./configure
Instead of that, if you want to put the tkisem executables
someplace other than where isem_ld is located, use the '--prefix'
configure argument to specify the directory ABOVE the bin/
directory where you want the files to go. For example, if you
do:
% ./configure --prefix=/usr
then files will be installed in /usr/bin AND /usr/lib. Likewise,
if you
% ./configure --prefix=/home/username/tkisem
then files will be installed in /home/username/tkisem/bin and
/home/username/tkisem/lib
(3) Build tkisem:
% make
With luck everything will work...
(4) Install tkisem:
% su -c "make install"
(5) Try it. Ensure you're running in X windows, then:
% tkisem
should bring up the graphical interface to instructional SPARC
emulator.
It probably won't work that smoothly. If you can't figure out what's
going wrong, send email to isem@cs.unm.edu.
Problems configuring the software
=================================
If you have a problem, don't worry, you can always rerun configure.
Do 'make realclean' before re-./configuring, to ensure you've gotten
rid of all traces of the previous configuration.
<<THIS SECTION IS TO-BE-WRITTEN WHEN WE START FINDING OUT ALL THE PROBLEMS!>>
|
