/usr/share/systemtap/runtime
Edit: /usr/share/systemtap/runtime/sym.h (6539B)
/* -*- 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;
uint32_t debug_frame_len;
uint32_t eh_frame_len;
uint32_t unwind_hdr_len;
uint32_t debug_line_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_ */