introspection_get_generalpurpose_regs()
Get the general purpose registers of a process
Synopsis:
#include <sys/introspection.h>
int introspection_get_generalpurpose_regs( pid64_t pid64,
unsigned tid,
debug_greg_t *regs );
Arguments:
- pid64
- The PID (pid_t) or unique PID (pid64_t) of the target process.
- tid
- The thread ID of the target thread.
- regs
- The location to store the data.
Library:
libintrospection
Use the -l introspection option to qcc to link against this library.
Description:
The introspection_get_generalpurpose_regs() function gets the general purpose registers of a thread and stores them into a struct debug_greg_t. The structure is architecture-dependent; refer to context.h in the corresponding architecture folder for more information.
Note:
Your process must have the
PROCMGR_AID_XPROCESS_QUERY ability enabled to request information
about another process.
Returns:
The size of the processor architecture-specific register set, on success. If an error occurs, the function returns the negative of a value from the Errors section.
Errors:
- EFAULT
- Error accessing the output buffer.
- EPERM
- The calling process doesn't have the required ability.
- ESRCH
- The PID or TID is invalid.
Classification:
| Safety: | |
|---|---|
| Cancellation point | Yes |
| Signal handler | Yes |
| Thread | Yes |
Page updated: