git: 4d91c53a789c - main - ifconfig.8: Document "ifconfig -g groupname"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 31 Mar 2022 15:08:45 UTC
The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=4d91c53a789ca4cb8f6951d7bdc8a1bf80e858ff commit 4d91c53a789ca4cb8f6951d7bdc8a1bf80e858ff Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-31 14:30:29 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-03-31 15:07:15 +0000 ifconfig.8: Document "ifconfig -g groupname" "ifconfig -g groupname" prints a list of interface names, which could be confusing, because it differs from the behavior of "ifconfig -a -g groupname". While here, add two examples showing the difference between "ifconfig -a -g groupname" and "ifconfig -g groupname". Fixes: 0dad3f0e1512 Import interface groups from OpenBSD. MFC after: 2 weeks --- sbin/ifconfig/ifconfig.8 | 50 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index df5f58b81309..d09e2b2f4507 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -202,6 +202,19 @@ may contain shell patterns in which case it should be quoted. Limit the output to the members of the specified .Ar groupname . .Pp +If +.Fl g +is specified before other significant flags like, e.g., +.Fl a , +.Fl l , +or +.Fl C , +then +.Nm +lists names of interfaces beloning to +.Ar groupname . +Any other flags and arguments are ignored in this case. +.Pp Only one option .Fl g should be specified as later override previous ones @@ -3129,6 +3142,43 @@ Display inet and inet6 address subnet masks in CIDR notation Display interfaces that are up with the exception of loopback .Dl # ifconfig -a -u -G lo .Pp +Display a list of interface names beloning to the wlan group: +.Bd -literal -offset indent -compact +# ifconfig -g wlan +wlan0 +wlan1 +.Ed +.Pp +Display details about the interfaces belonging to the wlan group: +.Bd -literal -offset indent -compact +# ifconfig -a -g wlan +wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 + ether 75:4c:61:6b:7a:73 + inet6 fe80::4c75:636a:616e:ffd8%wlan0 prefixlen 64 scopeid 0x3 + inet6 2001:5761:6e64:6152:6f6d:616e:fea4:ffe2 prefixlen 64 autoconf + inet 192.168.10.5 netmask 0xffffff00 broadcast 192.168.10.255 + groups: wlan + ssid "Hotspot" channel 11 (2462 MHz 11g) bssid 12:34:ff:ff:43:21 + regdomain ETSI country DE authmode WPA2/802.11i privacy ON + deftxkey UNDEF AES-CCM 2:128-bit AES-CCM 3:128-bit txpower 30 bmiss 10 + scanvalid 60 protmode CTS wme roaming MANUAL + parent interface: iwm0 + media: IEEE 802.11 Wireless Ethernet DS/2Mbps mode 11g + status: associated + nd6 options=23<PERFORMNUD,ACCEPT_RTADV,AUTO_LINKLOCAL> +wlan1: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 + ether 00:50:69:6f:74:72 + groups: wlan + ssid "" channel 2 (2417 MHz 11g) + regdomain FCC country US authmode OPEN privacy OFF txpower 30 bmiss 7 + scanvalid 60 bgscan bgscanintvl 300 bgscanidle 250 roam:rssi 7 + roam:rate 5 protmode CTS wme bintval 0 + parent interface: rum0 + media: IEEE 802.11 Wireless Ethernet autoselect (autoselect) + status: no carrier + nd6 options=29<PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL> +.Ed +.Pp Set a randomly-generated MAC address on tap0: .Dl # ifconfig tap0 ether random .Sh DIAGNOSTICS