git: 3049aac91b91 - main - ifconfig.8: Improve description of the address argument

From: Mateusz Piotrowski <>
Date: Thu, 31 Mar 2022 09:45:01 UTC
The branch main has been updated by 0mp (doc, ports committer):


commit 3049aac91b91a119ff3cdc09c90c501873415f97
Author:     Mateusz Piotrowski <>
AuthorDate: 2022-03-31 09:28:41 +0000
Commit:     Mateusz Piotrowski <>
CommitDate: 2022-03-31 09:43:18 +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
 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 9fede254314c..9c6e280dc954 100644
--- a/sbin/ifconfig/ifconfig.8
+++ b/sbin/ifconfig/ifconfig.8
@@ -270,7 +270,7 @@ That is, one can specify an address like
 .Li .
 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.
 The link-level
-.Pq Dq link
+.Pq Cm link
 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.
 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.
 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
 Display interfaces that are up with the exception of loopback
 .Dl # ifconfig -a -u -G lo
+Set a randomly-generated MAC address on tap0:
+.Dl # ifconfig tap0 ether random
 Messages indicating the specified interface does not exist, the
 requested address is unknown, or the user is not privileged and