ipvlan

Documentation

Overview

Package ipvlan provides Docker “ipvlan”-driver specific network configuration options. Please see also the Docker ipvlan driver documentation.

Index

• func WithFlag(flag IPVLANFlag) net.Opt
• func WithMode(mode IPVLANMode) net.Opt
• func WithParent(ifname string) net.Opt
• type IPVLANFlag
• type IPVLANMode

Functions

func WithFlag

func WithFlag(flag IPVLANFlag) net.Opt

WithFlag sets the IPVLAN (mode) flag; when unset, it defaults to “bridge” (BridgeFlag).

• BridgeFlag
• VEPAFlag
• PrivateFlag

See also: Docker's IPvlan network driver options.

func WithMode

func WithMode(mode IPVLANMode) net.Opt

WithMode sets the IPVLAN mode. If left unset, it defaults to “l2” L2Mode. All slave “ipvlan” network interfaces will operate in the same mode.

• L2Mode – the parent network interfaces bridges L2 traffic between the “slaves”, ARP can be used. However, different IP subnets on the same parent network interface cannot ping each other. An external host only sees the single external-facing MAC address of the parent.
• L3Mode – only IP-layer connectivity between “slaves”, where the parent network interface acts as an IP router for unicast traffic. Different IP subnets on the same parent network interface can reach each other using IP unicast traffic.
• L3sMode – like L3Mode, but with packet filtering supported.

See also:

• Docker's IPvlan network driver options.
• Introduction to Linux interfaces for virtual networking: IPVLAN.
• Getting started with IPVLAN.
• Linux kernel IPVLAN Driver HOWTO.

func WithParent

func WithParent(ifname string) net.Opt

WithParent sets the name of the “parent” interface (and optional VLAN) to attach the IPVLAN “slave” interfaces to. In Linux parlance, the “parent” interface is commonly referred to as the “master”.

See also: Docker's IPvlan network driver options.

Types

type IPVLANFlag

type IPVLANFlag string

const (
	BridgeFlag  IPVLANFlag = "bridge"
	VEPAFlag    IPVLANFlag = "vepa"
	PrivateFlag IPVLANFlag = "private"
)

type IPVLANMode

type IPVLANMode string

const (
	L2Mode  IPVLANMode = "l2"
	L3Mode  IPVLANMode = "l3"
	L3sMode IPVLANMode = "l3s"
)