LDLREAD(3X)
НАЗВАНИЕ
ldlread, ldlinit, ldlitem - работа с таблицей номеров
строк, хранящейся в объектном файле обычного формата
СИНТАКСИС
#include <stdio.h>
#include <filehdr.h>
#include <linenum.h>
#include <ldfcn.h>
int ldlread (ldptr, fcnindx, linenum, linent)
LDFILE *ldptr;
long fcnindx;
unsigned short linenum;
LINENO *linent;
int ldlinit (ldptr, fcnindx)
LDFILE *ldptr;
long fcnindx;
int ldlitem (ldptr, linenum, linent)
LDFILE *ldptr;
unsigned short linenum;
LINENO *linent;
ОПИСАНИЕ
Функция ldlread предназначена для поиска информации в
таблице номеров строк, хранящейся в объектном файле,
указанном аргументом ldptr. Поиск начинается с информа-
ции о первой строке некоторой функции и ограничивается
данными, относящимися к этой функции. Функция задается
аргументом fcnindx - индексом имени функции в таблице
имен объектного файла. Ldlread читает информацию о пер-
вой из строк, номер которой не меньше linenum, в об-
ласть памяти с адресом linent.
Функции ldlinit и ldlitem совместно делают то же, что и
ldlread. Вызов ldlinit (или ldlread) инициализирует по-
иск, после чего ldlitem используется для извлечения
последовательности элементов таблицы номеров строк, от-
носящихся к одной функции. Ldlinit определяет, где на-
ходятся данные о строках, принадлежащих функции
fcnindx. Ldlitem ищет и читает информацию о первой из
строк, номер которой не меньше linenum, в область памя-
ти с адресом linent.
Все три функции возвращают значения SUCCESS или
FAILURE. Ldlread возвращает FAILURE, если:
- В объектном файле нет таблицы номеров строк.
- Аргумент fcnindx не является индексом функции в
таблице имен.
- В таблице номеров строк нет элемента с номером, не
меньшим linenum.
Функция ldlinit возвращает FAILURE, если:
- В объектном файле нет таблицы номеров строк.
- Аргумент fcnindx не является индексом функции в
таблице имен.
Функция ldlitem возвращает FAILURE, если:
- В таблице номеров строк нет элемента с номером, не
меньшим linenum.
При редактировании связей вызывающей программы следует
подключить библиотеку программ доступа к объектным фай-
лам libld.a.
СМ. ТАКЖЕ
ldclose(3X), ldopen(3X), ldtbindex(3X), ldfcn(4).
|
