NAME    [Toc]    [Back]

     kvm_nlist - retrieve symbol table names from a kernel image

SYNOPSIS    [Toc]    [Back]

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

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

DESCRIPTION    [Toc]    [Back]

     kvm_nlist() retrieves the symbol table entries indicated  by
the name list
     argument  nl.   This  argument  points  to an array of nlist
structures, terminated
  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    [Toc]    [Back]

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

FILES    [Toc]    [Back]

     /var/db/kvm_bsd.db

SEE ALSO    [Toc]    [Back]

     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)

OpenBSD      3.6                           June      4,      1993