PMUV3 Learning path changes

Author: GayathriNarayana19

content/learning-paths/servers-and-cloud-computing/PMUv3_plugin_learning_path/_index.md

@@ -7,8 +7,9 @@ who_is_this_for: Engineers working on a workload/codebase to carry out performan
 
 learning_objectives: 
     - Get a fine-grained and precise measurement of functions handling a specific task. 
-    - The plugin is grouped into 15 categories also known as bundles, and each bundle has a set of PMU events. The values of the same can be obtained in one shot.   
-    - Apart from raw PMU event values, the backend tool also provides the KPI/metric values like MPKI, stalls, IPC and many more, thus helping in performance analysis tasks. 
+    - Instrument at a code/function level by choosing one of the 4 scenarios detailed in this learning path. 
+    - Run and collect the CSV of all the 15 bundles in one shot.
+    - Use the backend tool to plot raw PMU event values along with the KPI/metric values like MPKI, stalls, IPC and many more, thus helping in performance analysis tasks. 
 
 prerequisites:
     - Some familiarity with performance analysis.

content/learning-paths/servers-and-cloud-computing/PMUv3_plugin_learning_path/_next-steps.md

@@ -1,7 +1,7 @@
 ---
-next_step_guidance: PLACEHOLDER TEXT 1
+next_step_guidance: If you need a more detailed documentation, request repo access from author and access this [Documentation-PMUV3_plugin](https://github.com/GayathriNarayana19/PMUv3_plugin/blob/main/Documentation-PMUV3_plugin.pdf)
 
-recommended_path: /learning-paths/PLACEHOLDER_CATEGORY/PLACEHOLDER_LEARNING_PATH/
+recommended_path: /learning-paths/servers-and-cloud-computing/pmuv3_plugin_learning_path/
 
 further_reading:
     - resource:

content/learning-paths/servers-and-cloud-computing/PMUv3_plugin_learning_path/_review.md

@@ -1,38 +1,35 @@
 ---
 review:
     - questions:
-        question: >
-            PLACEHOLDER QUESTION 1?
+        question: Where to find the detailed documentation with example instrumentations?
+            
         answers:
-            - PLACEHOLDER ANSWER A
-            - PLACEHOLDER ANSWER B
+            - If you need a more detailed documentation, request repo access from author and access this [Documentation-PMUV3_plugin](https://github.com/GayathriNarayana19/PMUv3_plugin/blob/main/Documentation-PMUV3_plugin.pdf)
         correct_answer: 1                    
         explanation: >
-            PLACEHOLDER EXPLANATION 1
 
     - questions:
         question: >
-            PLACEHOLDER QUESTION 2?
+            If you want to instrument in a C++ codebase around a single chunk of code, which scenario will you adopt?
         answers:
-            - PLACEHOLDER ANSWER A
-            - PLACEHOLDER ANSWER B
-            - PLACEHOLDER ANSWER C
-            - PLACEHOLDER ANSWER D
-        correct_answer: 4                   
+            - Scenario I
+            - Scenario II
+            - Scenario III
+            - Scenario IV
+        correct_answer: 2                   
         explanation: >
-            PLACEHOLDER EXPLANATION 2
                
     - questions:
         question: >
-            PLACEHOLDER QUESTION 3?
+            What are the advantages of using PMUv3_plugin?
         answers:
-            - PLACEHOLDER ANSWER A
-            - PLACEHOLDER ANSWER B
-            - PLACEHOLDER ANSWER C
-            - PLACEHOLDER ANSWER D
-        correct_answer: 2          
+            - Avoids context switches
+            - Ability to collect the PMU events and metrics in one shot. 
+            - Scope to create Custom bundles is present.
+            - More precise and accurate compared to generic instrumentation methods due to direct counter accesis
+            - All the above
+        correct_answer: 5         
         explanation: >
-            PLACEHOLDER EXPLANATION 3
 
 
 

content/learning-paths/servers-and-cloud-computing/PMUv3_plugin_learning_path/before-you-begin.md

@@ -0,0 +1,41 @@
+---
+title: Requirements
+weight: 3
+
+### FIXED, DO NOT MODIFY
+layout: learningpathall
+---
+
+## Before you begin
+
+We recommend the directory structure to be as follows. Kindly place your codebase/project within 
+
+/YOUR_HOME_DIR/ut_integration.
+
+
+![example image alt-text#center](tree.png "Figure 1. Directory Tree")
+
+### STEP 1: Clone Linux and PMUv3_plugin
+```yaml
+git clone git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
+git clone https://github.com/GayathriNarayana19/PMUv3_plugin.git
+```
+(Below step OPTIONAL, good to enable once.)
+Enable userspace access : To ascertain if userspace access to the PMU counters is allowed, check the perf_user_access file.
+```yaml
+cat /proc/sys/kernel/perf_user_access
+0
+sudo sysctl kernel/perf_user_access=1
+kernel/perf_user_access=1
+cat /proc/sys/kernel/perf_user_access
+1
+```
+## STEP 2: Run ./build.sh
+To do the static library compilation, run ./build.sh from /home/ubuntu/ut_integration/PMUv3_plugin/directory.
+Run ./build.sh if you are going to instrument around a C++ codebase. If it is a C codebase, then comment line 19 of build.sh and uncomment line 20 and run ./build.sh
+
+![example image alt-text#center](build_sh.png "Figure 2. build.sh")
+
+## STEP 3: Include the static library in Makefile/CMakelists or relevant files
+In your application's Makefile or CMakeLists files, make sure to add or include this -lpmuv3_plugin_bundle.a static library and -L to point its location. 
+