_       _
| |_ ___| |_ _
|   | . | | | |
|_|_|___|_|_  |
          |___|

file src/elf.h

#ifndef HOLY_ELF_H
#define HOLY_ELF_H

#include <stdint.h>
#include <stddef.h>

struct holy_elf_version {
    char *provider;
    char *name;
    int weak;
    uint16_t index;
};

struct holy_elf_definition {
    char *name;
    uint16_t index;
};

struct holy_elf_symbol {
    char *name;
    /* raw ELF values; section zero denotes an undefined reference. */
    unsigned binding, type, visibility;
    uint16_t section, version_index;
    int version_hidden;
    const char *version, *provider; /* borrowed from version records */
};

struct holy_elf_info {
    int elf_class;
    uint16_t machine;
    uint16_t type;
    int has_dynamic;
    uint64_t flags1;
    char *interpreter;
    /* the GNU build-id note as lowercase hex, or NULL when the file states none; it
       is what ties a stripped runtime file to a separate debug file */
    char *build_id;
    char **needed;
    size_t needed_count;
    char *soname;
    char *rpath;
    char *runpath;
    struct holy_elf_version *versions;
    size_t version_count;
    struct holy_elf_definition *defined_versions;
    size_t defined_version_count;
    struct holy_elf_symbol *symbols;
    size_t symbol_count;
    uint32_t isa_needed;
    int isa_present;
};

/* returns 0 on parsed ELF, 1 on non-ELF, 2 on malformed/unsupported ELF.
   read_fd borrows a regular-file descriptor and does not change its offset.
   the caller frees the info after any result. */
int holy_elf_read_fd(int fd, struct holy_elf_info *info);
int holy_elf_read(const char *path, struct holy_elf_info *info);
void holy_elf_free(struct holy_elf_info *info);
/* writes the GNU build-id note of one regular file as lowercase hex, or returns 0
   when the file is not an ELF or states no note. this reads only the notes, so it
   also answers for a separate debug file whose other sections a strict reader would
   refuse. the caller owns a 65-byte buffer on success. */
int holy_elf_build_id(const char *path, char *hex);
const char *holy_elf_machine(const struct holy_elf_info *info);
const char *holy_elf_runtime(const struct holy_elf_info *info);
const char *holy_elf_isa(const struct holy_elf_info *info);
int holy_elf_exports_symbol(const struct holy_elf_info *provider,
                            const struct holy_elf_symbol *wanted);
int holy_elf_kernel_module_fd(int fd, const struct holy_elf_info *info,
                              const char *release, size_t release_length);

#endif