KVM_NLIST(3) UNIX Programmer’s Manual KVM_NLIST(3)

NAME
kvm_nlist - retrieve symbol table names from a kernel image

SYNOPSIS
#include <kvm.h>
#include <nlist.h>

int
kvm_nlist(kvm_t *kd, struct nlist *nl)

DESCRIPTION
kvm_nlist() retrieves the symbol table entries indicated by the name list
argument nl. 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, kvm_nlist() uses it
to speed lookups.

RETURN VALUES
The kvm_nlist() function returns the number of invalid entries found. If
the kernel symbol table was unreadable, -1 is returned.

FILES
/var/db/kvm_vmunix.db

SEE ALSO
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)

BSD Experimental June 4, 1993 1