feat: host NVIDIA driver fallback

Author: guanzi008

apps/ll-cli/src/main.cpp

@@ -607,6 +607,44 @@ void addInspectCommand(CLI::App &commandParser,
       ->check(validatorString);
 }
 
+// Function to add the extension subcommand
+void addExtensionCommand(CLI::App &commandParser,
+                         ExtensionOptions &extensionOptions,
+                         const std::string &group)
+{
+    auto *cliExtension =
+      commandParser.add_subcommand("extension", _("Manage extension overrides"))
+        ->group(group)
+        ->usage(_("Usage: ll-cli extension SUBCOMMAND [OPTIONS]"));
+
+    cliExtension->require_subcommand(1);
+
+    auto *cliImportCdi =
+      cliExtension
+        ->add_subcommand("import-cdi", _("Import CDI rules into extension overrides"))
+        ->usage(_("Usage: ll-cli extension import-cdi [OPTIONS]"));
+    cliImportCdi
+      ->add_option("--name",
+                   extensionOptions.name,
+                   _("Specify extension name prefix to update"))
+      ->type_name("NAME")
+      ->check(validatorString);
+    cliImportCdi
+      ->add_option("--config",
+                   extensionOptions.configPath,
+                   _("Specify config path (default: ~/.config/linglong/config.json)"))
+      ->type_name("FILE");
+    cliImportCdi
+      ->add_option("--cdi",
+                   extensionOptions.cdiPath,
+                   _("Specify CDI JSON path (default: nvidia-ctk cdi generate --format json)"))
+      ->type_name("FILE");
+    cliImportCdi
+      ->add_flag("--apply-when-installed",
+                 extensionOptions.applyWhenInstalled,
+                 _("Apply overrides even when extension is installed"));
+}
+
 } // namespace
 
 using namespace linglong::utils::global;
@@ -690,12 +728,14 @@ You can report bugs to the linyaps team under this project: https://github.com/O
     ContentOptions contentOptions{};
     RepoOptions repoOptions{};
     InspectOptions inspectOptions{};
+    ExtensionOptions extensionOptions{};
 
     // groups for subcommands
     auto *CliBuildInGroup = _("Managing installed applications and runtimes");
     auto *CliAppManagingGroup = _("Managing running applications");
     auto *CliSearchGroup = _("Finding applications and runtimes");
     auto *CliRepoGroup = _("Managing remote repositories");
+    auto *CliExtensionGroup = _("Managing extensions");
 
     // add all subcommands using the new functions
     addRunCommand(commandParser, runOptions, CliAppManagingGroup);
@@ -712,6 +752,7 @@ You can report bugs to the linyaps team under this project: https://github.com/O
     addContentCommand(commandParser, contentOptions, CliBuildInGroup);
     addPruneCommand(commandParser, CliAppManagingGroup);
     addInspectCommand(commandParser, inspectOptions, CliHiddenGroup);
+    addExtensionCommand(commandParser, extensionOptions, CliExtensionGroup);
 
     auto res = transformOldExec(argc, argv);
     CLI11_PARSE(commandParser, std::move(res));
