source: mainline/uspace/lib/c/include/elf/elf_mod.h@ d7f7a4a

/*
 * SPDX-FileCopyrightText: 2006 Sergey Bondari
 * SPDX-FileCopyrightText: 2008 Jiri Svoboda
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

/** @addtogroup libc
 * @{
 */
/** @file
 * @brief ELF loader structures and public functions.
 */

#ifndef ELF_MOD_H_
#define ELF_MOD_H_

#include <elf/elf.h>
#include <stddef.h>
#include <stdint.h>
#include <loader/pcb.h>

typedef enum {
        /** Leave all segments in RW access mode. */
        ELDF_RW = 1
} eld_flags_t;

/** TLS info for a module */
typedef struct {
        /** tdata section image */
        void *tdata;
        /** Size of tdata section image in bytes */
        size_t tdata_size;
        /** Size of tbss section */
        size_t tbss_size;
        /** Alignment of TLS initialization image */
        size_t tls_align;
} elf_tls_info_t;

/**
 * Some data extracted from the headers are stored here
 */
typedef struct {
        /** Entry point */
        entry_point_t entry;

        /** The base address where the file has been loaded.
         *  Points to the ELF file header.
         */
        void *base;

        /** ELF interpreter name or NULL if statically-linked */
        const char *interp;

        /** Pointer to the dynamic section */
        void *dynamic;

        /** TLS info */
        elf_tls_info_t tls;
} elf_finfo_t;

/**
 * Holds information about an ELF binary being loaded.
 */
typedef struct {
        /** Filedescriptor of the file from which we are loading */
        int fd;

        /** Difference between run-time addresses and link-time addresses */
        uintptr_t bias;

        /** Flags passed to the ELF loader. */
        eld_flags_t flags;

        /** Store extracted info here */
        elf_finfo_t *info;
} elf_ld_t;

extern errno_t elf_load_file(int, eld_flags_t, elf_finfo_t *);
extern errno_t elf_load_file_name(const char *, eld_flags_t, elf_finfo_t *);

#endif

/** @}
 */