62 lines
1.8 KiB
Go
62 lines
1.8 KiB
Go
package nvml
|
|
|
|
import "errors"
|
|
|
|
var (
|
|
// UnavailableLib is returned when the nvml library could not be loaded.
|
|
UnavailableLib = errors.New("could not load NVML library")
|
|
)
|
|
|
|
// nvmlDriver implements NvmlDriver
|
|
// Users are required to call Initialize method before using any other methods
|
|
type nvmlDriver struct{}
|
|
|
|
// NvmlDriver represents set of methods to query nvml library
|
|
type NvmlDriver interface {
|
|
Initialize() error
|
|
Shutdown() error
|
|
SystemDriverVersion() (string, error)
|
|
DeviceCount() (uint, error)
|
|
DeviceInfoByIndex(uint) (*DeviceInfo, error)
|
|
DeviceInfoAndStatusByIndex(uint) (*DeviceInfo, *DeviceStatus, error)
|
|
}
|
|
|
|
// DeviceInfo represents nvml device data
|
|
// this struct is returned by NvmlDriver DeviceInfoByIndex and
|
|
// DeviceInfoAndStatusByIndex methods
|
|
type DeviceInfo struct {
|
|
// The following fields are guaranteed to be retrieved from nvml
|
|
UUID string
|
|
PCIBusID string
|
|
DisplayState string
|
|
PersistenceMode string
|
|
|
|
// The following fields can be nil after call to nvml, because nvml was
|
|
// not able to retrieve this fields for specific nvidia card
|
|
Name *string
|
|
MemoryMiB *uint64
|
|
PowerW *uint
|
|
BAR1MiB *uint64
|
|
PCIBandwidthMBPerS *uint
|
|
CoresClockMHz *uint
|
|
MemoryClockMHz *uint
|
|
}
|
|
|
|
// DeviceStatus represents nvml device status
|
|
// this struct is returned by NvmlDriver DeviceInfoAndStatusByIndex method
|
|
type DeviceStatus struct {
|
|
// The following fields can be nil after call to nvml, because nvml was
|
|
// not able to retrieve this fields for specific nvidia card
|
|
PowerUsageW *uint
|
|
TemperatureC *uint
|
|
GPUUtilization *uint // %
|
|
MemoryUtilization *uint // %
|
|
EncoderUtilization *uint // %
|
|
DecoderUtilization *uint // %
|
|
BAR1UsedMiB *uint64
|
|
UsedMemoryMiB *uint64
|
|
ECCErrorsL1Cache *uint64
|
|
ECCErrorsL2Cache *uint64
|
|
ECCErrorsDevice *uint64
|
|
}
|