|
|
1.1 root 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
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.