pgm 0.0.2

Process Group Management

# pgm - Process Group Manager pgm is a tool used for managing groups of processes. Groups of processes can be started and stopped together. Individual processes are started in the background, but can be connected to later. When processes stop running, their output remains available for debugging until the processes is ‘removed’.

## Dependencies PGM currently uses tmux sessions to manage processes.

## Example:

Initialize a process group named ‘mine’

$ pgm init mine

Initialize a group named ‘mine’ with config file

$ pgm init mine –config launch.ini

List all groups

$ pgm groups 1 Group: mine

List all processes in group ‘mine’

$ pgm list mine 3 Processes PGM Name PID Status Command top 1001 Running htop netstat 1002 Running watch -n 1 ‘netstat -naltp’ disksize 1003 Exited(1) df -h tcpdump 1004 Running sudo tcpdump -i eth0

Add the process ‘syslog’ to the session ‘mine’

$ pgm add mine syslog –cmd tail -f /var/log/syslog Adding process ‘syslog’ to ‘mine’ using: tail -f /var/log/syslog

Add a sudo process to the session ‘mine’

$ pgm add mine iftop –sudo –cmd iftop -i eth0 Adding process ‘iftop’ to ‘mine’ using: sudo iftop -i eth0 [sudo] password for csrobot:

Add a process ‘syslog’ to the session ‘mine’ using command from conf file

$ pgm add mine syslog –config myconfig.ini

Adding process ‘syslog’ to ‘mine’ using: tail -f /var/log/syslog

Connect to process stdio

$ pgm connect mine top (opens tmux session to that process)

Show latest output of a process

$ pgm tail mine disksize Filesystem Size Used Avail Use% Mounted on /dev/sda1 209G 136G 63G 69% /

Kill a process (Ctrl-c) Note: does not remove the process output from pgm

$ pgm kill mine –name top Sending Ctrl-c (SIGINT) to process ‘top’ in session ‘mine’

Kill a process (Ctrl-c) and remove it

$ pgm kill mine -r –name top Sending Ctrl-c (SIGINT) to process ‘top’ in session ‘mine’ Removing ‘top’ from session ‘mine

Kill all processes (Ctrl-c)

$ pgm kill mine –all

Kill a process (Ctrl-d)

$ pgm kill mine -d –name top Sending Ctrl-d (EOF) to process ‘top’ in session ‘mine’

Kill a process (Ctrl-)

$ pgm kill mine -q –name top Sending Ctrl-(SIGQUIT) to process ‘top’ in session ‘mine’

Kill a process

$ pgm kill mine -9 –name top Sending SIGINT to process ‘top’ in session ‘mine’

Remove an exited process (only works on exited processes)

$ pgm rm mine –name top Removing ‘top’ from session ‘mine’