Date: Wed, 29 Jun 2022 08:19:29 GMT From: Mateusz Piotrowski <0mp@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Subject: git: fb40141d2b25 - stable/13 - ifconfig.8: Improve description of the address argument Message-ID: <202206290819.25T8JTRd005353@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
The branch stable/13 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=fb40141d2b254916ce9563f1de3cf922b4621872 commit fb40141d2b254916ce9563f1de3cf922b4621872 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-31 09:28:41 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-06-29 08:15:11 +0000 ifconfig.8: Improve description of the address argument - Split paragraphs for clarity. - Add an example of setting a random MAC address. MFC after: 2 weeks (cherry picked from commit 3049aac91b91a119ff3cdc09c90c501873415f97) --- sbin/ifconfig/ifconfig.8 | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index 1edcc1b35e09..f039cd0c855d 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -270,7 +270,7 @@ That is, one can specify an address like .Li 192.168.0.1/16 . .Pp For the -.Dq inet6 +.Cm inet6 family, it is also possible to specify the prefix length using the slash notation, like .Li ::1/128 . @@ -299,20 +299,23 @@ parameter below for more information. .\" count out long strings of digits in network byte order. .Pp The link-level -.Pq Dq link +.Pq Cm link address is specified as a series of colon-separated hex digits. This can be used to, for example, set a new MAC address on an Ethernet interface, though the mechanism used is not Ethernet specific. +.Pp Use the -.Pq Dq random +.Cm random keyword to set a randomly generated MAC address. A randomly-generated MAC address might be the same as one already in use in the network. Such duplications are extremely unlikely. +.Pp If the interface is already -up when this option is used, it will be briefly brought down and +up when the link-level address is modified, +it will be briefly brought down and then brought back up again in order to ensure that the receive filter in the underlying Ethernet hardware is properly reprogrammed. .It Ar address_family @@ -3149,6 +3152,9 @@ Display inet and inet6 address subnet masks in CIDR notation .Pp Display interfaces that are up with the exception of loopback .Dl # ifconfig -a -u -G lo +.Pp +Set a randomly-generated MAC address on tap0: +.Dl # ifconfig tap0 ether random .Sh DIAGNOSTICS Messages indicating the specified interface does not exist, the requested address is unknown, or the user is not privileged and
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202206290819.25T8JTRd005353>