function::target(3stap) — Linux manual page

FUNCTION::TARGET(3stap)     Context Functions     FUNCTION::TARGET(3stap)

NAME         top

       function::target - Return the process ID of the target process

SYNOPSIS         top

           target:long()

ARGUMENTS         top

       None

DESCRIPTION         top

       This function returns the process ID of the target process. This
       is useful in conjunction with the -x PID or -c CMD command-line
       options to stap. An example of its use is to create scripts that
       filter on a specific process.

       -x <pid> target returns the pid specified by -x

       -c <command> target returns the pid for the executed command
       specified by -c

SEE ALSO         top

       tapset::context(3stap)

COLOPHON         top

       This page is part of the systemtap (a tracing and live-system
       analysis tool) project.  Information about the project can be
       found at ⟨https://sourceware.org/systemtap/⟩.  If you have a bug
       report for this manual page, send it to systemtap@sourceware.org.
       This page was obtained from the project's upstream Git repository
       ⟨git://sourceware.org/git/systemtap.git⟩ on 2025-08-11.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2025-07-24.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

SystemTap Tapset Reference      April 2025        FUNCTION::TARGET(3stap)

Pages that refer to this page: tapset::context(3stap)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.