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.