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.