libipt-sys 0.1.1

raw bindings to the libipt intel processor tracing library
Documentation
; Copyright (c) 2018-2019, Intel Corporation
;
; Redistribution and use in source and binary forms, with or without
; modification, are permitted provided that the following conditions are met:
;
;  * Redistributions of source code must retain the above copyright notice,
;    this list of conditions and the following disclaimer.
;  * Redistributions in binary form must reproduce the above copyright notice,
;    this list of conditions and the following disclaimer in the documentation
;    and/or other materials provided with the distribution.
;  * Neither the name of Intel Corporation nor the names of its contributors
;    may be used to endorse or promote products derived from this software
;    without specific prior written permission.
;
; THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
; IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
; ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
; LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
; CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
; SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
; INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
; CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
; ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
; POSSIBILITY OF SUCH DAMAGE.

; Test MTC and CYC-based timing and OVF.
;
; Variant: calibration preserved on OVF.
;
; opt:ptdump --time --time-delta --keep-tcal-on-ovf
; opt:ptdump --mtc-freq 4 --cpuid-0x15.eax 1 --cpuid-0x15.ebx 4
;
; opt:ptxed --event:tick --event:time
; opt:ptxed --mtc-freq 4 --cpuid-0x15.eax 1 --cpuid-0x15.ebx 4
; opt:ptxed --insn:keep-tcal-on-ovf --block:keep-tcal-on-ovf

org 0x100000
bits 64

; @pt p0:  psb()
; @pt p1:  mode.exec(64bit)
; @pt p2:  fup(3: %l0)
; @pt p3:  tsc(0x1000)
; @pt p4:  tma(0x10, 0x40)
; @pt p5:  psbend()
l0: nop

; @pt p6:  mtc(0x2)
; @pt p7:  cyc(0x100)
; @pt p8:  mtc(0x3)

; @pt p9:  cyc(0x80)
; @pt p10: tnt(t)
l1: jne l3
l2: hlt

; @pt p11: cyc(0x80)
; @pt p12: mtc(0x4)

; @pt p13: ovf()
; @pt p14: fup(3: %l3)
l3: nop

; @pt p15: cyc(0x80)
; @pt p16: tnt(t)
l4: jne l6
l5: hlt

l6: nop
l7: hlt
; @pt p17: cyc(0x80)
; @pt p18: fup(1: %l7)
; @pt p19: tip.pgd(0: %l7)


; @pt .exp(ptdump)
;%0p0   psb
;%0p1   mode.exec   cs.l
;%0p2   fup         3: %?l0
;%0p3   tsc         1000      tsc +1000
;%0p4   tma         10, 40    tsc +0
;%0p5   psbend
;%0p6   mtc 2                 tsc +0
;[%p7: calibration error: no timing information]
;[%p7: error updating time: no calibration]
;%0p7   cyc 100               tsc +0
;%0p8   mtc 3                 tsc +40
;%0p9   cyc 80                tsc +20
;%0p10  tnt.8       !
;%0p11  cyc 80                tsc +20
;%0p12  mtc 4                 tsc +0
;%0p13  ovf
;%0p14  fup         3: %?l3
;%0p15  cyc 80                tsc +20
;%0p16  tnt.8       !
;%0p17  cyc 80                tsc +20
;%0p18  fup         1: %?l7.2
;%0p19  tip.pgd 0: %?l7.0


; @pt .exp(ptxed)
;%0l0 # nop
;%0l1 # jne l3
;[0000000000001060  tick]
;[0000000000001080  overflow]
;%0l3 # nop
;%0l4 # jne l6
;[00000000000010a0  tick]
;%0l6 # nop
;[00000000000010c0  disabled]