Manual Pages for UNIX Operating System command usage for man kvm_nlist

Kernel VM Library Functions                       kvm_nlist(3KVM)



NAME
     kvm_nlist - get entries from kernel symbol table

SYNOPSIS
     cc [ flag... ] file... -lkvm [ library...]
     #include 
     #include 

     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 contain-
     ing  names, types and values.  The n_name field of each such
     structure is taken to be a pointer  to  a  character  string
     representing  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(3ELF).

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|


SEE ALSO
     kvm_open(3KVM), kvm_kread(3KVM), nlist(3ELF), attributes(5)

NOTES
     Although the libkvm API is Committed, the symbol  names  and
     data  values that can be accessed through this set of inter-
     faces are Private and are subject to ongoing change.



SunOS 5.11           Last change: 2 May 2002                    1