Provided by: manpages-ru-dev_4.21.0-2_all bug

ИМЯ

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

LIBRARY

       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;  /* путь к общему объекту, который
                                          содержит адрес */
               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
              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;  /* разница между
                                             адресом в файле 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        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).

ВЕРСИИ

       Функция dladdr() есть в glibc 2.0 и новее. Функция dladdr1()  впервые  появилась  в  glibc
       2.3.3.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).

       ┌───────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │ИнтерфейсАтрибутЗначение │
       ├───────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │dladdr(), dladdr1()                                    │ Безвредность в нитях │ MT-Safe  │
       └───────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       Данные  функции  являются  нестандартными  расширениями  GNU, которые также присутствуют в
       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 версии 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе  этой  страницы  руководства,  пожалуйста,  отправьте
       электронное письмо на ⟨man-pages-ru-talks@lists.sourceforge.net⟩.