|
НАЗВАНИЕ
nlist - получение элементов таблицы имен
СИНТАКСИС
#include <nlist.h> int nlist (filename, nl) char *filename; struct nlist *nl;
ОПИСАНИЕ
Аргумент filename указывает на маршрутное имя выполняемого файла, аргумент nl - на массив структур типа
nlist. Функция nlist просматривает таблицу имен выполняемого файла и выделяет информацию об именах, перечисленных в массиве nl, признаком конца которого является
структура с пустой цепочкой в качестве имени. Если имя
удалось найти в выполняемом файле, то в соответствующие
поля той же структуры nlist помещается информация о
значении и типе имени. Если файл был скомпилирован без
опции -g, в поле типа записывается 0. Если имя не найдено, обнуляются оба поля. Более подробную информацию о
структуре таблицы имен можно найти в a.out(4).
Данная функция полезна для исследования системной таблицы имен, содержащейся в файле /unix, поскольку позволяет получить системные адреса текущей версии.
ПРИМЕЧАНИЯ
Для совместимости файл <nlist.h> автоматически включается в текст в файле <a.out.h>. Однако не стоит включать весь файл <a.out.h>, если единственное, что необходимо из него - структура nlist.
СМ. ТАКЖЕ
a.out(4).
ДИАГНОСТИКА
Все элементы обнуляются в том случае, если выполняемый
файл не доступен на чтение или он не содержит корректной таблицы имен.
В случае ошибки функция nlist возвращает -1; в противном случае результат равен 0.
|