d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

ifconfig.8: Document "ifconfig -g groupname"

Browse Source 
"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:	0dad3f0e15 Import interface groups from OpenBSD.
MFC after:	2 weeks
This commit is contained in:
Mateusz Piotrowski 2022-03-31 16:30:29 +02:00
parent 47f6b1bf06
commit 4d91c53a78
1 changed files with 50 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
sbin/ifconfig/ifconfig.8
View File

@ -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