---

   dladdr1 - транслирует адрес в информацию о символе

---

Other Alias

---

ОБЗОР

#define _GNU_SOURCE
#include <dlfcn.h>
int dladdr(void *addr, Dl_info *info);
int dladdr1(void *addr, Dl_info *info, void **extra_info, int flags);
Компонуется при указании параметра -ldl.

---

ОПИСАНИЕ

typedef struct {
    const char *dli_fname;  /* путь к общему объекту, который
                               содержит адрес */
    void       *dli_fbase;  /* начальный адрес, по которому расположен
                               общий объект */
    const char *dli_sname;  /* имя символа, к которому относится
                               адрес addr */
    void       *dli_saddr;  /* точный адрес символа с
                               именем dli_sname */
} Dl_info;

Если символ, соответствующий адресу addr, не найден, то dli_sname и dli_saddr устанавливаются в NULL.

Функция dladdr1() подобна dladdr(), но возвращает дополнительную информацию в аргументе extra_info. Возвращаемая информация зависит от значения, указанного в flags, которое может быть одним из:

RTLD_DL_LINKMAP Возвратить указатель на карту ссылок для совпадающего файла. Аргумент extra_info указывает на указатель на структуру link_map (т. е., struct link_map **), определённую в <link.h> так:

struct link_map {
    ElfW(Addr) l_addr;  /* разница между
                           адресом в файле ELF и
                           адресом в памяти */
    char      *l_name;  /* абсолютный путь, где
                           был найден объект */
    ElfW(Dyn) *l_ld;    /* динамический раздел
                           общего объекта */
    struct link_map *l_next, *l_prev;
                        /* цепочка загруженных объектов */
    /* дополнительные поля, зависящие от
       реализации */
};

RTLD_DL_SYMENT Возвращает указатель на элемент символьной таблицы ELF с совпадающим символом. Аргумент extra_info — указатель на символьный указатель: const ElfW(Sym) **. Макрос ElfW() преобразует этот аргумент в имя типа данных ELF, подходящее для аппаратной архитектуры. Например, на 64-битной платформе ElfW(Sym) возвращает имя типа данных Elf64_Sym, которое определено в <elf.h> так:

typedef struct  {
    Elf64_Word    st_name;     /* имя символа */
    unsigned char st_info;     /* тип символа и привязка */
    unsigned char st_other;    /* видимость символа */
    Elf64_Section st_shndx;    /* номер раздела */
    Elf64_Addr    st_value;    /* значение символа */
    Elf64_Xword   st_size;     /* размер символа */
} Elf64_Sym;

Поле st_name — номер в строковой таблице.

В поле st_info закодирован тип и привязка символа. Тип можно извлечь с помощью макроса ELF64_ST_TYPE(st_info) (или ELF32_ST_TYPE(), на 32-битных платформах), который возвращает одно из следующих значений:

Значение Описание
STT_NOTYPE тип символа не указан
STT_OBJECT символ является объектом данных
STT_FUNC Символ является объектом кода
STT_SECTION символ, связанный с разделом
STT_FILE имя символа является именем файла
STT_COMMON символ является объектом общих данных
STT_TLS символ является объектом локальных данных нити
STT_GNU_IFUNC символ является объектом скрытого кода