AIX::SysInfo - A Perl module for retrieving information about an AIX pSeries system

SYNOPSIS

  use AIX::SysInfo;
  my %sysinfo = get_sysinfo;

DESCRIPTION

You can install it using the usual Perl fashion:

  perl Makefile.PL
  make
  make test
  make install

This module provides a Perl interface for accessing information about a pSeries machine running the AIX operating system. It makes available a single function, get_sysinfo, which returns a hash containing the following keys:

hostname

The value of this key contains the hostname of the system.

serial_num

The value of this key contains the unique ID number for the system.

num_procs

The value of this key contains the number of processors in the system.

proc_speed

The value of this key contains the speed of the processors in the system.

proc_type

The value of this key contains the processor type (PowerPC_POWER5)

total_ram

The value of this key contains the total amount of RAM in the system, in megabytes.

total_swap

The value of this key contains the total amount of swap space in the system, in megabytes.

aix_version

The value of this key contains the version of AIX and the latest complete maintenance level on ths system, in the form "VRMF-ML".

model_type

The value of this key contains the hardware model as reported by uname -M (9117-570)

sys_arch

The value of this key contains information on hrdware architecture. It is taken from uname -M and on most modern systems it is simply IBM

firmware_ver

The value of this key contains version of the firmware (IBM,SF240_358)

lpar_name

The value of this key is LPAR name. If LPAR does not exist it is 'NULL'

lpar_id

The value of this key is LPAR number. If LPAR does not exist it is '-1'

NOTE

Most of the data is obtained by parsing output of these three AIX commands: /usr/bin/uname, /usr/bin/oslevel, /usr/sbin/prtconf

VERSION

   1.1.1 (released on Wed Jun 17 15:07:35 CDT 2009)
   1.1   (released on Tue Jun 16 16:39:00 CDT 2009)
   1.0   (released 2000-07-03)

BUGS

With version 1.1 this module was rewritten from scratch. It has been tested on p570/p595 LPAR hardware and on several older stand-alone servers. This version works slower that version 1.0 because it relies on prtconf command which takes several seconds to run, but it is more reliable method ( than others ) to query system parameters.

TO-DO

• Add an object-oriented interface.

• Add many more functions.

AUTHOR

  Sandor W. Sklar
  <mailto:ssklar@stanford.edu>
  <http://whippet.stanford.edu/~ssklar/>

  Version 1.1 is a complete re-write of the module
  Sergey Leonovich
  sleonov@cpan.org
  

COPYRIGHT/LICENSE

   Copyright (c) 2009, Sergey Leonovich
   Copyright (c) 2001, Sandor W. Sklar.

   This module is free software.
   It may be used, redistributed, and/or modified under the terms of the Perl Artistic License.