LDGETNAME(3X)                                     LDGETNAME(3X)
НАЗВАНИЕ
ldgetname  -  получение  текста  имени элемента таблицы
        имен объектного файла
СИНТАКСИС
       |#include <stdio.h>
       |#include <filehdr.h>
       |#include <syms.h>
       |#include <ldfcn.h>
       |
       |char *ldgetname (ldptr, symbol)
       |LDFILE *ldptr;
       |SYMENT *symbol;
ОПИСАНИЕ
Функция ldgetname возвращает указатель на имя,  связан-
        ное  с  элементом  symbol таблицы имен. Текст имени как
        цепочка символов помещается в локальный статический бу-
        фер функции ldgetname и обновляется при каждом  вызове,
        поэтому  для  сохранения  текста  вызывающая  программа
        должна его скопировать.
        Использование ldgetname не вызывает каких-либо проблем,
        связанных  с  совместимостью  объектных  файлов   снизу
        вверх. При невозможности получения имени функция  возв-
        ращает значение NULL (определенное во включаемом  файле
        <stdio.h>). Это может произойти по следующим причинам:
        1.   Если не найдена таблица цепочек.
                          
        2.   Если под таблицу цепочек не хватает памяти.
                         
        3.   Если обнаруживается некорректность  таблицы  цепо-
             чек.
                                       
        4.   Если смещение имени в таблице цепочек указывает за
             пределы таблицы.
        Как правило, ldgetname вызывается сразу после успешного
        обращения  к  ldtbread(3X) для извлечения текста имени,
        соответствующего элементу таблицы, прочитанному функци-
        ей ldtbread.                                           
                                                               
        При редактировании связей вызывающей программы  следует
        подключить библиотеку программ доступа к объектным фай-
        лам libld.a.
                                                               
СМ. ТАКЖЕ                                                      
        ldclose(3X),  ldopen(3X),  ldtbread(3X),  ldtbseek(3X),
        ldfcn(4).