// Copyright (c) Facebook, Inc. and its affiliates. // SPDX-License-Identifier: GPL-3.0+ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "debug_info.h" #include "dwarf_index.h" #include "error.h" #include "language.h" #include "linux_kernel.h" #include "memory_reader.h" #include "object_index.h" #include "program.h" #include "symbol.h" #include "vector.h" #include "util.h" DEFINE_VECTOR_FUNCTIONS(drgn_prstatus_vector) DEFINE_HASH_TABLE_FUNCTIONS(drgn_prstatus_map, int_key_hash_pair, scalar_key_eq) static Elf_Type note_header_type(GElf_Phdr *phdr) { #if _ELFUTILS_PREREQ(0, 175) if (phdr->p_align == 8) return ELF_T_NHDR8; #endif return ELF_T_NHDR; } LIBDRGN_PUBLIC enum drgn_program_flags drgn_program_flags(struct drgn_program *prog) { return prog->flags; } LIBDRGN_PUBLIC const struct drgn_platform * drgn_program_platform(struct drgn_program *prog) { return prog->has_platform ? &prog->platform : NULL; } LIBDRGN_PUBLIC const struct drgn_language * drgn_program_language(struct drgn_program *prog) { return prog->lang ? prog->lang : &drgn_default_language; } void drgn_program_set_platform(struct drgn_program *prog, const struct drgn_platform *platform) { if (!prog->has_platform) { prog->platform = *platform; prog->has_platform = true; } } void drgn_program_init(struct drgn_program *prog, const struct drgn_platform *platform) { memset(prog, 0, sizeof(*prog)); drgn_memory_reader_init(&prog->reader); drgn_program_init_types(prog); drgn_object_index_init(&prog->oindex); prog->core_fd = -1; if (platform) drgn_program_set_platform(prog, platform); char *env = getenv("DRGN_PREFER_ORC_UNWINDER"); prog->prefer_orc_unwinder = env && atoi(env); drgn_object_init(&prog->page_offset, prog); drgn_object_init(&prog->vmemmap, prog); } void drgn_program_deinit(struct drgn_program *prog) { if (prog->prstatus_cached) { if (prog->flags & DRGN_PROGRAM_IS_LINUX_KERNEL) drgn_prstatus_vector_deinit(&prog->prstatus_vector); else drgn_prstatus_map_deinit(&prog->prstatus_map); } free(prog->pgtable_it); drgn_object_deinit(&prog->vmemmap); drgn_object_deinit(&prog->page_offset); drgn_object_index_deinit(&prog->oindex); drgn_program_deinit_types(prog); drgn_memory_reader_deinit(&prog->reader); free(prog->file_segments); #ifdef WITH_LIBKDUMPFILE if (prog->kdump_ctx) kdump_free(prog->kdump_ctx); #endif elf_end(prog->core); if (prog->core_fd != -1) close(prog->core_fd); drgn_debug_info_destroy(prog->_dbinfo); } LIBDRGN_PUBLIC struct drgn_error * drgn_program_create(const struct drgn_platform *platform, struct drgn_program **ret) { struct drgn_program *prog; prog = malloc(sizeof(*prog)); if (!prog) return &drgn_enomem; drgn_program_init(prog, platform); *ret = prog; return NULL; } LIBDRGN_PUBLIC void drgn_program_destroy(struct drgn_program *prog) { if (prog) { drgn_program_deinit(prog); free(prog); } } LIBDRGN_PUBLIC struct drgn_error * drgn_program_add_memory_segment(struct drgn_program *prog, uint64_t address, uint64_t size, drgn_memory_read_fn read_fn, void *arg, bool physical) { return drgn_memory_reader_add_segment(&prog->reader, address, size, read_fn, arg, physical); } LIBDRGN_PUBLIC struct drgn_error * drgn_program_add_object_finder(struct drgn_program *prog, drgn_object_find_fn fn, void *arg) { return drgn_object_index_add_finder(&prog->oindex, fn, arg); } static struct drgn_error * drgn_program_check_initialized(struct drgn_program *prog) { if (prog->core_fd != -1 || !drgn_memory_reader_empty(&prog->reader)) { return drgn_error_create(DRGN_ERROR_INVALID_ARGUMENT, "program memory was already initialized"); } return NULL; } static struct drgn_error *has_kdump_signature(const char *path, int fd, bool *ret) { char signature[KDUMP_SIG_LEN]; size_t n = 0; while (n < sizeof(signature)) { ssize_t sret; sret = pread(fd, signature + n, sizeof(signature) - n, n); if (sret == -1) { if (errno == EINTR) continue; return drgn_error_create_os("pread", errno, path); } else if (sret == 0) { *ret = false; return NULL; } n += sret; } *ret = memcmp(signature, KDUMP_SIGNATURE, sizeof(signature)) == 0; return NULL; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_set_core_dump(struct drgn_program *prog, const char *path) { struct drgn_error *err; GElf_Ehdr ehdr_mem, *ehdr; struct drgn_platform platform; bool is_64_bit, is_kdump; size_t phnum, i; size_t num_file_segments, j; bool have_phys_addrs = false; const char *vmcoreinfo_note = NULL; size_t vmcoreinfo_size = 0; bool have_nt_taskstruct = false, is_proc_kcore; err = drgn_program_check_initialized(prog); if (err) return err; prog->core_fd = open(path, O_RDONLY); if (prog->core_fd == -1) return drgn_error_create_os("open", errno, path); err = has_kdump_signature(path, prog->core_fd, &is_kdump); if (err) goto out_fd; if (is_kdump) { err = drgn_program_set_kdump(prog); if (err) goto out_fd; return NULL; } elf_version(EV_CURRENT); prog->core = elf_begin(prog->core_fd, ELF_C_READ, NULL); if (!prog->core) { err = drgn_error_libelf(); goto out_fd; } ehdr = gelf_getehdr(prog->core, &ehdr_mem); if (!ehdr || ehdr->e_type != ET_CORE) { err = drgn_error_format(DRGN_ERROR_INVALID_ARGUMENT, "not an ELF core file"); goto out_elf; } drgn_platform_from_elf(ehdr, &platform); is_64_bit = ehdr->e_ident[EI_CLASS] == ELFCLASS64; if (elf_getphdrnum(prog->core, &phnum) != 0) { err = drgn_error_libelf(); goto out_elf; } /* * First pass: count the number of loadable segments, check if p_paddr * is valid, and check for notes. */ num_file_segments = 0; for (i = 0; i < phnum; i++) { GElf_Phdr phdr_mem, *phdr; phdr = gelf_getphdr(prog->core, i, &phdr_mem); if (!phdr) { err = drgn_error_libelf(); goto out_elf; } if (phdr->p_type == PT_LOAD) { if (phdr->p_paddr) have_phys_addrs = true; num_file_segments++; } else if (phdr->p_type == PT_NOTE) { Elf_Data *data; size_t offset; GElf_Nhdr nhdr; size_t name_offset, desc_offset; data = elf_getdata_rawchunk(prog->core, phdr->p_offset, phdr->p_filesz, note_header_type(phdr)); if (!data) { err = drgn_error_libelf(); goto out_elf; } offset = 0; while (offset < data->d_size && (offset = gelf_getnote(data, offset, &nhdr, &name_offset, &desc_offset))) { const char *name, *desc; name = (char *)data->d_buf + name_offset; desc = (char *)data->d_buf + desc_offset; if (strncmp(name, "CORE", nhdr.n_namesz) == 0) { if (nhdr.n_type == NT_TASKSTRUCT) have_nt_taskstruct = true; } else if (strncmp(name, "VMCOREINFO", nhdr.n_namesz) == 0) { vmcoreinfo_note = desc; vmcoreinfo_size = nhdr.n_descsz; /* * This is either a vmcore or * /proc/kcore, so even a p_paddr of 0 * may be valid. */ have_phys_addrs = true; } } } } if (have_nt_taskstruct) { /* * If the core file has an NT_TASKSTRUCT note and is in /proc, * then it's probably /proc/kcore. */ struct statfs fs; if (fstatfs(prog->core_fd, &fs) == -1) { err = drgn_error_create_os("fstatfs", errno, path); if (err) goto out_elf; } is_proc_kcore = fs.f_type == 0x9fa0; /* PROC_SUPER_MAGIC */ } else { is_proc_kcore = false; } if (vmcoreinfo_note && !is_proc_kcore) { char *env; /* Use libkdumpfile for ELF vmcores if it was requested. */ env = getenv("DRGN_USE_LIBKDUMPFILE_FOR_ELF"); if (env && atoi(env)) { err = drgn_program_set_kdump(prog); if (err) goto out_elf; return NULL; } } prog->file_segments = malloc_array(num_file_segments, sizeof(*prog->file_segments)); if (!prog->file_segments) { err = &drgn_enomem; goto out_elf; } if ((is_proc_kcore || vmcoreinfo_note) && platform.arch->linux_kernel_pgtable_iterator_next) { /* * Try to read any memory that isn't in the core dump via the * page table. */ err = drgn_program_add_memory_segment(prog, 0, is_64_bit ? UINT64_MAX : UINT32_MAX, read_memory_via_pgtable, prog, false); if (err) goto out_segments; } /* Second pass: add the segments. */ for (i = 0, j = 0; i < phnum && j < num_file_segments; i++) { GElf_Phdr phdr_mem, *phdr; phdr = gelf_getphdr(prog->core, i, &phdr_mem); if (!phdr) { err = drgn_error_libelf(); goto out_segments; } if (phdr->p_type != PT_LOAD) continue; prog->file_segments[j].file_offset = phdr->p_offset; prog->file_segments[j].file_size = phdr->p_filesz; prog->file_segments[j].fd = prog->core_fd; prog->file_segments[j].eio_is_fault = false; err = drgn_program_add_memory_segment(prog, phdr->p_vaddr, phdr->p_memsz, drgn_read_memory_file, &prog->file_segments[j], false); if (err) goto out_segments; if (have_phys_addrs && phdr->p_paddr != (is_64_bit ? UINT64_MAX : UINT32_MAX)) { err = drgn_program_add_memory_segment(prog, phdr->p_paddr, phdr->p_memsz, drgn_read_memory_file, &prog->file_segments[j], true); if (err) goto out_segments; } j++; } /* * Before Linux kernel commit 464920104bf7 ("/proc/kcore: update * physical address for kcore ram and text") (in v4.11), p_paddr in * /proc/kcore is always zero. If we know the address of the direct * mapping, we can still add physical segments. This needs to be a third * pass, as we may need to read virtual memory to determine the mapping. */ if (is_proc_kcore && !have_phys_addrs && platform.arch->linux_kernel_live_direct_mapping_fallback) { uint64_t direct_mapping, direct_mapping_size; err = platform.arch->linux_kernel_live_direct_mapping_fallback(prog, &direct_mapping, &direct_mapping_size); if (err) goto out_segments; for (i = 0, j = 0; i < phnum && j < num_file_segments; i++) { GElf_Phdr phdr_mem, *phdr; phdr = gelf_getphdr(prog->core, i, &phdr_mem); if (!phdr) { err = drgn_error_libelf(); goto out_segments; } if (phdr->p_type != PT_LOAD) continue; if (phdr->p_vaddr >= direct_mapping && phdr->p_vaddr - direct_mapping + phdr->p_memsz <= direct_mapping_size) { uint64_t phys_addr; phys_addr = phdr->p_vaddr - direct_mapping; err = drgn_program_add_memory_segment(prog, phys_addr, phdr->p_memsz, drgn_read_memory_file, &prog->file_segments[j], true); if (err) goto out_segments; } j++; } } if (vmcoreinfo_note) { err = parse_vmcoreinfo(vmcoreinfo_note, vmcoreinfo_size, &prog->vmcoreinfo); if (err) goto out_segments; } if (is_proc_kcore) { if (!vmcoreinfo_note) { err = read_vmcoreinfo_fallback(&prog->reader, &prog->vmcoreinfo); if (err) goto out_segments; } prog->flags |= (DRGN_PROGRAM_IS_LINUX_KERNEL | DRGN_PROGRAM_IS_LIVE); elf_end(prog->core); prog->core = NULL; } else if (vmcoreinfo_note) { prog->flags |= DRGN_PROGRAM_IS_LINUX_KERNEL; } if (prog->flags & DRGN_PROGRAM_IS_LINUX_KERNEL) { err = drgn_program_add_object_finder(prog, linux_kernel_object_find, prog); if (err) goto out_segments; if (!prog->lang) prog->lang = &drgn_language_c; } drgn_program_set_platform(prog, &platform); return NULL; out_segments: drgn_memory_reader_deinit(&prog->reader); drgn_memory_reader_init(&prog->reader); free(prog->file_segments); prog->file_segments = NULL; out_elf: elf_end(prog->core); prog->core = NULL; out_fd: close(prog->core_fd); prog->core_fd = -1; return err; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_set_kernel(struct drgn_program *prog) { return drgn_program_set_core_dump(prog, "/proc/kcore"); } LIBDRGN_PUBLIC struct drgn_error * drgn_program_set_pid(struct drgn_program *prog, pid_t pid) { struct drgn_error *err; char buf[64]; err = drgn_program_check_initialized(prog); if (err) return err; sprintf(buf, "/proc/%ld/mem", (long)pid); prog->core_fd = open(buf, O_RDONLY); if (prog->core_fd == -1) return drgn_error_create_os("open", errno, buf); prog->file_segments = malloc(sizeof(*prog->file_segments)); if (!prog->file_segments) { err = &drgn_enomem; goto out_fd; } prog->file_segments[0].file_offset = 0; prog->file_segments[0].file_size = UINT64_MAX; prog->file_segments[0].fd = prog->core_fd; prog->file_segments[0].eio_is_fault = true; err = drgn_program_add_memory_segment(prog, 0, UINT64_MAX, drgn_read_memory_file, prog->file_segments, false); if (err) goto out_segments; prog->pid = pid; prog->flags |= DRGN_PROGRAM_IS_LIVE; drgn_program_set_platform(prog, &drgn_host_platform); return NULL; out_segments: drgn_memory_reader_deinit(&prog->reader); drgn_memory_reader_init(&prog->reader); free(prog->file_segments); prog->file_segments = NULL; out_fd: close(prog->core_fd); prog->core_fd = -1; return err; } struct drgn_error *drgn_program_get_dbinfo(struct drgn_program *prog, struct drgn_debug_info **ret) { struct drgn_error *err; if (!prog->_dbinfo) { struct drgn_debug_info *dbinfo; err = drgn_debug_info_create(prog, &dbinfo); if (err) return err; err = drgn_program_add_object_finder(prog, drgn_debug_info_find_object, dbinfo); if (err) { drgn_debug_info_destroy(dbinfo); return err; } err = drgn_program_add_type_finder(prog, drgn_debug_info_find_type, dbinfo); if (err) { drgn_object_index_remove_finder(&prog->oindex); drgn_debug_info_destroy(dbinfo); return err; } prog->_dbinfo = dbinfo; } *ret = prog->_dbinfo; return NULL; } /* Set the default language from the language of "main". */ static void drgn_program_set_language_from_main(struct drgn_debug_info *dbinfo) { struct drgn_error *err; struct drgn_dwarf_index_iterator it; static const uint64_t tags[] = { DW_TAG_subprogram }; err = drgn_dwarf_index_iterator_init(&it, &dbinfo->dindex.global, "main", strlen("main"), tags, ARRAY_SIZE(tags)); if (err) { drgn_error_destroy(err); return; } struct drgn_dwarf_index_die *index_die; while ((index_die = drgn_dwarf_index_iterator_next(&it))) { Dwarf_Die die; err = drgn_dwarf_index_get_die(index_die, &die); if (err) { drgn_error_destroy(err); continue; } const struct drgn_language *lang; err = drgn_language_from_die(&die, false, &lang); if (err) { drgn_error_destroy(err); continue; } if (lang) { dbinfo->prog->lang = lang; break; } } } static int drgn_set_platform_from_dwarf(Dwfl_Module *module, void **userdatap, const char *name, Dwarf_Addr base, Dwarf *dwarf, Dwarf_Addr bias, void *arg) { Elf *elf; GElf_Ehdr ehdr_mem, *ehdr; struct drgn_platform platform; elf = dwarf_getelf(dwarf); if (!elf) return DWARF_CB_OK; ehdr = gelf_getehdr(elf, &ehdr_mem); if (!ehdr) return DWARF_CB_OK; drgn_platform_from_elf(ehdr, &platform); drgn_program_set_platform(arg, &platform); return DWARF_CB_ABORT; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_load_debug_info(struct drgn_program *prog, const char **paths, size_t n, bool load_default, bool load_main) { struct drgn_error *err; if (!n && !load_default && !load_main) return NULL; struct drgn_debug_info *dbinfo; err = drgn_program_get_dbinfo(prog, &dbinfo); if (err) return err; err = drgn_debug_info_load(dbinfo, paths, n, load_default, load_main); if ((!err || err->code == DRGN_ERROR_MISSING_DEBUG_INFO)) { if (!prog->lang && !(prog->flags & DRGN_PROGRAM_IS_LINUX_KERNEL)) drgn_program_set_language_from_main(dbinfo); if (!prog->has_platform) { dwfl_getdwarf(dbinfo->dwfl, drgn_set_platform_from_dwarf, prog, 0); } } return err; } static struct drgn_error *get_prstatus_pid(struct drgn_program *prog, const char *data, size_t size, uint32_t *ret) { bool is_64_bit, bswap; struct drgn_error *err = drgn_program_is_64_bit(prog, &is_64_bit); if (err) return err; err = drgn_program_bswap(prog, &bswap); if (err) return err; size_t offset = is_64_bit ? 32 : 24; uint32_t pr_pid; if (size < offset + sizeof(pr_pid)) { return drgn_error_create(DRGN_ERROR_OTHER, "NT_PRSTATUS is truncated"); } memcpy(&pr_pid, data + offset, sizeof(pr_pid)); if (bswap) pr_pid = bswap_32(pr_pid); *ret = pr_pid; return NULL; } struct drgn_error *drgn_program_cache_prstatus_entry(struct drgn_program *prog, const char *data, size_t size) { if (prog->flags & DRGN_PROGRAM_IS_LINUX_KERNEL) { struct string *entry = drgn_prstatus_vector_append_entry(&prog->prstatus_vector); if (!entry) return &drgn_enomem; entry->str = data; entry->len = size; } else { struct drgn_prstatus_map_entry entry = { .value = { data, size }, }; struct drgn_error *err = get_prstatus_pid(prog, data, size, &entry.key); if (err) return err; if (drgn_prstatus_map_insert(&prog->prstatus_map, &entry, NULL) == -1) return &drgn_enomem; } return NULL; } static struct drgn_error *drgn_program_cache_prstatus(struct drgn_program *prog) { struct drgn_error *err; size_t phnum, i; if (prog->prstatus_cached) return NULL; if (prog->flags & DRGN_PROGRAM_IS_LINUX_KERNEL) drgn_prstatus_vector_init(&prog->prstatus_vector); else drgn_prstatus_map_init(&prog->prstatus_map); #ifdef WITH_LIBKDUMPFILE if (prog->kdump_ctx) { err = drgn_program_cache_prstatus_kdump(prog); goto out; } #endif if (!prog->core) { err = NULL; goto out; } if (elf_getphdrnum(prog->core, &phnum) != 0) { err = drgn_error_libelf(); goto out; } for (i = 0; i < phnum; i++) { GElf_Phdr phdr_mem, *phdr; Elf_Data *data; size_t offset; GElf_Nhdr nhdr; size_t name_offset, desc_offset; phdr = gelf_getphdr(prog->core, i, &phdr_mem); if (!phdr) { err = drgn_error_libelf(); goto out; } if (phdr->p_type != PT_NOTE) continue; data = elf_getdata_rawchunk(prog->core, phdr->p_offset, phdr->p_filesz, note_header_type(phdr)); if (!data) { err = drgn_error_libelf(); goto out; } offset = 0; while (offset < data->d_size && (offset = gelf_getnote(data, offset, &nhdr, &name_offset, &desc_offset))) { const char *name; name = (char *)data->d_buf + name_offset; if (strncmp(name, "CORE", nhdr.n_namesz) != 0 || nhdr.n_type != NT_PRSTATUS) continue; err = drgn_program_cache_prstatus_entry(prog, (char *)data->d_buf + desc_offset, nhdr.n_descsz); if (err) goto out; } } err = NULL; out: if (err) { if (prog->flags & DRGN_PROGRAM_IS_LINUX_KERNEL) drgn_prstatus_vector_deinit(&prog->prstatus_vector); else drgn_prstatus_map_deinit(&prog->prstatus_map); } else { prog->prstatus_cached = true; } return err; } struct drgn_error *drgn_program_find_prstatus_by_cpu(struct drgn_program *prog, uint32_t cpu, struct string *ret, uint32_t *tid_ret) { assert(prog->flags & DRGN_PROGRAM_IS_LINUX_KERNEL); struct drgn_error *err = drgn_program_cache_prstatus(prog); if (err) return err; if (cpu < prog->prstatus_vector.size) { *ret = prog->prstatus_vector.data[cpu]; return get_prstatus_pid(prog, ret->str, ret->len, tid_ret); } else { ret->str = NULL; ret->len = 0; return NULL; } } struct drgn_error *drgn_program_find_prstatus_by_tid(struct drgn_program *prog, uint32_t tid, struct string *ret) { struct drgn_error *err; struct drgn_prstatus_map_iterator it; assert(!(prog->flags & DRGN_PROGRAM_IS_LINUX_KERNEL)); err = drgn_program_cache_prstatus(prog); if (err) return err; it = drgn_prstatus_map_search(&prog->prstatus_map, &tid); if (!it.entry) { ret->str = NULL; ret->len = 0; return NULL; } *ret = it.entry->value; return NULL; } struct drgn_error *drgn_program_init_core_dump(struct drgn_program *prog, const char *path) { struct drgn_error *err; err = drgn_program_set_core_dump(prog, path); if (err) return err; err = drgn_program_load_debug_info(prog, NULL, 0, true, true); if (err && err->code == DRGN_ERROR_MISSING_DEBUG_INFO) { drgn_error_destroy(err); err = NULL; } return err; } struct drgn_error *drgn_program_init_kernel(struct drgn_program *prog) { struct drgn_error *err; err = drgn_program_set_kernel(prog); if (err) return err; err = drgn_program_load_debug_info(prog, NULL, 0, true, true); if (err && err->code == DRGN_ERROR_MISSING_DEBUG_INFO) { drgn_error_destroy(err); err = NULL; } return err; } struct drgn_error *drgn_program_init_pid(struct drgn_program *prog, pid_t pid) { struct drgn_error *err; err = drgn_program_set_pid(prog, pid); if (err) return err; err = drgn_program_load_debug_info(prog, NULL, 0, true, true); if (err && err->code == DRGN_ERROR_MISSING_DEBUG_INFO) { drgn_error_destroy(err); err = NULL; } return err; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_from_core_dump(const char *path, struct drgn_program **ret) { struct drgn_error *err; struct drgn_program *prog; prog = malloc(sizeof(*prog)); if (!prog) return &drgn_enomem; drgn_program_init(prog, NULL); err = drgn_program_init_core_dump(prog, path); if (err) { drgn_program_deinit(prog); free(prog); return err; } *ret = prog; return NULL; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_from_kernel(struct drgn_program **ret) { struct drgn_error *err; struct drgn_program *prog; prog = malloc(sizeof(*prog)); if (!prog) return &drgn_enomem; drgn_program_init(prog, NULL); err = drgn_program_init_kernel(prog); if (err) { drgn_program_deinit(prog); free(prog); return err; } *ret = prog; return NULL; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_from_pid(pid_t pid, struct drgn_program **ret) { struct drgn_error *err; struct drgn_program *prog; prog = malloc(sizeof(*prog)); if (!prog) return &drgn_enomem; drgn_program_init(prog, NULL); err = drgn_program_init_pid(prog, pid); if (err) { drgn_program_deinit(prog); free(prog); return err; } *ret = prog; return NULL; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_read_memory(struct drgn_program *prog, void *buf, uint64_t address, size_t count, bool physical) { return drgn_memory_reader_read(&prog->reader, buf, address, count, physical); } DEFINE_VECTOR(char_vector, char) LIBDRGN_PUBLIC struct drgn_error * drgn_program_read_c_string(struct drgn_program *prog, uint64_t address, bool physical, size_t max_size, char **ret) { struct drgn_error *err; struct char_vector str = VECTOR_INIT; for (;;) { char *c = char_vector_append_entry(&str); if (!c) { char_vector_deinit(&str); return &drgn_enomem; } if (str.size <= max_size) { err = drgn_memory_reader_read(&prog->reader, c, address, 1, physical); if (err) { char_vector_deinit(&str); return err; } if (!*c) break; } else { *c = '\0'; break; } address++; } char_vector_shrink_to_fit(&str); *ret = str.data; return NULL; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_read_u8(struct drgn_program *prog, uint64_t address, bool physical, uint8_t *ret) { return drgn_memory_reader_read(&prog->reader, ret, address, sizeof(*ret), physical); } #define DEFINE_PROGRAM_READ_U(n) \ LIBDRGN_PUBLIC struct drgn_error * \ drgn_program_read_u##n(struct drgn_program *prog, uint64_t address, \ bool physical, uint##n##_t *ret) \ { \ bool bswap; \ struct drgn_error *err = drgn_program_bswap(prog, &bswap); \ if (err) \ return err; \ uint##n##_t tmp; \ err = drgn_memory_reader_read(&prog->reader, &tmp, address, \ sizeof(tmp), physical); \ if (err) \ return err; \ if (bswap) \ tmp = bswap_##n(tmp); \ *ret = tmp; \ return NULL; \ } DEFINE_PROGRAM_READ_U(16) DEFINE_PROGRAM_READ_U(32) DEFINE_PROGRAM_READ_U(64) #undef DEFINE_PROGRAM_READ_U LIBDRGN_PUBLIC struct drgn_error * drgn_program_read_word(struct drgn_program *prog, uint64_t address, bool physical, uint64_t *ret) { bool is_64_bit, bswap; struct drgn_error *err = drgn_program_is_64_bit(prog, &is_64_bit); if (err) return err; err = drgn_program_bswap(prog, &bswap); if (err) return err; if (is_64_bit) { uint64_t tmp; err = drgn_memory_reader_read(&prog->reader, &tmp, address, sizeof(tmp), physical); if (err) return err; if (bswap) tmp = bswap_64(tmp); *ret = tmp; } else { uint32_t tmp; err = drgn_memory_reader_read(&prog->reader, &tmp, address, sizeof(tmp), physical); if (err) return err; if (bswap) tmp = bswap_32(tmp); *ret = tmp; } return NULL; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_find_object(struct drgn_program *prog, const char *name, const char *filename, enum drgn_find_object_flags flags, struct drgn_object *ret) { if (ret && drgn_object_program(ret) != prog) { return drgn_error_create(DRGN_ERROR_INVALID_ARGUMENT, "object is from wrong program"); } return drgn_object_index_find(&prog->oindex, name, filename, flags, ret); } bool drgn_program_find_symbol_by_address_internal(struct drgn_program *prog, uint64_t address, Dwfl_Module *module, struct drgn_symbol *ret) { if (!module) { if (prog->_dbinfo) { module = dwfl_addrmodule(prog->_dbinfo->dwfl, address); if (!module) return false; } else { return false; } } GElf_Off offset; GElf_Sym elf_sym; const char *name = dwfl_module_addrinfo(module, address, &offset, &elf_sym, NULL, NULL, NULL); if (!name) return false; ret->name = name; ret->address = address - offset; ret->size = elf_sym.st_size; return true; } struct drgn_error *drgn_error_symbol_not_found(uint64_t address) { return drgn_error_format(DRGN_ERROR_LOOKUP, "could not find symbol containing 0x%" PRIx64, address); } LIBDRGN_PUBLIC struct drgn_error * drgn_program_find_symbol_by_address(struct drgn_program *prog, uint64_t address, struct drgn_symbol **ret) { struct drgn_symbol *sym; sym = malloc(sizeof(*sym)); if (!sym) return &drgn_enomem; if (!drgn_program_find_symbol_by_address_internal(prog, address, NULL, sym)) { free(sym); return drgn_error_symbol_not_found(address); } *ret = sym; return NULL; } struct find_symbol_by_name_arg { const char *name; struct drgn_symbol **ret; struct drgn_error *err; bool bad_symtabs; }; static int find_symbol_by_name_cb(Dwfl_Module *dwfl_module, void **userdatap, const char *module_name, Dwarf_Addr base, void *cb_arg) { struct find_symbol_by_name_arg *arg = cb_arg; int symtab_len, i; symtab_len = dwfl_module_getsymtab(dwfl_module); i = dwfl_module_getsymtab_first_global(dwfl_module); if (symtab_len == -1 || i == -1) { arg->bad_symtabs = true; return DWARF_CB_OK; } for (; i < symtab_len; i++) { GElf_Sym elf_sym; GElf_Addr elf_addr; const char *name; name = dwfl_module_getsym_info(dwfl_module, i, &elf_sym, &elf_addr, NULL, NULL, NULL); if (name && strcmp(arg->name, name) == 0) { struct drgn_symbol *sym; sym = malloc(sizeof(*sym)); if (sym) { sym->name = name; sym->address = elf_addr; sym->size = elf_sym.st_size; *arg->ret = sym; } else { arg->err = &drgn_enomem; } return DWARF_CB_ABORT; } } return DWARF_CB_OK; } LIBDRGN_PUBLIC struct drgn_error * drgn_program_find_symbol_by_name(struct drgn_program *prog, const char *name, struct drgn_symbol **ret) { struct find_symbol_by_name_arg arg = { .name = name, .ret = ret, }; if (prog->_dbinfo && dwfl_getmodules(prog->_dbinfo->dwfl, find_symbol_by_name_cb, &arg, 0)) return arg.err; return drgn_error_format(DRGN_ERROR_LOOKUP, "could not find symbol with name '%s'%s", name, arg.bad_symtabs ? " (could not get some symbol tables)" : ""); } LIBDRGN_PUBLIC struct drgn_error * drgn_program_element_info(struct drgn_program *prog, struct drgn_type *type, struct drgn_element_info *ret) { struct drgn_type *underlying_type; bool is_pointer, is_array; underlying_type = drgn_underlying_type(type); is_pointer = drgn_type_kind(underlying_type) == DRGN_TYPE_POINTER; is_array = drgn_type_kind(underlying_type) == DRGN_TYPE_ARRAY; if (!is_pointer && !is_array) return drgn_type_error("'%s' is not an array or pointer", type); ret->qualified_type = drgn_type_type(underlying_type); return drgn_type_bit_size(ret->qualified_type.type, &ret->bit_size); }