server

Documentation

Index

• Variables
• type Config
  • func (sc Config) Run(ctx context.Context, identity *identity.FullIdentity, ...) (err error)
• type Server
  • func New(opts *tlsopts.Options, publicAddr, privateAddr string, ...) (*Server, error)
  • func (p *Server) Addr() net.Addr
  • func (p *Server) Close() error
  • func (p *Server) GRPC() *grpc.Server
  • func (p *Server) Identity() *identity.FullIdentity
  • func (p *Server) PrivateAddr() net.Addr
  • func (p *Server) PrivateGRPC() *grpc.Server
  • func (p *Server) Run(ctx context.Context) (err error)
• type Service

Variables

var (

	// Error is a pkg/server error
	Error = errs.Class("pkg/server error")
)

Types

type Config

type Config struct {
	tlsopts.Config
	Address        string `user:"true" help:"public address to listen on" default:":7777"`
	PrivateAddress string `user:"true" help:"private address to listen on" default:"127.0.0.1:7778"`
}

Config holds server specific configuration parameters

func (Config) Run

func (sc Config) Run(ctx context.Context, identity *identity.FullIdentity, interceptor grpc.UnaryServerInterceptor, services ...Service) (err error)

Run will run the given responsibilities with the configured identity.

type Server

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

Server represents a bundle of services defined by a specific ID. Examples of servers are the satellite, the storagenode, and the uplink.

func New

func New(opts *tlsopts.Options, publicAddr, privateAddr string, interceptor grpc.UnaryServerInterceptor, services ...Service) (*Server, error)

New creates a Server out of an Identity, a net.Listener, a UnaryServerInterceptor, and a set of services.

func (*Server) Addr

func (p *Server) Addr() net.Addr

Addr returns the server's public listener address

func (*Server) Close

func (p *Server) Close() error

Close shuts down the server

func (*Server) GRPC

func (p *Server) GRPC() *grpc.Server

GRPC returns the server's gRPC handle for registration purposes

func (*Server) Identity

func (p *Server) Identity() *identity.FullIdentity

Identity returns the server's identity

func (*Server) PrivateAddr

func (p *Server) PrivateAddr() net.Addr

PrivateAddr returns the server's private listener address

func (*Server) PrivateGRPC

func (p *Server) PrivateGRPC() *grpc.Server

PrivateGRPC returns the server's gRPC handle for registration purposes

func (*Server) Run

func (p *Server) Run(ctx context.Context) (err error)

Run will run the server and all of its services

type Service

type Service interface {
	Run(ctx context.Context, server *Server) error
}

Service represents a specific gRPC method collection to be registered on a shared gRPC server. PointerDB, OverlayCache, PieceStore, Kademlia, etc. are all examples of services.