pfmlib_amd64.h

Go to the documentation of this file.

/*
 * AMD64 PMU specific types and definitions (64 and 32 bit modes)
 *
 * Copyright (c) 2005-2006 Hewlett-Packard Development Company, L.P.
 * Contributed by Stephane Eranian <eranian@hpl.hp.com>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
 * of the Software, and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
 * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
 * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
 * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
 * OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

#ifndef __PFMLIB_AMD64_H__
#define __PFMLIB_AMD64_H__

#include <stdint.h>

/*
 * privilege level mask usage for AMD64:
 *
 * PFM_PLM0 = OS (kernel, hypervisor, ..)
 * PFM_PLM1 = invalid parameters
 * PFM_PLM2 = invalid parameters
 * PFM_PLM3 = USR (user level)
 */

#ifdef __cplusplus
extern "C" {
#endif

#define PMU_AMD64_MAX_COUNTERS  4   /* total numbers of performance counters */

/*
 * AMD64 MSR definitions
 */

typedef union {
    uint64_t val;               /* complete register value */
    struct {
        uint64_t sel_event_mask:8;  /* event mask */
        uint64_t sel_unit_mask:8;   /* unit mask */
        uint64_t sel_usr:1;     /* user level */
        uint64_t sel_os:1;      /* system level */
        uint64_t sel_edge:1;        /* edge detec */
        uint64_t sel_pc:1;      /* pin control */
        uint64_t sel_int:1;     /* enable APIC intr */
        uint64_t sel_res1:1;        /* reserved */
        uint64_t sel_en:1;      /* enable */
        uint64_t sel_inv:1;     /* invert counter mask */
        uint64_t sel_cnt_mask:8;    /* counter mask */
        uint64_t sel_event_mask2:4; /* 10h only: event mask [11:8] */
        uint64_t sel_res2:4;        /* reserved */
        uint64_t sel_guest:1;       /* 10h only: guest only counter */
        uint64_t sel_host:1;        /* 10h only: host only counter */
        uint64_t sel_res3:22;       /* reserved */
    } perfsel;
} pfm_amd64_sel_reg_t; /* MSR 0xc001000-0xc001003 */

typedef union {
    uint64_t val;               /* complete register value */
    struct {
        uint64_t ctr_count:48;      /* 48-bit hardware counter  */
        uint64_t ctr_res1:16;       /* reserved */
    } perfctr;
} pfm_amd64_ctr_reg_t; /* MSR 0xc001004-0xc001007 */

typedef union {
    uint64_t val;               /* complete register value */
    struct {
        uint64_t ibsfetchmaxcnt:16;
        uint64_t ibsfetchcnt:16;
        uint64_t ibsfetchlat:16;
        uint64_t ibsfetchen:1;
        uint64_t ibsfetchval:1;
        uint64_t ibsfetchcomp:1;
        uint64_t ibsicmiss:1;
        uint64_t ibsphyaddrvalid:1;
        uint64_t ibsl1tlbpgsz:2;
        uint64_t ibsl1tlbmiss:1;
        uint64_t ibsl2tlbmiss:1;
        uint64_t ibsranden:1;
        uint64_t reserved:6;
    } reg;
} ibsfetchctl_t; /* MSR 0xc0011030 */

typedef union {
    uint64_t val;               /* complete register value */
    struct {
        uint64_t ibsopmaxcnt:16;
        uint64_t reserved1:1;
        uint64_t ibsopen:1;
        uint64_t ibsopval:1;
        uint64_t ibsopcntl:1;
        uint64_t reserved2:44;
    } reg;
} ibsopctl_t; /* MSR 0xc0011033 */

typedef union {
    uint64_t val;               /* complete register value */
    struct {
        uint64_t ibscomptoretctr:16;
        uint64_t ibstagtoretctr:16;
        uint64_t ibsopbrnresync:1;
        uint64_t ibsopmispreturn:1;
        uint64_t ibsopreturn:1;
        uint64_t ibsopbrntaken:1;
        uint64_t ibsopbrnmisp:1;
        uint64_t ibsopbrnret:1;
        uint64_t reserved:26;
    } reg;
} ibsopdata_t; /* MSR 0xc0011035 */

typedef union {
    uint64_t val;               /* complete register value */
    struct {
        uint64_t nbibsreqsrc:3;
        uint64_t reserved1:1;
        uint64_t nbibsreqdstproc:1;
        uint64_t nbibsreqcachehitst:1;
        uint64_t reserved2:58;
    } reg;
} ibsopdata2_t; /* MSR 0xc0011036 */

typedef union {
    uint64_t val;               /* complete register value */
    struct {
        uint64_t ibsldop:1;
        uint64_t ibsstop:1;
        uint64_t ibsdcl1tlbmiss:1;
        uint64_t ibsdcl2tlbmiss:1;
        uint64_t ibsdcl1tlbhit2m:1;
        uint64_t ibsdcl1tlbhit1g:1;
        uint64_t ibsdcl2tlbhit2m:1;
        uint64_t ibsdcmiss:1;
        uint64_t ibsdcmissacc:1;
        uint64_t ibsdcldbnkcon:1;
        uint64_t ibsdcstbnkcon:1;
        uint64_t ibsdcsttoldfwd:1;
        uint64_t ibsdcsttoldcan:1;
        uint64_t ibsdcucmemacc:1;
        uint64_t ibsdcwcmemacc:1;
        uint64_t ibsdclockedop:1;
        uint64_t ibsdcmabhit:1;
        uint64_t ibsdclinaddrvalid:1;
        uint64_t ibsdcphyaddrvalid:1;
        uint64_t reserved1:13;
        uint64_t ibsdcmisslat:16;
        uint64_t reserved2:16;
    } reg;
} ibsopdata3_t; /* MSR 0xc0011037 */

/*
 * AMD64 specific input parameters for the library
 */

typedef struct {
    uint32_t    cnt_mask;   /* threshold ([4-255] are reserved) */
    uint32_t    flags;      /* counter specific flag */
} pfmlib_amd64_counter_t;

#define PFM_AMD64_SEL_INV   0x1 /* inverse */
#define PFM_AMD64_SEL_EDGE  0x2 /* edge detect */
#define PFM_AMD64_SEL_GUEST 0x4 /* guest only */
#define PFM_AMD64_SEL_HOST  0x8 /* host only */

/*
 * IBS input parameters
 *
 * Maxcnt specifies the maximum count value of the periodic counter,
 * 20 bits, bits 3:0 are always set to zero.
 */
typedef struct {
    unsigned int maxcnt;
    unsigned int options;
} ibs_param_t;

/*
 * values for ibs_param_t.options
 */
#define IBS_OPTIONS_RANDEN 1    /* enable randomization (IBS fetch only) */
#define IBS_OPTIONS_UOPS   1    /* count dispatched uops (IBS op only) */

typedef struct {
    pfmlib_amd64_counter_t pfp_amd64_counters[PMU_AMD64_MAX_COUNTERS]; /* extended counter features */
    uint32_t    flags;      /* use flags */
    uint32_t    reserved1;  /* for future use */
        ibs_param_t ibsfetch;   /* IBS fetch control */
    ibs_param_t ibsop;      /* IBS execution control */
    uint64_t    reserved2;  /* for future use */
} pfmlib_amd64_input_param_t;

/* A bit mask, meaning multiple usage types may be defined */
#define PFMLIB_AMD64_USE_IBSFETCH   1
#define PFMLIB_AMD64_USE_IBSOP      2

/*
 * AMD64 specific output parameters for the library
 *
 * The values ibsfetch_base and ibsop_base pass back the index of the
 * ibsopctl and ibsfetchctl register in pfp_pmds[].
 */

typedef struct {
    uint32_t    ibsfetch_base;  /* Perfmon2 base register index */
    uint32_t    ibsop_base; /* Perfmon2 base register index */
    uint64_t    reserved[7];    /* for future use */
} pfmlib_amd64_output_param_t;

/* Perfmon2 registers relative to base register */
#define PMD_IBSFETCHCTL     0
#define PMD_IBSFETCHLINAD   1
#define PMD_IBSFETCHPHYSAD  2
#define PMD_IBSOPCTL        0
#define PMD_IBSOPRIP        1
#define PMD_IBSOPDATA       2
#define PMD_IBSOPDATA2      3
#define PMD_IBSOPDATA3      4
#define PMD_IBSDCLINAD      5
#define PMD_IBSDCPHYSAD     6

#ifdef __cplusplus /* extern C */
}
#endif

#endif /* __PFMLIB_AMD64_H__ */