Updates samples index for sched_switch

6 files changed, 49 insertions, 3 deletions

diff --git a/testsuite/systemtap.examples/index.html b/testsuite/systemtap.examples/index.html
index ba0d0fd7..66118bfc 100644
--- a/testsuite/systemtap.examples/index.html
+++ b/testsuite/systemtap.examples/index.html
@@ -196,6 +196,9 @@ keywords: <a href="keyword-index.html#SYSCALL">SYSCALL</a> <a href="keyword-inde
 <li><a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Called<br>
 keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTIONS">FUNCTIONS</a> <br>
 <p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p></li>
+<li><a href="profiling/sched_switch.stp">profiling/sched_switch.stp</a> - Display the task switches happening in the scheduler<br>
+keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTIONS">FUNCTIONS</a> <br>
+<p>The sched_switch.stp script takes two arguments, first argument can be "pid" or "name" to indicate what is being passed as second argument. The script will trace the process based on pid/name and print the scheduler switches happening with the process. If no arguments are passed, it displays all the scheduler switches. This can be used to understand which tasks schedule out the current process being traced, and when it gets scheduled in again.</p></li>
 <li><a href="profiling/thread-times.stp">profiling/thread-times.stp</a> - Profile kernel functions<br>
 keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <br>
 <p>The thread-times.stp script sets up time-based sampling. Every five seconds it prints out a sorted list with the top twenty processes with samples broken down into percentage total time spent in user-space and kernel-space.</p></li>
diff --git a/testsuite/systemtap.examples/index.txt b/testsuite/systemtap.examples/index.txt
index 3d0495f5..cb2b10d3 100644
--- a/testsuite/systemtap.examples/index.txt
+++ b/testsuite/systemtap.examples/index.txt
@@ -488,6 +488,18 @@ keywords: profiling functions
   called function.
 
 
+profiling/sched_switch.stp - Display the task switches happening in the scheduler
+keywords: profiling functions
+
+  The sched_switch.stp script takes two arguments, first argument can
+  be "pid" or "name" to indicate what is being passed as second
+  argument. The script will trace the process based on pid/name and
+  print the scheduler switches happening with the process. If no
+  arguments are passed, it displays all the scheduler switches. This
+  can be used to understand which tasks schedule out the current
+  process being traced, and when it gets scheduled in again.
+
+
 profiling/thread-times.stp - Profile kernel functions
 keywords: profiling
 
diff --git a/testsuite/systemtap.examples/keyword-index.html b/testsuite/systemtap.examples/keyword-index.html
index 1a68a9f0..2aad9adf 100644
--- a/testsuite/systemtap.examples/keyword-index.html
+++ b/testsuite/systemtap.examples/keyword-index.html
@@ -120,6 +120,9 @@ keywords: <a href="keyword-index.html#NETWORK">NETWORK</a> <a href="keyword-inde
 <li><a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Called<br>
 keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTIONS">FUNCTIONS</a> <br>
 <p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p></li>
+<li><a href="profiling/sched_switch.stp">profiling/sched_switch.stp</a> - Display the task switches happening in the scheduler<br>
+keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTIONS">FUNCTIONS</a> <br>
+<p>The sched_switch.stp script takes two arguments, first argument can be "pid" or "name" to indicate what is being passed as second argument. The script will trace the process based on pid/name and print the scheduler switches happening with the process. If no arguments are passed, it displays all the scheduler switches. This can be used to understand which tasks schedule out the current process being traced, and when it gets scheduled in again.</p></li>
 </ul>
 <h3><a name="FUTEX">FUTEX</a></h3>
 <ul>
@@ -300,6 +303,9 @@ keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <br>
 <li><a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Called<br>
 keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTIONS">FUNCTIONS</a> <br>
 <p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p></li>
+<li><a href="profiling/sched_switch.stp">profiling/sched_switch.stp</a> - Display the task switches happening in the scheduler<br>
+keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTIONS">FUNCTIONS</a> <br>
+<p>The sched_switch.stp script takes two arguments, first argument can be "pid" or "name" to indicate what is being passed as second argument. The script will trace the process based on pid/name and print the scheduler switches happening with the process. If no arguments are passed, it displays all the scheduler switches. This can be used to understand which tasks schedule out the current process being traced, and when it gets scheduled in again.</p></li>
 <li><a href="profiling/thread-times.stp">profiling/thread-times.stp</a> - Profile kernel functions<br>
 keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <br>
 <p>The thread-times.stp script sets up time-based sampling. Every five seconds it prints out a sorted list with the top twenty processes with samples broken down into percentage total time spent in user-space and kernel-space.</p></li>
