52 lines
1.2 KiB
Go
52 lines
1.2 KiB
Go
// Package router provides a network routing control plane
|
|
package router
|
|
|
|
import "time"
|
|
|
|
var (
|
|
// DefaultRouter is default network router
|
|
DefaultRouter = NewRouter()
|
|
)
|
|
|
|
// Router is an interface for a routing control plane
|
|
type Router interface {
|
|
// Init initializes the router with options
|
|
Init(...Option) error
|
|
// Options returns the router options
|
|
Options() Options
|
|
// ID returns the id of the router
|
|
ID() string
|
|
// Table returns the routing table
|
|
Table() Table
|
|
// Address returns the router adddress
|
|
Address() string
|
|
// Network returns the network address of the router
|
|
Network() string
|
|
// Advertise starts advertising routes to the network
|
|
Advertise() (<-chan *Update, error)
|
|
// Update updates the routing table
|
|
Update(*Update) error
|
|
// Stop stops the router
|
|
Stop() error
|
|
// String returns debug info
|
|
String() string
|
|
}
|
|
|
|
// Update is sent by the router to the network
|
|
type Update struct {
|
|
// ID is the source router ID
|
|
ID string
|
|
// Timestamp marks the time when update is sent
|
|
Timestamp time.Time
|
|
// Event defines advertisement even
|
|
Event *Event
|
|
}
|
|
|
|
// Option used by the router
|
|
type Option func(*Options)
|
|
|
|
// NewRouter creates new Router and returns it
|
|
func NewRouter(opts ...Option) Router {
|
|
return newRouter(opts...)
|
|
}
|