mirror of
https://github.com/ipfs/kubo.git
synced 2026-02-23 19:37:46 +08:00
92d08db7a5
- updated go-ctxgroup and goprocess ctxgroup: AddChildGroup was changed to AddChild. Used in two files: - p2p/net/mock/mock_net.go - routing/dht/dht.go - updated context from hg repo to git prev. commit in hg was ad01a6fcc8a19d3a4478c836895ffe883bd2ceab. (context: make parentCancelCtx iterative) represents commit 84f8955a887232b6308d79c68b8db44f64df455c in git repo - updated context to master (b6fdb7d8a4ccefede406f8fe0f017fb58265054c) Aaron Jacobs (2): net/context: Don't accept a context in the DoSomethingSlow example. context: Be clear that users must cancel the result of WithCancel. Andrew Gerrand (1): go.net: use golang.org/x/... import paths Bryan C. Mills (1): net/context: Don't leak goroutines in Done example. Damien Neil (1): context: fix removal of cancelled timer contexts from parent David Symonds (2): context: Fix WithValue example code. net: add import comments. Sameer Ajmani (1): context: fix TestAllocs to account for ints in interfaces
61 lines
2.2 KiB
Go
61 lines
2.2 KiB
Go
package host
|
|
|
|
import (
|
|
ma "github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/jbenet/go-multiaddr"
|
|
context "github.com/jbenet/go-ipfs/Godeps/_workspace/src/golang.org/x/net/context"
|
|
inet "github.com/jbenet/go-ipfs/p2p/net"
|
|
peer "github.com/jbenet/go-ipfs/p2p/peer"
|
|
protocol "github.com/jbenet/go-ipfs/p2p/protocol"
|
|
eventlog "github.com/jbenet/go-ipfs/thirdparty/eventlog"
|
|
)
|
|
|
|
var log = eventlog.Logger("p2p/host")
|
|
|
|
// Host is an object participating in a p2p network, which
|
|
// implements protocols or provides services. It handles
|
|
// requests like a Server, and issues requests like a Client.
|
|
// It is called Host because it is both Server and Client (and Peer
|
|
// may be confusing).
|
|
type Host interface {
|
|
// ID returns the (local) peer.ID associated with this Host
|
|
ID() peer.ID
|
|
|
|
// Peerstore returns the Host's repository of Peer Addresses and Keys.
|
|
Peerstore() peer.Peerstore
|
|
|
|
// Returns the listen addresses of the Host
|
|
Addrs() []ma.Multiaddr
|
|
|
|
// Networks returns the Network interface of the Host
|
|
Network() inet.Network
|
|
|
|
// Mux returns the Mux multiplexing incoming streams to protocol handlers
|
|
Mux() *protocol.Mux
|
|
|
|
// Connect ensures there is a connection between this host and the peer with
|
|
// given peer.ID. Connect will absorb the addresses in pi into its internal
|
|
// peerstore. If there is not an active connection, Connect will issue a
|
|
// h.Network.Dial, and block until a connection is open, or an error is
|
|
// returned. // TODO: Relay + NAT.
|
|
Connect(ctx context.Context, pi peer.PeerInfo) error
|
|
|
|
// SetStreamHandler sets the protocol handler on the Host's Mux.
|
|
// This is equivalent to:
|
|
// host.Mux().SetHandler(proto, handler)
|
|
// (Threadsafe)
|
|
SetStreamHandler(pid protocol.ID, handler inet.StreamHandler)
|
|
|
|
// RemoveStreamHandler removes a handler on the mux that was set by
|
|
// SetStreamHandler
|
|
RemoveStreamHandler(pid protocol.ID)
|
|
|
|
// NewStream opens a new stream to given peer p, and writes a p2p/protocol
|
|
// header with given protocol.ID. If there is no connection to p, attempts
|
|
// to create one. If ProtocolID is "", writes no header.
|
|
// (Threadsafe)
|
|
NewStream(pid protocol.ID, p peer.ID) (inet.Stream, error)
|
|
|
|
// Close shuts down the host, its Network, and services.
|
|
Close() error
|
|
}
|