Safe Haskell	Safe-Inferred
Language	Haskell2010

Ouroboros.Network.Server2

Contents

Run server
Trace

Description

Server implementation based on ConnectionManager

Synopsis

data ServerArguments (muxMode ∷ MuxMode) socket initiatorCtx peerAddr versionData versionNumber bytes m a b = ServerArguments {
- serverSockets ∷ NonEmpty socket
- serverSnocket ∷ Snocket m socket peerAddr
- serverTracer ∷ Tracer m (ServerTrace peerAddr)
- serverTrTracer ∷ Tracer m (RemoteTransitionTrace peerAddr)
- serverInboundGovernorTracer ∷ Tracer m (InboundGovernorTrace peerAddr)
- serverConnectionLimits ∷ AcceptedConnectionsLimit
- serverConnectionManager ∷ MuxConnectionManager muxMode socket initiatorCtx (ResponderContext peerAddr) peerAddr versionData versionNumber bytes m a b
- serverInboundIdleTimeout ∷ Maybe DiffTime
- serverInboundInfoChannel ∷ InboundGovernorInfoChannel muxMode initiatorCtx peerAddr versionData bytes m a b
- serverObservableStateVar ∷ StrictTVar m InboundGovernorObservableState
}
newtype InboundGovernorObservableState = InboundGovernorObservableState {
- igosPrng ∷ StdGen
}
newObservableStateVar ∷ MonadLabelledSTM m ⇒ StdGen → m (StrictTVar m InboundGovernorObservableState)
newObservableStateVarIO ∷ IO (StrictTVar IO InboundGovernorObservableState)
newObservableStateVarFromSeed ∷ MonadLabelledSTM m ⇒ Int → m (StrictTVar m InboundGovernorObservableState)
run ∷ ∀ muxMode socket initiatorCtx peerAddr versionData versionNumber m a b. (Alternative (STM m), MonadAsync m, MonadDelay m, MonadCatch m, MonadEvaluate m, MonadLabelledSTM m, MonadMask m, MonadThrow (STM m), MonadTime m, MonadTimer m, HasResponder muxMode ~ True, Ord peerAddr, Show peerAddr) ⇒ ServerArguments muxMode socket initiatorCtx peerAddr versionData versionNumber ByteString m a b → m Void
data ServerTrace peerAddr
- = TrAcceptConnection peerAddr
- | TrAcceptError SomeException
- | TrAcceptPolicyTrace AcceptConnectionsPolicyTrace
- | TrServerStarted [peerAddr]
- | TrServerStopped
- | TrServerError SomeException
data AcceptConnectionsPolicyTrace
data RemoteSt
- = RemoteWarmSt
- | RemoteHotSt
- | RemoteIdleSt
- | RemoteColdSt
type RemoteTransition = Transition' (Maybe RemoteSt)
type RemoteTransitionTrace peerAddr = TransitionTrace' peerAddr (Maybe RemoteSt)

Documentation

data ServerArguments (muxMode ∷ MuxMode) socket initiatorCtx peerAddr versionData versionNumber bytes m a b Source #

Server static configuration.

Constructors

ServerArguments

Fields

serverSockets ∷ NonEmpty socket
serverSnocket ∷ Snocket m socket peerAddr
serverTracer ∷ Tracer m (ServerTrace peerAddr)
serverTrTracer ∷ Tracer m (RemoteTransitionTrace peerAddr)
serverInboundGovernorTracer ∷ Tracer m (InboundGovernorTrace peerAddr)
serverConnectionLimits ∷ AcceptedConnectionsLimit
serverConnectionManager ∷ MuxConnectionManager muxMode socket initiatorCtx (ResponderContext peerAddr) peerAddr versionData versionNumber bytes m a b
serverInboundIdleTimeout ∷ Maybe DiffTime
Time for which all protocols need to be idle to trigger DemotedToCold transition.
serverInboundInfoChannel ∷ InboundGovernorInfoChannel muxMode initiatorCtx peerAddr versionData bytes m a b
Server control var is passed as an argument; this allows to use the server to run and manage responders which needs to be started on inbound connections.
serverObservableStateVar ∷ StrictTVar m InboundGovernorObservableState
Observable mutable state.

newtype InboundGovernorObservableState Source #

Currently only StdGen, but in the future this will be extended to a record which contains some useful statistics about peers to support more advanced prune strategies (see. PruneStrategy).

Constructors

InboundGovernorObservableState
Fields igosPrng ∷ StdGen

