integration-cli/docker_experimental_network_test.go
7781a1bf
 // +build !windows
afeea8c9
 
 package main
 
 import (
 	"strings"
 	"time"
 
33968e6c
 	"github.com/docker/docker/integration-cli/checker"
eeaa6c96
 	"github.com/docker/docker/integration-cli/cli"
afeea8c9
 	"github.com/docker/docker/pkg/parsers/kernel"
 	"github.com/go-check/check"
92427b3a
 	"github.com/gotestyourself/gotestyourself/icmd"
afeea8c9
 )
 
9af5d7c3
 // ensure Kernel version is >= v3.9 for macvlan support
930a9869
 func macvlanKernelSupport() bool {
9af5d7c3
 	return checkKernelMajorVersionGreaterOrEqualThen(3, 9)
930a9869
 }
 
9af5d7c3
 // ensure Kernel version is >= v4.2 for ipvlan support
930a9869
 func ipvlanKernelSupport() bool {
9af5d7c3
 	return checkKernelMajorVersionGreaterOrEqualThen(4, 2)
 }
 
 func checkKernelMajorVersionGreaterOrEqualThen(kernelVersion int, majorVersion int) bool {
930a9869
 	kv, err := kernel.GetKernelVersion()
 	if err != nil {
 		return false
 	}
9af5d7c3
 	if kv.Kernel < kernelVersion || (kv.Kernel == kernelVersion && kv.Major < majorVersion) {
930a9869
 		return false
 	}
 	return true
 }
