From f10c7cac45f99e18c2a62b2d0b36a395891b77c7 Mon Sep 17 00:00:00 2001 From: Blake Harnden <32446120+bharnden@users.noreply.github.com> Date: Mon, 6 Feb 2023 09:22:00 -0800 Subject: [PATCH] docs: reformatted bird documentation and removed invalid example link --- docs/services/bird.md | 26 +++++++++++++++++++++----- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/docs/services/bird.md b/docs/services/bird.md index 30b7a7e3..8fa7b895 100644 --- a/docs/services/bird.md +++ b/docs/services/bird.md @@ -5,9 +5,20 @@ ## Overview -The [BIRD Internet Routing Daemon](https://bird.network.cz/) is a routing daemon; i.e., a software responsible for managing kernel packet forwarding tables. It aims to develop a dynamic IP routing daemon with full support of all modern routing protocols, easy to use configuration interface and powerful route filtering language, primarily targeted on (but not limited to) Linux and other UNIX-like systems and distributed under the GNU General Public License. BIRD has a free implementation of several well known and common routing and router-supplemental protocols, namely RIP, RIPng, OSPFv2, OSPFv3, BGP, BFD, and NDP/RA. BIRD supports IPv4 and IPv6 address families, Linux kernel and several BSD variants (tested on FreeBSD, NetBSD and OpenBSD). BIRD consists of bird daemon and birdc interactive CLI client used for supervision. +The [BIRD Internet Routing Daemon](https://bird.network.cz/) is a routing +daemon; i.e., a software responsible for managing kernel packet forwarding +tables. It aims to develop a dynamic IP routing daemon with full support of +all modern routing protocols, easy to use configuration interface and powerful +route filtering language, primarily targeted on (but not limited to) Linux and +other UNIX-like systems and distributed under the GNU General Public License. +BIRD has a free implementation of several well known and common routing and +router-supplemental protocols, namely RIP, RIPng, OSPFv2, OSPFv3, BGP, BFD, +and NDP/RA. BIRD supports IPv4 and IPv6 address families, Linux kernel and +several BSD variants (tested on FreeBSD, NetBSD and OpenBSD). BIRD consists +of bird daemon and birdc interactive CLI client used for supervision. -In order to be able to use the BIRD Internet Routing Protocol, you must first install the project on your machine. +In order to be able to use the BIRD Internet Routing Protocol, you must first +install the project on your machine. ## BIRD Package Install @@ -17,7 +28,8 @@ sudo apt-get install bird ## BIRD Source Code Install -You can download BIRD source code from it's [official repository.](https://gitlab.labs.nic.cz/labs/bird/) +You can download BIRD source code from its +[official repository.](https://gitlab.labs.nic.cz/labs/bird/) ```shell ./configure make @@ -25,6 +37,10 @@ su make install vi /etc/bird/bird.conf ``` -The installation will place the bird directory inside */etc* where you will also find its config file. +The installation will place the bird directory inside */etc* where you will +also find its config file. -In order to be able to do use the Bird Internet Routing Protocol, you must modify *bird.conf* due to the fact that the given configuration file is not configured beyond allowing the bird daemon to start, which means that nothing else will happen if you run it. Keeran Marquis has a very detailed example on [Configuring BGP using Bird on Ubuntu](https://blog.marquis.co/configuring-bgp-using-bird-on-ubuntu-14-04lts/) which can be used as a building block to implement your custom routing daemon. +In order to be able to do use the Bird Internet Routing Protocol, you must +modify *bird.conf* due to the fact that the given configuration file is not +configured beyond allowing the bird daemon to start, which means that nothing +else will happen if you run it.