nvidia-container-toolkit/internal/config/image/capabilities.go

/**
# Copyright (c) 2022, 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 image

import (
	"sort"
	"strings"
)

// DriverCapability represents the possible values of NVIDIA_DRIVER_CAPABILITIES
type DriverCapability string

// Constants for the supported driver capabilities
const (
	DriverCapabilityAll      DriverCapability = "all"
	DriverCapabilityNone     DriverCapability = "none"
	DriverCapabilityCompat32 DriverCapability = "compat32"
	DriverCapabilityCompute  DriverCapability = "compute"
	DriverCapabilityDisplay  DriverCapability = "display"
	DriverCapabilityGraphics DriverCapability = "graphics"
	DriverCapabilityNgx      DriverCapability = "ngx"
	DriverCapabilityUtility  DriverCapability = "utility"
	DriverCapabilityVideo    DriverCapability = "video"
)

var (
	driverCapabilitiesNone = NewDriverCapabilities()
	driverCapabilitiesAll  = NewDriverCapabilities("all")

	// DefaultDriverCapabilities sets the value for driver capabilities if no value is set.
	DefaultDriverCapabilities = NewDriverCapabilities("utility,compute")
	// SupportedDriverCapabilities defines the set of all supported driver capabilities.
	SupportedDriverCapabilities = NewDriverCapabilities("compute,compat32,graphics,utility,video,display,ngx")
)

// NewDriverCapabilities creates a set of driver capabilities from the specified capabilities
func NewDriverCapabilities(capabilities ...string) DriverCapabilities {
	dc := make(DriverCapabilities)
	for _, capability := range capabilities {
		for _, c := range strings.Split(capability, ",") {
			trimmed := strings.TrimSpace(c)
			if trimmed == "" {
				continue
			}
			dc[DriverCapability(trimmed)] = true
		}
	}
	return dc
}

// DriverCapabilities represents the NVIDIA_DRIVER_CAPABILITIES set for the specified image.
type DriverCapabilities map[DriverCapability]bool

// Has check whether the specified capability is selected.
func (c DriverCapabilities) Has(capability DriverCapability) bool {
	if c.IsAll() {
		return true
	}
	return c[capability]
}

// Any checks whether any of the specified capabilites are set
func (c DriverCapabilities) Any(capabilities ...DriverCapability) bool {
	if c.IsAll() {
		return true
	}
	for _, cap := range capabilities {
		if c.Has(cap) {
			return true
		}
	}
	return false
}

// List returns the list of driver capabilities.
// The list is sorted.
func (c DriverCapabilities) List() []string {
	var capabilities []string
	for capability := range c {
		capabilities = append(capabilities, string(capability))
	}
	sort.Strings(capabilities)
	return capabilities
}

// String returns the string repesentation of the driver capabilities.
func (c DriverCapabilities) String() string {
	if c.IsAll() {
		return "all"
	}
	return strings.Join(c.List(), ",")
}

// IsAll indicates whether the set of capabilities is `all`
func (c DriverCapabilities) IsAll() bool {
	return c[DriverCapabilityAll]
}

// Intersection returns a new set which includes the item in BOTH d and s2.
// For example: d = {a1, a2} s2 = {a2, a3} s1.Intersection(s2) = {a2}
func (c DriverCapabilities) Intersection(s2 DriverCapabilities) DriverCapabilities {
	if s2.IsAll() {
		return c
	}
	if c.IsAll() {
		return s2
	}

	intersection := make(DriverCapabilities)
	for capability := range s2 {
		if c[capability] {
			intersection[capability] = true
		}
	}

	return intersection
}

// IsSuperset returns true if and only if d is a superset of s2.
func (c DriverCapabilities) IsSuperset(s2 DriverCapabilities) bool {
	if c.IsAll() {
		return true
	}

	for capability := range s2 {
		if !c[capability] {
			return false
		}
	}

	return true
}