2007-11-09 Martin Hunt <hunt@redhat.com>

	* README: New.

	* *.stp. Fix path.  See PR 4718.

diff --git a/examples/ChangeLog b/examples/ChangeLog
index 1999521f2aa74abc84c64378759fbe58b151ebfd..ded655b457fdb11ae98364bbdb0d565aaebf724c 100644 (file)
--- a/examples/ChangeLog
+++ b/examples/ChangeLog
@@ -1,3 +1,9 @@
+2007-11-09  Martin Hunt  <hunt@redhat.com>
+
+       * README: New.
+
+       * *.stp. Fix path.  See PR 4718.
+
 2007-10-10  Mike Mason
 
        * syscalltimes, syscalltime.txt:  New combination shell/SystemTap script

diff --git a/examples/README b/examples/README
new file mode 100644 (file)
index 0000000..6718a55
--- /dev/null
+++ b/examples/README
@@ -0,0 +1,9 @@
+This directory contains example scripts.  
+
+Each script should be checked in as executable.
+
+The first line should be
+#! /usr/bin/env stap
+
+There should be an accompanying ".txt" file describing what the
+script does and how to use it.

diff --git a/examples/futexes.stp b/examples/futexes.stp
old mode 100644 (file)
new mode 100755 (executable)
index 515a8db..16c6293
--- a/examples/futexes.stp
+++ b/examples/futexes.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 # This script tries to identify contended user-space locks by hooking
 # into the futex system call.

diff --git a/examples/helloworld.stp b/examples/helloworld.stp
old mode 100644 (file)
new mode 100755 (executable)
index c1e50c0..efe45b7
--- a/examples/helloworld.stp
+++ b/examples/helloworld.stp
@@ -1,2 +1,2 @@
-#! /usr/bin/stap
-probe begin { log("hello world") exit () }
+#! /usr/bin/env stap
+probe begin { println("hello world") exit () }

diff --git a/examples/iostat-scsi.stp b/examples/iostat-scsi.stp
old mode 100644 (file)
new mode 100755 (executable)
index 63b0496..ec1aeeb
--- a/examples/iostat-scsi.stp
+++ b/examples/iostat-scsi.stp
@@ -1,4 +1,4 @@
-#!/bin/env stap
+#! /usr/bin/env stap
 
 global devices, reads, writes
 