afeea8c9
 
 func (s *DockerNetworkSuite) TestDockerNetworkMacvlanPersistance(c *check.C) {
 	// verify the driver automatically provisions the 802.1q link (dm-dummy0.60)
930a9869
 	testRequires(c, DaemonIsLinux, macvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
7781a1bf
 
afeea8c9
 	// master dummy interface 'dm' abbreviation represents 'docker macvlan'
 	master := "dm-dummy0"
 	// simulate the master link the vlan tagged subinterface parent link will use
87e3fcfe
 	createMasterDummy(c, master)
afeea8c9
 	// create a network specifying the desired sub-interface name
 	dockerCmd(c, "network", "create", "--driver=macvlan", "-o", "parent=dm-dummy0.60", "dm-persist")
 	assertNwIsAvailable(c, "dm-persist")
 	// Restart docker daemon to test the config has persisted to disk
c502fb49
 	s.d.Restart(c)
afeea8c9
 	// verify network is recreated from persistence
 	assertNwIsAvailable(c, "dm-persist")
 	// cleanup the master interface that also collects the slave dev
 	deleteInterface(c, "dm-dummy0")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkIpvlanPersistance(c *check.C) {
 	// verify the driver automatically provisions the 802.1q link (di-dummy0.70)
930a9869
 	testRequires(c, DaemonIsLinux, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	// master dummy interface 'di' notation represent 'docker ipvlan'
 	master := "di-dummy0"
 	// simulate the master link the vlan tagged subinterface parent link will use
87e3fcfe
 	createMasterDummy(c, master)
afeea8c9
 	// create a network specifying the desired sub-interface name
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "-o", "parent=di-dummy0.70", "di-persist")
 	assertNwIsAvailable(c, "di-persist")
 	// Restart docker daemon to test the config has persisted to disk
c502fb49
 	s.d.Restart(c)
afeea8c9
 	// verify network is recreated from persistence
 	assertNwIsAvailable(c, "di-persist")
 	// cleanup the master interface that also collects the slave dev
 	deleteInterface(c, "di-dummy0")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkMacvlanSubIntCreate(c *check.C) {
 	// verify the driver automatically provisions the 802.1q link (dm-dummy0.50)
930a9869
 	testRequires(c, DaemonIsLinux, macvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	// master dummy interface 'dm' abbreviation represents 'docker macvlan'
 	master := "dm-dummy0"
 	// simulate the master link the vlan tagged subinterface parent link will use
87e3fcfe
 	createMasterDummy(c, master)
afeea8c9
 	// create a network specifying the desired sub-interface name
 	dockerCmd(c, "network", "create", "--driver=macvlan", "-o", "parent=dm-dummy0.50", "dm-subinterface")
 	assertNwIsAvailable(c, "dm-subinterface")
 	// cleanup the master interface which also collects the slave dev
 	deleteInterface(c, "dm-dummy0")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkIpvlanSubIntCreate(c *check.C) {
 	// verify the driver automatically provisions the 802.1q link (di-dummy0.50)
930a9869
 	testRequires(c, DaemonIsLinux, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	// master dummy interface 'dm' abbreviation represents 'docker ipvlan'
 	master := "di-dummy0"
 	// simulate the master link the vlan tagged subinterface parent link will use
87e3fcfe
 	createMasterDummy(c, master)
afeea8c9
 	// create a network specifying the desired sub-interface name
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "-o", "parent=di-dummy0.60", "di-subinterface")
 	assertNwIsAvailable(c, "di-subinterface")
 	// cleanup the master interface which also collects the slave dev
 	deleteInterface(c, "di-dummy0")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkMacvlanOverlapParent(c *check.C) {
 	// verify the same parent interface cannot be used if already in use by an existing network
930a9869
 	testRequires(c, DaemonIsLinux, macvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	// master dummy interface 'dm' abbreviation represents 'docker macvlan'
 	master := "dm-dummy0"
87e3fcfe
 	createMasterDummy(c, master)
 	createVlanInterface(c, master, "dm-dummy0.40", "40")
afeea8c9
 	// create a network using an existing parent interface
 	dockerCmd(c, "network", "create", "--driver=macvlan", "-o", "parent=dm-dummy0.40", "dm-subinterface")
 	assertNwIsAvailable(c, "dm-subinterface")
 	// attempt to create another network using the same parent iface that should fail
87e3fcfe
 	out, _, err := dockerCmdWithError("network", "create", "--driver=macvlan", "-o", "parent=dm-dummy0.40", "dm-parent-net-overlap")
afeea8c9
 	// verify that the overlap returns an error
87e3fcfe
 	c.Assert(err, check.NotNil, check.Commentf(out))
afeea8c9
 	// cleanup the master interface which also collects the slave dev
 	deleteInterface(c, "dm-dummy0")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkIpvlanOverlapParent(c *check.C) {
 	// verify the same parent interface cannot be used if already in use by an existing network
930a9869
 	testRequires(c, DaemonIsLinux, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	// master dummy interface 'dm' abbreviation represents 'docker ipvlan'
 	master := "di-dummy0"
87e3fcfe
 	createMasterDummy(c, master)
 	createVlanInterface(c, master, "di-dummy0.30", "30")
afeea8c9
 	// create a network using an existing parent interface
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "-o", "parent=di-dummy0.30", "di-subinterface")
 	assertNwIsAvailable(c, "di-subinterface")
 	// attempt to create another network using the same parent iface that should fail
87e3fcfe
 	out, _, err := dockerCmdWithError("network", "create", "--driver=ipvlan", "-o", "parent=di-dummy0.30", "di-parent-net-overlap")
afeea8c9
 	// verify that the overlap returns an error
87e3fcfe
 	c.Assert(err, check.NotNil, check.Commentf(out))
afeea8c9
 	// cleanup the master interface which also collects the slave dev
 	deleteInterface(c, "di-dummy0")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkMacvlanMultiSubnet(c *check.C) {
 	// create a dual stack multi-subnet Macvlan bridge mode network and validate connectivity between four containers, two on each subnet
930a9869
 	testRequires(c, DaemonIsLinux, IPv6, macvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
ec77c124
 	dockerCmd(c, "network", "create", "--driver=macvlan", "--ipv6", "--subnet=172.28.100.0/24", "--subnet=172.28.102.0/24", "--gateway=172.28.102.254",
afeea8c9
 		"--subnet=2001:db8:abc2::/64", "--subnet=2001:db8:abc4::/64", "--gateway=2001:db8:abc4::254", "dualstackbridge")
 	// Ensure the network was created
 	assertNwIsAvailable(c, "dualstackbridge")
 	// start dual stack containers and verify the user specified --ip and --ip6 addresses on subnets 172.28.100.0/24 and 2001:db8:abc2::/64
 	dockerCmd(c, "run", "-d", "--net=dualstackbridge", "--name=first", "--ip", "172.28.100.20", "--ip6", "2001:db8:abc2::20", "busybox", "top")
 	dockerCmd(c, "run", "-d", "--net=dualstackbridge", "--name=second", "--ip", "172.28.100.21", "--ip6", "2001:db8:abc2::21", "busybox", "top")
 
 	// Inspect and store the v4 address from specified container on the network dualstackbridge
 	ip := inspectField(c, "first", "NetworkSettings.Networks.dualstackbridge.IPAddress")
 	// Inspect and store the v6 address from specified container on the network dualstackbridge
 	ip6 := inspectField(c, "first", "NetworkSettings.Networks.dualstackbridge.GlobalIPv6Address")
 
 	// verify ipv4 connectivity to the explicit --ipv address second to first
 	_, _, err := dockerCmdWithError("exec", "second", "ping", "-c", "1", strings.TrimSpace(ip))
 	c.Assert(err, check.IsNil)
 	// verify ipv6 connectivity to the explicit --ipv6 address second to first
39bcaee4
 	c.Skip("Temporarily skipping while investigating sporadic v6 CI issues")
afeea8c9
 	_, _, err = dockerCmdWithError("exec", "second", "ping6", "-c", "1", strings.TrimSpace(ip6))
 	c.Assert(err, check.IsNil)
 
 	// start dual stack containers and verify the user specified --ip and --ip6 addresses on subnets 172.28.102.0/24 and 2001:db8:abc4::/64
 	dockerCmd(c, "run", "-d", "--net=dualstackbridge", "--name=third", "--ip", "172.28.102.20", "--ip6", "2001:db8:abc4::20", "busybox", "top")
 	dockerCmd(c, "run", "-d", "--net=dualstackbridge", "--name=fourth", "--ip", "172.28.102.21", "--ip6", "2001:db8:abc4::21", "busybox", "top")
 
 	// Inspect and store the v4 address from specified container on the network dualstackbridge
 	ip = inspectField(c, "third", "NetworkSettings.Networks.dualstackbridge.IPAddress")
 	// Inspect and store the v6 address from specified container on the network dualstackbridge
 	ip6 = inspectField(c, "third", "NetworkSettings.Networks.dualstackbridge.GlobalIPv6Address")
 
 	// verify ipv4 connectivity to the explicit --ipv address from third to fourth
 	_, _, err = dockerCmdWithError("exec", "fourth", "ping", "-c", "1", strings.TrimSpace(ip))
 	c.Assert(err, check.IsNil)
 	// verify ipv6 connectivity to the explicit --ipv6 address from third to fourth
 	_, _, err = dockerCmdWithError("exec", "fourth", "ping6", "-c", "1", strings.TrimSpace(ip6))
 	c.Assert(err, check.IsNil)
 
 	// Inspect the v4 gateway to ensure the proper default GW was assigned
 	ip4gw := inspectField(c, "first", "NetworkSettings.Networks.dualstackbridge.Gateway")
 	c.Assert(strings.TrimSpace(ip4gw), check.Equals, "172.28.100.1")
 	// Inspect the v6 gateway to ensure the proper default GW was assigned
 	ip6gw := inspectField(c, "first", "NetworkSettings.Networks.dualstackbridge.IPv6Gateway")
 	c.Assert(strings.TrimSpace(ip6gw), check.Equals, "2001:db8:abc2::1")
 
 	// Inspect the v4 gateway to ensure the proper explicitly assigned default GW was assigned
 	ip4gw = inspectField(c, "third", "NetworkSettings.Networks.dualstackbridge.Gateway")
 	c.Assert(strings.TrimSpace(ip4gw), check.Equals, "172.28.102.254")
 	// Inspect the v6 gateway to ensure the proper explicitly assigned default GW was assigned
 	ip6gw = inspectField(c, "third", "NetworkSettings.Networks.dualstackbridge.IPv6Gateway")
 	c.Assert(strings.TrimSpace(ip6gw), check.Equals, "2001:db8:abc4::254")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkIpvlanL2MultiSubnet(c *check.C) {
 	// create a dual stack multi-subnet Ipvlan L2 network and validate connectivity within the subnets, two on each subnet
930a9869
 	testRequires(c, DaemonIsLinux, IPv6, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
ec77c124
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "--ipv6", "--subnet=172.28.200.0/24", "--subnet=172.28.202.0/24", "--gateway=172.28.202.254",
afeea8c9
 		"--subnet=2001:db8:abc8::/64", "--subnet=2001:db8:abc6::/64", "--gateway=2001:db8:abc6::254", "dualstackl2")
 	// Ensure the network was created
 	assertNwIsAvailable(c, "dualstackl2")
 	// start dual stack containers and verify the user specified --ip and --ip6 addresses on subnets 172.28.200.0/24 and 2001:db8:abc8::/64
 	dockerCmd(c, "run", "-d", "--net=dualstackl2", "--name=first", "--ip", "172.28.200.20", "--ip6", "2001:db8:abc8::20", "busybox", "top")
 	dockerCmd(c, "run", "-d", "--net=dualstackl2", "--name=second", "--ip", "172.28.200.21", "--ip6", "2001:db8:abc8::21", "busybox", "top")
 
 	// Inspect and store the v4 address from specified container on the network dualstackl2
 	ip := inspectField(c, "first", "NetworkSettings.Networks.dualstackl2.IPAddress")
 	// Inspect and store the v6 address from specified container on the network dualstackl2
 	ip6 := inspectField(c, "first", "NetworkSettings.Networks.dualstackl2.GlobalIPv6Address")
 
 	// verify ipv4 connectivity to the explicit --ipv address second to first
 	_, _, err := dockerCmdWithError("exec", "second", "ping", "-c", "1", strings.TrimSpace(ip))
 	c.Assert(err, check.IsNil)
 	// verify ipv6 connectivity to the explicit --ipv6 address second to first
 	_, _, err = dockerCmdWithError("exec", "second", "ping6", "-c", "1", strings.TrimSpace(ip6))
 	c.Assert(err, check.IsNil)
 
 	// start dual stack containers and verify the user specified --ip and --ip6 addresses on subnets 172.28.202.0/24 and 2001:db8:abc6::/64
 	dockerCmd(c, "run", "-d", "--net=dualstackl2", "--name=third", "--ip", "172.28.202.20", "--ip6", "2001:db8:abc6::20", "busybox", "top")
 	dockerCmd(c, "run", "-d", "--net=dualstackl2", "--name=fourth", "--ip", "172.28.202.21", "--ip6", "2001:db8:abc6::21", "busybox", "top")
 
 	// Inspect and store the v4 address from specified container on the network dualstackl2
 	ip = inspectField(c, "third", "NetworkSettings.Networks.dualstackl2.IPAddress")
 	// Inspect and store the v6 address from specified container on the network dualstackl2
 	ip6 = inspectField(c, "third", "NetworkSettings.Networks.dualstackl2.GlobalIPv6Address")
 
 	// verify ipv4 connectivity to the explicit --ipv address from third to fourth
 	_, _, err = dockerCmdWithError("exec", "fourth", "ping", "-c", "1", strings.TrimSpace(ip))
 	c.Assert(err, check.IsNil)
 	// verify ipv6 connectivity to the explicit --ipv6 address from third to fourth
 	_, _, err = dockerCmdWithError("exec", "fourth", "ping6", "-c", "1", strings.TrimSpace(ip6))
 	c.Assert(err, check.IsNil)
 
 	// Inspect the v4 gateway to ensure the proper default GW was assigned
 	ip4gw := inspectField(c, "first", "NetworkSettings.Networks.dualstackl2.Gateway")
 	c.Assert(strings.TrimSpace(ip4gw), check.Equals, "172.28.200.1")
 	// Inspect the v6 gateway to ensure the proper default GW was assigned
 	ip6gw := inspectField(c, "first", "NetworkSettings.Networks.dualstackl2.IPv6Gateway")
 	c.Assert(strings.TrimSpace(ip6gw), check.Equals, "2001:db8:abc8::1")
 
 	// Inspect the v4 gateway to ensure the proper explicitly assigned default GW was assigned
 	ip4gw = inspectField(c, "third", "NetworkSettings.Networks.dualstackl2.Gateway")
 	c.Assert(strings.TrimSpace(ip4gw), check.Equals, "172.28.202.254")
 	// Inspect the v6 gateway to ensure the proper explicitly assigned default GW was assigned
 	ip6gw = inspectField(c, "third", "NetworkSettings.Networks.dualstackl2.IPv6Gateway")
 	c.Assert(strings.TrimSpace(ip6gw), check.Equals, "2001:db8:abc6::254")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkIpvlanL3MultiSubnet(c *check.C) {
 	// create a dual stack multi-subnet Ipvlan L3 network and validate connectivity between all four containers per L3 mode
930a9869
 	testRequires(c, DaemonIsLinux, IPv6, ipvlanKernelSupport, NotUserNamespace, NotArm, IPv6, ExperimentalDaemon)
ec77c124
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "--ipv6", "--subnet=172.28.10.0/24", "--subnet=172.28.12.0/24", "--gateway=172.28.12.254",
afeea8c9
 		"--subnet=2001:db8:abc9::/64", "--subnet=2001:db8:abc7::/64", "--gateway=2001:db8:abc7::254", "-o", "ipvlan_mode=l3", "dualstackl3")
 	// Ensure the network was created
 	assertNwIsAvailable(c, "dualstackl3")
 
 	// start dual stack containers and verify the user specified --ip and --ip6 addresses on subnets 172.28.10.0/24 and 2001:db8:abc9::/64
 	dockerCmd(c, "run", "-d", "--net=dualstackl3", "--name=first", "--ip", "172.28.10.20", "--ip6", "2001:db8:abc9::20", "busybox", "top")
 	dockerCmd(c, "run", "-d", "--net=dualstackl3", "--name=second", "--ip", "172.28.10.21", "--ip6", "2001:db8:abc9::21", "busybox", "top")
 
 	// Inspect and store the v4 address from specified container on the network dualstackl3
 	ip := inspectField(c, "first", "NetworkSettings.Networks.dualstackl3.IPAddress")
 	// Inspect and store the v6 address from specified container on the network dualstackl3
 	ip6 := inspectField(c, "first", "NetworkSettings.Networks.dualstackl3.GlobalIPv6Address")
 
 	// verify ipv4 connectivity to the explicit --ipv address second to first
 	_, _, err := dockerCmdWithError("exec", "second", "ping", "-c", "1", strings.TrimSpace(ip))
 	c.Assert(err, check.IsNil)
 	// verify ipv6 connectivity to the explicit --ipv6 address second to first
 	_, _, err = dockerCmdWithError("exec", "second", "ping6", "-c", "1", strings.TrimSpace(ip6))
 	c.Assert(err, check.IsNil)
 
 	// start dual stack containers and verify the user specified --ip and --ip6 addresses on subnets 172.28.12.0/24 and 2001:db8:abc7::/64
 	dockerCmd(c, "run", "-d", "--net=dualstackl3", "--name=third", "--ip", "172.28.12.20", "--ip6", "2001:db8:abc7::20", "busybox", "top")
 	dockerCmd(c, "run", "-d", "--net=dualstackl3", "--name=fourth", "--ip", "172.28.12.21", "--ip6", "2001:db8:abc7::21", "busybox", "top")
 
 	// Inspect and store the v4 address from specified container on the network dualstackl3
 	ip = inspectField(c, "third", "NetworkSettings.Networks.dualstackl3.IPAddress")
 	// Inspect and store the v6 address from specified container on the network dualstackl3
 	ip6 = inspectField(c, "third", "NetworkSettings.Networks.dualstackl3.GlobalIPv6Address")
 
 	// verify ipv4 connectivity to the explicit --ipv address from third to fourth
 	_, _, err = dockerCmdWithError("exec", "fourth", "ping", "-c", "1", strings.TrimSpace(ip))
 	c.Assert(err, check.IsNil)
 	// verify ipv6 connectivity to the explicit --ipv6 address from third to fourth
 	_, _, err = dockerCmdWithError("exec", "fourth", "ping6", "-c", "1", strings.TrimSpace(ip6))
 	c.Assert(err, check.IsNil)
 
 	// Inspect and store the v4 address from specified container on the network dualstackl3
 	ip = inspectField(c, "second", "NetworkSettings.Networks.dualstackl3.IPAddress")
 	// Inspect and store the v6 address from specified container on the network dualstackl3
 	ip6 = inspectField(c, "second", "NetworkSettings.Networks.dualstackl3.GlobalIPv6Address")
 
 	// Verify connectivity across disparate subnets which is unique to L3 mode only
 	_, _, err = dockerCmdWithError("exec", "third", "ping", "-c", "1", strings.TrimSpace(ip))
 	c.Assert(err, check.IsNil)
 	_, _, err = dockerCmdWithError("exec", "third", "ping6", "-c", "1", strings.TrimSpace(ip6))
 	c.Assert(err, check.IsNil)
 
 	// Inspect the v4 gateway to ensure no next hop is assigned in L3 mode
 	ip4gw := inspectField(c, "first", "NetworkSettings.Networks.dualstackl3.Gateway")
 	c.Assert(strings.TrimSpace(ip4gw), check.Equals, "")
 	// Inspect the v6 gateway to ensure the explicitly specified default GW is ignored per L3 mode enabled
 	ip6gw := inspectField(c, "third", "NetworkSettings.Networks.dualstackl3.IPv6Gateway")
 	c.Assert(strings.TrimSpace(ip6gw), check.Equals, "")
 }
 
 func (s *DockerNetworkSuite) TestDockerNetworkIpvlanAddressing(c *check.C) {
 	// Ensure the default gateways, next-hops and default dev devices are properly set
930a9869
 	testRequires(c, DaemonIsLinux, IPv6, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
ec77c124
 	dockerCmd(c, "network", "create", "--driver=macvlan", "--ipv6", "--subnet=172.28.130.0/24",
afeea8c9
 		"--subnet=2001:db8:abca::/64", "--gateway=2001:db8:abca::254", "-o", "macvlan_mode=bridge", "dualstackbridge")
 	assertNwIsAvailable(c, "dualstackbridge")
 	dockerCmd(c, "run", "-d", "--net=dualstackbridge", "--name=first", "busybox", "top")
 	// Validate macvlan bridge mode defaults gateway sets the default IPAM next-hop inferred from the subnet
 	out, _, err := dockerCmdWithError("exec", "first", "ip", "route")
 	c.Assert(err, check.IsNil)
 	c.Assert(out, checker.Contains, "default via 172.28.130.1 dev eth0")
 	// Validate macvlan bridge mode sets the v6 gateway to the user specified default gateway/next-hop
 	out, _, err = dockerCmdWithError("exec", "first", "ip", "-6", "route")
 	c.Assert(err, check.IsNil)
 	c.Assert(out, checker.Contains, "default via 2001:db8:abca::254 dev eth0")
 
 	// Verify ipvlan l2 mode sets the proper default gateway routes via netlink
 	// for either an explicitly set route by the user or inferred via default IPAM
ec77c124
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "--ipv6", "--subnet=172.28.140.0/24", "--gateway=172.28.140.254",
afeea8c9
 		"--subnet=2001:db8:abcb::/64", "-o", "ipvlan_mode=l2", "dualstackl2")
 	assertNwIsAvailable(c, "dualstackl2")
 	dockerCmd(c, "run", "-d", "--net=dualstackl2", "--name=second", "busybox", "top")
 	// Validate ipvlan l2 mode defaults gateway sets the default IPAM next-hop inferred from the subnet
 	out, _, err = dockerCmdWithError("exec", "second", "ip", "route")
 	c.Assert(err, check.IsNil)
 	c.Assert(out, checker.Contains, "default via 172.28.140.254 dev eth0")
 	// Validate ipvlan l2 mode sets the v6 gateway to the user specified default gateway/next-hop
 	out, _, err = dockerCmdWithError("exec", "second", "ip", "-6", "route")
 	c.Assert(err, check.IsNil)
 	c.Assert(out, checker.Contains, "default via 2001:db8:abcb::1 dev eth0")
 
 	// Validate ipvlan l3 mode sets the v4 gateway to dev eth0 and disregards any explicit or inferred next-hops
ec77c124
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "--ipv6", "--subnet=172.28.160.0/24", "--gateway=172.28.160.254",
afeea8c9
 		"--subnet=2001:db8:abcd::/64", "--gateway=2001:db8:abcd::254", "-o", "ipvlan_mode=l3", "dualstackl3")
 	assertNwIsAvailable(c, "dualstackl3")
 	dockerCmd(c, "run", "-d", "--net=dualstackl3", "--name=third", "busybox", "top")
 	// Validate ipvlan l3 mode sets the v4 gateway to dev eth0 and disregards any explicit or inferred next-hops
 	out, _, err = dockerCmdWithError("exec", "third", "ip", "route")
 	c.Assert(err, check.IsNil)
 	c.Assert(out, checker.Contains, "default dev eth0")
 	// Validate ipvlan l3 mode sets the v6 gateway to dev eth0 and disregards any explicit or inferred next-hops
 	out, _, err = dockerCmdWithError("exec", "third", "ip", "-6", "route")
 	c.Assert(err, check.IsNil)
 	c.Assert(out, checker.Contains, "default dev eth0")
 }
 
 func (s *DockerSuite) TestDockerNetworkMacVlanBridgeNilParent(c *check.C) {
 	// macvlan bridge mode - dummy parent interface is provisioned dynamically
930a9869
 	testRequires(c, DaemonIsLinux, macvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	dockerCmd(c, "network", "create", "--driver=macvlan", "dm-nil-parent")
 	assertNwIsAvailable(c, "dm-nil-parent")
 
 	// start two containers on the same subnet
 	dockerCmd(c, "run", "-d", "--net=dm-nil-parent", "--name=first", "busybox", "top")
 	c.Assert(waitRun("first"), check.IsNil)
 	dockerCmd(c, "run", "-d", "--net=dm-nil-parent", "--name=second", "busybox", "top")
 	c.Assert(waitRun("second"), check.IsNil)
 
 	// intra-network communications should succeed
 	_, _, err := dockerCmdWithError("exec", "second", "ping", "-c", "1", "first")
 	c.Assert(err, check.IsNil)
 }
 
 func (s *DockerSuite) TestDockerNetworkMacVlanBridgeInternalMode(c *check.C) {
 	// macvlan bridge mode --internal containers can communicate inside the network but not externally
930a9869
 	testRequires(c, DaemonIsLinux, macvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
eeaa6c96
 	cli.DockerCmd(c, "network", "create", "--driver=macvlan", "--internal", "dm-internal")
afeea8c9
 	assertNwIsAvailable(c, "dm-internal")
 	nr := getNetworkResource(c, "dm-internal")
 	c.Assert(nr.Internal, checker.True)
 
 	// start two containers on the same subnet
eeaa6c96
 	cli.DockerCmd(c, "run", "-d", "--net=dm-internal", "--name=first", "busybox", "top")
afeea8c9
 	c.Assert(waitRun("first"), check.IsNil)
eeaa6c96
 	cli.DockerCmd(c, "run", "-d", "--net=dm-internal", "--name=second", "busybox", "top")
afeea8c9
 	c.Assert(waitRun("second"), check.IsNil)
 
 	// access outside of the network should fail
eeaa6c96
 	result := cli.Docker(cli.Args("exec", "first", "ping", "-c", "1", "-w", "1", "8.8.8.8"), cli.WithTimeout(time.Second))
92427b3a
 	result.Assert(c, icmd.Expected{Timeout: true})
d7022f2b
 
afeea8c9
 	// intra-network communications should succeed
eeaa6c96
 	cli.DockerCmd(c, "exec", "second", "ping", "-c", "1", "first")
afeea8c9
 }
 
 func (s *DockerSuite) TestDockerNetworkIpvlanL2NilParent(c *check.C) {
 	// ipvlan l2 mode - dummy parent interface is provisioned dynamically
930a9869
 	testRequires(c, DaemonIsLinux, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "di-nil-parent")
 	assertNwIsAvailable(c, "di-nil-parent")
 
 	// start two containers on the same subnet
 	dockerCmd(c, "run", "-d", "--net=di-nil-parent", "--name=first", "busybox", "top")
 	c.Assert(waitRun("first"), check.IsNil)
 	dockerCmd(c, "run", "-d", "--net=di-nil-parent", "--name=second", "busybox", "top")
 	c.Assert(waitRun("second"), check.IsNil)
 
 	// intra-network communications should succeed
 	_, _, err := dockerCmdWithError("exec", "second", "ping", "-c", "1", "first")
 	c.Assert(err, check.IsNil)
 }
 
 func (s *DockerSuite) TestDockerNetworkIpvlanL2InternalMode(c *check.C) {
 	// ipvlan l2 mode --internal containers can communicate inside the network but not externally
930a9869
 	testRequires(c, DaemonIsLinux, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
eeaa6c96
 	cli.DockerCmd(c, "network", "create", "--driver=ipvlan", "--internal", "di-internal")
afeea8c9
 	assertNwIsAvailable(c, "di-internal")
 	nr := getNetworkResource(c, "di-internal")
 	c.Assert(nr.Internal, checker.True)
 
 	// start two containers on the same subnet
eeaa6c96
 	cli.DockerCmd(c, "run", "-d", "--net=di-internal", "--name=first", "busybox", "top")
afeea8c9
 	c.Assert(waitRun("first"), check.IsNil)
eeaa6c96
 	cli.DockerCmd(c, "run", "-d", "--net=di-internal", "--name=second", "busybox", "top")
afeea8c9
 	c.Assert(waitRun("second"), check.IsNil)
 
 	// access outside of the network should fail
eeaa6c96
 	result := cli.Docker(cli.Args("exec", "first", "ping", "-c", "1", "-w", "1", "8.8.8.8"), cli.WithTimeout(time.Second))
92427b3a
 	result.Assert(c, icmd.Expected{Timeout: true})
afeea8c9
 	// intra-network communications should succeed
eeaa6c96
 	cli.DockerCmd(c, "exec", "second", "ping", "-c", "1", "first")
afeea8c9
 }
 
 func (s *DockerSuite) TestDockerNetworkIpvlanL3NilParent(c *check.C) {
 	// ipvlan l3 mode - dummy parent interface is provisioned dynamically
930a9869
 	testRequires(c, DaemonIsLinux, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	dockerCmd(c, "network", "create", "--driver=ipvlan", "--subnet=172.28.230.0/24",
 		"--subnet=172.28.220.0/24", "-o", "ipvlan_mode=l3", "di-nil-parent-l3")
 	assertNwIsAvailable(c, "di-nil-parent-l3")
 
 	// start two containers on separate subnets
 	dockerCmd(c, "run", "-d", "--ip=172.28.220.10", "--net=di-nil-parent-l3", "--name=first", "busybox", "top")
 	c.Assert(waitRun("first"), check.IsNil)
 	dockerCmd(c, "run", "-d", "--ip=172.28.230.10", "--net=di-nil-parent-l3", "--name=second", "busybox", "top")
 	c.Assert(waitRun("second"), check.IsNil)
 
 	// intra-network communications should succeed
 	_, _, err := dockerCmdWithError("exec", "second", "ping", "-c", "1", "first")
 	c.Assert(err, check.IsNil)
 }
 
 func (s *DockerSuite) TestDockerNetworkIpvlanL3InternalMode(c *check.C) {
 	// ipvlan l3 mode --internal containers can communicate inside the network but not externally
930a9869
 	testRequires(c, DaemonIsLinux, ipvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
eeaa6c96
 	cli.DockerCmd(c, "network", "create", "--driver=ipvlan", "--subnet=172.28.230.0/24",
afeea8c9
 		"--subnet=172.28.220.0/24", "-o", "ipvlan_mode=l3", "--internal", "di-internal-l3")
 	assertNwIsAvailable(c, "di-internal-l3")
 	nr := getNetworkResource(c, "di-internal-l3")
 	c.Assert(nr.Internal, checker.True)
 
 	// start two containers on separate subnets
eeaa6c96
 	cli.DockerCmd(c, "run", "-d", "--ip=172.28.220.10", "--net=di-internal-l3", "--name=first", "busybox", "top")
afeea8c9
 	c.Assert(waitRun("first"), check.IsNil)
eeaa6c96
 	cli.DockerCmd(c, "run", "-d", "--ip=172.28.230.10", "--net=di-internal-l3", "--name=second", "busybox", "top")
afeea8c9
 	c.Assert(waitRun("second"), check.IsNil)
 
 	// access outside of the network should fail
eeaa6c96
 	result := cli.Docker(cli.Args("exec", "first", "ping", "-c", "1", "-w", "1", "8.8.8.8"), cli.WithTimeout(time.Second))
92427b3a
 	result.Assert(c, icmd.Expected{Timeout: true})
afeea8c9
 	// intra-network communications should succeed
eeaa6c96
 	cli.DockerCmd(c, "exec", "second", "ping", "-c", "1", "first")
afeea8c9
 }
 
 func (s *DockerSuite) TestDockerNetworkMacVlanExistingParent(c *check.C) {
 	// macvlan bridge mode - empty parent interface containers can reach each other internally but not externally
930a9869
 	testRequires(c, DaemonIsLinux, macvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	netName := "dm-parent-exists"
87e3fcfe
 	createMasterDummy(c, "dm-dummy0")
afeea8c9
 	//out, err := createVlanInterface(c, "dm-parent", "dm-slave", "macvlan", "bridge")
 	// create a network using an existing parent interface
 	dockerCmd(c, "network", "create", "--driver=macvlan", "-o", "parent=dm-dummy0", netName)
 	assertNwIsAvailable(c, netName)
 	// delete the network while preserving the parent link
 	dockerCmd(c, "network", "rm", netName)
 	assertNwNotAvailable(c, netName)
 	// verify the network delete did not delete the predefined link
87e3fcfe
 	linkExists(c, "dm-dummy0")
afeea8c9
 	deleteInterface(c, "dm-dummy0")
 }
 
 func (s *DockerSuite) TestDockerNetworkMacVlanSubinterface(c *check.C) {
 	// macvlan bridge mode -  empty parent interface containers can reach each other internally but not externally
930a9869
 	testRequires(c, DaemonIsLinux, macvlanKernelSupport, NotUserNamespace, NotArm, ExperimentalDaemon)
afeea8c9
 	netName := "dm-subinterface"
87e3fcfe
 	createMasterDummy(c, "dm-dummy0")
 	createVlanInterface(c, "dm-dummy0", "dm-dummy0.20", "20")
afeea8c9
 	// create a network using an existing parent interface
 	dockerCmd(c, "network", "create", "--driver=macvlan", "-o", "parent=dm-dummy0.20", netName)
 	assertNwIsAvailable(c, netName)
 
 	// start containers on 802.1q tagged '-o parent' sub-interface
 	dockerCmd(c, "run", "-d", "--net=dm-subinterface", "--name=first", "busybox", "top")
 	c.Assert(waitRun("first"), check.IsNil)
 	dockerCmd(c, "run", "-d", "--net=dm-subinterface", "--name=second", "busybox", "top")
 	c.Assert(waitRun("second"), check.IsNil)
 	// verify containers can communicate
87e3fcfe
 	_, _, err := dockerCmdWithError("exec", "second", "ping", "-c", "1", "first")
afeea8c9
 	c.Assert(err, check.IsNil)
 
 	// remove the containers
 	dockerCmd(c, "rm", "-f", "first")
 	dockerCmd(c, "rm", "-f", "second")
 	// delete the network while preserving the parent link
 	dockerCmd(c, "network", "rm", netName)
 	assertNwNotAvailable(c, netName)
 	// verify the network delete did not delete the predefined sub-interface
87e3fcfe
 	linkExists(c, "dm-dummy0.20")
afeea8c9
 	// delete the parent interface which also collects the slave
 	deleteInterface(c, "dm-dummy0")
 }
 
87e3fcfe
 func createMasterDummy(c *check.C, master string) {
afeea8c9
 	// ip link add <dummy_name> type dummy
87e3fcfe
 	icmd.RunCommand("ip", "link", "add", master, "type", "dummy").Assert(c, icmd.Success)
 	icmd.RunCommand("ip", "link", "set", master, "up").Assert(c, icmd.Success)
afeea8c9
 }
 
87e3fcfe
 func createVlanInterface(c *check.C, master, slave, id string) {
afeea8c9
 	// ip link add link <master> name <master>.<VID> type vlan id <VID>
87e3fcfe
 	icmd.RunCommand("ip", "link", "add", "link", master, "name", slave, "type", "vlan", "id", id).Assert(c, icmd.Success)
afeea8c9
 	// ip link set <sub_interface_name> up
87e3fcfe
 	icmd.RunCommand("ip", "link", "set", slave, "up").Assert(c, icmd.Success)
afeea8c9
 }
 
87e3fcfe
 func linkExists(c *check.C, master string) {
afeea8c9
 	// verify the specified link exists, ip link show <link_name>
87e3fcfe
 	icmd.RunCommand("ip", "link", "show", master).Assert(c, icmd.Success)
afeea8c9
 }