KVM_NLIST(3)                BSD Programmer's Manual               KVM_NLIST(3)

NAME
     kvmnlist - retrieve symbol table names from a kernel image

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

     int
     kvmnlist(kvmt *kd, struct nlist *nl)

DESCRIPTION
     kvmnlist() 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, kvmnlist() uses it
     to speed lookups.

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

FILES
     /var/run/kvm_bsd.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)

BSDI BSD/386                    March 26, 1993                               1