diff --git a/examples/iotime.stp b/examples/iotime.stp
old mode 100644 (file)
new mode 100755 (executable)
index c9b1704..a5b3644
--- a/examples/iotime.stp
+++ b/examples/iotime.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 /*
  * Copyright (C) 2006 Daniel Berrange, Red Hat Inc.

diff --git a/examples/nettop.stp b/examples/nettop.stp
old mode 100644 (file)
new mode 100755 (executable)
index c756f82..1310f5b
--- a/examples/nettop.stp
+++ b/examples/nettop.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 global ifxmit, ifrecv, ifdevs, ifpid, execname, user
 

diff --git a/examples/pf2.stp b/examples/pf2.stp
old mode 100644 (file)
new mode 100755 (executable)
index fbac4e5..96fdb7e
--- a/examples/pf2.stp
+++ b/examples/pf2.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 global profile, pcount
 probe timer.profile {

diff --git a/examples/sig_by_pid.stp b/examples/sig_by_pid.stp
index 4e0600f18d374952bb06b52246830c89e0651f90..9c1493f532fb0ebe4cc408834cf8a98ede3e2851 100755 (executable)
--- a/examples/sig_by_pid.stp
+++ b/examples/sig_by_pid.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 # Copyright (C) 2006 IBM Corp.
 #

diff --git a/examples/sig_by_proc.stp b/examples/sig_by_proc.stp
index 18b236d3e1d9efa35b82c29b67729d424a9a523b..ce845aed89002d8f5ef146757f036130303a39cc 100755 (executable)
--- a/examples/sig_by_proc.stp
+++ b/examples/sig_by_proc.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 # Copyright (C) 2006 IBM Corp.
 #

diff --git a/examples/sigmon.stp b/examples/sigmon.stp
index 42cb1892f054b2ad2d585595ed93d636ce9db65f..31d7822e57d019aaa63df27bdec09a84994804ab 100755 (executable)
--- a/examples/sigmon.stp
+++ b/examples/sigmon.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 # Copyright (C) 2006 IBM Corp.
 #

diff --git a/examples/sleeptime.stp b/examples/sleeptime.stp
old mode 100644 (file)
new mode 100755 (executable)
index 3234048..252e50c
--- a/examples/sleeptime.stp
+++ b/examples/sleeptime.stp
@@ -1,4 +1,5 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
+
 /*
  * Copyright (C) 2006 Daniel Berrange, Red Hat Inc.
  * Copyright (C) 2007 Will Cohen, Red Hat, Inc.

diff --git a/examples/small_demos/close.stp b/examples/small_demos/close.stp
index 53f53b2596fa943764ffbbba8596efacb0e1a122..7ba2a0369939f31a627ac6c6829e723b48a25b61 100755 (executable)
--- a/examples/small_demos/close.stp
+++ b/examples/small_demos/close.stp
@@ -7,3 +7,8 @@ probe syscall.close {
 probe syscall.close.return {
        printf("%s\n", returnstr(returnp))
 }
+
+probe end {
+       printf("DONE\n")
+}
+

diff --git a/examples/small_demos/fileopen.stp b/examples/small_demos/fileopen.stp
old mode 100644 (file)
new mode 100755 (executable)
index 5d59ee5..c1298f9
--- a/examples/small_demos/fileopen.stp
+++ b/examples/small_demos/fileopen.stp
@@ -1,9 +1,14 @@
+#! /usr/bin/env stap
+
+#
 # fileopen.stp
 #
 # This is based on dtrace script from 
 # http://www.gnome.org/~gman/blog/2006/Jan
 #
-#stap  fileopen.stp  -c "zenity --about"
+# stap  fileopen.stp  -c "zenity --about"
+# or
+# ./fileopen.stp -c "program or script"
 
 global opens
 

diff --git a/examples/socket-trace.stp b/examples/socket-trace.stp
old mode 100644 (file)
new mode 100755 (executable)
index e574205..13ab8e0
--- a/examples/socket-trace.stp
+++ b/examples/socket-trace.stp
@@ -1,4 +1,5 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
+
 probe kernel.function("*@net/socket.c").call {
   printf ("%s -> %s\n", thread_indent(1), probefunc())
 }

diff --git a/examples/syscalls_by_pid.stp b/examples/syscalls_by_pid.stp
index ceb5821aec0e4d6c1fae089af9bbbf3bf27a3d34..47aa4955a4a32b32fbce4c0cf4dc7a08a3dbf1ed 100755 (executable)
--- a/examples/syscalls_by_pid.stp
+++ b/examples/syscalls_by_pid.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 # Copyright (C) 2006 IBM Corp.
 #

diff --git a/examples/syscalls_by_proc.stp b/examples/syscalls_by_proc.stp
index 1807a46cf8c99abda616523a3dfad78bcf627067..af7d69321fa87ff3cb6e2121a459131158e75581 100755 (executable)
--- a/examples/syscalls_by_proc.stp
+++ b/examples/syscalls_by_proc.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 # Copyright (C) 2006 IBM Corp.
 #

diff --git a/examples/wait4time.stp b/examples/wait4time.stp
old mode 100644 (file)
new mode 100755 (executable)
index cf74fa5..bd1628e
--- a/examples/wait4time.stp
+++ b/examples/wait4time.stp
@@ -1,4 +1,4 @@
-#! /usr/bin/stap
+#! /usr/bin/env stap
 
 /*
  * Copyright (C) 2006 Daniel Berrange, Red Hat Inc.