NAME

GTop - Perl interface to libgtop

SYNOPSIS

use GTop ();
my \$gtop = GTop->new;

DESCRIPTION

Perl interface to libgtop:

http://ftp.gnome.org/pub/gnome/sources/libgtop/

CLASSES

EOF

my %constructors = map {$_,1} qw(mountlist proclist proc_map mountentry proc_args map_entry); my %notunion = map {$_,1} qw(mountentry map_entry); use constant IS_SOLARIS => $^O eq 'solaris';

for my $if (sort keys %interface) { local *FH; (my $leaf = $if) =~ s/_(.)/uc $1/e; my $class = sprintf "GTop::%s", ucfirst $leaf; (my $typedef = $class) =~ s/:/_/g;

    print BOOTXS "    boot_GTop_$if(aTHX);\n";

    print TYPEMAP "$class\tT_PTROBJ\n";

    print BOOTINC "typedef glibtop_$if * $typedef;\n";
    print BOOTINC qq(\#include "$if.boot"\n);

    my(@args) = ('','','','()');

    if ($if =~ /^proc_/)  { 
	@args = (', pid', 'pid_t pid', '($pid)', '($$)');
    }
    elsif ($if =~ /^netload/) {
	@args = (', interface', 'char * interface', 
		'($interface)', '(\'eth0\')');
    }
    elsif ($if =~ /^mountlist/) {
	@args = (', all_fs', 'int all_fs', '($all_fs)', '(1)');
    }
    elsif ($if =~ /^fsusage/) {
	@args = (', disk', 'char *disk', '($disk)', '(\'/\')');
    }

    print XS <<EOF unless $constructors{$if};

$class $if(gtop$args[0]) GTop gtop $args[1]

CODE:
RETVAL = (glibtop_$if *)safemalloc(sizeof(*RETVAL));
trace_malloc(RETVAL);
Zero(RETVAL, 1, glibtop_$if);
glibtop_get_$if(RETVAL$args[0]);

OUTPUT:
RETVAL

EOF

print TEST <<EOF unless $notunion{$if};

my \$$if = \$gtop->$if$args[3]; print "# $if\\n"; for (qw(@{ $interface{$if} })) { (my \$x = \$_) =~ s/:\\w+\$//; printf "# %s => %d\\n", \$x, \$$if->\$x(); }

EOF

    unless ($notunion{$if}) {
	print POD "\n=head2 $class\n";
	print POD "\n    my \$$if = \$gtop->$if$args[2];\n\n";
	print POD "=over 4\n";
    }

    open FH, ">$if.boot" or die $!;

    if (IS_SOLARIS) {
	for my $entry (@{ $interface{$if} }) {
	    my $type = 'u_int64_t'; 
	    if ($entry =~ s/:(\w+)$//) {
		$type = $1;
	    }
	    my $field = $entry;
	    my $xsname = "XS_glibtop_${if}_$field";
	    print FH <<EOF;
static XS($xsname)
{
    dXSARGS;

    glibtop_$if *s = (void *)SvIV((SV*)SvRV(ST(0)));

    ST(0) = sv_2mortal(newSVnv((unsigned long)s->$field));

    XSRETURN(1);
}
EOF
          }
}

    print FH "static void boot_GTop_$if (pTHX)\n{\n";

    for my $entry (@{ $interface{$if} }) {
	my $type = 'u_int64_t'; 
	if ($entry =~ s/:(\w+)$//) {
	    $type = $1;
	}
	my $field = $entry;
	my $method = join '::', $class, $field;
	my $xsname = "XS_glibtop_${if}_$field";
	if (IS_SOLARIS) {
	    print FH qq{   newXS("$method", $xsname, __FILE__);\n};
	}
	else {
	    print FH qq{   newGTopXS_$type("$method", glibtop_$if, $field);\n};
	}

	unless ($notunion{$if}) {
	    print POD "\n=item $field\n\n";
	    print POD "    my \$$field = \$$if->$field;\n";
	}
    }
    print FH qq{   newXS("$class\::DESTROY", XS_GTop_destroy, __FILE__);\n} 
    unless $notunion{$if};

    print FH "\n}\n";

    print POD "\n=back\n" unless $notunion{$if};
}

print BOOTXS "\n}\n"; print POD <<'EOF';

AUTHOR

Currently maintained by Malcolm J Harwood <mjh@cpan.org>.

Previously maintained by Stas Bekman <stas@stason.org>.

Doug MacEachern wrote the original version.

EOF

print TEST <<EOF; # XXX: need to do some real testing

# size_string testing ok GTop::size_string(1_024), " 1k"; ok GTop::size_string(1_924), " 2k"; ok GTop::size_string(8_192), " 8k"; ok GTop::size_string(1_148_576), " 1.1M"; ok GTop::size_string(133_809_024), " 128M";

EOF

close TYPEMAP; close BOOTINC; close BOOTXS; close XS; close POD; close TEST;

my @insure = (); if (0) { @insure = ( OPTIMIZE => '-g', CC => 'insure gcc', LD => 'insure gcc', ); }

require "./config.pl"; # as we may need prevent the loading of this helper lib from Server/Makefile.PL #$ENV{GTOP_BUILD} = 0; my($inc, $libs, $defines) = get_glibtop_config();

if (DEBUG) { warn "Using INC: $inc\n"; warn "Using LIBS: $libs\n"; warn "Using DEFINE: $defines\n"; }

WriteMakefile( @insure, NAME => 'GTop', VERSION_FROM => 'lib/GTop.pm', DIR => [], # XXX: libgtop 2.0+ has problems building Server/ INC => $inc, LIBS => [$libs], DEFINE => $defines, TYPEMAPS => [qw(typemap.gtop typemap)], PREREQ_PM => \%prereq, clean => { FILES => "@{[<*.boot>, <*.gtop>]}", }, 'macro' => { CVSROOT => 'modperl.com:/local/cvs_repository', }, );

sub MY::postamble { return <<'EOF';

cvs_tag : cvs -d $(CVSROOT) tag v$(VERSION_SYM) . @echo update GTop.pm VERSION now EOF }

cpanm GTop

perl -MCPAN -e shell
install GTop