man7.org > Linux > man-pages

Linux/UNIX system programming training

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

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO | COLOPHON 

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

NAME         top

       function::usymdata - Return the symbol and module offset of an
       address.

SYNOPSIS         top

           usymdata:string(addr:long)

ARGUMENTS         top

       addr
           The address to translate.

DESCRIPTION         top

       Returns the (function) symbol name associated with the given
       address in the current task if known, the offset from the start
       and the size of the symbol, plus the module name (between
       brackets). If symbol is unknown, but module is known, the offset
       inside the module, plus the size of the module is added. If any
       element is not known it will be omitted and if the symbol name is
       unknown it will return the hex string for the given address.

SEE ALSO         top

       tapset::ucontext-symbols(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 [email protected].
       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
       [email protected]

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

Pages that refer to this page: tapset::ucontext-symbols(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.

Cover of TLPI