Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

Check Out this Related Man Page

kvm_nlist(3KVM) 					    Kernel VM Library Functions 					   kvm_nlist(3KVM)

NAME
kvm_nlist - get entries from kernel symbol table SYNOPSIS
cc [ flag... ] file... -lkvm [ library...] #include <kvm.h> #include <nlist.h> int kvm_nlist(kvm_t *kd, struct nlist *nl); DESCRIPTION
The kvm_nlist() function examines the symbol table from the kernel image identified by kd (see kvm_open(3KVM)) and selectively extracts a list of values and puts them in the array of nlist structures pointed to by nl. The name list pointed to by nl consists of an array of structures containing names, types and values. The n_name field of each such structure is taken to be a pointer to a character string rep- resenting a symbol name. The list is terminated by an entry with a null pointer (or a pointer to a null string) in the n_name field. For each entry in nl, if the named symbol is present in the kernel symbol table, its value and type are placed in the n_value and n_type fields. If a symbol cannot be located, the corresponding n_type field of nl is set to 0. RETURN VALUES
The kvm_nlist() functions returns the value of nlist(3UCB) or nlist(3ELF), depending on the library used. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Stable | +-----------------------------+-----------------------------+ |MT-Level |Unsafe | +-----------------------------+-----------------------------+ SEE ALSO
kvm_open(3KVM), kvm_kread(3KVM), nlist(3ELF), nlist(3UCB), attributes(5) NOTES
Although the libkvm API is Stable, the symbol names and data values that can be accessed through this set of interfaces are Private and are subject to ongoing change. SunOS 5.11 2 May 2002 kvm_nlist(3KVM)
Man Page