From patchwork Thu Oct 22 03:54:08 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1385913 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org (client-ip=140.211.166.137; helo=fraxinus.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=ovn.org Received: from fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4CGtlw16vCz9sSn for ; Thu, 22 Oct 2020 14:54:36 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 9F5528685B; Thu, 22 Oct 2020 03:54:34 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from fraxinus.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Qxkbe0N20bL6; Thu, 22 Oct 2020 03:54:33 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by fraxinus.osuosl.org (Postfix) with ESMTP id D10CD85951; Thu, 22 Oct 2020 03:54:33 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id B2666C08A1; Thu, 22 Oct 2020 03:54:33 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by lists.linuxfoundation.org (Postfix) with ESMTP id 98544C0052 for ; Thu, 22 Oct 2020 03:54:31 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 88681204E7 for ; Thu, 22 Oct 2020 03:54:31 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id d5Xur2j4nxTt for ; Thu, 22 Oct 2020 03:54:30 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from relay1-d.mail.gandi.net (relay1-d.mail.gandi.net [217.70.183.193]) by silver.osuosl.org (Postfix) with ESMTPS id B4557204DB for ; Thu, 22 Oct 2020 03:54:29 +0000 (UTC) X-Originating-IP: 75.54.222.30 Received: from sigfpe.attlocal.net (75-54-222-30.lightspeed.rdcyca.sbcglobal.net [75.54.222.30]) (Authenticated sender: blp@ovn.org) by relay1-d.mail.gandi.net (Postfix) with ESMTPSA id CB825240003; Thu, 22 Oct 2020 03:54:25 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Wed, 21 Oct 2020 20:54:08 -0700 Message-Id: <20201022035415.33541-1-blp@ovn.org> X-Mailer: git-send-email 2.26.2 MIME-Version: 1.0 Cc: Ben Pfaff Subject: [ovs-dev] [PATCH ovn 1/8] ovn-nb: Better document dynamic addresses. X-BeenThere: ovs-dev@openvswitch.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ovs-dev-bounces@openvswitch.org Sender: "dev" Signed-off-by: Ben Pfaff Acked-by: Numan Siddique --- ovn-nb.xml | 75 ++++++++++++++++++------------------------------------ 1 file changed, 25 insertions(+), 50 deletions(-) diff --git a/ovn-nb.xml b/ovn-nb.xml index 86195af3414c..38724f3851b1 100644 --- a/ovn-nb.xml +++ b/ovn-nb.xml @@ -1049,65 +1049,40 @@
dynamic
- Use this keyword to make ovn-northd generate a - globally unique MAC address and choose an unused IPv4 address with - the logical port's subnet and store them in the port's column. ovn-northd will - use the subnet specified in in the port's . -
- -
Ethernet address followed by keyword "dynamic"
-
-

- The keyword dynamic after the MAC address indicates - that ovn-northd should choose an unused IPv4 address - from the logical port's subnet and store it with the specified - MAC in the port's column. - ovn-northd will use the subnet specified in in - the port's table. + Use dynamic to make ovn-northd generate + a globally unique MAC address, choose an unused IPv4 address with + the logical port's subnet (if is set in the port's ), and generate an IPv6 address from the + MAC address (if is set in the port's ) and store them in the port's column.

- Examples: + Only one element containing dynamic may appear in + .

- -
-
80:fa:5b:06:72:b7 dynamic
-
- This indicates that the logical port owns the specified - MAC address and ovn-northd should allocate an - unused IPv4 address for the logical port from the corresponding - logical switch subnet. -
-
-
Keyword "dynamic" followed by an IPv4/IPv6 address
+
dynamic ip
+
dynamic ipv6
+
dynamic ip ipv6
+ These act like dynamic alone but specify particular + IPv4 or IPv6 addresses to use. OVN IPAM will still automatically + allocate the other address if configured appropriately. Example: + dynamic 192.168.0.1 2001::1. +
-

- The keyword dynamic followed by an IPv4/IPv6 - address indicates that ovn-northd should choose - a dynamic ethernet address and use the provided IPv4/IPv6 address - as network address. -

- -

- Examples: -

- -
-
dynamic 192.168.0.1 2001::1
-
- This indicates that ovn-northd should allocate - a unique MAC address and use the provided IPv4/IPv6 address - for the related port -
-
+
mac dynamic
+
+ This acts like dynamic alone but specifies a + particular MAC address to use. OVN IPAM will still automatically + allocate IPv4 or IPv6 addresses, or both, if configured + appropriately. Example: 80:fa:5b:06:72:b7 dynamic
router