Skip to main content

pst: a reproduction of pstree

Travis CI Python versions Codecov

pst is a command-line utility that creates visual trees of your running processes on Unix-like systems.

pstexample

pst is a reproduction of pstree, written in Python.

Installation

pst currently supports Python 2.x-3.x.

PyPI

$ sudo pip install pst

Manual

First clone the pst repository and go into the directory.

$ git clone git://github.com/mixedconnections/pst.git
$ cd pst

Then run the command below.

$ sudo python setup.py install

If you don't have root permission (or don't want to install pst with sudo), try:

$ python setup.py install --prefix=~/.local
$ export PATH=~/.local/bin:$PATH

Usage

pst shows running processes as a tree. The tree is rooted at either pid or init if pid is omitted. If a user name is specified, all process trees rooted at processes owned by that user are shown

Command Line Options

-h, --help

Display a help message

-v, --version

Display the version of pst

-o, --output string

Directs the output to a file name of your choice

-w, --write

When specified, pst writes to stdout. By default, pst uses less to page the output.

-u, --user string

Show only trees rooted at processes of this user

-p, --pid integer

Start at this pid; default is 1 (init)

Demo

Demos speak more than a thousand words! Here's me running pst on ubuntu. As you can see, you can select a pid and see its child processes:

pst-demo

More Examples

shell> 
shell> pst
shell> pst --help
shell> pst -o trees.txt 
shell> pst --user postgres

Metadata

Release files for pst 1.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pst 1.5.3
File Size Uploaded
pst-1.5.3.tar.gz 4.7 MB Details

Release files / pst-1.5.3.tar.gz

Download URL pst-1.5.3.tar.gz
Size 4.7 MB
Tags Source
SHA-256 checksum
How to use checksums
ed312361b875893b4571644b8014b76aacedcd6809e1eb5836bd5c9e3ac411bd
BLAKE2b-256 checksum
How to use checksums
232519926a3de635cbd140f9ae466057ec9710f78aeed405914883d6fa8a04e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.37.0 CPython/2.7.15+

Release history Release notifications | RSS feed

This release

1.5.3 This release

1 release file

1.5.2

1 release file

1.5.1

1 release file

1.5.0

1 release file

0.0.2

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page