Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
KVM_NLIST(3)	       FreeBSD 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
     advantage 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
     returned.

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)

FreeBSD	11.1		       November	27, 2015		  FreeBSD 11.1

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=kvm_nlist&sektion=3&manpath=FreeBSD+11.1-RELEASE>

home | help