Skip to content

Commit a84eb16

Browse files
authored
dnsmasq: Sort ra modes via RA flags, add local directive to host (opnsense#740)
1 parent 2b2786d commit a84eb16

File tree

1 file changed

+24
-7
lines changed

1 file changed

+24
-7
lines changed

source/manual/dnsmasq.rst

Lines changed: 24 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -208,6 +208,8 @@ DNS Settings
208208
========================================= ====================================================================================
209209
**Host** Name of the host, without the domain part. Use "*" to create a wildcard entry.
210210
**Domain** Domain of the host, e.g. example.com
211+
**Local** Set the above domain as local. This will configure this DNS server as authoritative;
212+
it will not forward queries to any upstream servers for this domain.
211213
**IP addresses** IP addresses of the host, e.g. 192.168.100.100 or fd00:abcd::1. Can be multiple IPv4
212214
and IPv6 addresses for dual stack configurations. Setting multiple addresses will automatically
213215
assign the best match based on the subnet of the interface receiving the DHCP Discover.
@@ -290,16 +292,31 @@ DHCP Settings
290292
**Description** You may enter a description here for your reference (not parsed).
291293
========================================= ====================================================================================
292294

293-
.. Note::
294295

295-
Most common `RA Mode` options:
296+
.. tab:: RA Modes
297+
298+
================ ========== ========== ========== ==================== ================ ==========
299+
**Modes** **M-Bit** **O-Bit** **A-Bit** **Default Route** **DHCPv6** **SLAAC**
300+
================ ========== ========== ========== ==================== ================ ==========
301+
**default** 1 0 0 advertised stateful no
302+
**ra-only** 0 0 0 advertised no no
303+
**slaac** 1 0 1 advertised stateful yes
304+
**ra-stateless** 0 1 1 advertised stateless yes
305+
================ ========== ========== ========== ==================== ================ ==========
306+
307+
This is what the RA Flags (Bits) mean:
308+
309+
- ``M`` - Managed address configuration:
310+
The client should use stateful DHCPv6 to obtain an IPv6 address.
311+
- ``O`` - Other configuration:
312+
The client should use stateless DHCPv6 to obtain additional information (e.g., DNS server).
313+
- ``A`` - Autonomous address-configuration:
314+
The client can use SLAAC to self-assign an IPv6 address based on the advertised prefix.
315+
316+
.. Tip::
296317

297-
- ``ra-only``: Advertise IPv6 default route
298-
- ``ra-names``: Advertise IPv6 default route, derive hostname from IPv4 lease and register it if possible. Can be combined with ra-stateless and slaac.
299-
- ``ra-stateless``: (O + A bits) Advertise IPv6 default route, use SLAAC for IPv6 address, use stateless DHCPv6 for additional options
300-
- ``slaac``: (A bit) Advertise IPv6 default route, use SLAAC for IPv6 address, use DHCPv6 for additional IPv6 address and options
318+
For other RA modes not listed here, visit the `dnsmasq man page <https://thekelleys.org.uk/dnsmasq/docs/dnsmasq-man.html>`_.
301319

302-
For the less common options refer to the official dnsmasq man page.
303320

304321
.. tab:: DHCP options
305322

0 commit comments

Comments
 (0)