Debian Codegraph @

doc/SystemTap_Tapset_Reference/man3/function::probefunc.3stap

raw
1 '\" t
2 .\" Title: function::probefunc
3 .\" Author:
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: October 2025
6 .\" Manual: Context Functions
7 .\" Source: SystemTap Tapset Reference
8 .\" Language: English
9 .\"
10 .TH "FUNCTION::PROBEFUNC" "3stap" "October 2025" "SystemTap Tapset Reference" "Context Functions"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 function::probefunc \- Return the probe point\*(Aqs function name, if known
32 .SH "SYNOPSIS"
33 .sp
34 .nf
35 probefunc:string()
36 .fi
37 .SH "ARGUMENTS"
38 .PP
39 None
40 .SH "DESCRIPTION"
41 .PP
42 This function returns the name of the function being probed based on the current address, as computed by symname(\fBaddr\fR) or usymname(\fBuaddr\fR) depending on probe context (whether the probe is a user probe or a kernel probe)\&.
43 .SH "PLEASE NOTE"
44 .PP
45 this function\*(Aqs behaviour differs between SystemTap 2\&.0 and earlier versions\&. Prior to 2\&.0,
46 \fBprobefunc\fR
47 obtained the function name from the probe point string as returned by
48 \fBpp\fR, and used the current address as a fallback\&.
49 .PP
50 Consider using
51 \fBppfunc\fR
52 instead\&.
53 .SH SEE ALSO\n
54 .IR tapset::context-symbols (3stap)