Commit | Line | Data |
---|---|---|
cfd13a90 C |
1 | .TH NLIST 3 "19 January 1983" |
2 | .UC 4 | |
3 | .SH NAME | |
4 | nlist \- get entries from name list | |
5 | .SH SYNOPSIS | |
6 | .nf | |
7 | .B #include <nlist.h> | |
8 | .PP | |
9 | .B nlist(filename, nl) | |
10 | .B char *filename; | |
11 | .B struct nlist nl[]; | |
12 | .fi | |
13 | .SH DESCRIPTION | |
14 | .I Nlist | |
15 | examines the name list in the given executable output file | |
16 | and selectively extracts a list of values. | |
17 | The name list consists of an array of structures containing names, | |
18 | types and values. | |
19 | The list is terminated with a null name. | |
20 | Each name is looked up in the name list of the file. | |
21 | If the name is found, the type and value of the | |
22 | name are inserted in the next two fields. | |
23 | If the name is not found, both entries are set to 0. | |
24 | See | |
25 | .IR a.out (5) | |
26 | for the structure declaration. | |
27 | .PP | |
28 | This subroutine is useful for examining the system name list kept in the file | |
29 | .BR /vmunix . | |
30 | In this way programs can obtain system addresses that are up to date. | |
31 | .SH "SEE ALSO" | |
32 | a.out(5) | |
33 | .SH DIAGNOSTICS | |
34 | All type entries are set to 0 if the file cannot be found | |
35 | or if it is not a valid namelist. |