You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on May 24, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: doc/router-advert-feature-guide.md
+174-1Lines changed: 174 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,9 @@
2
2
3
3
The `"Router Advertisement"` feature enables `wpantund` to emit periodic Neighbor Discovery ICMPv6 Router Advertisement (RA) messages announcing routes on other network interfaces related to Thread network routes.
4
4
5
-
The routes included in RA message mirror all the routes added on the host primary interface corresponding to the Thread network:
5
+
The emitted RA can inlcude a set of prefixes (determined by user) or annoucne a default route.
6
+
7
+
When "Route Info" option is enabled, the routes included in RA message mirror all the routes added on the host primary interface corresponding to the Thread network:
6
8
- Host routes associated with off-mesh routes within the Thread network (when `Daemon:OffMeshRoute:AutoAddOnInterface` feature is enabled).
7
9
- Host routes associated with on-mesh prefixes within the Thread network (when `Daemon:OnMeshPrefix:AutoAddAsInterfaceRoute` feature is enabled).
8
10
- The list of interface routes is available form wpan property `IPv6:Routes`.
@@ -14,6 +16,16 @@ The wpantund RA feature can be enabled through property `RouterAdvert:Enable` (b
14
16
-`RouterAdvert:TxPeriod` the tx period of RA messages in units of seconds. Minimum period is 4 seconds, max period is 1800 seconds. The period is set to min or max if the value being set is out of the supported range. On start it is set to 10 seconds.
15
17
-`RouterAdvert:DefaultRoute:Lifetime` specifies the lifetime value in RA header (non-zero indicates that we are a default route). By default it is set to zero (i.e. not a default route).
16
18
-`RouterAdvert:DefaultRoute:Preference` specifies the default route preference. Positive value indicates high, zero indicates medium, and negative indicates low preference. Default value is zero (medium).
19
+
-`RouterAdvert:AddRouteInfoOption` can be used to enable or disable adding of "Route Info" option in RA. When set to false, the emitted RAs would not contain any "Route Info" options. By default it is enabled (set to true).
20
+
-`RouterAdvert:Prefixes` specifies the list of prefixes which are included in the RA message. This is a list-based property (we can set the entire list or use `add` or `remove` command to update the list item by item). When adding to the list, we can specify the length, valid and preferred lifetime, and associated flags (on-link and auto-config). A set of wpan properties are defined to help specify these. The value specified through these properties would apply to any next prefix added/removed to the list:
21
+
22
+
-`RouterAdvert:Prefix:PrefixLength` in bits 0-128 - default is 64.
23
+
-`RouterAdvert:Prefix:ValidLifetime` in seconds - default is 3600.
24
+
-`RouterAdvert:Prefix:PreferredLifetime` in seconds - default is 3600.
25
+
-`RouterAdvert:Prefix:Flag:OnLink` boolean value for on-link flag - default is true.
26
+
-`RouterAdvert:Prefix:Flag:AutoConfig` boolean value for auto-config flag - default is true.
27
+
28
+
When issuing a wpantund `leave` command, the list of prefixes and netifs for router advertisement will be cleared.
17
29
18
30
# Example of behavior
19
31
@@ -166,5 +178,166 @@ The property `RouterAdvert:DefaultRoute:Preference` determines default route pre
(NOTE: Since we are seing RA with `fd00:cafe:beef::` on wpan1 interface with on-link and auto-config flags, linux itself added an address with this prefix on `wpan1` interface which in turn was pushed to NCP by wpantund and its prefix added to list of on-mesh prefixes within Thread network. This in turn caused it to be added as a router info option as well)
0 commit comments