BSD 4_4 development
[unix-history] / usr / share / man / cat3 / kvm_nlist.0
KVM_NLIST(3) BSD Programmer's Manual KVM_NLIST(3)
N\bNA\bAM\bME\bE
k\bkv\bvm\bm_\b_n\bnl\bli\bis\bst\bt - retrieve symbol table names from a kernel image
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<k\bkv\bvm\bm.\b.h\bh>\b>
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<n\bnl\bli\bis\bst\bt.\b.h\bh>\b>
_\bi_\bn_\bt
k\bkv\bvm\bm_\b_n\bnl\bli\bis\bst\bt(_\bk_\bv_\bm_\b__\bt _\b*_\bk_\bd, _\bs_\bt_\br_\bu_\bc_\bt _\bn_\bl_\bi_\bs_\bt _\b*_\bn_\bl);
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
k\bkv\bvm\bm_\b_n\bnl\bli\bis\bst\bt() retrieves the symbol table entries indicated by the name list
argument _\bn_\bl. This argument points to an array of nlist structures, termi-
nated by an entry whose n_name field is NULL (see nlist(3)). Each symbol
is looked up using the n_name field, and if found, the corresponding
n_type and n_value fields are filled in. These fields are set to 0 if
the symbol is not found.
The program kvm_mkdb(8) builds a database from the running kernel's
namelist. If the database matches the opened kernel, k\bkv\bvm\bm_\b_n\bnl\bli\bis\bst\bt() uses it
to speed lookups.
R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bES\bS
The k\bkv\bvm\bm_\b_n\bnl\bli\bis\bst\bt() function returns the number of invalid entries found. If
the kernel symbol table was unreadable, -1 is returned.
F\bFI\bIL\bLE\bES\bS
/var/db/kvm_vmunix.db
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
kvm(3), kvm_close(3), kvm_getargv(3), kvm_getenvv(3), kvm_geterr(3),
kvm_getprocs(3), kvm_open(3), kvm_openfiles(3), kvm_read(3),
kvm_write(3), kvm_mkdb(8)
4.4BSD June 4, 1993 1