2 * SPDX-License-Identifier: BSD-2-Clause
4 * Copyright (c) 2005-2007 Joseph Koshy
5 * Copyright (c) 2007 The FreeBSD Foundation
8 * Portions of this software were developed by A. Joseph Koshy under
9 * sponsorship from the FreeBSD Foundation and Google, Inc.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
20 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 #include <sys/cdefs.h>
37 #include <sys/pmclog.h>
46 struct pmclog_ev_callchain {
51 uint32_t pl_cpuflags2;
53 uintfptr_t pl_pc[PMC_CALLCHAIN_DEPTH_MAX];
56 struct pmclog_ev_dropnotify {
59 struct pmclog_ev_closelog {
62 struct pmclog_ev_initialize {
66 struct timespec pl_ts;
67 char pl_cpuid[PATH_MAX];
70 struct pmclog_ev_map_in {
73 char pl_pathname[PATH_MAX];
76 struct pmclog_ev_map_out {
82 struct pmclog_ev_pcsample {
91 struct pmclog_ev_pmcallocate {
92 const char * pl_evname;
99 struct pmclog_ev_pmcallocatedyn {
100 char pl_evname[PMC_NAME_MAX];
106 struct pmclog_ev_pmcattach {
109 char pl_pathname[PATH_MAX];
112 struct pmclog_ev_pmcdetach {
117 struct pmclog_ev_proccsw {
121 pmc_value_t pl_value;
124 struct pmclog_ev_proccreate {
127 char pl_pcomm[MAXCOMLEN+1];
130 struct pmclog_ev_procexec {
133 uintptr_t pl_baseaddr;
134 uintptr_t pl_dynaddr;
135 char pl_pathname[PATH_MAX];
138 struct pmclog_ev_procexit {
141 pmc_value_t pl_value;
144 struct pmclog_ev_procfork {
149 struct pmclog_ev_sysexit {
153 struct pmclog_ev_threadcreate {
157 char pl_tdname[MAXCOMLEN+1];
160 struct pmclog_ev_threadexit {
164 struct pmclog_ev_userdata {
165 uint32_t pl_userdata;
169 enum pmclog_state pl_state; /* state after 'get_event()' */
170 off_t pl_offset; /* byte offset in stream */
171 size_t pl_count; /* count of records so far */
172 struct timespec pl_ts; /* log entry timestamp */
173 enum pmclog_type pl_type; /* type of log entry */
176 union { /* log entry data */
177 struct pmclog_ev_callchain pl_cc;
178 struct pmclog_ev_closelog pl_cl;
179 struct pmclog_ev_dropnotify pl_dn;
180 struct pmclog_ev_initialize pl_i;
181 struct pmclog_ev_map_in pl_mi;
182 struct pmclog_ev_map_out pl_mo;
183 struct pmclog_ev_pmcallocate pl_a;
184 struct pmclog_ev_pmcallocatedyn pl_ad;
185 struct pmclog_ev_pmcattach pl_t;
186 struct pmclog_ev_pmcdetach pl_d;
187 struct pmclog_ev_proccsw pl_c;
188 struct pmclog_ev_proccreate pl_pc;
189 struct pmclog_ev_procexec pl_x;
190 struct pmclog_ev_procexit pl_e;
191 struct pmclog_ev_procfork pl_f;
192 struct pmclog_ev_sysexit pl_se;
193 struct pmclog_ev_threadcreate pl_tc;
194 struct pmclog_ev_threadexit pl_te;
195 struct pmclog_ev_userdata pl_u;
199 enum pmclog_parser_state {
200 PL_STATE_NEW_RECORD, /* in-between records */
201 PL_STATE_EXPECTING_HEADER, /* header being read */
202 PL_STATE_PARTIAL_RECORD, /* header present but not the record */
203 PL_STATE_ERROR /* parsing error encountered */
206 struct pmclog_parse_state {
207 enum pmclog_parser_state ps_state;
208 enum pmc_cputype ps_arch; /* log file architecture */
209 uint32_t ps_version; /* hwpmc version */
210 int ps_initialized; /* whether initialized */
211 int ps_count; /* count of records processed */
212 off_t ps_offset; /* stream byte offset */
213 union pmclog_entry ps_saved; /* saved partial log entry */
214 int ps_svcount; /* #bytes saved */
215 int ps_fd; /* active fd or -1 */
216 char *ps_buffer; /* scratch buffer if fd != -1 */
217 char *ps_data; /* current parse pointer */
218 char *ps_cpuid; /* log cpuid */
219 size_t ps_len; /* length of buffered data */
222 #define PMCLOG_FD_NONE (-1)
225 void *pmclog_open(int _fd);
226 int pmclog_feed(void *_cookie, char *_data, int _len);
227 int pmclog_read(void *_cookie, struct pmclog_ev *_ev);
228 void pmclog_close(void *_cookie);