Doc: Example simple config

diff --git a/bird.conf b/bird.conf
index bafd6ea17a9023dc247fd3647ce14e50169c6b7e..c2b473784b07155219b189a63c011268013ad8f9 100644 (file)
--- a/bird.conf
+++ b/bird.conf
@@ -1,44 +1,57 @@
 /*
- *     This is an example configuration file.
+ *     This is a simple example configuration file with no aim for completeness.
+ *     See documentation for full description.
  */
 
-# Yet another comment
-
+# Router ID in IPv4 format
 router id 62.168.0.1;
 
-define xyzzy = (120+10);
+# Load device information from kernel.
+protocol device {}
 
-protocol device {
+# Generate direct routes for interfaces. Useful on BSD.
+protocol direct {
+       ipv4;
        disabled;
-#      interface "eth*", "ppp*";
 }
 
 protocol direct {
+       ipv6;
+       disabled;
 }
 
+# Feed routes to kernel FIB
 protocol kernel {
-       disabled;
+       ipv4 { export all; };
 #      learn;                  # Learn all routes from the kernel
 #      scan time 10;           # Scan kernel tables every 10 seconds
 }
 
-protocol static {
-#      disabled;
+protocol kernel {
+       ipv6;
+}
 
-       route fec0:2::/64 blackhole;
-       route fec0:3::/64 unreachable;
-       route fec0:4::/64 prohibit;
+# Static route feed
+protocol static {
+       ipv4 { export all; };
+       route 10.0.0.0/24 via 55.55.55.44;
+       route 10.10.0.0/16 blackhole;
+       route 10.20.0.0/20 unreachable;
+       route 10.30.50.0/28 prohibit;
+}
 
-#      route 0.0.0.0/0 via 195.113.31.113;
-#      route 62.168.0.0/25 unreachable;
-#      route 1.2.3.4/32 via 195.113.31.124;
-#      route 10.0.0.0/8 unreachable;
-#      route 10.1.1.0:255.255.255.0 via 62.168.0.3;
-#      route 10.1.2.0:255.255.255.0 via 62.168.0.3;
-#      route 10.1.3.0:255.255.255.0 via 62.168.0.4;
-#      route 10.2.0.0/24 via "arc0";
-       export all;
+protocol static {
+       ipv6 { export all; };
+       route 2001:db8:1::/48 via 5555::6666;
+       route 2001:db8:2::/48 blackhole;
+       route 2001:db8:3::/48 prohibit;
+       route 2001:db8:4::/48 unreachable;
 }
 
 protocol rip {
+       ipv4;
+}
+
+protocol ripng {
+       ipv6;
 }