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.

; SKL168: Intel(R) PT CYC Packets Can be Dropped When Immediately Preceding PSB
;
;         Due to a rare microarchitectural condition, generation of an Intel PT
;         (Processor Trace) PSB (Packet Stream Boundary) packet can cause a
;         single CYC (Cycle Count) packet, possibly along with an associated
;         MTC (Mini Time Counter) packet, to be dropped.
;
; Variant: MTC and corresponding CYC packet dropped
;
; opt:ptdump --tcal --time-delta
; opt:ptdump --mtc-freq 4 --cpuid-0x15.eax 1 --cpuid-0x15.ebx 4
;
;   cpu 6/78
;   cpu 6/94
;   cpu 6/142
;   cpu 6/158
;

org 0x100000
bits 64

; @pt p1:  psb()
; @pt p2:  psbend()

; @pt p3:  mtc(0x1)
; @pt p4:  cyc(0x100)
; @pt p5:  mtc(0x2)
; @pt p6:  cyc(0x80)
; @pt p7:  psb()
; @pt p8:  psbend()
; @pt p9:  cyc(0x100)
; @pt p10: mtc(0x4)
; @pt p11: cyc(0x100)
; @pt p12: mtc(0x5)


; @pt .exp(ptdump)
;%0p1   psb
;%0p2   psbend
;[%p3: error printing time: no timing information]
;%0p3   mtc 1           fcr <unavailable>
;[%p4: calibration error: no timing information]
;[%p4: error updating time: no calibration]
;%0p4   cyc 100
;%0p5   mtc 2           fcr +0.250
;%0p6   cyc 80
;%0p7   psb
;%0p8   psbend
;%0p9   cyc 100
;%0p10  mtc 4           fcr +0.000
;%0p11  cyc 100
;%0p12  mtc 5           fcr +0.000