/* -*- linux-c -*- * Copyright (C) 2005-2019 Red Hat Inc. * * This file is part of systemtap, and is free software. You can * redistribute it and/or modify it under the terms of the GNU General * Public License (GPL); either version 2, or (at your option) any * later version. */ #ifndef _STP_SYM_H_ #define _STP_SYM_H_ /* Constants for printing address symbols. */ /* Prints address as hex, plus space, no newline. */ #define _STP_SYM_HEXSTR 0 /* Prints symbol when found for address otherwise hex. */ #define _STP_SYM_SYMBOL 1 /* Prints "hex : symbol" when used in combination with _STP_SYM_SYMBOL if symbol found for address otherwise hex only. */ #define _STP_SYM_HEX_SYMBOL 2 /* Adds module " [name]" if found. */ #define _STP_SYM_MODULE 4 /* Adds offset to symbol and/or module when used. */ #define _STP_SYM_OFFSET 8 /* Adds size to offset of symbol or module, when _STP_SYM_OFFSET used. */ #define _STP_SYM_SIZE 16 /* Adds the string " (inexact)", if used in together with _STP_SYM_SYMBOL. */ #define _STP_SYM_INEXACT 32 /* Prefixes a space character. */ #define _STP_SYM_PRE_SPACE 64 /* Postfixes a space character, takes precedence over _STP_SYM_NEWLINE. */ #define _STP_SYM_POST_SPACE 128 /* Adds a newline character, doesn't combine with _STP_SYM_POST_SPACE. */ #define _STP_SYM_NEWLINE 256 /* Adds only module " [`basename name`]" if found, use with _STP_SYM_MODULE. */ #define _STP_SYM_MODULE_BASENAME 512 /* Adds the line number */ #define _STP_SYM_LINENUMBER 1024 /* Adds the filename the symbol is from when _STP_SYM_LINENUMBER is used. */ #define _STP_SYM_FILENAME 2048 /* Used for backtraces in hex string form. */ #define _STP_SYM_NONE (_STP_SYM_HEXSTR | _STP_SYM_POST_SPACE) /* Special "brief" case, used by print_ubacktrace_brief, no hex if possible. */ #define _STP_SYM_BRIEF (_STP_SYM_SYMBOL | _STP_SYM_OFFSET | _STP_SYM_NEWLINE) /* Full symbol format, as used in printed backtraces. */ #define _STP_SYM_FULL (_STP_SYM_SYMBOL | _STP_SYM_HEX_SYMBOL \ | _STP_SYM_MODULE | _STP_SYM_OFFSET \ | _STP_SYM_SIZE | _STP_SYM_PRE_SPACE \ | _STP_SYM_NEWLINE) /* More fuller symbol format, includes file names and line numbers. */ #define _STP_SYM_FULLER (_STP_SYM_SYMBOL | _STP_SYM_HEX_SYMBOL \ | _STP_SYM_MODULE | _STP_SYM_OFFSET \ | _STP_SYM_SIZE | _STP_SYM_FILENAME \ | _STP_SYM_LINENUMBER |_STP_SYM_PRE_SPACE \ | _STP_SYM_NEWLINE) /* Simple symbol format, as used in backtraces for strings. */ #define _STP_SYM_SIMPLE (_STP_SYM_SYMBOL | _STP_SYM_MODULE | _STP_SYM_MODULE_BASENAME \ | _STP_SYM_OFFSET | _STP_SYM_NEWLINE) /* All symbol information (as used by [u]symdata). */ #define _STP_SYM_DATA (_STP_SYM_SYMBOL | _STP_SYM_MODULE \ | _STP_SYM_OFFSET | _STP_SYM_SIZE) #ifdef STP_NEED_LINE_DATA /* DWARF standard opcode encodings. */ #define DW_LNS_copy 1 #define DW_LNS_advance_pc 2 #define DW_LNS_advance_line 3 #define DW_LNS_set_file 4 #define DW_LNS_set_column 5 #define DW_LNS_negate_stmt 6 #define DW_LNS_set_basic_block 7 #define DW_LNS_const_add_pc 8 #define DW_LNS_fixed_advance_pc 9 #define DW_LNS_set_prologue_end 10 #define DW_LNS_set_epilogue_begin 11 #define DW_LNS_set_isa 12 /* DWARF extended opcode encodings. */ #define DW_LNE_end_sequence 1 #define DW_LNE_set_address 2 #define DW_LNE_define_file 3 #define DW_LNE_set_discriminator 4 #define DW_LNE_lo_user 128 #define DW_LNE_hi_user 255 #endif /* STP_NEED_LINE_DATA */ struct _stp_symbol { unsigned long addr; const char *symbol; }; struct _stp_section { const char *name; unsigned long static_addr; /* XXX non-null if everywhere the same. */ unsigned long size; /* length of the address space module covers. */ struct _stp_symbol *symbols; /* ordered by address */ unsigned num_symbols; /* Synthesized index for .debug_frame table, keep section offset to adjust addresses relative to load address. */ void *debug_hdr; uint32_t debug_hdr_len; unsigned long sec_load_offset; }; struct _stp_module { const char* name; /* module name (kernel) or /canonical/path for userspace*/ const char* path; /* canonical filesystem path (kernel .ko or user) */ struct _stp_section *sections; unsigned num_sections; /* The .eh_frame unwind data for this module. Note index for .debug_frame (hdr) is per section. */ void *debug_frame; void *eh_frame; void *unwind_hdr; void *debug_line; void *debug_line_str; uint32_t debug_frame_len; uint32_t eh_frame_len; uint32_t unwind_hdr_len; uint32_t debug_line_len; uint32_t debug_line_str_len; unsigned long eh_frame_addr; /* Orig load address (offset) .eh_frame */ unsigned long unwind_hdr_addr; /* same for .eh_frame_hdr */ /* build-id information */ unsigned char *build_id_bits; unsigned long build_id_offset; unsigned long notes_sect; int build_id_len; }; /* Defined by translator-generated stap-symbols.h. */ extern struct _stp_module *_stp_modules []; extern const unsigned _stp_num_modules; /* Used in the unwinder to special case unwinding through kretprobes. */ /* Initialized through translator (stap-symbols.h) relative to kernel */ /* load address, fixup by transport symbols _stp_do_relocation */ extern unsigned long _stp_kretprobe_trampoline; #if defined(CONFIG_KALLSYMS) && !defined(STAPCONF_KALLSYMS_LOOKUP_NAME_EXPORTED) // PR26074: Signals that we still need to look up _stext and add it to // _stp_kretprobe_trampoline. extern unsigned _stp_need_kallsyms_stext; static void _stp_set_stext(uint64_t address); #endif static unsigned long _stp_kmodule_relocate (const char *module, const char *section, unsigned long offset); static unsigned long _stp_umodule_relocate (const char *module, unsigned long offset, struct task_struct *tsk); static struct _stp_module *_stp_get_unwind_info (unsigned long addr); static void _stp_kmodule_update_address(const char* module, const char* section, unsigned long offset); #if (defined(STP_USE_DWARF_UNWINDER) && defined(STP_NEED_UNWIND_DATA)) \ || defined(STP_NEED_LINE_DATA) extern struct _stp_module _stp_module_self; extern struct _stp_section _stp_module_self_sections[]; extern struct _stp_symbol _stp_module_self_symbols_0[]; extern struct _stp_symbol _stp_module_self_symbols_1[]; #endif /* defined(STP_USE_DWARF_UNWINDER) && defined(STP_NEED_UNWIND_DATA) || defined(STP_NEED_LINE_DATA) */ #endif /* _STP_SYM_H_ */