79 lines
3.1 KiB
C
79 lines
3.1 KiB
C
/* Interfaces for libdwelf. DWARF ELF Low-level Functions.
|
|
Copyright (C) 2014, 2015 Red Hat, Inc.
|
|
This file is part of elfutils.
|
|
|
|
This file is free software; you can redistribute it and/or modify
|
|
it under the terms of either
|
|
|
|
* the GNU Lesser General Public License as published by the Free
|
|
Software Foundation; either version 3 of the License, or (at
|
|
your option) any later version
|
|
|
|
or
|
|
|
|
* the GNU General Public License as published by the Free
|
|
Software Foundation; either version 2 of the License, or (at
|
|
your option) any later version
|
|
|
|
or both in parallel, as here.
|
|
|
|
elfutils is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
General Public License for more details.
|
|
|
|
You should have received copies of the GNU General Public License and
|
|
the GNU Lesser General Public License along with this program. If
|
|
not, see <http://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef _LIBDWELF_H
|
|
#define _LIBDWELF_H 1
|
|
|
|
#include "libdw.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* DWARF ELF Low-level Functions (dwelf).
|
|
Functions starting with dwelf_elf will take a (libelf) Elf object as
|
|
first argument and might set elf_errno on error. Functions starting
|
|
with dwelf_dwarf will take a (libdw) Dwarf object as first argument
|
|
and might set dwarf_errno on error. */
|
|
|
|
/* Returns the name and the CRC32 of the separate debug file from the
|
|
.gnu_debuglink section if found in the ELF. Return NULL if the ELF
|
|
file didn't have a .gnu_debuglink section, had malformed data in the
|
|
section or some other error occured. */
|
|
extern const char *dwelf_elf_gnu_debuglink (Elf *elf, GElf_Word *crc);
|
|
|
|
/* Returns the name and build ID from the .gnu_debugaltlink section if
|
|
found in the ELF. On success, pointers to the name and build ID
|
|
are written to *NAMEP and *BUILDID_P, and the positive length of
|
|
the build ID is returned. Returns 0 if the ELF lacks a
|
|
.gnu_debugaltlink section. Returns -1 in case of malformed data or
|
|
other errors. */
|
|
extern ssize_t dwelf_dwarf_gnu_debugaltlink (Dwarf *dwarf,
|
|
const char **namep,
|
|
const void **build_idp);
|
|
|
|
/* Returns the build ID as found in a NT_GNU_BUILD_ID note from either
|
|
a SHT_NOTE section or from a PT_NOTE segment if the ELF file
|
|
doesn't contain any section headers. On success a pointer to the
|
|
build ID is written to *BUILDID_P, and the positive length of the
|
|
build ID is returned. Returns 0 if the ELF lacks a NT_GNU_BUILD_ID
|
|
note. Returns -1 in case of malformed data or other errors. */
|
|
extern ssize_t dwelf_elf_gnu_build_id (Elf *elf, const void **build_idp);
|
|
|
|
/* Returns the size of the uncompressed data of a GNU compressed
|
|
section. The section name should start with .zdebug (but this
|
|
isn't checked by this function). If the section isn't compressed
|
|
(the section data doesn't start with ZLIB) -1 is returned. If an
|
|
error occured -1 is returned and elf_errno is set. */
|
|
extern ssize_t dwelf_scn_gnu_compressed_size (Elf_Scn *scn);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* libdwelf.h */
|