From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 17978 invoked by alias); 23 Dec 2011 08:31:42 -0000 Received: (qmail 17963 invoked by uid 22791); 23 Dec 2011 08:31:37 -0000 X-SWARE-Spam-Status: No, hits=-1.5 required=5.0 tests=AWL,BAYES_00 X-Spam-Check-By: sourceware.org Received: from relay1.mentorg.com (HELO relay1.mentorg.com) (192.94.38.131) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 23 Dec 2011 08:31:24 +0000 Received: from svr-orw-fem-01.mgc.mentorg.com ([147.34.98.93]) by relay1.mentorg.com with esmtp id 1Re0XD-0003e7-RB from Fredrik_Oestman@mentor.com for systemtap@sourceware.org; Fri, 23 Dec 2011 00:31:23 -0800 Received: from SVR-IES-FEM-03.mgc.mentorg.com ([137.202.0.108]) by svr-orw-fem-01.mgc.mentorg.com over TLS secured channel with Microsoft SMTPSVC(6.0.3790.4675); Fri, 23 Dec 2011 00:31:23 -0800 Received: from EU-MBX-04.mgc.mentorg.com ([169.254.4.220]) by SVR-IES-FEM-03.mgc.mentorg.com ([137.202.0.108]) with mapi id 14.01.0289.001; Fri, 23 Dec 2011 08:31:21 +0000 From: "Oestman, Fredrik" To: "systemtap@sourceware.org" CC: "Oestman, Fredrik" Subject: [PATCH 08/10] Correct and consistent .meta files for example Date: Fri, 23 Dec 2011 08:33:00 -0000 Message-ID: <524C960C5DFC794E82BE548D825F05CF01D4F7@EU-MBX-04.mgc.mentorg.com> Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-IsSubscribed: yes Mailing-List: contact systemtap-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Help: , Sender: systemtap-owner@sourceware.org X-SW-Source: 2011-q4/txt/msg00415.txt.bz2 Signed-off-by: Fredrik =D6stman --- testsuite/systemtap.examples/profiling/errno.meta | 2 +- .../systemtap.examples/profiling/fntimes.meta | 9 ++++++++- .../profiling/functioncallcount.meta | 6 +++--- .../systemtap.examples/profiling/latencytap.meta | 4 ++-- .../systemtap.examples/profiling/linetimes.meta | 4 ++-- .../systemtap.examples/profiling/periodic.meta | 6 +++--- .../systemtap.examples/profiling/sched_switch.meta | 7 +++---- .../systemtap.examples/profiling/thread-times.meta | 9 ++++++++- .../systemtap.examples/profiling/timeout.meta | 2 +- testsuite/systemtap.examples/profiling/topsys.meta | 2 +- 10 files changed, 32 insertions(+), 19 deletions(-) diff --git a/testsuite/systemtap.examples/profiling/errno.meta b/testsuite/= systemtap.examples/profiling/errno.meta index 9632ed7..35e7c6c 100644 --- a/testsuite/systemtap.examples/profiling/errno.meta +++ b/testsuite/systemtap.examples/profiling/errno.meta @@ -3,7 +3,7 @@ name: errno.stp version: 1.0 author: Dominic Duval keywords: profiling -subsystem: kernel +subsystem: any status: production exit: user-controlled output: sorted-list diff --git a/testsuite/systemtap.examples/profiling/fntimes.meta b/testsuit= e/systemtap.examples/profiling/fntimes.meta index 4b4ff1e..a8b7b15 100644 --- a/testsuite/systemtap.examples/profiling/fntimes.meta +++ b/testsuite/systemtap.examples/profiling/fntimes.meta @@ -1,6 +1,13 @@ -title: Show functions taking longer than usual +title: Show Functions Taking Longer Than Usual name: fntimes.stp +version: 1.0 +author: anonymous keywords: profiling +subsystem: any +status: proposed +exit: user-controlled +output: trace +scope: system-wide description: The fntimes.stp script monitors the execution time history of= a given function family (assumed non-recursive). Each time (beyond a warm= up interval) is then compared to the historical maximum. If it exceeds a c= ertain threshold (250%), a message is printed. test_check: stap -p4 fntimes.stp 'kernel.function("sys_*")' test_installcheck: stap fntimes.stp 'kernel.function("sys_*")' -c "sleep 7" diff --git a/testsuite/systemtap.examples/profiling/functioncallcount.meta = b/testsuite/systemtap.examples/profiling/functioncallcount.meta index 682b2f9..3b3cc3a 100644 --- a/testsuite/systemtap.examples/profiling/functioncallcount.meta +++ b/testsuite/systemtap.examples/profiling/functioncallcount.meta @@ -1,9 +1,9 @@ -title: Count Times Functions Called +title: Count Times Functions Are Called name: functioncallcount.stp version: 1.0 author: anonymous -keywords: profiling functions -subsystem: kernel +keywords: profiling function +subsystem: any status: production exit: user-controlled output: sorted-list on-exit diff --git a/testsuite/systemtap.examples/profiling/latencytap.meta b/tests= uite/systemtap.examples/profiling/latencytap.meta index 88fe424..60c3d34 100644 --- a/testsuite/systemtap.examples/profiling/latencytap.meta +++ b/testsuite/systemtap.examples/profiling/latencytap.meta @@ -1,9 +1,9 @@ -title: Show reasons and durations for processes sleeping +title: Show Reasons and Durations for Processes Sleeping name: latencytap.stp version: 1.0 author: William Cohen keywords: profiling -subsystem: kernel +subsystem: any status: experimental exit: user-controlled output: sorted-list diff --git a/testsuite/systemtap.examples/profiling/linetimes.meta b/testsu= ite/systemtap.examples/profiling/linetimes.meta index 3a9d699..35f7526 100644 --- a/testsuite/systemtap.examples/profiling/linetimes.meta +++ b/testsuite/systemtap.examples/profiling/linetimes.meta @@ -1,9 +1,9 @@ -title: Show Time Spent on Each Line if a Function +title: Show Time Spent on Each Line of a Function name: linetimes.stp version: 1.0 author: William Cohen keywords: profiling -subsystem: kernel +subsystem: any status: production exit: user-controlled output: sorted-list diff --git a/testsuite/systemtap.examples/profiling/periodic.meta b/testsui= te/systemtap.examples/profiling/periodic.meta index dae70e0..9e12079 100644 --- a/testsuite/systemtap.examples/profiling/periodic.meta +++ b/testsuite/systemtap.examples/profiling/periodic.meta @@ -1,14 +1,14 @@ -title: Show the period of the various timers on the system +title: Show the Period of the Various Timers on the System name: periodic.stp version: 1.0 author: William Cohen keywords: profiling -subsystem: kernel +subsystem: any status: production exit: user-controlled output: sorted-list scope: system-wide -description: The periodic.stp script uses the kernel.trace("timer_expire_= entry") tracepoint to collects data on period and frequency of the various = timers on the system. The script displays a sorted list of the timers obse= rved on the system from most frequent to least frequent. The script needs t= o be compiled with the '--all-modules' option to produce list the function = names. Optionally, this script can be used with a numerical argument to in= dicate the interval in seconds between printing output. +description: The periodic.stp script uses the kernel.trace("timer_expire_= entry") tracepoint to collect data on period and frequency of the various t= imers on the system. The script displays a sorted list of the timers obser= ved on the system from most frequent to least frequent. The script needs to= be compiled with the '--all-modules' option to produce list the function n= ames. Optionally, this script can be used with a numerical argument to ind= icate the interval in seconds between printing output. test_support: stap -l 'kernel.trace("timer_expire_entry")' test_check: stap -p4 --all-modules periodic.stp test_installcheck: stap periodic.stp --all-modules -c "sleep 0.2" diff --git a/testsuite/systemtap.examples/profiling/sched_switch.meta b/tes= tsuite/systemtap.examples/profiling/sched_switch.meta index b202a74..405a358 100644 --- a/testsuite/systemtap.examples/profiling/sched_switch.meta +++ b/testsuite/systemtap.examples/profiling/sched_switch.meta @@ -1,9 +1,9 @@ -title: Display the task switches happening in the scheduler +title: Display the Task Switches Happening in the Scheduler name: sched_switch.stp version: 1.0 author: kiran -keywords: profiling functions -subsystem: kernel +keywords: profiling function +subsystem: scheduler status: production exit: user-controlled output: trace @@ -11,4 +11,3 @@ scope: system-wide description: The sched_switch.stp script takes two arguments, first argume= nt can be "pid" or "name" to indicate what is being passed as second argume= nt. The script will trace the process based on pid/name and print the sched= uler switches happening with the process. If no arguments are passed, it di= splays all the scheduler switches. This can be used to understand which tas= ks schedule out the current process being traced, and when it gets schedule= d 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/thread-times.meta b/tes= tsuite/systemtap.examples/profiling/thread-times.meta index b7d37b1..154ffa5 100644 --- a/testsuite/systemtap.examples/profiling/thread-times.meta +++ b/testsuite/systemtap.examples/profiling/thread-times.meta @@ -1,6 +1,13 @@ -title: Profile kernel functions +title: Profile Kernel Functions name: thread-times.stp +version: 1.0 +author: anonymous keywords: profiling +subsystem: any +status: proposed +exit: user-controlled +output: trace +scope: system-wide description: The thread-times.stp script sets up time-based sampling. Eve= ry five seconds it prints out a sorted list with the top twenty threads occ= upying the CPUs, broken down as a percentage of user and kernel time. test_check: stap -p4 thread-times.stp test_installcheck: stap thread-times.stp -c "sleep 0.2" diff --git a/testsuite/systemtap.examples/profiling/timeout.meta b/testsuit= e/systemtap.examples/profiling/timeout.meta index a91ea1e..ec9bfee 100644 --- a/testsuite/systemtap.examples/profiling/timeout.meta +++ b/testsuite/systemtap.examples/profiling/timeout.meta @@ -3,7 +3,7 @@ name: timeout.stp version: 1.0 author: Uli Drepper and William Cohen keywords: profiling -subsystem: kernel +subsystem: process status: production exit: user-controlled output: sorted-list diff --git a/testsuite/systemtap.examples/profiling/topsys.meta b/testsuite= /systemtap.examples/profiling/topsys.meta index f764ee4..edbe1b9 100644 --- a/testsuite/systemtap.examples/profiling/topsys.meta +++ b/testsuite/systemtap.examples/profiling/topsys.meta @@ -3,7 +3,7 @@ name: topsys.stp version: 1.0 author: anonymous keywords: profiling -subsystem: kernel syscalls +subsystem: syscall status: production exit: user-controlled output: sorted-list --=20 1.7.6.4