diff options
| author |   Robin H. Johnson <robbat2@gentoo.org> | 2020-06-02 14:35:31 -0700 |
|---|---|---|
| committer | Robin H. Johnson <robbat2@gentoo.org> | 2020-06-02 14:35:31 -0700 |
| commit | 51a7c4fae619a05b8f179f5f03b3e8a556df7205 (patch) | |
| tree | f0e0c23099a25596f6f37fa281e5f9c4f404a77c /doc | |
| parent | dhclientv6: Add DHCPv6 support via dhclient (diff) | |
| download | netifrc-51a7c4fae619a05b8f179f5f03b3e8a556df7205.tar.gz netifrc-51a7c4fae619a05b8f179f5f03b3e8a556df7205.tar.bz2 netifrc-51a7c4fae619a05b8f179f5f03b3e8a556df7205.zip | |
doc/net.example.Linux: document !wireless better
Users that used layer2 wireless configuration external to netifrc and
had previously configured netifrc with:
`modules="!iwconfig !wpa_supplicant"`
were surprised by the introduction of the iw & iwd modules, because the
modules tries to auto-configure the wireless interfaces.
Document that `modules="!wireless"` is a better configuration knob for
this situation.
Bug: https://bugs.gentoo.org/717226
Signed-off-by: Robin H. Johnson <robbat2@gentoo.org>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/net.example.Linux.in | 21 |
1 files changed, 16 insertions, 5 deletions
diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in index 53d9e84..4fc603b 100644 --- a/doc/net.example.Linux.in +++ b/doc/net.example.Linux.in @@ -43,8 +43,20 @@ # You can also specify which modules not to use - for example you may be # using a supplicant or linux-wlan-ng to control wireless configuration but # you still want to configure network settings per SSID associated with. -#modules="!iwconfig !wpa_supplicant" -# IMPORTANT: If you need the above, please disable modules in that order +# +# A common case here may be using hostapd or other external configuration of +# the wireless hardware at layer 2, but leaving netifrc to configure the layer +# 3 networking +# +# Best practice for this situation is to disable ALL netifrc wireless modules: +#modules="!wireless" +# +# This supersedes older cases where each module was disabled seperately: +# If new modules are introduced that provide wireless support, they may be used +# automatically otherwise, causing situations like +# https://bugs.gentoo.org/717226 +# Do not use a line like this anymore: +#modules="!iwconfig !wpa_supplicant !iw !iwd" ############################################################################## @@ -435,9 +447,8 @@ # won't have associated then) # If you're using anything else to configure wireless on your interface AND -# you have installed wpa_supplicant, you need to disable wpa_supplicant -#modules="!iwconfig !wpa_supplicant" -#or +# you have installed wpa_supplicant, you need to disable wpa_supplicant. +# Please see the note about hostapd in the MODULES section. #modules="!wireless" ############################################################################## |