1 2 /* 3 * Copyright (C) 2017-2019 Lyude Paul 4 * Copyright (C) 2017-2019 Alyssa Rosenzweig 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a 7 * copy of this software and associated documentation files (the "Software"), 8 * to deal in the Software without restriction, including without limitation 9 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 10 * and/or sell copies of the Software, and to permit persons to whom the 11 * Software is furnished to do so, subject to the following conditions: 12 * 13 * The above copyright notice and this permission notice (including the next 14 * paragraph) shall be included in all copies or substantial portions of the 15 * Software. 16 * 17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 22 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 23 * SOFTWARE. 24 * 25 */ 26 27 #ifndef __PAN_DECODE_PUBLIC_H__ 28 #define __PAN_DECODE_PUBLIC_H__ 29 30 #include <stdio.h> 31 #include <stdlib.h> 32 #include <stddef.h> 33 #include <stdbool.h> 34 #include <inttypes.h> 35 36 /* Public entrypoints for the tracing infrastructure. This API should be kept 37 * more or less stable. Don't feel bad if you have to change it; just feel 38 * slightly guilty about creating more work for me later. -Alyssa <3 39 * 40 * I'm joking. Mostly. panwrap (out-of-tree) includes this, so update that if 41 * you need to change something here. panwrap is open-source but cannot be 42 * included in-tree. 43 */ 44 45 void pandecode_initialize(bool to_stderr); 46 47 void pandecode_next_frame(void); 48 49 void pandecode_close(void); 50 51 void 52 pandecode_inject_mmap(uint64_t gpu_va, void *cpu, unsigned sz, const char *name); 53 54 void pandecode_inject_free(uint64_t gpu_va, unsigned sz); 55 56 void pandecode_jc(uint64_t jc_gpu_va, unsigned gpu_id); 57 58 void 59 pandecode_abort_on_fault(uint64_t jc_gpu_va, unsigned gpu_id); 60 61 #endif /* __MMAP_TRACE_H__ */ 62