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>). Это может произойти по следующим причинам:

Если не найдена таблица цепочек.
Если под таблицу цепочек не хватает памяти.
Если обнаруживается некорректность таблицы цепочек.
Если смещение имени в таблице цепочек указывает за пределы таблицы.

Как правило, ldgetname вызывается сразу после успешного обращения к для извлечения текста имени, соответствующего элементу таблицы, прочитанному функцией ldtbread.

При редактировании связей вызывающей программы следует подключить библиотеку программ доступа к об ектным файлам libld.a.

СМ. ТАКЖЕ

, , , , .

Содержание раздела