devices

package

Go to main page

Versions in this module

v0

v0.2.0

Jul 8, 2026

v0.1.1

Jun 12, 2026

v0.1.0

Jun 4, 2026

Changes in this version

type CreateDeviceRequest

+ Tags tags.Tags

type Device

+ Tags tags.Tags

v0.0.7

Mar 3, 2026

v0.0.6

Feb 16, 2026

Changes in this version

+ var ErrNotSupportedOnMacOS = fmt.Errorf("PCI device passthrough is not supported on macOS") — darwin/amd64

+ var ErrVFIONotSupportedOnMacOS = fmt.Errorf("VFIO device passthrough is not supported on macOS") — darwin/amd64

+ var ErrVGPUNotSupportedOnMacOS = fmt.Errorf("vGPU (mdev) is not supported on macOS") — darwin/amd64

+ func SetGPUProfileCacheTTL(ttl string) — darwin/amd64, linux/amd64

v0.0.5

Jan 16, 2026

Changes in this version

+ func DestroyMdev(ctx context.Context, mdevUUID string) error

+ func IsMdevInUse(mdevUUID string) bool

+ func ReconcileMdevs(ctx context.Context, instanceInfos []MdevReconcileInfo) error

+ type GPUMode string

+ const GPUModeNone

+ const GPUModePassthrough

+ const GPUModeVGPU

+ func DetectHostGPUMode() GPUMode

+ type GPUProfile struct

+ Available int

+ FramebufferMB int

+ Name string

+ func ListGPUProfiles() ([]GPUProfile, error)

+ func ListGPUProfilesWithVFs(vfs []VirtualFunction) ([]GPUProfile, error)

+ type MdevDevice struct

+ InstanceID string

+ ProfileName string

+ ProfileType string

+ SysfsPath string

+ UUID string

+ VFAddress string

+ func CreateMdev(ctx context.Context, profileName, instanceID string) (*MdevDevice, error)

+ func ListMdevDevices() ([]MdevDevice, error)

+ type MdevReconcileInfo struct

+ InstanceID string

+ IsRunning bool

+ MdevUUID string

+ type PassthroughDevice struct

+ Available bool

+ Name string

+ type VirtualFunction struct

+ HasMdev bool

+ PCIAddress string

+ ParentGPU string

+ func DiscoverVFs() ([]VirtualFunction, error)

v0.0.4

Jan 12, 2026

Changes in this version

+ var DeviceNamePattern = regexp.MustCompile(`^[a-zA-Z0-9][a-zA-Z0-9_.-]+$`)

+ var ErrAlreadyBound = errors.New("device is already bound to VFIO")

+ var ErrAlreadyExists = errors.New("device already exists")

+ var ErrDeviceNotFound = errors.New("PCI device not found on host")

+ var ErrIOMMUGroupConflict = errors.New("IOMMU group contains other devices that must also be passed through")

+ var ErrInUse = errors.New("device is in use")

+ var ErrInvalidName = errors.New("device name must match pattern ^[a-zA-Z0-9][a-zA-Z0-9_.-]+$")

+ var ErrInvalidPCIAddress = errors.New("invalid PCI address format")

+ var ErrNameExists = errors.New("device name already exists")

+ var ErrNotBound = errors.New("device is not bound to VFIO")

+ var ErrNotFound = errors.New("device not found")

+ var ErrVFIONotAvailable = errors.New("VFIO is not available (modules not loaded)")

+ func GetDeviceSysfsPath(pciAddress string) string

+ func GetIOMMUGroupDevices(iommuGroup int) ([]string, error)

+ func ValidateDeviceName(name string) bool

+ func ValidatePCIAddress(addr string) bool

+ type AvailableDevice struct

+ CurrentDriver *string

+ DeviceID string

+ DeviceName string

+ IOMMUGroup int

+ PCIAddress string

+ VendorID string

+ VendorName string

+ func DiscoverAvailableDevices() ([]AvailableDevice, error)

+ func GetDeviceInfo(pciAddress string) (*AvailableDevice, error)

+ type CreateDeviceRequest struct

+ Name string

+ PCIAddress string

+ type Device struct

+ AttachedTo *string

+ BoundToVFIO bool

+ CreatedAt time.Time

+ DeviceID string

+ IOMMUGroup int

+ Id string

+ Name string

+ PCIAddress string

+ Type DeviceType

+ VendorID string

+ type DeviceType string

+ const DeviceTypeGPU

+ const DeviceTypeGeneric

+ func DetermineDeviceType(device *AvailableDevice) DeviceType

+ type InstanceLivenessChecker interface

+ DetectSuspiciousVMMProcesses func(ctx context.Context) int

+ GetInstanceDevices func(ctx context.Context, instanceID string) []string

+ IsInstanceRunning func(ctx context.Context, instanceID string) bool

+ ListAllInstanceDevices func(ctx context.Context) map[string][]string

+ type Manager interface

+ BindToVFIO func(ctx context.Context, id string) error

+ CreateDevice func(ctx context.Context, req CreateDeviceRequest) (*Device, error)

+ DeleteDevice func(ctx context.Context, id string) error

+ GetDevice func(ctx context.Context, idOrName string) (*Device, error)

+ ListAvailableDevices func(ctx context.Context) ([]AvailableDevice, error)

+ ListDevices func(ctx context.Context) ([]Device, error)

+ MarkAttached func(ctx context.Context, deviceID, instanceID string) error

+ MarkDetached func(ctx context.Context, deviceID string) error

+ ReconcileDevices func(ctx context.Context) error

+ SetLivenessChecker func(checker InstanceLivenessChecker)

+ UnbindFromVFIO func(ctx context.Context, id string) error

+ func NewManager(p *paths.Paths) Manager

+ type VFIOBinder struct

+ func NewVFIOBinder() *VFIOBinder

+ func (v *VFIOBinder) BindToVFIO(pciAddress string) error

+ func (v *VFIOBinder) CheckIOMMUGroupSafe(pciAddress string, allowedDevices []string) error

+ func (v *VFIOBinder) GetVFIOGroupPath(pciAddress string) (string, error)

+ func (v *VFIOBinder) IsDeviceBoundToVFIO(pciAddress string) bool

+ func (v *VFIOBinder) IsVFIOAvailable() bool

+ func (v *VFIOBinder) UnbindFromVFIO(pciAddress string) error

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL