os-vif 4.2.1__tar.gz → 4.3.0__tar.gz

{os_vif-4.2.1 → os_vif-4.3.0}/.zuul.yaml

@@ -119,15 +119,6 @@
             os_vif_ovs:
               per_port_bridge: true
 
-# TODO(gmann): As per the 2025.1 testing runtime, we need to run at least
-# one job on Focal. This job can be removed in the nexy cycle (2025.2)
-- job:
-    name: os-vif-ovn-ubuntu-jammy
-    description: |
-      os-vif ovn job (tests hybrid-plug=false) testing on Ubuntu Focal(20.04)
-    parent: os-vif-ovn
-    nodeset: openstack-single-node-jammy
-
 - project:
     templates:
       - check-requirements
@@ -139,11 +130,9 @@
       jobs:
         - openstack-tox-functional-ovs-with-sudo
         - os-vif-ovn
-        - os-vif-ovn-ubuntu-jammy
         - os-vif-ovs-iptables
     gate:
       jobs:
         - openstack-tox-functional-ovs-with-sudo
         - os-vif-ovn
-        - os-vif-ovn-ubuntu-jammy
         - os-vif-ovs-iptables

{os_vif-4.2.1 → os_vif-4.3.0}/AUTHORS

@@ -1,8 +1,10 @@
 Adrian Chiris <adrianc@mellanox.com>
+Adrien Cunin <a.cunin@syseleven.de>
 Alin Balutoiu <abalutoiu@cloudbasesolutions.com>
 Andreas Jaeger <aj@suse.com>
 Balazs Gibizer <gibi@redhat.com>
 Bence Romsics <bence.romsics@gmail.com>
+Bodo Petermann <b.petermann@syseleven.de>
 Brian Haley <brian.haley@hpe.com>
 Cao Xuan Hoang <hoangcx@vn.fujitsu.com>
 Carlos Goncalves <cgoncalves@redhat.com>

{os_vif-4.2.1 → os_vif-4.3.0}/ChangeLog

@@ -1,6 +1,16 @@
 CHANGES
 =======
 
+4.3.0
+-----
+
+* Add TAP device pre-creation support for OVS/OVN
+* Fixed bridge name when per\_port\_bridge is used
+* Stabilize functional test
+* reno: Update master for unmaintained/2024.1
+* Update master for stable/2025.2
+* Remove remaining job with Ubuntu Jammy (22.04)
+
 4.2.1
 -----
 

