pmc.h revision 226514
1/*- 2 * Copyright (c) 2003,2004 Joseph Koshy 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24 * SUCH DAMAGE. 25 * 26 * $FreeBSD: head/lib/libpmc/pmc.h 226514 2011-10-18 15:25:43Z fabient $ 27 */ 28 29#ifndef _PMC_H_ 30#define _PMC_H_ 31 32#include <sys/cdefs.h> 33#include <sys/pmc.h> 34 35/* 36 * Driver statistics. 37 */ 38struct pmc_driverstats { 39 int pm_intr_ignored; /* #interrupts ignored */ 40 int pm_intr_processed; /* #interrupts processed */ 41 int pm_intr_bufferfull; /* #interrupts with ENOSPC */ 42 int pm_syscalls; /* #syscalls */ 43 int pm_syscall_errors; /* #syscalls with errors */ 44 int pm_buffer_requests; /* #buffer requests */ 45 int pm_buffer_requests_failed; /* #failed buffer requests */ 46 int pm_log_sweeps; /* #sample buffer processing passes */ 47}; 48 49/* 50 * CPU information. 51 */ 52struct pmc_cpuinfo { 53 enum pmc_cputype pm_cputype; /* the kind of CPU */ 54 uint32_t pm_ncpu; /* number of CPUs */ 55 uint32_t pm_npmc; /* #PMCs per CPU */ 56 uint32_t pm_nclass; /* #classes of PMCs */ 57 struct pmc_classinfo pm_classes[PMC_CLASS_MAX]; 58}; 59 60/* 61 * Current PMC state. 62 */ 63struct pmc_pmcinfo { 64 int32_t pm_cpu; /* CPU number */ 65 struct pmc_info pm_pmcs[]; /* NPMC structs */ 66}; 67 68/* 69 * Prototypes 70 */ 71 72__BEGIN_DECLS 73int pmc_allocate(const char *_ctrspec, enum pmc_mode _mode, uint32_t _flags, 74 int _cpu, pmc_id_t *_pmcid); 75int pmc_attach(pmc_id_t _pmcid, pid_t _pid); 76int pmc_capabilities(pmc_id_t _pmc, uint32_t *_caps); 77int pmc_configure_logfile(int _fd); 78int pmc_flush_logfile(void); 79int pmc_close_logfile(void); 80int pmc_detach(pmc_id_t _pmcid, pid_t _pid); 81int pmc_disable(int _cpu, int _pmc); 82int pmc_enable(int _cpu, int _pmc); 83int pmc_get_driver_stats(struct pmc_driverstats *_gms); 84int pmc_get_msr(pmc_id_t _pmc, uint32_t *_msr); 85int pmc_init(void); 86int pmc_read(pmc_id_t _pmc, pmc_value_t *_value); 87int pmc_release(pmc_id_t _pmc); 88int pmc_rw(pmc_id_t _pmc, pmc_value_t _newvalue, pmc_value_t *_oldvalue); 89int pmc_set(pmc_id_t _pmc, pmc_value_t _value); 90int pmc_start(pmc_id_t _pmc); 91int pmc_stop(pmc_id_t _pmc); 92int pmc_width(pmc_id_t _pmc, uint32_t *_width); 93int pmc_write(pmc_id_t _pmc, pmc_value_t _value); 94int pmc_writelog(uint32_t _udata); 95 96int pmc_ncpu(void); 97int pmc_npmc(int _cpu); 98int pmc_cpuinfo(const struct pmc_cpuinfo **_cpu_info); 99int pmc_pmcinfo(int _cpu, struct pmc_pmcinfo **_pmc_info); 100 101const char *pmc_name_of_capability(uint32_t _c); 102const char *pmc_name_of_class(enum pmc_class _pc); 103const char *pmc_name_of_cputype(enum pmc_cputype _cp); 104const char *pmc_name_of_disposition(enum pmc_disp _pd); 105const char *pmc_name_of_event(enum pmc_event _pe); 106const char *pmc_name_of_mode(enum pmc_mode _pm); 107const char *pmc_name_of_state(enum pmc_state _ps); 108 109int pmc_event_names_of_class(enum pmc_class _cl, const char ***_eventnames, 110 int *_nevents); 111__END_DECLS 112 113#endif 114