Advanced Computer Architecture, Helper Scripts

This is a collection of helper scripts and codes for the 1st assignment for the course "Advanced Computer Architecture", 2019-2020, 3.4.37.8.

Prerequisites

You need to follow all the installation instructions as mentioned in the assignment.

By the end you should have the following directory tree:

Main Project directory            ${ACA_PATH}
├ CSLab "Helper" Code directory   ${HLP_PATH}
├ Parsec directory                ${PAR_PATH}
└ PIN directory                   ${PIN_PATH}

The names in the curly brackets are the names of the paths you have to change in the scripts.

Necessary changes

You will need to make the following changes in the pintool code, according to the advcomparch mailing list:

In the <CSLab Code directory>/pintool/tlb.h, make the following change:
```
 163:  UINT32 HitLatency = 0, UINT32 MissLatency = 100);
```

In the <CSLab Code directory>/pintool/cache.h, make the following changes:

 207:  UINT32 l1HitLatency = 1, UINT32 l2HitLatency = 15,
 208:  UINT32 l2MissLatency = 250);

In the <CSLab Code directory>/pintool/cache.h, add the prefetching code, starting at line 452 (courtesy of Thanasis Delis):

 // PREFETCHING
 ADDRINT prefetch_addr = addr;
 for (UINT32 i=0; i < _l2_prefetch_lines; i++) {
     CACHE_TAG l2Tag;
     UINT32 l2SetIndex;
     prefetch_addr += L2BlockSize();
     SplitAddress(prefetch_addr, L2LineShift(), L2SetIndexMask(), l2Tag, l2SetIndex);
     SET & l2Set = _l2_sets[l2SetIndex];
     l2Hit = l2Set.Find(l2Tag);
     if (!l2Hit) {
         CACHE_TAG l2_replaced = l2Set.Replace(l2Tag);

         // If L2 is inclusive and a TAG has been replaced we need to remove
         // all evicted blocks from L1.
         if ((L2_INCLUSIVE == 1) && !(l2_replaced == INVALID_TAG)) {
             ADDRINT replacedAddr = ADDRINT(l2_replaced) << FloorLog2(L2NumSets());
             replacedAddr = replacedAddr | l2SetIndex;
             replacedAddr = replacedAddr << L2LineShift();
             for (UINT32 i=0; i < L2BlockSize(); i+=L1BlockSize()) {
                 ADDRINT newAddr = replacedAddr | i;
                 SplitAddress(newAddr, L1LineShift(), L1SetIndexMask(), l1Tag, l1SetIndex);
                 l1Set = _l1_sets[l1SetIndex];
                 l1Set.DeleteIfPresent(l1Tag);
             }
         }
     }
 }

You then have to remake the simulator tool:

make clean; make

Installation

Clone the repository, preferably to the Main Project directory mentioned above:
```
 $ git clone https://github.com/UphillD/advcomparch-2020-helpers.git
```
Edit the launcher.sh file with the appropriate paths.

Make the *.sh files executable:

 $ find . -type f -iname "*.sh" -exec chmod +x {} \;

Usage

Simply execute the launcher.sh script, and follow the prompts:

$ ./launcher.sh

Alternatively, execute the script you wish to use directly, e.g.:

$ ./bencher_L1.sh

However, you will have to change the paths manually in every script if you plan to execute them manually.

Notes

The bencher scripts will run every benchmark with every configuration of the appropriate memory level (L1, L2, ..), and place their outputs in the path: <parsec_workspace>/outputs/<memory level>/

The plotter scripts will produce the graphs for every benchmark with every configuration of the appropriate memory level (L1, L2, ..) in the folder they are executed from.

They will also produce the same graphs if there was a 5% and 10% IPC reduction in place for every doubling of the memory capacity or associtivity. Those graphs can be distinguished by the "_Red" suffix.