|
|
1.1 ! root 1: .\" Copyright (c) 1980 Regents of the University of California. ! 2: .\" All rights reserved. The Berkeley software License Agreement ! 3: .\" specifies the terms and conditions for redistribution. ! 4: .\" ! 5: .\" @(#)nlist.3 6.1 (Berkeley) 5/15/85 ! 6: .\" ! 7: .TH NLIST 3 "May 15, 1985" ! 8: .UC 4 ! 9: .SH NAME ! 10: nlist \- get entries from name list ! 11: .SH SYNOPSIS ! 12: .nf ! 13: .B #include <nlist.h> ! 14: .PP ! 15: .B nlist(filename, nl) ! 16: .B char *filename; ! 17: .B struct nlist nl[]; ! 18: .fi ! 19: .SH DESCRIPTION ! 20: .I Nlist ! 21: examines the name list in the given executable output file ! 22: and selectively extracts a list of values. ! 23: The name list consists of an array of structures containing names, ! 24: types and values. ! 25: The list is terminated with a null name. ! 26: Each name is looked up in the name list of 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 examining the system name list kept in the file ! 35: .BR /vmunix . ! 36: In this way programs can obtain system addresses that are up to date. ! 37: .SH "SEE ALSO" ! 38: a.out(5) ! 39: .SH DIAGNOSTICS ! 40: If the file cannot be found or if it is not a valid namelist \-1 is returned; ! 41: otherwise, the number of unfound namelist entries is returned. ! 42: .PP ! 43: The type entry is set to 0 if the symbol is not found.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.