Due Thursday September 21st by midnight

Overview

This assignment is to read data from a file using a memory mapped file and read the ELF data from the file and populate the necessary data structures, there are three projects within this assignment.

• ELF Tester
• This project contains the main tests for the project, you will run this to test your program.
• Git location here
• Student ELF Tester
• • This project is where you will write your code that reads the ELF header from the file.
  • You will have a unique github repo created with the following format <user_name>_StudentELFTester in this organization
• ELF Main Check
• This project will be used by valgrind to check for memory leaks. Your program should not leak memory.
• Git location here

---

Configuring environment for this project

In order to be able to run this project there are a couple of things you need to do.

• Build and install the google test library, run the following commands from the terminal in your vm
1. sudo apt-get install libgtest-dev
2. sudo apt-get install cmake
3. cd /usr/src/gtest
4. sudo cmake CMakeLists.txt
5. sudo make
6. sudo cp *.a /usr/lib
7. Instructions cribbed from here
• Create environment variables in CLion, you will have to add environment variables to make this work
1. Go to file settings->CMake, see image below

2. Click on the ... next to Environment box, the below screen should come up

3. Click the plus button
4. Add a name and value on the next line

---

ELF Tester

ELF Tester will be used to test your project, it will need the location of your StudentELFReader from an environment variable. This program also requires the use of google test which must be installed per the above instructions. You must add the variable ELFREADER_LIB_DIR with the location of where your libStudentElfReader.a file

Also you will find that there is a file called libElfReader.a in the lib directory. This library is my implementation of the project. The tests will run my code and your code and then compare the answers.

The other thing you will notice is this is a C++ project, the header has a weird line extern "C". This tells the compiler that all functions in this bracket will be in a C library. Your library is a C library and therefore needs a different header than the ELF Reader project

---

Student ELF Reader

Student ELF Reader is a project where you will write your code, you are required to implement two functions getELFData and destroyELFData. The header file describes all functions and structures in helping you do the assignment.

• getELFData - Map the file into memory, copy data from the ELF header into the objects provided in the header file.
• destroyELFData - Destroy all memory created when the ElfData structure in getELFData

---

ELF Main Check

This project only exists for the purpose of checking if you have any memory leaks, you will not writing code in this project. It will simply link to your library and call getELFData and destroyELFData. You will build this project and then run valgrind on it to note any memory leaks. You will have to add the same environment variable ELFREADER_LIB_DIR used by ELFTester. You will also have to add ELF_COMMON_INCLUDE which is the location of your Student ELF project to include the header file from your project.

You will have to install valgrind in order to use this project to test for memory leaks. Install valgrind with this command sudo apt-get install valgrind. Run valgrind with valgrind --leak-check=yes <location of executable> You can find the quick start guide valgrind here

Resources

Here are some resources to help you figure out how to complete this project.

• mmap man page
• ELF man page
• Wikipedia ELF description