FreeBSD Manual Pages
KVM_NLIST(3) BSD Library Functions Manual KVM_NLIST(3) NAME kvm_nlist, kvm_nlist2 -- 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); int kvm_nlist2(kvm_t *kd, struct kvm_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 symbols in live kernels. 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. The kvm_nlist2() function retrieves the symbol table entries indicated by the name list argument nl. This argument points to an array of struct kvm_nlist structures, terminated by an entry whose n_name field is NULL These structures are similar to the nlist structures used by kvm_nlist() except that the n_value field uses a different type (kvaddr_t) to avoid truncation when examining non-native kernel images. RETURN VALUES The kvm_nlist() and kvm_nlist2() functions return the number of invalid entries found. If the kernel symbol table was unreadable, -1 is re- turned. SEE ALSO kldsym(2), kvm(3), kvm_close(3), kvm_getargv(3), kvm_getenvv(3), kvm_geterr(3), kvm_getprocs(3), kvm_native(3), kvm_open(3), kvm_openfiles(3), kvm_read(3), kvm_write(3) BSD November 27, 2015 BSD
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=kvm_nlist&sektion=3&manpath=FreeBSD+11.1-RELEASE+and+Ports>