1/* 2 * Copyright 2003 VMware, Inc. 3 * Copyright © 2007 Intel Corporation 4 * 5 * Permission is hereby granted, free of charge, to any person obtaining 6 * a copy of this software and associated documentation files (the 7 * "Software"), to deal in the Software without restriction, including 8 * without limitation the rights to use, copy, modify, merge, publish, 9 * distribute, sublicense, and/or sell copies of the Software, and to 10 * permit persons to whom the Software is furnished to do so, subject to 11 * the following conditions: 12 * 13 * The above copyright notice and this permission notice (including the 14 * next paragraph) shall be included in all copies or substantial 15 * portions of the Software. 16 * 17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 18 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 20 * IN NO EVENT SHALL THE COPYRIGHT OWNER(S) AND/OR ITS SUPPLIERS BE 21 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 22 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 23 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 24 */ 25 26#ifndef INTEL_DEBUG_H 27#define INTEL_DEBUG_H 28 29#include <stdint.h> 30#include "compiler/shader_enums.h" 31#include "util/macros.h" 32 33#ifdef __cplusplus 34extern "C" { 35#endif 36/** 37 * \file intel_debug.h 38 * 39 * Basic INTEL_DEBUG environment variable handling. This file defines the 40 * list of debugging flags, as well as some macros for handling them. 41 */ 42 43extern uint64_t intel_debug; 44 45/* Returns 0/1, not the matching bit mask. */ 46#define INTEL_DEBUG(flags) unlikely(intel_debug & (flags)) 47 48#define DEBUG_TEXTURE (1ull << 0) 49#define DEBUG_BLIT (1ull << 1) 50#define DEBUG_PERF (1ull << 2) 51#define DEBUG_PERFMON (1ull << 3) 52#define DEBUG_BATCH (1ull << 4) 53#define DEBUG_BUFMGR (1ull << 5) 54#define DEBUG_GS (1ull << 6) 55#define DEBUG_SYNC (1ull << 7) 56#define DEBUG_SF (1ull << 8) 57#define DEBUG_SUBMIT (1ull << 9) 58#define DEBUG_WM (1ull << 10) 59#define DEBUG_URB (1ull << 11) 60#define DEBUG_VS (1ull << 12) 61#define DEBUG_CLIP (1ull << 13) 62#define DEBUG_STALL (1ull << 14) 63#define DEBUG_BLORP (1ull << 15) 64#define DEBUG_NO16 (1ull << 16) 65#define DEBUG_NO_DUAL_OBJECT_GS (1ull << 17) 66#define DEBUG_OPTIMIZER (1ull << 18) 67#define DEBUG_ANNOTATION (1ull << 19) 68#define DEBUG_NO8 (1ull << 20) 69#define DEBUG_NO_OACONFIG (1ull << 21) 70#define DEBUG_SPILL_FS (1ull << 22) 71#define DEBUG_SPILL_VEC4 (1ull << 23) 72#define DEBUG_CS (1ull << 24) 73#define DEBUG_HEX (1ull << 25) 74#define DEBUG_NO_COMPACTION (1ull << 26) 75#define DEBUG_TCS (1ull << 27) 76#define DEBUG_TES (1ull << 28) 77#define DEBUG_L3 (1ull << 29) 78#define DEBUG_DO32 (1ull << 30) 79#define DEBUG_NO_CCS (1ull << 31) 80#define DEBUG_NO_HIZ (1ull << 32) 81#define DEBUG_COLOR (1ull << 33) 82#define DEBUG_REEMIT (1ull << 34) 83#define DEBUG_SOFT64 (1ull << 35) 84#define DEBUG_TCS_EIGHT_PATCH (1ull << 36) 85#define DEBUG_BT (1ull << 37) 86#define DEBUG_PIPE_CONTROL (1ull << 38) 87#define DEBUG_NO_FAST_CLEAR (1ull << 39) 88#define DEBUG_NO32 (1ull << 40) 89#define DEBUG_RT (1ull << 41) 90#define DEBUG_TASK (1ull << 42) 91#define DEBUG_MESH (1ull << 43) 92 93#define DEBUG_ANY (~0ull) 94 95#define DEBUG_ANY (~0ull) 96 97/* These flags are not compatible with the disk shader cache */ 98#define DEBUG_DISK_CACHE_DISABLE_MASK 0 99 100/* These flags may affect program generation */ 101#define DEBUG_DISK_CACHE_MASK \ 102 (DEBUG_NO16 | DEBUG_NO_DUAL_OBJECT_GS | DEBUG_NO8 | DEBUG_SPILL_FS | \ 103 DEBUG_SPILL_VEC4 | DEBUG_NO_COMPACTION | DEBUG_DO32 | DEBUG_SOFT64 | \ 104 DEBUG_TCS_EIGHT_PATCH | DEBUG_NO32) 105 106#ifdef HAVE_ANDROID_PLATFORM 107#define LOG_TAG "INTEL-MESA" 108#if ANDROID_API_LEVEL >= 26 109#include <log/log.h> 110#else 111#include <cutils/log.h> 112#endif /* use log/log.h start from android 8 major version */ 113#ifndef ALOGW 114#define ALOGW LOGW 115#endif 116#define dbg_printf(...) ALOGW(__VA_ARGS__) 117#else 118#define dbg_printf(...) fprintf(stderr, __VA_ARGS__) 119#endif /* HAVE_ANDROID_PLATFORM */ 120 121#define DBG(...) do { \ 122 if (INTEL_DEBUG(FILE_DEBUG_FLAG)) \ 123 dbg_printf(__VA_ARGS__); \ 124} while(0) 125 126extern uint64_t intel_debug_flag_for_shader_stage(gl_shader_stage stage); 127 128extern void brw_process_intel_debug_variable(void); 129 130/* Below is a list of structure located in the identifier buffer. The driver 131 * can fill those in for debug purposes. 132 */ 133 134enum intel_debug_block_type { 135 /* End of the debug blocks */ 136 INTEL_DEBUG_BLOCK_TYPE_END = 1, 137 138 /* Driver identifier (struct intel_debug_block_driver) */ 139 INTEL_DEBUG_BLOCK_TYPE_DRIVER, 140 141 /* Frame identifier (struct intel_debug_block_frame) */ 142 INTEL_DEBUG_BLOCK_TYPE_FRAME, 143 144 /* Internal, never to be written out */ 145 INTEL_DEBUG_BLOCK_TYPE_MAX, 146}; 147 148struct intel_debug_block_base { 149 uint32_t type; /* enum intel_debug_block_type */ 150 uint32_t length; /* inclusive of this structure size */ 151}; 152 153struct intel_debug_block_driver { 154 struct intel_debug_block_base base; 155 uint8_t description[]; 156}; 157 158struct intel_debug_block_frame { 159 struct intel_debug_block_base base; 160 uint64_t frame_id; 161}; 162 163extern void *intel_debug_identifier(void); 164extern uint32_t intel_debug_identifier_size(void); 165 166extern uint32_t intel_debug_write_identifiers(void *output, 167 uint32_t output_size, 168 const char *driver_name); 169 170extern void *intel_debug_get_identifier_block(void *buffer, 171 uint32_t buffer_size, 172 enum intel_debug_block_type type); 173 174#ifdef __cplusplus 175} 176#endif 177 178#endif /* INTEL_DEBUG_H */ 179