KVM_NLIST(3)            NetBSD Library Functions Manual           KVM_NLIST(3)

NAME
     kvm_nlist -- retrieve symbol table names from a kernel image

LIBRARY
     Kernel Data Access Library (libkvm, -lkvm)

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, ter-
     minated by an entry whose n_name field is NULL (see nlist(3)).  Each sym-
     bol 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.

     If kd was created by a call to kvm_open() with a NULL executable image
     name, kvm_nlist() will use /dev/ksyms to retrieve the kernel symbol ta-
     ble.

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

FILES
     /dev/ksyms

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), ksyms(4)

NetBSD 5.0_STABLE                May 11, 2003                NetBSD 5.0_STABLE
