mirror of
https://github.com/NVIDIA/nvidia-container-toolkit
synced 2024-12-01 16:52:54 +00:00
5b110fba2d
This change adds an nvcdi package that exposes a basic API for CDI spec generation. This is used from the nvidia-ctk cdi generate command and can be consumed by DRA implementations and the device plugin. Signed-off-by: Evan Lezar <elezar@nvidia.com>
90 lines
3.1 KiB
Go
90 lines
3.1 KiB
Go
/**
|
|
# Copyright (c) NVIDIA CORPORATION. All rights reserved.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
**/
|
|
|
|
package nvcdi
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"gitlab.com/nvidia/cloud-native/go-nvlib/pkg/nvlib/device"
|
|
"gitlab.com/nvidia/cloud-native/go-nvlib/pkg/nvml"
|
|
)
|
|
|
|
// DeviceNamer is an interface for getting device names
|
|
type DeviceNamer interface {
|
|
GetDeviceName(int, device.Device) (string, error)
|
|
GetMigDeviceName(int, device.Device, int, device.MigDevice) (string, error)
|
|
}
|
|
|
|
// Supported device naming strategies
|
|
const (
|
|
// DeviceNameStrategyIndex generates devices names such as 0 or 1:0
|
|
DeviceNameStrategyIndex = "index"
|
|
// DeviceNameStrategyTypeIndex generates devices names such as gpu0 or mig1:0
|
|
DeviceNameStrategyTypeIndex = "type-index"
|
|
// DeviceNameStrategyUUID uses the device UUID as the name
|
|
DeviceNameStrategyUUID = "uuid"
|
|
)
|
|
|
|
type deviceNameIndex struct {
|
|
gpuPrefix string
|
|
migPrefix string
|
|
}
|
|
type deviceNameUUID struct{}
|
|
|
|
// NewDeviceNamer creates a Device Namer based on the supplied strategy.
|
|
// This namer can be used to construct the names for MIG and GPU devices when generating the CDI spec.
|
|
func NewDeviceNamer(strategy string) (DeviceNamer, error) {
|
|
switch strategy {
|
|
case DeviceNameStrategyIndex:
|
|
return deviceNameIndex{}, nil
|
|
case DeviceNameStrategyTypeIndex:
|
|
return deviceNameIndex{gpuPrefix: "gpu", migPrefix: "mig"}, nil
|
|
case DeviceNameStrategyUUID:
|
|
return deviceNameUUID{}, nil
|
|
}
|
|
|
|
return nil, fmt.Errorf("invalid device name strategy: %v", strategy)
|
|
}
|
|
|
|
// GetDeviceName returns the name for the specified device based on the naming strategy
|
|
func (s deviceNameIndex) GetDeviceName(i int, d device.Device) (string, error) {
|
|
return fmt.Sprintf("%s%d", s.gpuPrefix, i), nil
|
|
}
|
|
|
|
// GetMigDeviceName returns the name for the specified device based on the naming strategy
|
|
func (s deviceNameIndex) GetMigDeviceName(i int, d device.Device, j int, mig device.MigDevice) (string, error) {
|
|
return fmt.Sprintf("%s%d:%d", s.migPrefix, i, j), nil
|
|
}
|
|
|
|
// GetDeviceName returns the name for the specified device based on the naming strategy
|
|
func (s deviceNameUUID) GetDeviceName(i int, d device.Device) (string, error) {
|
|
uuid, ret := d.GetUUID()
|
|
if ret != nvml.SUCCESS {
|
|
return "", fmt.Errorf("failed to get device UUID: %v", ret)
|
|
}
|
|
return uuid, nil
|
|
}
|
|
|
|
// GetMigDeviceName returns the name for the specified device based on the naming strategy
|
|
func (s deviceNameUUID) GetMigDeviceName(i int, d device.Device, j int, mig device.MigDevice) (string, error) {
|
|
uuid, ret := mig.GetUUID()
|
|
if ret != nvml.SUCCESS {
|
|
return "", fmt.Errorf("failed to get device UUID: %v", ret)
|
|
}
|
|
return uuid, nil
|
|
}
|