ttrace.2 (2010 09)

t
ttrace(2) ttrace(2)
Note: These requests are not supported on PA-RISC versions of HP-UX.
TT_PROC_GET_IBPT_REGS
, TT_PROC_GET_DBPT_REGS
These requests read process-wide breakpoint values from breakpoint registers. data
bytes are copied from the instruction or data breakpoint register(s) specified by addr to
addr2 in debugger memory. data must be 16 bytes. The request will get the value of the
pair of instruction or data breakpoint registers addr and addr+1 .
Note: These requests are not supported on PA-RISC versions of HP-UX.
TT_PROC_GET_ARGS
, TT_PROC_GET_ARGS_NOATTACH
These requests return a pointer to the argument list passed to the initial thread of the
process at execve() time (that is, argc, argv , envp ). If the target process has not
overwritten these arguments, this address can be used to retrieve the full argument and
environment list.
Note: These requests are not supported on PA-RISC versions of HP-UX.
Thread Requests
For all thread requests (those prefixed by
TT_LWP_), pid is the process id of the target process and lwpid
is the target thread within the target process.
TT_LWP_STOP
This request causes the thread identified by lwpid to stop executing. If the thread is
already stopped by the debugger ,orby an event , an error is returned.
The addr , data , and addr2 arguments must be zero.
TT_LWP_CONTINUE
This request causes the thread identified by lwpid to resume execution or, rather, to
return to the state it was in prior to being stopped by the debugger . If the thread had not
previously been stopped by the debugger, an error is returned.
If addr is not
TT_NOPC, that value is loaded in the program counter before execution is
resumed. Unexpected behavior will result if this value is not within the same function
since only the PC, not the context, is being modified.
If data is non-zero, it is expected to be a valid signal number and the thread will continue
as if it had received this signal.
The addr2 argument must be zero.
TT_LWP_SINGLE
This request causes the stopped thread identified by lwpid to resume execution for one
machine instruction. It causes a ag to be set so that an interrupt occurs upon the com-
pletion of one machine instruction, and then executes the same steps as listed above for
the TT_LWP_CONTINUE
request.
TT_LWP_TBRANCH
This request causes the stopped thread identified by lwpid to resume execution until a
taken branch instruction is executed. It causes a flag to be set so that an interrupt occurs
upon completion of the next taken branch instruction, and then executes the same steps
as listed above for the TT_LWP_CONTINUE request.
Note: This request is not supported on PA-RISC versions of HP-UX.
TT_LWP_GET_EVENT_MASK
This request is the same as TT_PROC_GET_EVENT_MASK except for the thread
identified by lwpid .
TT_LWP_SET_EVENT_MASK
This request is the same as TT_PROC_SET_EVENT_MASK except for the thread
identified by lwpid .
TT_LWP_GET_SIGMASK
This request is the same as TT_PROC_GET_SIGMASK except for the thread identified by
lwpid.
TT_LWP_SET_SIGMASK
This request is the same as TT_PROC_SET_SIGMASK except for the thread identified by
lwpid.
8 Hewlett-Packard Company 8 HP-UX 11i Version 3: September 2010