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