summaryrefslogtreecommitdiffstats
path: root/man/stapprobes.kprocess.3stap.in
diff options
context:
space:
mode:
authorDavid Smith <dsmith@redhat.com>2009-05-21 16:57:04 -0500
committerDavid Smith <dsmith@redhat.com>2009-05-21 16:57:04 -0500
commitc8e9eb18d8d13d099a4a177fe53de507c1d9ce8b (patch)
treeab2388afb795ed1a7ead2fbbf8b9d1b368a8231f /man/stapprobes.kprocess.3stap.in
parentdd9a3bcbef65bde65491d959e9458bc641924811 (diff)
parent3863e7999255deeaa7f8f4bba7df893773812537 (diff)
downloadsystemtap-steved-c8e9eb18d8d13d099a4a177fe53de507c1d9ce8b.tar.gz
systemtap-steved-c8e9eb18d8d13d099a4a177fe53de507c1d9ce8b.tar.xz
systemtap-steved-c8e9eb18d8d13d099a4a177fe53de507c1d9ce8b.zip
Merge commit 'origin/master' into pr7043
Conflicts: runtime/print.c runtime/transport/transport.c runtime/transport/transport_msgs.h
Diffstat (limited to 'man/stapprobes.kprocess.3stap.in')
-rw-r--r--man/stapprobes.kprocess.3stap.in106
1 files changed, 106 insertions, 0 deletions
diff --git a/man/stapprobes.kprocess.3stap.in b/man/stapprobes.kprocess.3stap.in
new file mode 100644
index 00000000..4f5e7903
--- /dev/null
+++ b/man/stapprobes.kprocess.3stap.in
@@ -0,0 +1,106 @@
+.\" -*- nroff -*-
+.TH STAPPROBES.KPROCESS 3stap @DATE@ "Intel, IBM"
+.SH NAME
+stapprobes.kprocess \- systemtap kernel process probe points
+
+.\" macros
+.de SAMPLE
+.br
+.RS
+.nf
+.nh
+..
+.de ESAMPLE
+.hy
+.fi
+.RE
+..
+
+.SH DESCRIPTION
+
+This family of probe points is used to probe the kernel's process activities.
+It contains the following probe points:
+
+.P
+.TP
+.B kprocess.create
+
+Fires whenever a new process is successfully created, either as a
+result of one of the fork syscall variants, or a new kernel thread.
+
+.B Arguments:
+
+.I task
+ a handle to the newly created process
+
+.I new_pid
+ pid of the newly created process
+
+.P
+.TP
+.B kprocess.start
+
+Fires immediately before a new process begins execution.
+
+.B Arguments:
+
+.I N/A
+
+.P
+.TP
+.B kprocess.exec
+
+Fires whenever a process attempts to exec to a new program
+
+.B Arguments:
+
+.I filename
+ the path to the new executable
+
+.P
+.TP
+.B kprocess.exec_complete
+
+Fires at the completion of an exec call
+
+.B Arguments:
+
+.I errno
+ the error number resulting from the exec
+
+.I success
+ a boolean indicating whether the exec was successful
+
+.P
+.TP
+.B kprocess.exit
+
+Fires when a process terminates. This will always be followed by a
+kprocess.release, though the latter may be delayed if the process
+waits in a zombie state.
+
+.B Arguments:
+
+.I code
+ the exit code of the process
+
+.P
+.TP
+.B kprocess.release
+
+Fires when a process is released from the kernel. This always
+follows a kprocess.exit, though it may be delayed somewhat if the
+process waits in a zombie state.
+
+.B Arguments:
+
+.I task
+ a task handle to the process being released
+
+.I pid
+ pid of the process being released
+
+.SH SEE ALSO
+.IR stap (1),
+.IR stapprobes (3stap)
+