@@ -920,6 +961,8 @@ You can report bugs to the linyaps team under this project: https://github.com/O
         result = cli->inspect(*ret, inspectOptions);
     } else if (name == "repo") {
         result = cli->repo(*ret, repoOptions);
+    } else if (name == "extension") {
+        result = cli->extension(*ret, extensionOptions);
     } else {
         // if subcommand name is not found, print help
         std::cout << commandParser.help("", CLI::AppFormatMode::All);

docs/pages/en/guide/reference/driver.md

@@ -20,6 +20,6 @@ The base that applications depend on already includes the appropriate version of
 
 Drivers not included in the base that require additional installation:
 
-- NVIDIA proprietary drivers: Install via `sudo ll-cli install org.deepin.driver.display.nvidia.570-124-04`. The `570-124-04` is the driver version number, which must match the driver version installed on the host system. Check the host driver version through the `/sys/module/nvidia/version` file.
+- NVIDIA proprietary drivers: Install via `sudo ll-cli install org.deepin.driver.display.nvidia.570-124-04`. The `570-124-04` is the driver version number, which must match the driver version installed on the host system. Check the host driver version through the `/sys/module/nvidia/version` file. If the extension is not installed, linyaps will attempt to link NVIDIA driver files from the host at runtime.
 - Glenfly graphics drivers: Install via `sudo ll-cli install com.glenfly.driver.display.arise`.
 - Intel video codec drivers (VAAPI): Install via `sudo ll-cli install org.deepin.driver.media.intel`, which includes support for both new and legacy Intel graphics cards.

docs/pages/guide/reference/driver.md

@@ -20,6 +20,6 @@
 
 不在 base 中携带的，需要额外安装的驱动：
 
-- 英伟达闭源驱动，通过 `sudo ll-cli install org.deepin.driver.display.nvidia.570-124-04` 安装。其中 `570-124-04` 是驱动版本号，需要与宿主机安装的驱动版本匹配，通过宿主机 `/sys/module/nvidia/version` 文件查看宿主机驱动的版本。
+- 英伟达闭源驱动，推荐通过 `sudo ll-cli install org.deepin.driver.display.nvidia.570-124-04` 安装。其中 `570-124-04` 是驱动版本号，需要与宿主机安装的驱动版本匹配，通过宿主机 `/sys/module/nvidia/version` 文件查看宿主机驱动的版本。未安装扩展时，linyaps 会在运行时尝试从宿主机自动链接 NVIDIA 驱动文件。
 - 格兰菲显卡驱动，通过 `sudo ll-cli install com.glenfly.driver.display.arise` 安装。
 - 英特尔视频编解码驱动（VAAPI），通过 `sudo ll-cli install org.deepin.driver.media.intel` 安装，包含了新/旧 Intel 显卡的支持。

libs/linglong/CMakeLists.txt

@@ -29,12 +29,16 @@ pfl_add_library(
   src/linglong/cli/dbus_notifier.h
   src/linglong/cli/dummy_notifier.cpp
   src/linglong/cli/dummy_notifier.h
+  src/linglong/cli/extension_override.cpp
+  src/linglong/cli/extension_override.h
   src/linglong/cli/interactive_notifier.h
   src/linglong/cli/json_printer.cpp
   src/linglong/cli/json_printer.h
   src/linglong/cli/printer.h
   src/linglong/cli/terminal_notifier.cpp
   src/linglong/cli/terminal_notifier.h
+  src/linglong/extension/cdi.cpp
+  src/linglong/extension/cdi.h
   src/linglong/extension/extension.cpp
   src/linglong/extension/extension.h
   src/linglong/package/architecture.cpp
@@ -94,6 +98,7 @@ pfl_add_library(
   src/linglong/runtime/container_builder.h
   src/linglong/runtime/container.cpp
   src/linglong/runtime/container.h
+  src/linglong/runtime/host_nvidia_fallback.cpp
   src/linglong/runtime/run_context.cpp
   src/linglong/runtime/run_context.h
   src/linglong/runtime/security_context.cpp

libs/linglong/src/linglong/cli/cli.cpp

@@ -25,6 +25,7 @@
 #include "linglong/api/types/v1/State.hpp"
 #include "linglong/api/types/v1/UpgradeListResult.hpp"
 #include "linglong/cli/printer.h"
+#include "linglong/cli/extension_override.h"
 #include "linglong/common/dir.h"
 #include "linglong/common/strings.h"
 #include "linglong/oci-cfg-generators/container_cfg_builder.h"
@@ -58,7 +59,9 @@
 #include <cstdint>
 #include <cstdlib>
 #include <filesystem>
+#include <fstream>
 #include <iostream>
+#include <map>
 #include <optional>
 #include <system_error>
 #include <thread>
@@ -519,10 +522,21 @@ int Cli::run(const RunOptions &options)
     linglong::runtime::ResolveOptions opts;
     opts.baseRef = options.base;
     opts.runtimeRef = options.runtime;
-    // 处理多个扩展
     if (!options.extensions.empty()) {
         opts.extensionRefs = options.extensions;
     }
+    auto configPath = extension_override::getUserConfigPath();
+    if (configPath) {
+        auto overrides = extension_override::loadOverrides(*configPath);
+        if (overrides) {
+            if (!overrides->empty()) {
+                runContext.setExtensionOverrides(std::move(*overrides));
+            }
+        } else {
+            qWarning() << "failed to load extension overrides:"
+                       << overrides.error().message().c_str();
+        }
+    }
 
     // 调整日志输出，打印扩展列表（用逗号拼接）
     std::string extStr =
@@ -2327,6 +2341,21 @@ int Cli::inspect(CLI::App *app, const InspectOptions &options)
     return 0;
 }
 
+int Cli::extension(CLI::App *app, const ExtensionOptions &options)
+{
+    LINGLONG_TRACE("command extension");
+
+    auto argsParseFunc = [&app](const std::string &name) -> bool {
+        return app->get_subcommand(name)->parsed();
+    };
+
+    if (argsParseFunc("import-cdi")) {
+        return importCdi(options);
+    }
+
+    return 0;
+}
+
 int Cli::getLayerDir(const InspectOptions &options)
 {
     LINGLONG_TRACE("Get Layer dir");
@@ -2388,6 +2417,35 @@ int Cli::getBundleDir(const InspectOptions &options)
     return 0;
 }
 
+int Cli::importCdi(const ExtensionOptions &options)
+{
+    LINGLONG_TRACE("import CDI config");
+
+    std::filesystem::path configPath;
+    if (options.configPath) {
+        configPath = *options.configPath;
+    } else {
+        auto userConfigPath = extension_override::getUserConfigPath();
+        if (!userConfigPath) {
+            this->printer.printErr(LINGLONG_ERRV("failed to resolve user config path"));
+            return -1;
+        }
+        configPath = *userConfigPath;
+    }
+
+    auto res = extension_override::importCdiOverrides(configPath,
+                                                      options.cdiPath,
+                                                      options.name,
+                                                      !options.applyWhenInstalled);
+    if (!res) {
+        this->printer.printErr(res.error());
+        return -1;
+    }
+
+    this->printer.printMessage("CDI config imported into " + configPath.string());
+    return 0;
+}
+
 utils::error::Result<void> Cli::initInteraction()
 {
     LINGLONG_TRACE("initInteraction");

libs/linglong/src/linglong/cli/cli.h

@@ -134,6 +134,14 @@ struct InspectOptions
     std::string dirType{ "layer" };
 };
 
+struct ExtensionOptions
+{
+    std::optional<std::string> configPath;
+    std::optional<std::string> cdiPath;
+    std::string name{ "org.deepin.driver.display.nvidia" };
+    bool applyWhenInstalled{ false };
+};
+
 enum class TaskType : int {
     None,
     Install,
@@ -186,6 +194,7 @@ class Cli : public QObject
     int content(const ContentOptions &options);
     int prune();
     int inspect(CLI::App *subcommand, const InspectOptions &options);
+    int extension(CLI::App *subcommand, const ExtensionOptions &options);
 
     void cancelCurrentTask();
 
@@ -225,6 +234,7 @@ class Cli : public QObject
     std::vector<std::string> getRunningAppContainers(const std::string &appid);
     int getLayerDir(const InspectOptions &options);
     int getBundleDir(const InspectOptions &options);
+    int importCdi(const ExtensionOptions &options);
     utils::error::Result<void> initInteraction();
     void detectDrivers();