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$
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(enum pmc_caps _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