DragonFly On-Line Manual Pages


KVM_NLIST(3)	      DragonFly 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 <sys/types.h> #include <kvm.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. kldsym(2) is used to locate the symbol. This is a less than perfect emu- lation of the nlist values but has the advantage of being aware of kernel modules and is reasonably fast.

RETURN VALUES

The kvm_nlist() function returns the number of invalid entries 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_openfiles(3), kvm_read(3), kvm_write(3) DragonFly 4.1 June 4, 1993 DragonFly 4.1