Annotation of Gnu-Mach/xen/public/trace.h, revision 1.1.1.1

1.1       root        1: /******************************************************************************
                      2:  * include/public/trace.h
                      3:  * 
                      4:  * Permission is hereby granted, free of charge, to any person obtaining a copy
                      5:  * of this software and associated documentation files (the "Software"), to
                      6:  * deal in the Software without restriction, including without limitation the
                      7:  * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
                      8:  * sell copies of the Software, and to permit persons to whom the Software is
                      9:  * furnished to do so, subject to the following conditions:
                     10:  *
                     11:  * The above copyright notice and this permission notice shall be included in
                     12:  * all copies or substantial portions of the Software.
                     13:  *
                     14:  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
                     15:  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
                     16:  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
                     17:  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
                     18:  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
                     19:  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
                     20:  * DEALINGS IN THE SOFTWARE.
                     21:  *
                     22:  * Mark Williamson, (C) 2004 Intel Research Cambridge
                     23:  * Copyright (C) 2005 Bin Ren
                     24:  */
                     25: 
                     26: #ifndef __XEN_PUBLIC_TRACE_H__
                     27: #define __XEN_PUBLIC_TRACE_H__
                     28: 
                     29: #define TRACE_EXTRA_MAX    7
                     30: #define TRACE_EXTRA_SHIFT 28
                     31: 
                     32: /* Trace classes */
                     33: #define TRC_CLS_SHIFT 16
                     34: #define TRC_GEN      0x0001f000    /* General trace            */
                     35: #define TRC_SCHED    0x0002f000    /* Xen Scheduler trace      */
                     36: #define TRC_DOM0OP   0x0004f000    /* Xen DOM0 operation trace */
                     37: #define TRC_HVM      0x0008f000    /* Xen HVM trace            */
                     38: #define TRC_MEM      0x0010f000    /* Xen memory trace         */
                     39: #define TRC_PV       0x0020f000    /* Xen PV traces            */
                     40: #define TRC_SHADOW   0x0040f000    /* Xen shadow tracing       */
                     41: #define TRC_PM       0x0080f000    /* Xen power management trace */
                     42: #define TRC_ALL      0x0ffff000
                     43: #define TRC_HD_TO_EVENT(x) ((x)&0x0fffffff)
                     44: #define TRC_HD_CYCLE_FLAG (1UL<<31)
                     45: #define TRC_HD_INCLUDES_CYCLE_COUNT(x) ( !!( (x) & TRC_HD_CYCLE_FLAG ) )
                     46: #define TRC_HD_EXTRA(x)    (((x)>>TRACE_EXTRA_SHIFT)&TRACE_EXTRA_MAX)
                     47: 
                     48: /* Trace subclasses */
                     49: #define TRC_SUBCLS_SHIFT 12
                     50: 
                     51: /* trace subclasses for SVM */
                     52: #define TRC_HVM_ENTRYEXIT 0x00081000   /* VMENTRY and #VMEXIT       */
                     53: #define TRC_HVM_HANDLER   0x00082000   /* various HVM handlers      */
                     54: 
                     55: #define TRC_SCHED_MIN       0x00021000   /* Just runstate changes */
                     56: #define TRC_SCHED_VERBOSE   0x00028000   /* More inclusive scheduling */
                     57: 
                     58: /* Trace events per class */
                     59: #define TRC_LOST_RECORDS        (TRC_GEN + 1)
                     60: #define TRC_TRACE_WRAP_BUFFER  (TRC_GEN + 2)
                     61: #define TRC_TRACE_CPU_CHANGE    (TRC_GEN + 3)
                     62: 
                     63: #define TRC_SCHED_RUNSTATE_CHANGE (TRC_SCHED_MIN + 1)
                     64: #define TRC_SCHED_DOM_ADD        (TRC_SCHED_VERBOSE +  1)
                     65: #define TRC_SCHED_DOM_REM        (TRC_SCHED_VERBOSE +  2)
                     66: #define TRC_SCHED_SLEEP          (TRC_SCHED_VERBOSE +  3)
                     67: #define TRC_SCHED_WAKE           (TRC_SCHED_VERBOSE +  4)
                     68: #define TRC_SCHED_YIELD          (TRC_SCHED_VERBOSE +  5)
                     69: #define TRC_SCHED_BLOCK          (TRC_SCHED_VERBOSE +  6)
                     70: #define TRC_SCHED_SHUTDOWN       (TRC_SCHED_VERBOSE +  7)
                     71: #define TRC_SCHED_CTL            (TRC_SCHED_VERBOSE +  8)
                     72: #define TRC_SCHED_ADJDOM         (TRC_SCHED_VERBOSE +  9)
                     73: #define TRC_SCHED_SWITCH         (TRC_SCHED_VERBOSE + 10)
                     74: #define TRC_SCHED_S_TIMER_FN     (TRC_SCHED_VERBOSE + 11)
                     75: #define TRC_SCHED_T_TIMER_FN     (TRC_SCHED_VERBOSE + 12)
                     76: #define TRC_SCHED_DOM_TIMER_FN   (TRC_SCHED_VERBOSE + 13)
                     77: #define TRC_SCHED_SWITCH_INFPREV (TRC_SCHED_VERBOSE + 14)
                     78: #define TRC_SCHED_SWITCH_INFNEXT (TRC_SCHED_VERBOSE + 15)
                     79: 
                     80: #define TRC_MEM_PAGE_GRANT_MAP      (TRC_MEM + 1)
                     81: #define TRC_MEM_PAGE_GRANT_UNMAP    (TRC_MEM + 2)
                     82: #define TRC_MEM_PAGE_GRANT_TRANSFER (TRC_MEM + 3)
                     83: 
                     84: #define TRC_PV_HYPERCALL             (TRC_PV +  1)
                     85: #define TRC_PV_TRAP                  (TRC_PV +  3)
                     86: #define TRC_PV_PAGE_FAULT            (TRC_PV +  4)
                     87: #define TRC_PV_FORCED_INVALID_OP     (TRC_PV +  5)
                     88: #define TRC_PV_EMULATE_PRIVOP        (TRC_PV +  6)
                     89: #define TRC_PV_EMULATE_4GB           (TRC_PV +  7)
                     90: #define TRC_PV_MATH_STATE_RESTORE    (TRC_PV +  8)
                     91: #define TRC_PV_PAGING_FIXUP          (TRC_PV +  9)
                     92: #define TRC_PV_GDT_LDT_MAPPING_FAULT (TRC_PV + 10)
                     93: #define TRC_PV_PTWR_EMULATION        (TRC_PV + 11)
                     94: #define TRC_PV_PTWR_EMULATION_PAE    (TRC_PV + 12)
                     95:   /* Indicates that addresses in trace record are 64 bits */
                     96: #define TRC_64_FLAG               (0x100) 
                     97: 
                     98: #define TRC_SHADOW_NOT_SHADOW                 (TRC_SHADOW +  1)
                     99: #define TRC_SHADOW_FAST_PROPAGATE             (TRC_SHADOW +  2)
                    100: #define TRC_SHADOW_FAST_MMIO                  (TRC_SHADOW +  3)
                    101: #define TRC_SHADOW_FALSE_FAST_PATH            (TRC_SHADOW +  4)
                    102: #define TRC_SHADOW_MMIO                       (TRC_SHADOW +  5)
                    103: #define TRC_SHADOW_FIXUP                      (TRC_SHADOW +  6)
                    104: #define TRC_SHADOW_DOMF_DYING                 (TRC_SHADOW +  7)
                    105: #define TRC_SHADOW_EMULATE                    (TRC_SHADOW +  8)
                    106: #define TRC_SHADOW_EMULATE_UNSHADOW_USER      (TRC_SHADOW +  9)
                    107: #define TRC_SHADOW_EMULATE_UNSHADOW_EVTINJ    (TRC_SHADOW + 10)
                    108: #define TRC_SHADOW_EMULATE_UNSHADOW_UNHANDLED (TRC_SHADOW + 11)
                    109: #define TRC_SHADOW_WRMAP_BF                   (TRC_SHADOW + 12)
                    110: #define TRC_SHADOW_PREALLOC_UNPIN             (TRC_SHADOW + 13)
                    111: #define TRC_SHADOW_RESYNC_FULL                (TRC_SHADOW + 14)
                    112: #define TRC_SHADOW_RESYNC_ONLY                (TRC_SHADOW + 15)
                    113: 
                    114: /* trace events per subclass */
                    115: #define TRC_HVM_VMENTRY         (TRC_HVM_ENTRYEXIT + 0x01)
                    116: #define TRC_HVM_VMEXIT          (TRC_HVM_ENTRYEXIT + 0x02)
                    117: #define TRC_HVM_VMEXIT64        (TRC_HVM_ENTRYEXIT + TRC_64_FLAG + 0x02)
                    118: #define TRC_HVM_PF_XEN          (TRC_HVM_HANDLER + 0x01)
                    119: #define TRC_HVM_PF_XEN64        (TRC_HVM_HANDLER + TRC_64_FLAG + 0x01)
                    120: #define TRC_HVM_PF_INJECT       (TRC_HVM_HANDLER + 0x02)
                    121: #define TRC_HVM_PF_INJECT64     (TRC_HVM_HANDLER + TRC_64_FLAG + 0x02)
                    122: #define TRC_HVM_INJ_EXC         (TRC_HVM_HANDLER + 0x03)
                    123: #define TRC_HVM_INJ_VIRQ        (TRC_HVM_HANDLER + 0x04)
                    124: #define TRC_HVM_REINJ_VIRQ      (TRC_HVM_HANDLER + 0x05)
                    125: #define TRC_HVM_IO_READ         (TRC_HVM_HANDLER + 0x06)
                    126: #define TRC_HVM_IO_WRITE        (TRC_HVM_HANDLER + 0x07)
                    127: #define TRC_HVM_CR_READ         (TRC_HVM_HANDLER + 0x08)
                    128: #define TRC_HVM_CR_READ64       (TRC_HVM_HANDLER + TRC_64_FLAG + 0x08)
                    129: #define TRC_HVM_CR_WRITE        (TRC_HVM_HANDLER + 0x09)
                    130: #define TRC_HVM_CR_WRITE64      (TRC_HVM_HANDLER + TRC_64_FLAG + 0x09)
                    131: #define TRC_HVM_DR_READ         (TRC_HVM_HANDLER + 0x0A)
                    132: #define TRC_HVM_DR_WRITE        (TRC_HVM_HANDLER + 0x0B)
                    133: #define TRC_HVM_MSR_READ        (TRC_HVM_HANDLER + 0x0C)
                    134: #define TRC_HVM_MSR_WRITE       (TRC_HVM_HANDLER + 0x0D)
                    135: #define TRC_HVM_CPUID           (TRC_HVM_HANDLER + 0x0E)
                    136: #define TRC_HVM_INTR            (TRC_HVM_HANDLER + 0x0F)
                    137: #define TRC_HVM_NMI             (TRC_HVM_HANDLER + 0x10)
                    138: #define TRC_HVM_SMI             (TRC_HVM_HANDLER + 0x11)
                    139: #define TRC_HVM_VMMCALL         (TRC_HVM_HANDLER + 0x12)
                    140: #define TRC_HVM_HLT             (TRC_HVM_HANDLER + 0x13)
                    141: #define TRC_HVM_INVLPG          (TRC_HVM_HANDLER + 0x14)
                    142: #define TRC_HVM_INVLPG64        (TRC_HVM_HANDLER + TRC_64_FLAG + 0x14)
                    143: #define TRC_HVM_MCE             (TRC_HVM_HANDLER + 0x15)
                    144: #define TRC_HVM_IO_ASSIST       (TRC_HVM_HANDLER + 0x16)
                    145: #define TRC_HVM_IO_ASSIST64     (TRC_HVM_HANDLER + TRC_64_FLAG + 0x16)
                    146: #define TRC_HVM_MMIO_ASSIST     (TRC_HVM_HANDLER + 0x17)
                    147: #define TRC_HVM_MMIO_ASSIST64   (TRC_HVM_HANDLER + TRC_64_FLAG + 0x17)
                    148: #define TRC_HVM_CLTS            (TRC_HVM_HANDLER + 0x18)
                    149: #define TRC_HVM_LMSW            (TRC_HVM_HANDLER + 0x19)
                    150: #define TRC_HVM_LMSW64          (TRC_HVM_HANDLER + TRC_64_FLAG + 0x19)
                    151: 
                    152: /* trace subclasses for power management */
                    153: #define TRC_PM_FREQ     0x00801000      /* xen cpu freq events */
                    154: #define TRC_PM_IDLE     0x00802000      /* xen cpu idle events */
                    155: 
                    156: /* trace events for per class */
                    157: #define TRC_PM_FREQ_CHANGE      (TRC_PM_FREQ + 0x01)
                    158: #define TRC_PM_IDLE_ENTRY       (TRC_PM_IDLE + 0x01)
                    159: #define TRC_PM_IDLE_EXIT        (TRC_PM_IDLE + 0x02)
                    160: 
                    161: /* This structure represents a single trace buffer record. */
                    162: struct t_rec {
                    163:     uint32_t event:28;
                    164:     uint32_t extra_u32:3;         /* # entries in trailing extra_u32[] array */
                    165:     uint32_t cycles_included:1;   /* u.cycles or u.no_cycles? */
                    166:     union {
                    167:         struct {
                    168:             uint32_t cycles_lo, cycles_hi; /* cycle counter timestamp */
                    169:             uint32_t extra_u32[7];         /* event data items */
                    170:         } cycles;
                    171:         struct {
                    172:             uint32_t extra_u32[7];         /* event data items */
                    173:         } nocycles;
                    174:     } u;
                    175: };
                    176: 
                    177: /*
                    178:  * This structure contains the metadata for a single trace buffer.  The head
                    179:  * field, indexes into an array of struct t_rec's.
                    180:  */
                    181: struct t_buf {
                    182:     /* Assume the data buffer size is X.  X is generally not a power of 2.
                    183:      * CONS and PROD are incremented modulo (2*X):
                    184:      *     0 <= cons < 2*X
                    185:      *     0 <= prod < 2*X
                    186:      * This is done because addition modulo X breaks at 2^32 when X is not a
                    187:      * power of 2:
                    188:      *     (((2^32 - 1) % X) + 1) % X != (2^32) % X
                    189:      */
                    190:     uint32_t cons;   /* Offset of next item to be consumed by control tools. */
                    191:     uint32_t prod;   /* Offset of next item to be produced by Xen.           */
                    192:     /*  Records follow immediately after the meta-data header.    */
                    193: };
                    194: 
                    195: #endif /* __XEN_PUBLIC_TRACE_H__ */
                    196: 
                    197: /*
                    198:  * Local variables:
                    199:  * mode: C
                    200:  * c-set-style: "BSD"
                    201:  * c-basic-offset: 4
                    202:  * tab-width: 4
                    203:  * indent-tabs-mode: nil
                    204:  * End:
                    205:  */
                    206:  */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.