diff --git a/testsuite/systemtap.examples/keyword-index.txt b/testsuite/systemtap.examples/keyword-index.txt
index 056b553a..01661cf1 100644
--- a/testsuite/systemtap.examples/keyword-index.txt
+++ b/testsuite/systemtap.examples/keyword-index.txt
@@ -154,6 +154,18 @@ keywords: profiling functions
   called function.
 
 
+profiling/sched_switch.stp - Display the task switches happening in the scheduler
+keywords: profiling functions
+
+  The sched_switch.stp script takes two arguments, first argument can
+  be "pid" or "name" to indicate what is being passed as second
+  argument. The script will trace the process based on pid/name and
+  print the scheduler switches happening with the process. If no
+  arguments are passed, it displays all the scheduler switches. This
+  can be used to understand which tasks schedule out the current
+  process being traced, and when it gets scheduled in again.
+
+
 = FUTEX =
 
 process/futexes.stp - System-Wide Futex Contention
@@ -618,6 +630,18 @@ keywords: profiling functions
   called function.
 
 
+profiling/sched_switch.stp - Display the task switches happening in the scheduler
+keywords: profiling functions
+
+  The sched_switch.stp script takes two arguments, first argument can
+  be "pid" or "name" to indicate what is being passed as second
+  argument. The script will trace the process based on pid/name and
+  print the scheduler switches happening with the process. If no
+  arguments are passed, it displays all the scheduler switches. This
+  can be used to understand which tasks schedule out the current
+  process being traced, and when it gets scheduled in again.
+
+
 profiling/thread-times.stp - Profile kernel functions
 keywords: profiling
 
diff --git a/testsuite/systemtap.examples/profiling/sched_switch.meta b/testsuite/systemtap.examples/profiling/sched_switch.meta
index 8f1a2858..b202a74c 100644
--- a/testsuite/systemtap.examples/profiling/sched_switch.meta
+++ b/testsuite/systemtap.examples/profiling/sched_switch.meta
@@ -1,4 +1,4 @@
-title: Display the task switches happeningt the scheduler
+title: Display the task switches happening in the scheduler
 name: sched_switch.stp
 version: 1.0
 author: kiran
@@ -6,9 +6,9 @@ keywords: profiling functions
 subsystem: kernel
 status: production
 exit: user-controlled
-output: sorted-list on-exit
+output: trace
 scope: system-wide
-description: The sched_switch.stp script takes two arguments, first argument can be "pid" or "name" to indicate what is being passed as second argument. The script will trace the process based on pid/name and print the scheduler switches happening with the process. If no arguments are passed, it displays all the scheduler switches. This can be used to understand which tasks scheduler the current process being traced, out and when it gets scheduled in again.
+description: The sched_switch.stp script takes two arguments, first argument can be "pid" or "name" to indicate what is being passed as second argument. The script will trace the process based on pid/name and print the scheduler switches happening with the process. If no arguments are passed, it displays all the scheduler switches. This can be used to understand which tasks schedule out the current process being traced, and when it gets scheduled in again.
 test_check: stap -p4 sched_switch.stp
 test_installcheck: stap  sched_switch.stp -c "sleep 1"
 
diff --git a/testsuite/systemtap.examples/profiling/sched_switch.stp b/testsuite/systemtap.examples/profiling/sched_switch.stp
index 24973526..1c1b18b7 100644..100755
--- a/testsuite/systemtap.examples/profiling/sched_switch.stp
+++ b/testsuite/systemtap.examples/profiling/sched_switch.stp
@@ -1,3 +1,4 @@
+#! /usr/bin/env stap
 /* This script works similar to ftrace's sched_switch. It displays a list of
  * processes which get switched in and out of the scheduler. The format of display
  * is PROCESS_NAME PROCESS_PID CPU TIMESTAMP PID: PRIORITY: PROCESS STATE ->/+