perfmon_pebs_smpl.h

Go to the documentation of this file.

/*
 * Copyright (c) 2009 Google, Inc
 * Contributed by Stephane Eranian <eranian@gmail.com>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of version 2 of the GNU General Public
 * License as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
 * 02111-1307 USA
 *
 */
#ifndef __PERFMON_PEBS_SMPL_H__
#define __PERFMON_PEBS_SMPL_H__ 1

/*
 * The 32-bit and 64-bit formats are identical, thus we use only
 * one name for the format.
 */
#define PFM_PEBS_SMPL_NAME      "pebs"

#define PFM_PEBS_NUM_CNT_RESET  8
/*
 * format specific parameters (passed at context creation)
 *
 * intr_thres: index from start of buffer of entry where the
 * PMU interrupt must be triggered. It must be several samples
 * short of the end of the buffer.
 */
typedef struct {
        uint64_t buf_size;              /* size of the PEBS buffer in bytes */
        uint64_t cnt_reset[PFM_PEBS_NUM_CNT_RESET];/* counter reset values */
        uint64_t reserved2[23];         /* for future use */
} pfm_pebs_smpl_arg_t;

/*
 * This header is at the beginning of the sampling buffer returned to the user.
 *
 * Because of PEBS alignement constraints, the actual PEBS buffer area does
 * not necessarily begin right after the header. The hdr_start_offs must be
 * used to compute the first byte of the buffer. The offset is defined as
 * the number of bytes between the end of the header and the beginning of
 * the buffer. As such the formula is:
 *      actual_buffer = (unsigned long)(hdr+1)+hdr->hdr_start_offs
 */
typedef struct {
        uint64_t overflows;             /* #overflows for buffer */
        uint64_t count;                 /* number of valid samples */
        uint64_t buf_size;              /* total buffer size */
        uint64_t pebs_size;             /* pebs buffer size */
        uint32_t version;               /* smpl format version */
        uint32_t entry_size;            /* pebs sample size */
        uint64_t reserved2[11];         /* for future use */
} pfm_pebs_smpl_hdr_t;

/*
 * Sample format as mandated by Intel documentation.
 * The same format is used in both 32 and 64 bit modes.
 */
typedef struct {
        uint64_t        eflags;
        uint64_t        ip;
        uint64_t        eax;
        uint64_t        ebx;
        uint64_t        ecx;
        uint64_t        edx;
        uint64_t        esi;
        uint64_t        edi;
        uint64_t        ebp;
        uint64_t        esp;
        uint64_t        r8;     /* 0 in 32-bit mode */
        uint64_t        r9;     /* 0 in 32-bit mode */
        uint64_t        r10;    /* 0 in 32-bit mode */
        uint64_t        r11;    /* 0 in 32-bit mode */
        uint64_t        r12;    /* 0 in 32-bit mode */
        uint64_t        r13;    /* 0 in 32-bit mode */
        uint64_t        r14;    /* 0 in 32-bit mode */
        uint64_t        r15;    /* 0 in 32-bit mode */
} pfm_pebs_core_smpl_entry_t; 

/*
 * Sample format as mandated by Intel documentation.
 * The same format is used in both 32 and 64 bit modes.
 */
typedef struct {
        uint64_t        eflags;
        uint64_t        ip;
        uint64_t        eax;
        uint64_t        ebx;
        uint64_t        ecx;
        uint64_t        edx;
        uint64_t        esi;
        uint64_t        edi;
        uint64_t        ebp;
        uint64_t        esp;
        uint64_t        r8;     /* 0 in 32-bit mode */
        uint64_t        r9;     /* 0 in 32-bit mode */
        uint64_t        r10;    /* 0 in 32-bit mode */
        uint64_t        r11;    /* 0 in 32-bit mode */
        uint64_t        r12;    /* 0 in 32-bit mode */
        uint64_t        r13;    /* 0 in 32-bit mode */
        uint64_t        r14;    /* 0 in 32-bit mode */
        uint64_t        r15;    /* 0 in 32-bit mode */
        uint64_t        ia32_perf_global_status;
        uint64_t        daddr;
        uint64_t        dsrc_enc;
        uint64_t        latency;
} pfm_pebs_nhm_smpl_entry_t; 

/*
 * 64-bit PEBS record format is described in
 * http://www.intel.com/technology/64bitextensions/30083502.pdf
 *
 * The format does not peek at samples. The sample structure is only
 * used to ensure that the buffer is large enough to accomodate one
 * sample.
 */
#ifdef __i386__
typedef struct {
        uint32_t        eflags;
        uint32_t        ip;
        uint32_t        eax;
        uint32_t        ebx;
        uint32_t        ecx;
        uint32_t        edx;
        uint32_t        esi;
        uint32_t        edi;
        uint32_t        ebp;
        uint32_t        esp;
} pfm_pebs_p4_smpl_entry_t;
#else
typedef struct {
        uint64_t        eflags;
        uint64_t        ip;
        uint64_t        eax;
        uint64_t        ebx;
        uint64_t        ecx;
        uint64_t        edx;
        uint64_t        esi;
        uint64_t        edi;
        uint64_t        ebp;
        uint64_t        esp;
        uint64_t        r8;
        uint64_t        r9;
        uint64_t        r10;
        uint64_t        r11;
        uint64_t        r12;
        uint64_t        r13;
        uint64_t        r14;
        uint64_t        r15;
} pfm_pebs_p4_smpl_entry_t;
#endif

#define PFM_PEBS_SMPL_VERSION_MAJ 1U
#define PFM_PEBS_SMPL_VERSION_MIN 0U
#define PFM_PEBS_SMPL_VERSION (((PFM_PEBS_SMPL_VERSION_MAJ&0xffff)<<16)|\
                                   (PFM_PEBS_SMPL_VERSION_MIN & 0xffff))

#endif /* __PERFMON_PEBS_SMPL_H__ */