Unix Man (Справочное руководство)


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.

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

СМ. ТАКЖЕ


, , , , .




Начало  Назад  Вперед