mirror of
https://github.com/aljazceru/kata-containers.git
synced 2025-12-26 02:24:21 +01:00
e9a46580b1
This allows to reuse detached block index and ensures that the index will not reach the limit of device(such as `maxSCSIDevices`) after restarting containers many times in one pod. Fixes: #2007 Signed-off-by: Li Yuxuan <liyuxuan04@baidu.com>
93 lines
2.7 KiB
Go
93 lines
2.7 KiB
Go
// Copyright (c) 2017-2018 Intel Corporation
|
|
// Copyright (c) 2018 Huawei Corporation
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
//
|
|
|
|
package api
|
|
|
|
import (
|
|
"github.com/kata-containers/runtime/virtcontainers/device/config"
|
|
persistapi "github.com/kata-containers/runtime/virtcontainers/persist/api"
|
|
"github.com/sirupsen/logrus"
|
|
)
|
|
|
|
var devLogger = logrus.WithField("subsystem", "device")
|
|
|
|
// SetLogger sets the logger for device api package.
|
|
func SetLogger(logger *logrus.Entry) {
|
|
fields := devLogger.Data
|
|
devLogger = logger.WithFields(fields)
|
|
}
|
|
|
|
// DeviceLogger returns logger for device management
|
|
func DeviceLogger() *logrus.Entry {
|
|
return devLogger
|
|
}
|
|
|
|
// DeviceReceiver is an interface used for accepting devices
|
|
// a device should be attached/added/plugged to a DeviceReceiver
|
|
type DeviceReceiver interface {
|
|
// these are for hotplug/hot-unplug devices to/from hypervisor
|
|
HotplugAddDevice(Device, config.DeviceType) error
|
|
HotplugRemoveDevice(Device, config.DeviceType) error
|
|
|
|
// this is only for virtio-blk and virtio-scsi support
|
|
GetAndSetSandboxBlockIndex() (int, error)
|
|
UnsetSandboxBlockIndex(int) error
|
|
GetHypervisorType() string
|
|
|
|
// this is for appending device to hypervisor boot params
|
|
AppendDevice(Device) error
|
|
}
|
|
|
|
// Device is the virtcontainers device interface.
|
|
type Device interface {
|
|
Attach(DeviceReceiver) error
|
|
Detach(DeviceReceiver) error
|
|
|
|
// ID returns device identifier
|
|
DeviceID() string
|
|
|
|
// DeviceType indicates which kind of device it is
|
|
// e.g. block, vfio or vhost user
|
|
DeviceType() config.DeviceType
|
|
|
|
// GetMajorMinor returns major and minor numbers
|
|
GetMajorMinor() (int64, int64)
|
|
|
|
// GetDeviceInfo returns device specific data used for hotplugging by hypervisor
|
|
// Caller could cast the return value to device specific struct
|
|
// e.g. Block device returns *config.BlockDrive and
|
|
// vfio device returns []*config.VFIODev
|
|
GetDeviceInfo() interface{}
|
|
|
|
// GetAttachCount returns how many times the device has been attached
|
|
GetAttachCount() uint
|
|
|
|
// Reference adds one reference to device then returns final ref count
|
|
Reference() uint
|
|
|
|
// Dereference removes one reference to device then returns final ref count
|
|
Dereference() uint
|
|
|
|
// Save converts Device to DeviceState
|
|
Save() persistapi.DeviceState
|
|
|
|
// Load loads DeviceState and converts it to specific device
|
|
Load(persistapi.DeviceState)
|
|
}
|
|
|
|
// DeviceManager can be used to create a new device, this can be used as single
|
|
// device management object.
|
|
type DeviceManager interface {
|
|
NewDevice(config.DeviceInfo) (Device, error)
|
|
RemoveDevice(string) error
|
|
AttachDevice(string, DeviceReceiver) error
|
|
DetachDevice(string, DeviceReceiver) error
|
|
IsDeviceAttached(string) bool
|
|
GetDeviceByID(string) Device
|
|
GetAllDevices() []Device
|
|
LoadDevices([]persistapi.DeviceState)
|
|
}
|