Proc-ProcessTable-piddler/README.md

62 lines
1.7 KiB
Markdown
Raw Permalink Normal View History

2019-09-03 04:40:36 -05:00
# About
2019-08-26 05:45:22 -05:00
2019-09-03 04:40:36 -05:00
Display all process table, open files, and network connections for a PID.
2019-09-03 05:11:00 -05:00
![piddler](piddler.png)
2019-09-03 04:40:36 -05:00
# Command Line Options
```
2019-09-04 01:21:36 -05:00
-a Show a_inodes.
2019-09-03 04:40:36 -05:00
-d Do not dedup.
2019-09-04 01:21:36 -05:00
-f Show FIFOs.
-m Show memory mapped libraries of the REG type.
2019-09-03 04:40:36 -05:00
-n Do not resolve PTR addresses.
2019-09-03 05:26:53 -05:00
--nc Disable color.
2019-09-04 01:21:36 -05:00
-p Show pipes.
-r Show show VREG / files.
-t Show shared libraries.
-u Show unix sockets.
2019-09-03 04:40:36 -05:00
```
# 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 |
| -------- | ---------------- |
2019-09-03 05:26:53 -05:00
| NO_COLOR | If set to 1, color will be disabled. |
2019-09-04 01:21:36 -05:00
| 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. |
| PIDDLER_a_inode | If set to 1, a_inode types will be shown. |
| PIDDLER_fifo | If set to 1, FIFOs will not be shown. |
| PIDDLER_memreglib | If set to 1, memory mapped libraries with the type REG will be shown. |
2019-09-03 04:40:36 -05:00
| PIDDLER_pipe | If set to 1, pipes will not be shown. |
2019-09-04 01:21:36 -05:00
| PIDDLER_txt | If set to 1, libraries with the TXT type will not be shown. |
2019-09-03 04:40:36 -05:00
| PIDDLER_unix | If set to 1, unix socket will not be shown. |
| PIDDLER_vregroot | If set to 1, VREG / will not be shown. |
# 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