In this lab, we give you 5 object files, ex1_sol.o, ex2_sol.o, ..., ex5-sol.o, and withhold their corresponding C sources. Each object file implements a particular function (e.g. ex1_sol.o defines function ex1). We ask you to understand the x86-64 assembly code for each of these functions and figure out what that function tries to do. Your task is to write the corresponding C function that accomplishes the same thing for each of the five functions.

Obtaining the lab

Do a git pull in your cso-labs/ directory. This lab's files are located in the cso-labs/binarylab/ subdirectory. You need to commit the changes you've made in the previous labs in order to be able to successfully do a git pull. Thus, your workflow should be as follows:
$ cd cso-labs/
$ git commit -am "commits for previous lab"
$ git pull
Since occasionally we need to modify lab files, please remember to ensure that your lab files are up to date with the class repository. We will explicitly inform you to do "git pull" via Piazza when we update the repository. As a precaution, you should also "git pull" periodically.

Uncover the mystery of assembly

The object files whose assembly code you seek to understand are in the binarylab/objs/ subdirectory. Suppose you set out to figure out what function ex1 (implemented in objs/ex1_sol.o) does. There are two approaches to do this. You should use them both to help uncover the mystery.

Approach 1

Disassemble the object files. Read the assembly and try to understand what the function tries to achieve. To disassemble objs/ex1_sol.o, type:
$ objdump -d objs/ex1_sol.o

Approach 2

Run ex1 in gdb.

There is a caveat: we do not tell you the signature of ex1. Therefore, it would be hard to write your own C code to correctly invoke ex1. How can you run ex1 then? It turns out that you can utilize the test harness code that we have given you to run ex1 and observe how it executes.

To run the test with the given ex1 function, you need to link the test object file objs/tester.o together with the given objs/ex*-sol.o files. We have made this step easy by including appropriate Makefile rules. When you type make, you will see that there are two binary executables being generated, tester, and tester-sol. The executable file tester links our tester file with your object files ex*.o which are generated from your ex*.c files. The executable file tester-sol links our tester file with the given object file objs/ex*-sol.o. Thus, when you run ./tester-sol, the tester invokes the given functions, and needless to say, all tests should pass.

Run gdb tester-sol. Stop the execution when the function ex1 is invoked. Dissemble the function. Execute the instructions one by one. Form some hypothesis on what the function signature is and what it does. Verify your hypothesis during execution by examining register values and memory contents.

Note: It is not the right approach to try to match the object code of your C function to that contained in ex*-sol.o. Doing so is painful and not necessary. Minor changes in how a set of C code is written will result in different object code, although they do not affect the code's semantics. Therefore, trying to find a C function that generates the same object code is frustracting and likely futile.

Test your solution

After you've finished each function (remember to remove the assert(0); statement), you can test its correctness as follows:
$ make
$ ./tester
Testing Ex1...
Ex1: your implementation passes the test
Testing Ex2...
Ex2: your implementation passes the test
Testing Ex3...
Ex3: your implementation passes the test
Testing Ex4...
Ex4: your implementation passes the test
Testing Ex5...
Ex5: your implementation passes the test
The above ouput ocurrs when all your ex* functions pass the test.

To test multiple times, run ./tester -r with the -r option. This runs the tester using a new seed for its random number generator.

Some of you might want to skip around and implement the five ex* functions in arbitary order. This is a good strategy if you are stuck on some function. To test just ex2, type ./tester -t 2. Ditto with other functions.

Note: Passing the test does not guarantee that you will get a perfect grade (i.e. your implementation is not necessarily correct). During grading, we may use a slightly different test or manually examine your source code to determine its correctness.

Explanations on some unfamiliar assembly and others

For this lab, you need to review the lecture notes and textbook to refresh your understanding of x86 assembly. Below are some additional information not covered in the lecture notes that are helpful for this lab as well.

For those of you who want to go out in the world to explore other object files, you will find the official Intel instruction set manual useful. Note that in the Intel manual, the source and destination operands are reversed in an instruction (i.e. destination operand first, source operand last). In the lecture notes and gdb/objdump's disassembled output, the destination operand appears last in an instruction. These differences are due to two assembly syntaxes, AT&T syntax and Intel syntax. The GNU software (gcc, gdb etc) and lecture notes use AT&T syntax which puts the destination operand last and Intel manual (of course) uses Intel syntax which puts the destination operand first.


First, please make sure you have the up to date lab files. Run the following command to generate lab3.tar.gz:
make handin
Submit here