Merge pull request #375 from nuclearcat/doc-updates

Doc updates

1 files changed, 12 insertions, 5 deletions

diff --git a/docs/pppoe_radius.md b/docs/pppoe_radius.md
index cc3f3461..ba22426f 100644
--- a/docs/pppoe_radius.md
+++ b/docs/pppoe_radius.md
@@ -39,6 +39,12 @@ These attributes control the IPv6 configuration negotiated via IPv6CP and DHCPv6
     *   Adds a route to the client session for the specified IPv6 prefix.
     *   Format: `2001:db8::/32 gateway metric`
 
+*   **DNS-Server-IPv6-Address** (169, RFC 6911)
+    *   Assigns an IPv6 DNS server to this session. Repeat the attribute for multiple servers.
+    *   Assigned servers replace the `[ipv6-dns]` defaults for the session. Sessions without assigned servers use those defaults.
+    *   Enable `ipv6_nd` to advertise the servers through RDNSS, `ipv6_dhcp` to return them through DHCPv6 DNS_SERVERS, or both as needed.
+    *   The list is not limited to three servers; each reply includes as many as fit in its packet buffer and logs a warning if servers are omitted.
+
 ## Routing
 
 *   **Framed-Route** (22)
@@ -65,12 +71,13 @@ The `shaper` module can be configured to listen for specific RADIUS attributes t
 
 *   **Filter-Id** (11)
     *   Used to specify upload/download limits.
-    *   **Simple Format:** `speed` (bits/sec) or `speed/burst`. 
-        *   Example: `10000` (10 Mbps)
-    *   **Cisco Format:** `rate-limit output access-group 1 8000000 1500000 3000000` (downstream) / `rate-limit input ...` (upstream).
+    *   **Simple Format:** `speed` or `downstream/upstream`, in Kbit/s with the default `rate-multiplier=1`.
+        *   Example: `10000` sets both directions to 10 Mbps; `10000/2000` sets downstream to 10 Mbps and upstream to 2 Mbps.
+        *   The slash separates rates. Configure bursts with `[shaper] down-burst-factor` and `up-burst-factor`.
+    *   **Cisco Format:** Set `vendor=Cisco` and `attr=Cisco-AVPair` in `[shaper]`. Values such as `lcp:interface-config#1=rate-limit output 8000000 1500000 3000000 conform-action transmit exceed-action drop` control downstream; `rate-limit input ...` controls upstream. Cisco rates are in bits/sec and bursts are in bytes. See the [README shaper examples](../README.md#built-in-shaper) for time ranges and complete examples.
     
 *   **Mikrotik-Rate-Limit** (Vendor: Mikrotik, ID: 8)
-    *   Supported if the attribute is present.
+    *   Set `vendor=Mikrotik` and `attr=Mikrotik-Rate-Limit` in `[shaper]` to select this attribute. Its first rate is upstream and its second rate is downstream, the reverse of the simple Filter-Id order.
     
 Note: The attribute ID and Vendor ID for the shaper are configurable in the `[shaper]` section of `accel-ppp.conf`.
 
@@ -79,4 +86,4 @@ Note: The attribute ID and Vendor ID for the shaper are configurable in the `[sh
 PPPoE discovery tags (like Service-Name) are generally handled by the server configuration, but TR-101 (Broadband Forum) tags can be processed if `tr101` support is enabled.
 
 *   **TR-101 Attributes** (Vendor: ADSL-Forum)
-    *   accel-ppp can parse Agent-Circuit-Id and Agent-Remote-Id from PADO/PADR packets if they are present in Vendor-Specific tags, and these can be used for authentication or accounting logging.
+    *   With `[pppoe] tr101=1`, accel-ppp extracts Agent-Circuit-Id and Agent-Remote-Id from TR-101 Vendor-Specific tags in client PADR packets and includes them in RADIUS authentication and accounting requests. PADO is a server response, not the source of these client tags.