Provides the ra package that implements a router-side functionality of IPv6
Neighbor Discovery mechanism
(RFC4861 and related RFCs). It
also provides a stand-alone daemon gorad and CLI tool gora to interact with
it. While the existing
mdlayher/ndp package provides a
low-level protocol functionalities (packet encoding, raw-socket wrapper, etc),
go-ra implements an unsolicited and solicited advertisement machinery and
declarative configuration interface on top of it.
- Basic RA mechanism defined in RFC4861
- Router MAC address discovery with Source Link Layer Address option
- MTU discovery with MTU option
- Prefix discovery with Prefix Information option
- DNS configuration discovery with RDNSS/DNSSL option
- Route advertisement with Route Information option
- NAT64 prefix discovery with PREF64 option
- Library: Use Go Modules as usual
- Stand-alone Binary: Visit release page and install pre-build binaries
- Container Image: Visit registry page and pull images
// Build a configuration
config := ra.Config{
Interfaces: []*ra.InterfaceConfig{
{
Name: "eth0",
// Send unsolicited RA once a second
RAIntervalMilliseconds: 1000, // 1sec
},
},
}
// Create an RA daemon
daemon, _ := ra.NewDaemon(&config)
// Run it
ctx, cancel := context.WithCancel(context.Background())
go daemon.Run(ctx)
// Get a running status
status := daemon.Status()
for _, iface := range status.Interfaces {
fmt.Printf("%s: %s (%s)\n", iface.Name, iface.State, iface.Message)
}
// Change configuration and reload
config.Interfaces[0].RAIntervalMilliseconds = 2000 // 2sec
err := daemon.Reload(ctx, &config)
if err != nil {
panic(err)
}
// Stop it
cancel()Create a configuration file. This configuration will be translated into the Config object and passed to the daemon. Please see the godoc for more details.
interfaces:
- name: eth0
raIntervalMilliseconds: 1000 # 1secStart daemon. You need a root privilege to run it.
$ sudo gorad -f config.yamlGet status.
$ gora status
Name Age TxUnsolicited TxSolicited State Message
eth0 22s 21 1 RunningModify and reload configuration
$ gora reload -f config.yamlOur original motivation for this project was use it with gobgp library to do BGP Unnumbered (see our integration test) which for us, makes sense to reinvent the RA daemon to not introduce an external non-go dependency.
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent