sshpool

Documentation

Overview

Package sshpool helps manage a pool of SSH clients.

Index

• type Pool
  • func New(c *ssh.ClientConfig) *Pool
  • func (p *Pool) Close() error
  • func (p *Pool) Get(host string) (*ssh.Client, error)
  • func (p *Pool) GetContext(ctx context.Context, host string) (*ssh.Client, error)
  • func (p *Pool) Put(host string, c *ssh.Client)

Types

type Pool

type Pool struct {
	// contains filtered or unexported fields
}

Pool is a pool of SSH clients to reuse.

Clients are pooled by the hostname they are connected to.

Users should call Get, which returns a Client from the pool if available, or creates and returns a new Client. The returned Client is not guaranteed to be good, e.g., the connection may have broken while the Client was in the pool.

The user should put the SSH client back into the pool after use. The user should not close the Client as Pool will close it if bad.

The user should Close the pool after use, to free any SSH Clients in the pool.

func New

func New(c *ssh.ClientConfig) *Pool

New returns a new Pool. The provided ssh config is used for new SSH connections if pool has none to reuse.

func (*Pool) Close

func (p *Pool) Close() error

Close closes all SSH clients in the Pool.

func (*Pool) Get

func (p *Pool) Get(host string) (*ssh.Client, error)

Get returns a good SSH client.

func (*Pool) GetContext

func (p *Pool) GetContext(ctx context.Context, host string) (*ssh.Client, error)

GetContext returns a good SSH client within the context timeout.

func (*Pool) Put

func (p *Pool) Put(host string, c *ssh.Client)

Put puts the client back in the pool if it is good. Otherwise, the Client is closed.