update the readme

This commit is contained in:
Zane C. B-H 2019-09-03 04:40:36 -05:00
parent 6f1bddc108
commit 6f9105f299
1 changed files with 52 additions and 2 deletions

View File

@ -1,3 +1,53 @@
# Proc-ProcessTable-piddler
# About
Displays information on a pid.
Display all process table, open files, and network connections for a PID.
![piddler](pidder.png)
# Command Line Options
```
-d Do not dedup.
-n Do not resolve PTR addresses.
-p Do not show pipes.
-r Do not show show VREG / files.
-t Do not show shared libraries.
-u Do not show unix sockets.
```
# Enviromental Variables
The enviromental variables below may be set to set the default for the
flag in question.
Unless set to defined ands set to 1, these will default to 0.
| Variable | Description |
| -------- | ---------------- |
| PIDDLER_txt | If set to 1, libraries will not be shown. |
| PIDDLER_pipe | If set to 1, pipes will not be shown. |
| PIDDLER_unix | If set to 1, unix socket will not be shown. |
| PIDDLER_vregroot | If set to 1, VREG / will not be shown. |
| PIDDLER_dont_dedup | If set to 1, duplicate file handles are removed. |
| PIDDLER_dont_resolv | If set to 1, PTR addresses will not be resolved for network connections. |
# Installing
## FreeBSD
pkg install perl5 p5-App-cpanminus
cpanm Proc::ProcessTable::piddler
## Linux
### CentOS
yum install cpanm
cpanm Proc::ProcessTable::piddler
### Debian
This has been tested as working on Debian 9 minimal.
apt install perl perl-base perl-modules make cpanminus gcc
cpanm Proc::ProcessTable::piddler