The directions below assume that you are logged into your
olympus account. If you have any questions, send email to your instructor.
1.- Remain in your directory. There is NO need to do cd into any other
directory.
2.- There is a Makefile in the ~emontagn/project directory. Make a link to that
file in your directory. Do not copy it to your directory. You can link to it
with the following command:
ln –s ~emontagn/project/Makefile Makefile
3.- Execute make copyfiles. This will copy necessary files from my directory
into your current directory. After this, you should have the following files:
obj1.c obj2.c obj3.c obj4.c obj5.c obj6.c simulator.c externs.h osdefs.h
intro.doc
Print all the files and copy them onto a disk. This is so that you can run the
simulator locally if you choose to do so.
After printing, delete externs.h (rm externs.h), osdefs.h and simulator.c from your directory.
rm externs.h
4.- To compile, execute make obj1.o
(Change this to obj2.o, obj3.o, etc. for the other objectives)
5.- To copy data files, execute make data1files
Copy other data files by replacing 1 with the current objective number. Copy
these data files onto your disk so that you can run the simulator locally.
6.- To link, execute make sim
7.- To run your program, execute sim
8.- Debug and correct errors.
9.- To run ossim and get a correct output file to compare, execute make
correct-output
This creates a file ossim.out in your current directory, which contains the
“correct” output for the current objective.
10.- To compare your results, execute make compare OBJ=1(=2, =3, etc. for the
others)
11.- To submit, execute make submit
SPECIAL NOTES:
(a) Do NOT edit any datafiles. Not even config.dat.(despite what the
instructions say)
(b) Do NOT retain any header files(*.h) in your directory after printing them.
You will run into problems later if you do not delete them.
(c) You will only submit the files obj1.c, obj2.c, etc. DO NOT modify the header
files, simulator.c or the Makefile. We will not accept those files
and will not
use them when we compile and test you objectives. If your code depends on them,
it will not run for us, and you know what that means.
Penalties for late submission are:
- Up to 1 week late - 10% off.
- From 1 week to 2 weeks late - 20%
- Objective are not accepted more than 1 week late (i.e. 0% for that objective)
NOTES:
1.- The first three objectives must be completed satisfactorily to pass the
course.
2.- Objective 4 need not be handed in separately, it will be included with
Objective 5.
3.- Objective 5 is the official end of the project for those who are not
eligible for, or who elect not to do the extra credit.
4.- Objective 6 is considered to be extra credit. You are eligible for that
extra credit ONLY IF you have successfully completed Objective #5. The extra
credit could be used to offset earlier penalties, or to offset poor exam
performance, or just so you can say that you finished the whole thing.
|