NAME

dtrace_pid — a DTrace provider for dynamic userspace tracing based on function boundary instrumentation

SYNOPSIS

pidPID:module:function:entry

pidPID:module:function:[offset]

pidPID:module:function:return

DESCRIPTION

The pid provider implements userspace dynamic tracing by instrumenting the entry and return of functions in userspace programs. Refer to dtrace_fbt(4) for more details about function boundary instrumentation.

The pid provider provides the following probes:

pidPID:module:function:entry: instruments the entry of the function.
pidPID:module:function:[offset]: instruments the instruction within the function located at offset bytes (expressed as a hexadecimal integer).
pidPID:module:function:return: instruments the return from the function.

Probe Arguments

The arguments of the entry probe (pidPID:module:function:entry) are the arguments of the traced function call.

Entry Probe Argument	Definition
`uint64_t` `arg0`	Function's first argument
`uint64_t` `arg1`	Function's second argument
`uint64_t` `arg2`	Function's third argument
`...`	...

The offset probes (pidPID:module:function:[offset]) do not define any arguments. Use uregs[] to inspect the registers.

The arguments of the return probe (pidPID:module:function:return) are the program counter and the function's return value.

Return Probe Argument	Definition
`uint64_t` `arg0`	Program counter
`uint64_t` `arg1`	Function's return value

Note that all probe arguments within the pid provider are of type uint64_t.

AUTHORS

This manual page was written by Mateusz Piotrowski <0mp@FreeBSD.org>.

NAME

SYNOPSIS

DESCRIPTION

Probe Arguments

SEE ALSO

AUTHORS