feat(utils): add std::error_code overloads for mknodat and symlink_at

Callers can opt into error_code path to avoid exception overhead
on non-critical paths (e.g. best-effort device/symlink creation).

Author: ComixHe

src/linyaps_box/utils/mknod.cpp

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2022-2025 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2022 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 
@@ -16,8 +16,25 @@ void linyaps_box::utils::mknodat(const file_descriptor &root,
 {
     LINYAPS_BOX_DEBUG() << "Create device " << path.string() << " with mode " << mode << " and dev "
                         << dev;
+
     if (::mknodat(root.get(), path.c_str(), mode, dev) == 0) {
         return;
     }
     throw std::system_error(errno, std::system_category(), "mknodat");
 }
+
+void linyaps_box::utils::mknodat(const file_descriptor &root,
+                                 const std::filesystem::path &path,
+                                 mode_t mode,
+                                 dev_t dev,
+                                 std::error_code &ec) noexcept
+{
+    LINYAPS_BOX_DEBUG() << "Create device " << path.string() << " with mode " << mode << " and dev "
+                        << dev;
+
+    ec.clear();
+    if (::mknodat(root.get(), path.c_str(), mode, dev) == 0) {
+        return;
+    }
+    ec.assign(errno, std::system_category());
+}

src/linyaps_box/utils/mknod.h

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2022-2025 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2022 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 
@@ -15,4 +15,10 @@ void mknodat(const file_descriptor &root,
              const std::filesystem::path &path,
              mode_t mode,
              dev_t dev);
+
+void mknodat(const file_descriptor &root,
+             const std::filesystem::path &path,
+             mode_t mode,
+             dev_t dev,
+             std::error_code &ec) noexcept;
 } // namespace linyaps_box::utils

src/linyaps_box/utils/symlink.cpp

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2025 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2025 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 
@@ -9,8 +9,6 @@
 
 #include <linux/limits.h>
 
-#include <array>
-
 void linyaps_box::utils::symlink(const std::filesystem::path &target,
                                  const std::filesystem::path &link_path)
 {
@@ -36,6 +34,21 @@ void linyaps_box::utils::symlink_at(const std::filesystem::path &target,
     }
 }
 
+void linyaps_box::utils::symlink_at(const std::filesystem::path &target,
+                                    const file_descriptor &dirfd,
+                                    const std::filesystem::path &link_path,
+                                    std::error_code &ec) noexcept
+{
+    LINYAPS_BOX_DEBUG() << "Create symlink " << link_path << " which under " << dirfd.current_path()
+                        << " point to " << target;
+
+    ec.clear();
+    const auto ret = ::symlinkat(target.c_str(), dirfd.get(), link_path.c_str());
+    if (ret == -1) {
+        ec.assign(errno, std::system_category());
+    }
+}
+
 std::filesystem::path linyaps_box::utils::readlink(const std::filesystem::path &path)
 {
     std::error_code ec;

src/linyaps_box/utils/symlink.h

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2025 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2025 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 
@@ -16,6 +16,11 @@ void symlink_at(const std::filesystem::path &target,
                 const file_descriptor &dirfd,
                 const std::filesystem::path &link_path);
 
+void symlink_at(const std::filesystem::path &target,
+                const file_descriptor &dirfd,
+                const std::filesystem::path &link_path,
+                std::error_code &ec) noexcept;
+
 std::filesystem::path readlink(const std::filesystem::path &path);
 
 std::filesystem::path readlinkat(const file_descriptor &dirfd, const std::filesystem::path &path);