freeRouter is a free, open source router os process. it speaks routing protocols, and (re)encapsulates packets on interfaces. it can export the computed forwarding tables to external dataplanes.
summary of features:
- forwarding: ipv4, ipv6, ipx, mpls, nsh, layer2, irb, atom, eompls, vpls, evpn
- routing protocols: ospf, isis, bgp, rip, eigrp, rift, babel, olsr, pim, msdp
- lsp support: p2p, p2mp, mp2mp built by bgp, ldp, rsvp-te, sr, sr-te, bier, polka
- crypto: macsec, ipsec, ikev1, ikev2, tls, dtls, ssh, openvpn, wireguard, sgt
- tunnel: gre, ipip, l2tp, pptp, lisp, geneve, nvgre, vxlan, etherip, amt
- encapsulation: ethernet, vlan, qinq, ppp(oe), framerelay, pwether, virtppp, hairpin
- misc: acl, qos, nat, pbr, srv6, vrrp, hsrp, inspect, 6to4, rpl, tunnel, vpdn, pcep
more about the project at www.freertr.org
you can find the same source tree at various locations, normally all should be the same:
- https://src.freertr.org/
- https://sources.freertr.org/
- https://codeberg.org/mc36/freeRtr
- https://bitbucket.org/mc361/freeRtr
- https://gitlab.com/mc36mc/freeRtr
- https://github.com/mc36/freeRtr
part of the subdirectories under misc/ are somewhere else too:
- p4bf at https://bitbucket.software.geant.org/projects/RARE/repos/rare/browse
- p4bmv2 at https://github.com/rare-freertr/RARE-bmv2
you'll need an up to date debian sid with a jdk installed
for natives, you'll need clang, dpdk, libpcap, libbpf, libxdp, liburing, libmnl and libcrypto
for p4sai, you'll need libsai
for p4bmv2, you'll need p4c and bmv2
for p4bf, you'll need the tofino sdk and a switch with the asic
the following directories could be found here:
- src contains the main sources
- cfg contains the self tests
- misc contains some smaller subprojects, see below
the following directories will appear here:
- img vm images used for interop and dataplane testing
- binDwn packages used for demo vm creation
- binDsk rootfs used for demo vm creation
- binMnt rootfs mounted for demo vm creation
- binImg outcome of demo vm creation
- binOut output of compilation
- binTmp output of testing
- native: dpdk, xdp, pcap, xsk, io uring, raw socket, mnl and sai based dataplanes
- p4bf: tofino based dataplane
- p4bmv2: bmv2 based dataplane
- bogon: web based bogon originator
- lookingglass: web based looking glass
- captures: script to stream captures
- sniffer: web based packet capture
- mailer: web based mail reader
- paster: web based pastebin service
- gallery: web based album viewer
- motion: web based alarm/recorder
- player: web based music player/streamer/receiver
- temper: web based thermostat/controller
- trackmap: web based monitoring
- voice: an answering machine
- snmp: some snmp definitions
- rfcs: rfc series renamer
- consistency: old style check definitions
- tests: some volumentric generators
- check: some check definitions
- sensor: some sensor definitions
- prometheus: some grafana definitions
- netconf: some yang definitions
- image: demo vm iso creator
- img2ova: demo vm ova creator
- service: install script
there is no build system in use, but you'll find shell scripts:
- d.sh to clean up
- c.sh to compile
- r.sh to run
- t.sh to selftest
as a first start to get your routers up, do the following:
- cd src
- ./c.sh
- ./tw.sh rout-bgp001
- telnet 127.0.0.1 20001
- telnet 127.0.0.1 20002
- telnet 127.0.0.1 20003
- telnet 127.0.0.1 20004
to have a topology with a dataplane, do the following:
- cd src
- ./c.sh
- ./cn.sh
- ./twd.sh p4lang-rout001
- telnet 127.0.0.1 20001
- telnet 127.0.0.1 20003
- telnet 127.0.0.1 20004
- telnet 127.0.0.1 20005
- telnet 127.0.0.1 20006
to start coding on the project, take a look on the following:
- grep me-the in the sources to see how to add a show command
- grep ifcHdlc to see how to add a new interface encapsulation
- take a look on rtrDownload to see an exmaple routing protocol
- find out how to add a new game to the command line interface
- try to solve a puzzle from the todo.txt in the source tree
- in most of the folders there is a class to extend or implment
- your eyes will bleed because of the mix of c, p4 and java
feel free to reach us on the mailing lists with your patches, ideas, feature requests, etc