kvm_nlist(3) [netbsd man page]

KVM_NLIST(3)						   BSD 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,
     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 corre-
     sponding 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
     table.

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)

BSD
								   May 11, 2003 							       BSD

KVM_NLIST(3)						   BSD 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

     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 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)

BSD
								   June 4, 1993 							       BSD