The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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 }