docker: github.com/docker/docker/vendor/github.com/docker/libnetwork/driverapi Index | Files

package driverapi

import "github.com/docker/docker/vendor/github.com/docker/libnetwork/driverapi"

Index

Package Files

driverapi.go errors.go ipamdata.go

Constants

const NetworkPluginEndpointType = "NetworkDriver"

NetworkPluginEndpointType represents the Endpoint Type used by Plugin system

func IsValidType Uses

func IsValidType(objType ObjectType) bool

IsValidType validates the passed in type against the valid object types

type Capability Uses

type Capability struct {
    DataScope         string
    ConnectivityScope string
}

Capability represents the high level capabilities of the drivers which libnetwork can make use of

type Driver Uses

type Driver interface {
    discoverapi.Discover

    // NetworkAllocate invokes the driver method to allocate network
    // specific resources passing network id and network specific config.
    // It returns a key,value pair of network specific driver allocations
    // to the caller.
    NetworkAllocate(nid string, options map[string]string, ipV4Data, ipV6Data []IPAMData) (map[string]string, error)

    // NetworkFree invokes the driver method to free network specific resources
    // associated with a given network id.
    NetworkFree(nid string) error

    // CreateNetwork invokes the driver method to create a network
    // passing the network id and network specific config. The
    // config mechanism will eventually be replaced with labels
    // which are yet to be introduced. The driver can return a
    // list of table names for which it is interested in receiving
    // notification when a CRUD operation is performed on any
    // entry in that table. This will be ignored for local scope
    // drivers.
    CreateNetwork(nid string, options map[string]interface{}, nInfo NetworkInfo, ipV4Data, ipV6Data []IPAMData) error

    // DeleteNetwork invokes the driver method to delete network passing
    // the network id.
    DeleteNetwork(nid string) error

    // CreateEndpoint invokes the driver method to create an endpoint
    // passing the network id, endpoint id endpoint information and driver
    // specific config. The endpoint information can be either consumed by
    // the driver or populated by the driver. The config mechanism will
    // eventually be replaced with labels which are yet to be introduced.
    CreateEndpoint(nid, eid string, ifInfo InterfaceInfo, options map[string]interface{}) error

    // DeleteEndpoint invokes the driver method to delete an endpoint
    // passing the network id and endpoint id.
    DeleteEndpoint(nid, eid string) error

    // EndpointOperInfo retrieves from the driver the operational data related to the specified endpoint
    EndpointOperInfo(nid, eid string) (map[string]interface{}, error)

    // Join method is invoked when a Sandbox is attached to an endpoint.
    Join(nid, eid string, sboxKey string, jinfo JoinInfo, options map[string]interface{}) error

    // Leave method is invoked when a Sandbox detaches from an endpoint.
    Leave(nid, eid string) error

    // ProgramExternalConnectivity invokes the driver method which does the necessary
    // programming to allow the external connectivity dictated by the passed options
    ProgramExternalConnectivity(nid, eid string, options map[string]interface{}) error

    // RevokeExternalConnectivity asks the driver to remove any external connectivity
    // programming that was done so far
    RevokeExternalConnectivity(nid, eid string) error

    // EventNotify notifies the driver when a CRUD operation has
    // happened on a table of its interest as soon as this node
    // receives such an event in the gossip layer. This method is
    // only invoked for the global scope driver.
    EventNotify(event EventType, nid string, tableName string, key string, value []byte)

    // DecodeTableEntry passes the driver a key, value pair from table it registered
    // with libnetwork. Driver should return {object ID, map[string]string} tuple.
    // If DecodeTableEntry is called for a table associated with NetworkObject or
    // EndpointObject the return object ID should be the network id or endpoint id
    // associated with that entry. map should have information about the object that
    // can be presented to the user.
    // For example: overlay driver returns the VTEP IP of the host that has the endpoint
    // which is shown in 'network inspect --verbose'
    DecodeTableEntry(tablename string, key string, value []byte) (string, map[string]string)

    // Type returns the type of this driver, the network type this driver manages
    Type() string

    // IsBuiltIn returns true if it is a built-in driver
    IsBuiltIn() bool
}

Driver is an interface that every plugin driver needs to implement.

type DriverCallback Uses

type DriverCallback interface {
    // GetPluginGetter returns the pluginv2 getter.
    GetPluginGetter() plugingetter.PluginGetter
    // RegisterDriver provides a way for Remote drivers to dynamically register new NetworkType and associate with a driver instance
    RegisterDriver(name string, driver Driver, capability Capability) error
}

DriverCallback provides a Callback interface for Drivers into LibNetwork

type ErrActiveRegistration Uses

type ErrActiveRegistration string

ErrActiveRegistration represents an error when a driver is registered to a networkType that is previously registered

func (ErrActiveRegistration) Error Uses

func (ar ErrActiveRegistration) Error() string

Error interface for ErrActiveRegistration

func (ErrActiveRegistration) Forbidden Uses

func (ar ErrActiveRegistration) Forbidden()

Forbidden denotes the type of this error

type ErrEndpointExists Uses

type ErrEndpointExists string

ErrEndpointExists is returned if more than one endpoint is added to the network

func (ErrEndpointExists) Error Uses

func (ee ErrEndpointExists) Error() string

func (ErrEndpointExists) Forbidden Uses

func (ee ErrEndpointExists) Forbidden()

Forbidden denotes the type of this error

type ErrNoEndpoint Uses

type ErrNoEndpoint string

