tcp

Documentation

Index

• type Logger
• type Server
  • func NewServer(settings Settings, logger Logger) (s *Server, err error)
  • func (s *Server) Listen(ctx context.Context) (err error)
• type Settings
  • func (s Settings) Copy() (copied Settings)
  • func (s *Settings) MergeWith(other Settings) (result Settings)
  • func (s *Settings) OverrideWith(other Settings)
  • func (s *Settings) SetDefaults()
  • func (s *Settings) Validate() (err error)

Types

type Logger

type Logger interface {
	Debug(s string)
	Info(s string)
	Error(s string)
}

type Server

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

func NewServer

func NewServer(settings Settings, logger Logger) (s *Server, err error)

func (*Server) Listen

func (s *Server) Listen(ctx context.Context) (err error)

Listen listens for incoming connections.

type Settings

type Settings struct {
	// Listening address for the TCP server.
	// It defaults to ":8388".
	// It cannot be nil in the internal state.
	Address *string
	// LogAddresses can be set to true to log
	// addresses proxied though the TCP server.
	// It defaults to false.
	// It cannot be nil in the internal state.
	LogAddresses *bool
	// CipherName is the cipher to use for the TCP server.
	// It defaults to "chacha20-ietf-poly1305".
	// It cannot be empty in the internal state.
	CipherName string
	// Password for the TCP server.
	// It defaults to the empty string.
	// It cannot be nil in the internal state.
	Password *string
}

func (Settings) Copy

func (s Settings) Copy() (copied Settings)

Copy returns a deep copy of the settings.

func (*Settings) MergeWith

func (s *Settings) MergeWith(other Settings) (result Settings)

MergeWith returns the merge result of the receiver settings with any unset fields set to the field of the other settings argument.

func (*Settings) OverrideWith

func (s *Settings) OverrideWith(other Settings)

OverrideWith sets any field of the receiving settings with the field value of any set field from the other settings.

func (*Settings) SetDefaults

func (s *Settings) SetDefaults()

SetDefaults sets default values for all unset field in the settings.

func (*Settings) Validate

func (s *Settings) Validate() (err error)