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