Unix Man (Справочное руководство)

         

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.



Содержание раздела