ErrNoEndpoint is returned if no endpoint with the specified id exists

func (ErrNoEndpoint) Error Uses

func (ene ErrNoEndpoint) Error() string

func (ErrNoEndpoint) NotFound Uses

func (ene ErrNoEndpoint) NotFound()

NotFound denotes the type of this error

type ErrNoNetwork Uses

type ErrNoNetwork string

ErrNoNetwork is returned if no network with the specified id exists

func (ErrNoNetwork) Error Uses

func (enn ErrNoNetwork) Error() string

func (ErrNoNetwork) NotFound Uses

func (enn ErrNoNetwork) NotFound()

NotFound denotes the type of this error

type ErrNotImplemented Uses

type ErrNotImplemented struct{}

ErrNotImplemented is returned when a Driver has not implemented an API yet

func (*ErrNotImplemented) Error Uses

func (eni *ErrNotImplemented) Error() string

func (*ErrNotImplemented) NotImplemented Uses

func (eni *ErrNotImplemented) NotImplemented()

NotImplemented denotes the type of this error

type EventType Uses

type EventType uint8

EventType defines a type for the CRUD event

const (
    // Create event is generated when a table entry is created,
    Create EventType = 1 + iota
    // Update event is generated when a table entry is updated.
    Update
    // Delete event is generated when a table entry is deleted.
    Delete
)

type IPAMData Uses

type IPAMData struct {
    AddressSpace string
    Pool         *net.IPNet
    Gateway      *net.IPNet
    AuxAddresses map[string]*net.IPNet
}

IPAMData represents the per-network ip related operational information libnetwork will send to the network driver during CreateNetwork()

func (*IPAMData) IsV6 Uses

func (i *IPAMData) IsV6() bool

IsV6 returns whether this is an IPv6 IPAMData structure

func (*IPAMData) MarshalJSON Uses

func (i *IPAMData) MarshalJSON() ([]byte, error)

MarshalJSON encodes IPAMData into json message

func (*IPAMData) String Uses

func (i *IPAMData) String() string

func (*IPAMData) UnmarshalJSON Uses

func (i *IPAMData) UnmarshalJSON(data []byte) error

UnmarshalJSON decodes a json message into IPAMData

func (*IPAMData) Validate Uses

func (i *IPAMData) Validate() error

Validate checks whether the IPAMData structure contains congruent data

type InterfaceInfo Uses

type InterfaceInfo interface {
    // SetMacAddress allows the driver to set the mac address to the endpoint interface
    // during the call to CreateEndpoint, if the mac address is not already set.
    SetMacAddress(mac net.HardwareAddr) error

    // SetIPAddress allows the driver to set the ip address to the endpoint interface
    // during the call to CreateEndpoint, if the address is not already set.
    // The API is to be used to assign both the IPv4 and IPv6 address types.
    SetIPAddress(ip *net.IPNet) error

    // MacAddress returns the MAC address.
    MacAddress() net.HardwareAddr

    // Address returns the IPv4 address.
    Address() *net.IPNet

    // AddressIPv6 returns the IPv6 address.
    AddressIPv6() *net.IPNet
}

InterfaceInfo provides a go interface for drivers to retrieve network information to interface resources.

type InterfaceNameInfo Uses

type InterfaceNameInfo interface {
    // SetNames method assigns the srcName and dstPrefix for the interface.
    SetNames(srcName, dstPrefix string) error
}

InterfaceNameInfo provides a go interface for the drivers to assign names to interfaces.

type JoinInfo Uses

type JoinInfo interface {
    // InterfaceName returns an InterfaceNameInfo go interface to facilitate
    // setting the names for the interface.
    InterfaceName() InterfaceNameInfo

    // SetGateway sets the default IPv4 gateway when a container joins the endpoint.
    SetGateway(net.IP) error

    // SetGatewayIPv6 sets the default IPv6 gateway when a container joins the endpoint.
    SetGatewayIPv6(net.IP) error

    // AddStaticRoute adds a route to the sandbox.
    // It may be used in addition to or instead of a default gateway (as above).
    AddStaticRoute(destination *net.IPNet, routeType int, nextHop net.IP) error

    // DisableGatewayService tells libnetwork not to provide Default GW for the container
    DisableGatewayService()

    // AddTableEntry adds a table entry to the gossip layer
    // passing the table name, key and an opaque value.
    AddTableEntry(tableName string, key string, value []byte) error
}

JoinInfo represents a set of resources that the driver has the ability to provide during join time.

type NetworkInfo Uses

type NetworkInfo interface {
    // TableEventRegister registers driver interest in a given
    // table name.
    TableEventRegister(tableName string, objType ObjectType) error

    // UpdateIPamConfig updates the networks IPAM configuration
    // based on information from the driver.  In windows, the OS (HNS) chooses
    // the IP address space if the user does not specify an address space.
    UpdateIpamConfig(ipV4Data []IPAMData)
}

NetworkInfo provides a go interface for drivers to provide network specific information to libnetwork.

type ObjectType Uses

type ObjectType int

ObjectType represents the type of object driver wants to store in libnetwork's networkDB

const (
    // EndpointObject should be set for libnetwork endpoint object related data
    EndpointObject ObjectType = 1 + iota
    // NetworkObject should be set for libnetwork network object related data
    NetworkObject
    // OpaqueObject is for driver specific data with no corresponding libnetwork object
    OpaqueObject
)

Package driverapi imports 6 packages (graph). Updated 2019-09-28. Refresh now. Tools for package owners.