[feature] Add wholearchive

modules/vstudio/vstudio.lua

@@ -367,7 +367,7 @@
 
 	function vstudio.needsExplicitLink(cfg)
 		if not cfg._needsExplicitLink then
-			local ex = cfg.implicitlink == p.OFF
+			local ex = cfg.implicitlink == p.OFF or cfg.wholearchive == p.ON
 			if not ex then
 				local prjdeps = project.getdependencies(cfg.project, "linkOnly")
 				local cfgdeps = config.getlinks(cfg, "dependencies", "object")

src/_premake_init.lua

@@ -1025,6 +1025,16 @@
 		}
 	}
 
+	api.register {
+		name = "wholearchive",
+		scope = "config",
+		kind = "string",
+		allowed = {
+			"Off",
+			"On",
+		}
+	}
+
 	api.register {
 		name = "editorintegration",
 		scope = "workspace",

src/base/config.lua

@@ -260,7 +260,7 @@
 
 		if part == "directory" then
 			table.foreachi(cfg.libdirs, function(dir)
-				table.insert(result, project.getrelative(cfg.project, dir))
+				table.insert(result, p.tools.getrelative(cfg.project, dir))
 			end)
 		end
 
@@ -294,7 +294,7 @@
 					if part == "object" then
 						item = prjcfg
 					else
-						item = project.getrelative(cfg.project, prjcfg.linktarget.fullpath)
+						item = p.tools.getrelative(cfg.project, prjcfg.linktarget.fullpath)
 					end
 
 				end
@@ -309,7 +309,7 @@
 					-- system library or assembly), make it project-relative
 					item = link
 					if item:find("/", nil, true) then
-						item = project.getrelative(cfg.project, item)
+						item = p.tools.getrelative(cfg.project, item)
 					end
 				end
 

src/tools/gcc.lua

@@ -632,6 +632,7 @@
 
 	function gcc.getlinks(cfg, systemonly, nogroups)
 		local result = {}
+		local lib_flag = iif(cfg.system == p.MACOSX and cfg.wholearchive == p.ON, "-force_load ", "-l")
 
 		if not systemonly then
 			if cfg.userelativelinks == p.ON then
@@ -640,7 +641,7 @@
 					if string.startswith(link, "lib") then
 						link = link:sub(4)
 					end
-					table.insert(result, "-l" .. link)
+					table.insert(result, lib_flag .. link)
 				end
 			else
 				-- Don't use the -l form for sibling libraries, since they may have
@@ -666,12 +667,12 @@
 				-- Check whether link mode decorator is present
 				if name:endswith(":static") then
 					name = string.sub(name, 0, -8)
-					table.insert(static_syslibs, "-l" .. name)
+					table.insert(static_syslibs, lib_flag .. name)
 				elseif name:endswith(":shared") then
 					name = string.sub(name, 0, -8)
-					table.insert(shared_syslibs, "-l" .. name)
+					table.insert(shared_syslibs, lib_flag .. name)
 				else
-					table.insert(shared_syslibs, "-l" .. name)
+					table.insert(shared_syslibs, lib_flag .. name)
 				end
 			end
 		end
@@ -691,6 +692,11 @@
 			table.insert(result, "-Wl,--end-group")
 		end
 
+		if cfg.wholearchive == p.ON and cfg.system ~= p.MACOSX and #result > 0 then
+			table.insert(result, 1, "-Wl,--whole-archive")
+			table.insert(result, "-Wl,--no-whole-archive")
+		end
+
 		return result
 	end
 

src/tools/msc.lua

@@ -466,6 +466,11 @@
 			table.insert(links, link)
 		end
 
+		if cfg.wholearchive == p.ON then
+			-- Don't use "/WHOLEARCHIVE" as path.translate might be applied to result
+			links = table.translate(links, function (s) return "-WHOLEARCHIVE:" .. s end)
+		end
+
 		return links
 	end
 

tests/tools/test_gcc.lua

@@ -708,6 +708,21 @@
 		test.contains({ "-lole32" }, gcc.getlinks(cfg))
 	end
 
+	function suite.links_onWholeArchive_onNonMacOSX()
+		system "windows"
+		links { "ole32" }
+		wholearchive "On"
+		prepare()
+		test.contains({ "-Wl,--whole-archive", "-lole32", "-Wl,--no-whole-archive" }, gcc.getlinks(cfg))
+	end
+
+	function suite.links_onWholeArchive_onMacOSX()
+		system "MacOSX"
+		links { "ole32" }
+		wholearchive "On"
+		prepare()
+		test.contains({ "-force_load ole32" }, gcc.getlinks(cfg))
+	end
 
 --
 -- When linking to a static sibling library, the relative path to the library

tests/tools/test_msc.lua

@@ -400,6 +400,22 @@ function suite.cflags_onVs2022IncludeDirsAfter()
 	test.contains("/external:I/usr/local/include", msc.getincludedirs(cfg, cfg.includedirs, cfg.externalincludedirs, cfg.frameworkdirs, cfg.includedirsafter))
 end
 
+--
+-- Check handling of library.
+--
+
+	function suite.links()
+		links { "mylibrary" }
+		prepare()
+		test.contains("mylibrary.lib", msc.getlinks(cfg))
+	end
+
+	function suite.links_wholearchive()
+		links { "mylibrary" }
+		wholearchive "On"
+		prepare()
+		test.contains("-WHOLEARCHIVE:mylibrary.lib", msc.getlinks(cfg))
+	end
 
 --
 -- Check handling of library search paths.

website/docs/Project-API.md

@@ -161,6 +161,7 @@
 | [vectorextensions](vectorextensions.md)                   | Enable hardware vector extensions |
 | [vpaths](vpaths.md)                                       |  |
 | [warnings](warnings.md)                                   |  |
+| [wholearchive](wholearchive.md)                           |  |
 | [workspace](workspace.md)                                 |  |
 
 ### Builtin Extension APIs ###

website/docs/wholearchive.md

@@ -0,0 +1,38 @@
+Apply whole archive flag to linked libraries.
+That would include all their symbols.
+
+```lua
+wholearchive "value"
+```
+
+### Parameters ###
+
+`value` is one of:
+
+| Value   | Description                                       |
+|---------|---------------------------------------------------|
+| On      | Turn on whole archive.                            |
+| Off     | Turn off whole archive.                           |
+
+### Availability ###
+
+Premake 5.0-beta8 or later.
+
+### Examples ###
+
+```lua
+project 'some_library'
+    kind 'StaticLib'
+    defines { 'MAKING_DLL_LIB' } -- for dllexport
+-- ..
+project 'some_dll'
+    kind 'SharedLib'
+    defines { 'MAKING_DLL_LIB' } -- for dllexport
+    links { 'some_library' }
+    wholearchive 'On'
+-- ..
+```
+
+### See Also ###
+
+* [links](links.md)

website/sidebars.js

@@ -300,6 +300,7 @@ module.exports = {
 						'vpaths',
 						'vsprops',
 						'warnings',
+						'wholearchive',
 						'workspace',
 						'wpf',
 						'xcodebuildresources',