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

FreeBSD Manual Pages

  
 
  

home | help
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, 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)

BSD				 June 4, 1993				   BSD

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+4.7-RELEASE>

home | help