NLIST(3C)
NLIST(3C)
НАЗВАНИЕ
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.
