NAME

Proc::ProcessTable::piddler - Display all process table, open files, and network connections for a PID.

VERSION

Version 0.2.0

SYNOPSIS

    use Proc::ProcessTable::piddler;

    # skip over the less useful stuff by default for less spammy output
    my $args={
              txt=>0,
              unix=>0,
              pipe=>0,
              vregroot=>0,
              dont_dedup=>0,
              dont_resolv=>0,
              };

    my $piddler = Proc::ProcessTable::piddler->new( $args );
    
    print $piddler->run( [ 0, 1432 ] );

METHODS

new

Initiates the object.

One argument is taken and that is a option hash reference of options.

    my $args={
              txt=>0,
              unix=>0,
              pipe=>0,
              vregroot=>0,
              dont_dedup=>0,
              dont_resolv=>0,
              };
    
    my $piddler = Proc::ProcessTable::piddler->new( $args );

args hash

a_inode

Print a_inode types.

Defaults to 0, false.

dont_dedup

Don't dedup the file descriptor list.

When deduping a list it checks if a file is open in rw, r, or w, only showing it once for any of thsoe modes. Any file with more than one open FD of that mode will have + appended value in the FD volume.

The modes below are all also RW and considered that.

    u
    ur
    uw

Defaults to 0, false.

dont_resolv

Don't resolve PTR addresses.

Defaults to 0, false.

fifo

Print FIFOs.

Defaults to 0, false.

memreglib

Prints memory mappaed libraries that show are of type REG.

The following are used to match libraries.

    /\.[0-9]+$/
    /\.[0-9]+\.[0-9$/
    /\.jar/

pipe

Print pipes.

Defaults to 0, false.

txt

Print the linked libraries used by the binary.

Defaults to 0, false.

unix

Print unix sockets.

Defaults to 0, false.

vregroot

Show VREG entries for /.

Defaults to 0, false.

run

This runs it and returns a string.

One option is taken and that is a array ref of PIDs to do.

    print $piddler->run( [ 0, 1432 ] );

timeString

Turns the raw run string into something usable.

memString

Turns the raw run string into something usable.

startString

Generates a short time string based on the supplied unix time.

nextColor

Returns the next color.

AUTHOR

Zane C. Bowers-Hadley, <vvelox at vvelox.net>

BUGS

Please report any bugs or feature requests to bug-proc-processtable-piddler at rt.cpan.org, or through the web interface at https://rt.cpan.org/NoAuth/ReportBug.html?Queue=Proc-ProcessTable-piddler. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Proc::ProcessTable::piddler

You can also look for information at:

• RT: CPAN's request tracker (report bugs here)

  https://rt.cpan.org/NoAuth/Bugs.html?Dist=Proc-ProcessTable-piddler

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Proc-ProcessTable-piddler

• CPAN Ratings

  https://cpanratings.perl.org/d/Proc-ProcessTable-piddler

• Search CPAN

  https://metacpan.org/release/Proc-ProcessTable-piddler

• Repository

  https://github.com/VVelox/Proc-ProcessTable-piddler

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

This software is Copyright (c) 2019 by Zane C. Bowers-Hadley.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

cpanm Proc::ProcessTable::piddler

perl -MCPAN -e shell
install Proc::ProcessTable::piddler