ComDetective Accuracy Verification Microbenchmarks
===============
These microbenchmarks were used to verify the accuracy of ComDetective in M. Aditya Sasongko, Palwisha Akhtar, Milind Chabbi, Didem Unat, "ComDetective: A Lightweight Communication Detection Tool for Threads", 2019 IEEE/ACM Supercomputing Conference. 


Installation
===============
To install these microbenchmarks, type the following commands.

make volume_install
make p2p_install


How to Run
===============
Before monitoring these microbenchmarks with ComDetective and Linux perf, please assign the installation path of ComDetective to the ComDetective_bin variable and the location of perf executable to the perf_bin variable in the Makefile.


Reproducing The Results in the ComDetective Paper
===============

The results in the paper were generated under the following environment.

- OS Kernel: Linux 4.15.0 with a patch that enables fast address replacement in debug registers. This patch has already been a part of Linux kernel in Linux version 4.18 or above.
- Hardware: Intel Xeon E5-2640 v4

To reproduce the write-volume verification results presented in the paper (Figure 3), execute the following commands.

# the following command generates the ground truths
make all_rfo_write
# the following command generates the total communication counts detected by ComDetective
make volume_write_verification

To reproduce the false sharing verification results in the paper (Figure 5), execute the following command.

make false_sharing_add_intra_socket_8_threads

To reproduce the read-write verification results in the paper (Figure 6), execute the following command.

make read_write

To reproduce the communication matrices for the point-to-point communication verification as shown in the paper (Figure 7), run the following command.

make p2p