new page: config/network/connman

src/SUMMARY.md

@@ -29,6 +29,7 @@
       - [wpa_supplicant](./config/network/wpa_supplicant.md)
       - [iwd](./config/network/iwd.md)
       - [NetworkManager](./config/network/networkmanager.md)
+      - [ConnMan](./config/network/connman.md)
    - [Xorg](./config/xorg/index.md)
       - [Session Management](./config/xorg/session-management.md)
    - [Multimedia](./config/media/index.md)

src/config/network/connman.md

@@ -0,0 +1,41 @@
+# ConnMan
+
+[ConnMan(8)](https://man.voidlinux.org/connman.8/) is a daemon that manages
+network connections, is designed to be slim and to use as few resources as
+possible. The `connman` package contains the basic utilities to run
+[ConnMan(8)](https://man.voidlinux.org/connman.8/).
+
+## Starting ConnMan
+
+To enable the [ConnMan(8)](https://man.voidlinux.org/connman.8/) daemon, first
+[disable](../services/index.md) any other network managing services like
+[dhcpcd](dhcpcd.md), [wpa_supplicant](wpa_supplicant.md), or `wicd`. These
+services all control network interface configuration, and interfere with each
+other.
+
+Finally, enable the [ConnMan(8)](https://man.voidlinux.org/connman.8/) service:
+
+```
+# ln -s /etc/sv/connmand /var/service/
+```
+
+## Configuring ConnMan
+
+The `connman` package includes a command line tool,
+[connmanctl(1)](https://man.voidlinux.org/connmanctl.1) to control network
+settings. If you do not provide any commands
+[connmanctl(1)](https://man.voidlinux.org/connmanctl.1) starts as an interactive
+shell.
+
+There are many other front-ends to
+[ConnMan(8)](https://man.voidlinux.org/connman.8/), including `connman-ui` for
+system trays, `connman-gtk` for GTK, `cmst` for QT and `connman-ncurses` for
+ncurses based UI.
+
+## Preventing DNS overides by ConnMan
+
+Create `/etc/sv/connmand/conf` with the following content:
+
+```
+OPTS="--nodnsproxy"
+```