Config.kmk@ 106905

Last change on this file since 106905 was 106905, checked in by vboxsync, 3 weeks ago
/Config.kmk: VBOX_XMLLINT/VBOX_HAVE_XMLLINT confusion. jiraref:VBP-1253
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 439.8 KB

Line
1	# $Id: Config.kmk 106905 2024-11-09 01:43:34Z vboxsync $
2	## @file
3	# The global build configuration file for VBox.
4	#
5	# This file gets included by all makefiles through the
6	# include $(KBUILD_PATH)/header.kmk statement.
7	#
8
9	#
10	# Copyright (C) 2006-2024 Oracle and/or its affiliates.
11	#
12	# This file is part of VirtualBox base platform packages, as
13	# available from https://www.virtualbox.org.
14	#
15	# This program is free software; you can redistribute it and/or
16	# modify it under the terms of the GNU General Public License
17	# as published by the Free Software Foundation, in version 3 of the
18	# License.
19	#
20	# This program is distributed in the hope that it will be useful, but
21	# WITHOUT ANY WARRANTY; without even the implied warranty of
22	# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
23	# General Public License for more details.
24	#
25	# You should have received a copy of the GNU General Public License
26	# along with this program; if not, see <https://www.gnu.org/licenses>.
27	#
28	# SPDX-License-Identifier: GPL-3.0-only
29	#
30
31	# Marker.
32	VBOX_ROOT_CONFIG_KMK_INCLUDED = 1
33
34	#
35	# kBuild stuff
36	#
37
38	# Build with umask 022 (requires kBuild r2556 to work, harmless on earlier).
39	$(set-umask 022)
40
41	# Add our own directories to the search paths.
42	KBUILD_TOOL_PATHS = $(KBUILD_DEVTOOLS)/kBuildTools/
43	KBUILD_UNIT_PATHS = $(KBUILD_DEVTOOLS)/kBuildUnits/
44
45	# Modify the build types.
46	KBUILD_BLD_TYPES = release profile debug kprofile
47
48	## 'strict' builds
49	# Same as release builds, except that RT_STRICT and VBOX_STRICT are defined,
50	# meaning all assertions are in action. (Appending means '.strict' props take
51	# precedence in argument lists.)
52	KBUILD_BLD_TYPES += strict
53	BLD_TYPE_strict_EXTENDS = release
54	BLD_TYPE_strict_EXTENDS_BY = appending
55
56	## 'asan' builds
57	# Same as release builds, except that some form of address sanitizer (e.g.
58	# VBOX_WITH_GCC_SANITIZER=1 or VBOX_WITH_EF_WRAPS) is enabled. In addition
59	# RT_STRICT and VBOX_STRICT are defined so assertions and sanity checks will
60	# also be enabled (mainly for not needing to build+test strict builds separately).
61	KBUILD_BLD_TYPES += asan
62	BLD_TYPE_asan_EXTENDS = release
63	BLD_TYPE_asan_EXTENDS_BY = appending
64
65	## 'dbgopt' builds
66	# Same as debug builds, except that compiler optimizations are enabled. This
67	# intended for cases where all the debug facitities (logging, assertions, ++)
68	# is wanted but actual source level debugging as important as execution speed.
69	KBUILD_BLD_TYPES += dbgopt
70	BLD_TYPE_dbgopt_EXTENDS = debug
71	BLD_TYPE_dbgopt_EXTENDS_BY = overriding
72
73	## 'parfait' builds
74	# Same as release builds, except that the result is prepared for static code
75	# analysis by parfait.
76	KBUILD_BLD_TYPES += parfait
77	BLD_TYPE_parfait_EXTENDS = release
78	BLD_TYPE_parfait_EXTENDS_BY = appending
79
80	## 'parfait-dbg' builds
81	# Same as debug builds, except that the result is prepared for static code
82	# analysis by parfait.
83	KBUILD_BLD_TYPES += parfait-dbg
84	BLD_TYPE_parfait-dbg_EXTENDS = debug
85	BLD_TYPE_parfait-dbg_EXTENDS_BY = appending
86
87	# Temporary hack for kBuild ticket #83.
88	## @todo kBuild: remove after closing ticket #83.
89	PROPS_ACCUMULATE_L_LNK += INTERMEDIATES
90	PROPS_PROGRAMS_ACCUMULATE_L += INTERMEDIATES
91	PROPS_LIBRARIES_ACCUMULATE_L += INTERMEDIATES
92	PROPS_DLLS_ACCUMULATE_L += INTERMEDIATES
93	PROPS_SYSMODS_ACCUMULATE_L += INTERMEDIATES
94	PROPS_MISCBINS_ACCUMULATE_L += INTERMEDIATES
95
96	# Some info on the vendor
97	VBOX_VENDOR = Oracle and/or its affiliates
98	VBOX_VENDOR_SHORT = Oracle
99	VBOX_PRODUCT = $(VBOX_VENDOR_SHORT) VirtualBox
100	VBOX_PUEL_PRODUCT = $(VBOX_PRODUCT) Extension Pack
101	# Not all could be done automatically. Here is a list of known places which
102	# have to be updated manually, please keep this up to date:
103	# src/VBox/Devices/PC/PXE/client/uinit.asm
104	# src/VBox/RDP/webclient/flash/com/sun/network/rdp/Version.as
105	# src/VBox/Frontends/VirtualBox/src/globals/UICommon.cpp
106	# src/VBox/Frontends/VirtualBox/src/settings/global/VBoxGLSettingsLanguage.cpp
107	# src/VBox/Frontends/VirtualBox/nls/*.ts
108	# debian/control
109	# src/VBox/Installer/linux/{debian,rpm}
110	# src/VBox/Installer/linux/virtualbox.desktop
111	# src/VBox/Additions/WINNT/Installer/ISO/ReadmeDrivers.txt
112	# src/VBox/Main/nls/*.ts
113	# src/VBox/ExtPacks/Puel/nls/*.ts
114	# src/VBox/Frontends/VBoxManage/nls/*.ts
115	# /.inf, /.rc
116
117	# Misc names used by the install paths below.
118	VBOX_PUEL_MANGLED_NAME = $(subst $(SP),_,$(VBOX_PUEL_PRODUCT))
119
120	# Install paths
121	## @todo This will change after 4.1 is branched off!
122	# What is now 'bin' and 'lib' will be moved down under 'staged/', except on
123	# darwin where it's currently called 'dist' which will be renamed to 'staged'.
124	# When running 'kmk install' files will be copied to 'dist/', on unix systems
125	# this will be done in FHS fashion assuming /usr/local or /usr as 'prefix'.
126	#
127	# Changes related to this are marked VBOX_WITH_NEW_LAYOUT.
128	ifndef VBOX_WITH_NEW_LAYOUT
129	PATH_INS = $(PATH_OUT)/dist
130	PATH_STAGE = $(PATH_OUT)
131	INST_DEBUG := stage/debug/
132	endif
133
134	ifeq ($(KBUILD_TARGET),darwin)
135	ifndef VBOX_WITH_NEW_LAYOUT
136	INST_DIST = dist/
137	else
138	INST_DIST :=
139	endif
140	INST_SDK = $(INST_DIST)sdk/
141
142	# the bundles
143	INST_VIRTUALBOX = $(INST_DIST)VirtualBox.app/
144	INST_VBOXDRV = $(INST_DIST)VBoxDrv.kext/
145	INST_VBOXNETFLT = $(INST_DIST)VBoxNetFlt.kext/
146	INST_VBOXNETADP = $(INST_DIST)VBoxNetAdp.kext/
147	INST_VBOXUSB = $(INST_DIST)VBoxUSB.kext/
148
149	# put everything in the VirtualBox app bundle.
150	INST_BIN = $(INST_VIRTUALBOX)Contents/MacOS/
151	INST_DLL = $(INST_BIN)
152	INST_SYS = $(INST_BIN)
153	INST_TESTCASE = $(INST_BIN)testcase/
154	INST_ADDITIONS = $(INST_DIST)additions/
155	INST_ADDITIONS_ISO = $(INST_BIN)
156	INST_UNATTENDED_TEMPLATES = $(INST_BIN)UnattendedTemplates/
157
158	INST_VBOXDBG_SYMS = $(INST_VIRTUALBOX)Contents/Resources/VBoxDbgSyms/
159
160	# other paths
161	INST_LIB = lib/
162	INST_ADDITIONS_LIB = $(INST_LIB)additions/
163	VBOX_INST_DTRACE_LIB = $(INST_BIN)dtrace/lib/
164	VBOX_INST_DTRACE_TST = $(INST_BIN)dtrace/testcase/
165	VBOX_INST_TOOLS = $(INST_BIN)tools/
166
167	else
168
169	INST_BIN = bin/
170	INST_DIST = $(INST_BIN)
171	INST_SDK = $(INST_BIN)sdk/
172
173	INST_VIRTUALBOX = $(INST_BIN)
174	INST_VBOXDRV = $(INST_BIN)
175	INST_VBOXNETFLT = $(INST_BIN)
176	INST_VBOXNETADP = $(INST_BIN)
177	INST_VBOXUSB = $(INST_BIN)
178
179	INST_DLL = $(INST_BIN)
180	INST_SYS = $(INST_BIN)
181	INST_TESTCASE = $(INST_BIN)testcase/
182	INST_ADDITIONS = $(INST_BIN)additions/
183	INST_ADDITIONS_ISO = $(INST_ADDITIONS)
184	INST_UNATTENDED_TEMPLATES = $(INST_BIN)UnattendedTemplates/
185
186	INST_LIB = lib/
187	INST_ADDITIONS_LIB = $(INST_LIB)additions/
188	VBOX_INST_DTRACE_LIB = $(INST_BIN)dtrace/lib/
189	VBOX_INST_DTRACE_TST = $(INST_BIN)dtrace/testcase/
190
191	INST_VBOXDBG_SYMS = $(INST_BIN)VBoxDbgSyms/
192	VBOX_INST_TOOLS = $(INST_BIN)tools/
193	endif
194
195
196	INST_VALIDATIONKIT = validationkit/
197	INST_TESTBOXSCRIPT = testboxscript/
198
199	INST_DOC = doc/
200	INST_EXTPACK = $(INST_BIN)ExtensionPacks/
201	INST_EXTPACK_CERTS = $(INST_BIN)ExtPackCertificates/
202	INST_EXTPACK_PUEL = $(INST_EXTPACK)$(VBOX_PUEL_MANGLED_NAME)/
203	INST_PACKAGES = packages/
204
205	VBOX_PATH_SDK = $(patsubst %/,%,$(PATH_STAGE)/$(INST_SDK))
206	VBOX_PATH_DIST = $(patsubst %/,%,$(PATH_STAGE)/$(INST_DIST))
207	VBOX_PATH_VALIDATIONKIT = $(patsubst %/,%,$(PATH_STAGE)/$(INST_VALIDATIONKIT))
208	VBOX_PATH_ADDITIONS = $(patsubst %/,%,$(PATH_STAGE)/$(INST_ADDITIONS))
209	VBOX_PATH_ADDITIONS_ISO = $(patsubst %/,%,$(PATH_STAGE)/$(INST_ADDITIONS_ISO))
210	VBOX_PATH_ADDITIONS_LIB = $(patsubst %/,%,$(PATH_STAGE)/$(INST_ADDITIONS_LIB))
211	VBOX_PATH_EXTPACK_PUEL = $(patsubst %/,%,$(PATH_STAGE)/$(INST_EXTPACK_PUEL))
212	VBOX_PATH_PACKAGES = $(patsubst %/,%,$(PATH_STAGE)/$(INST_PACKAGES))
213	VBOX_PATH_TOOLS = $(patsubst %/,%,$(PATH_STAGE)/$(VBOX_INST_TOOLS))
214
215
216	#
217	# Some source paths of global interest.
218	#
219	VBOX_PATH_SRC_CERTIFICATES = $(PATH_ROOT)/src/VBox/HostDrivers/Support/Certificates
220
221
222	#
223	# Delete targets on failure.
224	#
225	.DELETE_ON_ERROR:
226
227	#
228	# Notify about important kBuild updates.
229	#
230	if $(KBUILD_VERSION_MAJOR) == 0 \
231	&& ( $(KBUILD_VERSION_MINOR) >= 2 \
232	\|\| ( $(KBUILD_VERSION_MINOR) == 1 \
233	&& $(KBUILD_VERSION_PATCH) >= 999))
234	VBOX_MIN_KMK_REVISION := 3093
235	VBOX_MIN_KBUILD_KMK_REVISION := $(if-expr "$(KBUILD_HOST)" == "win",3097,$(if-expr "$(KBUILD_HOST).$(KBUILD_HOST_ARCH)" == "solaris.sparc64",2511,3074))
236	if $(KMK_REVISION) >= $(VBOX_MIN_KMK_REVISION)
237	if $(KBUILD_KMK_REVISION) >= $(VBOX_MIN_KBUILD_KMK_REVISION)
238	# OK.
239	else
240	$(error You must update kBuild! Requires kBuild binaries $(VBOX_MIN_KBUILD_KMK_REVISION) or later, kmk says $(KBUILD_KMK_REVISION) ($(KBUILD_VERSION)))
241	endif
242	else
243	$(error You must update kBuild! Requires kBuild revision $(VBOX_MIN_KMK_REVISION) or later, found $(KMK_REVISION) ($(KBUILD_VERSION)))
244	endif
245	else
246	$(error You must update kBuild! Requires 0.1.999 or later, found $(KBUILD_VERSION))
247	endif
248
249	#
250	# Define USERNAME early on.
251	#
252	ifndef USERNAME
253	ifdef USER
254	USERNAME = $(USER)
255	else
256	$(warning Warning: You must have USERNAME or USER in your environment.)
257	endif
258	endif
259
260	#
261	# Detect the darwin host version number so we can disable stuff that doesn't
262	# currently build on Lion.
263	#
264	ifeq ($(KBUILD_HOST),darwin)
265	VBOX_DARWIN_HOST_VERSION := $(subst ., ,$(shell uname -r))
266	# Keep counting _MAJOR past 19.x (macOS 10.15.x) to simplify dealing with macOS 11.x.
267	VBOX_DARWIN_HOST_VERSION_MAJOR := $(expr $(word 1, $(VBOX_DARWIN_HOST_VERSION)) - 4)
268	VBOX_DARWIN_HOST_VERSION_MINOR := $(word 2, $(VBOX_DARWIN_HOST_VERSION))
269	VBOX_DARWIN_HOST_VERSION_PATCH := $(word 3, $(VBOX_DARWIN_HOST_VERSION))
270	if $(VBOX_DARWIN_HOST_VERSION_MAJOR) <= 15
271	VBOX_DARWIN_HOST_VERSION := 10.$(VBOX_DARWIN_HOST_VERSION_MAJOR).$(VBOX_DARWIN_HOST_VERSION_MINOR)
272	else
273	VBOX_DARWIN_HOST_VERSION := 11.$(expr $(VBOX_DARWIN_HOST_VERSION_MAJOR) - 16).$(VBOX_DARWIN_HOST_VERSION_MINOR)
274	endif
275	endif
276
277	include $(PATH_ROOT)/Version.kmk
278
279	# The raw version string. This must not contain any other information/fields than
280	# major, minor and build revision (as it is now) -- also will be used for host/guest version
281	# comparison.
282	VBOX_VERSION_STRING_RAW = $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
283
284	# VBOX_VERSION_STRING without the publisher.
285	VBOX_VERSION_STRING_NO_PUB = $(VBOX_VERSION_STRING_RAW)$(addprefix _,$(VBOX_VERSION_PRERELEASE))
286
287	# Full version string (may include more than just x.y.z, but no spaces or other problematic chars).
288	# Note! The BETA[n],ALPHA[n],RC[n] indicators should be inserted before the
289	# publisher so that RTStrVersionCompare have a chance of comparing
290	# prerelease from different publishers correctly.
291	VBOX_VERSION_STRING = $(VBOX_VERSION_STRING_NO_PUB)$(VBOX_BUILD_PUBLISHER)
292
293
294	## Make a numeric value from the major, minor and build numbers (params)
295	VBOX_FULL_VERSION_MAKE = $(expr ($1 << 24) \| ($2 << 16) \| $3)
296
297	## Checks if the current VBox version is higher or equal to the major, minor and
298	# build numbers given as parameters.
299	# @returns 1 if true, 0 if false. For use with 'if'.
300	VBOX_VERSION_PREREQ = $(expr $(call VBOX_FULL_VERSION_MAKE,$(VBOX_VERSION_MAJOR),$(VBOX_VERSION_MINOR),$(VBOX_VERSION_BUILD)) \
301	>= $(call VBOX_FULL_VERSION_MAKE,$1,$2,$3))
302
303	# Enable host screen saver toggle by default
304	VBOX_WITH_SCREENSAVER_CONTROL = 1
305
306	# Force the additions.sh script to get an exact additions build when we're doing the release.
307	if $(VBOX_VERSION_BUILD) % 2 == 0
308	ifeq ($(VBOX_VERSION_PRERELEASE),)
309	VBOX_RELEASE_EXACT_MATCH = 1
310	endif
311	endif
312	ifneq ($(VBOX_RELEASE_EXACT_MATCH),)
313	export VBOX_ADDITIONS_SH_MODE = release
314	export VBOX_DOCUMENTATION_SH_MODE = release
315	export VBOX_EFI_SH_MODE = release
316	export VBOX_EXTPACKS_SH_MODE = release
317	endif
318
319	# Maybe we want set this manually.
320	VBOX_C_YEAR = $(date-utc %Y)
321
322	#
323	# The VirtualBox package type.
324	#
325	ifeq ($(KBUILD_TARGET),win)
326	VBOX_PACKAGE_OS = WINDOWS
327	else ifeq ($(KBUILD_TARGET),linux)
328	VBOX_PACKAGE_OS = LINUX
329	else ifeq ($(KBUILD_TARGET),darwin)
330	VBOX_PACKAGE_OS = DARWIN
331	else ifeq ($(KBUILD_TARGET),solaris)
332	VBOX_PACKAGE_OS = SOLARIS
333	else ifeq ($(KBUILD_TARGET),os2)
334	VBOX_PACKAGE_OS = OS2
335	else ifeq ($(KBUILD_TARGET),haiku)
336	VBOX_PACKAGE_OS = HAIKU
337	else if1of ($(KBUILD_TARGET), dragonfly freebsd netbsd openbsd)
338	VBOX_PACKAGE_OS = BSD
339	else
340	$(error Cannot determine VBOX_PACKAGE_OS)
341	endif
342	ifeq ($(KBUILD_TARGET_ARCH),x86)
343	VBOX_PACKAGE_ARCH = 32BITS
344	else
345	VBOX_PACKAGE_ARCH = 64BITS
346	endif
347	# distribution, mostly for Linux/Solaris where we support different distributions
348	# this strip will be overridden by the Linux packaging scripts
349	VBOX_PACKAGE_DIST ?= GENERIC
350	# Full string
351	VBOX_PACKAGE_STRING = $(VBOX_PACKAGE_OS)_$(VBOX_PACKAGE_ARCH)_$(VBOX_PACKAGE_DIST)
352
353	# Supported VirtualBox host architectures.
354	VBOX_SUPPORTED_HOST_ARCHS := amd64
355	if1of ($(KBUILD_TARGET), darwin win linux) # Work in progress.
356	VBOX_SUPPORTED_HOST_ARCHS += arm64
357	endif
358
359
360	#
361	# The VirtualBox Configuration Defaults.
362	#
363	# We try to document all the build configuration options here, things which
364	# aren't enabled by default are left commented out just to show that they
365	# exist and which value they should have (usually 1, but anyway).
366	#
367
368	# Indicate VBOX_ONLY build if any of the VBOX_ONLY_* variables are set.
369	VBOX_ONLY_BUILD := $(strip $(foreach x, ADDITIONS DOCS EXTPACKS SDK VALIDATIONKIT \
370	, $(if-expr defined(VBOX_ONLY_$(x)),VBOX_ONLY_$(x))))
371	if $(words $(VBOX_ONLY_BUILD)) > 1
372	$(error VBox: More than one VBOX_ONLY build enabled! $(VBOX_ONLY_BUILD))
373	endif
374
375	# Select new Xcode based on host OS X version.
376	ifeq ($(KBUILD_HOST),darwin)
377	if "$(KBUILD_TARGET_ARCH)" == "arm64"
378	VBOX_WITH_EVEN_NEWER_XCODE := 1
379	else if !defined(VBOX_WITH_EVEN_NEWER_XCODE) && !defined(VBOX_WITHOUT_EVEN_NEWER_XCODE) && !defined(VBOX_WITH_NEW_XCODE) && $(KBUILD_HOST_VERSION_MAJOR) >= 16 # (OS X 10.12 Sierra)
380	VBOX_WITH_EVEN_NEWER_XCODE := 1
381	else if !defined(VBOX_WITH_NEW_XCODE) && !defined(VBOX_WITHOUT_NEW_XCODE) && $(KBUILD_HOST_VERSION_MAJOR) >= 13 # (OS X 10.9 Mavericks)
382	VBOX_WITH_NEW_XCODE := 1
383	endif
384	endif
385	# Select new VC++ on Windows.
386	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH) $(KBUILD_HOST).$(KBUILD_HOST_ARCH), win.arm64)
387	VBOX_WITH_NEW_VCC = 1
388	endif
389	# Use this to disable control flow.
390	#VBOX_WITHOUT_CONTROL_FLOW_GUARD = 1
391	# Don't use the compiler CRT for statically linked modules, use IPRT with some
392	# additional CRT functionality.
393	# Note! This has only been tested with Visual C++ 2019.
394	## @todo the arm64 exclusion is temporary.
395	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" != "asan" && "$(KBUILD_TARGET_ARCH)" != "arm64"
396	VBOX_WITH_NOCRT_STATIC := 1
397	endif
398
399	## @name Additions
400	## @{
401	# This indicates that additions (of some kind or another) is being _built_.
402	# VBOX_WITHOUT_ADDITIONS overrides it.
403	VBOX_WITH_ADDITIONS = 1
404	# Build the optional ring-0 part of the additions for syntax checking.
405	# On linux we build this as a test case instead.
406	# Skip for darwin.arm64 for now.
407	if "$(KBUILD_TARGET)" != "linux" && "$(intersects $(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.arm64)" == ""
408	VBOX_WITH_ADDITION_DRIVERS = 1
409	endif
410	# Build X11 additions. Can be disabled separately.
411	if1of ($(KBUILD_TARGET), dragonfly freebsd linux netbsd openbsd solaris)
412	VBOX_WITH_X11_ADDITIONS = 1
413	# On ARM we don't support the old VBoxVideo graphics emulation and rely fully on VMSVGA
414	# (partly due to the fact that it relies on port I/O which is not available there).
415	if1of ($(KBUILD_TARGET_ARCH), arm32 arm64)
416	VBOX_NO_LEGACY_XORG_X11 = 1
417	endif
418	endif
419	# Enable the building of shared folders in the windows additions.
420	VBOX_WITH_WIN32_ADDITIONS_SHAREDFOLDERS = 1
421	# Take the binaries of the OS/2 Additions.
422	VBOX_WITH_OS2_ADDITIONS_BIN = 1
423	# Use additions from the build server.
424	#VBOX_WITH_ADDITIONS_FROM_BUILD_SERVER = 1
425	# Include additions in the package
426	VBOX_WITH_ADDITIONS_PACKING = 1
427	# Don't include any CRTs.
428	# For Windows hosts this would be the MS Visual Studio Redistributable (2019).
429	VBOX_WITH_CRT_PACKING =
430	# Only build the additions (for the additions build server).
431	#VBOX_ONLY_ADDITIONS = 1
432	ifdef VBOX_ADDITIONS_ONLY # typical mistake.
433	$(error It is VBOX_ONLY_ADDITIONS=1 not VBOX_ADDITIONS_ONLY!)
434	endif
435	# Don't bother with additions, overrides VBOX_WITH_ADDITIONS.
436	# This is not used by makefiles, only Config.kmk, see below.
437	ifdef VBOX_ONLY_SDK
438	VBOX_WITHOUT_ADDITIONS = 1
439	endif
440	# Don't create the additions ISO.
441	# (Used by the additions build server, don't invert it.)
442	#VBOX_WITHOUT_ADDITIONS_ISO = 1
443	# Include and build the Linux arm64 guest additions.
444	VBOX_WITH_LNX_ARM64_ADDITIONS = 1
445	## @}
446
447	# Set build options right for building the Additions as an RPM package.
448	# VBOX_ONLY_RPM_ADDITIONS = 1
449	ifdef VBOX_ONLY_RPM_ADDITIONS
450	VBOX_ONLY_ADDITIONS = 1
451	VBOX_ONLY_ADDITIONS_WITHOUT_RTISOMAKER = 1
452	# We build the RPMs using public sources.
453	VBOX_OSE = 1
454	# We want to re-use parts of the packing pass, but not all.
455	VBOX_WITHOUT_LINUX_GUEST_PACKAGE = 1
456	VBOX_WITHOUT_ADDITIONS_ISO = 1
457	endif
458
459	## @name Documentation
460	## @{
461	# The documentation
462	VBOX_WITH_DOCS = 1
463	# Use documentation from the build server.
464	#VBOX_WITH_DOCS_FROM_BUILD_SERVER = 1
465	# Include documentation in the package
466	VBOX_WITH_DOCS_PACKING = 1
467	# Build QHelp documentation, needs qhelpgenerator
468	VBOX_WITH_DOCS_QHELP = 1
469	# Include QHelp documentation in the package
470	VBOX_WITH_DOCS_QHELP_PACKING = 1
471	# By default only include translations in documentation-only builds
472	ifdef VBOX_ONLY_DOCS
473	ifndef VBOX_NO_DOCS_TRANSLATIONS
474	VBOX_WITH_DOCS_TRANSLATIONS = 1
475	endif
476	endif
477	# Default languages
478	VBOX_MANUAL_LANGUAGES = en_US
479	ifdef VBOX_WITH_DOCS_TRANSLATIONS
480	# The French translation is too outdated to be useful, needs a fresh start.
481	#VBOX_MANUAL_ADD_LANGUAGES = fr_FR
482	endif
483	# Don't bother with documentation, overrides VBOX_WITH_DOCS.
484	# This is not used by makefiles, only Config.kmk, see below.
485	#VBOX_WITHOUT_DOCS = 1
486	# Only build the documentation (for the documentation build server).
487	#VBOX_ONLY_DOCS = 1
488	ifdef VBOX_DOCS_ONLY # typical mistake.
489	$(error It is VBOX_ONLY_DOCS=1 not VBOX_DOCS_ONLY!)
490	endif
491	## @}
492
493	## @name VMM related settings.
494	## @{
495	# Enable the VT-x & AMD-V execution manager (HM).
496	if "$(KBUILD_TARGET)" == "amd64" && !defined(VBOX_WITHOUT_HWVIRT)
497	VBOX_WITH_HWVIRT := 1
498	endif
499	# Enable .r0 modules.
500	if "$(KBUILD_TARGET_ARCH)" == "amd64"
501	VBOX_WITH_R0_MODULES := 1
502	endif
503	# Enable safe STR (store task register) emulation for raw-mode.
504	VBOX_WITH_SAFE_STR = 1
505	# Enable support for 64-bit guests.
506	VBOX_WITH_64_BITS_GUESTS = 1
507	# Enable multi-core VCPUs.
508	VBOX_WITH_MULTI_CORE = 1
509	# Activate this to force the VM to pre-allocate the guest RAM before startup
510	VBOX_WITH_PREALLOC_RAM_BY_DEFAULT =
511	# Enable the debugger.
512	VBOX_WITH_DEBUGGER = 1
513	# Enable the debugger GUI.
514	VBOX_WITH_DEBUGGER_GUI = 1
515	# Nested hardware virtualization (64-bit hosts only).
516	ifeq ($(KBUILD_TARGET_ARCH),amd64)
517	# Enables SVM nested hardware virtualization support.
518	VBOX_WITH_NESTED_HWVIRT_SVM = 1
519	# Enables VMX nested hardware virtualization support.
520	VBOX_WITH_NESTED_HWVIRT_VMX = 1
521	# Enables nested hardware virtualization support but only in IEM.
522	#VBOX_WITH_NESTED_HWVIRT_ONLY_IN_IEM = 1
523	ifdef VBOX_WITH_NESTED_HWVIRT_ONLY_IN_IEM
524	if !defined(VBOX_WITH_NESTED_HWVIRT_SVM) && !defined(VBOX_WITH_NESTED_HWVIRT_VMX)
525	$(error VBOX_WITH_NESTED_HWVIRT_ONLY_IN_IEM defined without enabling nested VMX or nested SVM support)
526	endif
527	endif
528	# Enables guest EPT support for VMX nested hardware virtualization.
529	ifn1of ($(KBUILD_TARGET), darwin)
530	VBOX_WITH_NESTED_HWVIRT_VMX_EPT = 1
531	endif
532	if defined(VBOX_WITH_NESTED_HWVIRT_VMX_EPT) && !defined(VBOX_WITH_NESTED_HWVIRT_VMX)
533	$(error VBOX_WITH_NESTED_HWVIRT_VMX_EPT requires VBOX_WITH_NESTED_HWVIRT_VMX)
534	endif
535	endif
536	# Enable the TLBs in IEM (experimental).
537	if1of ($(KBUILD_TARGET_ARCH), arm64)
538	VBOX_WITH_IEM_TLB := 1
539	endif
540	# Enable the IEM recompiler of x86 code.
541	if1of ($(KBUILD_TARGET_ARCH), arm64)
542	VBOX_WITH_IEM_RECOMPILER := 1
543	VBOX_WITH_IEM_NATIVE_RECOMPILER := 1
544	endif
545	# Enable native NEM on windows and macOS.
546	if1of ($(KBUILD_TARGET), win darwin)
547	VBOX_WITH_NATIVE_NEM = 1
548	endif
549	# Enable NEM fallback if the driver is not available.
550	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.amd64 darwin.arm64 linux.arm64 win.arm64)
551	VBOX_WITH_DRIVERLESS_NEM_FALLBACK = 1
552	endif
553	# Enable forced driverless mode by default.
554	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.amd64 darwin.arm64 linux.arm64)
555	VBOX_WITH_DRIVERLESS_FORCED = 1
556	ifn1of ($(KBUILD_TARGET), linux win)
557	VBOX_WITH_INTNET_SERVICE_IN_R3 = 1
558	endif
559	endif
560	# Enables the new breakpoint handling code, see @bugref{8650}
561	VBOX_WITH_DBGF_FLOW_TRACING = 1
562	# Enables ARMv8 virtualization, see @bugref{10383}
563	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.arm64 linux.arm64 win.arm64)
564	VBOX_WITH_VIRT_ARMV8 = 1
565	endif
566	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), linux.amd64)
567	ifdef VBOX_WITH_R0_MODULES
568	# Enable IBT branch protection for the R0 modules.
569	# (A make warning will be shown if gcc is too old.)
570	VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION = 1
571	endif
572	endif
573	## @}
574
575
576	## @name Devices, Drivers, ...
577	## @{
578	# Build the Host Guest Communication Manager component.
579	VBOX_WITH_HGCM = 1
580	## Build the bugcheck detection code.
581	#VBOX_WITH_GUEST_BUGCHECK_DETECTION =
582	# Enable the USB feature. This includes VBOX_WITH_VUSB!
583	VBOX_WITH_USB = 1
584	# Enable the USB 1.1 controller plus virtual USB HID devices.
585	VBOX_WITH_VUSB = 1
586	# Enable the USB 2.0 controller.
587	VBOX_WITH_EHCI = 1
588	# Enable the ISCSI feature.
589	VBOX_WITH_ISCSI = 1
590	# Enable INIP support in the ISCSI feature.
591	VBOX_WITH_INIP = 1
592	# Enables lwip as a core of NAT service
593	VBOX_WITH_LWIP_NAT = 1
594	# Enables compilation of NAT service
595	VBOX_WITH_NAT_SERVICE = 1
596	# Enable NAT with Libslirp
597	VBOX_WITH_LIBSLIRP = 1
598	# Enable the E1000 feature.
599	VBOX_WITH_E1000 = 1
600	# Enable the Virtio feature.
601	VBOX_WITH_VIRTIO = 1
602	# Enable the Virtio SCSI device.
603	VBOX_WITH_VIRTIO_SCSI = 1
604	# HDA emulation is Intel HDA by default.
605	VBOX_WITH_INTEL_HDA = 1
606	ifn1of ($(KBUILD_TARGET), win darwin)
607	# Enable OSS audio support.
608	VBOX_WITH_AUDIO_OSS = 1
609	endif
610	if1of ($(KBUILD_TARGET), linux)
611	# Enable ALSA audio support.
612	VBOX_WITH_AUDIO_ALSA = 1
613	endif
614	if1of ($(KBUILD_TARGET), linux)
615	# Enable PulseAudio audio support.
616	VBOX_WITH_AUDIO_PULSE = 1
617	endif
618	# Enable building debugging backend.
619	# Only will be used at runtime when "VBoxInternal2/Audio/Debug/Enabled" (VM / global) is set.
620	VBOX_WITH_AUDIO_DEBUG = 1
621	# Enables the audio endpoint detection on Windows hosts.
622	VBOX_WITH_AUDIO_MMNOTIFICATION_CLIENT = 1
623	# Enable PCI passthrough support.
624	# (disabled with 6.1, since it's not complete/useful enough)
625	VBOX_WITH_PCI_PASSTHROUGH =
626	# Enable statically linked dbus support.
627	if1of ($(KBUILD_TARGET), linux solaris)
628	VBOX_WITH_DBUS = 1
629	endif
630	# Enable building PAM modules.
631	if1of ($(KBUILD_TARGET), linux solaris)
632	VBOX_WITH_PAM = 1
633	endif
634	# Enable internal networking.
635	VBOX_WITH_INTERNAL_NETWORKING = 1
636	# Enable vmsvga (svga2) graphics device variant, 2D part
637	VBOX_WITH_VMSVGA = 1
638	# Enable vmsvga (svga2) graphics device variant, 3D part
639	if1of ($(KBUILD_TARGET), darwin linux win)
640	VBOX_WITH_VMSVGA3D = 1
641	endif
642	# Enable vmsvga (svga2) graphics device variant, 3D part, VGPU10 DX commands
643	ifdef VBOX_WITH_VMSVGA3D
644	VBOX_WITH_VMSVGA3D_DX = 1
645	# Enable DXVK library for supporting VGPU10 DX on non Windows hosts
646	if1of ($(KBUILD_TARGET), linux darwin)
647	VBOX_WITH_DXVK = 1
648	endif
649	endif
650	# Enable the generic 3D settings support if at least one 3D capable solution is enabled
651	ifdef VBOX_WITH_VMSVGA3D
652	VBOX_WITH_3D_ACCELERATION = 1
653	endif
654	# Enable Host Guest Shared Memory Interface.
655	VBOX_WITH_HGSMI = 1
656	# Enable Video 2D Acceleration.
657	if1of ($(KBUILD_TARGET), darwin linux win freebsd)
658	VBOX_WITH_VIDEOHWACCEL = 1
659	endif
660	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), win.x86 win.amd64)
661	# Enable XPDM Video driver for XP and older guests.
662	VBOX_WITH_XPDM = 1
663	endif
664	# Enable Wddm Video driver for Vista+ guests.
665	ifn1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), win.arm64) ## @todo win.arm64: port the WDDM + VGA device to arm64.
666	VBOX_WITH_WDDM = 1
667	endif
668	# Lazy developer!!
669	VBOXWDDM_WITH_VBVA = 1
670	# Lazy developer!!
671	ifdef VBOX_WITH_WDDM
672	VBOX_WITH_VDMA = 1
673	else ifdef VBOX_WITH_VDMA
674	undefine VBOX_WITH_VDMA
675	endif
676	# Gallium based WDDM driver
677	if1of ($(KBUILD_TARGET), win)
678	VBOX_WITH_MESA3D = 1
679	endif
680	# VGPU10 UMD driver for Vista+ guests in the guest additions installer
681	ifdef VBOX_WITH_VMSVGA3D_DX
682	if1of ($(KBUILD_TARGET), win)
683	VBOX_WITH_WDDM_DX = 1
684	endif
685	endif
686	# Disable the Intel PXE ROM (uses Etherboot).
687	VBOX_WITH_INTEL_PXE =
688	# Enable EFI support
689	VBOX_WITH_EFI = 1
690	# Enable Secure Boot in the EFI firmware.
691	VBOX_WITH_EFI_SECURE_BOOT = 1
692	# Enable TPM support in the EFI firmware.
693	VBOX_WITH_EFI_TPM = 1
694	# Embed the EFI firmwares in VBoxDD2.dll/dylib/so.
695	VBOX_WITH_EFI_IN_DD2 = 1
696	# Fetch EFI firmware image from the build server
697	#VBOX_WITH_EFIFW_FROM_BUILD_SERVER = 1
698	# Include the EFI firmware into the package
699	ifndef VBOX_WITH_EFI_IN_DD2
700	VBOX_WITH_EFIFW_PACKING = 1
701	endif
702	# Enable setuid wrapper for Solaris host DVD.
703	#VBOX_WITH_SUID_WRAPPER = 1
704	# Enable the virtual SATA/AHCI controller
705	VBOX_WITH_AHCI = 1
706	# Enable the new async completion manager
707	VBOX_WITH_PDM_ASYNC_COMPLETION = 1
708	ifdef VBOX_WITH_USB
709	VBOX_WITH_VUSB = 1
710	VBOX_WITH_XHCI_IMPL = 1
711	endif
712	ifdef VBOX_WITH_EHCI
713	VBOX_WITH_EHCI_IMPL = 1
714	endif
715	ifdef VBOX_WITH_PCI_PASSTHROUGH
716	## @bugref{9218}: Disabled awaiting conversion of the device to new PDM device style.
717	#VBOX_WITH_PCI_PASSTHROUGH_IMPL = 1
718	endif
719	ifndef VBOX_WITHOUT_HOSTWEBCAM
720	VBOX_WITH_USB_VIDEO_IMPL = 1
721	endif
722	# Enable the hal/sysfs USB code on Linux.
723	ifeq ($(KBUILD_TARGET),linux)
724	VBOX_USB_WITH_SYSFS = 1
725	# Disabled for now
726	# VBOX_USB_WITH_DBUS = 1
727	VBOX_USB_WITH_INOTIFY = 1
728	endif
729	# Enable performance API.
730	VBOX_WITH_RESOURCE_USAGE_API = 1
731	# Use VBoxVolInfo for getting FS dependecies.
732	if1of ($(KBUILD_TARGET), linux)
733	VBOX_WITH_DEVMAPPER = 1
734	endif
735	# Enable unattended installation API
736	VBOX_WITH_UNATTENDED = 1
737	# Enable BusLogic SCSI host adapter
738	VBOX_WITH_BUSLOGIC = 1
739	# Enable LsiLogic SCSI host adapter
740	VBOX_WITH_LSILOGIC = 1
741	# Enable SCSI drivers
742	VBOX_WITH_SCSI = 1
743	# Enable this setting to force a fallback to default DMI data on configuration errors
744	VBOX_BIOS_DMI_FALLBACK =
745	# Enable the builtin PXE ROM
746	VBOX_WITH_PXE_ROM = 1
747	# Enable MSI support in devices
748	VBOX_WITH_MSI_DEVICES = 1
749	# Enable host network interface API.
750	if1of ($(KBUILD_TARGET), darwin freebsd linux solaris win)
751	VBOX_WITH_HOSTNETIF_API = 1
752	endif
753	# Emulated USB smart card reader
754	VBOX_WITH_USB_CARDREADER = 1
755	# Disk crypt plugin
756	VBOX_WITH_PLUGIN_CRYPT = 1
757	# VirtualKD stub/loader device, only relevant on Windows host
758	VBOX_WITH_VIRTUALKD = 1
759	# NVMe device emulation
760	VBOX_WITH_NVME_IMPL = 1
761	# Storage related debug drivers
762	VBOX_WITH_DRV_DISK_INTEGRITY = 1
763	# Enables the AMD IOMMU
764	VBOX_WITH_IOMMU_AMD = 1
765	# Enables the Intel IOMMU
766	VBOX_WITH_IOMMU_INTEL = 1
767	# Enables the new DBGF tracing framework
768	VBOX_WITH_DBGF_TRACING = 1
769	# Enable TPM device emulation support.
770	VBOX_WITH_TPM = 1
771	# Enable libtpms, required for the in process TPM emulation.
772	if1of ($(KBUILD_TARGET), linux darwin win solaris)
773	VBOX_WITH_LIBTPMS = 1
774	endif
775	# Disable keyboard HID Consumer/Desktop control keys passthrough
776	# VBOX_WITHOUT_KEYBOARD_HID_CC_DC_PASSTHROUGH = 1
777	## @}
778
779	# legacy
780	ifdef VBOX_ONLY_TESTSUITE
781	$(warning VBOX_ONLY_TESTSUITE was renamed to VBOX_ONLY_VALIDATIONKIT)
782	VBOX_ONLY_VALIDATIONKIT = $(VBOX_ONLY_TESTSUITE)
783	endif
784
785	## @name Other Component
786	## @{
787	# Build the installer.
788	VBOX_WITH_INSTALLER = 1
789	# Show license pages for non-OSE versions by default.
790	# This is required for e.g. the Windows host installer.
791	ifndef VBOX_OSE
792	VBOX_WITH_LICENSE_DISPLAY = 1
793	endif
794	VBOX_WITH_GUEST_INSTALLER_UNICODE = 1
795	# The kernel driver/module and related runtime libraries.
796	# On Linux we build this as a test case instead.
797	# On darwin we don't use a support driver.
798	if "$(KBUILD_TARGET)" != "linux" && "$(KBUILD_TARGET)" != "darwin"
799	VBOX_WITH_VBOXDRV = 1
800	endif
801	# The main api.
802	VBOX_WITH_MAIN = 1
803	# Enables proxy stub for MS COM (speeds up setting IPC for objects).
804	# (The VBOX_MIDL_PROXY_CLSID and VBOX_MIDL_PROXY_CLSID_IS are just two
805	# representations of the class ID for the proxy stub.)
806	VBOX_WITH_MIDL_PROXY_STUB = 1
807	VBOX_MIDL_PROXY_CLSID := {0bb3b78c-1807-4249-5ba5-ea42d66af0bf}
808	VBOX_MIDL_PROXY_CLSID_IS := {0x0bb3b78c,0x1807,0x4249,{0x5b,0xa5,0xea,0x42,0xd6,0x6a,0xf0,0xbf}}
809	# Whether to also ship 32-bit main API on 64-bit systems.
810	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), solaris.amd64 win.amd64)
811	if !defined(VBOX_ONLY_VALIDATIONKIT) && !defined(VBOX_ONLY_ADDITIONS) && !defined(VBOX_ONLY_DOCS) && !defined(VBOX_ONLY_EXTPACKS)
812	VBOX_WITH_32_ON_64_MAIN_API = 1
813	endif
814	endif
815	# Whether to generate a database of USB vendor IDs and device IDs into VBoxSVC.
816	VBOX_WITH_MAIN_USB_ID_DATABASE = 1
817	# Whether to enable error message translation in Main.
818	ifndef VBOX_ONLY_BUILD
819	VBOX_WITH_MAIN_NLS = 1
820	endif
821	# Whether to enable error message translation in Extension VM Pack.
822	if !defined(VBOX_ONLY_BUILD) \|\| defined(VBOX_ONLY_EXTPACKS)
823	VBOX_WITH_PUEL_NLS = 1
824	endif
825	# Whether to enable message translation in VBoxManage.
826	#ifndef VBOX_ONLY_BUILD
827	VBOX_WITH_VBOXMANAGE_NLS = 1
828	#endif
829	# Set this to prefix all C symbols in XPCOM, to avoid dynamic linking problems
830	# caused by our XPCOM library polluting the symbol namespace for system libs.
831	if1of ($(KBUILD_TARGET), linux solaris)
832	VBOX_WITH_XPCOM_NAMESPACE_CLEANUP = 1
833	endif
834	# The webservices api.
835	VBOX_WITH_WEBSERVICES = 1
836	VBOX_WITH_WEBSERVICES_SSL = 1
837	# The Qt GUI.
838	VBOX_WITH_QTGUI = 1
839	# Indicates the Qt is Cocoa based on the Mac.
840	ifeq ($(KBUILD_TARGET),darwin)
841	VBOX_WITH_COCOA_QT = 1
842	endif
843
844	# VBox Ballooning Control frontend.
845	VBOX_WITH_FE_BALLOONCTRL = 1
846	# VBox Autostart Service.
847	VBOX_WITH_FE_AUTOSTART = 1
848	# VBox Bug Report tool.
849	VBOX_WITH_FE_BUGREPORT = 1
850	# Enable this to get the SDL based GUI built. Mostly useful for development
851	# purposes. For production use it's recommended to use the Qt GUI which can
852	# be also stripped down. See VBOX_WITH_QTGUI.
853	VBOX_WITH_VBOXSDL =
854	# Start VBoxSVC in windows session 0 (services session).
855	VBOX_WITH_VBOXSVC_SESSION_0 = 1
856	# The headless frontend.
857	VBOX_WITH_HEADLESS = 1
858	# Enable the build of VRDP server.
859	VBOX_WITH_VRDP = 1
860	# Build the VRDP authentication modules.
861	VBOX_WITH_VRDP_AUTHMOD = 1
862	# Build enhanced version of rdesktop.
863	VBOX_WITH_VRDP_RDESKTOP = 1
864	## The Direct Framebuffer GUI.
865	#VBOX_WITH_VBOXFB = 1
866	# The basic frontend not using Main/COM/XPCOM.
867	#VBOX_WITH_VBOXBFE = 1
868	# Enables the Python<->XPCOM, Python<->COM and (WS enabled) Python<->WS bindings.
869	VBOX_WITH_PYTHON ?= 1
870	# Enables the PERL<->WS binding (if WS enabled).
871	#VBOX_WITH_PERL ?= 1
872	# Enables the PHP<->WS binding (if WS enabled).
873	VBOX_WITH_PHP ?= 1
874	if1of ($(KBUILD_TARGET), darwin linux solaris)
875	# Enable Java<->XPCOM bridge + glue code
876	VBOX_WITH_JXPCOM ?= 1
877	endif
878	if1of ($(KBUILD_TARGET), ) # scm:ignore-empty-if1of-set
879	# Enable Java<->MSCOM glue, bridge is provided by an external lib (Jacob)
880	VBOX_WITH_JMSCOM ?= 1
881	endif
882	if1of ($(KBUILD_TARGET), darwin linux solaris)
883	# Enable Java<->JAX-WS bridge
884	VBOX_WITH_JWS ?= 1
885	endif
886	# Use XPIDL instead of XSLT stylesheet
887	VBOX_WITH_JAVA_SUPPORT_IN_XPIDL ?=
888	# Build against multiple Python versions present in the system (only up to 3.2,
889	# unless VBOX_WITH_ONLY_PYTHON_LIMITED_API is overridden).
890	VBOX_WITH_MULTIVERSION_PYTHON ?= 1
891	# Only build the limited Python extension API version for 3.3 and later.
892	VBOX_WITH_ONLY_PYTHON_LIMITED_API = 1
893	# Build the Validation Kit.
894	VBOX_WITH_VALIDATIONKIT = 1
895	# Include unit tests (testcases) on the Validation Kit .ISO
896	# so that we can perform testing on older platforms which we don't support
897	# on the host anymore.
898	if1of ($(KBUILD_TARGET), darwin.amd64 linux win)
899	VBOX_WITH_VALIDATIONKIT_UNITTESTS_PACKING = 1
900	endif
901	# Set if we should ship the audio test from the Validation Kit with the host installer.
902	VBOX_WITH_HOST_SHIPPING_AUDIO_TEST = 1
903	# Set if we should ship the audio test from the Validation Kit with the guest additions.
904	VBOX_WITH_ADDITIONS_SHIPPING_AUDIO_TEST = 1
905	# Build the testcases.
906	VBOX_WITH_TESTCASES = 1
907	# Enable this to build vbox-img even if VBOX_WITH_TESTCASES is disabled
908	VBOX_WITH_VBOX_IMG =
909	# Enables recording support.
910	VBOX_WITH_RECORDING = 1
911	# Enable VPX (VP8 / VP9 codec), required for video capturing.
912	VBOX_WITH_LIBVPX = 1
913	# Enables audio support for recording (depends on VBOX_WITH_RECORDING).
914	VBOX_WITH_AUDIO_RECORDING = 1
915	if defined(VBOX_WITH_AUDIO_RECORDING) && !defined(VBOX_WITH_RECORDING)
916	$(error Audio recording (VBOX_WITH_AUDIO_RECORDING) needs the general recording feature (VBOX_WITH_RECORDING) enabled)
917	endif
918	# Enables libvorbis (Ogg Vorbis), required for encoding audio into the recorded data.
919	VBOX_WITH_LIBVORBIS = 1
920	# Enables libogg (Ogg file format). Required for building libvorbis above.
921	VBOX_WITH_LIBOGG = 1
922	# Currently OggVorbis is our only choice for audio recording support, so check for that.
923	if defined(VBOX_WITH_AUDIO_RECORDING) && !defined(VBOX_WITH_LIBVORBIS)
924	$(error Need libvorbis (VBOX_WITH_LIBVORBIS) in order to enable audio recoding support)
925	endif
926	if defined(VBOX_WITH_LIBVORBIS) && !defined(VBOX_WITH_LIBOGG)
927	$(error Need libogg (VBOX_WITH_LIBOGG) in order to build libvorbis (VBOX_WITH_LIBVORBIS))
928	endif
929	# Enable Wayland support for Guest Additions
930	VBOX_WITH_WAYLAND_ADDITIONS = 1
931	# Enable shared folders
932	VBOX_WITH_SHARED_FOLDERS = 1
933	# Enable shared clipboard
934	VBOX_WITH_SHARED_CLIPBOARD = 1
935	# Enable shared clipboard (file) transfers
936	if1of ($(KBUILD_TARGET), win linux)
937	VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS = 1
938	if1of ($(KBUILD_TARGET), linux)
939	VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS_HTTP = 1
940	endif
941	endif
942	# Enable the host/guest information service (aka guest properties).
943	VBOX_WITH_GUEST_PROPS = 1
944	# Enable this to prevent the guest from writing guest properties.
945	VBOX_WITH_GUEST_PROPS_RDONLY_GUEST =
946	# Compile the host channel
947	VBOX_WITH_HOST_CHANNEL = 1
948	# Enable the guest control service.
949	if1of ($(KBUILD_TARGET), darwin freebsd linux solaris win)
950	VBOX_WITH_GUEST_CONTROL = 1
951	# Enables support for handling certain commands via the built-in (busybox-like) toolbox in VBoxService. See @bugref{9783}
952	# This is for supporting Guest Additions < 7.1.
953	VBOX_WITH_GSTCTL_TOOLBOX_SUPPORT = 1
954	# Enables treating the toolbox as built-in commands. Requires 7.1 Guest Additions. See @bugref{9783}
955	VBOX_WITH_GSTCTL_TOOLBOX_AS_CMDS = 1
956	if !defined(VBOX_WITH_GSTCTL_TOOLBOX_SUPPORT) && !defined(VBOX_WITH_GSTCTL_TOOLBOX_AS_CMDS)
957	$(error Neither VBOX_WITH_GSTCTL_TOOLBOX_SUPPORT nor VBOX_WITH_GSTCTL_TOOLBOX_AS_CMDS specified, which will lead to broken Guest Control functionality!)
958	endif
959	endif
960	# Enable ballooning
961	VBOX_WITH_MEMBALLOON = 1
962	# Enable cURL (required for the network part of the GUI)
963	VBOX_WITH_LIBCURL = 1
964	# Enable libssh (required for cloud network attachment)
965	if1of ($(KBUILD_TARGET), darwin linux win)
966	VBOX_WITH_LIBSSH = 1
967	endif
968	# Enable Host=>Guest Drag'n'Drop
969	if1of ($(KBUILD_TARGET), darwin linux solaris win)
970	VBOX_WITH_DRAG_AND_DROP = 1
971	if1of ($(KBUILD_TARGET), darwin linux solaris win)
972	VBOX_WITH_DRAG_AND_DROP_GH = $(VBOX_WITH_DRAG_AND_DROP)
973	endif
974	ifdef VBOX_WITH_DRAG_AND_DROP_GH
975	ifeq ($(KBUILD_TARGET),darwin)
976	# On OS X (Darwin) this needs to be set in order to get proper
977	# guest->host support.
978	# Note: Setting this requires Qt also having this feature enabled!
979	VBOX_WITH_DRAG_AND_DROP_PROMISES = $(VBOX_WITH_DRAG_AND_DROP)
980	endif
981	endif
982	endif
983	# Enable audio support for VRDE.
984	VBOX_WITH_AUDIO_VRDE = 1
985	ifdef VBOX_WITH_VALIDATIONKIT
986	# Ship the Validation Kit audio driver for running tests (driver disabled by default).
987	VBOX_WITH_AUDIO_VALIDATIONKIT = 1
988	endif
989	# Use the VRDE external authentication library from VBoxSVC.
990	if1of ($(KBUILD_TARGET), win)
991	VBOX_WITH_VRDEAUTH_IN_VBOXSVC = 1
992	endif
993	# Enables use of merge modules in the windows installer. This will increase
994	# the overall installer size significantly because merge modules are not able
995	# to use a common .cab file to reduce their size.
996	#VBOX_WITH_MSM_INSTALL = 1
997	# Enables full VM encryption support @bugref{9955}.
998	VBOX_WITH_FULL_VM_ENCRYPTION = 1
999	# Enables the 'sign' command in bldRTSignTool. We may need this on windows.
1000	if1of ($(KBUILD_TARGET), win)
1001	VBOX_WITH_BLD_RTSIGNTOOL_SIGNING = 1
1002	endif
1003	# Enables support for liblzma inside of IPRT.
1004	ifndef VBOX_ONLY_SDK
1005	VBOX_WITH_LIBLZMA = 1
1006	endif
1007	## @}
1008
1009
1010	## @name Networking
1011	## @{
1012	# Use VBoxNetFlt for host interface networking.
1013	if1of ($(KBUILD_TARGET), darwin freebsd linux solaris win)
1014	VBOX_WITH_NETFLT = 1
1015	ifeq ($(KBUILD_TARGET),solaris)
1016	# requires snv_159+.
1017	VBOX_WITH_NETFLT_CROSSBOW = 1
1018	endif
1019	# Use VBoxNetAdp for host only networking.
1020	if1of ($(KBUILD_TARGET), darwin freebsd linux solaris win)
1021	VBOX_WITH_NETADP = 1
1022	endif
1023	endif
1024	# Enables the UDP tunnel transport.
1025	VBOX_WITH_UDPTUNNEL = 1
1026	# Enable the netshaper support
1027	VBOX_WITH_NETSHAPER = 1
1028	# Enable Virtual Distributed Ethernet or not.
1029	if1of ($(KBUILD_TARGET), freebsd linux)
1030	VBOX_WITH_VDE = 1
1031	endif
1032	# Use new VBoxNetDhcpd instead of old VBoxNetDHCP
1033	VBOX_WITH_DHCPD = 1
1034	# Experimental suport for cloud network integration (depends on libssh)
1035	ifdef VBOX_WITH_LIBSSH
1036	VBOX_WITH_CLOUD_NET = 1
1037	endif
1038	# Use Mac OS X VMNET API instead of network kernel extensions
1039	VBOX_WITH_VMNET = 1
1040	## @}
1041
1042
1043	## @name Extension pack
1044	## @{
1045	# Enables the extension pack feature.
1046	VBOX_WITH_EXTPACK = 1
1047	# Enables separating code into the Extension Pack, dubbed PUEL.
1048	VBOX_WITH_EXTPACK_PUEL = 1
1049	# Enables building+packing the Extension Pack, includes VBOX_WITH_EXTPACK_PUEL
1050	VBOX_WITH_EXTPACK_PUEL_BUILD = 1
1051	# Enable the BusMouse sample extension pack.
1052	#VBOX_WITH_EXTPACK_BUSMOUSESAMPLE = 1
1053	# Enable the VNC server extension pack (GPL only).
1054	#VBOX_WITH_EXTPACK_VNC = 1
1055	# Enables the VBoxDTrace extension pack.
1056	VBOX_WITH_EXTPACK_VBOXDTRACE = 1
1057	## @}
1058
1059	## @name Misc
1060	## @{
1061	# Enables all the doxgen bits.
1062	VBOX_WITH_ALL_DOXYGEN_TARGETS = 1
1063	# Set this to skip installing the redistributable compiler runtime.
1064	#VBOX_WITHOUT_COMPILER_REDIST = 1
1065	# Enables VMMR0.r0 (++) loading using the native loader on solaris.
1066	# Good for debugging and analysis. Experimental.
1067	#VBOX_WITH_NATIVE_SOLARIS_LOADING = 1
1068	# Set this to enable user mode dtrace probes.
1069	if1of ($(KBUILD_TARGET), darwin linux solaris)
1070	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1071	VBOX_WITH_DTRACE_R3 := 1
1072	VBOX_WITH_DTRACE_R3_MAIN := 1
1073	endif
1074	endif
1075	# Set this to enable kernel driver dtrace probes.
1076	if1of ($(KBUILD_TARGET), darwin solaris)
1077	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1078	VBOX_WITH_DTRACE_R0DRV := 1
1079	endif
1080	endif
1081	# Set this to enable dtrace probes in platform agnostic kernel code.
1082	ifn1of ($(KBUILD_TARGET), os2)
1083	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1084	VBOX_WITH_DTRACE_R0 := 1
1085	endif
1086	endif
1087	# Set this to enable dtrace probes raw-mode context code.
1088	if1of ($(KBUILD_TARGET), linux solaris)
1089	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1090	VBOX_WITH_DTRACE_RC := 1
1091	endif
1092	endif
1093	# Set this to enable support for dtrace probes in guest code.
1094	#VBOX_WITH_DTRACE_GST = 1
1095	# Set this to indicate that the host ships with DTrace.
1096	if1of ($(KBUILD_TARGET), darwin solaris)
1097	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1098	VBOX_WITH_NATIVE_DTRACE := 1
1099	endif
1100	endif
1101	# Makes it possible to run some of the testcases and tools on older
1102	# windows versions (only define when buildling win.x86).
1103	#VBOX_WITH_MORE_NT4_COMPAT_BINARIES = 1
1104	# Set this to enable building of the vboximg-mount FUSE mounting utility.
1105	if1of ($(KBUILD_TARGET), darwin linux)
1106	VBOX_WITH_VBOXIMGMOUNT = 1
1107	endif
1108	# Set this to enable packaging the fuse related bits into our installer.
1109	# Newer versions prohibit from distributing with commercial software @bugref{8515}
1110	#if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.amd64)
1111	# VBOX_WITH_FUSE_PACKING = 1
1112	#endif
1113	# Enables updating checking through Main.
1114	# Only available if cURL is being used.
1115	ifdef VBOX_WITH_LIBCURL
1116	VBOX_WITH_UPDATE_AGENT = 1
1117	endif
1118	## @}
1119
1120
1121	## @name Compiler and linker config
1122	## @{
1123	# For treating compiler and linker warnings as errors where possible.
1124	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), \
1125	darwin.x86 darwin.amd64 darwin.arm64 linux.x86 linux.amd64 linux.arm64 win.x86 win.amd64 win.arm64)
1126	VBOX_WITH_WARNINGS_AS_ERRORS = 1
1127	endif
1128	# Whether we can use Open Watcom to build stuff.
1129	if1of ($(KBUILD_TARGET), darwin linux os2 win)
1130	if1of ($(KBUILD_TARGET_ARCH), amd64 x86)
1131	VBOX_WITH_OPEN_WATCOM := 1
1132	else if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), win.arm64)
1133	VBOX_WITH_OPEN_WATCOM := 1
1134	endif
1135	endif
1136	## @}
1137
1138
1139	## @name Hardening
1140	## @{
1141	# Enables hardening.
1142	# Most developers will want to disable this in their LocalConfig.kmk.
1143	VBOX_WITH_HARDENING = 1
1144	# Where the application files are (going to be) installed.
1145	#VBOX_PATH_APP_PRIVATE = /usr/lib/virtualbox
1146	ifdef VBOX_WITH_HARDENING
1147	if1of ($(KBUILD_TARGET), linux solaris)
1148	VBOX_PATH_APP_PRIVATE = /opt/VirtualBox
1149	else ifeq ($(KBUILD_TARGET),darwin)
1150	VBOX_PATH_APP_PRIVATE = /Applications/VirtualBox.app/Contents/MacOS
1151	else ifeq ($(KBUILD_TARGET),freebsd)
1152	VBOX_PATH_APP_PRIVATE = /usr/local/lib/virtualbox
1153	else ifeq ($(KBUILD_TARGET),haiku)
1154	VBOX_PATH_APP_PRIVATE = /boot/system/apps/VirtualBox
1155	endif
1156	endif
1157	# Where the architecture specific application files are (going to be) installed.
1158	#VBOX_PATH_APP_PRIVATE_ARCH = /usr/lib/virtualbox
1159	ifdef VBOX_WITH_HARDENING
1160	if1of ($(KBUILD_TARGET), solaris)
1161	VBOX_PATH_APP_PRIVATE_ARCH_TOP = $(VBOX_PATH_APP_PRIVATE)
1162	VBOX_PATH_APP_PRIVATE_ARCH = $(VBOX_PATH_APP_PRIVATE_ARCH_TOP)/$(if-expr $(KBUILD_TARGET_ARCH) == "amd64",amd64,i386)
1163	else ifdef VBOX_PATH_APP_PRIVATE
1164	VBOX_PATH_APP_PRIVATE_ARCH = $(VBOX_PATH_APP_PRIVATE)
1165	endif
1166	endif
1167	# Where the shared libraries are (going to be) installed.
1168	#VBOX_PATH_SHARED_LIBS = /usr/lib
1169	ifdef VBOX_WITH_HARDENING
1170	if1of ($(KBUILD_TARGET), solaris)
1171	VBOX_PATH_SHARED_LIBS = $(VBOX_PATH_APP_PRIVATE)/$(if-expr $(KBUILD_TARGET_ARCH) == "amd64",amd64,i386)
1172	else ifdef VBOX_PATH_APP_PRIVATE
1173	VBOX_PATH_SHARED_LIBS = $(VBOX_PATH_APP_PRIVATE)
1174	endif
1175	endif
1176	# Where the documentation is (going to be) installed.
1177	#VBOX_PATH_APP_DOCS = /usr/share/doc/virtualbox
1178	ifdef VBOX_WITH_HARDENING
1179	ifdef VBOX_PATH_APP_PRIVATE
1180	VBOX_PATH_APP_DOCS = $(VBOX_PATH_APP_PRIVATE)
1181	endif
1182	endif
1183	# The DT_RPATH/DT_RUNPATH to embed into the binaries (ELF).
1184	# (This one is used for all binaries, there is no need to adjust this
1185	# depending on the location of the object.)
1186	#VBOX_WITH_RUNPATH = /usr/lib/virtualbox
1187	ifdef VBOX_WITH_HARDENING
1188	if1of ($(KBUILD_TARGET), solaris)
1189	VBOX_WITH_RUNPATH = $(VBOX_PATH_APP_PRIVATE)/$(if-expr $(KBUILD_TARGET_ARCH) == "amd64",amd64,i386)
1190	else if1of ($(KBUILD_TARGET), freebsd linux)
1191	VBOX_WITH_RUNPATH = $(VBOX_PATH_APP_PRIVATE)
1192	endif
1193	endif
1194	# Enable use of the $ORIGIN DT_RPATH/DT_RUNPATH feature (ELF).
1195	# Because of the setuid usage on all ELF platforms when hardening the build
1196	# things gets a bit complicated since the $ORIGIN+setuid policy differs.
1197	#VBOX_WITH_ORIGIN = 1
1198	ifndef VBOX_WITH_HARDENING
1199	if1of ($(KBUILD_TARGET), freebsd linux netbsd openbsd solaris) # duplicated further down
1200	VBOX_WITH_ORIGIN = 1
1201	endif
1202	endif
1203	# Building windows without a kernel code signing certificate (as good as
1204	# impossible to get these days, so enabled by default).
1205	VBOX_WITHOUT_WINDOWS_KERNEL_CODE_SIGNING_CERT = 1
1206	# Enable the system wide support service/daemon.
1207	# Very sketchy work in progress.
1208	#VBOX_WITH_SUPSVC = 1
1209
1210	# Continue to support Vista w/o any service pack, at least for now.
1211	VBOX_WITH_VISTA_NO_SP = 1
1212	ifdef VBOX_WITH_VBOXDRV
1213	# Enable image verification on darwin @bugref{9232}.
1214	VBOX_WITH_DARWIN_R0_DARWIN_IMAGE_VERIFICATION = 1
1215	endif
1216	## @}
1217
1218
1219	# Strip binaries of release and profile builds before packing them into the installer
1220	# archive. When building .deb/.rpms, don't strip the symbols as they are required for
1221	# the debug packages containing symbols for gdb located in /usr/lib/debug.
1222	# In rpm Additions we also need to do part of packing without strip.
1223	ifndef VBOX_ONLY_RPM_ADDITIONS
1224	VBOX_DO_STRIP := $(if $(filter release profile,$(KBUILD_TYPE)),1,)
1225	endif
1226
1227
1228	#
1229	# Config items for enabling work in progress.
1230	#
1231	# It's good pratice to add stuff here even if it is currently disabled by
1232	# default.
1233	#
1234	# Note! Please, do not add stuff to the global DEFS unless it is really
1235	# necessary! The other guys will hate for it you when they have to
1236	# recompile everything when the feature is enabled or disabled. Put
1237	# the ifdefs in target or template definitions.
1238	#
1239
1240	# Mask all Local APIC interrupt vectors which are set up to NMI mode when switching
1241	# to/from the guest in raw mode. Modern Linux kernels use the performance counter
1242	# to raise an NMI from time to time.
1243	if1of ($(KBUILD_TARGET), linux)
1244	VBOX_WITH_VMMR0_DISABLE_LAPIC_NMI = 1
1245	endif
1246	## For testing deadlock detection and lock order validation.
1247	# If issues are found, create high priority defects and temporarily comment
1248	# the next line.
1249	VBOX_WITH_STRICT_LOCKS = 1
1250	## VBoxSDS is the bridge windows service that sits between
1251	# VirtualBox object client and VBoxSVC that fixes problem
1252	# when multiple VBoxSVC starts for the same user
1253	# it is enabled for windows build only
1254	ifeq ($(KBUILD_TARGET),win)
1255	VBOX_WITH_SDS = 1
1256	endif
1257
1258	#
1259	# To make it easier to build the host side VBox bits and not have to
1260	# care about multiple page sizes right now.
1261	#
1262	ifdef VBOX_WITH_16K_PAGE_SIZE_ON_LINUX_ARM64
1263	VBOX_WITH_STATIC_ARM64_PAGE_SHIFT = 14
1264	else
1265	ifdef VBOX_WITH_4K_PAGE_SIZE_ON_LINUX_ARM64
1266	VBOX_WITH_STATIC_ARM64_PAGE_SHIFT = 10
1267	else
1268	ifdef VBOX_WITH_64K_PAGE_SIZE_ON_LINUX_ARM64
1269	VBOX_WITH_STATIC_ARM64_PAGE_SHIFT = 16
1270	endif
1271	endif
1272	endif
1273
1274	#
1275	# Branding
1276	#
1277	VBOX_BRAND_BIOS_LOGO := $(PATH_ROOT)/src/VBox/Devices/Graphics/BIOS/vbox_bios_splash_oracle.bmp
1278	VBOX_BRAND_LICENSE_HTML := $(PATH_ROOT)/doc/License-gpl-3.0.html
1279	VBOX_BRAND_LICENSE_RTF := $(PATH_ROOT)/doc/License-gpl-3.0.rtf
1280	VBOX_BRAND_LICENSE_TXT := $(PATH_ROOT)/doc/License-gpl-3.0.txt
1281	VBOX_BRAND_LICENSE_VER :=
1282	VBOX_BRAND_GUI_ABOUT_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about.png
1283	VBOX_BRAND_GUI_ABOUT_X2_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_x2.png
1284	VBOX_BRAND_GUI_ABOUT_X3_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_x3.png
1285	VBOX_BRAND_GUI_ABOUT_X4_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_x4.png
1286	VBOX_BRAND_GUI_ABOUT_16PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_16px.png
1287	VBOX_BRAND_GUI_ABOUT_16PX_X2_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_16px_x2.png
1288	VBOX_BRAND_GUI_ABOUT_16PX_X3_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_16px_x3.png
1289	VBOX_BRAND_GUI_ABOUT_16PX_X4_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_16px_x4.png
1290	VBOX_BRAND_GUI_VBOX_16PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_16px.png
1291	VBOX_BRAND_GUI_VBOX_20PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_20px.png
1292	VBOX_BRAND_GUI_VBOX_32PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_32px.png
1293	VBOX_BRAND_GUI_VBOX_40PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_40px.png
1294	VBOX_BRAND_GUI_VBOX_48PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_48px.png
1295	VBOX_BRAND_GUI_VBOX_64PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_64px.png
1296	VBOX_BRAND_GUI_VBOX_SVG := $(PATH_ROOT)/src/VBox/Artwork/NonOSE/virtualbox.svg
1297	VBOX_BRAND_WIN_INST_DLGJPG := $(PATH_ROOT)/src/VBox/Installer/win/Binary/Dialog.jpg
1298	VBOX_BRAND_WIN_INST_EXT :=
1299	VBOX_BRAND_WIN_ADD_INST_DLGBMP := $(PATH_ROOT)/src/VBox/Additions/WINNT/Installer/welcome.bmp
1300	VBOX_BRAND_DARWIN_DISKIMAGE_DS_STORE := $(PATH_ROOT)/src/VBox/Installer/darwin/DiskImage/DS_Store
1301	VBOX_BRAND_DARWIN_DISKIMAGE_BG := $(PATH_ROOT)/src/VBox/Installer/darwin/DiskImage/vbox_folder.tiff
1302	VBOX_BRAND_DARWIN_INSTALLER_BG := $(PATH_ROOT)/src/VBox/Installer/darwin/VirtualBox_mpkg/background.tif
1303
1304	#
1305	# Skip stuff.
1306	#
1307
1308	ifdef VBOX_ONLY_EXTPACKS
1309	# Clear some VBOX_WITH_XXX variables instead of adding ifdefs all over the place.
1310	VBOX_WITH_DEBUGGER =
1311	VBOX_WITH_ADDITIONS =
1312	VBOX_WITH_VBOXDRV =
1313	VBOX_WITH_TESTCASES =
1314	endif
1315
1316	# VBOX_QUICK can be used by core developers to speed to the build
1317	ifdef VBOX_QUICK
1318	# undefine variables by assigning blank.
1319	VBOX_WITH_ADDITIONS =
1320	VBOX_WITH_VALIDATIONKIT =
1321	VBOX_WITH_TESTCASES =
1322	VBOX_WITH_VBOXSDL =
1323	VBOX_WITH_HEADLESS =
1324	VBOX_WITH_VRDP =
1325	VBOX_WITH_VRDP_RDESKTOP =
1326	VBOX_WITH_DOCS =
1327	VBOX_WITH_WEBSERVICES =
1328	VBOX_WITH_32_ON_64_MAIN_API =
1329	endif # VBOX_QUICK
1330
1331	# Only AMD64 is supported for the main product, so disable most of the other bits.
1332	ifn1of ($(KBUILD_TARGET_ARCH), $(VBOX_SUPPORTED_HOST_ARCHS))
1333	VBOX_WITH_MAIN =
1334	VBOX_WITH_QTGUI =
1335	VBOX_WITH_VBOXSDL =
1336	VBOX_WITH_VBOXHEADLESS =
1337	VBOX_WITH_WEBSERVICES =
1338	VBOX_WITH_DEBUGGER_GUI =
1339	endif
1340
1341	ifeq ($(KBUILD_TARGET),darwin)
1342	VBOX_WITH_VRDP_RDESKTOP =
1343	# Permanent (no working SDL).
1344	VBOX_WITH_VBOXSDL =
1345
1346	ifeq ($(KBUILD_TARGET_ARCH),arm64)
1347	# No Qt yet, so no GUI, NLS or qhelp.
1348	VBOX_WITH_NLS :=
1349	VBOX_WITH_MAIN_NLS :=
1350	VBOX_WITH_PUEL_NLS :=
1351	VBOX_WITH_VBOXMANAGE_NLS :=
1352	VBOX_WITH_DOCS_QHELP :=
1353	VBOX_WITH_DOCS_QHELP_PACKING :=
1354	# Skip webservices as those are tedious to build.
1355	VBOX_WITH_WEBSERVICES :=
1356	# Ditto for the java<->XPCOM bridge.
1357	VBOX_WITH_JXPCOM :=
1358	endif
1359
1360	ifdef VBOX_WITH_DRIVERLESS_FORCED
1361	# No need for hardening when not using the driver.
1362	VBOX_WITH_HARDENING :=
1363	endif
1364	endif
1365
1366	ifeq ($(KBUILD_TARGET),freebsd)
1367	VBOX_WITH_DOCS =
1368	endif
1369
1370	ifeq ($(KBUILD_TARGET),haiku)
1371	VBOX_WITH_VRDP_RDESKTOP =
1372	# Permanent (no working SDL).
1373	VBOX_WITH_VBOXSDL =
1374	VBOX_WITH_DOCS =
1375	VBOX_WITH_VBOXDRV =
1376	VBOX_WITH_VRDP =
1377	VBOX_WITH_HEADLESS =
1378	VBOX_WITH_VBOXSDL =
1379	VBOX_WITH_QTGUI =
1380	# VBOX_WITH_MAIN=
1381	VBOX_WITH_DOCS =
1382	VBOX_WITH_ISCSI =
1383	VBOX_WITH_INIP =
1384	VBOX_WITH_INTERNAL_NETWORKING =
1385	VBOX_WITH_PDM_ASYNC_COMPLETION =
1386	VBOX_WITH_HARDENING =
1387	endif
1388
1389
1390	ifeq ($(KBUILD_TARGET),os2)
1391	VBOX_WITH_WEBSERVICES =
1392	VBOX_WITH_INSTALLER =
1393	VBOX_WITH_VRDP_AUTHMOD =
1394	VBOX_WITH_VRDP_RDESKTOP =
1395	VBOX_WITH_VALIDATIONKIT =
1396	VBOX_WITH_QTGUI =
1397	VBOX_WITH_USB =
1398	VBOX_WITH_EHCI =
1399	VBOX_WITH_DOCS =
1400	VBOX_WITH_PDM_ASYNC_COMPLETION =
1401	VBOX_WITH_HARDENING =
1402	endif
1403
1404	ifeq ($(KBUILD_TARGET),win)
1405	VBOX_WITH_VRDP_RDESKTOP =
1406	endif
1407
1408	ifn1of ($(KBUILD_TARGET_ARCH), x86 amd64 arm64)
1409	VBOX_WITH_ADDITION_DRIVERS =
1410	VBOX_WITH_DEBUGGER =
1411	VBOX_WITH_DOCS =
1412	VBOX_WITH_EHCI =
1413	VBOX_WITH_HARDENING =
1414	VBOX_WITH_HEADLESS =
1415	VBOX_WITH_HGCM =
1416	VBOX_WITH_HGSMI =
1417	VBOX_WITH_INIP =
1418	VBOX_WITH_INSTALLER =
1419	VBOX_WITH_INTERNAL_NETWORKING =
1420	VBOX_WITH_ISCSI =
1421	VBOX_WITH_MAIN =
1422	VBOX_WITH_PDM_ASYNC_COMPLETION =
1423	VBOX_WITH_QTGUI =
1424	VBOX_WITH_RAW_MODE =
1425	VBOX_WITH_VALIDATIONKIT =
1426	VBOX_WITH_USB =
1427	VBOX_WITH_VBOXDRV =
1428	VBOX_WITH_VBOXSDL =
1429	VBOX_WITH_WEBSERVICES =
1430	VBOX_WITH_XPCOM =
1431	VBOX_WITHOUT_HARDENING = 1
1432	# remove later:
1433	VBOX_WITH_VRDP =
1434	VBOX_WITH_VRDP_AUTHMOD =
1435	VBOX_WITH_VRDP_RDESKTOP =
1436	endif
1437
1438
1439	#
1440	# Include automatic and local config file to override the above settings
1441	# and to provide defaults for the settings below this point.
1442	#
1443	ifndef AUTOCFG
1444	AUTOCFG := $(wildcard $(PATH_ROOT)/AutoConfig.kmk)
1445	endif
1446	ifneq ($(AUTOCFG),)
1447	include $(AUTOCFG)
1448	endif
1449
1450	ifndef LOCALCFG
1451	LOCALCFG := $(wildcard $(PATH_ROOT)/LocalConfig.kmk)
1452	ifneq ($(LOCALCFG),)
1453	include $(LOCALCFG)
1454	endif
1455	else
1456	# Ignore it if it doesn't exist.
1457	if exists "$(LOCALCFG)"
1458	include $(LOCALCFG)
1459	else
1460	$(warning LOCALCFG='$(LOCALCFG)' does not exist)
1461	override LOCALCFG :=
1462	endif
1463	endif
1464
1465
1466	#
1467	# Configure 'parfait' and 'parfait-dbg' builds.
1468	#
1469	# We ASSUME that anyone doing this kind of build has the parfait tools
1470	# package already fetched using:
1471	# kmk VBOX_WITH_PARFAIT=1 -C tools fetch
1472	#
1473	if1of ($(KBUILD_TYPE), parfait parfait-dbg)
1474	VBOX_WITH_PARFAIT := 1
1475	VBOX_WITHOUT_PRECOMPILED_HEADERS := 1 # @todo Remove when working everywhere
1476	endif
1477
1478
1479	if defined(VBOX_WITH_PARFAIT)
1480	#
1481	# This includes the tool overrides for running with parfait.
1482	# Ideally there would be a dedicated parfait tool but when targetting
1483	# different hosts with different compiler toolchains and compiler flags
1484	# we would have to duplicate a lot of the already existing tools for each
1485	# supported toolchain. Instead we just override the paths to the compilers
1486	# for the currently used tools (as this is kind of static and doesn't change that often).
1487	# To not clutter this file too much this lives in a separate file.
1488	#
1489	include $(PATH_ROOT)/tools/ParfaitConfig.kmk
1490	endif
1491
1492
1493	#
1494	# Allow to overwrite the branding information from an external file
1495	#
1496	ifdef VBOX_BRANDING_CFG
1497	include $(VBOX_BRANDING_CFG)
1498	endif
1499
1500	#
1501	# Bitch about old settings.
1502	#
1503	ifdef VBOX_WITHOUT_LINUX_COMPILER_H
1504	$(warning VBOX_WITHOUT_LINUX_COMPILER_H was renamed to VBOX_WITH_LINUX_COMPILER_H, the meaning is inverted.)
1505	endif
1506
1507	#
1508	# Indicate VBOX_ONLY build if any of the VBOX_ONLY_* variables are set.
1509	#
1510	VBOX_ONLY_BUILD_NEW := $(strip $(foreach x, ADDITIONS DOCS EXTPACKS SDK VALIDATIONKIT \
1511	, $(if-expr defined(VBOX_ONLY_$(x)),VBOX_ONLY_$(x))))
1512	ifneq ($(VBOX_ONLY_BUILD),$(VBOX_ONLY_BUILD_NEW))
1513	$(error VBox: LocalConfig.kmk changed the VBOX_ONLY_ build status, VBOX_ONLY_* must be on the kmk command line or in the environment: $(VBOX_ONLY_BUILD) -> $(VBOX_ONLY_BUILD_NEW))
1514	endif
1515
1516	#
1517	# Enforce VBOX_WITH_NLS. It controls all NLS (except the GUI at the moment).
1518	#
1519	if defined(VBOX_WITH_MAIN_NLS) \|\| defined(VBOX_WITH_PUEL_NLS) \|\| defined(VBOX_WITH_VBOXMANAGE_NLS)
1520	VBOX_WITH_NLS := 1
1521	ifndef VBOX_WITH_NLS # (We test again to account for 'override VBOX_WITH_NLS :=')
1522	VBOX_WITH_MAIN_NLS :=
1523	VBOX_WITH_PUEL_NLS :=
1524	VBOX_WITH_VBOXMANAGE_NLS :=
1525	endif
1526	endif
1527
1528	#
1529	# For the docs build box.
1530	#
1531	ifdef VBOX_ONLY_DOCS
1532	# Always produce HTML docs (for publishing on website as part of release)
1533	VBOX_WITH_DOCS_HTML = 1
1534	# Always produce QHelp docs (for help in the UI, replacing CHM)
1535	VBOX_WITH_DOCS_QHELP = 1
1536	VBOX_WITH_TOOLS_QT_LINUX = 1
1537	endif
1538
1539	#
1540	# Disable components that are not open sourced.
1541	#
1542	ifdef VBOX_OSE
1543	VBOX_WITH_VRDP =
1544	VBOX_WITH_USB_VIDEO_IMPL =
1545	VBOX_WITH_NVME_IMPL =
1546	VBOX_WITH_EXTPACK_PUEL =
1547	VBOX_WITH_EXTPACK_PUEL_BUILD =
1548	VBOX_WITH_PCI_PASSTHROUGH_IMPL =
1549	VBOX_WITH_OS2_ADDITIONS_BIN =
1550	VBOX_WITH_LIBSSH =
1551	# not yet
1552	VBOX_WITH_PLUGIN_CRYPT =
1553	VBOX_WITH_DRAG_AND_DROP_PROMISES =
1554	ifn1of ($(KBUILD_TARGET), linux)
1555	VBOX_WITH_DOCS =
1556	VBOX_WITH_DOCS_PACKING =
1557	endif
1558	if1of ($(KBUILD_TARGET), solaris)
1559	VBOX_WITH_32_ON_64_MAIN_API =
1560	endif
1561	if1of ($(KBUILD_TARGET), win)
1562	# tar/gzip uncommon on Windows
1563	VBOX_WITH_EXTPACK_VBOXDTRACE =
1564	endif
1565	# Enable any translations in OSE, even partial ones.
1566	ifndef ($(VBOX_NO_DOCS_TRANSLATIONS))
1567	VBOX_WITH_DOCS_TRANSLATIONS = 1
1568	endif
1569	VBOX_WITH_INTEL_PXE =
1570	# Disable for OSE, requires snv_159+.
1571	VBOX_WITH_NETFLT_CROSSBOW =
1572	ifn1of ($(KBUILD_TARGET), darwin linux solaris win)
1573	VBOX_WITH_INSTALLER =
1574	endif
1575	if1of ($(KBUILD_TARGET), win)
1576	# Undefine codec libraries which are not needed.
1577	VBOX_WITH_LIBVPX =
1578	VBOX_WITH_LIBVORBIS =
1579	VBOX_WITH_LIBOGG =
1580	# Disable recording (with audio support).
1581	VBOX_WITH_RECORDING =
1582	VBOX_WITH_AUDIO_RECORDING =
1583	endif
1584	# branding
1585	VBOX_BRAND_LICENSE_HTML := $(PATH_ROOT)/doc/License-gpl-3.0.html
1586	VBOX_BRAND_LICENSE_RTF := $(PATH_ROOT)/doc/License-gpl-3.0.rtf
1587	VBOX_BRAND_LICENSE_TXT := $(PATH_ROOT)/doc/License-gpl-3.0.txt
1588	VBOX_BRAND_LICENSE_VER :=
1589	VBOX_BRAND_BIOS_LOGO := $(PATH_ROOT)/src/VBox/Devices/Graphics/BIOS/vbox_bios_splash.bmp
1590	VBOX_BRAND_GUI_ABOUT_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about.png
1591	VBOX_BRAND_GUI_ABOUT_X2_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_x2.png
1592	VBOX_BRAND_GUI_ABOUT_X3_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_x3.png
1593	VBOX_BRAND_GUI_ABOUT_X4_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_x4.png
1594	VBOX_BRAND_GUI_ABOUT_16PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_16px.png
1595	VBOX_BRAND_GUI_ABOUT_16PX_X2_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_16px_x2.png
1596	VBOX_BRAND_GUI_ABOUT_16PX_X3_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_16px_x3.png
1597	VBOX_BRAND_GUI_ABOUT_16PX_X4_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_16px_x4.png
1598	VBOX_BRAND_GUI_VBOX_16PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_16px.png
1599	VBOX_BRAND_GUI_VBOX_20PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_20px.png
1600	VBOX_BRAND_GUI_VBOX_32PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_32px.png
1601	VBOX_BRAND_GUI_VBOX_40PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_40px.png
1602	VBOX_BRAND_GUI_VBOX_48PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_48px.png
1603	VBOX_BRAND_GUI_VBOX_64PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_64px.png
1604	VBOX_BRAND_GUI_VBOX_SVG := $(PATH_ROOT)/src/VBox/Artwork/OSE/virtualbox.svg
1605	endif
1606
1607	#
1608	# VBOX_WITHOUT_HARDENING is for developers (put in LocalConfig.kmk).
1609	# Note that this is a bit rough since hardening governs more than one
1610	# variable... Also note that we allow VBOX_WITH_HARDENING=1 on the
1611	# command line to overrule VBOX_WITHOUT_HARDENING (the check below).
1612	#
1613	ifdef VBOX_WITHOUT_HARDENING
1614	VBOX_WITH_HARDENING =
1615	ifeq ($(VBOX_WITH_HARDENING),)
1616	VBOX_PATH_APP_PRIVATE =
1617	VBOX_PATH_APP_PRIVATE_ARCH =
1618	VBOX_PATH_APP_PRIVATE_ARCH_TOP =
1619	VBOX_PATH_SHARED_LIBS =
1620	VBOX_PATH_APP_DOCS =
1621	VBOX_WITH_RUNPATH =
1622	if1of ($(KBUILD_TARGET), freebsd linux netbsd openbsd solaris) # duplicated up above
1623	VBOX_WITH_ORIGIN = 1
1624	endif
1625	endif
1626	endif
1627
1628	#
1629	# Sanitize the additions build config variables.
1630	#
1631	ifdef VBOX_WITH_ADDITIONS_FROM_BUILD_SERVER
1632	VBOX_WITHOUT_ADDITIONS := 1
1633	ifdef VBOX_ONLY_ADDITIONS
1634	$(error VBOX_ONLY_ADDITIONS + VBOX_WITH_ADDITIONS_FROM_BUILD_SERVER does not add up!)
1635	endif
1636	endif
1637
1638	ifdef VBOX_ONLY_ADDITIONS
1639	ifdef VBOX_WITHOUT_ADDITIONS
1640	$(error VBOX_ONLY_ADDITIONS + VBOX_WITHOUT_ADDITIONS does not add up!)
1641	endif
1642	ifndef VBOX_WITH_ADDITIONS
1643	$(error VBOX_ONLY_ADDITIONS + unset VBOX_WITH_ADDITIONS does not add up!)
1644	endif
1645	endif
1646
1647	ifdef VBOX_WITHOUT_ADDITIONS
1648	# Zap anything that could be contradicting this.
1649	VBOX_WITH_ADDITIONS :=
1650	endif
1651
1652	#
1653	# Sanitize the documentation build config variables.
1654	#
1655	ifdef VBOX_WITH_DOCS_FROM_BUILD_SERVER
1656	VBOX_WITHOUT_DOCS := 1
1657	ifdef VBOX_ONLY_DOCS
1658	$(error VBOX_ONLY_DOCS + VBOX_WITH_DOCS_FROM_BUILD_SERVER does not add up!)
1659	endif
1660	else ifeq ($(KBUILD_HOST),solaris)
1661	# We require JDK 17 for the user manual now, and since that isn't available for solaris
1662	# (see JEP-381) we're forced to get the docs from the doc build server or disable them.
1663	VBOX_WITHOUT_DOCS := 1
1664	endif
1665
1666	ifdef VBOX_ONLY_DOCS
1667	ifdef VBOX_WITHOUT_DOCS
1668	$(error VBOX_ONLY_DOCS + VBOX_WITHOUT_DOCS does not add up!)
1669	endif
1670	endif
1671
1672	ifdef VBOX_WITHOUT_DOCS
1673	# Zap anything that could be contradicting this.
1674	VBOX_WITH_DOCS :=
1675	VBOX_WITH_DOCS_QHELP :=
1676	VBOX_WITH_DOCS_HTML :=
1677	endif
1678
1679	#
1680	# Disable components for headless
1681	#
1682	ifdef VBOX_HEADLESS
1683	VBOX_WITH_QTGUI =
1684	VBOX_WITH_VBOXSDL =
1685	VBOX_WITH_VRDP_RDESKTOP =
1686	endif
1687
1688	#
1689	# Undefined VBOX_WITH_MAIN implies exclusion of a few more items.
1690	#
1691	ifndef VBOX_WITH_MAIN
1692	VBOX_WITH_VBOXSDL =
1693	VBOX_WITH_QTGUI =
1694	VBOX_WITH_DEBUGGER_GUI =
1695	VBOX_WITH_HEADLESS =
1696	ifdef VBOX_ONLY_DOCS
1697	$(error Oh, does VBOX_ONLY_DOCS actually end up here. sweet.)
1698	endif
1699	VBOX_WITH_DOCS =
1700	endif
1701
1702	ifdef VBOX_WITH_EXTPACK_PUEL_BUILD
1703	VBOX_WITH_EXTPACK_PUEL = 1
1704	endif
1705
1706	ifdef VBOX_WITH_TESTSUITE
1707	$(warning VBOX_WITH_TESTSUITE was renamed to VBOX_WITH_VALIDATIONKIT)
1708	VBOX_WITH_VALIDATIONKIT = $(VBOX_WITH_TESTSUITE)
1709	endif
1710
1711
1712	#
1713	# Derived indicators.
1714	#
1715
1716	#
1717	# Mark OSE builds clearly, helps figuring out limitations more easily.
1718	#
1719	ifdef VBOX_OSE
1720	# This can be overridden (e.g. in LocalConfig.kmk) by whoever publishes a set
1721	# of VirtualBox binaries. We request though that you always use something that
1722	# clearly identifies your build and makes it clear that it is not one done by
1723	# the VirtualBox team.
1724	VBOX_BUILD_PUBLISHER ?= _OSE
1725	endif
1726
1727	# Keep in sync with G_virtualBoxPackage in glue-jaxws.xsl and glue-java.xsl
1728	# Changed with every new version, so beware!
1729	if $(VBOX_VERSION_BUILD) < 51
1730	VBOX_API_VERSION = $(VBOX_VERSION_MAJOR)_$(VBOX_VERSION_MINOR)
1731	else
1732	VBOX_API_VERSION = $(VBOX_VERSION_MAJOR)_$(expr $(VBOX_VERSION_MINOR) + 1)
1733	endif
1734	VBOX_API_SUFFIX = _$(VBOX_API_VERSION)
1735	VBOX_JAVA_PACKAGE = org.virtualbox$(VBOX_API_SUFFIX)
1736
1737	#
1738	# Derived / helper config indicators. Not configurable.
1739	#
1740
1741	# Use the OpenGL module in qt when the video hardware acceleration feature
1742	# is enabled.
1743	if defined(VBOX_WITH_VIDEOHWACCEL) && defined(VBOX_WITH_QTGUI)
1744	VBOX_GUI_USE_QGL = 1
1745	else
1746	VBOX_GUI_USE_QGL =
1747	endif
1748
1749	# Collection macro mainly for deciding whether VBoxDTrace needs shipping.
1750	VBOX_WITH_DTRACE := $(if-expr defined(VBOX_WITH_DTRACE_R0) \|\| defined(VBOX_WITH_DTRACE_R0DRV) \
1751	\|\| defined(VBOX_WITH_DTRACE_R3) \|\| defined(VBOX_WITH_DTRACE_RC),1,)
1752
1753	# kSubmit / kWorker is only available on windows.
1754	ifdef VBOX_USE_KSUBMIT
1755	ifeq ($(KBUILD_HOST),win)
1756	TOOL_VCC142AMD64_USE_KSUBMIT := 1
1757	TOOL_VCC142X86_USE_KSUBMIT := 1
1758	# TOOL_VCC120AMD64_USE_KSUBMIT := 1
1759	# TOOL_VCC120X86_USE_KSUBMIT := 1
1760	TOOL_VCC100AMD64_USE_KSUBMIT := 1
1761	TOOL_VCC100X86_USE_KSUBMIT := 1
1762	TOOL_QT5_USE_KSUBMIT := 1
1763	TOOL_OPENWATCOM_USE_KSUBMIT := 1
1764	TOOL_YASM_USE_KSUBMIT := 1
1765	TOOL_NASM_USE_KSUBMIT := 1
1766	TOOL_VBoxNasm_USE_KSUBMIT := 1
1767	else
1768	VBOX_USE_KSUBMIT :=
1769	endif
1770	endif
1771
1772	#
1773	# Requested permissions to the host OS (only the entitlements
1774	# crap on darwin for now).
1775	#
1776	ifeq ($(KBUILD_TARGET),darwin)
1777	#
1778	# Common entitlements for the main and VM process bundle.
1779	#
1780	# The following two are required in the main bundle even though they apply only to the VM
1781	# process. The issue is that TCC is looking up the primary bundle for these entitlements
1782	# and crashes the VM process if the entitlements are not here even though they are used
1783	# in the VM process only. This is not documented anywhere by Apple.
1784	# From Console.app when these are missing:
1785	# tccd: [com.apple.TCC:access] Prompting policy for hardened runtime; service:
1786	# kTCCServiceMicrophone requires entitlement com.apple.security.device.audio-input but it is missing for
1787	# RESP:{
1788	# ID: org.virtualbox.app.VirtualBox,
1789	# PID[17253],
1790	# auid: 501,
1791	# euid: 501,
1792	# responsible path: '/Applications/VirtualBox.app/Contents/MacOS/VirtualBox',
1793	# binary path: '/Applications/VirtualBox.app/Contents/MacOS/VirtualBox'
1794	# },
1795	# REQ:{
1796	# ID: org.virtualbox.app.VirtualBoxVM,
1797	# PID[17331],
1798	# auid: 501,
1799	# euid: 501,
1800	# binary path: '/Applications/VirtualBox.app/Contents/Resources/VirtualBoxVM.app/Contents/MacOS/VirtualBoxVM'
1801	# }
1802	VBOX_DARWIN_ENTITLEMENTS_LIST_COMMON := \
1803	com.apple.security.device.audio-input \
1804	com.apple.security.device.camera
1805
1806	#
1807	# The first two entitlements are required to get everything working
1808	# on Catalina which we want to keep supported for now:
1809	#
1810	# The first entitlement allows us to have unsigned executable memory in the guests
1811	# address space like the BIOS code (and essentially all the guests address space which
1812	# is mapped as RWX).
1813	# The second entitlement is required in order to map guest memory as RWX into the
1814	# guests address space.
1815	# These entitlements are not required starting with BigSur+ where Apple has clearly
1816	# changed something in their entitlement scheme without properly documenting it.
1817	#
1818	# allow-jit - for the recompiler in order to be able to generate and execute native code.
1819	# audio-input - recording audio from a guest.
1820	# camera - accessing the webcam from a guest.
1821	# usb - USB passthrough.
1822	# hypervisor - Hypervisor entitlement in order to be able to use Hypervisor.framework
1823	#
1824	VBOX_DARWIN_ENTITLEMENTS_LIST_VM := \
1825	$(VBOX_DARWIN_ENTITLEMENTS_LIST_COMMON) \
1826	com.apple.security.cs.allow-unsigned-executable-memory \
1827	com.apple.security.cs.disable-executable-page-protection \
1828	com.apple.security.cs.allow-jit \
1829	com.apple.security.device.usb \
1830	com.apple.security.hypervisor
1831
1832	#
1833	# The device-access and networking entitlements are reserved for
1834	# only specific vendors and are only available in release mode signing
1835	# (binaries signed with these entitlements in adhoc mode will just crash
1836	# with a code signing error).
1837	#
1838	ifeq ($(VBOX_SIGNING_MODE),release)
1839	VBOX_DARWIN_ENTITLEMENTS_LIST_VM += \
1840	com.apple.vm.device-access \
1841	com.apple.vm.networking
1842	endif
1843
1844	# Where the dynamic generated entitlements can be found.
1845	VBOX_DARWIN_ENTITLEMENTS_FILE := $(PATH_OUT)/Entitlements.plist
1846	VBOX_DARWIN_ENTITLEMENTS_FILE_VM := $(PATH_OUT)/EntitlementsVM.plist
1847	endif
1848
1849
1850	#
1851	# List of OSes and architectures we may possibly try build on/for.
1852	# This is used for the complicated assembler setup among other things.
1853	#
1854	VBOX_TARGET_OSES := freebsd darwin haiku linux netbsd openbsd solaris darwin os2 win
1855	VBOX_TARGET_ARCHES := amd64 x86 arm64 sparc32 sparc64
1856
1857	#
1858	# VBOX_GCC_TOOL is the kBuild tool name for gcc or clang.
1859	# VBOX_GCC32_TOOL is the same for 32-bit x86 code.
1860	#
1861	# Note! On Windows only the arm64 variant makes use of it.
1862	#
1863	ifndef VBOX_GCC_TOOL
1864	ifeq ($(KBUILD_TARGET),win)
1865	ifeq ($(KBUILD_TARGET_ARCH),arm64)
1866	VBOX_GCC_TOOL := VCC143-CLANGXX
1867	endif
1868	else ifeq ($(KBUILD_TARGET),os2)
1869	VBOX_GCC_TOOL := GXX3OMF
1870	else ifeq ($(KBUILD_TARGET),darwin)
1871	ifdef VBOX_WITH_EVEN_NEWER_XCODE
1872	VBOX_GCC_TOOL := CLANGXXMACHO
1873	DARWINCMN_TOOLCHAIN_DIRS_IGNORE_DEVTOOLS = 1# Use the system toolchains, not anything from tools/darwin.*.
1874	else ifdef VBOX_WITH_NEW_XCODE
1875	VBOX_GCC_TOOL := VBoxXcode62
1876	else
1877	VBOX_GCC_TOOL := GXX4MACHO
1878	endif
1879	else ifeq ($(KBUILD_TARGET),haiku)
1880	# Haiku shouldn't pass '-r' to the linker by default
1881	VBOX_GCC_TOOL := GXX3PLAIN
1882	else ifeq ($(KBUILD_TARGET),solaris)
1883	VBOX_GCC_TOOL := GXX3PLAIN
1884	VBOX_GCC32_TOOL := GCC3PLAIN
1885	ifeq ($(KBUILD_HOST),solaris)
1886	TOOL_GXX3PLAIN_LD_SYSMOD ?= /usr/ccs/bin/ld
1887	endif
1888	else
1889	VBOX_GCC_TOOL := GXX3
1890	ifeq ($(KBUILD_TARGET_ARCH).$(KBUILD_HOST_ARCH),x86.amd64) ## @todo mixing target/host here!
1891	VBOX_GCC_TOOL := GXX32
1892	VBOX_WITH_VBOXDRV =
1893	else ifeq ($(KBUILD_TARGET_ARCH).$(KBUILD_HOST_ARCH),amd64.x86)
1894	VBOX_GCC_TOOL := GXX64
1895	VBOX_WITH_VBOXDRV =
1896	endif
1897	endif
1898	endif
1899
1900	if1of ($(KBUILD_TARGET_ARCH), amd64 x86)
1901	ifn1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), win.x86 win.amd64)
1902	ifndef VBOX_GCC32_TOOL
1903	ifeq ($(KBUILD_TARGET_ARCH),x86)
1904	VBOX_GCC32_TOOL := $(VBOX_GCC_TOOL)
1905	else
1906	VBOX_GCC32_TOOL := GCC32
1907	endif
1908	endif
1909	endif
1910	endif
1911
1912	#
1913	# Decide which Visual C++ compiler version we're using by default.
1914	#
1915	ifndef VBOX_VCC_TOOL_STEM
1916	ifdef VBOX_WITH_NEW_VCC
1917	VBOX_VCC_TOOL_STEM := VCC143
1918	else
1919	VBOX_VCC_TOOL_STEM := VCC142
1920	endif
1921	else ifn1of ($(VBOX_VCC_TOOL_STEM), VCC100 VCC110 VCC120 VCC140 VCC141 VCC142 VCC143)
1922	$(error VBox: VBOX_VCC_TOOL_STEM='$(VBOX_VCC_TOOL_STEM)' is not supported, only VCC100, VCC110, VCC120, VCC140, VCC141, VCC142, VCC143 are)
1923	endif
1924	ifndef VBOX_VCC_TOOL
1925	VBOX_VCC_TOOL := $(VBOX_VCC_TOOL_STEM)$(toupper $(KBUILD_TARGET_ARCH))
1926	endif
1927
1928	#
1929	# Decide which Visual C++ compiler version we're using for newer stuff.
1930	#
1931	ifndef VBOX_NEWER_VCC_TOOL_STEM
1932	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
1933	VBOX_NEWER_VCC_TOOL_STEM := $(VBOX_VCC_TOOL_STEM)
1934	else
1935	VBOX_NEWER_VCC_TOOL_STEM := VCC120
1936	endif
1937	else ifn1of ($(VBOX_NEWER_VCC_TOOL_STEM), VCC120 VCC140 VCC141 VCC142 VCC143)
1938	$(error VBox: VBOX_NEWER_VCC_TOOL_STEM='$(VBOX_NEWER_VCC_TOOL_STEM)' is not supported)
1939	endif
1940	ifndef VBOX_NEWER_VCC_TOOL
1941	VBOX_NEWER_VCC_TOOL := $(VBOX_NEWER_VCC_TOOL_STEM)$(toupper $(KBUILD_TARGET_ARCH))
1942	endif
1943
1944	# Temporary measure while kBuild / tools updates their define quoting.
1945	ifdef KMK_WITH_QUOTING
1946	if ("$(VBOX_VCC_TOOL_STEM)" >= "VCC140" && "$(KBUILD_TARGET)" == "win") \
1947	\|\| ("$(KBUILD_TARGET)" != "darwin" && "$(KBUILD_TARGET)" != "win" && "$(KMK_REVISION)" >= 3566) \
1948	\|\| ("$(KBUILD_TARGET)" == "darwin" && "$(KMK_REVISION)" >= 3579)
1949	VBOX_WITH_AUTOMATIC_DEFS_QUOTING := 1
1950	endif
1951	endif
1952
1953
1954	#
1955	# Image and object format config.
1956	#
1957	VBOX_LDR_FMT.freebsd := elf
1958	VBOX_LDR_FMT.haiku := elf
1959	VBOX_LDR_FMT.linux := elf
1960	VBOX_LDR_FMT.netbsd := elf
1961	VBOX_LDR_FMT.openbsd := elf
1962	VBOX_LDR_FMT.solaris := elf
1963	VBOX_LDR_FMT.darwin := macho
1964	VBOX_LDR_FMT.os2 := lx
1965	VBOX_LDR_FMT.win := pe
1966	# Spread the above OS-level defaults to os+architecture specifics:
1967	$(foreach os,$(VBOX_TARGET_OSES),$(foreach arch,$(VBOX_TARGET_ARCHES)\
1968	,$(eval VBOX_LDR_FMT.$(os).$(arch) := $(VBOX_LDR_FMT.$(os)))))
1969	# os.arch overrides:
1970	VBOX_LDR_FMT.os2.amd64 := elf
1971	# The build target format.
1972	VBOX_LDR_FMT := $(firstword $(VBOX_LDR_FMT.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) $(VBOX_LDR_FMT.$(KBUILD_TARGET)))
1973	# Legacy:
1974	VBOX_LDR_FMT32 := $(firstword $(VBOX_LDR_FMT.$(KBUILD_TARGET).x86) $(VBOX_LDR_FMT))
1975	VBOX_LDR_FMT64 := $(firstword $(VBOX_LDR_FMT.$(KBUILD_TARGET).amd64) $(VBOX_LDR_FMT))
1976	if1of (os2, $(KBUILD_TARGET) $(KBUILD_HOST)) # This isn't too helpful
1977	DONT_USE_YASM = 1 # yasm doesn't implement omf yet.
1978	endif
1979
1980	#
1981	# Assembler setup.
1982	#
1983	# This is a bit complicated since we have to support two different assmblers
1984	# (yasm/nasm) and possibly two different formats (32-bit/64-bit).
1985	#
1986
1987	# First the assembler tool.
1988	VBOX_ASTOOL.x86 := $(if-expr defined(DONT_USE_YASM),NASM,YASM)
1989	VBOX_ASTOOL.amd64 := $(if-expr defined(DONT_USE_YASM),NASM,YASM)
1990	VBOX_ASTOOL.arm64 := $(VBOX_GCC_TOOL)
1991	VBOX_ASTOOL.sparc32 := $(VBOX_GCC_TOOL)
1992	VBOX_ASTOOL.sparc64 := $(VBOX_GCC_TOOL)
1993	# Spread the above OS-level defaults to os+architecture specifics:
1994	$(foreach os,$(VBOX_TARGET_OSES),$(foreach arch,$(VBOX_TARGET_ARCHES)\
1995	,$(eval VBOX_ASTOOL.$(os).$(arch) := $(VBOX_ASTOOL.$(arch)))))
1996	# os.arch overrides:
1997	VBOX_ASTOOL.os2.x86 := NASM
1998
1999	# Assembler tool flag config.
2000	VBOX_YASM_ASFLAGS.elf.x86 = -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) -f elf32 -DASM_FORMAT_ELF -g dwarf2
2001	VBOX_YASM_ASFLAGS.elf.amd64 = -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) -f elf64 -DASM_FORMAT_ELF -g dwarf2
2002	VBOX_YASM_ASFLAGS.macho.x86 = -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) -f macho32 -DASM_FORMAT_MACHO #-g dwarf2
2003	VBOX_YASM_ASFLAGS.macho.amd64 = -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) -f macho64 -DASM_FORMAT_MACHO #-g dwarf2
2004	VBOX_YASM_ASFLAGS.pe.x86 = -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) -f win32 -DASM_FORMAT_PE -g cv8
2005	VBOX_YASM_ASFLAGS.pe.amd64 = -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) -f win64 -DASM_FORMAT_PE -g cv8
2006	VBOX_YASM_ASFLAGS.lx.x86 = -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) -f obj -DASM_FORMAT_OMF -g stabs
2007	$(foreach os,$(VBOX_TARGET_OSES),$(foreach arch,$(VBOX_TARGET_ARCHES) \
2008	,$(eval VBOX_YASM_ASFLAGS.$(os).$(arch) = $$(VBOX_YASM_ASFLAGS.$(VBOX_LDR_FMT.$(os).$(arch)).$(arch)))))
2009
2010	VBOX_NASM_ASFLAGS.elf.x86 := -D__NASM__ -w+orphan-labels -f elf32 -DASM_FORMAT_ELF -F dwarf
2011	VBOX_NASM_ASFLAGS.elf.amd64 := -D__NASM__ -w+orphan-labels -f elf64 -DASM_FORMAT_ELF -F dwarf
2012	VBOX_NASM_ASFLAGS.macho.x86 := -D__NASM__ -w+orphan-labels -f macho32 -DASM_FORMAT_MACHO -F dwarf
2013	VBOX_NASM_ASFLAGS.macho.amd64 := -D__NASM__ -w+orphan-labels -f macho64 -DASM_FORMAT_MACHO -F dwarf
2014	VBOX_NASM_ASFLAGS.pe.x86 := -D__NASM__ -w+orphan-labels -f win32 -DASM_FORMAT_PE -F cv8
2015	VBOX_NASM_ASFLAGS.pe.amd64 := -D__NASM__ -w+orphan-labels -f win64 -DASM_FORMAT_PE -F cv8
2016	VBOX_NASM_ASFLAGS.lx.x86 := -D__NASM__ -w+orphan-labels -f obj -DASM_FORMAT_OMF -F borland
2017	$(foreach os,$(VBOX_TARGET_OSES),$(foreach arch,$(VBOX_TARGET_ARCHES) \
2018	,$(eval VBOX_NASM_ASFLAGS.$(os).$(arch) = $$(VBOX_NASM_ASFLAGS.$(VBOX_LDR_FMT.$(os).$(arch)).$(arch)))))
2019
2020	ifdef VBOX_GCC_TOOL
2021	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.elf.x86 := -DASM_FORMAT_ELF -m32
2022	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.elf.amd64 := -DASM_FORMAT_ELF -m64
2023	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.elf.arm64 := -DASM_FORMAT_ELF
2024	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.elf.sparc32 := -DASM_FORMAT_ELF -m32
2025	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.elf.sparc64 := -DASM_FORMAT_ELF -m64
2026	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.macho.x86 := -DASM_FORMAT_MACHO -m32
2027	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.macho.amd64 := -DASM_FORMAT_MACHO -m64
2028	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.macho.arm64 := -DASM_FORMAT_MACHO
2029	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.pe.x86 := -DASM_FORMAT_PE
2030	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.pe.amd64 := -DASM_FORMAT_PE
2031	VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.pe.arm64 := -DASM_FORMAT_PE
2032	$(foreach os,$(VBOX_TARGET_OSES),$(foreach arch,$(VBOX_TARGET_ARCHES) \
2033	,$(eval VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.$(os).$(arch) = $$(VBOX_$(VBOX_GCC_TOOL)_ASFLAGS.$(VBOX_LDR_FMT.$(os).$(arch)).$(arch)))))
2034	endif
2035
2036	# Combine the above ASFLAGS with the ASTOOL for each os+arch variation.
2037	$(foreach os,$(VBOX_TARGET_OSES),$(foreach arch,$(VBOX_TARGET_ARCHES) \
2038	,$(eval VBOX_ASFLAGS.$(os).$(arch) = $$(VBOX_$(VBOX_ASTOOL.$(os).$(arch))_ASFLAGS.$(os).$(arch)))))
2039
2040	# Default target:
2041	VBOX_ASTOOL = $(VBOX_ASTOOL.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH))
2042	VBOX_ASFLAGS = $(VBOX_$(VBOX_ASTOOL.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH))_ASFLAGS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH))
2043
2044	# Legacy targets:
2045	VBOX_ASTOOL32 = $(VBOX_ASTOOL.$(KBUILD_TARGET).x86)
2046	VBOX_ASFLAGS32 = $(VBOX_$(VBOX_ASTOOL.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH))_ASFLAGS.$(KBUILD_TARGET).x86)
2047	VBOX_ASFLAGS64 = $(VBOX_$(VBOX_ASTOOL.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH))_ASFLAGS.$(KBUILD_TARGET).amd64)
2048
2049
2050	#
2051	# Default tool nonsense.
2052	#
2053	## @todo Remove the default tool crap here!
2054	TOOL = $(VBOX_GCC_TOOL)
2055	TOOL.win.x86 = $(VBOX_VCC_TOOL_STEM)X86
2056	TOOL.win.amd64 = $(VBOX_VCC_TOOL_STEM)AMD64
2057	ASTOOL := $(VBOX_ASTOOL)
2058
2059
2060	#
2061	# Setup the global defines and includes.
2062	#
2063	# Note! The __SOMETHING__ #defines are deprecated as they violate the C/C++ specs.
2064	#
2065	INCS += $(PATH_ROOT)/include $(PATH_OUT)
2066	DEFS += VBOX
2067	DEFS.debug := DEBUG DEBUG_$(subst $(subst _, ,_),_,$(USERNAME)) DEBUG_USERNAME=$(subst $(subst _, ,_),_,$(USERNAME))
2068	DEFS.dbgopt = $(DEFS.debug)
2069	DEFS.profile = VBOX_WITH_STATISTICS
2070	DEFS.strict = RT_STRICT VBOX_STRICT
2071	DEFS.asan = RT_STRICT VBOX_STRICT
2072	DEFS.parfait = VBOX_WITH_PARFAIT
2073	DEFS.parfait-dbg = VBOX_WITH_PARFAIT
2074	DEFS.x86 = RT_ARCH_X86 __X86__
2075	DEFS.amd64 = RT_ARCH_AMD64 __AMD64__
2076	DEFS.arm64 = RT_ARCH_ARM64
2077	DEFS.sparc32 = RT_ARCH_SPARC
2078	DEFS.sparc64 = RT_ARCH_SPARC64
2079	DEFS.darwin = RT_OS_DARWIN __DARWIN__
2080	DEFS.freebsd = RT_OS_FREEBSD __FREEBSD__
2081	DEFS.haiku = RT_OS_HAIKU
2082	DEFS.linux = RT_OS_LINUX _FILE_OFFSET_BITS=64
2083	DEFS.netbsd = RT_OS_NETBSD
2084	DEFS.openbsd = RT_OS_OPENBSD
2085	DEFS.os2 = RT_OS_OS2
2086	DEFS.os-agnostic = RT_OS_AGNOSTIC
2087	DEFS.solaris = RT_OS_SOLARIS _FILE_OFFSET_BITS=64
2088	DEFS.win = RT_OS_WINDOWS __WIN__
2089	DEFS.win.x86 = __WIN32__
2090	DEFS.win.amd64 = __WIN64__
2091	DEFS.win.arm64 = __WIN64__
2092	# optional defines (use environment or make commandline)
2093	ifdef VBOX_WITH_STATISTICS
2094	DEFS += VBOX_WITH_STATISTICS
2095	endif
2096	ifdef VBOX_STRICT
2097	DEFS += VBOX_STRICT
2098	endif
2099	ifdef LOG_ENABLED
2100	DEFS += LOG_ENABLED
2101	endif
2102	ifdef VBOX_OSE
2103	DEFS += VBOX_OSE
2104	endif
2105	ifdef VBOX_WITH_64_BITS_GUESTS
2106	DEFS += VBOX_WITH_64_BITS_GUESTS
2107	endif
2108	ifdef VBOX_WITH_REM
2109	DEFS += VBOX_WITH_REM
2110	endif
2111	ifdef VBOX_WITH_RAW_MODE
2112	DEFS += VBOX_WITH_RAW_MODE
2113	endif
2114	ifdef VBOX_WITH_DRIVERLESS_FORCED
2115	DEFS += VBOX_WITH_DRIVERLESS_FORCED
2116	endif
2117	ifdef VBOX_WITH_PARFAIT
2118	ifn1of ($(KBUILD_TYPE), parfait parfait-dbg)
2119	DEFS += VBOX_WITH_PARFAIT
2120	endif
2121	ifeq ($(KBUILD_TARGET),win)
2122	DEFS += RT_RELAXED_CALLBACKS_TYPES
2123	endif
2124	endif
2125	ifdef VBOX_WITH_STATIC_ARM64_PAGE_SHIFT
2126	DEFS.linux.arm64 += IPRT_STATIC_ARM64_PAGE_SHIFT=$(VBOX_WITH_STATIC_ARM64_PAGE_SHIFT)
2127	endif
2128
2129	# Don't flood CDEFS, old MASMs doesn't like too many defines.
2130	ifdef VBOX_WITH_DEBUGGER
2131	CDEFS += VBOX_WITH_DEBUGGER
2132	endif
2133	ifdef VBOX_WITH_HARDENING
2134	CDEFS += VBOX_WITH_HARDENING
2135	endif
2136	if defined(VBOX_WITH_STRICT_LOCKS) && ($(KBUILD_TYPE) == "debug" \|\| $(KBUILD_TYPE) == "strict" \|\| $(KBUILD_TYPE) == "asan")
2137	CDEFS += RT_LOCK_STRICT RT_LOCK_STRICT_ORDER
2138	endif
2139	ifdef VBOX_WITH_EF_WRAPS
2140	CDEFS += RTMEM_WRAP_TO_EF_APIS RTMEM_WRAP_SOME_NEW_AND_DELETE_TO_EF
2141	endif
2142
2143	# Quoted strings should not be passed to the assemblers since they might not
2144	# subscribe to C preprocessing semantics.
2145	ifdef VBOX_PATH_APP_PRIVATE
2146	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2147	CDEFS += RTPATH_APP_PRIVATE="$(VBOX_PATH_APP_PRIVATE)"
2148	else
2149	CDEFS += RTPATH_APP_PRIVATE=\"$(VBOX_PATH_APP_PRIVATE)\"
2150	endif
2151	endif
2152	ifdef VBOX_PATH_APP_PRIVATE_ARCH
2153	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2154	CDEFS += RTPATH_APP_PRIVATE_ARCH="$(VBOX_PATH_APP_PRIVATE_ARCH)"
2155	else
2156	CDEFS += RTPATH_APP_PRIVATE_ARCH=\"$(VBOX_PATH_APP_PRIVATE_ARCH)\"
2157	endif
2158	endif
2159	ifdef VBOX_PATH_APP_PRIVATE_ARCH_TOP
2160	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2161	CDEFS += RTPATH_APP_PRIVATE_ARCH_TOP="$(VBOX_PATH_APP_PRIVATE_ARCH_TOP)"
2162	else
2163	CDEFS += RTPATH_APP_PRIVATE_ARCH_TOP=\"$(VBOX_PATH_APP_PRIVATE_ARCH_TOP)\"
2164	endif
2165	endif
2166	ifdef VBOX_PATH_SHARED_LIBS
2167	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2168	CDEFS += RTPATH_SHARED_LIBS="$(VBOX_PATH_SHARED_LIBS)"
2169	else
2170	CDEFS += RTPATH_SHARED_LIBS=\"$(VBOX_PATH_SHARED_LIBS)\"
2171	endif
2172	endif
2173	ifdef VBOX_PATH_APP_DOCS
2174	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2175	CDEFS += RTPATH_APP_DOCS="$(VBOX_PATH_APP_DOCS)"
2176	else
2177	CDEFS += RTPATH_APP_DOCS=\"$(VBOX_PATH_APP_DOCS)\"
2178	endif
2179	endif
2180	if1of ($(KBUILD_TARGET), os2) # The gcc here is too old to grok #pragma once, instead it complains.
2181	CDEFS += RT_WITHOUT_PRAGMA_ONCE
2182	endif
2183	CXXDEFS += $(CDEFS)
2184	PCHDEFS += $(CDEFS)
2185	OBJCDEFS += $(CDEFS)
2186
2187	USES += dtrace
2188	USES.win += vboximportchecker vboxsetpeversion
2189
2190
2191	#
2192	# Decide which Windows DDK to use by default.
2193	#
2194	# Note! For the VBoxSF.sys to build correctly, VBOX_WINDDK_GST_WLH must be
2195	# set up to the Windows 7 WDK as it ships Vista libraries with some
2196	# compatibility helpers and stuff (copysup.lib).
2197	# (WLH = windows longhorn, the codenamefor Vista).
2198	#
2199	# Note! WDK 10.0.26100.0 (Windows 11 24h2) no longer ships x86 kernel mode
2200	# libraries. Nor does it ship any win7, win8 or win6.3 (8.1) kernel
2201	# mode libraries for amd64. So, for building x86 and amd64 drivers, we
2202	# must use an older WDK version (like 10.0.22621.0, or 10.0.22000.0).
2203	# (It is possible we could use the w10/11 km libs for the x64 GA, but
2204	# that needs somewhat careful checking.)
2205	#
2206	if1of ($(KBUILD_TARGET_ARCH), x86 amd64)
2207	SDK_WINSDK10_MAX_VERSION = 10.0.22621.0
2208	endif
2209	VBOX_WINDDK ?= WINSDK10-KM
2210	VBOX_WINDDK_WLH ?= $(VBOX_WINDDK)
2211
2212	VBOX_WINDDK_GST ?= $(VBOX_WINDDK)
2213	if1of ($(KBUILD_TARGET_ARCH), x86 amd64)
2214	VBOX_WINDDK_GST_W8 ?= WINSDK10-KM-W8
2215	VBOX_WINDDK_GST_W7 ?= WINSDK10-KM-W7
2216	VBOX_WINDDK_GST_WLH ?= WINDDK71WLH
2217	VBOX_WINDDK_GST_W2K3 ?= WINDDK71WNET
2218	ifeq ($(KBUILD_TARGET_ARCH),x86)
2219	VBOX_WINDDK_GST_WXP ?= WINDDK71WXP
2220	else
2221	VBOX_WINDDK_GST_WXP ?= $(VBOX_WINDDK_GST_W2K3)
2222	endif
2223	VBOX_WINDDK_GST_W2K ?= $(VBOX_WINDDK_GST_WXP)
2224	VBOX_WINDDK_GST_NT4 ?= $(VBOX_WINDDK_GST_WXP)
2225	else
2226	VBOX_WINDDK_GST_W8 ?= $(VBOX_WINDDK_GST)
2227	VBOX_WINDDK_GST_W7 ?= $(VBOX_WINDDK_GST)
2228	VBOX_WINDDK_GST_WLH ?= $(VBOX_WINDDK_GST)
2229	VBOX_WINDDK_GST_W2K3 ?= $(VBOX_WINDDK_GST)
2230	VBOX_WINDDK_GST_WXP ?= $(VBOX_WINDDK_GST)
2231	VBOX_WINDDK_GST_W2K ?= $(VBOX_WINDDK_GST)
2232	VBOX_WINDDK_GST_NT4 ?= $(VBOX_WINDDK_GST)
2233	endif
2234
2235	#
2236	# Decide which Windows SDK to use by default.
2237	#
2238	VBOX_WINPSDK ?= WINSDK10-UM
2239	VBOX_WINPSDK_INCS ?= $(VBOX_WINPSDK)-INCS
2240	VBOX_WINPSDK_GST ?= $(VBOX_WINPSDK)
2241	VBOX_WINPSDK_GST_INCS ?= $(VBOX_WINPSDK_INCS)
2242	VBOX_WINPSDK_GST_W8 ?= $(VBOX_WINPSDK_GST)
2243	VBOX_WINPSDK_GST_W7 ?= $(VBOX_WINPSDK_GST)
2244	VBOX_WINPSDK_GST_WLH ?= $(VBOX_WINPSDK_GST)
2245	VBOX_WINPSDK_GST_WXP ?= $(VBOX_WINPSDK_GST)
2246	VBOX_WINPSDK_GST_W2K ?= $(VBOX_WINPSDK_GST)
2247	VBOX_WINPSDK_GST_NT4 ?= $(VBOX_WINPSDK_GST)
2248
2249	#
2250	# ARCH_BITS_DEFS.
2251	#
2252	if1of ($(KBUILD_TARGET_ARCH), amd64 sparc64 arm64)
2253	VBOX_HC_ARCH_BITS := 64
2254	ARCH_BITS_DEFS := HC_ARCH_BITS=64
2255	else if1of ($(KBUILD_TARGET_ARCH), x86 sparc32)
2256	VBOX_HC_ARCH_BITS := 32
2257	ARCH_BITS_DEFS := HC_ARCH_BITS=32
2258	else
2259	$(error VBox: KBUILD_TARGET_ARCH=$(KBUILD_TARGET_ARCH))
2260	endif
2261
2262	ifdef VBOX_WITH_64_BITS_GUESTS
2263	VBOX_GC_ARCH_BITS_DEFS := GC_ARCH_BITS=64
2264	else
2265	VBOX_GC_ARCH_BITS_DEFS := GC_ARCH_BITS=32
2266	endif
2267	ARCH_BITS_DEFS += $(VBOX_GC_ARCH_BITS_DEFS)
2268
2269	#
2270	# Add the output dir(s) to the dynamic loader search path.
2271	#
2272	if1of ($(KBUILD_HOST), freebsd linux netbsd openbsd solaris)
2273	export LD_LIBRARY_PATH:=$(PATH_STAGE_BIN):$(PATH_STAGE_LIB):$(LD_LIBRARY_PATH)
2274	endif
2275	ifeq ($(KBUILD_HOST),haiku)
2276	export LIBRARY_PATH:=$(PATH_STAGE_BIN):$(PATH_STAGE_LIB):$(LIBRARY_PATH)
2277	endif
2278	ifeq ($(KBUILD_HOST),os2)
2279	#fixme! export BEGINLIBPATH:=$(PATH_STAGE_BIN);$(PATH_STAGE_LIB);$(BEGINLIBPATH)
2280	endif
2281	ifeq ($(KBUILD_HOST),win)
2282	# This check is a bit hacky, but avoids problems with PATH being changed
2283	# again when the makefiles are reread because some automatically generated
2284	# makefile has been modified.
2285	ifeq ($(findstring $(PATH_STAGE_BIN);$(PATH_STAGE_LIB);,$(PATH)),)
2286	export PATH:=$(PATH_STAGE_BIN);$(PATH_STAGE_LIB);$(PATH)
2287	endif
2288	endif
2289
2290	#
2291	# Common libraries and tools.
2292	#
2293	ifeq ($(KBUILD_TARGET),darwin)
2294	LIB_RUNTIME = $(PATH_STAGE_BIN)/VBoxRT.dylib
2295	LIB_RUNTIME_EF = #$(PATH_STAGE_LIB)/RuntimeEFCPP.a
2296	VBOX_LIB_RUNTIME_X86 = $(PATH_STAGE_BIN)/VBoxRT-x86.dylib
2297	LIB_KPROFILE = $(PATH_STAGE_BIN)/kPrf2.dylib
2298	LIB_VMM = $(PATH_STAGE_BIN)/VBoxVMM.dylib
2299	LIB_VMMRC = $(PATH_STAGE_BIN)/VMMRC.rc
2300	LIB_REM = $(PATH_STAGE_LIB)/VBoxREM.dylib
2301	LIB_XPCOM = $(PATH_STAGE_BIN)/VBoxXPCOM.dylib
2302	LIB_XPCOM_IMP = $(PATH_STAGE_LIB)/VBoxXPCOMImp.dylib
2303	VBOX_LIB_XPCOM_X86 = $(PATH_STAGE_BIN)/VBoxXPCOM-x86.dylib
2304	LIB_DDU = $(PATH_STAGE_BIN)/VBoxDDU.dylib
2305	VBOX_LIB_SUPR0 :=
2306	LIB_VBOXXPCOMIPCD = $(PATH_STAGE_BIN)/VBoxXPCOMIPCD.dylib
2307	endif
2308	if1of ($(KBUILD_TARGET), freebsd haiku linux netbsd openbsd solaris)
2309	LIB_RUNTIME = $(PATH_STAGE_BIN)/VBoxRT.so
2310	LIB_RUNTIME_EF = $(PATH_STAGE_LIB)/RuntimeEFCPP.a
2311	VBOX_LIB_RUNTIME_X86 = $(PATH_STAGE_BIN)/VBoxRT-x86.so
2312	LIB_KPROFILE = $(PATH_STAGE_BIN)/kPrf2.so
2313	LIB_VMM = $(PATH_STAGE_BIN)/VBoxVMM.so
2314	LIB_VMMRC = $(PATH_STAGE_BIN)/VMMRC.rc
2315	LIB_REM = $(PATH_STAGE_LIB)/VBoxREM.so
2316	LIB_XPCOM = $(PATH_STAGE_BIN)/VBoxXPCOM.so
2317	LIB_XPCOM_IMP = $(PATH_STAGE_LIB)/VBoxXPCOMImp.so
2318	VBOX_LIB_XPCOM_X86 = $(PATH_STAGE_BIN)/VBoxXPCOM-x86.so
2319	LIB_DDU = $(PATH_STAGE_BIN)/VBoxDDU.so
2320	VBOX_LIB_SUPR0 :=
2321	LIB_VBOXXPCOMIPCD = $(PATH_STAGE_BIN)/VBoxXPCOMIPCD.so
2322	endif
2323	ifeq ($(KBUILD_TARGET),os2)
2324	LIB_RUNTIME = $(PATH_STAGE_BIN)/VBoxRT.dll
2325	LIB_RUNTIME_EF = #$(PATH_STAGE_LIB)/RuntimeEFCPP.a
2326	VBOX_LIB_RUNTIME_X86 = $(PATH_STAGE_BIN)/VBoxRT-x86.dll
2327	LIB_KPROFILE = $(PATH_STAGE_BIN)/kPrf2.dll
2328	LIB_VMM = $(PATH_STAGE_BIN)/VBoxVMM.dll
2329	LIB_VMMRC = $(PATH_STAGE_LIB)/VMMRCImp.lib
2330	LIB_REM = $(PATH_STAGE_LIB)/VBoxREMImp.lib
2331	LIB_XPCOM = $(PATH_STAGE_BIN)/VBoxXCOM.dll
2332	LIB_XPCOM_IMP = $(PATH_STAGE_LIB)/VBoxXPCOMImp.lib
2333	VBOX_LIB_XPCOM_X86 = $(PATH_STAGE_BIN)/VBoxXPCOM-x86.dll
2334	LIB_DDU = $(PATH_STAGE_BIN)/VBoxDDU.dll
2335	VBOX_OBJ_SYS0 = $(PATH_OBJ)/RuntimeR0/os2/sys0.obj
2336	VBOX_LIB_SUPR0 = $(PATH_STAGE_LIB)/SUPR0$(VBOX_SUFF_LIB)
2337	endif
2338	ifeq ($(KBUILD_TARGET),win)
2339	LIB_RUNTIME = $(PATH_STAGE_LIB)/VBoxRT.lib
2340	LIB_RUNTIME_EF = #$(PATH_STAGE_LIB)/RuntimeEFCPP.lib
2341	VBOX_LIB_RUNTIME_X86 = $(PATH_STAGE_LIB)/VBoxRT-x86.lib
2342	LIB_KPROFILE = $(PATH_STAGE_LIB)/kPrf2.lib
2343	LIB_VMM = $(PATH_STAGE_LIB)/VBoxVMM.lib
2344	LIB_VMMRC = $(PATH_OBJ)/VMMRC/VMMRC.lib
2345	LIB_REM = $(PATH_STAGE_LIB)/VBoxREMImp.lib
2346	LIB_XPCOM =
2347	LIB_XPCOM_IMP =
2348	VBOX_LIB_XPCOM_X86 =
2349	LIB_DDU = $(PATH_STAGE_LIB)/VBoxDDU.lib
2350	VBOX_LIB_SUPR0 = $(PATH_STAGE_LIB)/SUPR0$(VBOX_SUFF_LIB)
2351	endif
2352	ifn1of ($(KBUILD_TARGET_ARCH), $(VBOX_SUPPORTED_HOST_ARCHS)) # Hack to build a couple of extpack things that thing they need the VMM lib.
2353	LIB_VMM :=
2354	LIB_VMMRC :=
2355	endif
2356	VBOX_LIB_SUPHARDENED = $(PATH_STAGE_LIB)/SUPR3HardenedStatic$(VBOX_SUFF_LIB)
2357	VBOX_LIB_RUNTIME_STATIC = $(PATH_STAGE_LIB)/RuntimeR3$(VBOX_SUFF_LIB)
2358	VBOX_LIB_RUNTIME_STATIC_X86 = $(PATH_STAGE_LIB)/RuntimeR3-x86$(VBOX_SUFF_LIB)
2359	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" == "asan"
2360	VBOX_LIB_RUNTIME_STATIC_NO_ASAN = $(PATH_STAGE_LIB)/RuntimeR3NoAsan$(VBOX_SUFF_LIB)
2361	else
2362	VBOX_LIB_RUNTIME_STATIC_NO_ASAN = $(VBOX_LIB_RUNTIME_STATIC)
2363	endif
2364
2365	ifndef VBOX_WITH_REM
2366	LIB_REM :=
2367	endif
2368
2369	# Python
2370	ifndef VBOX_BLD_PYTHON
2371	if1of ($(KBUILD_HOST), win)
2372	VBOX_BLD_PYTHON := $(firstword $(rsort $(wildcard $(KBUILD_DEVTOOLS)/win.x86/python/v*/python$(HOSTSUFF_EXE))) \
2373	python-not-found.exe)
2374	else ifndef VBOX_WITH_PYTHON2_PREFERENCE
2375	VBOX_BLD_PYTHON := $(firstword \
2376	$(which python3$(HOSTSUFF_EXE)) \
2377	$(which python3.11$(HOSTSUFF_EXE)) \
2378	$(which python3.10$(HOSTSUFF_EXE)) \
2379	$(which python3.9$(HOSTSUFF_EXE)) \
2380	$(which python3.8$(HOSTSUFF_EXE)) \
2381	$(which python3.7$(HOSTSUFF_EXE)) \
2382	$(which python3.6$(HOSTSUFF_EXE)) \
2383	$(which python3.5$(HOSTSUFF_EXE)) \
2384	$(which python3.4$(HOSTSUFF_EXE)) \
2385	$(which python2.7$(HOSTSUFF_EXE)) \
2386	$(which python$(HOSTSUFF_EXE)) \
2387	$(which python2.6$(HOSTSUFF_EXE)) \
2388	python-not-found$(HOSTSUFF_EXE) )
2389	else
2390	VBOX_BLD_PYTHON := $(firstword \
2391	$(which python2.7$(HOSTSUFF_EXE)) \
2392	$(which python2.6$(HOSTSUFF_EXE)) \
2393	$(which python$(HOSTSUFF_EXE)) \
2394	$(which python3$(HOSTSUFF_EXE)) \
2395	python-not-found$(HOSTSUFF_EXE) )
2396	endif
2397	endif
2398	## For running python unittests in the validation kit.
2399	VBOX_UNITTEST_PYTHON ?= $(VBOX_BLD_PYTHON)
2400
2401	#
2402	# pylint setup, see https://www.pylint.org/.
2403	#
2404	# Disabled:
2405	# W0301 - Unnecessary semicolon.
2406	# W0511 - TODO/XXX/FIXME/+++.
2407	# W0603 - Using the global statement.
2408	# W0702 - No exception type(s) specified.
2409	# W0703 - Catch "Exception".
2410	# I0011 - Locally disabling XXXXX.
2411	# C0321 - More than one statement on a single line.
2412	# R0201 - Method could be a function.
2413	# C0326 - ????
2414	# W0123 - ????
2415	# C0330:bad-continuation - Wrong continued indentation (add X spaces).
2416	# * Triggering on perfectly legal comments in array initializers and stuff.
2417	# C0413:wrong-import-position - Import "YYYYY XXXXX" should be placed at the top of the module.
2418	# * False positives due to __copyright__, __version__, probably.
2419	# E0012:bad-option-value - Bad option value XXXXX.
2420	# * Newer pylint doesn't grok older warning disables in sources (e.g. W0142 in db.py). Wonderful!
2421	# I0012:locally-enabled - Locally enabling XXXXX.
2422	# * We temporarily disable stuff and then renabled it. Very tedious.
2423	# :nested-min-max - Buggy in 2.16.2 when mixing iterable and regular form, thus disabled.
2424	#
2425	# Note! Yes, --max-branchs is a typo, but not by me.
2426	#
2427	# Note! Users of older pylint release (< 1.0) needs to define
2428	# VBOX_WITH_PYLINT_PRE_V1_0 in LocalConfig because they changed the
2429	# output arguments in an backwards incompatible way and added more
2430	# attribute regex options.
2431	#
2432	ifndef VBOX_PYLINT
2433	VBOX_PYLINT := $(firstword $(which pylint-2.7) $(which pylint-2.6) $(which pylint2) $(which pylint))
2434	#ifdef VBOX_PYLINT # -- why was this needed. It messes up when using pylint w/ 3.x and building with 2.7.
2435	# VBOX_PYLINT := $(VBOX_BLD_PYTHON) $(VBOX_PYLINT)
2436	#endif
2437	endif
2438	if !defined(VBOX_WITH_PYLINT) && defined(VBOX_PYLINT)
2439	VBOX_WITH_PYLINT := 1
2440	ifndef VBOX_PYLINT_VERSION
2441	ifdef VBOX_WITH_PYLINT_PRE_V1_0
2442	VBOX_PYLINT_VERSION = 9999
2443	else ifdef VBOX_WITH_PYLINT_V1_2_1_PLUS
2444	VBOX_PYLINT_VERSION = 10201
2445	else ifdef VBOX_WITH_PYLINT_V1_1_PLUS
2446	VBOX_PYLINT_VERSION = 10100
2447	else
2448	VBOX_PYLINT_VERSION = 10000
2449	endif
2450	endif
2451	endif
2452	VBOX_PYLINT_FLAGS = $(if-expr $(VBOX_PYLINT_VERSION) >= 10500,--reports=n,--report=n) \
2453	$(if-expr $(VBOX_PYLINT_VERSION) >= 10000 \
2454	,--msg-template='{path}:{line}: <{msg_id}>({obj}:{symbol}): {msg}' \
2455	,--output-format=msvs --include-ids=y) \
2456	--persistent=n \
2457	--rcfile=$(PATH_ROOT)/tools/pylintrc \
2458	--max-line-length=130 \
2459	--max-attributes=32 \
2460	--max-branch$(if-expr $(VBOX_PYLINT_VERSION) >= 10000,e,)s=50 \
2461	--max-statements=100 \
2462	--max-returns=100 \
2463	--max-public-methods=139 \
2464	--max-args=9 \
2465	--max-module-lines=4096 \
2466	--max-locals=32 \
2467	$(if-expr $(VBOX_PYLINT_VERSION) >= 10500,--max-bool-expr=99,) \
2468	--min-public-methods=0 \
2469	--function-rgx='[a-z_][a-zA-Z0-9_]{2,40}$(DOLLAR)' \
2470	--method-rgx='[a-z_][a-zA-Z0-9_]{2,40}$(DOLLAR)' \
2471	--argument-rgx='([a-z_][a-zA-Z0-9_]{2,30}\|rc\|hr\|s\|c\|ch\|cx\|cy\|cb\|fn)$(DOLLAR)' \
2472	--variable-rgx='([a-z_][a-zA-Z0-9_]{2,30}\|rc\|hr\|s\|c\|ch\|cx\|cy\|cb\|fn)$(DOLLAR)' \
2473	--attr-rgx='([a-z_][a-zA-Z0-9_]{2,30}\|rc\|hr\|o)$(DOLLAR)' \
2474	--module-rgx='(([a-z_][a-z0-9_]*)\|([A-Z][a-zA-Z0-9]+)\|(td[A-Z][a-zA-Z0-9]+)\|(t(e\|)st(-\|)[a-zA-Z0-9]+))$(DOLLAR)' \
2475	--class-rgx='(td\|)[A-Z_][a-zA-Z0-9_]+$(DOLLAR)' \
2476	--const-rgx='(g_(k\|)[abcdefhmnpilorstu]+[A-Z][a-zA-Z0-9]+\|[A-Z_][A-Z0-9_]+\|__copyright__\|__version__\|__file__\|__all__)$(DOLLAR)' \
2477	--good-names='i,j,k,t,o,c,e,ch,s,_' \
2478	$(if-expr $(VBOX_PYLINT_VERSION) >= 10000,--class-attribute-rgx='(k[abcdefhmnpilorstu]+[A-Z0-9][a-zA-Z0-9_]{0,32}\|[A-Z_][A-Z0-9_]{2,32})',) \
2479	$(if-expr $(VBOX_PYLINT_VERSION) >= 10500,--max-nested-blocks=9,) \
2480	$(if-expr $(VBOX_PYLINT_VERSION) >= 10100,--disable=bad-whitespace,) \
2481	$(if-expr $(VBOX_PYLINT_VERSION) >= 10201,--disable=bad-continuation --disable=eval-used,) \
2482	$(if-expr $(VBOX_PYLINT_VERSION) >= 10201 && $(VBOX_PYLIN_VERSION) < 10500,--disable=bad-option-value,) \
2483	$(if-expr $(VBOX_PYLINT_VERSION) >= 10500,--disable=wrong-import-position --disable=E0012 --disable=locally-enabled,) \
2484	$(if-expr $(VBOX_PYLINT_VERSION) >= 10600,--disable=missing-docstring --disable=trailing-newlines --disable=ungrouped-imports,) \
2485	$(if-expr $(VBOX_PYLINT_VERSION) >= 10800,--disable=redundant-keyword-arg,) \
2486	$(if-expr $(VBOX_PYLINT_VERSION) >= 20000,--disable=useless-object-inheritance --disable=useless-return,) \
2487	$(if-expr $(VBOX_PYLINT_VERSION) >= 20400,--disable=import-outside-toplevel,) \
2488	$(if-expr $(VBOX_PYLINT_VERSION) >= 20900,--disable=super-with-arguments --disable=raise-missing-from,) \
2489	$(if-expr $(VBOX_PYLINT_VERSION) >= 21200,--disable=consider-using-f-string --disable=unnecessary-semicolon --disable=redundant-u-string-prefix) \
2490	$(if-expr $(VBOX_PYLINT_VERSION) >= 21602,--disable=broad-exception-raised) \
2491	$(if-expr $(VBOX_PYLINT_VERSION) >= 21602,--disable=nested-min-max) \
2492	--disable=unnecessary-semicolon,invalid-encoded-data,global-statement,bare-except,broad-except,multiple-statements,no-self-use,fixme \
2493	--disable=I0011 \
2494	--ignored-classes=testdriver.vboxcon
2495
2496
2497	# Define the macro for win path conversion.
2498	if !defined(VBOX_ONLY_SDK) \|\| defined(VBOX_ONLY_SDK_ON_HOST) \|\| defined(VBOX_ONLY_SDK_IN_VM)
2499	VBOX_FN_MAKE_WIN_PATH = "$(quote-sh-dq $(subst /,\,$(requote unq, $(1))))"
2500	else
2501	# Z: is always FS root for Wine.
2502	VBOX_FN_MAKE_WIN_PATH = $(subst /,\\,$(patsubst /%,Z:/%,$(1)))
2503	endif
2504
2505	# The kprofile build automagically links with kProfile.
2506	ifeq ($(KBUILD_TYPE),kprofile)
2507	LIB_RUNTIME += $(LIB_KPROFILE)
2508	endif
2509
2510	# Enable C++ electric fence heap. (Warning: will easily run out of virtual memory / kernel stuff on Linux/Windows.)
2511	ifdef VBOX_WITH_CPP_EF
2512	LIB_RUNTIME <= $(LIB_RUNTIME_EF)
2513	endif
2514
2515	# Overridable libraries (unix).
2516	LIB_PTHREAD ?= pthread
2517
2518	# Xcursor (consider an SDK for this).
2519	ifeq ($(VBOX_XCURSOR_LIBS),)
2520	ifeq ($(KBUILD_TARGET),solaris)
2521	VBOX_XCURSOR_LIBS := $(lastword $(wildcard $(KBUILD_DEVTOOLS_TRG)/libXcursor/*/lib/libXcursor.a))
2522	ifneq ($(VBOX_XCURSOR_LIBS),)
2523	VBOX_XCURSOR_INCS := $(patsubst %/lib/libXcursor.a,%/include, $(VBOX_XCURSOR_LIBS))
2524	VBOX_XCURSOR_LIBS += X11 Xrender Xfixes
2525	endif
2526	endif
2527	ifeq ($(VBOX_XCURSOR_LIBS),)
2528	VBOX_XCURSOR_LIBS := Xcursor
2529	endif
2530	endif
2531
2532
2533	# Intel ASL compiler for ACPI
2534	VBOX_IASLCMD ?= $(firstword $(wildcard $(KBUILD_DEVTOOLS_HST)/bin/iasl$(HOSTSUFF_EXE)) iasl$(HOSTSUFF_EXE))
2535
2536	# libxslt XSLT processor. (see PATH_TOOL_YASM for explanation why it's temporarily located in bin.)
2537	ifeq ($(VBOX_XSLTPROC),)
2538	ifeq ($(KBUILD_HOST),win)
2539	VBOX_XSLTPROC := $(wildcard $(KBUILD_DEVTOOLS)/$(KBUILD_HOST).$(KBUILD_HOST_ARCH)/libxslt/10142/bin/xsltproc.exe)
2540	ifeq ($(VBOX_XSLTPROC),)
2541	VBOX_XSLTPROC := $(wildcard $(KBUILD_DEVTOOLS)/$(KBUILD_HOST).$(KBUILD_HOST_ARCH)/libxslt/10128/bin/xsltproc.exe)# for x86
2542	ifeq ($(VBOX_XSLTPROC),)
2543	VBOX_XSLTPROC := $(KBUILD_DEVTOOLS)/win.x86/bin/xsltproc.exe
2544	endif
2545	endif
2546	else ifeq ($(KBUILD_HOST),os2)
2547	VBOX_XSLTPROC := BEGINLIBPATH="$(KBUILD_DEVTOOLS_HST)/bin;$$BEGINLIBPATH" $(KBUILD_DEVTOOLS_HST)/bin/xsltproc.exe
2548	else ifeq ($(KBUILD_HOST),haiku)
2549	VBOX_XSLTPROC := $(KBUILD_DEVTOOLS)/haiku.x86/bin/xsltproc
2550	else
2551	VBOX_XSLTPROC := xsltproc$(HOSTSUFF_EXE)
2552	endif
2553	endif
2554
2555	# Doxygen
2556	ifeq ($(VBOX_DOXYGEN),)
2557	VBOX_DOXYGEN := $(firstfile $(rversortfiles $(qwildcard , $(KBUILD_DEVTOOLS_HST)/doxygen/v*/doxygen$(HOSTSUFF_EXE))) doxygen$(HOSTSUFF_EXE))
2558	endif
2559
2560	# bin2c (convert binary files into C arrays)
2561	VBOX_BIN2C ?= $(PATH_OBJ)/bin2c/bin2c$(HOSTSUFF_EXE)
2562
2563	# genalias (generate aliases for nocrt_ functions)
2564	VBOX_GENALIAS ?= $(PATH_OBJ)/genalias/genalias$(HOSTSUFF_EXE)
2565
2566	# RTManifest (extension pack manifest utility)
2567	VBOX_RTMANIFEST ?= $(PATH_OBJ)/bldRTManifest/bldRTManifest$(HOSTSUFF_EXE)
2568
2569	# RTSignTool (certificate extraction tool)
2570	VBOX_RTSIGNTOOL ?= $(PATH_OBJ)/bldRTSignTool/bldRTSignTool$(HOSTSUFF_EXE)
2571
2572	# RTIsoMaker (our own ISO maker).
2573	VBOX_RTISOMAKER ?= $(PATH_OBJ)/bldRTIsoMaker/bldRTIsoMaker$(HOSTSUFF_EXE)
2574
2575	# RTLdrCheckImports (checks imports against oldest supported OS version (GAs typically))
2576	VBOX_RTLDRCHECKIMPORTS ?= $(PATH_OBJ)/bldRTLdrCheckImports/bldRTLdrCheckImports$(HOSTSUFF_EXE)
2577
2578	# VBoxCmp (simple /bin/cmp with more sensible output)
2579	VBOX_VBOXCMP ?= $(PATH_OBJ)/VBoxCmp/VBoxCmp$(HOSTSUFF_EXE)
2580
2581	# VBoxCPP (special purpose C preprocessor)
2582	VBOX_VBOXCPP ?= $(PATH_OBJ)/VBoxCPP/VBoxCPP$(HOSTSUFF_EXE)
2583
2584	# VBoxTpG (tracepoint generator)
2585	VBOX_VBOXTPG ?= $(PATH_OBJ)/VBoxTpG/VBoxTpG$(HOSTSUFF_EXE)
2586
2587	# VBoxPeSetVersion (changes the minimum OS version of an image)
2588	VBOX_PE_SET_VERSION ?= $(PATH_OBJ)/VBoxPeSetVersion/VBoxPeSetVersion$(HOSTSUFF_EXE)
2589
2590	# Visual C++ EditBin.exe.
2591	VBOX_VCC_EDITBIN = $(if $(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN_QSH),$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN_QSH)/,$(if $(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN),$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN)/,))editbin.exe /NoLogo
2592
2593	# filesplitter (splits java files)
2594	VBOX_FILESPLIT ?= $(PATH_OBJ)/filesplitter/filesplitter$(HOSTSUFF_EXE)
2595
2596	# biossums (set BIOS checksums)
2597	VBOX_BIOSSUMS ?= $(PATH_OBJ)/biossums/biossums$(HOSTSUFF_EXE)
2598
2599	# MakeAlternativeSource (for BIOSes)
2600	VBOX_MAKE_ALTERNATIVE_SOURCE ?= $(PATH_OBJ)/MakeAlternativeSource/MakeAlternativeSource$(HOSTSUFF_EXE)
2601
2602	# VBoxDef2LazyLoad (lazy dynamic library loader assembly generator)
2603	VBOX_DEF_2_LAZY_LOAD ?= $(PATH_OBJ)/VBoxDef2LazyLoad/VBoxDef2LazyLoad$(HOSTSUFF_EXE)
2604
2605	# VBoxCheckImports (checks what we imports from on windows)
2606	VBOX_CHECK_IMPORTS ?= $(PATH_OBJ)/VBoxCheckImports/VBoxCheckImports$(HOSTSUFF_EXE)
2607
2608	# VBoxEditCoffLib (symbol name tweaking for VBoxSF on windows)
2609	VBOX_EDIT_COFF_LIB ?= $(PATH_OBJ)/VBoxEditCoffLib/VBoxEditCoffLib$(HOSTSUFF_EXE)
2610
2611	# GNU tar if present.
2612	if1of ($(KBUILD_TARGET), linux os2 win)
2613	VBOX_GTAR ?= tar
2614	else if1of ($(KBUILD_TARGET), freebsd netbsd solaris)
2615	VBOX_GTAR ?= gtar
2616	endif
2617
2618	# zip
2619	VBOX_ZIP ?= zip$(HOSTSUFF_EXE)
2620
2621	ifeq ($(KBUILD_HOST),darwin) # Xcode 7.3.1 nm doesn't like -t, and -x behaves very differently. Throwing in -B (bsd) to make sure.
2622	VBOX_NM ?= $(subst $(REDIRECT_INT),$(REDIRECT_EXT),$(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(PATH_TOOL_$(VBOX_GCC_TOOL)_TOOLCHAIN_BIN_SLASH)nm) -p \
2623	$(if-expr $(VBOX_XCODE_VERSION_MAJOR) > 7 \|\| ($(VBOX_XCODE_VERSION_MAJOR) == 7 && $(VBOX_XCODE_VERSION_MINOR) >= 3),-B,)
2624	else
2625	VBOX_NM ?= nm -p -t x
2626	endif
2627
2628	# Makeself for the linux installers.
2629	VBOX_MAKESELF ?= $(KBUILD_DEVTOOLS)/common/makeself/v2.4.5-r2/makeself.sh
2630
2631	# Microsoft HTML Help Workshop.
2632	VBOX_PATH_HTML_HELP_WORKSHOP ?= $(KBUILD_DEVTOOLS)/win.x86/HTML_Help_Workshop/v1.3/
2633
2634	# Path to the null soft installer.
2635	VBOX_PATH_NSIS ?= $(KBUILD_DEVTOOLS)/win.x86/nsis/v3.09-log
2636
2637	# Windows Installer XML (WIX) toolset.
2638	VBOX_PATH_WIX ?= $(KBUILD_DEVTOOLS)/win.x86/wix/v4.0.5
2639	VBOX_PATH_MSITRAN ?= $(PATH_SDK_$(VBOX_WINPSDK)_BIN)/../x86/MsiTran.Exe
2640	VBOX_PATH_MSIDB ?= $(PATH_SDK_$(VBOX_WINPSDK)_BIN)/../x86/MsiDb.Exe
2641	# Note! The scripts has been moved to Bin in v8.0.
2642	VBOX_PATH_WISUBSTG ?= $(PATH_SDK_$(VBOX_WINPSDK)_BIN)/WiSubStg.vbs
2643	VBOX_PATH_WISUMINFO ?= $(PATH_SDK_$(VBOX_WINPSDK)_BIN)/WiSumInf.vbs
2644	VBOX_PATH_DIFX ?= $(KBUILD_DEVTOOLS)/win.$(KBUILD_TARGET_ARCH)/DIFx/v2.1-r3
2645
2646	ifdef VBOX_OSE ## @todo try get rid of this crap! People can use the latest and greatest Yasm release, no need to check in the binary for OSE.
2647	# We need to export YASM for OSE, but since it was converted to .zip we need to
2648	# allow for the location used by the zip to be properly cleaned up first.
2649	if1of ($(KBUILD_HOST).$(KBUILD_HOST_ARCH), linux.x86 solaris.x86 win.x86)
2650	PATH_TOOL_YASM ?= $(KBUILD_DEVTOOLS_HST)/bin
2651	endif
2652	endif
2653
2654	# bison and flex for windows. Needed by mesa and also used by VBoxDTrace.
2655	ifeq ($(KBUILD_HOST),win)
2656	ifndef TOOL_BISON_YACC
2657	TOOL_BISON_YACC := $(firstfile $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS)/win.x86/win_flex_bison/v/bison*$(HOSTSUFF_EXE))) bison.exe)
2658	endif
2659	ifndef TOOL_FLEX_LEX
2660	TOOL_FLEX_LEX := $(firstfile $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS)/win.x86/win_flex_bison/v/flex*$(HOSTSUFF_EXE))) flex.exe)
2661	endif
2662	endif
2663
2664
2665	# The Microsoft IDL compiler (the SDK build needs this on non-Windows).
2666	VBOX_WIN_MIDL ?= $(EXEC_X86_WIN32) $(call VBOX_FN_MAKE_WIN_PATH,$(qfirstfile ,$(qwildcard ,$(qaddsuffix ,/[Mm][Ii][Dd][Ll].[Ee][Xx][Ee], \
2667	$(PATH_SDK_$(VBOX_WINPSDK)_BIN) \
2668	$(KBUILD_DEVTOOLS)/win.x86/sdk/v7.1/Bin$(if-expr "$(KBUILD_HOST).$(KBUILD_HOST_ARCH)" == "win.amd64",/x64,) \
2669	$(KBUILD_DEVTOOLS)/win.x86/ddk/7600.16385.1/bin/x86 \
2670	$(KBUILD_DEVTOOLS)/win.x86/bin \
2671	$(PATH_SDK_$(VBOX_WINPSDK)_BIN) \
2672	$(PATH_SDK_$(VBOX_WINPSDK)) \
2673	$(PATH_SDK_WINPSDK_BIN) \
2674	$(PATH_SDK_WINPSDK) \
2675	)) Sorry_Cannot_Find_The_Midl_Compiler_In_The_PSDK))
2676
2677	# Tricks to work around midl.exe problems with spaces in the /cpp_cmd value, it
2678	# forgets to quote it when creating the commandline and cl.exe gets very confused.
2679	ifndef VBOX_WITH_PARFAIT
2680	if1of (quote, $(KMK_FEATURES))
2681	VBOX_MIDL_REDIRECT = $(REDIRECT) --prepend "$(quote-sh-dq PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(qaddsuffix ,;,$(PATH_TOOL_$(VBOX_VCC_TOOL)_DLL_BIN)))" --
2682	VBOX_MIDL_REDIRECT_X86 = $(REDIRECT) --prepend "$(quote-sh-dq PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_BIN);$(qaddsuffix ,;,$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_DLL_BIN)))" --
2683	else
2684	VBOX_MIDL_REDIRECT = $(REDIRECT) --prepend 'PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(PATH)' --
2685	VBOX_MIDL_REDIRECT_X86 = $(REDIRECT) --prepend 'PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_BIN);$(PATH)' --
2686	endif
2687	else
2688	if1of (quote, $(KMK_FEATURES))
2689	VBOX_MIDL_REDIRECT = \
2690	$(REDIRECT) --prepend "$(quote-sh-dq PATH=$(VBOX_PARFAIT_PATH_BIN);$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(qaddsuffix ,;,$(PATH_TOOL_$(VBOX_VCC_TOOL)_DLL_BIN)))" --
2691	VBOX_MIDL_REDIRECT_X86 = \
2692	$(REDIRECT) --prepend "$(quote-sh-dq PATH=$(VBOX_PARFAIT_PATH_BIN);$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_BIN);$(qaddsuffix ,;,$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_DLL_BIN)))" --
2693	else
2694	VBOX_MIDL_REDIRECT = \
2695	$(REDIRECT) --prepend 'PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(VBOX_PARFAIT_PATH_BIN);$(PATH)' --
2696	VBOX_MIDL_REDIRECT_X86 = \
2697	$(REDIRECT) --prepend 'PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(VBOX_PARFAIT_PATH_BIN);$(PATH)' --
2698	endif
2699	endif
2700	VBOX_MIDL_CPP_CMD = $(lastword $(notdir ,$(subst $(EXEC_X86_WIN32),,$(TOOL_$(VBOX_VCC_TOOL)_CC))))
2701	VBOX_MIDL_CPP_CMD_X86 = $(lastword $(notdir ,$(subst $(EXEC_X86_WIN32),,$(TOOL_$(VBOX_VCC_TOOL_STEM)X86_CC))))
2702
2703	##
2704	# Edits $1 and adding #pragma directives for disabling warnings windows.h causes.
2705	# @param 1 The name of the file to edit.
2706	define def_VBoxMidlOutputDisableMscWarnings
2707	$(QUIET)$(MV) -f "$1" "$1.tmp"
2708	$(QUIET)$(APPEND) -nt "$1" \
2709	'#if _MSC_VER >= 1920 /* RT_MSC_VER_VS2019 */' \
2710	'# pragma warning(disable:5031 5032) /* buggy winioctl.h in some w10 sdks */ ' \
2711	'#endif' \
2712	'#pragma warning(push) /* -Wall and windows.h */' \
2713	'#pragma warning(disable:4668 4255)' \
2714	'#if _MSC_VER >= 1800 /* RT_MSC_VER_VC120 */' \
2715	'# pragma warning(disable:4005)' \
2716	'#endif' \
2717	'#if _MSC_VER >= 1900 /* RT_MSC_VER_VC140 */' \
2718	'# pragma warning(disable:5039)' \
2719	'#endif' \
2720	''
2721	$(QUIET)$(CAT_EXT) "$1.tmp" >> "$1"
2722	$(QUIET)$(APPEND) -n "$1" \
2723	'' \
2724	'#pragma warning(pop)' \
2725	''
2726	$(QUIET)$(RM) -f "$1.tmp"
2727
2728	endef
2729
2730	# XPCOM setup for all but win32.
2731	ifneq ($(KBUILD_TARGET),win)
2732	VBOX_WITH_XPCOM = 1
2733	# if updating, also update xpidl_INST var in src/libs/xpcom18a4/Makefile.kmk
2734	VBOX_XPIDL ?= $(PATH_STAGE_BIN)/xpidl$(HOSTSUFF_EXE)
2735	ifeq ($(KBUILD_TARGET),os2)
2736	VBOX_XPIDL_ENV = BEGINLIBPATH="$(dir $(VBOX_XPIDL));$$BEGINLIBPATH"$(SP)
2737	endif
2738	VBOX_PATH_XPCOM_IDL ?= $(VBOX_PATH_SDK)/bindings/xpcom/idl
2739	VBOX_XPCOM_INCS ?= \
2740	$(VBOX_PATH_SDK)/bindings/xpcom/include \
2741	$(VBOX_PATH_SDK)/bindings/xpcom/include/xpcom \
2742	$(VBOX_PATH_SDK)/bindings/xpcom/include/string \
2743	$(VBOX_PATH_SDK)/bindings/xpcom/include/xpcom \
2744	$(VBOX_PATH_SDK)/bindings/xpcom/include/nsprpub \
2745	$(VBOX_PATH_SDK)/bindings/xpcom/include/ipcd
2746	ifneq ($(KBUILD_TARGET),os2)
2747	# libIDL-config (for xpcom18a4)
2748	ifeq ($(origin VBOX_LIBIDL_CONFIG),undefined)
2749	ifeq ($(KBUILD_HOST),solaris)
2750	VBOX_LIBIDL_CONFIG_FALLBACK = $(lastword $(wildcard $(KBUILD_DEVTOOLS)/solaris.amd64/libIDL/*/bin/libIDL-config-2))
2751	endif
2752	export VBOX_LIBIDL_CONFIG := $(firstword $(which libIDL-config-2 libIDL-config) $(VBOX_LIBIDL_CONFIG_FALLBACK) libIDL-config-2-not-found)
2753	endif
2754	endif
2755	endif
2756
2757	# The X11 LIBPATH. (The amd64 hack is for RHEL4.)
2758	ifeq ($(KBUILD_TARGET_ARCH),amd64)
2759	VBOX_LIBPATH_X11 ?= /usr/X11R6/lib64 /usr/X11R6/lib
2760	else
2761	VBOX_LIBPATH_X11 ?= /usr/X11R6/lib
2762	endif
2763
2764	# 32bit X11 LIBPATH for building 32bit guest additions
2765	VBOX_LIBPATH32_X11 ?= /usr/X11R6/lib32 /usr/X11R6/lib
2766
2767	# Good windows shell.
2768	VBOX_GOOD_COMSPEC = $(subst \,/,$(SystemRoot))/System32/cmd.exe
2769	VBOX_GOOD_COMSPEC_BS ?= $(subst /,\,$(VBOX_GOOD_COMSPEC))
2770
2771	#
2772	# Macros dealing with the darwin version we're targeting.
2773	# The DEF in VBOX_DEF_MACOSX_VERSION_MIN mean default. The default min
2774	# version is assumed to be the
2775	#
2776	ifeq ($(KBUILD_TARGET),darwin)
2777	# The minimum macOS version we're targetting.
2778	ifndef VBOX_DEF_MACOSX_VERSION_MIN
2779	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO) # For GAs.
2780	VBOX_DEF_MACOSX_VERSION_MIN := 10.6# Snow Leopard
2781	else if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2782	VBOX_DEF_MACOSX_VERSION_MIN := 10.9# Mavericks
2783	else
2784	VBOX_DEF_MACOSX_VERSION_MIN := 11.0# Big Sur
2785	endif
2786	endif
2787	VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT := $(subst .,,$(VBOX_DEF_MACOSX_VERSION_MIN))
2788
2789	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO) # For GAs.
2790	# Check for the Xcode 4.1 bits in tools/darwin.x86.
2791	if !defined(VBOX_WITH_MACOSX_COMPILERS_FROM_DEVEL) \
2792	&& !defined(VBOX_XCODE_VERSION) \
2793	&& exists "$(KBUILD_DEVTOOLS)/darwin.x86/xcode/v4.1"
2794	VBOX_WITH_MACOSX_COMPILERS_FROM_DEVEL := 1
2795	VBOX_PATH_MACOSX_DEVEL_ROOT := $(KBUILD_DEVTOOLS)/darwin.x86/xcode/v4.1
2796	VBOX_XCODE_VERSION := 4.1
2797	else
2798	# Fallback - system / LocalConfig.kmk.
2799	VBOX_PATH_MACOSX_DEVEL_ROOT ?= /Developer
2800	VBOX_PATH_MACOSX_SDK_ROOT ?= $(VBOX_PATH_MACOSX_DEVEL_ROOT)/SDKs
2801	VBOX_PATH_MACOSX_TOOLCHAIN_ROOT ?= $(VBOX_PATH_MACOSX_DEVEL_ROOT)
2802	endif
2803	else ifeq ($(VBOX_GCC_TOOL),VBoxXcode62)
2804	# Use the tool path of the compiler (it's clang, not gcc in this instance).
2805	include $(KBUILD_TOOL_PATHS)/$(VBOX_GCC_TOOL).kmk
2806	VBOX_PATH_MACOSX_DEVEL_ROOT := $(PATH_TOOL_$(VBOX_GCC_TOOL))
2807	# Fallback - system / LocalConfig.kmk.
2808	ifndef VBOX_PATH_MACOSX_DEVEL_ROOT
2809	VBOX_PATH_MACOSX_DEVEL_ROOT := $(firstword $(wildcard /Applications/Xcode.app/Contents/Developer /Developer /Library/Developer))
2810	endif
2811	ifndef VBOX_PATH_MACOSX_SDK_ROOT
2812	VBOX_PATH_MACOSX_SDK_ROOT := $(firstword $(wildcard \
2813	$(PATH_TOOL_$(VBOX_GCC_TOOL)_SDKS) \
2814	$(VBOX_PATH_MACOSX_DEVEL_ROOT)/SDKs/. \
2815	/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/. \
2816	/Developer/SDKs/. \
2817	/Library/Developer/CommandLineTools/SDKs/. ))
2818	endif
2819	ifndef VBOX_PATH_MACOSX_TOOLCHAIN_ROOT
2820	VBOX_PATH_MACOSX_TOOLCHAIN_ROOT := $(firstword $(wildcard \
2821	$(PATH_TOOL_$(VBOX_GCC_TOOL)_TOOLCHAIN) \
2822	$(VBOX_PATH_MACOSX_DEVEL_ROOT)/Library/Developer/CommandLineTools/. \
2823	$(VBOX_PATH_MACOSX_DEVEL_ROOT)/Toolchains/XcodeDefault.xctoolchain/. \
2824	/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/. \
2825	/Library/Developer/CommandLineTools/. \
2826	) /. )
2827	endif
2828	else
2829	# VBOX_WITH_EVEN_NEWER_XCODE ends up here.
2830	include $(KBUILD_PATH)/tools/$(VBOX_GCC_TOOL).kmk
2831	include $(KBUILD_PATH)/sdks/MACOSX$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT).kmk
2832	ifndef VBOX_PATH_MACOSX_SDK
2833	VBOX_PATH_MACOSX_SDK := $(PATH_SDK_MACOSX$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT))
2834	endif
2835	VBOX_PATH_MACOSX_SDK_ROOT = $(dir $(VBOX_PATH_MACOSX_SDK))
2836	endif
2837
2838	# Figure the default SDK location and obsolete linker tricks.
2839	ifeq ($(VBOX_DEF_MACOSX_VERSION_MIN),10.4)
2840	ifeq ($(origin VBOX_DARWIN_CLASSIC_LINKER),undefined)
2841	VBOX_DARWIN_CLASSIC_LINKER := $(shell ld -v 2>&1 )
2842	ifneq ($(filter ld64%, $(subst :, , $(VBOX_DARWIN_CLASSIC_LINKER))),)
2843	export VBOX_DARWIN_CLASSIC_LINKER := -Wl,-classic_linker
2844	else
2845	export VBOX_DARWIN_CLASSIC_LINKER :=
2846	endif
2847	endif
2848	endif
2849	if !defined(VBOX_PATH_MACOSX_SDK) && !defined(VBOX_WITH_EVEN_NEWER_XCODE) # newer xcode handles this above
2850	VBOX_PATH_MACOSX_SDK_ROOT_DIRS ?= \
2851	$(VBOX_PATH_MACOSX_SDK_ROOT) \
2852	$(KBUILD_DEVTOOLS)/darwin.x86/SDKs/ \
2853	$(KBUILD_DEVTOOLS)/darwin.amd64/SDKs/ \
2854	$(KBUILD_DEVTOOLS)/darwin.x86/xcode/v4.1/SDKs \
2855	$(KBUILD_DEVTOOLS)/darwin.x86/xcode/v3.2.6/SDKs
2856	ifeq ($(VBOX_DEF_MACOSX_VERSION_MIN),10.4)
2857	VBOX_PATH_MACOSX_SDK := $(firstword $(wildcard $(addsuffix /MacOSX$(VBOX_DEF_MACOSX_VERSION_MIN)u.sdk, $(VBOX_PATH_MACOSX_SDK_ROOT_DIRS))) \
2858	$(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX$(VBOX_DEF_MACOSX_VERSION_MIN)u.sdk )
2859	else
2860	VBOX_PATH_MACOSX_SDK := $(firstword $(wildcard $(addsuffix /MacOSX$(VBOX_DEF_MACOSX_VERSION_MIN).sdk, $(VBOX_PATH_MACOSX_SDK_ROOT_DIRS))) \
2861	$(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX$(VBOX_DEF_MACOSX_VERSION_MIN).sdk )
2862	endif
2863	endif
2864
2865	## The Xcode version (not relevant for command line tools, so we skip this in VBOX_WITH_EVEN_NEWER_XCODE mode).
2866	ifdef VBOX_WITH_EVEN_NEWER_XCODE
2867	VBOX_XCODE_VERSION ?= 10.98## Just a high non-existing version number.
2868	else ifeq ($(KBUILD_HOST),darwin)
2869	ifndef VBOX_XCODE_VERSION
2870	if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2871	VBOX_XCODE_VERSION := $(shell exec $(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/xcodebuild -version 2>&1)
2872	ifneq ($(pos Symbol not found,$(VBOX_XCODE_VERSION)),0) # Try detect unresolved symbol running Xcode 6.2 on Catalina.
2873	VBOX_XCODE_VERSION = 6.2
2874	else
2875	VBOX_XCODE_VERSION := $(word 2, $(VBOX_XCODE_VERSION))
2876	endif
2877	else if defined(VBOX_WITH_MACOSX_COMPILERS_FROM_DEVEL) \|\| exists "$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/xcodebuild"
2878	VBOX_XCODE_VERSION := $(word 2, $(shell $(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/xcodebuild -version))
2879	else
2880	VBOX_XCODE_VERSION := $(word 2, $(shell xcodebuild -version))
2881	endif
2882	ifeq ($(strip $(VBOX_XCODE_VERSION)),)
2883	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO)
2884	VBOX_XCODE_VERSION := 4.1
2885	else if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2886	VBOX_XCODE_VERSION := 6.2
2887	else
2888	VBOX_XCODE_VERSION := 9.4# whatever
2889	endif
2890	endif
2891	endif
2892	if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2893	ifdef KBUILD_USE_KOBJCACHE
2894	$(warning KBUILD_USE_KOBJCACHE does _not_ currently work with this version of Xcode)
2895	endif
2896	endif
2897	else
2898	VBOX_XCODE_VERSION ?= 4.1## @todo Anything special for GA, extpack and valkit tools fetching?
2899	endif
2900	VBOX_XCODE_VERSION_MAJOR := $(word 1, $(subst ., ,$(VBOX_XCODE_VERSION)))
2901	VBOX_XCODE_VERSION_MINOR := $(word 2, $(subst ., ,$(VBOX_XCODE_VERSION)))
2902	VBOX_XCODE_VERSION := $(VBOX_XCODE_VERSION_MAJOR).$(VBOX_XCODE_VERSION_MINOR)
2903
2904	ifeq ($(KBUILD_TARGET_ARCH),x86)
2905	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4 10.5)
2906	VBOX_DARWIN_NO_COMPACT_LINKEDIT ?= $(VBOX_LD_no_compact_linkedit)
2907	TOOL_GXX4MACHO_SUFFIX ?= -4.0
2908	endif
2909	else if $(VBOX_XCODE_VERSION_MAJOR) < 4 && "$(VBOX_XCODE_VERSION)" != "3.2"
2910	ifeq ($(PATH_CURRENT),$(PATH_ROOT)/tools)
2911	$(warning VBox: 64-bit darwin builds require Xcode 3.2 or later, you have $(VBOX_XCODE_VERSION))
2912	else
2913	$(error VBox: 64-bit darwin builds require Xcode 3.2 or later, you have $(VBOX_XCODE_VERSION))
2914	endif
2915	endif
2916	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO)
2917	if $(VBOX_XCODE_VERSION_MAJOR) > 4 \|\| ($(VBOX_XCODE_VERSION_MAJOR) == 4 && $(VBOX_XCODE_VERSION_MINOR) >= 2)
2918	TOOL_GXX4MACHO_PREFIX ?= llvm-
2919	endif
2920	if $(VBOX_XCODE_VERSION_MAJOR) < 5
2921	TOOL_GXX4MACHO_SUFFIX ?= -4.2
2922	endif
2923	VBOX_DARWIN_NO_COMPACT_LINKEDIT ?=
2924
2925	TOOL_GCC4MACHO_SUFFIX ?= $(TOOL_GXX4MACHO_SUFFIX)$(HOSTSUFF_EXE)
2926	TOOL_GCC4MACHO_PREFIX ?= $(TOOL_GXX4MACHO_PREFIX)
2927	if defined(VBOX_WITH_MACOSX_COMPILERS_FROM_DEVEL)
2928	TOOL_GCC4MACHO_PREFIX := $(VBOX_PATH_MACOSX_TOOLCHAIN_ROOT)/usr/bin/$(TOOL_GCC4MACHO_PREFIX)
2929	TOOL_GXX4MACHO_PREFIX := $(VBOX_PATH_MACOSX_TOOLCHAIN_ROOT)/usr/bin/$(TOOL_GXX4MACHO_PREFIX)
2930	TOOL_GCC4MACHO_SUFFIX := $(TOOL_GCC4MACHO_SUFFIX) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2931	TOOL_GXX4MACHO_SUFFIX := $(TOOL_GXX4MACHO_SUFFIX) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2932	ifndef SVN # must expand first so we won't be using old svn.
2933	SVN := $(firstword $(which svn) svn)
2934	endif
2935	if $(VBOX_XCODE_VERSION_MAJOR) > 4 \|\| ($(VBOX_XCODE_VERSION_MAJOR) == 4 && $(VBOX_XCODE_VERSION_MINOR) >= 2)
2936	export PATH:=$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/:$(VBOX_PATH_MACOSX_SDK)/usr/bin:$(VBOX_PATH_MACOSX_TOOLCHAIN_ROOT)/usr/bin:$(PATH)
2937	export DEVELOPER_DIR:=$(VBOX_PATH_MACOSX_DEVEL_ROOT)
2938	else
2939	export PATH:=$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/:$(PATH)
2940	endif
2941	TOOL_GXX32_CC = $(TOOL_GCC4MACHO_PREFIX)gcc$(TOOL_GCC4MACHO_SUFFIX) -m32
2942	TOOL_GXX32_CXX = $(TOOL_GCC4MACHO_PREFIX)g++$(TOOL_GCC4MACHO_SUFFIX) -m32
2943	TOOL_GXX32_LD = $(TOOL_GXX32_CXX)
2944	override TOOL_StandardDTrace_DTRACE := dtrace "-xcpppath=$(TOOL_GCC4MACHO_PREFIX)cpp-4.2"
2945	endif
2946	if $(VBOX_XCODE_VERSION_MAJOR) < 5
2947	## @todo WTF do we do the -m32/64 stuff here for these compilers? Also the visibility should be elsewhere...
2948	TOOL_GXX4MACHO_OBJC = $(TOOL_GCC4MACHO_PREFIX)gcc$(TOOL_GCC4MACHO_SUFFIX) $(if-expr $(KBUILD_TARGET_ARCH) == "x86",-m32,-m64) -fvisibility=hidden
2949	TOOL_GXX4MACHO_OBJCXX = $(TOOL_GCC4MACHO_PREFIX)gcc$(TOOL_GCC4MACHO_SUFFIX) $(if-expr $(KBUILD_TARGET_ARCH) == "x86",-m32,-m64) -fvisibility=hidden -fvisibility-inlines-hidden
2950	endif
2951	else if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2952	if $(KBUILD_HOST_VERSION_MAJOR) >= 18 # HACK ALERT! dtrace doesn't work on Mojave if we specify our Xcode 6.2 environment.
2953	override TOOL_StandardDTrace_DTRACE := dtrace "-xcpppath=$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/gcc"
2954	else
2955	override TOOL_StandardDTrace_DTRACE := $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) dtrace "-xcpppath=$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/gcc"
2956	endif
2957	export PATH:=$(VBOX_PATH_MACOSX_SDK)/usr/bin:$(PATH)
2958	else # effectively VBOX_WITH_EVEN_NEWER_XCODE
2959	override TOOL_StandardDTrace_DTRACE := $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) dtrace "-xcpppath=$(filter-out -f%,$(TOOL_$(VBOX_GCC_TOOL)_CC))"
2960	endif
2961
2962	ifdef VBOX_WITH_EVEN_NEWER_XCODE
2963	VBOX_DARWIN_DEF_SDK_SDKS := MACOSX$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT)
2964	VBOX_DARWIN_DEF_SDK_DEFS := MAC_OS_X_VERSION_MAX_ALLOWED=$(SDK_MACOSX$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT)_VERSION_VALUE)
2965	VBOX_DARWIN_DEF_SDK_LDFLAGS = $(VBOX_DARWIN_CLASSIC_LINKER) $(VBOX_DARWIN_NO_COMPACT_LINKEDIT)
2966	else
2967	VBOX_DARWIN_DEF_SDK_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT)0 \
2968	MAC_OS_X_VERSION_MAX_ALLOWED=$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT)0
2969	VBOX_DARWIN_DEF_SDK_CFLAGS := -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2970	VBOX_DARWIN_DEF_SDK_CXXFLAGS := -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2971	VBOX_DARWIN_DEF_SDK_OBJCFLAGS := -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2972	VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS := -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2973	VBOX_DARWIN_DEF_SDK_LDFLAGS = -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK)" \
2974	$(VBOX_DARWIN_CLASSIC_LINKER) $(VBOX_DARWIN_NO_COMPACT_LINKEDIT)
2975	endif
2976
2977	# specific versions - only used by xpcom18a4 (python) and 10.7 by UsbWebcam.
2978	## @todo s/VBOX_DARWIN_DEF_SDK_10/VBOX_DARWIN_SDK_10/g
2979
2980	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4) # classic linker detection is bust otherwise
2981	VBOX_PATH_MACOSX_SDK_10_4 ?= $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.4u.sdk
2982	VBOX_DARWIN_DEF_SDK_10_4_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=1040 MAC_OS_X_VERSION_MAX_ALLOWED=1040
2983	VBOX_DARWIN_DEF_SDK_10_4_CFLAGS := -mmacosx-version-min=10.4 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_4)"
2984	VBOX_DARWIN_DEF_SDK_10_4_CXXFLAGS := -mmacosx-version-min=10.4 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_4)"
2985	VBOX_DARWIN_DEF_SDK_10_4_OBJCFLAGS := -mmacosx-version-min=10.4 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_4)"
2986	VBOX_DARWIN_DEF_SDK_10_4_OBJCXXFLAGS := -mmacosx-version-min=10.4 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_4)"
2987	VBOX_DARWIN_DEF_SDK_10_4_LDFLAGS := -mmacosx-version-min=10.4 -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK_10_4)" $(VBOX_DARWIN_CLASSIC_LINKER)
2988	else
2989	VBOX_PATH_MACOSX_SDK_10_4 = $(error VBox: $(if $(target),$(target): ,)Using 10.4 SDK)
2990	VBOX_DARWIN_DEF_SDK_10_4_CXXFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.4 SDK)
2991	VBOX_DARWIN_DEF_SDK_10_4_LDFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.4 SDK)
2992	endif
2993
2994	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4 10.5)
2995	VBOX_PATH_MACOSX_SDK_10_5 ?= $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.5.sdk
2996	VBOX_DARWIN_DEF_SDK_10_5_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=1050 MAC_OS_X_VERSION_MAX_ALLOWED=1050
2997	VBOX_DARWIN_DEF_SDK_10_5_CFLAGS := -mmacosx-version-min=10.5 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_5)"
2998	VBOX_DARWIN_DEF_SDK_10_5_CXXFLAGS := -mmacosx-version-min=10.5 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_5)"
2999	VBOX_DARWIN_DEF_SDK_10_5_OBJCFLAGS := -mmacosx-version-min=10.5 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_5)"
3000	VBOX_DARWIN_DEF_SDK_10_5_OBJCXXFLAGS := -mmacosx-version-min=10.5 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_5)"
3001	VBOX_DARWIN_DEF_SDK_10_5_LDFLAGS := -mmacosx-version-min=10.5 -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK_10_5)" $(VBOX_DARWIN_NO_COMPACT_LINKEDIT)
3002	else
3003	VBOX_PATH_MACOSX_SDK_10_5 = $(error VBox: $(if $(target),$(target): ,)Using 10.5 SDK)
3004	VBOX_DARWIN_DEF_SDK_10_5_CXXFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.5 SDK)
3005	VBOX_DARWIN_DEF_SDK_10_5_LDFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.5 SDK)
3006	endif
3007
3008	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4 10.5 10.6)
3009	VBOX_PATH_MACOSX_SDK_10_6 ?= $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.6.sdk
3010	VBOX_DARWIN_DEF_SDK_10_6_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=1060 MAC_OS_X_VERSION_MAX_ALLOWED=1060
3011	VBOX_DARWIN_DEF_SDK_10_6_CFLAGS := -mmacosx-version-min=10.6 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_6)"
3012	VBOX_DARWIN_DEF_SDK_10_6_CXXFLAGS := -mmacosx-version-min=10.6 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_6)"
3013	VBOX_DARWIN_DEF_SDK_10_6_OBJCFLAGS := -mmacosx-version-min=10.6 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_6)"
3014	VBOX_DARWIN_DEF_SDK_10_6_OBJCXXFLAGS := -mmacosx-version-min=10.6 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_6)"
3015	VBOX_DARWIN_DEF_SDK_10_6_LDFLAGS := -mmacosx-version-min=10.6 -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK_10_6)"
3016	else
3017	VBOX_PATH_MACOSX_SDK_10_6 = $(error VBox: $(if $(target),$(target): ,)Using 10.6 SDK)
3018	VBOX_DARWIN_DEF_SDK_10_6_CXXFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.6 SDK)
3019	VBOX_DARWIN_DEF_SDK_10_6_LDFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.6 SDK)
3020	endif
3021
3022	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4 10.5 10.6 10.7)
3023	ifndef VBOX_PATH_MACOSX_SDK_10_7
3024	ifneq ($(wildcard $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.7.sdk),)
3025	VBOX_PATH_MACOSX_SDK_10_7 = $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.7.sdk
3026	else
3027	VBOX_PATH_MACOSX_SDK_10_7 = $(KBUILD_DEVTOOLS)/darwin.x86/SDKs/MacOSX10.7.sdk
3028	endif
3029	endif
3030	VBOX_DARWIN_DEF_SDK_10_7_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=1070 MAC_OS_X_VERSION_MAX_ALLOWED=1070
3031	VBOX_DARWIN_DEF_SDK_10_7_CFLAGS := -mmacosx-version-min=10.7 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_7)"
3032	VBOX_DARWIN_DEF_SDK_10_7_CXXFLAGS := -mmacosx-version-min=10.7 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_7)"
3033	VBOX_DARWIN_DEF_SDK_10_7_OBJCFLAGS := -mmacosx-version-min=10.7 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_7)"
3034	VBOX_DARWIN_DEF_SDK_10_7_OBJCXXFLAGS := -mmacosx-version-min=10.7 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_7)"
3035	VBOX_DARWIN_DEF_SDK_10_7_LDFLAGS := -mmacosx-version-min=10.7 -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK_10_7)"
3036	else
3037	VBOX_PATH_MACOSX_SDK_10_7 = $(error VBox: $(if $(target),$(target): ,)Using 10.7 SDK)
3038	VBOX_DARWIN_DEF_SDK_10_7_CXXFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.7 SDK)
3039	VBOX_DARWIN_DEF_SDK_10_7_LDFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.7 SDK)
3040	endif
3041
3042	#
3043	# Use bison and flex from Xcode to avoid linking issues (bison).
3044	#
3045	TOOL_BISON_YACC ?= $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(PATH_TOOL_$(VBOX_GCC_TOOL)_TOOLCHAIN_BIN_SLASH)bison
3046	TOOL_FLEX_LEX ?= $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(PATH_TOOL_$(VBOX_GCC_TOOL)_TOOLCHAIN_BIN_SLASH)flex
3047
3048	#
3049	# Disable VMNet if the SDK is too old.
3050	#
3051	if defined(VBOX_WITH_VMNET) && "$(VBOX_DEF_MACOSX_VERSION_MIN)" vlt "10.15"
3052	VBOX_WITH_VMNET :=
3053	endif
3054
3055	endif # target=darwin
3056
3057	#
3058	# Macro switching between @executable_path, @rpath and /Applications/VirtualBox.app
3059	# depending on whether the build is hardened or not (dylib install_name).
3060	#
3061	ifeq ($(KBUILD_TARGET),darwin)
3062	ifndef VBOX_DYLD_EXECUTABLE_PATH
3063	ifdef VBOX_WITH_HARDENING
3064	VBOX_DYLD_EXECUTABLE_PATH = $(VBOX_PATH_APP_PRIVATE_ARCH)
3065	else if 0
3066	VBOX_DYLD_EXECUTABLE_PATH = @executable_path
3067	else
3068	VBOX_DYLD_EXECUTABLE_PATH = @rpath
3069	VBOX_WITH_RELATIVE_RUNPATH = @loader_path/
3070	endif
3071	endif
3072	endif
3073
3074	#
3075	# Check for incompatible rpath combinations.
3076	#
3077	if defined(VBOX_WITH_RUNPATH) && defined(VBOX_WITH_ORIGIN)
3078	$(error VBox: VBOX_WITH_RUNPATH and VBOX_WITH_ORIGIN are mutually exclusive)
3079	endif
3080	if defined(VBOX_WITH_RELATIVE_RUNPATH) && defined(VBOX_WITH_ORIGIN)
3081	$(error VBox: VBOX_WITH_RELATIVE_RUNPATH and VBOX_WITH_ORIGIN are mutually exclusive)
3082	endif
3083	if defined(VBOX_WITH_RUNPATH) && defined(VBOX_WITH_RELATIVE_RUNPATH)
3084	$(error VBox: VBOX_WITH_RUNPATH and VBOX_WITH_RELATIVE_RUNPATH are mutually exclusive)
3085	endif
3086	if defined(VBOX_WITH_RELATIVE_RUNPATH) && defined(VBOX_WITH_HARDENING)
3087	$(error VBox: VBOX_WITH_RELATIVE_RUNPATH and VBOX_WITH_HARDENING are mutually exclusive)
3088	endif
3089
3090	#
3091	# VBOX_WITH_ORIGIN translates into VBOX_WITH_RELATIVE_RUNPATH.
3092	#
3093	# We use two helper variables for the VBOX_WITH_ORIGIN stuff:
3094	# VBOX_ORIGIN - Indirect expansion trick.
3095	# VBOX_GCC_RPATH_OPT - Different GCC/LD combinations needs different options.
3096	#
3097	VBOX_ORIGIN = $$ORIGIN
3098	ifeq ($(KBUILD_TARGET),solaris)
3099	VBOX_GCC_RPATH_OPT = -R
3100	else
3101	VBOX_GCC_RPATH_OPT = -Wl,-rpath,
3102	VBOX_GCC_ORIGIN_OPT = -Wl,-z,origin
3103	endif
3104	ifdef VBOX_WITH_ORIGIN
3105	VBOX_WITH_RELATIVE_RUNPATH = $$(VBOX_ORIGIN)
3106	endif
3107
3108
3109	#
3110	# Configure 'asan' type builds.
3111	#
3112	# We ASSUME that anyone doing this kind of build on linux has a compiler
3113	# with sanitizer support (otherwise we'd end up with a circular dependency
3114	# with DynamicConfig.kmk here to check the compiler version).
3115	#
3116	ifeq ($(KBUILD_TYPE),asan)
3117	if "$(KBUILD_TARGET)" == "linux"
3118	VBOX_WITH_GCC_SANITIZER := 1
3119	else if "$(KBUILD_TARGET)" == "darwin"
3120	VBOX_WITH_GCC_SANITIZER := 1
3121	else if "$(KBUILD_TARGET)" == "win"
3122	VBOX_WITH_VCC_SANITIZER := 1
3123	else
3124	VBOX_WITH_EF_WRAPS := 1
3125	endif
3126	endif
3127
3128	#
3129	# The address sanitiser library intercepts dlopen() and breaks RPATH $ORIGIN,
3130	# so we need to link it statically or set LD_LIBRARY_PATH. To link statically,
3131	# set VBOX_WITH_GCC_SANITIZER_STATIC in addition.
3132	#
3133	ifdef VBOX_WITH_GCC_SANITIZER
3134	VBOX_GCC_SANITIZER_FLAGS := \
3135	-fsanitize=undefined \
3136	-fsanitize=address \
3137	-fsanitize=return \
3138	-fsanitize=bounds \
3139	-fsanitize=object-size \
3140	-fno-sanitize=alignment \
3141	-fno-sanitize=vptr \
3142	-fno-common \
3143	-DIPRT_WITH_GCC_SANITIZER \
3144	-DVBOX_WITH_GCC_SANITIZER
3145	else ifdef VBOX_WITH_CLANG_SANITIZER ## @todo make work...
3146	VBOX_GCC_SANITIZER_FLAGS := \
3147	-DIPRT_WITH_GCC_SANITIZER \
3148	-DVBOX_WITH_GCC_SANITIZER \
3149	-fsanitize=object-size \
3150	-fsanitize-undefined-trap-on-error
3151	else
3152	VBOX_GCC_SANITIZER_FLAGS =
3153	endif
3154
3155	# -libasan-static is currently not supported in combination with -no-undefined.
3156	VBOX_GCC_NO_UNDEFINED :=
3157	VBOX_GCC_NO_UNDEFINED_R0 :=
3158	ifdef VBOX_WITH_GCC_SANITIZER
3159	ifdef VBOX_WITH_GCC_SANITIZER_STATIC
3160	VBOX_GCC_NO_UNDEFINED := -Wl,--no-undefined
3161	VBOX_GCC_NO_UNDEFINED_R0 := -no-undefined
3162	VBOX_GCC_SANITIZER_LDFLAGS += -static-libasan
3163	else
3164	if "$(KBUILD_TARGET)" == "darwin"
3165	VBOX_GCC_SANITIZER_LDFLAGS += -fsanitize=address
3166	else
3167	VBOX_GCC_SANITIZER_LDFLAGS += -lasan
3168	endif
3169	endif
3170	endif
3171
3172	# The config for Visual C++ 2019 update 9 and later.
3173	ifdef VBOX_WITH_VCC_SANITIZER
3174	VBOX_VCC_SANITIZER_FLAGS := -fsanitize=address -fno-sanitize-address-vcasan-lib
3175	# experimental: VBOX_VCC_SANITIZER_FLAGS += /fsanitize-address-use-after-return
3176	VBOX_VCC_SANITIZER_LDFLAGS :=
3177	else
3178	VBOX_VCC_SANITIZER_FLAGS :=
3179	VBOX_VCC_SANITIZER_LDFLAGS :=
3180	endif
3181
3182
3183	#
3184	# The X11 headers.
3185	#
3186	VBOX_PATH_X11_ROOT = $(PATH_ROOT)/src/VBox/Additions/x11/x11include
3187
3188
3189	#
3190	# Miscellaneous includes
3191	#
3192	VBOX_GRAPHICS_INCS = $(PATH_ROOT)/include/VBox/Graphics
3193	VBOX_JPEG_INCS = $(PATH_ROOT)/src/libs/libjpeg-turbo-2.1.3
3194
3195
3196	# The icons to use.
3197	ifdef VBOX_OSE
3198	VBOX_WINDOWS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/OSE/VirtualBox_win.ico
3199	VBOX_WINDOWS_ADDITIONS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/OSE/VirtualBox_win.ico
3200	VBOX_NSIS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/OSE/VirtualBox_win.ico
3201	VBOX_MACOSX_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/darwin/OSE/VirtualBox.icns
3202	else
3203	VBOX_WINDOWS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBox-vista.ico
3204	VBOX_WINDOWS_ADDITIONS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBoxGA-vista.ico
3205	VBOX_NSIS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBoxGA-nsis.ico
3206	VBOX_MACOSX_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/darwin/NonOSE/VirtualBox.icns
3207	ifeq ($(KBUILD_HOST),win)
3208	TOOL_VCC80X86_RC := $(KBUILD_DEVTOOLS)/win.x86/ddk/6000/bin/x86/rc.exe
3209	TOOL_VCC80AMD64_RC := $(KBUILD_DEVTOOLS)/win.x86/ddk/6000/bin/x86/rc.exe
3210	TOOL_VCC70_RC := $(KBUILD_DEVTOOLS)/win.x86/ddk/6000/bin/x86/rc.exe
3211	endif
3212	endif
3213
3214
3215	ifndef VBOX_NOINC_DYNAMIC_CONFIG_KMK
3216	#
3217	# GCC, YASM, PyLint, ++ dynamic properties.
3218	#
3219	# Most of this is resolved on first kmk invocation and cached in PATH_OUT.
3220	#
3221	# Note! That a harmless warning is printed if the file doesn't exist.
3222	# Note! Changes in GCC are not detected automatically (yet).
3223	#
3224	ifndef CLOSEPAR
3225	CLOSEPAR := )
3226	endif
3227	if1of ($(KBUILD_HOST), os2 win)
3228	VBOX_DEV_NULL := nul
3229	VBOX_DEV_NULL_ALT := NUL
3230	else
3231	VBOX_DEV_NULL := /dev/null
3232	VBOX_DEV_NULL_ALT := /dev/./null
3233	endif
3234
3235	# GCC macros.
3236	ifdef VBOX_GCC_TOOL
3237	# Load the tools files first.
3238	if $(pos VBox,$(VBOX_GCC_TOOL)) > 0
3239	include $(KBUILD_TOOL_PATHS)/$(VBOX_GCC_TOOL).kmk
3240	else
3241	include $(KBUILD_PATH)/tools/$(VBOX_GCC_TOOL).kmk
3242	endif
3243	ifdef VBOX_GCC32_TOOL
3244	ifneq ($(VBOX_GCC_TOOL),$(VBOX_GCC32_TOOL))
3245	if $(pos VBox,$(VBOX_GCC32_TOOL)) > 0
3246	include $(KBUILD_TOOL_PATHS)/$(VBOX_GCC32_TOOL).kmk
3247	else
3248	include $(KBUILD_PATH)/tools/$(VBOX_GCC32_TOOL).kmk
3249	endif
3250	endif
3251	endif
3252
3253	# Note! The chcking for 'error: unknown warning option' is for clang on darwin not giving us a
3254	# non-zero exit code when using an invalid option here, but it does later on.
3255	VBOX_GCC_CHECK_EX_CC_CXX = $(shell \
3256	if $(1) $(subst -Wno-,-W,$(2)) -Werror -c -o $(VBOX_DEV_NULL) $(4) > $(VBOX_DEV_NULL) 2>&1; then \
3257	case "`LC_ALL=C $(1) $(subst -Wno-,-W,$(2)) -Werror -c -o $(VBOX_DEV_NULL) $(4) 2>&1`" in \
3258	"error: unknown warning option"*$(CLOSEPAR) echo "$(3)";; \
3259	*$(CLOSEPAR) echo "$(2)";; \
3260	esac; \
3261	else echo "$(3)"; fi; )
3262	VBOX_GCC_CHECK_EX_CC = $(call VBOX_GCC_CHECK_EX_CC_CXX,$(1),$(2),$(3),-xc $(PATH_OUT)/DynamicConfig.c)
3263	VBOX_GCC_CHECK_EX_CXX = $(call VBOX_GCC_CHECK_EX_CC_CXX,$(1),$(2),$(3),-xc++ $(PATH_OUT)/DynamicConfig.cpp)
3264	VBOX_GCC_CHECK_EX_LD = $(shell \
3265	if $(1) -Wl,$(2) $(if $(eq $(KBUILD_HOST),darwin),-Wl$(COMMA)-u$(COMMA)start -Wl$(COMMA)-undefined$(COMMA)dynamic_lookup,) \
3266	-nostdlib -o $(VBOX_DEV_NULL) -xc $(VBOX_DEV_NULL) > /dev/null 2>&1; \
3267	then echo "-Wl,$(2)"; else echo "$(3)"; fi; )
3268
3269	VBOX_GCC_CHECK_CC = $(call VBOX_GCC_CHECK_EX_CC, $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC_TOOL)_CC),$1,$2)
3270	VBOX_GCC_CHECK_CXX = $(call VBOX_GCC_CHECK_EX_CXX, $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC_TOOL)_CXX),$1,$2)
3271	VBOX_GCC_CHECK_LD = $(call VBOX_GCC_CHECK_EX_LD, $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC_TOOL)_LD),$1,$2)
3272	ifdef VBOX_GCC32_TOOL
3273	VBOX_GCC32_CHECK_CXX = $(call VBOX_GCC_CHECK_EX_CXX, $(TOOL_$(VBOX_GCC32_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC32_TOOL)_CXX),$1,$2)
3274	endif
3275
3276	# This is kind of bad, the returned string needs to be re-evaluated before use.
3277	# The reason for this hack is that the windows kmk_ash cannot deal with $((1+1)). <-- no longer true.
3278	# Some versions of gcc (e.g. openSUSE11) return only major.minor on `gcc -dumpversion`.
3279	# gcc-5 of openSUSE42.1 only returns the major version on `gcc -dumpversion`!
3280	VBOX_GCC_VERSION = $(shell ($(1) -dumpfullversion 2>/dev/null \|\| $(1) -dumpversion) \| \
3281	$(SED_EXT) 's\|$[0-9][0-9]$\.\{0,1\}$[0-9]\{0,\}$\.\{0,1\}$[0-9]\{0,\}$.\|$$(expr 10000 * \1 + 100 * $$(firstword \2 0) + $$(firstword \3 0))\|' )
3282	VBOX_CLANG_VERSION = $(shell $(1) --version \| \
3283	$(SED_EXT) -n 's\|.version $[0-9][0-9]$\.\{0,1\}$[0-9]\{0,\}$\.\{0,1\}$[0-9]\{0,\}$.\|$$(expr 10000 \1 + 100 * $$(firstword \2 0) + $$(firstword \3 0))\|p' )
3284	endif # VBOX_GCC_TOOL
3285
3286	# YASM macros
3287	if !defined(DONT_USE_YASM) && "$(intersects $(KBUILD_HOST_ARCH) $(KBUILD_TARGET_ARCH), x86 amd64 arm64)" != ""
3288	include $(KBUILD_PATH)/tools/YASM.kmk
3289	VBOX_YASM_CHECK = $(if-expr "$(shell $(TOOL_YASM_AS) -e -o $(VBOX_DEV_NULL) $1 - < /dev/null 2>&1)" == "",$(1),)
3290	endif
3291
3292	# NASM macros (input and output must differ with recent versions (strcmp)).
3293	if !defined(DONT_USE_NASM) && "$(intersects $(KBUILD_HOST_ARCH) $(KBUILD_TARGET_ARCH), x86 amd64 arm64)" != ""
3294	include $(KBUILD_PATH)/tools/NASM.kmk
3295	VBOX_NASM_CHECK = $(if-expr "$(shell $(TOOL_NASM_AS) -e -o $(VBOX_DEV_NULL) $1 $(VBOX_DEV_NULL_ALT) 2>&1)" == "",$(1),$(2))
3296	endif
3297
3298	# Figures the pylint version.
3299	VBOX_PYLINT_FIGURE_VERSION = $(shell $(1) --version 2> /dev/null \
3300	\| $(SED_EXT) -n -e 's/pylint-[^[:blank:]]*/pylint/' \
3301	-e 's\|^ pylint $[0-9][0-9]$.$[0-9][0-9]$\.$[0-9][0-9]$.$(DOLLAR)\|$$(expr \1 * 10000 + \2 * 100 + \3)\|p' )
3302
3303	# Java stuff.
3304	ifeq ($(KBUILD_TARGET),darwin)
3305	VBOX_JAVA_BIN_PATH = $(firstword $(wildcard \
3306	/System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Commands \
3307	/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Commands \
3308	$(if-expr $(VBOX_XCODE_VERSION_MAJOR) >= 4,/System/Library/Frameworks/JavaVM.framework/Versions/A/Commands,) \
3309	$(if-expr $(VBOX_XCODE_VERSION_MAJOR) >= 10,/Library/Java/JavaVirtualMachines/jdk1.8.*.jdk/Contents/Home/bin,) \
3310	) /usr/bin)
3311	VBOX_JAVA = $(VBOX_JAVA_BIN_PATH)/java
3312	VBOX_JAVAC = $(VBOX_JAVA_BIN_PATH)/javac
3313	VBOX_JAVAH = $(VBOX_JAVA_BIN_PATH)/javah
3314	VBOX_JAR = $(VBOX_JAVA_BIN_PATH)/jar
3315	VBOX_JAVADOC = $(VBOX_JAVA_BIN_PATH)/javadoc
3316	VBOX_WSIMPORT = $(VBOX_JAVA_BIN_PATH)/wsimport
3317	if $(VBOX_XCODE_VERSION_MAJOR) >= 4 # Lion (4.1-preview 5) has a broken CurrentJDK link. Blindly applying it to 4.0.
3318	VBOX_JAVA_INC = $(firstword $(wildcard \
3319	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/JavaVM.framework/Versions/A/Headers \
3320	/Library/Java/JavaVirtualMachines/jdk1.8.jdk/Contents/Home/include \
3321	) )
3322	else
3323	VBOX_JAVA_INC = $(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Headers
3324	endif
3325
3326	else # !darwin
3327
3328	ifeq ($(KBUILD_TARGET),linux)
3329	ifeq ($(origin VBOX_JAVA_HOME),undefined)
3330	# Add correct detection for you distro after the /usr/../java-6-sun line.
3331	VBOX_JAVA_HOME := $(firstword $(wildcard \
3332	$(KBUILD_DEVTOOLS)/linux.x86/jdk1.6.0_27 \
3333	/usr/lib/jvm/java-6-sun \
3334	/usr/lib/jvm/java-6-openjdk \
3335	/usr/lib/jvm/java-6-openjdk-i386 \
3336	/usr/lib/jvm/java-6-openjdk-amd64 \
3337	/usr/lib/jvm/java-7-openjdk-i386 \
3338	/usr/lib/jvm/java-7-openjdk-amd64 \
3339	/usr/lib/jvm/default-java \
3340	/usr/lib/jvm/java \
3341	/usr/lib/jvm/jre \
3342	\
3343	/usr/lib/jvm/sun-jdk-1.6 \
3344	) /usr/lib/jvm/java-6-sun)
3345	endif
3346	endif
3347
3348	ifeq ($(KBUILD_TARGET),solaris)
3349	# VBOX_JAVA_HOME ?= /usr/jdk/jdk1.6.0
3350	VBOX_JAVA_HOME ?= $(firstword $(abspath $(wildcard \
3351	/usr/jdk/latest/include/.. \
3352	/usr/jdk/instances/jdk1.8*/include/.. \
3353	/usr/jdk/instances/jdk1.7*/include/.. \
3354	/usr/jdk/instances/jdk1.6*/include/.. \
3355	)) /usr/java)
3356	endif
3357
3358	ifeq ($(KBUILD_TARGET),win)
3359	VBOX_JAVA_HOME ?= c:/jdk
3360	endif
3361
3362	VBOX_JAVA_BIN_PATH ?= $(VBOX_JAVA_HOME)/bin
3363	VBOX_JAVA ?= "$(VBOX_JAVA_BIN_PATH)/java$(HOSTSUFF_EXE)"
3364	VBOX_JAVAC = "$(VBOX_JAVA_BIN_PATH)/javac$(HOSTSUFF_EXE)"
3365	VBOX_JAVAH = "$(VBOX_JAVA_BIN_PATH)/javah$(HOSTSUFF_EXE)"
3366	VBOX_JAR = "$(VBOX_JAVA_BIN_PATH)/jar$(HOSTSUFF_EXE)"
3367	VBOX_JAVADOC = "$(VBOX_JAVA_BIN_PATH)/javadoc$(HOSTSUFF_EXE)"
3368	# With Java 11 wsimport was removed, usually part of a separate install now.
3369	VBOX_WSIMPORT = $(firstword $(wildcard $(VBOX_JAVA_BIN_PATH)/wsimport$(HOSTSUFF_EXE)) wsimport$(HOSTSUFF_EXE))
3370	# correct for targets we care about
3371	VBOX_MD_OS = $(KBUILD_TARGET)
3372	VBOX_JAVA_INC = \
3373	$(VBOX_JAVA_HOME)/include \
3374	$(VBOX_JAVA_HOME)/include/$(VBOX_MD_OS)
3375	endif # !darwin
3376
3377	# The first transform the almost usless openjdk versions like "javac 9-Ubuntu" into something the 2nd expression groks.
3378	VBOX_JAVA_FIGURE_VERSION = $(shell $(1) -version 2>&1 \
3379	\| $(SED_EXT) -n \
3380	-e 's/ $[0-9][0-9]*$$-[[:alpha:]][[:alpha:]]$/ \1.0.0\2/' \
3381	-e 's\|^[^ ]* $[0-9][0-9]$\.$[0-9][0-9]$\.$[0-9][0-9]$.$(DOLLAR)\|$$(expr \1 10000 + \2 * 100 + \3)\|p' )
3382
3383
3384	# Test C and C++ files.
3385	$(PATH_OUT)/DynamicConfig.c $(PATH_OUT)/DynamicConfig.cpp:
3386	$(QUIET)$(MKDIR) -p $(@D)
3387	$(QUIET)$(APPEND) -tn "$@" "int foobar(void)" "{" " return 42;" "}" ""
3388
3389	# No $(QUIET) here as it's interesting to see what goes into the file.
3390	$(PATH_OUT)/DynamicConfig.kmk: \
3391	$(PATH_ROOT)/Config.kmk \
3392	$(LOCALCFG) \
3393	$(AUTOCFG) \
3394	$(VBOX_GCC_PATH_CC) \
3395	$(VBOX_GCC_PATH_CXX) \
3396	$(VBOX_GCC_LIBGCC) \
3397	$(VBOX_GCC32_PATH_CC) \
3398	$(VBOX_GCC32_PATH_CXX) \
3399	$(VBOX_GCC32_LIBGCC) \
3400	$(if-expr "$(KBUILD_HOST).$(KBUILD_HOST_ARCH)" == "solaris.amd64" && $(KBUILD_HOST_VERSION_MINOR) >= 11 \
3401	, /platform/i86pc/kernel/$(KBUILD_HOST_ARCH)/unix,) \
3402	\| $(PATH_OUT)/DynamicConfig.c $(PATH_OUT)/DynamicConfig.cpp
3403	$(call MSG_GENERATE,,$@,)
3404	$(QUIET)$(RM) -f '$@'
3405	$(QUIET)$(MKDIR) -p $(@D)
3406	$(QUIET)$(APPEND) '$@' '# Host version: $(KBUILD_HOST_VERSION_MAJOR).$(KBUILD_HOST_VERSION_MINOR).$(KBUILD_HOST_VERSION_PATCH); full: $(KBUILD_HOST_VERSION)'
3407	ifneq ($(KBUILD_TARGET),win)
3408	$(QUIET)$(APPEND) '$@' '# $(KBUILD_HOST_UNAME_SYSNAME) - $(KBUILD_HOST_UNAME_RELEASE) - $(KBUILD_HOST_UNAME_VERSION)'
3409	endif
3410	ifeq ($(KBUILD_TARGET),darwin)
3411	$(QUIET)$(APPEND) '$@' '# VBOX_XCODE_VERSION: $(VBOX_XCODE_VERSION)'
3412	$(QUIET)$(APPEND) '$@' '# VBOX_PATH_MACOSX_TOOLCHAIN_ROOT: $(VBOX_PATH_MACOSX_TOOLCHAIN_ROOT)'
3413	$(QUIET)$(APPEND) '$@' '# VBOX_PATH_MACOSX_SDK_ROOT: $(VBOX_PATH_MACOSX_SDK_ROOT)'
3414	$(QUIET)$(APPEND) '$@' '# VBOX_PATH_MACOSX_DEVEL_ROOT: $(VBOX_PATH_MACOSX_DEVEL_ROOT)'
3415	endif
3416	ifdef VBOX_GCC_TOOL
3417	# HC compiler switch detection.
3418	$(QUIET)$(APPEND) '$@' '# VBOX_GCC_TOOL=$(VBOX_GCC_TOOL)'
3419	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_VERSION_CC ?= $(call VBOX_GCC_VERSION,$(TOOL_$(VBOX_GCC_TOOL)_CC))'
3420	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_VERSION_CXX ?= $(call VBOX_GCC_VERSION,$(TOOL_$(VBOX_GCC_TOOL)_CXX))'
3421	if "$(KBUILD_TARGET)" == "darwin" \|\| $(pos CLANG,$(VBOX_GCC_TOOL)) > 0
3422	$(QUIET)$(APPEND) '$@' 'VBOX_CLANG_VERSION_CC ?= $(call VBOX_CLANG_VERSION,$(TOOL_$(VBOX_GCC_TOOL)_CC))'
3423	$(QUIET)$(APPEND) '$@' 'VBOX_CLANG_VERSION_CXX ?= $(call VBOX_CLANG_VERSION,$(TOOL_$(VBOX_GCC_TOOL)_CXX))'
3424	endif
3425	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_PATH_CC ?= $(which $(TOOL_$(VBOX_GCC_TOOL)_CC))'
3426	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_PATH_CXX ?= $(which $(TOOL_$(VBOX_GCC_TOOL)_CXX))'
3427	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_LIBGCC ?= $(shell $(TOOL_$(VBOX_GCC_TOOL)_CC) -print-libgcc-file-name)'
3428	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-pointer-sign ?= $(call VBOX_GCC_CHECK_CC,-Wno-pointer-sign,)'
3429	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-array_bounds ?= $(call VBOX_GCC_CHECK_CC,-Wno-array-bounds,)'
3430	# -Wextra produces additional useful warnings but includes -Wno-missing-field-initializers (too noisy)
3431	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wextra ?= $(call VBOX_GCC_CHECK_CC,-Wextra,)'
3432	$(QUIET)$(APPEND) '$@' 'ifneq ($$(VBOX_GCC_VERSION_CC),)'
3433	$(QUIET)$(APPEND) '$@' ' if $$(VBOX_GCC_VERSION_CC) >= 40500'
3434	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_Wlogical-op ?= $(call VBOX_GCC_CHECK_CC,-Wlogical-op,)'
3435	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_Wno-logical-op ?= $$(subst -Wlogical-op,-Wno-logical-op,$$(VBOX_GCC_Wlogical-op))
3436	$(QUIET)$(APPEND) '$@' ' endif'
3437	$(QUIET)$(APPEND) '$@' 'endif'
3438	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-address ?= $(call VBOX_GCC_CHECK_CXX,-Wno-address,)'
3439	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-delete-non-virtual-dtor ?= $(call VBOX_GCC_CHECK_CXX,-Wno-delete-non-virtual-dtor,)'
3440	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-non-virtual-dtor ?= $(call VBOX_GCC_CHECK_CXX,-Wno-non-virtual-dtor,)'
3441	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-int-in-bool-context ?= $(call VBOX_GCC_CHECK_CC,-Wno-int-in-bool-context,)'
3442	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-int-to-pointer-cast ?= $(call VBOX_GCC_CHECK_CC,-Wno-int-to-pointer-cast,)'
3443	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-invalid-offsetof ?= $(call VBOX_GCC_CHECK_CXX,-Wno-invalid-offsetof,)'
3444	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-literal-suffix ?= $(call VBOX_GCC_CHECK_CXX,-Wno-literal-suffix,)'
3445	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-misleading-indentation ?= $(call VBOX_GCC_CHECK_CC,-Wno-misleading-indentation,)'
3446	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-missing-field-initializers ?= $(call VBOX_GCC_CHECK_CC,-Wno-missing-field-initializers,)'
3447	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-pointer-to-int-cast ?= $(call VBOX_GCC_CHECK_CC,-Wno-pointer-to-int-cast,)'
3448	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-variadic-macros ?= $(call VBOX_GCC_CHECK_CXX,-Wno-variadic-macros,)'
3449	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-vla ?= $(call VBOX_GCC_CHECK_CXX,-Wno-vla,)'
3450	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-overlength-strings ?= $(call VBOX_GCC_CHECK_CC,-Wno-overlength-strings,)'
3451	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-overloaded-virtual ?= $(call VBOX_GCC_CHECK_CXX,-Wno-overloaded-virtual,)'
3452	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-ignored-qualifiers ?= $(call VBOX_GCC_CHECK_CXX,-Wno-ignored-qualifiers,)'
3453	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-multistatement-macros ?= $(call VBOX_GCC_CHECK_CXX,-Wno-multistatement-macros,)'
3454	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-class-memaccess ?= $(call VBOX_GCC_CHECK_CXX,-Wno-class-memaccess,)'
3455	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-stringop-overflow ?= $(call VBOX_GCC_CHECK_CXX,-Wno-stringop-overflow,)'
3456	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-stringop-truncation ?= $(call VBOX_GCC_CHECK_CXX,-Wno-stringop-truncation,)'
3457	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-cast-function-type ?= $(call VBOX_GCC_CHECK_CC,-Wno-cast-function-type,)'
3458	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-deprecated-declarations ?= $(call VBOX_GCC_CHECK_CC,-Wno-deprecated-declarations,)'
3459	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-implicit-fallthrough ?= $(call VBOX_GCC_CHECK_CC,-Wno-implicit-fallthrough,)'
3460	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-inline ?= $(call VBOX_GCC_CHECK_CXX,-Wno-inline,)'
3461	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-unknown-pragmas ?= $(call VBOX_GCC_CHECK_CXX,-Wno-unknown-pragmas,)'
3462	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-deprecated-copy ?= $(call VBOX_GCC_CHECK_CXX,-Wno-deprecated-copy,)'
3463	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fno-stack-protector ?= $(call VBOX_GCC_CHECK_CC,-fno-stack-protector,)'
3464	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fno-dwarf2-cfi-asm ?= $(call VBOX_GCC_CHECK_CC,-fno-dwarf2-cfi-asm,)'
3465	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_m64 ?= $(call VBOX_GCC_CHECK_CC,-m64,)'
3466	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_msse4.1 ?= $(call VBOX_GCC_CHECK_CC,-msse4.1,)'
3467	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_mavx ?= $(call VBOX_GCC_CHECK_CC,-mavx,)'
3468	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_mavx2 ?= $(call VBOX_GCC_CHECK_CC,-mavx2,)'
3469	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_no-pie ?= $(call VBOX_GCC_CHECK_CC,-no-pie,)'
3470	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fdiagnostics-show-option ?= $(call VBOX_GCC_CHECK_CC,-fdiagnostics-show-option,)'
3471	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fno-printf-return-value ?= $(call VBOX_GCC_CHECK_CC,-fno-printf-return-value,)'
3472	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wa_cma_nocompress_debug_sections ?= $(call VBOX_GCC_CHECK_CC,-Wa$(COMMA)--nocompress-debug-sections,)'
3473	# Produce code optimized for the most common IA32/AMD64/EM64T processors. Introduced with gcc version 4.2.
3474	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_mtune-generic ?= $(call VBOX_GCC_CHECK_CC,-mtune=generic,)'
3475	$(QUIET)$(APPEND) '$@' 'VBOX_LD_as_needed ?= $(call VBOX_GCC_CHECK_LD,--as-needed,)'
3476	$(QUIET)$(APPEND) '$@' 'VBOX_LD_hash_style_sysv ?= $(call VBOX_GCC_CHECK_LD,--hash-style=sysv,)'
3477	$(QUIET)$(APPEND) '$@' 'VBOX_LD_gc_sections ?= $(call VBOX_GCC_CHECK_LD,--gc-sections,)'
3478	# Set default attribute for ELF and MACH-O symbols to ``hidden'' to reduce the number
3479	# of relocation entries and PLT indirections in shared libraries. Don't allow for gcc version < 4.
3480	$(QUIET)$(APPEND) '$@' 'ifneq ($$(VBOX_GCC_VERSION_CC),)'
3481	$(QUIET)$(APPEND) '$@' ' if $$(VBOX_GCC_VERSION_CC) >= 40000'
3482	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_fvisibility-hidden ?= $(call VBOX_GCC_CHECK_CC,-fvisibility=hidden -DVBOX_HAVE_VISIBILITY_HIDDEN -DRT_USE_VISIBILITY_DEFAULT,)'
3483	$(QUIET)$(APPEND) '$@' ' endif'
3484	$(QUIET)$(APPEND) '$@' 'endif'
3485	ifn1of ($(KBUILD_TARGET), haiku)
3486	# Set default attribute for inline functions to ``hidden'' to reduce the number
3487	# of relocation entries and PLT indirections in shared libraries. Don't allow for gcc version < 4.
3488	$(QUIET)$(APPEND) '$@' 'ifneq ($$(VBOX_GCC_VERSION_CXX),)'
3489	$(QUIET)$(APPEND) '$@' ' if $$(VBOX_GCC_VERSION_CXX) >= 40000'
3490	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_fvisibility-inlines-hidden ?= $(call VBOX_GCC_CHECK_CXX,-fvisibility-inlines-hidden,)'
3491	$(QUIET)$(APPEND) '$@' ' endif'
3492	$(QUIET)$(APPEND) '$@' 'endif'
3493	endif
3494	# Prevent warnings about unused parameters as of gcc-4.8 / clang 6 as this warning is now very verbose
3495	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-unused-parameter ?= $(call VBOX_GCC_CHECK_CC,-Wno-unused-parameter,)'
3496	# Clang 6.
3497	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-language-extension-token ?= $(call VBOX_GCC_CHECK_CC,-Wno-language-extension-token,)'
3498	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-extended-offsetof ?= $(call VBOX_GCC_CHECK_CC,-Wno-extended-offsetof,)'
3499	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-gnu-folding-constant ?= $(call VBOX_GCC_CHECK_CC,-Wno-gnu-folding-constant,)'
3500	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-return-type-c-linkage ?= $(call VBOX_GCC_CHECK_CXX,-Wno-return-type-c-linkage,)'
3501	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-string-plus-int ?= $(call VBOX_GCC_CHECK_CC,-Wno-string-plus-int,)'
3502	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-nested-anon-types ?= $(call VBOX_GCC_CHECK_CC,-Wno-nested-anon-types,)'
3503	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-gnu-anonymous-struct ?= $(call VBOX_GCC_CHECK_CXX,-Wno-gnu-anonymous-struct,)'
3504	# Clang 11.
3505	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-c++17-compat-mangling ?= $(call VBOX_GCC_CHECK_CXX,-Wno-c++17-compat-mangling,)'
3506	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-nullability-extension ?= $(call VBOX_GCC_CHECK_CXX,-Wno-nullability-extension,)'
3507	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-gnu-statement-expression ?= $(call VBOX_GCC_CHECK_CXX,-Wno-gnu-statement-expression,)'
3508	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-import-preprocessor-directive-pedantic ?= $(call VBOX_GCC_CHECK_CXX,-Wno-import-preprocessor-directive-pedantic,)'
3509	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-undefined-var-template ?= $(call VBOX_GCC_CHECK_CXX,-Wno-undefined-var-template,)'
3510	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-c11-extensions ?= $(call VBOX_GCC_CHECK_CXX,-Wno-c11-extensions,)'
3511	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-tautological-pointer-compare ?= $(call VBOX_GCC_CHECK_CC,-Wno-tautological-pointer-compare,)'
3512	# Clang 13.
3513	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-deprecated-copy ?= $(call VBOX_GCC_CHECK_CC,-Wno-deprecated-copy,)'
3514	ifdef VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION
3515	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fcf-protection_branch ?= $(call VBOX_GCC_CHECK_CXX,-fcf-protection=branch,)'
3516	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fcf-protection_check ?= $(call VBOX_GCC_CHECK_CXX,-fcf-protection=check)'
3517	endif
3518	ifeq ($(KBUILD_TARGET),solaris)
3519	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_msave-args ?= $(call VBOX_GCC_CHECK_CXX,-msave-args,)'
3520	# Detect the solaris assembler. It is used by the the 4.x gcc compilers,
3521	# apparently. It will not be able to handle IEMAll via a -pipe, only when
3522	# passed a file. The solaris assmbler rulez ... not!
3523	$(QUIET)$(APPEND) '$@' 'VBOX_AS_VERSION ?= $(shell `gcc -print-prog-name=as` -V -o $(VBOX_DEV_NULL) < /dev/null 2>&1 \| kmk_sed -e '1!d' -e 's/^as: *//' )'
3524	$(QUIET)$(APPEND) '$@' 'if $$(pos Sun Compiler Common,$$(VBOX_AS_VERSION)) > 0'
3525	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_USING_SOLARIS_AS = 1'
3526	$(QUIET)$(APPEND) '$@' 'endif'
3527	$(QUIET)$(APPEND) '$@' 'ifndef VBOX_GCC_USING_SOLARIS_AS'
3528	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_pipe ?= -pipe'
3529	$(QUIET)$(APPEND) '$@' 'endif'
3530	else
3531	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_pipe ?= -pipe'
3532	endif
3533	# Find the compiler includes for IPRT no-crt.
3534	# Note that `$(dir $(gcc -print-libgcc-file-name))/include does not work for a 64-bit cross build on a 32-bit build host.
3535	$(QUIET)$(APPEND) '$@' 'VBOX_PATH_GCC_INCS ?= $(shell LC_ALL=C $(TOOL_$(VBOX_GCC_TOOL)_CC) -print-search-dirs\|$(SED_EXT) -ne 's+^install: $.[^/][^/]$/+\1+p')/include'
3536	ifdef VBOX_GCC32_TOOL
3537	# 32-bit (GC) compiler switch detection.
3538	$(QUIET)$(APPEND) '$@' '# VBOX_GCC32_TOOL=$(VBOX_GCC32_TOOL)'
3539	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_PATH_CC ?= $(which $(TOOL_$(VBOX_GCC32_TOOL)_CC))'
3540	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_PATH_CXX ?= $(which $(TOOL_$(VBOX_GCC32_TOOL)_CXX))'
3541	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_VERSION_CC ?= $(call VBOX_GCC_VERSION,$(TOOL_$(VBOX_GCC32_TOOL)_CC))'
3542	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_VERSION_CXX ?= $(call VBOX_GCC_VERSION,$(TOOL_$(VBOX_GCC32_TOOL)_CXX))'
3543	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_LIBGCC ?= $(shell $(TOOL_$(VBOX_GCC32_TOOL)_CC) -print-libgcc-file-name)'
3544	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_Wno-variadic-macros ?= $(call VBOX_GCC32_CHECK_CXX,-Wno-variadic-macros,)'
3545	endif
3546	# darwin no_compact_linkedit starting at Xcode 3.2
3547	ifeq ($(KBUILD_HOST),darwin)
3548	$(QUIET)$(APPEND) '$@' 'VBOX_LD_no_compact_linkedit ?= $(call VBOX_GCC_CHECK_LD,-no_compact_linkedit,)'
3549	endif
3550	endif # ifdef VBOX_GCC_TOOL
3551
3552	ifdef VBOX_YASM_CHECK
3553	# YASM
3554	$(QUIET)$(APPEND) '$@' '# debug: TOOL_YASM_AS="$(TOOL_YASM_AS)"'
3555	$(QUIET)$(APPEND) '$@' 'VBOX_YASM_Wno-segreg-in-64bit ?= $(call VBOX_YASM_CHECK,-Wno-segreg-in-64bit,)'
3556	endif
3557	ifdef VBOX_NASM_CHECK
3558	# NASM (--allow-64-bit: 2.12rc2)
3559	$(QUIET)$(APPEND) '$@' 'VBOX_NASM_allow_64_bit ?= $(call VBOX_NASM_CHECK,--allow-64-bit,)'
3560	endif
3561
3562	if1of ($(KBUILD_TARGET), linux)
3563	ifeq ($(KBUILD_TARGET),$(KBUILD_HOST))
3564	$(QUIET)$(RM) -f -- "$@.sanitizer.so" "$@.sanitizer32.so" '$@.sanitizer.c'
3565	$(APPEND) -t '$@.sanitizer.c' 'int foo() { return 42; }'
3566	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_SANITIZER_SO_FILES := \'
3567	$(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC_TOOL)_CC) -fPIC -shared \
3568	$(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS) -o "$@.sanitizer.so" "$@.sanitizer.c"
3569	ldd "$@.sanitizer.so" \| $(SED_EXT) --append '$@' -re '/lib(a\|ub)san\.so/!d' -e 's/.* => //' -e 's/ $0x[0-9a-fA-F]$ $(DOLLAR)/ \\/'
3570	$(QUIET)$(APPEND) '$@' ''
3571	# $(QUIET)$(APPEND) '$@' 'VBOX_GCC32_SANITIZER_SO_FILES := \'
3572	# $(TOOL_$(VBOX_GCC32_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC32_TOOL)_CC) -fPIC -shared \
3573	# $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS) -o "$@.sanitizer32.so" "$@.sanitizer.c"
3574	# ldd "$@.sanitizer32.so" \| $(SED_EXT) --append '$@' -re '/lib(a\|ub)san\.so/!d' -e 's/.* => //' -e 's/ $0x[0-9a-fA-F]$ $(DOLLAR)/ \\/'
3575	# $(QUIET)$(APPEND) '$@' ''
3576	$(QUIET)$(RM) -f -- "$@.sanitizer.so" "$@.sanitizer32.so" '$@.sanitizer.c'
3577	endif
3578	endif
3579	ifdef VBOX_PATH_PREFIX_MINGW32
3580	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_VERSION_CC ?= $(call VBOX_GCC_VERSION,$(VBOX_PATH_PREFIX_MINGW32)gcc -m32)'
3581	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_VERSION_CXX ?= $(call VBOX_GCC_VERSION,$(VBOX_PATH_PREFIX_MINGW32)g++ -m32)'
3582	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_Wno-array-bounds ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW32)g++ -m32,-Wno-array-bounds,)'
3583	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_Wno-unused-but-set-variable ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW32)g++ -m32,-Wno-unused-but-set-variable,)'
3584	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_Wno-maybe-uninitialized ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW32)g++ -m32,-Wno-maybe-uninitialized,)'
3585	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_USER_LABEL_PREFIX ?= $(shell echo "__USER_LABEL_PREFIX__" \| $(VBOX_PATH_PREFIX_MINGW32)g++ -m32 -E -xc++ - \| $(SED) -e "/^$(HASH)/d")'
3586	endif
3587	ifdef VBOX_PATH_PREFIX_MINGW64
3588	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_VERSION_CC ?= $(call VBOX_GCC_VERSION,$(VBOX_PATH_PREFIX_MINGW64)gcc -m64)'
3589	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_VERSION_CXX ?= $(call VBOX_GCC_VERSION,$(VBOX_PATH_PREFIX_MINGW64)g++ -m64)'
3590	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_Wno-array-bounds ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW64)g++ -m64,-Wno-array-bounds,)'
3591	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_Wno-unused-but-set-variable ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW64)g++ -m64,-Wno-unused-but-set-variable,)'
3592	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_Wno-maybe-uninitialized ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW64)g++ -m64,-Wno-maybe-uninitialized,)'
3593	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_USER_LABEL_PREFIX ?= $(shell echo "__USER_LABEL_PREFIX__" \| $(VBOX_PATH_PREFIX_MINGW64)g++ -m64 -E -xc++ - \| $(SED) -e "/^$(HASH)/d")'
3594	endif
3595	if defined(TOOL_FLEX) \|\| defined(TOOL_BISON)
3596	echo "Do NOT include the flex or bison tools before Config.kmk gets loaded"
3597	exit 1 #
3598	endif
3599	$(QUIET)$(APPEND) '$@' 'VBOX_HAVE_FLEX ?= $(firstfile $(TOOL_FLEX_LEX) $(which flex))'
3600	$(QUIET)$(APPEND) '$@' 'VBOX_HAVE_BISON ?= $(firstfile $(TOOL_BISON_YACC) $(which bison))'
3601	if "$(KBUILD_HOST)" == "solaris" && $(KBUILD_HOST_VERSION_MAJOR) == 5 && $(KBUILD_HOST_VERSION_MINOR) == 11
3602	# BRANCH_VERSION format on S11 - S11.3:
3603	# <trunk_id>.<update>.<sru>.<reserved>.<buildid>.<nightly_id>
3604	# e.g.: 0.175.3.32.0.4.0:20180427T232405Z - N.B. trunk_id = 0.175
3605	# BRANCH_VERSION format on S11.4:
3606	# <minor>.<update>.<sru>.<reserved>.<reserved>.<buildid>.<nightly_id>
3607	# e.g.: 11.4.0.0.1.10.0:20180702T173343Z
3608	# We're interested in <update> and <buildid>.
3609	$(QUIET)$(APPEND) '$@' "VBOX_SOLARIS_11_BRANCH_VERSION := $(shell pkg contents -H -t set -o pkg.fmri system/kernel \| $(SED_EXT) -e '1!d' -e 's/^.\-//;s/\:.//;s/.*,//')"
3610	$(QUIET)$(APPEND) '$@' 'ifeq ($$(word 2, $$(subst ., ,$$(VBOX_SOLARIS_11_BRANCH_VERSION))),175)'
3611	$(QUIET)$(APPEND) '$@' ' VBOX_SOLARIS_11_UPDATE_VERSION := $$(word 3, $$(subst ., ,$$(VBOX_SOLARIS_11_BRANCH_VERSION)))'
3612	$(QUIET)$(APPEND) '$@' 'else'
3613	$(QUIET)$(APPEND) '$@' ' VBOX_SOLARIS_11_UPDATE_VERSION := $$(word 2, $$(subst ., ,$$(VBOX_SOLARIS_11_BRANCH_VERSION)))'
3614	$(QUIET)$(APPEND) '$@' 'endif'
3615	$(QUIET)$(APPEND) '$@' 'VBOX_SOLARIS_11_BUILD_VERSION := $$(word 6, $$(subst ., ,$$(VBOX_SOLARIS_11_BRANCH_VERSION)))'
3616	endif
3617	if1of ($(KBUILD_HOST), darwin freebsd solaris)
3618	$(QUIET)$(APPEND) '$@' 'VBOX_HOST_DTRACE_VERSION := $(shell dtrace -V)'
3619	endif
3620	if defined(VBOX_PYLINT) && !defined(VBOX_WITH_PYLINT_PRE_V1_0) && !defined(VBOX_WITH_PYLINT_V1_1_PLUS) && !defined(VBOX_WITH_PYLINT_V1_2_1_PLUS)
3621	$(QUIET)$(APPEND) '$@' "VBOX_PYLINT_VERSION := $(call VBOX_PYLINT_FIGURE_VERSION, $(VBOX_PYLINT))"
3622	endif
3623	if defined(VBOX_JAVAC)
3624	$(QUIET)$(APPEND) '$@' 'VBOX_JAVA_VERSION := $(call VBOX_JAVA_FIGURE_VERSION, $(VBOX_JAVAC))'
3625	endif
3626	$(QUIET)$(APPEND) '$@' '#$(which $(VBOX_XSLTPROC))'
3627	$(QUIET)$(APPEND) '$@' 'VBOX_XSLTPROC_VERSION := $(firstword $(shell $(VBOX_XSLTPROC) --version \| $(SED) -e /libxslt/q \| $(SED) -e 's/^.libxslt $[0-9][0-9]$[^0-9]./\1/' ) 0)'
3628	$(QUIET)$(APPEND) '$@' 'VBOX_XSLTPROC_LIBXML_VERSION := $(firstword $(shell $(VBOX_XSLTPROC) --version \| $(SED) -e /libxml/q \| $(SED) -e 's/^.libxml $[0-9][0-9]$[^0-9]./\1/' ) 0)'
3629
3630	$(QUIET)$(ECHO) '========= START OF $@ ========='
3631	$(QUIET)$(CAT) $@
3632	$(QUIET)$(ECHO) '=========== END OF $@ ========='
3633
3634	include $(PATH_OUT)/DynamicConfig.kmk
3635	endif # !VBOX_NOINC_DYNAMIC_CONFIG_KMK
3636
3637
3638	#
3639	# C++ language level
3640	# See https://en.cppreference.com/w/cpp/compiler_support and compiler docs.
3641	#
3642	## @todo consider maxing this out.
3643	ifndef VBOX_GCC_std
3644	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.arm64) # Go straight for c++17 here.
3645	VBOX_GCC_std := -std=c++17
3646	# else if "$(VBOX_CLANG_VERSION_CXX)" vge 60000 # Most language features complete by v6. Lib stuff was less complete in v6, but hopefully acceptable for out purposes.
3647	#VBOX_GCC_std := -std=c++17
3648	else if "$(VBOX_CLANG_VERSION_CXX)" vge 50000 # darwin Xcode 5 allegedly knows what C++11 is
3649	VBOX_GCC_std := -std=c++11
3650	# else if "$(VBOX_GCC_VERSION_CXX)" vge 70000 # Language feature P0512R0 was v8, rest v7 or earlier. Most lib stuff present in 7, complete in v12.
3651	#VBOX_GCC_std := -std=gnu++17
3652	else if "$(VBOX_GCC_VERSION_CXX)" vge 40800
3653	VBOX_GCC_std := -std=c++11
3654	else if "$(VBOX_GCC_VERSION_CXX)" vge 40600
3655	VBOX_GCC_std := -std=c++0x
3656	endif
3657	endif
3658	ifndef VBOX_VCC_std
3659	if $(VBOX_VCC_TOOL_STEM) >= VCC141 # since 2017 15.3
3660	VBOX_VCC_std := -Zc:__cplusplus -std:c++17
3661	endif
3662	endif
3663
3664
3665	#
3666	# Compiler warning control.
3667	#
3668	VBOX_GCC_WARN ?= -Wall $(VBOX_GCC_Wextra) $(VBOX_GCC_Wno-missing-field-initializers) -Wno-unused -Wno-trigraphs \
3669	$(VBOX_GCC_fdiagnostics-show-option) $(VBOX_GCC_Wno-unused-parameter) $(VBOX_GCC_Wno-language-extension-token) \
3670	$(VBOX_GCC_Wno-extended-offsetof) $(VBOX_GCC_Wno-gnu-folding-constant) $(VBOX_GCC_Wno-gnu-anonymous-struct) \
3671	$(VBOX_GCC_Wlogical-op) $(VBOX_GCC_Wno-string-plus-int) $(VBOX_GCC_Wno-nested-anon-types) $(VBOX_GCC_Wno-variadic-macros) \
3672	$(VBOX_GCC_Wno-c++17-compat-mangling)
3673	VBOX_GCC_WARN_PEDANTIC = -Wshadow $(VBOX_GCC_WARN) -Wno-long-long
3674	if $(VBOX_GCC_VERSION_CXX) >= 40200 \|\| defined(VBOX_WITH_MASOCHISTIC_WARNINGS) # gcc 4.2.x+ (4.1.2 is causing trouble with the extpack & add builds)
3675	VBOX_GCC_WARN_MASOCHISTIC ?= -Wunused-variable -Wunused-function -Wunused-label -Wunused-parameter
3676	endif
3677	if $(KBUILD_TARGET) == "linux" \
3678	\|\| ($(KBUILD_TARGET) == "darwin" && "$(VBOX_GCC_TOOL)" != "GXX4MACHO" && "$(VBOX_GCC_TOOL)" != "GXX42MACHO") \
3679	\|\| defined(VBOX_WITH_MASOCHISTIC_WARNINGS)
3680	VBOX_GCC_WARN_PEDANTIC += $(VBOX_GCC_WARN_MASOCHISTIC)
3681	endif
3682
3683	ifdef VBOX_GCC_Wno-variadic-macros # Don't use -pedantic unless -Wno-variadic-macros also works. Too noisy.
3684	VBOX_GCC_PEDANTIC_OPTION ?= -pedantic
3685	else
3686	VBOX_GCC_PEDANTIC_OPTION ?=
3687	endif
3688	VBOX_GCC_PEDANTIC_CXX ?= $(VBOX_GCC_PEDANTIC_OPTION) $(VBOX_GCC_WARN_PEDANTIC) \
3689	$(VBOX_GCC_Wno-return-type-c-linkage) $(VBOX_GCC_Wno-overloaded-virtual) $(VBOX_GCC_Wno-undefined-var-template) $(VBOX_GCC_Wno-deprecated-copy)
3690	VBOX_GCC_PEDANTIC_C ?= $(VBOX_GCC_PEDANTIC_OPTION) $(VBOX_GCC_WARN_PEDANTIC) -Wmissing-prototypes -Wstrict-prototypes -Wmissing-declarations -Werror-implicit-function-declaration
3691
3692	# Avoid freaking out when using flexible arrays in C++ code (ldrPE.cpp, ++).
3693	if ($(VBOX_GCC_VERSION_CXX) < 60100 \|\| $(VBOX_GCC_VERSION_CXX) >= 70000) && "$(VBOX_GCC_Wno-array_bounds)" != ""
3694	VBOX_GCC_PEDANTIC_CXX += $(VBOX_GCC_Wno-array_bounds)
3695	endif
3696	# Stupid problem with (__typeof__((*ppv)) casts in asm.h where volatile is involved and ignored.
3697	if $(VBOX_GCC_VERSION_CXX) >= 80000 && "$(VBOX_GCC_Wno-ignored-qualifiers)"
3698	VBOX_GCC_PEDANTIC_CXX += $(VBOX_GCC_Wno-ignored-qualifiers)
3699	endif
3700
3701
3702	VBOX_GCC_NON_PEDANTIC_CXX ?= -Wno-sign-compare
3703	VBOX_GCC_NON_PEDANTIC_C ?= -Wno-sign-compare -Werror-implicit-function-declaration
3704
3705	if "$(KBUILD_TARGET)" == "darwin" && "$(VBOX_GCC_TOOL)" != "GXX4MACHO" && "$(VBOX_GCC_TOOL)" != "GXX42MACHO"
3706	VBOX_GCC_PEDANTIC_CXX += -Wno-c99-extensions
3707	VBOX_GCC_NON_PEDANTIC_CXX += -Wno-c99-extensions
3708	endif
3709
3710
3711	# Disabled Visual C++ warnings, W4:
3712	# -wd4065: switch statement contains 'default' but no 'case' labels
3713	# -wd4996: deprecated / insecure.
3714	# -wd4127: conditional expression is constant [level 4]
3715	# -wd4706: assignment within conditional expression [level 4]
3716	# -wd4201: nonstandard extension used : nameless struct/union [level 4]
3717	# -wd4214: nonstandard extension used : bit field types other than int [level 4]
3718	# -wd4510: 'VM::<unnamed-tag>' : default constructor could not be generated
3719	# -wd4512: 'VM' : assignment operator could not be generated
3720	# -wd4610: union 'VM::<unnamed-tag>' can never be instantiated - user defined constructor required
3721	# Disabled Visual C++ warnings, Wall:
3722	# -wd4514: unreferenced inline function has been removed
3723	# -wd4820: 'RTSTRSPACECORE' : '7' bytes padding added after data member 'RTSTRSPACECORE::uchHeight'
3724	# -wd4365: '=' : conversion from 'unsigned char' to 'char', signed/unsigned mismatch
3725	# -wd4987: nonstandard extension used: 'throw (...)' (setjmp.h + our stuff)
3726	# -wd4710: 'std::string std::_Narrow_str(std::wstring)' : function not inlined
3727	# -wd4061: enumerator 'RTASN1TYPE_END' in switch of enum 'RTASN1TYPE' is not explicitly handled by a case label
3728	# Note! C4062 checks for the same but includes the 'default' case, just like gcc. So, no trouble disabling this.
3729	# -wd4986: 'operator new[]': exception specification does not match previous declaration (crtdbg.h vs new, exception specification only)
3730	# -wd4191: 'type cast' : unsafe conversion from 'int (__cdecl *)(gzFile)' to 'PFNRT'
3731	# -wd4574: 'INCL_WINSOCK_API_TYPEDEFS' is defined to be '0': did you mean to use '#if INCL_WINSOCK_API_TYPEDEFS'?
3732	# -wd4917: 'OLE_XPOS_HIMETRIC' : a GUID can only be associated with a class, interface or namespace
3733	# -wd4711: function 'void __cdecl rtMemCacheFreeOne(struct RTMEMCACHEINT * __ptr64,void * __ptr64)' selected for automatic inline expansion
3734	# -wd4571: Informational: catch(...) semantics changed since Visual C++ 7.1; structured exceptions (SEH) are no longer caught
3735	# -wd4611: interaction between '_setjmp' and C++ object destruction is non-portable
3736	# -wd4324: '_TDI_PNP_CONTEXT_XP' : structure was padded due to __declspec(align())
3737	# -wd4505: VBoxNetFltNobj.h(45) : warning C4505: 'VBoxNetFltNobj::Release' : unreferenced local function has been removed
3738	# Probably related to http://stackoverflow.com/questions/3051992/compiler-warning-at-c-template-base-class
3739	# -wd4263: 'int VRDPChannelClipboard::SendPacket(const void *,uint32_t)' : member function does not override any base class virtual member function
3740	# Probably useful, but impractical, just like the next one.
3741	# -wd4264: 'int VRDPOutputCtx::SendPacket(void)' : no override available for virtual member function from base 'VRDPOutputCtx'; function is hidden
3742	# -wd4738: storing 32-bit float result in memory, possible loss of performance
3743	# -wd4371: UIActionPool.h(393) : warning C4371: 'UIActionPool::PointerToFunction' : layout of class may have changed from a previous version of the compiler due to better packing of member 'UIActionPool::PointerToFunction::ptfr'
3744	# -wd4748: uiactionpoolmanager.cpp(2723) : warning C4748: /GS can not protect parameters and local variables from local buffer overrun because optimizations are disabled in function
3745	# Want to enable these:
3746	# -wd4242: '=' : conversion from 'uint32_t' to 'uint8_t', possible loss of data
3747	# -wd4244: 'conversion' conversion from 'type1' to 'type2', possible loss of data
3748	# -wd4200: nonstandard extension used : zero-sized array in struct/union
3749	# Cannot generate copy-ctor or copy-assignment operator when UDT contains a zero-sized array
3750	VBOX_VCC_WARN_ALL := -W4 -Wall -wd4065 -wd4996 -wd4127 -wd4706 -wd4201 -wd4214 -wd4510 -wd4512 -wd4610 \
3751	-wd4514 -wd4820 -wd4365 -wd4987 -wd4710 -wd4061 -wd4986 -wd4191 -wd4574 -wd4917 -wd4711 -wd4611 -wd4571 -wd4324 -wd4505 \
3752	-wd4263 -wd4264 -wd4738 -wd4200 -wd4371 -wd4748
3753	if1of ($(VBOX_VCC_TOOL_STEM), VCC120)
3754	# -wd4350: behavior change: 'std::_Wrap_alloc<std::allocator<char>>::_Wrap_alloc(const std::_Wrap_alloc<std::allocator<char>> &) throw()' called instead of 'std::_Wrap_alloc<std::allocator<char>>::_Wrap_alloc<std::_Wrap_alloc<std::allocator<char>>>(_Other &) throw()'
3755	# -wd4435: iprt/cpp/xml.h(185) : warning C4435: 'xml::Input' : Object layout under /vd2 will change due to virtual base 'xml::Stream'
3756	VBOX_VCC_WARN_ALL += -wd4350 -wd4435
3757	endif
3758	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
3759	# -wd5045: Compiler will insert Spectre mitigation for memory load if /Qspectre switch specified
3760	# -wd4464: relative include path contains '..' (iprt/nocrt/compiler.msc.h)
3761	# -wd4623: 'VM': default constructor was implicitly defined as deleted
3762	# -wd4625: 'SUPDRVTRACERDATA': copy constructor was implicitly defined as deleted
3763	# -wd4626: 'SUPDRVTRACERDATA': assignment operator was implicitly defined as deleted
3764	# -wd5026: 'SUPDRVTRACERDATA': move constructor was implicitly defined as deleted
3765	# -wd5027: 'SUPDRVTRACERDATA': move assignment operator was implicitly defined as deleted
3766	# -wd4435: 'xml::Input': Object layout under /vd2 will change due to virtual base 'xml::Stream'
3767	# -wd4577: 'noexcept' used with no exception handling mode specified; termination on exception is not guaranteed. Specify /EHsc
3768	VBOX_VCC_WARN_ALL += -wd5045 -wd4464 -wd4623 -wd4625 -wd4626 -wd5026 -wd5027 -wd4435 -wd4577
3769	endif
3770	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # With v16.11.9, not with v16.6.0 4242
3771	# -wd5220: 'RTDBGMODINT::cRefs': a non-static data member with a volatile qualified type no longer implies that compiler generated copy/move constructors and copy/move assignment operators are not trivial
3772	VBOX_VCC_WARN_ALL += -wd5220
3773	# Temporarily:
3774	# -wd4242: asn1-ut-string.cpp(729): warning C4242: 'argument': conversion from 'uint32_t' to 'uint16_t', possibl loss of data
3775	# -wd4244: asn1-ut-objid.cpp(124): warning C4244: '=': conversion from 'uint32_t' to 'uint8_t', possible loss of data
3776	VBOX_VCC_WARN_ALL += -wd4242 -wd4244
3777	if1of (RT_RELAXED_CALLBACKS_TYPES, $(DEFS))
3778	# -wd5039: asn1-ut-core.cpp(212): warning C5039: 'RTAsn1EncodeWriteHeader': pointer or reference to potentially throwing function passed to 'extern "C"' function under -EHc. Undefined behavior may occur if this function throws an exception.
3779	VBOX_VCC_WARN_ALL += -wd5039
3780	endif
3781	endif
3782	# -wd4548: socket.cpp(1931): warning C4548: expression before comma has no effect; expected expression with side-effect
3783	VBOX_VCC_WARN_ALL += -wd4548
3784	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC143" && "$(KBUILD_TARGET_ARCH)" == "arm64"
3785	VBOX_VCC_WARN_ALL += -wd4746
3786	endif
3787	ifndef VBOX_NEWER_VCC_WARN_ALL
3788	if "$(VBOX_VCC_TOOL_STEM)" < "VCC120"
3789	VBOX_NEWER_VCC_WARN_ALL := $(VBOX_VCC_WARN_ALL) -wd4350 -wd4435
3790	else
3791	VBOX_NEWER_VCC_WARN_ALL := $(VBOX_VCC_WARN_ALL)
3792	endif
3793	endif
3794
3795
3796	# Disable pedantic warnings for NP/NonPedantic templates.
3797	# -wd4131: 'bi_flush' : uses old-style declarator
3798	# -wd4255: 'tr_static_init' : no function prototype given: converting '()' to '(void)'
3799	# -wd4668: '_WIN32_WCE' is not defined as a preprocessor macro, replacing with '0' for '#if/#elif'/
3800	# -wd4100: 'cinfo' : unreferenced formal parameter
3801	# -wd4189: 'sz' : local variable is initialized but not referenced
3802	# -wd4132: 'xmlStringComment' : const object should be initialized
3803	# -wd4152: nonstandard extension, function/data pointer conversion in expression
3804	# -wd4702: unreachable code
3805	# -wd4057: '=' : 'xmlChar ' differs in indirection to slightly different base types from 'char '
3806	# -wd4296: '>=' : expression is always true
3807	# -wd4389: '==' : signed/unsigned mismatch
3808	# -wd4018: '<=' : signed/unsigned mismatch
3809	# -wd4245: '=' : conversion from 'int' to 'unsigned int', signed/unsigned mismatch
3810	# -wd4267: '+=' : conversion from 'size_t' to 'long', possible loss of data
3811	# -wd4295: 'vendor_string' : array is too small to include a terminating null character
3812	VBOX_VCC_NON_PEDANTIC = -wd4131 -wd4255 -wd4668 -wd4100 -wd4189 -wd4132 -wd4152 -wd4702 -wd4057 -wd4296 -wd4389 -wd4018 -wd4245 \
3813	-wd4267 -wd4295
3814	VBOX_NEWER_VCC_NON_PEDANTIC = $(VBOX_VCC_NON_PEDANTIC)
3815
3816	ifeq ($(KBUILD_TARGET),win)
3817	VBOX_C_CXX_FLAGS_NO_UNUSED_PARAMETERS = -wd4100
3818	else
3819	VBOX_C_CXX_FLAGS_NO_UNUSED_PARAMETERS = -Wno-unused-parameter
3820	endif
3821
3822	#
3823	# Version dependent Visual C++ stuff.
3824	#
3825	if1of (win, $(KBUILD_TARGET) $(KBUILD_HOST))
3826	ifn1of ($(VBOX_VCC_TOOL_STEM), VCC100 VCC110 VCC120)
3827	ifndef VBOX_WITHOUT_CONTROL_FLOW_GUARD
3828	VBOX_VCC_CC_GUARD_CF = -guard:cf
3829	VBOX_VCC_LD_GUARD_CF = -Guard:CF
3830	else
3831	VBOX_VCC_CC_GUARD_CF =
3832	VBOX_VCC_LD_GUARD_CF =
3833	endif
3834	VBOX_VCC_LD_HIGH_ENTRYOPY_VA = /HighEntropyVA
3835	else
3836	VBOX_VCC_CC_GUARD_CF =
3837	VBOX_VCC_LD_GUARD_CF =
3838	VBOX_VCC_LD_HIGH_ENTRYOPY_VA =
3839	endif
3840	ifn1of ((VBOX_VCC_TOOL_STEM), VCC100 VCC110 VCC120 VCC140 VCC141)
3841	# 16.7 and later, so not in our linker yet.
3842	## @todo BUGBUG! Update VCC before 7.0 is released.
3843	#VBOX_VCC_LD_CET_COMPAT = /CetCompat
3844	VBOX_VCC_LD_CET_COMPAT =
3845	else
3846	VBOX_VCC_LD_CET_COMPAT =
3847	endif
3848	endif
3849
3850	#
3851	# Compiler optimization flags.
3852	#
3853	ifeq ($(KBUILD_TYPE),debug)
3854	VBOX_GCC_FP ?= -fno-omit-frame-pointer
3855	VBOX_GCC_OPT ?= -O0
3856	VBOX_VCC_FP ?= -Oy-
3857	VBOX_VCC_OPT ?=
3858	VBOX_GCC_R0_FP ?= -fno-omit-frame-pointer -fno-optimize-sibling-calls
3859	VBOX_GCC_R0_OPT ?= -O2
3860	VBOX_VCC_R0_FP ?= -Oy-
3861	VBOX_VCC_R0_OPT ?=
3862	VBOX_GCC_GC_FP ?= -fno-omit-frame-pointer -fno-optimize-sibling-calls
3863	VBOX_GCC_GC_OPT ?= -O2
3864	VBOX_VCC_GC_FP ?= -Oy-
3865	VBOX_VCC_GC_OPT ?=
3866	else
3867	# We should use -fomit-frame-pointer for GCC / -Oy for VCC.
3868	# -funwind-tables provides support for backtraces in gdb then.
3869	VBOX_GCC_FP ?= -fno-omit-frame-pointer
3870	VBOX_GCC_OPT ?= -O2 $(VBOX_GCC_mtune-generic)
3871	VBOX_VCC_FP ?= -Oy-
3872	VBOX_VCC_OPT ?= -O2
3873	VBOX_GCC_R0_FP ?= -fno-omit-frame-pointer
3874	VBOX_GCC_R0_OPT ?= -O2 $(VBOX_GCC_mtune-generic)
3875	VBOX_VCC_R0_FP ?= -Oy-
3876	VBOX_VCC_R0_OPT ?= -O2
3877	VBOX_GCC_GC_FP ?= -fno-omit-frame-pointer
3878	VBOX_GCC_GC_OPT ?= -O2 $(VBOX_GCC_mtune-generic)
3879	VBOX_VCC_GC_FP ?= -Oy-
3880	VBOX_VCC_GC_OPT ?= -O2
3881	endif
3882	ifeq ($(KBUILD_TARGET_ARCH),x86)
3883	ifneq ($(KBUILD_TARGET),darwin)
3884	# (The '<=' operator is for prepending (kmk specific).)
3885	VBOX_GCC_OPT <= -march=i586
3886	endif
3887	endif
3888
3889
3890	#
3891	# Select the CRT type we're using with Microsoft Visual C++.
3892	#
3893	if1of ($(KBUILD_TYPE), debug dbgopt strict)
3894	#not yet# VBOX_WITH_DEBUG_VCC_CRT = 1
3895	endif
3896	ifdef VBOX_WITH_DEBUG_VCC_CRT
3897	VBOX_VCC_CRT_TYPE := d
3898	VBOX_VCC_CRT_TYPE_UPPER := D
3899	VBOX_VCC_CRT_TYPE_N :=
3900	else
3901	VBOX_VCC_CRT_TYPE :=
3902	VBOX_VCC_CRT_TYPE_UPPER :=
3903	VBOX_VCC_CRT_TYPE_N := d
3904	endif
3905
3906	#
3907	# Select whether wchar_t is a native compiler defined type or not with
3908	# Microsoft Visual C++. We've been avoiding the native type for ever,
3909	# but now that is causing issues with Qt 6.x.
3910	#
3911	VBOX_VCC_WCHAR_T_VARIANT = -Zc:wchar_t
3912
3913
3914	#
3915	# Warnings as errors.
3916	#
3917	# GCC: We disable warnings on non-X86 systems because of the variadic
3918	# macro usage in the logger.
3919	#
3920	ifdef VBOX_WITH_WARNINGS_AS_ERRORS
3921	if $(VBOX_GCC_VERSION_CXX) >= 40000
3922	VBOX_GCC_WERR ?= -Werror
3923	endif
3924	VBOX_VCC_WERR ?= -WX
3925	VBOX_VCC_LD_WERR ?= ## @todo later also: -WX
3926	endif
3927
3928	#
3929	# The general GCC/Clang no warning policy.
3930	#
3931	# Note! This doesn't control everything. Instead set VBOX_GCC_WERR=$(NO_SUCH_VARIABLE) to
3932	# completely disable -Werror.
3933	#
3934	if !defined(VBOX_WITHOUT_NO_GCC_WARNING_POLICY) && !defined(VBOX_WITH_NO_GCC_WARNING_POLICY)
3935	if defined(VBOX_WITH_MASOCHISTIC_WARNINGS) # gcc 4.6.x+
3936	VBOX_WITH_NO_GCC_WARNING_POLICY = 1
3937	else if "$(KBUILD_TARGET)" == "darwin"
3938	ifn1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO)
3939	VBOX_WITH_NO_GCC_WARNING_POLICY = 1
3940	endif
3941	else if1of ($(KBUILD_TARGET), linux)
3942	if $(VBOX_GCC_VERSION_CXX) >= 40600 # gcc 4.6.x+
3943	VBOX_WITH_NO_GCC_WARNING_POLICY = 1
3944	endif
3945	endif
3946	endif
3947	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
3948	$(info build debug: VBOX_WITH_NO_GCC_WARNING_POLICY is enabled)
3949	endif
3950
3951	#
3952	# Misc stuff that should be after including DynamicConfig.kmk.
3953	#
3954
3955	# libxml XML linter.
3956	ifeq ($(VBOX_XMLLINT),)
3957	ifeq ($(KBUILD_HOST),win)
3958	VBOX_XMLLINT := $(firstfile \
3959	$(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS)/$(KBUILD_HOST).$(KBUILD_HOST_ARCH)/libxslt/*/bin/xmllint.exe)))
3960	endif
3961	ifeq ($(VBOX_XMLLINT),)
3962	VBOX_XMLLINT := $(which xmllint)
3963	endif
3964	ifneq ($(VBOX_XMLLINT),)
3965	VBOX_HAVE_XMLLINT := 1
3966	else
3967	VBOX_XMLLINT := xmllint
3968	VBOX_HAVE_XMLLINT :=
3969	endif
3970	else
3971	VBOX_HAVE_XMLLINT := 1
3972	endif
3973
3974	# Older versions of GCC cannot compile libssh, so disable it and the feature if that's the case.
3975	ifn1of ($(KBUILD_TARGET), darwin win)
3976	if $(VBOX_GCC_VERSION_CC) < 50000
3977	VBOX_WITH_LIBSSH :=
3978	VBOX_WITH_CLOUD_NET :=
3979	endif
3980	endif
3981
3982
3983	#
3984	# Misc macros.
3985	#
3986
3987	##
3988	# Edits VirtualBox version, vendor and package strings in a text file.
3989	#
3990	# The rule using this must list $(VBOX_SVN_REV_KMK) as a prerequisite.
3991	#
3992	# @param 1 The input filename.
3993	# @param 2 The output filename.
3994	#
3995	VBOX_EDIT_VERSION_CMD_FN = $(SED) \
3996	-e 's+@VBOX_VERSION_MAJOR@+$(VBOX_VERSION_MAJOR)+g' \
3997	-e 's+@VBOX_VERSION_MINOR@+$(VBOX_VERSION_MINOR)+g' \
3998	-e 's+@VBOX_VERSION_BUILD@+$(VBOX_VERSION_BUILD)+g' \
3999	-e 's+@VBOX_VERSION_STRING@+$(VBOX_VERSION_STRING)+g' \
4000	-e 's+@VBOX_SVN_REV@+$(VBOX_SVN_REV)+g' \
4001	-e 's+@VBOX_VENDOR@+$(VBOX_VENDOR)+g' \
4002	-e 's+@VBOX_VENDOR_SHORT@+$(VBOX_VENDOR_SHORT)+g' \
4003	-e 's+@VBOX_PRODUCT@+$(VBOX_PRODUCT)+g' \
4004	-e 's+@VBOX_C_YEAR@+$(VBOX_C_YEAR)+g' \
4005	-e 's+@VBOX_PACKAGE_STRING@+$(VBOX_PACKAGE_STRING)+g' \
4006	--output $(2) $(1)
4007
4008	##
4009	# Generates a rule for editing a file using VBOX_EDIT_VERSION_CMD_FN.
4010	#
4011	# @param 1 The target name.
4012	# @param 2 The input filename relative to the current sub-makefile.
4013	# @param 3 The output filename relative to the target output dir.
4014	# Optional, defaults to 2.
4015	#
4016	VBOX_EDIT_VERSION_RULE_FN = $(eval $(value VBOX_EDIT_VERSION_RULE_DEF))
4017	define VBOX_EDIT_VERSION_RULE_DEF
4018	$$($(1)_0_OUTDIR)/$(if $(3),$(3),$(2)): $(PATH_SUB_CURRENT)/$(2) $(VBOX_SVN_REV_KMK) \| $$(dir $$@)
4019	$(call MSG_GENERATE,$(1),$@,$<)
4020	$(QUIET)$(call VBOX_EDIT_VERSION_CMD_FN,$<,$@)
4021	$(eval $(1)_CLEAN += $$($(1)_0_OUTDIR)/$(if $(3),$(3),$(2)))
4022	endef
4023
4024
4025	##
4026	# Edits VirtualBox version, vendor, package, build target, build arch, and build type strings in a text file.
4027	#
4028	# Please use VBOX_EDIT_VERSION_AND_BUILD_RULE_FN to generate edit rule.
4029	#
4030	# @param 1 The input filename.
4031	# @param 2 The output filename.
4032	#
4033	VBOX_EDIT_VERSION_AND_BUILD_CMD_FN = $(SED) \
4034	-e 's+@VBOX_VERSION_MAJOR@+$(VBOX_VERSION_MAJOR)+g' \
4035	-e 's+@VBOX_VERSION_MINOR@+$(VBOX_VERSION_MINOR)+g' \
4036	-e 's+@VBOX_VERSION_BUILD@+$(VBOX_VERSION_BUILD)+g' \
4037	-e 's+@VBOX_VERSION_STRING@+$(VBOX_VERSION_STRING)+g' \
4038	-e 's+@VBOX_SVN_REV@+$(VBOX_SVN_REV)+g' \
4039	-e 's+@VBOX_VENDOR@+$(VBOX_VENDOR)+g' \
4040	-e 's+@VBOX_VENDOR_SHORT@+$(VBOX_VENDOR_SHORT)+g' \
4041	-e 's+@VBOX_PRODUCT@+$(VBOX_PRODUCT)+g' \
4042	-e 's+@VBOX_C_YEAR@+$(VBOX_C_YEAR)+g' \
4043	-e 's+@VBOX_PACKAGE_STRING@+$(VBOX_PACKAGE_STRING)+g' \
4044	-e 's+@KBUILD_TYPE@+$(KBUILD_TYPE)+g' \
4045	-e 's+@KBUILD_TARGET@+$(KBUILD_TARGET)+g' \
4046	-e 's+@KBUILD_TARGET_ARCH@+$(KBUILD_TARGET_ARCH)+g' \
4047	--output $(2) $(1)
4048
4049	##
4050	# Generates a rule for editing a file using VBOX_EDIT_VERSION_CMD_FN.
4051	#
4052	# @param 1 The target name.
4053	# @param 2 The input filename relative to the current sub-makefile.
4054	# @param 3 The output filename relative to the target output dir.
4055	# Optional, defaults to 2.
4056	#
4057	VBOX_EDIT_VERSION_AND_BUILD_RULE_FN = $(eval $(VBOX_EDIT_VERSION_AND_BUILD_RULE_DEF))
4058	define VBOX_EDIT_VERSION_AND_BUILD_RULE_DEF
4059	$$$$($(1)_0_OUTDIR)/$(if $(3),$(3),$(2)): $$(PATH_SUB_CURRENT)/$(2) $$(VBOX_SVN_REV_KMK) \| $$$$(dir $$$$@)
4060	$$(call MSG_GENERATE,$(1),$$@,$$<)
4061	$$(QUIET)$$(call VBOX_EDIT_VERSION_AND_BUILD_CMD_FN,$$<,$$@)
4062	$(1)_CLEAN += $$($(1)_0_OUTDIR)/$(if $(3),$(3),$(2))
4063	endef
4064
4065
4066	##
4067	# Fill in am import library target based on a somewhat special windows .def file.
4068	#
4069	# @param 1 The target name of the import library.
4070	# @param 2 The name of the real library.
4071	# @param 3 The .def-file paths relative to the current makefile.
4072	#
4073	VBOX_GENERATE_IMPORT_TARGET_FN = $(eval $(VBOX_GENERATE_IMPORT_TARGET_DEF))
4074	define VBOX_GENERATE_IMPORT_TARGET_DEF
4075	$(1)_TEMPLATE = VBoxR3Dll
4076	$(1)_INST = $(INST_LIB)
4077	if $(KBUILD_TARGET) == "darwin"
4078	$(1)_LDFLAGS = -install_name $(VBOX_DYLD_EXECUTABLE_PATH)/$(2)$(SUFF_DLL)
4079	else ifn1of ($(KBUILD_TARGET), os2 win)
4080	$(1)_SONAME = $(2)$(SUFF_DLL)
4081	endif
4082	if1of ($(KBUILD_TARGET), os2 win)
4083	$(1)_SOURCES = $$($(1)_0_OUTDIR)/$(1)Imp.def
4084	$(1)_CLEAN = $$($(1)_0_OUTDIR)/$(1)Imp.def
4085	else
4086	$(1)_SOURCES = $$($(1)_0_OUTDIR)/$(1)Imp.c
4087	$(1)_CLEAN = $$($(1)_0_OUTDIR)/$(1)Imp.c
4088	endif
4089
4090	$$$$($(1)_SOURCES): $(addprefix $(PATH_SUB_CURRENT)/,$(3)) $(PATH_ROOT)/src/bldprogs/deftoimp.sed \| $$$$(dir $$$$@)
4091	$$(call MSG_GENERATE,,$$@)
4092	ifeq ($(KBUILD_TARGET),os2)
4093	$$(SED) \
4094	-e '/not-$(KBUILD_TARGET)/d' \
4095	-e '/not-$(KBUILD_TARGET_ARCH)/d' \
4096	-e 's/^LIBRARY[[:space:]][[:space:]]$.$\.dll/LIBRARY \1 INITINSTANCE TERMINSTANCE\nDATA MULTIPLE\n/' \
4097	-e 's/^[ \t][ \t]*$[_a-zA-Z]$/ _\1/' \
4098	-e 's/[ \t]DATA[ \t]*/ /' \
4099	--output $$@ $(addprefix $(PATH_SUB_CURRENT)/,$(3))
4100	else ifeq ($(KBUILD_TARGET),win)
4101	$$(SED) \
4102	-e '/not-$(KBUILD_TARGET)/d' \
4103	-e '/not-$(KBUILD_TARGET_ARCH)/d' \
4104	--output $$@ $(addprefix $(PATH_SUB_CURRENT)/,$(3))
4105	else
4106	$$(QUIET)$$(APPEND) -tn $$@ \
4107	'#ifdef VBOX_HAVE_VISIBILITY_HIDDEN' \
4108	'# define EXPORT __attribute__((visibility("default")))' \
4109	'# define EXPORT_DATA __attribute__((visibility("default")))' \
4110	'#else' \
4111	'# define EXPORT' \
4112	'# define EXPORT_DATA' \
4113	'#endif' \
4114	''
4115	$$(SED) \
4116	-e '/not-$(KBUILD_TARGET)/d' \
4117	-e '/not-$(KBUILD_TARGET_ARCH)/d' \
4118	-f $(PATH_ROOT)/src/bldprogs/deftoimp.sed \
4119	--append $$@ $(addprefix $(PATH_SUB_CURRENT)/,$(3))
4120	endif
4121	endef # VBOX_GENERATE_IMPORT_TARGET_DEF
4122
4123
4124	## VBOX_UTF8_MANIFEST_CMDS
4125	# Wrapper around VBOX_UTF8_MANIFEST_FN that makes sure it's an EXE link target,
4126	# as this UTF-8 manifest doesn't make sense for non-executables.
4127	ifn1of ($(VBOX_VCC_TOOL_STEM), VCC100 VCC110 VCC120)
4128	## VBOX_UTF8_MANIFEST_FN
4129	# Adds a manifest resource with ID 1 that tells windows 10 1903 and later to
4130	# use UTF-8 for the ANSI and OEM code pages. We only do this when using UCRT
4131	# as the VCC100 CRT typically ends up with its internal code page not being
4132	# CP_UTF8 but the default codepage for the locale.
4133	#
4134	# This has also been hijacked for opting in on the new segmented heap in
4135	# Windows 10.
4136	#
4137	# @param 1 the output filename.
4138	# @param 2 the architecture (required for xp rtm)
4139	#
4140	VBOX_UTF8_MANIFEST_FN = \
4141	$(QUIET)$(APPEND) -tn "$(1).manifest" \
4142	'<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' \
4143	'<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">' \
4144	' <assemblyIdentity type="win32" name="$(notdir $(1))" processorArchitecture="$(2)" version="$(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD).$(expr $(VBOX_SVN_REV) % 50000)" />' \
4145	' <asmv3:application>' \
4146	' <asmv3:windowsSettings>' \
4147	' <activeCodePage xmlns="http://schemas.microsoft.com/SMI/2019/WindowsSettings">UTF-8</activeCodePage>' \
4148	' <heapType xmlns="http://schemas.microsoft.com/SMI/2020/WindowsSettings">SegmentHeap</heapType>' \
4149	' </asmv3:windowsSettings>' \
4150	' </asmv3:application>' \
4151	'</assembly>' \
4152	$(NLTAB)$(QUIET)$(REDIRECT) -- $(WINCMN_MT_RETRY) $(requote sh,$(PATH_SDK_$(VBOX_WINPSDK)_BIN)/mt.exe) \
4153	-nologo -manifest '$(subst /,\,$(1).manifest)' '-outputresource:$(subst /,\,$(1));$(HASH)1' \
4154	$(NLTAB)$(QUIET)$(RM) -f -- "$(1).manifest"
4155	VBOX_UTF8_MANIFEST_CMDS ?= $(if-expr "$(tool_do)" == "LINK_PROGRAM",$(call VBOX_UTF8_MANIFEST_FN,$(out),$(bld_trg_arch)),)
4156	else
4157	VBOX_UTF8_MANIFEST_CMDS =
4158	endif
4159
4160
4161	#
4162	# Code Signing.
4163	#
4164	# There are two signing modes; 'test' and 'release'.
4165	# - The 'test' mode is tailored local development, where typically test
4166	# certificates are involved. Only the bar minimum of files are signed and
4167	# nothing is timestamped (if we can control timestamping) in order to reduce
4168	# build time and to allow working offline.
4169	# - The 'release' mode is tailored for creating builds that are give to other
4170	# people, like the ones the build servers create. As much as possible is
4171	# signed and timestamped.
4172	# - The 'adhoc' mode is specific to building on macOS and is similar to 'test'
4173	# mode but doesn't require any certificates but a host set up for development work.
4174	# Binaries are signed in adhoc mode and include required entitlements as appropriate
4175	# (something we would only do in the 'packing' target). This seem to be the only working
4176	# way with newer versions of macOS (tested with Ventura) with 'test' not working anymore.
4177	#
4178	ifdef VBOX_SIGNING_MODE
4179	VBOX_SIGNING_MODE := $(strip $(VBOX_SIGNING_MODE))
4180	ifn1of ($(VBOX_SIGNING_MODE), test release adhoc)
4181	$(error VBOX_SIGNING_MODE must be either 'test', 'release' or 'adhoc'. The value '$(VBOX_SIGNING_MODE)' is not recognized.)
4182	endif
4183	if "$(VBOX_SIGNING_MODE)" == "adhoc" && "$(KBUILD_TARGET)" != "darwin"
4184	$(error 'adhoc' signing mode is only available on macOS)
4185	endif
4186	VBOX_RETRY ?= $(ASH) $(KBUILD_DEVTOOLS)/bin/retry.sh
4187	# temporary solution for a $(dir ...) equivalent which assumes that it gets a single path, possibly with spaces.
4188	VBOX_DIRX = $(subst ?,$(SP),$(dir $(subst $(SP),?,$1)))
4189	VBOX_NOTDIRX = $(subst ?,$(SP),$(notdir $(subst $(SP),?,$1)))
4190	# Corp code signing client.
4191	VBOX_CCS_CLIENT_JAR := $(firstword $(rsort \
4192	$(wildcard $(KBUILD_DEVTOOLS)/common/ccs/v*/Client.jar)) \
4193	$(KBUILD_DEVTOOLS)/common/ccs/notfound/Client.jar )
4194	VBOX_CCS_USER ?= virtualbox_grp
4195	VBOX_CCS_GLOBAL_UID ?= non-of-your-business
4196	VBOX_CCS_SERVER ?= UK
4197	##
4198	# Corp Code Signing command line.
4199	# @param $1 Signing method: solaris_elf, solaris_pkg, driver (microsoft), ...
4200	# @param $2 The file to be submitted for signing.
4201	# @param $3 The directory to put the signed file in. Defaults to $(dir $2).
4202	# @param $4 Additional options.
4203	VBOX_CCS_SIGN_CMD = $(VBOX_RETRY) $(VBOX_JAVA) -Xmx256m -jar "$(VBOX_CCS_CLIENT_JAR)" \
4204	sign -user "$(VBOX_CCS_USER)" -global_uid "$(VBOX_CCS_GLOBAL_UID)" \
4205	-job_timeout 90 -server_timeout 75 -server "$(VBOX_CCS_SERVER)" \
4206	-sign_method "$1" -file_to_sign "$2" -signed_location "$(if $3,$3,$(call VBOX_DIRX,$2))" $4
4207
4208	ifeq ($(KBUILD_HOST),win)
4209	#
4210	# Windows
4211	#
4212
4213	# VBOX_PATH_SELFSIGN points to the Vista WDK bin/SelfSign directory.
4214	ifndef VBOX_PATH_SELFSIGN
4215	VBOX_PATH_SELFSIGN := $(firstword $(rsort $(wildcard $(KBUILD_DEVTOOLS)/win.x86/selfsign/*)))
4216	ifeq ($(VBOX_PATH_SELFSIGN),)
4217	VBOX_PATH_SELFSIGN := $(KBUILD_DEVTOOLS)/win.x86/selfsign/r1
4218	endif
4219	endif
4220	ifndef VBOX_PATH_SIGN_TOOLS
4221	$(evalcall KB_FN_LOAD_SDK,$(VBOX_WINPSDK))
4222	VBOX_PATH_SIGN_TOOLS = $(PATH_SDK_$(VBOX_WINPSDK)_BIN)
4223	endif
4224
4225	VBOX_SIGNTOOL ?= $(VBOX_RETRY) $(requote sh,$(VBOX_PATH_SIGN_TOOLS)/signtool.exe)
4226	VBOX_SIGNTOOL_SHA1 ?= $(VBOX_SIGNTOOL)
4227	VBOX_SIGNTOOL_SHA1_ORDERDEPS ?=
4228	VBOX_SIGNTOOL_SHA2 ?= $(VBOX_SIGNTOOL)
4229	VBOX_SIGNTOOL_SHA2_ORDERDEPS ?=
4230	VBOX_SIGNTOOL_ORDERDEPS ?= $(VBOX_SIGNTOOL_SHA1_ORDERDEPS) $(VBOX_SIGNTOOL_SHA2_ORDERDEPS)
4231	ifndef VBOX_INF2CAT # Inf2Cat.exe is only found in the bin/*/x86 directory in WINSDK10. Arm64 requires a W10+ one.
4232	VBOX_INF2CAT = $(requote sh,$(firstfile $(qwildcard , $(qaddsuffix ,/[Ii][Nn][Ff]2[Cc][Aa][Tt].[Ee][Xx][Ee], \
4233	$(PATH_SDK_WINSDK10_BIN.x86) \
4234	$(PATH_SDK_WINSDK10_BIN) \
4235	$(if-expr defined(PATH_SDK_WINSDK10_BASE_BIN) && defined(SDK_WINSDK10_VERSION),$(PATH_SDK_WINSDK10_BASE_BIN)/$(SDK_WINSDK10_VERSION)/x86) \
4236	)) $(VBOX_PATH_SELFSIGN)/Inf2Cat.exe ))
4237	endif
4238
4239	ifeq ($(VBOX_SIGNING_MODE),test)
4240	VBOX_CERTIFICATE_SUBJECT_NAME ?= MyTestCertificate
4241	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_SUBJECT_NAME)"
4242	else # release
4243	VBOX_CERTIFICATE_SUBJECT_NAME ?= VirtualBox 2022
4244	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_SUBJECT_NAME)" /a
4245	#VBOX_CERTIFICATE_FINGERPRINT ?= 7e 92 b6 6b e5 1b 79 d8 ce 3f f2 5c 15 c2 df 6a b8 c7 f2 f2
4246	#VBOX_CERTIFICATE_FINGERPRINT ?= 5b de fe 58 0a 81 66 61 cd b5 7a 57 10 7b f4 18 74 86 ef cc
4247	#VBOX_CERTIFICATE_FINGERPRINT ?= 6f 47 42 06 bc bb 39 1b b8 2b a9 e5 dc 03 02 de f3 7a eb be
4248	VBOX_CERTIFICATE_FINGERPRINT ?= 5f 0b fe c5 53 17 c1 25 5a a4 7f cd bc 49 a2 fb 61 09 03 cc
4249	#VBOX_CROSS_CERTIFICATE_FILE ?= $(VBOX_PATH_SELFSIGN)/VeriSign Class 3 Public Primary Certification Authority - G5.cer
4250	#VBOX_CROSS_CERTIFICATE_FILE ?= $(VBOX_PATH_SELFSIGN)/DigiCert Assured ID Root CA.crt
4251	#VBOX_TSA_URL ?= http://timestamp.verisign.com/scripts/timstamp.dll - Appears to be broken between 2020-12-25 and 2020-12-30 (bugref:9849).
4252	VBOX_TSA_URL ?= http://timestamp.digicert.com
4253	endif
4254	if !defined(VBOX_CROSS_CERTIFICATE_FILE_ARGS) && defined(VBOX_CROSS_CERTIFICATE_FILE)
4255	VBOX_CROSS_CERTIFICATE_FILE_ARGS = /ac "$(VBOX_CROSS_CERTIFICATE_FILE)"
4256	endif
4257	if !defined(VBOX_TSA_URL_ARGS) && defined(VBOX_TSA_URL)
4258	VBOX_TSA_URL_ARGS = /t "$(VBOX_TSA_URL)"
4259	endif
4260	VBOX_CERTIFICATE_STORE ?= my
4261	VBOX_CERTIFICATE_STORE_ARGS ?= /s "$(VBOX_CERTIFICATE_STORE)"
4262	VBOX_CERTIFICATE_FINGERPRINT_ARGS := $(if-expr "$(VBOX_CERTIFICATE_FINGERPRINT)" != "" \
4263	,/sha1 "$(subst $(SP),,$(VBOX_CERTIFICATE_FINGERPRINT))",)
4264
4265	ifeq ($(VBOX_SIGNING_MODE),test)
4266	#VBOX_CERTIFICATE_SHA2_SUBJECT_NAME ?= MyTestCertificateSha2
4267	VBOX_CERTIFICATE_SHA2_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_SHA2_SUBJECT_NAME)"
4268	else # release
4269	VBOX_CERTIFICATE_SHA2_SUBJECT_NAME ?= Oracle Corporation
4270	VBOX_CERTIFICATE_SHA2_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_SHA2_SUBJECT_NAME)" /a
4271	#VBOX_CERTIFICATE_SHA2_FINGERPRINT ?= 31 31 bb 58 8b 19 9e 6e 85 0f d3 35 82 b0 c5 82 55 e1 6c 49
4272	#VBOX_CERTIFICATE_SHA2_FINGERPRINT ?= 22 05 6a 4d 46 2e 3d 2b b2 c3 2f bf b0 5b 84 c4 65 9c f7 fe
4273	#VBOX_CERTIFICATE_SHA2_FINGERPRINT ?= 17 3a 19 bf 8e 62 72 be 25 04 d3 08 aa 68 b1 b0 0e 03 33 2c
4274	VBOX_CERTIFICATE_SHA2_FINGERPRINT ?= 30 65 6f ca 8c 48 b1 d9 86 23 a9 4b 40 a6 bc 98 bd 87 bf ad
4275	VBOX_CROSS_CERTIFICATE_SHA2_FILE ?= $(VBOX_PATH_SELFSIGN)/DigiCert Assured ID Root CA.crt
4276	#VBOX_TSA_SHA2_URL ?= http://sha256timestamp.ws.symantec.com/sha256/timestamp - phase out for consistency reasons
4277	VBOX_TSA_SHA2_URL ?= http://timestamp.digicert.com
4278	endif
4279	if !defined(VBOX_CROSS_CERTIFICATE_SHA2_FILE_ARGS) && defined(VBOX_CROSS_CERTIFICATE_SHA2_FILE)
4280	VBOX_CROSS_CERTIFICATE_SHA2_FILE_ARGS = /ac "$(VBOX_CROSS_CERTIFICATE_SHA2_FILE)"
4281	endif
4282	if !defined(VBOX_TSA_SHA2_URL_ARGS) && defined(VBOX_TSA_SHA2_URL)
4283	VBOX_TSA_SHA2_URL_ARGS = /tr "$(VBOX_TSA_SHA2_URL)" /td SHA256
4284	endif
4285	VBOX_CERTIFICATE_SHA2_STORE ?= my
4286	VBOX_CERTIFICATE_SHA2_STORE_ARGS ?= /s "$(VBOX_CERTIFICATE_SHA2_STORE)"
4287	VBOX_CERTIFICATE_SHA2_FINGERPRINT_ARGS := $(if-expr "$(VBOX_CERTIFICATE_SHA2_FINGERPRINT)" != "" \
4288	,/sha1 "$(subst $(SP),,$(VBOX_CERTIFICATE_SHA2_FINGERPRINT))",) # Still using SHA-1 for fingerprinting, it's good enough for that!
4289	#VBOX_CERTIFICATE_EV_SUBJECT_NAME ?= MyEvCertificate
4290	VBOX_CERTIFICATE_EV_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_EV_SUBJECT_NAME)"
4291	VBOX_CERTIFICATE_EV_STORE ?= my
4292	VBOX_CERTIFICATE_EV_STORE_ARGS ?= /s "$(VBOX_CERTIFICATE_EV_STORE)"
4293	#VBOX_CERTIFICATE_EV_FINGERPRINT ?= my ev cert fingerprint
4294	VBOX_CERTIFICATE_EV_FINGERPRINT_ARGS := $(if-expr "$(VBOX_CERTIFICATE_EV_FINGERPRINT)" != "" \
4295	,/sha1 "$(subst $(SP),,$(VBOX_CERTIFICATE_EV_FINGERPRINT))",) # Still using SHA-1 for fingerprinting, it's good enough for that!
4296
4297	## Sign a file (generic).
4298	# @param 1 The file to sign.
4299	# @param 2 File description. Optional.
4300	# @param 3 Additional parameters. Optional.
4301	# @param 4 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4302	# @param 5 Disables dual signing if non-empty, picking the SHA2 signature (since 2022-07-18).
4303	# @param 6 non-zero for alternative command separator. This is used for generating repacking scripts.
4304	# @param 7 non-zero for timed execution if possible
4305	ifndef VBOX_SIGN_FILE_FN
4306	if $(intersects win all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4307	# CCS has lost the ability to do dual signing a while ago, can do SHA256 only
4308	VBOX_SIGN_FILE_FN = $(if $(strip $7),$(TIME) ,)$(call VBOX_CCS_SIGN_CMD,driver$(if-expr "$3" == "/ph",_pagehash,),$1,,-digest_algo SHA2)
4309	else ifdef VBOX_CERTIFICATE_SHA2_SUBJECT_NAME
4310	ifdef VBOX_CERTIFICATE_SUBJECT_NAME
4311	VBOX_SIGN_FILE_FN = $(if-expr "$5" == "",$(if $(strip $7),$(TIME) ,)$(VBOX_SIGNTOOL_SHA1) \
4312	sign /fd sha1 \
4313	$(VBOX_CROSS_CERTIFICATE_FILE_ARGS) \
4314	$(VBOX_CERTIFICATE_STORE_ARGS) \
4315	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4316	$(VBOX_CERTIFICATE_FINGERPRINT_ARGS) \
4317	$(VBOX_TSA_URL_ARGS) \
4318	$(if $(strip $(2)),/d "$(strip $(2))",) \
4319	$(3) \
4320	"$(1)" \
4321	$(if-expr "$6" == "",$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB)),$6))$(if $(strip $7),$(TIME) ,)$(VBOX_SIGNTOOL_SHA2) \
4322	sign $(if-expr "$5" == "",/as,) /fd sha256 \
4323	$(VBOX_CROSS_CERTIFICATE_SHA2_FILE_ARGS) \
4324	$(VBOX_CERTIFICATE_SHA2_STORE_ARGS) \
4325	$(VBOX_CERTIFICATE_SHA2_SUBJECT_NAME_ARGS) \
4326	$(VBOX_CERTIFICATE_SHA2_FINGERPRINT_ARGS) \
4327	$(VBOX_TSA_SHA2_URL_ARGS) \
4328	$(if $(strip $(2)),/d "$(strip $(2))",) \
4329	$(3) \
4330	"$(1)"
4331	else
4332	VBOX_SIGN_FILE_FN = $(if $(strip $7),$(TIME) ,)$(VBOX_SIGNTOOL_SHA2) \
4333	sign /fd sha256 \
4334	$(VBOX_CROSS_CERTIFICATE_SHA2_FILE_ARGS) \
4335	$(VBOX_CERTIFICATE_SHA2_STORE_ARGS) \
4336	$(VBOX_CERTIFICATE_SHA2_SUBJECT_NAME_ARGS) \
4337	$(VBOX_CERTIFICATE_SHA2_FINGERPRINT_ARGS) \
4338	$(VBOX_TSA_SHA2_URL_ARGS) \
4339	$(if $(strip $(2)),/d "$(strip $(2))",) \
4340	$(3) \
4341	"$(1)"
4342	endif
4343	else
4344	VBOX_SIGN_FILE_FN = $(if $(strip $7),$(TIME) ,)$(VBOX_SIGNTOOL) \
4345	sign /fd $(firstword $(VBOX_TEST_SIGN_ALGORITHM) sha256) \
4346	$(VBOX_CROSS_CERTIFICATE_FILE_ARGS) \
4347	$(VBOX_CERTIFICATE_STORE_ARGS) \
4348	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4349	$(VBOX_CERTIFICATE_FINGERPRINT_ARGS) \
4350	$(VBOX_TSA_URL_ARGS) \
4351	$(if $(strip $(2)),/d "$(strip $(2))",) \
4352	$(3) \
4353	"$(1)"
4354	endif
4355	endif
4356
4357	## EV sign a file (generic).
4358	# @param 1 The file to sign.
4359	# @param 2 The directory to put the signed file in. Defaults to $(dir $1).
4360	ifndef VBOX_SIGN_EV_FILE_FN
4361	if $(intersects win_ev all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4362	VBOX_SIGN_EV_FILE_FN = $(call VBOX_CCS_SIGN_CMD,microsoftev,$1,$(if $2,$2,))
4363	else ifdef VBOX_CERTIFICATE_EV_SUBJECT_NAME
4364	VBOX_SIGN_EV_FILE_FN = $(VBOX_SIGNTOOL_SHA2) \
4365	sign /fd sha256 \
4366	$(VBOX_CERTIFICATE_EV_STORE_ARGS) \
4367	$(VBOX_CERTIFICATE_EV_SUBJECT_NAME_ARGS) \
4368	$(VBOX_CERTIFICATE_EV_FINGERPRINT_ARGS) \
4369	$(VBOX_TSA_SHA2_URL_ARGS) \
4370	"$(1)"
4371	endif
4372	endif
4373
4374	## Local SHA-1 and SHA-256 signatures with EV SHA-256 signature from corp code signing.
4375	#
4376	# This builds on Plan B, since the corp code signing always replaces existing
4377	# signatures. Since we're signing more, though, we do things slightly differently
4378	# so we can apply this to VBOX_RTSIGNTOOL as well - only that didn't work because
4379	# kmk tries to help windows caching images it executes. So HACK ALERT on that.
4380	#
4381	# So, here is what we do.
4382	# 1. Sign $1 using the regular signing, probably dual signing it using local certs.
4383	# 2. Make temporary copy of $1 as $1.dual
4384	# 3. Do SHA-256 corp code signing of $1
4385	# 4. Add the SHA-256 signature from $1 to $1.dual using bldRTSignTool.
4386	# 5. Replace $1 with $1.dual.
4387	#
4388	# @param 1 The file to sign.
4389	# @param 2 File description. Optional.
4390	# @param 3 Additional parameters. Optional.
4391	# @param 4 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4392	# @param 5 Disables dual & tripple signing if non-empty.
4393	# @param 6 Disables triple signing if non-empty.
4394	#
4395	# @remarks The parameters are the same as VBOX_SIGN_FILE_FN.
4396	VBOX_SIGN_IMAGE_WITH_EV_FN = $(call VBOX_SIGN_FILE_FN,$1,$2,$3,$4,$5)$(if-expr "$5" == "" && "$(target)" != "bldRTSignTool", \
4397	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(RM) -f -- "$1.dual" \
4398	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(CP) -- "$1" "$1.dual" \
4399	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(call VBOX_CCS_SIGN_CMD,microsoftev,$1,,-digest_algo SHA2) \
4400	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(VBOX_RTSIGNTOOL) add-nested-$(if-expr "$(suffix $1)" == ".cat",cat,exe)-signature -v "$1.dual" "$1" \
4401	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(MV) -f -- "$1.dual" "$1" \
4402	,)
4403
4404
4405	## Corp code signing for drivers and catalogs, plan B.
4406	#
4407	# Since the corp code signing cannot dual signing and doesn't even have a
4408	# SHA-1 cert, we have to get creative:
4409	# 1. Sign $1 using local SHA-1 certificate.
4410	# 2. Make temporary copy of $1 as $1.dual
4411	# 3. Do SHA-256 corp code signing of $1
4412	# 4. Add the SHA-256 signature from $1 to $1.dual using bldRTSignTool.
4413	# 5. Move $1.dual to $1.
4414	#
4415	# @param 1 The file to sign.
4416	# @param 2 File description. Optional.
4417	# @param 3 Additional parameters. Optional.
4418	# @param 4 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4419	# @param 5 Disables dual signing if non-empty.
4420	#
4421	# @remarks The parameters are the same as VBOX_SIGN_FILE_FN.
4422	VBOX_SIGN_IMAGE_PLAN_B_FN = $(VBOX_SIGNTOOL_SHA1) \
4423	sign /fd sha1 \
4424	$(VBOX_CROSS_CERTIFICATE_FILE_ARGS) \
4425	$(VBOX_CERTIFICATE_STORE_ARGS) \
4426	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4427	$(VBOX_CERTIFICATE_FINGERPRINT_ARGS) \
4428	$(VBOX_TSA_URL_ARGS) \
4429	$(if $(strip $(2)),/d "$(strip $(2))",) \
4430	$(3) \
4431	"$(1)" \
4432	$(if-expr "$5" == "", \
4433	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(RM) -f -- "$1.dual" \
4434	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(CP) -- "$1" "$1.dual" \
4435	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(call VBOX_CCS_SIGN_CMD,driver$(if-expr "$3" == "/ph",_pagehash,),$1,,-digest_algo SHA2) \
4436	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(VBOX_RTSIGNTOOL) add-nested-$(if-expr "$(suffix $1)" == ".cat",cat,exe)-signature -v "$1.dual" "$1" \
4437	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(MV) -f -- "$1.dual" "$1" \
4438	,)
4439
4440	## Corp code signing for drivers and catalogs, plan C.
4441	#
4442	# This does a local SHA-1 signature before submitting to corp code signing. The end
4443	# result will have just a SHA-256 signature:
4444	# 1. Sign $1 using local SHA-1 certificate.
4445	# 2. Do SHA-256 corp code signing of $1
4446	#
4447	# @param 1 The file to sign.
4448	# @param 2 File description. Optional.
4449	# @param 3 Additional parameters. Optional.
4450	# @param 4 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4451	# @param 5 Disables dual signing if non-empty. Ignored because this can't do dual signing.
4452	# @remarks The parameters are the same as VBOX_SIGN_FILE_FN.
4453	VBOX_SIGN_IMAGE_PLAN_C_FN = $(VBOX_SIGNTOOL_SHA1) \
4454	sign /fd sha1 \
4455	$(VBOX_CROSS_CERTIFICATE_FILE_ARGS) \
4456	$(VBOX_CERTIFICATE_STORE_ARGS) \
4457	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4458	$(VBOX_CERTIFICATE_FINGERPRINT_ARGS) \
4459	$(VBOX_TSA_URL_ARGS) \
4460	$(if $(strip $(2)),/d "$(strip $(2))",) \
4461	$(3) \
4462	"$(1)" \
4463	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(call VBOX_CCS_SIGN_CMD,driver$(if-expr "$3" == "/ph",_pagehash,),$1,,-digest_algo SHA2)
4464
4465	## Sign an executable image, normal method.
4466	# @param 1 The file to sign.
4467	# @param 2 File description. Optional.
4468	# @param 3 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4469	if1of (win_with_ev, $(VBOX_WITH_CORP_CODE_SIGNING))
4470	VBOX_SIGN_IMAGE_NORMAL_FN ?= $(call VBOX_SIGN_IMAGE_WITH_EV_FN,$(1),$(2),/ph,$(3))
4471	VBOX_SIGN_IMAGE_NORMAL_ORDERDEPS ?= $(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS)
4472	else
4473	VBOX_SIGN_IMAGE_NORMAL_FN ?= $(call VBOX_SIGN_FILE_FN,$(1),$(2),/ph,$(3))
4474	VBOX_SIGN_IMAGE_NORMAL_ORDERDEPS ?= $(VBOX_SIGNTOOL_ORDERDEPS)
4475	endif
4476
4477	## Commands for signing a driver image after link.
4478	if $(intersects win_planb,$(VBOX_WITH_CORP_CODE_SIGNING))
4479	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_PLAN_B_FN,$(out),,/ph,2))
4480	VBOX_SIGN_DRIVER_ORDERDEPS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS))
4481	else if $(intersects win_planc,$(VBOX_WITH_CORP_CODE_SIGNING))
4482	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_NORMAL_FN,$(out),,2,nodual))
4483	VBOX_SIGN_DRIVER_ORDERDEPS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS))
4484	else
4485	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_NORMAL_FN,$(out),,2))
4486	VBOX_SIGN_DRIVER_ORDERDEPS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_SIGN_IMAGE_NORMAL_ORDERDEPS))
4487	endif
4488
4489	## Create a security catalog file.
4490	# @param 1 The directory containing the stuff to sign.
4491	# @param 2 The expected .cat name. (Inf2Cat lowercases it)
4492	# @param 3 The list of OSes, separated by ';'.
4493	ifndef VBOX_MAKE_CAT_HLP_FN
4494	VBOX_MAKE_CAT_HLP_FN = \
4495	$(RM) -f -- "$(2)" \
4496	$(NL)$(TAB)$(VBOX_INF2CAT) "/driver:$(strip $(1))" "/os:$(strip $(subst ;,$(COMMA),$(3)))" /verbose \
4497	$(NL)$(TAB)$(MV) -- "$(2)" "$(2)"
4498	if $(intersects win_planb,$(VBOX_WITH_CORP_CODE_SIGNING))
4499	VBOX_MAKE_CAT_HLP_FN += $(NL)$(TAB)$(call VBOX_SIGN_IMAGE_PLAN_B_FN,$(2),,,$(NL)$(TAB))
4500	else
4501	VBOX_MAKE_CAT_HLP_FN += $(NL)$(TAB)$(call VBOX_SIGN_FILE_FN,$(2),,,$(NL)$(TAB))
4502	endif
4503	endif
4504	VBOX_MAKE_CAT_FN.amd64 ?= $(call VBOX_MAKE_CAT_HLP_FN,$(1),$(2),XP_X64;Server2003_X64;Vista_X64)
4505	VBOX_MAKE_CAT_FN.x86 ?= $(call VBOX_MAKE_CAT_HLP_FN,$(1),$(2),2000;XP_X86;Server2003_X86;Vista_X86)
4506	VBOX_MAKE_CAT_FN.arm64 ?= $(call VBOX_MAKE_CAT_HLP_FN,$(1),$(2),10_19H1_ARM64;ServerRS5_ARM64;10_CO_ARM64;Server10_ARM64;10_RS3_ARM64)
4507	VBOX_MAKE_CAT_FN = $(VBOX_MAKE_CAT_FN.$(KBUILD_TARGET_ARCH))
4508
4509	## Functions + deps for signing an executable or a dll image. See VBOX_SIGN_IMAGE_NORMAL_FN for parameters.
4510	if defined(VBOX_CERTIFICATE_SUBJECT_NAME) && $(intersects win_planb,$(VBOX_WITH_CORP_CODE_SIGNING))
4511	VBOX_SIGN_IMAGE_FN ?= $(call VBOX_SIGN_IMAGE_PLAN_B_FN,$(1),$(2),/ph,$(3))
4512	VBOX_SIGN_IMAGE_ORDERDEPS ?= $(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS)
4513	else if defined(VBOX_CERTIFICATE_SUBJECT_NAME) && $(intersects win_planc,$(VBOX_WITH_CORP_CODE_SIGNING))
4514	VBOX_SIGN_IMAGE_FN ?= $(call VBOX_SIGN_IMAGE_PLAN_C_FN,$(1),$(2),/ph,$(3))
4515	VBOX_SIGN_IMAGE_ORDERDEPS ?= $(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS)
4516	else
4517	VBOX_SIGN_IMAGE_FN ?= $(call VBOX_SIGN_IMAGE_NORMAL_FN,$(1),$(2),$(3))
4518	VBOX_SIGN_IMAGE_ORDERDEPS ?= $(VBOX_SIGN_IMAGE_NORMAL_ORDERDEPS)
4519	endif
4520
4521	# Go nuts, sign everything.
4522	if "$(VBOX_SIGNING_MODE)" == "release" \|\| defined(VBOX_WITH_HARDENING)
4523	## Commands for signing an executable or a dll image after link.
4524	if defined(VBOX_CERTIFICATE_SUBJECT_NAME) && $(intersects win_planb,$(VBOX_WITH_CORP_CODE_SIGNING))
4525	VBOX_SIGN_IMAGE_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_PLAN_B_FN,$(out),,/ph,2))
4526	VBOX_SIGN_IMAGE_CMDS_ORDERDEPS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS))
4527	else if defined(VBOX_CERTIFICATE_SUBJECT_NAME) && $(intersects win_planc,$(VBOX_WITH_CORP_CODE_SIGNING))
4528	VBOX_SIGN_IMAGE_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_PLAN_C_FN,$(out),,/ph,2))
4529	VBOX_SIGN_IMAGE_CMDS_ORDERDEPS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS))
4530	else
4531	VBOX_SIGN_IMAGE_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_NORMAL_FN,$(out),,2))
4532	VBOX_SIGN_IMAGE_CMDS_ORDERDEPS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_SIGN_IMAGE_NORMAL_ORDERDEPS))
4533	endif
4534	endif
4535	## Enable signing of the additions drivers, i.e. create CAT files.
4536	## @todo r=bird: This bugger is entirely misplaced, as it belongs in the additions config section so it can be properly overriden.
4537	VBOX_SIGN_ADDITIONS ?= 1
4538	## Set if we should include the legacy timestamp CA.
4539	ifndef VBOX_WITH_VBOX_LEGACY_TS_CA
4540	if "$(findstring 805af82410a4827b71f59479a222670391bec2d5,$(VBOX_TSA_URL_ARGS))" != ""
4541	VBOX_WITH_VBOX_LEGACY_TS_CA = 1
4542	endif
4543	endif
4544
4545	else ifeq ($(KBUILD_HOST),darwin)
4546
4547	## Sign a VM process binary with the given entitlements
4548	# @param 1 The file to sign.
4549	# @param 2 Identifier, optional.
4550	ifeq ($(VBOX_SIGNING_MODE),adhoc)
4551	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4552	## @todo cannot handle $(2), the identifier.
4553	VBOX_SIGN_IMAGE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB) \
4554	$(call VBOX_CCS_SIGN_CMD,binary,$(1),,$(subst --entitlements=,-entitlement_file_path ,$(3)) \
4555	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),-hardened_runtime))
4556	else
4557	VBOX_SIGN_IMAGE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(VBOX_CODESIGN) \
4558	--verbose=9 \
4559	--force \
4560	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4561	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 16,--options 0x10000,--options runtime)) \
4562	--file-list - \
4563	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4564	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4565	--entitlements="$(VBOX_DARWIN_ENTITLEMENTS_FILE_VM)" \
4566	"$(1)" \
4567	$(if $(2),--identifier "$(2)",)
4568	endif
4569	else
4570	VBOX_SIGN_IMAGE_FN =
4571	endif
4572
4573	#
4574	# Darwin code signing.
4575	#
4576	# Currently release signing is done when packing. This may change later.
4577	# (Installer package signing is done elsewhere (VBOX_MACOSX_INSTALLER_SIGN).)
4578	#
4579	if defined(VBOX_CERTIFICATE_FINGERPRINT) && !defined(VBOX_CERTIFICATE_SUBJECT_NAME)
4580	VBOX_CERTIFICATE_SUBJECT_NAME = $(subst $(SP),,$(VBOX_CERTIFICATE_FINGERPRINT))
4581	endif
4582	ifeq ($(VBOX_SIGNING_MODE),test)
4583	VBOX_CERTIFICATE_SUBJECT_NAME ?= $(error You need to set VBOX_CERTIFICATE_SUBJECT_NAME in LocalConfig.kmk.)
4584	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= --sign "$(VBOX_CERTIFICATE_SUBJECT_NAME)"
4585	VBOX_TSA_URL ?= none
4586	else ifeq ($(VBOX_SIGNING_MODE),adhoc)
4587	ifdef VBOX_CERTIFICATE_SUBJECT_NAME
4588	$(error VBOX_CERTIFICATE_SUBJECT_NAME must not be set in 'adhoc' signing mode)
4589	endif
4590	VBOX_CERTIFICATE_SUBJECT_NAME = -
4591	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= --sign "$(VBOX_CERTIFICATE_SUBJECT_NAME)"
4592	VBOX_TSA_URL ?= none
4593	VBOX_SIGN_IMAGE_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_FN,$(out),,2))
4594	else
4595	VBOX_CERTIFICATE_SUBJECT_NAME ?= Developer ID Application: Oracle America, Inc.
4596	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= --sign "$(VBOX_CERTIFICATE_SUBJECT_NAME)"
4597	endif
4598
4599	VBOX_CODESIGN ?= codesign
4600	if 0
4601	VBOX_DARWIN_KEXT_SIGN_FILES = CodeDirectory CodeRequirement CodeResources CodeSignature
4602	else
4603	VBOX_DARWIN_KEXT_SIGN_FILES = CodeResources
4604	endif
4605
4606	# Always enable the hardened runtime when signing. Can be disabled if
4607	# trying to build on quite old macOS, which will likely need some effort.
4608	VBOX_WITH_MACOS_HARDENED_RUNTIME ?= 1
4609
4610	##
4611	# Corp Code Notarization command line. Modifies the file because the tickets are stapled.
4612	# @param 1 The file to be submitted for signing.
4613	# @param 2 Identifier, mandatory.
4614	# @param 3 The directory to put the notarized file in. Defaults to $(dir $1).
4615	VBOX_CCS_NOTARIZE_CMD = $(VBOX_RETRY) $(VBOX_JAVA) -jar "$(VBOX_CCS_CLIENT_JAR)" \
4616	mac_notarize -user "$(VBOX_CCS_USER)" -global_uid "$(VBOX_CCS_GLOBAL_UID)" \
4617	-job_timeout 90 -server_timeout 75 -server "$(VBOX_CCS_SERVER)" \
4618	-file_to_notarize "$1" -bundle_id "$2" -download_location "$(if $3,$3,$(call VBOX_DIRX,$1))"
4619
4620	## Sign an application bundle, framework or kernel extension.
4621	# @param 1 The bundle to sign.
4622	# @param 2 Identifier, optional.
4623	# @param 3 Additional codesign command line parameters, optional.
4624	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4625	## @todo cannot handle $(2), the identifier.
4626	## @todo $(3) is hopefully either empty, --deep or --entitlements=...
4627	VBOX_SIGN_BUNDLE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB) \
4628	ditto -c -k --keepParent "$(1)" "$(1).zip"$(NLTAB) \
4629	$(call VBOX_CCS_SIGN_CMD,apple,$(1).zip,,$(subst --entitlements=,-entitlement_file_path ,$(subst --deep,-deep,$(3))) \
4630	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),-hardened_runtime))$(NLTAB) \
4631	ditto -x -k "$(1).zip" "$(1)/../"$(NLTAB) \
4632	$(RM) -f -- "$(1).zip"
4633	else
4634	VBOX_SIGN_BUNDLE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(VBOX_CODESIGN) \
4635	--verbose=9 \
4636	--force \
4637	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4638	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 16,--options 0x10000,--options runtime)) \
4639	--file-list - \
4640	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4641	$(3) \
4642	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4643	"$(1)" $(if $(2),--identifier "$(2)",)
4644	endif
4645
4646	## Sign a Mach-O image.
4647	# @param 1 The file to sign.
4648	# @param 2 Identifier, optional.
4649	# @param 3 Additional codesign command line parameters, optional.
4650	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4651	## @todo cannot handle $(2), the identifier.
4652	## @todo $(3) is hopefully either empty or --entitlements=...
4653	VBOX_SIGN_MACHO_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB) \
4654	$(call VBOX_CCS_SIGN_CMD,binary,$(1),,$(subst --entitlements=,-entitlement_file_path ,$(3)) \
4655	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),-hardened_runtime))
4656	else
4657	VBOX_SIGN_MACHO_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(VBOX_CODESIGN) \
4658	--verbose=9 \
4659	--force \
4660	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4661	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 16,--options 0x10000,--options runtime)) \
4662	--file-list - \
4663	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4664	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4665	$(3) \
4666	"$(1)" \
4667	$(if $(2),--identifier "$(2)",)
4668	endif
4669
4670	## Commands for signing an extpack dylib file after link.
4671	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4672	VBOX_SIGN_EXTPACK_DYLIB_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),, \
4673	$(call VBOX_CCS_SIGN_CMD,binary,$(out),, \
4674	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),-hardened_runtime)) )
4675	else
4676	VBOX_SIGN_EXTPACK_DYLIB_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),, \
4677	$(VBOX_CODESIGN) \
4678	--verbose=9 \
4679	--force \
4680	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4681	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 16,--options 0x10000,--options runtime)) \
4682	--file-list - \
4683	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4684	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4685	$(out) )
4686	endif
4687
4688	## Sign a VMM Mach-O image.
4689	# @param 1 The file to sign.
4690	# @param 2 Identifier, optional.
4691	VBOX_SIGN_VMM_MOD_FN = $(VBOX_SIGN_MACHO_FN)
4692
4693	## Sign a non-executable file.
4694	# @param 1 The file to sign.
4695	# @param 2 Identifier, optional.
4696	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4697	## @todo cannot handle $(2), the identifier.
4698	VBOX_SIGN_FILE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB) \
4699	$(call VBOX_CCS_SIGN_CMD,mac_dmg,$(1))$(NLTAB) \
4700	$(REDIRECT) -E 'LC_ALL=C' -we "$(1).tmp" -- ditto -x -k -V "$(1).zip" "$(call VBOX_DIRX,$(1))"$(NLTAB) \
4701	dirname="$(call VBOX_DIRX,$(1))$(DOLLAR)($(SED) -n -e 's+^copying file $[0-9]\{1,\}$/.\{1,\}$(DOLLAR)+\1+p' "$(1).tmp")" ; \
4702	$(MV) -f -- "$(DOLLAR)dirname/$(DOLLAR)(basename "$(1)")" "$(call VBOX_DIRX,$(1))" ; \
4703	$(RM) -Rf -- "$(DOLLAR)dirname/"$(NLTAB) \
4704	$(RM) -f -- "$(1).zip" "$(1).tmp"
4705	else
4706	VBOX_SIGN_FILE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(VBOX_CODESIGN) \
4707	--verbose=9 \
4708	--force \
4709	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4710	--file-list=- \
4711	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4712	$(if $(2),--identifier "$(2)",) \
4713	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4714	"$(1)"
4715	endif
4716
4717	## Sign a DMG image.
4718	# @param 1 The file to sign.
4719	# @param 2 Identifier, optional.
4720	# @note Will segfault if --file-list is used on 10.15.2 (kSecCodeInfoChangedFiles -> NULL, outputter doesn't check for NULL).
4721	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4722	VBOX_SIGN_DMG_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(call VBOX_CCS_SIGN_CMD,binary,$(1))
4723	else
4724	VBOX_SIGN_DMG_FN = $(filter-out --file-list=-,$(VBOX_SIGN_FILE_FN))
4725	endif
4726
4727	## Sign a PKG file. Used with corp code signing only.
4728	# @param 1 The file to sign.
4729	# @param 2 Identifier, optional.
4730	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4731	## @todo cannot handle $(2), the identifier.
4732	VBOX_SIGN_PKG_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(call VBOX_CCS_SIGN_CMD,mac_pkg,$(1))
4733	endif
4734
4735	## Notarize a file (usually DMG, can also be PKG). Used with corp code signing only.
4736	# @param 1 The file to notarize.
4737	# @param 2 Identifier, mandatory.
4738	# @param 3 The directory to put the notarized file in. Defaults to $(dir $1).
4739	if $(intersects darwin darwin_notarize all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4740	VBOX_NOTARIZE_FILE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(call VBOX_CCS_NOTARIZE_CMD,$(1),$(2),$(3))
4741	endif
4742
4743	## @def VBOX_TEST_SIGN_KEXT
4744	# Adds test signing to a $1.kext target (the plist installer target).
4745	#
4746	# After both targets has been defined:
4747	# $(evalcall2 VBOX_TEST_SIGN_KEXT,VBoxDrv)
4748	#
4749	# @param 1 The kext name. Assumes there is a SYSMODS target of name $1
4750	# as well as an .plist installer by the name of '$1.kext'.
4751	# @remarks Currently assumes only binary + Info.plist in the bundle, no
4752	# other files. Should there be more, add them as a list in
4753	# a 2nd parameter.
4754	# @note This is only for the 'test' signing mode, we skip this in
4755	# 'release' signing mode as to not waste time on the build boxes.
4756	ifeq ($(VBOX_SIGNING_MODE),test) ## @todo when kBuild is updated to r2742+, this should be enabled for both modes.
4757	define VBOX_TEST_SIGN_KEXT
4758	$1_INSTTYPE.darwin = none
4759
4760	$1.kext_SOURCES += $$($1.kext_0_OUTDIR)/Contents/MacOS/$1=>MacOS/$1 \
4761	$(foreach extfile, $(VBOX_DARWIN_KEXT_SIGN_FILES) \
4762	, $$($1.kext_0_OUTDIR)/Contents/_CodeSignature/$(extfile)=>_CodeSignature/$(extfile))
4763	$1.kext_SYMLINKS += $(foreach symfile, $(VBOX_DARWIN_KEXT_SIGN_SYMLINKS), $(symfile)=>_CodeSignature/$(symfile))
4764	$1.kext_CLEAN += \
4765	$(foreach extfile, $(VBOX_DARWIN_KEXT_SIGN_FILES) , $$($1.kext_0_OUTDIR)/Contents/_CodeSignature/$(extfile)) \
4766	$(foreach symfile, $(VBOX_DARWIN_KEXT_SIGN_SYMLINKS), $$($1.kext_0_OUTDIR)/Contents/$(symfile)) \
4767	$$($1.kext_0_OUTDIR)/Contents/MacOS/$1 \
4768	$$($1.kext_0_OUTDIR)/$1.kext/Contents/_CodeSignature/
4769	$1.kext_BLDDIRS += $$($1.kext_0_OUTDIR)/Contents/MacOS/
4770
4771	$$$$($1.kext_0_OUTDIR)/Contents/MacOS/$1 \
4772	+ $(foreach file,$(VBOX_DARWIN_KEXT_SIGN_FILES), $$$$($1.kext_0_OUTDIR)/Contents/_CodeSignature/$(file)): \
4773	$$$$($1.kext_0_OUTDIR)/Contents/Info.plist $$$$($1_1_TARGET) \| $$$$($1.kext_0_OUTDIR)/
4774	$(RM) -Rf -- "$$($1.kext_0_OUTDIR)/Contents/_CodeSignature/" "$$($1.kext_0_OUTDIR)/Contents/MacOS/"
4775	$(MKDIR) -p -- "$$($1.kext_0_OUTDIR)/Contents/MacOS/"
4776	$(INSTALL) -m 644 $$($1_1_TARGET) $$($1.kext_0_OUTDIR)/Contents/MacOS/$1
4777	$(call VBOX_SIGN_BUNDLE_FN,$$($1.kext_0_OUTDIR),org.virtualbox.app.kext.$1,)
4778	endef
4779	else
4780	VBOX_TEST_SIGN_KEXT =
4781	endif
4782
4783
4784	else ifeq ($(KBUILD_HOST),solaris)
4785	#
4786	# Solaris code signing.
4787	#
4788	ifeq ($(VBOX_SIGNING_MODE),test)
4789	VBOX_CERTIFICATE_FILE ?= $(error You need to set VBOX_CERTIFICATE_FILE in LocalConfig.kmk.)
4790	VBOX_TOKEN_NAME ?= $(error You need to set VBOX_TOKEN_NAME in LocalConfig.kmk.)
4791	VBOX_PIN_FILE ?= $(error You need to set VBOX_PIN_FILE in LocalConfig.kmk.)
4792	else
4793	VBOX_CERTIFICATE_FILE ?= $(PATH_ROOT)/oracle.pem
4794	VBOX_TOKEN_NAME ?= "Sun Software PKCS\#11 softtoken"
4795	VBOX_PIN_FILE ?= $(PATH_ROOT)/oracle.pin
4796	endif
4797	VBOX_CERTIFICATE_FILE_ARGS ?= -c $(VBOX_CERTIFICATE_FILE)
4798	VBOX_TOKEN_NAME_ARGS ?= -T $(VBOX_TOKEN_NAME)
4799	VBOX_PIN_ARGS ?= -P $(VBOX_PIN_FILE)
4800
4801	VBOX_ELFSIGN ?= elfsign
4802
4803	# Sign an ELF image.
4804	# @param 1 The elf object file to sign.
4805	VBOX_SIGN_ELF_FN ?= $(VBOX_ELFSIGN) \
4806	sign \
4807	$(VBOX_CERTIFICATE_FILE_ARGS) \
4808	$(VBOX_TOKEN_NAME_ARGS) \
4809	$(VBOX_PIN_ARGS) \
4810	-e "$(1)"
4811
4812	## Commands for signing a driver image after link.
4813	if $(intersects solaris all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4814	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_CCS_SIGN_CMD,solaris_elf,$(out)))
4815	else
4816	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_ELF_FN,$(out)))
4817	endif
4818
4819	else
4820	# Not Windows, Mac OS X or Solaris build host, ignore.
4821	VBOX_SIGNING_MODE :=
4822	endif
4823
4824	#
4825	# Complain if windows hardening is enabled but not code signing.
4826	#
4827	else if "$(KBUILD_TARGET)" == "win" && defined(VBOX_WITH_HARDENING) && !defined(VBOX_ONLY_BUILD)
4828	$(error You need to enable code signing for a hardened windows build to work.)
4829	endif
4830
4831	#
4832	# Windows .inf editing.
4833	#
4834	VBOX_EDIT_INF_FN = $(VBOX_EDIT_INF_FN.$(KBUILD_TARGET_ARCH))
4835	## Edit an inf file a x86 target.
4836	# @param 1 The inf file to edit.
4837	# @param 2 The output file.
4838	VBOX_EDIT_INF_FN.x86 = $(SED) $(if $(VBOX_SIGNING_MODE),-e 's/^;cat *//', -e '/^;cat /d') \
4839	-e 's/^;x86 *//' \
4840	-e '/^;amd64 /d' \
4841	-e '/^;arm64 /d' \
4842	-e 's/@DOT-NT-ARCH@/.NTx86/g' \
4843	-e 's/@COMMA-NT-ARCH@/,NTx86/g' \
4844	-e 's/^;edit-DriverVer.*/DriverVer = $(date-utc %m\/%d\/%Y),$(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD).$(expr $(VBOX_SVN_REV) % 50000) ; r$(VBOX_SVN_REV)/' \
4845	--output $(2) \
4846	$(1)
4847	## Edit an inf file an amd64 target.
4848	# @param 1 The inf file to edit.
4849	# @param 2 The output file.
4850	VBOX_EDIT_INF_FN.amd64 = $(SED) \
4851	$(if $(VBOX_SIGNING_MODE),-e 's/^;cat *//', -e '/^;cat /d') \
4852	-e 's/^;amd64 *//' \
4853	-e '/^;x86 /d' \
4854	-e '/^;arm64 /d' \
4855	-e 's/@DOT-NT-ARCH@/.NTAMD64/g' \
4856	-e 's/@COMMA-NT-ARCH@/,NTAMD64/g' \
4857	-e 's/^;edit-DriverVer.*/DriverVer = $(date-utc %m\/%d\/%Y),$(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD).$(expr $(VBOX_SVN_REV) % 50000) ; r$(VBOX_SVN_REV)/' \
4858	--output $(2) \
4859	$(1)
4860	## Edit an inf file for an arm64 target.
4861	# @param 1 The inf file to edit.
4862	# @param 2 The output file.
4863	VBOX_EDIT_INF_FN.arm64 = $(SED) \
4864	$(if $(VBOX_SIGNING_MODE),-e 's/^;cat *//', -e '/^;cat /d') \
4865	-e 's/^;arm64 *//' \
4866	-e '/^;x86 /d' \
4867	-e '/^;amd64 /d' \
4868	-e 's/@DOT-NT-ARCH@/.NTARM64/g' \
4869	-e 's/@COMMA-NT-ARCH@/,NTARM64/g' \
4870	-e 's/^;edit-DriverVer.*/DriverVer = $(date-utc %m\/%d\/%Y),$(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD).$(expr $(VBOX_SVN_REV) % 50000) ; r$(VBOX_SVN_REV)/' \
4871	--output $(2) \
4872	$(1)
4873
4874	## @def VBOX_RE_SIGN_DLL_FN
4875	# Helper macro for re-signing DLL images from tools that we ship so they won't
4876	# cause trouble for the hardened build requirements.
4877	#
4878	# Invoke via $(call VBOX_RE_SIGN_DLL_FN) inside the SOURCES list. Necessary
4879	# _CLEAN entry will be added to the target. If hardening is not enabled or
4880	# we're not on windows, the source will be returned.
4881	#
4882	# @returns Name of the output file name. May have leading space, but no trailing.
4883	# @param 1 Target name.
4884	# @param 2 The source name.
4885	# @param 3 Optional prefix to avoid name collisions.
4886	#
4887	if defined(VBOX_SIGNING_MODE) && "$(KBUILD_TARGET)" == "win"
4888	if1of (quote, $(KMK_FEATURES))
4889	VBOX_RE_SIGN_DLL_FN = $(if-expr !defined($(1)_VBOX_RE_SIGNED_$(3)$(qnotdir ,$(2))), \
4890	$(evalcall VBOX_RE_SIGN_DLL_INTERNAL_FN,$1,$2,$3) \
4891	,)$($(1)_0_OUTDIR)/$(3)$(qnotdir ,$2)
4892
4893	define VBOX_RE_SIGN_DLL_INTERNAL_FN
4894	local n = $(3)$(qnotdir ,$2)
4895	ifndef $(1)_VBOX_RE_SIGNED_$(n)
4896	$(1)_VBOX_RE_SIGNED_$(n) := 1
4897	$(eval $(1)_CLEAN += $$($(1)_0_OUTDIR)/$(n))
4898
4899	$$($(1)_0_OUTDIR)/$(n): $(2) $(VBOX_VERSION_STAMP) \| $$(dir $$@) $(VBOX_SIGN_IMAGE_ORDERDEPS)
4900	$(call MSG_TOOL,SIGNTOOL,,$<,$@)
4901	$(RM) -f -- "$@"
4902	$(CP) -- "$(quote-sh-dq $<)" "$@"
4903	$(CHMOD) a+rw -- "$@"
4904	$(VBOX_VCC_EDITBIN) /LargeAddressAware /DynamicBase /NxCompat /Release \
4905	$(if-expr !defined(VBOX_WITHOUT_WINDOWS_KERNEL_CODE_SIGNING_CERT),/IntegrityCheck,) \
4906	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
4907	"$@"
4908	$(call VBOX_SIGN_IMAGE_FN,$@)
4909	endif
4910	endef # VBOX_RE_SIGN_DLL_INTERNAL_FN
4911
4912	else # old kmk: no quote feature
4913	VBOX_RE_SIGN_DLL_FN = $(if-expr !defined($(1)_VBOX_RE_SIGNED_$(3)$(notdir $(2))), \
4914	$(evalcall VBOX_RE_SIGN_DLL_INTERNAL_FN,$1,$2,$3) \
4915	,)$($(1)_0_OUTDIR)/$(3)$(notdir $2)
4916	define VBOX_RE_SIGN_DLL_INTERNAL_FN
4917	local n = $(3)$(notdir $2)
4918	ifndef $(1)_VBOX_RE_SIGNED_$(n)
4919	$(1)_VBOX_RE_SIGNED_$(n) := 1
4920	$(eval $(1)_CLEAN += $$($(1)_0_OUTDIR)/$(n))
4921
4922	$$($(1)_0_OUTDIR)/$(n): $(2) $(VBOX_VERSION_STAMP) \| $$(dir $$@) $(VBOX_SIGN_IMAGE_ORDERDEPS)
4923	$(call MSG_TOOL,SIGNTOOL,,$<,$@)
4924	$(RM) -f -- "$@"
4925	$(CP) -- "$<" "$@"
4926	$(CHMOD) a+rw -- "$@"
4927	$(VBOX_VCC_EDITBIN) /LargeAddressAware /DynamicBase /NxCompat /Release \
4928	$(if-expr !defined(VBOX_WITHOUT_WINDOWS_KERNEL_CODE_SIGNING_CERT),/IntegrityCheck,) \
4929	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
4930	"$@"
4931	$(call VBOX_SIGN_IMAGE_FN,$@)
4932	endif
4933	endef # VBOX_RE_SIGN_DLL_INTERNAL_FN
4934	endif # old kmk: no quote feature
4935	else
4936	VBOX_RE_SIGN_DLL_FN = $(2)
4937	endif
4938
4939
4940	#
4941	# File version info and description macros (ignored on most OSes).
4942	#
4943
4944	##
4945	# Internal macro.
4946	#
4947	# @param 1 The target name.
4948	# @param 2 The description
4949	# @param 3 Optional icon file.
4950	# @param 4 The template base name.
4951	# @param 5 Additional RC options.
4952	# @param 6 Original filename to use.
4953	#
4954	# @remarks ASSUMES RCFLAGS isn't a simple variable (var := value).
4955	define VBOX_SET_VER_INFO_INTERNAL
4956	ifeq ($(KBUILD_TARGET),win)
4957	$(1)_SOURCES.win += $(PATH_ROOT)/src/VBox/Artwork/win/$(4)
4958	$(1)_RCFLAGS += /nologo /dIN_INTERNAL_NAME="\"$(1)\"" /dIN_FILE_DESCRIPTION="\"$(2)\"" \
4959	/dIN_ORIGINAL_NAME="\"$(if $(6),$6,$$(notdir $$($(1)_1_INST_TARGET)))\"" \
4960	$(if $(3), /dIN_ICON_FILE="\"$(subst \\,/,$(strip $(3)))\"") $(5)
4961	$$$$($(1)_0_OUTDIR)/src/VBox/Artwork/win/$(basename $(4)).res: \
4962	$(PATH_ROOT)/include/VBox/version.h $$$$(VBOX_VERSION_HEADER)
4963	endif
4964	endef
4965
4966	##
4967	# Macro for setting DLL/SO/DYLIB version information and description.
4968	#
4969	# The macro must be invoked using evalcall2 after the whole target has
4970	# been declared.
4971	#
4972	# @param 1 The target name.
4973	# @param 2 The description
4974	# @param 3 Optional icon file.
4975	VBOX_SET_VER_INFO_DLL = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateDll.rc,)
4976
4977	##
4978	# Macro for setting EXE version information and description.
4979	#
4980	# The macro must be invoked using call after the whole target has been declared.
4981	#
4982	# @param 1 The target name.
4983	# @param 2 The description
4984	# @param 3 Optional icon file.
4985	# @param 4 Optional OriginalFilename value to use. Defaults to target name w/o dir.
4986	VBOX_SET_VER_INFO_EXE = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateExe.rc,,$4)
4987
4988	##
4989	# Macro for setting driver version information and description.
4990	#
4991	# The macro must be invoked using call after the whole target has been declared.
4992	#
4993	# @param 1 The target name.
4994	# @param 2 The description
4995	# @param 3 Optional icon file.
4996	# @param 4 Optional VFT2_DRV_xxx define for windows. Uses VFT2_UNKNOWN by default.
4997	VBOX_SET_VER_INFO_DRV = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateDrv.rc,$(if $(4), /dIN_FILE_SUBTYPE=$(4)))
4998
4999	##
5000	# Macro for setting the version information and description for a ring-0 module.
5001	#
5002	# The macro must be invoked using call after the whole target has been declared.
5003	#
5004	# @param 1 The target name.
5005	# @param 2 The description
5006	# @param 3 Optional icon file.
5007	VBOX_SET_VER_INFO_R0 = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateR0.rc,)
5008
5009	##
5010	# Macro for setting the version information and description for a raw-mode context module.
5011	#
5012	# The macro must be invoked using call after the whole target has been declared.
5013	#
5014	# @param 1 The target name.
5015	# @param 2 The description
5016	# @param 3 Optional icon file.
5017	VBOX_SET_VER_INFO_RC = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateRc.rc,)
5018
5019
5020
5021	#
5022	# Adjust kBuild defaults.
5023	#
5024	kBuildGlobalDefaults_DEBUG_NOSTAGE.win = true
5025	kBuildGlobalDefaults_DEBUG_NOSTAGE.os2 = true
5026	if1of ($(KBUILD_TARGET), darwin win)
5027	kBuildGlobalDefaults_LD_DEBUG = split
5028	endif
5029
5030
5031	#
5032	# Haiku resource and version generation.
5033	#
5034	ifeq ($(KBUILD_HOST),haiku)
5035	VBOX_HAIKU_RCTOOL := rc
5036	VBOX_HAIKU_XRESTOOL := xres
5037	VBOX_HAIKU_SETVERSIONTOOL := setversion
5038	# XXX: install won't preserve attributes...
5039	VBOX_HAIKU_MIMESETTOOL := mimeset
5040
5041	## Add optional resources to the program, set its version info, and sniff its mime properties.
5042	# @param 1 The file to add resources to.
5043	# @param 2 The resource files.
5044	# @param 3 The target name.
5045	define VBOX_HAIKU_XRES_SETVER_FN
5046	$(if $(2),$(call MSG_TOOL,HaikuAddResources,$(3),$(2))
5047	$(QUIET)$(VBOX_HAIKU_XRESTOOL) -o $(1) $(2),)
5048	$(call MSG_TOOL,HaikuSetVersion,$(3))
5049	$(QUIET)$(VBOX_HAIKU_SETVERSIONTOOL) $(1) \
5050	-app $(VBOX_VERSION_MAJOR) $(VBOX_VERSION_MINOR) $(VBOX_VERSION_BUILD) d $(VBOX_SVN_REV) \
5051	-short "$(VBOX_PRODUCT)" \
5052	-long "$(VBOX_PRODUCT) $(VBOX_VERSION_STRING) $(shell /bin/echo -e '\xC2\xA9')2009-$(VBOX_C_YEAR) $(VBOX_VENDOR)"
5053	$(call MSG_TOOL,HaikuMimeSet,$(3))
5054	$(QUIET)$(VBOX_HAIKU_MIMESETTOOL) -f $(1)
5055	endef
5056
5057	VBOX_HAIKU_XRES_SETVER_CMDS ?= $(if $(eq $(tool_do),LINK_PROGRAM),$(call VBOX_HAIKU_XRES_SETVER_FN,$(out),$($(target)_RSRCS),$(target)),)
5058	endif
5059
5060	#
5061	# Default prefixes and suffixes.
5062	#
5063	VBOX_PREF_LIB =
5064	if1of ($(KBUILD_TARGET), os2 win)
5065	VBOX_SUFF_LIB = .lib
5066	else
5067	VBOX_SUFF_LIB = .a
5068	endif
5069	if1of ($(KBUILD_HOST), os2 win)
5070	VBOX_HOSTSUFF_LIB = .lib
5071	else
5072	VBOX_HOSTSUFF_LIB = .a
5073	endif
5074	VBOX_SUFF_DLL = $(SUFF_DLL)
5075	ifeq ($(KBUILD_TARGET),os2) # GXX3OMF produces out .o at the moment.
5076	VBOX_SUFF_OBJ = .o
5077	else
5078	VBOX_SUFF_OBJ = $(SUFF_OBJ)
5079	endif
5080	VBOXW32GUEST_SUFF_LIB = .lib
5081	VBOXLNX32GUEST_SUFF_LIB = .a
5082
5083	#
5084	# SDKs for external libraries.
5085	#
5086	ifdef VBOX_WITH_DXVK
5087	SDK_VBoxDxVk := Direct3D 9/10/11 to Vulkan - for dll linking.
5088	SDK_VBoxDxVk_DEFAULT_INCS := \
5089	$(PATH_ROOT)/src/libs/dxvk-2.3.1/include/native/directx \
5090	$(PATH_ROOT)/src/libs/dxvk-2.3.1/include/native/windows
5091	SDK_VBoxDxVk_INCS ?= $(SDK_VBoxDxVk_DEFAULT_INCS)
5092	# Loaded dynamically
5093	SDK_VBoxDxVk_LIBS ?=
5094	endif
5095
5096	ifdef VBOX_WITH_LIBCURL
5097	SDK_VBoxLibCurl := libcurl for dll linking.
5098	SDK_VBoxLibCurl_INCS ?= $(PATH_ROOT)/src/libs/curl-8.7.1/include
5099	SDK_VBoxLibCurl_LIBS ?= $(PATH_STAGE_LIB)/VBox-libcurl$(VBOX_SUFF_LIB)
5100	SDK_VBoxLibCurl_DEFS ?= BUILDING_LIBCURL
5101
5102	SDK_VBoxLibCurl-x86 = libcurl/x86 for dll linking.
5103	SDK_VBoxLibCurl-x86_INCS ?= $(PATH_ROOT)/src/libs/curl-8.7.1/include
5104	SDK_VBoxLibCurl-x86_LIBS.x86 ?= $(PATH_STAGE_LIB)/VBox-libcurl-x86$(VBOX_SUFF_LIB)
5105	SDK_VBoxLibCurl-x86_DEFS ?= BUILDING_LIBCURL
5106	endif
5107
5108	SDK_VBoxLibPng := protable network graphics (png) library for dll linking.
5109	SDK_VBoxLibPng_INCS ?= $(PATH_ROOT)/src/libs/libpng-1.6.43
5110	SDK_VBoxLibPng_LIBS ?= $(PATH_STAGE_LIB)/VBox-libpng$(VBOX_SUFF_LIB)
5111
5112	# lzf
5113	SDK_VBoxLzf := lzf compressor/decompressor for dll linking.
5114	SDK_VBoxLzf_INCS ?= $(PATH_ROOT)/src/libs/liblzf-3.6
5115	SDK_VBoxLzf_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzf$(VBOX_SUFF_LIB)
5116
5117	SDK_VBoxLzf-x86 := lzf/x86 compressor/decompressor for dll linking.
5118	SDK_VBoxLzf-x86_EXTENDS := VBoxLzf
5119	SDK_VBoxLzf-x86_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzf-x86$(VBOX_SUFF_LIB)
5120
5121	SDK_VBoxLzfStatic := lzf compressor/decompressor for static linking.
5122	SDK_VBoxLzfStatic_EXTENDS := VBoxLzf
5123	if1of ($(KBUILD_TARGET), os2 win)
5124	SDK_VBoxLzfStatic_LIBS := $(PATH_STAGE_LIB)/VBox-liblzf-static$(VBOX_SUFF_LIB)
5125	endif
5126
5127	# openssl
5128	SDK_VBoxOpenSslStatic := OpenSSL - Only for VBoxRT and/or statically linked programs.
5129	SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS := $(PATH_OUT)/obj/crypto-3.1.7-headers/include
5130	SDK_VBoxOpenSslStatic_INCS ?= $(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)
5131	SDK_VBoxOpenSslStatic_ORDERDEPS ?= $(crypto-headers_1_TARGET)
5132	if !defined(VBOX_ONLY_SDK) \
5133	&& (!defined(VBOX_ONLY_ADDITIONS) \|\| !defined(VBOX_ONLY_ADDITIONS_WITHOUT_RTISOMAKER)) \
5134	&& (!defined(VBOX_ONLY_EXTPACKS) \|\| !defined(VBOX_ONLY_EXTPACKS_USE_IMPLIBS)) \
5135	&& ("$(SDK_VBoxOpenSslStatic_INCS)" == "$(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)")
5136	SDK_VBoxOpenSslStatic_DEPS ?= $(SDK_VBoxOpenSslStatic_INCS)/openssl/openssl-mangling.h
5137	endif
5138	SDK_VBoxOpenSslStatic_LIBS ?= \
5139	$(PATH_STAGE_LIB)/VBox-libssl$(VBOX_SUFF_LIB) \
5140	$(PATH_STAGE_LIB)/VBox-libcrypto$(VBOX_SUFF_LIB)
5141
5142	SDK_VBoxOpenSslStatic-x86 := OpenSSL/x86 - Only for VBoxRT and/or statically linked programs.
5143	SDK_VBoxOpenSslStatic-x86_VBOX_DEFAULT_INCS := $(PATH_OUT)/obj/crypto-3.1.7-headers/include
5144	SDK_VBoxOpenSslStatic-x86_INCS ?= $(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)
5145	SDK_VBoxOpenSslStatic-x86_ORDERDEPS ?= $(crypto-headers_1_TARGET)
5146	if ("$(SDK_VBoxOpenSslStatic_INCS)" == "$(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)")
5147	SDK_VBoxOpenSslStatic-x86_DEPS ?= $(SDK_VBoxOpenSslStatic_INCS)/openssl/openssl-mangling.h
5148	endif
5149	SDK_VBoxOpenSslStatic-x86_LIBS ?= \
5150	$(PATH_STAGE_LIB)/VBox-libssl-x86$(VBOX_SUFF_LIB) \
5151	$(PATH_STAGE_LIB)/VBox-libcrypto-x86$(VBOX_SUFF_LIB)
5152
5153	ifdef VBOX_WITH_BLD_RTSIGNTOOL_SIGNING
5154	SDK_VBoxOpenSslBldProg := OpenSSL - Build tools verison (i.e. bldRTSignTool)
5155	SDK_VBoxOpenSslBldProg_INCS ?= $(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)
5156	SDK_VBoxOpenSslBldProg_ORDERDEPS ?= $(crypto-headers_1_TARGET)
5157	if !defined(VBOX_ONLY_SDK) \
5158	&& ("$(SDK_VBoxOpenSslStatic_INCS)" == "$(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)")
5159	SDK_VBoxOpenSslBldProg_DEPS ?= $(SDK_VBoxOpenSslStatic_INCS)/openssl/openssl-mangling.h
5160	endif
5161	SDK_VBoxOpenSslBldProg_LIBS ?= \
5162	$(PATH_STAGE_LIB)/VBoxBldProg-libssl$(VBOX_SUFF_LIB) \
5163	$(PATH_STAGE_LIB)/VBoxBldProg-libcrypto$(VBOX_SUFF_LIB)
5164	endif
5165
5166	SDK_VBoxOpenSsl := This is what you should be using! It links against VBoxRT.
5167	SDK_VBoxOpenSsl_EXTENDS := VBoxOpenSslStatic
5168	if "$(SDK_VBoxOpenSslStatic_INCS)" == "$(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)"
5169	SDK_VBoxOpenSsl_LIBS = $(NO_SUCH_VARIABLE)
5170	endif
5171
5172	ifdef VBOX_WITH_LIBOGG
5173	SDK_VBoxLibOgg := libogg for dll linking.
5174	SDK_VBoxLibOgg_DEFAULT_INCS := $(PATH_ROOT)/src/libs/libogg-1.3.5/include
5175	SDK_VBoxLibOgg_INCS ?= $(SDK_VBoxLibOgg_DEFAULT_INCS)
5176	SDK_VBoxLibOgg_LIBS ?= $(PATH_STAGE_LIB)/VBox-libogg$(VBOX_SUFF_LIB)
5177	endif
5178
5179	ifdef VBOX_WITH_LIBVORBIS
5180	SDK_VBoxLibVorbis := libvorbis for dll linking.
5181	SDK_VBoxLibVorbis_DEFAULT_INCS := $(PATH_ROOT)/src/libs/libvorbis-1.3.7/include
5182	SDK_VBoxLibVorbis_INCS ?= $(SDK_VBoxLibVorbis_DEFAULT_INCS)
5183	SDK_VBoxLibVorbis_LIBS ?= $(PATH_STAGE_LIB)/VBox-libvorbis$(VBOX_SUFF_LIB)
5184	endif
5185
5186	# Our SoftFloat 3e variant.
5187	SDK_VBoxSoftFloatR3Shared := SoftFloat 3 for dll linking.
5188	SDK_VBoxSoftFloatR3Shared_DEFS := SOFTFLOAT_FAST_INT64
5189	SDK_VBoxSoftFloatR3Shared_DEFS.amd64 := LITTLEENDIAN
5190	SDK_VBoxSoftFloatR3Shared_DEFS.arm64 := LITTLEENDIAN
5191	SDK_VBoxSoftFloatR3Shared_DEFS.x86 := LITTLEENDIAN
5192	if1of ($(KBUILD_TARGET), win)
5193	SDK_VBoxSoftFloatR3Shared_DEFS += THREAD_LOCAL=__declspec(thread)
5194	else
5195	SDK_VBoxSoftFloatR3Shared_DEFS += THREAD_LOCAL=__thread
5196	endif
5197	SDK_VBoxSoftFloatR3Shared_INCS = \
5198	$(PATH_ROOT)/src/libs/softfloat-3e/source/include
5199	SDK_VBoxSoftFloatR3Shared_LIBS = \
5200	$(PATH_STAGE_LIB)/VBox-SoftFloat$(VBOX_SUFF_LIB)
5201
5202	SDK_VBoxSoftFloatR0 := SoftFloat 3 for ring-0 linking.
5203	SDK_VBoxSoftFloatR0_DEFS := SOFTFLOAT_FAST_INT64
5204	SDK_VBoxSoftFloatR0_DEFS.amd64 := LITTLEENDIAN
5205	SDK_VBoxSoftFloatR0_DEFS.arm64 := LITTLEENDIAN
5206	SDK_VBoxSoftFloatR0_DEFS.x86 := LITTLEENDIAN
5207	SDK_VBoxSoftFloatR0_INCS = \
5208	$(PATH_ROOT)/src/libs/softfloat-3e/source/include
5209	SDK_VBoxSoftFloatR0_LIBS = \
5210	$(PATH_STAGE_LIB)/VBox-SoftFloatR0$(VBOX_SUFF_LIB)
5211
5212	SDK_VBoxSoftFloatGuestR3Shared := SoftFloat 3 for ring-0 linking.
5213	SDK_VBoxSoftFloatGuestR3Shared_DEFS := SOFTFLOAT_FAST_INT64
5214	SDK_VBoxSoftFloatGuestR3Shared_DEFS.amd64 := LITTLEENDIAN
5215	SDK_VBoxSoftFloatGuestR3Shared_DEFS.arm64 := LITTLEENDIAN
5216	SDK_VBoxSoftFloatGuestR3Shared_DEFS.x86 := LITTLEENDIAN
5217	SDK_VBoxSoftFloatGuestR3Shared_INCS = \
5218	$(PATH_ROOT)/src/libs/softfloat-3e/source/include
5219	SDK_VBoxSoftFloatGuestR3Shared_LIBS.x86 = \
5220	$(VBOX_PATH_ADDITIONS_LIB)/VBox-SoftFloatGuestR3Shared-x86$(VBOX_SUFF_LIB)
5221	SDK_VBoxSoftFloatGuestR3Shared_LIBS.$(KBUILD_TARGET_ARCH) = \
5222	$(VBOX_PATH_ADDITIONS_LIB)/VBox-SoftFloatGuestR3Shared$(VBOX_SUFF_LIB)
5223
5224	ifdef VBOX_WITH_LIBSSH
5225	SDK_VBoxLibSsh := libssh for dynamic dll loading with assembly stubs.
5226	SDK_VBoxLibSsh_INCS ?= $(PATH_ROOT)/src/libs/libssh-0.10.6/include
5227	# SDK_VBoxLibSsh_LIBS is not defined, as VBoxLibSsh dll is not linked, but loaded explicitly
5228	# by auto-generated stub code (lazy loading)
5229	endif
5230
5231	ifdef VBOX_WITH_LIBTPMS
5232	SDK_VBoxLibTpms := libtpms for dll linking.
5233	SDK_VBoxLibTpms_DEFAULT_INCS := $(PATH_ROOT)/src/libs/libtpms-0.9.6/include
5234	SDK_VBoxLibTpms_INCS ?= $(SDK_VBoxLibTpms_DEFAULT_INCS)
5235	SDK_VBoxLibTpms_LIBS ?= $(PATH_STAGE_LIB)/VBox-libtpms$(VBOX_SUFF_LIB)
5236	endif
5237
5238	ifdef VBOX_WITH_LIBVPX
5239	SDK_VBoxLibVpx := libvpx for dll linking.
5240	SDK_VBoxLibVpx_DEFAULT_INCS := $(PATH_ROOT)/src/libs/libvpx-1.14.1
5241	SDK_VBoxLibVpx_INCS ?= $(SDK_VBoxLibVpx_DEFAULT_INCS)
5242	SDK_VBoxLibVpx_LIBS ?= $(PATH_STAGE_LIB)/VBox-libvpx$(VBOX_SUFF_LIB)
5243	endif
5244
5245	ifdef VBOX_WITH_LIBLZMA
5246	SDK_VBoxLibLzma := liblzma for dll linking.
5247	SDK_VBoxLibLzma_DEFAULT_INCS := $(PATH_ROOT)/src/libs/liblzma-5.4.1/api
5248	SDK_VBoxLibLzma_INCS ?= $(SDK_VBoxLibLzma_DEFAULT_INCS)
5249	SDK_VBoxLibLzma_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzma$(VBOX_SUFF_LIB)
5250
5251	SDK_VBoxLibLzma-x86 := liblzma/x86 compressor/decompressor for dll linking.
5252	SDK_VBoxLibLzma-x86_EXTENDS := VBoxLibLzma
5253	SDK_VBoxLibLzma-x86_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzma-x86$(VBOX_SUFF_LIB)
5254
5255	SDK_VBoxLibLzmaStatic := liblzma for static linking
5256	SDK_VBoxLibLzmaStatic_EXTENDS := VBoxLibLzma
5257	SDK_VBoxLibLzmaStatic_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzma-static$(VBOX_SUFF_LIB)
5258	endif
5259
5260	# libxml2
5261	SDK_VBoxLibXml2 := libxml2 for dll linking.
5262	SDK_VBoxLibXml2_INCS ?= $(PATH_ROOT)/src/libs/libxml2-2.13.2/include
5263	SDK_VBoxLibXml2_DEFS ?= _REENTRANT LIBXML_STATIC LIBXML_STATIC_FOR_DLL
5264	SDK_VBoxLibXml2_DEFS.win ?= WIN32 _WINDOWS _MBCS HAVE_WIN32_THREADS HAVE_COMPILER_TLS
5265	# Note: no linking to LIB here, we do that explicitly in src/VBox/Runtime/Makefile.kmk to link
5266	# libxml against VBoxRT
5267
5268	# zlib
5269	SDK_VBoxZlib := zlib for dll linking.
5270	if1of ($(KBUILD_TARGET), os2 solaris win)
5271	SDK_VBoxZlib_INCS ?= $(PATH_ROOT)/src/libs/zlib-1.2.13
5272	SDK_VBoxZlib_LATE_LIBS ?= $(PATH_STAGE_LIB)/VBox-zlib$(VBOX_SUFF_LIB)
5273	else
5274	SDK_VBoxZlib_INCS ?=
5275	SDK_VBoxZlib_LATE_LIBS ?= z
5276	SDK_VBoxZlib_DEFS.linux ?= _LARGEFILE64_SOURCE
5277	endif
5278
5279	SDK_VBoxZlib-x86 := zlib/x86
5280	SDK_VBoxZlib-x86_EXTENDS = VBoxZlib
5281	if1of ($(KBUILD_TARGET), os2 solaris win)
5282	SDK_VBoxZlib-x86_LIBS ?= $(PATH_STAGE_LIB)/VBox-zlib-x86$(VBOX_SUFF_LIB)
5283	endif
5284
5285	SDK_VBoxZlibStatic := zlib for static linking
5286	SDK_VBoxZlibStatic_EXTENDS := VBoxZlib
5287	if1of ($(KBUILD_TARGET), os2 win) # Not required on solaris.
5288	SDK_VBoxZlibStatic_LATE_LIBS ?= $(PATH_STAGE_LIB)/VBox-zlib-static$(VBOX_SUFF_LIB)
5289	endif
5290
5291	#
5292	# Special SDK for the problematic NTDLL.LIB.
5293	#
5294	SDK_VBoxNtDll := Mini NTDLL import library, required by IPRT.
5295	SDK_VBoxNtDll_LIBS.x86 ?= $(PATH_STAGE_LIB)/RuntimeR3NtDll-x86.lib
5296	SDK_VBoxNtDll_LIBS.amd64 ?= $(PATH_STAGE_LIB)/RuntimeR3NtDll-amd64.lib
5297	SDK_VBoxNtDll_LIBS.arm64 ?= $(PATH_STAGE_LIB)/RuntimeR3NtDll-arm64.lib
5298
5299	#
5300	# SDK for including newdev.lib.
5301	# It conceptually moved from the WDK to the PSDK with W10, as it's now in the um subdir.
5302	#
5303	SDK_VBoxWinNewDevLib := Abstracts where to find newdev.lib.
5304	ifn1of ($(VBOX_WINPSDK), WINPSDK71 WINPSDK80)
5305	SDK_VBoxWinNewDevLib_LIBS.x86 = $(PATH_SDK_$(VBOX_WINPSDK)_LIB.x86)/newdev.lib
5306	SDK_VBoxWinNewDevLib_LIBS.amd64 = $(PATH_SDK_$(VBOX_WINPSDK)_LIB.amd64)/newdev.lib
5307	SDK_VBoxWinNewDevLib_LIBS.arm64 = $(PATH_SDK_$(VBOX_WINPSDK)_LIB.arm64)/newdev.lib
5308	else
5309	SDK_VBoxWinNewDevLib_LIBS.x86 = $(PATH_SDK_$(VBOX_WINDDK)_LIB.x86)/newdev.lib
5310	SDK_VBoxWinNewDevLib_LIBS.amd64 = $(PATH_SDK_$(VBOX_WINDDK)_LIB.amd64)/newdev.lib
5311	endif
5312
5313	#
5314	# Determine Solaris version.
5315	#
5316	ifeq ($(KBUILD_TARGET),solaris)
5317	VBOX_SOLARIS_VERSION := $(expr $(KBUILD_HOST_VERSION_MAJOR) * 100 + $(KBUILD_HOST_VERSION_MINOR))
5318	ifeq ($(VBOX_SOLARIS_VERSION),510)
5319	DEFS.solaris += RT_OS_SOLARIS_10
5320	# Solaris 10 does not include crossbow.
5321	VBOX_SOLARIS_10 = 1
5322	# We cannot compile additions on Solaris 10, due kernel interface deps
5323	VBOX_WITHOUT_ADDITIONS := 1
5324	VBOX_WITH_ADDITIONS =
5325	else ifeq ($(VBOX_SOLARIS_VERSION),511)
5326	# OSS audio support for Solaris
5327	VBOX_WITH_AUDIO_OSS := 1
5328	endif
5329
5330	# XPCOM namespace cleanup issue with Solaris GCC 4.5.2 and newer, see @bugref{5838}.
5331	if $(VBOX_GCC_VERSION_CXX) >= 40502
5332	VBOX_WITH_XPCOM_NAMESPACE_CLEANUP =
5333	endif
5334	endif
5335
5336	#
5337	# VBoxTpG tool.
5338	#
5339	TOOL_VBoxTpG = The VirtualBox Tracepoint Generator
5340	TOOL_VBoxTpG_DTRACE_DEPORD = $(VBOX_VBOXTPG)
5341	TOOL_VBoxTpG_DTRACE_HDR_FLAGS := \
5342	-h --host-$(VBOX_HC_ARCH_BITS)-bit #-vvv
5343	define TOOL_VBoxTpG_DTRACE_HDR_CMDS
5344	$(QUIET)$(VBOX_VBOXTPG) $(if-expr $(intersects $(bld_trg_arch),$(KBUILD_ARCHES_64)),-64,-32) \
5345	$(flags) -o "$(out)" -s "$(source)"
5346	endef
5347	TOOL_VBoxTpG_DTRACE_OBJ_NOT_NEEDED :=
5348	TOOL_VBoxTpG_DTRACE_OBJ_FLAGS := -G --host-$(VBOX_HC_ARCH_BITS)-bit #-vvv
5349	define TOOL_VBoxTpG_DTRACE_OBJ_CMDS
5350	$(QUIET)$(VBOX_VBOXTPG) --assembler "$(TOOL_$(VBOX_ASTOOL)_AS)" \
5351	$(if-expr $(intersects $(bld_trg_arch),$(KBUILD_ARCHES_64)),-64,-32) \
5352	$(flags) \
5353	-o "$(out)" -s "$(source)"
5354	endef
5355
5356
5357	#
5358	# VBoxTpG tool - Disabled, only generate the header.
5359	#
5360	TOOL_VBoxTpG-Disabled = The VirtualBox Tracepoint Generator, disabled.
5361	TOOL_VBoxTpG-Disabled_DTRACE_DEPORD = $(VBOX_VBOXTPG)
5362	TOOL_VBoxTpG-Disabled_DTRACE_HDR_FLAGS := -h
5363	define TOOL_VBoxTpG-Disabled_DTRACE_HDR_CMDS
5364	$(QUIET)$(VBOX_VBOXTPG) $(flags) -o "$(out)" -s "$(source)"
5365	endef
5366	TOOL_VBoxTpG-Disabled_DTRACE_OBJ_NOT_NEEDED := $(KBUILD_OSES)
5367
5368
5369	#
5370	# dtrace+VBoxTpG tool for ring-3 to ring-0 pointer conversion.
5371	#
5372	TOOL_DTraceAndVBoxTpG = DTrace and the VirtualBox Tracepoint Generator working together on static ring-3 probes.
5373	TOOL_DTraceAndVBoxTpG_EXTENDS = StandardDTrace
5374	TOOL_DTraceAndVBoxTpG_DTRACE_DEPORD = $(VBOX_VBOXTPG)
5375	TOOL_DTraceAndVBoxTpG_DTRACE_HDR_CMDS =
5376	define TOOL_DTraceAndVBoxTpG_DTRACE_HDR_CMDS
5377	$(TOOL_StandardDTrace_DTRACE_HDR_CMDS)
5378	$(QUIET)$(VBOX_VBOXTPG) --generate-wrapper-header --host-$(VBOX_HC_ARCH_BITS)-bit --ring-3-context \
5379	$(filter-out -C, $(filter-out -h,$(flags))) \
5380	-o "$(out).tmp" -s "$(source)"
5381	$(APPEND) "$(out).tmp"
5382	$(SED) -e 's/$#define.*$(arg0/\1_ORIGINAL(arg0/' --append "$(out).tmp" "$(out)"
5383	$(MV) -f -- "$(out).tmp" "$(out)"
5384	endef
5385	TOOL_DTraceAndVBoxTpG_DTRACE_OBJ_NOT_NEEDED = $(TOOL_StandardDTrace_DTRACE_OBJ_NOT_NEEDED)
5386	TOOL_DTraceAndVBoxTpG_DTRACE_OBJ_CMDS = $(TOOL_StandardDTrace_DTRACE_OBJ_CMDS)
5387
5388
5389	ifdef VBOX_WITH_RAW_MODE
5390	#
5391	# Template for building RC things.
5392	#
5393	# Disabled Visual C++ warnings:
5394	# -wd4505: 'iemRaisePageFaultJmp' : unreferenced local function has been removed
5395	#
5396	TEMPLATE_VBoxRc = VBox Raw-Mode Context
5397	TEMPLATE_VBoxRc_ASTOOL := $(VBOX_ASTOOL32)
5398	TEMPLATE_VBoxRc_ASFLAGS = $(VBOX_ASFLAGS32)
5399	TEMPLATE_VBoxRc_DEFS = IN_RC IPRT_NO_CRT RT_WITH_NOCRT_ALIASES $(ARCH_BITS_DEFS)
5400	TEMPLATE_VBoxRc_INCS = $(PATH_ROOT)/include/iprt/nocrt
5401	TEMPLATE_VBoxRc_SYSSUFF = .rc
5402	TEMPLATE_VBoxRc_BLD_TRG_ARCH = x86
5403	TEMPLATE_VBoxRc_MODE = a+r,u+w
5404
5405	TEMPLATE_VBoxRc_USES += dtrace
5406	TEMPLATE_VBoxRc_DTRACE_HDR_FLAGS = --raw-mode-context
5407	TEMPLATE_VBoxRc_DTRACE_OBJ_FLAGS = --raw-mode-context --probe-fn-name "VMMRCProbeFire"
5408	ifdef VBOX_WITH_DTRACE_RC
5409	TEMPLATE_VBoxRc_DTRACETOOL = VBoxTpG
5410	TEMPLATE_VBoxRc_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_RC
5411	else
5412	TEMPLATE_VBoxRc_DTRACETOOL = VBoxTpG-Disabled
5413	endif
5414
5415	ifeq ($(VBOX_LDR_FMT32),pe)
5416	TEMPLATE_VBoxRc_TOOL = $(VBOX_VCC_TOOL_STEM)X86
5417	TEMPLATE_VBoxRc_RCDEFS = VBOX_SVN_REV=$(VBOX_SVN_REV) VBOX_SVN_REV_MOD_5K=$(expr $(VBOX_SVN_REV) % 50000)
5418	TEMPLATE_VBoxRc_CXXFLAGS = -Zi -Zl -GR- -EHs- -GF -GS- $(VBOX_VCC_WCHAR_T_VARIANT) -Gs8192 $(VBOX_VCC_GC_OPT) $(VBOX_VCC_GC_FP) \
5419	-Gy $(VBOX_VCC_WARN_ALL) -wd4505 $(VBOX_VCC_WERR)
5420	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
5421	TEMPLATE_VBoxRc_CXXFLAGS += -Gw
5422	endif
5423	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
5424	TEMPLATE_VBoxRc_CXXFLAGS += -Zc:inline
5425	endif
5426	ifdef VBOX_WITH_MSC_ANALYZE_THIS
5427	TEMPLATE_VBoxRc_CXXFLAGS += /analyze
5428	endif
5429	TEMPLATE_VBoxRc_CFLAGS = $(TEMPLATE_VBoxRc_CXXFLAGS)
5430	TEMPLATE_VBoxRc_LDFLAGS = -Ignore:4197 \
5431	-Driver -Subsystem:NATIVE -Incremental:NO -Align:64 -MapInfo:Exports -NoD $(VBOX_VCC_LD_WERR) -Release -Debug -Opt:Ref -Opt:Icf \
5432	-Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
5433	-Stub:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
5434	if defined(VBOX_SIGNING_MODE) && !defined(VBOX_WITHOUT_WINDOWS_KERNEL_CODE_SIGNING_CERT)
5435	TEMPLATE_VBoxRc_LDFLAGS += -IntegrityCheck
5436	endif
5437	TEMPLATE_VBoxRc_LATE_LIBS += \
5438	$(PATH_STAGE_LIB)/RuntimeRCStub$(VBOX_SUFF_LIB)
5439	TEMPLATE_VBoxRc_POST_CMDS = $(VBOX_SIGN_IMAGE_CMDS)
5440	TEMPLATE_VBoxRc_ORDERDEPS = $(VBOX_SIGN_IMAGE_CMDS_ORDERDEPS)
5441	endif # pe
5442
5443	ifeq ($(VBOX_LDR_FMT32),elf)
5444	TEMPLATE_VBoxRc_TOOL = $(VBOX_GCC32_TOOL)
5445	TEMPLATE_VBoxRc_CXXFLAGS = -fno-pie -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC32_Wno-variadic-macros) -fno-exceptions $(VBOX_GCC_GC_OPT) $(VBOX_GCC_GC_FP) -mno-sse -mno-mmx -mno-sse2 -mno-3dnow -fno-strict-aliasing $(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_fvisibility-inlines-hidden) -fno-rtti $(VBOX_GCC_IPRT_FMT_CHECK)
5446	TEMPLATE_VBoxRc_CFLAGS = -fno-pie -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC32_Wno-variadic-macros) -fno-exceptions $(VBOX_GCC_GC_OPT) $(VBOX_GCC_GC_FP) -mno-sse -mno-mmx -mno-sse2 -mno-3dnow -fno-strict-aliasing $(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_IPRT_FMT_CHECK)
5447	if $(VBOX_GCC32_VERSION_CC) < 30400
5448	TEMPLATE_VBoxRc_DEFS += RT_WITHOUT_PRAGMA_ONCE
5449	endif
5450	ifeq ($(KBUILD_TARGET),solaris)
5451	TEMPLATE_VBoxRc_LDFLAGS = -r
5452	else
5453	TEMPLATE_VBoxRc_LDFLAGS = -nostdlib -Bsymbolic -g
5454	## @todo WTF doesn't the globals work? Debug info is supposed to be split everywhere. GRR
5455	TEMPLATE_VBoxRc_LD_DEBUG = split
5456	endif
5457	ifn1of ($(KBUILD_TARGET), solaris freebsd)
5458	TEMPLATE_VBoxRc_LATE_LIBS = \
5459	$(VBOX_GCC32_LIBGCC) # intrinsics
5460	endif
5461	if1of ($(KBUILD_TARGET), linux)
5462	TEMPLATE_VBoxRc_POST_CMDS = $(if $(eq $(tool_do),LINK_SYSMOD),if readelf -S $(out)\|grep -q "[cd]tors"; then echo "Found ctors/dtors in $(out)!"; exit 1; fi)
5463	endif
5464	endif
5465
5466	ifeq ($(VBOX_LDR_FMT32),macho)
5467	TEMPLATE_VBoxRc_TOOL = $(VBOX_GCC_TOOL)
5468	TEMPLATE_VBoxRc_SDKS += $(VBOX_DARWIN_DEF_SDK_SDKS)
5469	TEMPLATE_VBoxRc_DEFS += $(VBOX_DARWIN_DEF_SDK_DEFS)
5470	TEMPLATE_VBoxRc_CXXFLAGS = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS) -m32 -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC32_Wno-variadic-macros) -fno-common -msoft-float -static $(VBOX_GCC_fno-stack-protector) -fno-exceptions $(VBOX_GCC_GC_OPT) $(VBOX_GCC_GC_FP) -fno-strict-aliasing -fno-rtti $(VBOX_GCC_std)
5471	TEMPLATE_VBoxRc_CFLAGS = $(VBOX_DARWIN_DEF_SDK_CFLAGS) -m32 -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC32_Wno-variadic-macros) -fno-common -msoft-float -static $(VBOX_GCC_fno-stack-protector) -fno-exceptions $(VBOX_GCC_GC_OPT) $(VBOX_GCC_GC_FP) -fno-strict-aliasing
5472	TEMPLATE_VBoxRc_LDFLAGS = $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -m32 -nostdlib
5473	#TEMPLATE_VBoxRc_LDFLAGS.release = -Wl,-S ???
5474	endif
5475
5476	ifeq ($(VBOX_LDR_FMT32),lx)
5477	TEMPLATE_VBoxRc_TOOL = GXX3OMF
5478	if $(VBOX_GCC_VERSION_CC) < 30400
5479	TEMPLATE_VBoxRc_DEFS += RT_WITHOUT_PRAGMA_ONCE
5480	endif
5481	TEMPLATE_VBoxRc_CXXFLAGS = -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC32_Wno-variadic-macros) $(VBOX_GCC_GC_OPT) $(VBOX_GCC_GC_FP) -fno-strict-aliasing -fno-exceptions -fno-rtti
5482	TEMPLATE_VBoxRc_CFLAGS = -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC32_Wno-variadic-macros) $(VBOX_GCC_GC_OPT) $(VBOX_GCC_GC_FP) -fno-strict-aliasing -fno-exceptions
5483	TEMPLATE_VBoxRc_LDFLAGS = -Zdll -nostdlib
5484	TEMPLATE_VBoxRc_LATE_LIBS = \
5485	$(VBOX_GCC32_LIBGCC) \
5486	$(VBOX_OBJ_SYS0) \
5487	end
5488	endif
5489
5490
5491	#
5492	# Template for building a RC ring-3 testcase (tstVMStructGC, tstDevStructGC).
5493	#
5494	TEMPLATE_VBoxRcExe = VBox Raw-Mode as ring-3 testcase
5495	TEMPLATE_VBoxRcExe_EXTENDS = VBoxRc
5496	TEMPLATE_VBoxRcExe_DEFS = $(filter-out IPRT_NO_CRT RT_WITH_NOCRT_ALIASES,$(TEMPLATE_VBoxRc_DEFS))
5497	TEMPLATE_VBoxRcExe_INCS = $(NO_SUCH_VARIABLE)
5498	TEMPLATE_VBoxRcExe_MODE = $(NO_SUCH_VARIABLE)
5499
5500	ifeq ($(VBOX_LDR_FMT32),pe)
5501	TEMPLATE_VBoxRcExe_LDFLAGS = -Ignore:4197 \
5502	-Incremental:NO -MapInfo:Exports -NoD -Debug -Opt:Ref -Opt:Icf \
5503	-Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
5504	-Stub:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
5505	TEMPLATE_VBoxRcExe_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK)
5506	TEMPLATE_VBoxRcExe_LATE_LIBS = \
5507	$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_LIB)/libcmt.lib \
5508	$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_LIB)/oldnames.lib
5509	endif
5510
5511	ifeq ($(VBOX_LDR_FMT32),elf)
5512	TEMPLATE_VBoxRcExe_CFLAGS = $(filter-out -nostdinc,$(TEMPLATE_VBoxRc_CFLAGS)) -O0
5513	TEMPLATE_VBoxRcExe_CXXFLAGS = $(filter-out -nostdinc,$(TEMPLATE_VBoxRc_CXXFLAGS)) -O0
5514	TEMPLATE_VBoxRcExe_LDFLAGS = -g
5515	TEMPLATE_VBoxRcExe_LDFLAGS.dbgopt = -g
5516	TEMPLATE_VBoxRcExe_LDFLAGS.strict = -g
5517	TEMPLATE_VBoxRcExe_LDFLAGS.release = -g
5518	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), freebsd.amd64)
5519	# The FreeBSD port of gcc isn't picking up -m32 where it should.
5520	TEMPLATE_VBoxRcExe_DEFS.$(KBUILD_TARGET) = $(TEMPLATE_VBoxRc_DEFS.$(KBUILD_TARGET)) IPRT_DONT_USE_SYSTEM_STDINT_H
5521	TEMPLATE_VBoxRcExe_LDFLAGS.$(KBUILD_TARGET) = /usr/lib32/crt1.o /usr/lib32/crti.o /usr/lib32/crtbegin.o $(TEMPLATE_VBoxRc_LDFLAGS.$(KBUILD_TARGET)) -nostdlib -v
5522	TEMPLATE_VBoxRcExe_LIBPATH.$(KBUILD_TARGET) = /usr/lib32
5523	TEMPLATE_VBoxRcExe_LATE_LIBS.$(KBUILD_TARGET) = /usr/lib32/crtend.o /usr/lib32/crtn.o /usr/lib32/libc.so
5524	endif
5525	endif
5526
5527	ifeq ($(VBOX_LDR_FMT32),macho)
5528	TEMPLATE_VBoxRcExe_CFLAGS = $(filter-out -static -nostdinc,$(TEMPLATE_VBoxRc_CFLAGS))
5529	TEMPLATE_VBoxRcExe_CXXFLAGS = $(filter-out -static -nostdinc,$(TEMPLATE_VBoxRc_CXXFLAGS))
5530	TEMPLATE_VBoxRcExe_LDFLAGS = -g -m32
5531	endif
5532
5533	ifeq ($(VBOX_LDR_FMT32),lx)
5534	TEMPLATE_VBoxRcExe_CFLAGS = $(filter-out -nostdinc,$(TEMPLATE_VBoxRc_CFLAGS))
5535	TEMPLATE_VBoxRcExe_CXXFLAGS = $(filter-out -nostdinc,$(TEMPLATE_VBoxRc_CXXFLAGS))
5536	TEMPLATE_VBoxRcExe_LDFLAGS = -g
5537	TEMPLATE_VBoxRcExe_LATE_LIBS = $(NO_SUCH_VARIABLE)
5538	endif
5539	endif # VBOX_WITH_RAW_MODE
5540
5541
5542	#
5543	# Template for building R0 things.
5544	#
5545	# Disabled Visual C++ warnings:
5546	# -wd4505: 'iemRaisePageFaultJmp' : unreferenced local function has been removed
5547	#
5548	TEMPLATE_VBoxR0 = VBox Ring 0
5549	$(foreach arch,$(VBOX_TARGET_ARCHES)\
5550	,$(eval TEMPLATE_VBoxR0_ASTOOL.$(KBUILD_TARGET).$(arch) := $(VBOX_ASTOOL.$(KBUILD_TARGET).$(arch))))
5551	$(foreach arch,$(VBOX_TARGET_ARCHES)\
5552	,$(eval TEMPLATE_VBoxR0_ASFLAGS.$(KBUILD_TARGET).$(arch) = $$(VBOX_ASFLAGS.$(KBUILD_TARGET).$(arch))))
5553	TEMPLATE_VBoxR0_DEFS = IN_RING0 IN_RING0_AGNOSTIC IPRT_NO_CRT RT_WITH_NOCRT_ALIASES $(ARCH_BITS_DEFS)
5554	TEMPLATE_VBoxR0_INCS = $(PATH_ROOT)/include/iprt/nocrt
5555	TEMPLATE_VBoxR0_SYSSUFF = .r0
5556	TEMPLATE_VBoxR0_MODE = a+r,u+w
5557
5558	TEMPLATE_VBoxR0_USES += dtrace
5559	TEMPLATE_VBoxR0_DTRACE_HDR_FLAGS = --ring-0-context-agnostic
5560	TEMPLATE_VBoxR0_DTRACE_OBJ_FLAGS = --ring-0-context-agnostic
5561	ifdef VBOX_WITH_DTRACE_R0
5562	TEMPLATE_VBoxR0_DTRACETOOL = VBoxTpG
5563	TEMPLATE_VBoxR0_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R0
5564	else
5565	TEMPLATE_VBoxR0_DTRACETOOL = VBoxTpG-Disabled
5566	endif
5567	ifdef VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION
5568	TEMPLATE_VBoxR0_DEFS += RT_WITH_IBT_BRANCH_PROTECTION RT_WITH_IBT_BRANCH_PROTECTION_WITHOUT_NOTRACK
5569	endif
5570
5571	ifeq ($(VBOX_LDR_FMT),pe)
5572	TEMPLATE_VBoxR0_TOOL = $(VBOX_VCC_TOOL)
5573	TEMPLATE_VBoxR0_RCDEFS = VBOX_SVN_REV=$(VBOX_SVN_REV) VBOX_SVN_REV_MOD_5K=$(expr $(VBOX_SVN_REV) % 50000)
5574	TEMPLATE_VBoxR0_CXXFLAGS = -Zi -Zl -GR- -EHs- -GF -GS- $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_OPT) $(VBOX_VCC_FP) \
5575	-Gy $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_std) $(VBOX_VCC_WARN_ALL) -wd4505 $(VBOX_VCC_WERR)
5576	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
5577	TEMPLATE_VBoxR0_CXXFLAGS += -Gw
5578	endif
5579	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
5580	TEMPLATE_VBoxR0_CXXFLAGS += -Zc:inline
5581	endif
5582	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
5583	TEMPLATE_VBoxR0_CXXFLAGS += /volatileMetadata-
5584	endif
5585	ifdef VBOX_WITH_MSC_ANALYZE_THIS
5586	TEMPLATE_VBoxR0_CXXFLAGS += /analyze
5587	endif
5588	TEMPLATE_VBoxR0_CFLAGS = $(filter-out $(VBOX_VCC_std),$(TEMPLATE_VBoxR0_CXXFLAGS))
5589	TEMPLATE_VBoxR0_LDFLAGS = -Ignore:4197 \
5590	-Driver -Subsystem:NATIVE -Incremental:NO -Align:4096 -MapInfo:Exports -NoD $(VBOX_VCC_LD_WERR) \
5591	-Release -Debug -Opt:Ref -Opt:Icf $(VBOX_VCC_LD_GUARD_CF) \
5592	-Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
5593	-Stub:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
5594	ifdef VBOX_WITH_DTRACE_R0
5595	TEMPLATE_VBoxR0_LDFLAGS += -Merge:VTGPrLc.Data=VTGPrLc.Begin -Merge:VTGPrLc.End=VTGPrLc.Begin -Merge:VTGPrLc.Begin=VTGObj
5596	endif
5597	ifdef VBOX_SIGNING_MODE
5598	TEMPLATE_VBoxR0_LDFLAGS += -IntegrityCheck
5599	endif
5600	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
5601	TEMPLATE_VBoxR0_LDFLAGS += -EmitVolatileMetadata:NO
5602	endif
5603	TEMPLATE_VBoxR0_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
5604	TEMPLATE_VBoxR0_LDFLAGS.win.arm64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
5605	ifneq ($(VBOX_VCC_CC_GUARD_CF),)
5606	TEMPLATE_VBoxR0_LDFLAGS.win.amd64 += -Include:__security_init_cookie -Export:ModuleInitSecurityCookie=__security_init_cookie
5607	TEMPLATE_VBoxR0_LDFLAGS.win.x86 += -Include:___security_init_cookie -Export:ModuleInitSecurityCookie=__security_init_cookie
5608	TEMPLATE_VBoxR0_LDFLAGS.win.arm64 += -Include:__security_init_cookie -Export:ModuleInitSecurityCookie=__security_init_cookie
5609	endif
5610	TEMPLATE_VBoxR0_LATE_LIBS = \
5611	$(PATH_STAGE_LIB)/RuntimeR0Stub$(VBOX_SUFF_LIB)
5612	ifneq ($(VBOX_VCC_CC_GUARD_CF),)
5613	TEMPLATE_VBoxR0_LATE_LIBS.x86 += \
5614	$(PATH_SDK_$(VBOX_WINDDK)_LIB)/BufferOverflowK.lib
5615	TEMPLATE_VBoxR0_LATE_LIBS.amd64 += \
5616	$(PATH_SDK_$(VBOX_WINDDK)_LIB)/BufferOverflowK.lib
5617	TEMPLATE_VBoxR0_LATE_LIBS.arm64 += \
5618	$(PATH_SDK_$(VBOX_WINDDK)_LIB)/BufferOverflowFastFailK.lib
5619	include $(KBUILD_PATH)/sdks/$(VBOX_WINDDK).kmk ## TODO: Add a kBuild feature for loading SDKs.
5620	endif
5621	TEMPLATE_VBoxR0_ORDERDEPS = $(VBOX_SIGN_DRIVER_ORDERDEPS)
5622	TEMPLATE_VBoxR0_POST_CMDS = $(VBOX_SIGN_DRIVER_CMDS)
5623	endif # pe
5624
5625	ifeq ($(VBOX_LDR_FMT),elf)
5626	TEMPLATE_VBoxR0_TOOL = $(VBOX_GCC_TOOL)
5627	TEMPLATE_VBoxR0_CFLAGS = -fno-pie -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_C) \
5628	$(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-exceptions \
5629	$(VBOX_GCC_fno-stack-protector) -fno-common -ffreestanding $(VBOX_GCC_fvisibility-hidden) -std=gnu99 $(VBOX_GCC_IPRT_FMT_CHECK)
5630	TEMPLATE_VBoxR0_CXXFLAGS = -fno-pie -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_CXX) \
5631	$(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-exceptions \
5632	$(VBOX_GCC_fno-stack-protector) -fno-common $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) \
5633	-fno-rtti $(VBOX_GCC_std) $(VBOX_GCC_IPRT_FMT_CHECK)
5634	if $(VBOX_GCC_VERSION_CC) >= 40500 # 4.1.2 complains, 4.5.2 is okay, didn't check which version inbetween made it okay with g++.
5635	TEMPLATE_VBoxR0_CXXFLAGS += -ffreestanding
5636	endif
5637	TEMPLATE_VBoxR0_CFLAGS.amd64 = -m64 -mno-red-zone -mno-sse -mno-mmx -mno-sse2 -mno-3dnow -fasynchronous-unwind-tables -ffreestanding
5638	TEMPLATE_VBoxR0_CXXFLAGS.amd64 = -m64 -mno-red-zone -mno-sse -mno-mmx -mno-sse2 -mno-3dnow -fasynchronous-unwind-tables
5639	TEMPLATE_VBoxR0_CXXFLAGS.freebsd = -ffreestanding
5640	if $(VBOX_GCC_VERSION_CC) < 30400
5641	TEMPLATE_VBoxR0_DEFS += RT_WITHOUT_PRAGMA_ONCE
5642	endif
5643	ifeq ($(KBUILD_TARGET),solaris)
5644	TEMPLATE_VBoxR0_LDFLAGS = -r
5645	TEMPLATE_VBoxR0_LDFLAGS.solaris = -u _init -u _info
5646	TEMPLATE_VBoxR0_LDFLAGS.solaris.amd64 = -m64
5647	TEMPLATE_VBoxR0_LDFLAGS.solaris.x86 = -m32
5648	TEMPLATE_VBoxR0_LATE_LIBS.solaris = \
5649	$(PATH_STAGE_LIB)/RuntimeR0Stub$(VBOX_SUFF_LIB)
5650	ifdef VBOX_GCC_USING_SOLARIS_AS
5651	TEMPLATE_VBoxR0_CFLAGS.amd64 += -Wa,-xmodel=kernel
5652	TEMPLATE_VBoxR0_CXXFLAGS.amd64 += -Wa,-xmodel=kernel
5653	endif
5654	# Solaris driver signing.
5655	TEMPLATE_VBoxR0_POST_CMDS = $(VBOX_SIGN_DRIVER_CMDS)
5656	else
5657	TEMPLATE_VBoxR0_LDFLAGS = -nostdlib -Bsymbolic -g
5658	## @todo WTF doesn't the globals work? Debug info is supposed to be split everywhere. GRR
5659	TEMPLATE_VBoxR0_LD_DEBUG = split
5660	endif
5661	if "$(KBUILD_TARGET)" == "linux" && !defined(VBOX_WITH_KMOD_WRAPPED_R0_MODS)
5662	VBOX_WITH_VBOXR0_AS_DLL = 1
5663	TEMPLATE_VBoxR0_DLLSUFF = .r0
5664	TEMPLATE_VBoxR0_CFLAGS += -fPIC
5665	TEMPLATE_VBoxR0_CXXFLAGS += -fPIC
5666	TEMPLATE_VBoxR0_LDFLAGS +=
5667	TEMPLATE_VBoxR0_DTRACE_HDR_FLAGS += --pic
5668	TEMPLATE_VBoxR0_DTRACE_OBJ_FLAGS += --pic
5669	else
5670	TEMPLATE_VBoxR0_CFLAGS.amd64 += -mcmodel=kernel
5671	TEMPLATE_VBoxR0_CXXFLAGS.amd64 += -mcmodel=kernel
5672	endif
5673	ifdef VBOX_WITH_KMOD_WRAPPED_R0_MODS # For BTF/pahold issue we use -g1
5674	TEMPLATE_VBoxR0_DEFS += VBOX_WITH_KMOD_WRAPPED_R0_MODS
5675	TEMPLATE_VBoxR0_LDFLAGS.linux += $(PATH_ROOT)/src/VBox/HostDrivers/Support/linux/VBoxR0-wrapped.lds
5676	TEMPLATE_VBoxR0_LNK_DEPS.linux += $(PATH_ROOT)/src/VBox/HostDrivers/Support/linux/VBoxR0-wrapped.lds
5677	TEMPLATE_VBoxR0_CFLAGS.linux += -g1
5678	TEMPLATE_VBoxR0_CXXFLAGS.linux += -g1
5679	endif
5680	ifdef VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION
5681	TEMPLATE_VBoxR0_CFLAGS += $(VBOX_GCC_fcf-protection_branch) -fno-jump-tables
5682	TEMPLATE_VBoxR0_CXXFLAGS += $(VBOX_GCC_fcf-protection_branch) -fno-jump-tables
5683	TEMPLATE_VBoxR0_LDFLAGS += $(VBOX_GCC_fcf-protection_branch) $(VBOX_GCC_fcf-protection_check)
5684	ifeq ($(VBOX_GCC_fcf-protection_branch),)
5685	$(warning VBox: VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION is set but gcc doesn't support branch protection)
5686	endif
5687	endif
5688	ifn1of ($(KBUILD_TARGET), solaris freebsd)
5689	TEMPLATE_VBoxR0_LATE_LIBS = \
5690	$(VBOX_GCC_LIBGCC) # intrinsics
5691	endif
5692	if1of ($(KBUILD_TARGET), linux)
5693	TEMPLATE_VBoxR0_POST_CMDS += $(NLTAB) \
5694	$(if $(eq $(tool_do),LINK_SYSMOD),if readelf -S $(out)\|grep -q "[cd]tors"; then echo "Found ctors/dtors in $(out)!"; exit 1; fi)
5695	endif
5696	endif # elf
5697
5698	ifeq ($(VBOX_LDR_FMT),macho)
5699	TEMPLATE_VBoxR0_TOOL = $(VBOX_GCC_TOOL)
5700	TEMPLATE_VBoxR0_SDKS += $(VBOX_DARWIN_DEF_SDK_SDKS)
5701	TEMPLATE_VBoxR0_DEFS += $(VBOX_DARWIN_DEF_SDK_DEFS)
5702	TEMPLATE_VBoxR0_CXXFLAGS = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS) -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) \
5703	-fno-common -static -fno-rtti -fno-exceptions $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing \
5704	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_std)
5705	TEMPLATE_VBoxR0_CXXFLAGS.amd64 = -m64 -msoft-float -mno-sse -mno-mmx -mno-sse2 -mno-3dnow -mno-red-zone -mno-sse3 -mno-sse4 -mno-sse4.1 -mno-sse4.2 -mno-sse4a -fno-unwind-tables
5706	TEMPLATE_VBoxR0_CXXFLAGS.x86 = -m32 -msoft-float -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
5707	TEMPLATE_VBoxR0_CXXFLAGS.arm64 = -m64 -target arm64e-apple-macos11.0 # Assembly fixup issues w/o the -target bit. Why?
5708	TEMPLATE_VBoxR0_CFLAGS = $(VBOX_DARWIN_DEF_SDK_CFLAGS) -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros) \
5709	-fno-common -static -fno-exceptions $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing \
5710	$(VBOX_GCC_fno-stack-protector)
5711	TEMPLATE_VBoxR0_CFLAGS.amd64 = -m64 -msoft-float -mno-sse -mno-mmx -mno-sse2 -mno-3dnow -mno-red-zone -mno-sse3 -mno-sse4 -mno-sse4.1 -mno-sse4.2 -mno-sse4a -fno-unwind-tables
5712	TEMPLATE_VBoxR0_CFLAGS.x86 = -m32 -msoft-float -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
5713	TEMPLATE_VBoxR0_CFLAGS.arm64 = -m64 -target arm64e-apple-macos11.0
5714	TEMPLATE_VBoxR0_LDFLAGS = $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -nostdlib
5715	TEMPLATE_VBoxR0_LDFLAGS.amd64 = -m64 -static
5716	TEMPLATE_VBoxR0_LDFLAGS.arm64 = -m64 -static
5717	TEMPLATE_VBoxR0_LDFLAGS.x86 = -m32
5718	TEMPLATE_VBoxR0_CXXFLAGS.amd64 += -mkernel
5719	TEMPLATE_VBoxR0_CFLAGS.amd64 += -mkernel
5720	TEMPLATE_VBoxR0_CXXFLAGS.arm64 += -mkernel
5721	TEMPLATE_VBoxR0_CFLAGS.arm64 += -mkernel
5722	TEMPLATE_VBoxR0_LDFLAGS += -Wl,-kext -mkernel
5723	TEMPLATE_VBoxR0_POST_CMDS = $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_VMM_MOD_FN,$(out),org.virtualbox.app.r0.$(target)))
5724	endif
5725
5726	ifeq ($(VBOX_LDR_FMT),lx)
5727	TEMPLATE_VBoxR0_TOOL = GXX3OMF
5728	TEMPLATE_VBoxR0_CFLAGS = -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-exceptions -fno-common
5729	TEMPLATE_VBoxR0_CXXFLAGS = -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-exceptions -fno-common -fno-rtti
5730	if $(VBOX_GCC_VERSION_CC) < 30400
5731	TEMPLATE_VBoxR0_DEFS += RT_WITHOUT_PRAGMA_ONCE
5732	endif
5733	TEMPLATE_VBoxR0_LDFLAGS = -nostdlib -Zdll
5734	TEMPLATE_VBoxR0_LATE_LIBS = \
5735	$(VBOX_GCC_LIBGCC) \
5736	$(VBOX_OBJ_SYS0) \
5737	end
5738	endif
5739
5740
5741	#
5742	# Template for building SUPDRV R0 things.
5743	#
5744	# Disabled Visual C++ warnings:
5745	# -wd4996: deprecated / insecure.
5746	# -wd4127: conditional expression is constant [level 4]
5747	# -wd4201: nonstandard extension used : nameless struct/union [level 4]
5748	# -wd4214: nonstandard extension used : bit field types other than int [level 4]
5749	# -wd4706: assignment within conditional expression [level 4]
5750	# -wd4324: '_TDI_PNP_CONTEXT_XP' : structure was padded due to __declspec(align())
5751	#
5752	# -wd4100: 'identifier' : unreferenced formal parameter [level 4] --- TODO: Enable this one!
5753	#
5754	TEMPLATE_VBoxR0Drv = VBox SUPDRV Ring 0
5755	$(foreach arch,$(VBOX_TARGET_ARCHES)\
5756	,$(eval TEMPLATE_VBoxR0Drv_ASTOOL.$(KBUILD_TARGET).$(arch) := $(VBOX_ASTOOL.$(KBUILD_TARGET).$(arch))))
5757	$(foreach arch,$(VBOX_TARGET_ARCHES)\
5758	,$(eval TEMPLATE_VBoxR0Drv_ASFLAGS.$(KBUILD_TARGET).$(arch) = $$(VBOX_ASFLAGS.$(KBUILD_TARGET).$(arch))))
5759	TEMPLATE_VBoxR0Drv_DEFS = IN_RING0 IN_RT_R0 $(ARCH_BITS_DEFS)
5760	TEMPLATE_VBoxR0Drv_USES += dtrace
5761	ifdef VBOX_WITH_DTRACE_R0DRV
5762	TEMPLATE_VBoxR0Drv_DTRACETOOL = VBoxTpG
5763	TEMPLATE_VBoxR0Drv_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R0DRV
5764	ifdef VBOX_WITH_NATIVE_DTRACE
5765	TEMPLATE_VBoxR0Drv_DEFS += VBOX_WITH_NATIVE_DTRACE
5766	endif
5767	else
5768	TEMPLATE_VBoxR0Drv_DTRACETOOL = VBoxTpG-Disabled
5769	endif
5770
5771	ifeq ($(KBUILD_TARGET),win)
5772	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_VCC_TOOL)
5773	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # for stddef.h ## @todo 8489: check if still needed
5774	TEMPLATE_VBoxR0Drv_SDKS = WINSDK10-UCRT-INCS
5775	endif
5776	TEMPLATE_VBoxR0Drv_RCDEFS = VBOX_SVN_REV=$(VBOX_SVN_REV) VBOX_SVN_REV_MOD_5K=$(expr $(VBOX_SVN_REV) % 50000)
5777	TEMPLATE_VBoxR0Drv_DEFS += _KERNEL_MODE=1 # Needed with W10 to access things like KeQueryInterruptTime
5778	TEMPLATE_VBoxR0Drv_DEFS.x86 = _X86_
5779	TEMPLATE_VBoxR0Drv_DEFS.x86 += NO_INTERLOCKED_INTRINSICS # Avoids intrisic VC/WDK trouble
5780	TEMPLATE_VBoxR0Drv_DEFS.x86 += WIN9X_COMPAT_SPINLOCK # Avoid multiply defined _KeInitializeSpinLock@4
5781	TEMPLATE_VBoxR0Drv_DEFS.amd64 = _AMD64_
5782	TEMPLATE_VBoxR0Drv_DEFS.amd64 += WIN9X_COMPAT_SPINLOCK # For Windows 8+ WDKs where it is no longer inlined but imported from ntoskrnl.
5783	TEMPLATE_VBoxR0Drv_DEFS.amd64 += NT_INLINE_IRQL NT_INLINE_GET_CURRENT_IRQL # Prevent W10 WDK from importing KeLowerIrql and KeGetCurrentIrql.
5784	TEMPLATE_VBoxR0Drv_DEFS.arm64 = _ARM64_
5785	TEMPLATE_VBoxR0Drv_DEFS.win = IPRT_NT_MAP_TO_ZW
5786	TEMPLATE_VBoxR0Drv_CXXFLAGS = -Zi -Zl -GR- -EHs- -GF -Gz -GS- $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_FP) -Gs4096 $(VBOX_VCC_OPT) \
5787	-Gy $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
5788	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
5789	TEMPLATE_VBoxR0Drv_CXXFLAGS += -Gw
5790	endif
5791	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
5792	TEMPLATE_VBoxR0Drv_CXXFLAGS += -Zc:inline
5793	endif
5794	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
5795	TEMPLATE_VBoxR0Drv_CXXFLAGS += /volatileMetadata-
5796	endif
5797	ifdef VBOX_WITH_MSC_ANALYZE_THIS
5798	TEMPLATE_VBoxR0Drv_CXXFLAGS += /analyze
5799	endif
5800	TEMPLATE_VBoxR0Drv_CFLAGS = $(TEMPLATE_VBoxR0Drv_CXXFLAGS)
5801	TEMPLATE_VBoxR0Drv_LDFLAGS = -Ignore:4197 \
5802	-Driver -Subsystem:NATIVE -Incremental:NO -Align:4096 -MapInfo:Exports -NoD -Release -Debug -Opt:Ref -Opt:Icf \
5803	$(VBOX_VCC_LD_GUARD_CF) \
5804	-Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
5805	-Stub:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
5806	ifdef VBOX_WITH_DTRACE_R0DRV
5807	TEMPLATE_VBoxR0Drv_LDFLAGS += -Merge:VTGPrLc.Data=VTGPrLc.Begin -Merge:VTGPrLc.End=VTGPrLc.Begin -Merge:VTGPrLc.Begin=VTGObj
5808	endif
5809	ifdef VBOX_SIGNING_MODE
5810	TEMPLATE_VBoxR0Drv_LDFLAGS += -IntegrityCheck
5811	endif
5812	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
5813	TEMPLATE_VBoxR0Drv_LDFLAGS += -EmitVolatileMetadata:NO
5814	endif
5815	TEMPLATE_VBoxR0Drv_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
5816	TEMPLATE_VBoxR0Drv_LDFLAGS.win.arm64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
5817	TEMPLATE_VBoxR0Drv_ORDERDEPS = $(VBOX_SIGN_DRIVER_ORDERDEPS)
5818	TEMPLATE_VBoxR0Drv_POST_CMDS = $(VBOX_SIGN_DRIVER_CMDS)
5819	endif
5820
5821	ifeq ($(KBUILD_TARGET),linux)
5822	TEMPLATE_VBoxR0Drv_TOOL = $(NO_SUCH_VARIABLE)
5823
5824	ifndef KERN_DIR
5825	ifndef KERN_VER
5826	KERN_VER := $(patsubst /lib/modules/%/build/.config,%,$(firstword $(shell LC_ALL=C ls -t /lib/modules/*/build/.config 2>/dev/null)))
5827	endif
5828	ifeq ($(KERN_VER),)
5829	KERN_VER := $(shell uname -r)
5830	endif
5831	KERN_DIR := /lib/modules/$(KERN_VER)/build
5832	endif
5833
5834	##
5835	## Generates a rule for test-building a linux kernel module (use evalcall2 to invoke).
5836	##
5837	## Since Linux KBuild will not abort due to undefined symbols when building
5838	## external modules we need to grep the error output ourselves. Since vboxdrv
5839	## and vboxguest respectively provide symbols that other modules use, we use
5840	## the rule target (tst*.run) to save those symbols so that KBuild can do its
5841	## checking.
5842	##
5843	## @param 1 Module name.
5844	## @param 2 The test build which symvers we need (empty if none)
5845	## @param 3 Save symvers if non-empty.
5846	##
5847	## @note Using the extra expansion to replace $(1), $(2) and $(3) before eval,
5848	## thus everything else needs escaped dollars.
5849	##
5850	if defined(VBOX_WITH_TESTCASES) \
5851	&& "$(KBUILD_HOST)" == "linux" \
5852	&& "$(KBUILD_HOST_ARCH)" == "$(KBUILD_TARGET_ARCH)" \
5853	&& !defined(VBOX_WITHOUT_LINUX_TEST_BUILDS) \
5854	&& !defined(VBOX_ONLY_SDK) \
5855	&& !defined(VBOX_ONLY_DOCS) \
5856	&& !defined(VBOX_ONLY_VALIDATIONKIT)
5857	define VBOX_LINUX_KMOD_TEST_BUILD_RULE_FN
5858	ifneq ($(KERN_DIR),)
5859	TESTING += $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5860	OTHERS += $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5861	OTHERS_CLEAN += $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5862	$$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run: \
5863	$$(if $(2),$$(PATH_TARGET)/tst$(2)$(subst /,_,$(KERN_DIR))_mod.run,) \
5864	$$$$($(1)_2_STAGE_TARGETS)
5865	$(QUIET)$$(call MSG_L1,Doing a test build of the $(1) kernel module)
5866	$(QUIET)$$(RM) -f -- "$$@"
5867	$(QUIET)$$(TEST) -n "$$($(1)_INST)"
5868	$(QUIET)$$(RM) -Rf -- "$$(PATH_TARGET)/tst$(1)_mod"
5869	$(QUIET)$$(MKDIR) -p -- "$$(PATH_TARGET)/tst$(1)_mod"
5870	$(QUIET)$$(CP) -R -- "$$(PATH_STAGE_BIN)/../$$($(1)_INST)" "$$(PATH_TARGET)/tst$(1)_mod/"
5871	+ $(QUIET)make KBUILD_VERBOSE=$(KBUILD_VERBOSE) KERN_DIR=$(KERN_DIR) VBOX_KERN_QUIET=1 \
5872	VBOX_KBUILD_TYPE=$(KBUILD_TYPE) VBOX_KBUILD_TARGET_ARCH=$(KBUILD_TARGET_ARCH) \
5873	KBUILD_TYPE= KBUILD_TARGET= KBUILD_TARGET_ARCH= KBUILD_TARGET_CPU= KBUILD_HOST= KBUILD_HOST_ARCH= KBUILD_HOST_CPU= \
5874	BUILD_TYPE= BUILD_TARGET= BUILD_TARGET_ARCH= BUILD_TARGET_CPU= BUILD_PLATFORM= BUILD_PLATFORM_ARCH= BUILD_PLATFORM_CPU= \
5875	-C $$(PATH_TARGET)/tst$(1)_mod clean
5876	ifneq ($(2),)
5877	$(QUIET)$$(CP) -f -- "$$<" "$$(PATH_TARGET)/tst$(1)_mod/Module.symvers"
5878	endif
5879	+ $(QUIET)$(REDIRECT_EXT) -d2=1 -w1 "$$(PATH_TARGET)/tst$(1)_mod/make.err" -- \
5880	make KBUILD_VERBOSE=$(KBUILD_VERBOSE) KERN_DIR=$(KERN_DIR) VBOX_KERN_QUIET=1 $(if $(2),KBUILD_EXTRA_SYMBOLS="$$(PATH_TARGET)/tst$(1)_mod/Module.symvers",) $(if-expr $(KMK_OPTS_JOBS) != 0,JOBS=$(KMK_OPTS_JOBS),) \
5881	VBOX_KBUILD_TYPE=$(KBUILD_TYPE) VBOX_KBUILD_TARGET_ARCH=$(KBUILD_TARGET_ARCH) \
5882	KBUILD_TYPE= KBUILD_TARGET= KBUILD_TARGET_ARCH= KBUILD_TARGET_CPU= KBUILD_HOST= KBUILD_HOST_ARCH= KBUILD_HOST_CPU= \
5883	BUILD_TYPE= BUILD_TARGET= BUILD_TARGET_ARCH= BUILD_TARGET_CPU= BUILD_PLATFORM= BUILD_PLATFORM_ARCH= BUILD_PLATFORM_CPU= \
5884	-C $$(PATH_TARGET)/tst$(1)_mod
5885	$(CAT) "$$(PATH_TARGET)/tst$(1)_mod/make.err"
5886	$(QUIET)! grep "^WARNING: .* undefined!$$$$" "$$(PATH_TARGET)/tst$(1)_mod/make.err"
5887	if1of ($(USERNAME), bird)
5888	- nm -u "$$(PATH_TARGET)/tst$(1)_mod/"*.ko \| sort
5889	endif
5890	ifneq ($(3),)
5891	$(QUIET)$$(CP) -f -- "$$(PATH_TARGET)/tst$(1)_mod/Module.symvers" "$$@"
5892	else
5893	$(QUIET)$$(APPEND) -t "$$@" "done"
5894	endif
5895	$(QUIET)$$(RM) -Rf -- "$$(PATH_TARGET)/tst$(1)_mod"
5896	vbox-linux-kmod-test-builds: $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5897	$$(foreach src,$$(notdir $$(filter %.c,$$(subst =>,/,$$($(1)_SOURCES)))),$$(patsubst %.c,%.o,$$(src))): $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5898	endif
5899	endef # VBOX_LINUX_KMOD_TEST_BUILD_RULE_FN
5900	else
5901	VBOX_LINUX_KMOD_TEST_BUILD_RULE_FN =
5902	endif
5903	else
5904	VBOX_LINUX_KMOD_TEST_BUILD_RULE_FN =
5905	endif # linux target
5906
5907	ifeq ($(KBUILD_TARGET),os2)
5908	ifndef VBOX_USE_WATCOM_FOR_OS2
5909	TEMPLATE_VBoxR0Drv_TOOL = GXX3OMF
5910	TEMPLATE_VBoxR0Drv_CXXFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-exceptions -fno-rtti
5911	TEMPLATE_VBoxR0Drv_CFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-exceptions
5912	TEMPLATE_VBoxR0Drv_LATE_LIBS = $(VBOX_GCC_LIBGCC)
5913	# wlink thinks physdevice doesn't need fixups and should have a stack - stupid!
5914	TEMPLATE_VBoxR0Drv_LDFLAGS = -Zlinker Option -Zlinker internalrelocs, -Zlinker togglerelocs
5915	else
5916	TEMPLATE_VBoxR0Drv_TOOL = OPENWATCOM
5917	TEMPLATE_VBoxR0Drv_CTOOL = OPENWATCOM
5918	TEMPLATE_VBoxR0Drv_CXXTOOL = OPENWATCOM
5919	TEMPLATE_VBoxR0Drv_LDTOOL = OPENWATCOM-WL
5920	TEMPLATE_VBoxR0Drv_ARTOOL = OPENWATCOM
5921	## @todo see if we can eliminate this one...
5922	TEMPLATE_VBoxR0Drv_ASTOOL = NASM
5923	TEMPLATE_VBoxR0Drv_ASFLAGS = -fobj -DASM_FORMAT_OMF -D__NASM__ -w+orphan-labels #-g -F borland
5924	TEMPLATE_VBoxR0Drv_DEFS.os2 = #_OS2EMX_H
5925	TEMPLATE_VBoxR0Drv_INCS = \
5926	$(PATH_TOOL_OPENWATCOM)/h \
5927	$(PATH_TOOL_OPENWATCOM)/h/os2 \
5928	$(PATH_ROOT)/include \
5929	$(PATH_KLIBC_TRUNK)/libc/include # for os2ddk
5930	TEMPLATE_VBoxR0Drv_CFLAGS = -s -ze -w4 -hd -d1+ -nt=TEXT32 -nc=CODE -4 -of+
5931	TEMPLATE_VBoxR0Drv_CXXFLAGS = -s -ze -w4 -hd -d2t -nt=TEXT32 -nc=CODE -4 -of+
5932	TEMPLATE_VBoxR0Drv_LDFLAGS = \
5933	form os2 lx physdevice \
5934	option NODefaultlibs, internalrelocs, togglerelocs \
5935	debug dwarf all #option symfile
5936	# debug codeview all option symfile - wlink generates bad info, overwritten mod dir header.
5937	endif
5938	endif
5939
5940	ifeq ($(KBUILD_TARGET),darwin)
5941	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
5942	TEMPLATE_VBoxR0Drv_SDKS += $(VBOX_DARWIN_DEF_SDK_SDKS)
5943	TEMPLATE_VBoxR0Drv_DEFS += $(VBOX_DARWIN_DEF_SDK_DEFS) KERNEL KERNEL_PRIVATE DRIVER_PRIVATE APPLE NeXT
5944	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO)
5945	TEMPLATE_VBoxR0Drv_INCS += \
5946	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/Kernel.framework/PrivateHeaders \
5947	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/Kernel.framework/Headers
5948	## @todo try use VBOX_GCC_PEDANTIC_CXX
5949	TEMPLATE_VBoxR0Drv_CXXFLAGS = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS) \
5950	-g $(VBOX_GCC_pipe) $(VBOX_GCC_WARN) -Wno-long-long $(VBOX_GCC_fdiagnostics-show-option) \
5951	-fno-common -nostdinc -fno-builtin -finline $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) \
5952	-fno-keep-inline-functions -fno-exceptions -msoft-float \
5953	-fapple-kext -fno-rtti -fcheck-new -force_cpusubtype_ALL \
5954	$(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fasm-blocks
5955	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = -m64 -mkernel -mno-red-zone -gdwarf-2
5956	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = -m32 -static
5957	TEMPLATE_VBoxR0Drv_CFLAGS = $(VBOX_DARWIN_DEF_SDK_CFLAGS) \
5958	-g $(VBOX_GCC_pipe) $(VBOX_GCC_WARN) -Wno-long-long -fno-common -nostdinc -fno-builtin -finline \
5959	-fno-keep-inline-functions -fno-exceptions $(VBOX_GCC_fvisibility-hidden) -msoft-float \
5960	-Wmissing-prototypes -Wstrict-prototypes -Wmissing-declarations \
5961	-Werror-implicit-function-declaration -force_cpusubtype_ALL \
5962	$(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fasm-blocks
5963	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -mkernel -mno-red-zone -gdwarf-2
5964	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -static
5965	TEMPLATE_VBoxR0Drv_LDFLAGS = $(filter-out $(VBOX_DARWIN_NO_COMPACT_LINKEDIT),$(VBOX_DARWIN_DEF_SDK_LDFLAGS)) \
5966	-nostdlib -Wl,-kext,-new_linker -Wl,-Y,1455 -keep_private_extern
5967	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = -m64
5968	TEMPLATE_VBoxR0Drv_LDFLAGS.x86 = -m32
5969	TEMPLATE_VBoxR0Drv_LATE_LIBS = kmodc++ kmod cc_kext cpp_kext $(VBOX_GCC_LIBGCC)
5970	else
5971	# Note xcode uses -fstrict-aliasing, we currently don't dare... We also add -mno-red-zone.
5972	TEMPLATE_VBoxR0Drv_INCS += \
5973	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/Kernel.framework/PrivateHeaders \
5974	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/Kernel.framework/Headers
5975	## @todo try use VBOX_GCC_PEDANTIC_CXX
5976	# -Wno-c++11-extensions -Wno-c99-extensions -Wno-extra-semi -Wno-zero-length-array
5977	TEMPLATE_VBoxR0Drv_CXXFLAGS = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS) -mkernel \
5978	-g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) -Wno-long-long $(VBOX_GCC_fdiagnostics-show-option) \
5979	-Wno-c++11-extensions -Wno-c99-extensions -Wno-extra-semi -Wno-zero-length-array \
5980	-Wno-gnu-zero-variadic-macro-arguments -Wno-four-char-constants \
5981	-fno-common -nostdinc -fno-builtin $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) \
5982	-fno-exceptions -fapple-kext -fno-rtti -mkernel \
5983	-fmodules -fmodules-prune-interval=86400 -fmodules-prune-after=345600 -Wnon-modular-include-in-framework-module \
5984	-Werror=non-modular-include-in-framework-module \
5985	$(VBOX_GCC_Wno-nullability-extension) $(VBOX_GCC_Wno-gnu-statement-expression) \
5986	$(VBOX_GCC_Wno-import-preprocessor-directive-pedantic) $(VBOX_GCC_Wno-c11-extensions) \
5987	$(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fasm-blocks -fno-strict-aliasing -stdlib=libc++
5988	# if1of ($(VBOX_GCC_TOOL), CLANGXXMACHO) ## @todo check if we can safely use $(VBOX_GCC_std) @bugref{9790}, good for noexcept.
5989	#TEMPLATE_VBoxR0Drv_CXXFLAGS += $(VBOX_GCC_std)
5990	# endif
5991	# also used by xcode 6.2: \
5992	# -Werror=return-type \
5993	# -Werror=deprecated-objc-isa-usage \
5994	# -Werror=objc-root-class \
5995	# -Wno-missing-field-initializers -Wno-missing-prototypes -Wunreachable-code \
5996	# -Wno-overloaded-virtual -Wno-exit-time-destructors -Wno-missing-braces -Wparentheses -Wswitch -Wunused-function \
5997	# -Wno-unused-label -Wno-unused-parameter -Wunused-variable -Wunused-value -Wempty-body \
5998	# -Wconditional-uninitialized -Wno-unknown-pragmas -Wno-shadow -Wno-four-char-constants \
5999	# -Wno-conversion -Wconstant-conversion -Wint-conversion -Wbool-conversion -Wenum-conversion \
6000	# -Wshorten-64-to-32 -Wno-newline-eof -Wno-c++11-extensions -Wdeprecated-declarations -Winvalid-offsetof -Wno-sign-conversion
6001	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = -m64 -msoft-float -mno-red-zone
6002	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = -m32 -msoft-float
6003	TEMPLATE_VBoxR0Drv_CXXFLAGS.arm64 = -m64 -fno-sanitize=vptr -target arm64e-apple-macos11.0
6004	TEMPLATE_VBoxR0Drv_CFLAGS = $(VBOX_DARWIN_DEF_SDK_CFLAGS) -mkernel \
6005	-g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) -Wno-long-long $(VBOX_GCC_fdiagnostics-show-option) \
6006	-fno-common -nostdinc -fno-builtin $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) \
6007	-fno-exceptions -fapple-kext -fno-rtti \
6008	-fmodules -fmodules-prune-interval=86400 -fmodules-prune-after=345600 -Wnon-modular-include-in-framework-module \
6009	-Werror=non-modular-include-in-framework-module $(VBOX_GCC_Wno-c11-extensions) \
6010	$(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fasm-blocks -fno-strict-aliasing
6011	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -msoft-float -mno-red-zone
6012	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -msoft-float
6013	TEMPLATE_VBoxR0Drv_CFLAGS.arm64 = -m64 -fno-sanitize=vptr -target arm64e-apple-macos11.0
6014	if 1
6015	TEMPLATE_VBoxR0Drv_CFLAGS += $(VBOX_GCC_WERR)
6016	TEMPLATE_VBoxR0Drv_CXXFLAGS += $(VBOX_GCC_WERR)
6017	endif
6018	TEMPLATE_VBoxR0Drv_LDFLAGS = $(filter-out $(VBOX_DARWIN_NO_COMPACT_LINKEDIT),$(VBOX_DARWIN_DEF_SDK_LDFLAGS)) \
6019	-nostdlib -stdlib=libc++ -Wl,-kext -Wl,-keep_private_externs
6020	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = -m64
6021	TEMPLATE_VBoxR0Drv_LDFLAGS.arm64 = -m64
6022	TEMPLATE_VBoxR0Drv_LDFLAGS.x86 = -m32
6023	TEMPLATE_VBoxR0Drv_LATE_LIBS = kmodc++ kmod cc_kext
6024	endif
6025	endif
6026
6027	ifeq ($(KBUILD_TARGET),solaris)
6028	## The Solaris /usr/platform/i86pc/include and /usr/include directories.
6029	VBOX_SOLARIS_SYS_INCS ?= /usr/platform/i86pc/include /usr/include
6030
6031	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
6032	TEMPLATE_VBoxR0Drv_DEFS += _MACHDEP _KERNEL _STRICT_STDC
6033	if $(VBOX_GCC_VERSION_CC) < 30400
6034	TEMPLATE_VBoxR0Drv_DEFS += RT_WITHOUT_PRAGMA_ONCE
6035	endif
6036	TEMPLATE_VBoxR0Drv_INCS = $(VBOX_SOLARIS_SYS_INCS)
6037	TEMPLATE_VBoxR0Drv_LDFLAGS = -r -dy
6038	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = $(if $(eq $(KBUILD_HOST),solaris),-64,-m elf_x86_64)
6039	# Exclude -Wall because of solaris headers' pragma ident warnings that gcc refuses to supress.
6040	TEMPLATE_VBoxR0Drv_CFLAGS = -Wpointer-arith -Winline $(VBOX_GCC_Wno-pointer-sign) \
6041	-Wmissing-prototypes -Wstrict-prototypes $(VBOX_GCC_fdiagnostics-show-option) \
6042	-Wshadow -Wuninitialized -Wunused-function -Wunused-label -Wunused-value -Wunused-variable \
6043	-Wformat -Wimplicit-int -Wimplicit-function-declaration -Werror-implicit-function-declaration -Wparentheses \
6044	-O2 -fno-omit-frame-pointer -ffreestanding -nodefaultlibs -fno-strict-aliasing -fno-common -std=c99
6045	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
6046	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -mno-sse -mno-mmx -mno-sse2 -mno-3dnow $(VBOX_GCC_msave-args) \
6047	-mno-red-zone -mcmodel=kernel $(if-expr defined(VBOX_GCC_USING_SOLARIS_AS),-Wa$(COMMA)-xmodel=kernel,) \
6048	-fno-reorder-blocks -fno-asynchronous-unwind-tables -funit-at-a-time
6049	TEMPLATE_VBoxR0Drv_CXXFLAGS = -Wpointer-arith \
6050	-Wshadow -Wuninitialized -Wunused-function -Wunused-label -Wunused-value -Wunused-variable -Wformat \
6051	-O2 -nodefaultlibs -fno-omit-frame-pointer -fno-strict-aliasing -fno-common -fno-exceptions -fno-rtti
6052	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.x86)
6053	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = $(TEMPLATE_VBoxR0Drv_CFLAGS.amd64)
6054	TEMPLATE_VBoxR0Drv_POST_CMDS = $(VBOX_SIGN_DRIVER_CMDS)
6055	endif # Solaris
6056
6057	ifeq ($(KBUILD_TARGET),freebsd)
6058	# x86 FreeBSD (6.2 or something):
6059	# cc -O2 -fno-strict-aliasing -pipe -Werror -D_KERNEL -DKLD_MODULE \
6060	# -nostdinc -I- -I. -I@ -I@/contrib/altq -I@/../include -I/usr/include \
6061	# -finline-limit=8000 -fno-common -mno-align-long-strings -mpreferred-stack-boundary=2 \
6062	# -mno-mmx -mno-3dnow -mno-sse -mno-sse2 -ffreestanding -Wall -Wredundant-decls -Wnested-externs \
6063	# -Wstrict-prototypes -Wmissing-prototypes -Wpointer-arith -Winline -Wcast-qual -fformat-extensions \
6064	# -std=c99 -c ../my.c
6065	# ld -d -warn-common -r -d -o my.kld my.o
6066	# :> export_syms
6067	# awk -f /usr/src/sys/modules/my/../../conf/kmod_syms.awk my.kld export_syms \| xargs -J% objcopy % my.kld
6068	# ld -Bsharable -d warn-commnon -o my.ko my.kld
6069	#
6070	# AMD64 FreeBSD (7.1):
6071	# cc -O2 -fno-strict-aliasing -pipe -D_KERNEL -DKLD_MODULE -std=c99 -nostdinc -I. -I@ -I@/contrib/altq \
6072	# -finline-limit=8000 --param inline-unit-growth=100 --param large-function-growth=1000 -fno-common \
6073	# -fno-omit-frame-pointer -mcmodel=kernel -mno-red-zone -mfpmath=387 -mno-sse -mno-sse2 -mno-mmx \
6074	# -mno-3dnow -msoft-float -fno-asynchronous-unwind-tables -ffreestanding \
6075	# -Wall -Wredundant-decls -Wnested-externs -Wstrict-prototypes -Wmissing-prototypes -Wpointer-arith -Winline -Wcast-qual -Wundef -Wno-pointer-sign \
6076	# -fformat-extensions -c /usr/src/sys/modules/my/../../dev/my/if_my.c
6077	# ld -d -warn-common -r -d -o if_my.ko if_my.o
6078	# :> export_syms
6079	# awk -f /usr/src/sys/modules/my/../../conf/kmod_syms.awk if_my.ko export_syms \| xargs -J% objcopy % if_my.ko
6080
6081	# Note: @ -> /usr/src/sys and machine -> /usr/src/sys/i386/include
6082
6083	## The location of the FreeBSD kernel source.
6084	VBOX_FREEBSD_SRC ?= /usr/src/sys
6085	## The FreeBSD /usr/include.
6086	VBOX_FREEBSD_SYS_INCS ?= /usr/include
6087
6088	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
6089	TEMPLATE_VBoxR0Drv_LDTOOL = FreeBsdKModLd
6090	TEMPLATE_VBoxR0Drv_DEFS += _KERNEL KLD_MODULE
6091	if $(VBOX_GCC_VERSION_CC) < 30400
6092	TEMPLATE_VBoxR0Drv_DEFS += RT_WITHOUT_PRAGMA_ONCE
6093	endif
6094	TEMPLATE_VBoxR0Drv_INCS = \
6095	$(VBOX_FREEBSD_SRC) \
6096	$(VBOX_FREEBSD_SRC)/contrib/altq \
6097	$(VBOX_FREEBSD_SRC)/contrib/ck/include \
6098	$(VBOX_FREEBSD_SRC)/../include \
6099	$(VBOX_FREEBSD_SYS_INCS)
6100	# omitting: -Wcast-qual, -Wredundant-decls
6101	TEMPLATE_VBoxR0Drv_CFLAGS = \
6102	$(VBOX_GCC_WARN) -Wpointer-arith -Winline $(VBOX_GCC_Wno-pointer-sign) $(VBOX_GCC_fdiagnostics-show-option) \
6103	-Wstrict-prototypes -Wmissing-prototypes -Wstrict-prototypes \
6104	-Wimplicit-function-declaration -Werror-implicit-function-declaration \
6105	-O2 -ffreestanding -fno-strict-aliasing -fno-common \
6106	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) \
6107	-nostdinc -std=c99
6108	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -mno-align-long-strings -mno-mmx -mno-3dnow -mno-sse -mno-sse2
6109	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -fno-omit-frame-pointer -mcmodel=kernel -mno-red-zone -mfpmath=387 \
6110	-mno-sse -mno-sse2 -mno-mmx -mno-3dnow -msoft-float -fno-asynchronous-unwind-tables -Wundef
6111	TEMPLATE_VBoxR0Drv_CXXFLAGS = -fno-exceptions -fno-rtti \
6112	$(VBOX_GCC_WARN) -Wpointer-arith -Winline \
6113	-O2 -fno-strict-aliasing -fno-common \
6114	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) \
6115	-nostdinc
6116	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.x86)
6117	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = $(TEMPLATE_VBoxR0Drv_CFLAGS.amd64)
6118	TEMPLATE_VBoxR0Drv_SYSSUFF = .ko
6119	TEMPLATE_VBoxR0Drv_LDFLAGS = -d --warn-common
6120	TEMPLATE_VBoxR0Drv_LDFLAGS.x86 = -m elf_i386_fbsd
6121	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = -m elf_x86_64_fbsd
6122
6123	TOOL_FreeBsdKModLd = FreeBSD kernel module linker.
6124	# See kBuild/tools/GCC3.kmk for docs.
6125	TOOL_FreeBsdKModLd_LINK_SYSMOD_OUTPUT_MAYBE = $(outbase).map
6126	TOOL_FreeBsdKModLd_LINK_SYSMOD_DEPEND = $(foreach lib,$(libs),$(if $(findstring $(lib),$(subst /,x,$(lib))),, $(lib)))
6127	TOOL_FreeBsdKModLd_LINK_SYSMOD_DEPORD =
6128	ifeq ($(KBUILD_TARGET_ARCH),amd64)
6129	TOOL_FreeBsdKModLd_LINK_SYSMOD_OUTPUT =
6130	define TOOL_FreeBsdKModLd_LINK_SYSMOD_CMDS
6131	# Link intermediate .kld (a relocatable object).
6132	ld $(flags) -r -o $(out) $(objs) \
6133	$(foreach p,$(libpath), -L$(p))\
6134	$(foreach lib,$(libs), $(if $(findstring $(lib),$(subst /,x,$(lib))), -l$(patsubst lib%,%,$(basename $(lib))), $(lib)))
6135	# Strip non-exported symbols private and localize the exported ones.
6136	awk -f $(VBOX_FREEBSD_SRC)/conf/kmod_syms.awk $(out) $(if $(othersrc), $(othersrc),/dev/null) \
6137	\| xargs -J% objcopy % $(out)
6138
6139	## Strip debug info (comment out if debugging or something).
6140	objcopy --strip-debug $(out)
6141	endef
6142	else # x86
6143	TOOL_FreeBsdKModLd_LINK_SYSMOD_OUTPUT = $(outbase).kld
6144	define TOOL_FreeBsdKModLd_LINK_SYSMOD_CMDS
6145	# Link intermediate .kld (a relocatable object).
6146	ld $(flags) -r -o $(outbase).kld $(objs) \
6147	$(foreach p,$(libpath), -L$(p))\
6148	$(foreach lib,$(libs), $(if $(findstring $(lib),$(subst /,x,$(lib))), -l$(patsubst lib%,%,$(basename $(lib))), $(lib)))
6149	# Strip non-exported symbols private and localize the exported ones.
6150	awk -f $(VBOX_FREEBSD_SRC)/conf/kmod_syms.awk $(outbase).kld $(if $(othersrc), $(othersrc),/dev/null) \
6151	\| xargs -J% objcopy % $(outbase).kld
6152
6153	# Link the final .ko (a shared object).
6154	ld $(flags) -Bshareable -o $(out) $(outbase).kld
6155	endef
6156	endif # x86
6157
6158	endif # FreeBSD
6159
6160	ifeq ($(KBUILD_TARGET),netbsd)
6161
6162	# The location of the NetBSD sources.
6163	VBOX_NETBSD_SRC ?= /usr/src
6164
6165	# NetBSD uses "i386" for 32-bit, "x86" for common 32- and 64-bit code.
6166	ifeq ($(KBUILD_TARGET_ARCH),amd64)
6167	VBOX_NETBSD_TARGET_ARCH = amd64
6168	else
6169	VBOX_NETBSD_TARGET_ARCH = i386
6170	endif
6171
6172	VBOX_NETBSD_TARGET_SRC = $(VBOX_NETBSD_SRC)/sys/arch/$(VBOX_NETBSD_TARGET_ARCH)
6173
6174	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
6175	TEMPLATE_VBoxR0Drv_DEFS += _KERNEL _MODULE
6176	if $(VBOX_GCC_VERSION_CC) < 30400
6177	TEMPLATE_VBoxR0Drv_DEFS += RT_WITHOUT_PRAGMA_ONCE
6178	endif
6179	TEMPLATE_VBoxR0Drv_INCS = \
6180	$(VBOX_NETBSD_SRC)/sys \
6181	$(VBOX_NETBSD_SRC)/common/include \
6182	$(PATH_OBJ)/netbsd/include
6183
6184	TEMPLATE_VBoxR0Drv_CFLAGS = \
6185	$(VBOX_GCC_WARN) -Wpointer-arith -Winline $(VBOX_GCC_Wno-pointer-sign) \
6186	$(VBOX_GCC_fdiagnostics-show-option) \
6187	-Wstrict-prototypes -Wmissing-prototypes -Wstrict-prototypes \
6188	-Wimplicit-function-declaration -Werror-implicit-function-declaration \
6189	-O2 -ffreestanding -fno-strict-aliasing -fno-common -finline-limit=8000 \
6190	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) \
6191	-nostdinc -std=c99 -msoft-float
6192	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -mno-mmx -mno-sse -mno-avx \
6193	-mno-fp-ret-in-387
6194	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 --param inline-unit-growth=100 \
6195	--param large-function-growth=1000 -fno-omit-frame-pointer \
6196	-mcmodel=kernel -mno-red-zone -mno-sse -mno-mmx -mno-avx \
6197	-fno-asynchronous-unwind-tables -mno-fp-ret-in-387
6198	TEMPLATE_VBoxR0Drv_CXXFLAGS = -fno-exceptions -fno-rtti \
6199	$(VBOX_GCC_WARN) -Wpointer-arith -Winline \
6200	-O2 -fno-strict-aliasing -fno-common -finline-limit=8000 \
6201	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) \
6202	-nostdinc -msoft-float
6203	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.x86)
6204	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = $(TEMPLATE_VBoxR0Drv_CFLAGS.amd64)
6205	TEMPLATE_VBoxR0Drv_SYSSUFF = .kmod
6206	TEMPLATE_VBoxR0Drv_LDFLAGS = -d --warn-common
6207	TEMPLATE_VBoxR0Drv_LDFLAGS.x86 = -m elf_i386
6208	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = -m elf_x86_64
6209
6210	# symlink kernel includes
6211	TEMPLATE_VBoxR0Drv_ORDERDEPS += \
6212	$(PATH_OBJ)/netbsd/include/$(VBOX_NETBSD_TARGET_ARCH) \
6213	$(PATH_OBJ)/netbsd/include/x86 \
6214	$(PATH_OBJ)/netbsd/include/machine
6215
6216	$$(PATH_OBJ)/netbsd/include/$(VBOX_NETBSD_TARGET_ARCH):
6217	$(QUIET)$(MKDIR) -p $(@D)
6218	$(QUIET)$(LN_SYMLINK) $(VBOX_NETBSD_TARGET_SRC)/include $@
6219
6220	$$(PATH_OBJ)/netbsd/include/x86:
6221	$(QUIET)$(MKDIR) -p $(@D)
6222	$(QUIET)$(LN_SYMLINK) $(VBOX_NETBSD_SRC)/sys/arch/x86/include $@
6223
6224	$$(PATH_OBJ)/netbsd/include/machine:
6225	$(QUIET)$(MKDIR) -p $(@D)
6226	$(QUIET)$(LN_SYMLINK) $(VBOX_NETBSD_TARGET_ARCH) $@
6227
6228	endif # NetBSD
6229
6230	ifeq ($(KBUILD_TARGET),haiku)
6231	## The Haiku include directories
6232	VBOX_HAIKU_SYS_INCS ?= /boot/develop/headers/os/kernel /boot/develop/headers/os/drivers
6233
6234	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
6235	TEMPLATE_VBoxR0Drv_LDTOOL = $(VBOX_GCC_TOOL)
6236	TEMPLATE_VBoxR0Drv_DEFS = _KERNEL_MODE=1 _STRICT_STDC IN_RING0 IN_RT_R0
6237	if $(VBOX_GCC_VERSION_CC) < 30400
6238	TEMPLATE_VBoxR0Drv_DEFS += RT_WITHOUT_PRAGMA_ONCE
6239	endif
6240	TEMPLATE_VBoxR0Drv_INCS = $(VBOX_HAIKU_SYS_INCS)
6241	#TODO: sort this out
6242	TEMPLATE_VBoxR0Drv_LDFLAGS = -shared $(VBOX_GCC_NO_UNDEFINED_R0) -dc -dy -lroot -rpath-link /boot/system/develop/lib/x86 --no-add-needed /boot/system/develop/lib/_KERNEL_ --no-add-needed /boot/system/develop/lib/haiku_version_glue.o
6243	TEMPLATE_VBoxR0Drv_CFLAGS = -fno-PIC \
6244	$(VBOX_GCC_WARN) -Wstrict-prototypes $(VBOX_GCC_Wno-pointer-sign) -Wno-sign-compare \
6245	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-common -Werror-implicit-function-declaration
6246	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
6247	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
6248	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -mno-sse -mno-mmx -mno-sse2 -mno-3dnow \
6249	-fno-reorder-blocks -ffreestanding -fno-asynchronous-unwind-tables -funit-at-a-time \
6250	-Wno-sign-compare
6251	TEMPLATE_VBoxR0Drv_CXXFLAGS = -fno-PIC -Wpointer-arith \
6252	-Wshadow -Wuninitialized -Wunused-function -Wunused-label -Wunused-value -Wunused-variable \
6253	-Wformat \
6254	-O2 -nodefaultlibs -fno-omit-frame-pointer -fno-strict-aliasing -fno-common -fno-exceptions -fno-rtti
6255	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.x86) -fno-exceptions -fno-rtti
6256	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = $(TEMPLATE_VBoxR0Drv_CFLAGS.amd64) -fno-exceptions -fno-rtti
6257	endif # Haiku
6258
6259	ifdef VBOX_WITH_VBOXDRV
6260	ifndef TEMPLATE_VBoxR0Drv_TOOL
6261	$(warning Warning: VBox Build: Target $(KBUILD_HOST) is not officially supported!)
6262	endif
6263	endif
6264
6265	ifn1of ($(KBUILD_TARGET), darwin os2 win solaris freebsd)
6266	# This doesn't work if supdrv is natively loading VMMR0.r0 et al, but
6267	# fortunately it isn't really necessary.
6268	TEMPLATE_VBoxR0Drv_CFLAGS += -include $(PATH_ROOT)/include/VBox/SUPDrvMangling.h
6269	TEMPLATE_VBoxR0Drv_CXXFLAGS += -include $(PATH_ROOT)/include/VBox/SUPDrvMangling.h
6270	TEMPLATE_VBoxR0Drv_ASDEFS += RT_MANGLER_PREFIX=VBoxHost_
6271	endif
6272
6273	ifeq ($(KBUILD_TARGET),darwin)
6274	#
6275	# A variant of VBoxR0Drv that uses the 10.10 SDK.
6276	#
6277	TEMPLATE_VBoxR0DrvOSX10.10 = VBoxR0Drv variant using the 10.10 SDK
6278	TEMPLATE_VBoxR0DrvOSX10.10_EXTENDS = VBoxR0Drv
6279	TEMPLATE_VBoxR0DrvOSX10.10_SDKS = MACOSX1010
6280	TEMPLATE_VBoxR0DrvOSX10.10_INCS = $(filter-out $(VBOX_PATH_MACOSX_SDK)/%,$(TEMPLATE_VBoxR0Drv_INCS)) \
6281	$(PATH_SDK_MACOSX1010)/System/Library/Frameworks/Kernel.framework/PrivateHeaders \
6282	$(PATH_SDK_MACOSX1010)/System/Library/Frameworks/Kernel.framework/Headers
6283	TEMPLATE_VBoxR0DrvOSX10.10_DEFS = $(filter-out $(VBOX_DARWIN_DEF_SDK_DEFS),$(TEMPLATE_VBoxR0Drv_DEFS))
6284
6285	endif
6286
6287	#
6288	# Template for building libraries used by ring-0 drivers.
6289	#
6290	TEMPLATE_VBoxR0DrvLib = VBox Ring 0 Driver Library
6291	TEMPLATE_VBoxR0DrvLib_EXTENDS = VBoxR0Drv
6292	TEMPLATE_VBoxR0DrvLib_INSTTYPE = stage
6293	TEMPLATE_VBoxR0DrvLib_INSTTYPE.linux = stage
6294
6295	#
6296	# Template for installing INF and CAT files.
6297	#
6298	TEMPLATE_VBoxR0DrvInfCat = VBox SUPDRV Ring 0 - Install .sys, .cat, .inf
6299	TEMPLATE_VBoxR0DrvInfCat_INST = $(INST_BIN)
6300	TEMPLATE_VBoxR0DrvInfCat_MODE = a+r,u+w
6301	TEMPLATE_VBoxR0DrvInfCat_IFFLAGS = --no-hard-link-files-when-possible
6302
6303
6304	#
6305	# Template for building R3 executables and static libraries which are linked into executables.
6306	# Note! This is the base template for a whole lot of other ones, so be careful when changing it.
6307	#
6308	# Disabled Visual C++ warnings:
6309	# -wd4065: switch statement contains 'default' but no 'case' labels
6310	# -wd4244: 'conversion' conversion from 'type1' to 'type2', possible loss of data
6311	# -wd4996: deprecated / insecure.
6312	#
6313	TEMPLATE_VBoxR3Exe = VBox Ring 3 Exe
6314	$(foreach arch,$(VBOX_TARGET_ARCHES)\
6315	,$(eval TEMPLATE_VBoxR3Exe_ASTOOL.$(KBUILD_TARGET).$(arch) := $(VBOX_ASTOOL.$(KBUILD_TARGET).$(arch))))
6316	$(foreach arch,$(VBOX_TARGET_ARCHES)\
6317	,$(eval TEMPLATE_VBoxR3Exe_ASFLAGS.$(KBUILD_TARGET).$(arch) = $$(VBOX_ASFLAGS.$(KBUILD_TARGET).$(arch))))
6318	TEMPLATE_VBoxR3Exe_DEFS = IN_RING3 $(VBOX_GC_ARCH_BITS_DEFS)
6319	TEMPLATE_VBoxR3Exe_DEFS.x86 = HC_ARCH_BITS=32
6320	TEMPLATE_VBoxR3Exe_DEFS.arm32 = HC_ARCH_BITS=32
6321	TEMPLATE_VBoxR3Exe_DEFS.sparc32 = HC_ARCH_BITS=32
6322	TEMPLATE_VBoxR3Exe_DEFS.amd64 = HC_ARCH_BITS=64
6323	TEMPLATE_VBoxR3Exe_DEFS.arm64 = HC_ARCH_BITS=64
6324	TEMPLATE_VBoxR3Exe_DEFS.sparc64 = HC_ARCH_BITS=64
6325	TEMPLATE_VBoxR3Exe_DEFS.win = _CRT_SECURE_NO_DEPRECATE
6326	TEMPLATE_VBoxR3Exe_USES = dtrace
6327	if defined(VBOX_WITH_DTRACE_R3) && defined(VBOX_WITH_NATIVE_DTRACE)
6328	TEMPLATE_VBoxR3Exe_DTRACETOOL = DTraceAndVBoxTpG
6329	TEMPLATE_VBoxR3Exe_DTRACE_OBJ_FLAGS = -C
6330	TEMPLATE_VBoxR3Exe_DTRACE_HDR_FLAGS = -C
6331	TEMPLATE_VBoxR3Exe_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3 VBOX_WITH_NATIVE_DTRACE
6332	else
6333	TEMPLATE_VBoxR3Exe_DTRACE_HDR_FLAGS = --ring-3-context
6334	TEMPLATE_VBoxR3Exe_DTRACE_OBJ_FLAGS = --ring-3-context --pic --probe-fn-imported --probe-fn-name "SUPTracerFireProbe"
6335	if defined(VBOX_WITH_DTRACE_R3)
6336	TEMPLATE_VBoxR3Exe_DTRACETOOL = VBoxTpG
6337	TEMPLATE_VBoxR3Exe_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3
6338	else
6339	TEMPLATE_VBoxR3Exe_DTRACETOOL = VBoxTpG-Disabled
6340	endif
6341	endif
6342	TEMPLATE_VBoxR3Exe_LATE_LIBS.kprofile = $(LIB_KPROFILE)
6343	ifeq ($(KBUILD_TARGET),win)
6344	# TEMPLATE_VBoxR3Exe_TOOL = $(VBOX_VCC_TOOL)
6345	TEMPLATE_VBoxR3Exe_TOOL.win.x86 = $(VBOX_VCC_TOOL_STEM)X86
6346	TEMPLATE_VBoxR3Exe_TOOL.win.amd64 = $(VBOX_VCC_TOOL_STEM)AMD64
6347	TEMPLATE_VBoxR3Exe_TOOL.win.arm64 = $(VBOX_VCC_TOOL_STEM)ARM64
6348	TEMPLATE_VBoxR3Exe_RCDEFS = VBOX_SVN_REV=$(VBOX_SVN_REV) VBOX_SVN_REV_MOD_5K=$(expr $(VBOX_SVN_REV) % 50000)
6349	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
6350	TEMPLATE_VBoxR3Exe_SDKS = ReorderCompilerIncs WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER) $(VBOX_WINPSDK)
6351	else
6352	TEMPLATE_VBoxR3Exe_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK)
6353	endif
6354	TEMPLATE_VBoxR3Exe_CXXFLAGS = -Zi -Zl -GR- -EHsc -GF -MD$(VBOX_VCC_CRT_TYPE) $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_OPT) $(VBOX_VCC_FP) \
6355	-Gy $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS) $(VBOX_VCC_std) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
6356	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
6357	TEMPLATE_VBoxR3Exe_CXXFLAGS += -Gw
6358	endif
6359	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
6360	TEMPLATE_VBoxR3Exe_CXXFLAGS += -Zc:inline
6361	endif
6362	ifdef VBOX_WITH_MSC_ANALYZE_THIS
6363	TEMPLATE_VBoxR3Exe_CXXFLAGS += /analyze
6364	endif
6365	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
6366	TEMPLATE_VBoxR3Exe_CXXFLAGS += /volatileMetadata-
6367	endif
6368	TEMPLATE_VBoxR3Exe_CXXFLAGS.debug = -RTCsu
6369	TEMPLATE_VBoxR3Exe_CXXFLAGS.dbgopt = $(NO_SUCH_VARIABLE)
6370	TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile = -Gh -GH
6371	TEMPLATE_VBoxR3Exe_CFLAGS = $(filter-out $(VBOX_VCC_std),$(TEMPLATE_VBoxR3Exe_CXXFLAGS))
6372	TEMPLATE_VBoxR3Exe_CFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6373	TEMPLATE_VBoxR3Exe_CFLAGS.dbgopt = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.dbgopt)
6374	TEMPLATE_VBoxR3Exe_CFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6375	TEMPLATE_VBoxR3Exe_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6376	TEMPLATE_VBoxR3Exe_PCHFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6377	TEMPLATE_VBoxR3Exe_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.dbgopt)
6378	TEMPLATE_VBoxR3Exe_PCHFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6379	TEMPLATE_VBoxR3Exe_LDFLAGS = -Ignore:4197 \
6380	/NOD /INCREMENTAL:NO /MAPINFO:EXPORTS /LargeAddressAware /DynamicBase /NxCompat /Release /Debug /Opt:Ref /Opt:Icf \
6381	$(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS) \
6382	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
6383	/STUB:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com \
6384	/DISALLOWLIB:libc.lib \
6385	/DISALLOWLIB:libcd.lib \
6386	/DISALLOWLIB:libcmt.lib \
6387	/DISALLOWLIB:libcmtd.lib \
6388	/DISALLOWLIB:msvcrt$(VBOX_VCC_CRT_TYPE_N).lib \
6389	/DISALLOWLIB:msvcprt$(VBOX_VCC_CRT_TYPE_N).lib
6390	ifdef VBOX_WITH_DTRACE_R3
6391	TEMPLATE_VBoxR3Exe_LDFLAGS += -Merge:VTGPrLc.Data=VTGPrLc.Begin -Merge:VTGPrLc.End=VTGPrLc.Begin -Merge:VTGPrLc.Begin=VTGObj
6392	endif
6393	if defined(VBOX_SIGNING_MODE) && defined(VBOX_WITH_HARDENING) && !defined(VBOX_WITHOUT_WINDOWS_KERNEL_CODE_SIGNING_CERT)
6394	TEMPLATE_VBoxR3Exe_LDFLAGS += -IntegrityCheck
6395	endif
6396	TEMPLATE_VBoxR3Exe_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
6397	TEMPLATE_VBoxR3Exe_LDFLAGS.win.arm64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
6398	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
6399	TEMPLATE_VBoxR3Exe_LDFLAGS += -EmitVolatileMetadata:NO
6400	endif
6401
6402	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
6403	TEMPLATE_VBoxR3Exe_LATE_LIBS.x86 = \
6404	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
6405	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6406	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6407	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib
6408	TEMPLATE_VBoxR3Exe_LATE_LIBS.amd64 = \
6409	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
6410	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6411	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6412	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/oldnames.lib
6413	TEMPLATE_VBoxR3Exe_LATE_LIBS.arm64 = \
6414	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.arm64)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
6415	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.arm64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6416	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.arm64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6417	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.arm64)_LIB)/oldnames.lib
6418	ifeq ($(KBUILD_TYPE),asan)
6419	TEMPLATE_VBoxR3Exe_LATE_LIBS.x86 += \
6420	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/clang_rt.asan_dynamic-i386.lib \
6421	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/clang_rt.asan_dynamic_runtime_thunk-i386.lib
6422	TEMPLATE_VBoxR3Exe_LATE_LIBS.amd64 += \
6423	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/clang_rt.asan_dynamic-x86_64.lib \
6424	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/clang_rt.asan_dynamic_runtime_thunk-x86_64.lib
6425	endif
6426	else
6427	TEMPLATE_VBoxR3Exe_LATE_LIBS.x86 = \
6428	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6429	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6430	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib
6431	TEMPLATE_VBoxR3Exe_LATE_LIBS.amd64 = \
6432	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6433	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6434	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/oldnames.lib
6435	endif
6436
6437	TEMPLATE_VBoxR3Exe_POST_CMDS = $(VBOX_UTF8_MANIFEST_CMDS)$(NLTAB)$(VBOX_SIGN_IMAGE_CMDS)
6438	TEMPLATE_VBoxR3Exe_ORDERDEPS = $(VBOX_SIGN_IMAGE_CMDS_ORDERDEPS)
6439	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
6440	TEMPLATE_VBoxR3Exe_POST_CMDS.win.x86 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION) $(out)$$(NLTAB)$(TEMPLATE_VBoxR3Exe_POST_CMDS))
6441	TEMPLATE_VBoxR3Exe_LNK_DEPS.win.x86 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION))
6442	TEMPLATE_VBoxR3Exe_LDFLAGS.win.x86 = \
6443	-Include:_vcc100_kernel32_fakes_cpp \
6444	-Include:_vcc100_kernel32_fakes_asm
6445	TEMPLATE_VBoxR3Exe_LATE_LIBS.win.x86 = \
6446	$(PATH_STAGE_LIB)/RuntimeR3VccTricks2$(VBOX_SUFF_LIB)
6447	TEMPLATE_VBoxR3Exe_LATE_LIBS.x86 = \
6448	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib \
6449	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6450	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
6451	endif
6452
6453	else # the gcc guys
6454	TEMPLATE_VBoxR3Exe_TOOL = $(VBOX_GCC_TOOL)
6455	if $(VBOX_GCC_VERSION_CC) < 30400
6456	TEMPLATE_VBoxR3Exe_DEFS += RT_WITHOUT_PRAGMA_ONCE
6457	endif
6458	TEMPLATE_VBoxR3Exe_CXXFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_OPT) \
6459	$(VBOX_GCC_FP) -fno-strict-aliasing $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_std) $(VBOX_GCC_fvisibility-inlines-hidden) \
6460	$(VBOX_GCC_IPRT_FMT_CHECK) $(VBOX_GCC_SANITIZER_FLAGS)
6461	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
6462	TEMPLATE_VBoxR3Exe_CXXFLAGS += $(VBOX_GCC_WERR)
6463	endif
6464	TEMPLATE_VBoxR3Exe_CXXFLAGS.x86 = -m32
6465	TEMPLATE_VBoxR3Exe_CXXFLAGS.amd64 = -m64
6466	TEMPLATE_VBoxR3Exe_CXXFLAGS.sparc32 = -m32
6467	TEMPLATE_VBoxR3Exe_CXXFLAGS.sparc64 = -m64
6468	TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile = -finstrument-functions
6469	TEMPLATE_VBoxR3Exe_CFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_OPT) \
6470	$(VBOX_GCC_FP) -fno-strict-aliasing $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_IPRT_FMT_CHECK)
6471	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
6472	TEMPLATE_VBoxR3Exe_CFLAGS += $(VBOX_GCC_WERR)
6473	endif
6474	TEMPLATE_VBoxR3Exe_CFLAGS.x86 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.x86)
6475	TEMPLATE_VBoxR3Exe_CFLAGS.amd64 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.amd64)
6476	TEMPLATE_VBoxR3Exe_CFLAGS.sparc32 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.sparc32)
6477	TEMPLATE_VBoxR3Exe_CFLAGS.sparc64 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.sparc64)
6478	TEMPLATE_VBoxR3Exe_CFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6479	TEMPLATE_VBoxR3Exe_CFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6480	TEMPLATE_VBoxR3Exe_OBJCFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS)
6481	TEMPLATE_VBoxR3Exe_OBJCFLAGS.x86 = $(TEMPLATE_VBoxR3Exe_CFLAGS.x86)
6482	TEMPLATE_VBoxR3Exe_OBJCFLAGS.amd64 = $(TEMPLATE_VBoxR3Exe_CFLAGS.amd64)
6483	TEMPLATE_VBoxR3Exe_OBJCFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CFLAGS.debug)
6484	TEMPLATE_VBoxR3Exe_OBJCFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CFLAGS.kprofile)
6485	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6486	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.x86 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.x86)
6487	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.amd64 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.amd64)
6488	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6489	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6490	TEMPLATE_VBoxR3Exe_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6491	TEMPLATE_VBoxR3Exe_PCHFLAGS.x86 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.x86)
6492	TEMPLATE_VBoxR3Exe_PCHFLAGS.amd64 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.amd64)
6493	TEMPLATE_VBoxR3Exe_PCHFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6494	TEMPLATE_VBoxR3Exe_PCHFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6495	TEMPLATE_VBoxR3Exe_LDFLAGS = $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS)
6496	TEMPLATE_VBoxR3Exe_LDFLAGS.x86 = -m32
6497	TEMPLATE_VBoxR3Exe_LDFLAGS.amd64 = -m64
6498	TEMPLATE_VBoxR3Exe_LDFLAGS.sparc32 = -m32
6499	TEMPLATE_VBoxR3Exe_LDFLAGS.sparc64 = -m64
6500	TEMPLATE_VBoxR3Exe_LDFLAGS.linux = -Wl,-z,noexecstack,-z,relro $(VBOX_LD_as_needed)
6501	TEMPLATE_VBoxR3Exe_LDFLAGS.solaris = -Wl,-z,ignore # same as VBOX_LD_as_needed
6502
6503	ifeq ($(KBUILD_TARGET),linux)
6504	TEMPLATE_VBoxR3Exe_LATE_LIBS = pthread m rt dl
6505	else ifeq ($(KBUILD_TARGET),os2)
6506	TEMPLATE_VBoxR3Exe_TOOL = GXX3OMF
6507	TEMPLATE_VBoxR3Exe_LATE_LIBS = socket iconv
6508	else ifeq ($(KBUILD_TARGET),darwin)
6509	TEMPLATE_VBoxR3Exe_TOOL = $(VBOX_GCC_TOOL)
6510	TEMPLATE_VBoxR3Exe_LATE_LIBS =
6511	TEMPLATE_VBoxR3Exe_DEFS += LIBICONV_PLUG # Avoid 3rd party libiconv (from macports).
6512	TEMPLATE_VBoxR3Exe_SDKS.darwin = $(VBOX_DARWIN_DEF_SDK_SDKS)
6513	TEMPLATE_VBoxR3Exe_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_DEFS)
6514	TEMPLATE_VBoxR3Exe_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CFLAGS) -fno-common
6515	TEMPLATE_VBoxR3Exe_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
6516	TEMPLATE_VBoxR3Exe_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
6517	TEMPLATE_VBoxR3Exe_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_OBJCFLAGS)
6518	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS)
6519	TEMPLATE_VBoxR3Exe_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -Wl,-headerpad_max_install_names
6520	TEMPLATE_VBoxR3Exe_LDFLAGS.darwin.x86 = -read_only_relocs suppress
6521	TEMPLATE_VBoxR3Exe_POST_CMDS.darwin = $(VBOX_SIGN_IMAGE_CMDS)
6522	ifdef VBOX_WITH_DTRACE_R3
6523	TEMPLATE_VBoxR3Exe_CXXFLAGS := $(filter-out -pedantic,$(TEMPLATE_VBoxR3Exe_CXXFLAGS)) -fdollars-in-identifiers # annoying gcc option precedence.
6524	endif
6525	else ifeq ($(KBUILD_TARGET),haiku)
6526	TEMPLATE_VBoxR3Exe_TOOL = GXX3
6527	TEMPLATE_VBoxR3Exe_POST_CMDS = $(VBOX_HAIKU_XRES_SETVER_CMDS)
6528	TEMPLATE_VBoxR3Exe_LATE_LIBS = network iconv stdc++ supc++
6529	TEMPLATE_VBoxR3Exe_LIBPATH += \
6530	/boot/common/lib
6531	# Haiku uses PIC by default...
6532	TEMPLATE_VBoxR3Exe_CFLAGS += -fno-pic
6533	TEMPLATE_VBoxR3Exe_CXXFLAGS += -fno-pic
6534	TEMPLATE_VBoxR3Exe_LDFLAGS += -fno-pic
6535	else if1of ($(KBUILD_TARGET), freebsd openbsd)
6536	TEMPLATE_VBoxR3Exe_TOOL = GXX3
6537	TEMPLATE_VBoxR3Exe_LATE_LIBS = pthread
6538	TEMPLATE_VBoxR3Exe_INCS += \
6539	/usr/include \
6540	/usr/X11R6/include \
6541	/usr/local/include
6542	TEMPLATE_VBoxR3Exe_LIBPATH += \
6543	/usr/lib \
6544	/usr/X11R6/lib \
6545	/usr/local/lib
6546	else ifeq ($(KBUILD_TARGET),netbsd)
6547	TEMPLATE_VBoxR3Exe_TOOL = GXX3
6548	TEMPLATE_VBoxR3Exe_LATE_LIBS = pthread
6549	TEMPLATE_VBoxR3Exe_INCS += \
6550	/usr/include \
6551	/usr/X11R7/include
6552	TEMPLATE_VBoxR3Exe_LIBPATH += \
6553	/usr/lib \
6554	/usr/X11R7/lib
6555	else ifeq ($(KBUILD_TARGET),solaris)
6556	TEMPLATE_VBoxR3Exe_TOOL = GXX3PLAIN
6557	TEMPLATE_VBoxR3Exe_DEFS += LIBICONV_PLUG _REENTRANT # Avoid the GNU libiconv, for now at least.
6558	if $(VBOX_GCC_VERSION_CC) < 30500
6559	TEMPLATE_VBoxR3Exe_CFLAGS += -std=gnu99
6560	endif
6561	TEMPLATE_VBoxR3Exe_LATE_LIBS = rt socket
6562	else
6563	$(warning Warning: VBOX Build: Target $(KBUILD_TARGET) is not officially supported!)
6564	TEMPLATE_VBoxR3Exe_CXXFLAGS.profile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.release)
6565	TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.krelease)
6566	endif
6567	ifdef VBOX_WITH_RUNPATH
6568	TEMPLATE_VBoxR3Exe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)'
6569	else ifdef VBOX_WITH_RELATIVE_RUNPATH
6570	TEMPLATE_VBoxR3Exe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)'
6571	endif
6572	ifdef VBOX_WITH_ORIGIN
6573	TEMPLATE_VBoxR3Exe_LDFLAGS.linux += $(VBOX_GCC_ORIGIN_OPT)
6574	endif
6575	endif
6576
6577	#
6578	# Template for building R3 shared objects / DLLs - base template, don't use directly.
6579	# This is mostly identical to the VBoxR3Exe template. (Avoid PIC if possible!)
6580	#
6581	## @todo Eliminate VBoxR3DllBase in favor of VBoxR3Dll.
6582	TEMPLATE_VBoxR3DllBase = VBox Ring 3 SO/DLLs Base Template - do not use directly!
6583	TEMPLATE_VBoxR3DllBase_EXTENDS = VBoxR3Exe
6584	TEMPLATE_VBoxR3DllBase_DEFS.darwin = $(TEMPLATE_VBoxR3Exe_DEFS.darwin) PIC
6585	TEMPLATE_VBoxR3DllBase_LDFLAGS.darwin = $(TEMPLATE_VBoxR3Exe_LDFLAGS.darwin) \
6586	-current_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
6587	-compatibility_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
6588	ifn1of ($(KBUILD_TARGET), darwin win os2)
6589	TEMPLATE_VBoxR3DllBase_DEFS = $(TEMPLATE_VBoxR3Exe_DEFS) PIC
6590	TEMPLATE_VBoxR3DllBase_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) -fPIC
6591	TEMPLATE_VBoxR3DllBase_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) -fPIC
6592	TEMPLATE_VBoxR3DllBase_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS) -fPIC
6593	TEMPLATE_VBoxR3DllBase_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS) -fPIC
6594	endif
6595
6596	#
6597	# Temporary: Renaming the template and warnings will be errors ("soon").
6598	#
6599	TEMPLATE_VBoxR3Dll = VBox ring-3 SO/DLLs, no warnings
6600	TEMPLATE_VBoxR3Dll_EXTENDS += VBoxR3DllBase
6601	TEMPLATE_VBoxR3Dll_EXTENDS_BY += appending
6602	ifeq ($(KBUILD_TARGET),win)
6603	TEMPLATE_VBoxR3Dll_CFLAGS += $(VBOX_VCC_WERR)
6604	TEMPLATE_VBoxR3Dll_CXXFLAGS += $(VBOX_VCC_WERR)
6605	TEMPLATE_VBoxR3Dll_PCHFLAGS += $(VBOX_VCC_WERR)
6606	TEMPLATE_VBoxR3Dll_LDFLAGS += $(VBOX_VCC_LD_WERR)
6607	else
6608	TEMPLATE_VBoxR3Dll_CFLAGS += $(VBOX_GCC_WERR)
6609	TEMPLATE_VBoxR3Dll_CXXFLAGS += $(VBOX_GCC_WERR)
6610	TEMPLATE_VBoxR3Dll_PCHFLAGS += $(VBOX_GCC_WERR)
6611	endif
6612
6613	# x86 edition of the above template for use on AMD64 targets.
6614	TEMPLATE_VBoxR3Dll-x86 = 32-bit VBox ring-3 SO/DLLs, no warnings
6615	TEMPLATE_VBoxR3Dll-x86_EXTENDS = VBoxR3Dll
6616	TEMPLATE_VBoxR3Dll-x86_BLD_TRG_ARCH = x86
6617	TEMPLATE_VBoxR3Dll-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxR3Dll_DEFS)) \
6618	HC_ARCH_BITS=32 ARCH_BITS=32
6619
6620
6621	#
6622	# Template for building performance critical stuff with warnings-as-errors.
6623	#
6624	TEMPLATE_VBoxR3DllNoPic = VBox ring-3 SO/DLLs without PIC, without warnings.
6625	TEMPLATE_VBoxR3DllNoPic_EXTENDS = VBoxR3DllBase
6626	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), linux.x86 freebsd.x86)
6627	TEMPLATE_VBoxR3DllNoPic_DEFS = $(TEMPLATE_VBoxR3Exe_DEFS)
6628	TEMPLATE_VBoxR3DllNoPic_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) $(VBOX_GCC_WERR)
6629	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) $(VBOX_GCC_WERR)
6630	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) $(VBOX_GCC_WERR)
6631	TEMPLATE_VBoxR3DllNoPic_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS)
6632	else ifeq ($(KBUILD_TARGET),win)
6633	TEMPLATE_VBoxR3DllNoPic_CFLAGS = $(filter-out -W3 -wd%,$(TEMPLATE_VBoxR3DllBase_CFLAGS)) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
6634	TEMPLATE_VBoxR3DllNoPic_CFLAGS.debug = $(filter-out -RTC%,$(TEMPLATE_VBoxR3DllBase_CFLAGS.debug))
6635	TEMPLATE_VBoxR3DllNoPic_CFLAGS.release = $(TEMPLATE_VBoxR3DllBase_CFLAGS.release) -GS-
6636	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS = $(filter-out -W3 -wd%,$(TEMPLATE_VBoxR3DllBase_CXXFLAGS)) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
6637	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS.debug = $(filter-out -RTC%,$(TEMPLATE_VBoxR3DllBase_CXXFLAGS.debug)) # RTCsu Prevents IEM opt.
6638	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS.release = $(TEMPLATE_VBoxR3DllBase_CXXFLAGS.release) -GS-
6639	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS = $(filter-out -W3 -wd%,$(TEMPLATE_VBoxR3DllBase_PCHFLAGS)) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
6640	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS.debug = $(filter-out -RTC%,$(TEMPLATE_VBoxR3DllBase_PCHFLAGS.debug)) # RTCsu Prevents IEM opt.
6641	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS.release = $(TEMPLATE_VBoxR3DllBase_PCHFLAGS.release) -GS-
6642	TEMPLATE_VBoxR3DllNoPic_LDFLAGS = $(TEMPLATE_VBoxR3DllBase_LDFLAGS) $(VBOX_VCC_LD_WERR)
6643	else
6644	TEMPLATE_VBoxR3DllNoPic_CFLAGS = $(TEMPLATE_VBoxR3DllBase_CFLAGS) $(VBOX_GCC_WERR)
6645	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS = $(TEMPLATE_VBoxR3DllBase_CXXFLAGS) $(VBOX_GCC_WERR)
6646	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS = $(TEMPLATE_VBoxR3DllBase_PCHFLAGS) $(VBOX_GCC_WERR)
6647	endif
6648
6649	# x86 edition of the above template for use on AMD64 targets.
6650	TEMPLATE_VBoxR3DllNoPic-x86 = 32-bit VBox ring-3 SO/DLLs without PIC, without warnings.
6651	TEMPLATE_VBoxR3DllNoPic-x86_EXTENDS = VBoxR3DllNoPic
6652	TEMPLATE_VBoxR3DllNoPic-x86_BLD_TRG_ARCH = x86
6653	TEMPLATE_VBoxR3DllNoPic-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxR3DllNoPic_DEFS)) \
6654	HC_ARCH_BITS=32 ARCH_BITS=32
6655
6656
6657	#
6658	# Template for building performance critical stuff without warnings-as-errors.
6659	#
6660	TEMPLATE_VBoxR3DllWarnNoPic = VBox ring-3 SO/DLLs without PIC, with warnings.
6661	TEMPLATE_VBoxR3DllWarnNoPic_EXTENDS = VBoxR3DllBase
6662	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), linux.x86 freebsd.x86)
6663	TEMPLATE_VBoxR3DllWarnNoPic_DEFS = $(TEMPLATE_VBoxR3Exe_DEFS)
6664	TEMPLATE_VBoxR3DllWarnNoPic_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS)
6665	TEMPLATE_VBoxR3DllWarnNoPic_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6666	TEMPLATE_VBoxR3DllWarnNoPic_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS)
6667	TEMPLATE_VBoxR3DllWarnNoPic_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS)
6668	else ifeq ($(KBUILD_TARGET),win)
6669	TEMPLATE_VBoxR3DllWarnNoPic_CFLAGS.release = $(TEMPLATE_VBoxR3DllBase_CFLAGS.release) -GS-
6670	TEMPLATE_VBoxR3DllWarnNoPic_CXXFLAGS.release = $(TEMPLATE_VBoxR3DllBase_CXXFLAGS.release) -GS-
6671	TEMPLATE_VBoxR3DllWarnNoPic_PCHFLAGS.release = $(TEMPLATE_VBoxR3DllBase_PCHFLAGS.release) -GS-
6672	endif
6673
6674	#
6675	# Base template for building static R3 executables and any static
6676	# libraries they link with. Do _not_ use directly!
6677	#
6678	## @todo Bake this into VBoxR3Static.
6679	TEMPLATE_VBoxR3StaticBase = VBox Static Ring 3 EXE
6680	TEMPLATE_VBoxR3StaticBase_EXTENDS = VBoxR3Exe
6681	TEMPLATE_VBoxR3StaticBase_DEFS = IN_RT_STATIC IN_RT_R3 IN_SUP_STATIC $(TEMPLATE_VBoxR3Exe_DEFS)
6682	ifdef VBOX_WITH_NOCRT_STATIC
6683	TEMPLATE_VBoxR3StaticBase_DEFS += IPRT_NO_CRT
6684	TEMPLATE_VBoxR3StaticBase_INCS = $(PATH_ROOT)/include/iprt/nocrt $(TEMPLATE_VBoxR3Exe_INCS)
6685	endif
6686	ifeq ($(KBUILD_TARGET),win)
6687	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
6688	ifdef VBOX_WITH_NOCRT_STATIC
6689	TEMPLATE_VBoxR3StaticBase_SDKS = $(subst WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER),,$(TEMPLATE_VBoxR3Exe_SDKS))
6690	else
6691	TEMPLATE_VBoxR3StaticBase_SDKS = $(subst WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER), WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC,$(TEMPLATE_VBoxR3Exe_SDKS))
6692	endif
6693	endif
6694	ifdef VBOX_WITH_NOCRT_STATIC
6695	TEMPLATE_VBoxR3StaticBase_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE) -EHsc -GR, $(TEMPLATE_VBoxR3Exe_CFLAGS)) \
6696	-Zl -EHc-s- -Gy -GR-
6697	TEMPLATE_VBoxR3StaticBase_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE) -EHsc -GR, $(TEMPLATE_VBoxR3Exe_CXXFLAGS)) \
6698	-Zl -EHc-s- -Gy -GR-
6699	TEMPLATE_VBoxR3StaticBase_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE) -EHsc -GR, $(TEMPLATE_VBoxR3Exe_PCHFLAGS)) \
6700	-Zl -EHc-s- -Gy -GR-
6701	else
6702	TEMPLATE_VBoxR3StaticBase_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Exe_CFLAGS)) \
6703	-MT$(VBOX_VCC_CRT_TYPE) -Gy
6704	TEMPLATE_VBoxR3StaticBase_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Exe_CXXFLAGS)) \
6705	-MT$(VBOX_VCC_CRT_TYPE) -Gy
6706	TEMPLATE_VBoxR3StaticBase_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Exe_PCHFLAGS)) \
6707	-MT$(VBOX_VCC_CRT_TYPE) -Gy
6708	endif
6709
6710	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120" # Do not use SSE so valkit stuff can run on NT4 w/o needing a separate runtime library.
6711	TEMPLATE_VBoxR3StaticBase_CFLAGS.win.x86 = $(TEMPLATE_VBoxR3Exe_CFLAGS.win.86) /arch:IA32
6712	TEMPLATE_VBoxR3StaticBase_CXXFLAGS.win.x86 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.win.86) /arch:IA32
6713	TEMPLATE_VBoxR3StaticBase_PCHFLAGS.win.x86 = $(TEMPLATE_VBoxR3Exe_PCHFLAGS.win.86) /arch:IA32
6714	TEMPLATE_VBoxR3StaticBase_CFLAGS += -Gw
6715	TEMPLATE_VBoxR3StaticBase_CXXFLAGS += -Gw
6716	TEMPLATE_VBoxR3StaticBase_PCHFLAGS += -Gw
6717	endif
6718
6719	ifdef VBOX_WITH_NOCRT_STATIC
6720	# .0000cfg normally merges into .idata, but the linker won't let us do so via /MERGE. Doesn't matter much,
6721	# because .idata can be writable when targeting x86 (NT 3.1 fun) and we don't want .0000cfg to be writable.
6722	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS) /NODEFAULTLIB /Merge:.0000cfg=.rdata
6723	else
6724	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(filter-out /DISALLOWLIB:libcmt$(VBOX_VCC_CRT_TYPE).lib /DISALLOWLIB:libcpmt$(VBOX_VCC_CRT_TYPE).lib, $(TEMPLATE_VBoxR3Exe_LDFLAGS))
6725	endif
6726	TEMPLATE_VBoxR3StaticBase_LDFLAGS += \
6727	/DISALLOWLIB:msvcrt.lib \
6728	/DISALLOWLIB:msvcrtd.lib \
6729	/DISALLOWLIB:msvcprt.lib \
6730	/DISALLOWLIB:msvcprtd.lib \
6731	/DISALLOWLIB:vcruntime.lib \
6732	/DISALLOWLIB:vcruntimed.lib \
6733	/DISALLOWLIB:ucrt.lib \
6734	/DISALLOWLIB:ucrtd.lib
6735	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
6736	ifdef VBOX_WITH_NOCRT_STATIC
6737	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.amd64 = $(NO_SUCH_VARIABLE)
6738	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.x86 = $(NO_SUCH_VARIABLE)
6739	else
6740	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.x86 = \
6741	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libvcruntime$(VBOX_VCC_CRT_TYPE).lib \
6742	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6743	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
6744	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/oldnames.lib
6745	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.amd64 = \
6746	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libvcruntime$(VBOX_VCC_CRT_TYPE).lib \
6747	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6748	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
6749	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/oldnames.lib
6750	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.arm64 = \
6751	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.arm64)_LIB)/libvcruntime$(VBOX_VCC_CRT_TYPE).lib \
6752	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.arm64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6753	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.arm64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
6754	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.arm64)_LIB)/oldnames.lib
6755	endif
6756	ifeq ($(KBUILD_TYPE),asan)
6757	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.x86 += \
6758	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/clang_rt.asan-i386.lib \
6759	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/clang_rt.asan_cxx-i386.lib
6760	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.amd64 += \
6761	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/clang_rt.asan-x86_64.lib \
6762	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/clang_rt.asan_cxx-x86_64.lib
6763	endif
6764	else
6765	ifdef VBOX_WITH_NOCRT_STATIC
6766	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.amd64 = $(NO_SUCH_VARIABLE)
6767	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.x86 = $(NO_SUCH_VARIABLE)
6768	else
6769	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.x86 = \
6770	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/oldnames.lib \
6771	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6772	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
6773	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.amd64 = \
6774	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6775	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
6776	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/oldnames.lib
6777	TEMPLATE_VBoxR3StaticBase_LATE_LIBS.arm64 = \
6778	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.arm64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6779	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.arm64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
6780	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.arm64)_LIB)/oldnames.lib
6781	endif
6782	endif
6783	else
6784	ifdef VBOX_WITH_NOCRT_STATIC
6785	TEMPLATE_VBoxR3StaticBase_DEFS += RT_WITH_NOCRT_WRAPPERS
6786	endif
6787	ifn1of ($(KBUILD_TARGET), darwin linux solaris)
6788	# The gcc guys sans darwin, linux and solaris (don't depend on statically compiled system libs there)
6789	TEMPLATE_VBoxR3StaticBase_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) -static
6790	TEMPLATE_VBoxR3StaticBase_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) -static
6791	TEMPLATE_VBoxR3StaticBase_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS) -static
6792	TEMPLATE_VBoxR3StaticBase_OBJCFLAGS = $(TEMPLATE_VBoxR3Exe_OBJCFLAGS) -static
6793	TEMPLATE_VBoxR3StaticBase_OBJCXXFLAGS = $(TEMPLATE_VBoxR3Exe_OBJCXXFLAGS) -static
6794	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS) -static
6795	else ifeq ($(KBUILD_TARGET),solaris)
6796	TEMPLATE_VBoxR3StaticBase_LATE_LIBS = $(TEMPLATE_VBoxR3Exe_LATE_LIBS) nsl
6797	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)',$(TEMPLATE_VBoxR3Exe_LDFLAGS))
6798	else
6799	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)',$(TEMPLATE_VBoxR3Exe_LDFLAGS))
6800	endif
6801	ifn1of ($(KBUILD_TARGET), darwin os2) # ELF only. Present in gcc 3.2.3 & binutils 2.15, possibly earlier.
6802	ifdef VBOX_LD_gc_sections # Older solaris linker versions doesn't grok --gc-sections (e.g. add build box).
6803	ifndef TEMPLATE_VBoxR3StaticBase_CXXFLAGS
6804	TEMPLATE_VBoxR3StaticBase_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6805	TEMPLATE_VBoxR3StaticBase_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS)
6806	endif
6807	TEMPLATE_VBoxR3StaticBase_CXXFLAGS += -ffunction-sections -fdata-sections
6808	TEMPLATE_VBoxR3StaticBase_CFLAGS += -ffunction-sections -fdata-sections
6809	TEMPLATE_VBoxR3StaticBase_LDFLAGS += $(VBOX_LD_gc_sections)
6810	endif
6811	endif
6812	endif
6813
6814	#
6815	# Temporary: Renaming the template and warnings will be errors (soon).
6816	# Unlike VBoxR3StaticBase, this is strict wrt warnings and includes IPRT.
6817	#
6818	TEMPLATE_VBoxR3Static = New name for VBoxR3StaticBase
6819	TEMPLATE_VBoxR3Static_EXTENDS = VBoxR3StaticBase
6820	TEMPLATE_VBoxR3Static_EXTENDS_BY = appending
6821	TEMPLATE_VBoxR3Static_SDKS.$(KBUILD_TARGET_ARCH) += VBoxOpenSslStatic
6822	TEMPLATE_VBoxR3Static_SDKS.win += VBoxNtDll
6823	ifeq ($(KBUILD_TARGET),win)
6824	TEMPLATE_VBoxR3Static_CFLAGS += $(VBOX_VCC_WERR)
6825	TEMPLATE_VBoxR3Static_CXXFLAGS += $(VBOX_VCC_WERR)
6826	TEMPLATE_VBoxR3Static_PCHFLAGS += $(VBOX_VCC_WERR)
6827	TEMPLATE_VBoxR3Static_LDFLAGS += $(VBOX_VCC_LD_WERR)
6828	else
6829	TEMPLATE_VBoxR3Static_CFLAGS += $(VBOX_GCC_WERR)
6830	TEMPLATE_VBoxR3Static_CXXFLAGS += $(VBOX_GCC_WERR)
6831	TEMPLATE_VBoxR3Static_PCHFLAGS += $(VBOX_GCC_WERR)
6832	TEMPLATE_VBoxR3Static_LDFLAGS.darwin.arm64 += $(TEMPLATE_VBoxR3StaticBase_LDFLAGS.darwin.arm64) -framework IOKit
6833	endif
6834	TEMPLATE_VBoxR3Static_LATE_LIBS.$(KBUILD_TARGET_ARCH) += \
6835	$(VBOX_LIB_RUNTIME_STATIC)
6836	ifneq ($(KBUILD_TARGET_ARCH),x86)
6837	TEMPLATE_VBoxR3Static_LATE_LIBS.x86 += \
6838	$(VBOX_LIB_RUNTIME_STATIC_X86)
6839	endif
6840	ifndef SDK_VBoxLibXml2_LIBS
6841	TEMPLATE_VBoxR3Static_LATE_LIBS.$(KBUILD_TARGET_ARCH) += \
6842	$(PATH_STAGE_LIB)/VBox-libxml2-static$(VBOX_SUFF_LIB)
6843	endif
6844	if1of ($(KBUILD_TARGET), os2 win)
6845	TEMPLATE_VBoxR3Static_LATE_LIBS.$(KBUILD_TARGET_ARCH) += \
6846	$(SDK_VBoxLzfStatic_LIBS) \
6847	$(SDK_VBoxZlibStatic_LATE_LIBS) \
6848	$(SDK_VBoxLibLzmaStatic_LIBS)
6849	else
6850	TEMPLATE_VBoxR3Static_LATE_LIBS.$(KBUILD_TARGET_ARCH) += \
6851	$(SDK_VBoxLzf_LIBS) \
6852	$(SDK_VBoxZlib_LATE_LIBS) \
6853	$(SDK_VBoxLibLzma_LIBS)
6854	if1of ($(KBUILD_TARGET), darwin freebsd)
6855	TEMPLATE_VBoxR3Static_LATE_LIBS += iconv
6856	else ifeq ($(KBUILD_TARGET),solaris)
6857	TEMPLATE_VBoxR3Static_LATE_LIBS += kstat
6858	endif
6859	endif
6860
6861	#
6862	# A no-ASAN version of VBoxR3Static for things like that automatically executed tests.
6863	#
6864	TEMPLATE_VBoxR3StaticExeNoAsan = VBoxR3Static but w/o ASAN
6865	TEMPLATE_VBoxR3StaticExeNoAsan_EXTENDS = VBoxR3Static
6866	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" == "asan"
6867	TEMPLATE_VBoxR3StaticExeNoAsan_CFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3Static_CFLAGS))
6868	TEMPLATE_VBoxR3StaticExeNoAsan_CXXFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3Static_CXXFLAGS))
6869	TEMPLATE_VBoxR3StaticExeNoAsan_PCHFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3Static_PCHFLAGS))
6870	TEMPLATE_VBoxR3StaticExeNoAsan_LDFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxR3Static_LDFLAGS)) -InferAsanLibs:No
6871	TEMPLATE_VBoxR3StaticExeNoAsan_LATE_LIBS.x86 = $(subst $(VBOX_LIB_RUNTIME_STATIC),$(VBOX_LIB_RUNTIME_STATIC_NO_ASAN),$(filter-out %clang_rt.asan-i386.lib %clang_rt.asan_cxx-i386.lib , $(TEMPLATE_VBoxR3Static_LATE_LIBS.x86)))
6872	TEMPLATE_VBoxR3StaticExeNoAsan_LATE_LIBS.amd64 = $(subst $(VBOX_LIB_RUNTIME_STATIC),$(VBOX_LIB_RUNTIME_STATIC_NO_ASAN),$(filter-out %clang_rt.asan-x86_64.lib %clang_rt.asan_cxx-x86_64.lib, $(TEMPLATE_VBoxR3Static_LATE_LIBS.amd64)))
6873	endif
6874
6875	#
6876	# A DLL capable version of VBoxR3Static
6877	#
6878	## @todo make VBoxR3StaticDll work on non-windows.
6879	TEMPLATE_VBoxR3StaticDll = VBox Static Ring-3 DLL
6880	TEMPLATE_VBoxR3StaticDll_EXTENDS = VBoxR3Static
6881	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" == "asan"
6882	TEMPLATE_VBoxR3StaticDll_LATE_LIBS.x86 = $(patsubst %clang_rt.asan-i386.lib, %clang_rt.asan_dll_thunk-i386.lib, $(filter-out %clang_rt.asan_cxx-i386.lib,$(TEMPLATE_VBoxR3Static_LATE_LIBS.x86)))
6883	TEMPLATE_VBoxR3StaticDll_LATE_LIBS.amd64 = $(patsubst %clang_rt.asan-x86_64.lib, %clang_rt.asan_dll_thunk-x86_64.lib, $(filter-out %clang_rt.asan_cxx-x86_64.lib,$(TEMPLATE_VBoxR3Static_LATE_LIBS.amd64)))
6884	endif
6885
6886	#
6887	# A no-ASAN version of VBoxR3StaticDll for the installer helper DLL.
6888	#
6889	# Note! Not compatible with BLD_TRG_ARCH overrides yet.
6890	#
6891	TEMPLATE_VBoxR3StaticDllNoAsan = VBoxR3StaticDll but w/o ASAN
6892	TEMPLATE_VBoxR3StaticDllNoAsan_EXTENDS = VBoxR3StaticDll
6893	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" == "asan"
6894	TEMPLATE_VBoxR3StaticDllNoAsan_CFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3StaticDll_CFLAGS))
6895	TEMPLATE_VBoxR3StaticDllNoAsan_CXXFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3StaticDll_CXXFLAGS))
6896	TEMPLATE_VBoxR3StaticDllNoAsan_PCHFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3StaticDll_PCHFLAGS))
6897	TEMPLATE_VBoxR3StaticDllNoAsan_LDFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxR3StaticDll_LDFLAGS)) -InferAsanLibs:No
6898	TEMPLATE_VBoxR3StaticDllNoAsan_LATE_LIBS.x86 = $(subst $(VBOX_LIB_RUNTIME_STATIC),$(VBOX_LIB_RUNTIME_STATIC_NO_ASAN),$(filter-out %clang_rt.asan_dll_thunk-i386.lib, $(TEMPLATE_VBoxR3StaticDll_LATE_LIBS.x86)))
6899	TEMPLATE_VBoxR3StaticDllNoAsan_LATE_LIBS.amd64 = $(subst $(VBOX_LIB_RUNTIME_STATIC),$(VBOX_LIB_RUNTIME_STATIC_NO_ASAN),$(filter-out %clang_rt.asan_dll_thunk-x86_64.lib, $(TEMPLATE_VBoxR3StaticDll_LATE_LIBS.amd64)))
6900	endif
6901
6902
6903	#
6904	# Non-pedantic variation of VBoxR3Static
6905	#
6906	TEMPLATE_VBoxR3StaticNonPedantic = VBox Static Ring-3 EXE, non-pedantic.
6907	TEMPLATE_VBoxR3StaticNonPedantic_EXTENDS = VBoxR3Static
6908	ifeq ($(KBUILD_TARGET),win)
6909	TEMPLATE_VBoxR3StaticNonPedantic_CFLAGS = $(TEMPLATE_VBoxR3Static_CFLAGS) $(VBOX_VCC_NON_PEDANTIC)
6910	TEMPLATE_VBoxR3StaticNonPedantic_CXXFLAGS = $(TEMPLATE_VBoxR3Static_CXXFLAGS) $(VBOX_VCC_NON_PEDANTIC)
6911	TEMPLATE_VBoxR3StaticNonPedantic_PCHFLAGS = $(TEMPLATE_VBoxR3Static_PCHFLAGS) $(VBOX_VCC_NON_PEDANTIC)
6912	else # gcc:
6913	TEMPLATE_VBoxR3StaticNonPedantic_TOOL = $(VBOX_GCC_TOOL)
6914	TEMPLATE_VBoxR3StaticNonPedantic_CFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_C) ,$(TEMPLATE_VBoxR3Static_CFLAGS)) \
6915	$(VBOX_GCC_NON_PEDANTIC_CXX)
6916	TEMPLATE_VBoxR3StaticNonPedantic_CXXFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_CXX),$(TEMPLATE_VBoxR3Static_CXXFLAGS)) \
6917	$(VBOX_GCC_NON_PEDANTIC_CXX)
6918	TEMPLATE_VBoxR3StaticNonPedantic_PCHFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_CXX),$(TEMPLATE_VBoxR3Static_PCHFLAGS)) \
6919	$(VBOX_GCC_NON_PEDANTIC_CXX)
6920	endif
6921
6922	#
6923	# VBoxR3Static w/o any CRT (windows only atm, experimental).
6924	# Implies no fancy C++, no exceptions, no static constructors or destructors, ++.
6925	#
6926	# Note! Not compatible with BLD_TRG_ARCH overrides yet.
6927	#
6928	TEMPLATE_VBoxR3StaticNoCrt = Static
6929	TEMPLATE_VBoxR3StaticNoCrt_EXTENDS = VBoxR3Static
6930	TEMPLATE_VBoxR3StaticNoCrt_SDKS = $(subst WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC,WINSDK10-UCRT-INCS, $(TEMPLATE_VBoxR3Static_SDKS))
6931	TEMPLATE_VBoxR3StaticNoCrt_SDKS.$(KBUILD_TARGET_ARCH) = $(filter-out VBoxOpenSslStatic,$(TEMPLATE_VBoxR3Static_SDKS.$(KBUILD_TARGET_ARCH)))
6932	TEMPLATE_VBoxR3StaticNoCrt_DEFS = $(TEMPLATE_VBoxR3Static_DEFS) \
6933	RT_NO_CRT \
6934	IN_RT_STATIC
6935	ifndef VBOX_WITH_NOCRT_STATIC
6936	TEMPLATE_VBoxR3StaticNoCrt_DEFS.win = $(TEMPLATE_VBoxR3Static_DEFS.win) \
6937	RT_WITHOUT_NOCRT_WRAPPERS
6938	endif
6939	TEMPLATE_VBoxR3StaticNoCrt_LATE_LIBS = \
6940	$(PATH_STAGE_LIB)/RuntimeR3NoCrt$(VBOX_SUFF_LIB)
6941	ifeq ($(KBUILD_TARGET),win)
6942	TEMPLATE_VBoxR3StaticNoCrt_LATE_LIBS.x86 = $(NO_SUCH_VARIABLE)
6943	TEMPLATE_VBoxR3StaticNoCrt_LATE_LIBS.amd64 = $(NO_SUCH_VARIABLE)
6944	TEMPLATE_VBoxR3StaticNoCrt_LATE_LIBS.arm64 = $(NO_SUCH_VARIABLE)
6945	TEMPLATE_VBoxR3StaticNoCrt_LATE_LIBS.win = $(NO_SUCH_VARIABLE)
6946	ifdef VBOX_WITH_NOCRT_STATIC
6947	TEMPLATE_VBoxR3StaticNoCrt_LATE_LIBS.$(KBUILD_TARGET_ARCH) = \
6948	$(PATH_STAGE_LIB)/RuntimeR3NoCrt$(VBOX_SUFF_LIB)
6949	ifneq ($(KBUILD_TARGET_ARCH),x86)
6950	TEMPLATE_VBoxR3StaticNoCrt_LATE_LIBS.x86 = \
6951	$(PATH_STAGE_LIB)/RuntimeR3NoCrt-x86$(VBOX_SUFF_LIB) # place holder, we don't have this library
6952	endif
6953	else
6954	TEMPLATE_VBoxR3StaticNoCrt_LATE_LIBS.win.x86 = \
6955	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticNoCrt_TOOL.win.x86)_LIB)/chkstk.obj
6956	endif
6957	TEMPLATE_VBoxR3StaticNoCrt_LDFLAGS = $(filter-out $(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxR3Static_LDFLAGS))
6958	TEMPLATE_VBoxR3StaticNoCrt_LDFLAGS.win.x86 = $(filter-out -Include%, $(TEMPLATE_VBoxR3Static_LDFLAGS.win.x86))
6959	TEMPLATE_VBoxR3StaticNoCrt_CFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Static_CFLAGS)) /GS- -EHs-
6960	TEMPLATE_VBoxR3StaticNoCrt_CXXFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Static_CXXFLAGS)) /GS- -EHs-
6961	TEMPLATE_VBoxR3StaticNoCrt_PCHFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Static_PCHFLAGS)) /GS- -EHs-
6962	TEMPLATE_VBoxR3StaticNoCrt_CXXFLAGS.debug = $(filter-out /RTC% -RTC%, $(TEMPLATE_VBoxR3Static_CXXFLAGS.debug))
6963	else
6964	TEMPLATE_VBoxR3StaticNoCrt_CXXFLAGS = $(TEMPLATE_VBoxR3Static_CXXFLAGS) -fno-exceptions
6965	TEMPLATE_VBoxR3StaticNoCrt_PCHFLAGS = $(TEMPLATE_VBoxR3Static_PCHFLAGS) -fno-exceptions
6966	endif
6967
6968
6969	#
6970	# Executable w/o CRT (windows only atm, experimental).
6971	# Implies no fancy C++, no exceptions, no static constructors or destructors, ++.
6972	#
6973	TEMPLATE_VBoxR3StaticNoCrtExe := VBoxR3StaticNoCrt with EXE startup code calling a main() function
6974	TEMPLATE_VBoxR3StaticNoCrtExe_EXTENDS := VBoxR3StaticNoCrt
6975	TEMPLATE_VBoxR3StaticNoCrtExe_EXTENDS_BY := appending
6976	TEMPLATE_VBoxR3StaticNoCrtExe_LDFLAGS.win := /entry:CustomMainEntrypoint /subsystem:console
6977
6978
6979	#
6980	# Template for building hardened Ring-3 executables.
6981	# These shall have no extra runpaths, esp. not origin ones.
6982	#
6983	TEMPLATE_VBoxR3HardenedExe := Hardened VBox Ring-3 EXE
6984	TEMPLATE_VBoxR3HardenedExe_EXTENDS := VBoxR3Exe
6985	TEMPLATE_VBoxR3HardenedExe_DEBUG_INST.win = $(INST_DEBUG)hardened-exes/
6986	TEMPLATE_VBoxR3HardenedExe_DEFS = $(TEMPLATE_VBoxR3Exe_DEFS) RTMEM_NO_WRAP_TO_EF_APIS
6987	ifdef VBOX_WITH_HARDENING
6988	TEMPLATE_VBoxR3HardenedExe_LATE_LIBS = $(VBOX_LIB_SUPHARDENED) $(TEMPLATE_VBoxR3Exe_LATE_LIBS)
6989	else
6990	TEMPLATE_VBoxR3HardenedExe_LATE_LIBS = $(TEMPLATE_VBoxR3Exe_LATE_LIBS)
6991	endif
6992	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.darwin = $(TEMPLATE_VBoxR3Exe_LDFLAGS.darwin) -framework IOKit
6993	ifeq ($(KBUILD_TARGET),linux)
6994	# not necessary except USE_LIB_PCAP is defined in SUPR3HardenedMain.cpp
6995	# TEMPLATE_VBoxR3HardenedExe_LATE_LIBS += cap
6996	endif
6997	ifeq ($(KBUILD_TARGET),win) # No CRT!
6998	TEMPLATE_VBoxR3HardenedExe_SDKS = VBoxNtDll $(TEMPLATE_VBoxR3Exe_SDKS)
6999	ifneq ($(VBOX_VCC_LD_GUARD_CF),)
7000	TEMPLATE_VBoxR3HardenedExe_CXXFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_CXXFLAGS))
7001	TEMPLATE_VBoxR3HardenedExe_CXXFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)) #-O2 -Oy-
7002	TEMPLATE_VBoxR3HardenedExe_PCHFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_PCHFLAGS))
7003	TEMPLATE_VBoxR3HardenedExe_PCHFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_PCHFLAGS.debug)) #-O2 -Oy-
7004	TEMPLATE_VBoxR3HardenedExe_CFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_CFLAGS))
7005	TEMPLATE_VBoxR3HardenedExe_CFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_CFLAGS.debug)) -O2 -Oy-
7006	else
7007	TEMPLATE_VBoxR3HardenedExe_CXXFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_CXXFLAGS)) -GS-
7008	TEMPLATE_VBoxR3HardenedExe_CXXFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)) -GS- #-O2 -Oy-
7009	TEMPLATE_VBoxR3HardenedExe_PCHFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_PCHFLAGS)) -GS-
7010	TEMPLATE_VBoxR3HardenedExe_PCHFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_PCHFLAGS.debug)) -GS- #-O2 -Oy-
7011	TEMPLATE_VBoxR3HardenedExe_CFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_CFLAGS)) -GS-
7012	TEMPLATE_VBoxR3HardenedExe_CFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_CFLAGS.debug)) -GS- -O2 -Oy-
7013	endif
7014	TEMPLATE_VBoxR3HardenedExe_LDFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxR3Exe_LDFLAGS)) \
7015	/DISALLOWLIB:msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7016	/DISALLOWLIB:msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7017	/DISALLOWLIB:vcruntime$(VBOX_VCC_CRT_TYPE).lib \
7018	/DISALLOWLIB:ucrt$(VBOX_VCC_CRT_TYPE).lib
7019	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.win.x86 = $(TEMPLATE_VBoxR3Exe_LDFLAGS.win.x86) /entry:suplibHardenedWindowsMain
7020	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.win.amd64 = $(TEMPLATE_VBoxR3Exe_LDFLAGS.win.amd64) /entry:suplibHardenedWindowsMain
7021	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.win.arm64 = $(TEMPLATE_VBoxR3Exe_LDFLAGS.win.arm64) /entry:suplibHardenedWindowsMain
7022	TEMPLATE_VBoxR3HardenedExe_LATE_LIBS.x86 = $(NOT_SUCH_VARIABLE)
7023	TEMPLATE_VBoxR3HardenedExe_LATE_LIBS.amd64 = $(NOT_SUCH_VARIABLE)
7024	TEMPLATE_VBoxR3HardenedExe_LATE_LIBS.arm64 = $(NOT_SUCH_VARIABLE)
7025	TEMPLATE_VBoxR3HardenedExe_USES.win = $(TEMPLATE_VBoxR3Exe_USES.win) vboximportchecker
7026	TEMPLATE_VBoxR3HardenedExe_VBOX_IMPORT_CHECKER.win = noimports
7027	else ifn1of ($(KBUILD_TARGET), os2)
7028	ifneq ($(KBUILD_TYPE),asan) # Keep RPATH in asan builds so we can find libasan.so.X and libubsan.so.Y.
7029	TEMPLATE_VBoxR3HardenedExe_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)%,$(TEMPLATE_VBoxR3Exe_LDFLAGS))
7030	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.linux = $(filter-out $(VBOX_GCC_ORIGIN_OPT),$(TEMPLATE_VBoxR3Exe_LDFLAGS.linux))
7031	endif
7032	endif
7033
7034	#
7035	# Template for building hardened Ring-3 libraries.
7036	#
7037	TEMPLATE_VBoxR3HardenedLib = Hardened VBox Ring-3 LIB
7038	TEMPLATE_VBoxR3HardenedLib_EXTENDS = VBoxR3HardenedExe
7039	TEMPLATE_VBoxR3HardenedLib_LATE_LIBS = $(NO_SUCH_VARIABLE)
7040	TEMPLATE_VBoxR3HardenedLib_LIBS = $(NO_SUCH_VARIABLE)
7041	TEMPLATE_VBoxR3HardenedLib_USES.win = $(NO_SUCH_VARIABLE)
7042	TEMPLATE_VBoxR3HardenedLib_POST_CMDS = $(NO_SUCH_VARIABLE)
7043
7044
7045	#
7046	# Template for building hardened Ring-3 testcase executables.
7047	#
7048	TEMPLATE_VBoxR3HardenedTstExe = VBox Ring-3 Hardened Testcase Exe (currently windows only!)
7049	TEMPLATE_VBoxR3HardenedTstExe_EXTENDS = VBoxR3HardenedExe
7050	TEMPLATE_VBoxR3HardenedTstExe_INST = $(INST_TESTCASE)
7051
7052	#
7053	# Template for building hardened Ring-3 testcase DLLs (pairs with VBoxR3HardenedTstExe).
7054	#
7055	TEMPLATE_VBoxR3HardenedTstDll = VBox Ring-3 Hardened Testcase Dll (currently windows only!)
7056	TEMPLATE_VBoxR3HardenedTstDll_EXTENDS = VBoxR3TstDll
7057	TEMPLATE_VBoxR3HardenedTstDll_INST = $(INST_TESTCASE)
7058	TEMPLATE_VBoxR3HardenedTstDll_LDFLAGS.win = $(TEMPLATE_VBoxR3TstDll_LDFLAGS.win) \
7059	$(if-expr !defined(VBOX_WITHOUT_WINDOWS_KERNEL_CODE_SIGNING_CERT),-IntegrityCheck,)
7060	ifn1of ($(KBUILD_TARGET), win os2)
7061	TEMPLATE_VBoxR3HardenedTstDll_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)%,$(TEMPLATE_VBoxR3TstDll_LDFLAGS))
7062	TEMPLATE_VBoxR3HardenedTstDll_LDFLAGS.linux = $(filter-out $(VBOX_GCC_ORIGIN_OPT),$(TEMPLATE_VBoxR3TstDll_LDFLAGS.linux))
7063	endif
7064
7065	#
7066	# Template for building set-uid-to-root helper programs.
7067	# In hardened builds, these may only contain absolute runpaths!
7068	#
7069	TEMPLATE_VBoxR3SetUidToRoot = Set-uid-to-root helper program.
7070	if1of ($(KBUILD_TARGET), win)
7071	TEMPLATE_VBoxR3SetUidToRoot_EXTENDS = VBoxR3Exe
7072	else
7073	TEMPLATE_VBoxR3SetUidToRoot_EXTENDS = VBoxR3HardenedExe
7074	TEMPLATE_VBoxR3SetUidToRoot_LDFLAGS = $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS)
7075	endif
7076	TEMPLATE_VBoxR3SetUidToRoot_LIBS = $(NO_SUCH_VARIABLE)
7077	TEMPLATE_VBoxR3SetUidToRoot_LATE_LIBS = $(NO_SUCH_VARIABLE)
7078	ifdef VBOX_WITH_RUNPATH
7079	TEMPLATE_VBoxR3SetUidToRoot_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)'
7080	endif
7081	ifndef VBOX_WITH_HARDENING
7082	ifdef VBOX_WITH_RELATIVE_RUNPATH
7083	TEMPLATE_VBoxR3SetUidToRoot_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)'
7084	endif
7085	ifdef VBOX_WITH_ORIGIN
7086	TEMPLATE_VBoxR3SetUidToRoot_LDFLAGS.linux += $(VBOX_GCC_ORIGIN_OPT)
7087	endif
7088	endif
7089
7090	#
7091	# Template for building R3 tools.
7092	#
7093	TEMPLATE_VBoxR3Tool = VBox Ring 3 Tools
7094	TEMPLATE_VBoxR3Tool_EXTENDS = VBoxR3Exe
7095	TEMPLATE_VBoxR3Tool_INST = $(VBOX_INST_TOOLS)
7096	ifeq ($(KBUILD_TARGET),win)
7097	TEMPLATE_VBoxR3Tool_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) $(VBOX_VCC_WERR)
7098	TEMPLATE_VBoxR3Tool_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) $(VBOX_VCC_WERR)
7099	TEMPLATE_VBoxR3Tool_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS) $(VBOX_VCC_WERR)
7100	TEMPLATE_VBoxR3Tool_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS) $(VBOX_VCC_LD_WERR)
7101	else
7102	TEMPLATE_VBoxR3Tool_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) $(VBOX_GCC_WERR)
7103	TEMPLATE_VBoxR3Tool_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) $(VBOX_GCC_WERR)
7104	TEMPLATE_VBoxR3Tool_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS) $(VBOX_GCC_WERR)
7105	ifdef VBOX_WITH_RUNPATH
7106	TEMPLATE_VBoxR3Tool_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' $(TEMPLATE_VBoxR3Exe_LDFLAGS)
7107	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7108	TEMPLATE_VBoxR3Tool_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..' $(TEMPLATE_VBoxR3Exe_LDFLAGS)
7109	endif
7110	endif
7111	TEMPLATE_VBoxR3Tool_LATE_LIBS = $(LIB_RUNTIME) $(TEMPLATE_VBoxR3Exe_LATE_LIBS)
7112	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
7113	TEMPLATE_VBoxR3Tool_LATE_LIBS.x86 = \
7114	$(PATH_STAGE_LIB)/RuntimeR3VccTricks2$(VBOX_SUFF_LIB) \
7115	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib
7116	endif
7117
7118
7119	#
7120	# Ring-3 testcase, running automatically during the build.
7121	# This is the VBoxR3Exe template only with a different install dir.
7122	#
7123	TEMPLATE_VBoxR3AutoTest = VBox Ring 3 Testcase Exe
7124	TEMPLATE_VBoxR3AutoTest_EXTENDS := VBoxR3Static
7125	TEMPLATE_VBoxR3AutoTest_SDKS.$(KBUILD_TARGET_ARCH) = $(filter-out VBoxOpenSslStatic,$(TEMPLATE_$(TEMPLATE_VBoxR3AutoTest_EXTENDS)_SDKS.$(KBUILD_TARGET_ARCH)))
7126	ifeq ($(KBUILD_TARGET),win)
7127	if "$(KBUILD_HOST_VERSION)" vlt "10.0.0.0.10240" # The windows ASAN requires windows 10 APIs to work.
7128	TEMPLATE_VBoxR3AutoTest_EXTENDS := VBoxR3StaticExeNoAsan
7129	endif
7130	ifdef VBOX_SIGNING_MODE
7131	TEMPLATE_VBoxR3AutoTest_LDFLAGS = $(filter-out -IntegrityCheck, $(TEMPLATE_$(TEMPLATE_VBoxR3AutoTest_EXTENDS)_LDFLAGS))
7132	TEMPLATE_VBoxR3AutoTest_POST_CMDS = $(NO_SUCH_VARIABLE)
7133	endif
7134	endif
7135	TEMPLATE_VBoxR3AutoTest_INST = $(INST_TESTCASE)
7136	TEMPLATE_VBoxR3AutoTest_LATE_LIBS.$(KBUILD_TARGET_ARCH) = $(filter-out \
7137	$(if-expr !defined(SDK_VBoxLibXml2_LIBS),$(PATH_STAGE_LIB)/VBox-libxml2-static$(VBOX_SUFF_LIB),) \
7138	$(if-expr "$(KBUILD_TARGET)" == "win" \|\| "$(KBUILD_TARGET)" == "os2" \
7139	,$(SDK_VBoxLzfStatic_LIBS) $(SDK_VBoxZlibStatic_LATE_LIBS) $(SDK_VBoxLibLzmaStatic_LIBS) \
7140	,$(SDK_VBoxLzf_LIBS) $(SDK_VBoxZlib_LATE_LIBS) $(SDK_VBoxLibLzma_LIBS)) \
7141	,$(TEMPLATE_$(TEMPLATE_VBoxR3AutoTest_EXTENDS)_LATE_LIBS.$(KBUILD_TARGET_ARCH)))
7142
7143	#
7144	# Ring-3 testcase.
7145	# This is the VBoxR3Exe template only with a different install dir.
7146	#
7147	TEMPLATE_VBoxR3TstExe = VBox Ring 3 Testcase Exe
7148	TEMPLATE_VBoxR3TstExe_EXTENDS = VBoxR3Exe
7149	TEMPLATE_VBoxR3TstExe_LATE_LIBS = $(LIB_RUNTIME) $(TEMPLATE_VBoxR3Exe_LATE_LIBS)
7150	TEMPLATE_VBoxR3TstExe_INST = $(INST_TESTCASE)
7151	ifdef VBOX_WITH_RUNPATH
7152	TEMPLATE_VBoxR3TstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' $(TEMPLATE_VBoxR3Exe_LDFLAGS)
7153	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7154	TEMPLATE_VBoxR3TstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..' $(TEMPLATE_VBoxR3Exe_LDFLAGS)
7155	endif
7156	if "$(KBUILD_TARGET)" == "win" && defined(VBOX_SIGNING_MODE)
7157	TEMPLATE_VBoxR3TstExe_POST_CMDS =
7158	TEMPLATE_VBoxR3TstExe_LDFLAGS = $(filter-out -IntegrityCheck, $(TEMPLATE_VBoxR3Exe_LDFLAGS))
7159	endif
7160	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
7161	TEMPLATE_VBoxR3TstExe_POST_CMDS.win.x86 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION) $(out))
7162	TEMPLATE_VBoxR3TstExe_LATE_LIBS.x86 = \
7163	$(PATH_STAGE_LIB)/RuntimeR3VccTricks2$(VBOX_SUFF_LIB) \
7164	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib
7165	endif
7166
7167	# x86 version of VBoxR3TstExe
7168	TEMPLATE_VBoxR3TstExe-x86 := 32-bit VBox Ring 3 Testcase Exe
7169	TEMPLATE_VBoxR3TstExe-x86_EXTENDS := VBoxR3TstExe
7170	TEMPLATE_VBoxR3TstExe-x86_BLD_TRG_ARCH := x86
7171	TEMPLATE_VBoxR3TstExe-x86_LATE_LIBS = $(LIB_RUNTIME_X86) $(TEMPLATE_VBoxR3Exe_LATE_LIBS)
7172
7173	#
7174	# Ring-3 testcase DLL.
7175	#
7176	TEMPLATE_VBoxR3TstDll = VBox Ring-3 Testcase Dll
7177	TEMPLATE_VBoxR3TstDll_EXTENDS = VBoxR3TstExe
7178	ifn1of ($(KBUILD_TARGET), darwin win os2)
7179	TEMPLATE_VBoxR3TstDll_DEFS = $(TEMPLATE_VBoxR3TstExe_DEFS) PIC
7180	TEMPLATE_VBoxR3TstDll_CFLAGS = $(TEMPLATE_VBoxR3TstExe_CFLAGS) -fPIC
7181	TEMPLATE_VBoxR3TstDll_CXXFLAGS = $(TEMPLATE_VBoxR3TstExe_CXXFLAGS) -fPIC
7182	TEMPLATE_VBoxR3TstDll_PCHFLAGS = $(TEMPLATE_VBoxR3TstExe_PCHFLAGS) -fPIC
7183	TEMPLATE_VBoxR3TstDll_LDFLAGS = $(TEMPLATE_VBoxR3TstExe_LDFLAGS) -fPIC
7184	endif
7185
7186
7187	#
7188	# Template for building bad C/C++ style R3 shared libraries / Dlls (no -pedantic).
7189	# (Same transformation as for VBoxR3ExeNonPedantic.)
7190	#
7191	TEMPLATE_VBoxR3DllNonPedantic = VBox ring-3 Non-pedantic, with warnings.
7192	TEMPLATE_VBoxR3DllNonPedantic_EXTENDS = VBoxR3DllBase
7193	ifeq ($(KBUILD_TARGET),win)
7194	TEMPLATE_VBoxR3DllNonPedantic_CFLAGS = $(TEMPLATE_VBoxR3DllBase_CFLAGS) $(VBOX_VCC_NON_PEDANTIC)
7195	TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS = $(TEMPLATE_VBoxR3DllBase_CXXFLAGS) $(VBOX_VCC_NON_PEDANTIC)
7196	TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS = $(TEMPLATE_VBoxR3DllBase_PCHFLAGS) $(VBOX_VCC_NON_PEDANTIC)
7197	else # gcc:
7198	TEMPLATE_VBoxR3DllNonPedantic_TOOL = $(VBOX_GCC_TOOL)
7199	TEMPLATE_VBoxR3DllNonPedantic_CFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_C) ,$(TEMPLATE_VBoxR3DllBase_CFLAGS)) \
7200	$(VBOX_GCC_NON_PEDANTIC_C)
7201	TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_CXX),$(TEMPLATE_VBoxR3DllBase_CXXFLAGS)) \
7202	$(VBOX_GCC_NON_PEDANTIC_CXX)
7203	TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_CXX),$(TEMPLATE_VBoxR3DllBase_PCHFLAGS)) \
7204	$(VBOX_GCC_NON_PEDANTIC_CXX)
7205	endif
7206
7207	# x86 edition of the above template for use on AMD64 targets.
7208	TEMPLATE_VBoxR3DllNonPedantic-x86 = 32-bit VBox ring-3 SO/DLLs, no warnings
7209	TEMPLATE_VBoxR3DllNonPedantic-x86_EXTENDS = VBoxR3DllNonPedantic
7210	TEMPLATE_VBoxR3DllNonPedantic-x86_BLD_TRG_ARCH = x86
7211	TEMPLATE_VBoxR3DllNonPedantic-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxR3DllNonPedantic_DEFS)) \
7212	HC_ARCH_BITS=32 ARCH_BITS=32
7213
7214
7215	#
7216	# Same as VBoxR3DllNonPedantic, only it optimizes debug builds.
7217	#
7218	TEMPLATE_VBoxR3DllNonPedanticFast = VBox ring-3 Non-pedantic, with warnings, optimized debug.
7219	TEMPLATE_VBoxR3DllNonPedanticFast_EXTENDS = VBoxR3DllNonPedantic
7220	ifeq ($(KBUILD_TYPE),debug)
7221	ifeq ($(KBUILD_TARGET),win)
7222	TEMPLATE_VBoxR3DllNonPedanticFast_CFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3DllNonPedantic_CFLAGS)) -O2 -Oy-
7223	TEMPLATE_VBoxR3DllNonPedanticFast_CFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3DllNonPedantic_CFLAGS.debug))
7224	TEMPLATE_VBoxR3DllNonPedanticFast_CXXFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS)) -O2 -Oy-
7225	TEMPLATE_VBoxR3DllNonPedanticFast_CXXFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS.debug))
7226	TEMPLATE_VBoxR3DllNonPedanticFast_PCHFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS)) -O2 -Oy-
7227	TEMPLATE_VBoxR3DllNonPedanticFast_PCHFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS.debug))
7228	else
7229	TEMPLATE_VBoxR3DllNonPedanticFast_CFLAGS = $(TEMPLATE_VBoxR3DllNonPedantic_CFLAGS) -O2 -fno-omit-frame-pointer
7230	TEMPLATE_VBoxR3DllNonPedanticFast_CXXFLAGS = $(TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS) -O2 -fno-omit-frame-pointer
7231	TEMPLATE_VBoxR3DllNonPedanticFast_PCHFLAGS = $(TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS) -O2 -fno-omit-frame-pointer
7232	endif
7233	endif
7234
7235
7236	#
7237	# Template for building libraries that are linked into VBoxRT.dll
7238	# and it's variations, pedantic variation.
7239	#
7240	TEMPLATE_VBoxR3RuntimeDll = For libraries that are linked into VBoxRT.
7241	TEMPLATE_VBoxR3RuntimeDll_EXTENDS := VBoxR3Dll
7242	TEMPLATE_VBoxR3RuntimeDll_DEFS = $(TEMPLATE_VBoxR3Dll_DEFS) IN_RT_R3
7243	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
7244	TEMPLATE_VBoxR3RuntimeDll_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Dll_CFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7245	TEMPLATE_VBoxR3RuntimeDll_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Dll_CXXFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7246	TEMPLATE_VBoxR3RuntimeDll_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Dll_PCHFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7247	TEMPLATE_VBoxR3RuntimeDll_LATE_LIBS.x86 = $(filter-out $(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/%, $(TEMPLATE_VBoxR3Dll_LATE_LIBS.x86)) \
7248	$(PATH_TOOL_$(TEMPLATE_VBoxR3RuntimeDll_TOOL.win.x86)_LIB)/oldnames.lib \
7249	$(PATH_TOOL_$(TEMPLATE_VBoxR3RuntimeDll_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
7250	$(PATH_TOOL_$(TEMPLATE_VBoxR3RuntimeDll_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
7251	endif
7252
7253	#
7254	# Template for building libraries that are linked into VBoxRT.dll
7255	# and it's variations, non-pedantic variation.
7256	#
7257	TEMPLATE_VBoxR3RuntimeDllNonPedantic = For libraries that are linked into VBoxRT, but must be excluded from -pedantic warnings.
7258	TEMPLATE_VBoxR3RuntimeDllNonPedantic_EXTENDS := VBoxR3DllNonPedantic
7259	TEMPLATE_VBoxR3RuntimeDllNonPedantic_DEFS = $(TEMPLATE_VBoxR3DllNonPedantic_DEFS) IN_RT_R3
7260	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && $(KBUILD_TARGET_ARCH) == "x86"
7261	TEMPLATE_VBoxR3RuntimeDllNonPedantic_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic_CFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7262	TEMPLATE_VBoxR3RuntimeDllNonPedantic_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7263	TEMPLATE_VBoxR3RuntimeDllNonPedantic_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7264	endif
7265
7266	#
7267	# Template for building libraries that are linked into VBoxRT-x86.dll
7268	# and it's variations, non-pedantic variation.
7269	#
7270	TEMPLATE_VBoxR3RuntimeDllNonPedantic-x86 = For libraries that are linked into VBoxRT, but must be excluded from -pedantic warnings.
7271	TEMPLATE_VBoxR3RuntimeDllNonPedantic-x86_EXTENDS := VBoxR3DllNonPedantic-x86
7272	TEMPLATE_VBoxR3RuntimeDllNonPedantic-x86_BLD_TRG_ARCH := x86
7273	TEMPLATE_VBoxR3RuntimeDllNonPedantic-x86_DEFS = $(TEMPLATE_VBoxR3DllNonPedantic-x86_DEFS) IN_RT_R3
7274	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && $(KBUILD_TARGET_ARCH) == "x86"
7275	TEMPLATE_VBoxR3RuntimeDllNonPedantic-x86_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic-x86_CFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7276	TEMPLATE_VBoxR3RuntimeDllNonPedantic-x86_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic-x86_CXXFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7277	TEMPLATE_VBoxR3RuntimeDllNonPedantic-x86_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic-x86_PCHFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7278	endif
7279
7280	#
7281	# Same as VBoxR3RuntimeDllNonPedantic, only it optimized debug builds too.
7282	#
7283	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast = For libraries that are linked into VBoxRT, but must be excluded from -pedantic warnings, optmized debug.
7284	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_EXTENDS = VBoxR3RuntimeDllNonPedantic
7285	ifeq ($(KBUILD_TYPE),debug)
7286	ifeq ($(KBUILD_TARGET),win)
7287	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CFLAGS)) -O2 -Oy-
7288	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CFLAGS.debug))
7289	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CXXFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CXXFLAGS)) -O2 -Oy-
7290	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CXXFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CXXFLAGS.debug))
7291	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_PCHFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_PCHFLAGS)) -O2 -Oy-
7292	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_PCHFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_PCHFLAGS.debug))
7293	else
7294	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CFLAGS = $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CFLAGS) -O2 -fno-omit-frame-pointer
7295	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CXXFLAGS = $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CXXFLAGS) -O2 -fno-omit-frame-pointer
7296	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_PCHFLAGS = $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_PCHFLAGS) -O2 -fno-omit-frame-pointer
7297	endif
7298	endif
7299
7300
7301	#
7302	# Template for building executables that are part of the VBox Main component
7303	# (COM/XPCOM interface to VirtualBox).
7304	#
7305	TEMPLATE_VBoxMainExe = VBox Main Executable
7306
7307	$(foreach arch,$(VBOX_TARGET_ARCHES)\
7308	,$(eval TEMPLATE_VBoxMainExe_ASTOOL.$(KBUILD_TARGET).$(arch) := $(VBOX_ASTOOL.$(KBUILD_TARGET).$(arch))))
7309	$(foreach arch,$(VBOX_TARGET_ARCHES)\
7310	,$(eval TEMPLATE_VBoxMainExe_ASFLAGS.$(KBUILD_TARGET).$(arch) = $$(VBOX_ASFLAGS.$(KBUILD_TARGET).$(arch))))
7311
7312	TEMPLATE_VBoxMainExe_DEFS = IN_RING3 UNICODE NDEBUG=1
7313	TEMPLATE_VBoxMainExe_DEFS.win = _UNICODE
7314	TEMPLATE_VBoxMainExe_RCDEFS = $(TEMPLATE_VBoxR3Exe_RCDEFS)
7315	TEMPLATE_VBoxMainExe_LATE_LIBS.kprofile = $(LIB_KPROFILE)
7316	TEMPLATE_VBoxMainExe_USES = dtrace
7317	if defined(VBOX_WITH_DTRACE_R3_MAIN) && defined(VBOX_WITH_NATIVE_DTRACE)
7318	TEMPLATE_VBoxMainExe_DTRACETOOL = DTraceAndVBoxTpG
7319	TEMPLATE_VBoxMainExe_DTRACE_OBJ_FLAGS = -C
7320	TEMPLATE_VBoxMainExe_DTRACE_HDR_FLAGS = -C
7321	TEMPLATE_VBoxMainExe_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3 VBOX_WITH_DTRACE_R3_MAIN VBOX_WITH_NATIVE_DTRACE
7322	else
7323	TEMPLATE_VBoxMainExe_DTRACE_HDR_FLAGS = --ring-3-context
7324	TEMPLATE_VBoxMainExe_DTRACE_OBJ_FLAGS = --ring-3-context --pic --probe-fn-imported --probe-fn-name "SUPTracerFireProbe"
7325	if defined(VBOX_WITH_DTRACE_R3_MAIN)
7326	TEMPLATE_VBoxMainExe_DTRACETOOL = VBoxTpG
7327	TEMPLATE_VBoxMainExe_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3 VBOX_WITH_DTRACE_R3_MAIN
7328	else
7329	TEMPLATE_VBoxMainExe_DTRACETOOL = VBoxTpG-Disabled
7330	endif
7331	endif
7332
7333	ifeq ($(KBUILD_TARGET),win)
7334	#TEMPLATE_VBoxMainExe_TOOL = $(VBOX_VCC_TOOL)
7335	TEMPLATE_VBoxMainExe_TOOL.win.x86 = $(VBOX_VCC_TOOL_STEM)X86
7336	TEMPLATE_VBoxMainExe_TOOL.win.amd64 = $(VBOX_VCC_TOOL_STEM)AMD64
7337	TEMPLATE_VBoxMainExe_TOOL.win.arm64 = $(VBOX_VCC_TOOL_STEM)ARM64
7338	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
7339	TEMPLATE_VBoxMainExe_SDKS = ReorderCompilerIncs WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER) $(VBOX_WINPSDK) $(VBOX_WINDDK)
7340	else
7341	TEMPLATE_VBoxMainExe_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK) $(VBOX_WINDDK)
7342	endif
7343	TEMPLATE_VBoxMainExe_CXXFLAGS = -Zi -Zl -GR -EHsc -GF -MD$(VBOX_VCC_CRT_TYPE) $(VBOX_VCC_WCHAR_T_VARIANT) \
7344	$(VBOX_VCC_OPT) $(VBOX_VCC_FP) $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS) $(VBOX_VCC_std)
7345	# -wd4625: 'DisplaySourceBitmap' : copy constructor could not be generated because a base class copy constructor is inaccessible
7346	# -wd4626: 'DisplaySourceBitmap' : assignment operator could not be generated because a base class assignment operator is inaccessible
7347	# The two above can be cured by adding private: DECLARE_CLS_COPY_CTOR_ASSIGN_NOOP(xxxx); but too much work.
7348	# -wd4355: 'this' : used in base member initializer list (e.g. VirtualBoxBase.cpp)
7349	TEMPLATE_VBoxMainExe_CXXFLAGS += $(VBOX_VCC_WARN_ALL) -wd4625 -wd4626 -wd4355 $(VBOX_VCC_WERR)
7350	TEMPLATE_VBoxMainExe_CXXFLAGS += -Gy
7351	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
7352	TEMPLATE_VBoxMainExe_CXXFLAGS += -Gw
7353	endif
7354	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
7355	TEMPLATE_VBoxMainExe_CXXFLAGS += -Zc:inline
7356	endif
7357	ifdef VBOX_WITH_MSC_ANALYZE_THIS
7358	TEMPLATE_VBoxMainExe_CXXFLAGS += /analyze
7359	endif
7360	TEMPLATE_VBoxMainExe_CXXFLAGS.debug = -RTCsu
7361	TEMPLATE_VBoxMainExe_CXXFLAGS.dbgopt = $(NO_SUCH_VARIABLE)
7362	TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile = -Gh -GH
7363	TEMPLATE_VBoxMainExe_CFLAGS = $(filter-out $(VBOX_VCC_std),$(TEMPLATE_VBoxMainExe_CXXFLAGS))
7364	TEMPLATE_VBoxMainExe_CFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7365	TEMPLATE_VBoxMainExe_CFLAGS.dbgopt = $(TEMPLATE_VBoxMainExe_CXXFLAGS.dbgopt)
7366	TEMPLATE_VBoxMainExe_CFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7367	TEMPLATE_VBoxMainExe_PCHFLAGS = $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7368	TEMPLATE_VBoxMainExe_PCHFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7369	TEMPLATE_VBoxMainExe_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxMainExe_CXXFLAGS.dbgopt)
7370	TEMPLATE_VBoxMainExe_PCHFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7371	TEMPLATE_VBoxMainExe_LDFLAGS = -Ignore:4197 \
7372	/NOD /INCREMENTAL:NO /MAPINFO:EXPORTS /LargeAddressAware /DynamicBase /NxCompat /Release /Debug /Opt:Ref /Opt:Icf \
7373	$(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS) \
7374	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
7375	/STUB:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com \
7376	/DISALLOWLIB:libc.lib \
7377	/DISALLOWLIB:libcd.lib \
7378	/DISALLOWLIB:libcmt.lib \
7379	/DISALLOWLIB:libcmtd.lib \
7380	/DISALLOWLIB:msvcrt$(VBOX_VCC_CRT_TYPE_N).lib \
7381	/DISALLOWLIB:msvcprt$(VBOX_VCC_CRT_TYPE_N).lib \
7382	/DISALLOWLIB:vcruntime$(VBOX_VCC_CRT_TYPE_N).lib \
7383	/DISALLOWLIB:ucrt$(VBOX_VCC_CRT_TYPE_N).lib \
7384	/DISALLOWLIB:libvcruntime.lib \
7385	/DISALLOWLIB:libvcruntimed.lib \
7386	/DISALLOWLIB:libucrt.lib \
7387	/DISALLOWLIB:libucrtd.lib
7388	if defined(VBOX_SIGNING_MODE) && defined(VBOX_WITH_HARDENING) && !defined(VBOX_WITHOUT_WINDOWS_KERNEL_CODE_SIGNING_CERT)
7389	TEMPLATE_VBoxMainExe_LDFLAGS += -IntegrityCheck
7390	endif
7391	ifdef VBOX_WITH_DTRACE_R3_MAIN
7392	TEMPLATE_VBoxMainExe_LDFLAGS += -Merge:VTGPrLc.Data=VTGPrLc.Begin -Merge:VTGPrLc.End=VTGPrLc.Begin -Merge:VTGPrLc.Begin=VTGObj
7393	endif
7394	TEMPLATE_VBoxMainExe_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
7395	TEMPLATE_VBoxMainExe_LATE_LIBS = \
7396	$(LIB_RUNTIME)
7397	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
7398	TEMPLATE_VBoxMainExe_LATE_LIBS.x86 = \
7399	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
7400	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7401	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7402	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/oldnames.lib
7403	TEMPLATE_VBoxMainExe_LATE_LIBS.amd64 = \
7404	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
7405	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7406	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7407	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/oldnames.lib
7408	TEMPLATE_VBoxMainExe_LATE_LIBS.arm64 = \
7409	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.arm64)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
7410	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.arm64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7411	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.arm64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7412	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.arm64)_LIB)/oldnames.lib
7413	ifeq ($(KBUILD_TYPE),asan)
7414	TEMPLATE_VBoxMainExe_LATE_LIBS.x86 += \
7415	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/clang_rt.asan_dynamic-i386.lib \
7416	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/clang_rt.asan_dynamic_runtime_thunk-i386.lib
7417	TEMPLATE_VBoxMainExe_LATE_LIBS.amd64 += \
7418	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/clang_rt.asan_dynamic-x86_64.lib \
7419	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/clang_rt.asan_dynamic_runtime_thunk-x86_64.lib
7420	endif
7421	else
7422	TEMPLATE_VBoxMainExe_LATE_LIBS.x86 = \
7423	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7424	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7425	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/oldnames.lib
7426	TEMPLATE_VBoxMainExe_LATE_LIBS.amd64 = \
7427	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7428	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7429	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/oldnames.lib
7430	endif
7431	TEMPLATE_VBoxMainExe_POST_CMDS = $(VBOX_UTF8_MANIFEST_CMDS)$(NLTAB)$(VBOX_SIGN_IMAGE_CMDS)
7432	TEMPLATE_VBoxMainExe_ORDERDEPS = $(VBOX_SIGN_IMAGE_CMDS_ORDERDEPS)
7433
7434	else # the GCC guys:
7435
7436	TEMPLATE_VBoxMainExe_TOOL = $(VBOX_GCC_TOOL)
7437	if $(VBOX_GCC_VERSION_CC) < 30400
7438	TEMPLATE_VBoxMainExe_DEFS += RT_WITHOUT_PRAGMA_ONCE
7439	endif
7440	TEMPLATE_VBoxMainExe_CXXFLAGS = -g $(VBOX_GCC_pipe) \
7441	$(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_Wno-multistatement-macros) $(VBOX_GCC_Wno-class-memaccess) -Wshadow \
7442	-fshort-wchar -fpermissive -fexceptions -frtti $(VBOX_GCC_OPT) $(VBOX_GCC_FP) -fno-strict-aliasing \
7443	$(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_std) $(VBOX_GCC_IPRT_FMT_CHECK) \
7444	$(VBOX_GCC_SANITIZER_FLAGS)
7445	if !defined("VBOX_GCC_Wno-delete-non-virtual-dtor") && defined("VBOX_GCC_Wno-non-virtual-dtor")
7446	TEMPLATE_VBoxMainExe_CXXFLAGS += $(VBOX_GCC_Wno-non-virtual-dtor)
7447	endif
7448	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
7449	TEMPLATE_VBoxMainExe_CXXFLAGS += $(VBOX_GCC_WERR)
7450	endif
7451	ifdef VBOX_WITH_DTRACE_R3_MAIN
7452	TEMPLATE_VBoxMainExe_CXXFLAGS := $(filter-out -pedantic,$(TEMPLATE_VBoxMainExe_CXXFLAGS)) -fdollars-in-identifiers # annoying gcc option precedence.
7453	endif
7454	TEMPLATE_VBoxMainExe_CXXFLAGS.x86 = -m32
7455	TEMPLATE_VBoxMainExe_CXXFLAGS.amd64 = -m64
7456	TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile = -finstrument-functions
7457	TEMPLATE_VBoxMainExe_CFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros) \
7458	$(VBOX_GCC_OPT) $(VBOX_GCC_FP) -fno-strict-aliasing $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_IPRT_FMT_CHECK) \
7459	$(VBOX_GCC_SANITIZER_FLAGS)
7460	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
7461	TEMPLATE_VBoxMainExe_CFLAGS += $(VBOX_GCC_WERR)
7462	endif
7463	TEMPLATE_VBoxMainExe_CFLAGS.x86 = -m32
7464	TEMPLATE_VBoxMainExe_CFLAGS.amd64 = -m64
7465	TEMPLATE_VBoxMainExe_CFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7466	TEMPLATE_VBoxMainExe_CFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7467	TEMPLATE_VBoxMainExe_OBJCFLAGS = $(TEMPLATE_VBoxMainExe_CFLAGS)
7468	TEMPLATE_VBoxMainExe_OBJCFLAGS.x86 = $(TEMPLATE_VBoxMainExe_CFLAGS.x86)
7469	TEMPLATE_VBoxMainExe_OBJCFLAGS.amd64 = $(TEMPLATE_VBoxMainExe_CFLAGS.amd64)
7470	TEMPLATE_VBoxMainExe_OBJCFLAGS.debug = $(TEMPLATE_VBoxMainExe_CFLAGS.debug)
7471	TEMPLATE_VBoxMainExe_OBJCFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CFLAGS.kprofile)
7472	TEMPLATE_VBoxMainExe_OBJCXXFLAGS = $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7473	TEMPLATE_VBoxMainExe_OBJCXXFLAGS.x86 = $(TEMPLATE_VBoxMainExe_CXXFLAGS.x86)
7474	TEMPLATE_VBoxMainExe_OBJCXXFLAGS.amd64 = $(TEMPLATE_VBoxMainExe_CXXFLAGS.amd64)
7475	TEMPLATE_VBoxMainExe_OBJCXXFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7476	TEMPLATE_VBoxMainExe_OBJCXXFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7477	TEMPLATE_VBoxMainExe_PCHFLAGS = $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7478	TEMPLATE_VBoxMainExe_PCHFLAGS.x86 = $(TEMPLATE_VBoxMainExe_CXXFLAGS.x86)
7479	TEMPLATE_VBoxMainExe_PCHFLAGS.amd64 = $(TEMPLATE_VBoxMainExe_CXXFLAGS.amd64)
7480	TEMPLATE_VBoxMainExe_PCHFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7481	TEMPLATE_VBoxMainExe_PCHFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7482	TEMPLATE_VBoxMainExe_LDFLAGS = $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS)
7483	TEMPLATE_VBoxMainExe_LDFLAGS.x86 = -m32
7484	TEMPLATE_VBoxMainExe_LDFLAGS.amd64 = -m64
7485	ifeq ($(KBUILD_TARGET),linux)
7486	TEMPLATE_VBoxMainExe_LATE_LIBS = pthread m rt $(LIB_RUNTIME) dl
7487	TEMPLATE_VBoxMainExe_LDFLAGS.linux = -Wl,-z,noexecstack,-z,relro $(VBOX_LD_as_needed)
7488	else ifeq ($(KBUILD_TARGET),os2)
7489	TEMPLATE_VBoxMainExe_TOOL = GXX3OMF
7490	TEMPLATE_VBoxMainExe_LATE_LIBS = $(LIB_RUNTIME)
7491	else ifeq ($(KBUILD_TARGET),darwin)
7492	TEMPLATE_VBoxMainExe_TOOL = $(VBOX_GCC_TOOL)
7493	TEMPLATE_VBoxMainExe_SDKS += $(VBOX_DARWIN_DEF_SDK_SDKS)
7494	TEMPLATE_VBoxMainExe_DEFS += $(VBOX_DARWIN_DEF_SDK_DEFS)
7495	TEMPLATE_VBoxMainExe_CFLAGS += $(VBOX_DARWIN_DEF_SDK_CFLAGS)
7496	TEMPLATE_VBoxMainExe_CXXFLAGS += $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
7497	TEMPLATE_VBoxMainExe_OBJCFLAGS += $(VBOX_DARWIN_DEF_SDK_OBJCFLAGS)
7498	TEMPLATE_VBoxMainExe_OBJCXXFLAGS += $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS)
7499	TEMPLATE_VBoxMainExe_LDFLAGS.darwin += -bind_at_load
7500	TEMPLATE_VBoxMainExe_LDFLAGS += $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -framework Carbon -Wl,-headerpad_max_install_names
7501	TEMPLATE_VBoxMainExe_LATE_LIBS = $(LIB_RUNTIME)
7502	TEMPLATE_VBoxMainExe_POST_CMDS.darwin = $(VBOX_SIGN_IMAGE_CMDS)
7503	else ifeq ($(KBUILD_TARGET),haiku)
7504	TEMPLATE_VBoxMainExe_TOOL = GXX3
7505	TEMPLATE_VBoxMainExe_LATE_LIBS = $(LIB_RUNTIME) network stdc++ supc++
7506	else if1of ($(KBUILD_TARGET), freebsd openbsd)
7507	TEMPLATE_VBoxMainExe_TOOL = GXX3
7508	TEMPLATE_VBoxMainExe_LATE_LIBS = $(LIB_RUNTIME)
7509	TEMPLATE_VBoxMainExe_INCS += \
7510	/usr/include \
7511	/usr/X11R6/include \
7512	/usr/local/include
7513	TEMPLATE_VBoxMainExe_LIBPATH += \
7514	/usr/lib \
7515	/usr/X11R6/lib \
7516	/usr/local/lib
7517	else ifeq ($(KBUILD_TARGET),netbsd)
7518	TEMPLATE_VBoxMainExe_TOOL = GXX3
7519	TEMPLATE_VBoxMainExe_LATE_LIBS = $(LIB_RUNTIME)
7520	TEMPLATE_VBoxMainExe_INCS += \
7521	/usr/include \
7522	/usr/X11R7/include
7523	TEMPLATE_VBoxMainExe_LIBPATH += \
7524	/usr/lib \
7525	/usr/X11R7/lib
7526	else ifeq ($(KBUILD_TARGET),solaris)
7527	TEMPLATE_VBoxMainExe_TOOL = GXX3PLAIN
7528	TEMPLATE_VBoxMainExe_DEFS += _REENTRANT
7529	TEMPLATE_VBoxMainExe_LATE_LIBS = $(LIB_RUNTIME) rt thread
7530	else
7531	$(warning Warning: VBox Build: Target $(KBUILD_TARGET) is not officially supported and may need TEMPLATE_VBoxMainExe tweaking!)
7532	TEMPLATE_VBoxMainExe_LATE_LIBS =
7533	endif
7534	TEMPLATE_VBoxMainExe_LDFLAGS.solaris = -Wl,-z,ignore # Same as VBOX_LD_as_needed.
7535	ifdef VBOX_WITH_RUNPATH
7536	TEMPLATE_VBoxMainExe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)'
7537	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7538	TEMPLATE_VBoxMainExe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)'
7539	endif
7540	ifdef VBOX_WITH_ORIGIN
7541	TEMPLATE_VBoxMainExe_LDFLAGS.linux += $(VBOX_GCC_ORIGIN_OPT)
7542	endif
7543
7544	endif # !win
7545
7546	# Add COM/XPCOM stuff
7547	TEMPLATE_VBoxMainExe_LATE_LIBS += \
7548	$(PATH_STAGE_LIB)/VBoxCOM$(VBOX_SUFF_LIB)
7549	ifdef VBOX_WITH_XPCOM
7550	## @todo may be worth creating the VBOX_XPCOM SDK def
7551	TEMPLATE_VBoxMainExe_DEFS += VBOX_WITH_XPCOM
7552	ifdef VBOX_WITH_XPCOM_NAMESPACE_CLEANUP
7553	TEMPLATE_VBoxMainExe_DEFS += VBOX_WITH_XPCOM_NAMESPACE_CLEANUP
7554	endif
7555	TEMPLATE_VBoxMainExe_INCS += \
7556	$(VBOX_XPCOM_INCS)
7557	TEMPLATE_VBoxMainExe_LATE_LIBS += \
7558	$(LIB_XPCOM)
7559	TEMPLATE_VBoxMainExe_INTERMEDIATES += \
7560	$(VBOX_PATH_SDK)/bindings/xpcom/include/VirtualBox_XPCOM.h
7561
7562	else # COM
7563	TEMPLATE_VBoxMainExe_INCS += \
7564	$(VBOX_PATH_SDK)/bindings/mscom/include
7565	TEMPLATE_VBoxMainExe_INTERMEDIATES += \
7566	$(VBOX_PATH_SDK)/bindings/mscom/include/VirtualBox.h
7567	endif # COM
7568
7569	#
7570	# Template for building the Main DLL modules (such as in-process COM/XPCOM
7571	# components for Main).
7572	#
7573	# This differs from VBoxMainExe only in PIC handling and similar DLL stuff.
7574	#
7575	TEMPLATE_VBoxMainDll = VBox Main Component (shared library)
7576	TEMPLATE_VBoxMainDll_EXTENDS = VBoxMainExe
7577	ifn1of ($(KBUILD_TARGET), darwin haiku os2 win)
7578	TEMPLATE_VBoxMainDll_DEFS = PIC $(TEMPLATE_VBoxMainExe_DEFS)
7579	TEMPLATE_VBoxMainDll_CFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_CFLAGS)
7580	TEMPLATE_VBoxMainDll_CXXFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7581	TEMPLATE_VBoxMainDll_PCHFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_PCHFLAGS)
7582	TEMPLATE_VBoxMainDll_LDFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_LDFLAGS)
7583	endif
7584	TEMPLATE_VBoxMainDll_LDFLAGS.darwin = $(filter-out -bind_at_load,$(TEMPLATE_VBoxMainExe_LDFLAGS.darwin)) \
7585	-current_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
7586	-compatibility_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
7587
7588	#
7589	# Template identical to VBoxMainDll except for where the stuff is
7590	# installed when using XPCOM (components/).
7591	#
7592	# Note! In the hardened build this gets a bit ugly since $ORIGIN/..
7593	# doesn't work. So, we keep the $ORIGIN from VBoxMainExe and let
7594	# the installers do the necessary .so symlinking.
7595	#
7596	# (No difference when building against COM on Windows.)
7597	#
7598	TEMPLATE_VBoxMainComp = VBox Main COM/XPCOM Component (shared library)
7599	TEMPLATE_VBoxMainComp_EXTENDS = VBoxMainExe
7600	ifn1of ($(KBUILD_TARGET), win)
7601	TEMPLATE_VBoxMainComp_INST = $(INST_BIN)components/
7602	endif
7603	ifneq ($(KBUILD_TARGET),win)
7604	ifeq ($(filter-out linux.arm64 solaris.x86 %.amd64 %.sparc32 %.sparc64,$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)),) ## TODO: cleanup!
7605	TEMPLATE_VBoxMainComp_DEFS = PIC $(TEMPLATE_VBoxMainExe_DEFS)
7606	TEMPLATE_VBoxMainComp_CFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_CFLAGS)
7607	TEMPLATE_VBoxMainComp_CXXFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7608	TEMPLATE_VBoxMainComp_PCHFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_PCHFLAGS)
7609	if defined(VBOX_WITH_RELATIVE_RUNPATH) && !defined(VBOX_WITH_HARDENING)
7610	TEMPLATE_VBoxMainComp_LDFLAGS = -fPIC $(filter-out '$(VBOX_GCC_RPATH_OPT)%',$(TEMPLATE_VBoxMainExe_LDFLAGS)) '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..'
7611	else
7612	TEMPLATE_VBoxMainComp_LDFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_LDFLAGS)
7613	endif
7614	else ifndef VBOX_WITH_HARDENING
7615	ifdef VBOX_WITH_RELATIVE_RUNPATH
7616	TEMPLATE_VBoxMainComp_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)%',$(TEMPLATE_VBoxMainExe_LDFLAGS)) '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..'
7617	endif
7618	endif
7619	endif
7620	TEMPLATE_VBoxMainComp_LDFLAGS.darwin = $(filter-out -bind_at_load,$(TEMPLATE_VBoxMainExe_LDFLAGS.darwin)) \
7621	-current_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
7622	-compatibility_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
7623
7624	# x86 version of VBoxMainComp
7625	TEMPLATE_VBoxMainComp-x86 = 32-bit VBox Main Component (shared library)
7626	TEMPLATE_VBoxMainComp-x86_EXTENDS = VBoxMainComp
7627	TEMPLATE_VBoxMainComp-x86_BLD_TRG_ARCH = x86
7628	TEMPLATE_VBoxMainComp-x86_INST.win = $(INST_DLL)x86/
7629	TEMPLATE_VBoxMainComp-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxMainComp_DEFS)) HC_ARCH_BIT=32 ARCH_BITS=32 \
7630	VBOX_IN_32_ON_64_MAIN_API
7631	TEMPLATE_VBoxMainComp-x86_LATE_LIBS = \
7632	$(subst $(PATH_STAGE_LIB)/VBoxCOM$(VBOX_SUFF_LIB),$(PATH_STAGE_LIB)/VBoxCOM-x86$(VBOX_SUFF_LIB), \
7633	$(subst $(LIB_RUNTIME),$(VBOX_LIB_RUNTIME_X86), \
7634	$(subst $(LIB_XPCOM),$(VBOX_LIB_XPCOM_X86), \
7635	$(TEMPLATE_VBoxMainComp_LATE_LIBS))))
7636
7637
7638	#
7639	# Template for building the Main static libraries.
7640	#
7641	# This differs from VBoxMainDll only that it zeroes out the _LATE_LIBS definition.
7642	#
7643	TEMPLATE_VBoxMainLib = VBox Main Component (static library)
7644	TEMPLATE_VBoxMainLib_EXTENDS = VBoxMainDll
7645	TEMPLATE_VBoxMainLib_LATE_LIBS = $(NO_SUCH_VARIABLE)
7646
7647	TEMPLATE_VBoxMainLib-x86 = 32-bit VBox Main Component (static library)
7648	TEMPLATE_VBoxMainLib-x86_EXTENDS = VBoxMainLib
7649	TEMPLATE_VBoxMainLib-x86_BLD_TRG_ARCH = x86
7650	TEMPLATE_VBoxMainLib-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxMainLib_DEFS)) HC_ARCH_BIT=32 ARCH_BITS=32 \
7651	VBOX_IN_32_ON_64_MAIN_API
7652
7653	#
7654	# Main unit testing, for compiling API implementation files into a testcase.
7655	# This is the VBoxMainExe template only with a different install dir.
7656	#
7657	TEMPLATE_VBoxMainTstExe = VBox Main Testcase Exe
7658	TEMPLATE_VBoxMainTstExe_EXTENDS = VBoxMainExe
7659	TEMPLATE_VBoxMainTstExe_INST = $(INST_TESTCASE)
7660	ifdef VBOX_WITH_RUNPATH
7661	TEMPLATE_VBoxMainTstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' $(TEMPLATE_VBoxMainExe_LDFLAGS)
7662	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7663	TEMPLATE_VBoxMainTstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..' $(TEMPLATE_VBoxMainExe_LDFLAGS)
7664	endif
7665	if "$(KBUILD_TARGET)" == "win" && defined(VBOX_SIGNING_MODE)
7666	TEMPLATE_VBoxMainTstExe_POST_CMDS =
7667	endif
7668
7669	#
7670	# Template for building executables that use the VBox Main component.
7671	#
7672	TEMPLATE_VBoxMainClientExe = VBox Main Client (executable)
7673	TEMPLATE_VBoxMainClientExe_EXTENDS = VBoxMainExe
7674	ifeq ($(KBUILD_TARGET),win)
7675	TEMPLATE_VBoxMainClientExe_DEPS = $(VBOX_PATH_SDK)/bindings/mscom/include/VirtualBox.h
7676	TEMPLATE_VBoxMainClientExe_LATE_LIBS.win = $(TEMPLATE_VBoxMainExe_LATE_LIBS.win) \
7677	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/User32.Lib \
7678	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/Shell32.Lib \
7679	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/ShLwApi.Lib \
7680	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/Ole32.Lib \
7681	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/OleAut32.Lib \
7682	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/Uuid.Lib
7683	else
7684	TEMPLATE_VBoxMainClientExe_DEPS = $(VBOX_PATH_SDK)/bindings/xpcom/include/VirtualBox_XPCOM.h
7685	TEMPLATE_VBoxMainClientExe_DEFS = $(TEMPLATE_VBoxMainExe_DEFS) \
7686	NDEBUG TRIMMED
7687	TEMPLATE_VBoxMainClientExe_CXXFLAGS.linux = $(TEMPLATE_VBoxMainExe_CXXFLAGS.linux) -pthread
7688	TEMPLATE_VBoxMainClientExe_PCHFLAGS.linux = $(TEMPLATE_VBoxMainExe_PCHFLAGS.linux) -pthread
7689	endif
7690
7691	#
7692	# Template for building shared libraries / DLLs that use the VBox Main component.
7693	#
7694	# This differs from VBoxMainClientExe only in PIC handling and similar DLL stuff.
7695	#
7696	TEMPLATE_VBoxMainClientDll = VBox MAIN Client (shared library)
7697	TEMPLATE_VBoxMainClientDll_EXTENDS = VBoxMainClientExe
7698	ifn1of ($(KBUILD_TARGET), darwin os2 win)
7699	TEMPLATE_VBoxMainClientDll_DEFS = PIC $(TEMPLATE_VBoxMainClientExe_DEFS)
7700	TEMPLATE_VBoxMainClientDll_CFLAGS = -fPIC $(TEMPLATE_VBoxMainClientExe_CFLAGS)
7701	TEMPLATE_VBoxMainClientDll_CXXFLAGS = -fPIC $(TEMPLATE_VBoxMainClientExe_CXXFLAGS)
7702	TEMPLATE_VBoxMainClientDll_PCHFLAGS = -fPIC $(TEMPLATE_VBoxMainClientExe_PCHFLAGS)
7703	TEMPLATE_VBoxMainClientDll_LDFLAGS = -fPIC $(TEMPLATE_VBoxMainClientExe_LDFLAGS)
7704	endif
7705	TEMPLATE_VBoxMainClientDll_LDFLAGS.darwin = $(filter-out -bind_at_load,$(TEMPLATE_VBoxMainClientExe_LDFLAGS.darwin))
7706
7707	# x86 version of VBoxMainClientDll
7708	TEMPLATE_VBoxMainClientDll-x86 := 32-bit VBox MAIN Client (shared library)
7709	TEMPLATE_VBoxMainClientDll-x86_EXTENDS := VBoxMainClientDll
7710	TEMPLATE_VBoxMainClientDll-x86_BLD_TRG_ARCH := x86
7711	TEMPLATE_VBoxMainClientDll-x86_INST.win = $(INST_DLL)x86/
7712	TEMPLATE_VBoxMainClientDll-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxMainClientDll_DEFS)) \
7713	HC_ARCH_BIT=32 ARCH_BITS=32 VBOX_IN_32_ON_64_MAIN_API
7714	TEMPLATE_VBoxMainClientDll-x86_LATE_LIBS = \
7715	$(subst $(PATH_STAGE_LIB)/VBoxCOM$(VBOX_SUFF_LIB),$(PATH_STAGE_LIB)/VBoxCOM-x86$(VBOX_SUFF_LIB), \
7716	$(subst $(LIB_RUNTIME),$(VBOX_LIB_RUNTIME_X86), \
7717	$(subst $(LIB_XPCOM),$(VBOX_LIB_XPCOM_X86), \
7718	$(TEMPLATE_VBoxMainClientDll_LATE_LIBS))))
7719
7720	#
7721	# Template for building testcases which are API clients.
7722	#
7723	TEMPLATE_VBoxMainClientTstExe = VBox Main Client Testcase (executable)
7724	TEMPLATE_VBoxMainClientTstExe_EXTENDS = VBoxMainClientExe
7725	TEMPLATE_VBoxMainClientTstExe_INST = $(INST_TESTCASE)
7726	ifdef VBOX_WITH_RUNPATH
7727	TEMPLATE_VBoxMainClientTstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' $(TEMPLATE_VBoxMainClientExe_LDFLAGS)
7728	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7729	TEMPLATE_VBoxMainClientTstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..' $(TEMPLATE_VBoxMainClientExe_LDFLAGS)
7730	endif
7731	if "$(KBUILD_TARGET)" == "win" && defined(VBOX_SIGNING_MODE)
7732	TEMPLATE_VBoxMainClientTstExe_POST_CMDS =
7733	endif
7734
7735
7736
7737	#
7738	# Templates used for building the extension packs.
7739	#
7740	ifdef VBOX_WITH_EXTPACK
7741	# Base templates (native or portable).
7742	TEMPLATE_VBoxR3ExtPack = For the ring-3 context extension pack modules.
7743	if 1 # Native for now.
7744	TEMPLATE_VBoxR3ExtPack_EXTENDS = VBoxR3Dll
7745	TEMPLATE_VBoxR3ExtPack_DEFS = $(TEMPLATE_VBoxR3Dll_DEFS) VBOX_IN_EXTPACK VBOX_IN_EXTPACK_R3
7746	else
7747	TEMPLATE_VBoxR3ExtPack_EXTENDS = VBoxNoCrtGccLib
7748	TEMPLATE_VBoxR3ExtPack_DEFS = $(TEMPLATE_VBoxNoCrtGccLib_DEFS) VBOX_IN_EXTPACK VBOX_IN_EXTPACK_R3 IPRT_NO_CRT IN_RING3
7749	TEMPLATE_VBoxR3ExtPack_INCS = $(PATH_ROOT)/include/iprt/nocrt $(TEMPLATE_VBoxR3Dll_INCS)
7750	endif
7751	ifneq ($(KBUILD_TARGET),win)
7752	TEMPLATE_VBoxR3ExtPack_CXXFLAGS = $(TEMPLATE_VBoxR3Dll_CXXFLAGS) -fno-rtti
7753	TEMPLATE_VBoxR3ExtPack_PCHFLAGS = $(TEMPLATE_VBoxR3Dll_PCHFLAGS) -fno-rtti
7754	endif
7755	TEMPLATE_VBoxR3ExtPack_INST = $(INST_EXTPACK)YouShallOverrideThis/
7756	ifeq ($(KBUILD_TARGET),linux)
7757	TEMPLATE_VBoxR3ExtPack_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)', $(TEMPLATE_VBoxR3Dll_LDFLAGS))
7758	else if !defined(VBOX_WITH_RUNPATH) && defined(VBOX_WITH_RELATIVE_RUNPATH)
7759	TEMPLATE_VBoxR3ExtPack_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/../../..' $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)', $(TEMPLATE_VBoxR3Dll_LDFLAGS))
7760	endif
7761	ifdef VBOX_ONLY_EXTPACKS_USE_IMPLIBS
7762	if1of ($(KBUILD_TARGET), win os2)
7763	TEMPLATE_VBoxR3ExtPack_LATE_LIBS = \
7764	$(PATH_STAGE_LIB)/VBoxRTImp$(VBOX_SUFF_LIB)
7765	else
7766	TEMPLATE_VBoxR3ExtPack_LATE_LIBS = \
7767	$(PATH_STAGE_LIB)/VBoxRTImp$(VBOX_SUFF_DLL)
7768	endif
7769	else
7770	TEMPLATE_VBoxR3ExtPack_LATE_LIBS = \
7771	$(LIB_RUNTIME)
7772	endif
7773	ifeq ($(KBUILD_TARGET),darwin)
7774	TEMPLATE_VBoxR3ExtPack_POST_CMDS = $(VBOX_SIGN_EXTPACK_DYLIB_CMDS)
7775	endif
7776
7777	TEMPLATE_VBoxR3ExtPackApi = For the ring-3 context extension pack modules using the Main API.
7778	TEMPLATE_VBoxR3ExtPackApi_EXTENDS = VBoxMainDll
7779	TEMPLATE_VBoxR3ExtPackApi_DEFS = $(TEMPLATE_VBoxMainDll_DEFS) VBOX_IN_EXTPACK VBOX_IN_EXTPACK_R3
7780	TEMPLATE_VBoxR3ExtPackApi_INST = $(INST_EXTPACK)YouShallOverrideThis/
7781	ifeq ($(KBUILD_TARGET),linux)
7782	TEMPLATE_VBoxR3ExtPackApi_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)', $(TEMPLATE_VBoxMainDll_LDFLAGS))
7783	else if !defined(VBOX_WITH_RUNPATH) && defined(VBOX_WITH_RELATIVE_RUNPATH)
7784	TEMPLATE_VBoxR3ExtPackApi_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/../../..' $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)', $(TEMPLATE_VBoxMainDll_LDFLAGS))
7785	endif
7786	ifdef VBOX_ONLY_EXTPACKS_USE_IMPLIBS
7787	if1of ($(KBUILD_TARGET), win os2)
7788	TEMPLATE_VBoxR3ExtPackApi_LATE_LIBS = \
7789	$(PATH_STAGE_LIB)/VBoxRTImp$(VBOX_SUFF_LIB)
7790	else
7791	TEMPLATE_VBoxR3ExtPackApi_LATE_LIBS = \
7792	$(PATH_STAGE_LIB)/VBoxRTImp$(VBOX_SUFF_DLL)
7793	endif
7794	else
7795	TEMPLATE_VBoxR3ExtPackApi_LATE_LIBS = \
7796	$(LIB_RUNTIME)
7797	endif
7798	ifeq ($(KBUILD_TARGET),darwin)
7799	TEMPLATE_VBoxR3ExtPackApi_POST_CMDS = $(VBOX_SIGN_EXTPACK_DYLIB_CMDS)
7800	endif
7801
7802	TEMPLATE_VBoxR0ExtPack = For the ring-0 context extension pack modules.
7803	TEMPLATE_VBoxR0ExtPack_EXTENDS = VBoxR0
7804	TEMPLATE_VBoxR0ExtPack_EXTENDS_BY = appending
7805	TEMPLATE_VBoxR0ExtPack_INST = $(INST_EXTPACK)YouShallOverrideThis/
7806	TEMPLATE_VBoxR0ExtPack_DEFS = VBOX_IN_EXTPACK VBOX_IN_EXTPACK_R0
7807	if1of ($(VBOX_LDR_FMT), pe lx)
7808	TEMPLATE_VBoxR0ExtPack_LATE_LIBS = \
7809	$(PATH_STAGE_LIB)/VMMR0Imp$(VBOX_SUFF_LIB)
7810	endif
7811	TEMPLATE_VBoxR0ExtPack_LATE_LIBS += \
7812	$(VBOX_LIB_SUPR0)
7813
7814	TEMPLATE_VBoxRcExtPack = For the raw-mode context extension pack modules.
7815	TEMPLATE_VBoxRcExtPack_EXTENDS = VBoxRc
7816	TEMPLATE_VBoxRcExtPack_EXTENDS_BY = appending
7817	TEMPLATE_VBoxRcExtPack_SYSSUFF = .rc
7818	TEMPLATE_VBoxRcExtPack_INST = $(INST_EXTPACK)YouShallOverrideThis/
7819	TEMPLATE_VBoxRcExtPack_DEFS = VBOX_IN_EXTPACK VBOX_IN_EXTPACK_RC
7820	if1of ($(VBOX_LDR_FMT32), pe lx)
7821	TEMPLATE_VBoxRcExtPack_LATE_LIBS = \
7822	$(PATH_STAGE_LIB)/VMMRCBuiltin$(VBOX_SUFF_LIB) \
7823	$(PATH_STAGE_LIB)/VMMRCImp$(VBOX_SUFF_LIB)
7824	endif
7825
7826	TEMPLATE_VBoxInsExtPack = For the install targets of an extension pack.
7827	TEMPLATE_VBoxInsExtPack_MODE = 0644
7828	TEMPLATE_VBoxInsExtPack_INST = $(INST_EXTPACK)YouShallOverrideThis/
7829
7830	# For each individual extension pack
7831	ifdef VBOX_WITH_EXTPACK_PUEL
7832	TEMPLATE_VBoxR3ExtPackPuel = For the ring-3 context modules in the PUEL extension pack.
7833	TEMPLATE_VBoxR3ExtPackPuel_EXTENDS = VBoxR3ExtPack
7834	TEMPLATE_VBoxR3ExtPackPuel_INST = $(INST_EXTPACK_PUEL)$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/
7835	TEMPLATE_VBoxR3ExtPackPuel_DEFS = $(TEMPLATE_VBoxR3ExtPack_DEFS) VBOX_IN_PUEL_EXTPACK
7836	TEMPLATE_VBoxR3ExtPackPuel_LD_DEBUG = split
7837
7838	TEMPLATE_VBoxR3ExtPackApiPuel = For the ring-3 context modules in the PUEL extension pack.
7839	TEMPLATE_VBoxR3ExtPackApiPuel_EXTENDS = VBoxR3ExtPackApi
7840	TEMPLATE_VBoxR3ExtPackApiPuel_INST = $(INST_EXTPACK_PUEL)$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/
7841	TEMPLATE_VBoxR3ExtPackApiPuel_DEFS = $(TEMPLATE_VBoxR3ExtPackApi_DEFS) VBOX_IN_PUEL_EXTPACK
7842	TEMPLATE_VBoxR3ExtPackApiPuel_LD_DEBUG = split
7843
7844	TEMPLATE_VBoxR3ExtPackPuelWithOpenSsl = For the ring-3 context modules in the PUEL extension pack using ExtPack OpenSSL.
7845	TEMPLATE_VBoxR3ExtPackPuelWithOpenSsl_EXTENDS = VBoxR3ExtPackPuel
7846
7847	TEMPLATE_VBoxR0ExtPackPuel = For the ring-0 context modules in the PUEL extension pack.
7848	TEMPLATE_VBoxR0ExtPackPuel_EXTENDS = VBoxR0ExtPack
7849	TEMPLATE_VBoxR0ExtPackPuel_INST = $(INST_EXTPACK_PUEL)$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/
7850	TEMPLATE_VBoxR0ExtPackPuel_DEFS = $(TEMPLATE_VBoxR0ExtPack_DEFS) VBOX_IN_PUEL_EXTPACK
7851
7852	TEMPLATE_VBoxRcExtPackPuel = For the raw-mode context modules in the PUEL extension pack.
7853	TEMPLATE_VBoxRcExtPackPuel_EXTENDS = VBoxRcExtPack
7854	TEMPLATE_VBoxRcExtPackPuel_INST = $(INST_EXTPACK_PUEL)$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/
7855	TEMPLATE_VBoxRcExtPackPuel_DEFS = $(TEMPLATE_VBoxRcExtPack_DEFS) VBOX_IN_PUEL_EXTPACK
7856
7857	TEMPLATE_VBoxInsExtPackPuel = For the install targets of an extension pack.
7858	TEMPLATE_VBoxInsExtPackPuel_EXTENDS = VBoxR0ExtPack
7859	TEMPLATE_VBoxInsExtPackPuel_INST = $(INST_EXTPACK_PUEL)
7860	endif
7861
7862	endif # VBOX_WITH_EXTPACK
7863
7864
7865	#
7866	# Qt
7867	# Qt
7868	# Qt
7869	#
7870	if defined(VBOX_WITH_QTGUI) \|\| defined(VBOX_WITH_NLS)
7871
7872	# Guess VBOX_WITH_ORACLE_QT
7873	ifndef VBOX_WITH_ORACLE_QT
7874	ifndef VBOX_OSE
7875	if1of ($(KBUILD_TARGET), darwin solaris win)
7876	VBOX_WITH_ORACLE_QT := 1
7877	endif
7878	endif
7879	endif
7880
7881	#
7882	# Handmade configuration of Qt - very annoying, this needs to
7883	# be cleaned up properly later some time (not important now).
7884	#
7885	# When using a debug QT build set VBOX_QT_DBG:=d in LocalConfig.kmk.
7886	#
7887	ifeq ($(VBOX_PATH_QT),)
7888	ifeq ($(KBUILD_TARGET),darwin)
7889	VBOX_PATH_QT := $(lastword $(sort $(wildcard $(KBUILD_DEVTOOLS_TRG)/qt/v6*)))
7890	ifeq ($(VBOX_PATH_QT),)
7891	ifneq ($(wildcard /Library/Frameworks/QtCore.framework),)
7892	# Using the global installation (for OSE).
7893	VBOX_PATH_QT ?= /usr
7894	VBOX_PATH_QT_FRAMEWORKS ?= /Library/Frameworks
7895	endif
7896	endif
7897	else if1of ($(KBUILD_TARGET), win)
7898	VBOX_PATH_QT := $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_TRG)/qt/v6*))
7899	VBOX_PATH_QT := $(firstfile $(qfilter ,%-$(tolower $(VBOX_VCC_TOOL_STEM)),$(VBOX_PATH_QT)) \
7900	$(qfilter-out ,%-vcc100 %-vcc110 %-vcc120 %-vcc140 %-vcc141 %-vcc142 %-vcc143 %-vcc150, $(VBOX_PATH_QT)))
7901	ifdef VBOX_PATH_QT
7902	PATH_SDK_QT6 := $(VBOX_PATH_QT)
7903	PATH_TOOL_QT6 := $(VBOX_PATH_QT)
7904	ifneq ($(KBUILD_HOST_ARCH),$(KBUILD_TARGET_ARCH))
7905	PATH_TOOL_QT6 := $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_HST)/qt/v6*))
7906	PATH_TOOL_QT6 := $(firstfile $(qfilter ,%-$(tolower $(VBOX_VCC_TOOL_STEM)),$(PATH_TOOL_QT6)) \
7907	$(qfilter-out ,%-vcc100 %-vcc110 %-vcc120 %-vcc140 %-vcc141 %-vcc142 %-vcc143 %-vcc150, $(PATH_TOOL_QT6)))
7908	ifndef VBOX_PATH_QT
7909	PATH_SDK_QT6 := $(VBOX_PATH_QT)
7910	endif
7911	endif
7912	endif
7913	else if1of ($(KBUILD_TARGET), linux solaris)
7914	VBOX_PATH_QT ?= $(firstfile $(versortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_TRG)/qt/v6*)))
7915	ifneq ($(VBOX_PATH_QT),)
7916	VBOX_WITH_ORACLE_QT = 1
7917	endif
7918	endif
7919	endif
7920	VBOX_PATH_QT ?= /usr
7921	VBOX_PATH_QT_LIB ?= $(VBOX_PATH_QT)/lib
7922
7923	ifdef VBOX_WITH_ORACLE_QT
7924	if "$(KBUILD_TARGET)" != "darwin"
7925	VBOX_QT_INFIX := VBox$(VBOX_QT_DBG)
7926	endif
7927	VBOX_QT_POSTFIX := VBox
7928	endif
7929
7930	if "$(VBOX_QT_DBG)" != "" && "$(VBOX_QT_DBG)" != "$(VBOX_VCC_CRT_TYPE)" && "$(KBUILD_TARGET)" == "win"
7931	$(warning WARNING! VBOX_QT_DBG (=$(VBOX_QT_DBG)) and VBOX_VCC_CRT_TYPE (=$(VBOX_VCC_CRT_TYPE)) does not match!)
7932	$(warning WARNING! This may cause heap troubles in the GUI in places where something is)
7933	$(warning WARNING! allocated in the Qt DLLs freed in our code (or vice versa) because they)
7934	$(warning WARNING! will be using different allocators. See r156914 for more details.)
7935	$(warning WARNING! VBOX_WITH_DEBUG_VCC_CRT=1 in enabled debug CRT.)
7936	endif
7937
7938	ifeq ($(KBUILD_TARGET),darwin)
7939	VBOX_QT_MOD := QtCore QtGui QtWidgets QtPrintSupport QtHelp QtNetwork QtSql QtStateMachine
7940	else if1of ($(KBUILD_TARGET), linux freebsd netbsd openbsd solaris win)
7941	if1of ($(KBUILD_TARGET), linux freebsd netbsd openbsd solaris)
7942	VBOX_QT_MOD += Qt6Core Qt6Gui Qt6Widgets Qt6PrintSupport Qt6StateMachine
7943	VBOX_QT_MOD += Qt6DBus Qt6Xml Qt6XcbQpa Qt6Help Qt6Network Qt6Sql
7944	ifeq ($(KBUILD_TARGET),linux)
7945	VBOX_QT_MOD += Qt6WaylandClient
7946	endif
7947	VBOX_QT_PLUGINS = \
7948	plugins/platforms/libqxcb$(VBOX_QT_POSTFIX).so \
7949	plugins/platformthemes/libqgtk3$(VBOX_QT_POSTFIX).so \
7950	plugins/sqldrivers/libqsqlite$(VBOX_QT_POSTFIX).so
7951	ifdef VBOX_WITH_ORACLE_QT
7952	VBOX_QT_PLUGINS += \
7953	plugins/platformthemes/libqgtk2$(VBOX_QT_POSTFIX).so \
7954	plugins/styles/libqgtk2style$(VBOX_QT_POSTFIX).so
7955	endif
7956	ifeq ($(KBUILD_TARGET),linux)
7957	VBOX_QT_PLUGINS += \
7958	plugins/platforms/libqwayland-generic$(VBOX_QT_POSTFIX).so \
7959	plugins/wayland-shell-integration/libxdg-shell$(VBOX_QT_POSTFIX).so
7960	endif
7961	else ifeq ($(KBUILD_TARGET),win)
7962	VBOX_QT_MOD += Qt6Core Qt6Gui Qt6Widgets Qt6PrintSupport Qt6StateMachine Qt6Help Qt6Network Qt6Sql
7963	endif # win
7964	endif # linux freebsd netbsd openbsd solaris win
7965
7966	VBOX_QT_MOD_NAMES = $(foreach qtmod,$(VBOX_QT_MOD),$(qtmod)$(VBOX_QT_INFIX))
7967
7968	# Hack LD_LIBRARY_PATH for stuff in tools.
7969	ifdef VBOX_WITH_ORACLE_QT
7970	if1of ($(KBUILD_TARGET), linux solaris)
7971	export LD_LIBRARY_PATH := $(VBOX_PATH_QT_LIB):$(LD_LIBRARY_PATH)
7972	endif
7973	endif
7974
7975	# WORKAROUND:
7976	# Both files included automatically, 1st include is included from 2nd one,
7977	# but moc can't include it due to problem with parsing framework structure,
7978	# as a result QT_VERSION can't be calculated and it's not only used in our
7979	# GUI but by the moc itself to parse modern signal/slot definitions.
7980	# We were hardcoding QT_VERSION for TEMPLATE_VBoxQtGuiExe below for quite
7981	# a long, but this have to end. Instead we can pass both includes manually.
7982	TOOL_QT5_MOCFLAGS.darwin += --include qconfig.h --include qglobal.h
7983	endif # defined(VBOX_WITH_QTGUI) \|\| defined(VBOX_WITH_NLS)
7984
7985	ifdef VBOX_WITH_QTGUI
7986	#
7987	# Template for building Qt GUI executables.
7988	#
7989	TEMPLATE_VBoxQtGuiExe = VBox Qt GUI Executable
7990	TEMPLATE_VBoxQtGuiExe_USES := qt6
7991	TEMPLATE_VBoxQtGuiExe_QTTOOL := QT6
7992	TEMPLATE_VBoxQtGuiExe_MOCTOOL := QT6
7993	TEMPLATE_VBoxQtGuiExe_UICTOOL := QT6
7994	TEMPLATE_VBoxQtGuiExe_RCCTOOL := QT6
7995	TEMPLATE_VBoxQtGuiExe_LRCTOOL := QT6
7996	TEMPLATE_VBoxQtGuiExe_SDKS := QT6
7997	TEMPLATE_VBoxQtGuiExe_QT_INFIX = $(VBOX_QT_INFIX)
7998	TEMPLATE_VBoxQtGuiExe_DEFS = IN_RING3 QT_NO_DEBUG QT_THREAD_SUPPORT QT_SHARED HAVE_CONFIG_H $(ARCH_BITS_DEFS)
7999	TEMPLATE_VBoxQtGuiExe_RCDEFS = $(TEMPLATE_VBoxR3Exe_RCDEFS)
8000
8001	ifeq ($(KBUILD_TARGET),win)
8002	# Note! Only use VBOX_VCC_CRT_TYPE when it matches VBOX_QT_DBG.
8003	TEMPLATE_VBoxQtGuiExe_TOOL = $(VBOX_VCC_TOOL)
8004	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8005	TEMPLATE_VBoxQtGuiExe_SDKS = WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)
8006	endif
8007	TEMPLATE_VBoxQtGuiExe_DEFS += \
8008	_WIN32_WINNT=0x0500 UNICODE _UNICODE \
8009	QT_DLL _CRT_SECURE_NO_DEPRECATE \
8010	$(QMAKE_PRL_DEFINES)
8011	TEMPLATE_VBoxQtGuiExe_CXXFLAGS = -nologo -Zm200 -MD$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),) \
8012	-Zi -EHsc $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS) $(VBOX_VCC_std)
8013	# -wd4481: nonstandard extension used: override specifier 'override'
8014	# -wd4625: 'QRubberBand' : copy constructor could not be generated because a base class copy constructor is inaccessible
8015	# -wd4626: 'QRubberBand' : assignment operator could not be generated because a base class assignment operator is inaccessible
8016	# -wd4640: qmetatype.h(2210): warning C4640: 'f' : construction of local static object is not thread-safe [too bad]
8017	# -wd4350: behavior change: 'int QStringList::indexOf(const QRegExp &,int) const' called instead of 'int QStringList::indexOf(QRegExp &,int) const'
8018	# -wd4121: UIActionPool.h(393) : warning C4121: 'UIActionPool::PointerToFunction' : alignment of a member was sensitive to packing
8019	# -wd4718: qmap.h(222) : warning C4718: 'QMapNode<enum DetailsElementType,bool>::destroySubTree' : recursive call has no side effects, deleting
8020	# -wd5204: pplwin.h(78): warning C5204: 'Concurrency::details::_DefaultPPLTaskScheduler': class has virtual functions
8021	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += $(VBOX_VCC_WARN_ALL) -wd4481 -wd4625 -wd4626 -wd4640 -wd4350 -wd4371 -wd4121 -wd4718 -wd5204 $(VBOX_VCC_WERR)
8022	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
8023	# -wd4619: qvectro.h(305 : warning C4619: #pragma warning : there is no warning number '4345'
8024	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd4619
8025	endif
8026	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8027	# -wd4774: string(530): warning C4774: '_scprintf' : format string expected in argument 1 is not a string literal
8028	# -wd4456: UICommon.cpp(1471): warning C4456: declaration of '_container_' hides previous local declaration [nested foreach]
8029	# -wd4458: UISettingsDialogSpecific.cpp(416): warning C4458: declaration of 'data' hides class member
8030	# qwidget.h(730): note: see declaration of 'QWidget::data'
8031	# -wd4946: qmap.h(213): warning C4946: reinterpret_cast used between related classes: 'QMapNodeBase' and 'QMapNode<Key,T>'
8032	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd4774 -wd4456 -wd4458 -wd4946
8033	endif
8034	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC141"
8035	# -wd4866: UIVirtualBoxManager.cpp(221) : warning C4866: compiler may not enforce left-to-right evaluation order for call to 'QStringList::operator<<'
8036	# Only with -std=c++17 and later.
8037	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd4866
8038	endif
8039	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # With v16.11.9, not with v16.6.0 4242
8040	# -wd5219: qpoint.h(187): warning C5219: implicit conversion from 'const int' to 'float', possible loss of data
8041	# -wd5240: qcolor.h(235): warning C5240: 'nodiscard': attribute is ignored in this syntactic position
8042	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd5219 -wd5240
8043	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += /volatileMetadata- # Don't waste space on x86/amd64-on-arm emulation optimizations.
8044	endif
8045	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC143" # (with qt 6.5.3 - reevalue when upgrading qt)
8046	# -wd5246: qobjectdefs.h(203): warning C5246: '_Elems': the initialization of a subobject should be wrapped in braces
8047	# -wd5249: qstyleoption.h(207): warning C5249: 'QStyleOptionHeaderV2::textElideMode' of type 'Qt::TextElideMode' has named enumerators with values that cannot be represented in the given bit field width of '2'
8048	# -wd5266: qhash.h(1083): warning C5266: 'const' qualifier on return type has no effect
8049	# -wd5267: qlist.h(50): warning C5267: definition of implicit copy constructor for 'QListSpecialMethods<T>' is deprecated because it has a user-provided destructor
8050	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd5246 -wd5249 -wd5266 -wd5267
8051	endif
8052	if1of ($(KBUILD_TARGET_ARCH), arm64) # (with qt 6.8.0)
8053	# -wd4668: qnumeric.h(88): warning C4668: 'Q_CC_GNU' is not defined as a preprocessor macro, replacing with '0' for '#if/#elif'
8054	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd4668
8055	endif
8056
8057	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -Gy
8058	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
8059	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -Gw
8060	endif
8061	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
8062	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -Zc:inline
8063	endif
8064	ifdef VBOX_WITH_MSC_ANALYZE_THIS
8065	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += /analyze
8066	endif
8067
8068	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.debug = -RTCsu
8069	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.debug = -RTCsu
8070	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.dbgopt = $(NO_SUCH_VARIABLE)
8071	TEMPLATE_VBoxQtGuiExe_PCHFLAGS = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS)
8072	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.debug = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.debug)
8073	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.dbgopt)
8074	TEMPLATE_VBoxQtGuiExe_LDFLAGS = -Ignore:4197 \
8075	/NOD /INCREMENTAL:NO /MAPINFO:EXPORTS /LargeAddressAware /DynamicBase /NxCompat /Release /Debug /Opt:Ref /Opt:Icf \
8076	$(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS) \
8077	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
8078	/STUB:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
8079	if defined(VBOX_SIGNING_MODE) && defined(VBOX_WITH_HARDENING) && !defined(VBOX_WITHOUT_WINDOWS_KERNEL_CODE_SIGNING_CERT)
8080	TEMPLATE_VBoxQtGuiExe_LDFLAGS += -IntegrityCheck
8081	endif
8082	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
8083	TEMPLATE_VBoxQtGuiExe_LDFLAGS += -EmitVolatileMetadata:NO
8084	endif
8085	TEMPLATE_VBoxQtGuiExe_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
8086	TEMPLATE_VBoxQtGuiExe_LDFLAGS.win.arm64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
8087
8088	TEMPLATE_VBoxQtGuiExe_SDKS += $(VBOX_WINPSDK)
8089	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8090	TEMPLATE_VBoxQtGuiExe_LATE_LIBS = \
8091	$(VBOX_LIBS_QT) \
8092	$(LIB_RUNTIME) \
8093	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/vcruntime$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
8094	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/msvcrt$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
8095	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/msvcprt$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
8096	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/oldnames.lib \
8097	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/delayimp.lib
8098	ifeq ($(KBUILD_TYPE),asan)
8099	TEMPLATE_VBoxQtGuiExe_LATE_LIBS += \
8100	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/clang_rt.asan_dynamic-x86_64.lib \
8101	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/clang_rt.asan_dynamic_runtime_thunk-x86_64.lib
8102	endif
8103	else
8104	TEMPLATE_VBoxQtGuiExe_LATE_LIBS = \
8105	$(VBOX_LIBS_QT) \
8106	$(LIB_RUNTIME) \
8107	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/msvcprt$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
8108	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/msvcrt$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
8109	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/oldnames.lib \
8110	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/delayimp.lib
8111	endif
8112	TEMPLATE_VBoxQtGuiExe_POST_CMDS = $(VBOX_UTF8_MANIFEST_CMDS)$(NLTAB)$(VBOX_SIGN_IMAGE_CMDS)
8113	TEMPLATE_VBoxQtGuiExe_ORDERDEPS = $(VBOX_SIGN_IMAGE_CMDS_ORDERDEPS)
8114
8115	else # the gcc guys:
8116	TEMPLATE_VBoxQtGuiExe_TOOL = $(VBOX_GCC_TOOL)
8117	if $(VBOX_GCC_VERSION_CC) < 30400
8118	TEMPLATE_VBoxQtGuiExe_DEFS += RT_WITHOUT_PRAGMA_ONCE
8119	endif
8120	TEMPLATE_VBoxQtGuiExe_DEFS.linux = _REENTRANT
8121	TEMPLATE_VBoxQtGuiExe_DEFS.solaris = _REENTRANT
8122
8123	## @todo Use VBOX_GCC_PEDANTIC_CXX?
8124	TEMPLATE_VBoxQtGuiExe_CXXFLAGS = \
8125	-g $(VBOX_GCC_pipe) $(filter-out -Wno-unused $(VBOX_GCC_Wno-unused-parameter),$(VBOX_GCC_WARN)) -frtti -fno-exceptions \
8126	-Wno-long-long -fshort-wchar -fno-strict-aliasing \
8127	$(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_Wno-multistatement-macros) $(VBOX_GCC_Wno-ignored-qualifiers) \
8128	$(VBOX_GCC_Wno-return-type-c-linkage) $(VBOX_GCC_std) $(VBOX_GCC_IPRT_FMT_CHECK) $(VBOX_GCC_SANITIZER_FLAGS)
8129	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
8130	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += $(VBOX_GCC_WERR)
8131	endif
8132	ifn1of ($(USERNAME), dsen serkan) # Bunch of stuff deprecated after 5.6.*. These guys knows how to deal with it. :)
8133	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += $(VBOX_GCC_Wno-deprecated-declarations)
8134	endif
8135	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -std=gnu++17
8136	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.x86 = -m32
8137	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.amd64 = -m64
8138	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.linux = -pthread
8139	TEMPLATE_VBoxQtGuiExe_PCHFLAGS = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS)
8140	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.x86 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.x86)
8141	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.amd64 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.amd64)
8142	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.linux = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.linux)
8143	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.debug = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.debug)
8144	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.dbgopt)
8145	TEMPLATE_VBoxQtGuiExe_OBJCFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) -fno-exceptions $(VBOX_GCC_IPRT_FMT_CHECK)
8146	TEMPLATE_VBoxQtGuiExe_OBJCFLAGS.x86 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.x86)
8147	TEMPLATE_VBoxQtGuiExe_OBJCFLAGS.amd64 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.amd64)
8148	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS = \
8149	-g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) \
8150	-frtti -fno-exceptions $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_IPRT_FMT_CHECK)
8151	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
8152	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS += $(VBOX_GCC_WERR)
8153	endif
8154	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS += -std=gnu++17
8155	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS.x86 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.x86)
8156	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS.amd64 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.amd64)
8157	TEMPLATE_VBoxQtGuiExe_LDFLAGS = $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS)
8158	TEMPLATE_VBoxQtGuiExe_LDFLAGS.x86 = -m32
8159	TEMPLATE_VBoxQtGuiExe_LDFLAGS.amd64 = -m64
8160	TEMPLATE_VBoxQtGuiExe_LATE_LIBS = \
8161	$(VBOX_LIBS_QT) \
8162	$(LIB_RUNTIME)
8163
8164	ifeq ($(KBUILD_TARGET),linux)
8165	TEMPLATE_VBoxQtGuiExe_LDFLAGS += -Wl,-z,noexecstack,-z,relro $(VBOX_LD_as_needed)
8166	TEMPLATE_VBOXQTGUIEXE_LDFLAGS += -Wl,-rpath,$(PATH_SDK_QT6_LIB)
8167	TEMPLATE_VBoxQtGuiExe_LATE_LIBS += \
8168	$(VBOX_XCURSOR_LIBS) \
8169	Xext \
8170	X11
8171	TEMPLATE_VBoxQtGuiExe_LIBPATH += \
8172	$(VBOX_LIBPATH_X11)
8173	else ifeq ($(KBUILD_TARGET),darwin)
8174	TEMPLATE_VBoxQtGuiExe_SDKS.darwin += $(VBOX_DARWIN_DEF_SDK_SDKS)
8175	TEMPLATE_VBoxQtGuiExe_DEFS.darwin += $(VBOX_DARWIN_DEF_SDK_DEFS)
8176	TEMPLATE_VBoxQtGuiExe_CFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_CFLAGS)
8177	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
8178	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.darwin += $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.darwin)
8179	TEMPLATE_VBoxQtGuiExe_OBJCFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_OBJCFLAGS)
8180	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS)
8181	TEMPLATE_VBoxQtGuiExe_LDFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -bind_at_load -Wl,-headerpad_max_install_names
8182	TEMPLATE_VBoxQtGuiExe_LATE_LIBS +=
8183	TEMPLATE_VBoxQtGuiExe_LIBPATH +=
8184	TEMPLATE_VBoxQtGuiExe_POST_CMDS.darwin = $(VBOX_SIGN_IMAGE_CMDS)
8185	else
8186	TEMPLATE_VBoxQtGuiExe_INCS += \
8187	$(VBOX_XCURSOR_INCS)
8188	TEMPLATE_VBoxQtGuiExe_LATE_LIBS += \
8189	$(VBOX_XCURSOR_LATE_LIBS) \
8190	Xext \
8191	X11 \
8192	m \
8193	$(LIB_PTHREAD)
8194	TEMPLATE_VBoxQtGuiExe_LIBPATH += \
8195	$(VBOX_LIBPATH_X11)
8196	ifeq ($(KBUILD_TARGET),freebsd)
8197	TEMPLATE_VBoxQtGuiExe_INCS += \
8198	/usr/include \
8199	/usr/X11R6/include \
8200	/usr/local/include
8201	TEMPLATE_VBoxQtGuiExe_LIBPATH += \
8202	/usr/lib \
8203	/usr/X11R6/lib \
8204	/usr/local/lib
8205	endif
8206	ifeq ($(KBUILD_TARGET),solaris)
8207	TEMPLATE_VBoxQtGuiExe_LDFLAGS.solaris = -Wl,-z,ignore # Same as VBOX_LD_as_needed.
8208	TEMPLATE_VBoxQtGuiExe_LATE_LIBS += \
8209	rt socket nsl
8210	endif
8211	endif
8212	# Assume the Qt shared objects are in the same directory as the executable, on Solaris too.
8213	ifdef VBOX_WITH_RUNPATH
8214	TEMPLATE_VBoxQtGuiExe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)'
8215	else ifdef VBOX_WITH_RELATIVE_RUNPATH
8216	TEMPLATE_VBoxQtGuiExe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)'
8217	endif
8218
8219	endif
8220
8221	# Add COM/XPCOM stuff
8222	TEMPLATE_VBoxQtGuiExe_LATE_LIBS += \
8223	$(PATH_STAGE_LIB)/VBoxCOM$(if-expr "$(VBOX_QT_DBG)" != "$(VBOX_VCC_CRT_TYPE)" && $(KBUILD_TARGET) == win,-GUI,)$(VBOX_SUFF_LIB)
8224	ifdef VBOX_WITH_XPCOM
8225	## @todo may be worth creating the VBOX_XPCOM SDK def, or just a SDK_VBOXXPCOM.
8226	TEMPLATE_VBoxQtGuiExe_DEFS += VBOX_WITH_XPCOM
8227	ifdef VBOX_WITH_XPCOM_NAMESPACE_CLEANUP
8228	TEMPLATE_VBoxQtGuiExe_DEFS += VBOX_WITH_XPCOM_NAMESPACE_CLEANUP
8229	endif
8230	TEMPLATE_VBoxQtGuiExe_INCS += \
8231	$(VBOX_XPCOM_INCS)
8232	TEMPLATE_VBoxQtGuiExe_LATE_LIBS += \
8233	$(LIB_XPCOM)
8234	TEMPLATE_VBoxQtGuiExe_INTERMEDIATES += \
8235	$(VBOX_PATH_SDK)/bindings/xpcom/include/VirtualBox_XPCOM.h
8236	else # COM
8237	TEMPLATE_VBoxQtGuiExe_INCS += \
8238	$(VBOX_PATH_SDK)/bindings/mscom/include
8239	TEMPLATE_VBoxQtGuiExe_INTERMEDIATES += \
8240	$(VBOX_PATH_SDK)/bindings/mscom/include/VirtualBox.h
8241	endif # COM
8242
8243	ifn1of ($(KBUILD_TARGET), darwin os2 win)
8244	TEMPLATE_VBoxQtGuiExe_DEFS += PIC
8245	TEMPLATE_VBoxQtGuiExe_CFLAGS += -fPIC
8246	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -fPIC
8247	# Needed for GCC 9. Even system's Qt 5.12.4 (on Ubuntu 19.10) did not have this fixed yet.
8248	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.linux = $(VBOX_GCC_Wno-deprecated-copy) $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS)
8249	TEMPLATE_VBoxQtGuiExe_LDFLAGS += -fPIC
8250	endif # not darwin, os2 or win
8251
8252	ifeq ($(KBUILD_TARGET),darwin)
8253	TEMPLATE_VBoxQtGuiExe_POST_CMDS = $(QUIET)install_name_tool $(foreach qtmod, $(VBOX_QT_MOD_NAMES), \
8254	$(foreach prefix, @executable_path/../Frameworks/ $(VBOX_PATH_QT)/Frameworks/ $(PATH_SDK_QT6)/, \
8255	-change "$(prefix)$(qtmod).framework/Versions/A/$(qtmod)" \
8256	"$(if $(VBOX_WITH_HARDENING),/Applications/VirtualBox.app/Contents/Frameworks,@rpath)/$(qtmod).framework/Versions/A/$(qtmod)" ) ) "$(out)"
8257	endif
8258
8259	#
8260	# Template for building Qt GUI components.
8261	#
8262	TEMPLATE_VBoxQtGuiDll = VBox Qt GUI Components
8263	TEMPLATE_VBoxQtGuiDll_EXTENDS = VBoxQtGuiExe
8264	TEMPLATE_VBoxQtGuiDll_LATE_LIBS = $(filter-out $(QTMAIN),$(TEMPLATE_VBoxQtGuiExe_LATE_LIBS))
8265	ifeq ($(KBUILD_TARGET),darwin)
8266	TEMPLATE_VBoxQtGuiDll_LDFLAGS.darwin += $(filter-out -bind_at_load,$(TEMPLATE_VBoxQtGuiExe_LDFLAGS.darwin)) \
8267	-current_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
8268	-compatibility_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
8269	endif
8270	ifn1of ($(KBUILD_TARGET), darwin os2 win)
8271	TEMPLATE_VBoxQtGuiDll_DEFS = PIC $(TEMPLATE_VBoxQtGuiExe_DEFS)
8272	TEMPLATE_VBoxQtGuiDll_CFLAGS = -fPIC $(TEMPLATE_VBoxQtGuiExe_CFLAGS)
8273	TEMPLATE_VBoxQtGuiDll_CXXFLAGS = -fPIC $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS)
8274	TEMPLATE_VBoxQtGuiDll_PCHFLAGS = $(TEMPLATE_VBoxQtGuiDll_CXXFLAGS)
8275	TEMPLATE_VBoxQtGuiDll_LDFLAGS = -fPIC $(TEMPLATE_VBoxQtGuiExe_LDFLAGS)
8276	endif
8277	endif # VBOX_WITH_QTGUI
8278
8279	ifdef VBOX_WITH_NLS
8280	#
8281	# Template for translation compilation.
8282	# Made as simple program without installing itself.
8283	# To archive it, the dummy code without runtime is used,
8284	# i.e. only compiler and system standard libs are linked.
8285	#
8286	TEMPLATE_VBoxNLS = VBox NLS template for installing translation files
8287	TEMPLATE_VBoxNLS_EXTENDS = VBoxR3Static
8288	TEMPLATE_VBoxNLS_USES := qt6
8289	TEMPLATE_VBoxNLS_QTTOOL := QT6
8290	TEMPLATE_VBoxNLS_QT_INFIX = $(VBOX_QT_INFIX)
8291	TEMPLATE_VBoxNLS_INSTTYPE = none
8292	TEMPLATE_VBoxNLS_LRCFLAGS += -silent
8293	TEMPLATE_VBoxNLS_QT_TRANSLATIONS_INST = $(INST_BIN)nls/
8294	TEMPLATE_VBoxNLS_SOURCES = \
8295	$(PATH_ROOT)/src/VBox/Main/nls/dummy.c
8296	TEMPLATE_VBoxNLS_SDKS.$(KBUILD_TARGET_ARCH) = $(filter-out VBoxOpenSslStatic,$(TEMPLATE_VBoxR3Static_SDKS.$(KBUILD_TARGET_ARCH)))
8297	ifdef VBOX_WITH_NOCRT_STATIC
8298	TEMPLATE_VBoxNLS_LATE_LIBS.$(KBUILD_TARGET_ARCH) = $(filter-out \
8299	$(PATH_STAGE_LIB)/VBox-libxml2-static$(VBOX_SUFF_LIB), \
8300	$(TEMPLATE_VBoxR3Static_LATE_LIBS.$(KBUILD_TARGET_ARCH)))
8301	else
8302	TEMPLATE_VBoxNLS_LATE_LIBS.$(KBUILD_TARGET_ARCH) = $(filter-out \
8303	$(VBOX_LIB_RUNTIME_STATIC) \
8304	$(PATH_STAGE_LIB)/VBox-libxml2-static$(VBOX_SUFF_LIB), \
8305	$(TEMPLATE_VBoxR3Static_LATE_LIBS.$(KBUILD_TARGET_ARCH)))
8306	endif
8307	endif # !VBOX_WITH_NLS
8308
8309
8310	#
8311	# Template for installing symbol files that we wish to ship.
8312	#
8313	TEMPLATE_VBoxDbgSyms = Symbol files for VBoxDbg and gurus.
8314	TEMPLATE_VBoxDbgSyms_INST = $(INST_VBOXDBG_SYMS)
8315
8316
8317	#
8318	# Template for building build bldprogs.
8319	# HACK ALERT! The BLD_TRG_* is a hack to allow building libraries as well.
8320	#
8321	TEMPLATE_VBoxBldProg = VBox Build Program
8322	TEMPLATE_VBoxBldProg_BLD_TRG := $(KBUILD_HOST)
8323	TEMPLATE_VBoxBldProg_BLD_TRG_ARCH := $(KBUILD_HOST_ARCH)
8324	TEMPLATE_VBoxBldProg_BLD_TRG_CPU := $(KBUILD_HOST_CPU)
8325	TEMPLATE_VBoxBldProg_DEFS := IN_RING3 LOG_DISABLED IN_BLD_PROG
8326	TEMPLATE_VBoxBldProg_DEFS.win := _CRT_SECURE_NO_DEPRECATE
8327	TEMPLATE_VBoxBldProg_ASTOOL.$(KBUILD_HOST).$(KBUILD_HOST_ARCH) := $(VBOX_ASTOOL.$(KBUILD_HOST).$(KBUILD_HOST_ARCH))
8328	TEMPLATE_VBoxBldProg_ASFLAGS.$(KBUILD_HOST).$(KBUILD_HOST_ARCH) = $(VBOX_ASFLAGS.$(KBUILD_HOST).$(KBUILD_HOST_ARCH))
8329	ifeq ($(KBUILD_HOST),win)
8330	TEMPLATE_VBoxBldProg_TOOL := $(VBOX_VCC_TOOL_STEM)$(toupper $(KBUILD_HOST_ARCH))
8331	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8332	TEMPLATE_VBoxBldProg_SDKS := ReorderCompilerIncs WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC $(VBOX_WINPSDK)
8333	else
8334	TEMPLATE_VBoxBldProg_SDKS := ReorderCompilerIncs $(VBOX_WINPSDK)
8335	endif
8336	TEMPLATE_VBoxBldProg_CXXFLAGS := -Zi -Zl -GR- -EHsc -GF $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_OPT) $(VBOX_VCC_FP) \
8337	-MT$(VBOX_VCC_CRT_TYPE) -Gy $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_std) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
8338	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
8339	TEMPLATE_VBoxBldProg_CXXFLAGS += -Gw
8340	endif
8341	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
8342	TEMPLATE_VBoxBldProg_CXXFLAGS += -Zc:inline
8343	endif
8344	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
8345	TEMPLATE_VBoxBldProg_CXXFLAGS += /volatileMetadata-
8346	endif
8347	ifdef VBOX_WITH_MSC_ANALYZE_THIS
8348	TEMPLATE_VBoxBldProg_CXXFLAGS += /analyze
8349	endif
8350	TEMPLATE_VBoxBldProg_CXXFLAGS.debug := -RTCsu
8351	TEMPLATE_VBoxBldProg_CXXFLAGS.dbgopt = $(NO_SUCH_VARIABLE)
8352	TEMPLATE_VBoxBldProg_CXXFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8353	TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8354	TEMPLATE_VBoxBldProg_CFLAGS = $(filter-out $(VBOX_VCC_std),$(TEMPLATE_VBoxBldProg_CXXFLAGS))
8355	TEMPLATE_VBoxBldProg_CFLAGS.debug = $(TEMPLATE_VBoxBldProg_CXXFLAGS.debug)
8356	TEMPLATE_VBoxBldProg_CFLAGS.dbgopt = $(TEMPLATE_VBoxBldProg_CXXFLAGS.dbgopt)
8357	TEMPLATE_VBoxBldProg_CFLAGS.release = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8358	TEMPLATE_VBoxBldProg_CFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8359	TEMPLATE_VBoxBldProg_CFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8360	TEMPLATE_VBoxBldProg_PCHFLAGS = $(TEMPLATE_VBoxBldProg_CXXFLAGS)
8361	TEMPLATE_VBoxBldProg_PCHFLAGS.debug = $(TEMPLATE_VBoxBldProg_CXXFLAGS.debug)
8362	TEMPLATE_VBoxBldProg_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxBldProg_CXXFLAGS.dbgopt)
8363	TEMPLATE_VBoxBldProg_PCHFLAGS.release = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8364	TEMPLATE_VBoxBldProg_PCHFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8365	TEMPLATE_VBoxBldProg_PCHFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8366	TEMPLATE_VBoxBldProg_LDFLAGS = -Ignore:4197 \
8367	/NOD /INCREMENTAL:NO /MAPINFO:EXPORTS /LargeAddressAware /DynamicBase /NxCompat /Release /Debug /Opt:Ref /Opt:Icf \
8368	$(VBOX_VCC_LD_GUARD_CF) \
8369	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
8370	/DISALLOWLIB:libc$(VBOX_VCC_CRT_TYPE_N).lib \
8371	/DISALLOWLIB:libcmt$(VBOX_VCC_CRT_TYPE_N).lib \
8372	/DISALLOWLIB:msvcrt.lib \
8373	/DISALLOWLIB:msvcrtd.lib \
8374	/DISALLOWLIB:msvcprt.lib \
8375	/DISALLOWLIB:msvcprtd.lib \
8376	/DISALLOWLIB:libvcruntime$(VBOX_VCC_CRT_TYPE_N).lib \
8377	/DISALLOWLIB:libucrt$(VBOX_VCC_CRT_TYPE_N).lib \
8378	/DISALLOWLIB:vcruntime.lib \
8379	/DISALLOWLIB:vcruntimed.lib \
8380	/DISALLOWLIB:ucrt.lib \
8381	/DISALLOWLIB:ucrtd.lib
8382	TEMPLATE_VBoxBldProg_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
8383	TEMPLATE_VBoxBldProg_LDFLAGS.win.arm64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
8384	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
8385	TEMPLATE_VBoxBldProg_LDFLAGS += -EmitVolatileMetadata:NO
8386	endif
8387	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8388	TEMPLATE_VBoxBldProg_LATE_LIBS = \
8389	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libvcruntime$(VBOX_VCC_CRT_TYPE).lib \
8390	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8391	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
8392	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/oldnames.lib
8393	else
8394	TEMPLATE_VBoxBldProg_LATE_LIBS = \
8395	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/oldnames.lib \
8396	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8397	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
8398	endif
8399
8400	else
8401	# (gcc of some kind )
8402	TEMPLATE_VBoxBldProg_TOOL = GXX3
8403	if $(VBOX_GCC_VERSION_CC) < 30400
8404	TEMPLATE_VBoxBldProg_DEFS += RT_WITHOUT_PRAGMA_ONCE
8405	endif
8406	TEMPLATE_VBoxBldProg_CFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros)
8407	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
8408	TEMPLATE_VBoxBldProg_CFLAGS += $(VBOX_GCC_WERR)
8409	endif
8410	TEMPLATE_VBoxBldProg_CFLAGS.x86 = -m32
8411	TEMPLATE_VBoxBldProg_CFLAGS.sparc32 = -m32
8412	TEMPLATE_VBoxBldProg_CFLAGS.amd64 = -m64
8413	TEMPLATE_VBoxBldProg_CFLAGS.sparc64 = -m64
8414	TEMPLATE_VBoxBldProg_CFLAGS.release = -O2 -fno-omit-frame-pointer -fno-strict-aliasing
8415	TEMPLATE_VBoxBldProg_CFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8416	TEMPLATE_VBoxBldProg_CFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8417	TEMPLATE_VBoxBldProg_CXXFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_std)
8418	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
8419	TEMPLATE_VBoxBldProg_CXXFLAGS += $(VBOX_GCC_WERR)
8420	endif
8421	TEMPLATE_VBoxBldProg_CXXFLAGS.x86 = -m32
8422	TEMPLATE_VBoxBldProg_CXXFLAGS.sparc32 = -m32
8423	TEMPLATE_VBoxBldProg_CXXFLAGS.amd64 = -m64
8424	TEMPLATE_VBoxBldProg_CXXFLAGS.sparc64 = -m64
8425	TEMPLATE_VBoxBldProg_CXXFLAGS.release = -O2 -fno-omit-frame-pointer -fno-strict-aliasing
8426	TEMPLATE_VBoxBldProg_CXXFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8427	TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8428	TEMPLATE_VBoxBldProg_OBJCFLAGS = $(TEMPLATE_VBoxBldProg_CFLAGS)
8429	TEMPLATE_VBoxBldProg_OBJCFLAGS.x86 = $(TEMPLATE_VBoxBldProg_CFLAGS.x86)
8430	TEMPLATE_VBoxBldProg_OBJCFLAGS.amd64 = $(TEMPLATE_VBoxBldProg_CFLAGS.amd64)
8431	TEMPLATE_VBoxBldProg_OBJCFLAGS.release = $(TEMPLATE_VBoxBldProg_CFLAGS.release)
8432	TEMPLATE_VBoxBldProg_OBJCFLAGS.profile = $(TEMPLATE_VBoxBldProg_CFLAGS.profile)
8433	TEMPLATE_VBoxBldProg_OBJCFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CFLAGS.kprofile)
8434	TEMPLATE_VBoxBldProg_OBJCXXFLAGS = $(TEMPLATE_VBoxBldProg_CXXFLAGS)
8435	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.x86 = $(TEMPLATE_VBoxBldProg_CXXFLAGS.x86)
8436	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.amd64 = $(TEMPLATE_VBoxBldProg_CXXFLAGS.amd64)
8437	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.release = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8438	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8439	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8440	TEMPLATE_VBoxBldProg_PCHFLAGS = $(TEMPLATE_VBoxBldProg_CXXFLAGS)
8441	TEMPLATE_VBoxBldProg_PCHFLAGS.x86 = $(TEMPLATE_VBoxBldProg_CXXFLAGS.x86)
8442	TEMPLATE_VBoxBldProg_PCHFLAGS.amd64 = $(TEMPLATE_VBoxBldProg_CXXFLAGS.amd64)
8443	TEMPLATE_VBoxBldProg_PCHFLAGS.release = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8444	TEMPLATE_VBoxBldProg_PCHFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8445	TEMPLATE_VBoxBldProg_PCHFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8446	TEMPLATE_VBoxBldProg_LDFLAGS.x86 = -m32
8447	TEMPLATE_VBoxBldProg_LDFLAGS.sparc32 = -m32
8448	TEMPLATE_VBoxBldProg_LDFLAGS.amd64 = -m64
8449	TEMPLATE_VBoxBldProg_LDFLAGS.sparc64 = -m64
8450	ifeq ($(KBUILD_HOST),linux)
8451	TEMPLATE_VBoxBldProg_LATE_LIBS = pthread m rt dl
8452	else ifeq ($(KBUILD_HOST),os2)
8453	TEMPLATE_VBoxBldProg_TOOL = GXX3OMF
8454	TEMPLATE_VBoxBldProg_LATE_LIBS = socket iconv
8455	else ifeq ($(KBUILD_HOST),darwin)
8456	TEMPLATE_VBoxBldProg_TOOL = $(VBOX_GCC_TOOL)
8457	if "$(VBOX_DEF_MACOSX_VERSION_MIN)" == "10.7" \|\| "$(VBOX_DARWIN_HOST_VERSION_MAJOR)" == "7"
8458	TEMPLATE_VBoxBldProg_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_DEFS)
8459	TEMPLATE_VBoxBldProg_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_CFLAGS) -fno-common
8460	TEMPLATE_VBoxBldProg_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_CXXFLAGS)
8461	TEMPLATE_VBoxBldProg_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_CXXFLAGS)
8462	TEMPLATE_VBoxBldProg_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_OBJCFLAGS) $(VBOX_GCC_PEDANTIC_C)
8463	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_OBJCXXFLAGS) $(VBOX_GCC_PEDANTIC_CXX)
8464	TEMPLATE_VBoxBldProg_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_LDFLAGS)
8465	else if "$(VBOX_DEF_MACOSX_VERSION_MIN)" == "10.6" \|\| "$(VBOX_DARWIN_HOST_VERSION_MAJOR)" == "6"
8466	TEMPLATE_VBoxBldProg_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_DEFS)
8467	TEMPLATE_VBoxBldProg_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_CFLAGS) -fno-common
8468	TEMPLATE_VBoxBldProg_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_CXXFLAGS)
8469	TEMPLATE_VBoxBldProg_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_CXXFLAGS)
8470	TEMPLATE_VBoxBldProg_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_OBJCFLAGS) $(VBOX_GCC_PEDANTIC_C)
8471	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_OBJCXXFLAGS) $(VBOX_GCC_PEDANTIC_CXX)
8472	TEMPLATE_VBoxBldProg_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_LDFLAGS)
8473	else if "$(VBOX_DEF_MACOSX_VERSION_MIN)" == "10.5" \|\| "$(VBOX_DARWIN_HOST_VERSION_MAJOR)" == "5" \|\| defined(VBOX_MACOS_10_5_WORKAROUND)
8474	TEMPLATE_VBoxBldProg_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_DEFS)
8475	TEMPLATE_VBoxBldProg_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_CFLAGS) -fno-common
8476	TEMPLATE_VBoxBldProg_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_CXXFLAGS)
8477	TEMPLATE_VBoxBldProg_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_CXXFLAGS)
8478	TEMPLATE_VBoxBldProg_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_OBJCFLAGS) $(VBOX_GCC_PEDANTIC_C)
8479	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_OBJCXXFLAGS) $(VBOX_GCC_PEDANTIC_CXX)
8480	TEMPLATE_VBoxBldProg_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_LDFLAGS)
8481	else
8482	TEMPLATE_VBoxBldProg_SDKS.darwin = $(VBOX_DARWIN_DEF_SDK_SDKS)
8483	TEMPLATE_VBoxBldProg_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_DEFS)
8484	TEMPLATE_VBoxBldProg_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CFLAGS) -fno-common
8485	TEMPLATE_VBoxBldProg_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
8486	TEMPLATE_VBoxBldProg_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
8487	TEMPLATE_VBoxBldProg_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_OBJCFLAGS) $(VBOX_GCC_PEDANTIC_C)
8488	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS) $(VBOX_GCC_PEDANTIC_CXX)
8489	TEMPLATE_VBoxBldProg_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_LDFLAGS)
8490	endif
8491	TEMPLATE_VBoxBldProg_LATE_LIBS =
8492	else ifeq ($(KBUILD_HOST),haiku)
8493	TEMPLATE_VBoxBldProg_TOOL = GXX3
8494	TEMPLATE_VBoxBldProg_LATE_LIBS = network iconv
8495	TEMPLATE_VBoxBldProg_LIBPATH += \
8496	/boot/common/lib
8497	else if1of ($(KBUILD_HOST), freebsd openbsd)
8498	TEMPLATE_VBoxBldProg_TOOL = $(VBOX_GCC_TOOL)
8499	TEMPLATE_VBoxBldProg_LATE_LIBS = pthread
8500	TEMPLATE_VBoxBldProg_INCS += \
8501	/usr/include \
8502	/usr/X11R6/include \
8503	/usr/local/include
8504	TEMPLATE_VBoxBldProg_LIBPATH += \
8505	/usr/lib \
8506	/usr/X11R6/lib \
8507	/usr/local/lib
8508	else ifeq ($(KBUILD_HOST),netbsd)
8509	TEMPLATE_VBoxBldProg_TOOL = GXX3
8510	TEMPLATE_VBoxBldProg_LATE_LIBS = pthread
8511	TEMPLATE_VBoxBldProg_INCS += \
8512	/usr/include \
8513	/usr/X11R7/include
8514	TEMPLATE_VBoxBldProg_LIBPATH += \
8515	/usr/lib \
8516	/usr/X11R7/lib
8517	else ifeq ($(KBUILD_HOST),solaris)
8518	TEMPLATE_VBoxBldProg_TOOL = GXX3PLAIN
8519	TEMPLATE_VBoxBldProg_LATE_LIBS = rt
8520	else
8521	$(warning Warning: VBOX Build: Target $(KBUILD_HOST) is not officially supported!)
8522	endif
8523
8524	endif # !win
8525
8526
8527	#
8528	# Advanced build programs using IPRT and stuff.
8529	#
8530	TEMPLATE_VBoxAdvBldProg = Advanced VBox Build Program
8531	TEMPLATE_VBoxAdvBldProg_EXTENDS = VBoxBldProg
8532	TEMPLATE_VBoxAdvBldProg_SDKS = $(TEMPLATE_VBoxBldProg_SDKS)
8533	TEMPLATE_VBoxAdvBldProg_SDKS.win = $(TEMPLATE_VBoxBldProg_SDKS.win) VBoxNtDll
8534	TEMPLATE_VBoxAdvBldProg_DEFS = $(TEMPLATE_VBoxBldProg_DEFS) IN_RT_R3 IN_ADV_BLD_PROG
8535	ifeq ($(KBUILD_HOST),win)
8536	TEMPLATE_VBoxAdvBldProg_CFLAGS = $(TEMPLATE_VBoxBldProg_CFLAGS) $(VBOX_VCC_WERR)
8537	TEMPLATE_VBoxAdvBldProg_CXXFLAGS = $(TEMPLATE_VBoxBldProg_CXXFLAGS) $(VBOX_VCC_WERR)
8538	TEMPLATE_VBoxAdvBldProg_PCHFLAGS = $(TEMPLATE_VBoxAdvBldProg_CXXFLAGS)
8539	endif
8540	TEMPLATE_VBoxAdvBldProg_LDFLAGS.darwin.arm64 = \
8541	$(TEMPLATE_VBoxBldProg_LDFLAGS.darwin.arm64) -framework IOKit
8542	TEMPLATE_VBoxAdvBldProg_LATE_LIBS = \
8543	$(PATH_STAGE_LIB)/RuntimeBldProg$(VBOX_HOSTSUFF_LIB) \
8544	$(TEMPLATE_VBoxBldProg_LATE_LIBS)
8545	TEMPLATE_VBoxAdvBldProg_LATE_LIBS.darwin = \
8546	$(TEMPLATE_VBoxAdvBldProg_LATE_LIBS) \
8547	iconv \
8548	$(TEMPLATE_VBoxBldProg_LATE_LIBS.darwin)
8549	TEMPLATE_VBoxAdvBldProg_LATE_LIBS.freebsd = \
8550	$(TEMPLATE_VBoxAdvBldProg_LATE_LIBS) \
8551	iconv \
8552	rt \
8553	$(TEMPLATE_VBoxBldProg_LATE_LIBS.freebsd)
8554	TEMPLATE_VBoxAdvBldProg_LATE_LIBS.linux = \
8555	$(TEMPLATE_VBoxAdvBldProg_LATE_LIBS) \
8556	$(TEMPLATE_VBoxBldProg_LATE_LIBS.linux)
8557	TEMPLATE_VBoxAdvBldProg_LATE_LIBS.solaris = \
8558	$(TEMPLATE_VBoxAdvBldProg_LATE_LIBS) \
8559	contract \
8560	kstat \
8561	rt \
8562	socket \
8563	nsl \
8564	$(TEMPLATE_VBoxBldProg_LATE_LIBS.solaris)
8565
8566
8567	#
8568	# Windows rc workaround for crosscompiling.
8569	# (Some (old) Wine versions fails loading msvcrt.dll from the VCC bin directory.)
8570	#
8571	ifneq ($(KBUILD_HOST),win)
8572	TOOL_VCC80X86_RC := $(EXEC_X86_WIN32) $(KBUILD_DEVTOOLS)/win.x86/bin/rc.exe
8573	TOOL_VCC80AMD64_RC := $(EXEC_X86_WIN32) $(KBUILD_DEVTOOLS)/win.x86/bin/rc.exe
8574	TOOL_VCC70_RC := $(EXEC_X86_WIN32) $(KBUILD_DEVTOOLS)/win.x86/bin/rc.exe
8575	WIN32_MC = $(EXEC_X86_WIN32) $(KBUILD_DEVTOOLS)/win.x86/bin/mc.exe
8576	else
8577	WIN32_MC = $(EXEC_X86_WIN32) $(firstword $(wildcard \
8578	$(PATH_SDK_$(VBOX_WINPSDK)_BIN)/MC.Exe \
8579	$(PATH_SDK_WINPSDK_BIN)/MC.Exe \
8580	$(PATH_SDK_WINPSDK)/Bin/MC.Exe \
8581	$(PATH_SDK_WIN32SDK_BIN)/MC.Exe \
8582	$(PATH_SDK_WIN64SDK_BIN)/MC.Exe \
8583	$(KBUILD_DEVTOOLS)/win.x86/bin/mc.exe \
8584	) Sorry_Cannot_find_mc_in_the_PSDK)
8585	endif
8586
8587
8588	#
8589	# Base template for building R3 programs for the guest additions.
8590	# Do _note_ use directly!
8591	#
8592	## @todo bake it into VBoxGuestR3Exe.
8593	TEMPLATE_VBoxGuestR3ExeBase = VBox Guest Program
8594	ifeq ($(KBUILD_TARGET),win)
8595	TEMPLATE_VBoxGuestR3ExeBase_EXTENDS = VBoxR3StaticBase
8596	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8597	ifdef VBOX_WITH_NOCRT_STATIC
8598	TEMPLATE_VBoxGuestR3ExeBase_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK_GST) VBoxNtDll
8599	else
8600	TEMPLATE_VBoxGuestR3ExeBase_SDKS = ReorderCompilerIncs WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC $(VBOX_WINPSDK_GST) VBoxNtDll
8601	endif
8602	else
8603	TEMPLATE_VBoxGuestR3ExeBase_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK_GST) VBoxNtDll
8604	endif
8605	# Hack for running on NT3x, NT4, W2K and XP w/o SP:
8606	# 1. Change OS and subsystem version in the image.
8607	# 2. NT 3.1 requires the IAT to be writable. To avoid making all of .rdata
8608	# writable we use the undocumented -NoOptIData option to prevent .idata$*
8609	# from being merged into .rdata.
8610	# 3. NT 3.1 doesn't support merging initialized and uninitialized section
8611	# because it doesn't recognize Misc.VirtualSize. So, we set the uncached
8612	# flag (!K) on the .bss section make it incompatible with .data.
8613	# VBOX_PE_SET_VERSION will clear the !K flag. (Not needed in no-CRT mode,
8614	# as the init code zeros uninitialized data there when running on NT 3.1.)
8615	# Similarly, for XP64 and 64-bit W2K3 we need to make sure the subsystem version
8616	# in the binaries are set to 5.2. The Visual C++ 2019 linker defaults to 6.0.
8617	# HACK ALERT! Double expansion of $$(NLTAB).
8618	TEMPLATE_VBoxGuestR3ExeBase_USES.win = $(TEMPLATE_VBoxR3StaticBase_USES.win) vboximportchecker vboxsetpeversion
8619	TEMPLATE_VBoxGuestR3ExeBase_VBOX_IMPORT_CHECKER.win.x86 = nt31
8620	TEMPLATE_VBoxGuestR3ExeBase_VBOX_IMPORT_CHECKER.win.amd64 = xp64
8621	TEMPLATE_VBoxGuestR3ExeBase_VBOX_IMPORT_CHECKER.win.arm64 = w10-1709
8622	TEMPLATE_VBoxGuestR3ExeBase_VBOX_SET_PE_VERSION.win.x86 = default
8623	TEMPLATE_VBoxGuestR3ExeBase_VBOX_SET_PE_VERSION.win.amd64 = default
8624	TEMPLATE_VBoxGuestR3ExeBase_VBOX_SET_PE_VERSION.win.arm64 = default
8625	ifdef VBOX_WITH_NOCRT_STATIC
8626	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.win.x86 = $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LDFLAGS.win.x86) -NoOptIData
8627	else
8628	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.win.x86 = -NoOptIData -Section:.bss,RW!K $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LDFLAGS.win.x86)
8629	endif
8630
8631	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
8632	TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS.win.x86 = $(NO_SUCH_VARIABLE)# Ditch RuntimeR3VccTricks2
8633	endif
8634
8635	else # the gcc guys
8636	TEMPLATE_VBoxGuestR3ExeBase_EXTENDS = VBoxR3Exe
8637	ifn1of ($(KBUILD_TARGET), darwin)
8638	TEMPLATE_VBoxGuestR3ExeBase_TOOL := $(subst GXX,GCC,$(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_TOOL))
8639	endif
8640	TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS = $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_CXXFLAGS) -fno-exceptions -fno-rtti
8641	# Do not inherit sanitizer flags from VBoxR3Exe in guest executables. Deal with them separately.
8642	TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS.debug = $(NO_SUCH_VARIABLE)
8643	TEMPLATE_VBoxGuestR3ExeBase_CFLAGS.debug = $(NO_SUCH_VARIABLE)
8644	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.linux = $(filter-out $(VBOX_GCC_ORIGIN_OPT),$(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LDFLAGS.linux))
8645	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.debug = $(NO_SUCH_VARIABLE)
8646	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)%,$(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LDFLAGS))
8647	ifn1of ($(KBUILD_TARGET), darwin os2) # ELF only. Present in gcc 3.2.3 & binutils 2.15, possibly earlier.
8648	ifdef VBOX_LD_gc_sections # Older solaris linker versions doesn't grok --gc-sections (e.g. add build box).
8649	TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS += -ffunction-sections -fdata-sections
8650	TEMPLATE_VBoxGuestR3ExeBase_CFLAGS += -ffunction-sections -fdata-sections
8651	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS += $(VBOX_LD_gc_sections)
8652	endif
8653	endif
8654	endif
8655	TEMPLATE_VBoxGuestR3ExeBase_INST = $(INST_ADDITIONS)
8656	TEMPLATE_VBoxGuestR3ExeBase_DEFS := \
8657	$(filter-out $(ARCH_BITS_DEFS) VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3, $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_DEFS)) \
8658	IN_GUEST \
8659	IN_GUEST_R3 \
8660	IN_RT_R3 \
8661	IN_RT_STATIC \
8662	$(VBOX_GC_ARCH_BITS_DEFS) \
8663	RT_NEED_NEW_AND_DELETE
8664	ifeq ($(KBUILD_TARGET),linux) # As few libs as possible on linux.
8665	TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS = pthread rt m dl
8666	else if1of ($(KBUILD_TARGET), darwin freebsd openbsd)
8667	TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS = $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LATE_LIBS) iconv
8668	else ifeq ($(KBUILD_TARGET),solaris)
8669	TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS = $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LATE_LIBS) nsl
8670	endif
8671
8672	# Use older versions of APIs which were improved in versions of glibc later
8673	# than what we are targetting, and do not use the stack protector, which
8674	# needs glibc 2.4 or later.
8675	TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS.linux = \
8676	-include $(PATH_ROOT)/include/iprt/linux/symvers.h \
8677	$(VBOX_GCC_fno-stack-protector)
8678	TEMPLATE_VBoxGuestR3ExeBase_CFLAGS.linux = $(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS.linux)
8679	# The GNU_HASH ELF tag is not supported by older systems.
8680	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.linux += $(VBOX_LD_hash_style_sysv)
8681
8682
8683	#
8684	# Template for building normal R3 programs for the guest additions, strict.
8685	#
8686	TEMPLATE_VBoxGuestR3Exe = VBox Guest Program w/ IPRT and VBGL.
8687	TEMPLATE_VBoxGuestR3Exe_EXTENDS := VBoxGuestR3ExeBase
8688	ifeq ($(KBUILD_TARGET),win)
8689	TEMPLATE_VBoxGuestR3Exe_CFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CFLAGS) $(VBOX_VCC_WERR)
8690	TEMPLATE_VBoxGuestR3Exe_CXXFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS) $(VBOX_VCC_WERR)
8691	if1of ($(VBOX_VCC_TOOL_STEM), VCC120)
8692	# VBoxDrvInst.cpp(520) : warning C4313: 'wprintf' : '%d' in format string conflicts with argument 1 of type 'const TCHAR *' [false positive - buggy compiler?]
8693	TEMPLATE_VBoxGuestR3Exe_CXXFLAGS += -wd4313
8694	endif
8695	TEMPLATE_VBoxGuestR3Exe_LDFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS) $(VBOX_VCC_LD_WERR)
8696	ifndef VBOX_WITH_NOCRT_STATIC # Temporary kludge to deal with some link order issues.
8697	TEMPLATE_VBoxGuestR3Exe_LDFLAGS.win.x86 = $(TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.win.x86) -Include:_vcc100_kernel32_fakes_asm
8698	endif
8699	TEMPLATE_VBoxGuestR3Exe_LATE_LIBS.x86 = \
8700	$(VBOX_LIB_IPRT_GUEST_R3_X86) \
8701	$(VBOX_LIB_VBGL_R3_X86) \
8702	$(VBOX_LIB_IPRT_GUEST_R3_X86) \
8703	$(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS.x86)
8704	TEMPLATE_VBoxGuestR3Exe_LATE_LIBS.$(KBUILD_TARGET_ARCH) = \
8705	$(VBOX_LIB_IPRT_GUEST_R3) \
8706	$(VBOX_LIB_VBGL_R3) \
8707	$(VBOX_LIB_IPRT_GUEST_R3) \
8708	$(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS.$(KBUILD_TARGET_ARCH))
8709	else
8710	TEMPLATE_VBoxGuestR3Exe_CFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CFLAGS) $(VBOX_GCC_WERR)
8711	TEMPLATE_VBoxGuestR3Exe_CXXFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS) $(VBOX_GCC_WERR)
8712	TEMPLATE_VBoxGuestR3Exe_LATE_LIBS = \
8713	$(VBOX_LIB_IPRT_GUEST_R3) \
8714	$(VBOX_LIB_VBGL_R3) \
8715	$(VBOX_LIB_IPRT_GUEST_R3) \
8716	$(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS)
8717	ifeq ($(KBUILD_TARGET),solaris)
8718	TEMPLATE_VBoxGuestR3Exe_LATE_LIBS += contract
8719	endif
8720	endif
8721
8722	#
8723	# Template for building R3 (dynamic) libraries for the guest additions, relaxed.
8724	#
8725	TEMPLATE_VBoxGuestR3DllNonPedantic := VBox Guest User Dynamic Libraries w/ IPRT and VBGL, non-pedantic.
8726	TEMPLATE_VBoxGuestR3DllNonPedantic_EXTENDS := VBoxGuestR3ExeBase
8727	## @todo add a INSTFUN that separates dlls and libs.
8728	ifeq ($(KBUILD_TARGET),win)
8729	ifeq ($(KBUILD_TYPE),asan)
8730	TEMPLATE_VBoxGuestR3DllNonPedantic_LATE_LIBS.x86 = $(patsubst %clang_rt.asan-i386.lib, %clang_rt.asan_dll_thunk-i386.lib, $(filter-out %clang_rt.asan_cxx-i386.lib,$(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS.x86)))
8731	TEMPLATE_VBoxGuestR3DllNonPedantic_LATE_LIBS.amd64 = $(patsubst %clang_rt.asan-x86_64.lib, %clang_rt.asan_dll_thunk-x86_64.lib, $(filter-out %clang_rt.asan_cxx-x86_64.lib,$(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS.amd64)))
8732	endif
8733	else ifn1of ($(KBUILD_TARGET), darwin os2 win)
8734	TEMPLATE_VBoxGuestR3DllNonPedantic_DEFS = $(TEMPLATE_VBoxGuestR3ExeBase_DEFS) PIC
8735	TEMPLATE_VBoxGuestR3DllNonPedantic_CFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CFLAGS) -fPIC
8736	TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS) -fPIC -fno-exceptions
8737	TEMPLATE_VBoxGuestR3DllNonPedantic_LDFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS) -fPIC
8738	endif
8739	ifeq ($(KBUILD_TARGET),win)
8740	TEMPLATE_VBoxGuestR3DllNonPedantic_LATE_LIBS.x86 = \
8741	$(VBOX_LIB_IPRT_GUEST_R3_SHARED_X86) \
8742	$(VBOX_LIB_VBGL_R3_SHARED_X86) \
8743	$(VBOX_LIB_IPRT_GUEST_R3_SHARED_X86) \
8744	$(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS.x86)
8745	TEMPLATE_VBoxGuestR3DllNonPedantic_LATE_LIBS.$(KBUILD_TARGET_ARCH) = \
8746	$(VBOX_LIB_IPRT_GUEST_R3_SHARED) \
8747	$(VBOX_LIB_VBGL_R3_SHARED) \
8748	$(VBOX_LIB_IPRT_GUEST_R3_SHARED) \
8749	$(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS.$(KBUILD_TARGET_ARCH))
8750	else
8751	TEMPLATE_VBoxGuestR3DllNonPedantic_LATE_LIBS = \
8752	$(VBOX_LIB_IPRT_GUEST_R3_SHARED) \
8753	$(VBOX_LIB_VBGL_R3_SHARED) \
8754	$(VBOX_LIB_IPRT_GUEST_R3_SHARED) \
8755	$(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS)
8756	endif
8757
8758	#
8759	# Template for building normal R3 (dynamic) libraries for the guest additions, strict.
8760	#
8761	TEMPLATE_VBoxGuestR3Dll := VBox Guest User Dynamic Libraries w/ IPRT and VBGL.
8762	TEMPLATE_VBoxGuestR3Dll_EXTENDS := VBoxGuestR3DllNonPedantic
8763	ifeq ($(KBUILD_TARGET),win)
8764	TEMPLATE_VBoxGuestR3Dll_CFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_CFLAGS) $(VBOX_VCC_WERR)
8765	TEMPLATE_VBoxGuestR3Dll_CXXFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS) $(VBOX_VCC_WERR)
8766	TEMPLATE_VBoxGuestR3Dll_LDFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_LDFLAGS) $(VBOX_VCC_LD_WERR)
8767	else
8768	TEMPLATE_VBoxGuestR3Dll_CFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_CFLAGS) $(VBOX_GCC_WERR)
8769	TEMPLATE_VBoxGuestR3Dll_CXXFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS) $(VBOX_GCC_WERR)
8770	endif
8771
8772	#
8773	# Variant of VBoxGuestR3Dll that requires Windows 2000 or later for x86, and W2K3 for AMD64.
8774	#
8775	TEMPLATE_VBoxGuestR3DllMinW2K = VBox Guest User Dynamic Libraries w/ IPRT and VBGL.
8776	TEMPLATE_VBoxGuestR3DllMinW2K_EXTENDS = VBoxGuestR3Dll
8777	TEMPLATE_VBoxGuestR3DllMinW2K_VBOX_IMPORT_CHECKER.win.x86 = w2k
8778	TEMPLATE_VBoxGuestR3DllMinW2K_VBOX_SET_PE_VERSION.win.x86 = w2k
8779	ifeq ($(KBUILD_TARGET),win)
8780	ifdef VBOX_WITH_NOCRT_STATIC
8781	TEMPLATE_VBoxGuestR3DllMinW2K_LDFLAGS.win.x86 = $(filter-out -NoOptIData,$(TEMPLATE_VBoxGuestR3Dll_LDFLAGS.win.x86))
8782	else
8783	TEMPLATE_VBoxGuestR3DllMinW2K_LDFLAGS.win.x86 = $(filter-out -NoOptIData -Section:.bss$(COMMA)RW!K,$(TEMPLATE_VBoxGuestR3Dll_LDFLAGS.win.x86))
8784	endif
8785	endif
8786
8787	#
8788	# Variant of VBoxGuestR3Dll that requires Windows Vista or later.
8789	#
8790	TEMPLATE_VBoxGuestR3DllMinVista = VBox Guest User Dynamic Libraries w/ IPRT and VBGL.
8791	TEMPLATE_VBoxGuestR3DllMinVista_EXTENDS = VBoxGuestR3Dll
8792	TEMPLATE_VBoxGuestR3DllMinVista_VBOX_IMPORT_CHECKER.win.x86 = vista
8793	TEMPLATE_VBoxGuestR3DllMinVista_VBOX_IMPORT_CHECKER.win.amd64 = vista
8794	TEMPLATE_VBoxGuestR3DllMinVista_VBOX_IMPORT_CHECKER.win.arm64 = w10-1709
8795	TEMPLATE_VBoxGuestR3DllMinVista_VBOX_SET_PE_VERSION.win.x86 = vista
8796	TEMPLATE_VBoxGuestR3DllMinVista_VBOX_SET_PE_VERSION.win.amd64 = vista
8797	TEMPLATE_VBoxGuestR3DllMinVista_VBOX_SET_PE_VERSION.win.arm64 = w10
8798	ifeq ($(KBUILD_TARGET),win)
8799	ifdef VBOX_WITH_NOCRT_STATIC
8800	TEMPLATE_VBoxGuestR3DllMinVista_LDFLAGS.win.x86 = $(filter-out -NoOptIData,$(TEMPLATE_VBoxGuestR3Dll_LDFLAGS.win.x86))
8801	else
8802	TEMPLATE_VBoxGuestR3DllMinVista_LDFLAGS.win.x86 = $(filter-out -NoOptIData -Section:.bss$(COMMA)RW!K,$(TEMPLATE_VBoxGuestR3Dll_LDFLAGS.win.x86))
8803	endif
8804	endif
8805
8806	#
8807	# Template for building normal R3 (dynamic) libraries for the guest additions with Visual C++ 2013 or later, strict.
8808	#
8809	TEMPLATE_NewerVccVBoxGuestR3Dll = VBoxGuestR3DllNonPedantic with the newer Visual C++ version (2013 or later).
8810	TEMPLATE_NewerVccVBoxGuestR3Dll_EXTENDS = VBoxGuestR3DllNonPedantic
8811	if "$(KBUILD_TARGET)" == "win" && "$(VBOX_NEWER_VCC_TOOL_STEM)" != "$(VBOX_VCC_TOOL_STEM)"
8812	TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86 = $(VBOX_NEWER_VCC_TOOL_STEM)X86
8813	TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64 = $(VBOX_NEWER_VCC_TOOL_STEM)AMD64
8814	TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.arm64 = $(VBOX_NEWER_VCC_TOOL_STEM)ARM64
8815	TEMPLATE_NewerVccVBoxGuestR3Dll_CXXFLAGS = \
8816	$(filter-out $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR), $(TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS)) \
8817	$(VBOX_NEWER_VCC_WARN_ALL) $(VBOX_VCC_WERR)
8818	TEMPLATE_NewerVccVBoxGuestR3Dll_CFLAGS = $(TEMPLATE_NewerVccVBoxGuestR3DllNonPedantic_CXXFLAGS)
8819	ifndef VBOX_WITH_NOCRT_STATIC
8820	TEMPLATE_NewerVccVBoxGuestR3Dll_LATE_LIBS.x86 = \
8821	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86)_LIB)/oldnames.lib \
8822	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8823	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
8824	TEMPLATE_NewerVccVBoxGuestR3Dll_LATE_LIBS.amd64 = \
8825	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64)_LIB)/oldnames.lib \
8826	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8827	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
8828	TEMPLATE_NewerVccVBoxGuestR3Dll_LATE_LIBS.arm64 = \
8829	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.arm64)_LIB)/oldnames.lib \
8830	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.arm64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8831	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.arm64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
8832	endif # !VBOX_WITH_NOCRT_STATIC
8833	# Hack end
8834	endif
8835	TEMPLATE_NewerVccVBoxGuestR3Dll_LATE_LIBS = $(TEMPLATE_VBoxGuestR3ExeBase_LATE_LIBS) # Not sure why this is here...
8836
8837	#
8838	# Variant of NewerVccVBoxGuestR3Dll that requires Windows Vista or later.
8839	#
8840	TEMPLATE_NewerVccVBoxGuestR3DllMinVista = NewerVccVBoxGuestR3Dll with the newer Visual C++ version (2013 or later).
8841	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_EXTENDS := NewerVccVBoxGuestR3Dll
8842	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_VBOX_SET_PE_VERSION.win.x86 := vista
8843	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_VBOX_SET_PE_VERSION.win.amd64 := vista
8844	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_VBOX_SET_PE_VERSION.win.arm64 := w10
8845	ifeq ($(KBUILD_TARGET),win)
8846	ifdef VBOX_WITH_NOCRT_STATIC
8847	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_LDFLAGS.win.x86 = $(filter-out -NoOptIData,$(TEMPLATE_NewerVccVBoxGuestR3Dll_LDFLAGS.win.x86))
8848	else
8849	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_LDFLAGS.win.x86 = $(filter-out -NoOptIData -Section:.bss$(COMMA)RW!K,$(TEMPLATE_NewerVccVBoxGuestR3Dll_LDFLAGS.win.x86))
8850	endif
8851	endif
8852
8853	#
8854	# Template for building R3 (static) libraries for the guest additions, strict.
8855	#
8856	TEMPLATE_VBoxGuestR3Lib := VBox Guest User Dynamic Libraries w/ IPRT and VBGL.
8857	TEMPLATE_VBoxGuestR3Lib_EXTENDS := VBoxGuestR3ExeBase
8858	TEMPLATE_VBoxGuestR3Lib_EXTENDS_BY := appending
8859	TEMPLATE_VBoxGuestR3Lib_INST = $(INST_ADDITIONS_LIB)
8860	ifeq ($(KBUILD_TARGET),win)
8861	TEMPLATE_VBoxGuestR3Lib_CFLAGS += $(VBOX_VCC_WERR)
8862	TEMPLATE_VBoxGuestR3Lib_CXXFLAGS += $(VBOX_VCC_WERR)
8863	TEMPLATE_VBoxGuestR3Lib_LDFLAGS += $(VBOX_VCC_LD_WERR)
8864	else
8865	TEMPLATE_VBoxGuestR3Lib_CFLAGS += $(VBOX_GCC_WERR)
8866	TEMPLATE_VBoxGuestR3Lib_CXXFLAGS += $(VBOX_GCC_WERR)
8867	endif
8868
8869
8870	#
8871	# Guest version of VBoxR3StaticNoCrtExe.
8872	#
8873	TEMPLATE_VBoxGuestR3NoCrtExe := ...
8874	TEMPLATE_VBoxGuestR3NoCrtExe_EXTENDS := VBoxGuestR3Exe
8875	TEMPLATE_VBoxGuestR3NoCrtExe_SDKS = $(subst WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC,WINSDK10-UCRT-INCS, $(TEMPLATE_VBoxGuestR3Exe_SDKS))
8876	TEMPLATE_VBoxGuestR3NoCrtExe_SDKS.$(KBUILD_TARGET_ARCH) = $(filter-out VBoxOpenSslStatic,$(TEMPLATE_VBoxGuestR3Exe_SDKS.$(KBUILD_TARGET_ARCH)))
8877	TEMPLATE_VBoxGuestR3NoCrtExe_DEFS = $(TEMPLATE_VBoxGuestR3Exe_DEFS) \
8878	RT_NO_CRT \
8879	IN_RT_STATIC
8880	ifndef VBOX_WITH_NOCRT_STATIC
8881	TEMPLATE_VBoxGuestR3NoCrtExe_DEFS.win = $(TEMPLATE_VBoxGuestR3Exe_DEFS.win) \
8882	RT_WITHOUT_NOCRT_WRAPPERS
8883	endif
8884	TEMPLATE_VBoxGuestR3NoCrtExe_LATE_LIBS = \
8885	$(PATH_STAGE_LIB)/RuntimeR3NoCrt$(VBOX_SUFF_LIB)
8886	ifeq ($(KBUILD_TARGET),win)
8887	TEMPLATE_VBoxGuestR3NoCrtExe_LATE_LIBS.x86 = $(NO_SUCH_VARIABLE)
8888	TEMPLATE_VBoxGuestR3NoCrtExe_LATE_LIBS.amd64 = $(NO_SUCH_VARIABLE)
8889	TEMPLATE_VBoxGuestR3NoCrtExe_LATE_LIBS.win = $(NO_SUCH_VARIABLE)
8890	TEMPLATE_VBoxGuestR3NoCrtExe_LATE_LIBS.win.x86 = \
8891	$(PATH_TOOL_$(TEMPLATE_VBoxGuestR3NoCrtExe_TOOL.win.x86)_LIB)/chkstk.obj
8892	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS = $(NO_SUCH_VARIABLE) # These four aren't necessary, just being careful.
8893	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS.x86 = $(NO_SUCH_VARIABLE)
8894	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS.amd64 = $(NO_SUCH_VARIABLE)
8895	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS.win = $(NO_SUCH_VARIABLE)
8896	TEMPLATE_VBoxGuestR3NoCrtExe_LDFLAGS = $(filter-out $(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxGuestR3Exe_LDFLAGS))
8897	TEMPLATE_VBoxGuestR3NoCrtExe_LDFLAGS.win.x86 = $(filter-out -Include%, $(TEMPLATE_VBoxGuestR3Exe_LDFLAGS.win.x86))
8898	TEMPLATE_VBoxGuestR3NoCrtExe_LDFLAGS.win = $(TEMPLATE_VBoxGuestR3Exe_LDFLAGS.win) /entry:CustomMainEntrypoint /subsystem:console
8899	TEMPLATE_VBoxGuestR3NoCrtExe_CFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3Exe_CFLAGS)) /GS- -EHs-
8900	TEMPLATE_VBoxGuestR3NoCrtExe_CXXFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3Exe_CXXFLAGS)) /GS- -EHs-
8901	TEMPLATE_VBoxGuestR3NoCrtExe_PCHFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3Exe_PCHFLAGS)) /GS- -EHs-
8902	TEMPLATE_VBoxGuestR3NoCrtExe_CXXFLAGS.debug = $(filter-out /RTC% -RTC%, $(TEMPLATE_VBoxGuestR3Exe_CXXFLAGS.debug))
8903	else
8904	TEMPLATE_VBoxGuestR3NoCrtExe_CXXFLAGS = $(TEMPLATE_VBoxGuestR3Exe_CXXFLAGS) -fno-exceptions
8905	TEMPLATE_VBoxGuestR3NoCrtExe_PCHFLAGS = $(TEMPLATE_VBoxGuestR3Exe_PCHFLAGS) -fno-exceptions
8906	endif
8907
8908
8909	#
8910	# Template for XFree86 guest modules (relocatable module, i.e. sysmod).
8911	# This mostly about zapping the VBoxR3Exe linker flags and libraries.
8912	#
8913	TEMPLATE_VBoxGuestR3XFree86Mod := VBox XFree86 Guest Module
8914	TEMPLATE_VBoxGuestR3XFree86Mod_EXTENDS := VBoxGuestR3ExeBase
8915	TEMPLATE_VBoxGuestR3XFree86Mod_SYSSUFF := .o
8916	TEMPLATE_VBoxGuestR3XFree86Mod_DEFS = $(TEMPLATE_VBoxGuestR3ExeBase_DEFS) VBOX_GUESTR3XF86MOD RTMEM_NO_WRAP_TO_EF_APIS
8917	TEMPLATE_VBoxGuestR3XFree86Mod_CFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3ExeBase_CFLAGS)) \
8918	-fno-pie -fno-merge-constants -std=c99 -ffreestanding
8919	TEMPLATE_VBoxGuestR3XFree86Mod_CXXFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS)) \
8920	-fno-pie -fno-merge-constants -ffreestanding
8921	TEMPLATE_VBoxGuestR3XFree86Mod_CFLAGS.linux = $(VBOX_GCC_fno-stack-protector) # Remove symvers.h
8922	TEMPLATE_VBoxGuestR3XFree86Mod_CXXFLAGS.linux = $(VBOX_GCC_fno-stack-protector) # Remove symvers.h
8923	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.$(KBUILD_TARGET) = $(NO_SUCH_VARIABLE)
8924	# The GNU_HASH ELF tag is not supported by older glibc dynamic linkers.
8925	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.linux = $(subst -Wl$(COMMA),,$(VBOX_LD_hash_style_sysv))
8926	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.$(KBUILD_TYPE) = $(NO_SUCH_VARIABLE)
8927	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS := -r
8928	if1of ($(KBUILD_TARGET), dragonfly freebsd linux netbsd openbsd) # the gnu ld guys.
8929	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.release := -S
8930	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.x86 := -m elf_i386
8931	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.amd64 := -m elf_x86_64
8932	endif
8933	TEMPLATE_VBoxGuestR3XFree86Mod_LATE_LIBS = $(VBOX_LIB_VBGL_R3_XFREE86)
8934	TEMPLATE_VBoxGuestR3XFree86Mod_LATE_LIBS.$(KBUILD_TYPE) = $(NO_SUCH_VARIABLE)
8935	TEMPLATE_VBoxGuestR3XFree86Mod_LATE_LIBS.$(KBUILD_TARGET) = $(NO_SUCH_VARIABLE)
8936	TEMPLATE_VBoxGuestR3XFree86Mod_LIBS = $(NO_SUCH_VARIABLE) # These three aren't necessary, just being careful.
8937	TEMPLATE_VBoxGuestR3XFree86Mod_LIBS.$(KBUILD_TYPE) = $(NO_SUCH_VARIABLE)
8938	TEMPLATE_VBoxGuestR3XFree86Mod_LIBS.$(KBUILD_TARGET) = $(NO_SUCH_VARIABLE)
8939
8940
8941	#
8942	# Template for XFree86 guest libraries.
8943	#
8944	TEMPLATE_VBoxGuestR3XFree86Lib := VBox XFree86 Guest Library
8945	TEMPLATE_VBoxGuestR3XFree86Lib_EXTENDS := VBoxGuestR3XFree86Mod
8946	TEMPLATE_VBoxGuestR3XFree86Lib_INST = $(INST_ADDITIONS_LIB)
8947
8948
8949	#
8950	# Template for X.Org guest modules (shared libs).
8951	# This mostly about zapping unnecessary LIBS from VBoxGuestR3DllNonPedantic and adding some flags.
8952	#
8953	TEMPLATE_VBoxGuestR3XOrgMod := VBox X.Org Guest Module
8954	TEMPLATE_VBoxGuestR3XOrgMod_EXTENDS := VBoxGuestR3DllNonPedantic
8955	TEMPLATE_VBoxGuestR3XOrgMod_DEFS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_DEFS) VBOX_GUESTR3XORGMOD RTMEM_NO_WRAP_TO_EF_APIS
8956	ifeq ($(KBUILD_TARGET_ARCH),amd64)
8957	TEMPLATE_VBoxGuestR3XOrgMod_DEFS += _XSERVER64
8958	endif
8959	TEMPLATE_VBoxGuestR3XOrgMod_CFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3DllNonPedantic_CFLAGS)) -std=c99
8960	TEMPLATE_VBoxGuestR3XOrgMod_CXXFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS))
8961	if1of ($(KBUILD_TARGET), linux)
8962	TEMPLATE_VBoxGuestR3XOrgMod_CFLAGS += -Wno-conversion -Wno-unused-parameter
8963	endif
8964	TEMPLATE_VBoxGuestR3XOrgMod_LDFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS),$(TEMPLATE_VBoxGuestR3DllNonPedantic_LDFLAGS))
8965	TEMPLATE_VBoxGuestR3XOrgMod_LATE_LIBS = $(VBOX_LIB_VBGL_R3_XORG)
8966	TEMPLATE_VBoxGuestR3XOrgMod_LATE_LIBS.$(KBUILD_TYPE) = $(NO_SUCH_VARIABLE)
8967	TEMPLATE_VBoxGuestR3XOrgMod_LATE_LIBS.$(KBUILD_TARGET) = $(NO_SUCH_VARIABLE)
8968	TEMPLATE_VBoxGuestR3XOrgMod_LATE_LIBS.freebsd = iconv
8969	TEMPLATE_VBoxGuestR3XOrgMod_LIBS = $(NO_SUCH_VARIABLE) # These three aren't necessary, just being careful.
8970	TEMPLATE_VBoxGuestR3XOrgMod_LIBS.$(KBUILD_TYPE) = $(NO_SUCH_VARIABLE)
8971	TEMPLATE_VBoxGuestR3XOrgMod_LIBS.$(KBUILD_TARGET) = $(NO_SUCH_VARIABLE)
8972
8973
8974	#
8975	# Template for X.Org guest libraries.
8976	#
8977	TEMPLATE_VBoxGuestR3XOrgLib := VBox X.Org Guest Library
8978	TEMPLATE_VBoxGuestR3XOrgLib_EXTENDS := VBoxGuestR3XOrgMod
8979	TEMPLATE_VBoxGuestR3XOrgLib_INST = $(INST_ADDITIONS_LIB)
8980
8981
8982	#
8983	# Template for building R0 drivers for the guest additions.
8984	#
8985	TEMPLATE_VBoxGuestR0Drv = VBox Guest Driver
8986	TEMPLATE_VBoxGuestR0Drv_EXTENDS = VBoxR0Drv
8987	TEMPLATE_VBoxGuestR0Drv_INST = $(INST_ADDITIONS)
8988	TEMPLATE_VBoxGuestR0Drv_SDKS.win.x86 = ReorderCompilerIncs $(VBOX_WINDDK_GST) $(VBOX_WINPSDK_GST_INCS)
8989	TEMPLATE_VBoxGuestR0Drv_SDKS.win.amd64 = ReorderCompilerIncs $(VBOX_WINDDK_GST) $(VBOX_WINPSDK_GST_INCS)
8990	TEMPLATE_VBoxGuestR0Drv_SDKS.win.arm32 = ReorderCompilerIncs $(VBOX_WINDDK_GST) $(VBOX_WINPSDK_GST_INCS)
8991	TEMPLATE_VBoxGuestR0Drv_SDKS.win.arm64 = ReorderCompilerIncs $(VBOX_WINDDK_GST) $(VBOX_WINPSDK_GST_INCS)
8992	TEMPLATE_VBoxGuestR0Drv_DEFS = $(TEMPLATE_VBoxR0Drv_DEFS) IN_GUEST IN_GUEST_R0
8993	TEMPLATE_VBoxGuestR0Drv_DEFS.linux = RT_NO_EXPORT_SYMBOL
8994	ifeq ($(KBUILD_TARGET),solaris)
8995	TEMPLATE_VBoxGuestR0Drv_LDFLAGS = -r -dy
8996	endif
8997	ifn1of ($(KBUILD_TARGET), darwin os2 win)
8998	TEMPLATE_VBoxGuestR0Drv_CFLAGS = $(patsubst %/VBox/SUPDrvMangling.h,%/VBox/VBoxGuestMangling.h,$(TEMPLATE_VBoxR0Drv_CFLAGS))
8999	TEMPLATE_VBoxGuestR0Drv_CXXFLAGS = $(patsubst %/VBox/SUPDrvMangling.h,%/VBox/VBoxGuestMangling.h,$(TEMPLATE_VBoxR0Drv_CXXFLAGS))
9000	TEMPLATE_VBoxGuestR0Drv_ASDEFS = $(patsubst RT_MANGLER_PREFIX=%,RT_MANGLER_PREFIX=VBoxGuest_,$(TEMPLATE_VBoxR0Drv_ASDEFS))
9001	endif
9002	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120" # Do not use SSE so the binaries might works on NT4 and earlier.
9003	TEMPLATE_VBoxGuestR0Drv_CFLAGS.win.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.win.x86) /arch:IA32
9004	TEMPLATE_VBoxGuestR0Drv_CXXFLAGS.win.x86 = $(TEMPLATE_VBoxR0Drv_CXXFLAGS.win.x86) /arch:IA32
9005	endif
9006
9007
9008	#
9009	# Template for building R0 libraries for the guest additions.
9010	#
9011	TEMPLATE_VBoxGuestR0DrvLib = VBox Guest Driver Libraries
9012	TEMPLATE_VBoxGuestR0DrvLib_EXTENDS = VBoxGuestR0Drv
9013	TEMPLATE_VBoxGuestR0DrvLib_INSTTYPE = stage
9014	TEMPLATE_VBoxGuestR0DrvLib_INSTTYPE.linux = stage
9015	TEMPLATE_VBoxGuestR0DrvLib_INST = $(INST_ADDITIONS_LIB)
9016	ifeq ($(KBUILD_TARGET),haiku)
9017	TEMPLATE_VBoxGuestR0DrvLib_LDFLAGS = -r -dy
9018	endif
9019
9020
9021	#
9022	# Guest additions libraries (all static).
9023	# The _SHARED variants are compiled as PIC and intended for linking into a .so/.dll/.dylib.
9024	#
9025	VBOX_LIB_IPRT_GUEST_R3 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR3$(VBOX_SUFF_LIB)
9026	VBOX_LIB_IPRT_GUEST_R3_SHARED = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR3Shared$(VBOX_SUFF_LIB)
9027	VBOX_LIB_IPRT_GUEST_R0 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR0$(VBOX_SUFF_LIB)
9028	#ifeq ($(KBUILD_TARGET_ARCH),x86)
9029	# VBOX_LIB_IPRT_GUEST_R0_NT4 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR0NT4$(VBOX_SUFF_LIB)
9030	#else
9031	VBOX_LIB_IPRT_GUEST_R0_NT4 = $(VBOX_LIB_IPRT_GUEST_R0)
9032	#endif
9033	VBOX_LIB_VBGL_R3 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3Lib$(VBOX_SUFF_LIB)
9034	VBOX_LIB_VBGL_R3_XFREE86 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3LibXFree86$(VBOX_SUFF_LIB)
9035	VBOX_LIB_VBGL_R3_XORG = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3LibXOrg$(VBOX_SUFF_LIB)
9036	VBOX_LIB_VBGL_R3_SHARED = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3LibShared$(VBOX_SUFF_LIB)
9037	VBOX_LIB_VBGL_R0BASE = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR0LibBase$(VBOX_SUFF_LIB)
9038	VBOX_LIB_VBGL_R0 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR0Lib$(VBOX_SUFF_LIB)
9039	ifeq ($(KBUILD_TARGET_ARCH),x86)
9040	VBOX_LIB_IPRT_GUEST_R3_X86 = $(VBOX_LIB_IPRT_GUEST_R3)
9041	VBOX_LIB_IPRT_GUEST_R3_SHARED_X86 = $(VBOX_LIB_IPRT_GUEST_R3_SHARED)
9042	VBOX_LIB_VBGL_R3_X86 = $(VBOX_LIB_VBGL_R3)
9043	VBOX_LIB_VBGL_R3_SHARED_X86 = $(VBOX_LIB_VBGL_R3_SHARED)
9044	else
9045	VBOX_LIB_IPRT_GUEST_R3_X86 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR3-x86$(VBOX_SUFF_LIB)
9046	VBOX_LIB_IPRT_GUEST_R3_SHARED_X86 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR3Shared-x86$(VBOX_SUFF_LIB)
9047	VBOX_LIB_VBGL_R3_X86 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3Lib-x86$(VBOX_SUFF_LIB)
9048	VBOX_LIB_VBGL_R3_SHARED_X86 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3LibShared-x86$(VBOX_SUFF_LIB)
9049	endif
9050
9051
9052	#
9053	# Check the publisher and version string.
9054	#
9055	# We are being very strict because the version string is visible in various
9056	# APIs and logs and must be machine readable.
9057	#
9058	VBOX_VERSION_COMP_VALID_CHAR_SET = ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyz()[]{}+-.,
9059	ifneq ($(VBOX_BUILD_PUBLISHER),)
9060	if !defined(VBOX_BUILD_TAG) && $(length $(VBOX_BUILD_PUBLISHER)) > 10
9061	$(error VBox: VBOX_BUILD_PUBLISHER must not be longer than 10 characters!)
9062	else if defined(VBOX_BUILD_TAG) && $(length $(VBOX_BUILD_PUBLISHER)) > 48
9063	$(error VBox: VBOX_BUILD_PUBLISHER must not be longer than 48 characters!)
9064	endif
9065	if "$(substr $(VBOX_BUILD_PUBLISHER), 1, 1)" != "_"
9066	$(error VBox: VBOX_BUILD_PUBLISHER must start with an underscore!)
9067	endif
9068	if "$(translate $(substr $(VBOX_BUILD_PUBLISHER),2),$(VBOX_VERSION_COMP_VALID_CHAR_SET),)" != ""
9069	$(error VBox: VBOX_BUILD_PUBLISHER='$(VBOX_BUILD_PUBLISHER)' contains bad characters! Valid set is:$(NLTAB)$(VBOX_VERSION_COMP_VALID_CHAR_SET))
9070	endif
9071	endif
9072
9073	if $(words $(VBOX_VERSION_STRING)) != 1
9074	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' contains spaces or is empty.)
9075	endif
9076	if "$(subst __,-,$(VBOX_VERSION_STRING))" != "$(VBOX_VERSION_STRING)"
9077	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' contains double underscores.)
9078	endif
9079
9080	VBOX_VER_TMP1 := $(subst _,$(SP),$(VBOX_VERSION_STRING))
9081
9082	if $(words $(VBOX_VER_TMP1)) > 3
9083	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' contains too many parts (underscores), max 3!)
9084	endif
9085	if "$(translate $(word 1,$(VBOX_VER_TMP1)),0123456789,)" != ".."
9086	$(error VBox: The x.y.z part of VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' is malformed: '$(word 1,$(VBOX_VER_TMP1))')
9087	endif
9088	if "$(word 1,$(VBOX_VER_TMP1))" != "$(VBOX_VERSION_STRING_RAW)"
9089	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' does not start with VBOX_VERSION_STRING_RAW='$(VBOX_VERSION_STRING_RAW)')
9090	endif
9091
9092	if $(words $(VBOX_VER_TMP1)) == 3 \|\| ($(words $(VBOX_VER_TMP1)) == 2 && "$(VBOX_BUILD_PUBLISHER)" == "")
9093	if "$(substr $(word 2,$(VBOX_VER_TMP1)),1,4)" == "BETA"
9094	VBOX_VER_TMP2 = 5
9095	else if "$(substr $(word 2,$(VBOX_VER_TMP1)),1,5)" == "ALPHA"
9096	VBOX_VER_TMP2 = 6
9097	else if "$(substr $(word 2,$(VBOX_VER_TMP1)),1,2)" == "RC"
9098	VBOX_VER_TMP2 = 3
9099	else
9100	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' uses an unknown build type: '$(word 2,$(VBOX_VER_TMP1))')
9101	endif
9102	if "$(translate $(substr $(word 2,$(VBOX_VER_TMP1)),$(VBOX_VER_TMP2)),0123456789)" != ""
9103	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' uses an unknown build type: '$(word 2,$(VBOX_VER_TMP1))')
9104	endif
9105	endif
9106
9107	VBOX_VER_TMP1 :=
9108	VBOX_VER_TMP2 :=
9109
9110
9111	#
9112	# Two targets to coordinate version number changes properly. Note that the
9113	# only way to get a really consistent build is to run 'kmk' in the top-level
9114	# directory. If you don't run it there, you get a consistent sub-tree only.
9115	#
9116	VBOX_BAD_CHAR_SET = ,;:/\$(SP)$(TAB)$(HASH)=![]@%&''()*""<>?^{}\|~
9117	VBOX_VERSION_STAMP = $(PATH_OUT)/version-stamp-raw-api-puel-$(translate $(VBOX_VERSION_STRING)-$(VBOX_C_YEAR)-$(VBOX_VENDOR)-$(VBOX_PRODUCT)-$(VBOX_API_VERSION)-$(VBOX_PUEL_PRODUCT)-$(VBOX_BUILD_PUBLISHER)-$(USERNAME),$(VBOX_BAD_CHAR_SET),,_)
9118	VBOX_VERSION_HEADER = $(PATH_OUT)/version-generated.h
9119	VBOX_VERSION_MK = $(PATH_OUT)/version-generated.mk
9120
9121	$(VBOX_VERSION_STAMP): \| $(PATH_ROOT)/Config.kmk
9122	$(call MSG_GENERATE,,$@)
9123	$(QUIET)$(MKDIR) -p $(@D)
9124	$(QUIET)$(RM) -f $(wildcard $(PATH_OUT)/version-stamp-*)
9125	$(QUIET)$(APPEND) $@ $(VBOX_VERSION_STRING)
9126
9127	$(VBOX_VERSION_HEADER): $(VBOX_VERSION_STAMP)
9128	$(call MSG_GENERATE,,$@)
9129	$(QUIET)$(MKDIR) -p $(@D)
9130	$(QUIET)$(RM) -f $@ $@.tmp
9131	$(QUIET)$(APPEND) $@.tmp '#ifndef ___version_generated_h___'
9132	$(QUIET)$(APPEND) $@.tmp '#define ___version_generated_h___'
9133	$(QUIET)$(APPEND) $@.tmp ''
9134	$(QUIET)$(APPEND) $@.tmp '#define VBOX_VERSION_MAJOR $(VBOX_VERSION_MAJOR)'
9135	$(QUIET)$(APPEND) $@.tmp '#define VBOX_VERSION_MINOR $(VBOX_VERSION_MINOR)'
9136	$(QUIET)$(APPEND) $@.tmp '#define VBOX_VERSION_BUILD $(VBOX_VERSION_BUILD)'
9137	ifneq ($(VBOX_VERSION_PRERELEASE),)
9138	$(QUIET)$(APPEND) $@.tmp '#define VBOX_VERSION_PRERELEASE "$(strip $(VBOX_VERSION_PRERELEASE))"'
9139	endif
9140	$(QUIET)$(APPEND) $@.tmp '#define VBOX_VERSION_STRING_RAW "$(VBOX_VERSION_STRING_RAW)"'
9141	$(QUIET)$(APPEND) $@.tmp '#define VBOX_VERSION_STRING "$(VBOX_VERSION_STRING)"'
9142	$(QUIET)$(APPEND) $@.tmp '#define VBOX_API_VERSION_STRING "$(VBOX_API_VERSION)"'
9143	$(QUIET)$(APPEND) $@.tmp ''
9144	ifdef VBOX_BUILD_SERVER_BUILD
9145	$(QUIET)$(APPEND) $@.tmp '#define VBOX_BUILD_SERVER_BUILD 1'
9146	else
9147	$(QUIET)$(APPEND) $@.tmp '#define VBOX_PRIVATE_BUILD_DESC "Private build by $(USERNAME)"'
9148	endif
9149	$(QUIET)$(APPEND) $@.tmp ''
9150	$(QUIET)$(APPEND) $@.tmp '#endif'
9151	$(QUIET)$(MV) -f $@.tmp $@
9152
9153
9154	VBOX_PACKAGE_HEADER = $(PATH_OUT)/package-generated.h
9155
9156	$(VBOX_PACKAGE_HEADER):
9157	$(call MSG_GENERATE,,$@)
9158	$(QUIET)$(MKDIR) -p $(@D)
9159	$(QUIET)$(RM) -f $@ $@.tmp
9160	$(QUIET)$(APPEND) $@.tmp '#ifndef ___package_generated_h___'
9161	$(QUIET)$(APPEND) $@.tmp '#define ___package_generated_h___'
9162	$(QUIET)$(APPEND) $@.tmp ''
9163	$(QUIET)$(APPEND) $@.tmp '#define VBOX_PACKAGE_STRING "$(VBOX_PACKAGE_STRING)"'
9164	$(QUIET)$(APPEND) $@.tmp ''
9165	$(QUIET)$(APPEND) $@.tmp '#endif'
9166	$(QUIET)$(MV) -f $@.tmp $@
9167
9168	VBOX_PRODUCT_HEADER = $(PATH_OUT)/product-generated.h
9169
9170	$(VBOX_PRODUCT_HEADER): $(VBOX_VERSION_STAMP)
9171	$(call MSG_GENERATE,,$@)
9172	$(QUIET)$(MKDIR) -p $(@D)
9173	$(QUIET)$(RM) -f $@ $@.tmp
9174	$(QUIET)$(APPEND) $@.tmp '#ifndef ___product_generated_h___'
9175	$(QUIET)$(APPEND) $@.tmp '#define ___product_generated_h___'
9176	$(QUIET)$(APPEND) $@.tmp ''
9177	$(QUIET)$(APPEND) $@.tmp '#define VBOX_VENDOR "$(VBOX_VENDOR)"'
9178	$(QUIET)$(APPEND) $@.tmp '#define VBOX_VENDOR_SHORT "$(VBOX_VENDOR_SHORT)"'
9179	$(QUIET)$(APPEND) $@.tmp '#define VBOX_PRODUCT "$(VBOX_PRODUCT)"'
9180	$(QUIET)$(APPEND) $@.tmp '#define VBOX_PUEL_PRODUCT "$(VBOX_PUEL_PRODUCT)"'
9181	$(QUIET)$(APPEND) $@.tmp '#define VBOX_BUILD_PUBLISHER "$(VBOX_BUILD_PUBLISHER)"'
9182	$(QUIET)$(APPEND) $@.tmp '#define VBOX_C_YEAR "$(VBOX_C_YEAR)"'
9183	$(QUIET)$(APPEND) $@.tmp ''
9184	$(QUIET)$(APPEND) $@.tmp '#endif'
9185	$(QUIET)$(MV) -f $@.tmp $@
9186
9187	#
9188	# Used for external makefiles which cannot include Config.kmk
9189	#
9190	$(VBOX_VERSION_MK): $(VBOX_VERSION_STAMP)
9191	$(call MSG_GENERATE,,$@)
9192	$(QUIET)$(RM) -f $@ $@.tmp
9193	$(QUIET)$(MKDIR) -p $(@D)
9194	$(QUIET)$(APPEND) $@.tmp 'VBOX_VERSION_MAJOR = $(VBOX_VERSION_MAJOR)'
9195	$(QUIET)$(APPEND) $@.tmp 'VBOX_VERSION_MINOR = $(VBOX_VERSION_MINOR)'
9196	$(QUIET)$(APPEND) $@.tmp 'VBOX_VERSION_BUILD = $(VBOX_VERSION_BUILD)'
9197	$(QUIET)$(APPEND) $@.tmp 'VBOX_VERSION_STRING = $(VBOX_VERSION_STRING)'
9198	ifneq ($(VBOX_VERSION_PRERELEASE),)
9199	$(QUIET)$(APPEND) $@.tmp 'VBOX_VERSION_PRERELEASE = $(strip $(VBOX_VERSION_PRERELEASE))'
9200	endif
9201	$(QUIET)$(APPEND) $@.tmp 'VBOX_VENDOR = $(VBOX_VENDOR)'
9202	$(QUIET)$(APPEND) $@.tmp 'VBOX_VENDOR_SHORT = $(VBOX_VENDOR_SHORT)'
9203	$(QUIET)$(APPEND) $@.tmp 'VBOX_PRODUCT = $(VBOX_PRODUCT)'
9204	$(QUIET)$(APPEND) $@.tmp 'VBOX_C_YEAR = $(VBOX_C_YEAR)'
9205	ifdef VBOX_BUILD_SERVER_BUILD
9206	$(QUIET)$(APPEND) $@.tmp 'VBOX_BUILD_SERVER_BUILD = 1'
9207	else
9208	$(QUIET)$(APPEND) $@.tmp 'VBOX_PRIVATE_BUILD_DESC = Private build by $(USERNAME)'
9209	endif
9210	$(QUIET)$(MV) -f $@.tmp $@
9211
9212	if !defined(VBOX_OSE) && !defined(VBOX_NOINC_LICENSE_VER_KMK)
9213	if1of ($(KBUILD_TARGET), freebsd linux netbsd openbsd solaris)
9214	# VBOX_LICENSE_VER is used in several Makefiles
9215	VBOX_LICENSE_VER_KMK = $(PATH_OUT)/license-version.kmk
9216	$(VBOX_LICENSE_VER_KMK): $(VBOX_BRAND_LICENSE_HTML)
9217	$(call MSG_GENERATE,,$(VBOX_LICENSE_VER_KMK))
9218	$(QUIET)$(MKDIR) -p $(@D)
9219	ifdef VBOX_BRAND_LICENSE_VER
9220	$(QUIET)$(RM) -f '$@'
9221	$(APPEND) '$@' 'VBOX_LICENSE_VER=$(VBOX_BRAND_LICENSE_VER)'
9222	else
9223	$(QUIET)$(SED) -e "s/.License version $[0-9.]$ [,&]./VBOX_LICENSE_VER=\1/;t;d" --output $@ $(VBOX_BRAND_LICENSE_HTML)
9224	endif
9225	-include $(VBOX_LICENSE_VER_KMK)
9226	ifdef VBOX_LICENSE_VER
9227	VBOX_LICENSE_FILES = \
9228	License-$(VBOX_LICENSE_VER).html \
9229	$(foreach f,$(VBOX_INSTALLER_ADD_LANGUAGES),License-$(VBOX_LICENSE_VER)-$(f).html)
9230	VBOX_LICENSE_BINS = $(addprefix $(PATH_STAGE_BIN)/,$(VBOX_LICENSE_FILES))
9231	endif
9232	endif
9233	endif
9234
9235
9236	ifeq ($(KBUILD_TARGET),darwin)
9237	$(VBOX_DARWIN_ENTITLEMENTS_FILE):
9238	$(call MSG_GENERATE,,$@)
9239	$(QUIET)$(MKDIR) -p $(@D)
9240	$(QUIET)$(RM) -f $@ $@.tmp
9241	$(QUIET)$(APPEND) $@.tmp '<?xml version="1.0" encoding="UTF-8"?>'
9242	$(QUIET)$(APPEND) $@.tmp '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">'
9243	$(QUIET)$(APPEND) $@.tmp '<plist version="1.0">'
9244	$(QUIET)$(APPEND) $@.tmp '<dict>'
9245	$(QUIET)$(APPEND) -n $@.tmp $(foreach entitlement,$(VBOX_DARWIN_ENTITLEMENTS_LIST_COMMON), ' <key>$(entitlement)</key><true/>')
9246	$(QUIET)$(APPEND) $@.tmp '</dict>'
9247	$(QUIET)$(APPEND) $@.tmp '</plist>'
9248	$(QUIET)$(MV) -f $@.tmp $@
9249
9250	$(VBOX_DARWIN_ENTITLEMENTS_FILE_VM):
9251	$(call MSG_GENERATE,,$@)
9252	$(QUIET)$(MKDIR) -p $(@D)
9253	$(QUIET)$(RM) -f $@ $@.tmp
9254	$(QUIET)$(APPEND) $@.tmp '<?xml version="1.0" encoding="UTF-8"?>'
9255	$(QUIET)$(APPEND) $@.tmp '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">'
9256	$(QUIET)$(APPEND) $@.tmp '<plist version="1.0">'
9257	$(QUIET)$(APPEND) $@.tmp '<dict>'
9258	$(QUIET)$(APPEND) -n $@.tmp $(foreach entitlement,$(VBOX_DARWIN_ENTITLEMENTS_LIST_VM), ' <key>$(entitlement)</key><true/>')
9259	$(QUIET)$(APPEND) $@.tmp '</dict>'
9260	$(QUIET)$(APPEND) $@.tmp '</plist>'
9261	$(QUIET)$(MV) -f $@.tmp $@
9262	endif
9263
9264	ifndef VBOX_NOINC_MISC
9265	# Force building of the version header file as the first thing anywhere in
9266	# the tree. This eliminates the need for manual dependencies on it.
9267	## @todo there gotta be a better way of doing this.
9268	Makefile.kmk: \| $(VBOX_VERSION_HEADER) $(VBOX_VERSION_MK) $(VBOX_PRODUCT_HEADER) $(VBOX_PACKAGE_HEADER)
9269	ifeq ($(KBUILD_TARGET),darwin)
9270	Makefile.kmk: \| $(VBOX_DARWIN_ENTITLEMENTS_FILE) $(VBOX_DARWIN_ENTITLEMENTS_FILE_VM)
9271	endif
9272	endif
9273
9274
9275	#
9276	# Subversion tree revision.
9277	#
9278	# The VBOX_SVN_REV contains our best guess. Use svn info on the root of the
9279	# tree to determine this it if .svn/wc.db or .svn/entries is found (the former
9280	# also up to two directory levels higher to allow for checkouts of the entire
9281	# repository), otherwise fall back on maximum value of Config.kmk and
9282	# Version.kmk revision.
9283	#
9284	# Makefile rules using this information shall list $(VBOX_SVN_REV_KMK) as a
9285	# prerequisite.
9286	#
9287	SVN ?= svn$(HOSTSUFF_EXE)
9288	VBOX_SVN_REV_KMK = $(PATH_OUT)/revision.kmk
9289	ifndef VBOX_SVN_REV
9290	VBOX_SVN_REV_CONFIG_FALLBACK := $(patsubst %:,, $Rev: 106905 $ )
9291	VBOX_SVN_REV_FALLBACK := $(if-expr $(VBOX_SVN_REV_CONFIG_FALLBACK) > $(VBOX_SVN_REV_VERSION_FALLBACK),$(VBOX_SVN_REV_CONFIG_FALLBACK),$(VBOX_SVN_REV_VERSION_FALLBACK))
9292	VBOX_SVN_DEP := $(firstword $(wildcard $(PATH_ROOT)/.svn/wc.db $(abspath $(PATH_ROOT)/../.svn/wc.db) $(abspath $(PATH_ROOT)/../../.svn/wc.db) $(PATH_ROOT)/.svn/entries))
9293	ifeq ($(which $(SVN)),)
9294	VBOX_SVN_DEP :=
9295	endif
9296
9297	# Rule for generating a timestamp and updating the real thing on change.
9298	$(VBOX_SVN_REV_KMK).ts +\| $(VBOX_SVN_REV_KMK): $(if $(VBOX_SVN_DEP), $(VBOX_SVN_DEP), $(PATH_ROOT)/Config.kmk)
9299	$(call MSG_GENERATE,,$(VBOX_SVN_REV_KMK))
9300	$(QUIET)$(RM) -f $@ $@.tmp
9301	$(QUIET)$(MKDIR) -p $(@D)
9302	ifneq ($(VBOX_SVN_DEP),)
9303	-$(REDIRECT) -E 'LC_ALL=C' -wo $@.tmp -- $(SVN) info $(PATH_ROOT)
9304	# Append fallback. Will be ignored if "svn info" provides meaningful data.
9305	$(QUIET)$(APPEND) $@.tmp 'Last Changed Rev: $(VBOX_SVN_REV_FALLBACK)'
9306	$(SED) -e '/^Last Changed Rev/!d' -e 's/Last Changed Rev\: */export VBOX_SVN_REV=/; t a; :a q' --output $@ $@.tmp
9307	$(QUIET)$(RM) -f $@.tmp
9308	else
9309	$(QUIET)$(APPEND) $@ 'export VBOX_SVN_REV=$(VBOX_SVN_REV_FALLBACK)'
9310	endif
9311	$(QUIET)$(CP) --changed -fv $@ $(VBOX_SVN_REV_KMK)
9312
9313	ifndef VBOX_NOINC_SVN_REV_KMK
9314	include $(VBOX_SVN_REV_KMK)
9315	endif
9316	else
9317	# allow to overwrite VBOX_SVN_REV externally (mainly for building .debs/.rpms)
9318	$(VBOX_SVN_REV_KMK):
9319	$(call MSG_GENERATE,,$(VBOX_SVN_REV_KMK))
9320	$(QUIET)$(RM) -f $@
9321	$(QUIET)$(MKDIR) -p $(@D)
9322	$(QUIET)$(APPEND) $@ 'export VBOX_SVN_REV=$(VBOX_SVN_REV)'
9323	$(QUIET)echo '* $(VBOX_SVN_REV_KMK) was externally overwritten:'
9324	$(QUIET)$(CAT) $(VBOX_SVN_REV_KMK)
9325	endif
9326
9327	# only needed for VBoxGuest for Linux/FreeBSD guests
9328	VBOX_SVN_REV_HEADER = $(PATH_OUT)/revision-generated.h
9329	$(VBOX_SVN_REV_HEADER): $(VBOX_SVN_REV_KMK)
9330	$(call MSG_GENERATE,,$@)
9331	$(QUIET)$(RM) -f $@ $@.tmp
9332	$(QUIET)$(MKDIR) -p $(@D)
9333	$(QUIET)$(APPEND) $@.tmp '#define VBOX_SVN_REV $(VBOX_SVN_REV)'
9334	$(QUIET)$(MV) -f $@.tmp $@
9335
9336	#
9337	# Shared definitions of the XIDL file to use as a source for
9338	# generating various other files (VBoxSVC, webservice, docs, front-ends, ...)
9339	#
9340
9341	# Real XIDL source file; from this we strip the <desc> elements to generate
9342	# a second XIDL file, from which the COM/XPCOM IDL files are then generated:
9343	VBOX_XIDL_FILE_SRC = $(PATH_ROOT)/src/VBox/Main/idl/VirtualBox.xidl
9344	# second XIDL file to use as source for COM/XPCOM IDL (with stripped docs):
9345	VBOX_XIDL_FILE = $(PATH_OUT)/obj/VirtualBox_stripped.xidl
9346
9347
9348	#
9349	# VBOX_SEP needs to be quoted when used on the shell command line.
9350	#
9351	if1of ($(KBUILD_TARGET), os2 win)
9352	VBOX_SEP = $(SEMICOLON)
9353	else
9354	VBOX_SEP = $(COLON)
9355	endif
9356
9357	# Java compiler options, needs some version checking.
9358	if defined(VBOX_JAVA_VERSION) && $(VBOX_JAVA_VERSION) >= 110000
9359	VBOX_JAVA_WS_PATH ?= /usr/share/java
9360	VBOX_JAVA_WS_EXTRA_JARS ?= $(VBOX_JAVA_WS_PATH)/jws-api.jar$(VBOX_SEP)$(VBOX_JAVA_WS_PATH)/jaxb-api.jar$(VBOX_SEP)$(VBOX_JAVA_WS_PATH)/jaxws-api.jar
9361	else if defined(VBOX_JAVA_VERSION) && $(VBOX_JAVA_VERSION) >= 10900
9362	VBOX_JAVA_WS_OPTS ?= --add-modules java.xml.ws
9363	endif
9364	if defined(VBOX_JAVA_VERSION) && $(VBOX_JAVA_VERSION) >= 110000
9365	VBOX_JAVAC_OPTS = -encoding UTF-8 -source 9 -target 9 -Xlint:unchecked
9366	else if defined(VBOX_JAVA_VERSION) && $(VBOX_JAVA_VERSION) >= 90000
9367	VBOX_JAVAC_OPTS = -encoding UTF-8 -source 6 -target 6 -Xlint:unchecked
9368	else
9369	VBOX_JAVAC_OPTS = -encoding UTF-8 -source 1.5 -target 1.5 -Xlint:unchecked
9370	endif
9371	VBOX_JAVADOC_OPTS = -encoding UTF-8
9372
9373
9374	#
9375	# Legacy.
9376	#
9377	## @todo try remove this.
9378	ifneq ($(LOCALCFG),)
9379	include $(LOCALCFG)
9380	endif
9381
9382
9383	#
9384	# For efficiently build serveral build types / archs.
9385	#
9386	both-debug-release both-release-debug: \
9387	build-release-$(KBUILD_TARGET_ARCH) \
9388	build-debug-$(KBUILD_TARGET_ARCH)
9389	both-x86-amd64 both-amd64-x86: \
9390	build-$(KBUILD_TYPE)-x86 \
9391	build-$(KBUILD_TYPE)-x86
9392	both-types-archs both-archs-types: \
9393	build-debug-x86 \
9394	build-release-x86 \
9395	build-debug-amd64 \
9396	build-release-amd64
9397
9398	build-release-x86:
9399	+$(MAKE) KBUILD_TYPE=release KBUILD_TARGET_ARCH=x86
9400
9401	build-debug-x86:
9402	+$(MAKE) KBUILD_TYPE=debug KBUILD_TARGET_ARCH=x86
9403
9404	build-release-amd64:
9405	+$(MAKE) KBUILD_TYPE=release KBUILD_TARGET_ARCH=amd64
9406
9407	build-debug-amd64:
9408	+$(MAKE) KBUILD_TYPE=debug KBUILD_TARGET_ARCH=amd64
9409
9410	build-release-arm64:
9411	+$(MAKE) KBUILD_TYPE=release KBUILD_TARGET_ARCH=arm64
9412
9413	build-debug-arm64:
9414	+$(MAKE) KBUILD_TYPE=debug KBUILD_TARGET_ARCH=arm64
9415
9416
9417	#
9418	# Some extra goals.
9419	#
9420	.PHONY: up update st stat status
9421	up update::
9422	$(SVN) up
9423
9424	up2 update2::
9425	$(SVN) up --ignore-externals
9426
9427	st stat status:
9428	$(SVN) status

Note: See TracBrowser for help on using the repository browser.

Download in other formats:

Original Format