toolchain/gcc: correct the check expr for newer clang
[librecmc/librecmc.git] / docs / Bridge_Mode.md
index 9f29c591059f16965ef23f5f8b357cd7e42500d8..341cdc567d4d9eb22e7ee0551a17830f78817618 100644 (file)
@@ -6,7 +6,7 @@ to bridge mode, where the devices stops acting like an IP router
 2). LibreCMC does not actually have a bridge mode, but the same effect
 is achievable with two easy steps.
 
-1. Add the LAN ethernet port to the LAN bridge interface
+1. Add the WAN ethernet port to the LAN bridge interface
 2. Set the DHCP server to ignore the LAN interface
 
 ## Adjust the LAN bridge interface
@@ -21,6 +21,9 @@ Place a checkmark in the box for the "eth0" interface for wan and
 wan6. (I suppose the interface name might vary amongst different
 routers.)
 
+![alt text](images/librecmc-eth0-added-to-lan.png "Adjustments to
+ LibreCMC interface physical settings")
+
 You can also check the box for Enable STP if desired. There doesn't
 seem to be any downside from this, though I suppose it would use a
 little more CPU cycles and memory. STP is a protocol intended to
@@ -32,8 +35,8 @@ layer 2 switches.
 On the same page, scroll down a little to the DHCP Server section. In
 the General Setup tab, check the "Ignore interface" box.
 
-![alt text](images/librecmc-eth0-added-to-lan.png "Adjustments to
- LibreCMC interface physical settings")
+![alt text](images/librecmc-dhcp-server-ignore-lan.png "Setting
+ LibreCMC DHCP server to ignore LAN interface")
 
 Save and apply your changes.
 
@@ -59,10 +62,40 @@ LibreCMC device's MAC address, so you don't have trouble finding it.
 
 ![alt text](images/librecmc-switch-lan-to-dhcp.png)
 
-## Adjusting the firewall...?
+## Advanced
+
+These adjustments are not required, but they lead to a configuration
+which will be more consistent and have cleaner logs.
+
+### Disabling odhcpd (DHCP daemon)
+
+In bridge mode, you aren't going to want to serve DHCP out any
+interface. So you might as well just shut down the whole DHCP
+server. Log in via SSH, and run the commands:
+
+```
+/etc/init.d/odhcpd stop
+/etc/init.d/odhcpd disable
+```
+
+### Delete the WAN(6) interfaces
+
+From `Network` >> `Interfaces`, you can delete the WAN and WAN6
+interfaces. See also the "Add a LAN6 interface" section below.
+
+### Delete the WAN Firewall Zone
+
+From `Network` >> `Firewall` you can delete the WAN zone. If you do
+need a WAN firewall, then you should not be running in bridge mode in
+the first place.
+
+### Add a LAN6 Interface
+
+If you have IPv6 access, you will want an interface which receives an
+IPv6 address. From `Network` >> `Interfaces` create a new interface
+called `LAN6` with `Protocol` set to `DHCPv6 client`.
 
-To make a more consistent look in the your LibreCMC interface, you
-could go into Network >> Firewall and do things like deleting WAN
-zones or disabling NAT masquerading. But since the ports are bridged,
-it isn't necessary, and it will only make it more work to switch back
-out of "bridge mode" if you want to later.
+You will likely also want to disable `odhcpd` (see above). Otherwise
+your logs can get filled up with unnecessary IPv6 related messages, as
+libreCMC tries to act like an IPv6 router. `odhcpd` normally handles
+DHCPv6 as well as IPv6 Router Advertisements.