Skip injection of GSP firmware by default

This change skips the injection of GSP firmware by default.

An include-gsp-firmware feature flag is added to allow the firmware
paths to be injected if required.

Signed-off-by: Evan Lezar <elezar@nvidia.com>
This commit is contained in:
Evan Lezar 2024-09-16 15:43:23 +02:00
parent 30921c2dae
commit 61057e63d1
7 changed files with 22 additions and 66 deletions

View File

@ -90,6 +90,10 @@ func doPrestart() {
args := []string{getCLIPath(cli)} args := []string{getCLIPath(cli)}
// Only include GSP firmware if explicitly renabled.
if !hook.Features.IncludeGSPFirmware.IsEnabled() {
args = append(args, "--no-gsp-firmware")
}
// Only include the nvidia-persistenced socket if it is explicitly enabled. // Only include the nvidia-persistenced socket if it is explicitly enabled.
if !hook.Features.IncludePersistencedSocket.IsEnabled() { if !hook.Features.IncludePersistencedSocket.IsEnabled() {
args = append(args, "--no-persistenced") args = append(args, "--no-persistenced")

View File

@ -61,6 +61,7 @@ type options struct {
ignorePatterns cli.StringSlice ignorePatterns cli.StringSlice
} }
includeGSPFirmware bool
includePersistencedSocket bool includePersistencedSocket bool
} }
@ -171,6 +172,11 @@ func (m command) build() *cli.Command {
Usage: "Specify a pattern the CSV mount specifications.", Usage: "Specify a pattern the CSV mount specifications.",
Destination: &opts.csv.ignorePatterns, Destination: &opts.csv.ignorePatterns,
}, },
&cli.BoolFlag{
Name: "include-gsp-firmware",
Usage: "Include the GSP firmware in the generated CDI specification.",
Destination: &opts.includeGSPFirmware,
},
&cli.BoolFlag{ &cli.BoolFlag{
Name: "include-persistenced-socket", Name: "include-persistenced-socket",
Usage: "Include the nvidia-persistenced socket in the generated CDI specification.", Usage: "Include the nvidia-persistenced socket in the generated CDI specification.",
@ -280,6 +286,7 @@ func (m command) generateSpec(opts *options) (spec.Interface, error) {
nvcdi.WithLibrarySearchPaths(opts.librarySearchPaths.Value()), nvcdi.WithLibrarySearchPaths(opts.librarySearchPaths.Value()),
nvcdi.WithCSVFiles(opts.csv.files.Value()), nvcdi.WithCSVFiles(opts.csv.files.Value()),
nvcdi.WithCSVIgnorePatterns(opts.csv.ignorePatterns.Value()), nvcdi.WithCSVIgnorePatterns(opts.csv.ignorePatterns.Value()),
nvcdi.WithOptInFeature("include-gsp-firmware", opts.includeGSPFirmware),
nvcdi.WithOptInFeature("include-persistenced-socket", opts.includePersistencedSocket), nvcdi.WithOptInFeature("include-persistenced-socket", opts.includePersistencedSocket),
) )
if err != nil { if err != nil {

View File

@ -24,6 +24,7 @@ const (
FeatureNVSWITCH = featureName("nvswitch") FeatureNVSWITCH = featureName("nvswitch")
FeatureGDRCopy = featureName("gdrcopy") FeatureGDRCopy = featureName("gdrcopy")
FeatureAllowLDConfigFromContainer = featureName("allow-ldconfig-from-container") FeatureAllowLDConfigFromContainer = featureName("allow-ldconfig-from-container")
FeatureIncludeGSPFirmware = featureName("include-gsp-firmware")
FeatureIncludePersistencedSocket = featureName("include-persistenced-socket") FeatureIncludePersistencedSocket = featureName("include-persistenced-socket")
) )
@ -37,6 +38,8 @@ type features struct {
// If this feature flag is not set to 'true' only host-rooted config paths // If this feature flag is not set to 'true' only host-rooted config paths
// (i.e. paths starting with an '@' are considered valid) // (i.e. paths starting with an '@' are considered valid)
AllowLDConfigFromContainer *feature `toml:"allow-ldconfig-from-container,omitempty"` AllowLDConfigFromContainer *feature `toml:"allow-ldconfig-from-container,omitempty"`
// IncludeGSPFirmware enables the injection of GSP firmware into containers.
IncludeGSPFirmware *feature `toml:"include-gsp-firmware,omitempty"`
// IncludePersistencedSocket enables the injection of the nvidia-persistenced // IncludePersistencedSocket enables the injection of the nvidia-persistenced
// socket into containers. // socket into containers.
IncludePersistencedSocket *feature `toml:"include-persistenced-socket,omitempty"` IncludePersistencedSocket *feature `toml:"include-persistenced-socket,omitempty"`
@ -61,6 +64,8 @@ func (fs features) IsEnabledInEnvironment(n featureName, in ...getenver) bool {
// Features without envvar overrides // Features without envvar overrides
case FeatureAllowLDConfigFromContainer: case FeatureAllowLDConfigFromContainer:
return fs.AllowLDConfigFromContainer.IsEnabled() return fs.AllowLDConfigFromContainer.IsEnabled()
case FeatureIncludeGSPFirmware:
return fs.IncludeGSPFirmware.IsEnabled()
case FeatureIncludePersistencedSocket: case FeatureIncludePersistencedSocket:
return fs.IncludePersistencedSocket.IsEnabled() return fs.IncludePersistencedSocket.IsEnabled()
default: default:

View File

@ -189,6 +189,7 @@ func generateAutomaticCDISpec(logger logger.Interface, cfg *config.Config, devic
nvcdi.WithDriverRoot(cfg.NVIDIAContainerCLIConfig.Root), nvcdi.WithDriverRoot(cfg.NVIDIAContainerCLIConfig.Root),
nvcdi.WithVendor("runtime.nvidia.com"), nvcdi.WithVendor("runtime.nvidia.com"),
nvcdi.WithClass("gpu"), nvcdi.WithClass("gpu"),
nvcdi.WithOptInFeature("include-gsp-firmware", cfg.Features.IncludeGSPFirmware.IsEnabled()),
nvcdi.WithOptInFeature("include-persistenced-socket", cfg.Features.IncludePersistencedSocket.IsEnabled()), nvcdi.WithOptInFeature("include-persistenced-socket", cfg.Features.IncludePersistencedSocket.IsEnabled()),
) )
if err != nil { if err != nil {

View File

@ -18,12 +18,10 @@ package nvcdi
import ( import (
"fmt" "fmt"
"os"
"path/filepath" "path/filepath"
"strings" "strings"
"github.com/NVIDIA/go-nvml/pkg/nvml" "github.com/NVIDIA/go-nvml/pkg/nvml"
"golang.org/x/sys/unix"
"github.com/NVIDIA/nvidia-container-toolkit/internal/discover" "github.com/NVIDIA/nvidia-container-toolkit/internal/discover"
"github.com/NVIDIA/nvidia-container-toolkit/internal/logger" "github.com/NVIDIA/nvidia-container-toolkit/internal/logger"
@ -63,7 +61,7 @@ func (l *nvcdilib) newDriverVersionDiscoverer(version string) (discover.Discover
return nil, fmt.Errorf("failed to create discoverer for IPC sockets: %v", err) return nil, fmt.Errorf("failed to create discoverer for IPC sockets: %v", err)
} }
firmwares, err := NewDriverFirmwareDiscoverer(l.logger, l.driver.Root, version) firmwares, err := l.newDriverFirmwareDiscoverer(l.logger, l.driver.Root, version)
if err != nil { if err != nil {
return nil, fmt.Errorf("failed to create discoverer for GSP firmware: %v", err) return nil, fmt.Errorf("failed to create discoverer for GSP firmware: %v", err)
} }
@ -107,67 +105,6 @@ func NewDriverLibraryDiscoverer(logger logger.Interface, driver *root.Driver, nv
return d, nil return d, nil
} }
func getUTSRelease() (string, error) {
utsname := &unix.Utsname{}
if err := unix.Uname(utsname); err != nil {
return "", err
}
return unix.ByteSliceToString(utsname.Release[:]), nil
}
func getFirmwareSearchPaths(logger logger.Interface) ([]string, error) {
var firmwarePaths []string
if p := getCustomFirmwareClassPath(logger); p != "" {
logger.Debugf("using custom firmware class path: %s", p)
firmwarePaths = append(firmwarePaths, p)
}
utsRelease, err := getUTSRelease()
if err != nil {
return nil, fmt.Errorf("failed to get UTS_RELEASE: %v", err)
}
standardPaths := []string{
filepath.Join("/lib/firmware/updates/", utsRelease),
"/lib/firmware/updates/",
filepath.Join("/lib/firmware/", utsRelease),
"/lib/firmware/",
}
return append(firmwarePaths, standardPaths...), nil
}
// getCustomFirmwareClassPath returns the custom firmware class path if it exists.
func getCustomFirmwareClassPath(logger logger.Interface) string {
customFirmwareClassPath, err := os.ReadFile("/sys/module/firmware_class/parameters/path")
if err != nil {
logger.Warningf("failed to get custom firmware class path: %v", err)
return ""
}
return strings.TrimSpace(string(customFirmwareClassPath))
}
// NewDriverFirmwareDiscoverer creates a discoverer for GSP firmware associated with the specified driver version.
func NewDriverFirmwareDiscoverer(logger logger.Interface, driverRoot string, version string) (discover.Discover, error) {
gspFirmwareSearchPaths, err := getFirmwareSearchPaths(logger)
if err != nil {
return nil, fmt.Errorf("failed to get firmware search paths: %v", err)
}
gspFirmwarePaths := filepath.Join("nvidia", version, "gsp*.bin")
return discover.NewMounts(
logger,
lookup.NewFileLocator(
lookup.WithLogger(logger),
lookup.WithRoot(driverRoot),
lookup.WithSearchPaths(gspFirmwareSearchPaths...),
),
driverRoot,
[]string{gspFirmwarePaths},
), nil
}
// NewDriverBinariesDiscoverer creates a discoverer for GSP firmware associated with the GPU driver. // NewDriverBinariesDiscoverer creates a discoverer for GSP firmware associated with the GPU driver.
func NewDriverBinariesDiscoverer(logger logger.Interface, driverRoot string) discover.Discover { func NewDriverBinariesDiscoverer(logger logger.Interface, driverRoot string) discover.Discover {
return discover.NewMounts( return discover.NewMounts(

View File

@ -31,7 +31,7 @@ import (
// newDriverFirmwareDiscoverer creates a discoverer for GSP firmware associated with the specified driver version. // newDriverFirmwareDiscoverer creates a discoverer for GSP firmware associated with the specified driver version.
func (l *nvcdilib) newDriverFirmwareDiscoverer(logger logger.Interface, driverRoot string, version string) (discover.Discover, error) { func (l *nvcdilib) newDriverFirmwareDiscoverer(logger logger.Interface, driverRoot string, version string) (discover.Discover, error) {
if !l.optInFeatures["allow-gsp-firmware"] { if !l.optInFeatures["include-gsp-firmware"] {
return discover.None{}, nil return discover.None{}, nil
} }

View File

@ -69,7 +69,9 @@ type nvcdilib struct {
// New creates a new nvcdi library // New creates a new nvcdi library
func New(opts ...Option) (Interface, error) { func New(opts ...Option) (Interface, error) {
l := &nvcdilib{} l := &nvcdilib{
optInFeatures: make(map[string]bool),
}
for _, opt := range opts { for _, opt := range opts {
opt(l) opt(l)
} }