logging

type LogSessionOrContext ¶

type LogSessionOrContext interface {
	User() string
	RemoteAddr() net.Addr
}

LogSessionOrContext represents either an ssh.Session or an ssh.Context. It is used by logging functions that accept both.

See also the github.com/gliderlabs/ssh.

type Logger ¶

type Logger interface {
	Print(v ...interface{})
	Printf(format string, v ...interface{})
}

Logger represents an object that can be used for log messages. It is assumed to be goroutine-safe.

The log.Logger type of the builtin log package implements this type.

type MemoryLeakDetector ¶

type MemoryLeakDetector = MemoryLeakDetectorOff

MemoryLeakDetector represents the either enabled or disabled memory leak detector. See MemoryLeakDetectorInterface for documentation.

func NewLeakDetector() MemoryLeakDetector

type MemoryLeakDetectorInterface ¶

type MemoryLeakDetectorInterface interface {
	// Add and Done are used to register async processes with this LeakDetector.
	//
	// A call to Add() should be performed when an async action is started.
	// A call to Done() with the same name should be performed when the async action is completed as expected.
	//
	// Names should be unique. Upon reuse, Add() and Done() call panic().
	Add(name string)
	Done(name string)

	// Finish checks if all calls to Add() have been undone by a call to Done().
	// It should be called syncronously.
	//
	// If this is not the case within MemoryLeakTimeout, it prints to logger an appropriate error message.
	// If this is the case, it prints a short message confirming that the leak check completed.
	Finish(logger Logger, s LogSessionOrContext)
}

MemoryLeakDetectorInterface represents a Memory Leak Detector. It is used to ensure that no concurrent processes have caused a memory leak within sessions.

This interface is not used at runtime, it serves only for documentation purposes. The MemoryLeakDetectorInterface can be turned on or off at build time using the "leak" build tag. This sets the MemoryLeakDetector type alias is set either to MemoryLeakDetectorOn or MemoryLeakDetectorOff. These contain the actual implementation.

At runtime, all instances should be created using NewLeakDetector and never MemoryLeakDetectorOn or MemoryLeakDetectorOff. They are still exposed, so that both implementations can be tested.

When the MemoryLeakDetectorInterface is disabled, all functions in this interface are noops. As opposed to using this interface, that enables the disabled variant to be compiled away.

type MemoryLeakDetectorOff ¶

type MemoryLeakDetectorOff struct{}

MemoryLeakDetectorOff is the disabled variant of MemoryLeakDetectorInterface.

func (d MemoryLeakDetectorOff) Add(name string)

func (d MemoryLeakDetectorOff) Done(name string)

func (d MemoryLeakDetectorOff) Finish(logger Logger, s LogSessionOrContext)

type MemoryLeakDetectorOn ¶

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

MemoryLeakDetectorOn is the enabled variant of MemoryLeakDetectorInterface.

func (d *MemoryLeakDetectorOn) Add(name string)

func (d *MemoryLeakDetectorOn) Done(name string)

func (d *MemoryLeakDetectorOn) Finish(logger Logger, s LogSessionOrContext)