Axel Schwenke > HPUX-Pstat-1.01 > HPUX::Pstat

Download:
HPUX-Pstat-1.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.01   Source  

NAME ^

HPUX::Pstat - Perl wrapper for pstat() functions

SYNOPSIS ^

use HPUX::Rstat;

$pst = HPUX::Pstat::getstatic();

$psd = HPUX::Pstat::getdynamic();

$psv = HPUX::Pstat::getvminfo();

$pss = HPUX::Pstat::getswap(size = 1, start = 0);

$pss = HPUX::Pstat::getproc(size = 1, start = 0);

$pss = HPUX::Pstat::getprocessor(size = 1, start = 0);

DESCRIPTION ^

This Perl modules lets you call some of the pstat(2) functions and returns system performance data in Perl data structures. HPUX::Pstat is meant as a foundation to build performance monitoring tools upon.

The HPUX::Pstat::getstatic, HPUX::Pstat::getdynamic and HPUX::Pstat::getvminfo functions each return a hashref containing most of the respective C structure members.

The HPUX::Pstat::getswap, HPUX::Pstat::getproc and HPUX::Pstat::getprocessor functions take up to two arguments and return a reference to an array-of-hashes. The arguments specify the number of records to fetch and the index of the first record and are equivalents to the elemcount and index arguments of the respective pstat functions. In any case only valid data is returned (Example: If you call HPUX::Pstat::getprocessor(4) on a 2-processor box, the resulting array will contain only two entries).

DATA FORMAT ^

The included example1.pl dumps the data structures of all functions. For more information read /usr/include/sys/pstat.h.

PORTABILITY ^

According to the pstat(2) manpage the calling interface is kernel dependent. So do not expect too much. HPUX::Pstat was written and tested on a HPUX 11.0 box and compiles well with Perl 5.6.1 and gcc.

BUGS AND DESIGN LIMITATIONS ^

So far the list of imported struct members is hardcoded in pack.c. I also left out some of the more obscure struct members and all of the members marked as deprecated.

As any software this package may contain bugs. Please feel free to contact me if you find one.

AUTHOR ^

Axel Schwenke <axel.schwenke@gmx.net>

Copyright (c) 2003 Axel Schwenke. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

VERSION ^

Version 1.01 (31 March 2003)

SEE ALSO ^

pstat(2).

syntax highlighting: