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

The kvm_nlist() function 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 kldsym(2) system call is used to locate the symbol.

This is a less
than perfect emulation of the nlist values but has the ad

vantage of being
aware of kernel modules and is reasonably fast.

RETURN VALUES

The kvm_nlist() function returns the number of invalid en

tries found. If
the kernel symbol table was unreadable, -1 is returned.

SEE ALSO

kldsym(2), kvm(3), kvm_close(3), kvm_getargv(3),

kvm_getenvv(3),
kvm_geterr(3), kvm_getprocs(3), kvm_open(3), kvm_open

files(3),
kvm_read(3), kvm_write(3)

BSD June 4, 1993

BSD