ОБЗОР

#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	символ является объектом скрытого кода

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

Значение	Описание
STB_LOCAL	локальный символ
STB_GLOBAL	глобальный символ
STB_WEAK	символ со слабой привязкой
STB_GNU_UNIQUE	уникальный символ

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

Значение	Описание
STV_DEFAULT	видимость символа по умолчательным правилам
STV_INTERNAL	скрытый класс, связанный с процессором
STV_HIDDEN	символ недоступен в других модулях
STV_PROTECTED	не вытесняемый, не экспортируемый

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

Если адрес, указанный addr, мог бы совпасть с общим объектом, то эти функции возвращают 0. В этом случае сообщение об ошибке не доступно через dlerror(3).

ВЕРСИИ

АТРИБУТЫ

СООТВЕТСТВИЕ СТАНДАРТАМ