pgtree
Unix process hierachy tree display for specific processes (kind of mixed pgrep + pstree)
pgtree is also able to send signal to found processes and all their children
The purpose is to have the tool working out of the box on any Unix box, using the default OS python installed, without installing anything else. The code must be compatible with python 2.x + 3.x
Should work on any Unix that can execute :
# /usr/bin/pgrep
# /usr/bin/ps -e -o pid,ppid,stime,user,ucomm,args
if pgrep command not available (AIX), pgtree uses built-in pgrep (-f -i -x -u <user> supported).
Tested on various versions of RedHat / CentOS / Ubuntu / Debian / Suse / MacOS / Solaris / AIX including old versions
(uses -o comm on Solaris)
Installation
FYI, the pgtree/pgtree.py is standalone and can be directly copied/used anywhere without any installation.
installation using pip:
# pip install pgtree
installation using setup.py, root install in /usr/local/bin:
# ./setup.py install
installation using setup.py, user install in ~/.local/bin:
# ./setup.py install --prefix=~/.local
Usage
# pgtree -h
usage: pgtree.py [-Iya] [-C <when>] [-O <psfield>] [-c|-k|-K] [-p <pid1>,...|<pgrep args>]
-I : use -o uid instead of -o user for ps command
(if uid/user mapping is broken ps command can be stuck)
-c : display processes and children only
-k : kill -TERM processes and children
-K : kill -KILL processes and children
-y : do not ask for confirmation to kill
-C : color preference : y/yes/always or n/no/never (default auto)
-w : tty wrap text : y/yes or n/no (default y)
-a : use ascii characters
-O <psfield> : display <psfield> instead of 'stime' in output
<psfield> must be valid with ps -o <psfield> command
by default display full process hierarchy (parents + children of selected processes)
-p <pids> : select processes pids to display hierarchy (default 1)
<pgrep args> : use pgrep to select processes (see pgrep -h)
found pids are prefixed with ▶
Examples
show all parents and children of processes matching bash
show processes matching bash and their children
kill all sh processes of user joknarf and their children
Demo
1 maintainer
Metadata
1 maintainer
Release files for pgtree 1.0.19
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pgtree-1.0.19.tar.gz | 9.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pgtree-1.0.19-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 22.3 kB
Release files / pgtree-1.0.19.tar.gz
| Download URL | pgtree-1.0.19.tar.gz |
|---|---|
| Size | 9.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a6211b88038f301760927f6ff1f88b4af9084deaa3dfd0b690e66b79c1b86f4c
|
|
BLAKE2b-256 checksum How to use checksums |
8248f6b06067e31b32c9e749904186d5cf65d1dbbe76f42f1107a7d7a3c236db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.1
|
Release files / pgtree-1.0.19-py2.py3-none-any.whl
| Download URL | pgtree-1.0.19-py2.py3-none-any.whl |
|---|---|
| Size | 13.1 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
62cf9e85ebc0607c29b577b13f13e6f46fee82284efbac3c1a720c0c32814975
|
|
BLAKE2b-256 checksum How to use checksums |
047df12c33cf098e76ef5bb23e0b76d111fbc0a4a56c2aa87ad1d4601166d43c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.1
|