newObservableStateVar ∷ MonadLabelledSTM m ⇒ StdGen → m (StrictTVar m InboundGovernorObservableState) Source #

Create new observable state StrictTVar.

newObservableStateVarIO ∷ IO (StrictTVar IO InboundGovernorObservableState) Source #

Using the global StdGen.

newObservableStateVarFromSeed ∷ MonadLabelledSTM m ⇒ Int → m (StrictTVar m InboundGovernorObservableState) Source #

Useful for testing, it is using mkStdGen.

Run server

run ∷ ∀ muxMode socket initiatorCtx peerAddr versionData versionNumber m a b. (Alternative (STM m), MonadAsync m, MonadDelay m, MonadCatch m, MonadEvaluate m, MonadLabelledSTM m, MonadMask m, MonadThrow (STM m), MonadTime m, MonadTimer m, HasResponder muxMode ~ True, Ord peerAddr, Show peerAddr) ⇒ ServerArguments muxMode socket initiatorCtx peerAddr versionData versionNumber ByteString m a b → m Void Source #

Run the server, which consists of the following components:

inbound governor, it corresponds to p2p-governor on outbound side
accept loop(s), one per given ip address. We support up to one ipv4 address and up to one ipv6 address, i.e. an ipv6 enabled node will run two accept loops on listening on different addresses with shared inbound governor.

The server can be run in either of two MuxMode-es:

The first one is used in data diffusion for Node-To-Node protocol, while the other is useful for running a server for the Node-To-Client protocol.

Trace

data ServerTrace peerAddr Source #

Constructors

TrAcceptConnection peerAddr
TrAcceptError SomeException
TrAcceptPolicyTrace AcceptConnectionsPolicyTrace
TrServerStarted [peerAddr]
TrServerStopped
TrServerError SomeException	similar to `TrAcceptConnection` but it is logged once the connection is handed to inbound connection manager, e.g. after handshake negotiation.

Instances

Instances details

Show peerAddr ⇒ Show (ServerTrace peerAddr) Source #
Instance details Defined in Ouroboros.Network.Server2 Methods showsPrec ∷ Int → ServerTrace peerAddr → ShowS # show ∷ ServerTrace peerAddr → String # showList ∷ [ServerTrace peerAddr] → ShowS #

data AcceptConnectionsPolicyTrace Source #

Trace for the AcceptConnectionsLimit policy.

Constructors

ServerTraceAcceptConnectionRateLimiting DiffTime Int
ServerTraceAcceptConnectionHardLimit Word32
ServerTraceAcceptConnectionResume Int

Instances

Instances details

Show AcceptConnectionsPolicyTrace Source #
Instance details Defined in Ouroboros.Network.Server.RateLimiting Methods showsPrec ∷ Int → AcceptConnectionsPolicyTrace → ShowS # show ∷ AcceptConnectionsPolicyTrace → String # showList ∷ [AcceptConnectionsPolicyTrace] → ShowS #
Eq AcceptConnectionsPolicyTrace Source #
Instance details Defined in Ouroboros.Network.Server.RateLimiting Methods (==) ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → Bool # (/=) ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → Bool #
Ord AcceptConnectionsPolicyTrace Source #
Instance details Defined in Ouroboros.Network.Server.RateLimiting Methods compare ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → Ordering # (<) ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → Bool # (<=) ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → Bool # (>) ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → Bool # (>=) ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → Bool # max ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace # min ∷ AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace → AcceptConnectionsPolicyTrace #

data RemoteSt Source #

Remote connection state tracked by inbound protocol governor.

Constructors

RemoteWarmSt
RemoteHotSt
RemoteIdleSt
RemoteColdSt

Instances

Instances details

Show RemoteSt Source #
Instance details Defined in Ouroboros.Network.InboundGovernor Methods showsPrec ∷ Int → RemoteSt → ShowS # show ∷ RemoteSt → String # showList ∷ [RemoteSt] → ShowS #
Eq RemoteSt Source #
Instance details Defined in Ouroboros.Network.InboundGovernor Methods (==) ∷ RemoteSt → RemoteSt → Bool # (/=) ∷ RemoteSt → RemoteSt → Bool #

type RemoteTransition = Transition' (Maybe RemoteSt) Source #

Nothing represents uninitialised state.

type RemoteTransitionTrace peerAddr = TransitionTrace' peerAddr (Maybe RemoteSt) Source #