dladdr(3)

НАИМЕНОВАНИЕ
dladdr, dladdr1 - транслирует адрес в информацию о символе

БИБЛИОТЕКА
Dynamic linking library (libdl, -ldl)

СИНТАКСИС
#define _GNU_SOURCE
#include <dlfcn.h>

int dladdr(const void *addr, Dl_info *info);
int dladdr1(const void *addr, Dl_info *info, void **extra_info,
            int flags);

ОПИСАНИЕ
Функция dladdr() определяет, в каком из загруженных общих объектов приложения расположен адрес, указанный в addr. Если объект находится, то dladdr() возвращает информацию об общем объекте и символе, который относится к адресу addr. Данная информация возвращается в виде структуры Dl_info:

    typedef struct {
        const char *dli_fname;  /* Pathname of shared object that
                                   contains address */
        void       *dli_fbase;  /* Base address at which shared
                                   object is loaded */
        const char *dli_sname;  /* Name of symbol whose definition
                                   overlaps addr */
        void       *dli_saddr;  /* Exact address of symbol named
                                   in dli_sname */
    } Dl_info;

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

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

RTLD_DL_LINKMAP
    Obtain a pointer to the link map for the matched file. The extra_info argument points to a pointer to a link_map structure (i.e., struct link_map **), defined in <link.h> as:

        struct link_map {
            ElfW(Addr) l_addr;  /* Difference between the
                                   address in the ELF file and
                                   the address in memory */
            char      *l_name;  /* Absolute pathname where
                                   object was found */
            ElfW(Dyn) *l_ld;    /* Dynamic section of the
                                   shared object */
            struct link_map *l_next, *l_prev;
                                /* Chain of loaded objects */

            /* Plus additional fields private to the
               implementation */
        };

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 | Symbol's name is filename
    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, мог бы совпасть с общим объектом, но не с символом в общем объекте, то полям info->dli_sname и info->dli_saddr присваивается значение NULL.

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

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
dladdr(), dladdr1() | Безвредность в нитях | MT-Safe

СТАНДАРТЫ
GNU.

ИСТОРИЯ

dladdr()
    glibc 2.0.

dladdr1()
    glibc 2.3.3.

Solaris.

ПРОГРАММНЫЕ ОШИБКИ
Иногда указатели на функции, передаваемые в dladdr(), могут вас удивить. На некоторых архитектурах (в частности, i386- и x86-64), dli_fname и dli_fbase могут указывать на объект, из которого вызывалась функция dladdr(), даже если функция, использовавшаяся как аргумент, должна быть из динамически скомпонованной библиотеки.

Проблема в том, что указатель на функцию по прежнему ищется во время компиляции, но всего лишь указывает на раздел plt (таблицу компоновки процедур) первоначального объекта (которая размещает вызов после запроса динамического компоновщика на поиск символа). Чтобы обойти это, вы можете попробовать скомпилировать независимый от размещения код: в этом случае компилятор больше не сможет подготовить указатель во время компиляции и gcc(1) создаст код, который просто загрузит конечный адрес символа из got (глобальной таблицы смещений) при запуске до передачи его в dladdr().

СМОТРИТЕ ТАКЖЕ
dl_iterate_phdr(3), dlinfo(3), dlopen(3), dlsym(3), ld.so(8)

ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков (debian-l10n-russian@lists.debian.org).