1PT_QRY_GET_OFFSET(3)                                      PT_QRY_GET_OFFSET(3)
2
3
4

NAME

6       pt_qry_get_offset,  pt_qry_get_sync_offset  - get an Intel(R) Processor
7       Trace query decoder’s current/synchronization trace buffer offset
8

SYNOPSIS

10       #include <intel-pt.h>
11       int pt_qry_get_offset(const struct pt_query_decoder *decoder,
12                             uint64_t *offset);
13       int pt_qry_get_sync_offset(const struct pt_query_decoder *decoder,
14                                  uint64_t *offset);
15
16       Link with -lipt.
17

DESCRIPTION

19       pt_qry_get_offset() provides decoder’s current position  as  offset  in
20       bytes  from the beginning of decoder’s trace buffer in the unsigned in‐
21       teger variable pointed to by offset.
22
23       pt_qry_get_sync_offset() provides decoder’s last synchronization  point
24       as  offset in bytes from the beginning of decoder’s trace buffer in the
25       unsigned integer variable pointed to by offset.
26

RETURN VALUE

28       Both functions return zero on success or a negative pt_error_code  enu‐
29       meration constant in case of an error.
30

ERRORS

32       pte_invalid
33              The decoder or offset argument is NULL.
34
35       pte_nosync
36              decoder  has  not  been synchronized onto the trace stream.  Use
37              pt_qry_sync_forward(3),       pt_qry_sync_backward(3),        or
38              pt_qry_sync_set(3) to synchronize decoder.
39

SEE ALSO

41       pt_qry_alloc_decoder(3),    pt_qry_free_decoder(3),    pt_qry_sync_for‐
42       ward(3), pt_qry_sync_backward(3),  pt_qry_sync_set(3),  pt_qry_get_con‐
43       fig(3),        pt_qry_cond_branch(3),        pt_qry_indirect_branch(3),
44       pt_qry_event(3), pt_qry_time(3), pt_qry_core_bus_ratio(3)
45
46
47
48                                                          PT_QRY_GET_OFFSET(3)
Impressum