Commit | Line | Data |
---|---|---|
32e2dce8 KT |
1 | .th NLIST III 6/12/72 |
2 | .sh NAME | |
3 | nlist \*- get entries from name list | |
4 | .sh SYNOPSIS | |
5 | .ft B | |
6 | .lp +6 6 | |
7 | jsr r5,nlist; file; list | |
8 | .lp +6 6 | |
9 | ... | |
10 | .lp +6 6 | |
11 | file: <file name\\0>; .even | |
12 | .lp +6 6 | |
13 | list: <name1xxx>; type1; value1 | |
14 | .lp +6 6 | |
15 | <name2xxx>; type2; value2 | |
16 | .lp +6 6 | |
17 | ... | |
18 | .lp +6 6 | |
19 | 0 | |
20 | .s3 | |
21 | .nf | |
22 | .i0 | |
23 | nlist(filename, nl) | |
24 | char *filename; | |
25 | .dt | |
26 | struct { | |
27 | char name[8]; | |
28 | int type; | |
29 | int value; | |
30 | } nl[ ]; | |
31 | .fi | |
32 | .ft R | |
33 | .sh DESCRIPTION | |
34 | .it Nlist | |
35 | examines the name list in | |
36 | the given executable output file | |
37 | and selectively extracts a | |
38 | list of values. | |
39 | The name list consists of | |
40 | a list of 8-character names (null padded) | |
41 | each followed by two words. | |
42 | The list is terminated with a null name. | |
43 | Each name is looked up in the name list of | |
44 | the file. | |
45 | If the name is found, the type and value of the | |
46 | name are placed in the two words following | |
47 | the name. | |
48 | If the name is not found, the type entry is set to \*-1. | |
49 | .s3 | |
50 | This subroutine is useful for | |
51 | examining the system name list kept in | |
52 | the file | |
53 | \fB/usr/sys/unix\fR. | |
54 | In this way programs can obtain system addresses | |
55 | that are up to date. | |
56 | .sh "SEE ALSO" | |
57 | a.out(V) | |
58 | .sh DIAGNOSTICS | |
59 | All | |
60 | type entries are set to \*-1 if the file cannot be found | |
61 | or if it is not a valid namelist. | |
62 | .sh BUGS |