HP-UX Reference (11i v2 07/12) - 2 System Calls (vol 5)

t
ttrace(2) ttrace(2)
For this request, the lwpid argument must be set to zero.
TT_PROC_SET_SCBM
This request allows the debugger to pass a bitmap to the kernel indicating which system
calls should cause a debugger stop.
The addr argument must be set to
TTSCBM_SELECT or TTSCBM_UNSELECT
to indicate
whether the bitmap represents a positive (meaning that the calls in the bitmap will result
in a stop) or a negative (meaning that all calls except those in the bit map will result in a
stop) list.
The data argument is the size of the bitmap, in bytes. A size of zero indicates that the
current bitmap, if any, should be cleared.
The addr2 argument is the user address where the bitmap is located. If data is zero, this
value must be zero too.
The lwpid argument must be zero.
TT_PROC_EXIT
This request causes the traced process to terminate. It has the same consequence as
exit() being invoked by one of the process threads. The lwpid, addr, data, and addr2
arguments must be zero.
TT_PROC_CORE
This request causes the traced process to generate a core file without modifying the
process’s state. If addr is zero, the core file is created in the target process’s current work-
ing directory and is named core.pid; where, pid is the process ID of the target process. If
addr is non-zero, it is the address of a buffer containing the path of the core file to be
created. Up to
MAXPATHLEN bytes will be read from the buffer. If the path is not abso-
lute (not starting with a slash), it is relative to the target process’s current working direc-
tory. In both cases, the directory must exist and, if present, the file must be a regular file.
In all cases, the debugger’s credentials are used and standard permission checking applies.
The lwpid, data and addr2 arguments must be zero.
TT_PROC_GET_NUM_IBPT_REGS
TT_PROC_GET_NUM_DBPT_REGS
These requests return the number of physical hardware instruction or data breakpoint
registers that are available for use.
TT_PROC_SET_IBPT_REGS
TT_PROC_SET_DBPT_REGS
These requests write process-wide breakpoint values into breakpoint registers. data bytes
from addr2 will be written to the instruction or data breakpoint register(s) named by addr.
For Itanium-based systems, addr must be an even number less than the value returned by
TT_PROC_GET_NUM_IBPT_REGS
or TT_PROC_GET_NUM_DBPT_REGS
respectively.
data must be 16 bytes. The request will set a value into the pair of instruction or data
breakpoint registers addr and addr+1.
Note: The available breakpoint registers must be shared between process-wide breakpoints
and per-thread breakpoints. If a breakpoint register is currently being used as a per-thread
breakpoint in any thread within the target process, it may not be used for a process-wide
breakpoint.
Note: This does not limit the number of
break instructions that may be present in the
program text.
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
This request returns a pointer to the argument list passed to the initial thread of the
HP-UX 11i Version 2: December 2007 Update − 7 − Hewlett-Packard Company 487