Skip to main content

Manage persistent ssh tunnels and port forwards.

Project description

Manage persistent ssh tunnels and port forwards.

Portfwd runs a collection of ssh tunnel commands persistently, each in its own <>_ instance with all the visibility and process control that SvcD brings.

It reads tunnel preconditions from special comments within the ssh config file. It uses the configuration options from the config file as the SvcD signature function thus restarting particular ssh tunnels when their specific configuration changes. It has an "automatic" mode (the -A option) which monitors the desired list of tunnels from statuses expressed via <>_ which allows live addition or removal of tunnels as needed.

Function Condition(portfwd, op, invert, *args)

Factory to construct a condition from a specification.

Class FlagCondition

MRO: _PortfwdCondition
A flag based condition.

Function main(argv=None, environ=None)

Command line main programme.

Class PingCondition

MRO: _PortfwdCondition
A ping based condition.

Class Portfwd

An ssh tunnel built on a SvcD.

Method Portfwd.__init__(self, target, ssh_config=None, conditions=(), test_shcmd=None, trace=False, verbose=False, flags=None)

Initialise the Portfwd.


  • target: the tunnel name, and also the name of the ssh configuration used
  • ssh_config: ssh configuration file if not the default
  • conditions: an iterable of Conditions which must hold before the tunnel is set up; the tunnel also aborts if these cease to hold
  • test_shcmd: a shell command which must succeed before the tunnel is set up; the tunnel also aborts if this command subsequently fails
  • trace: issue tracing messages; default False
  • verbose: be verbose; default False
  • flags: optional preexisting Flags instance

Class Portfwds

A collection of Portfwd instances and associated control methods.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for, version 20190602
Filename, size File type Python version Upload date Hashes
Filename, size (8.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page