ttrace.2 (2010 09)

t
ttrace(2) ttrace(2)
process specified by pid. The lwpid argument must be 0 (zero).
The addr argument points to an array of up to
TT_VEC_MAX tt_vec_ts, in the calling
process’s address space. Each contains a request to be performed and the corresponding
arguments. The
tt_vec_t contains at least the following fields:
Name Type Description
Request (Limited to:
TT_LWP_STOP,
TT_LWP_CONTINUE,
TT_LWP_RUREGS,
TT_LWP_WUREGS)
ttv_req ttreq_t
Light-Weight Process (thread) ID
specifying a valid thread within
the target process on which to per-
form request ttv_req
ttv_lwpid lwpid_t
ttv_addr uint64_t addr argument to request ttv_req
ttv_data uint64_t data argument to request ttv_req
ttv_addr2 uint64_t addr2 argument to request ttv_req
The array of
tt_vec_ts must be cleared (for example, with bzero()) prior to filling in
the fields listed above. (The names of fields in this structure, other than those listed
above, (if any) are subject to change without notice.)
See the descriptions of the individual requests for details of the addr, data and addr2
arguments required for each.
The data argument specifies the number of request elements in the array pointed to by
addr.
The addr2 argument points to a location in the calling process’s address space containing
a single
tt_vec_res_t. The tt_vec_res_t contains at least the following fields:
Name Type Description
Points to an 8-byte location
in the calling process’s
address space into which
the count of successful
requests will be written.
ttvr_count uint64_t
Points to an array of at
least data 8-byte elements
in the calling process’s
address space into which
the return values of the
individual requests (if any)
will be written.
ttvr_ret1 uint64_t
The tt_vec_res_t must be cleared (for example, with bzero()) prior to filling in
the fields listed above.
On return, ttvr_count will contain the number of requests from the array pointed to by
addr which succeeded.
TT_VEC_GENERIC stops processing requests from the array
upon encountering an error.
The first ttvr_count elements of the array pointed to by ttvr_ret1 will be filled in with the
return values of the corresponding requests. Although none of the requests supported by
TT_VEC_GENERIC at this time produce return values, additional requests which pro-
duce return values may be supported in the future.
12 Hewlett-Packard Company − 12 − HP-UX 11i Version 3: September 2010