network

Documentation

Index

• Constants
• Variables
• func NetNumQueues(cpu int) int
• func ResolveQueueSize(qs int) int
• func TuneTAP(link netlink.Link) error
• func VMIDPrefix(vmID string) string
• type Network

Constants

const (

	// NetQueueSize is the default virtio-net ring depth per queue.
	// 512 balances download throughput (favors larger rings) against
	// request-response latency (favors smaller rings).
	NetQueueSize = 512
)

Variables

var (
	ErrNotFound      = errors.New("network not found")
	ErrNotConfigured = errors.New("network provider not configured")
)

Functions

func NetNumQueues

func NetNumQueues(cpu int) int

NetNumQueues returns the virtio-net queue count for the given CPU count. CH uses queue pairs (TX+RX), so the result is always even (≥ 2).

func ResolveQueueSize

func ResolveQueueSize(qs int) int

ResolveQueueSize returns qs if positive, otherwise the default NetQueueSize.

func TuneTAP

func TuneTAP(link netlink.Link) error

TuneTAP applies best-effort performance tuning to a TAP device.

func VMIDPrefix

func VMIDPrefix(vmID string) string

VMIDPrefix returns the first 8 characters of a VM ID, matching the truncation used by both bridge and CNI TAP device naming.

Types

type Network

type Network interface {
	Type() string

	// Verify checks whether the network namespace for a VM exists.
	// Returns nil if the netns is present, an error otherwise.
	Verify(ctx context.Context, vmID string) error
	// Config creates network namespace, bridge, and tap for a VM.
	// When existing configs are provided (recovery after host reboot),
	// the netns and tap devices are recreated using the persisted MAC addresses.
	// NOTE: vmCfg.Network may be mutated to record the resolved conflist name.
	Config(ctx context.Context, vmID string, numNICs int, vmCfg *types.VMConfig, existing ...*types.NetworkConfig) ([]*types.NetworkConfig, error)
	Delete(context.Context, []string) ([]string, error)
	Inspect(context.Context, string) (*types.Network, error)
	List(context.Context) ([]*types.Network, error)

	RegisterGC(*gc.Orchestrator)
}

Network defines the interface for a network provider (CNI, etc.).