1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 22 /* 23 * Copyright 2009 Sun Microsystems, Inc. All rights reserved. 24 * Use is subject to license terms. 25 */ 26 27 #ifndef _DEBUG_DOT_H 28 #define _DEBUG_DOT_H 29 30 #include <debug.h> 31 #include <conv.h> 32 33 #ifdef __cplusplus 34 extern "C" { 35 #endif 36 37 /* 38 * Debugging is enabled by various tokens (see debug.c) that result in an 39 * internal bit mask (d_class) being initialized. Each debugging function is 40 * appropriate for one or more of the classes specified by the bit mask. Each 41 * debugging function validates whether it is appropriate for the present 42 * classes before printing anything. 43 */ 44 #define DBG_NOTCLASS(c) !(dbg_desc->d_class & (c)) 45 46 #define DBG_C_ARGS 0x00000001 47 #define DBG_C_AUDITING 0x00000002 48 #define DBG_C_BASIC 0x00000004 49 #define DBG_C_BINDINGS 0x00000008 50 #define DBG_C_CAP 0x00000010 51 #define DBG_C_DEMANGLE 0x00000020 52 #define DBG_C_ENTRY 0x00000040 53 #define DBG_C_FILES 0x00000080 54 #define DBG_C_GOT 0x00000100 55 #define DBG_C_INIT 0x00000200 56 #define DBG_C_LIBS 0x00000400 57 #define DBG_C_MAP 0x00000800 58 #define DBG_C_MOVE 0x00001000 59 #define DBG_C_RELOC 0x00002000 60 #define DBG_C_SECTIONS 0x00004000 61 #define DBG_C_SEGMENTS 0x00008000 62 #define DBG_C_STATS 0x00010000 63 #define DBG_C_STRTAB 0x00020000 64 #define DBG_C_SUPPORT 0x00040000 65 #define DBG_C_SYMBOLS 0x00080000 66 #define DBG_C_TLS 0x00100000 67 #define DBG_C_UNUSED 0x00200000 68 #define DBG_C_VERSIONS 0x00400000 69 70 71 #define DBG_C_ALL 0xffffffff 72 73 typedef struct { 74 const char *o_name; /* command line argument name */ 75 uint_t o_class; /* associated class for this name */ 76 uint_t o_extra; /* associated extra for this name */ 77 } DBG_options; 78 79 #define AL_CNT_DEBUG 4 80 81 /* 82 * Some Dbg_*() format strings differ depending on whether they are used for 83 * 32-bit or 64-bit values. 84 */ 85 #if defined(_ELF64) 86 87 #define MSG_EDATA_TITLE MSG_EDATA_TITLE_64 88 #define MSG_EDATA_ENTRY MSG_EDATA_ENTRY_64 89 90 #else 91 92 #define MSG_EDATA_TITLE MSG_EDATA_TITLE_32 93 #define MSG_EDATA_ENTRY MSG_EDATA_ENTRY_32 94 95 #endif 96 97 /* 98 * Some Elf_*() format strings differ depending on whether they are used for 99 * 32-bit or 64-bit values. 100 */ 101 #if defined(_ELF64) 102 103 #define MSG_GOT_TITLE MSG_GOT_TITLE_64 104 #define MSG_GOT_ENTRY_RE MSG_GOT_ENTRY_RE_64 105 #define MSG_GOT_ENTRY_NR MSG_GOT_ENTRY_NR_64 106 #define MSG_GOT_COLUMNS1 MSG_GOT_COLUMNS1_64 107 #define MSG_GOT_COLUMNS2 MSG_GOT_COLUMNS2_64 108 #define MSG_GOT_FORMAT1 MSG_GOT_FORMAT1_64 109 #define MSG_GOT_FORMAT2 MSG_GOT_FORMAT2_64 110 111 #define MSG_PHD_VADDR MSG_PHD_VADDR_64 112 #define MSG_PHD_PADDR MSG_PHD_PADDR_64 113 #define MSG_PHD_FILESZ MSG_PHD_FILESZ_64 114 #define MSG_PHD_OFFSET MSG_PHD_OFFSET_64 115 116 #define MSG_REL_EFSA_TITLE MSG_REL_EFSA_TITLE_64 117 #define MSG_REL_EFLA_TITLE MSG_REL_EFLA_TITLE_64 118 #define MSG_REL_EFSN_TITLE MSG_REL_EFSN_TITLE_64 119 #define MSG_REL_EFLN_TITLE MSG_REL_EFLN_TITLE_64 120 #define MSG_REL_EFSA_ENTRY MSG_REL_EFSA_ENTRY_64 121 #define MSG_REL_EFLA_ENTRY MSG_REL_EFLA_ENTRY_64 122 #define MSG_REL_EFSN_ENTRY MSG_REL_EFSN_ENTRY_64 123 #define MSG_REL_EFLN_ENTRY MSG_REL_EFLN_ENTRY_64 124 #define MSG_REL_RT_APLREG MSG_REL_RT_APLREG_64 125 #define MSG_REL_RT_APLVAL MSG_REL_RT_APLVAL_64 126 #define MSG_REL_RTA_TITLE MSG_REL_RTA_TITLE_64 127 #define MSG_REL_RTN_TITLE MSG_REL_RTN_TITLE_64 128 #define MSG_REL_RTV_TITLE MSG_REL_RTV_TITLE_64 129 #define MSG_REL_RTA_ENTRY MSG_REL_RTA_ENTRY_64 130 #define MSG_REL_RTN_ENTRY MSG_REL_RTN_ENTRY_64 131 #define MSG_REL_LDSA_TITLE MSG_REL_LDSA_TITLE_64 132 #define MSG_REL_LDSN_TITLE MSG_REL_LDSN_TITLE_64 133 #define MSG_REL_LDSV_TITLE MSG_REL_LDSV_TITLE_64 134 #define MSG_REL_LDSA_ENTRY MSG_REL_LDSA_ENTRY_64 135 #define MSG_REL_LDSN_ENTRY MSG_REL_LDSN_ENTRY_64 136 #define MSG_REL_LDLA_TITLE MSG_REL_LDLA_TITLE_64 137 #define MSG_REL_LDLN_TITLE MSG_REL_LDLN_TITLE_64 138 #define MSG_REL_LDLV_TITLE MSG_REL_LDLV_TITLE_64 139 #define MSG_REL_LDLA_ENTRY MSG_REL_LDLA_ENTRY_64 140 #define MSG_REL_LDLN_ENTRY MSG_REL_LDLN_ENTRY_64 141 142 #define MSG_SHD_ADDR MSG_SHD_ADDR_64 143 #define MSG_SHD_SIZE MSG_SHD_SIZE_64 144 #define MSG_SHD_OFFSET MSG_SHD_OFFSET_64 145 #define MSG_SHD_OFFSET_ENT MSG_SHD_OFFSET_ENT_64 146 #define MSG_SHD_ALIGN MSG_SHD_ALIGN_64 147 #define MSG_SHD_LINK MSG_SHD_LINK_64 148 149 #define MSG_SYM_EFS_ENTRY MSG_SYM_EFS_ENTRY_64 150 #define MSG_SYM_EFL_ENTRY MSG_SYM_EFL_ENTRY_64 151 #define MSG_SYM_EFS_TITLE MSG_SYM_EFS_TITLE_64 152 #define MSG_SYM_EFL_TITLE MSG_SYM_EFL_TITLE_64 153 #define MSG_SYM_LDS_TITLE MSG_SYM_LDS_TITLE_64 154 #define MSG_SYM_LDL_TITLE MSG_SYM_LDL_TITLE_64 155 156 #else 157 158 #define MSG_GOT_TITLE MSG_GOT_TITLE_32 159 #define MSG_GOT_ENTRY_RE MSG_GOT_ENTRY_RE_32 160 #define MSG_GOT_ENTRY_NR MSG_GOT_ENTRY_NR_32 161 #define MSG_GOT_COLUMNS1 MSG_GOT_COLUMNS1_32 162 #define MSG_GOT_COLUMNS2 MSG_GOT_COLUMNS2_32 163 #define MSG_GOT_FORMAT1 MSG_GOT_FORMAT1_32 164 #define MSG_GOT_FORMAT2 MSG_GOT_FORMAT2_32 165 166 #define MSG_PHD_VADDR MSG_PHD_VADDR_32 167 #define MSG_PHD_PADDR MSG_PHD_PADDR_32 168 #define MSG_PHD_FILESZ MSG_PHD_FILESZ_32 169 #define MSG_PHD_OFFSET MSG_PHD_OFFSET_32 170 171 #define MSG_REL_EFSA_TITLE MSG_REL_EFSA_TITLE_32 172 #define MSG_REL_EFLA_TITLE MSG_REL_EFLA_TITLE_32 173 #define MSG_REL_EFSN_TITLE MSG_REL_EFSN_TITLE_32 174 #define MSG_REL_EFLN_TITLE MSG_REL_EFLN_TITLE_32 175 #define MSG_REL_EFSA_ENTRY MSG_REL_EFSA_ENTRY_32 176 #define MSG_REL_EFLA_ENTRY MSG_REL_EFLA_ENTRY_32 177 #define MSG_REL_EFSN_ENTRY MSG_REL_EFSN_ENTRY_32 178 #define MSG_REL_EFLN_ENTRY MSG_REL_EFLN_ENTRY_32 179 #define MSG_REL_RT_APLREG MSG_REL_RT_APLREG_32 180 #define MSG_REL_RT_APLVAL MSG_REL_RT_APLVAL_32 181 #define MSG_REL_RTA_TITLE MSG_REL_RTA_TITLE_32 182 #define MSG_REL_RTN_TITLE MSG_REL_RTN_TITLE_32 183 #define MSG_REL_RTV_TITLE MSG_REL_RTV_TITLE_32 184 #define MSG_REL_RTA_ENTRY MSG_REL_RTA_ENTRY_32 185 #define MSG_REL_RTN_ENTRY MSG_REL_RTN_ENTRY_32 186 #define MSG_REL_LDSA_TITLE MSG_REL_LDSA_TITLE_32 187 #define MSG_REL_LDSN_TITLE MSG_REL_LDSN_TITLE_32 188 #define MSG_REL_LDSV_TITLE MSG_REL_LDSV_TITLE_32 189 #define MSG_REL_LDSA_ENTRY MSG_REL_LDSA_ENTRY_32 190 #define MSG_REL_LDSN_ENTRY MSG_REL_LDSN_ENTRY_32 191 #define MSG_REL_LDLA_TITLE MSG_REL_LDLA_TITLE_32 192 #define MSG_REL_LDLN_TITLE MSG_REL_LDLN_TITLE_32 193 #define MSG_REL_LDLV_TITLE MSG_REL_LDLV_TITLE_32 194 #define MSG_REL_LDLA_ENTRY MSG_REL_LDLA_ENTRY_32 195 #define MSG_REL_LDLN_ENTRY MSG_REL_LDLN_ENTRY_32 196 197 #define MSG_SHD_ADDR MSG_SHD_ADDR_32 198 #define MSG_SHD_SIZE MSG_SHD_SIZE_32 199 #define MSG_SHD_OFFSET MSG_SHD_OFFSET_32 200 #define MSG_SHD_OFFSET_ENT MSG_SHD_OFFSET_ENT_32 201 #define MSG_SHD_ALIGN MSG_SHD_ALIGN_32 202 #define MSG_SHD_LINK MSG_SHD_LINK_32 203 204 #define MSG_SYM_EFS_ENTRY MSG_SYM_EFS_ENTRY_32 205 #define MSG_SYM_EFL_ENTRY MSG_SYM_EFL_ENTRY_32 206 #define MSG_SYM_EFS_TITLE MSG_SYM_EFS_TITLE_32 207 #define MSG_SYM_EFL_TITLE MSG_SYM_EFL_TITLE_32 208 #define MSG_SYM_LDS_TITLE MSG_SYM_LDS_TITLE_32 209 #define MSG_SYM_LDL_TITLE MSG_SYM_LDL_TITLE_32 210 211 #endif 212 213 #define INDEX_STR_SIZE 10 214 215 /* 216 * Buffer used by dbg_isec_name() to format input section 217 * names. The size was selected to satisfy two opposing 218 * constraints: 219 * - To be large enough to handle the largest C++ mangled name. 220 * Although we can malloc buffers, we don't want that to happen. 221 * - To be small enough on the thread stack to not cause problems. 222 */ 223 typedef char dbg_isec_name_buf_t[INDEX_STR_SIZE + 2048]; 224 225 #if defined(_ELF64) 226 #define dbg_fmt_isec_name dbg64_fmt_isec_name 227 #define dbg_fmt_isec_name2 dbg64_fmt_isec_name2 228 #else 229 #define dbg_fmt_isec_name dbg32_fmt_isec_name 230 #define dbg_fmt_isec_name2 dbg32_fmt_isec_name2 231 #endif 232 extern const char *dbg_fmt_isec_name(Is_desc *, dbg_isec_name_buf_t, 233 char **); 234 extern const char *dbg_fmt_isec_name2(const char *, Word, 235 dbg_isec_name_buf_t, char **); 236 237 #ifdef __cplusplus 238 } 239 #endif 240 241 #endif /* _DEBUG_DOT_H */ 242