This is the Unix::Processors Perl Package.

Copyright
=========

   This package is Copyright 2000 by Wilson Snyder
<wsnyder@wsnyder.org>.

   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.

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";
       (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:

   * sparc-sun-solaris2.6

   * i386-linux

   Porting will definately be necessary for other operating systems.

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

  1. `cd' to the directory containing this INSTALL 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.