[projmgr] Add support for link: whole-archive feature

Author: grasci-arm

tools/projmgr/include/ProjMgrParser.h

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-2025 Arm Limited. All rights reserved.
+ * Copyright (c) 2020-2026 Arm Limited. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -439,6 +439,7 @@ struct YamlMark {
  *        file path,
  *        for compiler control,
  *        file category,
+ *        link directives,
  *        file build settings,
  *        type filter,
  *        yaml mark
@@ -447,9 +448,10 @@ struct FileNode {
   std::string file;
   std::vector<std::string> forCompiler;
   std::string category;
+  std::string link;
   BuildType build;
   TypeFilter type;
-  YamlMark mark;
+  YamlMark mark;;
 };
 
 /**

tools/projmgr/include/ProjMgrYamlParser.h

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-2025 Arm Limited. All rights reserved.
+ * Copyright (c) 2020-2026 Arm Limited. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -148,6 +148,7 @@ static constexpr const char* YAML_LOAD_OFFSET = "load-offset";
 static constexpr const char* YAML_LICENSE = "license";
 static constexpr const char* YAML_LICENSES = "licenses";
 static constexpr const char* YAML_LICENSE_AGREEMENT = "license-agreement";
+static constexpr const char* YAML_LINK = "link";
 static constexpr const char* YAML_LINKER = "linker";
 static constexpr const char* YAML_LINK_TIME_OPTIMIZE = "link-time-optimize";
 static constexpr const char* YAML_MAP = "map";

tools/projmgr/schemas/common.schema.json

@@ -264,6 +264,11 @@
       "type": ["null", "boolean"],
       "description": "Enable Link Time Optimization (LTO)"
     },
+    "LinkDirectiveType": {
+      "title": "link:",
+      "enum": [ "whole-archive" ],
+      "description": "Link directive: whole-archive instructs the linker to include the entire library"
+    },
     "DebugType": {
       "title": "debug:\nDocumentation: https://open-cmsis-pack.github.io/cmsis-toolbox/YML-Input-Format/#debug",
       "enum": [ "on", "off" ],
@@ -864,7 +869,6 @@
       "description": "The file attribute defines the special handling in the project when being used as configuration or template file."
     },
     "FileLanguageType": {
-      "title": "languange:",
       "enum": [ "asm", "c", "cpp", "c-cpp", "link" ],
       "description": "File language attribute type defines the language for source, header and include file categories. Based on the language the information is used by language specific build tools."
     },
@@ -882,7 +886,7 @@
         },
         "add-path":        { "$ref": "#/definitions/AddpathsType" },
         "add-path-asm":    { "$ref": "#/definitions/AddAsmPathsType" },
-        "attr":            { "title": "attr:", "$ref": "#/definitions/FileAttributeType" },
+        "attr":            { "$ref": "#/definitions/FileAttributeType" },
         "base": {
           "title": "base:",
           "type": "string",
@@ -904,6 +908,7 @@
         "language":        { "$ref": "#/definitions/FileLanguageType" },
         "language-C":      { "$ref": "#/definitions/LanguageCType" },
         "language-CPP":    { "$ref": "#/definitions/LanguageCppType" },
+        "link":            { "$ref": "#/definitions/LinkDirectiveType" },
         "link-time-optimize": { "$ref": "#/definitions/LinkTimeOptimizeType" },
         "misc":            { "$ref": "#/definitions/MiscTypes" },
         "not-for-context": { "$ref": "#/definitions/NotForContext" },

tools/projmgr/src/ProjMgrCbuild.cpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-2025 Arm Limited. All rights reserved.
+ * Copyright (c) 2020-2026 Arm Limited. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -362,6 +362,7 @@ void ProjMgrCbuild::SetFilesNode(YAML::Node node, const ContextItem* context, co
     RteFsUtils::NormalizePath(fileName, context->directories.cprj);
     SetNodeValue(fileNode[YAML_FILE], FormatPath(fileName, context->directories.cbuild));
     SetNodeValue(fileNode[YAML_CATEGORY], file.category.empty() ? RteFsUtils::FileCategoryFromExtension(file.file) : file.category);
+    SetNodeValue(fileNode[YAML_LINK], file.link);
     SetControlsNode(fileNode, context, file.build);
     node.push_back(fileNode);
   }

tools/projmgr/src/ProjMgrYamlParser.cpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-2025 Arm Limited. All rights reserved.
+ * Copyright (c) 2020-2026 Arm Limited. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -774,6 +774,7 @@ bool ProjMgrYamlParser::ParseFiles(const YAML::Node& parent, const string& file,
       ParsePortablePath(fileEntry, file, YAML_FILE, fileItem.file);
       ParseVectorOrString(fileEntry, YAML_FORCOMPILER, fileItem.forCompiler);
       ParseString(fileEntry, YAML_CATEGORY, fileItem.category);
+      ParseString(fileEntry, YAML_LINK, fileItem.link);
       if (!ParseBuildType(fileEntry, file, fileItem.build)) {
         return false;
       }
@@ -1475,6 +1476,7 @@ const set<string> filesKeys = {
   YAML_LANGUAGE_C,
   YAML_LANGUAGE_CPP,
   YAML_LINK_TIME_OPTIMIZE,
+  YAML_LINK,
   YAML_DEFINE,
   YAML_DEFINE_ASM,
   YAML_UNDEFINE,

tools/projmgr/test/data/TestLinkLib/lib.a

@@ -0,0 +1 @@
+/* Dummy */

tools/projmgr/test/data/TestLinkLib/main.c

@@ -0,0 +1 @@
+/* Dummy */

tools/projmgr/test/data/TestLinkLib/project.cproject.yml

@@ -0,0 +1,14 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Open-CMSIS-Pack/devtools/main/tools/projmgr/schemas/cproject.schema.json
+
+project:
+
+  components:
+    - component: CORE
+    - component: Startup
+
+  groups:
+    - group: Source
+      files:
+        - file: lib.a
+          link: whole-archive
+        - file: main.c

tools/projmgr/test/data/TestLinkLib/solution.csolution.yml

@@ -0,0 +1,15 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Open-CMSIS-Pack/devtools/main/tools/projmgr/schemas/csolution.schema.json
+
+solution:
+
+  compiler: AC6
+
+  target-types:
+    - type: CM0
+      device: RteTest_ARMCM0
+
+  projects:
+    - project: project.cproject.yml
+
+  packs:
+    - pack: ARM::RteTest_DFP

tools/projmgr/test/src/ProjMgrUnitTests.cpp

@@ -7225,6 +7225,17 @@ TEST_F(ProjMgrUnitTests, LinkTimeOptimize) {
   EXPECT_TRUE(cbuild["build"]["groups"][0]["files"][0]["link-time-optimize"].IsDefined());
 }
 
+TEST_F(ProjMgrUnitTests, LinkWholeArchive) {
+  char* argv[3];
+  const string& csolution = testinput_folder + "/TestLinkLib/solution.csolution.yml";
+  argv[1] = (char*)"convert";
+  argv[2] = (char*)csolution.c_str();
+  EXPECT_EQ(0, RunProjMgr(3, argv, m_envp));
+  const YAML::Node& cbuild = YAML::LoadFile(testinput_folder + "/TestLinkLib/out/project/CM0/project+CM0.cbuild.yml");
+  EXPECT_EQ("library", cbuild["build"]["groups"][0]["files"][0]["category"].as<string>());
+  EXPECT_EQ("whole-archive", cbuild["build"]["groups"][0]["files"][0]["link"].as<string>());
+}
+
 TEST_F(ProjMgrUnitTests, ImageOnly) {
   char* argv[5];
   const string& csolution = testinput_folder + "/ImageOnly/image-only.csolution.yml";