NAME

Solaris::Kvm - Perl interface to Solaris Kernel Virtual Memory Access Library (libkvm)

SYNOPSIS

use Solaris::Kvm;

$handle = new Solaris::Kvm();
printf "value of maxusers %d\n", $handle->maxusers;
printf "size of maxusers variable %d\n", $handle->size('maxusers');

DESCRIPTION

Solaris::Kvm allows read access to Solaris kernel variables through the tied hash interface. By default, the module reads the /dev/ksyms namelist, but it is also possible to use an alternative namelist by passing its name to the module constructor:

$handle = new Solaris::Kvm("/my_namelist");

The value of a particular kernel variable can by looked up by simply retrieving the element from the hash using the name of the variable as a key:

printf "maxusers: %d\n", $handle->{maxusers};

Note, the value is automatically refreshed for every lookup - i.e. internally, the FETCH routine calls kvm_kread(). Variable value can also be retrieved using the subroutine/method syntax:

printf "maxusers: %d\n", $handle->maxusers;

although, it is slightly less efficient since such call is dispatched through the AUTOLOAD function. In addition to reading the values of kernel variables, the module is capable of providing the size of a variable (in bytes), its type (object, function, etc) as well as its bind (local, global, etc) and visibility (internal, protected, etc):

printf "maxusers size: %d\n", $handle->size('maxusers');
printf "maxusers type: %d\n", $handle->type('maxusers');
printf "maxusers bind: %d\n", $handle->bind('maxusers');
printf "maxusers visibility: %d\n", $handle->visibility('maxusers');

All these functions return standard ELF constants (STT_OBJECT, STT_HIDDEN, etc), defined in elf.h. The "write" function is disabled - those who wish to modify the values of kernel variables should really use /etc/system...;-).

EXPORT

STB_GLOBAL	
STB_WEAK
STB_NUM
STT_NOTYPE	
STT_OBJECT
STT_FUNC
STT_SECTION	
STT_FILE
STT_COMMON	
STT_TLS		
STT_NUM	
STV_DEFAULT
STV_INTERNAL
STV_HIDDEN
STV_PROTECTED

AUTHOR

Alexander Golomshtok<lt>golomshtok_alexander@jpmorgan.com<gt>

SEE ALSO

libkvm(3LIB), perl.