{os_vif-4.2.1 → os_vif-4.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: os_vif
-Version: 4.2.1
+Version: 4.3.0
 Summary: A library for plugging and unplugging virtual interfaces in OpenStack.
 Home-page: https://docs.openstack.org/os-vif/latest/
 Author: OpenStack
@@ -33,6 +33,15 @@ Requires-Dist: ovsdbapp>=0.12.1
 Requires-Dist: pyroute2>=0.5.2
 Requires-Dist: stevedore>=1.20.0
 Requires-Dist: debtcollector>=1.19.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 ========================
 Team and repository tags

{os_vif-4.2.1 → os_vif-4.3.0}/os_vif/internal/ip/ip_command.py

@@ -18,6 +18,7 @@ class IpCommand(metaclass=abc.ABCMeta):
     TYPE_VETH = 'veth'
     TYPE_VLAN = 'vlan'
     TYPE_BRIDGE = 'bridge'
+    TYPE_TUNTAP = 'tuntap'
 
     @abc.abstractmethod
     def set(self, device, check_exit_code=None, state=None, mtu=None,
@@ -37,11 +38,12 @@ class IpCommand(metaclass=abc.ABCMeta):
 
     @abc.abstractmethod
     def add(self, device, dev_type, check_exit_code=None, peer=None, link=None,
-            vlan_id=None, ageing=None):
+            vlan_id=None, ageing=None, mode=None, multiqueue=False):
         """Method to add an interface.
 
         :param   device: A network device (string)
-        :param   dev_type: String network device type (TYPE_VETH, TYPE_VLAN)
+        :param   dev_type: String network device type (TYPE_VETH, TYPE_VLAN,
+                           TYPE_BRIDGE, TYPE_TUNTAP)
         :param   check_exit_code: List of integers of allowed execution exit
                                   codes
         :param   peer: String peer name, for veth interfaces
@@ -50,6 +52,8 @@ class IpCommand(metaclass=abc.ABCMeta):
         :param   vlan_id: Integer VLAN ID for VLAN devices
         :param   ageing: integer value in seconds before learned
                          mac addresses are forgotten.
+        :param   mode: String mode for tuntap devices ('tap' or 'tun')
+        :param   multiqueue: Boolean to enable multiqueue for tuntap devices
         :return: status of the command execution
         """
 

{os_vif-4.2.1 → os_vif-4.3.0}/os_vif/internal/ip/linux/impl_pyroute2.py

@@ -74,7 +74,7 @@ class PyRoute2(ip_command.IpCommand):
         return idx[0]
 
     def add(self, device, dev_type, check_exit_code=None, peer=None, link=None,
-            vlan_id=None, ageing=None):
+            vlan_id=None, ageing=None, mode=None, multiqueue=False):
         check_exit_code = check_exit_code or []
         with iproute.IPRoute() as ip:
             args = {'ifname': device,
@@ -102,6 +102,15 @@ class PyRoute2(ip_command.IpCommand):
                 # what policy to use and keep this code generic.
                 if ageing is not None:
                     args['IFLA_BR_AGEING_TIME'] = ageing
+            elif self.TYPE_TUNTAP == dev_type:
+                # Set mode (default to 'tap' if not specified)
+                # This matches the 'ip tuntap add' command behavior
+                tap_mode = mode if mode else 'tap'
+                args['mode'] = tap_mode
+                # Enable multiqueue if requested
+                # This sets the IFF_MULTI_QUEUE flag in IFTUN_IFR
+                if multiqueue:
+                    args['multi_queue'] = True
             else:
                 raise exception.NetworkInterfaceTypeNotDefined(type=dev_type)
 

{os_vif-4.2.1 → os_vif-4.3.0}/os_vif/objects/vif.py

@@ -327,7 +327,8 @@ class VIFPortProfileOpenVSwitch(VIFPortProfileBase):
     # Version 1.1: Added 'datapath_type'
     # Version 1.2: VIFPortProfileBase updated to 1.1 from 1.0
     # Version 1.3: Added 'create_port'
-    VERSION = '1.3'
+    # Version 1.4: Added 'create_tap' and 'multiqueue'
+    VERSION = '1.4'
 
     fields = {
         #: A UUID to uniquely identify the interface. If omitted one will be
@@ -342,10 +343,21 @@ class VIFPortProfileOpenVSwitch(VIFPortProfileBase):
 
         #: Whether the os-vif plugin should add the port to the bridge.
         'create_port': fields.BooleanField(default=False),
+
+        #: Whether the os-vif plugin should create the TAP device.
+        'create_tap': fields.BooleanField(default=False),
+
+        #: Whether to enable multiqueue on the TAP device.
+        'multiqueue': fields.BooleanField(default=False),
     }
 
     def obj_make_compatible(self, primitive, target_version):
         target_version = versionutils.convert_version_to_tuple(target_version)
+        if target_version < (1, 4):
+            if 'create_tap' in primitive:
+                del primitive['create_tap']
+            if 'multiqueue' in primitive:
+                del primitive['multiqueue']
         if target_version < (1, 3) and 'create_port' in primitive:
             del primitive['create_port']
         if target_version < (1, 1) and 'datapath_type' in primitive:
@@ -370,7 +382,8 @@ class VIFPortProfileFPOpenVSwitch(VIFPortProfileOpenVSwitch):
     # Version 1.1: VIFPortProfileOpenVSwitch updated to 1.1 from 1.0
     # Version 1.2: VIFPortProfileOpenVSwitch updated to 1.2 from 1.1
     # Version 1.3: VIFPortProfileOpenVSwitch updated to 1.3 from 1.2
-    VERSION = '1.3'
+    # Version 1.4: VIFPortProfileOpenVSwitch updated to 1.4 from 1.3
+    VERSION = '1.4'
 
     fields = {
         #: Name of the bridge (managed by fast path) to connect to.
@@ -391,9 +404,12 @@ class VIFPortProfileFPOpenVSwitch(VIFPortProfileOpenVSwitch):
         elif target_version < (1, 3):
             super(VIFPortProfileFPOpenVSwitch, self).obj_make_compatible(
                 primitive, '1.2')
-        else:
+        elif target_version < (1, 4):
             super(VIFPortProfileFPOpenVSwitch, self).obj_make_compatible(
                 primitive, '1.3')
+        else:
+            super(VIFPortProfileFPOpenVSwitch, self).obj_make_compatible(
+                primitive, '1.4')
 
 
 @removals.removed_class("VIFPortProfileOVSRepresentor",
@@ -421,7 +437,8 @@ class VIFPortProfileOVSRepresentor(VIFPortProfileOpenVSwitch):
     # Version 1.1: VIFPortProfileOpenVSwitch updated to 1.1 from 1.0
     # Version 1.2: VIFPortProfileOpenVSwitch updated to 1.2 from 1.1
     # Version 1.3: VIFPortProfileOpenVSwitch updated to 1.3 from 1.2
-    VERSION = '1.3'
+    # Version 1.4: VIFPortProfileOpenVSwitch updated to 1.4 from 1.3
+    VERSION = '1.4'
 
     fields = {
         #: Name to set on the representor (if set).
@@ -442,9 +459,12 @@ class VIFPortProfileOVSRepresentor(VIFPortProfileOpenVSwitch):
         elif target_version < (1, 3):
             super(VIFPortProfileOVSRepresentor, self).obj_make_compatible(
                 primitive, '1.2')
-        else:
+        elif target_version < (1, 4):
             super(VIFPortProfileOVSRepresentor, self).obj_make_compatible(
                 primitive, '1.3')
+        else:
+            super(VIFPortProfileOVSRepresentor, self).obj_make_compatible(
+                primitive, '1.4')
 
 
 @base.VersionedObjectRegistry.register

{os_vif-4.2.1 → os_vif-4.3.0}/os_vif/tests/functional/internal/command/ip/test_impl_pyroute2.py

@@ -81,6 +81,22 @@ class ShellIpCommands(object):
             return
         return match.group('state')
 
+    def is_admin_up(self, device):
+        """Check if device is administratively up (UP flag set).
+
+        This differs from show_state() which returns the operational state.
+        TAP devices without a carrier will have state=DOWN but can still
+        be administratively UP (UP in flags like <NO-CARRIER,BROADCAST,UP>).
+        """
+        # Flags are in angle brackets on the first line, e.g. <NO-CARRIER,UP>
+        first_line = self.show_device(device)[0]
+        regex = re.compile(r".*<(?P<flags>[^>]+)>")
+        match = regex.match(first_line)
+        if match is None:
+            return False
+        flags = match.group('flags').split(',')
+        return 'UP' in flags
+
     def show_promisc(self, device):
         regex = re.compile(r".*(PROMISC)")
         match = regex.match(self.show_device(device)[0])
@@ -263,3 +279,98 @@ class TestIpCommand(ShellIpCommands, base.BaseFunctionalTestCase):
         _ip_cmd_set(device, master=bridge)
         path = "/sys/class/net/{}/brif/{}".format(bridge, device)
         self.assertTrue(os.path.exists(path))
+
+    def test_add_tap(self):
+        """Test creating a tap device."""
+        device = "test_tap_1"
+        self.addCleanup(self.del_device, device)
+        _ip_cmd_add(device, 'tuntap', mode='tap')
+        self.assertTrue(self.exist_device(device))
+
+        # Verify it's a tap device by checking /sys/class/net/<dev>/tun_flags
+        tun_flags_path = "/sys/class/net/{}/tun_flags".format(device)
+        if os.path.exists(tun_flags_path):
+            with open(tun_flags_path, 'r') as f:
+                flags_hex = f.read().strip()
+                flags = int(flags_hex, 16)
+                # IFF_TAP = 0x0002
+                IFF_TAP = 0x0002
+                self.assertTrue(flags & IFF_TAP,
+                              "TAP flag not set. Flags: {}".format(flags_hex))
+
+    def test_add_tap_with_multiqueue(self):
+        """Test creating a tap device with multiqueue parameter.
+
+        Note: The IFF_MULTI_QUEUE flag (0x0100) cannot be set via netlink.
+        It is only set when a process opens /dev/net/tun with the
+        IFF_MULTI_QUEUE flag in the ioctl. Libvirt sets this when attaching
+        to the TAP device. This test verifies that:
+        1. The TAP device can be created with multiqueue=True without error
+        2. The device is properly created as a TAP device
+        """
+        device = "test_tap_mq"
+        self.addCleanup(self.del_device, device)
+        _ip_cmd_add(device, 'tuntap', mode='tap', multiqueue=True)
+        self.assertTrue(self.exist_device(device))
+
+        # Verify it's a tap device by checking /sys/class/net/<dev>/tun_flags
+        tun_flags_path = "/sys/class/net/{}/tun_flags".format(device)
+        if os.path.exists(tun_flags_path):
+            with open(tun_flags_path, 'r') as f:
+                flags_hex = f.read().strip()
+                flags = int(flags_hex, 16)
+                # IFF_TAP = 0x0002 - verify it's a TAP device
+                IFF_TAP = 0x0002
+                self.assertTrue(
+                    flags & IFF_TAP,
+                    "TAP flag not set. Flags: %s" % flags_hex)
+
+    def test_add_tap_idempotent(self):
+        """Test tap device creation is idempotent with exit code handling."""
+        device = "test_tap_idemp"
+        self.addCleanup(self.del_device, device)
+
+        # Create the device
+        _ip_cmd_add(device, 'tuntap', mode='tap')
+        self.assertTrue(self.exist_device(device))
+
+        # Try to create again with EEXIST in check_exit_code (17)
+        # This should not raise an exception
+        _ip_cmd_add(device, 'tuntap', mode='tap', check_exit_code=[0, 17])
+        self.assertTrue(self.exist_device(device))
+
+    def test_add_tun_device(self):
+        """Test creating a tun device (not tap)."""
+        device = "test_tun_1"
+        self.addCleanup(self.del_device, device)
+        _ip_cmd_add(device, 'tuntap', mode='tun')
+        self.assertTrue(self.exist_device(device))
+
+        # Verify it's a tun device
+        tun_flags_path = "/sys/class/net/{}/tun_flags".format(device)
+        if os.path.exists(tun_flags_path):
+            with open(tun_flags_path, 'r') as f:
+                flags_hex = f.read().strip()
+                flags = int(flags_hex, 16)
+                # IFF_TUN = 0x0001
+                IFF_TUN = 0x0001
+                self.assertTrue(flags & IFF_TUN,
+                              "TUN flag not set. Flags: {}".format(flags_hex))
+
+    def test_tap_set_properties(self):
+        """Test setting properties on a tap device."""
+        device = "test_tap_props"
+        mac = "36:a7:e4:f9:01:02"
+        self.addCleanup(self.del_device, device)
+
+        # Create tap device
+        _ip_cmd_add(device, 'tuntap', mode='tap')
+        self.assertTrue(self.exist_device(device))
+
+        # Set MAC address and state
+        _ip_cmd_set(device, address=mac, state='up')
+        # TAP devices without a carrier will show state=DOWN but should be
+        # administratively UP (UP flag in interface flags)
+        self.assertTrue(self.is_admin_up(device),
+                        "Device should be administratively UP")
+        self.assertEqual(mac, self.show_mac(device))

{os_vif-4.2.1 → os_vif-4.3.0}/os_vif/tests/unit/internal/ip/linux/test_impl_pyroute2.py

@@ -175,3 +175,69 @@ class TestIpCommand(base.TestCase):
 
             self.assertRaises(ipexc.NetlinkError, self.ip.delete, self.DEVICE,
                               check_exit_code=[self.OTHER_ERROR_CODE])
+
+    def test_add_tap(self):
+        """Test creating a basic tap device."""
+        self.ip.add(self.DEVICE, 'tuntap', mode='tap')
+        args = {'ifname': self.DEVICE,
+                'kind': 'tuntap',
+                'mode': 'tap'}
+        self.ip_link.assert_called_once_with('add', **args)
+
+    def test_add_tap_default_mode(self):
+        """Test creating tap device with default mode (should be 'tap')."""
+        self.ip.add(self.DEVICE, 'tuntap')
+        args = {'ifname': self.DEVICE,
+                'kind': 'tuntap',
+                'mode': 'tap'}
+        self.ip_link.assert_called_once_with('add', **args)
+
+    def test_add_tap_with_multiqueue(self):
+        """Test creating tap device with multiqueue enabled."""
+        self.ip.add(self.DEVICE, 'tuntap', mode='tap', multiqueue=True)
+
+        # Verify the call includes multiqueue flag
+        args = {'ifname': self.DEVICE,
+                'kind': 'tuntap',
+                'mode': 'tap',
+                'multi_queue': True}
+        self.ip_link.assert_called_once_with('add', **args)
+
+    def test_add_tun_device(self):
+        """Test creating a tun device (not tap)."""
+        self.ip.add(self.DEVICE, 'tuntap', mode='tun')
+        args = {'ifname': self.DEVICE,
+                'kind': 'tuntap',
+                'mode': 'tun'}
+        self.ip_link.assert_called_once_with('add', **args)
+
+    def test_add_tap_exit_code(self):
+        """Test tap device creation with exit code handling."""
+        self.ip_link.side_effect = ipexc.NetlinkError(self.ERROR_CODE,
+                                                      msg="Error message")
+
+        # Should not raise when error code matches
+        self.ip.add(self.DEVICE, 'tuntap', mode='tap',
+                    check_exit_code=[self.ERROR_CODE])
+        self.ip_link.assert_called_once()
+
+        # Should raise when exit code doesn't match
+        self.assertRaises(
+            ipexc.NetlinkError,
+            self.ip.add, self.DEVICE, 'tuntap', mode='tap',
+            check_exit_code=[self.OTHER_ERROR_CODE])
+
+    def test_set_no_multiqueue_parameter(self):
+        """Verify set() no longer accepts multiqueue parameter."""
+        with mock.patch.object(
+                iproute.IPRoute, 'link_lookup', return_value=[1],
+                create=True):
+            self.ip_link.return_value = [{'flags': 0}]
+
+            # Should work without multiqueue
+            self.ip.set(self.DEVICE, state=self.UP, mtu=self.MTU,
+                        address=self.MAC)
+
+            # Should raise TypeError if multiqueue is passed
+            self.assertRaises(TypeError, self.ip.set, self.DEVICE,
+                            multiqueue=True)

{os_vif-4.2.1 → os_vif-4.3.0}/os_vif/tests/unit/test_objects.py

@@ -40,12 +40,12 @@ object_data = {
     'VIFPortProfile8021Qbg': '1.1-b3011621809dca9216b50579ce9d6b19',
     'VIFPortProfile8021Qbh': '1.1-226b61b2e76ba452f7b31530cff80ac9',
     'VIFPortProfileBase': '1.1-4982d1621df12ebd1f3b07948f3d0e5f',
-    'VIFPortProfileOpenVSwitch': '1.3-1ad9a350a9cae19c977d21fcce7c8c7f',
-    'VIFPortProfileFPOpenVSwitch': '1.3-06c425743430e7702ef112e09b987346',
+    'VIFPortProfileOpenVSwitch': '1.4-54fb321f2b70c37d392fadc226c889e7',
+    'VIFPortProfileFPOpenVSwitch': '1.4-20904c1dcdac0641cabf7b02525973bd',
     'VIFPortProfileFPBridge': '1.1-49f1952bf50bab7a95112c908534751f',
     'VIFPortProfileFPTap': '1.1-fd178229477604dfb65de5ce929488e5',
     'VIFVHostUser': '1.1-1f95b43be1f884f090ca1f4d79adfd35',
-    'VIFPortProfileOVSRepresentor': '1.3-f625e17143473b93d6c7f97ded9f785a',
+    'VIFPortProfileOVSRepresentor': '1.4-82b7292ee4cd6f808b724d2f5648932b',
     'VIFNestedDPDK': '1.0-fdbaf6b20afd116529929b21aa7158dc',
     'VIFPortProfileK8sDPDK': '1.1-e2a2abd112b14e0239e76b99d9b252ae',
     'DatapathOffloadBase': '1.0-77509ea1ea0dd750d5864b9bd87d3f9d',
@@ -78,3 +78,60 @@ class TestObjectVersions(base.TestCase):
         self.assertIn('vif_name', primitive)
         vif.obj_make_compatible(primitive, '1.0')
         self.assertNotIn('vif_name', primitive)
+
+    def test_vif_port_profile_ovs_obj_make_compatible_1_4(self):
+        """Test obj_make_compatible removes create_tap and multiqueue for
+        versions < 1.4.
+        """
+        profile = objects.vif.VIFPortProfileOpenVSwitch(
+            interface_id='e65867e0-9340-4a7f-a256-09af6eb7a3aa',
+            create_tap=True,
+            multiqueue=True)
+        primitive = profile.obj_to_primitive()['versioned_object.data']
+        self.assertIn('create_tap', primitive)
+        self.assertIn('multiqueue', primitive)
+
+        # For version 1.3, both create_tap and multiqueue should be removed
+        profile.obj_make_compatible(primitive, '1.3')
+        self.assertNotIn('create_tap', primitive)
+        self.assertNotIn('multiqueue', primitive)
+
+    def test_vif_port_profile_ovs_obj_make_compatible_1_3(self):
+        """Test obj_make_compatible removes create_port for versions < 1.3."""
+        profile = objects.vif.VIFPortProfileOpenVSwitch(
+            interface_id='e65867e0-9340-4a7f-a256-09af6eb7a3aa',
+            create_port=True)
+        primitive = profile.obj_to_primitive()['versioned_object.data']
+        self.assertIn('create_port', primitive)
+
+        # For version 1.2, create_port should be removed
+        profile.obj_make_compatible(primitive, '1.2')
+        self.assertNotIn('create_port', primitive)
+
+    def test_vif_port_profile_ovs_create_tap_multiqueue_fields(self):
+        """Test that create_tap and multiqueue fields can be set."""
+        profile = objects.vif.VIFPortProfileOpenVSwitch(
+            interface_id='e65867e0-9340-4a7f-a256-09af6eb7a3aa',
+            create_tap=True,
+            multiqueue=True)
+        self.assertTrue(profile.create_tap)
+        self.assertTrue(profile.multiqueue)
+
+        # Test explicitly set default values
+        profile_default = objects.vif.VIFPortProfileOpenVSwitch(
+            interface_id='e65867e0-9340-4a7f-a256-09af6eb7a3aa',
+            create_tap=False,
+            multiqueue=False)
+        self.assertFalse(profile_default.create_tap)
+        self.assertFalse(profile_default.multiqueue)
+
+    def test_vif_port_profile_ovs_in_operator(self):
+        """Test that 'in' operator works for checking field existence."""
+        profile = objects.vif.VIFPortProfileOpenVSwitch(
+            interface_id='e65867e0-9340-4a7f-a256-09af6eb7a3aa',
+            create_tap=True,
+            multiqueue=True)
+        self.assertIn('create_tap', profile)
+        self.assertIn('multiqueue', profile)
+        self.assertIn('interface_id', profile)
+        self.assertNotIn('nonexistent_field', profile)

{os_vif-4.2.1 → os_vif-4.3.0}/os_vif.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: os_vif
-Version: 4.2.1
+Version: 4.3.0
 Summary: A library for plugging and unplugging virtual interfaces in OpenStack.
 Home-page: https://docs.openstack.org/os-vif/latest/
 Author: OpenStack
@@ -33,6 +33,15 @@ Requires-Dist: ovsdbapp>=0.12.1
 Requires-Dist: pyroute2>=0.5.2
 Requires-Dist: stevedore>=1.20.0
 Requires-Dist: debtcollector>=1.19.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 ========================
 Team and repository tags

{os_vif-4.2.1 → os_vif-4.3.0}/os_vif.egg-info/SOURCES.txt

@@ -91,6 +91,7 @@ releasenotes/notes/add-no-op-plugin-763a6703e7328a24.yaml
 releasenotes/notes/add-ovs-representor-portprofile-5f8290e5a40bf0a4.yaml
 releasenotes/notes/add-ovs-vhostuser-support-2ba8de51c1f3a244.yaml
 releasenotes/notes/add-ovsdb-native-322fffb49c91503d.yaml
+releasenotes/notes/add-tap-creation-support-2069718-abc123.yaml
 releasenotes/notes/always-plug-vifs-for-ovs-1d033fc49a9c6c4e.yaml
 releasenotes/notes/brctl-removal-a5b0e69b865afa57.yaml
 releasenotes/notes/bug-1892132-812e6d5ce0588ebb.yaml
@@ -126,6 +127,7 @@ releasenotes/source/2023.2.rst
 releasenotes/source/2024.1.rst
 releasenotes/source/2024.2.rst
 releasenotes/source/2025.1.rst
+releasenotes/source/2025.2.rst
 releasenotes/source/conf.py
 releasenotes/source/index.rst
 releasenotes/source/newton.rst

os_vif-4.3.0/os_vif.egg-info/pbr.json

@@ -0,0 +1 @@
+{"git_version": "8cbe6ee", "is_release": true}

os_vif-4.3.0/releasenotes/notes/add-tap-creation-support-2069718-abc123.yaml

@@ -0,0 +1,24 @@
+---
+features:
+  - |
+    Added support for os-vif to pre-create TAP devices when using OVS/OVN.
+    The ``VIFPortProfileOpenVSwitch`` object now supports two new fields:
+
+    * ``create_tap``: When set to ``True``, os-vif will create the TAP device
+      with the correct MAC address and MTU before adding it to OVS.
+    * ``multiqueue``: When set to ``True`` along with ``create_tap``, the TAP
+      device will be created with multiqueue support enabled for improved
+      performance with multiple vCPUs. The multiqueue setting is determined
+      by Nova from the ``hw:vif_multiqueue_enabled`` flavor extra spec or
+      image property.
+
+    When the ``[ovn]/ovs_create_tap`` config option is enabled in
+    Neutron's ML2/OVN mechanism driver, Neutron sets the ``ovs_create_tap``
+    flag in the vif_details during port binding. Nova then reads this value and
+    propagates it to os-vif via the ``create_tap`` field, and configures
+    libvirt with ``managed="no"`` so it uses the pre-created TAP device. This
+    reduces live migration downtime by ensuring the network is fully wired
+    before the VM starts.
+
+    See `bug 2069718 <https://bugs.launchpad.net/neutron/+bug/2069718>`_.
+

{os_vif-4.2.1 → os_vif-4.3.0}/releasenotes/source/2024.1.rst

@@ -3,4 +3,4 @@
 ===========================
 
 .. release-notes::
-   :branch: stable/2024.1
+   :branch: unmaintained/2024.1

os_vif-4.3.0/releasenotes/source/2025.2.rst

@@ -0,0 +1,6 @@
+===========================
+2025.2 Series Release Notes
+===========================
+
+.. release-notes::
+   :branch: stable/2025.2

{os_vif-4.2.1 → os_vif-4.3.0}/releasenotes/source/index.rst

@@ -6,6 +6,7 @@ Release Notes
    :maxdepth: 1
 
    unreleased
+   2025.2
    2025.1
    2024.2
    2024.1

{os_vif-4.2.1 → os_vif-4.3.0}/vif_plug_ovs/exception.py

@@ -35,3 +35,9 @@ class RepresentorNotFound(osv_exception.ExceptionBase):
 
 class PciDeviceNotFoundById(osv_exception.ExceptionBase):
     msg_fmt = _("PCI device %(id)s not found")
+
+
+class TapCreationNotSupported(osv_exception.ExceptionBase):
+    msg_fmt = _('Tap device creation requested for unsupported VIF type. '
+                'create_tap is only supported for VIFOpenVSwitch, got '
+                '%(vif_type)s')

{os_vif-4.2.1 → os_vif-4.3.0}/vif_plug_ovs/linux_net.py

@@ -90,6 +90,29 @@ def update_veth_pair(dev1_name, dev2_name, mtu):
         _update_device_mtu(dev, mtu)
 
 
+@privsep.vif_plug.entrypoint
+def create_tap(dev, mtu, mac, multiqueue=False):
+    """Create a tap device with the specified configuration.
+
+    Creates a tap device using pyroute2's netlink interface, with optional
+    multiqueue support for better performance with multiple VCPUs.
+
+    :param dev: Device name (string)
+    :param mtu: MTU value (integer)
+    :param mac: MAC address (string)
+    :param multiqueue: Enable multiqueue support (boolean, default False)
+                       Requires Linux kernel 3.8+
+    """
+    # Create the tap device with optional multiqueue support
+    # Use check_exit_code=[0, 17] to handle EEXIST (device already exists)
+    ip_lib.add(dev, 'tuntap', mode='tap', multiqueue=multiqueue,
+               check_exit_code=[0, 17])
+    # Configure the device state and MAC address
+    ip_lib.set(dev, state='up', address=mac, check_exit_code=[0, 2, 254])
+    # Set MTU if specified
+    _update_device_mtu(dev, mtu)
+
+
 def _disable_ipv6(bridge):
     """Disable ipv6 if available for bridge. Must be called from
        privsep context.