unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (4.4BSD-Lite2)
Page:
Section:
Apropos / Subsearch:
optional field

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

NAME
     kvm_nlist - retrieve symbol table names from a kernel image

SYNOPSIS
     #include <&lt;kvm.h>&gt;
     #include <&lt;nlist.h>&gt;

     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)

4.4BSD                           June 4, 1993                                1