diff --git a/src/SUMMARY.md b/src/SUMMARY.md index fe50a564d..2b8471b5b 100644 --- a/src/SUMMARY.md +++ b/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) diff --git a/src/config/network/connman.md b/src/config/network/connman.md new file mode 100644 index 000000000..191f022da --- /dev/null +++ b/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" +```