1PT_INSN_GET_OFFSET(3)                                    PT_INSN_GET_OFFSET(3)
2
3
4

NAME

6       pt_insn_get_offset, pt_insn_get_sync_offset - get an Intel(R) Processor
7       Trace instruction flow decoder’s current/synchronization  trace  buffer
8       offset
9

SYNOPSIS

11       #include <intel-pt.h>
12       int pt_insn_get_offset(const struct pt_insn_decoder *decoder,
13                              uint64_t *offset);
14       int pt_insn_get_sync_offset(const struct pt_insn_decoder *decoder,
15                                   uint64_t *offset);
16
17       Link with -lipt.
18

DESCRIPTION

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

RETURN VALUE

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

ERRORS

33       pte_invalid
34              The decoder or offset argument is NULL.
35
36       pte_nosync
37              decoder has not been synchronized onto the  trace  stream.   Use
38              pt_insn_sync_forward(3),   pt_insn_sync_backward(3),  or  pt_in‐
39              sn_sync_set(3) to synchronize decoder.
40

SEE ALSO

42       pt_insn_alloc_decoder(3),  pt_insn_free_decoder(3),   pt_insn_sync_for‐
43       ward(3),    pt_insn_sync_backward(3),    pt_insn_sync_set(3),    pt_in‐
44       sn_get_config(3),  pt_insn_time(3),  pt_insn_core_bus_ratio(3),  pt_in‐
45       sn_next(3)
46
47
48
49                                                         PT_INSN_GET_OFFSET(3)
Impressum