2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2003,2004 Joseph Koshy
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 #include <sys/cdefs.h>
35 #include <sys/types.h>
41 struct pmc_driverstats {
42 unsigned int pm_intr_ignored; /* #interrupts ignored */
43 unsigned int pm_intr_processed; /* #interrupts processed */
44 unsigned int pm_intr_bufferfull; /* #interrupts with ENOSPC */
45 unsigned int pm_syscalls; /* #syscalls */
46 unsigned int pm_syscall_errors; /* #syscalls with errors */
47 unsigned int pm_buffer_requests; /* #buffer requests */
48 unsigned int pm_buffer_requests_failed; /* #failed buffer requests */
49 unsigned int pm_log_sweeps; /* #sample buffer processing
57 enum pmc_cputype pm_cputype; /* the kind of CPU */
58 uint32_t pm_ncpu; /* number of CPUs */
59 uint32_t pm_npmc; /* #PMCs per CPU */
60 uint32_t pm_nclass; /* #classes of PMCs */
61 struct pmc_classinfo pm_classes[PMC_CLASS_MAX];
68 int32_t pm_cpu; /* CPU number */
69 struct pmc_info pm_pmcs[]; /* NPMC structs */
77 int pmc_allocate(const char *_ctrspec, enum pmc_mode _mode, uint32_t _flags,
78 int _cpu, pmc_id_t *_pmcid, uint64_t count);
79 int pmc_attach(pmc_id_t _pmcid, pid_t _pid);
80 int pmc_capabilities(pmc_id_t _pmc, uint32_t *_caps);
81 int pmc_configure_logfile(int _fd);
82 int pmc_flush_logfile(void);
83 int pmc_close_logfile(void);
84 int pmc_detach(pmc_id_t _pmcid, pid_t _pid);
85 int pmc_disable(int _cpu, int _pmc);
86 int pmc_enable(int _cpu, int _pmc);
87 int pmc_get_driver_stats(struct pmc_driverstats *_gms);
88 int pmc_get_msr(pmc_id_t _pmc, uint32_t *_msr);
90 int pmc_read(pmc_id_t _pmc, pmc_value_t *_value);
91 int pmc_release(pmc_id_t _pmc);
92 int pmc_rw(pmc_id_t _pmc, pmc_value_t _newvalue, pmc_value_t *_oldvalue);
93 int pmc_set(pmc_id_t _pmc, pmc_value_t _value);
94 int pmc_start(pmc_id_t _pmc);
95 int pmc_stop(pmc_id_t _pmc);
96 int pmc_width(pmc_id_t _pmc, uint32_t *_width);
97 int pmc_write(pmc_id_t _pmc, pmc_value_t _value);
98 int pmc_writelog(uint32_t _udata);
101 int pmc_npmc(int _cpu);
102 int pmc_cpuinfo(const struct pmc_cpuinfo **_cpu_info);
103 int pmc_pmcinfo(int _cpu, struct pmc_pmcinfo **_pmc_info);
105 const char *pmc_name_of_capability(enum pmc_caps _c);
106 const char *pmc_name_of_class(enum pmc_class _pc);
107 const char *pmc_name_of_cputype(enum pmc_cputype _cp);
108 const char *pmc_name_of_disposition(enum pmc_disp _pd);
109 const char *pmc_name_of_event(enum pmc_event _pe);
110 const char *pmc_name_of_mode(enum pmc_mode _pm);
111 const char *pmc_name_of_state(enum pmc_state _ps);
113 int pmc_event_names_of_class(enum pmc_class _cl, const char ***_eventnames,
116 int pmc_pmu_enabled(void);
117 void pmc_pmu_print_counters(const char *);
118 void pmc_pmu_print_counter_desc(const char *);
119 void pmc_pmu_print_counter_desc_long(const char *);
120 void pmc_pmu_print_counter_full(const char *);
121 uint64_t pmc_pmu_sample_rate_get(const char *);
122 int pmc_pmu_pmcallocate(const char *, struct pmc_op_pmcallocate *);
123 const char *pmc_pmu_event_get_by_idx(const char *, int idx);
124 int pmc_pmu_idx_get_by_event(const char*, const char *);
125 int pmc_pmu_stat_mode(const char ***);