Added links to index page for repo, entity db and the site. Fixing radv section.

This commit is contained in:
Tristan B. Velloza Kildaire 2021-06-24 16:32:18 +02:00
parent f14cdf5697
commit 91a1d9006e
4 changed files with 153 additions and 1 deletions

View File

@ -107,3 +107,11 @@ the original babel routing software, _babeld_, here, on the [live router map](ht
Does it sound interesting enough for you already? Want to get connected? Then head on over
to our [Getting started] section where you can find all the guides you need in order to get connected,
follow the rules and have fun!
---
## Important links
* The CRXN homepage is: http://deavmi.assigned.network/projects/crxn
* The **EntityDB** repository is: https://codeberg.org/CRXN/entitydb
* This documentation is at: https://github.com/Community-Run-eXperimental-Network/docs

View File

@ -3,7 +3,13 @@ Radv
Radv or _Router advertisements_ is a feature Bird offers that can allow you to add an additional configuration to your Bird router such that you
can have it automatically configure your host devices on your CRXN /48 LAN such that they can access the LAN, the greater CRXN and also possibly
configure [CRXN DNS]() too!
configure [CRXN DNS](../dns) too!
There are tutorials for both:
1. [Bird 1.6](bird1.6_radv.md) (untested)
2. [Bird 2.0](bird2_radv.md)
---

64
docs/radv/bird1.6_radv.md Normal file
View File

@ -0,0 +1,64 @@
Radv
====
This document is for setting up radv on Bird 1.6.
# General syntax
You will want to add one of these to one of your Bird configuration files:
```
protocol radv
{
# Stuff goes here
}
```
## Advertising your prefix
If you would like to advertise your prefix to hosts on your LAN that have set their address acquisition for IPv6 to _'Automatic'_ such that they will assign themselves an address within that prefix then you will want to add a `prefix` block as so:
```
protocol radv
{
# Advertise your prefix
prefix fd40:ec65:5b4c::/64 {
# TODO: Add anything that needs to be in here
};
# Interfaces to run radv on
interface "eth0";
}
```
In the above example I am advertising a `/64` within my `/48`/ULA (`fd40:ec65:5b4c::/48`), `fd40:ec65:5b4c::/64`, and only on interface `eth0` will radv run.
## Advertising route(s)
You can advertise a default route, to `fd00::/8` or simply all routes in your router's routing table, to your hosts using the following:
### Advertising a single `fd00::/8`
TODO: Add this as I normally don't do this even though one should as it means less memory consumption and advertisement updates
### Advertising all known routes
This will advertise all the routes your Bird router knows (those in the `crxn` table) such that your, laptop for example, will add all of them to its routing table.
```
protocol radv
{
# Advertise your prefix
prefix fd40:ec65:5b4c::/64 {
# TODO: Add anything that needs to be in here
};
# Interfaces to run radv on
interface "eth0";
# Advertise all routes (TODO: check if this is the correct syntax)
propagate_routes yes;
table crxn;
}
```

74
docs/radv/bird2_radv.md Normal file
View File

@ -0,0 +1,74 @@
Radv
====
This document is for setting up radv on Bird 2.0.
# General syntax
You will want to add one of these to one of your Bird configuration files:
```
protocol radv
{
# Stuff goes here
}
```
## Advertising your prefix
If you would like to advertise your prefix to hosts on your LAN that have set their address acquisition for IPv6 to _'Automatic'_ such that they will assign themselves an address within that prefix then you will want to add a `prefix` block as so:
```
protocol radv
{
# Advertise your prefix
prefix fd40:ec65:5b4c::/64 {
# TODO: Add anything that needs to be in here
};
# Interfaces to run radv on
interface "eth0";
}
```
In the above example I am advertising a `/64` within my `/48`/ULA (`fd40:ec65:5b4c::/48`), `fd40:ec65:5b4c::/64`, and only on interface `eth0` will radv run.
## Advertising route(s)
You can advertise a default route, to `fd00::/8` or simply all routes in your router's routing table, to your hosts using the following:
### Advertising a single `fd00::/8`
TODO: Add this as I normally don't do this even though one should as it means less memory consumption and advertisement updates
### Advertising all known routes
This will advertise all the routes your Bird router knows (those in the `crxn` table) such that your, laptop for example, will add all of them to its routing table.
```
protocol radv
{
# Enable propagating of routes exported to us via radv to hosts
propagate routes yes;
ipv6 {
# Export all your routes into the radv advertisement
export filter crxn6;
table crxn;
};
# Interface to run radv on - only eth0 (change to what you want)
interface "eth0" {
# Advertise your prefix
prefix fd40:ec65:5b4c::/64 {
# Defaults are fine
};
# Normally it will distribute a default route, disable that (TODO: Check)
prefix ::/0 {
skip yes;
};
};
}
```