Solaris Version 0.2 alpha

DISCLAIMER & COPYRIGHT

Copyright (c) 1998 Alan Burlison

You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file, with the exception that it cannot be placed on a CD-ROM or similar media for commercial distribution without the prior approval of the author.

This code is provided with no warranty of any kind, and is used entirely at your own risk.

This code was written by the author as a private individual, and is in no way endorsed or warrantied by Sun Microsystems.

WHAT IS IT?

This set of modules provides Solaris-specific functionality, mainly related to obtaining performance and configuration information from the Operating System. The following modules are provided:

Solaris::MapDev
Maps between device instance names and /dev names, e.g. "sd0" to "c0t0d0" and vice-versa.

Solaris::Kstat
Provides access to the kernel performance statistics via the Solaris kstat interface - see 'man kstat' for details. The kernel statistics are represented as a set of nested perl hashes.

The following modules are under development:

Solaris::Kmem
Read values from the running kernel.

Solaris::MIB
Access STREAMS network statistics

Solaris::NDD
Access network device statistics

PREREQUISITES

  1. Perl 5.004_05 or later Perl 5.004_04 has several bugs that prevent this package from working
  2. Solaris 2.5.1 or later
  3. A C compiler

INSTALLATION

  1. Check you have all the prequisites installed and working.
  2. Run 'perl Makefile.PL && make test'
  3. If successful, run 'make install'

HOW TO USE

There are man pages for all the modules - after installation try 'man Solaris::Kstat' and 'man Solaris::MapDev' for full details.

There are also a few example scripts provided, which will be installed into the same directory as your perl executable. These are:

dump_kstats     Dumps the entire kstat tree to stdout
iost+           Replacement for iostat with better statistics
mapdev          Maps between device instances and names (eg sdNN to cNtNdN)
show_devs       Show all disk device serial numbers & manufacturer information

SUPPORT

Support questions and suggestions can be directed to Alan.Burlison@uk.sun.com