device

type DesiredDevice struct {
	Owner      DeviceOwner       `json:"owner" yaml:"owner"`
	Name       string            `json:"name" yaml:"name"`
	DeviceSpec DesiredDeviceSpec `json:"spec" yaml:"spec"`
	// contains filtered or unexported fields
}

type DesiredDeviceKey struct {
	Owner DeviceOwner
	Name  string
}

type DesiredDeviceSpec interface {
	ToNetlink() (netlink.Link, error)
	Properties() string
	MarshalJSON() ([]byte, error)
	MarshalYAML() (any, error)
	// NeedsRecreate reports whether the existing kernel device must be deleted
	// and re-added rather than modified in-place. It is only called when a
	// device with this name already exists.
	//
	// It must return true ONLY when an immutable kernel attribute (e.g. VRF
	// table ID, VLAN ID) actually differs between the desired spec and the
	// existing device. Returning true unconditionally causes a destructive
	// delete+add on every reconcile (including periodic refresh).
	NeedsRecreate(existing netlink.Link) bool
}

type DesiredVLANDeviceSpec struct {
	Name        string `json:"name" yaml:"name"`
	VLANID      int    `json:"vlanID" yaml:"vlanID"`
	MTU         int    `json:"mtu" yaml:"mtu"`
	ParentName  string `json:"parentName" yaml:"parentName"`
	ParentIndex int    `json:"parentIndex" yaml:"parentIndex"`
}

type DeviceOwner struct {
	Name string `json:"name" yaml:"name"`
}

type Initializer struct {
	// contains filtered or unexported fields
}

type ManagerOperations interface {
	// UpsertDevice upserts a desired device into the desired device table.
	UpsertDevice(device DesiredDevice) error
	// UpsertDeviceWait upserts a desired device into the desired device table
	// and waits for the device to be reconciled.
	UpsertDeviceWait(device DesiredDevice, timeout time.Duration) error
	// DeleteDevice deletes a desired device from the desired device table.
	DeleteDevice(device DesiredDevice) error
	// GetOrRegisterOwner gets or registers an owner with the given name.
	GetOrRegisterOwner(name string) DeviceOwner
	// RemoveOwner removes an owner and associated devices with the given owner.
	RemoveOwner(owner DeviceOwner) error
	// RegisterInitializer registers an initializer with the given name and returns
	// the initializer to the caller.
	RegisterInitializer(name string) Initializer
	// FinalizeInitializer should be called by the caller with registered initializer
	// once callers initial sync is completed. Once all initializers are finalized,
	// the reconciler will start initial pruning.
	FinalizeInitializer(initializer Initializer)
}