projects / unix-history / blame
| 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. |