nojhan/tunnelmon
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
20 commits 1 branch 3 tags 134 KiB
  • Python 100%
Find a file
nojhan 71c89f1fe7 Port to Python3 
Handle bytes vs strings.
Fewer logging for interactive mode.
Prepare config file: move -f to -g, use -f for config.
2016-12-02 19:30:40 +01:00
AUTHORS Add README, remove old html doc. 2016-11-30 18:40:08 +01:00
CHANGELOG Add README, remove old html doc. 2016-11-30 18:40:08 +01:00
ereshkigal symbolic link 2009-06-24 11:46:31 +00:00
ereshkigal.py Port to Python3 2016-12-02 19:30:40 +01:00
LICENSE trunk dir, authors 2009-06-23 20:26:51 +00:00
README.md Add README, remove old html doc. 2016-11-30 18:40:08 +01:00

README.md

ereshkigal -- Monitor and manage autoSSH tunnels

SYNOPSIS

ereshkigal [-h]

ereshkigal [-c] [-n] [-a] [-l LEVEL] [-f FILE]

DESCRIPTION

ereshkigal is an autossh tunnel monitor. It gives a user interface to monitor existing SSH tunnel that are managed with autossh.

It can print the current state of your tunnels or display them in an interactive text-based interface.

ereshkigal is released under the GNU Public License v3.

INSTALLATION

ereshkigal targets Linux operating systems, and depends on:

  • autossh (which needs OpenSSH, obviously)
  • python ≥ 2.4

OPTIONS

Called without option,ereshkigal will print the current state of the autossh tunnels and exit.

  • -h, --help: Show a help message and exit

  • -c, --curses: Start the interactive user interface. Tunnels states will be updated regularly and you will be able to control them (see below).

  • -n, --connections: Display only SSH connections related to a tunnel. This feature is only available as root, because it needs system permissions.

  • -a, --autossh: Only display the list of autossh processes.

  • -l LEVEL, --log-level LEVEL: Control the verbosity of the logging, the greater, the more verbose. Available log levels are: error < warning < debug. Defaults to error, which only prints unrecoverable problems.

  • -f FILE, --log-file FILE: Log messages are written to the given FILE. Useful to debug the interactive interface. If not set, asking for the curses interface automatically set logging to the "ereshkigal.log" file.

INTERACTIVE INTERFACE

Keyboard commands:

  • R: Reload the selected autossh instance (i.e. send a SIGUSR1, which is interpreted as a reload command by autossh).
  • K: Kill the selected autossh instance (i.e. send a SIGKILL).
  • T: (only available as root) show the tunnel connections related to each autossh instances.
  • Q: quit ereshkigal.