19380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard/* Interfaces for libdwelf. DWARF ELF Low-level Functions. 20c32b6f086b9838fe4b7d93575068554d0c420f7Mark Wielaard Copyright (C) 2014, 2015 Red Hat, Inc. 39380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard This file is part of elfutils. 49380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 59380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard This file is free software; you can redistribute it and/or modify 69380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard it under the terms of either 79380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 89380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard * the GNU Lesser General Public License as published by the Free 99380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard Software Foundation; either version 3 of the License, or (at 109380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard your option) any later version 119380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 129380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard or 139380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 149380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard * the GNU General Public License as published by the Free 159380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard Software Foundation; either version 2 of the License, or (at 169380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard your option) any later version 179380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 189380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard or both in parallel, as here. 199380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 209380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard elfutils is distributed in the hope that it will be useful, but 219380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard WITHOUT ANY WARRANTY; without even the implied warranty of 229380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 239380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard General Public License for more details. 249380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 259380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard You should have received copies of the GNU General Public License and 269380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard the GNU Lesser General Public License along with this program. If 279380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard not, see <http://www.gnu.org/licenses/>. */ 289380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 299380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard#ifndef _LIBDWELF_H 309380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard#define _LIBDWELF_H 1 319380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 329380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard#include "libdw.h" 339380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 349380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard#ifdef __cplusplus 359380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaardextern "C" { 369380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard#endif 379380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 389380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard/* DWARF ELF Low-level Functions (dwelf). 399380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard Functions starting with dwelf_elf will take a (libelf) Elf object as 409380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard first argument and might set elf_errno on error. Functions starting 419380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard with dwelf_dwarf will take a (libdw) Dwarf object as first argument 429380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard and might set dwarf_errno on error. */ 439380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 449380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard/* Returns the name and the CRC32 of the separate debug file from the 459380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard .gnu_debuglink section if found in the ELF. Return NULL if the ELF 469380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard file didn't have a .gnu_debuglink section, had malformed data in the 479380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard section or some other error occured. */ 489380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaardextern const char *dwelf_elf_gnu_debuglink (Elf *elf, GElf_Word *crc); 499380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 504813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer/* Returns the name and build ID from the .gnu_debugaltlink section if 514813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer found in the ELF. On success, pointers to the name and build ID 524813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer are written to *NAMEP and *BUILDID_P, and the positive length of 534813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer the build ID is returned. Returns 0 if the ELF lacks a 544813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer .gnu_debugaltlink section. Returns -1 in case of malformed data or 554813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer other errors. */ 564813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimerextern ssize_t dwelf_dwarf_gnu_debugaltlink (Dwarf *dwarf, 574813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer const char **namep, 584813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer const void **build_idp); 594813dbbcb81a0f5ebbc9756fe6f4ed62d298b011Florian Weimer 60d81d32d2a4f92355e4c677b578147dfe819251b9Mark Wielaard/* Returns the build ID as found in a NT_GNU_BUILD_ID note from either 61d81d32d2a4f92355e4c677b578147dfe819251b9Mark Wielaard a SHT_NOTE section or from a PT_NOTE segment if the ELF file 62d81d32d2a4f92355e4c677b578147dfe819251b9Mark Wielaard doesn't contain any section headers. On success a pointer to the 63d81d32d2a4f92355e4c677b578147dfe819251b9Mark Wielaard build ID is written to *BUILDID_P, and the positive length of the 64d81d32d2a4f92355e4c677b578147dfe819251b9Mark Wielaard build ID is returned. Returns 0 if the ELF lacks a NT_GNU_BUILD_ID 65d81d32d2a4f92355e4c677b578147dfe819251b9Mark Wielaard note. Returns -1 in case of malformed data or other errors. */ 66d81d32d2a4f92355e4c677b578147dfe819251b9Mark Wielaardextern ssize_t dwelf_elf_gnu_build_id (Elf *elf, const void **build_idp); 67d81d32d2a4f92355e4c677b578147dfe819251b9Mark Wielaard 680c32b6f086b9838fe4b7d93575068554d0c420f7Mark Wielaard/* Returns the size of the uncompressed data of a GNU compressed 690c32b6f086b9838fe4b7d93575068554d0c420f7Mark Wielaard section. The section name should start with .zdebug (but this 700c32b6f086b9838fe4b7d93575068554d0c420f7Mark Wielaard isn't checked by this function). If the section isn't compressed 710c32b6f086b9838fe4b7d93575068554d0c420f7Mark Wielaard (the section data doesn't start with ZLIB) -1 is returned. If an 720c32b6f086b9838fe4b7d93575068554d0c420f7Mark Wielaard error occured -1 is returned and elf_errno is set. */ 730c32b6f086b9838fe4b7d93575068554d0c420f7Mark Wielaardextern ssize_t dwelf_scn_gnu_compressed_size (Elf_Scn *scn); 740c32b6f086b9838fe4b7d93575068554d0c420f7Mark Wielaard 759380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard#ifdef __cplusplus 769380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard} 779380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard#endif 789380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard 799380297e130e6ccc829c8d56d701fb539b27bb0fMark Wielaard#endif /* libdwelf.h */ 80