Unix::Processors
****************

This is the Unix::Processors Perl Package.

Copyright
=========

This package is Copyright 1999-2007 by Wilson Snyder wsnyder@wsnyder.org.

You may distribute under the terms of either the GNU General Public License or the Perl Artistic License, as specified in the Perl README file.

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

Description
===========

This package provides access to per-processor information from Perl.

       my $procs = new Unix::Processors;
       print $procs->max_online, " CPUs at ", $procs->max_clock, " MHz\n";
       if ($procs->max_online != $procs->max_physical) {
           print "Hyperthreading between ",$procs->max_physical," physical CPUs.\n";
       }
       (my $FORMAT =   "%2s  %-8s     %4s    \n") =~ s/\s\s+/ /g;
       printf($FORMAT, "#", "STATE", "CLOCK",  "TYPE", );
       foreach my $proc (@{$procs->processors}) {
           printf ($FORMAT, $proc->id, $proc->state, $proc->clock, $proc->type);
       }

See man Unix::Processors after installation.

Obtaining Distribution
======================

The latest version is available at http://www.perl.org/CPAN/

Download the latest package from that site, and decompress. gunzip Unix-Processors_version.tar.gz ; tar xvf Unix-Processors_version.tar

Supported Systems
=================

This version of Unix::Processors has been built and tested on:

  * i386-linux

  * aix-4.3.3

  * aix-5.1.0 (32 and 64 bit)

  * alpha-osf

  * freebsd (clock methods not supported before freebsd 5.4)

  * hpux-11.00

  * hpux-11.11

  * sgi-irix

  * sparc-sun-solaris2.6

  * sparc-sun-solaris2.8

Porting will definately be necessary for other operating systems.

Installation
============

 1. cd to the directory containing this README notice.

 2. Type perl Makefile.PL to configure Unix::Processors for your system.

 3. Type make to compile Unix::Processors.

 4. Type make install to install the programs and any data files and documentation.