Config.kmk@ 103497

Last change on this file since 103497 was 103497, checked in by vboxsync, 9 months ago
/Config.kmk: Shut up C5039 warnings on windows when RT_RELAXED_CALLBACKS_TYPES us defined (for parfait). bugref:3409
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 428.3 KB

Line
1	# $Id: Config.kmk 103497 2024-02-21 14:32:30Z 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-2023 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	# Misc names used by the install paths below.
97	VBOX_PUEL_MANGLED_NAME := Oracle_VM_VirtualBox_Extension_Pack
98
99	# Install paths
100	## @todo This will change after 4.1 is branched off!
101	# What is now 'bin' and 'lib' will be moved down under 'staged/', except on
102	# darwin where it's currently called 'dist' which will be renamed to 'staged'.
103	# When running 'kmk install' files will be copied to 'dist/', on unix systems
104	# this will be done in FHS fashion assuming /usr/local or /usr as 'prefix'.
105	#
106	# Changes related to this are marked VBOX_WITH_NEW_LAYOUT.
107	ifndef VBOX_WITH_NEW_LAYOUT
108	PATH_INS = $(PATH_OUT)/dist
109	PATH_STAGE = $(PATH_OUT)
110	INST_DEBUG := stage/debug/
111	endif
112
113	ifeq ($(KBUILD_TARGET),darwin)
114	ifndef VBOX_WITH_NEW_LAYOUT
115	INST_DIST = dist/
116	else
117	INST_DIST :=
118	endif
119	INST_SDK = $(INST_DIST)sdk/
120
121	# the bundles
122	INST_VIRTUALBOX = $(INST_DIST)VirtualBox.app/
123	INST_VBOXDRV = $(INST_DIST)VBoxDrv.kext/
124	INST_VBOXNETFLT = $(INST_DIST)VBoxNetFlt.kext/
125	INST_VBOXNETADP = $(INST_DIST)VBoxNetAdp.kext/
126	INST_VBOXUSB = $(INST_DIST)VBoxUSB.kext/
127
128	# put everything in the VirtualBox app bundle.
129	INST_BIN = $(INST_VIRTUALBOX)Contents/MacOS/
130	INST_DLL = $(INST_BIN)
131	INST_SYS = $(INST_BIN)
132	INST_TESTCASE = $(INST_BIN)testcase/
133	INST_ADDITIONS = $(INST_DIST)additions/
134	INST_ADDITIONS_ISO = $(INST_BIN)
135	INST_UNATTENDED_TEMPLATES = $(INST_BIN)UnattendedTemplates/
136
137	INST_VBOXDBG_SYMS = $(INST_VIRTUALBOX)Contents/Resources/VBoxDbgSyms/
138
139	# other paths
140	INST_LIB = lib/
141	INST_ADDITIONS_LIB = $(INST_LIB)additions/
142	VBOX_INST_DTRACE_LIB = $(INST_BIN)dtrace/lib/
143	VBOX_INST_DTRACE_TST = $(INST_BIN)dtrace/testcase/
144	VBOX_INST_TOOLS = $(INST_BIN)tools/
145
146	else
147
148	INST_BIN = bin/
149	INST_DIST = $(INST_BIN)
150	INST_SDK = $(INST_BIN)sdk/
151
152	INST_VIRTUALBOX = $(INST_BIN)
153	INST_VBOXDRV = $(INST_BIN)
154	INST_VBOXNETFLT = $(INST_BIN)
155	INST_VBOXNETADP = $(INST_BIN)
156	INST_VBOXUSB = $(INST_BIN)
157
158	INST_DLL = $(INST_BIN)
159	INST_SYS = $(INST_BIN)
160	INST_TESTCASE = $(INST_BIN)testcase/
161	INST_ADDITIONS = $(INST_BIN)additions/
162	INST_ADDITIONS_ISO = $(INST_ADDITIONS)
163	INST_UNATTENDED_TEMPLATES = $(INST_BIN)UnattendedTemplates/
164
165	INST_LIB = lib/
166	INST_ADDITIONS_LIB = $(INST_LIB)additions/
167	VBOX_INST_DTRACE_LIB = $(INST_BIN)dtrace/lib/
168	VBOX_INST_DTRACE_TST = $(INST_BIN)dtrace/testcase/
169
170	INST_VBOXDBG_SYMS = $(INST_BIN)VBoxDbgSyms/
171	VBOX_INST_TOOLS = $(INST_BIN)tools/
172	endif
173
174
175	INST_VALIDATIONKIT = validationkit/
176	INST_TESTBOXSCRIPT = testboxscript/
177
178	INST_DOC = doc/
179	INST_EXTPACK = $(INST_BIN)ExtensionPacks/
180	INST_EXTPACK_CERTS = $(INST_BIN)ExtPackCertificates/
181	INST_EXTPACK_PUEL = $(INST_EXTPACK)$(VBOX_PUEL_MANGLED_NAME)/
182	INST_PACKAGES = packages/
183
184	VBOX_PATH_SDK = $(patsubst %/,%,$(PATH_STAGE)/$(INST_SDK))
185	VBOX_PATH_DIST = $(patsubst %/,%,$(PATH_STAGE)/$(INST_DIST))
186	VBOX_PATH_VALIDATIONKIT = $(patsubst %/,%,$(PATH_STAGE)/$(INST_VALIDATIONKIT))
187	VBOX_PATH_ADDITIONS = $(patsubst %/,%,$(PATH_STAGE)/$(INST_ADDITIONS))
188	VBOX_PATH_ADDITIONS_ISO = $(patsubst %/,%,$(PATH_STAGE)/$(INST_ADDITIONS_ISO))
189	VBOX_PATH_ADDITIONS_LIB = $(patsubst %/,%,$(PATH_STAGE)/$(INST_ADDITIONS_LIB))
190	VBOX_PATH_EXTPACK_PUEL = $(patsubst %/,%,$(PATH_STAGE)/$(INST_EXTPACK_PUEL))
191	VBOX_PATH_PACKAGES = $(patsubst %/,%,$(PATH_STAGE)/$(INST_PACKAGES))
192	VBOX_PATH_TOOLS = $(patsubst %/,%,$(PATH_STAGE)/$(VBOX_INST_TOOLS))
193
194
195	#
196	# Some source paths of global interest.
197	#
198	VBOX_PATH_SRC_CERTIFICATES = $(PATH_ROOT)/src/VBox/HostDrivers/Support/Certificates
199
200
201	#
202	# Delete targets on failure.
203	#
204	.DELETE_ON_ERROR:
205
206	#
207	# Notify about important kBuild updates.
208	#
209	if $(KBUILD_VERSION_MAJOR) == 0 \
210	&& ( $(KBUILD_VERSION_MINOR) >= 2 \
211	\|\| ( $(KBUILD_VERSION_MINOR) == 1 \
212	&& $(KBUILD_VERSION_PATCH) >= 999))
213	VBOX_MIN_KMK_REVISION := 3093
214	VBOX_MIN_KBUILD_KMK_REVISION := $(if-expr "$(KBUILD_HOST)" == "win",3097,$(if-expr "$(KBUILD_HOST).$(KBUILD_HOST_ARCH)" == "solaris.sparc64",2511,3074))
215	if $(KMK_REVISION) >= $(VBOX_MIN_KMK_REVISION)
216	if $(KBUILD_KMK_REVISION) >= $(VBOX_MIN_KBUILD_KMK_REVISION)
217	# OK.
218	else
219	$(error You must update kBuild! Requires kBuild binaries $(VBOX_MIN_KBUILD_KMK_REVISION) or later, kmk says $(KBUILD_KMK_REVISION) ($(KBUILD_VERSION)))
220	endif
221	else
222	$(error You must update kBuild! Requires kBuild revision $(VBOX_MIN_KMK_REVISION) or later, found $(KMK_REVISION) ($(KBUILD_VERSION)))
223	endif
224	else
225	$(error You must update kBuild! Requires 0.1.999 or later, found $(KBUILD_VERSION))
226	endif
227
228	#
229	# Define USERNAME early on.
230	#
231	ifndef USERNAME
232	ifdef USER
233	USERNAME = $(USER)
234	else
235	$(warning Warning: You must have USERNAME or USER in your environment.)
236	endif
237	endif
238
239	#
240	# Detect the darwin host version number so we can disable stuff that doesn't
241	# currently build on Lion.
242	#
243	ifeq ($(KBUILD_HOST),darwin)
244	VBOX_DARWIN_HOST_VERSION := $(subst ., ,$(shell uname -r))
245	# Keep counting _MAJOR past 19.x (macOS 10.15.x) to simplify dealing with macOS 11.x.
246	VBOX_DARWIN_HOST_VERSION_MAJOR := $(expr $(word 1, $(VBOX_DARWIN_HOST_VERSION)) - 4)
247	VBOX_DARWIN_HOST_VERSION_MINOR := $(word 2, $(VBOX_DARWIN_HOST_VERSION))
248	VBOX_DARWIN_HOST_VERSION_PATCH := $(word 3, $(VBOX_DARWIN_HOST_VERSION))
249	if $(VBOX_DARWIN_HOST_VERSION_MAJOR) <= 15
250	VBOX_DARWIN_HOST_VERSION := 10.$(VBOX_DARWIN_HOST_VERSION_MAJOR).$(VBOX_DARWIN_HOST_VERSION_MINOR)
251	else
252	VBOX_DARWIN_HOST_VERSION := 11.$(expr $(VBOX_DARWIN_HOST_VERSION_MAJOR) - 16).$(VBOX_DARWIN_HOST_VERSION_MINOR)
253	endif
254	endif
255
256	include $(PATH_ROOT)/Version.kmk
257
258	# The raw version string. This must not contain any other information/fields than
259	# major, minor and build revision (as it is now) -- also will be used for host/guest version
260	# comparison.
261	VBOX_VERSION_STRING_RAW = $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
262
263	# VBOX_VERSION_STRING without the publisher.
264	VBOX_VERSION_STRING_NO_PUB = $(VBOX_VERSION_STRING_RAW)$(addprefix _,$(VBOX_VERSION_PRERELEASE))
265
266	# Full version string (may include more than just x.y.z, but no spaces or other problematic chars).
267	# Note! The BETA[n],ALPHA[n],RC[n] indicators should be inserted before the
268	# publisher so that RTStrVersionCompare have a chance of comparing
269	# prerelease from different publishers correctly.
270	VBOX_VERSION_STRING = $(VBOX_VERSION_STRING_NO_PUB)$(VBOX_BUILD_PUBLISHER)
271
272
273	## Make a numeric value from the major, minor and build numbers (params)
274	VBOX_FULL_VERSION_MAKE = $(expr ($1 << 24) \| ($2 << 16) \| $3)
275
276	## Checks if the current VBox version is higher or equal to the major, minor and
277	# build numbers given as parameters.
278	# @returns 1 if true, 0 if false. For use with 'if'.
279	VBOX_VERSION_PREREQ = $(expr $(call VBOX_FULL_VERSION_MAKE,$(VBOX_VERSION_MAJOR),$(VBOX_VERSION_MINOR),$(VBOX_VERSION_BUILD)) \
280	>= $(call VBOX_FULL_VERSION_MAKE,$1,$2,$3))
281
282	# Enable host screen saver toggle by default
283	VBOX_WITH_SCREENSAVER_CONTROL = 1
284
285	# Force the additions.sh script to get an exact additions build when we're doing the release.
286	if $(VBOX_VERSION_BUILD) % 2 == 0
287	ifeq ($(VBOX_VERSION_PRERELEASE),)
288	VBOX_RELEASE_EXACT_MATCH = 1
289	endif
290	endif
291	ifneq ($(VBOX_RELEASE_EXACT_MATCH),)
292	export VBOX_ADDITIONS_SH_MODE = release
293	export VBOX_DOCUMENTATION_SH_MODE = release
294	export VBOX_EFI_SH_MODE = release
295	export VBOX_EXTPACKS_SH_MODE = release
296	endif
297
298	# Some info on the vendor
299	VBOX_VENDOR = Oracle and/or its affiliates
300	VBOX_VENDOR_SHORT = Oracle
301	VBOX_PRODUCT = Oracle VM VirtualBox
302	# Not all could be done automatically. Here is a list of known places which
303	# have to be updated manually, please keep this up to date:
304	# src/VBox/Devices/PC/PXE/client/uinit.asm
305	# src/VBox/RDP/webclient/flash/com/sun/network/rdp/Version.as
306	# src/VBox/Frontends/VirtualBox/src/globals/UICommon.cpp
307	# src/VBox/Frontends/VirtualBox/src/settings/global/VBoxGLSettingsLanguage.cpp
308	# src/VBox/Frontends/VirtualBox/nls/*.ts
309	# debian/control
310	# src/VBox/Installer/linux/{debian,rpm}
311	# src/VBox/Installer/linux/virtualbox.desktop
312	# src/VBox/Additions/WINNT/Installer/ISO/ReadmeDrivers.txt
313	# src/VBox/Main/nls/*.ts
314	# src/VBox/ExtPacks/Puel/nls/*.ts
315	# src/VBox/Frontends/VBoxManage/nls/*.ts
316	# /.inf, /.rc
317
318	# Maybe we want set this manually.
319	VBOX_C_YEAR = $(date-utc %Y)
320
321	#
322	# The VirtualBox package type.
323	#
324	ifeq ($(KBUILD_TARGET),win)
325	VBOX_PACKAGE_OS = WINDOWS
326	else ifeq ($(KBUILD_TARGET),linux)
327	VBOX_PACKAGE_OS = LINUX
328	else ifeq ($(KBUILD_TARGET),darwin)
329	VBOX_PACKAGE_OS = DARWIN
330	else ifeq ($(KBUILD_TARGET),solaris)
331	VBOX_PACKAGE_OS = SOLARIS
332	else ifeq ($(KBUILD_TARGET),os2)
333	VBOX_PACKAGE_OS = OS2
334	else ifeq ($(KBUILD_TARGET),haiku)
335	VBOX_PACKAGE_OS = HAIKU
336	else if1of ($(KBUILD_TARGET), dragonfly freebsd netbsd openbsd)
337	VBOX_PACKAGE_OS = BSD
338	else
339	$(error Cannot determine VBOX_PACKAGE_OS)
340	endif
341	ifeq ($(KBUILD_TARGET_ARCH),x86)
342	VBOX_PACKAGE_ARCH = 32BITS
343	else
344	VBOX_PACKAGE_ARCH = 64BITS
345	endif
346	# distribution, mostly for Linux/Solaris where we support different distributions
347	# this strip will be overridden by the Linux packaging scripts
348	VBOX_PACKAGE_DIST ?= GENERIC
349	# Full string
350	VBOX_PACKAGE_STRING = $(VBOX_PACKAGE_OS)_$(VBOX_PACKAGE_ARCH)_$(VBOX_PACKAGE_DIST)
351
352	# Supported VirtualBox host architectures.
353	VBOX_SUPPORTED_HOST_ARCHS := amd64
354	if1of ($(KBUILD_TARGET), darwin) # Work in progress.
355	VBOX_SUPPORTED_HOST_ARCHS += arm64
356	endif
357
358
359	#
360	# The VirtualBox Configuration Defaults.
361	#
362	# We try to document all the build configuration options here, things which
363	# aren't enabled by default are left commented out just to show that they
364	# exist and which value they should have (usually 1, but anyway).
365	#
366
367	# Indicate VBOX_ONLY build if any of the VBOX_ONLY_* variables are set.
368	VBOX_ONLY_BUILD := $(strip $(foreach x, ADDITIONS DOCS EXTPACKS SDK VALIDATIONKIT \
369	, $(if-expr defined(VBOX_ONLY_$(x)),VBOX_ONLY_$(x))))
370	if $(words $(VBOX_ONLY_BUILD)) > 1
371	$(error VBox: More than one VBOX_ONLY build enabled! $(VBOX_ONLY_BUILD))
372	endif
373
374	# Select new Xcode based on host OS X version.
375	ifeq ($(KBUILD_HOST),darwin)
376	if "$(KBUILD_TARGET_ARCH)" == "arm64"
377	VBOX_WITH_EVEN_NEWER_XCODE := 1
378	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)
379	VBOX_WITH_EVEN_NEWER_XCODE := 1
380	else if !defined(VBOX_WITH_NEW_XCODE) && !defined(VBOX_WITHOUT_NEW_XCODE) && $(KBUILD_HOST_VERSION_MAJOR) >= 13 # (OS X 10.9 Mavericks)
381	VBOX_WITH_NEW_XCODE := 1
382	endif
383	endif
384	# Select new VC++ on Windows.
385	VBOX_WITH_NEW_VCC = 1
386	# Use this to disable control flow.
387	#VBOX_WITHOUT_CONTROL_FLOW_GUARD = 1
388	# Select Windows 11 SDK.
389	VBOX_WITH_NEW_WINDOWS_SDK = 1
390	# Select Windows 11 DDK.
391	VBOX_WITH_NEW_WINDOWS_DDK = 1
392	# Don't use the compiler CRT for statically linked modules, use IPRT with some
393	# additional CRT functionality.
394	# Note! This has only been tested with Visual C++ 2019.
395	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" != "asan"
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), darwin)
551	VBOX_WITH_DRIVERLESS_NEM_FALLBACK = 1
552	endif
553	# Enable forced driverless mode by default.
554	if1of ($(KBUILD_TARGET), darwin)
555	VBOX_WITH_DRIVERLESS_FORCED = 1
556	VBOX_WITH_INTNET_SERVICE_IN_R3 = 1
557	endif
558	# Enables the new breakpoint handling code, see @bugref{8650}
559	VBOX_WITH_DBGF_FLOW_TRACING = 1
560	# Enables ARMv8 virtualization, see @bugref{10383}
561	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.arm64)
562	VBOX_WITH_VIRT_ARMV8 = 1
563	endif
564	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), linux.amd64)
565	ifdef VBOX_WITH_R0_MODULES
566	# Enable IBT branch protection for the R0 modules.
567	# (A make warning will be shown if gcc is too old.)
568	VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION = 1
569	endif
570	endif
571	## @}
572
573
574	## @name Devices, Drivers, ...
575	## @{
576	# Build the Host Guest Communication Manager component.
577	VBOX_WITH_HGCM = 1
578	## Build the bugcheck detection code.
579	#VBOX_WITH_GUEST_BUGCHECK_DETECTION =
580	# Enable the USB feature. This includes VBOX_WITH_VUSB!
581	VBOX_WITH_USB = 1
582	# Enable the USB 1.1 controller plus virtual USB HID devices.
583	VBOX_WITH_VUSB = 1
584	# Enable the USB 2.0 controller.
585	VBOX_WITH_EHCI = 1
586	# Enable the ISCSI feature.
587	VBOX_WITH_ISCSI = 1
588	# Enable INIP support in the ISCSI feature.
589	VBOX_WITH_INIP = 1
590	# Enables lwip as a core of NAT service
591	VBOX_WITH_LWIP_NAT = 1
592	# Enables compilation of NAT service
593	VBOX_WITH_NAT_SERVICE = 1
594	# Enable the E1000 feature.
595	VBOX_WITH_E1000 = 1
596	# Enable the Virtio feature.
597	VBOX_WITH_VIRTIO = 1
598	# Enable the Virtio SCSI device.
599	VBOX_WITH_VIRTIO_SCSI = 1
600	# HDA emulation is Intel HDA by default.
601	VBOX_WITH_INTEL_HDA = 1
602	ifn1of ($(KBUILD_TARGET), win darwin)
603	# Enable OSS audio support.
604	VBOX_WITH_AUDIO_OSS = 1
605	endif
606	if1of ($(KBUILD_TARGET), linux)
607	# Enable ALSA audio support.
608	VBOX_WITH_AUDIO_ALSA = 1
609	endif
610	if1of ($(KBUILD_TARGET), linux)
611	# Enable PulseAudio audio support.
612	VBOX_WITH_AUDIO_PULSE = 1
613	endif
614	# Enable building debugging backend.
615	# Only will be used at runtime when "VBoxInternal2/Audio/Debug/Enabled" (VM / global) is set.
616	VBOX_WITH_AUDIO_DEBUG = 1
617	# Enables the audio endpoint detection on Windows hosts.
618	VBOX_WITH_AUDIO_MMNOTIFICATION_CLIENT = 1
619	# Enable PCI passthrough support.
620	# (disabled with 6.1, since it's not complete/useful enough)
621	VBOX_WITH_PCI_PASSTHROUGH =
622	# Enable statically linked dbus support.
623	if1of ($(KBUILD_TARGET), linux solaris)
624	VBOX_WITH_DBUS = 1
625	endif
626	# Enable building PAM modules.
627	if1of ($(KBUILD_TARGET), linux solaris)
628	VBOX_WITH_PAM = 1
629	endif
630	# Enable internal networking.
631	VBOX_WITH_INTERNAL_NETWORKING = 1
632	# Enable vmsvga (svga2) graphics device variant, 2D part
633	VBOX_WITH_VMSVGA = 1
634	# Enable vmsvga (svga2) graphics device variant, 3D part
635	if1of ($(KBUILD_TARGET), darwin linux win)
636	VBOX_WITH_VMSVGA3D = 1
637	endif
638	# Enable vmsvga (svga2) graphics device variant, 3D part, VGPU10 DX commands
639	ifdef VBOX_WITH_VMSVGA3D
640	VBOX_WITH_VMSVGA3D_DX = 1
641	# Enable DXVK library for supporting VGPU10 DX on non Windows hosts
642	if1of ($(KBUILD_TARGET), linux darwin)
643	VBOX_WITH_DXVK = 1
644	endif
645	endif
646	# Enable the generic 3D settings support if at least one 3D capable solution is enabled
647	ifdef VBOX_WITH_VMSVGA3D
648	VBOX_WITH_3D_ACCELERATION = 1
649	endif
650	# Enable Host Guest Shared Memory Interface.
651	VBOX_WITH_HGSMI = 1
652	# Enable Video 2D Acceleration.
653	if1of ($(KBUILD_TARGET), darwin linux win freebsd)
654	VBOX_WITH_VIDEOHWACCEL = 1
655	endif
656	# Enable Wddm Video driver for Vista+ guests.
657	VBOX_WITH_WDDM = 1
658	# Lazy developer!!
659	VBOXWDDM_WITH_VBVA = 1
660	# Lazy developer!!
661	ifdef VBOX_WITH_WDDM
662	VBOX_WITH_VDMA = 1
663	else ifdef VBOX_WITH_VDMA
664	undefine VBOX_WITH_VDMA
665	endif
666	# Gallium based WDDM driver
667	if1of ($(KBUILD_TARGET), win)
668	VBOX_WITH_MESA3D = 1
669	endif
670	# VGPU10 UMD driver for Vista+ guests in the guest additions installer
671	ifdef VBOX_WITH_VMSVGA3D_DX
672	if1of ($(KBUILD_TARGET), win)
673	VBOX_WITH_WDDM_DX = 1
674	endif
675	endif
676	# Disable the Intel PXE ROM (uses Etherboot).
677	VBOX_WITH_INTEL_PXE =
678	# Enable EFI support
679	VBOX_WITH_EFI = 1
680	# Enable Secure Boot in the EFI firmware.
681	VBOX_WITH_EFI_SECURE_BOOT = 1
682	# Enable TPM support in the EFI firmware.
683	VBOX_WITH_EFI_TPM = 1
684	# Embed the EFI firmwares in VBoxDD2.dll/dylib/so.
685	VBOX_WITH_EFI_IN_DD2 = 1
686	# Fetch EFI firmware image from the build server
687	#VBOX_WITH_EFIFW_FROM_BUILD_SERVER = 1
688	# Include the EFI firmware into the package
689	ifndef VBOX_WITH_EFI_IN_DD2
690	VBOX_WITH_EFIFW_PACKING = 1
691	endif
692	# Enable setuid wrapper for Solaris host DVD.
693	#VBOX_WITH_SUID_WRAPPER = 1
694	# Enable the virtual SATA/AHCI controller
695	VBOX_WITH_AHCI = 1
696	# Enable the new async completion manager
697	VBOX_WITH_PDM_ASYNC_COMPLETION = 1
698	ifdef VBOX_WITH_USB
699	VBOX_WITH_VUSB = 1
700	VBOX_WITH_XHCI_IMPL = 1
701	endif
702	ifdef VBOX_WITH_EHCI
703	VBOX_WITH_EHCI_IMPL = 1
704	endif
705	ifdef VBOX_WITH_PCI_PASSTHROUGH
706	## @bugref{9218}: Disabled awaiting conversion of the device to new PDM device style.
707	#VBOX_WITH_PCI_PASSTHROUGH_IMPL = 1
708	endif
709	ifndef VBOX_WITHOUT_HOSTWEBCAM
710	VBOX_WITH_USB_VIDEO_IMPL = 1
711	endif
712	# Enable the hal/sysfs USB code on Linux.
713	ifeq ($(KBUILD_TARGET),linux)
714	VBOX_USB_WITH_SYSFS = 1
715	# Disabled for now
716	# VBOX_USB_WITH_DBUS = 1
717	VBOX_USB_WITH_INOTIFY = 1
718	endif
719	# Enable performance API.
720	VBOX_WITH_RESOURCE_USAGE_API = 1
721	# Use VBoxVolInfo for getting FS dependecies.
722	if1of ($(KBUILD_TARGET), linux)
723	VBOX_WITH_DEVMAPPER = 1
724	endif
725	# Enable unattended installation API
726	VBOX_WITH_UNATTENDED = 1
727	# Enable BusLogic SCSI host adapter
728	VBOX_WITH_BUSLOGIC = 1
729	# Enable LsiLogic SCSI host adapter
730	VBOX_WITH_LSILOGIC = 1
731	# Enable SCSI drivers
732	VBOX_WITH_SCSI = 1
733	# Enable this setting to force a fallback to default DMI data on configuration errors
734	VBOX_BIOS_DMI_FALLBACK =
735	# Enable the builtin PXE ROM
736	VBOX_WITH_PXE_ROM = 1
737	# Enable MSI support in devices
738	VBOX_WITH_MSI_DEVICES = 1
739	# Enable host network interface API.
740	if1of ($(KBUILD_TARGET), darwin freebsd linux solaris win)
741	VBOX_WITH_HOSTNETIF_API = 1
742	endif
743	# Emulated USB smart card reader
744	VBOX_WITH_USB_CARDREADER = 1
745	# Disk crypt plugin
746	VBOX_WITH_PLUGIN_CRYPT = 1
747	# VirtualKD stub/loader device, only relevant on Windows host
748	VBOX_WITH_VIRTUALKD = 1
749	# NVMe device emulation
750	VBOX_WITH_NVME_IMPL = 1
751	# Storage related debug drivers
752	VBOX_WITH_DRV_DISK_INTEGRITY = 1
753	# Enables the AMD IOMMU
754	VBOX_WITH_IOMMU_AMD = 1
755	# Enables the Intel IOMMU
756	VBOX_WITH_IOMMU_INTEL = 1
757	# Enables the new DBGF tracing framework
758	VBOX_WITH_DBGF_TRACING = 1
759	# Enable TPM device emulation support.
760	VBOX_WITH_TPM = 1
761	# Enable libtpms, required for the in process TPM emulation.
762	if1of ($(KBUILD_TARGET), linux darwin win solaris)
763	VBOX_WITH_LIBTPMS = 1
764	endif
765	# Disable keyboard HID Consumer/Desktop control keys passthrough
766	# VBOX_WITHOUT_KEYBOARD_HID_CC_DC_PASSTHROUGH = 1
767	## @}
768
769	# legacy
770	ifdef VBOX_ONLY_TESTSUITE
771	$(warning VBOX_ONLY_TESTSUITE was renamed to VBOX_ONLY_VALIDATIONKIT)
772	VBOX_ONLY_VALIDATIONKIT = $(VBOX_ONLY_TESTSUITE)
773	endif
774
775	## @name Other Component
776	## @{
777	# Build the installer.
778	VBOX_WITH_INSTALLER = 1
779	VBOX_WITH_GUEST_INSTALLER_UNICODE = 1
780	# The kernel driver/module and related runtime libraries.
781	# On Linux we build this as a test case instead.
782	# On darwin we don't use a support driver.
783	if "$(KBUILD_TARGET)" != "linux" && "$(KBUILD_TARGET)" != "darwin"
784	VBOX_WITH_VBOXDRV = 1
785	endif
786	# The main api.
787	VBOX_WITH_MAIN = 1
788	# Enables proxy stub for MS COM (speeds up setting IPC for objects).
789	# (The VBOX_MIDL_PROXY_CLSID and VBOX_MIDL_PROXY_CLSID_IS are just two
790	# representations of the class ID for the proxy stub.)
791	VBOX_WITH_MIDL_PROXY_STUB = 1
792	VBOX_MIDL_PROXY_CLSID := {0bb3b78c-1807-4249-5ba5-ea42d66af0bf}
793	VBOX_MIDL_PROXY_CLSID_IS := {0x0bb3b78c,0x1807,0x4249,{0x5b,0xa5,0xea,0x42,0xd6,0x6a,0xf0,0xbf}}
794	# Whether to also ship 32-bit main API on 64-bit systems.
795	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), solaris.amd64 win.amd64)
796	if !defined(VBOX_ONLY_VALIDATIONKIT) && !defined(VBOX_ONLY_ADDITIONS) && !defined(VBOX_ONLY_DOCS) && !defined(VBOX_ONLY_EXTPACKS)
797	VBOX_WITH_32_ON_64_MAIN_API = 1
798	endif
799	endif
800	# Whether to generate a database of USB vendor IDs and device IDs into VBoxSVC.
801	VBOX_WITH_MAIN_USB_ID_DATABASE = 1
802	# Whether to enable error message translation in Main.
803	ifndef VBOX_ONLY_BUILD
804	VBOX_WITH_MAIN_NLS = 1
805	endif
806	# Whether to enable error message translation in Extension VM Pack.
807	if !defined(VBOX_ONLY_BUILD) \|\| defined(VBOX_ONLY_EXTPACKS)
808	VBOX_WITH_PUEL_NLS = 1
809	endif
810	# Whether to enable message translation in VBoxManage.
811	#ifndef VBOX_ONLY_BUILD
812	VBOX_WITH_VBOXMANAGE_NLS = 1
813	#endif
814	# Set this to prefix all C symbols in XPCOM, to avoid dynamic linking problems
815	# caused by our XPCOM library polluting the symbol namespace for system libs.
816	if1of ($(KBUILD_TARGET), linux solaris)
817	VBOX_WITH_XPCOM_NAMESPACE_CLEANUP = 1
818	endif
819	# The webservices api.
820	VBOX_WITH_WEBSERVICES = 1
821	VBOX_WITH_WEBSERVICES_SSL = 1
822	# The Qt GUI.
823	VBOX_WITH_QTGUI = 1
824	# Indicates the Qt is Cocoa based on the Mac.
825	ifeq ($(KBUILD_TARGET),darwin)
826	VBOX_WITH_COCOA_QT = 1
827	endif
828	# Use Qt6 instead of Qt5.
829	VBOX_WITH_QT6 := 1
830
831	# VBox Ballooning Control frontend.
832	VBOX_WITH_FE_BALLOONCTRL = 1
833	# VBox Autostart Service.
834	VBOX_WITH_FE_AUTOSTART = 1
835	# VBox Bug Report tool.
836	VBOX_WITH_FE_BUGREPORT = 1
837	# Enable this to get the SDL based GUI built. Mostly useful for development
838	# purposes. For production use it's recommended to use the Qt GUI which can
839	# be also stripped down. See VBOX_WITH_QTGUI.
840	VBOX_WITH_VBOXSDL =
841	# Start VBoxSVC in windows session 0 (services session).
842	VBOX_WITH_VBOXSVC_SESSION_0 = 1
843	# The headless frontend.
844	VBOX_WITH_HEADLESS = 1
845	# Enable the build of VRDP server.
846	VBOX_WITH_VRDP = 1
847	# Build the VRDP authentication modules.
848	VBOX_WITH_VRDP_AUTHMOD = 1
849	# Build enhanced version of rdesktop.
850	VBOX_WITH_VRDP_RDESKTOP = 1
851	## The Direct Framebuffer GUI.
852	#VBOX_WITH_VBOXFB = 1
853	# The basic frontend not using Main/COM/XPCOM.
854	#VBOX_WITH_VBOXBFE = 1
855	# Enables the Python<->XPCOM, Python<->COM and (WS enabled) Python<->WS bindings.
856	VBOX_WITH_PYTHON ?= 1
857	# Enables the PERL<->WS binding (if WS enabled).
858	#VBOX_WITH_PERL ?= 1
859	# Enables the PHP<->WS binding (if WS enabled).
860	VBOX_WITH_PHP ?= 1
861	if1of ($(KBUILD_TARGET), darwin linux solaris)
862	# Enable Java<->XPCOM bridge + glue code
863	VBOX_WITH_JXPCOM ?= 1
864	endif
865	if1of ($(KBUILD_TARGET), ) # scm:ignore-empty-if1of-set
866	# Enable Java<->MSCOM glue, bridge is provided by an external lib (Jacob)
867	VBOX_WITH_JMSCOM ?= 1
868	endif
869	if1of ($(KBUILD_TARGET), darwin linux solaris)
870	# Enable Java<->JAX-WS bridge
871	VBOX_WITH_JWS ?= 1
872	endif
873	# Use XPIDL instead of XSLT stylesheet
874	VBOX_WITH_JAVA_SUPPORT_IN_XPIDL ?=
875	# Build against multiple Python versions present in the system (only up to 3.2,
876	# unless VBOX_WITH_ONLY_PYTHON_LIMITED_API is overridden).
877	VBOX_WITH_MULTIVERSION_PYTHON ?= 1
878	# Only build the limited Python extension API version for 3.3 and later.
879	VBOX_WITH_ONLY_PYTHON_LIMITED_API = 1
880	# Build the Validation Kit.
881	VBOX_WITH_VALIDATIONKIT = 1
882	# Include unit tests (testcases) on the Validation Kit .ISO
883	# so that we can perform testing on older platforms which we don't support
884	# on the host anymore.
885	if1of ($(KBUILD_TARGET), darwin.amd64 linux win)
886	VBOX_WITH_VALIDATIONKIT_UNITTESTS_PACKING = 1
887	endif
888	# Set if we should ship the audio test from the Validation Kit with the host installer.
889	VBOX_WITH_HOST_SHIPPING_AUDIO_TEST = 1
890	# Set if we should ship the audio test from the Validation Kit with the guest additions.
891	VBOX_WITH_ADDITIONS_SHIPPING_AUDIO_TEST = 1
892	# Build the testcases.
893	VBOX_WITH_TESTCASES = 1
894	# Enable this to build vbox-img even if VBOX_WITH_TESTCASES is disabled
895	VBOX_WITH_VBOX_IMG =
896	# Enables recording support.
897	VBOX_WITH_RECORDING = 1
898	# Enable VPX (VP8 / VP9 codec), required for video capturing.
899	VBOX_WITH_LIBVPX = 1
900	# Enables audio support for recording (depends on VBOX_WITH_RECORDING).
901	VBOX_WITH_AUDIO_RECORDING = 1
902	if defined(VBOX_WITH_AUDIO_RECORDING) && !defined(VBOX_WITH_RECORDING)
903	$(error Audio recording (VBOX_WITH_AUDIO_RECORDING) needs the general recording feature (VBOX_WITH_RECORDING) enabled)
904	endif
905	# Enables libvorbis (Ogg Vorbis), required for encoding audio into the recorded data.
906	VBOX_WITH_LIBVORBIS = 1
907	# Enables libogg (Ogg file format). Required for building libvorbis above.
908	VBOX_WITH_LIBOGG = 1
909	if defined(VBOX_WITH_LIBVORBIS) && !defined(VBOX_WITH_LIBOGG)
910	$(error Need libogg (VBOX_WITH_LIBOGG) in order to build libvorbis (VBOX_WITH_LIBVORBIS))
911	endif
912	# Enable Wayland support for Guest Additions
913	VBOX_WITH_WAYLAND_ADDITIONS = 1
914	# Enable shared folders
915	VBOX_WITH_SHARED_FOLDERS = 1
916	# Enable shared clipboard
917	VBOX_WITH_SHARED_CLIPBOARD = 1
918	# Enable shared clipboard (file) transfers
919	if1of ($(KBUILD_TARGET), win linux)
920	VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS = 1
921	if1of ($(KBUILD_TARGET), linux)
922	VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS_HTTP = 1
923	endif
924	endif
925	# Enable the host/guest information service (aka guest properties).
926	VBOX_WITH_GUEST_PROPS = 1
927	# Enable this to prevent the guest from writing guest properties.
928	VBOX_WITH_GUEST_PROPS_RDONLY_GUEST =
929	# Compile the host channel
930	VBOX_WITH_HOST_CHANNEL = 1
931	# Enable the guest control service.
932	if1of ($(KBUILD_TARGET), darwin freebsd linux solaris win)
933	VBOX_WITH_GUEST_CONTROL = 1
934	# Enables support for handling certain commands via the built-in (busybox-like) toolbox in VBoxService. See @bugref{9783}
935	# This is for supporting Guest Additions < 7.1.
936	VBOX_WITH_GSTCTL_TOOLBOX_SUPPORT = 1
937	# Enables treating the toolbox as built-in commands. Requires 7.1 Guest Additions. See @bugref{9783}
938	VBOX_WITH_GSTCTL_TOOLBOX_AS_CMDS = 1
939	endif
940	# Enable ballooning
941	VBOX_WITH_MEMBALLOON = 1
942	# Enable cURL (required for the network part of the GUI)
943	VBOX_WITH_LIBCURL = 1
944	# Enable libssh (required for cloud network attachment)
945	if1of ($(KBUILD_TARGET), darwin linux win)
946	VBOX_WITH_LIBSSH = 1
947	endif
948	# Enable Host=>Guest Drag'n'Drop
949	if1of ($(KBUILD_TARGET), darwin linux solaris win)
950	VBOX_WITH_DRAG_AND_DROP = 1
951	if1of ($(KBUILD_TARGET), darwin linux solaris win)
952	VBOX_WITH_DRAG_AND_DROP_GH = $(VBOX_WITH_DRAG_AND_DROP)
953	endif
954	ifdef VBOX_WITH_DRAG_AND_DROP_GH
955	ifeq ($(KBUILD_TARGET),darwin)
956	# On OS X (Darwin) this needs to be set in order to get proper
957	# guest->host support.
958	# Note: Setting this requires Qt also having this feature enabled!
959	VBOX_WITH_DRAG_AND_DROP_PROMISES = $(VBOX_WITH_DRAG_AND_DROP)
960	endif
961	endif
962	endif
963	# Enable audio support for VRDE.
964	VBOX_WITH_AUDIO_VRDE = 1
965	ifdef VBOX_WITH_VALIDATIONKIT
966	# Ship the Validation Kit audio driver for running tests (driver disabled by default).
967	VBOX_WITH_AUDIO_VALIDATIONKIT = 1
968	endif
969	# Use the VRDE external authentication library from VBoxSVC.
970	if1of ($(KBUILD_TARGET), win)
971	VBOX_WITH_VRDEAUTH_IN_VBOXSVC = 1
972	endif
973	# Enables use of merge modules in the windows installer. This will increase
974	# the overall installer size significantly because merge modules are not able
975	# to use a common .cab file to reduce their size.
976	#VBOX_WITH_MSM_INSTALL = 1
977	# Enables full VM encryption support @bugref{9955}.
978	VBOX_WITH_FULL_VM_ENCRYPTION = 1
979	# Enables the 'sign' command in bldRTSignTool. We may need this on windows.
980	if1of ($(KBUILD_TARGET), win)
981	VBOX_WITH_BLD_RTSIGNTOOL_SIGNING = 1
982	endif
983	# Enables support for liblzma inside of IPRT.
984	ifndef VBOX_ONLY_SDK
985	VBOX_WITH_LIBLZMA = 1
986	endif
987	## @}
988
989
990	## @name Networking
991	## @{
992	# Use VBoxNetFlt for host interface networking.
993	if1of ($(KBUILD_TARGET), darwin freebsd linux solaris win)
994	VBOX_WITH_NETFLT = 1
995	ifeq ($(KBUILD_TARGET),solaris)
996	# requires snv_159+.
997	VBOX_WITH_NETFLT_CROSSBOW = 1
998	endif
999	# Use VBoxNetAdp for host only networking.
1000	if1of ($(KBUILD_TARGET), darwin freebsd linux solaris win)
1001	VBOX_WITH_NETADP = 1
1002	endif
1003	endif
1004	# Enables the UDP tunnel transport.
1005	VBOX_WITH_UDPTUNNEL = 1
1006	# Enable the netshaper support
1007	VBOX_WITH_NETSHAPER = 1
1008	# Enable Virtual Distributed Ethernet or not.
1009	if1of ($(KBUILD_TARGET), freebsd linux)
1010	VBOX_WITH_VDE = 1
1011	endif
1012	# Use new VBoxNetDhcpd instead of old VBoxNetDHCP
1013	VBOX_WITH_DHCPD = 1
1014	# Experimental suport for cloud network integration (depends on libssh)
1015	ifdef VBOX_WITH_LIBSSH
1016	VBOX_WITH_CLOUD_NET = 1
1017	endif
1018	# Use Mac OS X VMNET API instead of network kernel extensions
1019	VBOX_WITH_VMNET = 1
1020	## @}
1021
1022
1023	## @name Extension pack
1024	## @{
1025	# Enables the extension pack feature.
1026	VBOX_WITH_EXTPACK = 1
1027	# Enables separating code into the Oracle VM VirtualBox Extension Pack, dubbed PUEL.
1028	VBOX_WITH_EXTPACK_PUEL = 1
1029	# Enables building+packing the Oracle VM VirtualBox Extension Pack, includes VBOX_WITH_EXTPACK_PUEL
1030	VBOX_WITH_EXTPACK_PUEL_BUILD = 1
1031	# Enable the BusMouse sample extension pack.
1032	#VBOX_WITH_EXTPACK_BUSMOUSESAMPLE = 1
1033	# Enable the VNC server extension pack (GPL only).
1034	#VBOX_WITH_EXTPACK_VNC = 1
1035	# Enables the VBoxDTrace extension pack.
1036	VBOX_WITH_EXTPACK_VBOXDTRACE = 1
1037	## @}
1038
1039	## @name Misc
1040	## @{
1041	# Enables all the doxgen bits.
1042	VBOX_WITH_ALL_DOXYGEN_TARGETS = 1
1043	# Set this to skip installing the redistributable compiler runtime.
1044	#VBOX_WITHOUT_COMPILER_REDIST = 1
1045	# Enables VMMR0.r0 (++) loading using the native loader on solaris.
1046	# Good for debugging and analysis. Experimental.
1047	#VBOX_WITH_NATIVE_SOLARIS_LOADING = 1
1048	# Set this to enable user mode dtrace probes.
1049	if1of ($(KBUILD_TARGET), darwin linux solaris)
1050	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1051	VBOX_WITH_DTRACE_R3 := 1
1052	VBOX_WITH_DTRACE_R3_MAIN := 1
1053	endif
1054	endif
1055	# Set this to enable kernel driver dtrace probes.
1056	if1of ($(KBUILD_TARGET), darwin solaris)
1057	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1058	VBOX_WITH_DTRACE_R0DRV := 1
1059	endif
1060	endif
1061	# Set this to enable dtrace probes in platform agnostic kernel code.
1062	ifn1of ($(KBUILD_TARGET), os2)
1063	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1064	VBOX_WITH_DTRACE_R0 := 1
1065	endif
1066	endif
1067	# Set this to enable dtrace probes raw-mode context code.
1068	if1of ($(KBUILD_TARGET), linux solaris)
1069	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1070	VBOX_WITH_DTRACE_RC := 1
1071	endif
1072	endif
1073	# Set this to enable support for dtrace probes in guest code.
1074	#VBOX_WITH_DTRACE_GST = 1
1075	# Set this to indicate that the host ships with DTrace.
1076	if1of ($(KBUILD_TARGET), darwin solaris)
1077	if1of ($(KBUILD_TARGET_ARCH), x86 amd64) ## @todo bugref:9898
1078	VBOX_WITH_NATIVE_DTRACE := 1
1079	endif
1080	endif
1081	# Makes it possible to run some of the testcases and tools on older
1082	# windows versions (only define when buildling win.x86).
1083	#VBOX_WITH_MORE_NT4_COMPAT_BINARIES = 1
1084	# Set this to enable building of the vboximg-mount FUSE mounting utility.
1085	if1of ($(KBUILD_TARGET), darwin linux)
1086	VBOX_WITH_VBOXIMGMOUNT = 1
1087	endif
1088	# Set this to enable packaging the fuse related bits into our installer.
1089	# Newer versions prohibit from distributing with commercial software @bugref{8515}
1090	#if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.amd64)
1091	# VBOX_WITH_FUSE_PACKING = 1
1092	#endif
1093	# Enables updating checking through Main.
1094	# Only available if cURL is being used.
1095	ifdef VBOX_WITH_LIBCURL
1096	VBOX_WITH_UPDATE_AGENT = 1
1097	endif
1098	## @}
1099
1100
1101	## @name Compiler and linker config
1102	## @{
1103	# For treating compiler and linker warnings as errors where possible.
1104	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.x86 darwin.amd64 darwin.arm64 linux.x86 linux.amd64 linux.arm64 win.x86 win.amd64)
1105	VBOX_WITH_WARNINGS_AS_ERRORS = 1
1106	endif
1107	# Whether we can use Open Watcom to build stuff.
1108	if1of ($(KBUILD_TARGET), darwin linux os2 win)
1109	if1of ($(KBUILD_TARGET_ARCH), amd64 x86)
1110	VBOX_WITH_OPEN_WATCOM := 1
1111	endif
1112	endif
1113	## @}
1114
1115
1116	## @name Hardening
1117	## @{
1118	# Enables hardening.
1119	# Most developers will want to disable this in their LocalConfig.kmk.
1120	VBOX_WITH_HARDENING = 1
1121	# Where the application files are (going to be) installed.
1122	#VBOX_PATH_APP_PRIVATE = /usr/lib/virtualbox
1123	ifdef VBOX_WITH_HARDENING
1124	if1of ($(KBUILD_TARGET), linux solaris)
1125	VBOX_PATH_APP_PRIVATE = /opt/VirtualBox
1126	else ifeq ($(KBUILD_TARGET),darwin)
1127	VBOX_PATH_APP_PRIVATE = /Applications/VirtualBox.app/Contents/MacOS
1128	else ifeq ($(KBUILD_TARGET),freebsd)
1129	VBOX_PATH_APP_PRIVATE = /usr/local/lib/virtualbox
1130	else ifeq ($(KBUILD_TARGET),haiku)
1131	VBOX_PATH_APP_PRIVATE = /boot/system/apps/VirtualBox
1132	endif
1133	endif
1134	# Where the architecture specific application files are (going to be) installed.
1135	#VBOX_PATH_APP_PRIVATE_ARCH = /usr/lib/virtualbox
1136	ifdef VBOX_WITH_HARDENING
1137	if1of ($(KBUILD_TARGET), solaris)
1138	VBOX_PATH_APP_PRIVATE_ARCH_TOP = $(VBOX_PATH_APP_PRIVATE)
1139	VBOX_PATH_APP_PRIVATE_ARCH = $(VBOX_PATH_APP_PRIVATE_ARCH_TOP)/$(if-expr $(KBUILD_TARGET_ARCH) == "amd64",amd64,i386)
1140	else ifdef VBOX_PATH_APP_PRIVATE
1141	VBOX_PATH_APP_PRIVATE_ARCH = $(VBOX_PATH_APP_PRIVATE)
1142	endif
1143	endif
1144	# Where the shared libraries are (going to be) installed.
1145	#VBOX_PATH_SHARED_LIBS = /usr/lib
1146	ifdef VBOX_WITH_HARDENING
1147	if1of ($(KBUILD_TARGET), solaris)
1148	VBOX_PATH_SHARED_LIBS = $(VBOX_PATH_APP_PRIVATE)/$(if-expr $(KBUILD_TARGET_ARCH) == "amd64",amd64,i386)
1149	else ifdef VBOX_PATH_APP_PRIVATE
1150	VBOX_PATH_SHARED_LIBS = $(VBOX_PATH_APP_PRIVATE)
1151	endif
1152	endif
1153	# Where the documentation is (going to be) installed.
1154	#VBOX_PATH_APP_DOCS = /usr/share/doc/virtualbox
1155	ifdef VBOX_WITH_HARDENING
1156	ifdef VBOX_PATH_APP_PRIVATE
1157	VBOX_PATH_APP_DOCS = $(VBOX_PATH_APP_PRIVATE)
1158	endif
1159	endif
1160	# The DT_RPATH/DT_RUNPATH to embed into the binaries (ELF).
1161	# (This one is used for all binaries, there is no need to adjust this
1162	# depending on the location of the object.)
1163	#VBOX_WITH_RUNPATH = /usr/lib/virtualbox
1164	ifdef VBOX_WITH_HARDENING
1165	if1of ($(KBUILD_TARGET), solaris)
1166	VBOX_WITH_RUNPATH = $(VBOX_PATH_APP_PRIVATE)/$(if-expr $(KBUILD_TARGET_ARCH) == "amd64",amd64,i386)
1167	else if1of ($(KBUILD_TARGET), freebsd linux)
1168	VBOX_WITH_RUNPATH = $(VBOX_PATH_APP_PRIVATE)
1169	endif
1170	endif
1171	# Enable use of the $ORIGIN DT_RPATH/DT_RUNPATH feature (ELF).
1172	# Because of the setuid usage on all ELF platforms when hardening the build
1173	# things gets a bit complicated since the $ORIGIN+setuid policy differs.
1174	#VBOX_WITH_ORIGIN = 1
1175	ifndef VBOX_WITH_HARDENING
1176	if1of ($(KBUILD_TARGET), freebsd linux netbsd openbsd solaris) # duplicated further down
1177	VBOX_WITH_ORIGIN = 1
1178	endif
1179	endif
1180	# Enable the system wide support service/daemon.
1181	# Very sketchy work in progress.
1182	#VBOX_WITH_SUPSVC = 1
1183
1184	# Continue to support Vista w/o any service pack, at least for now.
1185	VBOX_WITH_VISTA_NO_SP = 1
1186	ifdef VBOX_WITH_VBOXDRV
1187	# Enable image verification on darwin @bugref{9232}.
1188	VBOX_WITH_DARWIN_R0_DARWIN_IMAGE_VERIFICATION = 1
1189	endif
1190	## @}
1191
1192
1193	# Strip binaries of release and profile builds before packing them into the installer
1194	# archive. When building .deb/.rpms, don't strip the symbols as they are required for
1195	# the debug packages containing symbols for gdb located in /usr/lib/debug.
1196	# In rpm Additions we also need to do part of packing without strip.
1197	ifndef VBOX_ONLY_RPM_ADDITIONS
1198	VBOX_DO_STRIP := $(if $(filter release profile,$(KBUILD_TYPE)),1,)
1199	endif
1200
1201
1202	#
1203	# Config items for enabling work in progress.
1204	#
1205	# It's good pratice to add stuff here even if it is currently disabled by
1206	# default.
1207	#
1208	# Note! Please, do not add stuff to the global DEFS unless it is really
1209	# necessary! The other guys will hate for it you when they have to
1210	# recompile everything when the feature is enabled or disabled. Put
1211	# the ifdefs in target or template definitions.
1212	#
1213
1214	# Mask all Local APIC interrupt vectors which are set up to NMI mode when switching
1215	# to/from the guest in raw mode. Modern Linux kernels use the performance counter
1216	# to raise an NMI from time to time.
1217	if1of ($(KBUILD_TARGET), linux)
1218	VBOX_WITH_VMMR0_DISABLE_LAPIC_NMI = 1
1219	endif
1220	## For testing deadlock detection and lock order validation.
1221	# If issues are found, create high priority defects and temporarily comment
1222	# the next line.
1223	VBOX_WITH_STRICT_LOCKS = 1
1224	## VBoxSDS is the bridge windows service that sits between
1225	# VirtualBox object client and VBoxSVC that fixes problem
1226	# when multiple VBoxSVC starts for the same user
1227	# it is enabled for windows build only
1228	ifeq ($(KBUILD_TARGET),win)
1229	VBOX_WITH_SDS = 1
1230	endif
1231
1232
1233	#
1234	# Branding
1235	#
1236	VBOX_BRAND_BIOS_LOGO := $(PATH_ROOT)/src/VBox/Devices/Graphics/BIOS/puel_logo.bmp
1237	VBOX_BRAND_LICENSE_HTML := $(PATH_ROOT)/doc/License-gpl-3.0.html
1238	VBOX_BRAND_LICENSE_RTF := $(PATH_ROOT)/doc/License-gpl-3.0.rtf
1239	VBOX_BRAND_LICENSE_TXT := $(PATH_ROOT)/doc/License-gpl-3.0.txt
1240	VBOX_BRAND_LICENSE_VER :=
1241	VBOX_BRAND_GUI_ABOUT_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about.png
1242	VBOX_BRAND_GUI_ABOUT_X2_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_x2.png
1243	VBOX_BRAND_GUI_ABOUT_X3_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_x3.png
1244	VBOX_BRAND_GUI_ABOUT_X4_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_x4.png
1245	VBOX_BRAND_GUI_ABOUT_16PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_16px.png
1246	VBOX_BRAND_GUI_ABOUT_16PX_X2_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_16px_x2.png
1247	VBOX_BRAND_GUI_ABOUT_16PX_X3_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_16px_x3.png
1248	VBOX_BRAND_GUI_ABOUT_16PX_X4_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/about_16px_x4.png
1249	VBOX_BRAND_GUI_VBOX_16PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_16px.png
1250	VBOX_BRAND_GUI_VBOX_20PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_20px.png
1251	VBOX_BRAND_GUI_VBOX_32PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_32px.png
1252	VBOX_BRAND_GUI_VBOX_40PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_40px.png
1253	VBOX_BRAND_GUI_VBOX_48PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_48px.png
1254	VBOX_BRAND_GUI_VBOX_64PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/NonOSE/VirtualBox_64px.png
1255	VBOX_BRAND_GUI_VBOX_SVG := $(PATH_ROOT)/src/VBox/Artwork/NonOSE/virtualbox.svg
1256	VBOX_BRAND_WIN_INST_DLGJPG := $(PATH_ROOT)/src/VBox/Installer/win/Binary/Dialog.jpg
1257	VBOX_BRAND_WIN_INST_EXT :=
1258	VBOX_BRAND_WIN_ADD_INST_DLGBMP := $(PATH_ROOT)/src/VBox/Additions/WINNT/Installer/welcome.bmp
1259	VBOX_BRAND_DARWIN_DISKIMAGE_DS_STORE := $(PATH_ROOT)/src/VBox/Installer/darwin/DiskImage/DS_Store
1260	VBOX_BRAND_DARWIN_DISKIMAGE_BG := $(PATH_ROOT)/src/VBox/Installer/darwin/DiskImage/vbox_folder.tiff
1261	VBOX_BRAND_DARWIN_INSTALLER_BG := $(PATH_ROOT)/src/VBox/Installer/darwin/VirtualBox_mpkg/background.tif
1262
1263	#
1264	# Skip stuff.
1265	#
1266
1267	ifdef VBOX_ONLY_EXTPACKS
1268	# Clear some VBOX_WITH_XXX variables instead of adding ifdefs all over the place.
1269	VBOX_WITH_DEBUGGER =
1270	VBOX_WITH_ADDITIONS =
1271	VBOX_WITH_VBOXDRV =
1272	VBOX_WITH_TESTCASES =
1273	endif
1274
1275	# VBOX_QUICK can be used by core developers to speed to the build
1276	ifdef VBOX_QUICK
1277	# undefine variables by assigning blank.
1278	VBOX_WITH_ADDITIONS =
1279	VBOX_WITH_VALIDATIONKIT =
1280	VBOX_WITH_TESTCASES =
1281	VBOX_WITH_VBOXSDL =
1282	VBOX_WITH_HEADLESS =
1283	VBOX_WITH_VRDP =
1284	VBOX_WITH_VRDP_RDESKTOP =
1285	VBOX_WITH_DOCS =
1286	VBOX_WITH_WEBSERVICES =
1287	VBOX_WITH_32_ON_64_MAIN_API =
1288	endif # VBOX_QUICK
1289
1290	# Only AMD64 is supported for the main product, so disable most of the other bits.
1291	ifn1of ($(KBUILD_TARGET_ARCH), $(VBOX_SUPPORTED_HOST_ARCHS))
1292	VBOX_WITH_MAIN =
1293	VBOX_WITH_QTGUI =
1294	VBOX_WITH_VBOXSDL =
1295	VBOX_WITH_VBOXHEADLESS =
1296	VBOX_WITH_WEBSERVICES =
1297	VBOX_WITH_DEBUGGER_GUI =
1298	endif
1299
1300	ifeq ($(KBUILD_TARGET),darwin)
1301	VBOX_WITH_VRDP_RDESKTOP =
1302	# Permanent (no working SDL).
1303	VBOX_WITH_VBOXSDL =
1304
1305	ifeq ($(KBUILD_TARGET_ARCH),arm64)
1306	# No Qt yet, so no GUI, NLS or qhelp.
1307	VBOX_WITH_NLS :=
1308	VBOX_WITH_MAIN_NLS :=
1309	VBOX_WITH_PUEL_NLS :=
1310	VBOX_WITH_VBOXMANAGE_NLS :=
1311	VBOX_WITH_DOCS_QHELP :=
1312	VBOX_WITH_DOCS_QHELP_PACKING :=
1313	# Skip webservices as those are tedious to build.
1314	VBOX_WITH_WEBSERVICES :=
1315	# Ditto for the java<->XPCOM bridge.
1316	VBOX_WITH_JXPCOM :=
1317	endif
1318
1319	ifdef VBOX_WITH_DRIVERLESS_FORCED
1320	# No need for hardening when not using the driver.
1321	VBOX_WITH_HARDENING :=
1322	endif
1323	endif
1324
1325	ifeq ($(KBUILD_TARGET),freebsd)
1326	VBOX_WITH_DOCS =
1327	endif
1328
1329	ifeq ($(KBUILD_TARGET),haiku)
1330	VBOX_WITH_VRDP_RDESKTOP =
1331	# Permanent (no working SDL).
1332	VBOX_WITH_VBOXSDL =
1333	VBOX_WITH_DOCS =
1334	VBOX_WITH_VBOXDRV =
1335	VBOX_WITH_VRDP =
1336	VBOX_WITH_HEADLESS =
1337	VBOX_WITH_VBOXSDL =
1338	VBOX_WITH_QTGUI =
1339	# VBOX_WITH_MAIN=
1340	VBOX_WITH_DOCS =
1341	VBOX_WITH_ISCSI =
1342	VBOX_WITH_INIP =
1343	VBOX_WITH_INTERNAL_NETWORKING =
1344	VBOX_WITH_PDM_ASYNC_COMPLETION =
1345	VBOX_WITH_HARDENING =
1346	endif
1347
1348
1349	ifeq ($(KBUILD_TARGET),os2)
1350	VBOX_WITH_WEBSERVICES =
1351	VBOX_WITH_INSTALLER =
1352	VBOX_WITH_VRDP_AUTHMOD =
1353	VBOX_WITH_VRDP_RDESKTOP =
1354	VBOX_WITH_VALIDATIONKIT =
1355	VBOX_WITH_QTGUI =
1356	VBOX_WITH_USB =
1357	VBOX_WITH_EHCI =
1358	VBOX_WITH_DOCS =
1359	VBOX_WITH_PDM_ASYNC_COMPLETION =
1360	VBOX_WITH_HARDENING =
1361	endif
1362
1363	ifeq ($(KBUILD_TARGET),win)
1364	VBOX_WITH_VRDP_RDESKTOP =
1365	endif
1366
1367	ifn1of ($(KBUILD_TARGET_ARCH), x86 amd64 arm64)
1368	VBOX_WITH_ADDITION_DRIVERS =
1369	VBOX_WITH_DEBUGGER =
1370	VBOX_WITH_DOCS =
1371	VBOX_WITH_EHCI =
1372	VBOX_WITH_HARDENING =
1373	VBOX_WITH_HEADLESS =
1374	VBOX_WITH_HGCM =
1375	VBOX_WITH_HGSMI =
1376	VBOX_WITH_INIP =
1377	VBOX_WITH_INSTALLER =
1378	VBOX_WITH_INTERNAL_NETWORKING =
1379	VBOX_WITH_ISCSI =
1380	VBOX_WITH_MAIN =
1381	VBOX_WITH_PDM_ASYNC_COMPLETION =
1382	VBOX_WITH_QTGUI =
1383	VBOX_WITH_RAW_MODE =
1384	VBOX_WITH_VALIDATIONKIT =
1385	VBOX_WITH_USB =
1386	VBOX_WITH_VBOXDRV =
1387	VBOX_WITH_VBOXSDL =
1388	VBOX_WITH_WEBSERVICES =
1389	VBOX_WITH_XPCOM =
1390	VBOX_WITHOUT_HARDENING = 1
1391	# remove later:
1392	VBOX_WITH_VRDP =
1393	VBOX_WITH_VRDP_AUTHMOD =
1394	VBOX_WITH_VRDP_RDESKTOP =
1395	endif
1396
1397
1398	#
1399	# Include automatic and local config file to override the above settings
1400	# and to provide defaults for the settings below this point.
1401	#
1402	ifndef AUTOCFG
1403	AUTOCFG := $(wildcard $(PATH_ROOT)/AutoConfig.kmk)
1404	endif
1405	ifneq ($(AUTOCFG),)
1406	include $(AUTOCFG)
1407	endif
1408
1409	ifndef LOCALCFG
1410	LOCALCFG := $(wildcard $(PATH_ROOT)/LocalConfig.kmk)
1411	ifneq ($(LOCALCFG),)
1412	include $(LOCALCFG)
1413	endif
1414	else
1415	# Ignore it if it doesn't exist.
1416	if exists "$(LOCALCFG)"
1417	include $(LOCALCFG)
1418	else
1419	$(warning LOCALCFG='$(LOCALCFG)' does not exist)
1420	override LOCALCFG :=
1421	endif
1422	endif
1423
1424
1425	#
1426	# Configure 'parfait' and 'parfait-dbg' builds.
1427	#
1428	# We ASSUME that anyone doing this kind of build has the parfait tools
1429	# package already fetched using:
1430	# kmk VBOX_WITH_PARFAIT=1 -C tools fetch
1431	#
1432	if1of ($(KBUILD_TYPE), parfait parfait-dbg)
1433	VBOX_WITH_PARFAIT := 1
1434	VBOX_WITHOUT_PRECOMPILED_HEADERS := 1 # @todo Remove when working everywhere
1435	endif
1436
1437
1438	if defined(VBOX_WITH_PARFAIT)
1439	#
1440	# This includes the tool overrides for running with parfait.
1441	# Ideally there would be a dedicated parfait tool but when targetting
1442	# different hosts with different compiler toolchains and compiler flags
1443	# we would have to duplicate a lot of the already existing tools for each
1444	# supported toolchain. Instead we just override the paths to the compilers
1445	# for the currently used tools (as this is kind of static and doesn't change that often).
1446	# To not clutter this file too much this lives in a separate file.
1447	#
1448	include $(PATH_ROOT)/tools/ParfaitConfig.kmk
1449	endif
1450
1451
1452	#
1453	# Allow to overwrite the branding information from an external file
1454	#
1455	ifdef VBOX_BRANDING_CFG
1456	include $(VBOX_BRANDING_CFG)
1457	endif
1458
1459	#
1460	# Bitch about old settings.
1461	#
1462	ifdef VBOX_WITHOUT_LINUX_COMPILER_H
1463	$(warning VBOX_WITHOUT_LINUX_COMPILER_H was renamed to VBOX_WITH_LINUX_COMPILER_H, the meaning is inverted.)
1464	endif
1465
1466	#
1467	# Indicate VBOX_ONLY build if any of the VBOX_ONLY_* variables are set.
1468	#
1469	VBOX_ONLY_BUILD_NEW := $(strip $(foreach x, ADDITIONS DOCS EXTPACKS SDK VALIDATIONKIT \
1470	, $(if-expr defined(VBOX_ONLY_$(x)),VBOX_ONLY_$(x))))
1471	ifneq ($(VBOX_ONLY_BUILD),$(VBOX_ONLY_BUILD_NEW))
1472	$(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))
1473	endif
1474
1475	#
1476	# Enforce VBOX_WITH_NLS. It controls all NLS (except the GUI at the moment).
1477	#
1478	if defined(VBOX_WITH_MAIN_NLS) \|\| defined(VBOX_WITH_PUEL_NLS) \|\| defined(VBOX_WITH_VBOXMANAGE_NLS)
1479	VBOX_WITH_NLS := 1
1480	ifndef VBOX_WITH_NLS # (We test again to account for 'override VBOX_WITH_NLS :=')
1481	VBOX_WITH_MAIN_NLS :=
1482	VBOX_WITH_PUEL_NLS :=
1483	VBOX_WITH_VBOXMANAGE_NLS :=
1484	endif
1485	endif
1486
1487	#
1488	# For the docs build box.
1489	#
1490	ifdef VBOX_ONLY_DOCS
1491	# Always produce HTML docs (for publishing on website as part of release)
1492	VBOX_WITH_DOCS_HTML = 1
1493	# Always produce QHelp docs (for help in the UI, replacing CHM)
1494	VBOX_WITH_DOCS_QHELP = 1
1495	VBOX_WITH_TOOLS_QT_LINUX = 1
1496	endif
1497
1498	#
1499	# Disable components that are not open sourced.
1500	#
1501	ifdef VBOX_OSE
1502	VBOX_WITH_VRDP =
1503	VBOX_WITH_USB_VIDEO_IMPL =
1504	VBOX_WITH_NVME_IMPL =
1505	VBOX_WITH_EXTPACK_PUEL =
1506	VBOX_WITH_EXTPACK_PUEL_BUILD =
1507	VBOX_WITH_PCI_PASSTHROUGH_IMPL =
1508	VBOX_WITH_OS2_ADDITIONS_BIN =
1509	VBOX_WITH_LIBSSH =
1510	# not yet
1511	VBOX_WITH_PLUGIN_CRYPT =
1512	VBOX_WITH_DRAG_AND_DROP_PROMISES =
1513	ifn1of ($(KBUILD_TARGET), linux)
1514	VBOX_WITH_DOCS =
1515	VBOX_WITH_DOCS_PACKING =
1516	endif
1517	if1of ($(KBUILD_TARGET), solaris)
1518	VBOX_WITH_32_ON_64_MAIN_API =
1519	endif
1520	if1of ($(KBUILD_TARGET), win)
1521	# tar/gzip uncommon on Windows
1522	VBOX_WITH_EXTPACK_VBOXDTRACE =
1523	endif
1524	# Enable any translations in OSE, even partial ones.
1525	ifndef ($(VBOX_NO_DOCS_TRANSLATIONS))
1526	VBOX_WITH_DOCS_TRANSLATIONS = 1
1527	endif
1528	VBOX_WITH_INTEL_PXE =
1529	# Disable for OSE, requires snv_159+.
1530	VBOX_WITH_NETFLT_CROSSBOW =
1531	ifn1of ($(KBUILD_TARGET), darwin linux solaris win)
1532	VBOX_WITH_INSTALLER =
1533	endif
1534	if1of ($(KBUILD_TARGET), win)
1535	# Undefine codec libraries which are not needed.
1536	VBOX_WITH_LIBVPX =
1537	VBOX_WITH_LIBVORBIS =
1538	VBOX_WITH_LIBOGG =
1539	# Disable recording (with audio support).
1540	VBOX_WITH_RECORDING =
1541	VBOX_WITH_AUDIO_RECORDING =
1542	endif
1543	# branding
1544	VBOX_BRAND_LICENSE_HTML := $(PATH_ROOT)/doc/License-gpl-3.0.html
1545	VBOX_BRAND_LICENSE_RTF := $(PATH_ROOT)/doc/License-gpl-3.0.rtf
1546	VBOX_BRAND_LICENSE_TXT := $(PATH_ROOT)/doc/License-gpl-3.0.txt
1547	VBOX_BRAND_LICENSE_VER :=
1548	VBOX_BRAND_BIOS_LOGO := $(PATH_ROOT)/src/VBox/Devices/Graphics/BIOS/ose_logo.bmp
1549	VBOX_BRAND_GUI_ABOUT_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about.png
1550	VBOX_BRAND_GUI_ABOUT_X2_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_x2.png
1551	VBOX_BRAND_GUI_ABOUT_X3_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_x3.png
1552	VBOX_BRAND_GUI_ABOUT_X4_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_x4.png
1553	VBOX_BRAND_GUI_ABOUT_16PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_16px.png
1554	VBOX_BRAND_GUI_ABOUT_16PX_X2_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_16px_x2.png
1555	VBOX_BRAND_GUI_ABOUT_16PX_X3_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_16px_x3.png
1556	VBOX_BRAND_GUI_ABOUT_16PX_X4_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/about_16px_x4.png
1557	VBOX_BRAND_GUI_VBOX_16PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_16px.png
1558	VBOX_BRAND_GUI_VBOX_20PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_20px.png
1559	VBOX_BRAND_GUI_VBOX_32PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_32px.png
1560	VBOX_BRAND_GUI_VBOX_40PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_40px.png
1561	VBOX_BRAND_GUI_VBOX_48PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_48px.png
1562	VBOX_BRAND_GUI_VBOX_64PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_64px.png
1563	VBOX_BRAND_GUI_CUBE_42PX_PNG := $(PATH_ROOT)/src/VBox/Frontends/VirtualBox/images/OSE/VirtualBox_cube_42px.png
1564	VBOX_BRAND_GUI_VBOX_SVG := $(PATH_ROOT)/src/VBox/Artwork/OSE/virtualbox.svg
1565	endif
1566
1567	#
1568	# VBOX_WITHOUT_HARDENING is for developers (put in LocalConfig.kmk).
1569	# Note that this is a bit rough since hardening governs more than one
1570	# variable... Also note that we allow VBOX_WITH_HARDENING=1 on the
1571	# command line to overrule VBOX_WITHOUT_HARDENING (the check below).
1572	#
1573	ifdef VBOX_WITHOUT_HARDENING
1574	VBOX_WITH_HARDENING =
1575	ifeq ($(VBOX_WITH_HARDENING),)
1576	VBOX_PATH_APP_PRIVATE =
1577	VBOX_PATH_APP_PRIVATE_ARCH =
1578	VBOX_PATH_APP_PRIVATE_ARCH_TOP =
1579	VBOX_PATH_SHARED_LIBS =
1580	VBOX_PATH_APP_DOCS =
1581	VBOX_WITH_RUNPATH =
1582	if1of ($(KBUILD_TARGET), freebsd linux netbsd openbsd solaris) # duplicated up above
1583	VBOX_WITH_ORIGIN = 1
1584	endif
1585	endif
1586	endif
1587
1588	#
1589	# Sanitize the additions build config variables.
1590	#
1591	ifdef VBOX_WITH_ADDITIONS_FROM_BUILD_SERVER
1592	VBOX_WITHOUT_ADDITIONS := 1
1593	ifdef VBOX_ONLY_ADDITIONS
1594	$(error VBOX_ONLY_ADDITIONS + VBOX_WITH_ADDITIONS_FROM_BUILD_SERVER does not add up!)
1595	endif
1596	endif
1597
1598	ifdef VBOX_ONLY_ADDITIONS
1599	ifdef VBOX_WITHOUT_ADDITIONS
1600	$(error VBOX_ONLY_ADDITIONS + VBOX_WITHOUT_ADDITIONS does not add up!)
1601	endif
1602	ifndef VBOX_WITH_ADDITIONS
1603	$(error VBOX_ONLY_ADDITIONS + unset VBOX_WITH_ADDITIONS does not add up!)
1604	endif
1605	endif
1606
1607	ifdef VBOX_WITHOUT_ADDITIONS
1608	# Zap anything that could be contradicting this.
1609	VBOX_WITH_ADDITIONS :=
1610	endif
1611
1612	#
1613	# Sanitize the documentation build config variables.
1614	#
1615	ifdef VBOX_WITH_DOCS_FROM_BUILD_SERVER
1616	VBOX_WITHOUT_DOCS := 1
1617	ifdef VBOX_ONLY_DOCS
1618	$(error VBOX_ONLY_DOCS + VBOX_WITH_DOCS_FROM_BUILD_SERVER does not add up!)
1619	endif
1620	else ifeq ($(KBUILD_HOST),solaris)
1621	# We require JDK 17 for the user manual now, and since that isn't available for solaris
1622	# (see JEP-381) we're forced to get the docs from the doc build server or disable them.
1623	VBOX_WITHOUT_DOCS := 1
1624	endif
1625
1626	ifdef VBOX_ONLY_DOCS
1627	ifdef VBOX_WITHOUT_DOCS
1628	$(error VBOX_ONLY_DOCS + VBOX_WITHOUT_DOCS does not add up!)
1629	endif
1630	endif
1631
1632	ifdef VBOX_WITHOUT_DOCS
1633	# Zap anything that could be contradicting this.
1634	VBOX_WITH_DOCS :=
1635	VBOX_WITH_DOCS_QHELP :=
1636	VBOX_WITH_DOCS_HTML :=
1637	endif
1638
1639	#
1640	# Disable components for headless
1641	#
1642	ifdef VBOX_HEADLESS
1643	VBOX_WITH_QTGUI =
1644	VBOX_WITH_VBOXSDL =
1645	VBOX_WITH_VRDP_RDESKTOP =
1646	endif
1647
1648	#
1649	# Undefined VBOX_WITH_MAIN implies exclusion of a few more items.
1650	#
1651	ifndef VBOX_WITH_MAIN
1652	VBOX_WITH_VBOXSDL =
1653	VBOX_WITH_QTGUI =
1654	VBOX_WITH_DEBUGGER_GUI =
1655	VBOX_WITH_HEADLESS =
1656	ifdef VBOX_ONLY_DOCS
1657	$(error Oh, does VBOX_ONLY_DOCS actually end up here. sweet.)
1658	endif
1659	VBOX_WITH_DOCS =
1660	endif
1661
1662	ifdef VBOX_WITH_EXTPACK_PUEL_BUILD
1663	VBOX_WITH_EXTPACK_PUEL = 1
1664	endif
1665
1666	ifdef VBOX_WITH_TESTSUITE
1667	$(warning VBOX_WITH_TESTSUITE was renamed to VBOX_WITH_VALIDATIONKIT)
1668	VBOX_WITH_VALIDATIONKIT = $(VBOX_WITH_TESTSUITE)
1669	endif
1670
1671
1672	#
1673	# Derived indicators.
1674	#
1675
1676	#
1677	# Mark OSE builds clearly, helps figuring out limitations more easily.
1678	#
1679	ifdef VBOX_OSE
1680	# This can be overridden (e.g. in LocalConfig.kmk) by whoever publishes a set
1681	# of VirtualBox binaries. We request though that you always use something that
1682	# clearly identifies your build and makes it clear that it is not one done by
1683	# the VirtualBox team.
1684	VBOX_BUILD_PUBLISHER ?= _OSE
1685	endif
1686
1687	# Keep in sync with G_virtualBoxPackage in glue-jaxws.xsl and glue-java.xsl
1688	# Changed with every new version, so beware!
1689	if $(VBOX_VERSION_BUILD) < 51
1690	VBOX_API_VERSION = $(VBOX_VERSION_MAJOR)_$(VBOX_VERSION_MINOR)
1691	else
1692	VBOX_API_VERSION = $(VBOX_VERSION_MAJOR)_$(expr $(VBOX_VERSION_MINOR) + 1)
1693	endif
1694	VBOX_API_SUFFIX = _$(VBOX_API_VERSION)
1695	VBOX_JAVA_PACKAGE = org.virtualbox$(VBOX_API_SUFFIX)
1696
1697	#
1698	# Derived / helper config indicators. Not configurable.
1699	#
1700
1701	# Use the OpenGL module in qt when the video hardware acceleration feature
1702	# is enabled.
1703	if defined(VBOX_WITH_VIDEOHWACCEL) && defined(VBOX_WITH_QTGUI)
1704	VBOX_GUI_USE_QGL = 1
1705	else
1706	VBOX_GUI_USE_QGL =
1707	endif
1708
1709	# Collection macro mainly for deciding whether VBoxDTrace needs shipping.
1710	VBOX_WITH_DTRACE := $(if-expr defined(VBOX_WITH_DTRACE_R0) \|\| defined(VBOX_WITH_DTRACE_R0DRV) \
1711	\|\| defined(VBOX_WITH_DTRACE_R3) \|\| defined(VBOX_WITH_DTRACE_RC),1,)
1712
1713	# kSubmit / kWorker is only available on windows.
1714	ifdef VBOX_USE_KSUBMIT
1715	ifeq ($(KBUILD_HOST),win)
1716	TOOL_VCC142AMD64_USE_KSUBMIT := 1
1717	TOOL_VCC142X86_USE_KSUBMIT := 1
1718	# TOOL_VCC120AMD64_USE_KSUBMIT := 1
1719	# TOOL_VCC120X86_USE_KSUBMIT := 1
1720	TOOL_VCC100AMD64_USE_KSUBMIT := 1
1721	TOOL_VCC100X86_USE_KSUBMIT := 1
1722	TOOL_QT5_USE_KSUBMIT := 1
1723	TOOL_OPENWATCOM_USE_KSUBMIT := 1
1724	TOOL_YASM_USE_KSUBMIT := 1
1725	TOOL_NASM_USE_KSUBMIT := 1
1726	TOOL_VBoxNasm_USE_KSUBMIT := 1
1727	else
1728	VBOX_USE_KSUBMIT :=
1729	endif
1730	endif
1731
1732	#
1733	# Requested permissions to the host OS (only the entitlements
1734	# crap on darwin for now).
1735	#
1736	ifeq ($(KBUILD_TARGET),darwin)
1737	#
1738	# Common entitlements for the main and VM process bundle.
1739	#
1740	# The following two are required in the main bundle even though they apply only to the VM
1741	# process. The issue is that TCC is looking up the primary bundle for these entitlements
1742	# and crashes the VM process if the entitlements are not here even though they are used
1743	# in the VM process only. This is not documented anywhere by Apple.
1744	# From Console.app when these are missing:
1745	# tccd: [com.apple.TCC:access] Prompting policy for hardened runtime; service:
1746	# kTCCServiceMicrophone requires entitlement com.apple.security.device.audio-input but it is missing for
1747	# RESP:{
1748	# ID: org.virtualbox.app.VirtualBox,
1749	# PID[17253],
1750	# auid: 501,
1751	# euid: 501,
1752	# responsible path: '/Applications/VirtualBox.app/Contents/MacOS/VirtualBox',
1753	# binary path: '/Applications/VirtualBox.app/Contents/MacOS/VirtualBox'
1754	# },
1755	# REQ:{
1756	# ID: org.virtualbox.app.VirtualBoxVM,
1757	# PID[17331],
1758	# auid: 501,
1759	# euid: 501,
1760	# binary path: '/Applications/VirtualBox.app/Contents/Resources/VirtualBoxVM.app/Contents/MacOS/VirtualBoxVM'
1761	# }
1762	VBOX_DARWIN_ENTITLEMENTS_LIST_COMMON := \
1763	com.apple.security.device.audio-input \
1764	com.apple.security.device.camera
1765
1766	#
1767	# The first two entitlements are required to get everything working
1768	# on Catalina which we want to keep supported for now:
1769	#
1770	# The first entitlement allows us to have unsigned executable memory in the guests
1771	# address space like the BIOS code (and essentially all the guests address space which
1772	# is mapped as RWX).
1773	# The second entitlement is required in order to map guest memory as RWX into the
1774	# guests address space.
1775	# These entitlements are not required starting with BigSur+ where Apple has clearly
1776	# changed something in their entitlement scheme without properly documenting it.
1777	#
1778	# allow-jit - for the recompiler in order to be able to generate and execute native code.
1779	# audio-input - recording audio from a guest.
1780	# camera - accessing the webcam from a guest.
1781	# usb - USB passthrough.
1782	# hypervisor - Hypervisor entitlement in order to be able to use Hypervisor.framework
1783	#
1784	VBOX_DARWIN_ENTITLEMENTS_LIST_VM := \
1785	$(VBOX_DARWIN_ENTITLEMENTS_LIST_COMMON) \
1786	com.apple.security.cs.allow-unsigned-executable-memory \
1787	com.apple.security.cs.disable-executable-page-protection \
1788	com.apple.security.cs.allow-jit \
1789	com.apple.security.device.usb \
1790	com.apple.security.hypervisor
1791
1792	#
1793	# The device-access and networking entitlements are reserved for
1794	# only specific vendors and are only available in release mode signing
1795	# (binaries signed with these entitlements in adhoc mode will just crash
1796	# with a code signing error).
1797	#
1798	ifeq ($(VBOX_SIGNING_MODE),release)
1799	VBOX_DARWIN_ENTITLEMENTS_LIST_VM += \
1800	com.apple.vm.device-access \
1801	com.apple.vm.networking
1802	endif
1803
1804	# Where the dynamic generated entitlements can be found.
1805	VBOX_DARWIN_ENTITLEMENTS_FILE := $(PATH_OUT)/Entitlements.plist
1806	VBOX_DARWIN_ENTITLEMENTS_FILE_VM := $(PATH_OUT)/EntitlementsVM.plist
1807	endif
1808
1809	#
1810	# Image and object format config.
1811	#
1812	if1of ($(KBUILD_TARGET), freebsd haiku linux netbsd openbsd solaris)
1813	VBOX_LDR_FMT = elf
1814	endif
1815	ifeq ($(KBUILD_TARGET),darwin)
1816	VBOX_LDR_FMT = macho
1817	endif
1818	ifeq ($(KBUILD_TARGET),os2)
1819	VBOX_LDR_FMT = lx
1820	VBOX_LDR_FMT32 = lx
1821	VBOX_LDR_FMT64 = elf
1822	DONT_USE_YASM = 1 # yasm doesn't implement omf yet.
1823	endif
1824	ifeq ($(KBUILD_TARGET),win)
1825	VBOX_LDR_FMT = pe
1826	endif
1827	VBOX_LDR_FMT32 ?= $(VBOX_LDR_FMT)
1828	VBOX_LDR_FMT64 ?= $(VBOX_LDR_FMT)
1829
1830	#
1831	# Assembler setup.
1832	#
1833	# This is a bit complicated since we have to support two different assmblers
1834	# (yasm/nasm) and possibly two different formats (32-bit/64-bit).
1835	#
1836	if1of ($(KBUILD_TARGET_ARCH), amd64 x86)
1837	ifeq ($(VBOX_LDR_FMT),elf)
1838	ifeq ($(KBUILD_TARGET_ARCH),x86)
1839	VBOX_ASFLAGS_FMT = -f elf32 -DASM_FORMAT_ELF
1840	else
1841	VBOX_ASFLAGS_FMT = -f elf64 -DASM_FORMAT_ELF
1842	endif
1843	VBOX_ASFLAGS_DBFINFO = -g dwarf2
1844	endif
1845	ifeq ($(VBOX_LDR_FMT),lx)
1846	VBOX_ASFLAGS_FMT = -f obj -DASM_FORMAT_OMF
1847	VBOX_ASFLAGS_DBFINFO = -g stabs
1848	endif
1849	ifeq ($(VBOX_LDR_FMT),macho)
1850	ifeq ($(KBUILD_TARGET_ARCH),x86)
1851	VBOX_ASFLAGS_FMT = -f macho32 -DASM_FORMAT_MACHO
1852	else
1853	VBOX_ASFLAGS_FMT = -f macho64 -DASM_FORMAT_MACHO
1854	endif
1855	VBOX_ASFLAGS_DBFINFO = -g dwarf2
1856	endif
1857	ifeq ($(VBOX_LDR_FMT),pe)
1858	ifeq ($(KBUILD_TARGET_ARCH),x86)
1859	VBOX_ASFLAGS_FMT = -f win32 -DASM_FORMAT_PE
1860	else
1861	VBOX_ASFLAGS_FMT = -f win64 -DASM_FORMAT_PE
1862	endif
1863	VBOX_ASFLAGS_DBFINFO = -g cv8
1864	endif
1865	ifndef VBOX_ASFLAGS_FMT
1866	$(error VBOX_ASFLAGS_FMT is not defined. VBOX_LDR_FMT=$(VBOX_LDR_FMT))
1867	endif
1868
1869	ifeq ($(VBOX_LDR_FMT32),elf)
1870	VBOX_ASFLAGS_FMT32 = -f elf32 -DASM_FORMAT_ELF
1871	VBOX_ASFLAGS_DBFINFO32 = -g dwarf2
1872	endif
1873	ifeq ($(VBOX_LDR_FMT32),lx)
1874	VBOX_ASFLAGS_FMT32 = -f obj -DASM_FORMAT_OMF
1875	VBOX_ASFLAGS_DBFINFO32 = -g stabs
1876	endif
1877	ifeq ($(VBOX_LDR_FMT32),macho)
1878	VBOX_ASFLAGS_FMT32 = -f macho32 -DASM_FORMAT_MACHO
1879	VBOX_ASFLAGS_DBFINFO32 = -g dwarf2
1880	endif
1881	ifeq ($(VBOX_LDR_FMT32),pe)
1882	VBOX_ASFLAGS_FMT32 = -f win32 -DASM_FORMAT_PE
1883	VBOX_ASFLAGS_DBFINFO32 = -g cv8
1884	endif
1885	ifndef VBOX_ASFLAGS_FMT32
1886	$(error VBOX_ASFLAGS_FMT32 is not defined. VBOX_LDR_FMT32=$(VBOX_LDR_FMT32))
1887	endif
1888
1889	ifeq ($(VBOX_LDR_FMT64),elf)
1890	VBOX_ASFLAGS_FMT64 = -f elf64 -DASM_FORMAT_ELF
1891	VBOX_ASFLAGS_DBFINFO64 = -g dwarf2
1892	endif
1893	ifeq ($(VBOX_LDR_FMT64),macho)
1894	VBOX_ASFLAGS_FMT64 = -f macho64 -DASM_FORMAT_MACHO
1895	VBOX_ASFLAGS_DBFINFO64 = -g dwarf2
1896	endif
1897	ifeq ($(VBOX_LDR_FMT64),pe)
1898	VBOX_ASFLAGS_FMT64 = -f win64 -DASM_FORMAT_PE
1899	VBOX_ASFLAGS_DBFINFO64 = -g cv8
1900	endif
1901	ifndef VBOX_ASFLAGS_FMT64
1902	$(error VBOX_ASFLAGS_FMT64 is not defined. VBOX_LDR_FMT64=$(VBOX_LDR_FMT64))
1903	endif
1904
1905	ifndef DONT_USE_YASM
1906	VBOX_ASTOOL = YASM
1907	VBOX_LDR_FMT_2_YASM_DBGINFO.elf = -g dwarf2
1908	VBOX_LDR_FMT_2_YASM_DBGINFO.lx = -g stabs
1909	VBOX_LDR_FMT_2_YASM_DBGINFO.macho =
1910	VBOX_LDR_FMT_2_YASM_DBGINFO.pe = -g cv8
1911	VBOX_ASFLAGS = $(VBOX_ASFLAGS_FMT) -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) $(VBOX_LDR_FMT_2_YASM_DBGINFO.$(VBOX_LDR_FMT))
1912	VBOX_ASFLAGS32 = $(VBOX_ASFLAGS_FMT32) -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) $(VBOX_LDR_FMT_2_YASM_DBGINFO.$(VBOX_LDR_FMT32))
1913	VBOX_ASFLAGS64 = $(VBOX_ASFLAGS_FMT64) -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit) $(VBOX_LDR_FMT_2_YASM_DBGINFO.$(VBOX_LDR_FMT64))
1914	else
1915	VBOX_ASTOOL = NASM
1916	VBOX_ASFLAGS = $(subst elf32,elf,$(VBOX_ASFLAGS_FMT)) -D__NASM__ -w+orphan-labels -g
1917	VBOX_ASFLAGS32 = $(subst elf32,elf,$(VBOX_ASFLAGS_FMT32)) -D__NASM__ -w+orphan-labels -g
1918	VBOX_ASFLAGS64 = $(VBOX_ASFLAGS_FMT64) -D__NASM__ -w+orphan-labels -g
1919	endif
1920	else # ifn1of ($(KBUILD_TARGET_ARCH), amd64 x86)
1921	VBOX_ASTOOL = $(VBOX_GCC_TOOL)
1922	VBOX_LDR_FMT_2_FLAGS.elf := -DASM_FORMAT_ELF
1923	VBOX_LDR_FMT_2_FLAGS.macho := -DASM_FORMAT_MACHO
1924	VBOX_LDR_FMT_2_FLAGS.pe := -DASM_FORMAT_PE
1925	VBOX_ASFLAGS := -g $(VBOX_LDR_FMT_2_FLAGS.$(VBOX_LDR_FMT))
1926	VBOX_ASFLAGS32 := -g $(VBOX_LDR_FMT_2_FLAGS.$(VBOX_LDR_FMT32))
1927	VBOX_ASFLAGS64 := -g $(VBOX_LDR_FMT_2_FLAGS.$(VBOX_LDR_FMT64))
1928	if1of ($(KBUILD_TARGET_ARCH), sparc32 sparc64)
1929	VBOX_ASFLAGS += -m$(VBOX_HC_ARCH_BITS)
1930	VBOX_ASFLAGS32 += -m32
1931	VBOX_ASFLAGS64 += -m64
1932	endif
1933	endif # ifn1of ($(KBUILD_TARGET_ARCH), amd64 x86)
1934
1935	#
1936	# Windows only has mingw handy. On *nix we have to deal with cross compiling
1937	# 32-bit targets on 64-bit platforms, meaning we'll be using gcc32/g++32.
1938	# In the latter case we'll also have to disable all the all the R0 driver related stuff.
1939	#
1940	ifndef VBOX_GCC_TOOL
1941	ifeq ($(KBUILD_TARGET),win)
1942	ifeq ($(KBUILD_TARGET_ARCH),x86)
1943	VBOX_GCC_TOOL := MINGW32
1944	TOOL_MINGW32_CFLAGS := $(UNDEFINED) # override -g
1945	else
1946	VBOX_GCC_TOOL := MINGWW64
1947	endif
1948	else ifeq ($(KBUILD_TARGET),os2)
1949	VBOX_GCC_TOOL := GXX3OMF
1950	else ifeq ($(KBUILD_TARGET),darwin)
1951	ifdef VBOX_WITH_EVEN_NEWER_XCODE
1952	VBOX_GCC_TOOL := CLANGXXMACHO
1953	DARWINCMN_TOOLCHAIN_DIRS_IGNORE_DEVTOOLS = 1# Use the system toolchains, not anything from tools/darwin.*.
1954	else ifdef VBOX_WITH_NEW_XCODE
1955	VBOX_GCC_TOOL := VBoxXcode62
1956	else
1957	VBOX_GCC_TOOL := GXX4MACHO
1958	endif
1959	else ifeq ($(KBUILD_TARGET),haiku)
1960	# Haiku shouldn't pass '-r' to the linker by default
1961	VBOX_GCC_TOOL := GXX3PLAIN
1962	else ifeq ($(KBUILD_TARGET),solaris)
1963	VBOX_GCC_TOOL := GXX3PLAIN
1964	VBOX_GCC32_TOOL := GCC3PLAIN
1965	ifeq ($(KBUILD_HOST),solaris)
1966	TOOL_GXX3PLAIN_LD_SYSMOD ?= /usr/ccs/bin/ld
1967	endif
1968	else
1969	VBOX_GCC_TOOL := GXX3
1970	ifeq ($(KBUILD_TARGET_ARCH).$(KBUILD_HOST_ARCH),x86.amd64) ## @todo mixing target/host here!
1971	VBOX_GCC_TOOL := GXX32
1972	VBOX_WITH_VBOXDRV =
1973	else ifeq ($(KBUILD_TARGET_ARCH).$(KBUILD_HOST_ARCH),amd64.x86)
1974	VBOX_GCC_TOOL := GXX64
1975	VBOX_WITH_VBOXDRV =
1976	endif
1977	endif
1978	endif
1979	ifndef VBOX_GCC32_TOOL
1980	ifeq ($(KBUILD_TARGET_ARCH),x86)
1981	VBOX_GCC32_TOOL := $(VBOX_GCC_TOOL)
1982	else ifeq ($(KBUILD_TARGET),win)
1983	VBOX_GCC32_TOOL := MINGW32
1984	else
1985	VBOX_GCC32_TOOL := GCC32
1986	endif
1987	endif
1988
1989	#
1990	# Decide which Visual C++ compiler version we're using by default.
1991	#
1992	ifndef VBOX_VCC_TOOL_STEM
1993	ifdef VBOX_WITH_NEW_VCC
1994	VBOX_VCC_TOOL_STEM := VCC142
1995	else
1996	VBOX_VCC_TOOL_STEM := VCC100
1997	endif
1998	else ifn1of ($(VBOX_VCC_TOOL_STEM), VCC100 VCC110 VCC120 VCC140 VCC141 VCC142)
1999	$(error VBox: VBOX_VCC_TOOL_STEM='$(VBOX_VCC_TOOL_STEM)' is not supported, only VCC100, VCC110, VCC120, VCC140, VCC141, VCC142 are)
2000	endif
2001	ifndef VBOX_VCC_TOOL
2002	VBOX_VCC_TOOL := $(VBOX_VCC_TOOL_STEM)$(toupper $(KBUILD_TARGET_ARCH))
2003	endif
2004
2005	#
2006	# Decide which Visual C++ compiler version we're using for newer stuff.
2007	#
2008	ifndef VBOX_NEWER_VCC_TOOL_STEM
2009	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
2010	VBOX_NEWER_VCC_TOOL_STEM := $(VBOX_VCC_TOOL_STEM)
2011	else
2012	VBOX_NEWER_VCC_TOOL_STEM := VCC120
2013	endif
2014	else ifn1of ($(VBOX_NEWER_VCC_TOOL_STEM), VCC120 VCC140 VCC141 VCC142)
2015	$(error VBox: VBOX_NEWER_VCC_TOOL_STEM='$(VBOX_NEWER_VCC_TOOL_STEM)' is not supported)
2016	endif
2017	ifndef VBOX_NEWER_VCC_TOOL
2018	VBOX_NEWER_VCC_TOOL := $(VBOX_NEWER_VCC_TOOL_STEM)$(toupper $(KBUILD_TARGET_ARCH))
2019	endif
2020
2021	# Temporary measure while kBuild / tools updates their define quoting.
2022	ifdef KMK_WITH_QUOTING
2023	if ("$(VBOX_VCC_TOOL_STEM)" >= "VCC140" && "$(KBUILD_TARGET)" == "win") \
2024	\|\| ("$(KBUILD_TARGET)" != "darwin" && "$(KBUILD_TARGET)" != "win" && "$(KMK_REVISION)" >= 3566) \
2025	\|\| ("$(KBUILD_TARGET)" == "darwin" && "$(KMK_REVISION)" >= 3579)
2026	VBOX_WITH_AUTOMATIC_DEFS_QUOTING := 1
2027	endif
2028	endif
2029
2030
2031	#
2032	# Default tool nonsense.
2033	#
2034	## @todo Remove the default tool crap here!
2035	TOOL = $(VBOX_GCC_TOOL)
2036	TOOL.win.x86 = $(VBOX_VCC_TOOL_STEM)X86
2037	TOOL.win.amd64 = $(VBOX_VCC_TOOL_STEM)AMD64
2038	ASTOOL := $(VBOX_ASTOOL)
2039
2040
2041	#
2042	# Setup the global defines and includes.
2043	#
2044	# Note! The __SOMETHING__ #defines are deprecated as they violate the C/C++ specs.
2045	#
2046	INCS += $(PATH_ROOT)/include $(PATH_OUT)
2047	DEFS += VBOX
2048	DEFS.debug := DEBUG DEBUG_$(subst $(subst _, ,_),_,$(USERNAME)) DEBUG_USERNAME=$(subst $(subst _, ,_),_,$(USERNAME))
2049	DEFS.dbgopt = $(DEFS.debug)
2050	DEFS.profile = VBOX_WITH_STATISTICS
2051	DEFS.strict = RT_STRICT VBOX_STRICT
2052	DEFS.asan = RT_STRICT VBOX_STRICT
2053	DEFS.parfait = VBOX_WITH_PARFAIT
2054	DEFS.parfait-dbg = VBOX_WITH_PARFAIT
2055	DEFS.x86 = RT_ARCH_X86 __X86__
2056	DEFS.amd64 = RT_ARCH_AMD64 __AMD64__
2057	DEFS.arm64 = RT_ARCH_ARM64
2058	DEFS.sparc32 = RT_ARCH_SPARC
2059	DEFS.sparc64 = RT_ARCH_SPARC64
2060	DEFS.darwin = RT_OS_DARWIN __DARWIN__
2061	DEFS.freebsd = RT_OS_FREEBSD __FREEBSD__
2062	DEFS.haiku = RT_OS_HAIKU
2063	DEFS.linux = RT_OS_LINUX _FILE_OFFSET_BITS=64
2064	DEFS.netbsd = RT_OS_NETBSD
2065	DEFS.openbsd = RT_OS_OPENBSD
2066	DEFS.os2 = RT_OS_OS2
2067	DEFS.os-agnostic = RT_OS_AGNOSTIC
2068	DEFS.solaris = RT_OS_SOLARIS _FILE_OFFSET_BITS=64
2069	DEFS.win = RT_OS_WINDOWS __WIN__
2070	DEFS.win.x86 = __WIN32__
2071	DEFS.win.amd64 = __WIN64__
2072	# optional defines (use environment or make commandline)
2073	ifdef VBOX_WITH_STATISTICS
2074	DEFS += VBOX_WITH_STATISTICS
2075	endif
2076	ifdef VBOX_STRICT
2077	DEFS += VBOX_STRICT
2078	endif
2079	ifdef LOG_ENABLED
2080	DEFS += LOG_ENABLED
2081	endif
2082	ifdef VBOX_OSE
2083	DEFS += VBOX_OSE
2084	endif
2085	ifdef VBOX_WITH_64_BITS_GUESTS
2086	DEFS += VBOX_WITH_64_BITS_GUESTS
2087	endif
2088	ifdef VBOX_WITH_REM
2089	DEFS += VBOX_WITH_REM
2090	endif
2091	ifdef VBOX_WITH_RAW_MODE
2092	DEFS += VBOX_WITH_RAW_MODE
2093	endif
2094	ifdef VBOX_WITH_DRIVERLESS_FORCED
2095	DEFS += VBOX_WITH_DRIVERLESS_FORCED
2096	endif
2097	ifdef VBOX_WITH_PARFAIT
2098	DEFS += VBOX_WITH_PARFAIT
2099	ifeq ($(KBUILD_TARGET),win)
2100	DEFS += RT_RELAXED_CALLBACKS_TYPES
2101	endif
2102	endif
2103
2104	# Don't flood CDEFS, old MASMs doesn't like too many defines.
2105	ifdef VBOX_WITH_DEBUGGER
2106	CDEFS += VBOX_WITH_DEBUGGER
2107	endif
2108	ifdef VBOX_WITH_HARDENING
2109	CDEFS += VBOX_WITH_HARDENING
2110	endif
2111	if defined(VBOX_WITH_STRICT_LOCKS) && ($(KBUILD_TYPE) == "debug" \|\| $(KBUILD_TYPE) == "strict" \|\| $(KBUILD_TYPE) == "asan")
2112	CDEFS += RT_LOCK_STRICT RT_LOCK_STRICT_ORDER
2113	endif
2114	ifdef VBOX_WITH_EF_WRAPS
2115	CDEFS += RTMEM_WRAP_TO_EF_APIS RTMEM_WRAP_SOME_NEW_AND_DELETE_TO_EF
2116	endif
2117
2118	# Quoted strings should not be passed to the assemblers since they might not
2119	# subscribe to C preprocessing semantics.
2120	ifdef VBOX_PATH_APP_PRIVATE
2121	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2122	CDEFS += RTPATH_APP_PRIVATE="$(VBOX_PATH_APP_PRIVATE)"
2123	else
2124	CDEFS += RTPATH_APP_PRIVATE=\"$(VBOX_PATH_APP_PRIVATE)\"
2125	endif
2126	endif
2127	ifdef VBOX_PATH_APP_PRIVATE_ARCH
2128	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2129	CDEFS += RTPATH_APP_PRIVATE_ARCH="$(VBOX_PATH_APP_PRIVATE_ARCH)"
2130	else
2131	CDEFS += RTPATH_APP_PRIVATE_ARCH=\"$(VBOX_PATH_APP_PRIVATE_ARCH)\"
2132	endif
2133	endif
2134	ifdef VBOX_PATH_APP_PRIVATE_ARCH_TOP
2135	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2136	CDEFS += RTPATH_APP_PRIVATE_ARCH_TOP="$(VBOX_PATH_APP_PRIVATE_ARCH_TOP)"
2137	else
2138	CDEFS += RTPATH_APP_PRIVATE_ARCH_TOP=\"$(VBOX_PATH_APP_PRIVATE_ARCH_TOP)\"
2139	endif
2140	endif
2141	ifdef VBOX_PATH_SHARED_LIBS
2142	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2143	CDEFS += RTPATH_SHARED_LIBS="$(VBOX_PATH_SHARED_LIBS)"
2144	else
2145	CDEFS += RTPATH_SHARED_LIBS=\"$(VBOX_PATH_SHARED_LIBS)\"
2146	endif
2147	endif
2148	ifdef VBOX_PATH_APP_DOCS
2149	ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
2150	CDEFS += RTPATH_APP_DOCS="$(VBOX_PATH_APP_DOCS)"
2151	else
2152	CDEFS += RTPATH_APP_DOCS=\"$(VBOX_PATH_APP_DOCS)\"
2153	endif
2154	endif
2155	if1of ($(KBUILD_TARGET), os2) # The gcc here is too old to grok #pragma once, instead it complains.
2156	CDEFS += RT_WITHOUT_PRAGMA_ONCE
2157	endif
2158	CXXDEFS += $(CDEFS)
2159	PCHDEFS += $(CDEFS)
2160	OBJCDEFS += $(CDEFS)
2161
2162	USES += dtrace
2163	USES.win += vboximportchecker
2164
2165
2166	#
2167	# Decide which Windows DDK to use by default.
2168	#
2169	ifdef VBOX_WITH_NEW_WINDOWS_DDK
2170	VBOX_WINDDK ?= WINSDK10-KM
2171	VBOX_WINDDK_WLH ?= $(VBOX_WINDDK)
2172	VBOX_WINDDK_GST_W8 ?= WINSDK10-KM-W8
2173	VBOX_WINDDK_GST_W7 ?= WINSDK10-KM-W7
2174	VBOX_WINDDK_GST_WLH ?= WINDDK71WLH
2175	else if1of ($(VBOX_VCC_TOOL_STEM), VCC110)
2176	VBOX_WINDDK ?= WINDDK80
2177	else
2178	VBOX_WINDDK ?= WINDDK71
2179	endif
2180	VBOX_WINDDK_WLH ?= $(VBOX_WINDDK)WLH
2181
2182	VBOX_WINDDK_GST ?= $(VBOX_WINDDK)
2183	VBOX_WINDDK_GST_W8 ?= WINDDK80W8
2184	VBOX_WINDDK_GST_W7 ?= $(VBOX_WINDDK_GST)W7
2185	VBOX_WINDDK_GST_WLH ?= $(VBOX_WINDDK_GST)WLH
2186	VBOX_WINDDK_GST_W2K3 ?= WINDDK71WNET
2187	ifeq ($(KBUILD_TARGET_ARCH),x86)
2188	VBOX_WINDDK_GST_WXP ?= WINDDK71WXP
2189	VBOX_WINDDK_GST_W2K ?= $(VBOX_WINDDK_GST_WXP)
2190	VBOX_WINDDK_GST_NT4 ?= $(VBOX_WINDDK_GST_WXP)
2191	else
2192	VBOX_WINDDK_GST_WXP ?= $(VBOX_WINDDK_GST_W2K3)
2193	VBOX_WINDDK_GST_W2K ?= $(VBOX_WINDDK_GST_W2K3)
2194	VBOX_WINDDK_GST_NT4 ?= $(VBOX_WINDDK_GST_W2K3)
2195	endif
2196
2197
2198	#
2199	# Decide which Windows SDK to use by default.
2200	#
2201	ifdef VBOX_WITH_NEW_WINDOWS_SDK
2202	VBOX_WINPSDK ?= WINSDK10-UM
2203	VBOX_WINPSDK_INCS ?= $(VBOX_WINPSDK)-INCS
2204	else if1of ($(VBOX_VCC_TOOL_STEM), VCC110)
2205	VBOX_WINPSDK ?= WINPSDK80
2206	VBOX_WINPSDK_INCS ?= $(VBOX_WINPSDK)INCS
2207	else
2208	VBOX_WINPSDK ?= WINPSDK71
2209	VBOX_WINPSDK_INCS ?= $(VBOX_WINPSDK)INCS
2210	endif
2211	VBOX_WINPSDK_GST ?= $(VBOX_WINPSDK)
2212	VBOX_WINPSDK_GST_INCS ?= $(VBOX_WINPSDK_INCS)
2213	ifneq ($(VBOX_WINPSDK_GST),WINPSDK71)
2214	VBOX_WINPSDK_GST_W8 ?= $(VBOX_WINPSDK_GST)
2215	else
2216	VBOX_WINPSDK_GST_W8 ?= WINPSDK80
2217	endif
2218	VBOX_WINPSDK_GST_W7 ?= $(VBOX_WINPSDK_GST)
2219	VBOX_WINPSDK_GST_WLH ?= $(VBOX_WINPSDK_GST)
2220	VBOX_WINPSDK_GST_WXP ?= $(VBOX_WINPSDK_GST)
2221	ifeq ($(KBUILD_TARGET_ARCH),x86)
2222	VBOX_WINPSDK_GST_W2K ?= $(VBOX_WINPSDK_GST)
2223	VBOX_WINPSDK_GST_NT4 ?= $(VBOX_WINPSDK_GST)
2224	else
2225	VBOX_WINPSDK_GST_W2K ?= $(VBOX_WINPSDK_GST_WXP)
2226	VBOX_WINPSDK_GST_NT4 ?= $(VBOX_WINPSDK_GST_WXP)
2227	endif
2228
2229
2230	#
2231	# ARCH_BITS_DEFS.
2232	#
2233	if1of ($(KBUILD_TARGET_ARCH), amd64 sparc64 arm64)
2234	VBOX_HC_ARCH_BITS := 64
2235	ARCH_BITS_DEFS := HC_ARCH_BITS=64
2236	else if1of ($(KBUILD_TARGET_ARCH), x86 sparc32)
2237	VBOX_HC_ARCH_BITS := 32
2238	ARCH_BITS_DEFS := HC_ARCH_BITS=32
2239	else
2240	$(error VBox: KBUILD_TARGET_ARCH=$(KBUILD_TARGET_ARCH))
2241	endif
2242
2243	ifdef VBOX_WITH_64_BITS_GUESTS
2244	VBOX_GC_ARCH_BITS_DEFS := GC_ARCH_BITS=64
2245	else
2246	VBOX_GC_ARCH_BITS_DEFS := GC_ARCH_BITS=32
2247	endif
2248	ARCH_BITS_DEFS += $(VBOX_GC_ARCH_BITS_DEFS)
2249
2250	#
2251	# Add the output dir(s) to the dynamic loader search path.
2252	#
2253	if1of ($(KBUILD_HOST), freebsd linux netbsd openbsd solaris)
2254	export LD_LIBRARY_PATH:=$(PATH_STAGE_BIN):$(PATH_STAGE_LIB):$(LD_LIBRARY_PATH)
2255	endif
2256	ifeq ($(KBUILD_HOST),haiku)
2257	export LIBRARY_PATH:=$(PATH_STAGE_BIN):$(PATH_STAGE_LIB):$(LIBRARY_PATH)
2258	endif
2259	ifeq ($(KBUILD_HOST),os2)
2260	#fixme! export BEGINLIBPATH:=$(PATH_STAGE_BIN);$(PATH_STAGE_LIB);$(BEGINLIBPATH)
2261	endif
2262	ifeq ($(KBUILD_HOST),win)
2263	# This check is a bit hacky, but avoids problems with PATH being changed
2264	# again when the makefiles are reread because some automatically generated
2265	# makefile has been modified.
2266	ifeq ($(findstring $(PATH_STAGE_BIN);$(PATH_STAGE_LIB);,$(PATH)),)
2267	export PATH:=$(PATH_STAGE_BIN);$(PATH_STAGE_LIB);$(PATH)
2268	endif
2269	endif
2270
2271	#
2272	# Common libraries and tools.
2273	#
2274	ifeq ($(KBUILD_TARGET),darwin)
2275	LIB_RUNTIME = $(PATH_STAGE_BIN)/VBoxRT.dylib
2276	LIB_RUNTIME_EF = #$(PATH_STAGE_LIB)/RuntimeEFCPP.a
2277	VBOX_LIB_RUNTIME_X86 = $(PATH_STAGE_BIN)/VBoxRT-x86.dylib
2278	LIB_KPROFILE = $(PATH_STAGE_BIN)/kPrf2.dylib
2279	LIB_VMM = $(PATH_STAGE_BIN)/VBoxVMM.dylib
2280	LIB_VMMRC = $(PATH_STAGE_BIN)/VMMRC.rc
2281	LIB_REM = $(PATH_STAGE_LIB)/VBoxREM.dylib
2282	LIB_XPCOM = $(PATH_STAGE_BIN)/VBoxXPCOM.dylib
2283	LIB_XPCOM_IMP = $(PATH_STAGE_LIB)/VBoxXPCOMImp.dylib
2284	VBOX_LIB_XPCOM_X86 = $(PATH_STAGE_BIN)/VBoxXPCOM-x86.dylib
2285	LIB_DDU = $(PATH_STAGE_BIN)/VBoxDDU.dylib
2286	VBOX_LIB_SUPR0 :=
2287	LIB_VBOXXPCOMIPCD = $(PATH_STAGE_BIN)/VBoxXPCOMIPCD.dylib
2288	endif
2289	if1of ($(KBUILD_TARGET), freebsd haiku linux netbsd openbsd solaris)
2290	LIB_RUNTIME = $(PATH_STAGE_BIN)/VBoxRT.so
2291	LIB_RUNTIME_EF = $(PATH_STAGE_LIB)/RuntimeEFCPP.a
2292	VBOX_LIB_RUNTIME_X86 = $(PATH_STAGE_BIN)/VBoxRT-x86.so
2293	LIB_KPROFILE = $(PATH_STAGE_BIN)/kPrf2.so
2294	LIB_VMM = $(PATH_STAGE_BIN)/VBoxVMM.so
2295	LIB_VMMRC = $(PATH_STAGE_BIN)/VMMRC.rc
2296	LIB_REM = $(PATH_STAGE_LIB)/VBoxREM.so
2297	LIB_XPCOM = $(PATH_STAGE_BIN)/VBoxXPCOM.so
2298	LIB_XPCOM_IMP = $(PATH_STAGE_LIB)/VBoxXPCOMImp.so
2299	VBOX_LIB_XPCOM_X86 = $(PATH_STAGE_BIN)/VBoxXPCOM-x86.so
2300	LIB_DDU = $(PATH_STAGE_BIN)/VBoxDDU.so
2301	VBOX_LIB_SUPR0 :=
2302	LIB_VBOXXPCOMIPCD = $(PATH_STAGE_BIN)/VBoxXPCOMIPCD.so
2303	endif
2304	ifeq ($(KBUILD_TARGET),os2)
2305	LIB_RUNTIME = $(PATH_STAGE_BIN)/VBoxRT.dll
2306	LIB_RUNTIME_EF = #$(PATH_STAGE_LIB)/RuntimeEFCPP.a
2307	VBOX_LIB_RUNTIME_X86 = $(PATH_STAGE_BIN)/VBoxRT-x86.dll
2308	LIB_KPROFILE = $(PATH_STAGE_BIN)/kPrf2.dll
2309	LIB_VMM = $(PATH_STAGE_BIN)/VBoxVMM.dll
2310	LIB_VMMRC = $(PATH_STAGE_LIB)/VMMRCImp.lib
2311	LIB_REM = $(PATH_STAGE_LIB)/VBoxREMImp.lib
2312	LIB_XPCOM = $(PATH_STAGE_BIN)/VBoxXCOM.dll
2313	LIB_XPCOM_IMP = $(PATH_STAGE_LIB)/VBoxXPCOMImp.lib
2314	VBOX_LIB_XPCOM_X86 = $(PATH_STAGE_BIN)/VBoxXPCOM-x86.dll
2315	LIB_DDU = $(PATH_STAGE_BIN)/VBoxDDU.dll
2316	VBOX_OBJ_SYS0 = $(PATH_OBJ)/RuntimeR0/os2/sys0.obj
2317	VBOX_LIB_SUPR0 = $(PATH_STAGE_LIB)/SUPR0$(VBOX_SUFF_LIB)
2318	endif
2319	ifeq ($(KBUILD_TARGET),win)
2320	LIB_RUNTIME = $(PATH_STAGE_LIB)/VBoxRT.lib
2321	LIB_RUNTIME_EF = #$(PATH_STAGE_LIB)/RuntimeEFCPP.lib
2322	VBOX_LIB_RUNTIME_X86 = $(PATH_STAGE_LIB)/VBoxRT-x86.lib
2323	LIB_KPROFILE = $(PATH_STAGE_LIB)/kPrf2.lib
2324	LIB_VMM = $(PATH_STAGE_LIB)/VBoxVMM.lib
2325	LIB_VMMRC = $(PATH_OBJ)/VMMRC/VMMRC.lib
2326	LIB_REM = $(PATH_STAGE_LIB)/VBoxREMImp.lib
2327	LIB_XPCOM =
2328	LIB_XPCOM_IMP =
2329	VBOX_LIB_XPCOM_X86 =
2330	LIB_DDU = $(PATH_STAGE_LIB)/VBoxDDU.lib
2331	VBOX_LIB_SUPR0 = $(PATH_STAGE_LIB)/SUPR0$(VBOX_SUFF_LIB)
2332	endif
2333	ifn1of ($(KBUILD_TARGET_ARCH), $(VBOX_SUPPORTED_HOST_ARCHS)) # Hack to build a couple of extpack things that thing they need the VMM lib.
2334	LIB_VMM :=
2335	LIB_VMMRC :=
2336	endif
2337	VBOX_LIB_SUPHARDENED = $(PATH_STAGE_LIB)/SUPR3HardenedStatic$(VBOX_SUFF_LIB)
2338	VBOX_LIB_RUNTIME_STATIC = $(PATH_STAGE_LIB)/RuntimeR3$(VBOX_SUFF_LIB)
2339	VBOX_LIB_RUNTIME_STATIC_X86 = $(PATH_STAGE_LIB)/RuntimeR3-x86$(VBOX_SUFF_LIB)
2340	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" == "asan"
2341	VBOX_LIB_RUNTIME_STATIC_NO_ASAN = $(PATH_STAGE_LIB)/RuntimeR3NoAsan$(VBOX_SUFF_LIB)
2342	else
2343	VBOX_LIB_RUNTIME_STATIC_NO_ASAN = $(VBOX_LIB_RUNTIME_STATIC)
2344	endif
2345
2346	ifndef VBOX_WITH_REM
2347	LIB_REM :=
2348	endif
2349
2350	# Python
2351	ifndef VBOX_BLD_PYTHON
2352	if1of ($(KBUILD_HOST), win)
2353	VBOX_BLD_PYTHON := $(firstword $(rsort $(wildcard $(KBUILD_DEVTOOLS)/win.x86/python/v*/python$(HOSTSUFF_EXE))) \
2354	python-not-found.exe)
2355	else ifndef VBOX_WITH_PYTHON2_PREFERENCE
2356	VBOX_BLD_PYTHON := $(firstword \
2357	$(which python3$(HOSTSUFF_EXE)) \
2358	$(which python3.11$(HOSTSUFF_EXE)) \
2359	$(which python3.10$(HOSTSUFF_EXE)) \
2360	$(which python3.9$(HOSTSUFF_EXE)) \
2361	$(which python3.8$(HOSTSUFF_EXE)) \
2362	$(which python3.7$(HOSTSUFF_EXE)) \
2363	$(which python3.6$(HOSTSUFF_EXE)) \
2364	$(which python3.5$(HOSTSUFF_EXE)) \
2365	$(which python3.4$(HOSTSUFF_EXE)) \
2366	$(which python2.7$(HOSTSUFF_EXE)) \
2367	$(which python$(HOSTSUFF_EXE)) \
2368	$(which python2.6$(HOSTSUFF_EXE)) \
2369	python-not-found$(HOSTSUFF_EXE) )
2370	else
2371	VBOX_BLD_PYTHON := $(firstword \
2372	$(which python2.7$(HOSTSUFF_EXE)) \
2373	$(which python2.6$(HOSTSUFF_EXE)) \
2374	$(which python$(HOSTSUFF_EXE)) \
2375	$(which python3$(HOSTSUFF_EXE)) \
2376	python-not-found$(HOSTSUFF_EXE) )
2377	endif
2378	endif
2379	## For running python unittests in the validation kit.
2380	VBOX_UNITTEST_PYTHON ?= $(VBOX_BLD_PYTHON)
2381
2382	#
2383	# pylint setup, see https://www.pylint.org/.
2384	#
2385	# Disabled:
2386	# W0301 - Unnecessary semicolon.
2387	# W0511 - TODO/XXX/FIXME/+++.
2388	# W0603 - Using the global statement.
2389	# W0702 - No exception type(s) specified.
2390	# W0703 - Catch "Exception".
2391	# I0011 - Locally disabling XXXXX.
2392	# C0321 - More than one statement on a single line.
2393	# R0201 - Method could be a function.
2394	# C0326 - ????
2395	# W0123 - ????
2396	# C0330:bad-continuation - Wrong continued indentation (add X spaces).
2397	# * Triggering on perfectly legal comments in array initializers and stuff.
2398	# C0413:wrong-import-position - Import "YYYYY XXXXX" should be placed at the top of the module.
2399	# * False positives due to __copyright__, __version__, probably.
2400	# E0012:bad-option-value - Bad option value XXXXX.
2401	# * Newer pylint doesn't grok older warning disables in sources (e.g. W0142 in db.py). Wonderful!
2402	# I0012:locally-enabled - Locally enabling XXXXX.
2403	# * We temporarily disable stuff and then renabled it. Very tedious.
2404	# :nested-min-max - Buggy in 2.16.2 when mixing iterable and regular form, thus disabled.
2405	#
2406	# Note! Yes, --max-branchs is a typo, but not by me.
2407	#
2408	# Note! Users of older pylint release (< 1.0) needs to define
2409	# VBOX_WITH_PYLINT_PRE_V1_0 in LocalConfig because they changed the
2410	# output arguments in an backwards incompatible way and added more
2411	# attribute regex options.
2412	#
2413	ifndef VBOX_PYLINT
2414	VBOX_PYLINT := $(firstword $(which pylint-2.7) $(which pylint-2.6) $(which pylint2) $(which pylint))
2415	#ifdef VBOX_PYLINT # -- why was this needed. It messes up when using pylint w/ 3.x and building with 2.7.
2416	# VBOX_PYLINT := $(VBOX_BLD_PYTHON) $(VBOX_PYLINT)
2417	#endif
2418	endif
2419	if !defined(VBOX_WITH_PYLINT) && defined(VBOX_PYLINT)
2420	VBOX_WITH_PYLINT := 1
2421	ifndef VBOX_PYLINT_VERSION
2422	ifdef VBOX_WITH_PYLINT_PRE_V1_0
2423	VBOX_PYLINT_VERSION = 9999
2424	else ifdef VBOX_WITH_PYLINT_V1_2_1_PLUS
2425	VBOX_PYLINT_VERSION = 10201
2426	else ifdef VBOX_WITH_PYLINT_V1_1_PLUS
2427	VBOX_PYLINT_VERSION = 10100
2428	else
2429	VBOX_PYLINT_VERSION = 10000
2430	endif
2431	endif
2432	endif
2433	VBOX_PYLINT_FLAGS = $(if-expr $(VBOX_PYLINT_VERSION) >= 10500,--reports=n,--report=n) \
2434	$(if-expr $(VBOX_PYLINT_VERSION) >= 10000 \
2435	,--msg-template='{path}:{line}: <{msg_id}>({obj}:{symbol}): {msg}' \
2436	,--output-format=msvs --include-ids=y) \
2437	--persistent=n \
2438	--rcfile=$(PATH_ROOT)/tools/pylintrc \
2439	--max-line-length=130 \
2440	--max-attributes=32 \
2441	--max-branch$(if-expr $(VBOX_PYLINT_VERSION) >= 10000,e,)s=50 \
2442	--max-statements=100 \
2443	--max-returns=100 \
2444	--max-public-methods=139 \
2445	--max-args=9 \
2446	--max-module-lines=4096 \
2447	--max-locals=32 \
2448	$(if-expr $(VBOX_PYLINT_VERSION) >= 10500,--max-bool-expr=99,) \
2449	--min-public-methods=0 \
2450	--function-rgx='[a-z_][a-zA-Z0-9_]{2,40}$(DOLLAR)' \
2451	--method-rgx='[a-z_][a-zA-Z0-9_]{2,40}$(DOLLAR)' \
2452	--argument-rgx='([a-z_][a-zA-Z0-9_]{2,30}\|rc\|hr\|s\|c\|ch\|cx\|cy\|cb\|fn)$(DOLLAR)' \
2453	--variable-rgx='([a-z_][a-zA-Z0-9_]{2,30}\|rc\|hr\|s\|c\|ch\|cx\|cy\|cb\|fn)$(DOLLAR)' \
2454	--attr-rgx='([a-z_][a-zA-Z0-9_]{2,30}\|rc\|hr\|o)$(DOLLAR)' \
2455	--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)' \
2456	--class-rgx='(td\|)[A-Z_][a-zA-Z0-9_]+$(DOLLAR)' \
2457	--const-rgx='(g_(k\|)[abcdefhmnpilorstu]+[A-Z][a-zA-Z0-9]+\|[A-Z_][A-Z0-9_]+\|__copyright__\|__version__\|__file__\|__all__)$(DOLLAR)' \
2458	--good-names='i,j,k,t,o,c,e,ch,s,_' \
2459	$(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})',) \
2460	$(if-expr $(VBOX_PYLINT_VERSION) >= 10500,--max-nested-blocks=9,) \
2461	$(if-expr $(VBOX_PYLINT_VERSION) >= 10100,--disable=bad-whitespace,) \
2462	$(if-expr $(VBOX_PYLINT_VERSION) >= 10201,--disable=bad-continuation --disable=eval-used,) \
2463	$(if-expr $(VBOX_PYLINT_VERSION) >= 10201 && $(VBOX_PYLIN_VERSION) < 10500,--disable=bad-option-value,) \
2464	$(if-expr $(VBOX_PYLINT_VERSION) >= 10500,--disable=wrong-import-position --disable=E0012 --disable=locally-enabled,) \
2465	$(if-expr $(VBOX_PYLINT_VERSION) >= 10600,--disable=missing-docstring --disable=trailing-newlines --disable=ungrouped-imports,) \
2466	$(if-expr $(VBOX_PYLINT_VERSION) >= 10800,--disable=redundant-keyword-arg,) \
2467	$(if-expr $(VBOX_PYLINT_VERSION) >= 20000,--disable=useless-object-inheritance --disable=useless-return,) \
2468	$(if-expr $(VBOX_PYLINT_VERSION) >= 20400,--disable=import-outside-toplevel,) \
2469	$(if-expr $(VBOX_PYLINT_VERSION) >= 20900,--disable=super-with-arguments --disable=raise-missing-from,) \
2470	$(if-expr $(VBOX_PYLINT_VERSION) >= 21200,--disable=consider-using-f-string --disable=unnecessary-semicolon --disable=redundant-u-string-prefix) \
2471	$(if-expr $(VBOX_PYLINT_VERSION) >= 21602,--disable=broad-exception-raised) \
2472	$(if-expr $(VBOX_PYLINT_VERSION) >= 21602,--disable=nested-min-max) \
2473	--disable=unnecessary-semicolon,invalid-encoded-data,global-statement,bare-except,broad-except,multiple-statements,no-self-use,fixme \
2474	--disable=I0011 \
2475	--ignored-classes=testdriver.vboxcon
2476
2477
2478	# Define the macro for win path conversion.
2479	if !defined(VBOX_ONLY_SDK) \|\| defined(VBOX_ONLY_SDK_ON_HOST) \|\| defined(VBOX_ONLY_SDK_IN_VM)
2480	VBOX_FN_MAKE_WIN_PATH = "$(quote-sh-dq $(subst /,\,$(requote unq, $(1))))"
2481	else
2482	# Z: is always FS root for Wine.
2483	VBOX_FN_MAKE_WIN_PATH = $(subst /,\\,$(patsubst /%,Z:/%,$(1)))
2484	endif
2485
2486	# The kprofile build automagically links with kProfile.
2487	ifeq ($(KBUILD_TYPE),kprofile)
2488	LIB_RUNTIME += $(LIB_KPROFILE)
2489	endif
2490
2491	# Enable C++ electric fence heap. (Warning: will easily run out of virtual memory / kernel stuff on Linux/Windows.)
2492	ifdef VBOX_WITH_CPP_EF
2493	LIB_RUNTIME <= $(LIB_RUNTIME_EF)
2494	endif
2495
2496	# Overridable libraries (unix).
2497	LIB_PTHREAD ?= pthread
2498
2499	# Xcursor (consider an SDK for this).
2500	ifeq ($(VBOX_XCURSOR_LIBS),)
2501	ifeq ($(KBUILD_TARGET),solaris)
2502	VBOX_XCURSOR_LIBS := $(lastword $(wildcard $(KBUILD_DEVTOOLS_TRG)/libXcursor/*/lib/libXcursor.a))
2503	ifneq ($(VBOX_XCURSOR_LIBS),)
2504	VBOX_XCURSOR_INCS := $(patsubst %/lib/libXcursor.a,%/include, $(VBOX_XCURSOR_LIBS))
2505	VBOX_XCURSOR_LIBS += X11 Xrender Xfixes
2506	endif
2507	endif
2508	ifeq ($(VBOX_XCURSOR_LIBS),)
2509	VBOX_XCURSOR_LIBS := Xcursor
2510	endif
2511	endif
2512
2513
2514	# Intel ASL compiler for ACPI
2515	VBOX_IASLCMD ?= $(firstword $(wildcard $(KBUILD_DEVTOOLS_HST)/bin/iasl$(HOSTSUFF_EXE)) iasl$(HOSTSUFF_EXE))
2516
2517	# libxslt XSLT processor. (see PATH_TOOL_YASM for explanation why it's temporarily located in bin.)
2518	ifeq ($(VBOX_XSLTPROC),)
2519	ifeq ($(KBUILD_HOST),win)
2520	VBOX_XSLTPROC := $(wildcard $(KBUILD_DEVTOOLS)/$(KBUILD_HOST).$(KBUILD_HOST_ARCH)/libxslt/10128/bin/xsltproc.exe)
2521	ifeq ($(VBOX_XSLTPROC),)
2522	VBOX_XSLTPROC := $(KBUILD_DEVTOOLS)/win.x86/bin/xsltproc.exe
2523	endif
2524	else ifeq ($(KBUILD_HOST),os2)
2525	VBOX_XSLTPROC := BEGINLIBPATH="$(KBUILD_DEVTOOLS_HST)/bin;$$BEGINLIBPATH" $(KBUILD_DEVTOOLS_HST)/bin/xsltproc.exe
2526	else ifeq ($(KBUILD_HOST),haiku)
2527	VBOX_XSLTPROC := $(KBUILD_DEVTOOLS)/haiku.x86/bin/xsltproc
2528	else
2529	VBOX_XSLTPROC := xsltproc$(HOSTSUFF_EXE)
2530	endif
2531	endif
2532
2533	# Doxygen
2534	ifeq ($(VBOX_DOXYGEN),)
2535	VBOX_DOXYGEN := $(firstfile $(rversortfiles $(qwildcard , $(KBUILD_DEVTOOLS_HST)/doxygen/v*/doxygen$(HOSTSUFF_EXE))) doxygen$(HOSTSUFF_EXE))
2536	endif
2537
2538	# bin2c (convert binary files into C arrays)
2539	VBOX_BIN2C ?= $(PATH_OBJ)/bin2c/bin2c$(HOSTSUFF_EXE)
2540
2541	# genalias (generate aliases for nocrt_ functions)
2542	VBOX_GENALIAS ?= $(PATH_OBJ)/genalias/genalias$(HOSTSUFF_EXE)
2543
2544	# RTManifest (extension pack manifest utility)
2545	VBOX_RTMANIFEST ?= $(PATH_OBJ)/bldRTManifest/bldRTManifest$(HOSTSUFF_EXE)
2546
2547	# RTSignTool (certificate extraction tool)
2548	VBOX_RTSIGNTOOL ?= $(PATH_OBJ)/bldRTSignTool/bldRTSignTool$(HOSTSUFF_EXE)
2549
2550	# RTIsoMaker (our own ISO maker).
2551	VBOX_RTISOMAKER ?= $(PATH_OBJ)/bldRTIsoMaker/bldRTIsoMaker$(HOSTSUFF_EXE)
2552
2553	# RTLdrCheckImports (checks imports against oldest supported OS version (GAs typically))
2554	VBOX_RTLDRCHECKIMPORTS ?= $(PATH_OBJ)/bldRTLdrCheckImports/bldRTLdrCheckImports$(HOSTSUFF_EXE)
2555
2556	# VBoxCmp (simple /bin/cmp with more sensible output)
2557	VBOX_VBOXCMP ?= $(PATH_OBJ)/VBoxCmp/VBoxCmp$(HOSTSUFF_EXE)
2558
2559	# VBoxCPP (special purpose C preprocessor)
2560	VBOX_VBOXCPP ?= $(PATH_OBJ)/VBoxCPP/VBoxCPP$(HOSTSUFF_EXE)
2561
2562	# VBoxTpG (tracepoint generator)
2563	VBOX_VBOXTPG ?= $(PATH_OBJ)/VBoxTpG/VBoxTpG$(HOSTSUFF_EXE)
2564
2565	# VBoxPeSetVersion (changes the minimum OS version of an image)
2566	VBOX_PE_SET_VERSION ?= $(PATH_OBJ)/VBoxPeSetVersion/VBoxPeSetVersion$(HOSTSUFF_EXE)
2567
2568	# Visual C++ EditBin.exe.
2569	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
2570
2571	# filesplitter (splits java files)
2572	VBOX_FILESPLIT ?= $(PATH_OBJ)/filesplitter/filesplitter$(HOSTSUFF_EXE)
2573
2574	# biossums (set BIOS checksums)
2575	VBOX_BIOSSUMS ?= $(PATH_OBJ)/biossums/biossums$(HOSTSUFF_EXE)
2576
2577	# MakeAlternativeSource (for BIOSes)
2578	VBOX_MAKE_ALTERNATIVE_SOURCE ?= $(PATH_OBJ)/MakeAlternativeSource/MakeAlternativeSource$(HOSTSUFF_EXE)
2579
2580	# VBoxDef2LazyLoad (lazy dynamic library loader assembly generator)
2581	VBOX_DEF_2_LAZY_LOAD ?= $(PATH_OBJ)/VBoxDef2LazyLoad/VBoxDef2LazyLoad$(HOSTSUFF_EXE)
2582
2583	# VBoxCheckImports (checks what we imports from on windows)
2584	VBOX_CHECK_IMPORTS ?= $(PATH_OBJ)/VBoxCheckImports/VBoxCheckImports$(HOSTSUFF_EXE)
2585
2586	# VBoxEditCoffLib (symbol name tweaking for VBoxSF on windows)
2587	VBOX_EDIT_COFF_LIB ?= $(PATH_OBJ)/VBoxEditCoffLib/VBoxEditCoffLib$(HOSTSUFF_EXE)
2588
2589	# GNU tar if present.
2590	if1of ($(KBUILD_TARGET), linux os2 win)
2591	VBOX_GTAR ?= tar
2592	else if1of ($(KBUILD_TARGET), freebsd netbsd solaris)
2593	VBOX_GTAR ?= gtar
2594	endif
2595
2596	# zip
2597	VBOX_ZIP ?= zip$(HOSTSUFF_EXE)
2598
2599	ifeq ($(KBUILD_TARGET),win)
2600	ifeq ($(KBUILD_TARGET_ARCH),x86) # Normally we should test for KBUILD_HOST_ARCH but we only require MINGWW64 for 64-bit _targets_
2601	VBOX_NM ?= $(PATH_TOOL_MINGW32)/bin/nm.exe -p
2602	else
2603	VBOX_NM ?= $(PATH_TOOL_MINGWW64)/bin/nm.exe -p
2604	endif
2605	else 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.
2606	VBOX_NM ?= $(subst $(REDIRECT_INT),$(REDIRECT_EXT),$(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(PATH_TOOL_$(VBOX_GCC_TOOL)_TOOLCHAIN_BIN_SLASH)nm) -p \
2607	$(if-expr $(VBOX_XCODE_VERSION_MAJOR) > 7 \|\| ($(VBOX_XCODE_VERSION_MAJOR) == 7 && $(VBOX_XCODE_VERSION_MINOR) >= 3),-B,)
2608	else
2609	VBOX_NM ?= nm -p -t x
2610	endif
2611
2612	# Makeself for the linux installers.
2613	VBOX_MAKESELF ?= $(KBUILD_DEVTOOLS)/common/makeself/v2.4.5-r2/makeself.sh
2614
2615	# Microsoft HTML Help Workshop.
2616	VBOX_PATH_HTML_HELP_WORKSHOP ?= $(KBUILD_DEVTOOLS)/win.x86/HTML_Help_Workshop/v1.3/
2617
2618	# Path to the null soft installer.
2619	VBOX_PATH_NSIS ?= $(KBUILD_DEVTOOLS)/win.x86/nsis/v3.08-log
2620
2621	# Windows install tools...
2622	# Note! The scripts has been moved to Bin in v8.0.
2623	VBOX_PATH_WIX ?= $(KBUILD_DEVTOOLS)/win.x86/wix/v3.11.2
2624	ifdef VBOX_WITH_NEW_WINDOWS_SDK
2625	VBOX_PATH_MSITRAN ?= $(PATH_SDK_$(VBOX_WINPSDK)_BIN)/../x86/MsiTran.Exe
2626	VBOX_PATH_MSIDB ?= $(PATH_SDK_$(VBOX_WINPSDK)_BIN)/../x86/MsiDb.Exe
2627	VBOX_PATH_WISUBSTG ?= $(PATH_SDK_$(VBOX_WINPSDK)_BIN)/WiSubStg.vbs
2628	VBOX_PATH_WISUMINFO ?= $(PATH_SDK_$(VBOX_WINPSDK)_BIN)/WiSumInf.vbs
2629	else
2630	VBOX_PATH_MSITRAN ?= $(KBUILD_DEVTOOLS)/win.x86/sdk/v7.1/Bin/MsiTran.Exe
2631	VBOX_PATH_MSIDB ?= $(KBUILD_DEVTOOLS)/win.x86/sdk/v7.1/Bin/MsiDb.Exe
2632	VBOX_PATH_WISUBSTG ?= $(KBUILD_DEVTOOLS)/win.x86/sdk/v7.1/Samples/sysmgmt/msi/scripts/WiSubStg.vbs
2633	VBOX_PATH_WISUMINFO ?= $(KBUILD_DEVTOOLS)/win.x86/sdk/v7.1/Samples/sysmgmt/msi/scripts/WiSumInf.vbs
2634	endif
2635	VBOX_PATH_DIFX ?= $(KBUILD_DEVTOOLS)/win.$(KBUILD_TARGET_ARCH)/DIFx/v2.1-r3
2636
2637	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.
2638	# We need to export YASM for OSE, but since it was converted to .zip we need to
2639	# allow for the location used by the zip to be properly cleaned up first.
2640	if1of ($(KBUILD_HOST).$(KBUILD_HOST_ARCH), linux.x86 solaris.x86 win.x86)
2641	PATH_TOOL_YASM ?= $(KBUILD_DEVTOOLS_HST)/bin
2642	endif
2643	endif
2644
2645	# bison and flex for windows. Needed by mesa and also used by VBoxDTrace.
2646	ifeq ($(KBUILD_HOST),win)
2647	ifndef TOOL_BISON_YACC
2648	TOOL_BISON_YACC := $(firstfile $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS)/win.x86/win_flex_bison/v/bison*$(HOSTSUFF_EXE))) bison.exe)
2649	endif
2650	ifndef TOOL_FLEX_LEX
2651	TOOL_FLEX_LEX := $(firstfile $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS)/win.x86/win_flex_bison/v/flex*$(HOSTSUFF_EXE))) flex.exe)
2652	endif
2653	endif
2654
2655
2656	# The Microsoft IDL compiler (the SDK build needs this on non-Windows).
2657	VBOX_WIN_MIDL ?= $(EXEC_X86_WIN32) $(call VBOX_FN_MAKE_WIN_PATH,$(qfirstfile ,$(qwildcard ,$(qaddsuffix ,/[Mm][Ii][Dd][Ll].[Ee][Xx][Ee], \
2658	$(PATH_SDK_$(VBOX_WINPSDK)_BIN) \
2659	$(KBUILD_DEVTOOLS)/win.x86/sdk/v7.1/Bin$(if-expr "$(KBUILD_HOST).$(KBUILD_HOST_ARCH)" == "win.amd64",/x64,) \
2660	$(KBUILD_DEVTOOLS)/win.x86/ddk/7600.16385.1/bin/x86 \
2661	$(KBUILD_DEVTOOLS)/win.x86/bin \
2662	$(PATH_SDK_$(VBOX_WINPSDK)_BIN) \
2663	$(PATH_SDK_$(VBOX_WINPSDK)) \
2664	$(PATH_SDK_WINPSDK_BIN) \
2665	$(PATH_SDK_WINPSDK) \
2666	)) Sorry_Cannot_Find_The_Midl_Compiler_In_The_PSDK))
2667
2668	# Tricks to work around midl.exe problems with spaces in the /cpp_cmd value, it
2669	# forgets to quote it when creating the commandline and cl.exe gets very confused.
2670	ifndef VBOX_WITH_PARFAIT
2671	if1of (quote, $(KMK_FEATURES))
2672	VBOX_MIDL_REDIRECT = $(REDIRECT) --prepend "$(quote-sh-dq PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(qaddsuffix ,;,$(PATH_TOOL_$(VBOX_VCC_TOOL)_DLL_BIN)))" --
2673	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)))" --
2674	else
2675	VBOX_MIDL_REDIRECT = $(REDIRECT) --prepend 'PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(PATH)' --
2676	VBOX_MIDL_REDIRECT_X86 = $(REDIRECT) --prepend 'PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_BIN);$(PATH)' --
2677	endif
2678	else
2679	if1of (quote, $(KMK_FEATURES))
2680	VBOX_MIDL_REDIRECT = \
2681	$(REDIRECT) --prepend "$(quote-sh-dq PATH=$(VBOX_PARFAIT_PATH_BIN);$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(qaddsuffix ,;,$(PATH_TOOL_$(VBOX_VCC_TOOL)_DLL_BIN)))" --
2682	VBOX_MIDL_REDIRECT_X86 = \
2683	$(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)))" --
2684	else
2685	VBOX_MIDL_REDIRECT = \
2686	$(REDIRECT) --prepend 'PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(VBOX_PARFAIT_PATH_BIN);$(PATH)' --
2687	VBOX_MIDL_REDIRECT_X86 = \
2688	$(REDIRECT) --prepend 'PATH=$(PATH_TOOL_$(VBOX_VCC_TOOL)_BIN);$(VBOX_PARFAIT_PATH_BIN);$(PATH)' --
2689	endif
2690	endif
2691	VBOX_MIDL_CPP_CMD = $(lastword $(notdir ,$(subst $(EXEC_X86_WIN32),,$(TOOL_$(VBOX_VCC_TOOL)_CC))))
2692	VBOX_MIDL_CPP_CMD_X86 = $(lastword $(notdir ,$(subst $(EXEC_X86_WIN32),,$(TOOL_$(VBOX_VCC_TOOL_STEM)X86_CC))))
2693
2694	##
2695	# Edits $1 and adding #pragma directives for disabling warnings windows.h causes.
2696	# @param 1 The name of the file to edit.
2697	define def_VBoxMidlOutputDisableMscWarnings
2698	$(QUIET)$(MV) -f "$1" "$1.tmp"
2699	$(QUIET)$(APPEND) -nt "$1" \
2700	'#if _MSC_VER >= 1920 /* RT_MSC_VER_VS2019 */' \
2701	'# pragma warning(disable:5031 5032) /* buggy winioctl.h in some w10 sdks */ ' \
2702	'#endif' \
2703	'#pragma warning(push) /* -Wall and windows.h */' \
2704	'#pragma warning(disable:4668 4255)' \
2705	'#if _MSC_VER >= 1800 /* RT_MSC_VER_VC120 */' \
2706	'# pragma warning(disable:4005)' \
2707	'#endif' \
2708	'#if _MSC_VER >= 1900 /* RT_MSC_VER_VC140 */' \
2709	'# pragma warning(disable:5039)' \
2710	'#endif' \
2711	''
2712	$(QUIET)$(CAT_EXT) "$1.tmp" >> "$1"
2713	$(QUIET)$(APPEND) -n "$1" \
2714	'' \
2715	'#pragma warning(pop)' \
2716	''
2717	$(QUIET)$(RM) -f "$1.tmp"
2718
2719	endef
2720
2721	# XPCOM setup for all but win32.
2722	ifneq ($(KBUILD_TARGET),win)
2723	VBOX_WITH_XPCOM = 1
2724	# if updating, also update xpidl_INST var in src/libs/xpcom18a4/Makefile.kmk
2725	VBOX_XPIDL ?= $(PATH_STAGE_BIN)/xpidl$(HOSTSUFF_EXE)
2726	ifeq ($(KBUILD_TARGET),os2)
2727	VBOX_XPIDL_ENV = BEGINLIBPATH="$(dir $(VBOX_XPIDL));$$BEGINLIBPATH"$(SP)
2728	endif
2729	VBOX_PATH_XPCOM_IDL ?= $(VBOX_PATH_SDK)/bindings/xpcom/idl
2730	VBOX_XPCOM_INCS ?= \
2731	$(VBOX_PATH_SDK)/bindings/xpcom/include \
2732	$(VBOX_PATH_SDK)/bindings/xpcom/include/xpcom \
2733	$(VBOX_PATH_SDK)/bindings/xpcom/include/string \
2734	$(VBOX_PATH_SDK)/bindings/xpcom/include/xpcom \
2735	$(VBOX_PATH_SDK)/bindings/xpcom/include/nsprpub \
2736	$(VBOX_PATH_SDK)/bindings/xpcom/include/ipcd
2737	ifneq ($(KBUILD_TARGET),os2)
2738	# libIDL-config (for xpcom18a4)
2739	ifeq ($(origin VBOX_LIBIDL_CONFIG),undefined)
2740	ifeq ($(KBUILD_HOST),solaris)
2741	VBOX_LIBIDL_CONFIG_FALLBACK = $(lastword $(wildcard $(KBUILD_DEVTOOLS)/solaris.amd64/libIDL/*/bin/libIDL-config-2))
2742	endif
2743	export VBOX_LIBIDL_CONFIG := $(firstword $(which libIDL-config-2 libIDL-config) $(VBOX_LIBIDL_CONFIG_FALLBACK) libIDL-config-2-not-found)
2744	endif
2745	endif
2746	endif
2747
2748	# The X11 LIBPATH. (The amd64 hack is for RHEL4.)
2749	ifeq ($(KBUILD_TARGET_ARCH),amd64)
2750	VBOX_LIBPATH_X11 ?= /usr/X11R6/lib64 /usr/X11R6/lib
2751	else
2752	VBOX_LIBPATH_X11 ?= /usr/X11R6/lib
2753	endif
2754
2755	# 32bit X11 LIBPATH for building 32bit guest additions
2756	VBOX_LIBPATH32_X11 ?= /usr/X11R6/lib32 /usr/X11R6/lib
2757
2758	# Good windows shell.
2759	VBOX_GOOD_COMSPEC = $(subst \,/,$(SystemRoot))/System32/cmd.exe
2760	VBOX_GOOD_COMSPEC_BS ?= $(subst /,\,$(VBOX_GOOD_COMSPEC))
2761
2762	#
2763	# Macros dealing with the darwin version we're targeting.
2764	# The DEF in VBOX_DEF_MACOSX_VERSION_MIN mean default. The default min
2765	# version is assumed to be the
2766	#
2767	ifeq ($(KBUILD_TARGET),darwin)
2768	# The minimum macOS version we're targetting.
2769	ifndef VBOX_DEF_MACOSX_VERSION_MIN
2770	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO) # For GAs.
2771	VBOX_DEF_MACOSX_VERSION_MIN := 10.6# Snow Leopard
2772	else if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2773	VBOX_DEF_MACOSX_VERSION_MIN := 10.9# Mavericks
2774	else ifeq ($(KBUILD_TARGET_ARCH),arm64)
2775	VBOX_DEF_MACOSX_VERSION_MIN := 11.0# The Jack Kerouac novel.
2776	else
2777	if defined(VBOX_WITH_VMNET) && !defined(VBOX_ONLY_BUILD) # Force SDK 10.15 for VMNET
2778	VBOX_DEF_MACOSX_VERSION_MIN := 10.15# Catalina
2779	else
2780	VBOX_DEF_MACOSX_VERSION_MIN := 10.13# High Sierra
2781	endif
2782	endif
2783	endif
2784	VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT := $(subst .,,$(VBOX_DEF_MACOSX_VERSION_MIN))
2785
2786	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO) # For GAs.
2787	# Check for the Xcode 4.1 bits in tools/darwin.x86.
2788	if !defined(VBOX_WITH_MACOSX_COMPILERS_FROM_DEVEL) \
2789	&& !defined(VBOX_XCODE_VERSION) \
2790	&& exists "$(KBUILD_DEVTOOLS)/darwin.x86/xcode/v4.1"
2791	VBOX_WITH_MACOSX_COMPILERS_FROM_DEVEL := 1
2792	VBOX_PATH_MACOSX_DEVEL_ROOT := $(KBUILD_DEVTOOLS)/darwin.x86/xcode/v4.1
2793	VBOX_XCODE_VERSION := 4.1
2794	else
2795	# Fallback - system / LocalConfig.kmk.
2796	VBOX_PATH_MACOSX_DEVEL_ROOT ?= /Developer
2797	VBOX_PATH_MACOSX_SDK_ROOT ?= $(VBOX_PATH_MACOSX_DEVEL_ROOT)/SDKs
2798	VBOX_PATH_MACOSX_TOOLCHAIN_ROOT ?= $(VBOX_PATH_MACOSX_DEVEL_ROOT)
2799	endif
2800	else ifeq ($(VBOX_GCC_TOOL),VBoxXcode62)
2801	# Use the tool path of the compiler (it's clang, not gcc in this instance).
2802	include $(KBUILD_TOOL_PATHS)/$(VBOX_GCC_TOOL).kmk
2803	VBOX_PATH_MACOSX_DEVEL_ROOT := $(PATH_TOOL_$(VBOX_GCC_TOOL))
2804	# Fallback - system / LocalConfig.kmk.
2805	ifndef VBOX_PATH_MACOSX_DEVEL_ROOT
2806	VBOX_PATH_MACOSX_DEVEL_ROOT := $(firstword $(wildcard /Applications/Xcode.app/Contents/Developer /Developer /Library/Developer))
2807	endif
2808	ifndef VBOX_PATH_MACOSX_SDK_ROOT
2809	VBOX_PATH_MACOSX_SDK_ROOT := $(firstword $(wildcard \
2810	$(PATH_TOOL_$(VBOX_GCC_TOOL)_SDKS) \
2811	$(VBOX_PATH_MACOSX_DEVEL_ROOT)/SDKs/. \
2812	/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/. \
2813	/Developer/SDKs/. \
2814	/Library/Developer/CommandLineTools/SDKs/. ))
2815	endif
2816	ifndef VBOX_PATH_MACOSX_TOOLCHAIN_ROOT
2817	VBOX_PATH_MACOSX_TOOLCHAIN_ROOT := $(firstword $(wildcard \
2818	$(PATH_TOOL_$(VBOX_GCC_TOOL)_TOOLCHAIN) \
2819	$(VBOX_PATH_MACOSX_DEVEL_ROOT)/Library/Developer/CommandLineTools/. \
2820	$(VBOX_PATH_MACOSX_DEVEL_ROOT)/Toolchains/XcodeDefault.xctoolchain/. \
2821	/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/. \
2822	/Library/Developer/CommandLineTools/. \
2823	) /. )
2824	endif
2825	else
2826	# VBOX_WITH_EVEN_NEWER_XCODE ends up here.
2827	include $(KBUILD_PATH)/tools/$(VBOX_GCC_TOOL).kmk
2828	include $(KBUILD_PATH)/sdks/MACOSX$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT).kmk
2829	ifndef VBOX_PATH_MACOSX_SDK
2830	VBOX_PATH_MACOSX_SDK := $(PATH_SDK_MACOSX$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT))
2831	endif
2832	VBOX_PATH_MACOSX_SDK_ROOT = $(dir $(VBOX_PATH_MACOSX_SDK))
2833	endif
2834
2835	# Figure the default SDK location and obsolete linker tricks.
2836	ifeq ($(VBOX_DEF_MACOSX_VERSION_MIN),10.4)
2837	ifeq ($(origin VBOX_DARWIN_CLASSIC_LINKER),undefined)
2838	VBOX_DARWIN_CLASSIC_LINKER := $(shell ld -v 2>&1 )
2839	ifneq ($(filter ld64%, $(subst :, , $(VBOX_DARWIN_CLASSIC_LINKER))),)
2840	export VBOX_DARWIN_CLASSIC_LINKER := -Wl,-classic_linker
2841	else
2842	export VBOX_DARWIN_CLASSIC_LINKER :=
2843	endif
2844	endif
2845	endif
2846	if !defined(VBOX_PATH_MACOSX_SDK) && !defined(VBOX_WITH_EVEN_NEWER_XCODE) # newer xcode handles this above
2847	VBOX_PATH_MACOSX_SDK_ROOT_DIRS ?= \
2848	$(VBOX_PATH_MACOSX_SDK_ROOT) \
2849	$(KBUILD_DEVTOOLS)/darwin.x86/SDKs/ \
2850	$(KBUILD_DEVTOOLS)/darwin.amd64/SDKs/ \
2851	$(KBUILD_DEVTOOLS)/darwin.x86/xcode/v4.1/SDKs \
2852	$(KBUILD_DEVTOOLS)/darwin.x86/xcode/v3.2.6/SDKs
2853	ifeq ($(VBOX_DEF_MACOSX_VERSION_MIN),10.4)
2854	VBOX_PATH_MACOSX_SDK := $(firstword $(wildcard $(addsuffix /MacOSX$(VBOX_DEF_MACOSX_VERSION_MIN)u.sdk, $(VBOX_PATH_MACOSX_SDK_ROOT_DIRS))) \
2855	$(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX$(VBOX_DEF_MACOSX_VERSION_MIN)u.sdk )
2856	else
2857	VBOX_PATH_MACOSX_SDK := $(firstword $(wildcard $(addsuffix /MacOSX$(VBOX_DEF_MACOSX_VERSION_MIN).sdk, $(VBOX_PATH_MACOSX_SDK_ROOT_DIRS))) \
2858	$(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX$(VBOX_DEF_MACOSX_VERSION_MIN).sdk )
2859	endif
2860	endif
2861
2862	## The Xcode version (not relevant for command line tools, so we skip this in VBOX_WITH_EVEN_NEWER_XCODE mode).
2863	ifdef VBOX_WITH_EVEN_NEWER_XCODE
2864	VBOX_XCODE_VERSION ?= 10.98## Just a high non-existing version number.
2865	else ifeq ($(KBUILD_HOST),darwin)
2866	ifndef VBOX_XCODE_VERSION
2867	if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2868	VBOX_XCODE_VERSION := $(shell exec $(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/xcodebuild -version 2>&1)
2869	ifneq ($(pos Symbol not found,$(VBOX_XCODE_VERSION)),0) # Try detect unresolved symbol running Xcode 6.2 on Catalina.
2870	VBOX_XCODE_VERSION = 6.2
2871	else
2872	VBOX_XCODE_VERSION := $(word 2, $(VBOX_XCODE_VERSION))
2873	endif
2874	else if defined(VBOX_WITH_MACOSX_COMPILERS_FROM_DEVEL) \|\| exists "$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/xcodebuild"
2875	VBOX_XCODE_VERSION := $(word 2, $(shell $(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/xcodebuild -version))
2876	else
2877	VBOX_XCODE_VERSION := $(word 2, $(shell xcodebuild -version))
2878	endif
2879	ifeq ($(strip $(VBOX_XCODE_VERSION)),)
2880	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO)
2881	VBOX_XCODE_VERSION := 4.1
2882	else if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2883	VBOX_XCODE_VERSION := 6.2
2884	else
2885	VBOX_XCODE_VERSION := 9.4# whatever
2886	endif
2887	endif
2888	endif
2889	if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2890	ifdef KBUILD_USE_KOBJCACHE
2891	$(warning KBUILD_USE_KOBJCACHE does _not_ currently work with this version of Xcode)
2892	endif
2893	endif
2894	else
2895	VBOX_XCODE_VERSION ?= 4.1## @todo Anything special for GA, extpack and valkit tools fetching?
2896	endif
2897	VBOX_XCODE_VERSION_MAJOR := $(word 1, $(subst ., ,$(VBOX_XCODE_VERSION)))
2898	VBOX_XCODE_VERSION_MINOR := $(word 2, $(subst ., ,$(VBOX_XCODE_VERSION)))
2899	VBOX_XCODE_VERSION := $(VBOX_XCODE_VERSION_MAJOR).$(VBOX_XCODE_VERSION_MINOR)
2900
2901	ifeq ($(KBUILD_TARGET_ARCH),x86)
2902	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4 10.5)
2903	VBOX_DARWIN_NO_COMPACT_LINKEDIT ?= $(VBOX_LD_no_compact_linkedit)
2904	TOOL_GXX4MACHO_SUFFIX ?= -4.0
2905	endif
2906	else if $(VBOX_XCODE_VERSION_MAJOR) < 4 && "$(VBOX_XCODE_VERSION)" != "3.2"
2907	ifeq ($(PATH_CURRENT),$(PATH_ROOT)/tools)
2908	$(warning VBox: 64-bit darwin builds require Xcode 3.2 or later, you have $(VBOX_XCODE_VERSION))
2909	else
2910	$(error VBox: 64-bit darwin builds require Xcode 3.2 or later, you have $(VBOX_XCODE_VERSION))
2911	endif
2912	endif
2913	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO)
2914	if $(VBOX_XCODE_VERSION_MAJOR) > 4 \|\| ($(VBOX_XCODE_VERSION_MAJOR) == 4 && $(VBOX_XCODE_VERSION_MINOR) >= 2)
2915	TOOL_GXX4MACHO_PREFIX ?= llvm-
2916	endif
2917	if $(VBOX_XCODE_VERSION_MAJOR) < 5
2918	TOOL_GXX4MACHO_SUFFIX ?= -4.2
2919	endif
2920	VBOX_DARWIN_NO_COMPACT_LINKEDIT ?=
2921
2922	TOOL_GCC4MACHO_SUFFIX ?= $(TOOL_GXX4MACHO_SUFFIX)$(HOSTSUFF_EXE)
2923	TOOL_GCC4MACHO_PREFIX ?= $(TOOL_GXX4MACHO_PREFIX)
2924	if defined(VBOX_WITH_MACOSX_COMPILERS_FROM_DEVEL)
2925	TOOL_GCC4MACHO_PREFIX := $(VBOX_PATH_MACOSX_TOOLCHAIN_ROOT)/usr/bin/$(TOOL_GCC4MACHO_PREFIX)
2926	TOOL_GXX4MACHO_PREFIX := $(VBOX_PATH_MACOSX_TOOLCHAIN_ROOT)/usr/bin/$(TOOL_GXX4MACHO_PREFIX)
2927	TOOL_GCC4MACHO_SUFFIX := $(TOOL_GCC4MACHO_SUFFIX) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2928	TOOL_GXX4MACHO_SUFFIX := $(TOOL_GXX4MACHO_SUFFIX) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2929	ifndef SVN # must expand first so we won't be using old svn.
2930	SVN := $(firstword $(which svn) svn)
2931	endif
2932	if $(VBOX_XCODE_VERSION_MAJOR) > 4 \|\| ($(VBOX_XCODE_VERSION_MAJOR) == 4 && $(VBOX_XCODE_VERSION_MINOR) >= 2)
2933	export PATH:=$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/:$(VBOX_PATH_MACOSX_SDK)/usr/bin:$(VBOX_PATH_MACOSX_TOOLCHAIN_ROOT)/usr/bin:$(PATH)
2934	export DEVELOPER_DIR:=$(VBOX_PATH_MACOSX_DEVEL_ROOT)
2935	else
2936	export PATH:=$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/:$(PATH)
2937	endif
2938	TOOL_GXX32_CC = $(TOOL_GCC4MACHO_PREFIX)gcc$(TOOL_GCC4MACHO_SUFFIX) -m32
2939	TOOL_GXX32_CXX = $(TOOL_GCC4MACHO_PREFIX)g++$(TOOL_GCC4MACHO_SUFFIX) -m32
2940	TOOL_GXX32_LD = $(TOOL_GXX32_CXX)
2941	override TOOL_StandardDTrace_DTRACE := dtrace "-xcpppath=$(TOOL_GCC4MACHO_PREFIX)cpp-4.2"
2942	endif
2943	if $(VBOX_XCODE_VERSION_MAJOR) < 5
2944	## @todo WTF do we do the -m32/64 stuff here for these compilers? Also the visibility should be elsewhere...
2945	TOOL_GXX4MACHO_OBJC = $(TOOL_GCC4MACHO_PREFIX)gcc$(TOOL_GCC4MACHO_SUFFIX) $(if-expr $(KBUILD_TARGET_ARCH) == "x86",-m32,-m64) -fvisibility=hidden
2946	TOOL_GXX4MACHO_OBJCXX = $(TOOL_GCC4MACHO_PREFIX)gcc$(TOOL_GCC4MACHO_SUFFIX) $(if-expr $(KBUILD_TARGET_ARCH) == "x86",-m32,-m64) -fvisibility=hidden -fvisibility-inlines-hidden
2947	endif
2948	else if1of ($(VBOX_GCC_TOOL), VBoxXcode62)
2949	if $(KBUILD_HOST_VERSION_MAJOR) >= 18 # HACK ALERT! dtrace doesn't work on Mojave if we specify our Xcode 6.2 environment.
2950	override TOOL_StandardDTrace_DTRACE := dtrace "-xcpppath=$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/gcc"
2951	else
2952	override TOOL_StandardDTrace_DTRACE := $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) dtrace "-xcpppath=$(VBOX_PATH_MACOSX_DEVEL_ROOT)/usr/bin/gcc"
2953	endif
2954	export PATH:=$(VBOX_PATH_MACOSX_SDK)/usr/bin:$(PATH)
2955	else # effectively VBOX_WITH_EVEN_NEWER_XCODE
2956	override TOOL_StandardDTrace_DTRACE := $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) dtrace "-xcpppath=$(filter-out -f%,$(TOOL_$(VBOX_GCC_TOOL)_CC))"
2957	endif
2958
2959	ifdef VBOX_WITH_EVEN_NEWER_XCODE
2960	VBOX_DARWIN_DEF_SDK_SDKS := MACOSX$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT)
2961	VBOX_DARWIN_DEF_SDK_DEFS := MAC_OS_X_VERSION_MAX_ALLOWED=$(SDK_MACOSX$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT)_VERSION_VALUE)
2962	VBOX_DARWIN_DEF_SDK_LDFLAGS = $(VBOX_DARWIN_CLASSIC_LINKER) $(VBOX_DARWIN_NO_COMPACT_LINKEDIT)
2963	else
2964	VBOX_DARWIN_DEF_SDK_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT)0 \
2965	MAC_OS_X_VERSION_MAX_ALLOWED=$(VBOX_DEF_MACOSX_VERSION_MIN_NO_DOT)0
2966	VBOX_DARWIN_DEF_SDK_CFLAGS := -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2967	VBOX_DARWIN_DEF_SDK_CXXFLAGS := -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2968	VBOX_DARWIN_DEF_SDK_OBJCFLAGS := -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2969	VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS := -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -isysroot "$(VBOX_PATH_MACOSX_SDK)"
2970	VBOX_DARWIN_DEF_SDK_LDFLAGS = -mmacosx-version-min=$(VBOX_DEF_MACOSX_VERSION_MIN) -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK)" \
2971	$(VBOX_DARWIN_CLASSIC_LINKER) $(VBOX_DARWIN_NO_COMPACT_LINKEDIT)
2972	endif
2973
2974	# specific versions - only used by xpcom18a4 (python) and 10.7 by UsbWebcam.
2975	## @todo s/VBOX_DARWIN_DEF_SDK_10/VBOX_DARWIN_SDK_10/g
2976
2977	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4) # classic linker detection is bust otherwise
2978	VBOX_PATH_MACOSX_SDK_10_4 ?= $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.4u.sdk
2979	VBOX_DARWIN_DEF_SDK_10_4_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=1040 MAC_OS_X_VERSION_MAX_ALLOWED=1040
2980	VBOX_DARWIN_DEF_SDK_10_4_CFLAGS := -mmacosx-version-min=10.4 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_4)"
2981	VBOX_DARWIN_DEF_SDK_10_4_CXXFLAGS := -mmacosx-version-min=10.4 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_4)"
2982	VBOX_DARWIN_DEF_SDK_10_4_OBJCFLAGS := -mmacosx-version-min=10.4 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_4)"
2983	VBOX_DARWIN_DEF_SDK_10_4_OBJCXXFLAGS := -mmacosx-version-min=10.4 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_4)"
2984	VBOX_DARWIN_DEF_SDK_10_4_LDFLAGS := -mmacosx-version-min=10.4 -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK_10_4)" $(VBOX_DARWIN_CLASSIC_LINKER)
2985	else
2986	VBOX_PATH_MACOSX_SDK_10_4 = $(error VBox: $(if $(target),$(target): ,)Using 10.4 SDK)
2987	VBOX_DARWIN_DEF_SDK_10_4_CXXFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.4 SDK)
2988	VBOX_DARWIN_DEF_SDK_10_4_LDFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.4 SDK)
2989	endif
2990
2991	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4 10.5)
2992	VBOX_PATH_MACOSX_SDK_10_5 ?= $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.5.sdk
2993	VBOX_DARWIN_DEF_SDK_10_5_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=1050 MAC_OS_X_VERSION_MAX_ALLOWED=1050
2994	VBOX_DARWIN_DEF_SDK_10_5_CFLAGS := -mmacosx-version-min=10.5 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_5)"
2995	VBOX_DARWIN_DEF_SDK_10_5_CXXFLAGS := -mmacosx-version-min=10.5 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_5)"
2996	VBOX_DARWIN_DEF_SDK_10_5_OBJCFLAGS := -mmacosx-version-min=10.5 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_5)"
2997	VBOX_DARWIN_DEF_SDK_10_5_OBJCXXFLAGS := -mmacosx-version-min=10.5 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_5)"
2998	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)
2999	else
3000	VBOX_PATH_MACOSX_SDK_10_5 = $(error VBox: $(if $(target),$(target): ,)Using 10.5 SDK)
3001	VBOX_DARWIN_DEF_SDK_10_5_CXXFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.5 SDK)
3002	VBOX_DARWIN_DEF_SDK_10_5_LDFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.5 SDK)
3003	endif
3004
3005	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4 10.5 10.6)
3006	VBOX_PATH_MACOSX_SDK_10_6 ?= $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.6.sdk
3007	VBOX_DARWIN_DEF_SDK_10_6_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=1060 MAC_OS_X_VERSION_MAX_ALLOWED=1060
3008	VBOX_DARWIN_DEF_SDK_10_6_CFLAGS := -mmacosx-version-min=10.6 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_6)"
3009	VBOX_DARWIN_DEF_SDK_10_6_CXXFLAGS := -mmacosx-version-min=10.6 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_6)"
3010	VBOX_DARWIN_DEF_SDK_10_6_OBJCFLAGS := -mmacosx-version-min=10.6 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_6)"
3011	VBOX_DARWIN_DEF_SDK_10_6_OBJCXXFLAGS := -mmacosx-version-min=10.6 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_6)"
3012	VBOX_DARWIN_DEF_SDK_10_6_LDFLAGS := -mmacosx-version-min=10.6 -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK_10_6)"
3013	else
3014	VBOX_PATH_MACOSX_SDK_10_6 = $(error VBox: $(if $(target),$(target): ,)Using 10.6 SDK)
3015	VBOX_DARWIN_DEF_SDK_10_6_CXXFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.6 SDK)
3016	VBOX_DARWIN_DEF_SDK_10_6_LDFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.6 SDK)
3017	endif
3018
3019	if1of ($(VBOX_DEF_MACOSX_VERSION_MIN), 10.4 10.5 10.6 10.7)
3020	ifndef VBOX_PATH_MACOSX_SDK_10_7
3021	ifneq ($(wildcard $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.7.sdk),)
3022	VBOX_PATH_MACOSX_SDK_10_7 = $(VBOX_PATH_MACOSX_SDK_ROOT)/MacOSX10.7.sdk
3023	else
3024	VBOX_PATH_MACOSX_SDK_10_7 = $(KBUILD_DEVTOOLS)/darwin.x86/SDKs/MacOSX10.7.sdk
3025	endif
3026	endif
3027	VBOX_DARWIN_DEF_SDK_10_7_DEFS := MAC_OS_X_VERSION_MIN_REQUIRED=1070 MAC_OS_X_VERSION_MAX_ALLOWED=1070
3028	VBOX_DARWIN_DEF_SDK_10_7_CFLAGS := -mmacosx-version-min=10.7 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_7)"
3029	VBOX_DARWIN_DEF_SDK_10_7_CXXFLAGS := -mmacosx-version-min=10.7 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_7)"
3030	VBOX_DARWIN_DEF_SDK_10_7_OBJCFLAGS := -mmacosx-version-min=10.7 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_7)"
3031	VBOX_DARWIN_DEF_SDK_10_7_OBJCXXFLAGS := -mmacosx-version-min=10.7 -isysroot "$(VBOX_PATH_MACOSX_SDK_10_7)"
3032	VBOX_DARWIN_DEF_SDK_10_7_LDFLAGS := -mmacosx-version-min=10.7 -Wl,-syslibroot,"$(VBOX_PATH_MACOSX_SDK_10_7)"
3033	else
3034	VBOX_PATH_MACOSX_SDK_10_7 = $(error VBox: $(if $(target),$(target): ,)Using 10.7 SDK)
3035	VBOX_DARWIN_DEF_SDK_10_7_CXXFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.7 SDK)
3036	VBOX_DARWIN_DEF_SDK_10_7_LDFLAGS = $(error VBox: $(if $(target),$(target): ,)Using 10.7 SDK)
3037	endif
3038
3039	#
3040	# Use bison and flex from Xcode to avoid linking issues (bison).
3041	#
3042	TOOL_BISON_YACC ?= $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(PATH_TOOL_$(VBOX_GCC_TOOL)_TOOLCHAIN_BIN_SLASH)bison
3043	TOOL_FLEX_LEX ?= $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(PATH_TOOL_$(VBOX_GCC_TOOL)_TOOLCHAIN_BIN_SLASH)flex
3044
3045	#
3046	# Disable VMNet if the SDK is too old.
3047	#
3048	if defined(VBOX_WITH_VMNET) && "$(VBOX_DEF_MACOSX_VERSION_MIN)" vlt "10.15"
3049	VBOX_WITH_VMNET :=
3050	endif
3051
3052	endif # target=darwin
3053
3054	#
3055	# Macro switching between @executable_path, @rpath and /Applications/VirtualBox.app
3056	# depending on whether the build is hardened or not (dylib install_name).
3057	#
3058	ifeq ($(KBUILD_TARGET),darwin)
3059	ifndef VBOX_DYLD_EXECUTABLE_PATH
3060	ifdef VBOX_WITH_HARDENING
3061	VBOX_DYLD_EXECUTABLE_PATH = $(VBOX_PATH_APP_PRIVATE_ARCH)
3062	else if 0
3063	VBOX_DYLD_EXECUTABLE_PATH = @executable_path
3064	else
3065	VBOX_DYLD_EXECUTABLE_PATH = @rpath
3066	VBOX_WITH_RELATIVE_RUNPATH = @loader_path/
3067	endif
3068	endif
3069	endif
3070
3071	#
3072	# Check for incompatible rpath combinations.
3073	#
3074	if defined(VBOX_WITH_RUNPATH) && defined(VBOX_WITH_ORIGIN)
3075	$(error VBox: VBOX_WITH_RUNPATH and VBOX_WITH_ORIGIN are mutually exclusive)
3076	endif
3077	if defined(VBOX_WITH_RELATIVE_RUNPATH) && defined(VBOX_WITH_ORIGIN)
3078	$(error VBox: VBOX_WITH_RELATIVE_RUNPATH and VBOX_WITH_ORIGIN are mutually exclusive)
3079	endif
3080	if defined(VBOX_WITH_RUNPATH) && defined(VBOX_WITH_RELATIVE_RUNPATH)
3081	$(error VBox: VBOX_WITH_RUNPATH and VBOX_WITH_RELATIVE_RUNPATH are mutually exclusive)
3082	endif
3083	if defined(VBOX_WITH_RELATIVE_RUNPATH) && defined(VBOX_WITH_HARDENING)
3084	$(error VBox: VBOX_WITH_RELATIVE_RUNPATH and VBOX_WITH_HARDENING are mutually exclusive)
3085	endif
3086
3087	#
3088	# VBOX_WITH_ORIGIN translates into VBOX_WITH_RELATIVE_RUNPATH.
3089	#
3090	# We use two helper variables for the VBOX_WITH_ORIGIN stuff:
3091	# VBOX_ORIGIN - Indirect expansion trick.
3092	# VBOX_GCC_RPATH_OPT - Different GCC/LD combinations needs different options.
3093	#
3094	VBOX_ORIGIN = $$ORIGIN
3095	ifeq ($(KBUILD_TARGET),solaris)
3096	VBOX_GCC_RPATH_OPT = -R
3097	else
3098	VBOX_GCC_RPATH_OPT = -Wl,-rpath,
3099	VBOX_GCC_ORIGIN_OPT = -Wl,-z,origin
3100	endif
3101	ifdef VBOX_WITH_ORIGIN
3102	VBOX_WITH_RELATIVE_RUNPATH = $$(VBOX_ORIGIN)
3103	endif
3104
3105
3106	#
3107	# Configure 'asan' type builds.
3108	#
3109	# We ASSUME that anyone doing this kind of build on linux has a compiler
3110	# with sanitizer support (otherwise we'd end up with a circular dependency
3111	# with DynamicConfig.kmk here to check the compiler version).
3112	#
3113	ifeq ($(KBUILD_TYPE),asan)
3114	if "$(KBUILD_TARGET)" == "linux"
3115	VBOX_WITH_GCC_SANITIZER := 1
3116	else if "$(KBUILD_TARGET)" == "darwin"
3117	VBOX_WITH_GCC_SANITIZER := 1
3118	else if "$(KBUILD_TARGET)" == "win"
3119	VBOX_WITH_VCC_SANITIZER := 1
3120	else
3121	VBOX_WITH_EF_WRAPS := 1
3122	endif
3123	endif
3124
3125	#
3126	# The address sanitiser library intercepts dlopen() and breaks RPATH $ORIGIN,
3127	# so we need to link it statically or set LD_LIBRARY_PATH. To link statically,
3128	# set VBOX_WITH_GCC_SANITIZER_STATIC in addition.
3129	#
3130	ifdef VBOX_WITH_GCC_SANITIZER
3131	VBOX_GCC_SANITIZER_FLAGS := \
3132	-fsanitize=undefined \
3133	-fsanitize=address \
3134	-fsanitize=return \
3135	-fsanitize=bounds \
3136	-fsanitize=object-size \
3137	-fno-sanitize=alignment \
3138	-fno-sanitize=vptr \
3139	-fno-common \
3140	-DIPRT_WITH_GCC_SANITIZER \
3141	-DVBOX_WITH_GCC_SANITIZER
3142	else ifdef VBOX_WITH_CLANG_SANITIZER ## @todo make work...
3143	VBOX_GCC_SANITIZER_FLAGS := \
3144	-DIPRT_WITH_GCC_SANITIZER \
3145	-DVBOX_WITH_GCC_SANITIZER \
3146	-fsanitize=object-size \
3147	-fsanitize-undefined-trap-on-error
3148	else
3149	VBOX_GCC_SANITIZER_FLAGS =
3150	endif
3151
3152	# -libasan-static is currently not supported in combination with -no-undefined.
3153	VBOX_GCC_NO_UNDEFINED :=
3154	VBOX_GCC_NO_UNDEFINED_R0 :=
3155	ifdef VBOX_WITH_GCC_SANITIZER
3156	ifdef VBOX_WITH_GCC_SANITIZER_STATIC
3157	VBOX_GCC_NO_UNDEFINED := -Wl,--no-undefined
3158	VBOX_GCC_NO_UNDEFINED_R0 := -no-undefined
3159	VBOX_GCC_SANITIZER_LDFLAGS += -static-libasan
3160	else
3161	if "$(KBUILD_TARGET)" == "darwin"
3162	VBOX_GCC_SANITIZER_LDFLAGS += -fsanitize=address
3163	else
3164	VBOX_GCC_SANITIZER_LDFLAGS += -lasan
3165	endif
3166	endif
3167	endif
3168
3169	# The config for Visual C++ 2019 update 9 and later.
3170	ifdef VBOX_WITH_VCC_SANITIZER
3171	VBOX_VCC_SANITIZER_FLAGS := -fsanitize=address -fno-sanitize-address-vcasan-lib
3172	# experimental: VBOX_VCC_SANITIZER_FLAGS += /fsanitize-address-use-after-return
3173	VBOX_VCC_SANITIZER_LDFLAGS :=
3174	else
3175	VBOX_VCC_SANITIZER_FLAGS :=
3176	VBOX_VCC_SANITIZER_LDFLAGS :=
3177	endif
3178
3179
3180	#
3181	# The X11 headers.
3182	#
3183	VBOX_PATH_X11_ROOT = $(PATH_ROOT)/src/VBox/Additions/x11/x11include
3184
3185
3186	#
3187	# Miscellaneous includes
3188	#
3189	VBOX_GRAPHICS_INCS = $(PATH_ROOT)/include/VBox/Graphics
3190	VBOX_JPEG_INCS = $(PATH_ROOT)/src/libs/libjpeg-turbo-2.1.3
3191
3192
3193	# The icons to use.
3194	ifdef VBOX_OSE
3195	VBOX_WINDOWS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/OSE/VirtualBox_win.ico
3196	VBOX_WINDOWS_ADDITIONS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/OSE/VirtualBox_win.ico
3197	VBOX_NSIS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/OSE/VirtualBox_win.ico
3198	VBOX_MACOSX_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/darwin/OSE/VirtualBox.icns
3199	else
3200	ifeq ($(KBUILD_HOST),win)
3201	VBOX_WINDOWS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBox-vista.ico
3202	VBOX_WINDOWS_ADDITIONS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBoxGA-vista.ico
3203	VBOX_NSIS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBoxGA-nsis.ico
3204	TOOL_VCC80X86_RC := $(KBUILD_DEVTOOLS)/win.x86/ddk/6000/bin/x86/rc.exe
3205	TOOL_VCC80AMD64_RC := $(KBUILD_DEVTOOLS)/win.x86/ddk/6000/bin/x86/rc.exe
3206	TOOL_VCC70_RC := $(KBUILD_DEVTOOLS)/win.x86/ddk/6000/bin/x86/rc.exe
3207	else
3208	VBOX_WINDOWS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBox-winxp.ico
3209	VBOX_WINDOWS_ADDITIONS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBoxGA-winxp.ico
3210	VBOX_NSIS_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/win/NonOSE/VirtualBox-nsis.ico
3211	endif
3212	VBOX_MACOSX_ICON_FILE ?= $(PATH_ROOT)/src/VBox/Artwork/darwin/NonOSE/VirtualBox.icns
3213	endif
3214
3215
3216	ifndef VBOX_NOINC_DYNAMIC_CONFIG_KMK
3217	#
3218	# GCC and YASM dynamic properties.
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	if $(pos VBox,$(VBOX_GCC_TOOL)) > 0
3225	include $(KBUILD_TOOL_PATHS)/$(VBOX_GCC_TOOL).kmk
3226	else
3227	include $(KBUILD_PATH)/tools/$(VBOX_GCC_TOOL).kmk
3228	endif
3229	ifneq ($(VBOX_GCC_TOOL),$(VBOX_GCC32_TOOL))
3230	if $(pos VBox,$(VBOX_GCC32_TOOL)) > 0
3231	include $(KBUILD_TOOL_PATHS)/$(VBOX_GCC32_TOOL).kmk
3232	else
3233	include $(KBUILD_PATH)/tools/$(VBOX_GCC32_TOOL).kmk
3234	endif
3235	endif
3236
3237	# These tests never worked on Windows because of /dev/null, so, there
3238	# can be no harm in just dropping them until cygwin is mp safe.
3239	ifeq ($(KBUILD_HOST),win)
3240	VBOX_GCC_CHECK_EX_CC = $(3)
3241	VBOX_GCC_CHECK_EX_CXX = $(3)
3242	VBOX_GCC_CHECK_EX_LD = $(3)
3243	VBOX_GCC_CHECK_CC = $(2)
3244	VBOX_GCC_CHECK_CXX = $(2)
3245	VBOX_GCC_CHECK_LD = $(2)
3246	VBOX_GCC32_CHECK_CXX = $(2)
3247	else
3248	# Note! The chcking for 'error: unknown warning option' is for clang on darwin not giving us a
3249	# non-zero exit code when using an invalid option here, but it does later on.
3250	ifndef CLOSEPAR
3251	CLOSEPAR := )
3252	endif
3253	VBOX_GCC_CHECK_EX_CC_CXX = $(shell \
3254	if $(1) $(subst -Wno-,-W,$(2)) -Werror -c -o /dev/null $(4) > /dev/null 2>&1; then \
3255	case "`LC_ALL=C $(1) $(subst -Wno-,-W,$(2)) -Werror -c -o /dev/null $(4) 2>&1`" in \
3256	"error: unknown warning option"*$(CLOSEPAR) echo "$(3)";; \
3257	*$(CLOSEPAR) echo "$(2)";; \
3258	esac; \
3259	else echo "$(3)"; fi; )
3260	VBOX_GCC_CHECK_EX_CC = $(call VBOX_GCC_CHECK_EX_CC_CXX,$(1),$(2),$(3),-xc $(PATH_OUT)/DynamicConfig.c)
3261	VBOX_GCC_CHECK_EX_CXX = $(call VBOX_GCC_CHECK_EX_CC_CXX,$(1),$(2),$(3),-xc++ $(PATH_OUT)/DynamicConfig.cpp)
3262	VBOX_GCC_CHECK_EX_LD = $(shell \
3263	if $(1) -Wl,$(2) $(if $(eq $(KBUILD_HOST),darwin),-Wl$(COMMA)-u$(COMMA)start -Wl$(COMMA)-undefined$(COMMA)dynamic_lookup,) \
3264	-nostdlib -o /dev/null -xc /dev/null > /dev/null 2>&1; \
3265	then echo "-Wl,$(2)"; else echo "$(3)"; fi; )
3266
3267	VBOX_GCC_CHECK_CC = $(call VBOX_GCC_CHECK_EX_CC, $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC_TOOL)_CC),$1,$2)
3268	VBOX_GCC_CHECK_CXX = $(call VBOX_GCC_CHECK_EX_CXX, $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC_TOOL)_CXX),$1,$2)
3269	VBOX_GCC_CHECK_LD = $(call VBOX_GCC_CHECK_EX_LD, $(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC_TOOL)_LD),$1,$2)
3270	VBOX_GCC32_CHECK_CXX = $(call VBOX_GCC_CHECK_EX_CXX, $(TOOL_$(VBOX_GCC32_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC32_TOOL)_CXX),$1,$2)
3271	endif
3272
3273	ifeq ($(KBUILD_HOST),win)
3274	# We're not using gcc on windows anymore, just cook the result.
3275	VBOX_GCC_VERSION := $(expr 10000 * 3 + 100 * 3 + 3)
3276	else
3277	# This is kind of bad, the returned string needs to be re-evaluated before use.
3278	# The reason for this hack is that the windows kmk_ash cannot deal with $((1+1)).
3279	# Some versions of gcc (e.g. openSUSE11) return only major.minor on `gcc -dumpversion`.
3280	# gcc-5 of openSUSE42.1 only returns the major version on `gcc -dumpversion`!
3281	VBOX_GCC_VERSION = $(shell ($(1) -dumpfullversion 2>/dev/null \|\| $(1) -dumpversion) \| \
3282	$(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))\|' )
3283	ifeq ($(KBUILD_TARGET),darwin)
3284	VBOX_CLANG_VERSION = $(shell $(1) --version \| \
3285	$(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' )
3286	endif
3287	endif
3288
3289	# YASM macros
3290	ifndef DONT_USE_YASM
3291	include $(KBUILD_PATH)/tools/YASM.kmk
3292	if1of ($(KBUILD_HOST), win os2)
3293	VBOX_YASM_CHECK = $(if-expr "$(shell $(TOOL_YASM_AS) -e -o nul $1 - < /dev/null 2>&1)" == "",$(1),)
3294	else
3295	VBOX_YASM_CHECK = $(if-expr "$(shell $(TOOL_YASM_AS) -e -o /dev/null $1 - < /dev/null 2>&1)" == "",$(1),)
3296	endif
3297	else
3298	VBOX_YASM_CHECK =
3299	endif
3300
3301	# NASM macros (input and output must differ with recent versions (strcmp)).
3302	ifndef DONT_USE_NASM
3303	include $(KBUILD_PATH)/tools/NASM.kmk
3304	if1of ($(KBUILD_HOST), win os2)
3305	VBOX_NASM_CHECK = $(if-expr "$(shell $(TOOL_NASM_AS) -e -o nul $1 NUL 2>&1)" == "",$(1),$(2))
3306	else
3307	VBOX_NASM_CHECK = $(if-expr "$(shell $(TOOL_NASM_AS) -e -o /dev/./null $1 /dev/null 2>&1)" == "",$(1),$(2))
3308	endif
3309	else
3310	VBOX_NASM_CHECK =
3311	endif
3312
3313	# Figures the pylint version.
3314	VBOX_PYLINT_FIGURE_VERSION = $(shell $(1) --version 2> /dev/null \
3315	\| $(SED_EXT) -n -e 's/pylint-[^[:blank:]]*/pylint/' \
3316	-e 's\|^ pylint $[0-9][0-9]$.$[0-9][0-9]$\.$[0-9][0-9]$.$(DOLLAR)\|$$(expr \1 * 10000 + \2 * 100 + \3)\|p' )
3317
3318	# Java stuff.
3319	ifeq ($(KBUILD_TARGET),darwin)
3320	VBOX_JAVA_BIN_PATH = $(firstword $(wildcard \
3321	/System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Commands \
3322	/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Commands \
3323	$(if-expr $(VBOX_XCODE_VERSION_MAJOR) >= 4,/System/Library/Frameworks/JavaVM.framework/Versions/A/Commands,) \
3324	$(if-expr $(VBOX_XCODE_VERSION_MAJOR) >= 10,/Library/Java/JavaVirtualMachines/jdk1.8.*.jdk/Contents/Home/bin,) \
3325	) /usr/bin)
3326	VBOX_JAVA = $(VBOX_JAVA_BIN_PATH)/java
3327	VBOX_JAVAC = $(VBOX_JAVA_BIN_PATH)/javac
3328	VBOX_JAVAH = $(VBOX_JAVA_BIN_PATH)/javah
3329	VBOX_JAR = $(VBOX_JAVA_BIN_PATH)/jar
3330	VBOX_JAVADOC = $(VBOX_JAVA_BIN_PATH)/javadoc
3331	VBOX_WSIMPORT = $(VBOX_JAVA_BIN_PATH)/wsimport
3332	if $(VBOX_XCODE_VERSION_MAJOR) >= 4 # Lion (4.1-preview 5) has a broken CurrentJDK link. Blindly applying it to 4.0.
3333	VBOX_JAVA_INC = $(firstword $(wildcard \
3334	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/JavaVM.framework/Versions/A/Headers \
3335	/Library/Java/JavaVirtualMachines/jdk1.8.*.jdk/Contents/Home/include \
3336	) )
3337	else
3338	VBOX_JAVA_INC = $(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Headers
3339	endif
3340
3341	else # !darwin
3342
3343	ifeq ($(KBUILD_TARGET),linux)
3344	ifeq ($(origin VBOX_JAVA_HOME),undefined)
3345	# Add correct detection for you distro after the /usr/../java-6-sun line.
3346	VBOX_JAVA_HOME := $(firstword $(wildcard \
3347	$(KBUILD_DEVTOOLS)/linux.x86/jdk1.6.0_27 \
3348	/usr/lib/jvm/java-6-sun \
3349	/usr/lib/jvm/java-6-openjdk \
3350	/usr/lib/jvm/java-6-openjdk-i386 \
3351	/usr/lib/jvm/java-6-openjdk-amd64 \
3352	/usr/lib/jvm/java-7-openjdk-i386 \
3353	/usr/lib/jvm/java-7-openjdk-amd64 \
3354	/usr/lib/jvm/default-java \
3355	/usr/lib/jvm/java \
3356	/usr/lib/jvm/jre \
3357	\
3358	/usr/lib/jvm/sun-jdk-1.6 \
3359	) /usr/lib/jvm/java-6-sun)
3360	endif
3361	endif
3362
3363	ifeq ($(KBUILD_TARGET),solaris)
3364	# VBOX_JAVA_HOME ?= /usr/jdk/jdk1.6.0
3365	VBOX_JAVA_HOME ?= $(firstword $(abspath $(wildcard \
3366	/usr/jdk/latest/include/.. \
3367	/usr/jdk/instances/jdk1.8*/include/.. \
3368	/usr/jdk/instances/jdk1.7*/include/.. \
3369	/usr/jdk/instances/jdk1.6*/include/.. \
3370	)) /usr/java)
3371	endif
3372
3373	ifeq ($(KBUILD_TARGET),win)
3374	VBOX_JAVA_HOME ?= c:/jdk
3375	endif
3376
3377	VBOX_JAVA_BIN_PATH ?= $(VBOX_JAVA_HOME)/bin
3378	VBOX_JAVA ?= "$(VBOX_JAVA_BIN_PATH)/java$(HOSTSUFF_EXE)"
3379	VBOX_JAVAC = "$(VBOX_JAVA_BIN_PATH)/javac$(HOSTSUFF_EXE)"
3380	VBOX_JAVAH = "$(VBOX_JAVA_BIN_PATH)/javah$(HOSTSUFF_EXE)"
3381	VBOX_JAR = "$(VBOX_JAVA_BIN_PATH)/jar$(HOSTSUFF_EXE)"
3382	VBOX_JAVADOC = "$(VBOX_JAVA_BIN_PATH)/javadoc$(HOSTSUFF_EXE)"
3383	# With Java 11 wsimport was removed, usually part of a separate install now.
3384	VBOX_WSIMPORT = $(firstword $(wildcard $(VBOX_JAVA_BIN_PATH)/wsimport$(HOSTSUFF_EXE)) wsimport$(HOSTSUFF_EXE))
3385	# correct for targets we care about
3386	VBOX_MD_OS = $(KBUILD_TARGET)
3387	VBOX_JAVA_INC = \
3388	$(VBOX_JAVA_HOME)/include \
3389	$(VBOX_JAVA_HOME)/include/$(VBOX_MD_OS)
3390	endif # !darwin
3391	# The first transform the almost usless openjdk versions like "javac 9-Ubuntu" into something the 2nd expression groks.
3392	VBOX_JAVA_FIGURE_VERSION = $(shell $(1) -version 2>&1 \
3393	\| $(SED_EXT) -n \
3394	-e 's/ $[0-9][0-9]*$$-[[:alpha:]][[:alpha:]]$/ \1.0.0\2/' \
3395	-e 's\|^[^ ]* $[0-9][0-9]$\.$[0-9][0-9]$\.$[0-9][0-9]$.$(DOLLAR)\|$$(expr \1 10000 + \2 * 100 + \3)\|p' )
3396
3397	# Test C and C++ files.
3398	$(PATH_OUT)/DynamicConfig.c $(PATH_OUT)/DynamicConfig.cpp:
3399	$(QUIET)$(MKDIR) -p $(@D)
3400	$(QUIET)$(APPEND) -tn "$@" "int foobar(void)" "{" " return 42;" "}" ""
3401
3402	# No $(QUIET) here as it's interesting to see what goes into the file.
3403	$(PATH_OUT)/DynamicConfig.kmk: \
3404	$(PATH_ROOT)/Config.kmk \
3405	$(LOCALCFG) \
3406	$(AUTOCFG) \
3407	$(VBOX_GCC_PATH_CC) \
3408	$(VBOX_GCC_PATH_CXX) \
3409	$(VBOX_GCC_LIBGCC) \
3410	$(VBOX_GCC32_PATH_CC) \
3411	$(VBOX_GCC32_PATH_CXX) \
3412	$(VBOX_GCC32_LIBGCC) \
3413	$(if-expr "$(KBUILD_HOST).$(KBUILD_HOST_ARCH)" == "solaris.amd64" && $(KBUILD_HOST_VERSION_MINOR) >= 11 \
3414	, /platform/i86pc/kernel/$(KBUILD_HOST_ARCH)/unix,) \
3415	\| $(PATH_OUT)/DynamicConfig.c $(PATH_OUT)/DynamicConfig.cpp
3416	$(call MSG_GENERATE,,$@,)
3417	$(QUIET)$(RM) -f '$@'
3418	$(QUIET)$(MKDIR) -p $(@D)
3419	$(QUIET)$(APPEND) '$@' '# Host version: $(KBUILD_HOST_VERSION_MAJOR).$(KBUILD_HOST_VERSION_MINOR).$(KBUILD_HOST_VERSION_PATCH); full: $(KBUILD_HOST_VERSION)'
3420	ifneq ($(KBUILD_TARGET),win)
3421	$(QUIET)$(APPEND) '$@' '# $(KBUILD_HOST_UNAME_SYSNAME) - $(KBUILD_HOST_UNAME_RELEASE) - $(KBUILD_HOST_UNAME_VERSION)'
3422	endif
3423	ifeq ($(KBUILD_TARGET),darwin)
3424	$(QUIET)$(APPEND) '$@' '# VBOX_XCODE_VERSION: $(VBOX_XCODE_VERSION)'
3425	$(QUIET)$(APPEND) '$@' '# VBOX_PATH_MACOSX_TOOLCHAIN_ROOT: $(VBOX_PATH_MACOSX_TOOLCHAIN_ROOT)'
3426	$(QUIET)$(APPEND) '$@' '# VBOX_PATH_MACOSX_SDK_ROOT: $(VBOX_PATH_MACOSX_SDK_ROOT)'
3427	$(QUIET)$(APPEND) '$@' '# VBOX_PATH_MACOSX_DEVEL_ROOT: $(VBOX_PATH_MACOSX_DEVEL_ROOT)'
3428	$(QUIET)$(APPEND) '$@' 'VBOX_CLANG_VERSION_CC ?= $(call VBOX_CLANG_VERSION,$(TOOL_$(VBOX_GCC_TOOL)_CC))'
3429	$(QUIET)$(APPEND) '$@' 'VBOX_CLANG_VERSION_CXX ?= $(call VBOX_CLANG_VERSION,$(TOOL_$(VBOX_GCC_TOOL)_CXX))'
3430	endif
3431	# HC compiler switch detection.
3432	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_VERSION_CC ?= $(call VBOX_GCC_VERSION,$(TOOL_$(VBOX_GCC_TOOL)_CC))'
3433	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_VERSION_CXX ?= $(call VBOX_GCC_VERSION,$(TOOL_$(VBOX_GCC_TOOL)_CXX))'
3434	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_PATH_CC ?= $(which $(TOOL_$(VBOX_GCC_TOOL)_CC))'
3435	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_PATH_CXX ?= $(which $(TOOL_$(VBOX_GCC_TOOL)_CXX))'
3436	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_LIBGCC ?= $(shell $(TOOL_$(VBOX_GCC_TOOL)_CC) -print-libgcc-file-name)'
3437	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-pointer-sign ?= $(call VBOX_GCC_CHECK_CC,-Wno-pointer-sign,)'
3438	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-array_bounds ?= $(call VBOX_GCC_CHECK_CC,-Wno-array-bounds,)'
3439	# -Wextra produces additional useful warnings but includes -Wno-missing-field-initializers (too noisy)
3440	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wextra ?= $(call VBOX_GCC_CHECK_CC,-Wextra,)'
3441	$(QUIET)$(APPEND) '$@' 'ifneq ($$(VBOX_GCC_VERSION_CC),)'
3442	$(QUIET)$(APPEND) '$@' ' if $$(VBOX_GCC_VERSION_CC) >= 40500'
3443	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_Wlogical-op ?= $(call VBOX_GCC_CHECK_CC,-Wlogical-op,)'
3444	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_Wno-logical-op ?= $$(subst -Wlogical-op,-Wno-logical-op,$$(VBOX_GCC_Wlogical-op))
3445	$(QUIET)$(APPEND) '$@' ' endif'
3446	$(QUIET)$(APPEND) '$@' 'endif'
3447	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-address ?= $(call VBOX_GCC_CHECK_CXX,-Wno-address,)'
3448	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-delete-non-virtual-dtor ?= $(call VBOX_GCC_CHECK_CXX,-Wno-delete-non-virtual-dtor,)'
3449	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-non-virtual-dtor ?= $(call VBOX_GCC_CHECK_CXX,-Wno-non-virtual-dtor,)'
3450	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-int-in-bool-context ?= $(call VBOX_GCC_CHECK_CC,-Wno-int-in-bool-context,)'
3451	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-int-to-pointer-cast ?= $(call VBOX_GCC_CHECK_CC,-Wno-int-to-pointer-cast,)'
3452	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-invalid-offsetof ?= $(call VBOX_GCC_CHECK_CXX,-Wno-invalid-offsetof,)'
3453	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-literal-suffix ?= $(call VBOX_GCC_CHECK_CXX,-Wno-literal-suffix,)'
3454	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-misleading-indentation ?= $(call VBOX_GCC_CHECK_CC,-Wno-misleading-indentation,)'
3455	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-missing-field-initializers ?= $(call VBOX_GCC_CHECK_CC,-Wno-missing-field-initializers,)'
3456	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-pointer-to-int-cast ?= $(call VBOX_GCC_CHECK_CC,-Wno-pointer-to-int-cast,)'
3457	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-variadic-macros ?= $(call VBOX_GCC_CHECK_CXX,-Wno-variadic-macros,)'
3458	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-vla ?= $(call VBOX_GCC_CHECK_CXX,-Wno-vla,)'
3459	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-overlength-strings ?= $(call VBOX_GCC_CHECK_CC,-Wno-overlength-strings,)'
3460	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-overloaded-virtual ?= $(call VBOX_GCC_CHECK_CXX,-Wno-overloaded-virtual,)'
3461	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-ignored-qualifiers ?= $(call VBOX_GCC_CHECK_CXX,-Wno-ignored-qualifiers,)'
3462	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-multistatement-macros ?= $(call VBOX_GCC_CHECK_CXX,-Wno-multistatement-macros,)'
3463	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-class-memaccess ?= $(call VBOX_GCC_CHECK_CXX,-Wno-class-memaccess,)'
3464	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-stringop-overflow ?= $(call VBOX_GCC_CHECK_CXX,-Wno-stringop-overflow,)'
3465	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-stringop-truncation ?= $(call VBOX_GCC_CHECK_CXX,-Wno-stringop-truncation,)'
3466	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-cast-function-type ?= $(call VBOX_GCC_CHECK_CC,-Wno-cast-function-type,)'
3467	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-deprecated-declarations ?= $(call VBOX_GCC_CHECK_CC,-Wno-deprecated-declarations,)'
3468	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-implicit-fallthrough ?= $(call VBOX_GCC_CHECK_CC,-Wno-implicit-fallthrough,)'
3469	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-inline ?= $(call VBOX_GCC_CHECK_CXX,-Wno-inline,)'
3470	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-unknown-pragmas ?= $(call VBOX_GCC_CHECK_CXX,-Wno-unknown-pragmas,)'
3471	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-deprecated-copy ?= $(call VBOX_GCC_CHECK_CXX,-Wno-deprecated-copy,)'
3472	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fno-stack-protector ?= $(call VBOX_GCC_CHECK_CC,-fno-stack-protector,)'
3473	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fno-dwarf2-cfi-asm ?= $(call VBOX_GCC_CHECK_CC,-fno-dwarf2-cfi-asm,)'
3474	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_m64 ?= $(call VBOX_GCC_CHECK_CC,-m64,)'
3475	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_msse4.1 ?= $(call VBOX_GCC_CHECK_CC,-msse4.1,)'
3476	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_mavx ?= $(call VBOX_GCC_CHECK_CC,-mavx,)'
3477	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_mavx2 ?= $(call VBOX_GCC_CHECK_CC,-mavx2,)'
3478	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_no-pie ?= $(call VBOX_GCC_CHECK_CC,-no-pie,)'
3479	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fdiagnostics-show-option ?= $(call VBOX_GCC_CHECK_CC,-fdiagnostics-show-option,)'
3480	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fno-printf-return-value ?= $(call VBOX_GCC_CHECK_CC,-fno-printf-return-value,)'
3481	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wa_cma_nocompress_debug_sections ?= $(call VBOX_GCC_CHECK_CC,-Wa$(COMMA)--nocompress-debug-sections,)'
3482	# Produce code optimized for the most common IA32/AMD64/EM64T processors. Introduced with gcc version 4.2.
3483	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_mtune-generic ?= $(call VBOX_GCC_CHECK_CC,-mtune=generic,)'
3484	$(QUIET)$(APPEND) '$@' 'VBOX_LD_as_needed ?= $(call VBOX_GCC_CHECK_LD,--as-needed,)'
3485	$(QUIET)$(APPEND) '$@' 'VBOX_LD_hash_style_sysv ?= $(call VBOX_GCC_CHECK_LD,--hash-style=sysv,)'
3486	$(QUIET)$(APPEND) '$@' 'VBOX_LD_gc_sections ?= $(call VBOX_GCC_CHECK_LD,--gc-sections,)'
3487	# Set default attribute for ELF and MACH-O symbols to ``hidden'' to reduce the number
3488	# of relocation entries and PLT indirections in shared libraries. Don't allow for gcc version < 4.
3489	$(QUIET)$(APPEND) '$@' 'ifneq ($$(VBOX_GCC_VERSION_CC),)'
3490	$(QUIET)$(APPEND) '$@' ' if $$(VBOX_GCC_VERSION_CC) >= 40000'
3491	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_fvisibility-hidden ?= $(call VBOX_GCC_CHECK_CC,-fvisibility=hidden -DVBOX_HAVE_VISIBILITY_HIDDEN -DRT_USE_VISIBILITY_DEFAULT,)'
3492	$(QUIET)$(APPEND) '$@' ' endif'
3493	$(QUIET)$(APPEND) '$@' 'endif'
3494	ifn1of ($(KBUILD_TARGET), haiku)
3495	# Set default attribute for inline functions to ``hidden'' to reduce the number
3496	# of relocation entries and PLT indirections in shared libraries. Don't allow for gcc version < 4.
3497	$(QUIET)$(APPEND) '$@' 'ifneq ($$(VBOX_GCC_VERSION_CXX),)'
3498	$(QUIET)$(APPEND) '$@' ' if $$(VBOX_GCC_VERSION_CXX) >= 40000'
3499	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_fvisibility-inlines-hidden ?= $(call VBOX_GCC_CHECK_CXX,-fvisibility-inlines-hidden,)'
3500	$(QUIET)$(APPEND) '$@' ' endif'
3501	$(QUIET)$(APPEND) '$@' 'endif'
3502	endif
3503	# Prevent warnings about unused parameters as of gcc-4.8 / clang 6 as this warning is now very verbose
3504	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-unused-parameter ?= $(call VBOX_GCC_CHECK_CC,-Wno-unused-parameter,)'
3505	# Clang 6.
3506	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-language-extension-token ?= $(call VBOX_GCC_CHECK_CC,-Wno-language-extension-token,)'
3507	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-extended-offsetof ?= $(call VBOX_GCC_CHECK_CC,-Wno-extended-offsetof,)'
3508	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-gnu-folding-constant ?= $(call VBOX_GCC_CHECK_CC,-Wno-gnu-folding-constant,)'
3509	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-return-type-c-linkage ?= $(call VBOX_GCC_CHECK_CXX,-Wno-return-type-c-linkage,)'
3510	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-string-plus-int ?= $(call VBOX_GCC_CHECK_CC,-Wno-string-plus-int,)'
3511	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-nested-anon-types ?= $(call VBOX_GCC_CHECK_CC,-Wno-nested-anon-types,)'
3512	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-gnu-anonymous-struct ?= $(call VBOX_GCC_CHECK_CXX,-Wno-gnu-anonymous-struct,)'
3513	# Clang 11.
3514	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-c++17-compat-mangling ?= $(call VBOX_GCC_CHECK_CXX,-Wno-c++17-compat-mangling,)'
3515	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-nullability-extension ?= $(call VBOX_GCC_CHECK_CXX,-Wno-nullability-extension,)'
3516	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-gnu-statement-expression ?= $(call VBOX_GCC_CHECK_CXX,-Wno-gnu-statement-expression,)'
3517	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-import-preprocessor-directive-pedantic ?= $(call VBOX_GCC_CHECK_CXX,-Wno-import-preprocessor-directive-pedantic,)'
3518	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-undefined-var-template ?= $(call VBOX_GCC_CHECK_CXX,-Wno-undefined-var-template,)'
3519	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-c11-extensions ?= $(call VBOX_GCC_CHECK_CXX,-Wno-c11-extensions,)'
3520	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-tautological-pointer-compare ?= $(call VBOX_GCC_CHECK_CC,-Wno-tautological-pointer-compare,)'
3521	# Clang 13.
3522	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_Wno-deprecated-copy ?= $(call VBOX_GCC_CHECK_CC,-Wno-deprecated-copy,)'
3523	ifdef VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION
3524	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fcf-protection_branch ?= $(call VBOX_GCC_CHECK_CXX,-fcf-protection=branch,)'
3525	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_fcf-protection_check ?= $(call VBOX_GCC_CHECK_CXX,-fcf-protection=check)'
3526	endif
3527	ifeq ($(KBUILD_TARGET),solaris)
3528	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_msave-args ?= $(call VBOX_GCC_CHECK_CXX,-msave-args,)'
3529	# Detect the solaris assembler. It is used by the the 4.x gcc compilers,
3530	# apparently. It will not be able to handle IEMAll via a -pipe, only when
3531	# passed a file. The solaris assmbler rulez ... not!
3532	$(QUIET)$(APPEND) '$@' 'VBOX_AS_VERSION ?= $(shell `gcc -print-prog-name=as` -V -o /dev/null < /dev/null 2>&1 \| kmk_sed -e '1!d' -e 's/^as: *//' )'
3533	$(QUIET)$(APPEND) '$@' 'if $$(pos Sun Compiler Common,$$(VBOX_AS_VERSION)) > 0'
3534	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_USING_SOLARIS_AS=1'
3535	$(QUIET)$(APPEND) '$@' 'endif'
3536	$(QUIET)$(APPEND) '$@' 'ifndef VBOX_GCC_USING_SOLARIS_AS'
3537	$(QUIET)$(APPEND) '$@' ' VBOX_GCC_pipe ?= -pipe'
3538	$(QUIET)$(APPEND) '$@' 'endif'
3539	else
3540	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_pipe ?= -pipe'
3541	endif
3542	# Find the compiler includes for IPRT no-crt.
3543	# Note that `$(dir $(gcc -print-libgcc-file-name))/include does not work for a 64-bit cross build on a 32-bit build host.
3544	ifeq ($(KBUILD_HOST),win)
3545	# With the cygwin issues and gcc on windows returning a useless path, just skip this on windows.
3546	$(QUIET)$(APPEND) '$@' 'VBOX_PATH_GCC_INCS ?= '
3547	else
3548	$(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'
3549	endif
3550	# 32-bit (GC) compiler switch detection.
3551	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_PATH_CC ?= $(which $(TOOL_$(VBOX_GCC32_TOOL)_CC))'
3552	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_PATH_CXX ?= $(which $(TOOL_$(VBOX_GCC32_TOOL)_CXX))'
3553	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_VERSION_CC ?= $(call VBOX_GCC_VERSION,$(TOOL_$(VBOX_GCC32_TOOL)_CC))'
3554	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_VERSION_CXX ?= $(call VBOX_GCC_VERSION,$(TOOL_$(VBOX_GCC32_TOOL)_CXX))'
3555	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_LIBGCC ?= $(shell $(TOOL_$(VBOX_GCC32_TOOL)_CC) -print-libgcc-file-name)'
3556	$(QUIET)$(APPEND) '$@' 'VBOX_GCC32_Wno-variadic-macros ?= $(call VBOX_GCC32_CHECK_CXX,-Wno-variadic-macros,)'
3557	# darwin no_compact_linkedit starting at Xcode 3.2
3558	ifeq ($(KBUILD_HOST),darwin)
3559	$(QUIET)$(APPEND) '$@' 'VBOX_LD_no_compact_linkedit ?= $(call VBOX_GCC_CHECK_LD,-no_compact_linkedit,)'
3560	endif
3561	ifn1of ($(KBUILD_TARGET_ARCH), sparc32 sparc64)
3562	# YASM
3563	$(QUIET)$(APPEND) '$@' '# debug: TOOL_YASM_AS="$(TOOL_YASM_AS)"'
3564	$(QUIET)$(APPEND) '$@' 'VBOX_YASM_Wno-segreg-in-64bit ?= $(call VBOX_YASM_CHECK,-Wno-segreg-in-64bit,)'
3565	# NASM (--allow-64-bit: 2.12rc2)
3566	$(QUIET)$(APPEND) '$@' 'VBOX_NASM_allow_64_bit ?= $(call VBOX_NASM_CHECK,--allow-64-bit,)'
3567	endif
3568	if1of ($(KBUILD_TARGET), linux)
3569	ifeq ($(KBUILD_TARGET),$(KBUILD_HOST))
3570	$(QUIET)$(RM) -f -- "[email protected]" "[email protected]" '[email protected]'
3571	$(APPEND) -t '[email protected]' 'int foo() { return 42; }'
3572	$(QUIET)$(APPEND) '$@' 'VBOX_GCC_SANITIZER_SO_FILES := \'
3573	$(TOOL_$(VBOX_GCC_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC_TOOL)_CC) -fPIC -shared \
3574	$(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS) -o "[email protected]" "[email protected]"
3575	ldd "[email protected]" \| $(SED_EXT) --append '$@' -re '/lib(a\|ub)san\.so/!d' -e 's/.* => //' -e 's/ $0x[0-9a-fA-F]$ $(DOLLAR)/ \\/'
3576	$(QUIET)$(APPEND) '$@' ''
3577	# $(QUIET)$(APPEND) '$@' 'VBOX_GCC32_SANITIZER_SO_FILES := \'
3578	# $(TOOL_$(VBOX_GCC32_TOOL)_ENV_SETUP) $(TOOL_$(VBOX_GCC32_TOOL)_CC) -fPIC -shared \
3579	# $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS) -o "[email protected]" "[email protected]"
3580	# ldd "[email protected]" \| $(SED_EXT) --append '$@' -re '/lib(a\|ub)san\.so/!d' -e 's/.* => //' -e 's/ $0x[0-9a-fA-F]$ $(DOLLAR)/ \\/'
3581	# $(QUIET)$(APPEND) '$@' ''
3582	$(QUIET)$(RM) -f -- "[email protected]" "[email protected]" '[email protected]'
3583	endif
3584	endif
3585	ifdef VBOX_PATH_PREFIX_MINGW32
3586	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_VERSION_CC ?= $(call VBOX_GCC_VERSION,$(VBOX_PATH_PREFIX_MINGW32)gcc -m32)'
3587	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_VERSION_CXX ?= $(call VBOX_GCC_VERSION,$(VBOX_PATH_PREFIX_MINGW32)g++ -m32)'
3588	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_Wno-array-bounds ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW32)g++ -m32,-Wno-array-bounds,)'
3589	$(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,)'
3590	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_Wno-maybe-uninitialized ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW32)g++ -m32,-Wno-maybe-uninitialized,)'
3591	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW32_USER_LABEL_PREFIX ?= $(shell echo "__USER_LABEL_PREFIX__" \| $(VBOX_PATH_PREFIX_MINGW32)g++ -m32 -E -xc++ - \| $(SED) -e "/^$(HASH)/d")'
3592	endif
3593	ifdef VBOX_PATH_PREFIX_MINGW64
3594	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_VERSION_CC ?= $(call VBOX_GCC_VERSION,$(VBOX_PATH_PREFIX_MINGW64)gcc -m64)'
3595	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_VERSION_CXX ?= $(call VBOX_GCC_VERSION,$(VBOX_PATH_PREFIX_MINGW64)g++ -m64)'
3596	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_Wno-array-bounds ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW64)g++ -m64,-Wno-array-bounds,)'
3597	$(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,)'
3598	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_Wno-maybe-uninitialized ?= $(call VBOX_GCC_CHECK_EX_CXX,$(VBOX_PATH_PREFIX_MINGW64)g++ -m64,-Wno-maybe-uninitialized,)'
3599	$(QUIET)$(APPEND) '$@' 'VBOX_MINGW64_USER_LABEL_PREFIX ?= $(shell echo "__USER_LABEL_PREFIX__" \| $(VBOX_PATH_PREFIX_MINGW64)g++ -m64 -E -xc++ - \| $(SED) -e "/^$(HASH)/d")'
3600	endif
3601	if defined(TOOL_FLEX) \|\| defined(TOOL_BISON)
3602	echo "Do NOT include the flex or bison tools before Config.kmk gets loaded"
3603	exit 1 #
3604	endif
3605	$(QUIET)$(APPEND) '$@' 'VBOX_HAVE_FLEX ?= $(firstfile $(TOOL_FLEX_LEX) $(which flex))'
3606	$(QUIET)$(APPEND) '$@' 'VBOX_HAVE_BISON ?= $(firstfile $(TOOL_BISON_YACC) $(which bison))'
3607	$(QUIET)$(APPEND) '$@' 'VBOX_HAVE_XMLLINT ?= $(which xmllint)'
3608	if "$(KBUILD_HOST)" == "solaris" && $(KBUILD_HOST_VERSION_MAJOR) == 5 && $(KBUILD_HOST_VERSION_MINOR) == 11
3609	# BRANCH_VERSION format on S11 - S11.3:
3610	# <trunk_id>.<update>.<sru>.<reserved>.<buildid>.<nightly_id>
3611	# e.g.: 0.175.3.32.0.4.0:20180427T232405Z - N.B. trunk_id = 0.175
3612	# BRANCH_VERSION format on S11.4:
3613	# <minor>.<update>.<sru>.<reserved>.<reserved>.<buildid>.<nightly_id>
3614	# e.g.: 11.4.0.0.1.10.0:20180702T173343Z
3615	# We're interested in <update> and <buildid>.
3616	$(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/.*,//')"
3617	$(QUIET)$(APPEND) '$@' 'ifeq ($$(word 2, $$(subst ., ,$$(VBOX_SOLARIS_11_BRANCH_VERSION))),175)'
3618	$(QUIET)$(APPEND) '$@' ' VBOX_SOLARIS_11_UPDATE_VERSION := $$(word 3, $$(subst ., ,$$(VBOX_SOLARIS_11_BRANCH_VERSION)))'
3619	$(QUIET)$(APPEND) '$@' 'else'
3620	$(QUIET)$(APPEND) '$@' ' VBOX_SOLARIS_11_UPDATE_VERSION := $$(word 2, $$(subst ., ,$$(VBOX_SOLARIS_11_BRANCH_VERSION)))'
3621	$(QUIET)$(APPEND) '$@' 'endif'
3622	$(QUIET)$(APPEND) '$@' 'VBOX_SOLARIS_11_BUILD_VERSION := $$(word 6, $$(subst ., ,$$(VBOX_SOLARIS_11_BRANCH_VERSION)))'
3623	endif
3624	if1of ($(KBUILD_HOST), darwin freebsd solaris)
3625	$(QUIET)$(APPEND) '$@' 'VBOX_HOST_DTRACE_VERSION := $(shell dtrace -V)'
3626	endif
3627	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)
3628	$(QUIET)$(APPEND) '$@' "VBOX_PYLINT_VERSION := $(call VBOX_PYLINT_FIGURE_VERSION, $(VBOX_PYLINT))"
3629	endif
3630	if defined(VBOX_JAVAC)
3631	$(QUIET)$(APPEND) '$@' 'VBOX_JAVA_VERSION := $(call VBOX_JAVA_FIGURE_VERSION, $(VBOX_JAVAC))'
3632	endif
3633
3634	$(QUIET)$(ECHO) '========= START OF $@ ========='
3635	$(QUIET)$(CAT) $@
3636	$(QUIET)$(ECHO) '=========== END OF $@ ========='
3637
3638	include $(PATH_OUT)/DynamicConfig.kmk
3639	endif # !VBOX_NOINC_DYNAMIC_CONFIG_KMK
3640
3641
3642	#
3643	# C++ language level
3644	# See https://en.cppreference.com/w/cpp/compiler_support and compiler docs.
3645	#
3646	## @todo consider maxing this out.
3647	ifndef VBOX_GCC_std
3648	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), darwin.arm64) # Go straight for c++17 here.
3649	VBOX_GCC_std := -std=c++17
3650	# 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.
3651	#VBOX_GCC_std := -std=c++17
3652	else if "$(VBOX_CLANG_VERSION_CXX)" vge 50000 # darwin Xcode 5 allegedly knows what C++11 is
3653	VBOX_GCC_std := -std=c++11
3654	# 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.
3655	#VBOX_GCC_std := -std=gnu++17
3656	else if "$(VBOX_GCC_VERSION_CXX)" vge 40800
3657	VBOX_GCC_std := -std=c++11
3658	else if "$(VBOX_GCC_VERSION_CXX)" vge 40600
3659	VBOX_GCC_std := -std=c++0x
3660	endif
3661	endif
3662	ifndef VBOX_VCC_std
3663	if $(VBOX_VCC_TOOL_STEM) >= VCC141 # since 2017 15.3
3664	VBOX_VCC_std := -std:c++17 -Zc:__cplusplus
3665	endif
3666	endif
3667
3668
3669	#
3670	# Compiler warning control.
3671	#
3672	VBOX_GCC_WARN ?= -Wall $(VBOX_GCC_Wextra) $(VBOX_GCC_Wno-missing-field-initializers) -Wno-unused -Wno-trigraphs \
3673	$(VBOX_GCC_fdiagnostics-show-option) $(VBOX_GCC_Wno-unused-parameter) $(VBOX_GCC_Wno-language-extension-token) \
3674	$(VBOX_GCC_Wno-extended-offsetof) $(VBOX_GCC_Wno-gnu-folding-constant) $(VBOX_GCC_Wno-gnu-anonymous-struct) \
3675	$(VBOX_GCC_Wlogical-op) $(VBOX_GCC_Wno-string-plus-int) $(VBOX_GCC_Wno-nested-anon-types) $(VBOX_GCC_Wno-variadic-macros) \
3676	$(VBOX_GCC_Wno-c++17-compat-mangling)
3677	VBOX_GCC_WARN_PEDANTIC = -Wshadow $(VBOX_GCC_WARN) -Wno-long-long
3678	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)
3679	VBOX_GCC_WARN_MASOCHISTIC ?= -Wunused-variable -Wunused-function -Wunused-label -Wunused-parameter
3680	endif
3681	if $(KBUILD_TARGET) == "linux" \
3682	\|\| ($(KBUILD_TARGET) == "darwin" && "$(VBOX_GCC_TOOL)" != "GXX4MACHO" && "$(VBOX_GCC_TOOL)" != "GXX42MACHO") \
3683	\|\| defined(VBOX_WITH_MASOCHISTIC_WARNINGS)
3684	VBOX_GCC_WARN_PEDANTIC += $(VBOX_GCC_WARN_MASOCHISTIC)
3685	endif
3686
3687	ifdef VBOX_GCC_Wno-variadic-macros # Don't use -pedantic unless -Wno-variadic-macros also works. Too noisy.
3688	VBOX_GCC_PEDANTIC_OPTION ?= -pedantic
3689	else
3690	VBOX_GCC_PEDANTIC_OPTION ?=
3691	endif
3692	VBOX_GCC_PEDANTIC_CXX ?= $(VBOX_GCC_PEDANTIC_OPTION) $(VBOX_GCC_WARN_PEDANTIC) \
3693	$(VBOX_GCC_Wno-return-type-c-linkage) $(VBOX_GCC_Wno-overloaded-virtual) $(VBOX_GCC_Wno-undefined-var-template) $(VBOX_GCC_Wno-deprecated-copy)
3694	VBOX_GCC_PEDANTIC_C ?= $(VBOX_GCC_PEDANTIC_OPTION) $(VBOX_GCC_WARN_PEDANTIC) -Wmissing-prototypes -Wstrict-prototypes -Wmissing-declarations -Werror-implicit-function-declaration
3695
3696	# Avoid freaking out when using flexible arrays in C++ code (ldrPE.cpp, ++).
3697	if ($(VBOX_GCC_VERSION_CXX) < 60100 \|\| $(VBOX_GCC_VERSION_CXX) >= 70000) && "$(VBOX_GCC_Wno-array_bounds)" != ""
3698	VBOX_GCC_PEDANTIC_CXX += $(VBOX_GCC_Wno-array_bounds)
3699	endif
3700	# Stupid problem with (__typeof__((*ppv)) casts in asm.h where volatile is involved and ignored.
3701	if $(VBOX_GCC_VERSION_CXX) >= 80000 && "$(VBOX_GCC_Wno-ignored-qualifiers)"
3702	VBOX_GCC_PEDANTIC_CXX += $(VBOX_GCC_Wno-ignored-qualifiers)
3703	endif
3704
3705
3706	VBOX_GCC_NON_PEDANTIC_CXX ?= -Wno-sign-compare
3707	VBOX_GCC_NON_PEDANTIC_C ?= -Wno-sign-compare -Werror-implicit-function-declaration
3708
3709	if "$(KBUILD_TARGET)" == "darwin" && "$(VBOX_GCC_TOOL)" != "GXX4MACHO" && "$(VBOX_GCC_TOOL)" != "GXX42MACHO"
3710	VBOX_GCC_PEDANTIC_CXX += -Wno-c99-extensions
3711	VBOX_GCC_NON_PEDANTIC_CXX += -Wno-c99-extensions
3712	endif
3713
3714
3715	# Disabled Visual C++ warnings, W4:
3716	# -wd4065: switch statement contains 'default' but no 'case' labels
3717	# -wd4996: deprecated / insecure.
3718	# -wd4127: conditional expression is constant [level 4]
3719	# -wd4706: assignment within conditional expression [level 4]
3720	# -wd4201: nonstandard extension used : nameless struct/union [level 4]
3721	# -wd4214: nonstandard extension used : bit field types other than int [level 4]
3722	# -wd4510: 'VM::<unnamed-tag>' : default constructor could not be generated
3723	# -wd4512: 'VM' : assignment operator could not be generated
3724	# -wd4610: union 'VM::<unnamed-tag>' can never be instantiated - user defined constructor required
3725	# Disabled Visual C++ warnings, Wall:
3726	# -wd4514: unreferenced inline function has been removed
3727	# -wd4820: 'RTSTRSPACECORE' : '7' bytes padding added after data member 'RTSTRSPACECORE::uchHeight'
3728	# -wd4365: '=' : conversion from 'unsigned char' to 'char', signed/unsigned mismatch
3729	# -wd4987: nonstandard extension used: 'throw (...)' (setjmp.h + our stuff)
3730	# -wd4710: 'std::string std::_Narrow_str(std::wstring)' : function not inlined
3731	# -wd4061: enumerator 'RTASN1TYPE_END' in switch of enum 'RTASN1TYPE' is not explicitly handled by a case label
3732	# Note! C4062 checks for the same but includes the 'default' case, just like gcc. So, no trouble disabling this.
3733	# -wd4986: 'operator new[]': exception specification does not match previous declaration (crtdbg.h vs new, exception specification only)
3734	# -wd4191: 'type cast' : unsafe conversion from 'int (__cdecl *)(gzFile)' to 'PFNRT'
3735	# -wd4574: 'INCL_WINSOCK_API_TYPEDEFS' is defined to be '0': did you mean to use '#if INCL_WINSOCK_API_TYPEDEFS'?
3736	# -wd4917: 'OLE_XPOS_HIMETRIC' : a GUID can only be associated with a class, interface or namespace
3737	# -wd4711: function 'void __cdecl rtMemCacheFreeOne(struct RTMEMCACHEINT * __ptr64,void * __ptr64)' selected for automatic inline expansion
3738	# -wd4571: Informational: catch(...) semantics changed since Visual C++ 7.1; structured exceptions (SEH) are no longer caught
3739	# -wd4611: interaction between '_setjmp' and C++ object destruction is non-portable
3740	# -wd4324: '_TDI_PNP_CONTEXT_XP' : structure was padded due to __declspec(align())
3741	# -wd4505: VBoxNetFltNobj.h(45) : warning C4505: 'VBoxNetFltNobj::Release' : unreferenced local function has been removed
3742	# Probably related to http://stackoverflow.com/questions/3051992/compiler-warning-at-c-template-base-class
3743	# -wd4263: 'int VRDPChannelClipboard::SendPacket(const void *,uint32_t)' : member function does not override any base class virtual member function
3744	# Probably useful, but impractical, just like the next one.
3745	# -wd4264: 'int VRDPOutputCtx::SendPacket(void)' : no override available for virtual member function from base 'VRDPOutputCtx'; function is hidden
3746	# -wd4738: storing 32-bit float result in memory, possible loss of performance
3747	# -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'
3748	# -wd4748: uiactionpoolmanager.cpp(2723) : warning C4748: /GS can not protect parameters and local variables from local buffer overrun because optimizations are disabled in function
3749	# Want to enable these:
3750	# -wd4242: '=' : conversion from 'uint32_t' to 'uint8_t', possible loss of data
3751	# -wd4244: 'conversion' conversion from 'type1' to 'type2', possible loss of data
3752	# -wd4200: nonstandard extension used : zero-sized array in struct/union
3753	# Cannot generate copy-ctor or copy-assignment operator when UDT contains a zero-sized array
3754	VBOX_VCC_WARN_ALL := -W4 -Wall -wd4065 -wd4996 -wd4127 -wd4706 -wd4201 -wd4214 -wd4510 -wd4512 -wd4610 \
3755	-wd4514 -wd4820 -wd4365 -wd4987 -wd4710 -wd4061 -wd4986 -wd4191 -wd4574 -wd4917 -wd4711 -wd4611 -wd4571 -wd4324 -wd4505 \
3756	-wd4263 -wd4264 -wd4738 -wd4200 -wd4371 -wd4748
3757	if1of ($(VBOX_VCC_TOOL_STEM), VCC120)
3758	# -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()'
3759	# -wd4435: iprt/cpp/xml.h(185) : warning C4435: 'xml::Input' : Object layout under /vd2 will change due to virtual base 'xml::Stream'
3760	VBOX_VCC_WARN_ALL += -wd4350 -wd4435
3761	endif
3762	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
3763	# -wd5045: Compiler will insert Spectre mitigation for memory load if /Qspectre switch specified
3764	# -wd4464: relative include path contains '..' (iprt/nocrt/compiler.msc.h)
3765	# -wd4623: 'VM': default constructor was implicitly defined as deleted
3766	# -wd4625: 'SUPDRVTRACERDATA': copy constructor was implicitly defined as deleted
3767	# -wd4626: 'SUPDRVTRACERDATA': assignment operator was implicitly defined as deleted
3768	# -wd5026: 'SUPDRVTRACERDATA': move constructor was implicitly defined as deleted
3769	# -wd5027: 'SUPDRVTRACERDATA': move assignment operator was implicitly defined as deleted
3770	# -wd4435: 'xml::Input': Object layout under /vd2 will change due to virtual base 'xml::Stream'
3771	# -wd4577: 'noexcept' used with no exception handling mode specified; termination on exception is not guaranteed. Specify /EHsc
3772	VBOX_VCC_WARN_ALL += -wd5045 -wd4464 -wd4623 -wd4625 -wd4626 -wd5026 -wd5027 -wd4435 -wd4577
3773	endif
3774	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # With v16.11.9, not with v16.6.0 4242
3775	# -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
3776	VBOX_VCC_WARN_ALL += -wd5220
3777	# Temporarily:
3778	# -wd4242: asn1-ut-string.cpp(729): warning C4242: 'argument': conversion from 'uint32_t' to 'uint16_t', possibl loss of data
3779	# -wd4244: asn1-ut-objid.cpp(124): warning C4244: '=': conversion from 'uint32_t' to 'uint8_t', possible loss of data
3780	VBOX_VCC_WARN_ALL += -wd4242 -wd4244
3781	if1of (RT_RELAXED_CALLBACKS_TYPES,$(DEFS))
3782	# -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.
3783	VBOX_VCC_WARN_ALL += -wd5039
3784	endif
3785	endif
3786	# -wd4548: socket.cpp(1931): warning C4548: expression before comma has no effect; expected expression with side-effect
3787	VBOX_VCC_WARN_ALL += -wd4548
3788	ifndef VBOX_WITH_NEW_WINDOWS_SDK
3789	# -wd5031: iprt/win/windows.h(55): warning C5031: #pragma warning(pop): likely mismatch, popping warning state pushed in different file
3790	# -wd5032: iprt/win/windows.h(37): warning C5032: detected #pragma warning(push) with no corresponding #pragma warning(pop)
3791	VBOX_VCC_WARN_ALL += -wd5031 -wd5032
3792	endif
3793	ifndef VBOX_NEWER_VCC_WARN_ALL
3794	if "$(VBOX_VCC_TOOL_STEM)" < "VCC120"
3795	VBOX_NEWER_VCC_WARN_ALL := $(VBOX_VCC_WARN_ALL) -wd4350 -wd4435
3796	else
3797	VBOX_NEWER_VCC_WARN_ALL := $(VBOX_VCC_WARN_ALL)
3798	endif
3799	endif
3800
3801
3802	# Disable pedantic warnings for NP/NonPedantic templates.
3803	# -wd4131: 'bi_flush' : uses old-style declarator
3804	# -wd4255: 'tr_static_init' : no function prototype given: converting '()' to '(void)'
3805	# -wd4668: '_WIN32_WCE' is not defined as a preprocessor macro, replacing with '0' for '#if/#elif'/
3806	# -wd4100: 'cinfo' : unreferenced formal parameter
3807	# -wd4189: 'sz' : local variable is initialized but not referenced
3808	# -wd4132: 'xmlStringComment' : const object should be initialized
3809	# -wd4152: nonstandard extension, function/data pointer conversion in expression
3810	# -wd4702: unreachable code
3811	# -wd4057: '=' : 'xmlChar ' differs in indirection to slightly different base types from 'char '
3812	# -wd4296: '>=' : expression is always true
3813	# -wd4389: '==' : signed/unsigned mismatch
3814	# -wd4018: '<=' : signed/unsigned mismatch
3815	# -wd4245: '=' : conversion from 'int' to 'unsigned int', signed/unsigned mismatch
3816	# -wd4267: '+=' : conversion from 'size_t' to 'long', possible loss of data
3817	# -wd4295: 'vendor_string' : array is too small to include a terminating null character
3818	VBOX_VCC_NON_PEDANTIC = -wd4131 -wd4255 -wd4668 -wd4100 -wd4189 -wd4132 -wd4152 -wd4702 -wd4057 -wd4296 -wd4389 -wd4018 -wd4245 \
3819	-wd4267 -wd4295
3820	VBOX_NEWER_VCC_NON_PEDANTIC = $(VBOX_VCC_NON_PEDANTIC)
3821
3822	ifeq ($(KBUILD_TARGET),win)
3823	VBOX_C_CXX_FLAGS_NO_UNUSED_PARAMETERS = -wd4100
3824	else
3825	VBOX_C_CXX_FLAGS_NO_UNUSED_PARAMETERS = -Wno-unused-parameter
3826	endif
3827
3828	#
3829	# Version dependent Visual C++ stuff.
3830	#
3831	if1of (win, $(KBUILD_TARGET) $(KBUILD_HOST))
3832	ifn1of ($(VBOX_VCC_TOOL_STEM), VCC100 VCC110 VCC120)
3833	ifndef VBOX_WITHOUT_CONTROL_FLOW_GUARD
3834	VBOX_VCC_CC_GUARD_CF = -guard:cf
3835	VBOX_VCC_LD_GUARD_CF = -Guard:CF
3836	else
3837	VBOX_VCC_CC_GUARD_CF =
3838	VBOX_VCC_LD_GUARD_CF =
3839	endif
3840	VBOX_VCC_LD_HIGH_ENTRYOPY_VA = /HighEntropyVA
3841	else
3842	VBOX_VCC_CC_GUARD_CF =
3843	VBOX_VCC_LD_GUARD_CF =
3844	VBOX_VCC_LD_HIGH_ENTRYOPY_VA =
3845	endif
3846	ifn1of ((VBOX_VCC_TOOL_STEM), VCC100 VCC110 VCC120 VCC140 VCC141)
3847	# 16.7 and later, so not in our linker yet.
3848	## @todo BUGBUG! Update VCC before 7.0 is released.
3849	#VBOX_VCC_LD_CET_COMPAT = /CetCompat
3850	VBOX_VCC_LD_CET_COMPAT =
3851	else
3852	VBOX_VCC_LD_CET_COMPAT =
3853	endif
3854	endif
3855
3856	#
3857	# Compiler optimization flags.
3858	#
3859	ifeq ($(KBUILD_TYPE),debug)
3860	VBOX_GCC_FP ?= -fno-omit-frame-pointer
3861	VBOX_GCC_OPT ?= -O0
3862	VBOX_VCC_FP ?= -Oy-
3863	VBOX_VCC_OPT ?=
3864	VBOX_GCC_R0_FP ?= -fno-omit-frame-pointer -fno-optimize-sibling-calls
3865	VBOX_GCC_R0_OPT ?= -O2
3866	VBOX_VCC_R0_FP ?= -Oy-
3867	VBOX_VCC_R0_OPT ?=
3868	VBOX_GCC_GC_FP ?= -fno-omit-frame-pointer -fno-optimize-sibling-calls
3869	VBOX_GCC_GC_OPT ?= -O2
3870	VBOX_VCC_GC_FP ?= -Oy-
3871	VBOX_VCC_GC_OPT ?=
3872	else
3873	# We should use -fomit-frame-pointer for GCC / -Oy for VCC.
3874	# -funwind-tables provides support for backtraces in gdb then.
3875	VBOX_GCC_FP ?= -fno-omit-frame-pointer
3876	VBOX_GCC_OPT ?= -O2 $(VBOX_GCC_mtune-generic)
3877	VBOX_VCC_FP ?= -Oy-
3878	VBOX_VCC_OPT ?= -O2
3879	VBOX_GCC_R0_FP ?= -fno-omit-frame-pointer
3880	VBOX_GCC_R0_OPT ?= -O2 $(VBOX_GCC_mtune-generic)
3881	VBOX_VCC_R0_FP ?= -Oy-
3882	VBOX_VCC_R0_OPT ?= -O2
3883	VBOX_GCC_GC_FP ?= -fno-omit-frame-pointer
3884	VBOX_GCC_GC_OPT ?= -O2 $(VBOX_GCC_mtune-generic)
3885	VBOX_VCC_GC_FP ?= -Oy-
3886	VBOX_VCC_GC_OPT ?= -O2
3887	endif
3888	ifeq ($(KBUILD_TARGET_ARCH),x86)
3889	ifneq ($(KBUILD_TARGET),darwin)
3890	# (The '<=' operator is for prepending (kmk specific).)
3891	VBOX_GCC_OPT <= -march=i586
3892	endif
3893	endif
3894
3895
3896	#
3897	# Select the CRT type we're using with Microsoft Visual C++.
3898	#
3899	if1of ($(KBUILD_TYPE), debug dbgopt strict)
3900	#not yet# VBOX_WITH_DEBUG_VCC_CRT = 1
3901	endif
3902	ifdef VBOX_WITH_DEBUG_VCC_CRT
3903	VBOX_VCC_CRT_TYPE := d
3904	VBOX_VCC_CRT_TYPE_UPPER := D
3905	VBOX_VCC_CRT_TYPE_N :=
3906	else
3907	VBOX_VCC_CRT_TYPE :=
3908	VBOX_VCC_CRT_TYPE_UPPER :=
3909	VBOX_VCC_CRT_TYPE_N := d
3910	endif
3911
3912	#
3913	# Select whether wchar_t is a native compiler defined type or not with
3914	# Microsoft Visual C++. We've been avoiding the native type for ever,
3915	# but now that is causing issues with Qt 6.x.
3916	#
3917	ifndef VBOX_WITH_QT6
3918	VBOX_VCC_WCHAR_T_VARIANT = -Zc:wchar_t-
3919	else
3920	VBOX_VCC_WCHAR_T_VARIANT = -Zc:wchar_t
3921	endif
3922
3923
3924	#
3925	# Warnings as errors.
3926	#
3927	# GCC: We disable warnings on non-X86 systems because of the variadic
3928	# macro usage in the logger.
3929	#
3930	ifdef VBOX_WITH_WARNINGS_AS_ERRORS
3931	if $(VBOX_GCC_VERSION_CXX) >= 40000
3932	VBOX_GCC_WERR ?= -Werror
3933	endif
3934	VBOX_VCC_WERR ?= -WX
3935	VBOX_VCC_LD_WERR ?= ## @todo later also: -WX
3936	endif
3937
3938	#
3939	# The general GCC/Clang no warning policy.
3940	#
3941	# Note! This doesn't control everything. Instead set VBOX_GCC_WERR=$(NO_SUCH_VARIABLE) to
3942	# completely disable -Werror.
3943	#
3944	if !defined(VBOX_WITHOUT_NO_GCC_WARNING_POLICY) && !defined(VBOX_WITH_NO_GCC_WARNING_POLICY)
3945	if defined(VBOX_WITH_MASOCHISTIC_WARNINGS) # gcc 4.6.x+
3946	VBOX_WITH_NO_GCC_WARNING_POLICY = 1
3947	else if "$(KBUILD_TARGET)" == "darwin"
3948	ifn1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO)
3949	VBOX_WITH_NO_GCC_WARNING_POLICY = 1
3950	endif
3951	else if1of ($(KBUILD_TARGET), linux)
3952	if $(VBOX_GCC_VERSION_CXX) >= 40600 # gcc 4.6.x+
3953	VBOX_WITH_NO_GCC_WARNING_POLICY = 1
3954	endif
3955	endif
3956	endif
3957	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
3958	$(info build debug: VBOX_WITH_NO_GCC_WARNING_POLICY is enabled)
3959	endif
3960
3961	#
3962	# Misc stuff that should be after including DynamicConfig.kmk.
3963	#
3964
3965	# libxml XML linter.
3966	ifeq ($(VBOX_XMLLINT),)
3967	ifeq ($(KBUILD_HOST),win)
3968	VBOX_XMLLINT := $(wildcard $(KBUILD_DEVTOOLS)/$(KBUILD_HOST).$(KBUILD_HOST_ARCH)/libxslt/10128/bin/xmllint.exe)
3969	endif
3970	ifeq ($(VBOX_XMLLINT),)
3971	VBOX_XMLLINT := $(VBOX_HAVE_XMLLINT)
3972	endif
3973	ifneq ($(VBOX_XMLLINT),)
3974	VBOX_HAVE_XMLLINT := 1
3975	else
3976	VBOX_XMLLINT := xmllint
3977	VBOX_HAVE_XMLLINT :=
3978	endif
3979	else
3980	VBOX_HAVE_XMLLINT := 1
3981	endif
3982
3983	# Older versions of GCC cannot compile libssh, so disable it and the feature if that's the case.
3984	ifn1of ($(KBUILD_TARGET), darwin win)
3985	if $(VBOX_GCC_VERSION_CC) < 50000
3986	VBOX_WITH_LIBSSH :=
3987	VBOX_WITH_CLOUD_NET :=
3988	endif
3989	endif
3990
3991
3992	#
3993	# Misc macros.
3994	#
3995
3996	##
3997	# Edits VirtualBox version, vendor and package strings in a text file.
3998	#
3999	# The rule using this must list $(VBOX_SVN_REV_KMK) as a prerequisite.
4000	#
4001	# @param 1 The input filename.
4002	# @param 2 The output filename.
4003	#
4004	VBOX_EDIT_VERSION_CMD_FN = $(SED) \
4005	-e 's+@VBOX_VERSION_MAJOR@+$(VBOX_VERSION_MAJOR)+g' \
4006	-e 's+@VBOX_VERSION_MINOR@+$(VBOX_VERSION_MINOR)+g' \
4007	-e 's+@VBOX_VERSION_BUILD@+$(VBOX_VERSION_BUILD)+g' \
4008	-e 's+@VBOX_VERSION_STRING@+$(VBOX_VERSION_STRING)+g' \
4009	-e 's+@VBOX_SVN_REV@+$(VBOX_SVN_REV)+g' \
4010	-e 's+@VBOX_VENDOR@+$(VBOX_VENDOR)+g' \
4011	-e 's+@VBOX_VENDOR_SHORT@+$(VBOX_VENDOR_SHORT)+g' \
4012	-e 's+@VBOX_PRODUCT@+$(VBOX_PRODUCT)+g' \
4013	-e 's+@VBOX_C_YEAR@+$(VBOX_C_YEAR)+g' \
4014	-e 's+@VBOX_PACKAGE_STRING@+$(VBOX_PACKAGE_STRING)+g' \
4015	--output $(2) $(1)
4016
4017	##
4018	# Generates a rule for editing a file using VBOX_EDIT_VERSION_CMD_FN.
4019	#
4020	# @param 1 The target name.
4021	# @param 2 The input filename relative to the current sub-makefile.
4022	# @param 3 The output filename relative to the target output dir.
4023	# Optional, defaults to 2.
4024	#
4025	VBOX_EDIT_VERSION_RULE_FN = $(eval $(value VBOX_EDIT_VERSION_RULE_DEF))
4026	define VBOX_EDIT_VERSION_RULE_DEF
4027	$$($(1)_0_OUTDIR)/$(if $(3),$(3),$(2)): $(PATH_SUB_CURRENT)/$(2) $(VBOX_SVN_REV_KMK) \| $$(dir $$@)
4028	$(call MSG_GENERATE,$(1),$@,$<)
4029	$(QUIET)$(call VBOX_EDIT_VERSION_CMD_FN,$<,$@)
4030	$(eval $(1)_CLEAN += $$($(1)_0_OUTDIR)/$(if $(3),$(3),$(2)))
4031	endef
4032
4033
4034	##
4035	# Edits VirtualBox version, vendor, package, build target, build arch, and build type strings in a text file.
4036	#
4037	# Please use VBOX_EDIT_VERSION_AND_BUILD_RULE_FN to generate edit rule.
4038	#
4039	# @param 1 The input filename.
4040	# @param 2 The output filename.
4041	#
4042	VBOX_EDIT_VERSION_AND_BUILD_CMD_FN = $(SED) \
4043	-e 's+@VBOX_VERSION_MAJOR@+$(VBOX_VERSION_MAJOR)+g' \
4044	-e 's+@VBOX_VERSION_MINOR@+$(VBOX_VERSION_MINOR)+g' \
4045	-e 's+@VBOX_VERSION_BUILD@+$(VBOX_VERSION_BUILD)+g' \
4046	-e 's+@VBOX_VERSION_STRING@+$(VBOX_VERSION_STRING)+g' \
4047	-e 's+@VBOX_SVN_REV@+$(VBOX_SVN_REV)+g' \
4048	-e 's+@VBOX_VENDOR@+$(VBOX_VENDOR)+g' \
4049	-e 's+@VBOX_VENDOR_SHORT@+$(VBOX_VENDOR_SHORT)+g' \
4050	-e 's+@VBOX_PRODUCT@+$(VBOX_PRODUCT)+g' \
4051	-e 's+@VBOX_C_YEAR@+$(VBOX_C_YEAR)+g' \
4052	-e 's+@VBOX_PACKAGE_STRING@+$(VBOX_PACKAGE_STRING)+g' \
4053	-e 's+@KBUILD_TYPE@+$(KBUILD_TYPE)+g' \
4054	-e 's+@KBUILD_TARGET@+$(KBUILD_TARGET)+g' \
4055	-e 's+@KBUILD_TARGET_ARCH@+$(KBUILD_TARGET_ARCH)+g' \
4056	--output $(2) $(1)
4057
4058	##
4059	# Generates a rule for editing a file using VBOX_EDIT_VERSION_CMD_FN.
4060	#
4061	# @param 1 The target name.
4062	# @param 2 The input filename relative to the current sub-makefile.
4063	# @param 3 The output filename relative to the target output dir.
4064	# Optional, defaults to 2.
4065	#
4066	VBOX_EDIT_VERSION_AND_BUILD_RULE_FN = $(eval $(VBOX_EDIT_VERSION_AND_BUILD_RULE_DEF))
4067	define VBOX_EDIT_VERSION_AND_BUILD_RULE_DEF
4068	$$$$($(1)_0_OUTDIR)/$(if $(3),$(3),$(2)): $$(PATH_SUB_CURRENT)/$(2) $$(VBOX_SVN_REV_KMK) \| $$$$(dir $$$$@)
4069	$$(call MSG_GENERATE,$(1),$$@,$$<)
4070	$$(QUIET)$$(call VBOX_EDIT_VERSION_AND_BUILD_CMD_FN,$$<,$$@)
4071	$(1)_CLEAN += $$($(1)_0_OUTDIR)/$(if $(3),$(3),$(2))
4072	endef
4073
4074
4075	##
4076	# Fill in am import library target based on a somewhat special windows .def file.
4077	#
4078	# @param 1 The target name of the import library.
4079	# @param 2 The name of the real library.
4080	# @param 3 The .def-file paths relative to the current makefile.
4081	#
4082	VBOX_GENERATE_IMPORT_TARGET_FN = $(eval $(VBOX_GENERATE_IMPORT_TARGET_DEF))
4083	define VBOX_GENERATE_IMPORT_TARGET_DEF
4084	$(1)_TEMPLATE = VBoxR3Dll
4085	$(1)_INST = $(INST_LIB)
4086	if $(KBUILD_TARGET) == "darwin"
4087	$(1)_LDFLAGS = -install_name $(VBOX_DYLD_EXECUTABLE_PATH)/$(2)$(SUFF_DLL)
4088	else ifn1of ($(KBUILD_TARGET), os2 win)
4089	$(1)_SONAME = $(2)$(SUFF_DLL)
4090	endif
4091	if1of ($(KBUILD_TARGET), os2 win)
4092	$(1)_SOURCES = $$($(1)_0_OUTDIR)/$(1)Imp.def
4093	$(1)_CLEAN = $$($(1)_0_OUTDIR)/$(1)Imp.def
4094	else
4095	$(1)_SOURCES = $$($(1)_0_OUTDIR)/$(1)Imp.c
4096	$(1)_CLEAN = $$($(1)_0_OUTDIR)/$(1)Imp.c
4097	endif
4098
4099	$$$$($(1)_SOURCES): $(addprefix $(PATH_SUB_CURRENT)/,$(3)) $(PATH_ROOT)/src/bldprogs/deftoimp.sed \| $$$$(dir $$$$@)
4100	$$(call MSG_GENERATE,,$$@)
4101	ifeq ($(KBUILD_TARGET),os2)
4102	$$(SED) \
4103	-e '/not-$(KBUILD_TARGET)/d' \
4104	-e '/not-$(KBUILD_TARGET_ARCH)/d' \
4105	-e 's/^LIBRARY[[:space:]][[:space:]]$.$\.dll/LIBRARY \1 INITINSTANCE TERMINSTANCE\nDATA MULTIPLE\n/' \
4106	-e 's/^[ \t][ \t]*$[_a-zA-Z]$/ _\1/' \
4107	-e 's/[ \t]DATA[ \t]*/ /' \
4108	--output $$@ $(addprefix $(PATH_SUB_CURRENT)/,$(3))
4109	else ifeq ($(KBUILD_TARGET),win)
4110	$$(SED) \
4111	-e '/not-$(KBUILD_TARGET)/d' \
4112	-e '/not-$(KBUILD_TARGET_ARCH)/d' \
4113	--output $$@ $(addprefix $(PATH_SUB_CURRENT)/,$(3))
4114	else
4115	$$(QUIET)$$(APPEND) -tn $$@ \
4116	'#ifdef VBOX_HAVE_VISIBILITY_HIDDEN' \
4117	'# define EXPORT __attribute__((visibility("default")))' \
4118	'# define EXPORT_DATA __attribute__((visibility("default")))' \
4119	'#else' \
4120	'# define EXPORT' \
4121	'# define EXPORT_DATA' \
4122	'#endif' \
4123	''
4124	$$(SED) \
4125	-e '/not-$(KBUILD_TARGET)/d' \
4126	-e '/not-$(KBUILD_TARGET_ARCH)/d' \
4127	-f $(PATH_ROOT)/src/bldprogs/deftoimp.sed \
4128	--append $$@ $(addprefix $(PATH_SUB_CURRENT)/,$(3))
4129	endif
4130	endef # VBOX_GENERATE_IMPORT_TARGET_DEF
4131
4132
4133	## VBOX_UTF8_MANIFEST_CMDS
4134	# Wrapper around VBOX_UTF8_MANIFEST_FN that makes sure it's an EXE link target,
4135	# as this UTF-8 manifest doesn't make sense for non-executables.
4136	ifn1of ($(VBOX_VCC_TOOL_STEM), VCC100 VCC110 VCC120)
4137	## VBOX_UTF8_MANIFEST_FN
4138	# Adds a manifest resource with ID 1 that tells windows 10 1903 and later to
4139	# use UTF-8 for the ANSI and OEM code pages. We only do this when using UCRT
4140	# as the VCC100 CRT typically ends up with its internal code page not being
4141	# CP_UTF8 but the default codepage for the locale.
4142	#
4143	# @param 1 the output filename.
4144	# @param 2 the architecture (required for xp rtm)
4145	#
4146	VBOX_UTF8_MANIFEST_FN = \
4147	$(QUIET)$(APPEND) -tn "$(1).manifest" \
4148	'<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' \
4149	'<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">' \
4150	' <assemblyIdentity type="win32" name="$(notdir $(1))" processorArchitecture="$(2)" version="$(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD).$(expr $(VBOX_SVN_REV) % 50000)" />' \
4151	' <asmv3:application>' \
4152	' <asmv3:windowsSettings>' \
4153	' <activeCodePage xmlns="http://schemas.microsoft.com/SMI/2019/WindowsSettings">UTF-8</activeCodePage>' \
4154	' </asmv3:windowsSettings>' \
4155	' </asmv3:application>' \
4156	'</assembly>' \
4157	$(NLTAB)$(QUIET)$(REDIRECT) -- $(WINCMN_MT_RETRY) $(requote sh,$(PATH_SDK_$(VBOX_WINPSDK)_BIN)/mt.exe) \
4158	-nologo -manifest '$(subst /,\,$(1).manifest)' '-outputresource:$(subst /,\,$(1));$(HASH)1' \
4159	$(NLTAB)$(QUIET)$(RM) -f -- "$(1).manifest"
4160	VBOX_UTF8_MANIFEST_CMDS ?= $(if-expr "$(tool_do)" == "LINK_PROGRAM",$(call VBOX_UTF8_MANIFEST_FN,$(out),$(bld_trg_arch)),)
4161	else
4162	VBOX_UTF8_MANIFEST_CMDS =
4163	endif
4164
4165
4166	#
4167	# Code Signing.
4168	#
4169	# There are two signing modes; 'test' and 'release'.
4170	# - The 'test' mode is tailored local development, where typically test
4171	# certificates are involved. Only the bar minimum of files are signed and
4172	# nothing is timestamped (if we can control timestamping) in order to reduce
4173	# build time and to allow working offline.
4174	# - The 'release' mode is tailored for creating builds that are give to other
4175	# people, like the ones the build servers create. As much as possible is
4176	# signed and timestamped.
4177	# - The 'adhoc' mode is specific to building on macOS and is similar to 'test'
4178	# mode but doesn't require any certificates but a host set up for development work.
4179	# Binaries are signed in adhoc mode and include required entitlements as appropriate
4180	# (something we would only do in the 'packing' target). This seem to be the only working
4181	# way with newer versions of macOS (tested with Ventura) with 'test' not working anymore.
4182	#
4183	ifdef VBOX_SIGNING_MODE
4184	VBOX_SIGNING_MODE := $(strip $(VBOX_SIGNING_MODE))
4185	ifn1of ($(VBOX_SIGNING_MODE), test release adhoc)
4186	$(error VBOX_SIGNING_MODE must be either 'test', 'release' or 'adhoc'. The value '$(VBOX_SIGNING_MODE)' is not recognized.)
4187	endif
4188	if "$(VBOX_SIGNING_MODE)" == "adhoc" && "$(KBUILD_TARGET)" != "darwin"
4189	$(error 'adhoc' signing mode is only available on macOS)
4190	endif
4191	VBOX_RETRY ?= $(ASH) $(KBUILD_DEVTOOLS)/bin/retry.sh
4192	# temporary solution for a $(dir ...) equivalent which assumes that it gets a single path, possibly with spaces.
4193	VBOX_DIRX = $(subst ?,$(SP),$(dir $(subst $(SP),?,$1)))
4194	# Corp code signing client.
4195	VBOX_CCS_CLIENT_JAR := $(firstword $(rsort \
4196	$(wildcard $(KBUILD_DEVTOOLS)/common/ccs/v*/Client.jar)) \
4197	$(KBUILD_DEVTOOLS)/common/ccs/notfound/Client.jar )
4198	VBOX_CCS_USER ?= virtualbox_grp
4199	VBOX_CCS_GLOBAL_UID ?= non-of-your-business
4200	VBOX_CCS_SERVER ?= UK
4201	##
4202	# Corp Code Signing command line.
4203	# @param $1 Signing method: solaris_elf, solaris_pkg, driver (microsoft), ...
4204	# @param $2 The file to be submitted for signing.
4205	# @param $3 The directory to put the signed file in. Defaults to $(dir $2).
4206	# @param $4 Additional options.
4207	VBOX_CCS_SIGN_CMD = $(VBOX_RETRY) $(VBOX_JAVA) -jar "$(VBOX_CCS_CLIENT_JAR)" \
4208	sign -user "$(VBOX_CCS_USER)" -global_uid "$(VBOX_CCS_GLOBAL_UID)" \
4209	-job_timeout 90 -server_timeout 75 -server "$(VBOX_CCS_SERVER)" \
4210	-sign_method "$1" -file_to_sign "$2" -signed_location "$(if $3,$3,$(call VBOX_DIRX,$2))" $4
4211
4212	ifeq ($(KBUILD_HOST),win)
4213	#
4214	# Windows
4215	#
4216
4217	# VBOX_PATH_SELFSIGN points to the Vista WDK bin/SelfSign directory.
4218	ifndef VBOX_PATH_SELFSIGN
4219	VBOX_PATH_SELFSIGN := $(firstword $(rsort $(wildcard $(KBUILD_DEVTOOLS)/win.x86/selfsign/*)))
4220	ifeq ($(VBOX_PATH_SELFSIGN),)
4221	VBOX_PATH_SELFSIGN := $(KBUILD_DEVTOOLS)/win.x86/selfsign/r1
4222	endif
4223	endif
4224	ifndef VBOX_PATH_SIGN_TOOLS
4225	ifdef VBOX_WITH_NEW_WINDOWS_SDK
4226	VBOX_PATH_SIGN_TOOLS = $(PATH_SDK_$(VBOX_WINPSDK)_BIN)
4227	else
4228	VBOX_PATH_SIGN_TOOLS := $(firstword $(rsort $(wildcard \
4229	$(addprefix $(KBUILD_DEVTOOLS)/win.x86/sdk/v8.1*/Bin/, x86 $(if-expr $(KBUILD_HOST_ARCH)=="amd64",x64,) ) )))
4230	ifeq ($(VBOX_PATH_SIGN_TOOLS),)
4231	VBOX_PATH_SIGN_TOOLS := $(firstword $(rsort $(wildcard \
4232	$(addprefix $(KBUILD_DEVTOOLS)/win.x86/sdk/v10*/Bin/, x86 $(if-expr $(KBUILD_HOST_ARCH)=="amd64",x64,) ) )))
4233	ifeq ($(VBOX_PATH_SIGN_TOOLS),)
4234	VBOX_PATH_SIGN_TOOLS := $(VBOX_PATH_SELFSIGN)
4235	endif
4236	endif
4237	endif
4238	endif
4239
4240	VBOX_SIGNTOOL ?= $(VBOX_RETRY) "$(VBOX_PATH_SIGN_TOOLS)/signtool.exe"
4241	VBOX_SIGNTOOL_SHA1 ?= $(VBOX_SIGNTOOL)
4242	VBOX_SIGNTOOL_SHA1_ORDERDEPS ?=
4243	VBOX_SIGNTOOL_SHA2 ?= $(VBOX_SIGNTOOL)
4244	VBOX_SIGNTOOL_SHA2_ORDERDEPS ?=
4245	VBOX_SIGNTOOL_ORDERDEPS ?= $(VBOX_SIGNTOOL_SHA1_ORDERDEPS) $(VBOX_SIGNTOOL_SHA2_ORDERDEPS)
4246	VBOX_INF2CAT ?= $(VBOX_PATH_SELFSIGN)/inf2cat.exe
4247
4248	ifeq ($(VBOX_SIGNING_MODE),test)
4249	VBOX_CERTIFICATE_SUBJECT_NAME ?= MyTestCertificate
4250	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_SUBJECT_NAME)"
4251	else # release
4252	VBOX_CERTIFICATE_SUBJECT_NAME ?= VirtualBox 2022
4253	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_SUBJECT_NAME)" /a
4254	#VBOX_CERTIFICATE_FINGERPRINT ?= 7e 92 b6 6b e5 1b 79 d8 ce 3f f2 5c 15 c2 df 6a b8 c7 f2 f2
4255	#VBOX_CERTIFICATE_FINGERPRINT ?= 5b de fe 58 0a 81 66 61 cd b5 7a 57 10 7b f4 18 74 86 ef cc
4256	#VBOX_CERTIFICATE_FINGERPRINT ?= 6f 47 42 06 bc bb 39 1b b8 2b a9 e5 dc 03 02 de f3 7a eb be
4257	VBOX_CERTIFICATE_FINGERPRINT ?= 5f 0b fe c5 53 17 c1 25 5a a4 7f cd bc 49 a2 fb 61 09 03 cc
4258	#VBOX_CROSS_CERTIFICATE_FILE ?= $(VBOX_PATH_SELFSIGN)/VeriSign Class 3 Public Primary Certification Authority - G5.cer
4259	#VBOX_CROSS_CERTIFICATE_FILE ?= $(VBOX_PATH_SELFSIGN)/DigiCert Assured ID Root CA.crt
4260	#VBOX_TSA_URL ?= http://timestamp.verisign.com/scripts/timstamp.dll - Appears to be broken between 2020-12-25 and 2020-12-30 (bugref:9849).
4261	VBOX_TSA_URL ?= http://timestamp.digicert.com
4262	endif
4263	if !defined(VBOX_CROSS_CERTIFICATE_FILE_ARGS) && defined(VBOX_CROSS_CERTIFICATE_FILE)
4264	VBOX_CROSS_CERTIFICATE_FILE_ARGS = /ac "$(VBOX_CROSS_CERTIFICATE_FILE)"
4265	endif
4266	if !defined(VBOX_TSA_URL_ARGS) && defined(VBOX_TSA_URL)
4267	VBOX_TSA_URL_ARGS = /t "$(VBOX_TSA_URL)"
4268	endif
4269	VBOX_CERTIFICATE_STORE ?= my
4270	VBOX_CERTIFICATE_STORE_ARGS ?= /s "$(VBOX_CERTIFICATE_STORE)"
4271	VBOX_CERTIFICATE_FINGERPRINT_ARGS := $(if-expr "$(VBOX_CERTIFICATE_FINGERPRINT)" != "" \
4272	,/sha1 "$(subst $(SP),,$(VBOX_CERTIFICATE_FINGERPRINT))",)
4273
4274	ifeq ($(VBOX_SIGNING_MODE),test)
4275	#VBOX_CERTIFICATE_SHA2_SUBJECT_NAME ?= MyTestCertificateSha2
4276	VBOX_CERTIFICATE_SHA2_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_SHA2_SUBJECT_NAME)"
4277	else # release
4278	VBOX_CERTIFICATE_SHA2_SUBJECT_NAME ?= Oracle Corporation
4279	VBOX_CERTIFICATE_SHA2_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_SHA2_SUBJECT_NAME)" /a
4280	#VBOX_CERTIFICATE_SHA2_FINGERPRINT ?= 31 31 bb 58 8b 19 9e 6e 85 0f d3 35 82 b0 c5 82 55 e1 6c 49
4281	#VBOX_CERTIFICATE_SHA2_FINGERPRINT ?= 22 05 6a 4d 46 2e 3d 2b b2 c3 2f bf b0 5b 84 c4 65 9c f7 fe
4282	#VBOX_CERTIFICATE_SHA2_FINGERPRINT ?= 17 3a 19 bf 8e 62 72 be 25 04 d3 08 aa 68 b1 b0 0e 03 33 2c
4283	VBOX_CERTIFICATE_SHA2_FINGERPRINT ?= 30 65 6f ca 8c 48 b1 d9 86 23 a9 4b 40 a6 bc 98 bd 87 bf ad
4284	VBOX_CROSS_CERTIFICATE_SHA2_FILE ?= $(VBOX_PATH_SELFSIGN)/DigiCert Assured ID Root CA.crt
4285	#VBOX_TSA_SHA2_URL ?= http://sha256timestamp.ws.symantec.com/sha256/timestamp - phase out for consistency reasons
4286	VBOX_TSA_SHA2_URL ?= http://timestamp.digicert.com
4287	endif
4288	if !defined(VBOX_CROSS_CERTIFICATE_SHA2_FILE_ARGS) && defined(VBOX_CROSS_CERTIFICATE_SHA2_FILE)
4289	VBOX_CROSS_CERTIFICATE_SHA2_FILE_ARGS = /ac "$(VBOX_CROSS_CERTIFICATE_SHA2_FILE)"
4290	endif
4291	if !defined(VBOX_TSA_SHA2_URL_ARGS) && defined(VBOX_TSA_SHA2_URL)
4292	VBOX_TSA_SHA2_URL_ARGS = /tr "$(VBOX_TSA_SHA2_URL)" /td SHA256
4293	endif
4294	VBOX_CERTIFICATE_SHA2_STORE ?= my
4295	VBOX_CERTIFICATE_SHA2_STORE_ARGS ?= /s "$(VBOX_CERTIFICATE_SHA2_STORE)"
4296	VBOX_CERTIFICATE_SHA2_FINGERPRINT_ARGS := $(if-expr "$(VBOX_CERTIFICATE_SHA2_FINGERPRINT)" != "" \
4297	,/sha1 "$(subst $(SP),,$(VBOX_CERTIFICATE_SHA2_FINGERPRINT))",) # Still using SHA-1 for fingerprinting, it's good enough for that!
4298	#VBOX_CERTIFICATE_EV_SUBJECT_NAME ?= MyEvCertificate
4299	VBOX_CERTIFICATE_EV_SUBJECT_NAME_ARGS ?= /n "$(VBOX_CERTIFICATE_EV_SUBJECT_NAME)"
4300	VBOX_CERTIFICATE_EV_STORE ?= my
4301	VBOX_CERTIFICATE_EV_STORE_ARGS ?= /s "$(VBOX_CERTIFICATE_EV_STORE)"
4302	#VBOX_CERTIFICATE_EV_FINGERPRINT ?= my ev cert fingerprint
4303	VBOX_CERTIFICATE_EV_FINGERPRINT_ARGS := $(if-expr "$(VBOX_CERTIFICATE_EV_FINGERPRINT)" != "" \
4304	,/sha1 "$(subst $(SP),,$(VBOX_CERTIFICATE_EV_FINGERPRINT))",) # Still using SHA-1 for fingerprinting, it's good enough for that!
4305
4306	## Sign a file (generic).
4307	# @param 1 The file to sign.
4308	# @param 2 File description. Optional.
4309	# @param 3 Additional parameters. Optional.
4310	# @param 4 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4311	# @param 5 Disables dual signing if non-empty, picking the SHA2 signature (since 2022-07-18).
4312	# @param 6 non-zero for alternative command separator. This is used for generating repacking scripts.
4313	ifndef VBOX_SIGN_FILE_FN
4314	if $(intersects win all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4315	VBOX_SIGN_FILE_FN = $(call VBOX_CCS_SIGN_CMD,driver$(if-expr "$3" == "/ph",_pagehash,),$1,,-digest_algo $(if-expr "$5" == "",SHA1,SHA2)) \
4316	$(if-expr "$5" == "", \
4317	$(if-expr "$6" == "",$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB)),$6) \
4318	$(call VBOX_CCS_SIGN_CMD,driver$(if-expr "$3" == "/ph",_pagehash,),$1,,-dual_sign -digest_algo SHA2))
4319	else ifdef VBOX_CERTIFICATE_SHA2_SUBJECT_NAME
4320	ifdef VBOX_CERTIFICATE_SUBJECT_NAME
4321	VBOX_SIGN_FILE_FN = $(if-expr "$5" == "",$(VBOX_SIGNTOOL_SHA1) \
4322	sign /fd sha1 \
4323	$(VBOX_CROSS_CERTIFICATE_FILE_ARGS) \
4324	$(VBOX_CERTIFICATE_STORE_ARGS) \
4325	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4326	$(VBOX_CERTIFICATE_FINGERPRINT_ARGS) \
4327	$(VBOX_TSA_URL_ARGS) \
4328	$(if $(strip $(2)),/d "$(strip $(2))",) \
4329	$(3) \
4330	"$(1)" \
4331	$(if-expr "$6" == "",$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB)),$6))$(VBOX_SIGNTOOL_SHA2) \
4332	sign $(if-expr "$5" == "",/as,) /fd sha256 \
4333	$(VBOX_CROSS_CERTIFICATE_SHA2_FILE_ARGS) \
4334	$(VBOX_CERTIFICATE_SHA2_STORE_ARGS) \
4335	$(VBOX_CERTIFICATE_SHA2_SUBJECT_NAME_ARGS) \
4336	$(VBOX_CERTIFICATE_SHA2_FINGERPRINT_ARGS) \
4337	$(VBOX_TSA_SHA2_URL_ARGS) \
4338	$(if $(strip $(2)),/d "$(strip $(2))",) \
4339	$(3) \
4340	"$(1)"
4341	else
4342	VBOX_SIGN_FILE_FN = $(VBOX_SIGNTOOL_SHA2) \
4343	sign /fd sha256 \
4344	$(VBOX_CROSS_CERTIFICATE_SHA2_FILE_ARGS) \
4345	$(VBOX_CERTIFICATE_SHA2_STORE_ARGS) \
4346	$(VBOX_CERTIFICATE_SHA2_SUBJECT_NAME_ARGS) \
4347	$(VBOX_CERTIFICATE_SHA2_FINGERPRINT_ARGS) \
4348	$(VBOX_TSA_SHA2_URL_ARGS) \
4349	$(if $(strip $(2)),/d "$(strip $(2))",) \
4350	$(3) \
4351	"$(1)"
4352	endif
4353	else
4354	VBOX_SIGN_FILE_FN = $(VBOX_SIGNTOOL) \
4355	sign /fd $(firstword $(VBOX_TEST_SIGN_ALGORITHM) sha256) \
4356	$(VBOX_CROSS_CERTIFICATE_FILE_ARGS) \
4357	$(VBOX_CERTIFICATE_STORE_ARGS) \
4358	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4359	$(VBOX_CERTIFICATE_FINGERPRINT_ARGS) \
4360	$(VBOX_TSA_URL_ARGS) \
4361	$(if $(strip $(2)),/d "$(strip $(2))",) \
4362	$(3) \
4363	"$(1)"
4364	endif
4365	endif
4366
4367	## EV sign a file (generic).
4368	# @param 1 The file to sign.
4369	# @param 2 The directory to put the signed file in. Defaults to $(dir $1).
4370	ifndef VBOX_SIGN_EV_FILE_FN
4371	if $(intersects win_ev all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4372	VBOX_SIGN_EV_FILE_FN = $(call VBOX_CCS_SIGN_CMD,microsoftev,$1,$(if $2,$2,))
4373	else ifdef VBOX_CERTIFICATE_EV_SUBJECT_NAME
4374	VBOX_SIGN_EV_FILE_FN = $(VBOX_SIGNTOOL_SHA2) \
4375	sign /fd sha256 \
4376	$(VBOX_CERTIFICATE_EV_STORE_ARGS) \
4377	$(VBOX_CERTIFICATE_EV_SUBJECT_NAME_ARGS) \
4378	$(VBOX_CERTIFICATE_EV_FINGERPRINT_ARGS) \
4379	$(VBOX_TSA_SHA2_URL_ARGS) \
4380	"$(1)"
4381	endif
4382	endif
4383
4384	## Local SHA-1 and SHA-256 signatures with EV SHA-256 signature from corp code signing.
4385	#
4386	# This builds on Plan B, since the corp code signing always replaces existing
4387	# signatures. Since we're signing more, though, we do things slightly differently
4388	# so we can apply this to VBOX_RTSIGNTOOL as well - only that didn't work because
4389	# kmk tries to help windows caching images it executes. So HACK ALERT on that.
4390	#
4391	# So, here is what we do.
4392	# 1. Sign $1 using the regular signing, probably dual signing it using local certs.
4393	# 2. Make temporary copy of $1 as $1.dual
4394	# 3. Do SHA-256 corp code signing of $1
4395	# 4. Add the SHA-256 signature from $1 to $1.dual using bldRTSignTool.
4396	# 5. Replace $1 with $1.dual.
4397	#
4398	# @param 1 The file to sign.
4399	# @param 2 File description. Optional.
4400	# @param 3 Additional parameters. Optional.
4401	# @param 4 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4402	# @param 5 Disables dual & tripple signing if non-empty.
4403	# @param 6 Disables tripple signing if non-empty.
4404	#
4405	# @remarks The parameters are the same as VBOX_SIGN_FILE_FN.
4406	VBOX_SIGN_IMAGE_WITH_EV_FN = $(call VBOX_SIGN_FILE_FN,$1,$2,$3,$4,$5)$(if-expr "$5" == "" && "$(target)" != "bldRTSignTool", \
4407	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(RM) -f -- "$1.dual" \
4408	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(CP) -- "$1" "$1.dual" \
4409	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(call VBOX_CCS_SIGN_CMD,microsoftev,$1,,-digest_algo SHA2) \
4410	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(VBOX_RTSIGNTOOL) add-nested-$(if-expr "$(suffix $1)" == ".cat",cat,exe)-signature -v "$1.dual" "$1" \
4411	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(MV) -f -- "$1.dual" "$1" \
4412	,)
4413
4414
4415	## Corp code signing for drivers and catalogs, plan B.
4416	#
4417	# Since the corp code signing cannot dual signing and doesn't even have a
4418	# SHA-1 cert, we have to get creative:
4419	# 1. Sign $1 using local SHA-1 certificate.
4420	# 2. Make temporary copy of $1 as $1.ccs
4421	# 3. Do SHA-256 corp code signing of $1.ccs
4422	# 4. Add the SHA-256 signature from $1.ccs to $1 using bldRTSignTool.
4423	# 5. Delete $1.ccs.
4424	#
4425	# @param 1 The file to sign.
4426	# @param 2 File description. Optional.
4427	# @param 3 Additional parameters. Optional.
4428	# @param 4 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4429	# @param 5 Disables dual signing if non-empty.
4430	#
4431	# @remarks The parameters are the same as VBOX_SIGN_FILE_FN.
4432	VBOX_SIGN_IMAGE_PLAN_B_FN = $(VBOX_SIGNTOOL_SHA1) \
4433	sign /fd sha1 \
4434	$(VBOX_CROSS_CERTIFICATE_FILE_ARGS) \
4435	$(VBOX_CERTIFICATE_STORE_ARGS) \
4436	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4437	$(VBOX_CERTIFICATE_FINGERPRINT_ARGS) \
4438	$(VBOX_TSA_URL_ARGS) \
4439	$(if $(strip $(2)),/d "$(strip $(2))",) \
4440	$(3) \
4441	"$(1)" \
4442	$(if-expr "$5" == "", \
4443	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(RM) -f -- "$1.ccs" \
4444	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(CP) -- "$1" "$1.ccs" \
4445	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(call VBOX_CCS_SIGN_CMD,driver$(if-expr "$3" == "/ph",_pagehash,),$1.ccs,,-digest_algo SHA2) \
4446	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(VBOX_RTSIGNTOOL) add-nested-$(if-expr "$(suffix $1)" == ".cat",cat,exe)-signature -v "$1" "$1.ccs" \
4447	$(if-expr "$4" == "2",$$(NLTAB),$(NLTAB))$(RM) -f -- "$1.ccs" \
4448	,)
4449
4450	## Sign an executable image.
4451	# @param 1 The file to sign.
4452	# @param 2 File description. Optional.
4453	# @param 3 Set to 2 if the expression will be expanded twice before chopped into commands (for _CMDS).
4454	if1of (win_with_ev, $(VBOX_WITH_CORP_CODE_SIGNING))
4455	VBOX_SIGN_IMAGE_FN ?= $(call VBOX_SIGN_IMAGE_WITH_EV_FN,$(1),$(2),/ph,$(3))
4456	VBOX_SIGN_IMAGE_ORDERDEPS ?= $(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS)
4457	else
4458	VBOX_SIGN_IMAGE_FN ?= $(call VBOX_SIGN_FILE_FN,$(1),$(2),/ph,$(3))
4459	VBOX_SIGN_IMAGE_ORDERDEPS ?= $(VBOX_SIGNTOOL_ORDERDEPS)
4460	endif
4461
4462	## Commands for signing a driver image after link.
4463	if $(intersects win_planb,$(VBOX_WITH_CORP_CODE_SIGNING))
4464	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_PLAN_B_FN,$(out),,/ph,2))
4465	VBOX_SIGN_DRIVER_ORDERDEPS ?= $(VBOX_RTSIGNTOOL) $(VBOX_SIGNTOOL_ORDERDEPS)
4466	else
4467	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_FN,$(out),,2))
4468	VBOX_SIGN_DRIVER_ORDERDEPS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_SIGN_IMAGE_ORDERDEPS))
4469	endif
4470
4471	## Create a security catalog file.
4472	# @param 1 The directory containing the stuff to sign.
4473	# @param 2 The expected .cat name. (Inf2Cat lowercases it)
4474	# @param 3 The list of OSes, separated by ';'.
4475	ifndef VBOX_MAKE_CAT_HLP_FN
4476	VBOX_MAKE_CAT_HLP_FN = \
4477	$(RM) -f -- "$(2)" \
4478	$(NL)$(TAB)$(VBOX_INF2CAT) "/driver:$(strip $(1))" "/os:$(strip $(subst ;,$(COMMA),$(3)))" /verbose \
4479	$(NL)$(TAB)$(MV) -- "$(2)" "$(2)"
4480	if $(intersects win_planb,$(VBOX_WITH_CORP_CODE_SIGNING))
4481	VBOX_MAKE_CAT_HLP_FN += $(NL)$(TAB)$(call VBOX_SIGN_IMAGE_PLAN_B_FN,$(2),,,$(NL)$(TAB))
4482	else
4483	VBOX_MAKE_CAT_HLP_FN += $(NL)$(TAB)$(call VBOX_SIGN_FILE_FN,$(2),,,$(NL)$(TAB))
4484	endif
4485	endif
4486	VBOX_MAKE_CAT64_FN ?= $(call VBOX_MAKE_CAT_HLP_FN,$(1),$(2),XP_X64;Server2003_X64;Vista_X64)
4487	VBOX_MAKE_CAT32_FN ?= $(call VBOX_MAKE_CAT_HLP_FN,$(1),$(2),2000;XP_X86;Server2003_X86;Vista_X86)
4488	ifeq ($(KBUILD_TARGET_ARCH),x86)
4489	VBOX_MAKE_CAT_FN ?= $(call VBOX_MAKE_CAT32_FN,$(1),$(2))
4490	else
4491	VBOX_MAKE_CAT_FN ?= $(call VBOX_MAKE_CAT64_FN,$(1),$(2))
4492	endif
4493
4494	# Go nuts, sign everything.
4495	if "$(VBOX_SIGNING_MODE)" == "release" \|\| defined(VBOX_WITH_HARDENING)
4496	## Commands for signing an executable or a dll image after link.
4497	VBOX_SIGN_IMAGE_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_FN,$(out),,2))
4498	VBOX_SIGN_IMAGE_CMDS_ORDERDEPS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_SIGN_IMAGE_ORDERDEPS))
4499	endif
4500	## Enable signing of the additions drivers, i.e. create CAT files.
4501	## @todo r=bird: This bugger is entirely misplaced, as it belongs in the additions config section so it can be properly overriden.
4502	VBOX_SIGN_ADDITIONS ?= 1
4503	## Set if we should include the legacy timestamp CA.
4504	ifndef VBOX_WITH_VBOX_LEGACY_TS_CA
4505	if "$(findstring 805af82410a4827b71f59479a222670391bec2d5,$(VBOX_TSA_URL_ARGS))" != ""
4506	VBOX_WITH_VBOX_LEGACY_TS_CA = 1
4507	endif
4508	endif
4509
4510	else ifeq ($(KBUILD_HOST),darwin)
4511
4512	## Sign a VM process binary with the given entitlements
4513	# @param 1 The file to sign.
4514	# @param 2 Identifier, optional.
4515	ifeq ($(VBOX_SIGNING_MODE),adhoc)
4516	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4517	## @todo cannot handle $(2), the identifier.
4518	VBOX_SIGN_IMAGE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB) \
4519	$(call VBOX_CCS_SIGN_CMD,binary,$(1),,$(subst --entitlements=,-entitlement_file_path ,$(3)) \
4520	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),-hardened_runtime))
4521	else
4522	VBOX_SIGN_IMAGE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(VBOX_CODESIGN) \
4523	--verbose=9 \
4524	--force \
4525	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4526	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 16,--options 0x10000,--options runtime)) \
4527	--file-list - \
4528	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4529	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4530	--entitlements="$(VBOX_DARWIN_ENTITLEMENTS_FILE_VM)" \
4531	"$(1)" \
4532	$(if $(2),--identifier "$(2)",)
4533	endif
4534	else
4535	VBOX_SIGN_IMAGE_FN =
4536	endif
4537
4538	#
4539	# Darwin code signing.
4540	#
4541	# Currently release signing is done when packing. This may change later.
4542	# (Installer package signing is done elsewhere (VBOX_MACOSX_INSTALLER_SIGN).)
4543	#
4544	if defined(VBOX_CERTIFICATE_FINGERPRINT) && !defined(VBOX_CERTIFICATE_SUBJECT_NAME)
4545	VBOX_CERTIFICATE_SUBJECT_NAME = $(subst $(SP),,$(VBOX_CERTIFICATE_FINGERPRINT))
4546	endif
4547	ifeq ($(VBOX_SIGNING_MODE),test)
4548	VBOX_CERTIFICATE_SUBJECT_NAME ?= $(error You need to set VBOX_CERTIFICATE_SUBJECT_NAME in LocalConfig.kmk.)
4549	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= --sign "$(VBOX_CERTIFICATE_SUBJECT_NAME)"
4550	VBOX_TSA_URL ?= none
4551	else ifeq ($(VBOX_SIGNING_MODE),adhoc)
4552	ifdef VBOX_CERTIFICATE_SUBJECT_NAME
4553	$(error VBOX_CERTIFICATE_SUBJECT_NAME must not be set in 'adhoc' signing mode)
4554	endif
4555	VBOX_CERTIFICATE_SUBJECT_NAME = -
4556	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= --sign "$(VBOX_CERTIFICATE_SUBJECT_NAME)"
4557	VBOX_TSA_URL ?= none
4558	VBOX_SIGN_IMAGE_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_IMAGE_FN,$(out),,2))
4559	else
4560	VBOX_CERTIFICATE_SUBJECT_NAME ?= Developer ID Application: Oracle America, Inc.
4561	VBOX_CERTIFICATE_SUBJECT_NAME_ARGS ?= --sign "$(VBOX_CERTIFICATE_SUBJECT_NAME)"
4562	endif
4563
4564	VBOX_CODESIGN ?= codesign
4565	if 0
4566	VBOX_DARWIN_KEXT_SIGN_FILES = CodeDirectory CodeRequirement CodeResources CodeSignature
4567	else
4568	VBOX_DARWIN_KEXT_SIGN_FILES = CodeResources
4569	endif
4570
4571	# Always enable the hardened runtime when signing. Can be disabled if
4572	# trying to build on quite old macOS, which will likely need some effort.
4573	VBOX_WITH_MACOS_HARDENED_RUNTIME ?= 1
4574
4575	##
4576	# Corp Code Notarization command line. Modifies the file because the tickets are stapled.
4577	# @param 1 The file to be submitted for signing.
4578	# @param 2 Identifier, mandatory.
4579	# @param 3 The directory to put the notarized file in. Defaults to $(dir $1).
4580	VBOX_CCS_NOTARIZE_CMD = $(VBOX_RETRY) $(VBOX_JAVA) -jar "$(VBOX_CCS_CLIENT_JAR)" \
4581	mac_notarize -user "$(VBOX_CCS_USER)" -global_uid "$(VBOX_CCS_GLOBAL_UID)" \
4582	-job_timeout 90 -server_timeout 75 -server "$(VBOX_CCS_SERVER)" \
4583	-file_to_notarize "$1" -bundle_id "$2" -download_location "$(if $3,$3,$(call VBOX_DIRX,$1))"
4584
4585	## Sign an application bundle, framework or kernel extension.
4586	# @param 1 The bundle to sign.
4587	# @param 2 Identifier, optional.
4588	# @param 3 Additional codesign command line parameters, optional.
4589	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4590	## @todo cannot handle $(2), the identifier.
4591	## @todo $(3) is hopefully either empty, --deep or --entitlements=...
4592	VBOX_SIGN_BUNDLE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB) \
4593	ditto -c -k --keepParent "$(1)" "$(1).zip"$(NLTAB) \
4594	$(call VBOX_CCS_SIGN_CMD,apple,$(1).zip,,$(subst --entitlements=,-entitlement_file_path ,$(subst --deep,-deep,$(3))) \
4595	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),-hardened_runtime))$(NLTAB) \
4596	ditto -x -k "$(1).zip" "$(1)/../"$(NLTAB) \
4597	$(RM) -f -- "$(1).zip"
4598	else
4599	VBOX_SIGN_BUNDLE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(VBOX_CODESIGN) \
4600	--verbose=9 \
4601	--force \
4602	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4603	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 16,--options 0x10000,--options runtime)) \
4604	--file-list - \
4605	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4606	$(3) \
4607	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4608	"$(1)" $(if $(2),--identifier "$(2)",)
4609	endif
4610
4611	## Sign a Mach-O image.
4612	# @param 1 The file to sign.
4613	# @param 2 Identifier, optional.
4614	# @param 3 Additional codesign command line parameters, optional.
4615	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4616	## @todo cannot handle $(2), the identifier.
4617	## @todo $(3) is hopefully either empty or --entitlements=...
4618	VBOX_SIGN_MACHO_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB) \
4619	$(call VBOX_CCS_SIGN_CMD,binary,$(1),,$(subst --entitlements=,-entitlement_file_path ,$(3)) \
4620	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),-hardened_runtime))
4621	else
4622	VBOX_SIGN_MACHO_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(VBOX_CODESIGN) \
4623	--verbose=9 \
4624	--force \
4625	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4626	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 16,--options 0x10000,--options runtime)) \
4627	--file-list - \
4628	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4629	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4630	$(3) \
4631	"$(1)" \
4632	$(if $(2),--identifier "$(2)",)
4633	endif
4634
4635	## Commands for signing an extpack dylib file after link.
4636	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4637	VBOX_SIGN_EXTPACK_DYLIB_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),, \
4638	$(call VBOX_CCS_SIGN_CMD,binary,$(out),, \
4639	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),-hardened_runtime)) )
4640	else
4641	VBOX_SIGN_EXTPACK_DYLIB_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),, \
4642	$(VBOX_CODESIGN) \
4643	--verbose=9 \
4644	--force \
4645	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4646	$(if $(VBOX_WITH_MACOS_HARDENED_RUNTIME),$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 16,--options 0x10000,--options runtime)) \
4647	--file-list - \
4648	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4649	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4650	$(out) )
4651	endif
4652
4653	## Sign a VMM Mach-O image.
4654	# @param 1 The file to sign.
4655	# @param 2 Identifier, optional.
4656	VBOX_SIGN_VMM_MOD_FN = $(VBOX_SIGN_MACHO_FN)
4657
4658	## Sign a non-executable file.
4659	# @param 1 The file to sign.
4660	# @param 2 Identifier, optional.
4661	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4662	## @todo cannot handle $(2), the identifier.
4663	VBOX_SIGN_FILE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB) \
4664	$(call VBOX_CCS_SIGN_CMD,mac_dmg,$(1))$(NLTAB) \
4665	$(REDIRECT) -E 'LC_ALL=C' -we "$(1).tmp" -- ditto -x -k -V "$(1).zip" "$(call VBOX_DIRX,$(1))"$(NLTAB) \
4666	dirname="$(call VBOX_DIRX,$(1))$(DOLLAR)($(SED) -n -e 's+^copying file $[0-9]\{1,\}$/.\{1,\}$(DOLLAR)+\1+p' "$(1).tmp")" ; \
4667	$(MV) -f -- "$(DOLLAR)dirname/$(DOLLAR)(basename "$(1)")" "$(call VBOX_DIRX,$(1))" ; \
4668	$(RM) -Rf -- "$(DOLLAR)dirname/"$(NLTAB) \
4669	$(RM) -f -- "$(1).zip" "$(1).tmp"
4670	else
4671	VBOX_SIGN_FILE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(VBOX_CODESIGN) \
4672	--verbose=9 \
4673	--force \
4674	$(if-expr $(KBUILD_HOST_VERSION_MAJOR) <= 14,--digest-algorithm sha256,) \
4675	--file-list=- \
4676	$(if-expr defined(VBOX_TSA_URL),--timestamp="$(VBOX_TSA_URL)") \
4677	$(if $(2),--identifier "$(2)",) \
4678	$(VBOX_CERTIFICATE_SUBJECT_NAME_ARGS) \
4679	"$(1)"
4680	endif
4681
4682	## Sign a DMG image.
4683	# @param 1 The file to sign.
4684	# @param 2 Identifier, optional.
4685	# @note Will segfault if --file-list is used on 10.15.2 (kSecCodeInfoChangedFiles -> NULL, outputter doesn't check for NULL).
4686	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4687	VBOX_SIGN_DMG_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(call VBOX_CCS_SIGN_CMD,binary,$(1))
4688	else
4689	VBOX_SIGN_DMG_FN = $(filter-out --file-list=-,$(VBOX_SIGN_FILE_FN))
4690	endif
4691
4692	## Sign a PKG file. Used with corp code signing only.
4693	# @param 1 The file to sign.
4694	# @param 2 Identifier, optional.
4695	if $(intersects darwin all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4696	## @todo cannot handle $(2), the identifier.
4697	VBOX_SIGN_PKG_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(call VBOX_CCS_SIGN_CMD,mac_pkg,$(1))
4698	endif
4699
4700	## Notarize a file (usually DMG, can also be PKG). Used with corp code signing only.
4701	# @param 1 The file to notarize.
4702	# @param 2 Identifier, mandatory.
4703	if $(intersects darwin darwin_notarize all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4704	VBOX_NOTARIZE_FILE_FN = $(call MSG_TOOL,SIGNTOOL,,$(1),$(2))$(NLTAB)$(call VBOX_CCS_NOTARIZE_CMD,$(1),$(2))
4705	endif
4706
4707	## @def VBOX_TEST_SIGN_KEXT
4708	# Adds test signing to a $1.kext target (the plist installer target).
4709	#
4710	# After both targets has been defined:
4711	# $(evalcall2 VBOX_TEST_SIGN_KEXT,VBoxDrv)
4712	#
4713	# @param 1 The kext name. Assumes there is a SYSMODS target of name $1
4714	# as well as an .plist installer by the name of '$1.kext'.
4715	# @remarks Currently assumes only binary + Info.plist in the bundle, no
4716	# other files. Should there be more, add them as a list in
4717	# a 2nd parameter.
4718	# @note This is only for the 'test' signing mode, we skip this in
4719	# 'release' signing mode as to not waste time on the build boxes.
4720	ifeq ($(VBOX_SIGNING_MODE),test) ## @todo when kBuild is updated to r2742+, this should be enabled for both modes.
4721	define VBOX_TEST_SIGN_KEXT
4722	$1_INSTTYPE.darwin = none
4723
4724	$1.kext_SOURCES += $$($1.kext_0_OUTDIR)/Contents/MacOS/$1=>MacOS/$1 \
4725	$(foreach extfile, $(VBOX_DARWIN_KEXT_SIGN_FILES) \
4726	, $$($1.kext_0_OUTDIR)/Contents/_CodeSignature/$(extfile)=>_CodeSignature/$(extfile))
4727	$1.kext_SYMLINKS += $(foreach symfile, $(VBOX_DARWIN_KEXT_SIGN_SYMLINKS), $(symfile)=>_CodeSignature/$(symfile))
4728	$1.kext_CLEAN += \
4729	$(foreach extfile, $(VBOX_DARWIN_KEXT_SIGN_FILES) , $$($1.kext_0_OUTDIR)/Contents/_CodeSignature/$(extfile)) \
4730	$(foreach symfile, $(VBOX_DARWIN_KEXT_SIGN_SYMLINKS), $$($1.kext_0_OUTDIR)/Contents/$(symfile)) \
4731	$$($1.kext_0_OUTDIR)/Contents/MacOS/$1 \
4732	$$($1.kext_0_OUTDIR)/$1.kext/Contents/_CodeSignature/
4733	$1.kext_BLDDIRS += $$($1.kext_0_OUTDIR)/Contents/MacOS/
4734
4735	$$$$($1.kext_0_OUTDIR)/Contents/MacOS/$1 \
4736	+ $(foreach file,$(VBOX_DARWIN_KEXT_SIGN_FILES), $$$$($1.kext_0_OUTDIR)/Contents/_CodeSignature/$(file)): \
4737	$$$$($1.kext_0_OUTDIR)/Contents/Info.plist $$$$($1_1_TARGET) \| $$$$($1.kext_0_OUTDIR)/
4738	$(RM) -Rf -- "$$($1.kext_0_OUTDIR)/Contents/_CodeSignature/" "$$($1.kext_0_OUTDIR)/Contents/MacOS/"
4739	$(MKDIR) -p -- "$$($1.kext_0_OUTDIR)/Contents/MacOS/"
4740	$(INSTALL) -m 644 $$($1_1_TARGET) $$($1.kext_0_OUTDIR)/Contents/MacOS/$1
4741	$(call VBOX_SIGN_BUNDLE_FN,$$($1.kext_0_OUTDIR),org.virtualbox.app.kext.$1,)
4742	endef
4743	else
4744	VBOX_TEST_SIGN_KEXT =
4745	endif
4746
4747
4748	else ifeq ($(KBUILD_HOST),solaris)
4749	#
4750	# Solaris code signing.
4751	#
4752	ifeq ($(VBOX_SIGNING_MODE),test)
4753	VBOX_CERTIFICATE_FILE ?= $(error You need to set VBOX_CERTIFICATE_FILE in LocalConfig.kmk.)
4754	VBOX_TOKEN_NAME ?= $(error You need to set VBOX_TOKEN_NAME in LocalConfig.kmk.)
4755	VBOX_PIN_FILE ?= $(error You need to set VBOX_PIN_FILE in LocalConfig.kmk.)
4756	else
4757	VBOX_CERTIFICATE_FILE ?= $(PATH_ROOT)/oracle.pem
4758	VBOX_TOKEN_NAME ?= "Sun Software PKCS\#11 softtoken"
4759	VBOX_PIN_FILE ?= $(PATH_ROOT)/oracle.pin
4760	endif
4761	VBOX_CERTIFICATE_FILE_ARGS ?= -c $(VBOX_CERTIFICATE_FILE)
4762	VBOX_TOKEN_NAME_ARGS ?= -T $(VBOX_TOKEN_NAME)
4763	VBOX_PIN_ARGS ?= -P $(VBOX_PIN_FILE)
4764
4765	VBOX_ELFSIGN ?= elfsign
4766
4767	# Sign an ELF image.
4768	# @param 1 The elf object file to sign.
4769	VBOX_SIGN_ELF_FN ?= $(VBOX_ELFSIGN) \
4770	sign \
4771	$(VBOX_CERTIFICATE_FILE_ARGS) \
4772	$(VBOX_TOKEN_NAME_ARGS) \
4773	$(VBOX_PIN_ARGS) \
4774	-e "$(1)"
4775
4776	## Commands for signing a driver image after link.
4777	if $(intersects solaris all 1,$(VBOX_WITH_CORP_CODE_SIGNING))
4778	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_CCS_SIGN_CMD,solaris_elf,$(out)))
4779	else
4780	VBOX_SIGN_DRIVER_CMDS ?= $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_ELF_FN,$(out)))
4781	endif
4782
4783	else
4784	# Not Windows, Mac OS X or Solaris build host, ignore.
4785	VBOX_SIGNING_MODE :=
4786	endif
4787
4788	#
4789	# Complain if windows hardening is enabled but not code signing.
4790	#
4791	else if "$(KBUILD_TARGET)" == "win" && defined(VBOX_WITH_HARDENING) && !defined(VBOX_ONLY_BUILD)
4792	$(error You need to enable code signing for a hardened windows build to work.)
4793	endif
4794
4795	#
4796	# Windows .inf editing.
4797	#
4798	ifeq ($(KBUILD_TARGET_ARCH),x86)
4799	VBOX_EDIT_INF_FN = $(call VBOX_EDIT_INF32_FN,$(1),$(2))
4800	else
4801	VBOX_EDIT_INF_FN = $(call VBOX_EDIT_INF64_FN,$(1),$(2))
4802	endif
4803	## Edit an inf file an x86 target.
4804	# @param 1 The inf file to edit.
4805	# @param 2 The output file.
4806	VBOX_EDIT_INF32_FN = $(SED) $(if $(VBOX_SIGNING_MODE),-e 's/^;cat *//', -e '/^;cat /d') \
4807	-e 's/^;x86 *//' \
4808	-e '/^;amd64 /d' \
4809	-e 's/@DOT-NT-ARCH@/.NTx86/g' \
4810	-e 's/@COMMA-NT-ARCH@/,NTx86/g' \
4811	-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)/' \
4812	--output $(2) \
4813	$(1)
4814	## Edit an inf file an x86 target.
4815	# @param 1 The inf file to edit.
4816	# @param 2 The output file.
4817	VBOX_EDIT_INF64_FN = $(SED) \
4818	$(if $(VBOX_SIGNING_MODE),-e 's/^;cat *//', -e '/^;cat /d') \
4819	-e 's/^;amd64 *//' \
4820	-e '/^;x86 /d' \
4821	-e 's/@DOT-NT-ARCH@/.NTAMD64/g' \
4822	-e 's/@COMMA-NT-ARCH@/,NTAMD64/g' \
4823	-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)/' \
4824	--output $(2) \
4825	$(1)
4826
4827	## @def VBOX_RE_SIGN_DLL_FN
4828	# Helper macro for re-signing DLL images from tools that we ship so they won't
4829	# cause trouble for the hardened build requirements.
4830	#
4831	# Invoke via $(call VBOX_RE_SIGN_DLL_FN) inside the SOURCES list. Necessary
4832	# _CLEAN entry will be added to the target. If hardening is not enabled or
4833	# we're not on windows, the source will be returned.
4834	#
4835	# @returns Name of the output file name. May have leading space, but no trailing.
4836	# @param 1 Target name.
4837	# @param 2 The source name.
4838	# @param 3 Optional prefix to avoid name collisions.
4839	#
4840	if defined(VBOX_SIGNING_MODE) && "$(KBUILD_TARGET)" == "win"
4841	if1of (quote, $(KMK_FEATURES))
4842	VBOX_RE_SIGN_DLL_FN = $(if-expr !defined($(1)_VBOX_RE_SIGNED_$(3)$(qnotdir ,$(2))), \
4843	$(evalcall VBOX_RE_SIGN_DLL_INTERNAL_FN,$1,$2,$3) \
4844	,)$($(1)_0_OUTDIR)/$(3)$(qnotdir ,$2)
4845
4846	define VBOX_RE_SIGN_DLL_INTERNAL_FN
4847	local n = $(3)$(qnotdir ,$2)
4848	ifndef $(1)_VBOX_RE_SIGNED_$(n)
4849	$(1)_VBOX_RE_SIGNED_$(n) := 1
4850	$(eval $(1)_CLEAN += $$($(1)_0_OUTDIR)/$(n))
4851
4852	$$($(1)_0_OUTDIR)/$(n): $(2) $(VBOX_VERSION_STAMP) \| $$(dir $$@) $(VBOX_SIGN_IMAGE_ORDERDEPS)
4853	$(call MSG_TOOL,SIGNTOOL,,$<,$@)
4854	$(RM) -f -- "$@"
4855	$(CP) -- "$(quote-sh-dq $<)" "$@"
4856	$(CHMOD) a+rw -- "$@"
4857	$(VBOX_VCC_EDITBIN) /LargeAddressAware /DynamicBase /NxCompat /Release /IntegrityCheck \
4858	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
4859	"$@"
4860	$(call VBOX_SIGN_IMAGE_FN,$@)
4861	endif
4862	endef # VBOX_RE_SIGN_DLL_INTERNAL_FN
4863
4864	else # old kmk: no quote feature
4865	VBOX_RE_SIGN_DLL_FN = $(if-expr !defined($(1)_VBOX_RE_SIGNED_$(3)$(notdir $(2))), \
4866	$(evalcall VBOX_RE_SIGN_DLL_INTERNAL_FN,$1,$2,$3) \
4867	,)$($(1)_0_OUTDIR)/$(3)$(notdir $2)
4868	define VBOX_RE_SIGN_DLL_INTERNAL_FN
4869	local n = $(3)$(notdir $2)
4870	ifndef $(1)_VBOX_RE_SIGNED_$(n)
4871	$(1)_VBOX_RE_SIGNED_$(n) := 1
4872	$(eval $(1)_CLEAN += $$($(1)_0_OUTDIR)/$(n))
4873
4874	$$($(1)_0_OUTDIR)/$(n): $(2) $(VBOX_VERSION_STAMP) \| $$(dir $$@) $(VBOX_SIGN_IMAGE_ORDERDEPS)
4875	$(call MSG_TOOL,SIGNTOOL,,$<,$@)
4876	$(RM) -f -- "$@"
4877	$(CP) -- "$<" "$@"
4878	$(CHMOD) a+rw -- "$@"
4879	$(VBOX_VCC_EDITBIN) /LargeAddressAware /DynamicBase /NxCompat /Release /IntegrityCheck \
4880	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
4881	"$@"
4882	$(call VBOX_SIGN_IMAGE_FN,$@)
4883	endif
4884	endef # VBOX_RE_SIGN_DLL_INTERNAL_FN
4885	endif # old kmk: no quote feature
4886	else
4887	VBOX_RE_SIGN_DLL_FN = $(2)
4888	endif
4889
4890
4891	#
4892	# File version info and description macros (ignored on most OSes).
4893	#
4894
4895	##
4896	# Internal macro.
4897	#
4898	# @param 1 The target name.
4899	# @param 2 The description
4900	# @param 3 Optional icon file.
4901	# @param 4 The template base name.
4902	# @param 5 Additional RC options.
4903	# @param 6 Original filename to use.
4904	#
4905	# @remarks ASSUMES RCFLAGS isn't a simple variable (var := value).
4906	define VBOX_SET_VER_INFO_INTERNAL
4907	ifeq ($(KBUILD_TARGET),win)
4908	$(1)_SOURCES.win += $(PATH_ROOT)/src/VBox/Artwork/win/$(4)
4909	$(1)_RCFLAGS += /nologo /dIN_INTERNAL_NAME="\"$(1)\"" /dIN_FILE_DESCRIPTION="\"$(2)\"" \
4910	/dIN_ORIGINAL_NAME="\"$(if $(6),$6,$$(notdir $$($(1)_1_INST_TARGET)))\"" \
4911	$(if $(3), /dIN_ICON_FILE="\"$(subst \\,/,$(strip $(3)))\"") $(5)
4912	$$$$($(1)_0_OUTDIR)/src/VBox/Artwork/win/$(basename $(4)).res: \
4913	$(PATH_ROOT)/include/VBox/version.h $$$$(VBOX_VERSION_HEADER)
4914	endif
4915	endef
4916
4917	##
4918	# Macro for setting DLL/SO/DYLIB version information and description.
4919	#
4920	# The macro must be invoked using evalcall2 after the whole target has
4921	# been declared.
4922	#
4923	# @param 1 The target name.
4924	# @param 2 The description
4925	# @param 3 Optional icon file.
4926	VBOX_SET_VER_INFO_DLL = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateDll.rc,)
4927
4928	##
4929	# Macro for setting EXE version information and description.
4930	#
4931	# The macro must be invoked using call after the whole target has been declared.
4932	#
4933	# @param 1 The target name.
4934	# @param 2 The description
4935	# @param 3 Optional icon file.
4936	# @param 4 Optional OriginalFilename value to use. Defaults to target name w/o dir.
4937	VBOX_SET_VER_INFO_EXE = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateExe.rc,,$4)
4938
4939	##
4940	# Macro for setting driver version information and description.
4941	#
4942	# The macro must be invoked using call after the whole target has been declared.
4943	#
4944	# @param 1 The target name.
4945	# @param 2 The description
4946	# @param 3 Optional icon file.
4947	# @param 4 Optional VFT2_DRV_xxx define for windows. Uses VFT2_UNKNOWN by default.
4948	VBOX_SET_VER_INFO_DRV = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateDrv.rc,$(if $(4), /dIN_FILE_SUBTYPE=$(4)))
4949
4950	##
4951	# Macro for setting the version information and description for a ring-0 module.
4952	#
4953	# The macro must be invoked using call after the whole target has been declared.
4954	#
4955	# @param 1 The target name.
4956	# @param 2 The description
4957	# @param 3 Optional icon file.
4958	VBOX_SET_VER_INFO_R0 = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateR0.rc,)
4959
4960	##
4961	# Macro for setting the version information and description for a raw-mode context module.
4962	#
4963	# The macro must be invoked using call after the whole target has been declared.
4964	#
4965	# @param 1 The target name.
4966	# @param 2 The description
4967	# @param 3 Optional icon file.
4968	VBOX_SET_VER_INFO_RC = $(evalcall2 VBOX_SET_VER_INFO_INTERNAL,$1,$2,$3,TemplateRc.rc,)
4969
4970
4971
4972	#
4973	# Adjust kBuild defaults.
4974	#
4975	kBuildGlobalDefaults_DEBUG_NOSTAGE.win = true
4976	kBuildGlobalDefaults_DEBUG_NOSTAGE.os2 = true
4977	if1of ($(KBUILD_TARGET), darwin win)
4978	kBuildGlobalDefaults_LD_DEBUG = split
4979	endif
4980
4981
4982	#
4983	# Haiku resource and version generation.
4984	#
4985	ifeq ($(KBUILD_HOST),haiku)
4986	VBOX_HAIKU_RCTOOL := rc
4987	VBOX_HAIKU_XRESTOOL := xres
4988	VBOX_HAIKU_SETVERSIONTOOL := setversion
4989	# XXX: install won't preserve attributes...
4990	VBOX_HAIKU_MIMESETTOOL := mimeset
4991
4992	## Add optional resources to the program, set its version info, and sniff its mime properties.
4993	# @param 1 The file to add resources to.
4994	# @param 2 The resource files.
4995	# @param 3 The target name.
4996	define VBOX_HAIKU_XRES_SETVER_FN
4997	$(if $(2),$(call MSG_TOOL,HaikuAddResources,$(3),$(2))
4998	$(QUIET)$(VBOX_HAIKU_XRESTOOL) -o $(1) $(2),)
4999	$(call MSG_TOOL,HaikuSetVersion,$(3))
5000	$(QUIET)$(VBOX_HAIKU_SETVERSIONTOOL) $(1) \
5001	-app $(VBOX_VERSION_MAJOR) $(VBOX_VERSION_MINOR) $(VBOX_VERSION_BUILD) d $(VBOX_SVN_REV) \
5002	-short "$(VBOX_PRODUCT)" \
5003	-long "$(VBOX_PRODUCT) $(VBOX_VERSION_STRING) $(shell /bin/echo -e '\xC2\xA9')2009-$(VBOX_C_YEAR) $(VBOX_VENDOR)"
5004	$(call MSG_TOOL,HaikuMimeSet,$(3))
5005	$(QUIET)$(VBOX_HAIKU_MIMESETTOOL) -f $(1)
5006	endef
5007
5008	VBOX_HAIKU_XRES_SETVER_CMDS ?= $(if $(eq $(tool_do),LINK_PROGRAM),$(call VBOX_HAIKU_XRES_SETVER_FN,$(out),$($(target)_RSRCS),$(target)),)
5009	endif
5010
5011	#
5012	# Default prefixes and suffixes.
5013	#
5014	VBOX_PREF_LIB =
5015	if1of ($(KBUILD_TARGET), os2 win)
5016	VBOX_SUFF_LIB = .lib
5017	else
5018	VBOX_SUFF_LIB = .a
5019	endif
5020	if1of ($(KBUILD_HOST), os2 win)
5021	VBOX_HOSTSUFF_LIB = .lib
5022	else
5023	VBOX_HOSTSUFF_LIB = .a
5024	endif
5025	VBOX_SUFF_DLL = $(SUFF_DLL)
5026	ifeq ($(KBUILD_TARGET),os2) # GXX3OMF produces out .o at the moment.
5027	VBOX_SUFF_OBJ = .o
5028	else
5029	VBOX_SUFF_OBJ = $(SUFF_OBJ)
5030	endif
5031	VBOXW32GUEST_SUFF_LIB = .lib
5032	VBOXLNX32GUEST_SUFF_LIB = .a
5033
5034	#
5035	# SDKs for external libraries.
5036	#
5037	ifdef VBOX_WITH_DXVK
5038	SDK_VBoxDxVk := Direct3D 9/10/11 to Vulkan - for dll linking.
5039	SDK_VBoxDxVk_DEFAULT_INCS := \
5040	$(PATH_ROOT)/src/libs/dxvk-native-1.9.2a/include/native/directx \
5041	$(PATH_ROOT)/src/libs/dxvk-native-1.9.2a/include/native/windows
5042	SDK_VBoxDxVk_INCS ?= $(SDK_VBoxDxVk_DEFAULT_INCS)
5043	# Loaded dynamically
5044	SDK_VBoxDxVk_LIBS ?=
5045	endif
5046
5047	ifdef VBOX_WITH_LIBCURL
5048	SDK_VBoxLibCurl := libcurl for dll linking.
5049	SDK_VBoxLibCurl_INCS ?= $(PATH_ROOT)/src/libs/curl-8.4.0/include
5050	SDK_VBoxLibCurl_LIBS ?= $(PATH_STAGE_LIB)/VBox-libcurl$(VBOX_SUFF_LIB)
5051	SDK_VBoxLibCurl_DEFS ?= BUILDING_LIBCURL
5052
5053	SDK_VBoxLibCurl-x86 = libcurl/x86 for dll linking.
5054	SDK_VBoxLibCurl-x86_INCS ?= $(PATH_ROOT)/src/libs/curl-8.4.0/include
5055	SDK_VBoxLibCurl-x86_LIBS.x86 ?= $(PATH_STAGE_LIB)/VBox-libcurl-x86$(VBOX_SUFF_LIB)
5056	SDK_VBoxLibCurl-x86_DEFS ?= BUILDING_LIBCURL
5057	endif
5058
5059	SDK_VBoxLibPng := protable network graphics (png) library for dll linking.
5060	SDK_VBoxLibPng_INCS ?= $(PATH_ROOT)/src/libs/libpng-1.6.42
5061	SDK_VBoxLibPng_LIBS ?= $(PATH_STAGE_LIB)/VBox-libpng$(VBOX_SUFF_LIB)
5062
5063	# lzf
5064	SDK_VBoxLzf := lzf compressor/decompressor for dll linking.
5065	SDK_VBoxLzf_INCS ?= $(PATH_ROOT)/src/libs/liblzf-3.6
5066	SDK_VBoxLzf_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzf$(VBOX_SUFF_LIB)
5067
5068	SDK_VBoxLzf-x86 := lzf/x86 compressor/decompressor for dll linking.
5069	SDK_VBoxLzf-x86_EXTENDS := VBoxLzf
5070	SDK_VBoxLzf-x86_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzf-x86$(VBOX_SUFF_LIB)
5071
5072	SDK_VBoxLzf_STATIC := lzf compressor/decompressor for static linking.
5073	SDK_VBoxLzf_STATIC_EXTENDS := VBoxLzf
5074	if1of ($(KBUILD_TARGET), os2 win)
5075	SDK_VBoxLzf_STATIC_LIBS := $(PATH_STAGE_LIB)/VBox-liblzf-static$(VBOX_SUFF_LIB)
5076	endif
5077
5078	# openssl
5079	SDK_VBoxOpenSslStatic := OpenSSL - Only for VBoxRT and/or statically linked programs.
5080	SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS := $(PATH_OUT)/obj/crypto-3.1.4-headers/include
5081	SDK_VBoxOpenSslStatic_INCS ?= $(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)
5082	SDK_VBoxOpenSslStatic_ORDERDEPS ?= $(crypto-headers_1_TARGET)
5083	if !defined(VBOX_ONLY_SDK) \
5084	&& (!defined(VBOX_ONLY_ADDITIONS) \|\| !defined(VBOX_ONLY_ADDITIONS_WITHOUT_RTISOMAKER)) \
5085	&& (!defined(VBOX_ONLY_EXTPACKS) \|\| !defined(VBOX_ONLY_EXTPACKS_USE_IMPLIBS)) \
5086	&& ("$(SDK_VBoxOpenSslStatic_INCS)" == "$(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)")
5087	SDK_VBoxOpenSslStatic_DEPS ?= $(SDK_VBoxOpenSslStatic_INCS)/openssl/openssl-mangling.h
5088	endif
5089	SDK_VBoxOpenSslStatic_LIBS ?= \
5090	$(PATH_STAGE_LIB)/VBox-libssl$(VBOX_SUFF_LIB) \
5091	$(PATH_STAGE_LIB)/VBox-libcrypto$(VBOX_SUFF_LIB)
5092
5093	SDK_VBoxOpenSslStatic-x86 := OpenSSL/x86 - Only for VBoxRT and/or statically linked programs.
5094	SDK_VBoxOpenSslStatic-x86_VBOX_DEFAULT_INCS := $(PATH_OUT)/obj/crypto-3.1.4-headers/include
5095	SDK_VBoxOpenSslStatic-x86_INCS ?= $(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)
5096	SDK_VBoxOpenSslStatic-x86_ORDERDEPS ?= $(crypto-headers_1_TARGET)
5097	if ("$(SDK_VBoxOpenSslStatic_INCS)" == "$(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)")
5098	SDK_VBoxOpenSslStatic-x86_DEPS ?= $(SDK_VBoxOpenSslStatic_INCS)/openssl/openssl-mangling.h
5099	endif
5100	SDK_VBoxOpenSslStatic-x86_LIBS ?= \
5101	$(PATH_STAGE_LIB)/VBox-libssl-x86$(VBOX_SUFF_LIB) \
5102	$(PATH_STAGE_LIB)/VBox-libcrypto-x86$(VBOX_SUFF_LIB)
5103
5104	ifdef VBOX_WITH_BLD_RTSIGNTOOL_SIGNING
5105	SDK_VBoxOpenSslBldProg := OpenSSL - Build tools verison (i.e. bldRTSignTool)
5106	SDK_VBoxOpenSslBldProg_INCS ?= $(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)
5107	SDK_VBoxOpenSslBldProg_ORDERDEPS ?= $(crypto-headers_1_TARGET)
5108	if !defined(VBOX_ONLY_SDK) \
5109	&& ("$(SDK_VBoxOpenSslStatic_INCS)" == "$(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)")
5110	SDK_VBoxOpenSslBldProg_DEPS ?= $(SDK_VBoxOpenSslStatic_INCS)/openssl/openssl-mangling.h
5111	endif
5112	SDK_VBoxOpenSslBldProg_LIBS ?= \
5113	$(PATH_STAGE_LIB)/VBoxBldProg-libssl$(VBOX_SUFF_LIB) \
5114	$(PATH_STAGE_LIB)/VBoxBldProg-libcrypto$(VBOX_SUFF_LIB)
5115	endif
5116
5117	SDK_VBoxOpenSsl := This is what you should be using! It links against VBoxRT.
5118	SDK_VBoxOpenSsl_EXTENDS := VBoxOpenSslStatic
5119	if "$(SDK_VBoxOpenSslStatic_INCS)" == "$(SDK_VBoxOpenSslStatic_VBOX_DEFAULT_INCS)"
5120	SDK_VBoxOpenSsl_LIBS = $(NO_SUCH_VARIABLE)
5121	endif
5122
5123	ifdef VBOX_WITH_LIBOGG
5124	SDK_VBoxLibOgg := libogg for dll linking.
5125	SDK_VBoxLibOgg_DEFAULT_INCS := $(PATH_ROOT)/src/libs/libogg-1.3.5/include
5126	SDK_VBoxLibOgg_INCS ?= $(SDK_VBoxLibOgg_DEFAULT_INCS)
5127	SDK_VBoxLibOgg_LIBS ?= $(PATH_STAGE_LIB)/VBox-libogg$(VBOX_SUFF_LIB)
5128	endif
5129
5130	ifdef VBOX_WITH_LIBVORBIS
5131	SDK_VBoxLibVorbis := libvorbis for dll linking.
5132	SDK_VBoxLibVorbis_DEFAULT_INCS := $(PATH_ROOT)/src/libs/libvorbis-1.3.7/include
5133	SDK_VBoxLibVorbis_INCS ?= $(SDK_VBoxLibVorbis_DEFAULT_INCS)
5134	SDK_VBoxLibVorbis_LIBS ?= $(PATH_STAGE_LIB)/VBox-libvorbis$(VBOX_SUFF_LIB)
5135	endif
5136
5137	# Our SoftFloat 3e variant.
5138	SDK_VBoxSoftFloatR3Shared := SoftFloat 3 for dll linking.
5139	SDK_VBoxSoftFloatR3Shared_DEFS := SOFTFLOAT_FAST_INT64
5140	SDK_VBoxSoftFloatR3Shared_DEFS.amd64 := LITTLEENDIAN
5141	SDK_VBoxSoftFloatR3Shared_DEFS.arm64 := LITTLEENDIAN
5142	SDK_VBoxSoftFloatR3Shared_DEFS.x86 := LITTLEENDIAN
5143	if1of ($(KBUILD_TARGET), win)
5144	SDK_VBoxSoftFloatR3Shared_DEFS += THREAD_LOCAL=__declspec(thread)
5145	else
5146	SDK_VBoxSoftFloatR3Shared_DEFS += THREAD_LOCAL=__thread
5147	endif
5148	SDK_VBoxSoftFloatR3Shared_INCS = \
5149	$(PATH_ROOT)/src/libs/softfloat-3e/source/include
5150	SDK_VBoxSoftFloatR3Shared_LIBS = \
5151	$(PATH_STAGE_LIB)/VBox-SoftFloat$(VBOX_SUFF_LIB)
5152
5153	SDK_VBoxSoftFloatR0 := SoftFloat 3 for ring-0 linking.
5154	SDK_VBoxSoftFloatR0_DEFS := SOFTFLOAT_FAST_INT64
5155	SDK_VBoxSoftFloatR0_DEFS.amd64 := LITTLEENDIAN
5156	SDK_VBoxSoftFloatR0_DEFS.arm64 := LITTLEENDIAN
5157	SDK_VBoxSoftFloatR0_DEFS.x86 := LITTLEENDIAN
5158	SDK_VBoxSoftFloatR0_INCS = \
5159	$(PATH_ROOT)/src/libs/softfloat-3e/source/include
5160	SDK_VBoxSoftFloatR0_LIBS = \
5161	$(PATH_STAGE_LIB)/VBox-SoftFloatR0$(VBOX_SUFF_LIB)
5162
5163	SDK_VBoxSoftFloatGuestR3Shared := SoftFloat 3 for ring-0 linking.
5164	SDK_VBoxSoftFloatGuestR3Shared_DEFS := SOFTFLOAT_FAST_INT64
5165	SDK_VBoxSoftFloatGuestR3Shared_DEFS.amd64 := LITTLEENDIAN
5166	SDK_VBoxSoftFloatGuestR3Shared_DEFS.arm64 := LITTLEENDIAN
5167	SDK_VBoxSoftFloatGuestR3Shared_DEFS.x86 := LITTLEENDIAN
5168	SDK_VBoxSoftFloatGuestR3Shared_INCS = \
5169	$(PATH_ROOT)/src/libs/softfloat-3e/source/include
5170	SDK_VBoxSoftFloatGuestR3Shared_LIBS.x86 = \
5171	$(VBOX_PATH_ADDITIONS_LIB)/VBox-SoftFloatGuestR3Shared-x86$(VBOX_SUFF_LIB)
5172	SDK_VBoxSoftFloatGuestR3Shared_LIBS.$(KBUILD_TARGET_ARCH) = \
5173	$(VBOX_PATH_ADDITIONS_LIB)/VBox-SoftFloatGuestR3Shared$(VBOX_SUFF_LIB)
5174
5175	ifdef VBOX_WITH_LIBSSH
5176	SDK_VBoxLibSsh := libssh for dynamic dll loading with assembly stubs.
5177	SDK_VBoxLibSsh_INCS ?= $(PATH_ROOT)/src/libs/libssh-0.10.6/include
5178	# SDK_VBoxLibSsh_LIBS is not defined, as VBoxLibSsh dll is not linked, but loaded explicitly
5179	# by auto-generated stub code (lazy loading)
5180	endif
5181
5182	ifdef VBOX_WITH_LIBTPMS
5183	SDK_VBoxLibTpms := libtpms for dll linking.
5184	SDK_VBoxLibTpms_DEFAULT_INCS := $(PATH_ROOT)/src/libs/libtpms-0.9.6/include
5185	SDK_VBoxLibTpms_INCS ?= $(SDK_VBoxLibTpms_DEFAULT_INCS)
5186	SDK_VBoxLibTpms_LIBS ?= $(PATH_STAGE_LIB)/VBox-libtpms$(VBOX_SUFF_LIB)
5187	endif
5188
5189	ifdef VBOX_WITH_LIBVPX
5190	SDK_VBoxLibVpx := libvpx for dll linking.
5191	SDK_VBoxLibVpx_DEFAULT_INCS := $(PATH_ROOT)/src/libs/libvpx-1.13.1
5192	SDK_VBoxLibVpx_INCS ?= $(SDK_VBoxLibVpx_DEFAULT_INCS)
5193	SDK_VBoxLibVpx_LIBS ?= $(PATH_STAGE_LIB)/VBox-libvpx$(VBOX_SUFF_LIB)
5194	endif
5195
5196	ifdef VBOX_WITH_LIBLZMA
5197	SDK_VBoxLibLzma := liblzma for dll linking.
5198	SDK_VBoxLibLzma_DEFAULT_INCS := $(PATH_ROOT)/src/libs/liblzma-5.4.1/api
5199	SDK_VBoxLibLzma_INCS ?= $(SDK_VBoxLibLzma_DEFAULT_INCS)
5200	SDK_VBoxLibLzma_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzma$(VBOX_SUFF_LIB)
5201
5202	SDK_VBoxLibLzma-x86 := liblzma/x86 compressor/decompressor for dll linking.
5203	SDK_VBoxLibLzma-x86_EXTENDS := VBoxLibLzma
5204	SDK_VBoxLibLzma-x86_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzma-x86$(VBOX_SUFF_LIB)
5205
5206	SDK_VBoxLibLzmaStatic := liblzma for static linking
5207	SDK_VBoxLibLzmaStatic_EXTENDS := VBoxLibLzma
5208	SDK_VBoxLibLzmaStatic_LIBS ?= $(PATH_STAGE_LIB)/VBox-liblzma-static$(VBOX_SUFF_LIB)
5209	endif
5210
5211	# libxml2
5212	SDK_VBoxLibXml2 := libxml2 for dll linking.
5213	SDK_VBoxLibXml2_INCS ?= $(PATH_ROOT)/src/libs/libxml2-2.9.14/include
5214	SDK_VBoxLibXml2_DEFS ?= _REENTRANT LIBXML_STATIC LIBXML_STATIC_FOR_DLL
5215	SDK_VBoxLibXml2_DEFS.win ?= WIN32 _WINDOWS _MBCS HAVE_WIN32_THREADS HAVE_COMPILER_TLS
5216	# Note: no linking to LIB here, we do that explicitly in src/VBox/Runtime/Makefile.kmk to link
5217	# libxml against VBoxRT
5218
5219	# zlib
5220	SDK_VBoxZlib := zlib for dll linking.
5221	if1of ($(KBUILD_TARGET), os2 solaris win)
5222	SDK_VBoxZlib_INCS ?= $(PATH_ROOT)/src/libs/zlib-1.2.13
5223	SDK_VBoxZlib_LIBS ?= $(PATH_STAGE_LIB)/VBox-zlib$(VBOX_SUFF_LIB)
5224	else
5225	SDK_VBoxZlib_INCS ?=
5226	SDK_VBoxZlib_LIBS ?= z
5227	SDK_VBoxZlib_DEFS.linux ?= _LARGEFILE64_SOURCE
5228	endif
5229
5230	SDK_VBoxZlib-x86 := zlib/x86
5231	SDK_VBoxZlib-x86_EXTENDS = VBoxZlib
5232	if1of ($(KBUILD_TARGET), os2 solaris win)
5233	SDK_VBoxZlib_LIBS-x86 ?= $(PATH_STAGE_LIB)/VBox-zlib-x86$(VBOX_SUFF_LIB)
5234	endif
5235
5236	SDK_VBoxZlibStatic := zlib for static linking
5237	SDK_VBoxZlibStatic_EXTENDS := VBoxZlib
5238	if1of ($(KBUILD_TARGET), os2 win) # Not required on solaris.
5239	SDK_VBoxZlibStatic_LIBS ?= $(PATH_STAGE_LIB)/VBox-zlib-static$(VBOX_SUFF_LIB)
5240	endif
5241
5242	#
5243	# Special SDK for the problematic NTDLL.LIB.
5244	#
5245	SDK_VBoxNtDll := Mini NTDLL import library, required by IPRT.
5246	SDK_VBoxNtDll_LIBS.x86 ?= $(PATH_STAGE_LIB)/RuntimeR3NtDll-x86.lib
5247	SDK_VBoxNtDll_LIBS.amd64 ?= $(PATH_STAGE_LIB)/RuntimeR3NtDll-amd64.lib
5248
5249	#
5250	# SDK for including newdev.lib.
5251	# It conceptually moved from the WDK to the PSDK with W10, as it's now in the um subdir.
5252	#
5253	SDK_VBoxWinNewDevLib := Abstracts where to find newdev.lib.
5254	ifn1of ($(VBOX_WINPSDK), WINPSDK71 WINPSDK80)
5255	SDK_VBoxWinNewDevLib_LIBS.x86 = $(PATH_SDK_$(VBOX_WINPSDK)_LIB.x86)/newdev.lib
5256	SDK_VBoxWinNewDevLib_LIBS.amd64 = $(PATH_SDK_$(VBOX_WINPSDK)_LIB.amd64)/newdev.lib
5257	else
5258	SDK_VBoxWinNewDevLib_LIBS.x86 = $(PATH_SDK_$(VBOX_WINDDK)_LIB.x86)/newdev.lib
5259	SDK_VBoxWinNewDevLib_LIBS.amd64 = $(PATH_SDK_$(VBOX_WINDDK)_LIB.amd64)/newdev.lib
5260	endif
5261
5262	#
5263	# Determine Solaris version.
5264	#
5265	ifeq ($(KBUILD_TARGET),solaris)
5266	VBOX_SOLARIS_VERSION := $(expr $(KBUILD_HOST_VERSION_MAJOR) * 100 + $(KBUILD_HOST_VERSION_MINOR))
5267	ifeq ($(VBOX_SOLARIS_VERSION),510)
5268	DEFS.solaris += RT_OS_SOLARIS_10
5269	# Solaris 10 does not include crossbow.
5270	VBOX_SOLARIS_10 = 1
5271	# We cannot compile additions on Solaris 10, due kernel interface deps
5272	VBOX_WITHOUT_ADDITIONS := 1
5273	VBOX_WITH_ADDITIONS =
5274	else ifeq ($(VBOX_SOLARIS_VERSION),511)
5275	# OSS audio support for Solaris
5276	VBOX_WITH_AUDIO_OSS := 1
5277	endif
5278
5279	# XPCOM namespace cleanup issue with Solaris GCC 4.5.2 and newer, see @bugref{5838}.
5280	if $(VBOX_GCC_VERSION_CXX) >= 40502
5281	VBOX_WITH_XPCOM_NAMESPACE_CLEANUP =
5282	endif
5283	endif
5284
5285	#
5286	# VBoxTpG tool.
5287	#
5288	TOOL_VBoxTpG = The VirtualBox Tracepoint Generator
5289	TOOL_VBoxTpG_DTRACE_DEPORD = $(VBOX_VBOXTPG)
5290	TOOL_VBoxTpG_DTRACE_HDR_FLAGS := \
5291	-h --host-$(VBOX_HC_ARCH_BITS)-bit #-vvv
5292	define TOOL_VBoxTpG_DTRACE_HDR_CMDS
5293	$(QUIET)$(VBOX_VBOXTPG) $(if-expr $(intersects $(bld_trg_arch),$(KBUILD_ARCHES_64)),-64,-32) \
5294	$(flags) -o "$(out)" -s "$(source)"
5295	endef
5296	TOOL_VBoxTpG_DTRACE_OBJ_NOT_NEEDED :=
5297	TOOL_VBoxTpG_DTRACE_OBJ_FLAGS := -G --host-$(VBOX_HC_ARCH_BITS)-bit #-vvv
5298	define TOOL_VBoxTpG_DTRACE_OBJ_CMDS
5299	$(QUIET)$(VBOX_VBOXTPG) --assembler "$(TOOL_$(VBOX_ASTOOL)_AS)" \
5300	$(if-expr $(intersects $(bld_trg_arch),$(KBUILD_ARCHES_64)),-64,-32) \
5301	$(flags) \
5302	-o "$(out)" -s "$(source)"
5303	endef
5304
5305
5306	#
5307	# VBoxTpG tool - Disabled, only generate the header.
5308	#
5309	TOOL_VBoxTpG-Disabled = The VirtualBox Tracepoint Generator, disabled.
5310	TOOL_VBoxTpG-Disabled_DTRACE_DEPORD = $(VBOX_VBOXTPG)
5311	TOOL_VBoxTpG-Disabled_DTRACE_HDR_FLAGS := -h
5312	define TOOL_VBoxTpG-Disabled_DTRACE_HDR_CMDS
5313	$(QUIET)$(VBOX_VBOXTPG) $(flags) -o "$(out)" -s "$(source)"
5314	endef
5315	TOOL_VBoxTpG-Disabled_DTRACE_OBJ_NOT_NEEDED := $(KBUILD_OSES)
5316
5317
5318	#
5319	# dtrace+VBoxTpG tool for ring-3 to ring-0 pointer conversion.
5320	#
5321	TOOL_DTraceAndVBoxTpG = DTrace and the VirtualBox Tracepoint Generator working together on static ring-3 probes.
5322	TOOL_DTraceAndVBoxTpG_EXTENDS = StandardDTrace
5323	TOOL_DTraceAndVBoxTpG_DTRACE_DEPORD = $(VBOX_VBOXTPG)
5324	TOOL_DTraceAndVBoxTpG_DTRACE_HDR_CMDS =
5325	define TOOL_DTraceAndVBoxTpG_DTRACE_HDR_CMDS
5326	$(TOOL_StandardDTrace_DTRACE_HDR_CMDS)
5327	$(QUIET)$(VBOX_VBOXTPG) --generate-wrapper-header --host-$(VBOX_HC_ARCH_BITS)-bit --ring-3-context \
5328	$(filter-out -C, $(filter-out -h,$(flags))) \
5329	-o "$(out).tmp" -s "$(source)"
5330	$(APPEND) "$(out).tmp"
5331	$(SED) -e 's/$#define.*$(arg0/\1_ORIGINAL(arg0/' --append "$(out).tmp" "$(out)"
5332	$(MV) -f -- "$(out).tmp" "$(out)"
5333	endef
5334	TOOL_DTraceAndVBoxTpG_DTRACE_OBJ_NOT_NEEDED = $(TOOL_StandardDTrace_DTRACE_OBJ_NOT_NEEDED)
5335	TOOL_DTraceAndVBoxTpG_DTRACE_OBJ_CMDS = $(TOOL_StandardDTrace_DTRACE_OBJ_CMDS)
5336
5337
5338	ifdef VBOX_WITH_RAW_MODE
5339	#
5340	# Template for building RC things.
5341	#
5342	# Disabled Visual C++ warnings:
5343	# -wd4505: 'iemRaisePageFaultJmp' : unreferenced local function has been removed
5344	#
5345	TEMPLATE_VBoxRc = VBox Raw-Mode Context
5346	TEMPLATE_VBoxRc_ASTOOL := $(VBOX_ASTOOL)
5347	TEMPLATE_VBoxRc_ASFLAGS = $(VBOX_ASFLAGS32)
5348	TEMPLATE_VBoxRc_DEFS = IN_RC IPRT_NO_CRT RT_WITH_NOCRT_ALIASES $(ARCH_BITS_DEFS)
5349	TEMPLATE_VBoxRc_INCS = $(PATH_ROOT)/include/iprt/nocrt
5350	TEMPLATE_VBoxRc_SYSSUFF = .rc
5351	TEMPLATE_VBoxRc_BLD_TRG_ARCH = x86
5352	TEMPLATE_VBoxRc_MODE = a+r,u+w
5353
5354	TEMPLATE_VBoxRc_USES += dtrace
5355	TEMPLATE_VBoxRc_DTRACE_HDR_FLAGS = --raw-mode-context
5356	TEMPLATE_VBoxRc_DTRACE_OBJ_FLAGS = --raw-mode-context --probe-fn-name "VMMRCProbeFire"
5357	ifdef VBOX_WITH_DTRACE_RC
5358	TEMPLATE_VBoxRc_DTRACETOOL = VBoxTpG
5359	TEMPLATE_VBoxRc_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_RC
5360	else
5361	TEMPLATE_VBoxRc_DTRACETOOL = VBoxTpG-Disabled
5362	endif
5363
5364	ifeq ($(VBOX_LDR_FMT32),pe)
5365	TEMPLATE_VBoxRc_TOOL = $(VBOX_VCC_TOOL_STEM)X86
5366	TEMPLATE_VBoxRc_RCDEFS = VBOX_SVN_REV=$(VBOX_SVN_REV) VBOX_SVN_REV_MOD_5K=$(expr $(VBOX_SVN_REV) % 50000)
5367	TEMPLATE_VBoxRc_CXXFLAGS = -Zi -Zl -GR- -EHs- -GF -GS- $(VBOX_VCC_WCHAR_T_VARIANT) -Gs8192 $(VBOX_VCC_GC_OPT) $(VBOX_VCC_GC_FP) \
5368	-Gy $(VBOX_VCC_WARN_ALL) -wd4505 $(VBOX_VCC_WERR)
5369	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
5370	TEMPLATE_VBoxRc_CXXFLAGS += -Gw
5371	endif
5372	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
5373	TEMPLATE_VBoxRc_CXXFLAGS += -Zc:inline
5374	endif
5375	ifdef VBOX_WITH_MSC_ANALYZE_THIS
5376	TEMPLATE_VBoxRc_CXXFLAGS += /analyze
5377	endif
5378	TEMPLATE_VBoxRc_CFLAGS = $(TEMPLATE_VBoxRc_CXXFLAGS)
5379	TEMPLATE_VBoxRc_LDFLAGS = -Ignore:4197 \
5380	-Driver -Subsystem:NATIVE -Incremental:NO -Align:64 -MapInfo:Exports -NoD $(VBOX_VCC_LD_WERR) -Release -Debug -Opt:Ref -Opt:Icf \
5381	-Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
5382	-Stub:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
5383	ifdef VBOX_SIGNING_MODE
5384	TEMPLATE_VBoxRc_LDFLAGS += -IntegrityCheck
5385	endif
5386	TEMPLATE_VBoxRc_LIBS += \
5387	$(PATH_STAGE_LIB)/RuntimeRCStub$(VBOX_SUFF_LIB)
5388	TEMPLATE_VBoxRc_POST_CMDS = $(VBOX_SIGN_IMAGE_CMDS)
5389	TEMPLATE_VBoxRc_ORDERDEPS = $(VBOX_SIGN_IMAGE_CMDS_ORDERDEPS)
5390	endif # pe
5391
5392	ifeq ($(VBOX_LDR_FMT32),elf)
5393	TEMPLATE_VBoxRc_TOOL = $(VBOX_GCC32_TOOL)
5394	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)
5395	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)
5396	if $(VBOX_GCC32_VERSION_CC) < 30400
5397	TEMPLATE_VBoxRc_DEFS += RT_WITHOUT_PRAGMA_ONCE
5398	endif
5399	ifeq ($(KBUILD_TARGET),solaris)
5400	TEMPLATE_VBoxRc_LDFLAGS = -r
5401	else
5402	TEMPLATE_VBoxRc_LDFLAGS = -nostdlib -Bsymbolic -g
5403	## @todo WTF doesn't the globals work? Debug info is supposed to be split everywhere. GRR
5404	TEMPLATE_VBoxRc_LD_DEBUG = split
5405	endif
5406	ifn1of ($(KBUILD_TARGET), solaris freebsd)
5407	TEMPLATE_VBoxRc_LIBS = \
5408	$(VBOX_GCC32_LIBGCC) # intrinsics
5409	endif
5410	if1of ($(KBUILD_TARGET), linux)
5411	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)
5412	endif
5413	endif
5414
5415	ifeq ($(VBOX_LDR_FMT32),macho)
5416	TEMPLATE_VBoxRc_TOOL = $(VBOX_GCC_TOOL)
5417	TEMPLATE_VBoxRc_SDKS += $(VBOX_DARWIN_DEF_SDK_SDKS)
5418	TEMPLATE_VBoxRc_DEFS += $(VBOX_DARWIN_DEF_SDK_DEFS)
5419	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)
5420	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
5421	TEMPLATE_VBoxRc_LDFLAGS = $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -m32 -nostdlib
5422	#TEMPLATE_VBoxRc_LDFLAGS.release = -Wl,-S ???
5423	endif
5424
5425	ifeq ($(VBOX_LDR_FMT32),lx)
5426	TEMPLATE_VBoxRc_TOOL = GXX3OMF
5427	if $(VBOX_GCC_VERSION_CC) < 30400
5428	TEMPLATE_VBoxRc_DEFS += RT_WITHOUT_PRAGMA_ONCE
5429	endif
5430	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
5431	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
5432	TEMPLATE_VBoxRc_LDFLAGS = -Zdll -nostdlib
5433	TEMPLATE_VBoxRc_LIBS = \
5434	$(VBOX_GCC32_LIBGCC) \
5435	$(VBOX_OBJ_SYS0) \
5436	end
5437	endif
5438
5439
5440	#
5441	# Template for building a RC ring-3 testcase (tstVMStructGC, tstDevStructGC).
5442	#
5443	TEMPLATE_VBoxRcExe = VBox Raw-Mode as ring-3 testcase
5444	TEMPLATE_VBoxRcExe_EXTENDS = VBoxRc
5445	TEMPLATE_VBoxRcExe_DEFS = $(filter-out IPRT_NO_CRT RT_WITH_NOCRT_ALIASES,$(TEMPLATE_VBoxRc_DEFS))
5446	TEMPLATE_VBoxRcExe_INCS = $(NO_SUCH_VARIABLE)
5447	TEMPLATE_VBoxRcExe_MODE = $(NO_SUCH_VARIABLE)
5448
5449	ifeq ($(VBOX_LDR_FMT32),pe)
5450	TEMPLATE_VBoxRcExe_LDFLAGS = -Ignore:4197 \
5451	-Incremental:NO -MapInfo:Exports -NoD -Debug -Opt:Ref -Opt:Icf \
5452	-Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
5453	-Stub:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
5454	TEMPLATE_VBoxRcExe_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK)
5455	TEMPLATE_VBoxRcExe_LIBS = \
5456	$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_LIB)/libcmt.lib \
5457	$(PATH_TOOL_$(VBOX_VCC_TOOL_STEM)X86_LIB)/oldnames.lib
5458	endif
5459
5460	ifeq ($(VBOX_LDR_FMT32),elf)
5461	TEMPLATE_VBoxRcExe_CFLAGS = $(filter-out -nostdinc,$(TEMPLATE_VBoxRc_CFLAGS)) -O0
5462	TEMPLATE_VBoxRcExe_CXXFLAGS = $(filter-out -nostdinc,$(TEMPLATE_VBoxRc_CXXFLAGS)) -O0
5463	TEMPLATE_VBoxRcExe_LDFLAGS = -g
5464	TEMPLATE_VBoxRcExe_LDFLAGS.dbgopt = -g
5465	TEMPLATE_VBoxRcExe_LDFLAGS.strict = -g
5466	TEMPLATE_VBoxRcExe_LDFLAGS.release = -g
5467	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), freebsd.amd64)
5468	# The FreeBSD port of gcc isn't picking up -m32 where it should.
5469	TEMPLATE_VBoxRcExe_DEFS.$(KBUILD_TARGET) = $(TEMPLATE_VBoxRc_DEFS.$(KBUILD_TARGET)) IPRT_DONT_USE_SYSTEM_STDINT_H
5470	TEMPLATE_VBoxRcExe_LDFLAGS.$(KBUILD_TARGET) = /usr/lib32/crt1.o /usr/lib32/crti.o /usr/lib32/crtbegin.o $(TEMPLATE_VBoxRc_LDFLAGS.$(KBUILD_TARGET)) -nostdlib -v
5471	TEMPLATE_VBoxRcExe_LIBPATH.$(KBUILD_TARGET) = /usr/lib32
5472	TEMPLATE_VBoxRcExe_LIBS.$(KBUILD_TARGET) = /usr/lib32/crtend.o /usr/lib32/crtn.o /usr/lib32/libc.so
5473	endif
5474	endif
5475
5476	ifeq ($(VBOX_LDR_FMT32),macho)
5477	TEMPLATE_VBoxRcExe_CFLAGS = $(filter-out -static -nostdinc,$(TEMPLATE_VBoxRc_CFLAGS))
5478	TEMPLATE_VBoxRcExe_CXXFLAGS = $(filter-out -static -nostdinc,$(TEMPLATE_VBoxRc_CXXFLAGS))
5479	TEMPLATE_VBoxRcExe_LDFLAGS = -g -m32
5480	endif
5481
5482	ifeq ($(VBOX_LDR_FMT32),lx)
5483	TEMPLATE_VBoxRcExe_CFLAGS = $(filter-out -nostdinc,$(TEMPLATE_VBoxRc_CFLAGS))
5484	TEMPLATE_VBoxRcExe_CXXFLAGS = $(filter-out -nostdinc,$(TEMPLATE_VBoxRc_CXXFLAGS))
5485	TEMPLATE_VBoxRcExe_LDFLAGS = -g
5486	TEMPLATE_VBoxRcExe_LIBS = $(NO_SUCH_VARIABLE)
5487	endif
5488	endif # VBOX_WITH_RAW_MODE
5489
5490
5491	#
5492	# Template for building R0 things.
5493	#
5494	# Disabled Visual C++ warnings:
5495	# -wd4505: 'iemRaisePageFaultJmp' : unreferenced local function has been removed
5496	#
5497	TEMPLATE_VBoxR0 = VBox Ring 0
5498	TEMPLATE_VBoxR0_ASTOOL := $(VBOX_ASTOOL)
5499	TEMPLATE_VBoxR0_ASFLAGS = $(VBOX_ASFLAGS)
5500	TEMPLATE_VBoxR0_DEFS = IN_RING0 IN_RING0_AGNOSTIC IPRT_NO_CRT RT_WITH_NOCRT_ALIASES $(ARCH_BITS_DEFS)
5501	TEMPLATE_VBoxR0_INCS = $(PATH_ROOT)/include/iprt/nocrt
5502	TEMPLATE_VBoxR0_SYSSUFF = .r0
5503	TEMPLATE_VBoxR0_MODE = a+r,u+w
5504
5505	TEMPLATE_VBoxR0_USES += dtrace
5506	TEMPLATE_VBoxR0_DTRACE_HDR_FLAGS = --ring-0-context-agnostic
5507	TEMPLATE_VBoxR0_DTRACE_OBJ_FLAGS = --ring-0-context-agnostic
5508	ifdef VBOX_WITH_DTRACE_R0
5509	TEMPLATE_VBoxR0_DTRACETOOL = VBoxTpG
5510	TEMPLATE_VBoxR0_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R0
5511	else
5512	TEMPLATE_VBoxR0_DTRACETOOL = VBoxTpG-Disabled
5513	endif
5514	ifdef VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION
5515	TEMPLATE_VBoxR0_DEFS += RT_WITH_IBT_BRANCH_PROTECTION RT_WITH_IBT_BRANCH_PROTECTION_WITHOUT_NOTRACK
5516	endif
5517
5518	ifeq ($(VBOX_LDR_FMT),pe)
5519	TEMPLATE_VBoxR0_TOOL = $(VBOX_VCC_TOOL)
5520	TEMPLATE_VBoxR0_RCDEFS = VBOX_SVN_REV=$(VBOX_SVN_REV) VBOX_SVN_REV_MOD_5K=$(expr $(VBOX_SVN_REV) % 50000)
5521	TEMPLATE_VBoxR0_CXXFLAGS = -Zi -Zl -GR- -EHs- -GF -GS- $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_OPT) $(VBOX_VCC_FP) \
5522	-Gy $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_std) $(VBOX_VCC_WARN_ALL) -wd4505 $(VBOX_VCC_WERR)
5523	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
5524	TEMPLATE_VBoxR0_CXXFLAGS += -Gw
5525	endif
5526	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
5527	TEMPLATE_VBoxR0_CXXFLAGS += -Zc:inline
5528	endif
5529	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
5530	TEMPLATE_VBoxR0_CXXFLAGS += /volatileMetadata-
5531	endif
5532	ifdef VBOX_WITH_MSC_ANALYZE_THIS
5533	TEMPLATE_VBoxR0_CXXFLAGS += /analyze
5534	endif
5535	TEMPLATE_VBoxR0_CFLAGS = $(filter-out $(VBOX_VCC_std),$(TEMPLATE_VBoxR0_CXXFLAGS))
5536	TEMPLATE_VBoxR0_LDFLAGS = -Ignore:4197 \
5537	-Driver -Subsystem:NATIVE -Incremental:NO -Align:4096 -MapInfo:Exports -NoD $(VBOX_VCC_LD_WERR) \
5538	-Release -Debug -Opt:Ref -Opt:Icf $(VBOX_VCC_LD_GUARD_CF) \
5539	-Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
5540	-Stub:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
5541	ifdef VBOX_WITH_DTRACE_R0
5542	TEMPLATE_VBoxR0_LDFLAGS += -Merge:VTGPrLc.Data=VTGPrLc.Begin -Merge:VTGPrLc.End=VTGPrLc.Begin -Merge:VTGPrLc.Begin=VTGObj
5543	endif
5544	ifdef VBOX_SIGNING_MODE
5545	TEMPLATE_VBoxR0_LDFLAGS += -IntegrityCheck
5546	endif
5547	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
5548	TEMPLATE_VBoxR0_LDFLAGS += -EmitVolatileMetadata:NO
5549	endif
5550	TEMPLATE_VBoxR0_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
5551	ifneq ($(VBOX_VCC_CC_GUARD_CF),)
5552	TEMPLATE_VBoxR0_LDFLAGS.win.amd64 += -Include:__security_init_cookie -Export:ModuleInitSecurityCookie=__security_init_cookie
5553	TEMPLATE_VBoxR0_LDFLAGS.win.x86 += -Include:___security_init_cookie -Export:ModuleInitSecurityCookie=__security_init_cookie
5554	endif
5555	TEMPLATE_VBoxR0_LIBS = \
5556	$(PATH_STAGE_LIB)/RuntimeR0Stub$(VBOX_SUFF_LIB)
5557	ifneq ($(VBOX_VCC_CC_GUARD_CF),)
5558	TEMPLATE_VBoxR0_LIBS += \
5559	$(PATH_SDK_$(VBOX_WINDDK)_LIB)/BufferOverflowK.lib
5560	include $(KBUILD_PATH)/sdks/$(VBOX_WINDDK).kmk ## TODO: Add a kBuild feature for loading SDKs.
5561	endif
5562	TEMPLATE_VBoxR0_ORDERDEPS = $(VBOX_SIGN_DRIVER_ORDERDEPS)
5563	TEMPLATE_VBoxR0_POST_CMDS = $(VBOX_SIGN_DRIVER_CMDS)
5564	endif # pe
5565
5566	ifeq ($(VBOX_LDR_FMT),elf)
5567	TEMPLATE_VBoxR0_TOOL = $(VBOX_GCC_TOOL)
5568	TEMPLATE_VBoxR0_CFLAGS = -fno-pie -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_C) \
5569	$(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-exceptions \
5570	$(VBOX_GCC_fno-stack-protector) -fno-common -ffreestanding $(VBOX_GCC_fvisibility-hidden) -std=gnu99 $(VBOX_GCC_IPRT_FMT_CHECK)
5571	TEMPLATE_VBoxR0_CXXFLAGS = -fno-pie -nostdinc -g $(VBOX_GCC_pipe) $(VBOX_GCC_WERR) $(VBOX_GCC_PEDANTIC_CXX) \
5572	$(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-exceptions \
5573	$(VBOX_GCC_fno-stack-protector) -fno-common $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) \
5574	-fno-rtti $(VBOX_GCC_std) $(VBOX_GCC_IPRT_FMT_CHECK)
5575	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++.
5576	TEMPLATE_VBoxR0_CXXFLAGS += -ffreestanding
5577	endif
5578	TEMPLATE_VBoxR0_CFLAGS.amd64 = -m64 -mno-red-zone -mno-sse -mno-mmx -mno-sse2 -mno-3dnow -fasynchronous-unwind-tables -ffreestanding
5579	TEMPLATE_VBoxR0_CXXFLAGS.amd64 = -m64 -mno-red-zone -mno-sse -mno-mmx -mno-sse2 -mno-3dnow -fasynchronous-unwind-tables
5580	TEMPLATE_VBoxR0_CXXFLAGS.freebsd = -ffreestanding
5581	if $(VBOX_GCC_VERSION_CC) < 30400
5582	TEMPLATE_VBoxR0_DEFS += RT_WITHOUT_PRAGMA_ONCE
5583	endif
5584	ifeq ($(KBUILD_TARGET),solaris)
5585	TEMPLATE_VBoxR0_LDFLAGS = -r
5586	TEMPLATE_VBoxR0_LDFLAGS.solaris = -u _init -u _info
5587	TEMPLATE_VBoxR0_LDFLAGS.solaris.amd64 = -m64
5588	TEMPLATE_VBoxR0_LDFLAGS.solaris.x86 = -m32
5589	TEMPLATE_VBoxR0_LIBS.solaris = \
5590	$(PATH_STAGE_LIB)/RuntimeR0Stub$(VBOX_SUFF_LIB)
5591	ifdef VBOX_GCC_USING_SOLARIS_AS
5592	TEMPLATE_VBoxR0_CFLAGS.amd64 += -Wa,-xmodel=kernel
5593	TEMPLATE_VBoxR0_CXXFLAGS.amd64 += -Wa,-xmodel=kernel
5594	endif
5595	# Solaris driver signing.
5596	TEMPLATE_VBoxR0_POST_CMDS = $(VBOX_SIGN_DRIVER_CMDS)
5597	else
5598	TEMPLATE_VBoxR0_LDFLAGS = -nostdlib -Bsymbolic -g
5599	## @todo WTF doesn't the globals work? Debug info is supposed to be split everywhere. GRR
5600	TEMPLATE_VBoxR0_LD_DEBUG = split
5601	endif
5602	if "$(KBUILD_TARGET)" == "linux" && !defined(VBOX_WITH_KMOD_WRAPPED_R0_MODS)
5603	VBOX_WITH_VBOXR0_AS_DLL = 1
5604	TEMPLATE_VBoxR0_DLLSUFF = .r0
5605	TEMPLATE_VBoxR0_CFLAGS += -fPIC
5606	TEMPLATE_VBoxR0_CXXFLAGS += -fPIC
5607	TEMPLATE_VBoxR0_LDFLAGS +=
5608	TEMPLATE_VBoxR0_DTRACE_HDR_FLAGS += --pic
5609	TEMPLATE_VBoxR0_DTRACE_OBJ_FLAGS += --pic
5610	else
5611	TEMPLATE_VBoxR0_CFLAGS.amd64 += -mcmodel=kernel
5612	TEMPLATE_VBoxR0_CXXFLAGS.amd64 += -mcmodel=kernel
5613	endif
5614	ifdef VBOX_WITH_KMOD_WRAPPED_R0_MODS # For BTF/pahold issue we use -g1
5615	TEMPLATE_VBoxR0_DEFS += VBOX_WITH_KMOD_WRAPPED_R0_MODS
5616	TEMPLATE_VBoxR0_LDFLAGS.linux += $(PATH_ROOT)/src/VBox/HostDrivers/Support/linux/VBoxR0-wrapped.lds
5617	TEMPLATE_VBoxR0_LNK_DEPS.linux += $(PATH_ROOT)/src/VBox/HostDrivers/Support/linux/VBoxR0-wrapped.lds
5618	TEMPLATE_VBoxR0_CFLAGS.linux += -g1
5619	TEMPLATE_VBoxR0_CXXFLAGS.linux += -g1
5620	endif
5621	ifdef VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION
5622	TEMPLATE_VBoxR0_CFLAGS += $(VBOX_GCC_fcf-protection_branch) -fno-jump-tables
5623	TEMPLATE_VBoxR0_CXXFLAGS += $(VBOX_GCC_fcf-protection_branch) -fno-jump-tables
5624	TEMPLATE_VBoxR0_LDFLAGS += $(VBOX_GCC_fcf-protection_branch) $(VBOX_GCC_fcf-protection_check)
5625	ifeq ($(VBOX_GCC_fcf-protection_branch),)
5626	$(warning VBox: VBOX_WITH_R0_MOD_IBT_BRANCH_PROTECTION is set but gcc doesn't support branch protection)
5627	endif
5628	endif
5629	ifn1of ($(KBUILD_TARGET), solaris freebsd)
5630	TEMPLATE_VBoxR0_LIBS = \
5631	$(VBOX_GCC_LIBGCC) # intrinsics
5632	endif
5633	if1of ($(KBUILD_TARGET), linux)
5634	TEMPLATE_VBoxR0_POST_CMDS += $(NLTAB) \
5635	$(if $(eq $(tool_do),LINK_SYSMOD),if readelf -S $(out)\|grep -q "[cd]tors"; then echo "Found ctors/dtors in $(out)!"; exit 1; fi)
5636	endif
5637	endif # elf
5638
5639	ifeq ($(VBOX_LDR_FMT),macho)
5640	TEMPLATE_VBoxR0_TOOL = $(VBOX_GCC_TOOL)
5641	TEMPLATE_VBoxR0_SDKS += $(VBOX_DARWIN_DEF_SDK_SDKS)
5642	TEMPLATE_VBoxR0_DEFS += $(VBOX_DARWIN_DEF_SDK_DEFS)
5643	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) \
5644	-fno-common -static -fno-rtti -fno-exceptions $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing \
5645	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_std)
5646	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
5647	TEMPLATE_VBoxR0_CXXFLAGS.x86 = -m32 -msoft-float -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
5648	TEMPLATE_VBoxR0_CXXFLAGS.arm64 = -m64 -target arm64e-apple-macos11.0 # Assembly fixup issues w/o the -target bit. Why?
5649	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) \
5650	-fno-common -static -fno-exceptions $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing \
5651	$(VBOX_GCC_fno-stack-protector)
5652	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
5653	TEMPLATE_VBoxR0_CFLAGS.x86 = -m32 -msoft-float -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
5654	TEMPLATE_VBoxR0_CFLAGS.arm64 = -m64 -target arm64e-apple-macos11.0
5655	TEMPLATE_VBoxR0_LDFLAGS = $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -nostdlib
5656	TEMPLATE_VBoxR0_LDFLAGS.amd64 = -m64 -static
5657	TEMPLATE_VBoxR0_LDFLAGS.arm64 = -m64 -static
5658	TEMPLATE_VBoxR0_LDFLAGS.x86 = -m32
5659	TEMPLATE_VBoxR0_CXXFLAGS.amd64 += -mkernel
5660	TEMPLATE_VBoxR0_CFLAGS.amd64 += -mkernel
5661	TEMPLATE_VBoxR0_CXXFLAGS.arm64 += -mkernel
5662	TEMPLATE_VBoxR0_CFLAGS.arm64 += -mkernel
5663	TEMPLATE_VBoxR0_LDFLAGS += -Wl,-kext -mkernel
5664	TEMPLATE_VBoxR0_POST_CMDS = $(if $(eq $(tool_do),LINK_LIBRARY),,$(call VBOX_SIGN_VMM_MOD_FN,$(out),org.virtualbox.app.r0.$(target)))
5665	endif
5666
5667	ifeq ($(VBOX_LDR_FMT),lx)
5668	TEMPLATE_VBoxR0_TOOL = GXX3OMF
5669	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
5670	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
5671	if $(VBOX_GCC_VERSION_CC) < 30400
5672	TEMPLATE_VBoxR0_DEFS += RT_WITHOUT_PRAGMA_ONCE
5673	endif
5674	TEMPLATE_VBoxR0_LDFLAGS = -nostdlib -Zdll
5675	TEMPLATE_VBoxR0_LIBS = \
5676	$(VBOX_GCC_LIBGCC) \
5677	$(VBOX_OBJ_SYS0) \
5678	end
5679	endif
5680
5681
5682	#
5683	# Template for building SUPDRV R0 things.
5684	#
5685	# Disabled Visual C++ warnings:
5686	# -wd4996: deprecated / insecure.
5687	# -wd4127: conditional expression is constant [level 4]
5688	# -wd4201: nonstandard extension used : nameless struct/union [level 4]
5689	# -wd4214: nonstandard extension used : bit field types other than int [level 4]
5690	# -wd4706: assignment within conditional expression [level 4]
5691	# -wd4324: '_TDI_PNP_CONTEXT_XP' : structure was padded due to __declspec(align())
5692	#
5693	# -wd4100: 'identifier' : unreferenced formal parameter [level 4] --- TODO: Enable this one!
5694	#
5695	TEMPLATE_VBoxR0Drv = VBox SUPDRV Ring 0
5696	TEMPLATE_VBoxR0Drv_ASTOOL := $(VBOX_ASTOOL)
5697	TEMPLATE_VBoxR0Drv_ASFLAGS = $(VBOX_ASFLAGS)
5698	TEMPLATE_VBoxR0Drv_DEFS = IN_RING0 IN_RT_R0 $(ARCH_BITS_DEFS)
5699	TEMPLATE_VBoxR0Drv_USES += dtrace
5700	ifdef VBOX_WITH_DTRACE_R0DRV
5701	TEMPLATE_VBoxR0Drv_DTRACETOOL = VBoxTpG
5702	TEMPLATE_VBoxR0Drv_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R0DRV
5703	ifdef VBOX_WITH_NATIVE_DTRACE
5704	TEMPLATE_VBoxR0Drv_DEFS += VBOX_WITH_NATIVE_DTRACE
5705	endif
5706	else
5707	TEMPLATE_VBoxR0Drv_DTRACETOOL = VBoxTpG-Disabled
5708	endif
5709
5710	ifeq ($(KBUILD_TARGET),win)
5711	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_VCC_TOOL)
5712	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # for stddef.h ## @todo 8489: check if still needed
5713	TEMPLATE_VBoxR0Drv_SDKS = WINSDK10-UCRT-INCS
5714	endif
5715	TEMPLATE_VBoxR0Drv_RCDEFS = VBOX_SVN_REV=$(VBOX_SVN_REV) VBOX_SVN_REV_MOD_5K=$(expr $(VBOX_SVN_REV) % 50000)
5716	TEMPLATE_VBoxR0Drv_DEFS += _KERNEL_MODE=1 # Needed with W10 to access things like KeQueryInterruptTime
5717	TEMPLATE_VBoxR0Drv_DEFS.x86 = _X86_
5718	TEMPLATE_VBoxR0Drv_DEFS.x86 += NO_INTERLOCKED_INTRINSICS # Avoids intrisic VC/WDK trouble
5719	TEMPLATE_VBoxR0Drv_DEFS.x86 += WIN9X_COMPAT_SPINLOCK # Avoid multiply defined _KeInitializeSpinLock@4
5720	TEMPLATE_VBoxR0Drv_DEFS.amd64 = _AMD64_
5721	TEMPLATE_VBoxR0Drv_DEFS.amd64 += WIN9X_COMPAT_SPINLOCK # For Windows 8+ WDKs where it is no longer inlined but imported from ntoskrnl.
5722	TEMPLATE_VBoxR0Drv_DEFS.amd64 += NT_INLINE_IRQL NT_INLINE_GET_CURRENT_IRQL # Prevent W10 WDK from importing KeLowerIrql and KeGetCurrentIrql.
5723	TEMPLATE_VBoxR0Drv_DEFS.win = IPRT_NT_MAP_TO_ZW
5724	TEMPLATE_VBoxR0Drv_CXXFLAGS = -Zi -Zl -GR- -EHs- -GF -Gz -GS- $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_FP) -Gs4096 $(VBOX_VCC_OPT) \
5725	-Gy $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
5726	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
5727	TEMPLATE_VBoxR0Drv_CXXFLAGS += -Gw
5728	endif
5729	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
5730	TEMPLATE_VBoxR0Drv_CXXFLAGS += -Zc:inline
5731	endif
5732	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
5733	TEMPLATE_VBoxR0Drv_CXXFLAGS += /volatileMetadata-
5734	endif
5735	ifdef VBOX_WITH_MSC_ANALYZE_THIS
5736	TEMPLATE_VBoxR0Drv_CXXFLAGS += /analyze
5737	endif
5738	TEMPLATE_VBoxR0Drv_CFLAGS = $(TEMPLATE_VBoxR0Drv_CXXFLAGS)
5739	TEMPLATE_VBoxR0Drv_LDFLAGS = -Ignore:4197 \
5740	-Driver -Subsystem:NATIVE -Incremental:NO -Align:4096 -MapInfo:Exports -NoD -Release -Debug -Opt:Ref -Opt:Icf \
5741	$(VBOX_VCC_LD_GUARD_CF) \
5742	-Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
5743	-Stub:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
5744	ifdef VBOX_WITH_DTRACE_R0DRV
5745	TEMPLATE_VBoxR0Drv_LDFLAGS += -Merge:VTGPrLc.Data=VTGPrLc.Begin -Merge:VTGPrLc.End=VTGPrLc.Begin -Merge:VTGPrLc.Begin=VTGObj
5746	endif
5747	ifdef VBOX_SIGNING_MODE
5748	TEMPLATE_VBoxR0Drv_LDFLAGS += -IntegrityCheck
5749	endif
5750	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
5751	TEMPLATE_VBoxR0Drv_LDFLAGS += -EmitVolatileMetadata:NO
5752	endif
5753	TEMPLATE_VBoxR0Drv_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
5754	TEMPLATE_VBoxR0Drv_ORDERDEPS = $(VBOX_SIGN_DRIVER_ORDERDEPS)
5755	TEMPLATE_VBoxR0Drv_POST_CMDS = $(VBOX_SIGN_DRIVER_CMDS)
5756	endif
5757
5758	ifeq ($(KBUILD_TARGET),linux)
5759	TEMPLATE_VBoxR0Drv_TOOL = $(NO_SUCH_VARIABLE)
5760
5761	ifndef KERN_DIR
5762	ifndef KERN_VER
5763	KERN_VER := $(patsubst /lib/modules/%/build/.config,%,$(firstword $(shell LC_ALL=C ls -t /lib/modules/*/build/.config 2>/dev/null)))
5764	endif
5765	ifeq ($(KERN_VER),)
5766	KERN_VER := $(shell uname -r)
5767	endif
5768	KERN_DIR := /lib/modules/$(KERN_VER)/build
5769	endif
5770
5771	##
5772	## Generates a rule for test-building a linux kernel module (use evalcall2 to invoke).
5773	##
5774	## Since Linux KBuild will not abort due to undefined symbols when building
5775	## external modules we need to grep the error output ourselves. Since vboxdrv
5776	## and vboxguest respectively provide symbols that other modules use, we use
5777	## the rule target (tst*.run) to save those symbols so that KBuild can do its
5778	## checking.
5779	##
5780	## @param 1 Module name.
5781	## @param 2 The test build which symvers we need (empty if none)
5782	## @param 3 Save symvers if non-empty.
5783	##
5784	## @note Using the extra expansion to replace $(1), $(2) and $(3) before eval,
5785	## thus everything else needs escaped dollars.
5786	##
5787	if defined(VBOX_WITH_TESTCASES) \
5788	&& "$(KBUILD_HOST)" == "linux" \
5789	&& "$(KBUILD_HOST_ARCH)" == "$(KBUILD_TARGET_ARCH)" \
5790	&& !defined(VBOX_WITHOUT_LINUX_TEST_BUILDS) \
5791	&& !defined(VBOX_ONLY_SDK) \
5792	&& !defined(VBOX_ONLY_DOCS) \
5793	&& !defined(VBOX_ONLY_VALIDATIONKIT)
5794	define VBOX_LINUX_KMOD_TEST_BUILD_RULE_FN
5795	ifneq ($(KERN_DIR),)
5796	TESTING += $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5797	OTHERS += $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5798	OTHERS_CLEAN += $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5799	$$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run: \
5800	$$(if $(2),$$(PATH_TARGET)/tst$(2)$(subst /,_,$(KERN_DIR))_mod.run,) \
5801	$$$$($(1)_2_STAGE_TARGETS)
5802	$(QUIET)$$(call MSG_L1,Doing a test build of the $(1) kernel module)
5803	$(QUIET)$$(RM) -f -- "$$@"
5804	$(QUIET)$$(TEST) -n "$$($(1)_INST)"
5805	$(QUIET)$$(RM) -Rf -- "$$(PATH_TARGET)/tst$(1)_mod"
5806	$(QUIET)$$(MKDIR) -p -- "$$(PATH_TARGET)/tst$(1)_mod"
5807	$(QUIET)$$(CP) -R -- "$$(PATH_STAGE_BIN)/../$$($(1)_INST)" "$$(PATH_TARGET)/tst$(1)_mod/"
5808	+ $(QUIET)make KBUILD_VERBOSE=$(KBUILD_VERBOSE) KERN_DIR=$(KERN_DIR) VBOX_KERN_QUIET=1 \
5809	VBOX_KBUILD_TYPE=$(KBUILD_TYPE) VBOX_KBUILD_TARGET_ARCH=$(KBUILD_TARGET_ARCH) \
5810	KBUILD_TYPE= KBUILD_TARGET= KBUILD_TARGET_ARCH= KBUILD_TARGET_CPU= KBUILD_HOST= KBUILD_HOST_ARCH= KBUILD_HOST_CPU= \
5811	BUILD_TYPE= BUILD_TARGET= BUILD_TARGET_ARCH= BUILD_TARGET_CPU= BUILD_PLATFORM= BUILD_PLATFORM_ARCH= BUILD_PLATFORM_CPU= \
5812	-C $$(PATH_TARGET)/tst$(1)_mod clean
5813	ifneq ($(2),)
5814	$(QUIET)$$(CP) -f -- "$$<" "$$(PATH_TARGET)/tst$(1)_mod/Module.symvers"
5815	endif
5816	+ $(QUIET)$(REDIRECT_EXT) -d2=1 -w1 "$$(PATH_TARGET)/tst$(1)_mod/make.err" -- \
5817	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),) \
5818	VBOX_KBUILD_TYPE=$(KBUILD_TYPE) VBOX_KBUILD_TARGET_ARCH=$(KBUILD_TARGET_ARCH) \
5819	KBUILD_TYPE= KBUILD_TARGET= KBUILD_TARGET_ARCH= KBUILD_TARGET_CPU= KBUILD_HOST= KBUILD_HOST_ARCH= KBUILD_HOST_CPU= \
5820	BUILD_TYPE= BUILD_TARGET= BUILD_TARGET_ARCH= BUILD_TARGET_CPU= BUILD_PLATFORM= BUILD_PLATFORM_ARCH= BUILD_PLATFORM_CPU= \
5821	-C $$(PATH_TARGET)/tst$(1)_mod
5822	$(CAT) "$$(PATH_TARGET)/tst$(1)_mod/make.err"
5823	$(QUIET)! grep "^WARNING: .* undefined!$$$$" "$$(PATH_TARGET)/tst$(1)_mod/make.err"
5824	if1of ($(USERNAME), bird)
5825	- nm -u "$$(PATH_TARGET)/tst$(1)_mod/"*.ko \| sort
5826	endif
5827	ifneq ($(3),)
5828	$(QUIET)$$(CP) -f -- "$$(PATH_TARGET)/tst$(1)_mod/Module.symvers" "$$@"
5829	else
5830	$(QUIET)$$(APPEND) -t "$$@" "done"
5831	endif
5832	$(QUIET)$$(RM) -Rf -- "$$(PATH_TARGET)/tst$(1)_mod"
5833	vbox-linux-kmod-test-builds: $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5834	$$(foreach src,$$(notdir $$(filter %.c,$$(subst =>,/,$$($(1)_SOURCES)))),$$(patsubst %.c,%.o,$$(src))): $$(PATH_TARGET)/tst$(1)$(subst /,_,$(KERN_DIR))_mod.run
5835	endif
5836	endef # VBOX_LINUX_KMOD_TEST_BUILD_RULE_FN
5837	else
5838	VBOX_LINUX_KMOD_TEST_BUILD_RULE_FN =
5839	endif
5840	else
5841	VBOX_LINUX_KMOD_TEST_BUILD_RULE_FN =
5842	endif # linux target
5843
5844	ifeq ($(KBUILD_TARGET),os2)
5845	ifndef VBOX_USE_WATCOM_FOR_OS2
5846	TEMPLATE_VBoxR0Drv_TOOL = GXX3OMF
5847	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
5848	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
5849	TEMPLATE_VBoxR0Drv_LIBS = $(VBOX_GCC_LIBGCC)
5850	# wlink thinks physdevice doesn't need fixups and should have a stack - stupid!
5851	TEMPLATE_VBoxR0Drv_LDFLAGS = -Zlinker Option -Zlinker internalrelocs, -Zlinker togglerelocs
5852	else
5853	TEMPLATE_VBoxR0Drv_TOOL = OPENWATCOM
5854	TEMPLATE_VBoxR0Drv_CTOOL = OPENWATCOM
5855	TEMPLATE_VBoxR0Drv_CXXTOOL = OPENWATCOM
5856	TEMPLATE_VBoxR0Drv_LDTOOL = OPENWATCOM-WL
5857	TEMPLATE_VBoxR0Drv_ARTOOL = OPENWATCOM
5858	TEMPLATE_VBoxR0Drv_ASTOOL = NASM
5859	TEMPLATE_VBoxR0Drv_ASFLAGS = -fobj -DASM_FORMAT_OMF -D__NASM__ -w+orphan-labels #-g -F borland
5860	TEMPLATE_VBoxR0Drv_DEFS.os2 = #_OS2EMX_H
5861	TEMPLATE_VBoxR0Drv_INCS = \
5862	$(PATH_TOOL_OPENWATCOM)/h \
5863	$(PATH_TOOL_OPENWATCOM)/h/os2 \
5864	$(PATH_ROOT)/include \
5865	$(PATH_KLIBC_TRUNK)/libc/include # for os2ddk
5866	TEMPLATE_VBoxR0Drv_CFLAGS = -s -ze -w4 -hd -d1+ -nt=TEXT32 -nc=CODE -4 -of+
5867	TEMPLATE_VBoxR0Drv_CXXFLAGS = -s -ze -w4 -hd -d2t -nt=TEXT32 -nc=CODE -4 -of+
5868	TEMPLATE_VBoxR0Drv_LDFLAGS = \
5869	form os2 lx physdevice \
5870	option NODefaultlibs, internalrelocs, togglerelocs \
5871	debug dwarf all #option symfile
5872	# debug codeview all option symfile - wlink generates bad info, overwritten mod dir header.
5873	endif
5874	endif
5875
5876	ifeq ($(KBUILD_TARGET),darwin)
5877	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
5878	TEMPLATE_VBoxR0Drv_SDKS += $(VBOX_DARWIN_DEF_SDK_SDKS)
5879	TEMPLATE_VBoxR0Drv_DEFS += $(VBOX_DARWIN_DEF_SDK_DEFS) KERNEL KERNEL_PRIVATE DRIVER_PRIVATE APPLE NeXT
5880	if1of ($(VBOX_GCC_TOOL), GXX4MACHO GXX42MACHO)
5881	TEMPLATE_VBoxR0Drv_INCS += \
5882	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/Kernel.framework/PrivateHeaders \
5883	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/Kernel.framework/Headers
5884	## @todo try use VBOX_GCC_PEDANTIC_CXX
5885	TEMPLATE_VBoxR0Drv_CXXFLAGS = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS) \
5886	-g $(VBOX_GCC_pipe) $(VBOX_GCC_WARN) -Wno-long-long $(VBOX_GCC_fdiagnostics-show-option) \
5887	-fno-common -nostdinc -fno-builtin -finline $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) \
5888	-fno-keep-inline-functions -fno-exceptions -msoft-float \
5889	-fapple-kext -fno-rtti -fcheck-new -force_cpusubtype_ALL \
5890	$(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fasm-blocks
5891	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = -m64 -mkernel -mno-red-zone -gdwarf-2
5892	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = -m32 -static
5893	TEMPLATE_VBoxR0Drv_CFLAGS = $(VBOX_DARWIN_DEF_SDK_CFLAGS) \
5894	-g $(VBOX_GCC_pipe) $(VBOX_GCC_WARN) -Wno-long-long -fno-common -nostdinc -fno-builtin -finline \
5895	-fno-keep-inline-functions -fno-exceptions $(VBOX_GCC_fvisibility-hidden) -msoft-float \
5896	-Wmissing-prototypes -Wstrict-prototypes -Wmissing-declarations \
5897	-Werror-implicit-function-declaration -force_cpusubtype_ALL \
5898	$(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fasm-blocks
5899	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -mkernel -mno-red-zone -gdwarf-2
5900	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -static
5901	TEMPLATE_VBoxR0Drv_LDFLAGS = $(filter-out $(VBOX_DARWIN_NO_COMPACT_LINKEDIT),$(VBOX_DARWIN_DEF_SDK_LDFLAGS)) \
5902	-nostdlib -Wl,-kext,-new_linker -Wl,-Y,1455 -keep_private_extern
5903	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = -m64
5904	TEMPLATE_VBoxR0Drv_LDFLAGS.x86 = -m32
5905	TEMPLATE_VBoxR0Drv_LIBS = kmodc++ kmod cc_kext cpp_kext $(VBOX_GCC_LIBGCC)
5906	else
5907	# Note xcode uses -fstrict-aliasing, we currently don't dare... We also add -mno-red-zone.
5908	TEMPLATE_VBoxR0Drv_INCS += \
5909	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/Kernel.framework/PrivateHeaders \
5910	$(VBOX_PATH_MACOSX_SDK)/System/Library/Frameworks/Kernel.framework/Headers
5911	## @todo try use VBOX_GCC_PEDANTIC_CXX
5912	# -Wno-c++11-extensions -Wno-c99-extensions -Wno-extra-semi -Wno-zero-length-array
5913	TEMPLATE_VBoxR0Drv_CXXFLAGS = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS) -mkernel \
5914	-g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) -Wno-long-long $(VBOX_GCC_fdiagnostics-show-option) \
5915	-Wno-c++11-extensions -Wno-c99-extensions -Wno-extra-semi -Wno-zero-length-array \
5916	-Wno-gnu-zero-variadic-macro-arguments -Wno-four-char-constants \
5917	-fno-common -nostdinc -fno-builtin $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) \
5918	-fno-exceptions -fapple-kext -fno-rtti -mkernel \
5919	-fmodules -fmodules-prune-interval=86400 -fmodules-prune-after=345600 -Wnon-modular-include-in-framework-module \
5920	-Werror=non-modular-include-in-framework-module \
5921	$(VBOX_GCC_Wno-nullability-extension) $(VBOX_GCC_Wno-gnu-statement-expression) \
5922	$(VBOX_GCC_Wno-import-preprocessor-directive-pedantic) $(VBOX_GCC_Wno-c11-extensions) \
5923	$(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fasm-blocks -fno-strict-aliasing -stdlib=libc++
5924	# if1of ($(VBOX_GCC_TOOL), CLANGXXMACHO) ## @todo check if we can safely use $(VBOX_GCC_std) @bugref{9790}, good for noexcept.
5925	#TEMPLATE_VBoxR0Drv_CXXFLAGS += $(VBOX_GCC_std)
5926	# endif
5927	# also used by xcode 6.2: \
5928	# -Werror=return-type \
5929	# -Werror=deprecated-objc-isa-usage \
5930	# -Werror=objc-root-class \
5931	# -Wno-missing-field-initializers -Wno-missing-prototypes -Wunreachable-code \
5932	# -Wno-overloaded-virtual -Wno-exit-time-destructors -Wno-missing-braces -Wparentheses -Wswitch -Wunused-function \
5933	# -Wno-unused-label -Wno-unused-parameter -Wunused-variable -Wunused-value -Wempty-body \
5934	# -Wconditional-uninitialized -Wno-unknown-pragmas -Wno-shadow -Wno-four-char-constants \
5935	# -Wno-conversion -Wconstant-conversion -Wint-conversion -Wbool-conversion -Wenum-conversion \
5936	# -Wshorten-64-to-32 -Wno-newline-eof -Wno-c++11-extensions -Wdeprecated-declarations -Winvalid-offsetof -Wno-sign-conversion
5937	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = -m64 -msoft-float -mno-red-zone
5938	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = -m32 -msoft-float
5939	TEMPLATE_VBoxR0Drv_CXXFLAGS.arm64 = -m64 -fno-sanitize=vptr -target arm64e-apple-macos11.0
5940	TEMPLATE_VBoxR0Drv_CFLAGS = $(VBOX_DARWIN_DEF_SDK_CFLAGS) -mkernel \
5941	-g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) -Wno-long-long $(VBOX_GCC_fdiagnostics-show-option) \
5942	-fno-common -nostdinc -fno-builtin $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) \
5943	-fno-exceptions -fapple-kext -fno-rtti \
5944	-fmodules -fmodules-prune-interval=86400 -fmodules-prune-after=345600 -Wnon-modular-include-in-framework-module \
5945	-Werror=non-modular-include-in-framework-module $(VBOX_GCC_Wno-c11-extensions) \
5946	$(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fasm-blocks -fno-strict-aliasing
5947	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -msoft-float -mno-red-zone
5948	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -msoft-float
5949	TEMPLATE_VBoxR0Drv_CFLAGS.arm64 = -m64 -fno-sanitize=vptr -target arm64e-apple-macos11.0
5950	if 1
5951	TEMPLATE_VBoxR0Drv_CFLAGS += $(VBOX_GCC_WERR)
5952	TEMPLATE_VBoxR0Drv_CXXFLAGS += $(VBOX_GCC_WERR)
5953	endif
5954	TEMPLATE_VBoxR0Drv_LDFLAGS = $(filter-out $(VBOX_DARWIN_NO_COMPACT_LINKEDIT),$(VBOX_DARWIN_DEF_SDK_LDFLAGS)) \
5955	-nostdlib -stdlib=libc++ -Wl,-kext -Wl,-keep_private_externs
5956	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = -m64
5957	TEMPLATE_VBoxR0Drv_LDFLAGS.arm64 = -m64
5958	TEMPLATE_VBoxR0Drv_LDFLAGS.x86 = -m32
5959	TEMPLATE_VBoxR0Drv_LIBS = kmodc++ kmod cc_kext
5960	endif
5961	endif
5962
5963	ifeq ($(KBUILD_TARGET),solaris)
5964	## The Solaris /usr/platform/i86pc/include and /usr/include directories.
5965	VBOX_SOLARIS_SYS_INCS ?= /usr/platform/i86pc/include /usr/include
5966
5967	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
5968	TEMPLATE_VBoxR0Drv_DEFS += _MACHDEP _KERNEL _STRICT_STDC
5969	if $(VBOX_GCC_VERSION_CC) < 30400
5970	TEMPLATE_VBoxR0Drv_DEFS += RT_WITHOUT_PRAGMA_ONCE
5971	endif
5972	TEMPLATE_VBoxR0Drv_INCS = $(VBOX_SOLARIS_SYS_INCS)
5973	TEMPLATE_VBoxR0Drv_LDFLAGS = -r -dy
5974	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = $(if $(eq $(KBUILD_HOST),solaris),-64,-m elf_x86_64)
5975	# Exclude -Wall because of solaris headers' pragma ident warnings that gcc refuses to supress.
5976	TEMPLATE_VBoxR0Drv_CFLAGS = -Wpointer-arith -Winline $(VBOX_GCC_Wno-pointer-sign) \
5977	-Wmissing-prototypes -Wstrict-prototypes $(VBOX_GCC_fdiagnostics-show-option) \
5978	-Wshadow -Wuninitialized -Wunused-function -Wunused-label -Wunused-value -Wunused-variable \
5979	-Wformat -Wimplicit-int -Wimplicit-function-declaration -Werror-implicit-function-declaration -Wparentheses \
5980	-O2 -fno-omit-frame-pointer -ffreestanding -nodefaultlibs -fno-strict-aliasing -fno-common -std=c99
5981	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
5982	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -mno-sse -mno-mmx -mno-sse2 -mno-3dnow $(VBOX_GCC_msave-args) \
5983	-mno-red-zone -mcmodel=kernel $(if-expr defined(VBOX_GCC_USING_SOLARIS_AS),-Wa$(COMMA)-xmodel=kernel,) \
5984	-fno-reorder-blocks -fno-asynchronous-unwind-tables -funit-at-a-time
5985	TEMPLATE_VBoxR0Drv_CXXFLAGS = -Wpointer-arith \
5986	-Wshadow -Wuninitialized -Wunused-function -Wunused-label -Wunused-value -Wunused-variable -Wformat \
5987	-O2 -nodefaultlibs -fno-omit-frame-pointer -fno-strict-aliasing -fno-common -fno-exceptions -fno-rtti
5988	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.x86)
5989	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = $(TEMPLATE_VBoxR0Drv_CFLAGS.amd64)
5990	TEMPLATE_VBoxR0Drv_POST_CMDS = $(VBOX_SIGN_DRIVER_CMDS)
5991	endif # Solaris
5992
5993	ifeq ($(KBUILD_TARGET),freebsd)
5994	# x86 FreeBSD (6.2 or something):
5995	# cc -O2 -fno-strict-aliasing -pipe -Werror -D_KERNEL -DKLD_MODULE \
5996	# -nostdinc -I- -I. -I@ -I@/contrib/altq -I@/../include -I/usr/include \
5997	# -finline-limit=8000 -fno-common -mno-align-long-strings -mpreferred-stack-boundary=2 \
5998	# -mno-mmx -mno-3dnow -mno-sse -mno-sse2 -ffreestanding -Wall -Wredundant-decls -Wnested-externs \
5999	# -Wstrict-prototypes -Wmissing-prototypes -Wpointer-arith -Winline -Wcast-qual -fformat-extensions \
6000	# -std=c99 -c ../my.c
6001	# ld -d -warn-common -r -d -o my.kld my.o
6002	# :> export_syms
6003	# awk -f /usr/src/sys/modules/my/../../conf/kmod_syms.awk my.kld export_syms \| xargs -J% objcopy % my.kld
6004	# ld -Bsharable -d warn-commnon -o my.ko my.kld
6005	#
6006	# AMD64 FreeBSD (7.1):
6007	# cc -O2 -fno-strict-aliasing -pipe -D_KERNEL -DKLD_MODULE -std=c99 -nostdinc -I. -I@ -I@/contrib/altq \
6008	# -finline-limit=8000 --param inline-unit-growth=100 --param large-function-growth=1000 -fno-common \
6009	# -fno-omit-frame-pointer -mcmodel=kernel -mno-red-zone -mfpmath=387 -mno-sse -mno-sse2 -mno-mmx \
6010	# -mno-3dnow -msoft-float -fno-asynchronous-unwind-tables -ffreestanding \
6011	# -Wall -Wredundant-decls -Wnested-externs -Wstrict-prototypes -Wmissing-prototypes -Wpointer-arith -Winline -Wcast-qual -Wundef -Wno-pointer-sign \
6012	# -fformat-extensions -c /usr/src/sys/modules/my/../../dev/my/if_my.c
6013	# ld -d -warn-common -r -d -o if_my.ko if_my.o
6014	# :> export_syms
6015	# awk -f /usr/src/sys/modules/my/../../conf/kmod_syms.awk if_my.ko export_syms \| xargs -J% objcopy % if_my.ko
6016
6017	# Note: @ -> /usr/src/sys and machine -> /usr/src/sys/i386/include
6018
6019	## The location of the FreeBSD kernel source.
6020	VBOX_FREEBSD_SRC ?= /usr/src/sys
6021	## The FreeBSD /usr/include.
6022	VBOX_FREEBSD_SYS_INCS ?= /usr/include
6023
6024	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
6025	TEMPLATE_VBoxR0Drv_LDTOOL = FreeBsdKModLd
6026	TEMPLATE_VBoxR0Drv_DEFS += _KERNEL KLD_MODULE
6027	if $(VBOX_GCC_VERSION_CC) < 30400
6028	TEMPLATE_VBoxR0Drv_DEFS += RT_WITHOUT_PRAGMA_ONCE
6029	endif
6030	TEMPLATE_VBoxR0Drv_INCS = \
6031	$(VBOX_FREEBSD_SRC) \
6032	$(VBOX_FREEBSD_SRC)/contrib/altq \
6033	$(VBOX_FREEBSD_SRC)/contrib/ck/include \
6034	$(VBOX_FREEBSD_SRC)/../include \
6035	$(VBOX_FREEBSD_SYS_INCS)
6036	# omitting: -Wcast-qual, -Wredundant-decls
6037	TEMPLATE_VBoxR0Drv_CFLAGS = \
6038	$(VBOX_GCC_WARN) -Wpointer-arith -Winline $(VBOX_GCC_Wno-pointer-sign) $(VBOX_GCC_fdiagnostics-show-option) \
6039	-Wstrict-prototypes -Wmissing-prototypes -Wstrict-prototypes \
6040	-Wimplicit-function-declaration -Werror-implicit-function-declaration \
6041	-O2 -ffreestanding -fno-strict-aliasing -fno-common \
6042	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) \
6043	-nostdinc -std=c99
6044	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -mno-align-long-strings -mno-mmx -mno-3dnow -mno-sse -mno-sse2
6045	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -fno-omit-frame-pointer -mcmodel=kernel -mno-red-zone -mfpmath=387 \
6046	-mno-sse -mno-sse2 -mno-mmx -mno-3dnow -msoft-float -fno-asynchronous-unwind-tables -Wundef
6047	TEMPLATE_VBoxR0Drv_CXXFLAGS = -fno-exceptions -fno-rtti \
6048	$(VBOX_GCC_WARN) -Wpointer-arith -Winline \
6049	-O2 -fno-strict-aliasing -fno-common \
6050	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) \
6051	-nostdinc
6052	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.x86)
6053	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = $(TEMPLATE_VBoxR0Drv_CFLAGS.amd64)
6054	TEMPLATE_VBoxR0Drv_SYSSUFF = .ko
6055	TEMPLATE_VBoxR0Drv_LDFLAGS = -d --warn-common
6056	TEMPLATE_VBoxR0Drv_LDFLAGS.x86 = -m elf_i386_fbsd
6057	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = -m elf_x86_64_fbsd
6058
6059	TOOL_FreeBsdKModLd = FreeBSD kernel module linker.
6060	# See kBuild/tools/GCC3.kmk for docs.
6061	TOOL_FreeBsdKModLd_LINK_SYSMOD_OUTPUT_MAYBE = $(outbase).map
6062	TOOL_FreeBsdKModLd_LINK_SYSMOD_DEPEND = $(foreach lib,$(libs),$(if $(findstring $(lib),$(subst /,x,$(lib))),, $(lib)))
6063	TOOL_FreeBsdKModLd_LINK_SYSMOD_DEPORD =
6064	ifeq ($(KBUILD_TARGET_ARCH),amd64)
6065	TOOL_FreeBsdKModLd_LINK_SYSMOD_OUTPUT =
6066	define TOOL_FreeBsdKModLd_LINK_SYSMOD_CMDS
6067	# Link intermediate .kld (a relocatable object).
6068	ld $(flags) -r -o $(out) $(objs) \
6069	$(foreach p,$(libpath), -L$(p))\
6070	$(foreach lib,$(libs), $(if $(findstring $(lib),$(subst /,x,$(lib))), -l$(patsubst lib%,%,$(basename $(lib))), $(lib)))
6071	# Strip non-exported symbols private and localize the exported ones.
6072	awk -f $(VBOX_FREEBSD_SRC)/conf/kmod_syms.awk $(out) $(if $(othersrc), $(othersrc),/dev/null) \
6073	\| xargs -J% objcopy % $(out)
6074
6075	## Strip debug info (comment out if debugging or something).
6076	objcopy --strip-debug $(out)
6077	endef
6078	else # x86
6079	TOOL_FreeBsdKModLd_LINK_SYSMOD_OUTPUT = $(outbase).kld
6080	define TOOL_FreeBsdKModLd_LINK_SYSMOD_CMDS
6081	# Link intermediate .kld (a relocatable object).
6082	ld $(flags) -r -o $(outbase).kld $(objs) \
6083	$(foreach p,$(libpath), -L$(p))\
6084	$(foreach lib,$(libs), $(if $(findstring $(lib),$(subst /,x,$(lib))), -l$(patsubst lib%,%,$(basename $(lib))), $(lib)))
6085	# Strip non-exported symbols private and localize the exported ones.
6086	awk -f $(VBOX_FREEBSD_SRC)/conf/kmod_syms.awk $(outbase).kld $(if $(othersrc), $(othersrc),/dev/null) \
6087	\| xargs -J% objcopy % $(outbase).kld
6088
6089	# Link the final .ko (a shared object).
6090	ld $(flags) -Bshareable -o $(out) $(outbase).kld
6091	endef
6092	endif # x86
6093
6094	endif # FreeBSD
6095
6096	ifeq ($(KBUILD_TARGET),netbsd)
6097
6098	# The location of the NetBSD sources.
6099	VBOX_NETBSD_SRC ?= /usr/src
6100
6101	# NetBSD uses "i386" for 32-bit, "x86" for common 32- and 64-bit code.
6102	ifeq ($(KBUILD_TARGET_ARCH),amd64)
6103	VBOX_NETBSD_TARGET_ARCH = amd64
6104	else
6105	VBOX_NETBSD_TARGET_ARCH = i386
6106	endif
6107
6108	VBOX_NETBSD_TARGET_SRC = $(VBOX_NETBSD_SRC)/sys/arch/$(VBOX_NETBSD_TARGET_ARCH)
6109
6110	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
6111	TEMPLATE_VBoxR0Drv_DEFS += _KERNEL _MODULE
6112	if $(VBOX_GCC_VERSION_CC) < 30400
6113	TEMPLATE_VBoxR0Drv_DEFS += RT_WITHOUT_PRAGMA_ONCE
6114	endif
6115	TEMPLATE_VBoxR0Drv_INCS = \
6116	$(VBOX_NETBSD_SRC)/sys \
6117	$(VBOX_NETBSD_SRC)/common/include \
6118	$(PATH_OBJ)/netbsd/include
6119
6120	TEMPLATE_VBoxR0Drv_CFLAGS = \
6121	$(VBOX_GCC_WARN) -Wpointer-arith -Winline $(VBOX_GCC_Wno-pointer-sign) \
6122	$(VBOX_GCC_fdiagnostics-show-option) \
6123	-Wstrict-prototypes -Wmissing-prototypes -Wstrict-prototypes \
6124	-Wimplicit-function-declaration -Werror-implicit-function-declaration \
6125	-O2 -ffreestanding -fno-strict-aliasing -fno-common -finline-limit=8000 \
6126	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) \
6127	-nostdinc -std=c99 -msoft-float
6128	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -mno-mmx -mno-sse -mno-avx \
6129	-mno-fp-ret-in-387
6130	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 --param inline-unit-growth=100 \
6131	--param large-function-growth=1000 -fno-omit-frame-pointer \
6132	-mcmodel=kernel -mno-red-zone -mno-sse -mno-mmx -mno-avx \
6133	-fno-asynchronous-unwind-tables -mno-fp-ret-in-387
6134	TEMPLATE_VBoxR0Drv_CXXFLAGS = -fno-exceptions -fno-rtti \
6135	$(VBOX_GCC_WARN) -Wpointer-arith -Winline \
6136	-O2 -fno-strict-aliasing -fno-common -finline-limit=8000 \
6137	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) \
6138	-nostdinc -msoft-float
6139	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.x86)
6140	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = $(TEMPLATE_VBoxR0Drv_CFLAGS.amd64)
6141	TEMPLATE_VBoxR0Drv_SYSSUFF = .kmod
6142	TEMPLATE_VBoxR0Drv_LDFLAGS = -d --warn-common
6143	TEMPLATE_VBoxR0Drv_LDFLAGS.x86 = -m elf_i386
6144	TEMPLATE_VBoxR0Drv_LDFLAGS.amd64 = -m elf_x86_64
6145
6146	# symlink kernel includes
6147	TEMPLATE_VBoxR0Drv_ORDERDEPS += \
6148	$(PATH_OBJ)/netbsd/include/$(VBOX_NETBSD_TARGET_ARCH) \
6149	$(PATH_OBJ)/netbsd/include/x86 \
6150	$(PATH_OBJ)/netbsd/include/machine
6151
6152	$$(PATH_OBJ)/netbsd/include/$(VBOX_NETBSD_TARGET_ARCH):
6153	$(QUIET)$(MKDIR) -p $(@D)
6154	$(QUIET)$(LN_SYMLINK) $(VBOX_NETBSD_TARGET_SRC)/include $@
6155
6156	$$(PATH_OBJ)/netbsd/include/x86:
6157	$(QUIET)$(MKDIR) -p $(@D)
6158	$(QUIET)$(LN_SYMLINK) $(VBOX_NETBSD_SRC)/sys/arch/x86/include $@
6159
6160	$$(PATH_OBJ)/netbsd/include/machine:
6161	$(QUIET)$(MKDIR) -p $(@D)
6162	$(QUIET)$(LN_SYMLINK) $(VBOX_NETBSD_TARGET_ARCH) $@
6163
6164	endif # NetBSD
6165
6166	ifeq ($(KBUILD_TARGET),haiku)
6167	## The Haiku include directories
6168	VBOX_HAIKU_SYS_INCS ?= /boot/develop/headers/os/kernel /boot/develop/headers/os/drivers
6169
6170	TEMPLATE_VBoxR0Drv_TOOL = $(VBOX_GCC_TOOL)
6171	TEMPLATE_VBoxR0Drv_LDTOOL = $(VBOX_GCC_TOOL)
6172	TEMPLATE_VBoxR0Drv_DEFS = _KERNEL_MODE=1 _STRICT_STDC IN_RING0 IN_RT_R0
6173	if $(VBOX_GCC_VERSION_CC) < 30400
6174	TEMPLATE_VBoxR0Drv_DEFS += RT_WITHOUT_PRAGMA_ONCE
6175	endif
6176	TEMPLATE_VBoxR0Drv_INCS = $(VBOX_HAIKU_SYS_INCS)
6177	#TODO: sort this out
6178	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
6179	TEMPLATE_VBoxR0Drv_CFLAGS = -fno-PIC \
6180	$(VBOX_GCC_WARN) -Wstrict-prototypes $(VBOX_GCC_Wno-pointer-sign) -Wno-sign-compare \
6181	$(VBOX_GCC_fno-stack-protector) $(VBOX_GCC_R0_OPT) $(VBOX_GCC_R0_FP) -fno-strict-aliasing -fno-common -Werror-implicit-function-declaration
6182	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
6183	TEMPLATE_VBoxR0Drv_CFLAGS.x86 = -m32 -mno-sse -mno-mmx -mno-sse2 -mno-3dnow
6184	TEMPLATE_VBoxR0Drv_CFLAGS.amd64 = -m64 -mno-sse -mno-mmx -mno-sse2 -mno-3dnow \
6185	-fno-reorder-blocks -ffreestanding -fno-asynchronous-unwind-tables -funit-at-a-time \
6186	-Wno-sign-compare
6187	TEMPLATE_VBoxR0Drv_CXXFLAGS = -fno-PIC -Wpointer-arith \
6188	-Wshadow -Wuninitialized -Wunused-function -Wunused-label -Wunused-value -Wunused-variable \
6189	-Wformat \
6190	-O2 -nodefaultlibs -fno-omit-frame-pointer -fno-strict-aliasing -fno-common -fno-exceptions -fno-rtti
6191	TEMPLATE_VBoxR0Drv_CXXFLAGS.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.x86) -fno-exceptions -fno-rtti
6192	TEMPLATE_VBoxR0Drv_CXXFLAGS.amd64 = $(TEMPLATE_VBoxR0Drv_CFLAGS.amd64) -fno-exceptions -fno-rtti
6193	endif # Haiku
6194
6195	ifdef VBOX_WITH_VBOXDRV
6196	ifndef TEMPLATE_VBoxR0Drv_TOOL
6197	$(warning Warning: VBox Build: Target $(KBUILD_HOST) is not officially supported!)
6198	endif
6199	endif
6200
6201	ifn1of ($(KBUILD_TARGET), darwin os2 win solaris freebsd)
6202	# This doesn't work if supdrv is natively loading VMMR0.r0 et al, but
6203	# fortunately it isn't really necessary.
6204	TEMPLATE_VBoxR0Drv_CFLAGS += -include $(PATH_ROOT)/include/VBox/SUPDrvMangling.h
6205	TEMPLATE_VBoxR0Drv_CXXFLAGS += -include $(PATH_ROOT)/include/VBox/SUPDrvMangling.h
6206	TEMPLATE_VBoxR0Drv_ASDEFS += RT_MANGLER_PREFIX=VBoxHost_
6207	endif
6208
6209	ifeq ($(KBUILD_TARGET),darwin)
6210	#
6211	# A variant of VBoxR0Drv that uses the 10.10 SDK.
6212	#
6213	TEMPLATE_VBoxR0DrvOSX10.10 = VBoxR0Drv variant using the 10.10 SDK
6214	TEMPLATE_VBoxR0DrvOSX10.10_EXTENDS = VBoxR0Drv
6215	TEMPLATE_VBoxR0DrvOSX10.10_SDKS = MACOSX1010
6216	TEMPLATE_VBoxR0DrvOSX10.10_INCS = $(filter-out $(VBOX_PATH_MACOSX_SDK)/%,$(TEMPLATE_VBoxR0Drv_INCS)) \
6217	$(PATH_SDK_MACOSX1010)/System/Library/Frameworks/Kernel.framework/PrivateHeaders \
6218	$(PATH_SDK_MACOSX1010)/System/Library/Frameworks/Kernel.framework/Headers
6219	TEMPLATE_VBoxR0DrvOSX10.10_DEFS = $(filter-out $(VBOX_DARWIN_DEF_SDK_DEFS),$(TEMPLATE_VBoxR0Drv_DEFS))
6220
6221	endif
6222
6223	#
6224	# Template for building libraries used by ring-0 drivers.
6225	#
6226	TEMPLATE_VBoxR0DrvLib = VBox Ring 0 Driver Library
6227	TEMPLATE_VBoxR0DrvLib_EXTENDS = VBoxR0Drv
6228	TEMPLATE_VBoxR0DrvLib_INSTTYPE = stage
6229	TEMPLATE_VBoxR0DrvLib_INSTTYPE.linux = stage
6230
6231	#
6232	# Template for installing INF and CAT files.
6233	#
6234	TEMPLATE_VBoxR0DrvInfCat = VBox SUPDRV Ring 0 - Install .sys, .cat, .inf
6235	TEMPLATE_VBoxR0DrvInfCat_INST = $(INST_BIN)
6236	TEMPLATE_VBoxR0DrvInfCat_MODE = a+r,u+w
6237	TEMPLATE_VBoxR0DrvInfCat_IFFLAGS = --no-hard-link-files-when-possible
6238
6239
6240	#
6241	# Template for building R3 executables and static libraries which are linked into executables.
6242	# Note! This is the base template for a whole lot of other ones, so be careful when changing it.
6243	#
6244	# Disabled Visual C++ warnings:
6245	# -wd4065: switch statement contains 'default' but no 'case' labels
6246	# -wd4244: 'conversion' conversion from 'type1' to 'type2', possible loss of data
6247	# -wd4996: deprecated / insecure.
6248	#
6249	TEMPLATE_VBoxR3Exe = VBox Ring 3 Exe
6250	TEMPLATE_VBoxR3Exe_ASTOOL := $(VBOX_ASTOOL)
6251	TEMPLATE_VBoxR3Exe_ASFLAGS.x86 = $(VBOX_ASFLAGS32)
6252	TEMPLATE_VBoxR3Exe_ASFLAGS.sparc32 = $(VBOX_ASFLAGS32)
6253	TEMPLATE_VBoxR3Exe_ASFLAGS.amd64 = $(VBOX_ASFLAGS64)
6254	TEMPLATE_VBoxR3Exe_ASFLAGS.arm64 = $(VBOX_ASFLAGS64)
6255	TEMPLATE_VBoxR3Exe_ASFLAGS.sparc64 = $(VBOX_ASFLAGS64)
6256	TEMPLATE_VBoxR3Exe_DEFS = IN_RING3 $(VBOX_GC_ARCH_BITS_DEFS)
6257	TEMPLATE_VBoxR3Exe_DEFS.x86 = HC_ARCH_BITS=32
6258	TEMPLATE_VBoxR3Exe_DEFS.arm32 = HC_ARCH_BITS=32
6259	TEMPLATE_VBoxR3Exe_DEFS.sparc32 = HC_ARCH_BITS=32
6260	TEMPLATE_VBoxR3Exe_DEFS.amd64 = HC_ARCH_BITS=64
6261	TEMPLATE_VBoxR3Exe_DEFS.arm64 = HC_ARCH_BITS=64
6262	TEMPLATE_VBoxR3Exe_DEFS.sparc64 = HC_ARCH_BITS=64
6263	TEMPLATE_VBoxR3Exe_DEFS.win = _CRT_SECURE_NO_DEPRECATE
6264	TEMPLATE_VBoxR3Exe_USES = dtrace
6265	if defined(VBOX_WITH_DTRACE_R3) && defined(VBOX_WITH_NATIVE_DTRACE)
6266	TEMPLATE_VBoxR3Exe_DTRACETOOL = DTraceAndVBoxTpG
6267	TEMPLATE_VBoxR3Exe_DTRACE_OBJ_FLAGS = -C
6268	TEMPLATE_VBoxR3Exe_DTRACE_HDR_FLAGS = -C
6269	TEMPLATE_VBoxR3Exe_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3 VBOX_WITH_NATIVE_DTRACE
6270	else
6271	TEMPLATE_VBoxR3Exe_DTRACE_HDR_FLAGS = --ring-3-context
6272	TEMPLATE_VBoxR3Exe_DTRACE_OBJ_FLAGS = --ring-3-context --pic --probe-fn-imported --probe-fn-name "SUPTracerFireProbe"
6273	if defined(VBOX_WITH_DTRACE_R3)
6274	TEMPLATE_VBoxR3Exe_DTRACETOOL = VBoxTpG
6275	TEMPLATE_VBoxR3Exe_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3
6276	else
6277	TEMPLATE_VBoxR3Exe_DTRACETOOL = VBoxTpG-Disabled
6278	endif
6279	endif
6280	TEMPLATE_VBoxR3Exe_LIBS.kprofile = $(LIB_KPROFILE)
6281	ifeq ($(KBUILD_TARGET),win)
6282	# TEMPLATE_VBoxR3Exe_TOOL = $(VBOX_VCC_TOOL)
6283	TEMPLATE_VBoxR3Exe_TOOL.win.x86 = $(VBOX_VCC_TOOL_STEM)X86
6284	TEMPLATE_VBoxR3Exe_TOOL.win.amd64 = $(VBOX_VCC_TOOL_STEM)AMD64
6285	TEMPLATE_VBoxR3Exe_RCDEFS = VBOX_SVN_REV=$(VBOX_SVN_REV) VBOX_SVN_REV_MOD_5K=$(expr $(VBOX_SVN_REV) % 50000)
6286	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
6287	TEMPLATE_VBoxR3Exe_SDKS = ReorderCompilerIncs WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER) $(VBOX_WINPSDK)
6288	else
6289	TEMPLATE_VBoxR3Exe_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK)
6290	endif
6291	TEMPLATE_VBoxR3Exe_CXXFLAGS = -Zi -Zl -GR- -EHsc -GF -MD$(VBOX_VCC_CRT_TYPE) $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_OPT) $(VBOX_VCC_FP) \
6292	-Gy $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS) $(VBOX_VCC_std) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
6293	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
6294	TEMPLATE_VBoxR3Exe_CXXFLAGS += -Gw
6295	endif
6296	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
6297	TEMPLATE_VBoxR3Exe_CXXFLAGS += -Zc:inline
6298	endif
6299	ifdef VBOX_WITH_MSC_ANALYZE_THIS
6300	TEMPLATE_VBoxR3Exe_CXXFLAGS += /analyze
6301	endif
6302	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
6303	TEMPLATE_VBoxR3Exe_CXXFLAGS += /volatileMetadata-
6304	endif
6305	TEMPLATE_VBoxR3Exe_CXXFLAGS.debug = -RTCsu
6306	TEMPLATE_VBoxR3Exe_CXXFLAGS.dbgopt = $(NO_SUCH_VARIABLE)
6307	TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile = -Gh -GH
6308	TEMPLATE_VBoxR3Exe_CFLAGS = $(filter-out $(VBOX_VCC_std),$(TEMPLATE_VBoxR3Exe_CXXFLAGS))
6309	TEMPLATE_VBoxR3Exe_CFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6310	TEMPLATE_VBoxR3Exe_CFLAGS.dbgopt = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.dbgopt)
6311	TEMPLATE_VBoxR3Exe_CFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6312	TEMPLATE_VBoxR3Exe_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6313	TEMPLATE_VBoxR3Exe_PCHFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6314	TEMPLATE_VBoxR3Exe_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.dbgopt)
6315	TEMPLATE_VBoxR3Exe_PCHFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6316	TEMPLATE_VBoxR3Exe_LDFLAGS = -Ignore:4197 \
6317	/NOD /INCREMENTAL:NO /MAPINFO:EXPORTS /LargeAddressAware /DynamicBase /NxCompat /Release /Debug /Opt:Ref /Opt:Icf \
6318	$(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS) \
6319	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
6320	/STUB:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com \
6321	/DISALLOWLIB:libc.lib \
6322	/DISALLOWLIB:libcd.lib \
6323	/DISALLOWLIB:libcmt.lib \
6324	/DISALLOWLIB:libcmtd.lib \
6325	/DISALLOWLIB:msvcrt$(VBOX_VCC_CRT_TYPE_N).lib \
6326	/DISALLOWLIB:msvcprt$(VBOX_VCC_CRT_TYPE_N).lib
6327	ifdef VBOX_WITH_DTRACE_R3
6328	TEMPLATE_VBoxR3Exe_LDFLAGS += -Merge:VTGPrLc.Data=VTGPrLc.Begin -Merge:VTGPrLc.End=VTGPrLc.Begin -Merge:VTGPrLc.Begin=VTGObj
6329	endif
6330	if defined(VBOX_SIGNING_MODE) && defined(VBOX_WITH_HARDENING)
6331	TEMPLATE_VBoxR3Exe_LDFLAGS += -IntegrityCheck
6332	endif
6333	TEMPLATE_VBoxR3Exe_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
6334	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
6335	TEMPLATE_VBoxR3Exe_LDFLAGS += -EmitVolatileMetadata:NO
6336	endif
6337
6338	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
6339	TEMPLATE_VBoxR3Exe_LIBS.x86 = \
6340	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
6341	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6342	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6343	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib
6344	TEMPLATE_VBoxR3Exe_LIBS.amd64 = \
6345	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
6346	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6347	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6348	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/oldnames.lib
6349	ifeq ($(KBUILD_TYPE),asan)
6350	TEMPLATE_VBoxR3Exe_LIBS.x86 += \
6351	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/clang_rt.asan_dynamic-i386.lib \
6352	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/clang_rt.asan_dynamic_runtime_thunk-i386.lib
6353	TEMPLATE_VBoxR3Exe_LIBS.amd64 += \
6354	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/clang_rt.asan_dynamic-x86_64.lib \
6355	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/clang_rt.asan_dynamic_runtime_thunk-x86_64.lib
6356	endif
6357	else
6358	TEMPLATE_VBoxR3Exe_LIBS.x86 = \
6359	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6360	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6361	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib
6362	TEMPLATE_VBoxR3Exe_LIBS.amd64 = \
6363	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6364	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6365	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.amd64)_LIB)/oldnames.lib
6366	endif
6367
6368	TEMPLATE_VBoxR3Exe_POST_CMDS = $(VBOX_UTF8_MANIFEST_CMDS)$(NLTAB)$(VBOX_SIGN_IMAGE_CMDS)
6369	TEMPLATE_VBoxR3Exe_ORDERDEPS = $(VBOX_SIGN_IMAGE_CMDS_ORDERDEPS)
6370	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
6371	TEMPLATE_VBoxR3Exe_POST_CMDS.win.x86 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION) $(out)$$(NLTAB)$(TEMPLATE_VBoxR3Exe_POST_CMDS))
6372	TEMPLATE_VBoxR3Exe_LNK_DEPS.win.x86 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION))
6373	TEMPLATE_VBoxR3Exe_LDFLAGS.win.x86 = \
6374	-Include:_vcc100_kernel32_fakes_cpp \
6375	-Include:_vcc100_kernel32_fakes_asm
6376	TEMPLATE_VBoxR3Exe_LIBS.win.x86 = \
6377	$(PATH_STAGE_LIB)/RuntimeR3VccTricks2$(VBOX_SUFF_LIB)
6378	TEMPLATE_VBoxR3Exe_LIBS.x86 = \
6379	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib \
6380	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6381	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
6382	endif
6383
6384	else # the gcc guys
6385	TEMPLATE_VBoxR3Exe_TOOL = $(VBOX_GCC_TOOL)
6386	if $(VBOX_GCC_VERSION_CC) < 30400
6387	TEMPLATE_VBoxR3Exe_DEFS += RT_WITHOUT_PRAGMA_ONCE
6388	endif
6389	TEMPLATE_VBoxR3Exe_CXXFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_OPT) \
6390	$(VBOX_GCC_FP) -fno-strict-aliasing $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_std) $(VBOX_GCC_fvisibility-inlines-hidden) \
6391	$(VBOX_GCC_IPRT_FMT_CHECK) $(VBOX_GCC_SANITIZER_FLAGS)
6392	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
6393	TEMPLATE_VBoxR3Exe_CXXFLAGS += $(VBOX_GCC_WERR)
6394	endif
6395	TEMPLATE_VBoxR3Exe_CXXFLAGS.x86 = -m32
6396	TEMPLATE_VBoxR3Exe_CXXFLAGS.amd64 = -m64
6397	TEMPLATE_VBoxR3Exe_CXXFLAGS.sparc32 = -m32
6398	TEMPLATE_VBoxR3Exe_CXXFLAGS.sparc64 = -m64
6399	TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile = -finstrument-functions
6400	TEMPLATE_VBoxR3Exe_CFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_OPT) \
6401	$(VBOX_GCC_FP) -fno-strict-aliasing $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_IPRT_FMT_CHECK)
6402	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
6403	TEMPLATE_VBoxR3Exe_CFLAGS += $(VBOX_GCC_WERR)
6404	endif
6405	TEMPLATE_VBoxR3Exe_CFLAGS.x86 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.x86)
6406	TEMPLATE_VBoxR3Exe_CFLAGS.amd64 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.amd64)
6407	TEMPLATE_VBoxR3Exe_CFLAGS.sparc32 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.sparc32)
6408	TEMPLATE_VBoxR3Exe_CFLAGS.sparc64 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.sparc64)
6409	TEMPLATE_VBoxR3Exe_CFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6410	TEMPLATE_VBoxR3Exe_CFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6411	TEMPLATE_VBoxR3Exe_OBJCFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS)
6412	TEMPLATE_VBoxR3Exe_OBJCFLAGS.x86 = $(TEMPLATE_VBoxR3Exe_CFLAGS.x86)
6413	TEMPLATE_VBoxR3Exe_OBJCFLAGS.amd64 = $(TEMPLATE_VBoxR3Exe_CFLAGS.amd64)
6414	TEMPLATE_VBoxR3Exe_OBJCFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CFLAGS.debug)
6415	TEMPLATE_VBoxR3Exe_OBJCFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CFLAGS.kprofile)
6416	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6417	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.x86 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.x86)
6418	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.amd64 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.amd64)
6419	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6420	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6421	TEMPLATE_VBoxR3Exe_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6422	TEMPLATE_VBoxR3Exe_PCHFLAGS.x86 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.x86)
6423	TEMPLATE_VBoxR3Exe_PCHFLAGS.amd64 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.amd64)
6424	TEMPLATE_VBoxR3Exe_PCHFLAGS.debug = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)
6425	TEMPLATE_VBoxR3Exe_PCHFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile)
6426	TEMPLATE_VBoxR3Exe_LDFLAGS = $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS)
6427	TEMPLATE_VBoxR3Exe_LDFLAGS.x86 = -m32
6428	TEMPLATE_VBoxR3Exe_LDFLAGS.amd64 = -m64
6429	TEMPLATE_VBoxR3Exe_LDFLAGS.sparc32 = -m32
6430	TEMPLATE_VBoxR3Exe_LDFLAGS.sparc64 = -m64
6431	TEMPLATE_VBoxR3Exe_LDFLAGS.linux = -Wl,-z,noexecstack,-z,relro $(VBOX_LD_as_needed)
6432	TEMPLATE_VBoxR3Exe_LDFLAGS.solaris = -Wl,-z,ignore # same as VBOX_LD_as_needed
6433
6434	ifeq ($(KBUILD_TARGET),linux)
6435	TEMPLATE_VBoxR3Exe_LIBS = pthread m rt dl
6436	else ifeq ($(KBUILD_TARGET),os2)
6437	TEMPLATE_VBoxR3Exe_TOOL = GXX3OMF
6438	TEMPLATE_VBoxR3Exe_LIBS = socket iconv
6439	else ifeq ($(KBUILD_TARGET),darwin)
6440	TEMPLATE_VBoxR3Exe_TOOL = $(VBOX_GCC_TOOL)
6441	TEMPLATE_VBoxR3Exe_LIBS =
6442	TEMPLATE_VBoxR3Exe_DEFS += LIBICONV_PLUG # Avoid 3rd party libiconv (from macports).
6443	TEMPLATE_VBoxR3Exe_SDKS.darwin = $(VBOX_DARWIN_DEF_SDK_SDKS)
6444	TEMPLATE_VBoxR3Exe_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_DEFS)
6445	TEMPLATE_VBoxR3Exe_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CFLAGS) -fno-common
6446	TEMPLATE_VBoxR3Exe_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
6447	TEMPLATE_VBoxR3Exe_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
6448	TEMPLATE_VBoxR3Exe_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_OBJCFLAGS)
6449	TEMPLATE_VBoxR3Exe_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS)
6450	TEMPLATE_VBoxR3Exe_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -Wl,-headerpad_max_install_names
6451	TEMPLATE_VBoxR3Exe_LDFLAGS.darwin.x86 = -read_only_relocs suppress
6452	TEMPLATE_VBoxR3Exe_POST_CMDS.darwin = $(VBOX_SIGN_IMAGE_CMDS)
6453	ifdef VBOX_WITH_DTRACE_R3
6454	TEMPLATE_VBoxR3Exe_CXXFLAGS := $(filter-out -pedantic,$(TEMPLATE_VBoxR3Exe_CXXFLAGS)) -fdollars-in-identifiers # annoying gcc option precedence.
6455	endif
6456	else ifeq ($(KBUILD_TARGET),haiku)
6457	TEMPLATE_VBoxR3Exe_TOOL = GXX3
6458	TEMPLATE_VBoxR3Exe_POST_CMDS = $(VBOX_HAIKU_XRES_SETVER_CMDS)
6459	TEMPLATE_VBoxR3Exe_LIBS = network iconv stdc++ supc++
6460	TEMPLATE_VBoxR3Exe_LIBPATH += \
6461	/boot/common/lib
6462	# Haiku uses PIC by default...
6463	TEMPLATE_VBoxR3Exe_CFLAGS += -fno-pic
6464	TEMPLATE_VBoxR3Exe_CXXFLAGS += -fno-pic
6465	TEMPLATE_VBoxR3Exe_LDFLAGS += -fno-pic
6466	else if1of ($(KBUILD_TARGET), freebsd openbsd)
6467	TEMPLATE_VBoxR3Exe_TOOL = GXX3
6468	TEMPLATE_VBoxR3Exe_LIBS = pthread
6469	TEMPLATE_VBoxR3Exe_INCS += \
6470	/usr/include \
6471	/usr/X11R6/include \
6472	/usr/local/include
6473	TEMPLATE_VBoxR3Exe_LIBPATH += \
6474	/usr/lib \
6475	/usr/X11R6/lib \
6476	/usr/local/lib
6477	else ifeq ($(KBUILD_TARGET),netbsd)
6478	TEMPLATE_VBoxR3Exe_TOOL = GXX3
6479	TEMPLATE_VBoxR3Exe_LIBS = pthread
6480	TEMPLATE_VBoxR3Exe_INCS += \
6481	/usr/include \
6482	/usr/X11R7/include
6483	TEMPLATE_VBoxR3Exe_LIBPATH += \
6484	/usr/lib \
6485	/usr/X11R7/lib
6486	else ifeq ($(KBUILD_TARGET),solaris)
6487	TEMPLATE_VBoxR3Exe_TOOL = GXX3PLAIN
6488	TEMPLATE_VBoxR3Exe_DEFS += LIBICONV_PLUG _REENTRANT # Avoid the GNU libiconv, for now at least.
6489	if $(VBOX_GCC_VERSION_CC) < 30500
6490	TEMPLATE_VBoxR3Exe_CFLAGS += -std=gnu99
6491	endif
6492	TEMPLATE_VBoxR3Exe_LIBS = rt socket
6493	else
6494	$(warning Warning: VBOX Build: Target $(KBUILD_TARGET) is not officially supported!)
6495	TEMPLATE_VBoxR3Exe_CXXFLAGS.profile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.release)
6496	TEMPLATE_VBoxR3Exe_CXXFLAGS.kprofile = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.krelease)
6497	endif
6498	ifdef VBOX_WITH_RUNPATH
6499	TEMPLATE_VBoxR3Exe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)'
6500	else ifdef VBOX_WITH_RELATIVE_RUNPATH
6501	TEMPLATE_VBoxR3Exe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)'
6502	endif
6503	ifdef VBOX_WITH_ORIGIN
6504	TEMPLATE_VBoxR3Exe_LDFLAGS.linux += $(VBOX_GCC_ORIGIN_OPT)
6505	endif
6506	endif
6507
6508	#
6509	# Template for building R3 shared objects / DLLs - base template, don't use directly.
6510	# This is mostly identical to the VBoxR3Exe template. (Avoid PIC if possible!)
6511	#
6512	## @todo Eliminate VBoxR3DllBase in favor of VBoxR3Dll.
6513	TEMPLATE_VBoxR3DllBase = VBox Ring 3 SO/DLLs Base Template - do not use directly!
6514	TEMPLATE_VBoxR3DllBase_EXTENDS = VBoxR3Exe
6515	TEMPLATE_VBoxR3DllBase_DEFS.darwin = $(TEMPLATE_VBoxR3Exe_DEFS.darwin) PIC
6516	TEMPLATE_VBoxR3DllBase_LDFLAGS.darwin = $(TEMPLATE_VBoxR3Exe_LDFLAGS.darwin) \
6517	-current_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
6518	-compatibility_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
6519	ifn1of ($(KBUILD_TARGET), darwin win os2)
6520	TEMPLATE_VBoxR3DllBase_DEFS = $(TEMPLATE_VBoxR3Exe_DEFS) PIC
6521	TEMPLATE_VBoxR3DllBase_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) -fPIC
6522	TEMPLATE_VBoxR3DllBase_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) -fPIC
6523	TEMPLATE_VBoxR3DllBase_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS) -fPIC
6524	TEMPLATE_VBoxR3DllBase_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS) -fPIC
6525	endif
6526
6527	#
6528	# Temporary: Renaming the template and warnings will be errors ("soon").
6529	#
6530	TEMPLATE_VBoxR3Dll = VBox ring-3 SO/DLLs, no warnings
6531	TEMPLATE_VBoxR3Dll_EXTENDS += VBoxR3DllBase
6532	TEMPLATE_VBoxR3Dll_EXTENDS_BY += appending
6533	ifeq ($(KBUILD_TARGET),win)
6534	TEMPLATE_VBoxR3Dll_CFLAGS += $(VBOX_VCC_WERR)
6535	TEMPLATE_VBoxR3Dll_CXXFLAGS += $(VBOX_VCC_WERR)
6536	TEMPLATE_VBoxR3Dll_PCHFLAGS += $(VBOX_VCC_WERR)
6537	TEMPLATE_VBoxR3Dll_LDFLAGS += $(VBOX_VCC_LD_WERR)
6538	else
6539	TEMPLATE_VBoxR3Dll_CFLAGS += $(VBOX_GCC_WERR)
6540	TEMPLATE_VBoxR3Dll_CXXFLAGS += $(VBOX_GCC_WERR)
6541	TEMPLATE_VBoxR3Dll_PCHFLAGS += $(VBOX_GCC_WERR)
6542	endif
6543
6544	# x86 edition of the above template for use on AMD64 targets.
6545	TEMPLATE_VBoxR3Dll-x86 = 32-bit VBox ring-3 SO/DLLs, no warnings
6546	TEMPLATE_VBoxR3Dll-x86_EXTENDS = VBoxR3Dll
6547	TEMPLATE_VBoxR3Dll-x86_BLD_TRG_ARCH = x86
6548	TEMPLATE_VBoxR3Dll-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxR3Dll_DEFS)) \
6549	HC_ARCH_BITS=32 ARCH_BITS=32
6550
6551
6552	#
6553	# Template for building performance critical stuff with warnings-as-errors.
6554	#
6555	TEMPLATE_VBoxR3DllNoPic = VBox ring-3 SO/DLLs without PIC, without warnings.
6556	TEMPLATE_VBoxR3DllNoPic_EXTENDS = VBoxR3DllBase
6557	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), linux.x86 freebsd.x86)
6558	TEMPLATE_VBoxR3DllNoPic_DEFS = $(TEMPLATE_VBoxR3Exe_DEFS)
6559	TEMPLATE_VBoxR3DllNoPic_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) $(VBOX_GCC_WERR)
6560	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) $(VBOX_GCC_WERR)
6561	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) $(VBOX_GCC_WERR)
6562	TEMPLATE_VBoxR3DllNoPic_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS)
6563	else ifeq ($(KBUILD_TARGET),win)
6564	TEMPLATE_VBoxR3DllNoPic_CFLAGS = $(filter-out -W3 -wd%,$(TEMPLATE_VBoxR3DllBase_CFLAGS)) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
6565	TEMPLATE_VBoxR3DllNoPic_CFLAGS.debug = $(filter-out -RTC%,$(TEMPLATE_VBoxR3DllBase_CFLAGS.debug))
6566	TEMPLATE_VBoxR3DllNoPic_CFLAGS.release = $(TEMPLATE_VBoxR3DllBase_CFLAGS.release) -GS-
6567	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS = $(filter-out -W3 -wd%,$(TEMPLATE_VBoxR3DllBase_CXXFLAGS)) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
6568	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS.debug = $(filter-out -RTC%,$(TEMPLATE_VBoxR3DllBase_CXXFLAGS.debug)) # RTCsu Prevents IEM opt.
6569	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS.release = $(TEMPLATE_VBoxR3DllBase_CXXFLAGS.release) -GS-
6570	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS = $(filter-out -W3 -wd%,$(TEMPLATE_VBoxR3DllBase_PCHFLAGS)) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
6571	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS.debug = $(filter-out -RTC%,$(TEMPLATE_VBoxR3DllBase_PCHFLAGS.debug)) # RTCsu Prevents IEM opt.
6572	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS.release = $(TEMPLATE_VBoxR3DllBase_PCHFLAGS.release) -GS-
6573	TEMPLATE_VBoxR3DllNoPic_LDFLAGS = $(TEMPLATE_VBoxR3DllBase_LDFLAGS) $(VBOX_VCC_LD_WERR)
6574	else
6575	TEMPLATE_VBoxR3DllNoPic_CFLAGS = $(TEMPLATE_VBoxR3DllBase_CFLAGS) $(VBOX_GCC_WERR)
6576	TEMPLATE_VBoxR3DllNoPic_CXXFLAGS = $(TEMPLATE_VBoxR3DllBase_CXXFLAGS) $(VBOX_GCC_WERR)
6577	TEMPLATE_VBoxR3DllNoPic_PCHFLAGS = $(TEMPLATE_VBoxR3DllBase_PCHFLAGS) $(VBOX_GCC_WERR)
6578	endif
6579
6580	# x86 edition of the above template for use on AMD64 targets.
6581	TEMPLATE_VBoxR3DllNoPic-x86 = 32-bit VBox ring-3 SO/DLLs without PIC, without warnings.
6582	TEMPLATE_VBoxR3DllNoPic-x86_EXTENDS = VBoxR3DllNoPic
6583	TEMPLATE_VBoxR3DllNoPic-x86_BLD_TRG_ARCH = x86
6584	TEMPLATE_VBoxR3DllNoPic-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxR3DllNoPic_DEFS)) \
6585	HC_ARCH_BITS=32 ARCH_BITS=32
6586
6587
6588	#
6589	# Template for building performance critical stuff without warnings-as-errors.
6590	#
6591	TEMPLATE_VBoxR3DllWarnNoPic = VBox ring-3 SO/DLLs without PIC, with warnings.
6592	TEMPLATE_VBoxR3DllWarnNoPic_EXTENDS = VBoxR3DllBase
6593	if1of ($(KBUILD_TARGET).$(KBUILD_TARGET_ARCH), linux.x86 freebsd.x86)
6594	TEMPLATE_VBoxR3DllWarnNoPic_DEFS = $(TEMPLATE_VBoxR3Exe_DEFS)
6595	TEMPLATE_VBoxR3DllWarnNoPic_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS)
6596	TEMPLATE_VBoxR3DllWarnNoPic_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6597	TEMPLATE_VBoxR3DllWarnNoPic_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS)
6598	TEMPLATE_VBoxR3DllWarnNoPic_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS)
6599	else ifeq ($(KBUILD_TARGET),win)
6600	TEMPLATE_VBoxR3DllWarnNoPic_CFLAGS.release = $(TEMPLATE_VBoxR3DllBase_CFLAGS.release) -GS-
6601	TEMPLATE_VBoxR3DllWarnNoPic_CXXFLAGS.release = $(TEMPLATE_VBoxR3DllBase_CXXFLAGS.release) -GS-
6602	TEMPLATE_VBoxR3DllWarnNoPic_PCHFLAGS.release = $(TEMPLATE_VBoxR3DllBase_PCHFLAGS.release) -GS-
6603	endif
6604
6605	#
6606	# Base template for building static R3 executables and any static
6607	# libraries they link with. Do _not_ use directly!
6608	#
6609	## @todo Bake this into VBoxR3Static.
6610	TEMPLATE_VBoxR3StaticBase = VBox Static Ring 3 EXE
6611	TEMPLATE_VBoxR3StaticBase_EXTENDS = VBoxR3Exe
6612	TEMPLATE_VBoxR3StaticBase_DEFS = IN_RT_STATIC IN_RT_R3 IN_SUP_STATIC $(TEMPLATE_VBoxR3Exe_DEFS)
6613	ifdef VBOX_WITH_NOCRT_STATIC
6614	TEMPLATE_VBoxR3StaticBase_DEFS += IPRT_NO_CRT
6615	TEMPLATE_VBoxR3StaticBase_INCS = $(PATH_ROOT)/include/iprt/nocrt $(TEMPLATE_VBoxR3Exe_INCS)
6616	endif
6617	ifeq ($(KBUILD_TARGET),win)
6618	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
6619	ifdef VBOX_WITH_NOCRT_STATIC
6620	TEMPLATE_VBoxR3StaticBase_SDKS = $(subst WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER),,$(TEMPLATE_VBoxR3Exe_SDKS))
6621	else
6622	TEMPLATE_VBoxR3StaticBase_SDKS = $(subst WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER), WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC,$(TEMPLATE_VBoxR3Exe_SDKS))
6623	endif
6624	endif
6625	ifdef VBOX_WITH_NOCRT_STATIC
6626	TEMPLATE_VBoxR3StaticBase_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE) -EHsc -GR, $(TEMPLATE_VBoxR3Exe_CFLAGS)) \
6627	-Zl -EHc-s- -Gy -GR-
6628	TEMPLATE_VBoxR3StaticBase_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE) -EHsc -GR, $(TEMPLATE_VBoxR3Exe_CXXFLAGS)) \
6629	-Zl -EHc-s- -Gy -GR-
6630	TEMPLATE_VBoxR3StaticBase_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE) -EHsc -GR, $(TEMPLATE_VBoxR3Exe_PCHFLAGS)) \
6631	-Zl -EHc-s- -Gy -GR-
6632	else
6633	TEMPLATE_VBoxR3StaticBase_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Exe_CFLAGS)) \
6634	-MT$(VBOX_VCC_CRT_TYPE) -Gy
6635	TEMPLATE_VBoxR3StaticBase_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Exe_CXXFLAGS)) \
6636	-MT$(VBOX_VCC_CRT_TYPE) -Gy
6637	TEMPLATE_VBoxR3StaticBase_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Exe_PCHFLAGS)) \
6638	-MT$(VBOX_VCC_CRT_TYPE) -Gy
6639	endif
6640
6641	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120" # Do not use SSE so valkit stuff can run on NT4 w/o needing a separate runtime library.
6642	TEMPLATE_VBoxR3StaticBase_CFLAGS.win.x86 = $(TEMPLATE_VBoxR3Exe_CFLAGS.win.86) /arch:IA32
6643	TEMPLATE_VBoxR3StaticBase_CXXFLAGS.win.x86 = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.win.86) /arch:IA32
6644	TEMPLATE_VBoxR3StaticBase_PCHFLAGS.win.x86 = $(TEMPLATE_VBoxR3Exe_PCHFLAGS.win.86) /arch:IA32
6645	TEMPLATE_VBoxR3StaticBase_CFLAGS += -Gw
6646	TEMPLATE_VBoxR3StaticBase_CXXFLAGS += -Gw
6647	TEMPLATE_VBoxR3StaticBase_PCHFLAGS += -Gw
6648	endif
6649
6650	ifdef VBOX_WITH_NOCRT_STATIC
6651	# .0000cfg normally merges into .idata, but the linker won't let us do so via /MERGE. Doesn't matter much,
6652	# because .idata can be writable when targeting x86 (NT 3.1 fun) and we don't want .0000cfg to be writable.
6653	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS) /NODEFAULTLIB /Merge:.0000cfg=.rdata
6654	else
6655	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(filter-out /DISALLOWLIB:libcmt$(VBOX_VCC_CRT_TYPE).lib /DISALLOWLIB:libcpmt$(VBOX_VCC_CRT_TYPE).lib, $(TEMPLATE_VBoxR3Exe_LDFLAGS))
6656	endif
6657	TEMPLATE_VBoxR3StaticBase_LDFLAGS += \
6658	/DISALLOWLIB:msvcrt.lib \
6659	/DISALLOWLIB:msvcrtd.lib \
6660	/DISALLOWLIB:msvcprt.lib \
6661	/DISALLOWLIB:msvcprtd.lib \
6662	/DISALLOWLIB:vcruntime.lib \
6663	/DISALLOWLIB:vcruntimed.lib \
6664	/DISALLOWLIB:ucrt.lib \
6665	/DISALLOWLIB:ucrtd.lib
6666	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
6667	ifdef VBOX_WITH_NOCRT_STATIC
6668	TEMPLATE_VBoxR3StaticBase_LIBS.amd64 = $(NO_SUCH_VARIABLE)
6669	TEMPLATE_VBoxR3StaticBase_LIBS.x86 = $(NO_SUCH_VARIABLE)
6670	else
6671	TEMPLATE_VBoxR3StaticBase_LIBS.x86 = \
6672	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libvcruntime$(VBOX_VCC_CRT_TYPE).lib \
6673	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6674	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
6675	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/oldnames.lib
6676	TEMPLATE_VBoxR3StaticBase_LIBS.amd64 = \
6677	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libvcruntime$(VBOX_VCC_CRT_TYPE).lib \
6678	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6679	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
6680	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/oldnames.lib
6681	endif
6682	ifeq ($(KBUILD_TYPE),asan)
6683	TEMPLATE_VBoxR3StaticBase_LIBS.x86 += \
6684	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/clang_rt.asan-i386.lib \
6685	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/clang_rt.asan_cxx-i386.lib
6686	TEMPLATE_VBoxR3StaticBase_LIBS.amd64 += \
6687	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/clang_rt.asan-x86_64.lib \
6688	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/clang_rt.asan_cxx-x86_64.lib
6689	endif
6690	else
6691	ifdef VBOX_WITH_NOCRT_STATIC
6692	TEMPLATE_VBoxR3StaticBase_LIBS.amd64 = $(NO_SUCH_VARIABLE)
6693	TEMPLATE_VBoxR3StaticBase_LIBS.x86 = $(NO_SUCH_VARIABLE)
6694	else
6695	TEMPLATE_VBoxR3StaticBase_LIBS.x86 = \
6696	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/oldnames.lib \
6697	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6698	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
6699	TEMPLATE_VBoxR3StaticBase_LIBS.amd64 = \
6700	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
6701	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
6702	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticBase_TOOL.win.amd64)_LIB)/oldnames.lib
6703	endif
6704	endif
6705	else
6706	ifdef VBOX_WITH_NOCRT_STATIC
6707	TEMPLATE_VBoxR3StaticBase_DEFS += RT_WITH_NOCRT_WRAPPERS
6708	endif
6709	ifn1of ($(KBUILD_TARGET), darwin linux solaris)
6710	# The gcc guys sans darwin, linux and solaris (don't depend on statically compiled system libs there)
6711	TEMPLATE_VBoxR3StaticBase_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) -static
6712	TEMPLATE_VBoxR3StaticBase_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) -static
6713	TEMPLATE_VBoxR3StaticBase_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS) -static
6714	TEMPLATE_VBoxR3StaticBase_OBJCFLAGS = $(TEMPLATE_VBoxR3Exe_OBJCFLAGS) -static
6715	TEMPLATE_VBoxR3StaticBase_OBJCXXFLAGS = $(TEMPLATE_VBoxR3Exe_OBJCXXFLAGS) -static
6716	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS) -static
6717	else ifeq ($(KBUILD_TARGET),solaris)
6718	TEMPLATE_VBoxR3StaticBase_LIBS = $(TEMPLATE_VBoxR3Exe_LIBS) nsl
6719	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)',$(TEMPLATE_VBoxR3Exe_LDFLAGS))
6720	else
6721	TEMPLATE_VBoxR3StaticBase_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)',$(TEMPLATE_VBoxR3Exe_LDFLAGS))
6722	endif
6723	ifn1of ($(KBUILD_TARGET), darwin os2) # ELF only. Present in gcc 3.2.3 & binutils 2.15, possibly earlier.
6724	ifdef VBOX_LD_gc_sections # Older solaris linker versions doesn't grok --gc-sections (e.g. add build box).
6725	ifndef TEMPLATE_VBoxR3StaticBase_CXXFLAGS
6726	TEMPLATE_VBoxR3StaticBase_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS)
6727	TEMPLATE_VBoxR3StaticBase_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS)
6728	endif
6729	TEMPLATE_VBoxR3StaticBase_CXXFLAGS += -ffunction-sections -fdata-sections
6730	TEMPLATE_VBoxR3StaticBase_CFLAGS += -ffunction-sections -fdata-sections
6731	TEMPLATE_VBoxR3StaticBase_LDFLAGS += $(VBOX_LD_gc_sections)
6732	endif
6733	endif
6734	endif
6735
6736	#
6737	# Temporary: Renaming the template and warnings will be errors (soon).
6738	# Unlike VBoxR3StaticBase, this is strict wrt warnings and includes IPRT.
6739	#
6740	TEMPLATE_VBoxR3Static = New name for VBoxR3StaticBase
6741	TEMPLATE_VBoxR3Static_EXTENDS = VBoxR3StaticBase
6742	TEMPLATE_VBoxR3Static_EXTENDS_BY = appending
6743	TEMPLATE_VBoxR3Static_SDKS.$(KBUILD_TARGET_ARCH) += VBoxOpenSslStatic
6744	TEMPLATE_VBoxR3Static_SDKS.win += VBoxNtDll
6745	ifeq ($(KBUILD_TARGET),win)
6746	TEMPLATE_VBoxR3Static_CFLAGS += $(VBOX_VCC_WERR)
6747	TEMPLATE_VBoxR3Static_CXXFLAGS += $(VBOX_VCC_WERR)
6748	TEMPLATE_VBoxR3Static_PCHFLAGS += $(VBOX_VCC_WERR)
6749	TEMPLATE_VBoxR3Static_LDFLAGS += $(VBOX_VCC_LD_WERR)
6750	else
6751	TEMPLATE_VBoxR3Static_CFLAGS += $(VBOX_GCC_WERR)
6752	TEMPLATE_VBoxR3Static_CXXFLAGS += $(VBOX_GCC_WERR)
6753	TEMPLATE_VBoxR3Static_PCHFLAGS += $(VBOX_GCC_WERR)
6754	TEMPLATE_VBoxR3Static_LDFLAGS.darwin.arm64 += $(TEMPLATE_VBoxR3StaticBase_LDFLAGS.darwin.arm64) -framework IOKit
6755	endif
6756	TEMPLATE_VBoxR3Static_LIBS.$(KBUILD_TARGET_ARCH) += \
6757	$(VBOX_LIB_RUNTIME_STATIC)
6758	ifneq ($(KBUILD_TARGET_ARCH),x86)
6759	TEMPLATE_VBoxR3Static_LIBS.x86 += \
6760	$(VBOX_LIB_RUNTIME_STATIC_X86)
6761	endif
6762	ifndef SDK_VBoxLibXml2_LIBS
6763	TEMPLATE_VBoxR3Static_LIBS.$(KBUILD_TARGET_ARCH) += \
6764	$(PATH_STAGE_LIB)/VBox-libxml2-static$(VBOX_SUFF_LIB)
6765	endif
6766	if1of ($(KBUILD_TARGET), os2 win)
6767	TEMPLATE_VBoxR3Static_LIBS.$(KBUILD_TARGET_ARCH) += \
6768	$(SDK_VBoxLzf_STATIC_LIBS) \
6769	$(SDK_VBoxZlibStatic_LIBS) \
6770	$(SDK_VBoxLibLzmaStatic_LIBS)
6771	else
6772	TEMPLATE_VBoxR3Static_LIBS.$(KBUILD_TARGET_ARCH) += \
6773	$(SDK_VBoxLzf_LIBS) \
6774	$(SDK_VBoxZlib_LIBS) \
6775	$(SDK_VBoxLibLzma_LIBS)
6776	if1of ($(KBUILD_TARGET), darwin freebsd)
6777	TEMPLATE_VBoxR3Static_LIBS += iconv
6778	else ifeq ($(KBUILD_TARGET),solaris)
6779	TEMPLATE_VBoxR3Static_LIBS += kstat
6780	endif
6781	endif
6782
6783	#
6784	# A no-ASAN version of VBoxR3Static for things like that automatically executed tests.
6785	#
6786	TEMPLATE_VBoxR3StaticExeNoAsan = VBoxR3Static but w/o ASAN
6787	TEMPLATE_VBoxR3StaticExeNoAsan_EXTENDS = VBoxR3Static
6788	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" == "asan"
6789	TEMPLATE_VBoxR3StaticExeNoAsan_CFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3Static_CFLAGS))
6790	TEMPLATE_VBoxR3StaticExeNoAsan_CXXFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3Static_CXXFLAGS))
6791	TEMPLATE_VBoxR3StaticExeNoAsan_PCHFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3Static_PCHFLAGS))
6792	TEMPLATE_VBoxR3StaticExeNoAsan_LDFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxR3Static_LDFLAGS)) -InferAsanLibs:No
6793	TEMPLATE_VBoxR3StaticExeNoAsan_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_LIBS.x86)))
6794	TEMPLATE_VBoxR3StaticExeNoAsan_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_LIBS.amd64)))
6795	endif
6796
6797	#
6798	# A DLL capable version of VBoxR3Static
6799	#
6800	## @todo make VBoxR3StaticDll work on non-windows.
6801	TEMPLATE_VBoxR3StaticDll = VBox Static Ring-3 DLL
6802	TEMPLATE_VBoxR3StaticDll_EXTENDS = VBoxR3Static
6803	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" == "asan"
6804	TEMPLATE_VBoxR3StaticDll_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_LIBS.x86)))
6805	TEMPLATE_VBoxR3StaticDll_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_LIBS.amd64)))
6806	endif
6807
6808	#
6809	# A no-ASAN version of VBoxR3StaticDll for the installer helper DLL.
6810	#
6811	# Note! Not compatible with BLD_TRG_ARCH overrides yet.
6812	#
6813	TEMPLATE_VBoxR3StaticDllNoAsan = VBoxR3StaticDll but w/o ASAN
6814	TEMPLATE_VBoxR3StaticDllNoAsan_EXTENDS = VBoxR3StaticDll
6815	if "$(KBUILD_TARGET)" == "win" && "$(KBUILD_TYPE)" == "asan"
6816	TEMPLATE_VBoxR3StaticDllNoAsan_CFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3StaticDll_CFLAGS))
6817	TEMPLATE_VBoxR3StaticDllNoAsan_CXXFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3StaticDll_CXXFLAGS))
6818	TEMPLATE_VBoxR3StaticDllNoAsan_PCHFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_FLAGS) , $(TEMPLATE_VBoxR3StaticDll_PCHFLAGS))
6819	TEMPLATE_VBoxR3StaticDllNoAsan_LDFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxR3StaticDll_LDFLAGS)) -InferAsanLibs:No
6820	TEMPLATE_VBoxR3StaticDllNoAsan_LIBS.x86 = $(subst $(VBOX_LIB_RUNTIME_STATIC),$(VBOX_LIB_RUNTIME_STATIC_NO_ASAN),$(filter-out %clang_rt.asan_dll_thunk-i386.lib, $(TEMPLATE_VBoxR3StaticDll_LIBS.x86)))
6821	TEMPLATE_VBoxR3StaticDllNoAsan_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_LIBS.amd64)))
6822	endif
6823
6824
6825	#
6826	# Non-pedantic variation of VBoxR3Static
6827	#
6828	TEMPLATE_VBoxR3StaticNonPedantic = VBox Static Ring-3 EXE, non-pedantic.
6829	TEMPLATE_VBoxR3StaticNonPedantic_EXTENDS = VBoxR3Static
6830	ifeq ($(KBUILD_TARGET),win)
6831	TEMPLATE_VBoxR3StaticNonPedantic_CFLAGS = $(TEMPLATE_VBoxR3Static_CFLAGS) $(VBOX_VCC_NON_PEDANTIC)
6832	TEMPLATE_VBoxR3StaticNonPedantic_CXXFLAGS = $(TEMPLATE_VBoxR3Static_CXXFLAGS) $(VBOX_VCC_NON_PEDANTIC)
6833	TEMPLATE_VBoxR3StaticNonPedantic_PCHFLAGS = $(TEMPLATE_VBoxR3Static_PCHFLAGS) $(VBOX_VCC_NON_PEDANTIC)
6834	else # gcc:
6835	TEMPLATE_VBoxR3StaticNonPedantic_TOOL = $(VBOX_GCC_TOOL)
6836	TEMPLATE_VBoxR3StaticNonPedantic_CFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_C) ,$(TEMPLATE_VBoxR3Static_CFLAGS)) \
6837	$(VBOX_GCC_NON_PEDANTIC_CXX)
6838	TEMPLATE_VBoxR3StaticNonPedantic_CXXFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_CXX),$(TEMPLATE_VBoxR3Static_CXXFLAGS)) \
6839	$(VBOX_GCC_NON_PEDANTIC_CXX)
6840	TEMPLATE_VBoxR3StaticNonPedantic_PCHFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_CXX),$(TEMPLATE_VBoxR3Static_PCHFLAGS)) \
6841	$(VBOX_GCC_NON_PEDANTIC_CXX)
6842	endif
6843
6844	#
6845	# VBoxR3Static w/o any CRT (windows only atm, experimental).
6846	# Implies no fancy C++, no exceptions, no static constructors or destructors, ++.
6847	#
6848	# Note! Not compatible with BLD_TRG_ARCH overrides yet.
6849	#
6850	TEMPLATE_VBoxR3StaticNoCrt = Static
6851	TEMPLATE_VBoxR3StaticNoCrt_EXTENDS = VBoxR3Static
6852	TEMPLATE_VBoxR3StaticNoCrt_SDKS = $(subst WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC,WINSDK10-UCRT-INCS, $(TEMPLATE_VBoxR3Static_SDKS))
6853	TEMPLATE_VBoxR3StaticNoCrt_SDKS.$(KBUILD_TARGET_ARCH) = $(filter-out VBoxOpenSslStatic,$(TEMPLATE_VBoxR3Static_SDKS.$(KBUILD_TARGET_ARCH)))
6854	TEMPLATE_VBoxR3StaticNoCrt_DEFS = $(TEMPLATE_VBoxR3Static_DEFS) \
6855	RT_NO_CRT \
6856	IN_RT_STATIC
6857	ifndef VBOX_WITH_NOCRT_STATIC
6858	TEMPLATE_VBoxR3StaticNoCrt_DEFS.win = $(TEMPLATE_VBoxR3Static_DEFS.win) \
6859	RT_WITHOUT_NOCRT_WRAPPERS
6860	endif
6861	TEMPLATE_VBoxR3StaticNoCrt_LIBS = \
6862	$(PATH_STAGE_LIB)/RuntimeR3NoCrt$(VBOX_SUFF_LIB)
6863	ifeq ($(KBUILD_TARGET),win)
6864	TEMPLATE_VBoxR3StaticNoCrt_LIBS.x86 = $(NO_SUCH_VARIABLE)
6865	TEMPLATE_VBoxR3StaticNoCrt_LIBS.amd64 = $(NO_SUCH_VARIABLE)
6866	TEMPLATE_VBoxR3StaticNoCrt_LIBS.win = $(NO_SUCH_VARIABLE)
6867	ifdef VBOX_WITH_NOCRT_STATIC
6868	TEMPLATE_VBoxR3StaticNoCrt_LIBS.$(KBUILD_TARGET_ARCH) = \
6869	$(PATH_STAGE_LIB)/RuntimeR3NoCrt$(VBOX_SUFF_LIB)
6870	ifneq ($(KBUILD_TARGET_ARCH),x86)
6871	TEMPLATE_VBoxR3StaticNoCrt_LIBS.x86 = \
6872	$(PATH_STAGE_LIB)/RuntimeR3NoCrt-x86$(VBOX_SUFF_LIB) # place holder, we don't have this library
6873	endif
6874	else
6875	TEMPLATE_VBoxR3StaticNoCrt_LIBS.win.x86 = \
6876	$(PATH_TOOL_$(TEMPLATE_VBoxR3StaticNoCrt_TOOL.win.x86)_LIB)/chkstk.obj
6877	endif
6878	TEMPLATE_VBoxR3StaticNoCrt_LDFLAGS = $(filter-out $(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxR3Static_LDFLAGS))
6879	TEMPLATE_VBoxR3StaticNoCrt_LDFLAGS.win.x86 = $(filter-out -Include%, $(TEMPLATE_VBoxR3Static_LDFLAGS.win.x86))
6880	TEMPLATE_VBoxR3StaticNoCrt_CFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Static_CFLAGS)) /GS- -EHs-
6881	TEMPLATE_VBoxR3StaticNoCrt_CXXFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Static_CXXFLAGS)) /GS- -EHs-
6882	TEMPLATE_VBoxR3StaticNoCrt_PCHFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Static_PCHFLAGS)) /GS- -EHs-
6883	TEMPLATE_VBoxR3StaticNoCrt_CXXFLAGS.debug = $(filter-out /RTC% -RTC%, $(TEMPLATE_VBoxR3Static_CXXFLAGS.debug))
6884	else
6885	TEMPLATE_VBoxR3StaticNoCrt_CXXFLAGS = $(TEMPLATE_VBoxR3Static_CXXFLAGS) -fno-exceptions
6886	TEMPLATE_VBoxR3StaticNoCrt_PCHFLAGS = $(TEMPLATE_VBoxR3Static_PCHFLAGS) -fno-exceptions
6887	endif
6888
6889
6890	#
6891	# Executable w/o CRT (windows only atm, experimental).
6892	# Implies no fancy C++, no exceptions, no static constructors or destructors, ++.
6893	#
6894	TEMPLATE_VBoxR3StaticNoCrtExe := VBoxR3StaticNoCrt with EXE startup code calling a main() function
6895	TEMPLATE_VBoxR3StaticNoCrtExe_EXTENDS := VBoxR3StaticNoCrt
6896	TEMPLATE_VBoxR3StaticNoCrtExe_EXTENDS_BY := appending
6897	TEMPLATE_VBoxR3StaticNoCrtExe_LDFLAGS.win := /entry:CustomMainEntrypoint /subsystem:console
6898
6899
6900	#
6901	# Template for building hardened Ring-3 executables.
6902	# These shall have no extra runpaths, esp. not origin ones.
6903	#
6904	TEMPLATE_VBoxR3HardenedExe := Hardened VBox Ring-3 EXE
6905	TEMPLATE_VBoxR3HardenedExe_EXTENDS := VBoxR3Exe
6906	TEMPLATE_VBoxR3HardenedExe_DEBUG_INST.win = $(INST_DEBUG)hardened-exes/
6907	TEMPLATE_VBoxR3HardenedExe_DEFS = $(TEMPLATE_VBoxR3Exe_DEFS) RTMEM_NO_WRAP_TO_EF_APIS
6908	ifdef VBOX_WITH_HARDENING
6909	TEMPLATE_VBoxR3HardenedExe_LIBS = $(VBOX_LIB_SUPHARDENED) $(TEMPLATE_VBoxR3Exe_LIBS)
6910	else
6911	TEMPLATE_VBoxR3HardenedExe_LIBS = $(TEMPLATE_VBoxR3Exe_LIBS)
6912	endif
6913	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.darwin = $(TEMPLATE_VBoxR3Exe_LDFLAGS.darwin) -framework IOKit
6914	ifeq ($(KBUILD_TARGET),linux)
6915	# not necessary except USE_LIB_PCAP is defined in SUPR3HardenedMain.cpp
6916	# TEMPLATE_VBoxR3HardenedExe_LIBS += cap
6917	endif
6918	ifeq ($(KBUILD_TARGET),win) # No CRT!
6919	TEMPLATE_VBoxR3HardenedExe_SDKS = VBoxNtDll $(TEMPLATE_VBoxR3Exe_SDKS)
6920	ifneq ($(VBOX_VCC_LD_GUARD_CF),)
6921	TEMPLATE_VBoxR3HardenedExe_CXXFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_CXXFLAGS))
6922	TEMPLATE_VBoxR3HardenedExe_CXXFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)) #-O2 -Oy-
6923	TEMPLATE_VBoxR3HardenedExe_PCHFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_PCHFLAGS))
6924	TEMPLATE_VBoxR3HardenedExe_PCHFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_PCHFLAGS.debug)) #-O2 -Oy-
6925	TEMPLATE_VBoxR3HardenedExe_CFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_CFLAGS))
6926	TEMPLATE_VBoxR3HardenedExe_CFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxR3Exe_CFLAGS.debug)) -O2 -Oy-
6927	else
6928	TEMPLATE_VBoxR3HardenedExe_CXXFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_CXXFLAGS)) -GS-
6929	TEMPLATE_VBoxR3HardenedExe_CXXFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug)) -GS- #-O2 -Oy-
6930	TEMPLATE_VBoxR3HardenedExe_PCHFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_PCHFLAGS)) -GS-
6931	TEMPLATE_VBoxR3HardenedExe_PCHFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_PCHFLAGS.debug)) -GS- #-O2 -Oy-
6932	TEMPLATE_VBoxR3HardenedExe_CFLAGS = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_CFLAGS)) -GS-
6933	TEMPLATE_VBoxR3HardenedExe_CFLAGS.debug = $(filter-out -RTC% -GZ $(VBOX_VCC_SANITIZER_FLAGS) -GS,$(TEMPLATE_VBoxR3Exe_CFLAGS.debug)) -GS- -O2 -Oy-
6934	endif
6935	TEMPLATE_VBoxR3HardenedExe_LDFLAGS = $(filter-out $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxR3Exe_LDFLAGS)) \
6936	/DISALLOWLIB:msvcrt$(VBOX_VCC_CRT_TYPE).lib \
6937	/DISALLOWLIB:msvcprt$(VBOX_VCC_CRT_TYPE).lib \
6938	/DISALLOWLIB:vcruntime$(VBOX_VCC_CRT_TYPE).lib \
6939	/DISALLOWLIB:ucrt$(VBOX_VCC_CRT_TYPE).lib
6940	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.win.x86 = $(TEMPLATE_VBoxR3Exe_LDFLAGS.win.x86) /entry:suplibHardenedWindowsMain
6941	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.win.amd64 = $(TEMPLATE_VBoxR3Exe_LDFLAGS.win.amd64) /entry:suplibHardenedWindowsMain
6942	TEMPLATE_VBoxR3HardenedExe_LIBS.x86 = $(NOT_SUCH_VARIABLE)
6943	TEMPLATE_VBoxR3HardenedExe_LIBS.amd64 = $(NOT_SUCH_VARIABLE)
6944	TEMPLATE_VBoxR3HardenedExe_USES.win = $(TEMPLATE_VBoxR3Exe_USES.win) vboximportchecker
6945	TEMPLATE_VBoxR3HardenedExe_VBOX_IMPORT_CHECKER.win = noimports
6946	else ifn1of ($(KBUILD_TARGET), os2)
6947	ifneq ($(KBUILD_TYPE),asan) # Keep RPATH in asan builds so we can find libasan.so.X and libubsan.so.Y.
6948	TEMPLATE_VBoxR3HardenedExe_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)%,$(TEMPLATE_VBoxR3Exe_LDFLAGS))
6949	TEMPLATE_VBoxR3HardenedExe_LDFLAGS.linux = $(filter-out $(VBOX_GCC_ORIGIN_OPT),$(TEMPLATE_VBoxR3Exe_LDFLAGS.linux))
6950	endif
6951	endif
6952
6953	#
6954	# Template for building hardened Ring-3 libraries.
6955	#
6956	TEMPLATE_VBoxR3HardenedLib = Hardened VBox Ring-3 LIB
6957	TEMPLATE_VBoxR3HardenedLib_EXTENDS = VBoxR3HardenedExe
6958	TEMPLATE_VBoxR3HardenedLib_LIBS = $(NO_SUCH_VARIABLE)
6959	TEMPLATE_VBoxR3HardenedLib_USES.win = $(NO_SUCH_VARIABLE)
6960	TEMPLATE_VBoxR3HardenedLib_POST_CMDS = $(NO_SUCH_VARIABLE)
6961
6962
6963	#
6964	# Template for building hardened Ring-3 testcase executables.
6965	#
6966	TEMPLATE_VBoxR3HardenedTstExe = VBox Ring-3 Hardened Testcase Exe (currently windows only!)
6967	TEMPLATE_VBoxR3HardenedTstExe_EXTENDS = VBoxR3HardenedExe
6968	TEMPLATE_VBoxR3HardenedTstExe_INST = $(INST_TESTCASE)
6969
6970	#
6971	# Template for building hardened Ring-3 testcase DLLs (pairs with VBoxR3HardenedTstExe).
6972	#
6973	TEMPLATE_VBoxR3HardenedTstDll = VBox Ring-3 Hardened Testcase Dll (currently windows only!)
6974	TEMPLATE_VBoxR3HardenedTstDll_EXTENDS = VBoxR3TstDll
6975	TEMPLATE_VBoxR3HardenedTstDll_INST = $(INST_TESTCASE)
6976	TEMPLATE_VBoxR3HardenedTstDll_LDFLAGS.win = $(TEMPLATE_VBoxR3TstDll_LDFLAGS.win) -IntegrityCheck
6977	ifn1of ($(KBUILD_TARGET), win os2)
6978	TEMPLATE_VBoxR3HardenedTstDll_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)%,$(TEMPLATE_VBoxR3TstDll_LDFLAGS))
6979	TEMPLATE_VBoxR3HardenedTstDll_LDFLAGS.linux = $(filter-out $(VBOX_GCC_ORIGIN_OPT),$(TEMPLATE_VBoxR3TstDll_LDFLAGS.linux))
6980	endif
6981
6982	#
6983	# Template for building set-uid-to-root helper programs.
6984	# In hardened builds, these may only contain absolute runpaths!
6985	#
6986	TEMPLATE_VBoxR3SetUidToRoot = Set-uid-to-root helper program.
6987	if1of ($(KBUILD_TARGET), win)
6988	TEMPLATE_VBoxR3SetUidToRoot_EXTENDS = VBoxR3Exe
6989	else
6990	TEMPLATE_VBoxR3SetUidToRoot_EXTENDS = VBoxR3HardenedExe
6991	TEMPLATE_VBoxR3SetUidToRoot_LDFLAGS = $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS)
6992	endif
6993	TEMPLATE_VBoxR3SetUidToRoot_LIBS = $(NO_SUCH_VARIABLE)
6994	ifdef VBOX_WITH_RUNPATH
6995	TEMPLATE_VBoxR3SetUidToRoot_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)'
6996	endif
6997	ifndef VBOX_WITH_HARDENING
6998	ifdef VBOX_WITH_RELATIVE_RUNPATH
6999	TEMPLATE_VBoxR3SetUidToRoot_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)'
7000	endif
7001	ifdef VBOX_WITH_ORIGIN
7002	TEMPLATE_VBoxR3SetUidToRoot_LDFLAGS.linux += $(VBOX_GCC_ORIGIN_OPT)
7003	endif
7004	endif
7005
7006	#
7007	# Template for building R3 tools.
7008	#
7009	TEMPLATE_VBoxR3Tool = VBox Ring 3 Tools
7010	TEMPLATE_VBoxR3Tool_EXTENDS = VBoxR3Exe
7011	TEMPLATE_VBoxR3Tool_INST = $(VBOX_INST_TOOLS)
7012	ifeq ($(KBUILD_TARGET),win)
7013	TEMPLATE_VBoxR3Tool_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) $(VBOX_VCC_WERR)
7014	TEMPLATE_VBoxR3Tool_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) $(VBOX_VCC_WERR)
7015	TEMPLATE_VBoxR3Tool_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS) $(VBOX_VCC_WERR)
7016	TEMPLATE_VBoxR3Tool_LDFLAGS = $(TEMPLATE_VBoxR3Exe_LDFLAGS) $(VBOX_VCC_LD_WERR)
7017	else
7018	TEMPLATE_VBoxR3Tool_CFLAGS = $(TEMPLATE_VBoxR3Exe_CFLAGS) $(VBOX_GCC_WERR)
7019	TEMPLATE_VBoxR3Tool_CXXFLAGS = $(TEMPLATE_VBoxR3Exe_CXXFLAGS) $(VBOX_GCC_WERR)
7020	TEMPLATE_VBoxR3Tool_PCHFLAGS = $(TEMPLATE_VBoxR3Exe_PCHFLAGS) $(VBOX_GCC_WERR)
7021	ifdef VBOX_WITH_RUNPATH
7022	TEMPLATE_VBoxR3Tool_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' $(TEMPLATE_VBoxR3Exe_LDFLAGS)
7023	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7024	TEMPLATE_VBoxR3Tool_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..' $(TEMPLATE_VBoxR3Exe_LDFLAGS)
7025	endif
7026	endif
7027	TEMPLATE_VBoxR3Tool_LIBS = $(LIB_RUNTIME) $(TEMPLATE_VBoxR3Exe_LIBS)
7028	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
7029	TEMPLATE_VBoxR3Tool_LIBS.x86 = \
7030	$(PATH_STAGE_LIB)/RuntimeR3VccTricks2$(VBOX_SUFF_LIB) \
7031	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib
7032	endif
7033
7034
7035	#
7036	# Ring-3 testcase, running automatically during the build.
7037	# This is the VBoxR3Exe template only with a different install dir.
7038	#
7039	TEMPLATE_VBoxR3AutoTest = VBox Ring 3 Testcase Exe
7040	TEMPLATE_VBoxR3AutoTest_EXTENDS := VBoxR3Static
7041	TEMPLATE_VBoxR3AutoTest_SDKS.$(KBUILD_TARGET_ARCH) = $(filter-out VBoxOpenSslStatic,$(TEMPLATE_$(TEMPLATE_VBoxR3AutoTest_EXTENDS)_SDKS.$(KBUILD_TARGET_ARCH)))
7042	ifeq ($(KBUILD_TARGET),win)
7043	if "$(KBUILD_HOST_VERSION)" vlt "10.0.0.0.10240" # The windows ASAN requires windows 10 APIs to work.
7044	TEMPLATE_VBoxR3AutoTest_EXTENDS := VBoxR3StaticExeNoAsan
7045	endif
7046	ifdef VBOX_SIGNING_MODE
7047	TEMPLATE_VBoxR3AutoTest_LDFLAGS = $(filter-out -IntegrityCheck, $(TEMPLATE_$(TEMPLATE_VBoxR3AutoTest_EXTENDS)_LDFLAGS))
7048	TEMPLATE_VBoxR3AutoTest_POST_CMDS = $(NO_SUCH_VARIABLE)
7049	endif
7050	endif
7051	TEMPLATE_VBoxR3AutoTest_INST = $(INST_TESTCASE)
7052	TEMPLATE_VBoxR3AutoTest_LIBS.$(KBUILD_TARGET_ARCH) = $(filter-out \
7053	$(if-expr !defined(SDK_VBoxLibXml2_LIBS),$(PATH_STAGE_LIB)/VBox-libxml2-static$(VBOX_SUFF_LIB),) \
7054	$(if-expr "$(KBUILD_TARGET)" == "win" \|\| "$(KBUILD_TARGET)" == "os2" \
7055	,$(SDK_VBoxLzf_STATIC_LIBS) $(SDK_VBoxZlibStatic_LIBS) $(SDK_VBoxLibLzmaStatic_LIBS) \
7056	,$(SDK_VBoxLzf_LIBS) $(SDK_VBoxZlib_LIBS) $(SDK_VBoxLibLzma_LIBS)) \
7057	,$(TEMPLATE_$(TEMPLATE_VBoxR3AutoTest_EXTENDS)_LIBS.$(KBUILD_TARGET_ARCH)))
7058
7059	#
7060	# Ring-3 testcase.
7061	# This is the VBoxR3Exe template only with a different install dir.
7062	#
7063	TEMPLATE_VBoxR3TstExe = VBox Ring 3 Testcase Exe
7064	TEMPLATE_VBoxR3TstExe_EXTENDS = VBoxR3Exe
7065	TEMPLATE_VBoxR3TstExe_LIBS = $(LIB_RUNTIME) $(TEMPLATE_VBoxR3Exe_LIBS)
7066	TEMPLATE_VBoxR3TstExe_INST = $(INST_TESTCASE)
7067	ifdef VBOX_WITH_RUNPATH
7068	TEMPLATE_VBoxR3TstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' $(TEMPLATE_VBoxR3Exe_LDFLAGS)
7069	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7070	TEMPLATE_VBoxR3TstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..' $(TEMPLATE_VBoxR3Exe_LDFLAGS)
7071	endif
7072	if "$(KBUILD_TARGET)" == "win" && defined(VBOX_SIGNING_MODE)
7073	TEMPLATE_VBoxR3TstExe_POST_CMDS =
7074	TEMPLATE_VBoxR3TstExe_LDFLAGS = $(filter-out -IntegrityCheck, $(TEMPLATE_VBoxR3Exe_LDFLAGS))
7075	endif
7076	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
7077	TEMPLATE_VBoxR3TstExe_POST_CMDS.win.x86 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION) $(out))
7078	TEMPLATE_VBoxR3TstExe_LIBS.x86 = \
7079	$(PATH_STAGE_LIB)/RuntimeR3VccTricks2$(VBOX_SUFF_LIB) \
7080	$(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/oldnames.lib
7081	endif
7082
7083	# x86 version of VBoxR3TstExe
7084	TEMPLATE_VBoxR3TstExe-x86 := 32-bit VBox Ring 3 Testcase Exe
7085	TEMPLATE_VBoxR3TstExe-x86_EXTENDS := VBoxR3TstExe
7086	TEMPLATE_VBoxR3TstExe-x86_BLD_TRG_ARCH := x86
7087	TEMPLATE_VBoxR3TstExe-x86_LIBS = $(LIB_RUNTIME_X86) $(TEMPLATE_VBoxR3Exe_LIBS)
7088
7089	#
7090	# Ring-3 testcase DLL.
7091	#
7092	TEMPLATE_VBoxR3TstDll = VBox Ring-3 Testcase Dll
7093	TEMPLATE_VBoxR3TstDll_EXTENDS = VBoxR3TstExe
7094	ifn1of ($(KBUILD_TARGET), darwin win os2)
7095	TEMPLATE_VBoxR3TstDll_DEFS = $(TEMPLATE_VBoxR3TstExe_DEFS) PIC
7096	TEMPLATE_VBoxR3TstDll_CFLAGS = $(TEMPLATE_VBoxR3TstExe_CFLAGS) -fPIC
7097	TEMPLATE_VBoxR3TstDll_CXXFLAGS = $(TEMPLATE_VBoxR3TstExe_CXXFLAGS) -fPIC
7098	TEMPLATE_VBoxR3TstDll_PCHFLAGS = $(TEMPLATE_VBoxR3TstExe_PCHFLAGS) -fPIC
7099	TEMPLATE_VBoxR3TstDll_LDFLAGS = $(TEMPLATE_VBoxR3TstExe_LDFLAGS) -fPIC
7100	endif
7101
7102
7103	#
7104	# Template for building bad C/C++ style R3 shared libraries / Dlls (no -pedantic).
7105	# (Same transformation as for VBoxR3ExeNonPedantic.)
7106	#
7107	TEMPLATE_VBoxR3DllNonPedantic = VBox ring-3 Non-pedantic, with warnings.
7108	TEMPLATE_VBoxR3DllNonPedantic_EXTENDS = VBoxR3DllBase
7109	ifeq ($(KBUILD_TARGET),win)
7110	TEMPLATE_VBoxR3DllNonPedantic_CFLAGS = $(TEMPLATE_VBoxR3DllBase_CFLAGS) $(VBOX_VCC_NON_PEDANTIC)
7111	TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS = $(TEMPLATE_VBoxR3DllBase_CXXFLAGS) $(VBOX_VCC_NON_PEDANTIC)
7112	TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS = $(TEMPLATE_VBoxR3DllBase_PCHFLAGS) $(VBOX_VCC_NON_PEDANTIC)
7113	else # gcc:
7114	TEMPLATE_VBoxR3DllNonPedantic_TOOL = $(VBOX_GCC_TOOL)
7115	TEMPLATE_VBoxR3DllNonPedantic_CFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_C) ,$(TEMPLATE_VBoxR3DllBase_CFLAGS)) \
7116	$(VBOX_GCC_NON_PEDANTIC_C)
7117	TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_CXX),$(TEMPLATE_VBoxR3DllBase_CXXFLAGS)) \
7118	$(VBOX_GCC_NON_PEDANTIC_CXX)
7119	TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS = $(filter-out $(VBOX_GCC_WERR) $(VBOX_GCC_WARN_MASOCHISTIC) $(VBOX_GCC_PEDANTIC_CXX),$(TEMPLATE_VBoxR3DllBase_PCHFLAGS)) \
7120	$(VBOX_GCC_NON_PEDANTIC_CXX)
7121	endif
7122
7123	# x86 edition of the above template for use on AMD64 targets.
7124	TEMPLATE_VBoxR3DllNonPedantic-x86 = 32-bit VBox ring-3 SO/DLLs, no warnings
7125	TEMPLATE_VBoxR3DllNonPedantic-x86_EXTENDS = VBoxR3DllNonPedantic
7126	TEMPLATE_VBoxR3DllNonPedantic-x86_BLD_TRG_ARCH = x86
7127	TEMPLATE_VBoxR3DllNonPedantic-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxR3DllNonPedantic_DEFS)) \
7128	HC_ARCH_BITS=32 ARCH_BITS=32
7129
7130
7131	#
7132	# Same as VBoxR3DllNonPedantic, only it optimizes debug builds.
7133	#
7134	TEMPLATE_VBoxR3DllNonPedanticFast = VBox ring-3 Non-pedantic, with warnings, optimized debug.
7135	TEMPLATE_VBoxR3DllNonPedanticFast_EXTENDS = VBoxR3DllNonPedantic
7136	ifeq ($(KBUILD_TYPE),debug)
7137	ifeq ($(KBUILD_TARGET),win)
7138	TEMPLATE_VBoxR3DllNonPedanticFast_CFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3DllNonPedantic_CFLAGS)) -O2 -Oy-
7139	TEMPLATE_VBoxR3DllNonPedanticFast_CFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3DllNonPedantic_CFLAGS.debug))
7140	TEMPLATE_VBoxR3DllNonPedanticFast_CXXFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS)) -O2 -Oy-
7141	TEMPLATE_VBoxR3DllNonPedanticFast_CXXFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS.debug))
7142	TEMPLATE_VBoxR3DllNonPedanticFast_PCHFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS)) -O2 -Oy-
7143	TEMPLATE_VBoxR3DllNonPedanticFast_PCHFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS.debug))
7144	else
7145	TEMPLATE_VBoxR3DllNonPedanticFast_CFLAGS = $(TEMPLATE_VBoxR3DllNonPedantic_CFLAGS) -O2 -fno-omit-frame-pointer
7146	TEMPLATE_VBoxR3DllNonPedanticFast_CXXFLAGS = $(TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS) -O2 -fno-omit-frame-pointer
7147	TEMPLATE_VBoxR3DllNonPedanticFast_PCHFLAGS = $(TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS) -O2 -fno-omit-frame-pointer
7148	endif
7149	endif
7150
7151
7152	#
7153	# Template for building libraries that are linked into VBoxRT.dll
7154	# and it's variations, pedantic variation.
7155	#
7156	TEMPLATE_VBoxR3RuntimeDll = For libraries that are linked into VBoxRT.
7157	TEMPLATE_VBoxR3RuntimeDll_EXTENDS = VBoxR3Dll
7158	TEMPLATE_VBoxR3RuntimeDll_DEFS = $(TEMPLATE_VBoxR3Dll_DEFS) IN_RT_R3
7159	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
7160	TEMPLATE_VBoxR3RuntimeDll_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Dll_CFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7161	TEMPLATE_VBoxR3RuntimeDll_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Dll_CXXFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7162	TEMPLATE_VBoxR3RuntimeDll_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3Dll_PCHFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7163	TEMPLATE_VBoxR3RuntimeDll_LIBS.x86 = $(filter-out $(PATH_TOOL_$(TEMPLATE_VBoxR3Exe_TOOL.win.x86)_LIB)/%, $(TEMPLATE_VBoxR3Dll_LIBS.x86)) \
7164	$(PATH_TOOL_$(TEMPLATE_VBoxR3RuntimeDll_TOOL.win.x86)_LIB)/oldnames.lib \
7165	$(PATH_TOOL_$(TEMPLATE_VBoxR3RuntimeDll_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
7166	$(PATH_TOOL_$(TEMPLATE_VBoxR3RuntimeDll_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
7167	endif
7168
7169	#
7170	# Template for building libraries that are linked into VBoxRT.dll
7171	# and it's variations, non-pedantic variation.
7172	#
7173	TEMPLATE_VBoxR3RuntimeDllNonPedantic = For libraries that are linked into VBoxRT, but must be excluded from -pedantic warnings.
7174	TEMPLATE_VBoxR3RuntimeDllNonPedantic_EXTENDS = VBoxR3DllNonPedantic
7175	TEMPLATE_VBoxR3RuntimeDllNonPedantic_DEFS = $(TEMPLATE_VBoxR3DllNonPedantic_DEFS) IN_RT_R3
7176	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && $(KBUILD_TARGET_ARCH) == "x86"
7177	TEMPLATE_VBoxR3RuntimeDllNonPedantic_CFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic_CFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7178	TEMPLATE_VBoxR3RuntimeDllNonPedantic_CXXFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic_CXXFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7179	TEMPLATE_VBoxR3RuntimeDllNonPedantic_PCHFLAGS = $(filter-out -MD$(VBOX_VCC_CRT_TYPE), $(TEMPLATE_VBoxR3DllNonPedantic_PCHFLAGS)) -MT$(VBOX_VCC_CRT_TYPE)
7180	endif
7181
7182	#
7183	# Same as VBoxR3RuntimeDllNonPedantic, only it optimized debug builds too.
7184	#
7185	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast = For libraries that are linked into VBoxRT, but must be excluded from -pedantic warnings, optmized debug.
7186	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_EXTENDS = VBoxR3RuntimeDllNonPedantic
7187	ifeq ($(KBUILD_TYPE),debug)
7188	ifeq ($(KBUILD_TARGET),win)
7189	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CFLAGS)) -O2 -Oy-
7190	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CFLAGS.debug))
7191	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CXXFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CXXFLAGS)) -O2 -Oy-
7192	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CXXFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CXXFLAGS.debug))
7193	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_PCHFLAGS = $(filter-out -O0, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_PCHFLAGS)) -O2 -Oy-
7194	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_PCHFLAGS.debug = $(filter-out -RTC%, $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_PCHFLAGS.debug))
7195	else
7196	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CFLAGS = $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CFLAGS) -O2 -fno-omit-frame-pointer
7197	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_CXXFLAGS = $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_CXXFLAGS) -O2 -fno-omit-frame-pointer
7198	TEMPLATE_VBoxR3RuntimeDllNonPedanticFast_PCHFLAGS = $(TEMPLATE_VBoxR3RuntimeDllNonPedantic_PCHFLAGS) -O2 -fno-omit-frame-pointer
7199	endif
7200	endif
7201
7202
7203	#
7204	# Template for building executables that are part of the VBox Main component
7205	# (COM/XPCOM interface to VirtualBox).
7206	#
7207	TEMPLATE_VBoxMainExe = VBox Main Executable
7208	TEMPLATE_VBoxMainExe_ASTOOL := $(VBOX_ASTOOL)
7209	TEMPLATE_VBoxMainExe_ASFLAGS = $(VBOX_ASFLAGS)
7210	TEMPLATE_VBoxMainExe_DEFS = IN_RING3 UNICODE NDEBUG=1
7211	TEMPLATE_VBoxMainExe_DEFS.win = _UNICODE
7212	TEMPLATE_VBoxMainExe_RCDEFS = $(TEMPLATE_VBoxR3Exe_RCDEFS)
7213	TEMPLATE_VBoxMainExe_LIBS.kprofile = $(LIB_KPROFILE)
7214	TEMPLATE_VBoxMainExe_USES = dtrace
7215	if defined(VBOX_WITH_DTRACE_R3_MAIN) && defined(VBOX_WITH_NATIVE_DTRACE)
7216	TEMPLATE_VBoxMainExe_DTRACETOOL = DTraceAndVBoxTpG
7217	TEMPLATE_VBoxMainExe_DTRACE_OBJ_FLAGS = -C
7218	TEMPLATE_VBoxMainExe_DTRACE_HDR_FLAGS = -C
7219	TEMPLATE_VBoxMainExe_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3 VBOX_WITH_DTRACE_R3_MAIN VBOX_WITH_NATIVE_DTRACE
7220	else
7221	TEMPLATE_VBoxMainExe_DTRACE_HDR_FLAGS = --ring-3-context
7222	TEMPLATE_VBoxMainExe_DTRACE_OBJ_FLAGS = --ring-3-context --pic --probe-fn-imported --probe-fn-name "SUPTracerFireProbe"
7223	if defined(VBOX_WITH_DTRACE_R3_MAIN)
7224	TEMPLATE_VBoxMainExe_DTRACETOOL = VBoxTpG
7225	TEMPLATE_VBoxMainExe_DEFS += VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3 VBOX_WITH_DTRACE_R3_MAIN
7226	else
7227	TEMPLATE_VBoxMainExe_DTRACETOOL = VBoxTpG-Disabled
7228	endif
7229	endif
7230
7231	ifeq ($(KBUILD_TARGET),win)
7232	#TEMPLATE_VBoxMainExe_TOOL = $(VBOX_VCC_TOOL)
7233	TEMPLATE_VBoxMainExe_TOOL.win.x86 = $(VBOX_VCC_TOOL_STEM)X86
7234	TEMPLATE_VBoxMainExe_TOOL.win.amd64 = $(VBOX_VCC_TOOL_STEM)AMD64
7235	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
7236	TEMPLATE_VBoxMainExe_SDKS = ReorderCompilerIncs WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER) $(VBOX_WINPSDK) $(VBOX_WINDDK)
7237	else
7238	TEMPLATE_VBoxMainExe_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK) $(VBOX_WINDDK)
7239	endif
7240	TEMPLATE_VBoxMainExe_CXXFLAGS = -Zi -Zl -GR -EHsc -GF -MD$(VBOX_VCC_CRT_TYPE) $(VBOX_VCC_WCHAR_T_VARIANT) \
7241	$(VBOX_VCC_OPT) $(VBOX_VCC_FP) $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS) $(VBOX_VCC_std)
7242	# -wd4625: 'DisplaySourceBitmap' : copy constructor could not be generated because a base class copy constructor is inaccessible
7243	# -wd4626: 'DisplaySourceBitmap' : assignment operator could not be generated because a base class assignment operator is inaccessible
7244	# The two above can be cured by adding private: DECLARE_CLS_COPY_CTOR_ASSIGN_NOOP(xxxx); but too much work.
7245	# -wd4355: 'this' : used in base member initializer list (e.g. VirtualBoxBase.cpp)
7246	TEMPLATE_VBoxMainExe_CXXFLAGS += $(VBOX_VCC_WARN_ALL) -wd4625 -wd4626 -wd4355 $(VBOX_VCC_WERR)
7247	TEMPLATE_VBoxMainExe_CXXFLAGS += -Gy
7248	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
7249	TEMPLATE_VBoxMainExe_CXXFLAGS += -Gw
7250	endif
7251	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
7252	TEMPLATE_VBoxMainExe_CXXFLAGS += -Zc:inline
7253	endif
7254	ifdef VBOX_WITH_MSC_ANALYZE_THIS
7255	TEMPLATE_VBoxMainExe_CXXFLAGS += /analyze
7256	endif
7257	TEMPLATE_VBoxMainExe_CXXFLAGS.debug = -RTCsu
7258	TEMPLATE_VBoxMainExe_CXXFLAGS.dbgopt = $(NO_SUCH_VARIABLE)
7259	TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile = -Gh -GH
7260	TEMPLATE_VBoxMainExe_CFLAGS = $(filter-out $(VBOX_VCC_std),$(TEMPLATE_VBoxMainExe_CXXFLAGS))
7261	TEMPLATE_VBoxMainExe_CFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7262	TEMPLATE_VBoxMainExe_CFLAGS.dbgopt = $(TEMPLATE_VBoxMainExe_CXXFLAGS.dbgopt)
7263	TEMPLATE_VBoxMainExe_CFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7264	TEMPLATE_VBoxMainExe_PCHFLAGS = $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7265	TEMPLATE_VBoxMainExe_PCHFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7266	TEMPLATE_VBoxMainExe_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxMainExe_CXXFLAGS.dbgopt)
7267	TEMPLATE_VBoxMainExe_PCHFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7268	TEMPLATE_VBoxMainExe_LDFLAGS = -Ignore:4197 \
7269	/NOD /INCREMENTAL:NO /MAPINFO:EXPORTS /LargeAddressAware /DynamicBase /NxCompat /Release /Debug /Opt:Ref /Opt:Icf \
7270	$(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS) \
7271	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
7272	/STUB:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com \
7273	/DISALLOWLIB:libc.lib \
7274	/DISALLOWLIB:libcd.lib \
7275	/DISALLOWLIB:libcmt.lib \
7276	/DISALLOWLIB:libcmtd.lib \
7277	/DISALLOWLIB:msvcrt$(VBOX_VCC_CRT_TYPE_N).lib \
7278	/DISALLOWLIB:msvcprt$(VBOX_VCC_CRT_TYPE_N).lib \
7279	/DISALLOWLIB:vcruntime$(VBOX_VCC_CRT_TYPE_N).lib \
7280	/DISALLOWLIB:ucrt$(VBOX_VCC_CRT_TYPE_N).lib \
7281	/DISALLOWLIB:libvcruntime.lib \
7282	/DISALLOWLIB:libvcruntimed.lib \
7283	/DISALLOWLIB:libucrt.lib \
7284	/DISALLOWLIB:libucrtd.lib
7285	if defined(VBOX_SIGNING_MODE) && defined(VBOX_WITH_HARDENING)
7286	TEMPLATE_VBoxMainExe_LDFLAGS += -IntegrityCheck
7287	endif
7288	ifdef VBOX_WITH_DTRACE_R3_MAIN
7289	TEMPLATE_VBoxMainExe_LDFLAGS += -Merge:VTGPrLc.Data=VTGPrLc.Begin -Merge:VTGPrLc.End=VTGPrLc.Begin -Merge:VTGPrLc.Begin=VTGObj
7290	endif
7291	TEMPLATE_VBoxMainExe_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
7292	TEMPLATE_VBoxMainExe_LIBS = \
7293	$(LIB_RUNTIME)
7294	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
7295	TEMPLATE_VBoxMainExe_LIBS.x86 = \
7296	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
7297	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7298	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7299	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/oldnames.lib
7300	TEMPLATE_VBoxMainExe_LIBS.amd64 = \
7301	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/vcruntime$(VBOX_VCC_CRT_TYPE).lib \
7302	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7303	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7304	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/oldnames.lib
7305	ifeq ($(KBUILD_TYPE),asan)
7306	TEMPLATE_VBoxMainExe_LIBS.x86 += \
7307	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/clang_rt.asan_dynamic-i386.lib \
7308	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/clang_rt.asan_dynamic_runtime_thunk-i386.lib
7309	TEMPLATE_VBoxMainExe_LIBS.amd64 += \
7310	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/clang_rt.asan_dynamic-x86_64.lib \
7311	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/clang_rt.asan_dynamic_runtime_thunk-x86_64.lib
7312	endif
7313	else
7314	TEMPLATE_VBoxMainExe_LIBS.x86 = \
7315	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7316	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7317	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.x86)_LIB)/oldnames.lib
7318	TEMPLATE_VBoxMainExe_LIBS.amd64 = \
7319	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/msvcrt$(VBOX_VCC_CRT_TYPE).lib \
7320	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/msvcprt$(VBOX_VCC_CRT_TYPE).lib \
7321	$(PATH_TOOL_$(TEMPLATE_VBoxMainExe_TOOL.win.amd64)_LIB)/oldnames.lib
7322	endif
7323	TEMPLATE_VBoxMainExe_POST_CMDS = $(VBOX_UTF8_MANIFEST_CMDS)$(NLTAB)$(VBOX_SIGN_IMAGE_CMDS)
7324	TEMPLATE_VBoxMainExe_ORDERDEPS = $(VBOX_SIGN_IMAGE_CMDS_ORDERDEPS)
7325
7326	else # the GCC guys:
7327
7328	TEMPLATE_VBoxMainExe_TOOL = $(VBOX_GCC_TOOL)
7329	if $(VBOX_GCC_VERSION_CC) < 30400
7330	TEMPLATE_VBoxMainExe_DEFS += RT_WITHOUT_PRAGMA_ONCE
7331	endif
7332	TEMPLATE_VBoxMainExe_CXXFLAGS = -g $(VBOX_GCC_pipe) \
7333	$(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_Wno-multistatement-macros) $(VBOX_GCC_Wno-class-memaccess) -Wshadow \
7334	-fshort-wchar -fpermissive -fexceptions -frtti $(VBOX_GCC_OPT) $(VBOX_GCC_FP) -fno-strict-aliasing \
7335	$(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_std) $(VBOX_GCC_IPRT_FMT_CHECK) \
7336	$(VBOX_GCC_SANITIZER_FLAGS)
7337	if !defined("VBOX_GCC_Wno-delete-non-virtual-dtor") && defined("VBOX_GCC_Wno-non-virtual-dtor")
7338	TEMPLATE_VBoxMainExe_CXXFLAGS += $(VBOX_GCC_Wno-non-virtual-dtor)
7339	endif
7340	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
7341	TEMPLATE_VBoxMainExe_CXXFLAGS += $(VBOX_GCC_WERR)
7342	endif
7343	ifdef VBOX_WITH_DTRACE_R3_MAIN
7344	TEMPLATE_VBoxMainExe_CXXFLAGS := $(filter-out -pedantic,$(TEMPLATE_VBoxMainExe_CXXFLAGS)) -fdollars-in-identifiers # annoying gcc option precedence.
7345	endif
7346	TEMPLATE_VBoxMainExe_CXXFLAGS.x86 = -m32
7347	TEMPLATE_VBoxMainExe_CXXFLAGS.amd64 = -m64
7348	TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile = -finstrument-functions
7349	TEMPLATE_VBoxMainExe_CFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros) \
7350	$(VBOX_GCC_OPT) $(VBOX_GCC_FP) -fno-strict-aliasing $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_IPRT_FMT_CHECK) \
7351	$(VBOX_GCC_SANITIZER_FLAGS)
7352	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
7353	TEMPLATE_VBoxMainExe_CFLAGS += $(VBOX_GCC_WERR)
7354	endif
7355	TEMPLATE_VBoxMainExe_CFLAGS.x86 = -m32
7356	TEMPLATE_VBoxMainExe_CFLAGS.amd64 = -m64
7357	TEMPLATE_VBoxMainExe_CFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7358	TEMPLATE_VBoxMainExe_CFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7359	TEMPLATE_VBoxMainExe_OBJCFLAGS = $(TEMPLATE_VBoxMainExe_CFLAGS)
7360	TEMPLATE_VBoxMainExe_OBJCFLAGS.x86 = $(TEMPLATE_VBoxMainExe_CFLAGS.x86)
7361	TEMPLATE_VBoxMainExe_OBJCFLAGS.amd64 = $(TEMPLATE_VBoxMainExe_CFLAGS.amd64)
7362	TEMPLATE_VBoxMainExe_OBJCFLAGS.debug = $(TEMPLATE_VBoxMainExe_CFLAGS.debug)
7363	TEMPLATE_VBoxMainExe_OBJCFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CFLAGS.kprofile)
7364	TEMPLATE_VBoxMainExe_OBJCXXFLAGS = $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7365	TEMPLATE_VBoxMainExe_OBJCXXFLAGS.x86 = $(TEMPLATE_VBoxMainExe_CXXFLAGS.x86)
7366	TEMPLATE_VBoxMainExe_OBJCXXFLAGS.amd64 = $(TEMPLATE_VBoxMainExe_CXXFLAGS.amd64)
7367	TEMPLATE_VBoxMainExe_OBJCXXFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7368	TEMPLATE_VBoxMainExe_OBJCXXFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7369	TEMPLATE_VBoxMainExe_PCHFLAGS = $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7370	TEMPLATE_VBoxMainExe_PCHFLAGS.x86 = $(TEMPLATE_VBoxMainExe_CXXFLAGS.x86)
7371	TEMPLATE_VBoxMainExe_PCHFLAGS.amd64 = $(TEMPLATE_VBoxMainExe_CXXFLAGS.amd64)
7372	TEMPLATE_VBoxMainExe_PCHFLAGS.debug = $(TEMPLATE_VBoxMainExe_CXXFLAGS.debug)
7373	TEMPLATE_VBoxMainExe_PCHFLAGS.kprofile = $(TEMPLATE_VBoxMainExe_CXXFLAGS.kprofile)
7374	TEMPLATE_VBoxMainExe_LDFLAGS = $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS)
7375	TEMPLATE_VBoxMainExe_LDFLAGS.x86 = -m32
7376	TEMPLATE_VBoxMainExe_LDFLAGS.amd64 = -m64
7377	ifeq ($(KBUILD_TARGET),linux)
7378	TEMPLATE_VBoxMainExe_LIBS = pthread m rt $(LIB_RUNTIME) dl
7379	TEMPLATE_VBoxMainExe_LDFLAGS.linux = -Wl,-z,noexecstack,-z,relro $(VBOX_LD_as_needed)
7380	else ifeq ($(KBUILD_TARGET),os2)
7381	TEMPLATE_VBoxMainExe_TOOL = GXX3OMF
7382	TEMPLATE_VBoxMainExe_LIBS = $(LIB_RUNTIME)
7383	else ifeq ($(KBUILD_TARGET),darwin)
7384	TEMPLATE_VBoxMainExe_TOOL = $(VBOX_GCC_TOOL)
7385	TEMPLATE_VBoxMainExe_SDKS += $(VBOX_DARWIN_DEF_SDK_SDKS)
7386	TEMPLATE_VBoxMainExe_DEFS += $(VBOX_DARWIN_DEF_SDK_DEFS)
7387	TEMPLATE_VBoxMainExe_CFLAGS += $(VBOX_DARWIN_DEF_SDK_CFLAGS)
7388	TEMPLATE_VBoxMainExe_CXXFLAGS += $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
7389	TEMPLATE_VBoxMainExe_OBJCFLAGS += $(VBOX_DARWIN_DEF_SDK_OBJCFLAGS)
7390	TEMPLATE_VBoxMainExe_OBJCXXFLAGS += $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS)
7391	TEMPLATE_VBoxMainExe_LDFLAGS.darwin += -bind_at_load
7392	TEMPLATE_VBoxMainExe_LDFLAGS += $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -framework Carbon -Wl,-headerpad_max_install_names
7393	TEMPLATE_VBoxMainExe_LIBS = $(LIB_RUNTIME)
7394	TEMPLATE_VBoxMainExe_POST_CMDS.darwin = $(VBOX_SIGN_IMAGE_CMDS)
7395	else ifeq ($(KBUILD_TARGET),haiku)
7396	TEMPLATE_VBoxMainExe_TOOL = GXX3
7397	TEMPLATE_VBoxMainExe_LIBS = $(LIB_RUNTIME) network stdc++ supc++
7398	else if1of ($(KBUILD_TARGET), freebsd openbsd)
7399	TEMPLATE_VBoxMainExe_TOOL = GXX3
7400	TEMPLATE_VBoxMainExe_LIBS = $(LIB_RUNTIME)
7401	TEMPLATE_VBoxMainExe_INCS += \
7402	/usr/include \
7403	/usr/X11R6/include \
7404	/usr/local/include
7405	TEMPLATE_VBoxMainExe_LIBPATH += \
7406	/usr/lib \
7407	/usr/X11R6/lib \
7408	/usr/local/lib
7409	else ifeq ($(KBUILD_TARGET),netbsd)
7410	TEMPLATE_VBoxMainExe_TOOL = GXX3
7411	TEMPLATE_VBoxMainExe_LIBS = $(LIB_RUNTIME)
7412	TEMPLATE_VBoxMainExe_INCS += \
7413	/usr/include \
7414	/usr/X11R7/include
7415	TEMPLATE_VBoxMainExe_LIBPATH += \
7416	/usr/lib \
7417	/usr/X11R7/lib
7418	else ifeq ($(KBUILD_TARGET),solaris)
7419	TEMPLATE_VBoxMainExe_TOOL = GXX3PLAIN
7420	TEMPLATE_VBoxMainExe_DEFS += _REENTRANT
7421	TEMPLATE_VBoxMainExe_LIBS = $(LIB_RUNTIME) rt thread
7422	else
7423	$(warning Warning: VBOX Build: Target $(KBUILD_TARGET) is not officially supported!)
7424	TEMPLATE_VBoxMainExe_LIBS =
7425	endif
7426	TEMPLATE_VBoxMainExe_LDFLAGS.solaris = -Wl,-z,ignore # Same as VBOX_LD_as_needed.
7427	ifdef VBOX_WITH_RUNPATH
7428	TEMPLATE_VBoxMainExe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)'
7429	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7430	TEMPLATE_VBoxMainExe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)'
7431	endif
7432	ifdef VBOX_WITH_ORIGIN
7433	TEMPLATE_VBoxMainExe_LDFLAGS.linux += $(VBOX_GCC_ORIGIN_OPT)
7434	endif
7435
7436	endif # !win
7437
7438	# Add COM/XPCOM stuff
7439	TEMPLATE_VBoxMainExe_LIBS += \
7440	$(PATH_STAGE_LIB)/VBoxCOM$(VBOX_SUFF_LIB)
7441	ifdef VBOX_WITH_XPCOM
7442	## @todo may be worth creating the VBOX_XPCOM SDK def
7443	TEMPLATE_VBoxMainExe_DEFS += VBOX_WITH_XPCOM
7444	ifdef VBOX_WITH_XPCOM_NAMESPACE_CLEANUP
7445	TEMPLATE_VBoxMainExe_DEFS += VBOX_WITH_XPCOM_NAMESPACE_CLEANUP
7446	endif
7447	TEMPLATE_VBoxMainExe_INCS += \
7448	$(VBOX_XPCOM_INCS)
7449	TEMPLATE_VBoxMainExe_LIBS += \
7450	$(LIB_XPCOM)
7451	TEMPLATE_VBoxMainExe_INTERMEDIATES += \
7452	$(VBOX_PATH_SDK)/bindings/xpcom/include/VirtualBox_XPCOM.h
7453
7454	else # COM
7455	TEMPLATE_VBoxMainExe_INCS += \
7456	$(VBOX_PATH_SDK)/bindings/mscom/include
7457	TEMPLATE_VBoxMainExe_INTERMEDIATES += \
7458	$(VBOX_PATH_SDK)/bindings/mscom/include/VirtualBox.h
7459	endif # COM
7460
7461	#
7462	# Template for building the Main DLL modules (such as in-process COM/XPCOM
7463	# components for Main).
7464	#
7465	# This differs from VBoxMainExe only in PIC handling and similar DLL stuff.
7466	#
7467	TEMPLATE_VBoxMainDll = VBox Main Component (shared library)
7468	TEMPLATE_VBoxMainDll_EXTENDS = VBoxMainExe
7469	ifn1of ($(KBUILD_TARGET), darwin haiku os2 win)
7470	TEMPLATE_VBoxMainDll_DEFS = PIC $(TEMPLATE_VBoxMainExe_DEFS)
7471	TEMPLATE_VBoxMainDll_CFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_CFLAGS)
7472	TEMPLATE_VBoxMainDll_CXXFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7473	TEMPLATE_VBoxMainDll_PCHFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_PCHFLAGS)
7474	TEMPLATE_VBoxMainDll_LDFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_LDFLAGS)
7475	endif
7476	TEMPLATE_VBoxMainDll_LDFLAGS.darwin = $(filter-out -bind_at_load,$(TEMPLATE_VBoxMainExe_LDFLAGS.darwin)) \
7477	-current_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
7478	-compatibility_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
7479
7480	#
7481	# Template identical to VBoxMainDll except for where the stuff is
7482	# installed when using XPCOM (components/).
7483	#
7484	# Note! In the hardened build this gets a bit ugly since $ORIGIN/..
7485	# doesn't work. So, we keep the $ORIGIN from VBoxMainExe and let
7486	# the installers do the necessary .so symlinking.
7487	#
7488	# (No difference when building against COM on Windows.)
7489	#
7490	TEMPLATE_VBoxMainComp = VBox Main COM/XPCOM Component (shared library)
7491	TEMPLATE_VBoxMainComp_EXTENDS = VBoxMainExe
7492	ifn1of ($(KBUILD_TARGET), win)
7493	TEMPLATE_VBoxMainComp_INST = $(INST_BIN)components/
7494	endif
7495	ifneq ($(KBUILD_TARGET),win)
7496	ifeq ($(filter-out solaris.x86 %.amd64 %.sparc32 %.sparc64,$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)),) ## TODO: cleanup!
7497	TEMPLATE_VBoxMainComp_DEFS = PIC $(TEMPLATE_VBoxMainExe_DEFS)
7498	TEMPLATE_VBoxMainComp_CFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_CFLAGS)
7499	TEMPLATE_VBoxMainComp_CXXFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_CXXFLAGS)
7500	TEMPLATE_VBoxMainComp_PCHFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_PCHFLAGS)
7501	if defined(VBOX_WITH_RELATIVE_RUNPATH) && !defined(VBOX_WITH_HARDENING)
7502	TEMPLATE_VBoxMainComp_LDFLAGS = -fPIC $(filter-out '$(VBOX_GCC_RPATH_OPT)%',$(TEMPLATE_VBoxMainExe_LDFLAGS)) '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..'
7503	else
7504	TEMPLATE_VBoxMainComp_LDFLAGS = -fPIC $(TEMPLATE_VBoxMainExe_LDFLAGS)
7505	endif
7506	else ifndef VBOX_WITH_HARDENING
7507	ifdef VBOX_WITH_RELATIVE_RUNPATH
7508	TEMPLATE_VBoxMainComp_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)%',$(TEMPLATE_VBoxMainExe_LDFLAGS)) '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..'
7509	endif
7510	endif
7511	endif
7512	TEMPLATE_VBoxMainComp_LDFLAGS.darwin = $(filter-out -bind_at_load,$(TEMPLATE_VBoxMainExe_LDFLAGS.darwin)) \
7513	-current_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
7514	-compatibility_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
7515
7516	# x86 version of VBoxMainComp
7517	TEMPLATE_VBoxMainComp-x86 = 32-bit VBox Main Component (shared library)
7518	TEMPLATE_VBoxMainComp-x86_EXTENDS = VBoxMainComp
7519	TEMPLATE_VBoxMainComp-x86_BLD_TRG_ARCH = x86
7520	TEMPLATE_VBoxMainComp-x86_INST.win = $(INST_DLL)x86/
7521	TEMPLATE_VBoxMainComp-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxMainComp_DEFS)) HC_ARCH_BIT=32 ARCH_BITS=32 \
7522	VBOX_IN_32_ON_64_MAIN_API
7523	TEMPLATE_VBoxMainComp-x86_LIBS = \
7524	$(subst $(PATH_STAGE_LIB)/VBoxCOM$(VBOX_SUFF_LIB),$(PATH_STAGE_LIB)/VBoxCOM-x86$(VBOX_SUFF_LIB), \
7525	$(subst $(LIB_RUNTIME),$(VBOX_LIB_RUNTIME_X86), \
7526	$(subst $(LIB_XPCOM),$(VBOX_LIB_XPCOM_X86), \
7527	$(TEMPLATE_VBoxMainComp_LIBS))))
7528
7529
7530	#
7531	# Template for building the Main static libraries.
7532	#
7533	# This differs from VBoxMainDll only that it zeroes out the _LIBS definition.
7534	#
7535	TEMPLATE_VBoxMainLib = VBox Main Component (static library)
7536	TEMPLATE_VBoxMainLib_EXTENDS = VBoxMainDll
7537	TEMPLATE_VBoxMainLib_LIBS =
7538
7539	TEMPLATE_VBoxMainLib-x86 = 32-bit VBox Main Component (static library)
7540	TEMPLATE_VBoxMainLib-x86_EXTENDS = VBoxMainLib
7541	TEMPLATE_VBoxMainLib-x86_BLD_TRG_ARCH = x86
7542	TEMPLATE_VBoxMainLib-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxMainLib_DEFS)) HC_ARCH_BIT=32 ARCH_BITS=32 \
7543	VBOX_IN_32_ON_64_MAIN_API
7544
7545	#
7546	# Main unit testing, for compiling API implementation files into a testcase.
7547	# This is the VBoxMainExe template only with a different install dir.
7548	#
7549	TEMPLATE_VBoxMainTstExe = VBox Main Testcase Exe
7550	TEMPLATE_VBoxMainTstExe_EXTENDS = VBoxMainExe
7551	TEMPLATE_VBoxMainTstExe_INST = $(INST_TESTCASE)
7552	ifdef VBOX_WITH_RUNPATH
7553	TEMPLATE_VBoxMainTstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' $(TEMPLATE_VBoxMainExe_LDFLAGS)
7554	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7555	TEMPLATE_VBoxMainTstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..' $(TEMPLATE_VBoxMainExe_LDFLAGS)
7556	endif
7557	if "$(KBUILD_TARGET)" == "win" && defined(VBOX_SIGNING_MODE)
7558	TEMPLATE_VBoxMainTstExe_POST_CMDS =
7559	endif
7560
7561	#
7562	# Template for building executables that use the VBox Main component.
7563	#
7564	TEMPLATE_VBoxMainClientExe = VBox Main Client (executable)
7565	TEMPLATE_VBoxMainClientExe_EXTENDS = VBoxMainExe
7566	ifeq ($(KBUILD_TARGET),win)
7567	TEMPLATE_VBoxMainClientExe_DEPS = $(VBOX_PATH_SDK)/bindings/mscom/include/VirtualBox.h
7568	TEMPLATE_VBoxMainClientExe_LIBS.win = $(TEMPLATE_VBoxMainExe_LIBS.win) \
7569	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/User32.Lib \
7570	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/Shell32.Lib \
7571	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/ShLwApi.Lib \
7572	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/Ole32.Lib \
7573	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/OleAut32.Lib \
7574	$(PATH_SDK_$(VBOX_WINPSDK)_LIB)/Uuid.Lib
7575	else
7576	TEMPLATE_VBoxMainClientExe_DEPS = $(VBOX_PATH_SDK)/bindings/xpcom/include/VirtualBox_XPCOM.h
7577	TEMPLATE_VBoxMainClientExe_DEFS = $(TEMPLATE_VBoxMainExe_DEFS) \
7578	NDEBUG TRIMMED
7579	TEMPLATE_VBoxMainClientExe_CXXFLAGS.linux = $(TEMPLATE_VBoxMainExe_CXXFLAGS.linux) -pthread
7580	TEMPLATE_VBoxMainClientExe_PCHFLAGS.linux = $(TEMPLATE_VBoxMainExe_PCHFLAGS.linux) -pthread
7581	endif
7582
7583	#
7584	# Template for building shared libraries / DLLs that use the VBox Main component.
7585	#
7586	# This differs from VBoxMainClientExe only in PIC handling and similar DLL stuff.
7587	#
7588	TEMPLATE_VBoxMainClientDll = VBox MAIN Client (shared library)
7589	TEMPLATE_VBoxMainClientDll_EXTENDS = VBoxMainClientExe
7590	ifn1of ($(KBUILD_TARGET), darwin os2 win)
7591	TEMPLATE_VBoxMainClientDll_DEFS = PIC $(TEMPLATE_VBoxMainClientExe_DEFS)
7592	TEMPLATE_VBoxMainClientDll_CFLAGS = -fPIC $(TEMPLATE_VBoxMainClientExe_CFLAGS)
7593	TEMPLATE_VBoxMainClientDll_CXXFLAGS = -fPIC $(TEMPLATE_VBoxMainClientExe_CXXFLAGS)
7594	TEMPLATE_VBoxMainClientDll_PCHFLAGS = -fPIC $(TEMPLATE_VBoxMainClientExe_PCHFLAGS)
7595	TEMPLATE_VBoxMainClientDll_LDFLAGS = -fPIC $(TEMPLATE_VBoxMainClientExe_LDFLAGS)
7596	endif
7597	TEMPLATE_VBoxMainClientDll_LDFLAGS.darwin = $(filter-out -bind_at_load,$(TEMPLATE_VBoxMainClientExe_LDFLAGS.darwin))
7598
7599	# x86 version of VBoxMainClientDll
7600	TEMPLATE_VBoxMainClientDll-x86 := 32-bit VBox MAIN Client (shared library)
7601	TEMPLATE_VBoxMainClientDll-x86_EXTENDS := VBoxMainClientDll
7602	TEMPLATE_VBoxMainClientDll-x86_BLD_TRG_ARCH := x86
7603	TEMPLATE_VBoxMainClientDll-x86_INST.win = $(INST_DLL)x86/
7604	TEMPLATE_VBoxMainClientDll-x86_DEFS = $(filter-out HC_ARCH_BITS%,$(TEMPLATE_VBoxMainClientDll_DEFS)) \
7605	HC_ARCH_BIT=32 ARCH_BITS=32 VBOX_IN_32_ON_64_MAIN_API
7606	TEMPLATE_VBoxMainClientDll-x86_LIBS = \
7607	$(subst $(PATH_STAGE_LIB)/VBoxCOM$(VBOX_SUFF_LIB),$(PATH_STAGE_LIB)/VBoxCOM-x86$(VBOX_SUFF_LIB), \
7608	$(subst $(LIB_RUNTIME),$(VBOX_LIB_RUNTIME_X86), \
7609	$(subst $(LIB_XPCOM),$(VBOX_LIB_XPCOM_X86), \
7610	$(TEMPLATE_VBoxMainClientDll_LIBS))))
7611
7612	#
7613	# Template for building testcases which are API clients.
7614	#
7615	TEMPLATE_VBoxMainClientTstExe = VBox Main Client Testcase (executable)
7616	TEMPLATE_VBoxMainClientTstExe_EXTENDS = VBoxMainClientExe
7617	TEMPLATE_VBoxMainClientTstExe_INST = $(INST_TESTCASE)
7618	ifdef VBOX_WITH_RUNPATH
7619	TEMPLATE_VBoxMainClientTstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' $(TEMPLATE_VBoxMainClientExe_LDFLAGS)
7620	else ifdef VBOX_WITH_RELATIVE_RUNPATH
7621	TEMPLATE_VBoxMainClientTstExe_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/..' $(TEMPLATE_VBoxMainClientExe_LDFLAGS)
7622	endif
7623	if "$(KBUILD_TARGET)" == "win" && defined(VBOX_SIGNING_MODE)
7624	TEMPLATE_VBoxMainClientTstExe_POST_CMDS =
7625	endif
7626
7627
7628
7629	#
7630	# Templates used for building the extension packs.
7631	#
7632	ifdef VBOX_WITH_EXTPACK
7633	# Base templates (native or portable).
7634	TEMPLATE_VBoxR3ExtPack = For the ring-3 context extension pack modules.
7635	if 1 # Native for now.
7636	TEMPLATE_VBoxR3ExtPack_EXTENDS = VBoxR3Dll
7637	TEMPLATE_VBoxR3ExtPack_DEFS = $(TEMPLATE_VBoxR3Dll_DEFS) VBOX_IN_EXTPACK VBOX_IN_EXTPACK_R3
7638	else
7639	TEMPLATE_VBoxR3ExtPack_EXTENDS = VBoxNoCrtGccLib
7640	TEMPLATE_VBoxR3ExtPack_DEFS = $(TEMPLATE_VBoxNoCrtGccLib_DEFS) VBOX_IN_EXTPACK VBOX_IN_EXTPACK_R3 IPRT_NO_CRT IN_RING3
7641	TEMPLATE_VBoxR3ExtPack_INCS = $(PATH_ROOT)/include/iprt/nocrt $(TEMPLATE_VBoxR3Dll_INCS)
7642	endif
7643	ifneq ($(KBUILD_TARGET),win)
7644	TEMPLATE_VBoxR3ExtPack_CXXFLAGS = $(TEMPLATE_VBoxR3Dll_CXXFLAGS) -fno-rtti
7645	TEMPLATE_VBoxR3ExtPack_PCHFLAGS = $(TEMPLATE_VBoxR3Dll_PCHFLAGS) -fno-rtti
7646	endif
7647	TEMPLATE_VBoxR3ExtPack_INST = $(INST_EXTPACK)YouShallOverrideThis/
7648	ifeq ($(KBUILD_TARGET),linux)
7649	TEMPLATE_VBoxR3ExtPack_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)', $(TEMPLATE_VBoxR3Dll_LDFLAGS))
7650	else if !defined(VBOX_WITH_RUNPATH) && defined(VBOX_WITH_RELATIVE_RUNPATH)
7651	TEMPLATE_VBoxR3ExtPack_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/../../..' $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)', $(TEMPLATE_VBoxR3Dll_LDFLAGS))
7652	endif
7653	ifdef VBOX_ONLY_EXTPACKS_USE_IMPLIBS
7654	if1of ($(KBUILD_TARGET), win os2)
7655	TEMPLATE_VBoxR3ExtPack_LIBS = \
7656	$(PATH_STAGE_LIB)/VBoxRTImp$(VBOX_SUFF_LIB)
7657	else
7658	TEMPLATE_VBoxR3ExtPack_LIBS = \
7659	$(PATH_STAGE_LIB)/VBoxRTImp$(VBOX_SUFF_DLL)
7660	endif
7661	else
7662	TEMPLATE_VBoxR3ExtPack_LIBS = \
7663	$(LIB_RUNTIME)
7664	endif
7665	ifeq ($(KBUILD_TARGET),darwin)
7666	TEMPLATE_VBoxR3ExtPack_POST_CMDS = $(VBOX_SIGN_EXTPACK_DYLIB_CMDS)
7667	endif
7668
7669	TEMPLATE_VBoxR3ExtPackApi = For the ring-3 context extension pack modules using the Main API.
7670	TEMPLATE_VBoxR3ExtPackApi_EXTENDS = VBoxMainDll
7671	TEMPLATE_VBoxR3ExtPackApi_DEFS = $(TEMPLATE_VBoxMainDll_DEFS) VBOX_IN_EXTPACK VBOX_IN_EXTPACK_R3
7672	TEMPLATE_VBoxR3ExtPackApi_INST = $(INST_EXTPACK)YouShallOverrideThis/
7673	ifeq ($(KBUILD_TARGET),linux)
7674	TEMPLATE_VBoxR3ExtPackApi_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)' '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)', $(TEMPLATE_VBoxMainDll_LDFLAGS))
7675	else if !defined(VBOX_WITH_RUNPATH) && defined(VBOX_WITH_RELATIVE_RUNPATH)
7676	TEMPLATE_VBoxR3ExtPackApi_LDFLAGS = '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)/../../..' $(filter-out '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)', $(TEMPLATE_VBoxMainDll_LDFLAGS))
7677	endif
7678	ifdef VBOX_ONLY_EXTPACKS_USE_IMPLIBS
7679	if1of ($(KBUILD_TARGET), win os2)
7680	TEMPLATE_VBoxR3ExtPackApi_LIBS = \
7681	$(PATH_STAGE_LIB)/VBoxRTImp$(VBOX_SUFF_LIB)
7682	else
7683	TEMPLATE_VBoxR3ExtPackApi_LIBS = \
7684	$(PATH_STAGE_LIB)/VBoxRTImp$(VBOX_SUFF_DLL)
7685	endif
7686	else
7687	TEMPLATE_VBoxR3ExtPackApi_LIBS = \
7688	$(LIB_RUNTIME)
7689	endif
7690	ifeq ($(KBUILD_TARGET),darwin)
7691	TEMPLATE_VBoxR3ExtPackApi_POST_CMDS = $(VBOX_SIGN_EXTPACK_DYLIB_CMDS)
7692	endif
7693
7694	TEMPLATE_VBoxR0ExtPack = For the ring-0 context extension pack modules.
7695	TEMPLATE_VBoxR0ExtPack_EXTENDS = VBoxR0
7696	TEMPLATE_VBoxR0ExtPack_EXTENDS_BY = appending
7697	TEMPLATE_VBoxR0ExtPack_INST = $(INST_EXTPACK)YouShallOverrideThis/
7698	TEMPLATE_VBoxR0ExtPack_DEFS = VBOX_IN_EXTPACK VBOX_IN_EXTPACK_R0
7699	if1of ($(VBOX_LDR_FMT), pe lx)
7700	TEMPLATE_VBoxR0ExtPack_LIBS = \
7701	$(PATH_STAGE_LIB)/VMMR0Imp$(VBOX_SUFF_LIB)
7702	endif
7703	TEMPLATE_VBoxR0ExtPack_LIBS += \
7704	$(VBOX_LIB_SUPR0)
7705
7706	TEMPLATE_VBoxRcExtPack = For the raw-mode context extension pack modules.
7707	TEMPLATE_VBoxRcExtPack_EXTENDS = VBoxRc
7708	TEMPLATE_VBoxRcExtPack_EXTENDS_BY = appending
7709	TEMPLATE_VBoxRcExtPack_SYSSUFF = .rc
7710	TEMPLATE_VBoxRcExtPack_INST = $(INST_EXTPACK)YouShallOverrideThis/
7711	TEMPLATE_VBoxRcExtPack_DEFS = VBOX_IN_EXTPACK VBOX_IN_EXTPACK_RC
7712	if1of ($(VBOX_LDR_FMT32), pe lx)
7713	TEMPLATE_VBoxRcExtPack_LIBS = \
7714	$(PATH_STAGE_LIB)/VMMRCBuiltin$(VBOX_SUFF_LIB) \
7715	$(PATH_STAGE_LIB)/VMMRCImp$(VBOX_SUFF_LIB)
7716	endif
7717
7718	TEMPLATE_VBoxInsExtPack = For the install targets of an extension pack.
7719	TEMPLATE_VBoxInsExtPack_MODE = 0644
7720	TEMPLATE_VBoxInsExtPack_INST = $(INST_EXTPACK)YouShallOverrideThis/
7721
7722	# For each individual extension pack
7723	ifdef VBOX_WITH_EXTPACK_PUEL
7724	TEMPLATE_VBoxR3ExtPackPuel = For the ring-3 context modules in the PUEL extension pack.
7725	TEMPLATE_VBoxR3ExtPackPuel_EXTENDS = VBoxR3ExtPack
7726	TEMPLATE_VBoxR3ExtPackPuel_INST = $(INST_EXTPACK_PUEL)$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/
7727	TEMPLATE_VBoxR3ExtPackPuel_DEFS = $(TEMPLATE_VBoxR3ExtPack_DEFS) VBOX_IN_PUEL_EXTPACK
7728	TEMPLATE_VBoxR3ExtPackPuel_LD_DEBUG = split
7729
7730	TEMPLATE_VBoxR3ExtPackApiPuel = For the ring-3 context modules in the PUEL extension pack.
7731	TEMPLATE_VBoxR3ExtPackApiPuel_EXTENDS = VBoxR3ExtPackApi
7732	TEMPLATE_VBoxR3ExtPackApiPuel_INST = $(INST_EXTPACK_PUEL)$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/
7733	TEMPLATE_VBoxR3ExtPackApiPuel_DEFS = $(TEMPLATE_VBoxR3ExtPackApi_DEFS) VBOX_IN_PUEL_EXTPACK
7734	TEMPLATE_VBoxR3ExtPackApiPuel_LD_DEBUG = split
7735
7736	TEMPLATE_VBoxR3ExtPackPuelWithOpenSsl = For the ring-3 context modules in the PUEL extension pack using ExtPack OpenSSL.
7737	TEMPLATE_VBoxR3ExtPackPuelWithOpenSsl_EXTENDS = VBoxR3ExtPackPuel
7738
7739	TEMPLATE_VBoxR0ExtPackPuel = For the ring-0 context modules in the PUEL extension pack.
7740	TEMPLATE_VBoxR0ExtPackPuel_EXTENDS = VBoxR0ExtPack
7741	TEMPLATE_VBoxR0ExtPackPuel_INST = $(INST_EXTPACK_PUEL)$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/
7742	TEMPLATE_VBoxR0ExtPackPuel_DEFS = $(TEMPLATE_VBoxR0ExtPack_DEFS) VBOX_IN_PUEL_EXTPACK
7743
7744	TEMPLATE_VBoxRcExtPackPuel = For the raw-mode context modules in the PUEL extension pack.
7745	TEMPLATE_VBoxRcExtPackPuel_EXTENDS = VBoxRcExtPack
7746	TEMPLATE_VBoxRcExtPackPuel_INST = $(INST_EXTPACK_PUEL)$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/
7747	TEMPLATE_VBoxRcExtPackPuel_DEFS = $(TEMPLATE_VBoxRcExtPack_DEFS) VBOX_IN_PUEL_EXTPACK
7748
7749	TEMPLATE_VBoxInsExtPackPuel = For the install targets of an extension pack.
7750	TEMPLATE_VBoxInsExtPackPuel_EXTENDS = VBoxR0ExtPack
7751	TEMPLATE_VBoxInsExtPackPuel_INST = $(INST_EXTPACK_PUEL)
7752	endif
7753
7754	endif # VBOX_WITH_EXTPACK
7755
7756
7757	#
7758	# Qt
7759	# Qt
7760	# Qt
7761	#
7762	if defined(VBOX_WITH_QTGUI) \|\| defined(VBOX_WITH_NLS)
7763
7764	# Guess VBOX_WITH_ORACLE_QT
7765	ifndef VBOX_WITH_ORACLE_QT
7766	ifndef VBOX_OSE
7767	if1of ($(KBUILD_TARGET), darwin solaris win)
7768	VBOX_WITH_ORACLE_QT := 1
7769	endif
7770	endif
7771	endif
7772
7773	#
7774	# Handmade configuration of Qt - very annoying, this needs to
7775	# be cleaned up properly later some time (not important now).
7776	#
7777	# When using a debug QT build set VBOX_QT_DBG:=d in LocalConfig.kmk.
7778	#
7779	ifeq ($(VBOX_PATH_QT),)
7780	ifeq ($(KBUILD_TARGET),darwin)
7781	VBOX_PATH_QT := $(lastword $(sort $(wildcard $(KBUILD_DEVTOOLS_TRG)/qt/v5*)))
7782	ifeq ($(VBOX_PATH_QT),)
7783	ifneq ($(wildcard /Library/Frameworks/QtCore.framework),)
7784	# Using the global installation (for OSE).
7785	VBOX_PATH_QT ?= /usr
7786	VBOX_PATH_QT_FRAMEWORKS ?= /Library/Frameworks
7787	endif
7788	endif
7789	else if1of ($(KBUILD_TARGET), win)
7790	## @todo kBuild: Use qfilter[-out] here once kmk.exe is updated.
7791	ifndef VBOX_WITH_QT6
7792	VBOX_PATH_QT := $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_TRG)/qt/v5*))
7793	VBOX_PATH_QT := $(firstfile $(filter %-$(tolower $(VBOX_VCC_TOOL_STEM)),$(VBOX_PATH_QT)) \
7794	$(filter-out %-vcc100 %-vcc110 %-vcc120 %-vcc140 %-vcc141 %-vcc142 %-vcc143 %-vcc150, $(VBOX_PATH_QT)))
7795	ifdef VBOX_PATH_QT
7796	PATH_SDK_QT5 := $(VBOX_PATH_QT)
7797	PATH_TOOL_QT5 := $(VBOX_PATH_QT)
7798	endif
7799	else # qt6
7800	VBOX_PATH_QT := $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_TRG)/qt/v6*))
7801	VBOX_PATH_QT := $(firstfile $(filter %-$(tolower $(VBOX_VCC_TOOL_STEM)),$(VBOX_PATH_QT)) \
7802	$(filter-out %-vcc100 %-vcc110 %-vcc120 %-vcc140 %-vcc141 %-vcc142 %-vcc143 %-vcc150, $(VBOX_PATH_QT)))
7803	ifdef VBOX_PATH_QT
7804	PATH_SDK_QT6 := $(VBOX_PATH_QT)
7805	PATH_TOOL_QT6 := $(VBOX_PATH_QT)
7806	endif
7807	endif # qt6
7808	else if1of ($(KBUILD_TARGET), linux solaris)
7809	ifndef VBOX_WITH_QT6
7810	VBOX_PATH_QT ?= $(firstfile $(versortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_TRG)/qt/v5*)))
7811	else
7812	VBOX_PATH_QT ?= $(firstfile $(versortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_TRG)/qt/v6*)))
7813	endif
7814	ifneq ($(VBOX_PATH_QT),)
7815	VBOX_WITH_ORACLE_QT = 1
7816	endif
7817	endif
7818	endif
7819	VBOX_PATH_QT ?= /usr
7820	VBOX_PATH_QT_LIB ?= $(VBOX_PATH_QT)/lib
7821
7822	if defined(VBOX_WITH_ORACLE_QT) && (!defined(VBOX_WITH_QT6) \|\| "$(KBUILD_TARGET)" != "darwin")
7823	VBOX_QT_INFIX := VBox$(VBOX_QT_DBG)
7824	endif
7825
7826	if "$(VBOX_QT_DBG)" != "" && "$(VBOX_QT_DBG)" != "$(VBOX_VCC_CRT_TYPE)" && "$(KBUILD_TARGET)" == "win"
7827	$(warning WARNING! VBOX_QT_DBG (=$(VBOX_QT_DBG)) and VBOX_VCC_CRT_TYPE (=$(VBOX_VCC_CRT_TYPE)) does not match!)
7828	$(warning WARNING! This may cause heap troubles in the GUI in places where something is)
7829	$(warning WARNING! allocated in the Qt DLLs freed in our code (or vice versa) because they)
7830	$(warning WARNING! will be using different allocators. See r156914 for more details.)
7831	$(warning WARNING! VBOX_WITH_DEBUG_VCC_CRT=1 in enabled debug CRT.)
7832	endif
7833
7834	ifeq ($(KBUILD_TARGET),darwin)
7835	VBOX_QT_MOD := QtCore QtGui QtWidgets QtPrintSupport QtHelp QtNetwork QtSql
7836	ifdef VBOX_WITH_QT6
7837	VBOX_QT_MOD += QtStateMachine
7838	else
7839	VBOX_QT_MOD += QtMacExtras
7840	endif
7841	else if1of ($(KBUILD_TARGET), linux freebsd netbsd openbsd solaris win)
7842	if1of ($(KBUILD_TARGET), linux freebsd netbsd openbsd solaris)
7843	ifndef VBOX_WITH_QT6
7844	VBOX_QT_MOD += Qt5Core Qt5Gui Qt5Widgets Qt5PrintSupport $(if $(VBOX_GUI_USE_QGL),Qt5OpenGL,)
7845	VBOX_QT_MOD += Qt5DBus Qt5Xml Qt5XcbQpa Qt5X11Extras Qt5Help Qt5Network Qt5Sql
7846	VBOX_QT_PLUGINS = \
7847	plugins/platforms/libqxcb.so \
7848	plugins/platformthemes/libqgtk2.so \
7849	plugins/platformthemes/libqgtk3.so \
7850	plugins/sqldrivers/libqsqlite.so \
7851	plugins/styles/libqgtk2style.so \
7852	plugins/xcbglintegrations/libqxcb-glx-integration.so
7853	else # qt6
7854	VBOX_QT_MOD += Qt6Core Qt6Gui Qt6Widgets Qt6PrintSupport Qt6StateMachine
7855	VBOX_QT_MOD += Qt6DBus Qt6Xml Qt6XcbQpa Qt6Help Qt6Network Qt6Sql
7856	VBOX_QT_PLUGINS = \
7857	plugins/platforms/libqxcbVBox.so \
7858	plugins/platformthemes/libqgtk2VBox.so \
7859	plugins/platformthemes/libqgtk3VBox.so \
7860	plugins/sqldrivers/libqsqliteVBox.so \
7861	plugins/styles/libqgtk2styleVBox.so
7862	endif # qt6
7863	else ifeq ($(KBUILD_TARGET),win)
7864	ifndef VBOX_WITH_QT6
7865	VBOX_QT_MOD += Qt5Core Qt5Gui Qt5Widgets Qt5PrintSupport $(if $(VBOX_GUI_USE_QGL),Qt5OpenGL,)
7866	VBOX_QT_MOD += Qt5WinExtras Qt5Help Qt5Network Qt5Sql
7867	else # qt6
7868	VBOX_QT_MOD += Qt6Core Qt6Gui Qt6Widgets Qt6PrintSupport Qt6StateMachine Qt6Help Qt6Network Qt6Sql
7869	endif # qt6
7870	endif # win
7871	endif # linux freebsd netbsd openbsd solaris win
7872
7873	VBOX_QT_MOD_NAMES = $(foreach qtmod,$(VBOX_QT_MOD),$(qtmod)$(VBOX_QT_INFIX))
7874
7875	# Hack LD_LIBRARY_PATH for stuff in tools.
7876	ifdef VBOX_WITH_ORACLE_QT
7877	if1of ($(KBUILD_TARGET), linux solaris)
7878	export LD_LIBRARY_PATH := $(VBOX_PATH_QT_LIB):$(LD_LIBRARY_PATH)
7879	endif
7880	endif
7881
7882	# WORKAROUND:
7883	# Both files included automatically, 1st include is included from 2nd one,
7884	# but moc can't include it due to problem with parsing framework structure,
7885	# as a result QT_VERSION can't be calculated and it's not only used in our
7886	# GUI but by the moc itself to parse modern signal/slot definitions.
7887	# We were hardcoding QT_VERSION for TEMPLATE_VBoxQtGuiExe below for quite
7888	# a long, but this have to end. Instead we can pass both includes manually.
7889	TOOL_QT5_MOCFLAGS.darwin += --include qconfig.h --include qglobal.h
7890	endif # defined(VBOX_WITH_QTGUI) \|\| defined(VBOX_WITH_NLS)
7891
7892	ifdef VBOX_WITH_QTGUI
7893	#
7894	# Template for building Qt GUI executables.
7895	#
7896	TEMPLATE_VBoxQtGuiExe = VBox Qt GUI Executable
7897	ifndef VBOX_WITH_QT6
7898	TEMPLATE_VBoxQtGuiExe_USES := qt5
7899	TEMPLATE_VBoxQtGuiExe_QTTOOL := QT5
7900	TEMPLATE_VBoxQtGuiExe_MOCTOOL := QT5
7901	TEMPLATE_VBoxQtGuiExe_UICTOOL := QT5
7902	TEMPLATE_VBoxQtGuiExe_RCCTOOL := QT5
7903	TEMPLATE_VBoxQtGuiExe_LRCTOOL := QT5
7904	TEMPLATE_VBoxQtGuiExe_SDKS := QT5
7905	else
7906	TEMPLATE_VBoxQtGuiExe_USES := qt6
7907	TEMPLATE_VBoxQtGuiExe_QTTOOL := QT6
7908	TEMPLATE_VBoxQtGuiExe_MOCTOOL := QT6
7909	TEMPLATE_VBoxQtGuiExe_UICTOOL := QT6
7910	TEMPLATE_VBoxQtGuiExe_RCCTOOL := QT6
7911	TEMPLATE_VBoxQtGuiExe_LRCTOOL := QT6
7912	TEMPLATE_VBoxQtGuiExe_SDKS := QT6
7913	endif
7914	TEMPLATE_VBoxQtGuiExe_QT_INFIX = $(VBOX_QT_INFIX)
7915	TEMPLATE_VBoxQtGuiExe_DEFS = IN_RING3 QT_NO_DEBUG QT_THREAD_SUPPORT QT_SHARED HAVE_CONFIG_H $(ARCH_BITS_DEFS)
7916	TEMPLATE_VBoxQtGuiExe_RCDEFS = $(TEMPLATE_VBoxR3Exe_RCDEFS)
7917
7918	ifeq ($(KBUILD_TARGET),win)
7919	# Note! Only use VBOX_VCC_CRT_TYPE when it matches VBOX_QT_DBG.
7920	TEMPLATE_VBoxQtGuiExe_TOOL = $(VBOX_VCC_TOOL)
7921	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
7922	TEMPLATE_VBoxQtGuiExe_SDKS = WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)
7923	endif
7924	TEMPLATE_VBoxQtGuiExe_DEFS += \
7925	_WIN32_WINNT=0x0500 UNICODE _UNICODE \
7926	QT_DLL _CRT_SECURE_NO_DEPRECATE \
7927	$(QMAKE_PRL_DEFINES)
7928	TEMPLATE_VBoxQtGuiExe_CXXFLAGS = -nologo -Zm200 -MD$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),) \
7929	-Zi -EHsc $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS) $(VBOX_VCC_std)
7930	# -wd4481: nonstandard extension used: override specifier 'override'
7931	# -wd4625: 'QRubberBand' : copy constructor could not be generated because a base class copy constructor is inaccessible
7932	# -wd4626: 'QRubberBand' : assignment operator could not be generated because a base class assignment operator is inaccessible
7933	# -wd4640: qmetatype.h(2210): warning C4640: 'f' : construction of local static object is not thread-safe [too bad]
7934	# -wd4350: behavior change: 'int QStringList::indexOf(const QRegExp &,int) const' called instead of 'int QStringList::indexOf(QRegExp &,int) const'
7935	# -wd4121: UIActionPool.h(393) : warning C4121: 'UIActionPool::PointerToFunction' : alignment of a member was sensitive to packing
7936	# -wd4718: qmap.h(222) : warning C4718: 'QMapNode<enum DetailsElementType,bool>::destroySubTree' : recursive call has no side effects, deleting
7937	# -wd5204: pplwin.h(78): warning C5204: 'Concurrency::details::_DefaultPPLTaskScheduler': class has virtual functions
7938	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += $(VBOX_VCC_WARN_ALL) -wd4481 -wd4625 -wd4626 -wd4640 -wd4350 -wd4371 -wd4121 -wd4718 -wd5204 $(VBOX_VCC_WERR)
7939	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
7940	# -wd4619: qvectro.h(305 : warning C4619: #pragma warning : there is no warning number '4345'
7941	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd4619
7942	endif
7943	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
7944	# -wd4774: string(530): warning C4774: '_scprintf' : format string expected in argument 1 is not a string literal
7945	# -wd4456: UICommon.cpp(1471): warning C4456: declaration of '_container_' hides previous local declaration [nested foreach]
7946	# -wd4458: UISettingsDialogSpecific.cpp(416): warning C4458: declaration of 'data' hides class member
7947	# qwidget.h(730): note: see declaration of 'QWidget::data'
7948	# -wd4946: qmap.h(213): warning C4946: reinterpret_cast used between related classes: 'QMapNodeBase' and 'QMapNode<Key,T>'
7949	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd4774 -wd4456 -wd4458 -wd4946
7950	endif
7951	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC141"
7952	# -wd4866: UIVirtualBoxManager.cpp(221) : warning C4866: compiler may not enforce left-to-right evaluation order for call to 'QStringList::operator<<'
7953	# Only with -std=c++17 and later.
7954	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd4866
7955	endif
7956	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # With v16.11.9, not with v16.6.0 4242
7957	# -wd5219: qpoint.h(187): warning C5219: implicit conversion from 'const int' to 'float', possible loss of data
7958	# -wd5240: qcolor.h(235): warning C5240: 'nodiscard': attribute is ignored in this syntactic position
7959	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -wd5219 -wd5240
7960	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += /volatileMetadata- # Don't waste space on x86/amd64-on-arm emulation optimizations.
7961	endif
7962	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -Gy
7963	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
7964	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -Gw
7965	endif
7966	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
7967	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -Zc:inline
7968	endif
7969	ifdef VBOX_WITH_MSC_ANALYZE_THIS
7970	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += /analyze
7971	endif
7972
7973	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.debug = -RTCsu
7974	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.debug = -RTCsu
7975	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.dbgopt = $(NO_SUCH_VARIABLE)
7976	TEMPLATE_VBoxQtGuiExe_PCHFLAGS = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS)
7977	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.debug = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.debug)
7978	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.dbgopt)
7979	TEMPLATE_VBoxQtGuiExe_LDFLAGS = -Ignore:4197 \
7980	/NOD /INCREMENTAL:NO /MAPINFO:EXPORTS /LargeAddressAware /DynamicBase /NxCompat /Release /Debug /Opt:Ref /Opt:Icf \
7981	$(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS) \
7982	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
7983	/STUB:$(PATH_ROOT)/src/VBox/HostDrivers/Support/win/winstub.com
7984	if defined(VBOX_SIGNING_MODE) && defined(VBOX_WITH_HARDENING)
7985	TEMPLATE_VBoxQtGuiExe_LDFLAGS += -IntegrityCheck
7986	endif
7987	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
7988	TEMPLATE_VBoxQtGuiExe_LDFLAGS += -EmitVolatileMetadata:NO
7989	endif
7990	TEMPLATE_VBoxQtGuiExe_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
7991
7992	TEMPLATE_VBoxQtGuiExe_SDKS += $(VBOX_WINPSDK)
7993	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
7994	TEMPLATE_VBoxQtGuiExe_LIBS = \
7995	$(VBOX_LIBS_QT) \
7996	$(LIB_RUNTIME) \
7997	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/vcruntime$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
7998	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/msvcrt$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
7999	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/msvcprt$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
8000	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/oldnames.lib \
8001	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/delayimp.lib
8002	ifeq ($(KBUILD_TYPE),asan)
8003	TEMPLATE_VBoxQtGuiExe_LIBS += \
8004	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/clang_rt.asan_dynamic-x86_64.lib \
8005	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/clang_rt.asan_dynamic_runtime_thunk-x86_64.lib
8006	endif
8007	else
8008	TEMPLATE_VBoxQtGuiExe_LIBS = \
8009	$(VBOX_LIBS_QT) \
8010	$(LIB_RUNTIME) \
8011	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/msvcprt$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
8012	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/msvcrt$(if-expr "$(VBOX_QT_DBG)" == "$(VBOX_VCC_CRT_TYPE)",$(VBOX_VCC_CRT_TYPE),).lib \
8013	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/oldnames.lib \
8014	$(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/delayimp.lib
8015	endif
8016	TEMPLATE_VBoxQtGuiExe_POST_CMDS = $(VBOX_UTF8_MANIFEST_CMDS)$(NLTAB)$(VBOX_SIGN_IMAGE_CMDS)
8017	TEMPLATE_VBoxQtGuiExe_ORDERDEPS = $(VBOX_SIGN_IMAGE_CMDS_ORDERDEPS)
8018
8019	else # the gcc guys:
8020	TEMPLATE_VBoxQtGuiExe_TOOL = $(VBOX_GCC_TOOL)
8021	if $(VBOX_GCC_VERSION_CC) < 30400
8022	TEMPLATE_VBoxQtGuiExe_DEFS += RT_WITHOUT_PRAGMA_ONCE
8023	endif
8024	TEMPLATE_VBoxQtGuiExe_DEFS.linux = _REENTRANT
8025	TEMPLATE_VBoxQtGuiExe_DEFS.solaris = _REENTRANT
8026
8027	## @todo Use VBOX_GCC_PEDANTIC_CXX?
8028	TEMPLATE_VBoxQtGuiExe_CXXFLAGS = \
8029	-g $(VBOX_GCC_pipe) $(filter-out -Wno-unused $(VBOX_GCC_Wno-unused-parameter),$(VBOX_GCC_WARN)) -frtti -fno-exceptions \
8030	-Wno-long-long -fshort-wchar -fno-strict-aliasing \
8031	$(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_Wno-multistatement-macros) $(VBOX_GCC_Wno-ignored-qualifiers) \
8032	$(VBOX_GCC_Wno-return-type-c-linkage) $(VBOX_GCC_std) $(VBOX_GCC_IPRT_FMT_CHECK) $(VBOX_GCC_SANITIZER_FLAGS)
8033	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
8034	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += $(VBOX_GCC_WERR)
8035	endif
8036	ifn1of ($(USERNAME), dsen serkan) # Bunch of stuff deprecated after 5.6.*. These guys knows how to deal with it. :)
8037	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += $(VBOX_GCC_Wno-deprecated-declarations)
8038	endif
8039	ifdef VBOX_WITH_QT6
8040	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -std=gnu++17
8041	endif
8042	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.x86 = -m32
8043	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.amd64 = -m64
8044	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.linux = -pthread
8045	TEMPLATE_VBoxQtGuiExe_PCHFLAGS = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS)
8046	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.x86 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.x86)
8047	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.amd64 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.amd64)
8048	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.linux = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.linux)
8049	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.debug = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.debug)
8050	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.dbgopt)
8051	TEMPLATE_VBoxQtGuiExe_OBJCFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) -fno-exceptions $(VBOX_GCC_IPRT_FMT_CHECK)
8052	TEMPLATE_VBoxQtGuiExe_OBJCFLAGS.x86 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.x86)
8053	TEMPLATE_VBoxQtGuiExe_OBJCFLAGS.amd64 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.amd64)
8054	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS = \
8055	-g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) \
8056	-frtti -fno-exceptions $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_fvisibility-inlines-hidden) $(VBOX_GCC_IPRT_FMT_CHECK)
8057	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
8058	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS += $(VBOX_GCC_WERR)
8059	endif
8060	ifdef VBOX_WITH_QT6
8061	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS += -std=gnu++17
8062	endif
8063	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS.x86 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.x86)
8064	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS.amd64 = $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.amd64)
8065	TEMPLATE_VBoxQtGuiExe_LDFLAGS = $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS)
8066	TEMPLATE_VBoxQtGuiExe_LDFLAGS.x86 = -m32
8067	TEMPLATE_VBoxQtGuiExe_LDFLAGS.amd64 = -m64
8068	TEMPLATE_VBoxQtGuiExe_LIBS = \
8069	$(VBOX_LIBS_QT) \
8070	$(LIB_RUNTIME)
8071
8072	ifeq ($(KBUILD_TARGET),linux)
8073	TEMPLATE_VBoxQtGuiExe_LDFLAGS += -Wl,-z,noexecstack,-z,relro $(VBOX_LD_as_needed)
8074	TEMPLATE_VBOXQTGUIEXE_LDFLAGS += -Wl,-rpath,$(PATH_SDK_QT5_LIB)
8075	TEMPLATE_VBoxQtGuiExe_LIBS += \
8076	$(VBOX_XCURSOR_LIBS) \
8077	Xext \
8078	X11
8079	TEMPLATE_VBoxQtGuiExe_LIBPATH += \
8080	$(VBOX_LIBPATH_X11)
8081	else ifeq ($(KBUILD_TARGET),darwin)
8082	TEMPLATE_VBoxQtGuiExe_SDKS.darwin += $(VBOX_DARWIN_DEF_SDK_SDKS)
8083	TEMPLATE_VBoxQtGuiExe_DEFS.darwin += $(VBOX_DARWIN_DEF_SDK_DEFS)
8084	TEMPLATE_VBoxQtGuiExe_CFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_CFLAGS)
8085	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
8086	TEMPLATE_VBoxQtGuiExe_PCHFLAGS.darwin += $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS.darwin)
8087	TEMPLATE_VBoxQtGuiExe_OBJCFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_OBJCFLAGS)
8088	ifdef VBOX_WITH_QT6
8089	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS)
8090	else
8091	TEMPLATE_VBoxQtGuiExe_OBJCXXFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS) $(VBOX_GCC_std)
8092	endif
8093	TEMPLATE_VBoxQtGuiExe_LDFLAGS.darwin += $(VBOX_DARWIN_DEF_SDK_LDFLAGS) -bind_at_load -Wl,-headerpad_max_install_names
8094	TEMPLATE_VBoxQtGuiExe_LIBS +=
8095	TEMPLATE_VBoxQtGuiExe_LIBPATH +=
8096	TEMPLATE_VBoxQtGuiExe_POST_CMDS.darwin = $(VBOX_SIGN_IMAGE_CMDS)
8097	else
8098	TEMPLATE_VBoxQtGuiExe_INCS += \
8099	$(VBOX_XCURSOR_INCS)
8100	TEMPLATE_VBoxQtGuiExe_LIBS += \
8101	$(VBOX_XCURSOR_LIBS) \
8102	Xext \
8103	X11 \
8104	m \
8105	$(LIB_PTHREAD)
8106	TEMPLATE_VBoxQtGuiExe_LIBPATH += \
8107	$(VBOX_LIBPATH_X11)
8108	ifeq ($(KBUILD_TARGET),freebsd)
8109	TEMPLATE_VBoxQtGuiExe_INCS += \
8110	/usr/include \
8111	/usr/X11R6/include \
8112	/usr/local/include
8113	TEMPLATE_VBoxQtGuiExe_LIBPATH += \
8114	/usr/lib \
8115	/usr/X11R6/lib \
8116	/usr/local/lib
8117	endif
8118	ifeq ($(KBUILD_TARGET),solaris)
8119	TEMPLATE_VBoxQtGuiExe_LDFLAGS.solaris = -Wl,-z,ignore # Same as VBOX_LD_as_needed.
8120	TEMPLATE_VBoxQtGuiExe_LIBS += \
8121	rt socket nsl
8122	endif
8123	endif
8124	# Assume the Qt shared objects are in the same directory as the executable, on Solaris too.
8125	ifdef VBOX_WITH_RUNPATH
8126	TEMPLATE_VBoxQtGuiExe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RUNPATH)'
8127	else ifdef VBOX_WITH_RELATIVE_RUNPATH
8128	TEMPLATE_VBoxQtGuiExe_LDFLAGS += '$(VBOX_GCC_RPATH_OPT)$(VBOX_WITH_RELATIVE_RUNPATH)'
8129	endif
8130
8131	endif
8132
8133	# Add COM/XPCOM stuff
8134	TEMPLATE_VBoxQtGuiExe_LIBS += \
8135	$(PATH_STAGE_LIB)/VBoxCOM$(if-expr "$(VBOX_QT_DBG)" != "$(VBOX_VCC_CRT_TYPE)" && $(KBUILD_TARGET) == win,-GUI,)$(VBOX_SUFF_LIB)
8136	ifdef VBOX_WITH_XPCOM
8137	## @todo may be worth creating the VBOX_XPCOM SDK def, or just a SDK_VBOXXPCOM.
8138	TEMPLATE_VBoxQtGuiExe_DEFS += VBOX_WITH_XPCOM
8139	ifdef VBOX_WITH_XPCOM_NAMESPACE_CLEANUP
8140	TEMPLATE_VBoxQtGuiExe_DEFS += VBOX_WITH_XPCOM_NAMESPACE_CLEANUP
8141	endif
8142	TEMPLATE_VBoxQtGuiExe_INCS += \
8143	$(VBOX_XPCOM_INCS)
8144	TEMPLATE_VBoxQtGuiExe_LIBS += \
8145	$(LIB_XPCOM)
8146	TEMPLATE_VBoxQtGuiExe_INTERMEDIATES += \
8147	$(VBOX_PATH_SDK)/bindings/xpcom/include/VirtualBox_XPCOM.h
8148	else # COM
8149	TEMPLATE_VBoxQtGuiExe_INCS += \
8150	$(VBOX_PATH_SDK)/bindings/mscom/include
8151	TEMPLATE_VBoxQtGuiExe_INTERMEDIATES += \
8152	$(VBOX_PATH_SDK)/bindings/mscom/include/VirtualBox.h
8153	endif # COM
8154
8155	ifn1of ($(KBUILD_TARGET), darwin os2 win)
8156	TEMPLATE_VBoxQtGuiExe_DEFS += PIC
8157	TEMPLATE_VBoxQtGuiExe_CFLAGS += -fPIC
8158	TEMPLATE_VBoxQtGuiExe_CXXFLAGS += -fPIC
8159	# Needed for GCC 9. Even system's Qt 5.12.4 (on Ubuntu 19.10) did not have this fixed yet.
8160	TEMPLATE_VBoxQtGuiExe_CXXFLAGS.linux = $(VBOX_GCC_Wno-deprecated-copy) $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS)
8161	TEMPLATE_VBoxQtGuiExe_LDFLAGS += -fPIC
8162	endif # not darwin, os2 or win
8163
8164	ifeq ($(KBUILD_TARGET),darwin)
8165	ifndef VBOX_WITH_QT6
8166	TEMPLATE_VBoxQtGuiExe_POST_CMDS = $(QUIET)install_name_tool $(foreach qtmod, $(VBOX_QT_MOD_NAMES), \
8167	$(foreach prefix, @executable_path/../Frameworks/ $(VBOX_PATH_QT)/Frameworks/ $(PATH_SDK_QT5)/, \
8168	-change "$(prefix)$(qtmod).framework/Versions/5/$(qtmod)" \
8169	"$(if $(VBOX_WITH_HARDENING),/Applications/VirtualBox.app/Contents/Frameworks,@rpath)/$(qtmod).framework/Versions/5/$(qtmod)" ) ) "$(out)"
8170	else
8171	TEMPLATE_VBoxQtGuiExe_POST_CMDS = $(QUIET)install_name_tool $(foreach qtmod, $(VBOX_QT_MOD_NAMES), \
8172	$(foreach prefix, @executable_path/../Frameworks/ $(VBOX_PATH_QT)/Frameworks/ $(PATH_SDK_QT6)/, \
8173	-change "$(prefix)$(qtmod).framework/Versions/A/$(qtmod)" \
8174	"$(if $(VBOX_WITH_HARDENING),/Applications/VirtualBox.app/Contents/Frameworks,@rpath)/$(qtmod).framework/Versions/A/$(qtmod)" ) ) "$(out)"
8175	endif
8176	endif
8177
8178	#
8179	# Template for building Qt GUI components.
8180	#
8181	TEMPLATE_VBoxQtGuiDll = VBox Qt GUI Components
8182	TEMPLATE_VBoxQtGuiDll_EXTENDS = VBoxQtGuiExe
8183	TEMPLATE_VBoxQtGuiDll_LIBS = $(filter-out $(QTMAIN),$(TEMPLATE_VBoxQtGuiExe_LIBS))
8184	ifeq ($(KBUILD_TARGET),darwin)
8185	TEMPLATE_VBoxQtGuiDll_LDFLAGS.darwin += $(filter-out -bind_at_load,$(TEMPLATE_VBoxQtGuiExe_LDFLAGS.darwin)) \
8186	-current_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
8187	-compatibility_version $(VBOX_VERSION_MAJOR).$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD)
8188	endif
8189	ifn1of ($(KBUILD_TARGET), darwin os2 win)
8190	TEMPLATE_VBoxQtGuiDll_DEFS = PIC $(TEMPLATE_VBoxQtGuiExe_DEFS)
8191	TEMPLATE_VBoxQtGuiDll_CFLAGS = -fPIC $(TEMPLATE_VBoxQtGuiExe_CFLAGS)
8192	TEMPLATE_VBoxQtGuiDll_CXXFLAGS = -fPIC $(TEMPLATE_VBoxQtGuiExe_CXXFLAGS)
8193	TEMPLATE_VBoxQtGuiDll_PCHFLAGS = $(TEMPLATE_VBoxQtGuiDll_CXXFLAGS)
8194	TEMPLATE_VBoxQtGuiDll_LDFLAGS = -fPIC $(TEMPLATE_VBoxQtGuiExe_LDFLAGS)
8195	endif
8196	endif # VBOX_WITH_QTGUI
8197
8198	ifdef VBOX_WITH_NLS
8199	#
8200	# Template for translation compilation.
8201	# Made as simple program without installing itself.
8202	# To archive it, the dummy code without runtime is used,
8203	# i.e. only compiler and system standard libs are linked.
8204	#
8205	TEMPLATE_VBoxNLS = VBox NLS template for installing translation files
8206	TEMPLATE_VBoxNLS_EXTENDS = VBoxR3Static
8207	ifndef VBOX_WITH_QT6
8208	TEMPLATE_VBoxNLS_USES := qt5
8209	TEMPLATE_VBoxNLS_QTTOOL := QT5
8210	else
8211	TEMPLATE_VBoxNLS_USES := qt6
8212	TEMPLATE_VBoxNLS_QTTOOL := QT6
8213	endif
8214	TEMPLATE_VBoxNLS_QT_INFIX = $(VBOX_QT_INFIX)
8215	TEMPLATE_VBoxNLS_INSTTYPE = none
8216	TEMPLATE_VBoxNLS_LRCFLAGS += -silent
8217	TEMPLATE_VBoxNLS_QT_TRANSLATIONS_INST = $(INST_BIN)nls/
8218	TEMPLATE_VBoxNLS_SOURCES = \
8219	$(PATH_ROOT)/src/VBox/Main/nls/dummy.c
8220	TEMPLATE_VBoxNLS_SDKS.$(KBUILD_TARGET_ARCH) = $(filter-out VBoxOpenSslStatic,$(TEMPLATE_VBoxR3Static_SDKS.$(KBUILD_TARGET_ARCH)))
8221	ifdef VBOX_WITH_NOCRT_STATIC
8222	TEMPLATE_VBoxNLS_LIBS.$(KBUILD_TARGET_ARCH) = $(filter-out \
8223	$(PATH_STAGE_LIB)/VBox-libxml2-static$(VBOX_SUFF_LIB), \
8224	$(TEMPLATE_VBoxR3Static_LIBS.$(KBUILD_TARGET_ARCH)))
8225	else
8226	TEMPLATE_VBoxNLS_LIBS.$(KBUILD_TARGET_ARCH) = $(filter-out \
8227	$(VBOX_LIB_RUNTIME_STATIC) \
8228	$(PATH_STAGE_LIB)/VBox-libxml2-static$(VBOX_SUFF_LIB), \
8229	$(TEMPLATE_VBoxR3Static_LIBS.$(KBUILD_TARGET_ARCH)))
8230	endif
8231	endif # !VBOX_WITH_NLS
8232
8233
8234	#
8235	# Template for installing symbol files that we wish to ship.
8236	#
8237	TEMPLATE_VBoxDbgSyms = Symbol files for VBoxDbg and gurus.
8238	TEMPLATE_VBoxDbgSyms_INST = $(INST_VBOXDBG_SYMS)
8239
8240
8241	#
8242	# Template for building build bldprogs.
8243	# HACK ALERT! The BLD_TRG_* is a hack to allow building libraries as well.
8244	#
8245	TEMPLATE_VBoxBldProg = VBox Build Program
8246	TEMPLATE_VBoxBldProg_BLD_TRG := $(KBUILD_HOST)
8247	TEMPLATE_VBoxBldProg_BLD_TRG_ARCH := $(KBUILD_HOST_ARCH)
8248	TEMPLATE_VBoxBldProg_BLD_TRG_CPU := $(KBUILD_HOST_CPU)
8249	TEMPLATE_VBoxBldProg_DEFS := IN_RING3 LOG_DISABLED IN_BLD_PROG
8250	TEMPLATE_VBoxBldProg_DEFS.win := _CRT_SECURE_NO_DEPRECATE
8251	ifeq ($(KBUILD_TARGET),$(KBUILD_HOST))
8252	TEMPLATE_VBoxBldProg_ASTOOL := $(VBOX_ASTOOL)
8253	TEMPLATE_VBoxBldProg_ASFLAGS.x86 := $(VBOX_ASFLAGS32)
8254	TEMPLATE_VBoxBldProg_ASFLAGS.arm32 := $(VBOX_ASFLAGS32)
8255	TEMPLATE_VBoxBldProg_ASFLAGS.sparc32 := $(VBOX_ASFLAGS32)
8256	TEMPLATE_VBoxBldProg_ASFLAGS.amd64 := $(VBOX_ASFLAGS64)
8257	TEMPLATE_VBoxBldProg_ASFLAGS.arm64 := $(VBOX_ASFLAGS64)
8258	TEMPLATE_VBoxBldProg_ASFLAGS.sparc64 := $(VBOX_ASFLAGS64)
8259	else if1of ($(KBUILD_TARGET_ARCH), amd64 x86)
8260	TEMPLATE_VBoxBldProg_ASTOOL := YASM
8261	TEMPLATE_VBoxBldProg_ASFLAGS := -D__YASM__ -Worphan-labels $(VBOX_YASM_Wno-segreg-in-64bit)
8262	if1of ($(KBUILD_HOST), win)
8263	TEMPLATE_VBoxBldProg_ASFLAGS += -g cv8 -DASM_FORMAT_ELF
8264	TEMPLATE_VBoxBldProg_ASFLAGS.x86 := -f win32
8265	TEMPLATE_VBoxBldProg_ASFLAGS.amd64 := -f win64
8266	else if1of ($(KBUILD_HOST), darwin)
8267	TEMPLATE_VBoxBldProg_ASFLAGS += -DASM_FORMAT_MACHO
8268	TEMPLATE_VBoxBldProg_ASFLAGS.x86 := -f macho32
8269	TEMPLATE_VBoxBldProg_ASFLAGS.amd64 := -f macho64
8270	else
8271	TEMPLATE_VBoxBldProg_ASFLAGS += -g dwarf2 -DASM_FORMAT_ELF
8272	TEMPLATE_VBoxBldProg_ASFLAGS.x86 := -f elf32
8273	TEMPLATE_VBoxBldProg_ASFLAGS.amd64 := -f elf64
8274	endif
8275	endif
8276	ifeq ($(KBUILD_HOST),win)
8277	TEMPLATE_VBoxBldProg_TOOL := $(VBOX_VCC_TOOL_STEM)$(toupper $(KBUILD_HOST_ARCH))
8278	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8279	TEMPLATE_VBoxBldProg_SDKS := ReorderCompilerIncs WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC $(VBOX_WINPSDK)
8280	else
8281	TEMPLATE_VBoxBldProg_SDKS := ReorderCompilerIncs $(VBOX_WINPSDK)
8282	endif
8283	TEMPLATE_VBoxBldProg_CXXFLAGS := -Zi -Zl -GR- -EHsc -GF $(VBOX_VCC_WCHAR_T_VARIANT) $(VBOX_VCC_OPT) $(VBOX_VCC_FP) \
8284	-MT$(VBOX_VCC_CRT_TYPE) -Gy $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_std) $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR)
8285	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120"
8286	TEMPLATE_VBoxBldProg_CXXFLAGS += -Gw
8287	endif
8288	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140" # Reduces object size, speeding up linking and makes inline behaviour C++11 compliant.
8289	TEMPLATE_VBoxBldProg_CXXFLAGS += -Zc:inline
8290	endif
8291	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
8292	TEMPLATE_VBoxBldProg_CXXFLAGS += /volatileMetadata-
8293	endif
8294	ifdef VBOX_WITH_MSC_ANALYZE_THIS
8295	TEMPLATE_VBoxBldProg_CXXFLAGS += /analyze
8296	endif
8297	TEMPLATE_VBoxBldProg_CXXFLAGS.debug := -RTCsu
8298	TEMPLATE_VBoxBldProg_CXXFLAGS.dbgopt = $(NO_SUCH_VARIABLE)
8299	TEMPLATE_VBoxBldProg_CXXFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8300	TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8301	TEMPLATE_VBoxBldProg_CFLAGS = $(filter-out $(VBOX_VCC_std),$(TEMPLATE_VBoxBldProg_CXXFLAGS))
8302	TEMPLATE_VBoxBldProg_CFLAGS.debug = $(TEMPLATE_VBoxBldProg_CXXFLAGS.debug)
8303	TEMPLATE_VBoxBldProg_CFLAGS.dbgopt = $(TEMPLATE_VBoxBldProg_CXXFLAGS.dbgopt)
8304	TEMPLATE_VBoxBldProg_CFLAGS.release = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8305	TEMPLATE_VBoxBldProg_CFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8306	TEMPLATE_VBoxBldProg_CFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8307	TEMPLATE_VBoxBldProg_PCHFLAGS = $(TEMPLATE_VBoxBldProg_CXXFLAGS)
8308	TEMPLATE_VBoxBldProg_PCHFLAGS.debug = $(TEMPLATE_VBoxBldProg_CXXFLAGS.debug)
8309	TEMPLATE_VBoxBldProg_PCHFLAGS.dbgopt = $(TEMPLATE_VBoxBldProg_CXXFLAGS.dbgopt)
8310	TEMPLATE_VBoxBldProg_PCHFLAGS.release = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8311	TEMPLATE_VBoxBldProg_PCHFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8312	TEMPLATE_VBoxBldProg_PCHFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8313	TEMPLATE_VBoxBldProg_LDFLAGS = -Ignore:4197 \
8314	/NOD /INCREMENTAL:NO /MAPINFO:EXPORTS /LargeAddressAware /DynamicBase /NxCompat /Release /Debug /Opt:Ref /Opt:Icf \
8315	$(VBOX_VCC_LD_GUARD_CF) \
8316	/Version:$(VBOX_VERSION_MAJOR)0$(VBOX_VERSION_MINOR).$(VBOX_VERSION_BUILD) \
8317	/DISALLOWLIB:libc$(VBOX_VCC_CRT_TYPE_N).lib \
8318	/DISALLOWLIB:libcmt$(VBOX_VCC_CRT_TYPE_N).lib \
8319	/DISALLOWLIB:msvcrt.lib \
8320	/DISALLOWLIB:msvcrtd.lib \
8321	/DISALLOWLIB:msvcprt.lib \
8322	/DISALLOWLIB:msvcprtd.lib \
8323	/DISALLOWLIB:libvcruntime$(VBOX_VCC_CRT_TYPE_N).lib \
8324	/DISALLOWLIB:libucrt$(VBOX_VCC_CRT_TYPE_N).lib \
8325	/DISALLOWLIB:vcruntime.lib \
8326	/DISALLOWLIB:vcruntimed.lib \
8327	/DISALLOWLIB:ucrt.lib \
8328	/DISALLOWLIB:ucrtd.lib
8329	TEMPLATE_VBoxBldProg_LDFLAGS.win.amd64 = $(VBOX_VCC_LD_HIGH_ENTRYOPY_VA)
8330	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC142" # Don't waste space on x86/amd64-on-arm emulation optimizations.
8331	TEMPLATE_VBoxBldProg_LDFLAGS += -EmitVolatileMetadata:NO
8332	endif
8333	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8334	TEMPLATE_VBoxBldProg_LIBS = \
8335	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libvcruntime$(VBOX_VCC_CRT_TYPE).lib \
8336	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8337	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib \
8338	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/oldnames.lib
8339	else
8340	TEMPLATE_VBoxBldProg_LIBS = \
8341	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/oldnames.lib \
8342	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8343	$(PATH_TOOL_$(TEMPLATE_VBoxBldProg_TOOL)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
8344	endif
8345
8346	else
8347	# (gcc of some kind )
8348	TEMPLATE_VBoxBldProg_TOOL = GXX3
8349	if $(VBOX_GCC_VERSION_CC) < 30400
8350	TEMPLATE_VBoxBldProg_DEFS += RT_WITHOUT_PRAGMA_ONCE
8351	endif
8352	TEMPLATE_VBoxBldProg_CFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_C) $(VBOX_GCC_Wno-variadic-macros)
8353	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
8354	TEMPLATE_VBoxBldProg_CFLAGS += $(VBOX_GCC_WERR)
8355	endif
8356	TEMPLATE_VBoxBldProg_CFLAGS.x86 = -m32
8357	TEMPLATE_VBoxBldProg_CFLAGS.sparc32 = -m32
8358	TEMPLATE_VBoxBldProg_CFLAGS.amd64 = -m64
8359	TEMPLATE_VBoxBldProg_CFLAGS.sparc64 = -m64
8360	TEMPLATE_VBoxBldProg_CFLAGS.release = -O2 -fno-omit-frame-pointer -fno-strict-aliasing
8361	TEMPLATE_VBoxBldProg_CFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8362	TEMPLATE_VBoxBldProg_CFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8363	TEMPLATE_VBoxBldProg_CXXFLAGS = -g $(VBOX_GCC_pipe) $(VBOX_GCC_PEDANTIC_CXX) $(VBOX_GCC_Wno-variadic-macros) $(VBOX_GCC_std)
8364	ifdef VBOX_WITH_NO_GCC_WARNING_POLICY
8365	TEMPLATE_VBoxBldProg_CXXFLAGS += $(VBOX_GCC_WERR)
8366	endif
8367	TEMPLATE_VBoxBldProg_CXXFLAGS.x86 = -m32
8368	TEMPLATE_VBoxBldProg_CXXFLAGS.sparc32 = -m32
8369	TEMPLATE_VBoxBldProg_CXXFLAGS.amd64 = -m64
8370	TEMPLATE_VBoxBldProg_CXXFLAGS.sparc64 = -m64
8371	TEMPLATE_VBoxBldProg_CXXFLAGS.release = -O2 -fno-omit-frame-pointer -fno-strict-aliasing
8372	TEMPLATE_VBoxBldProg_CXXFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8373	TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8374	TEMPLATE_VBoxBldProg_OBJCFLAGS = $(TEMPLATE_VBoxBldProg_CFLAGS)
8375	TEMPLATE_VBoxBldProg_OBJCFLAGS.x86 = $(TEMPLATE_VBoxBldProg_CFLAGS.x86)
8376	TEMPLATE_VBoxBldProg_OBJCFLAGS.amd64 = $(TEMPLATE_VBoxBldProg_CFLAGS.amd64)
8377	TEMPLATE_VBoxBldProg_OBJCFLAGS.release = $(TEMPLATE_VBoxBldProg_CFLAGS.release)
8378	TEMPLATE_VBoxBldProg_OBJCFLAGS.profile = $(TEMPLATE_VBoxBldProg_CFLAGS.profile)
8379	TEMPLATE_VBoxBldProg_OBJCFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CFLAGS.kprofile)
8380	TEMPLATE_VBoxBldProg_OBJCXXFLAGS = $(TEMPLATE_VBoxBldProg_CXXFLAGS)
8381	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.x86 = $(TEMPLATE_VBoxBldProg_CXXFLAGS.x86)
8382	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.amd64 = $(TEMPLATE_VBoxBldProg_CXXFLAGS.amd64)
8383	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.release = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8384	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8385	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8386	TEMPLATE_VBoxBldProg_PCHFLAGS = $(TEMPLATE_VBoxBldProg_CXXFLAGS)
8387	TEMPLATE_VBoxBldProg_PCHFLAGS.x86 = $(TEMPLATE_VBoxBldProg_CXXFLAGS.x86)
8388	TEMPLATE_VBoxBldProg_PCHFLAGS.amd64 = $(TEMPLATE_VBoxBldProg_CXXFLAGS.amd64)
8389	TEMPLATE_VBoxBldProg_PCHFLAGS.release = $(TEMPLATE_VBoxBldProg_CXXFLAGS.release)
8390	TEMPLATE_VBoxBldProg_PCHFLAGS.profile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.profile)
8391	TEMPLATE_VBoxBldProg_PCHFLAGS.kprofile = $(TEMPLATE_VBoxBldProg_CXXFLAGS.kprofile)
8392	TEMPLATE_VBoxBldProg_LDFLAGS.x86 = -m32
8393	TEMPLATE_VBoxBldProg_LDFLAGS.sparc32 = -m32
8394	TEMPLATE_VBoxBldProg_LDFLAGS.amd64 = -m64
8395	TEMPLATE_VBoxBldProg_LDFLAGS.sparc64 = -m64
8396	ifeq ($(KBUILD_HOST),linux)
8397	TEMPLATE_VBoxBldProg_LIBS = pthread m rt dl
8398	else ifeq ($(KBUILD_HOST),os2)
8399	TEMPLATE_VBoxBldProg_TOOL = GXX3OMF
8400	TEMPLATE_VBoxBldProg_LIBS = socket iconv
8401	else ifeq ($(KBUILD_HOST),darwin)
8402	TEMPLATE_VBoxBldProg_TOOL = $(VBOX_GCC_TOOL)
8403	if "$(VBOX_DEF_MACOSX_VERSION_MIN)" == "10.7" \|\| "$(VBOX_DARWIN_HOST_VERSION_MAJOR)" == "7"
8404	TEMPLATE_VBoxBldProg_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_DEFS)
8405	TEMPLATE_VBoxBldProg_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_CFLAGS) -fno-common
8406	TEMPLATE_VBoxBldProg_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_CXXFLAGS)
8407	TEMPLATE_VBoxBldProg_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_CXXFLAGS)
8408	TEMPLATE_VBoxBldProg_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_OBJCFLAGS) $(VBOX_GCC_PEDANTIC_C)
8409	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_OBJCXXFLAGS) $(VBOX_GCC_PEDANTIC_CXX)
8410	TEMPLATE_VBoxBldProg_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_7_LDFLAGS)
8411	else if "$(VBOX_DEF_MACOSX_VERSION_MIN)" == "10.6" \|\| "$(VBOX_DARWIN_HOST_VERSION_MAJOR)" == "6"
8412	TEMPLATE_VBoxBldProg_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_DEFS)
8413	TEMPLATE_VBoxBldProg_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_CFLAGS) -fno-common
8414	TEMPLATE_VBoxBldProg_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_CXXFLAGS)
8415	TEMPLATE_VBoxBldProg_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_CXXFLAGS)
8416	TEMPLATE_VBoxBldProg_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_OBJCFLAGS) $(VBOX_GCC_PEDANTIC_C)
8417	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_OBJCXXFLAGS) $(VBOX_GCC_PEDANTIC_CXX)
8418	TEMPLATE_VBoxBldProg_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_6_LDFLAGS)
8419	else if "$(VBOX_DEF_MACOSX_VERSION_MIN)" == "10.5" \|\| "$(VBOX_DARWIN_HOST_VERSION_MAJOR)" == "5" \|\| defined(VBOX_MACOS_10_5_WORKAROUND)
8420	TEMPLATE_VBoxBldProg_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_DEFS)
8421	TEMPLATE_VBoxBldProg_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_CFLAGS) -fno-common
8422	TEMPLATE_VBoxBldProg_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_CXXFLAGS)
8423	TEMPLATE_VBoxBldProg_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_CXXFLAGS)
8424	TEMPLATE_VBoxBldProg_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_OBJCFLAGS) $(VBOX_GCC_PEDANTIC_C)
8425	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_OBJCXXFLAGS) $(VBOX_GCC_PEDANTIC_CXX)
8426	TEMPLATE_VBoxBldProg_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_10_5_LDFLAGS)
8427	else
8428	TEMPLATE_VBoxBldProg_SDKS.darwin = $(VBOX_DARWIN_DEF_SDK_SDKS)
8429	TEMPLATE_VBoxBldProg_DEFS.darwin = $(VBOX_DARWIN_DEF_SDK_DEFS)
8430	TEMPLATE_VBoxBldProg_CFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CFLAGS) -fno-common
8431	TEMPLATE_VBoxBldProg_CXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
8432	TEMPLATE_VBoxBldProg_PCHFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_CXXFLAGS)
8433	TEMPLATE_VBoxBldProg_OBJCFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_OBJCFLAGS) $(VBOX_GCC_PEDANTIC_C)
8434	TEMPLATE_VBoxBldProg_OBJCXXFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_OBJCXXFLAGS) $(VBOX_GCC_PEDANTIC_CXX)
8435	TEMPLATE_VBoxBldProg_LDFLAGS.darwin = $(VBOX_DARWIN_DEF_SDK_LDFLAGS)
8436	endif
8437	TEMPLATE_VBoxBldProg_LIBS =
8438	else ifeq ($(KBUILD_HOST),haiku)
8439	TEMPLATE_VBoxBldProg_TOOL = GXX3
8440	TEMPLATE_VBoxBldProg_LIBS = network iconv
8441	TEMPLATE_VBoxBldProg_LIBPATH += \
8442	/boot/common/lib
8443	else if1of ($(KBUILD_HOST), freebsd openbsd)
8444	TEMPLATE_VBoxBldProg_TOOL = $(VBOX_GCC_TOOL)
8445	TEMPLATE_VBoxBldProg_LIBS = pthread
8446	TEMPLATE_VBoxBldProg_INCS += \
8447	/usr/include \
8448	/usr/X11R6/include \
8449	/usr/local/include
8450	TEMPLATE_VBoxBldProg_LIBPATH += \
8451	/usr/lib \
8452	/usr/X11R6/lib \
8453	/usr/local/lib
8454	else ifeq ($(KBUILD_HOST),netbsd)
8455	TEMPLATE_VBoxBldProg_TOOL = GXX3
8456	TEMPLATE_VBoxBldProg_LIBS = pthread
8457	TEMPLATE_VBoxBldProg_INCS += \
8458	/usr/include \
8459	/usr/X11R7/include
8460	TEMPLATE_VBoxBldProg_LIBPATH += \
8461	/usr/lib \
8462	/usr/X11R7/lib
8463	else ifeq ($(KBUILD_HOST),solaris)
8464	TEMPLATE_VBoxBldProg_TOOL = GXX3PLAIN
8465	TEMPLATE_VBoxBldProg_LIBS = rt
8466	else
8467	$(warning Warning: VBOX Build: Target $(KBUILD_HOST) is not officially supported!)
8468	endif
8469
8470	endif # !win
8471
8472
8473	#
8474	# Advanced build programs using IPRT and stuff.
8475	#
8476	TEMPLATE_VBoxAdvBldProg = Advanced VBox Build Program
8477	TEMPLATE_VBoxAdvBldProg_EXTENDS = VBoxBldProg
8478	TEMPLATE_VBoxAdvBldProg_SDKS = $(TEMPLATE_VBoxBldProg_SDKS)
8479	TEMPLATE_VBoxAdvBldProg_SDKS.win = $(TEMPLATE_VBoxBldProg_SDKS.win) VBoxNtDll
8480	TEMPLATE_VBoxAdvBldProg_DEFS = $(TEMPLATE_VBoxBldProg_DEFS) IN_RT_R3 IN_ADV_BLD_PROG
8481	ifeq ($(KBUILD_HOST),win)
8482	TEMPLATE_VBoxAdvBldProg_CFLAGS = $(TEMPLATE_VBoxBldProg_CFLAGS) $(VBOX_VCC_WERR)
8483	TEMPLATE_VBoxAdvBldProg_CXXFLAGS = $(TEMPLATE_VBoxBldProg_CXXFLAGS) $(VBOX_VCC_WERR)
8484	TEMPLATE_VBoxAdvBldProg_PCHFLAGS = $(TEMPLATE_VBoxAdvBldProg_CXXFLAGS)
8485	endif
8486	TEMPLATE_VBoxAdvBldProg_LDFLAGS.darwin.arm64 = \
8487	$(TEMPLATE_VBoxBldProg_LDFLAGS.darwin.arm64) -framework IOKit
8488	TEMPLATE_VBoxAdvBldProg_LIBS = \
8489	$(PATH_STAGE_LIB)/RuntimeBldProg$(VBOX_HOSTSUFF_LIB) \
8490	$(TEMPLATE_VBoxBldProg_LIBS)
8491	TEMPLATE_VBoxAdvBldProg_LIBS.darwin = \
8492	$(TEMPLATE_VBoxAdvBldProg_LIBS) \
8493	iconv \
8494	$(TEMPLATE_VBoxBldProg_LIBS.darwin)
8495	TEMPLATE_VBoxAdvBldProg_LIBS.freebsd = \
8496	$(TEMPLATE_VBoxAdvBldProg_LIBS) \
8497	iconv \
8498	rt \
8499	$(TEMPLATE_VBoxBldProg_LIBS.freebsd)
8500	TEMPLATE_VBoxAdvBldProg_LIBS.linux = \
8501	$(TEMPLATE_VBoxAdvBldProg_LIBS) \
8502	$(TEMPLATE_VBoxBldProg_LIBS.linux)
8503	TEMPLATE_VBoxAdvBldProg_LIBS.solaris = \
8504	$(TEMPLATE_VBoxAdvBldProg_LIBS) \
8505	contract \
8506	kstat \
8507	rt \
8508	socket \
8509	nsl \
8510	$(TEMPLATE_VBoxBldProg_LIBS.solaris)
8511
8512
8513	#
8514	# Windows rc workaround for crosscompiling.
8515	# (Some (old) Wine versions fails loading msvcrt.dll from the VCC bin directory.)
8516	#
8517	ifneq ($(KBUILD_HOST),win)
8518	TOOL_VCC80X86_RC := $(EXEC_X86_WIN32) $(KBUILD_DEVTOOLS)/win.x86/bin/rc.exe
8519	TOOL_VCC80AMD64_RC := $(EXEC_X86_WIN32) $(KBUILD_DEVTOOLS)/win.x86/bin/rc.exe
8520	TOOL_VCC70_RC := $(EXEC_X86_WIN32) $(KBUILD_DEVTOOLS)/win.x86/bin/rc.exe
8521	WIN32_MC = $(EXEC_X86_WIN32) $(KBUILD_DEVTOOLS)/win.x86/bin/mc.exe
8522	else
8523	WIN32_MC = $(EXEC_X86_WIN32) $(firstword $(wildcard \
8524	$(PATH_SDK_$(VBOX_WINPSDK)_BIN)/MC.Exe \
8525	$(PATH_SDK_WINPSDK_BIN)/MC.Exe \
8526	$(PATH_SDK_WINPSDK)/Bin/MC.Exe \
8527	$(PATH_SDK_WIN32SDK_BIN)/MC.Exe \
8528	$(PATH_SDK_WIN64SDK_BIN)/MC.Exe \
8529	$(KBUILD_DEVTOOLS)/win.x86/bin/mc.exe \
8530	) Sorry_Cannot_find_mc_in_the_PSDK)
8531	endif
8532
8533
8534	#
8535	# Base template for building R3 programs for the guest additions.
8536	# Do _note_ use directly!
8537	#
8538	## @todo bake it into VBoxGuestR3Exe.
8539	TEMPLATE_VBoxGuestR3ExeBase = VBox Guest Program
8540	ifeq ($(KBUILD_TARGET),win)
8541	TEMPLATE_VBoxGuestR3ExeBase_EXTENDS = VBoxR3StaticBase
8542	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
8543	ifdef VBOX_WITH_NOCRT_STATIC
8544	TEMPLATE_VBoxGuestR3ExeBase_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK_GST) VBoxNtDll
8545	else
8546	TEMPLATE_VBoxGuestR3ExeBase_SDKS = ReorderCompilerIncs WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC $(VBOX_WINPSDK_GST) VBoxNtDll
8547	endif
8548	else
8549	TEMPLATE_VBoxGuestR3ExeBase_SDKS = ReorderCompilerIncs $(VBOX_WINPSDK_GST) VBoxNtDll
8550	endif
8551	# Hack for running on NT3x, NT4, W2K and XP w/o SP:
8552	# 1. Change OS and subsystem version in the image.
8553	# 2. NT 3.1 requires the IAT to be writable. To avoid making all of .rdata
8554	# writable we use the undocumented -NoOptIData option to prevent .idata$*
8555	# from being merged into .rdata.
8556	# 3. NT 3.1 doesn't support merging initialized and uninitialized section
8557	# because it doesn't recognize Misc.VirtualSize. So, we set the uncached
8558	# flag (!K) on the .bss section make it incompatible with .data.
8559	# VBOX_PE_SET_VERSION will clear the !K flag. (Not needed in no-CRT mode,
8560	# as the init code zeros uninitialized data there when running on NT 3.1.)
8561	# Similarly, for XP64 and 64-bit W2K3 we need to make sure the subsystem version
8562	# in the binaries are set to 5.2. The Visual C++ 2019 linker defaults to 6.0.
8563	# HACK ALERT! Double expansion of $$(NLTAB).
8564	TEMPLATE_VBoxGuestR3ExeBase_USES.win = $(TEMPLATE_VBoxR3StaticBase_USES.win) vboximportchecker
8565	TEMPLATE_VBoxGuestR3ExeBase_VBOX_IMPORT_CHECKER.win.x86 = nt31
8566	TEMPLATE_VBoxGuestR3ExeBase_VBOX_IMPORT_CHECKER.win.amd64 = xp64
8567	TEMPLATE_VBoxGuestR3ExeBase_POST_CMDS.win.x86 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION) $(out)$$(NLTAB)$(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_POST_CMDS))
8568	TEMPLATE_VBoxGuestR3ExeBase_LNK_DEPS.win.x86 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION))
8569	TEMPLATE_VBoxGuestR3ExeBase_POST_CMDS.win.amd64 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION) $(out)$$(NLTAB)$(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_POST_CMDS))
8570	TEMPLATE_VBoxGuestR3ExeBase_LNK_DEPS.win.amd64 = $(if $(eq $(tool_do),LINK_LIBRARY),,$(VBOX_PE_SET_VERSION))
8571	ifdef VBOX_WITH_NOCRT_STATIC
8572	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.win.x86 = $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LDFLAGS.win.x86) -NoOptIData
8573	else
8574	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.win.x86 = -NoOptIData -Section:.bss,RW!K $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LDFLAGS.win.x86)
8575	endif
8576
8577	if defined(VBOX_WITH_MORE_NT4_COMPAT_BINARIES) && "$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)" == "win.x86"
8578	TEMPLATE_VBoxGuestR3ExeBase_LIBS.win.x86 = $(NO_SUCH_VARIABLE)# Ditch RuntimeR3VccTricks2
8579	endif
8580
8581	else # the gcc guys
8582	TEMPLATE_VBoxGuestR3ExeBase_EXTENDS = VBoxR3Exe
8583	ifn1of ($(KBUILD_TARGET), darwin)
8584	TEMPLATE_VBoxGuestR3ExeBase_TOOL := $(subst GXX,GCC,$(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_TOOL))
8585	endif
8586	TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS = $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_CXXFLAGS) -fno-exceptions -fno-rtti
8587	# Do not inherit sanitizer flags from VBoxR3Exe in guest executables. Deal with them separately.
8588	TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS.debug = $(NO_SUCH_VARIABLE)
8589	TEMPLATE_VBoxGuestR3ExeBase_CFLAGS.debug = $(NO_SUCH_VARIABLE)
8590	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.linux = $(filter-out $(VBOX_GCC_ORIGIN_OPT),$(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LDFLAGS.linux))
8591	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.debug = $(NO_SUCH_VARIABLE)
8592	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS = $(filter-out '$(VBOX_GCC_RPATH_OPT)%,$(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LDFLAGS))
8593	ifn1of ($(KBUILD_TARGET), darwin os2) # ELF only. Present in gcc 3.2.3 & binutils 2.15, possibly earlier.
8594	ifdef VBOX_LD_gc_sections # Older solaris linker versions doesn't grok --gc-sections (e.g. add build box).
8595	TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS += -ffunction-sections -fdata-sections
8596	TEMPLATE_VBoxGuestR3ExeBase_CFLAGS += -ffunction-sections -fdata-sections
8597	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS += $(VBOX_LD_gc_sections)
8598	endif
8599	endif
8600	endif
8601	TEMPLATE_VBoxGuestR3ExeBase_INST = $(INST_ADDITIONS)
8602	TEMPLATE_VBoxGuestR3ExeBase_DEFS := \
8603	$(filter-out $(ARCH_BITS_DEFS) VBOX_WITH_DTRACE VBOX_WITH_DTRACE_R3, $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_DEFS)) \
8604	IN_GUEST \
8605	IN_GUEST_R3 \
8606	IN_RT_R3 \
8607	IN_RT_STATIC \
8608	$(VBOX_GC_ARCH_BITS_DEFS) \
8609	RT_NEED_NEW_AND_DELETE
8610	ifeq ($(KBUILD_TARGET),linux) # As few libs as possible on linux.
8611	TEMPLATE_VBoxGuestR3ExeBase_LIBS = pthread rt m dl
8612	else if1of ($(KBUILD_TARGET), darwin freebsd openbsd)
8613	TEMPLATE_VBoxGuestR3ExeBase_LIBS = $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LIBS) iconv
8614	else ifeq ($(KBUILD_TARGET),solaris)
8615	TEMPLATE_VBoxGuestR3ExeBase_LIBS = $(TEMPLATE_$(TEMPLATE_VBoxGuestR3ExeBase_EXTENDS)_LIBS) nsl
8616	endif
8617
8618	# Use older versions of APIs which were improved in versions of glibc later
8619	# than what we are targetting, and do not use the stack protector, which
8620	# needs glibc 2.4 or later.
8621	TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS.linux = \
8622	-include $(PATH_ROOT)/include/iprt/linux/symvers.h \
8623	$(VBOX_GCC_fno-stack-protector)
8624	TEMPLATE_VBoxGuestR3ExeBase_CFLAGS.linux = $(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS.linux)
8625	# The GNU_HASH ELF tag is not supported by older systems.
8626	TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.linux += $(VBOX_LD_hash_style_sysv)
8627
8628
8629	#
8630	# Template for building normal R3 programs for the guest additions, strict.
8631	#
8632	TEMPLATE_VBoxGuestR3Exe = VBox Guest Program w/ IPRT and VBGL.
8633	TEMPLATE_VBoxGuestR3Exe_EXTENDS = VBoxGuestR3ExeBase
8634	ifeq ($(KBUILD_TARGET),win)
8635	TEMPLATE_VBoxGuestR3Exe_CFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CFLAGS) $(VBOX_VCC_WERR)
8636	TEMPLATE_VBoxGuestR3Exe_CXXFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS) $(VBOX_VCC_WERR)
8637	if1of ($(VBOX_VCC_TOOL_STEM), VCC120)
8638	# VBoxDrvInst.cpp(520) : warning C4313: 'wprintf' : '%d' in format string conflicts with argument 1 of type 'const TCHAR *' [false positive - buggy compiler?]
8639	TEMPLATE_VBoxGuestR3Exe_CXXFLAGS += -wd4313
8640	endif
8641	TEMPLATE_VBoxGuestR3Exe_LDFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS) $(VBOX_VCC_LD_WERR)
8642	ifndef VBOX_WITH_NOCRT_STATIC # Temporary kludge to deal with some link order issues.
8643	TEMPLATE_VBoxGuestR3Exe_LDFLAGS.win.x86 = $(TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS.win.x86) -Include:_vcc100_kernel32_fakes_asm
8644	endif
8645	TEMPLATE_VBoxGuestR3Exe_LIBS.x86 = \
8646	$(VBOX_LIB_IPRT_GUEST_R3_X86) \
8647	$(VBOX_LIB_VBGL_R3_X86) \
8648	$(VBOX_LIB_IPRT_GUEST_R3_X86) \
8649	$(TEMPLATE_VBoxGuestR3ExeBase_LIBS.x86)
8650	TEMPLATE_VBoxGuestR3Exe_LIBS.$(KBUILD_TARGET_ARCH) = \
8651	$(VBOX_LIB_IPRT_GUEST_R3) \
8652	$(VBOX_LIB_VBGL_R3) \
8653	$(VBOX_LIB_IPRT_GUEST_R3) \
8654	$(TEMPLATE_VBoxGuestR3ExeBase_LIBS.$(KBUILD_TARGET_ARCH))
8655	else
8656	TEMPLATE_VBoxGuestR3Exe_CFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CFLAGS) $(VBOX_GCC_WERR)
8657	TEMPLATE_VBoxGuestR3Exe_CXXFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS) $(VBOX_GCC_WERR)
8658	TEMPLATE_VBoxGuestR3Exe_LIBS = \
8659	$(VBOX_LIB_IPRT_GUEST_R3) \
8660	$(VBOX_LIB_VBGL_R3) \
8661	$(VBOX_LIB_IPRT_GUEST_R3) \
8662	$(TEMPLATE_VBoxGuestR3ExeBase_LIBS)
8663	ifeq ($(KBUILD_TARGET),solaris)
8664	TEMPLATE_VBoxGuestR3Exe_LIBS += contract
8665	endif
8666	endif
8667
8668	#
8669	# Template for building R3 (dynamic) libraries for the guest additions, relaxed.
8670	#
8671	TEMPLATE_VBoxGuestR3DllNonPedantic := VBox Guest User Dynamic Libraries w/ IPRT and VBGL, non-pedantic.
8672	TEMPLATE_VBoxGuestR3DllNonPedantic_EXTENDS := VBoxGuestR3ExeBase
8673	## @todo add a INSTFUN that separates dlls and libs.
8674	ifeq ($(KBUILD_TARGET),win)
8675	ifeq ($(KBUILD_TYPE),asan)
8676	TEMPLATE_VBoxGuestR3DllNonPedantic_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_LIBS.x86)))
8677	TEMPLATE_VBoxGuestR3DllNonPedantic_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_LIBS.amd64)))
8678	endif
8679	else ifn1of ($(KBUILD_TARGET), darwin os2 win)
8680	TEMPLATE_VBoxGuestR3DllNonPedantic_DEFS = $(TEMPLATE_VBoxGuestR3ExeBase_DEFS) PIC
8681	TEMPLATE_VBoxGuestR3DllNonPedantic_CFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CFLAGS) -fPIC
8682	TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS) -fPIC -fno-exceptions
8683	TEMPLATE_VBoxGuestR3DllNonPedantic_LDFLAGS = $(TEMPLATE_VBoxGuestR3ExeBase_LDFLAGS) -fPIC
8684	endif
8685	ifeq ($(KBUILD_TARGET),win)
8686	TEMPLATE_VBoxGuestR3DllNonPedantic_LIBS.x86 = \
8687	$(VBOX_LIB_IPRT_GUEST_R3_SHARED_X86) \
8688	$(VBOX_LIB_VBGL_R3_SHARED_X86) \
8689	$(VBOX_LIB_IPRT_GUEST_R3_SHARED_X86) \
8690	$(TEMPLATE_VBoxGuestR3ExeBase_LIBS.x86)
8691	TEMPLATE_VBoxGuestR3DllNonPedantic_LIBS.$(KBUILD_TARGET_ARCH) = \
8692	$(VBOX_LIB_IPRT_GUEST_R3_SHARED) \
8693	$(VBOX_LIB_VBGL_R3_SHARED) \
8694	$(VBOX_LIB_IPRT_GUEST_R3_SHARED) \
8695	$(TEMPLATE_VBoxGuestR3ExeBase_LIBS.$(KBUILD_TARGET_ARCH))
8696	else
8697	TEMPLATE_VBoxGuestR3DllNonPedantic_LIBS = \
8698	$(VBOX_LIB_IPRT_GUEST_R3_SHARED) \
8699	$(VBOX_LIB_VBGL_R3_SHARED) \
8700	$(VBOX_LIB_IPRT_GUEST_R3_SHARED) \
8701	$(TEMPLATE_VBoxGuestR3ExeBase_LIBS)
8702	endif
8703
8704	#
8705	# Template for building normal R3 (dynamic) libraries for the guest additions, strict.
8706	#
8707	TEMPLATE_VBoxGuestR3Dll := VBox Guest User Dynamic Libraries w/ IPRT and VBGL.
8708	TEMPLATE_VBoxGuestR3Dll_EXTENDS := VBoxGuestR3DllNonPedantic
8709	ifeq ($(KBUILD_TARGET),win)
8710	TEMPLATE_VBoxGuestR3Dll_CFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_CFLAGS) $(VBOX_VCC_WERR)
8711	TEMPLATE_VBoxGuestR3Dll_CXXFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS) $(VBOX_VCC_WERR)
8712	TEMPLATE_VBoxGuestR3Dll_LDFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_LDFLAGS) $(VBOX_VCC_LD_WERR)
8713	else
8714	TEMPLATE_VBoxGuestR3Dll_CFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_CFLAGS) $(VBOX_GCC_WERR)
8715	TEMPLATE_VBoxGuestR3Dll_CXXFLAGS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS) $(VBOX_GCC_WERR)
8716	endif
8717
8718	#
8719	# Variant of VBoxGuestR3Dll that requires Windows 2000 or later for x86, and W2K3 for AMD64.
8720	#
8721	TEMPLATE_VBoxGuestR3DllMinW2K = VBox Guest User Dynamic Libraries w/ IPRT and VBGL.
8722	TEMPLATE_VBoxGuestR3DllMinW2K_EXTENDS = VBoxGuestR3Dll
8723	TEMPLATE_VBoxGuestR3DllMinW2K_VBOX_IMPORT_CHECKER.win.x86 = w2k
8724	ifeq ($(KBUILD_TARGET),win)
8725	ifdef VBOX_WITH_NOCRT_STATIC
8726	TEMPLATE_VBoxGuestR3DllMinW2K_LDFLAGS.win.x86 = $(filter-out -NoOptIData,$(TEMPLATE_VBoxGuestR3Dll_LDFLAGS.win.x86))
8727	else
8728	TEMPLATE_VBoxGuestR3DllMinW2K_LDFLAGS.win.x86 = $(filter-out -NoOptIData -Section:.bss$(COMMA)RW!K,$(TEMPLATE_VBoxGuestR3Dll_LDFLAGS.win.x86))
8729	endif
8730	TEMPLATE_VBoxGuestR3DllMinW2K_POST_CMDS.win.x86 = $(subst $(VBOX_PE_SET_VERSION), $(VBOX_PE_SET_VERSION) --w2k,$(TEMPLATE_VBoxGuestR3Dll_POST_CMDS.win.x86))
8731	endif
8732
8733	#
8734	# Variant of VBoxGuestR3Dll that requires Windows Vista or later.
8735	#
8736	TEMPLATE_VBoxGuestR3DllMinVista = VBox Guest User Dynamic Libraries w/ IPRT and VBGL.
8737	TEMPLATE_VBoxGuestR3DllMinVista_EXTENDS = VBoxGuestR3Dll
8738	TEMPLATE_VBoxGuestR3DllMinVista_VBOX_IMPORT_CHECKER.win.x86 = vista
8739	TEMPLATE_VBoxGuestR3DllMinVista_VBOX_IMPORT_CHECKER.win.amd64 = vista
8740	ifeq ($(KBUILD_TARGET),win)
8741	ifdef VBOX_WITH_NOCRT_STATIC
8742	TEMPLATE_VBoxGuestR3DllMinVista_LDFLAGS.win.x86 = $(filter-out -NoOptIData,$(TEMPLATE_VBoxGuestR3Dll_LDFLAGS.win.x86))
8743	else
8744	TEMPLATE_VBoxGuestR3DllMinVista_LDFLAGS.win.x86 = $(filter-out -NoOptIData -Section:.bss$(COMMA)RW!K,$(TEMPLATE_VBoxGuestR3Dll_LDFLAGS.win.x86))
8745	endif
8746	TEMPLATE_VBoxGuestR3DllMinVista_POST_CMDS.win.x86 = $(subst $(VBOX_PE_SET_VERSION), $(VBOX_PE_SET_VERSION) --vista,$(TEMPLATE_VBoxGuestR3Dll_POST_CMDS.win.x86))
8747	TEMPLATE_VBoxGuestR3DllMinVista_POST_CMDS.win.amd64 = $(subst $(VBOX_PE_SET_VERSION), $(VBOX_PE_SET_VERSION) --vista,$(TEMPLATE_VBoxGuestR3Dll_POST_CMDS.win.amd64))
8748	endif
8749
8750	#
8751	# Template for building normal R3 (dynamic) libraries for the guest additions with Visual C++ 2013 or later, strict.
8752	#
8753	TEMPLATE_NewerVccVBoxGuestR3Dll = VBoxGuestR3DllNonPedantic with the newer Visual C++ version (2013 or later).
8754	TEMPLATE_NewerVccVBoxGuestR3Dll_EXTENDS = VBoxGuestR3DllNonPedantic
8755	if "$(KBUILD_TARGET)" == "win" && "$(VBOX_NEWER_VCC_TOOL_STEM)" != "$(VBOX_VCC_TOOL_STEM)"
8756	TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86 = $(VBOX_NEWER_VCC_TOOL_STEM)X86
8757	TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64 = $(VBOX_NEWER_VCC_TOOL_STEM)AMD64
8758	TEMPLATE_NewerVccVBoxGuestR3Dll_CXXFLAGS = \
8759	$(filter-out $(VBOX_VCC_WARN_ALL) $(VBOX_VCC_WERR), $(TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS)) \
8760	$(VBOX_NEWER_VCC_WARN_ALL) $(VBOX_VCC_WERR)
8761	TEMPLATE_NewerVccVBoxGuestR3Dll_CFLAGS = $(TEMPLATE_NewerVccVBoxGuestR3DllNonPedantic_CXXFLAGS)
8762	ifndef VBOX_WITH_NOCRT_STATIC
8763	# Hack begin
8764	# Does not work when building x86 for amd64 build (No rule to make target /oldnames.lib).
8765	# TEMPLATE_NewerVccVBoxGuestR3Dll_LIBS.x86 = \
8766	# $(subst $(PATH_TOOL_$(TEMPLATE_VBoxGuestR3DllNonPedantic_TOOL.win.x86)_LIB),$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86)_LIB), $(TEMPLATE_VBoxGuestR3DllNonPedantic_LIBS.x86))
8767	# TEMPLATE_NewerVccVBoxGuestR3Dll_LIBS.amd64 = \
8768	# $(subst $(PATH_TOOL_$(TEMPLATE_VBoxGuestR3DllNonPedantic_TOOL.win.amd64)_LIB),$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64)_LIB), $(TEMPLATE_VBoxGuestR3DllNonPedantic_LIBS.amd64))
8769	# Directly assign TEMPLATE_NewerVccVBoxGuestR3Dll_LIBS.
8770	TEMPLATE_NewerVccVBoxGuestR3Dll_LIBS.x86 = \
8771	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86)_LIB)/oldnames.lib \
8772	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8773	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.x86)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
8774	TEMPLATE_NewerVccVBoxGuestR3Dll_LIBS.amd64 = \
8775	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64)_LIB)/oldnames.lib \
8776	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64)_LIB)/libcmt$(VBOX_VCC_CRT_TYPE).lib \
8777	$(PATH_TOOL_$(TEMPLATE_NewerVccVBoxGuestR3Dll_TOOL.win.amd64)_LIB)/libcpmt$(VBOX_VCC_CRT_TYPE).lib
8778	endif # !VBOX_WITH_NOCRT_STATIC
8779	# Hack end
8780	endif
8781	TEMPLATE_NewerVccVBoxGuestR3Dll_LIBS = \
8782	$(TEMPLATE_VBoxGuestR3ExeBase_LIBS)
8783
8784	#
8785	# Variant of NewerVccVBoxGuestR3Dll that requires Windows Vista or later.
8786	#
8787	TEMPLATE_NewerVccVBoxGuestR3DllMinVista = NewerVccVBoxGuestR3Dll with the newer Visual C++ version (2013 or later).
8788	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_EXTENDS := NewerVccVBoxGuestR3Dll
8789	ifeq ($(KBUILD_TARGET),win)
8790	ifdef VBOX_WITH_NOCRT_STATIC
8791	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_LDFLAGS.win.x86 = $(filter-out -NoOptIData,$(TEMPLATE_NewerVccVBoxGuestR3Dll_LDFLAGS.win.x86))
8792	else
8793	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_LDFLAGS.win.x86 = $(filter-out -NoOptIData -Section:.bss$(COMMA)RW!K,$(TEMPLATE_NewerVccVBoxGuestR3Dll_LDFLAGS.win.x86))
8794	endif
8795	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_POST_CMDS.win.x86 = $(subst $(VBOX_PE_SET_VERSION), $(VBOX_PE_SET_VERSION) --vista,$(TEMPLATE_NewerVccVBoxGuestR3Dll_POST_CMDS.win.x86))
8796	TEMPLATE_NewerVccVBoxGuestR3DllMinVista_POST_CMDS.win.amd64 = $(subst $(VBOX_PE_SET_VERSION), $(VBOX_PE_SET_VERSION) --vista,$(TEMPLATE_NewerVccVBoxGuestR3Dll_POST_CMDS.win.amd64))
8797	endif
8798
8799	#
8800	# Template for building R3 (static) libraries for the guest additions, strict.
8801	#
8802	TEMPLATE_VBoxGuestR3Lib := VBox Guest User Dynamic Libraries w/ IPRT and VBGL.
8803	TEMPLATE_VBoxGuestR3Lib_EXTENDS := VBoxGuestR3ExeBase
8804	TEMPLATE_VBoxGuestR3Lib_EXTENDS_BY := appending
8805	TEMPLATE_VBoxGuestR3Lib_INST = $(INST_ADDITIONS_LIB)
8806	ifeq ($(KBUILD_TARGET),win)
8807	TEMPLATE_VBoxGuestR3Lib_CFLAGS += $(VBOX_VCC_WERR)
8808	TEMPLATE_VBoxGuestR3Lib_CXXFLAGS += $(VBOX_VCC_WERR)
8809	TEMPLATE_VBoxGuestR3Lib_LDFLAGS += $(VBOX_VCC_LD_WERR)
8810	else
8811	TEMPLATE_VBoxGuestR3Lib_CFLAGS += $(VBOX_GCC_WERR)
8812	TEMPLATE_VBoxGuestR3Lib_CXXFLAGS += $(VBOX_GCC_WERR)
8813	endif
8814
8815
8816	#
8817	# Guest version of VBoxR3StaticNoCrtExe.
8818	#
8819	TEMPLATE_VBoxGuestR3NoCrtExe := ...
8820	TEMPLATE_VBoxGuestR3NoCrtExe_EXTENDS := VBoxGuestR3Exe
8821	TEMPLATE_VBoxGuestR3NoCrtExe_SDKS = $(subst WINSDK10-UCRT$(VBOX_VCC_CRT_TYPE_UPPER)-STATIC,WINSDK10-UCRT-INCS, $(TEMPLATE_VBoxGuestR3Exe_SDKS))
8822	TEMPLATE_VBoxGuestR3NoCrtExe_SDKS.$(KBUILD_TARGET_ARCH) = $(filter-out VBoxOpenSslStatic,$(TEMPLATE_VBoxGuestR3Exe_SDKS.$(KBUILD_TARGET_ARCH)))
8823	TEMPLATE_VBoxGuestR3NoCrtExe_DEFS = $(TEMPLATE_VBoxGuestR3Exe_DEFS) \
8824	RT_NO_CRT \
8825	IN_RT_STATIC
8826	ifndef VBOX_WITH_NOCRT_STATIC
8827	TEMPLATE_VBoxGuestR3NoCrtExe_DEFS.win = $(TEMPLATE_VBoxGuestR3Exe_DEFS.win) \
8828	RT_WITHOUT_NOCRT_WRAPPERS
8829	endif
8830	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS = \
8831	$(PATH_STAGE_LIB)/RuntimeR3NoCrt$(VBOX_SUFF_LIB)
8832	ifeq ($(KBUILD_TARGET),win)
8833	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS.x86 = $(NO_SUCH_VARIABLE)
8834	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS.amd64 = $(NO_SUCH_VARIABLE)
8835	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS.win = $(NO_SUCH_VARIABLE)
8836	TEMPLATE_VBoxGuestR3NoCrtExe_LIBS.win.x86 = \
8837	$(PATH_TOOL_$(TEMPLATE_VBoxGuestR3NoCrtExe_TOOL.win.x86)_LIB)/chkstk.obj
8838	TEMPLATE_VBoxGuestR3NoCrtExe_LDFLAGS = $(filter-out $(VBOX_VCC_LD_GUARD_CF) $(VBOX_VCC_SANITIZER_LDFLAGS), $(TEMPLATE_VBoxGuestR3Exe_LDFLAGS))
8839	TEMPLATE_VBoxGuestR3NoCrtExe_LDFLAGS.win.x86 = $(filter-out -Include%, $(TEMPLATE_VBoxGuestR3Exe_LDFLAGS.win.x86))
8840	TEMPLATE_VBoxGuestR3NoCrtExe_LDFLAGS.win = $(TEMPLATE_VBoxGuestR3Exe_LDFLAGS.win) /entry:CustomMainEntrypoint /subsystem:console
8841	TEMPLATE_VBoxGuestR3NoCrtExe_CFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3Exe_CFLAGS)) /GS- -EHs-
8842	TEMPLATE_VBoxGuestR3NoCrtExe_CXXFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3Exe_CXXFLAGS)) /GS- -EHs-
8843	TEMPLATE_VBoxGuestR3NoCrtExe_PCHFLAGS = $(filter-out -EH% -GS $(VBOX_VCC_CC_GUARD_CF) $(VBOX_VCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3Exe_PCHFLAGS)) /GS- -EHs-
8844	TEMPLATE_VBoxGuestR3NoCrtExe_CXXFLAGS.debug = $(filter-out /RTC% -RTC%, $(TEMPLATE_VBoxGuestR3Exe_CXXFLAGS.debug))
8845	else
8846	TEMPLATE_VBoxGuestR3NoCrtExe_CXXFLAGS = $(TEMPLATE_VBoxGuestR3Exe_CXXFLAGS) -fno-exceptions
8847	TEMPLATE_VBoxGuestR3NoCrtExe_PCHFLAGS = $(TEMPLATE_VBoxGuestR3Exe_PCHFLAGS) -fno-exceptions
8848	endif
8849
8850
8851	#
8852	# Template for XFree86 guest modules (relocatable module, i.e. sysmod).
8853	# This mostly about zapping the VBoxR3Exe linker flags and libraries.
8854	#
8855	TEMPLATE_VBoxGuestR3XFree86Mod := VBox XFree86 Guest Module
8856	TEMPLATE_VBoxGuestR3XFree86Mod_EXTENDS := VBoxGuestR3ExeBase
8857	TEMPLATE_VBoxGuestR3XFree86Mod_SYSSUFF := .o
8858	TEMPLATE_VBoxGuestR3XFree86Mod_DEFS = $(TEMPLATE_VBoxGuestR3ExeBase_DEFS) VBOX_GUESTR3XF86MOD RTMEM_NO_WRAP_TO_EF_APIS
8859	TEMPLATE_VBoxGuestR3XFree86Mod_CFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3ExeBase_CFLAGS)) \
8860	-fno-pie -fno-merge-constants -std=c99 -ffreestanding
8861	TEMPLATE_VBoxGuestR3XFree86Mod_CXXFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3ExeBase_CXXFLAGS)) \
8862	-fno-pie -fno-merge-constants -ffreestanding
8863	TEMPLATE_VBoxGuestR3XFree86Mod_CFLAGS.linux = $(VBOX_GCC_fno-stack-protector) # Remove symvers.h
8864	TEMPLATE_VBoxGuestR3XFree86Mod_CXXFLAGS.linux = $(VBOX_GCC_fno-stack-protector) # Remove symvers.h
8865	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.$(KBUILD_TARGET) = $(NO_SUCH_VARIABLE)
8866	# The GNU_HASH ELF tag is not supported by older glibc dynamic linkers.
8867	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.linux = $(subst -Wl$(COMMA),,$(VBOX_LD_hash_style_sysv))
8868	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.$(KBUILD_TYPE) = $(NO_SUCH_VARIABLE)
8869	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS := -r
8870	if1of ($(KBUILD_TARGET), dragonfly freebsd linux netbsd openbsd) # the gnu ld guys.
8871	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.release := -S
8872	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.x86 := -m elf_i386
8873	TEMPLATE_VBoxGuestR3XFree86Mod_LDFLAGS.amd64 := -m elf_x86_64
8874	endif
8875	TEMPLATE_VBoxGuestR3XFree86Mod_LIBS = $(VBOX_LIB_VBGL_R3_XFREE86)
8876	TEMPLATE_VBoxGuestR3XFree86Mod_LIBS.$(KBUILD_TYPE) = $(NO_SUCH_VARIABLE)
8877	TEMPLATE_VBoxGuestR3XFree86Mod_LIBS.$(KBUILD_TARGET) = $(NO_SUCH_VARIABLE)
8878
8879
8880	#
8881	# Template for XFree86 guest libraries.
8882	#
8883	TEMPLATE_VBoxGuestR3XFree86Lib := VBox XFree86 Guest Library
8884	TEMPLATE_VBoxGuestR3XFree86Lib_EXTENDS := VBoxGuestR3XFree86Mod
8885	TEMPLATE_VBoxGuestR3XFree86Lib_INST = $(INST_ADDITIONS_LIB)
8886	TEMPLATE_VBoxGuestR3XFree86Lib_LIBS = $(INST_ADDITIONS_LIB)
8887
8888
8889	#
8890	# Template for X.Org guest modules (shared libs).
8891	# This mostly about zapping unnecessary LIBS from VBoxGuestR3DllNonPedantic and adding some flags.
8892	#
8893	TEMPLATE_VBoxGuestR3XOrgMod := VBox X.Org Guest Module
8894	TEMPLATE_VBoxGuestR3XOrgMod_EXTENDS := VBoxGuestR3DllNonPedantic
8895	TEMPLATE_VBoxGuestR3XOrgMod_DEFS = $(TEMPLATE_VBoxGuestR3DllNonPedantic_DEFS) VBOX_GUESTR3XORGMOD RTMEM_NO_WRAP_TO_EF_APIS
8896	ifeq ($(KBUILD_TARGET_ARCH),amd64)
8897	TEMPLATE_VBoxGuestR3XOrgMod_DEFS += _XSERVER64
8898	endif
8899	TEMPLATE_VBoxGuestR3XOrgMod_CFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3DllNonPedantic_CFLAGS)) -std=c99
8900	TEMPLATE_VBoxGuestR3XOrgMod_CXXFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS),$(TEMPLATE_VBoxGuestR3DllNonPedantic_CXXFLAGS))
8901	if1of ($(KBUILD_TARGET), linux)
8902	TEMPLATE_VBoxGuestR3XOrgMod_CFLAGS += -Wno-conversion -Wno-unused-parameter
8903	endif
8904	TEMPLATE_VBoxGuestR3XOrgMod_LDFLAGS = $(filter-out $(VBOX_GCC_SANITIZER_FLAGS) $(VBOX_GCC_SANITIZER_LDFLAGS),$(TEMPLATE_VBoxGuestR3DllNonPedantic_LDFLAGS))
8905	TEMPLATE_VBoxGuestR3XOrgMod_LIBS = $(VBOX_LIB_VBGL_R3_XORG)
8906	TEMPLATE_VBoxGuestR3XOrgMod_LIBS.$(KBUILD_TYPE) = $(NO_SUCH_VARIABLE)
8907	TEMPLATE_VBoxGuestR3XOrgMod_LIBS.$(KBUILD_TARGET) = $(NO_SUCH_VARIABLE)
8908	TEMPLATE_VBoxGuestR3XOrgMod_LIBS.freebsd += iconv
8909
8910
8911	#
8912	# Template for X.Org guest libraries.
8913	#
8914	TEMPLATE_VBoxGuestR3XOrgLib := VBox X.Org Guest Library
8915	TEMPLATE_VBoxGuestR3XOrgLib_EXTENDS := VBoxGuestR3XOrgMod
8916	TEMPLATE_VBoxGuestR3XOrgLib_INST = $(INST_ADDITIONS_LIB)
8917
8918
8919	#
8920	# Template for building R0 drivers for the guest additions.
8921	#
8922	TEMPLATE_VBoxGuestR0Drv = VBox Guest Driver
8923	TEMPLATE_VBoxGuestR0Drv_EXTENDS = VBoxR0Drv
8924	TEMPLATE_VBoxGuestR0Drv_INST = $(INST_ADDITIONS)
8925	TEMPLATE_VBoxGuestR0Drv_SDKS.win.x86 = ReorderCompilerIncs $(VBOX_WINDDK_GST) $(VBOX_WINPSDK_GST_INCS)
8926	TEMPLATE_VBoxGuestR0Drv_SDKS.win.amd64 = ReorderCompilerIncs $(VBOX_WINDDK_GST) $(VBOX_WINPSDK_GST_INCS)
8927	TEMPLATE_VBoxGuestR0Drv_DEFS = $(TEMPLATE_VBoxR0Drv_DEFS) IN_GUEST IN_GUEST_R0
8928	TEMPLATE_VBoxGuestR0Drv_DEFS.linux = RT_NO_EXPORT_SYMBOL
8929	ifeq ($(KBUILD_TARGET),solaris)
8930	TEMPLATE_VBoxGuestR0Drv_LDFLAGS = -r -dy
8931	endif
8932	ifn1of ($(KBUILD_TARGET), darwin os2 win)
8933	TEMPLATE_VBoxGuestR0Drv_CFLAGS = $(patsubst %/VBox/SUPDrvMangling.h,%/VBox/VBoxGuestMangling.h,$(TEMPLATE_VBoxR0Drv_CFLAGS))
8934	TEMPLATE_VBoxGuestR0Drv_CXXFLAGS = $(patsubst %/VBox/SUPDrvMangling.h,%/VBox/VBoxGuestMangling.h,$(TEMPLATE_VBoxR0Drv_CXXFLAGS))
8935	TEMPLATE_VBoxGuestR0Drv_ASDEFS = $(patsubst RT_MANGLER_PREFIX=%,RT_MANGLER_PREFIX=VBoxGuest_,$(TEMPLATE_VBoxR0Drv_ASDEFS))
8936	endif
8937	if "$(VBOX_VCC_TOOL_STEM)" >= "VCC120" # Do not use SSE so the binaries might works on NT4 and earlier.
8938	TEMPLATE_VBoxGuestR0Drv_CFLAGS.win.x86 = $(TEMPLATE_VBoxR0Drv_CFLAGS.win.x86) /arch:IA32
8939	TEMPLATE_VBoxGuestR0Drv_CXXFLAGS.win.x86 = $(TEMPLATE_VBoxR0Drv_CXXFLAGS.win.x86) /arch:IA32
8940	endif
8941
8942
8943	#
8944	# Template for building R0 libraries for the guest additions.
8945	#
8946	TEMPLATE_VBoxGuestR0DrvLib = VBox Guest Driver Libraries
8947	TEMPLATE_VBoxGuestR0DrvLib_EXTENDS = VBoxGuestR0Drv
8948	TEMPLATE_VBoxGuestR0DrvLib_INSTTYPE = stage
8949	TEMPLATE_VBoxGuestR0DrvLib_INSTTYPE.linux = stage
8950	TEMPLATE_VBoxGuestR0DrvLib_INST = $(INST_ADDITIONS_LIB)
8951	ifeq ($(KBUILD_TARGET),haiku)
8952	TEMPLATE_VBoxGuestR0DrvLib_LDFLAGS = -r -dy
8953	endif
8954
8955
8956	#
8957	# Guest additions libraries (all static).
8958	# The _SHARED variants are compiled as PIC and intended for linking into a .so/.dll/.dylib.
8959	#
8960	VBOX_LIB_IPRT_GUEST_R3 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR3$(VBOX_SUFF_LIB)
8961	VBOX_LIB_IPRT_GUEST_R3_SHARED = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR3Shared$(VBOX_SUFF_LIB)
8962	VBOX_LIB_IPRT_GUEST_R0 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR0$(VBOX_SUFF_LIB)
8963	#ifeq ($(KBUILD_TARGET_ARCH),x86)
8964	# VBOX_LIB_IPRT_GUEST_R0_NT4 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR0NT4$(VBOX_SUFF_LIB)
8965	#else
8966	VBOX_LIB_IPRT_GUEST_R0_NT4 = $(VBOX_LIB_IPRT_GUEST_R0)
8967	#endif
8968	VBOX_LIB_VBGL_R3 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3Lib$(VBOX_SUFF_LIB)
8969	VBOX_LIB_VBGL_R3_XFREE86 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3LibXFree86$(VBOX_SUFF_LIB)
8970	VBOX_LIB_VBGL_R3_XORG = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3LibXOrg$(VBOX_SUFF_LIB)
8971	VBOX_LIB_VBGL_R3_SHARED = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3LibShared$(VBOX_SUFF_LIB)
8972	VBOX_LIB_VBGL_R0BASE = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR0LibBase$(VBOX_SUFF_LIB)
8973	VBOX_LIB_VBGL_R0 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR0Lib$(VBOX_SUFF_LIB)
8974	ifeq ($(KBUILD_TARGET_ARCH),x86)
8975	VBOX_LIB_IPRT_GUEST_R3_X86 = $(VBOX_LIB_IPRT_GUEST_R3)
8976	VBOX_LIB_IPRT_GUEST_R3_SHARED_X86 = $(VBOX_LIB_IPRT_GUEST_R3_SHARED)
8977	VBOX_LIB_VBGL_R3_X86 = $(VBOX_LIB_VBGL_R3)
8978	VBOX_LIB_VBGL_R3_SHARED_X86 = $(VBOX_LIB_VBGL_R3_SHARED)
8979	else
8980	VBOX_LIB_IPRT_GUEST_R3_X86 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR3-x86$(VBOX_SUFF_LIB)
8981	VBOX_LIB_IPRT_GUEST_R3_SHARED_X86 = $(VBOX_PATH_ADDITIONS_LIB)/RuntimeGuestR3Shared-x86$(VBOX_SUFF_LIB)
8982	VBOX_LIB_VBGL_R3_X86 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3Lib-x86$(VBOX_SUFF_LIB)
8983	VBOX_LIB_VBGL_R3_SHARED_X86 = $(VBOX_PATH_ADDITIONS_LIB)/VBoxGuestR3LibShared-x86$(VBOX_SUFF_LIB)
8984	endif
8985
8986
8987	#
8988	# Check the publisher and version string.
8989	#
8990	# We are being very strict because the version string is visible in various
8991	# APIs and logs and must be machine readable.
8992	#
8993	VBOX_VERSION_COMP_VALID_CHAR_SET = ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyz()[]{}+-.,
8994	ifneq ($(VBOX_BUILD_PUBLISHER),)
8995	if !defined(VBOX_BUILD_TAG) && $(length $(VBOX_BUILD_PUBLISHER)) > 10
8996	$(error VBox: VBOX_BUILD_PUBLISHER must not be longer than 10 characters!)
8997	else if defined(VBOX_BUILD_TAG) && $(length $(VBOX_BUILD_PUBLISHER)) > 48
8998	$(error VBox: VBOX_BUILD_PUBLISHER must not be longer than 48 characters!)
8999	endif
9000	if "$(substr $(VBOX_BUILD_PUBLISHER), 1, 1)" != "_"
9001	$(error VBox: VBOX_BUILD_PUBLISHER must start with an underscore!)
9002	endif
9003	if "$(translate $(substr $(VBOX_BUILD_PUBLISHER),2),$(VBOX_VERSION_COMP_VALID_CHAR_SET),)" != ""
9004	$(error VBox: VBOX_BUILD_PUBLISHER='$(VBOX_BUILD_PUBLISHER)' contains bad characters! Valid set is:$(NLTAB)$(VBOX_VERSION_COMP_VALID_CHAR_SET))
9005	endif
9006	endif
9007
9008	if $(words $(VBOX_VERSION_STRING)) != 1
9009	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' contains spaces or is empty.)
9010	endif
9011	if "$(subst __,-,$(VBOX_VERSION_STRING))" != "$(VBOX_VERSION_STRING)"
9012	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' contains double underscores.)
9013	endif
9014
9015	VBOX_VER_TMP1 := $(subst _,$(SP),$(VBOX_VERSION_STRING))
9016
9017	if $(words $(VBOX_VER_TMP1)) > 3
9018	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' contains too many parts (underscores), max 3!)
9019	endif
9020	if "$(translate $(word 1,$(VBOX_VER_TMP1)),0123456789,)" != ".."
9021	$(error VBox: The x.y.z part of VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' is malformed: '$(word 1,$(VBOX_VER_TMP1))')
9022	endif
9023	if "$(word 1,$(VBOX_VER_TMP1))" != "$(VBOX_VERSION_STRING_RAW)"
9024	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' does not start with VBOX_VERSION_STRING_RAW='$(VBOX_VERSION_STRING_RAW)')
9025	endif
9026
9027	if $(words $(VBOX_VER_TMP1)) == 3 \|\| ($(words $(VBOX_VER_TMP1)) == 2 && "$(VBOX_BUILD_PUBLISHER)" == "")
9028	if "$(substr $(word 2,$(VBOX_VER_TMP1)),1,4)" == "BETA"
9029	VBOX_VER_TMP2 = 5
9030	else if "$(substr $(word 2,$(VBOX_VER_TMP1)),1,5)" == "ALPHA"
9031	VBOX_VER_TMP2 = 6
9032	else if "$(substr $(word 2,$(VBOX_VER_TMP1)),1,2)" == "RC"
9033	VBOX_VER_TMP2 = 3
9034	else
9035	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' uses an unknown build type: '$(word 2,$(VBOX_VER_TMP1))')
9036	endif
9037	if "$(translate $(substr $(word 2,$(VBOX_VER_TMP1)),$(VBOX_VER_TMP2)),0123456789)" != ""
9038	$(error VBox: VBOX_VERSION_STRING='$(VBOX_VERSION_STRING)' uses an unknown build type: '$(word 2,$(VBOX_VER_TMP1))')
9039	endif
9040	endif
9041
9042	VBOX_VER_TMP1 :=
9043	VBOX_VER_TMP2 :=
9044
9045
9046	#
9047	# Two targets to coordinate version number changes properly. Note that the
9048	# only way to get a really consistent build is to run 'kmk' in the top-level
9049	# directory. If you don't run it there, you get a consistent sub-tree only.
9050	#
9051	VBOX_BAD_CHAR_SET = ,;:/\$(SP)$(TAB)$(HASH)=![]@%&''()*""<>?^{}\|~
9052	VBOX_VERSION_STAMP = $(PATH_OUT)/version-stamp-raw-api-$(translate $(VBOX_VERSION_STRING)-$(VBOX_C_YEAR)-$(VBOX_VENDOR)-$(VBOX_PRODUCT)-$(VBOX_API_VERSION)-$(VBOX_BUILD_PUBLISHER)-$(USERNAME),$(VBOX_BAD_CHAR_SET),,_)
9053	VBOX_VERSION_HEADER = $(PATH_OUT)/version-generated.h
9054	VBOX_VERSION_MK = $(PATH_OUT)/version-generated.mk
9055
9056	$(VBOX_VERSION_STAMP): \| $(PATH_ROOT)/Config.kmk
9057	$(call MSG_GENERATE,,$@)
9058	$(QUIET)$(MKDIR) -p $(@D)
9059	$(QUIET)$(RM) -f $(wildcard $(PATH_OUT)/version-stamp-*)
9060	$(QUIET)$(APPEND) $@ $(VBOX_VERSION_STRING)
9061
9062	$(VBOX_VERSION_HEADER): $(VBOX_VERSION_STAMP)
9063	$(call MSG_GENERATE,,$@)
9064	$(QUIET)$(MKDIR) -p $(@D)
9065	$(QUIET)$(RM) -f $@ [email protected]
9066	$(QUIET)$(APPEND) [email protected] '#ifndef ___version_generated_h___'
9067	$(QUIET)$(APPEND) [email protected] '#define ___version_generated_h___'
9068	$(QUIET)$(APPEND) [email protected] ''
9069	$(QUIET)$(APPEND) [email protected] '#define VBOX_VERSION_MAJOR $(VBOX_VERSION_MAJOR)'
9070	$(QUIET)$(APPEND) [email protected] '#define VBOX_VERSION_MINOR $(VBOX_VERSION_MINOR)'
9071	$(QUIET)$(APPEND) [email protected] '#define VBOX_VERSION_BUILD $(VBOX_VERSION_BUILD)'
9072	ifneq ($(VBOX_VERSION_PRERELEASE),)
9073	$(QUIET)$(APPEND) [email protected] '#define VBOX_VERSION_PRERELEASE "$(strip $(VBOX_VERSION_PRERELEASE))"'
9074	endif
9075	$(QUIET)$(APPEND) [email protected] '#define VBOX_VERSION_STRING_RAW "$(VBOX_VERSION_STRING_RAW)"'
9076	$(QUIET)$(APPEND) [email protected] '#define VBOX_VERSION_STRING "$(VBOX_VERSION_STRING)"'
9077	$(QUIET)$(APPEND) [email protected] '#define VBOX_API_VERSION_STRING "$(VBOX_API_VERSION)"'
9078	$(QUIET)$(APPEND) [email protected] ''
9079	ifdef VBOX_BUILD_SERVER_BUILD
9080	$(QUIET)$(APPEND) [email protected] '#define VBOX_BUILD_SERVER_BUILD 1'
9081	else
9082	$(QUIET)$(APPEND) [email protected] '#define VBOX_PRIVATE_BUILD_DESC "Private build by $(USERNAME)"'
9083	endif
9084	$(QUIET)$(APPEND) [email protected] ''
9085	$(QUIET)$(APPEND) [email protected] '#endif'
9086	$(QUIET)$(MV) -f [email protected] $@
9087
9088
9089	VBOX_PACKAGE_HEADER = $(PATH_OUT)/package-generated.h
9090
9091	$(VBOX_PACKAGE_HEADER):
9092	$(call MSG_GENERATE,,$@)
9093	$(QUIET)$(MKDIR) -p $(@D)
9094	$(QUIET)$(RM) -f $@ [email protected]
9095	$(QUIET)$(APPEND) [email protected] '#ifndef ___package_generated_h___'
9096	$(QUIET)$(APPEND) [email protected] '#define ___package_generated_h___'
9097	$(QUIET)$(APPEND) [email protected] ''
9098	$(QUIET)$(APPEND) [email protected] '#define VBOX_PACKAGE_STRING "$(VBOX_PACKAGE_STRING)"'
9099	$(QUIET)$(APPEND) [email protected] ''
9100	$(QUIET)$(APPEND) [email protected] '#endif'
9101	$(QUIET)$(MV) -f [email protected] $@
9102
9103	VBOX_PRODUCT_HEADER = $(PATH_OUT)/product-generated.h
9104
9105	$(VBOX_PRODUCT_HEADER): $(VBOX_VERSION_STAMP)
9106	$(call MSG_GENERATE,,$@)
9107	$(QUIET)$(MKDIR) -p $(@D)
9108	$(QUIET)$(RM) -f $@ [email protected]
9109	$(QUIET)$(APPEND) [email protected] '#ifndef ___product_generated_h___'
9110	$(QUIET)$(APPEND) [email protected] '#define ___product_generated_h___'
9111	$(QUIET)$(APPEND) [email protected] ''
9112	$(QUIET)$(APPEND) [email protected] '#define VBOX_VENDOR "$(VBOX_VENDOR)"'
9113	$(QUIET)$(APPEND) [email protected] '#define VBOX_VENDOR_SHORT "$(VBOX_VENDOR_SHORT)"'
9114	$(QUIET)$(APPEND) [email protected] '#define VBOX_PRODUCT "$(VBOX_PRODUCT)"'
9115	$(QUIET)$(APPEND) [email protected] '#define VBOX_BUILD_PUBLISHER "$(VBOX_BUILD_PUBLISHER)"'
9116	$(QUIET)$(APPEND) [email protected] '#define VBOX_C_YEAR "$(VBOX_C_YEAR)"'
9117	$(QUIET)$(APPEND) [email protected] ''
9118	$(QUIET)$(APPEND) [email protected] '#endif'
9119	$(QUIET)$(MV) -f [email protected] $@
9120
9121	#
9122	# Used for external makefiles which cannot include Config.kmk
9123	#
9124	$(VBOX_VERSION_MK): $(VBOX_VERSION_STAMP)
9125	$(call MSG_GENERATE,,$@)
9126	$(QUIET)$(RM) -f $@ [email protected]
9127	$(QUIET)$(MKDIR) -p $(@D)
9128	$(QUIET)$(APPEND) [email protected] 'VBOX_VERSION_MAJOR = $(VBOX_VERSION_MAJOR)'
9129	$(QUIET)$(APPEND) [email protected] 'VBOX_VERSION_MINOR = $(VBOX_VERSION_MINOR)'
9130	$(QUIET)$(APPEND) [email protected] 'VBOX_VERSION_BUILD = $(VBOX_VERSION_BUILD)'
9131	$(QUIET)$(APPEND) [email protected] 'VBOX_VERSION_STRING = $(VBOX_VERSION_STRING)'
9132	ifneq ($(VBOX_VERSION_PRERELEASE),)
9133	$(QUIET)$(APPEND) [email protected] 'VBOX_VERSION_PRERELEASE = $(strip $(VBOX_VERSION_PRERELEASE))'
9134	endif
9135	$(QUIET)$(APPEND) [email protected] 'VBOX_VENDOR = $(VBOX_VENDOR)'
9136	$(QUIET)$(APPEND) [email protected] 'VBOX_VENDOR_SHORT = $(VBOX_VENDOR_SHORT)'
9137	$(QUIET)$(APPEND) [email protected] 'VBOX_PRODUCT = $(VBOX_PRODUCT)'
9138	$(QUIET)$(APPEND) [email protected] 'VBOX_C_YEAR = $(VBOX_C_YEAR)'
9139	ifdef VBOX_BUILD_SERVER_BUILD
9140	$(QUIET)$(APPEND) [email protected] 'VBOX_BUILD_SERVER_BUILD = 1'
9141	else
9142	$(QUIET)$(APPEND) [email protected] 'VBOX_PRIVATE_BUILD_DESC = Private build by $(USERNAME)'
9143	endif
9144	$(QUIET)$(MV) -f [email protected] $@
9145
9146	if !defined(VBOX_OSE) && !defined(VBOX_NOINC_LICENSE_VER_KMK)
9147	if1of ($(KBUILD_TARGET), freebsd linux netbsd openbsd solaris)
9148	# VBOX_LICENSE_VER is used in several Makefiles
9149	VBOX_LICENSE_VER_KMK = $(PATH_OUT)/license-version.kmk
9150	$(VBOX_LICENSE_VER_KMK): $(VBOX_BRAND_LICENSE_HTML)
9151	$(call MSG_GENERATE,,$(VBOX_LICENSE_VER_KMK))
9152	$(QUIET)$(MKDIR) -p $(@D)
9153	ifdef VBOX_BRAND_LICENSE_VER
9154	$(QUIET)$(RM) -f '$@'
9155	$(APPEND) '$@' 'VBOX_LICENSE_VER=$(VBOX_BRAND_LICENSE_VER)'
9156	else
9157	$(QUIET)$(SED) -e "s/.License version $[0-9.]$ [,&]./VBOX_LICENSE_VER=\1/;t;d" --output $@ $(VBOX_BRAND_LICENSE_HTML)
9158	endif
9159	-include $(VBOX_LICENSE_VER_KMK)
9160	ifdef VBOX_LICENSE_VER
9161	VBOX_LICENSE_FILES = \
9162	License-$(VBOX_LICENSE_VER).html \
9163	$(foreach f,$(VBOX_INSTALLER_ADD_LANGUAGES),License-$(VBOX_LICENSE_VER)-$(f).html)
9164	VBOX_LICENSE_BINS = $(addprefix $(PATH_STAGE_BIN)/,$(VBOX_LICENSE_FILES))
9165	endif
9166	endif
9167	endif
9168
9169
9170	ifeq ($(KBUILD_TARGET),darwin)
9171	$(VBOX_DARWIN_ENTITLEMENTS_FILE):
9172	$(call MSG_GENERATE,,$@)
9173	$(QUIET)$(MKDIR) -p $(@D)
9174	$(QUIET)$(RM) -f $@ [email protected]
9175	$(QUIET)$(APPEND) [email protected] '<?xml version="1.0" encoding="UTF-8"?>'
9176	$(QUIET)$(APPEND) [email protected] '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">'
9177	$(QUIET)$(APPEND) [email protected] '<plist version="1.0">'
9178	$(QUIET)$(APPEND) [email protected] '<dict>'
9179	$(QUIET)$(APPEND) -n [email protected] $(foreach entitlement,$(VBOX_DARWIN_ENTITLEMENTS_LIST_COMMON), ' <key>$(entitlement)</key><true/>')
9180	$(QUIET)$(APPEND) [email protected] '</dict>'
9181	$(QUIET)$(APPEND) [email protected] '</plist>'
9182	$(QUIET)$(MV) -f [email protected] $@
9183
9184	$(VBOX_DARWIN_ENTITLEMENTS_FILE_VM):
9185	$(call MSG_GENERATE,,$@)
9186	$(QUIET)$(MKDIR) -p $(@D)
9187	$(QUIET)$(RM) -f $@ [email protected]
9188	$(QUIET)$(APPEND) [email protected] '<?xml version="1.0" encoding="UTF-8"?>'
9189	$(QUIET)$(APPEND) [email protected] '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">'
9190	$(QUIET)$(APPEND) [email protected] '<plist version="1.0">'
9191	$(QUIET)$(APPEND) [email protected] '<dict>'
9192	$(QUIET)$(APPEND) -n [email protected] $(foreach entitlement,$(VBOX_DARWIN_ENTITLEMENTS_LIST_VM), ' <key>$(entitlement)</key><true/>')
9193	$(QUIET)$(APPEND) [email protected] '</dict>'
9194	$(QUIET)$(APPEND) [email protected] '</plist>'
9195	$(QUIET)$(MV) -f [email protected] $@
9196	endif
9197
9198	ifndef VBOX_NOINC_MISC
9199	# Force building of the version header file as the first thing anywhere in
9200	# the tree. This eliminates the need for manual dependencies on it.
9201	## @todo there gotta be a better way of doing this.
9202	Makefile.kmk: \| $(VBOX_VERSION_HEADER) $(VBOX_VERSION_MK) $(VBOX_PRODUCT_HEADER) $(VBOX_PACKAGE_HEADER)
9203	ifeq ($(KBUILD_TARGET),darwin)
9204	Makefile.kmk: \| $(VBOX_DARWIN_ENTITLEMENTS_FILE) $(VBOX_DARWIN_ENTITLEMENTS_FILE_VM)
9205	endif
9206	endif
9207
9208
9209	#
9210	# Subversion tree revision.
9211	#
9212	# The VBOX_SVN_REV contains our best guess. Use svn info on the root of the
9213	# tree to determine this it if .svn/wc.db or .svn/entries is found (the former
9214	# also up to two directory levels higher to allow for checkouts of the entire
9215	# repository), otherwise fall back on maximum value of Config.kmk and
9216	# Version.kmk revision.
9217	#
9218	# Makefile rules using this information shall list $(VBOX_SVN_REV_KMK) as a
9219	# prerequisite.
9220	#
9221	SVN ?= svn$(HOSTSUFF_EXE)
9222	VBOX_SVN_REV_KMK = $(PATH_OUT)/revision.kmk
9223	ifndef VBOX_SVN_REV
9224	VBOX_SVN_REV_CONFIG_FALLBACK := $(patsubst %:,, $Rev: 103497 $ )
9225	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))
9226	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))
9227	ifeq ($(which $(SVN)),)
9228	VBOX_SVN_DEP :=
9229	endif
9230
9231	# Rule for generating a timestamp and updating the real thing on change.
9232	$(VBOX_SVN_REV_KMK).ts +\| $(VBOX_SVN_REV_KMK): $(if $(VBOX_SVN_DEP), $(VBOX_SVN_DEP), $(PATH_ROOT)/Config.kmk)
9233	$(call MSG_GENERATE,,$(VBOX_SVN_REV_KMK))
9234	$(QUIET)$(RM) -f $@ [email protected]
9235	$(QUIET)$(MKDIR) -p $(@D)
9236	ifneq ($(VBOX_SVN_DEP),)
9237	-$(REDIRECT) -E 'LC_ALL=C' -wo [email protected] -- $(SVN) info $(PATH_ROOT)
9238	# Append fallback. Will be ignored if "svn info" provides meaningful data.
9239	$(QUIET)$(APPEND) [email protected] 'Last Changed Rev: $(VBOX_SVN_REV_FALLBACK)'
9240	$(SED) -e '/^Last Changed Rev/!d' -e 's/Last Changed Rev\: */export VBOX_SVN_REV=/; t a; :a q' --output $@ [email protected]
9241	$(QUIET)$(RM) -f [email protected]
9242	else
9243	$(QUIET)$(APPEND) $@ 'export VBOX_SVN_REV=$(VBOX_SVN_REV_FALLBACK)'
9244	endif
9245	$(QUIET)$(CP) --changed -fv $@ $(VBOX_SVN_REV_KMK)
9246
9247	ifndef VBOX_NOINC_SVN_REV_KMK
9248	include $(VBOX_SVN_REV_KMK)
9249	endif
9250	else
9251	# allow to overwrite VBOX_SVN_REV externally (mainly for building .debs/.rpms)
9252	$(VBOX_SVN_REV_KMK):
9253	$(call MSG_GENERATE,,$(VBOX_SVN_REV_KMK))
9254	$(QUIET)$(RM) -f $@
9255	$(QUIET)$(MKDIR) -p $(@D)
9256	$(QUIET)$(APPEND) $@ 'export VBOX_SVN_REV=$(VBOX_SVN_REV)'
9257	$(QUIET)echo '* $(VBOX_SVN_REV_KMK) was externally overwritten:'
9258	$(QUIET)$(CAT) $(VBOX_SVN_REV_KMK)
9259	endif
9260
9261	# only needed for VBoxGuest for Linux/FreeBSD guests
9262	VBOX_SVN_REV_HEADER = $(PATH_OUT)/revision-generated.h
9263	$(VBOX_SVN_REV_HEADER): $(VBOX_SVN_REV_KMK)
9264	$(call MSG_GENERATE,,$@)
9265	$(QUIET)$(RM) -f $@ [email protected]
9266	$(QUIET)$(MKDIR) -p $(@D)
9267	$(QUIET)$(APPEND) [email protected] '#define VBOX_SVN_REV $(VBOX_SVN_REV)'
9268	$(QUIET)$(MV) -f [email protected] $@
9269
9270	#
9271	# Shared definitions of the XIDL file to use as a source for
9272	# generating various other files (VBoxSVC, webservice, docs, front-ends, ...)
9273	#
9274
9275	# Real XIDL source file; from this we strip the <desc> elements to generate
9276	# a second XIDL file, from which the COM/XPCOM IDL files are then generated:
9277	VBOX_XIDL_FILE_SRC = $(PATH_ROOT)/src/VBox/Main/idl/VirtualBox.xidl
9278	# second XIDL file to use as source for COM/XPCOM IDL (with stripped docs):
9279	VBOX_XIDL_FILE = $(PATH_OUT)/obj/VirtualBox_stripped.xidl
9280
9281
9282	#
9283	# VBOX_SEP needs to be quoted when used on the shell command line.
9284	#
9285	if1of ($(KBUILD_TARGET), os2 win)
9286	VBOX_SEP = $(SEMICOLON)
9287	else
9288	VBOX_SEP = $(COLON)
9289	endif
9290
9291	# Java compiler options, needs some version checking.
9292	if defined(VBOX_JAVA_VERSION) && $(VBOX_JAVA_VERSION) >= 110000
9293	VBOX_JAVA_WS_PATH ?= /usr/share/java
9294	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
9295	else if defined(VBOX_JAVA_VERSION) && $(VBOX_JAVA_VERSION) >= 10900
9296	VBOX_JAVA_WS_OPTS ?= --add-modules java.xml.ws
9297	endif
9298	if defined(VBOX_JAVA_VERSION) && $(VBOX_JAVA_VERSION) >= 110000
9299	VBOX_JAVAC_OPTS = -encoding UTF-8 -source 9 -target 9 -Xlint:unchecked
9300	else if defined(VBOX_JAVA_VERSION) && $(VBOX_JAVA_VERSION) >= 90000
9301	VBOX_JAVAC_OPTS = -encoding UTF-8 -source 6 -target 6 -Xlint:unchecked
9302	else
9303	VBOX_JAVAC_OPTS = -encoding UTF-8 -source 1.5 -target 1.5 -Xlint:unchecked
9304	endif
9305	VBOX_JAVADOC_OPTS = -encoding UTF-8
9306
9307
9308	#
9309	# Legacy.
9310	#
9311	## @todo try remove this.
9312	ifneq ($(LOCALCFG),)
9313	include $(LOCALCFG)
9314	endif
9315
9316
9317	#
9318	# For efficiently build serveral build types / archs.
9319	#
9320	both-debug-release both-release-debug: \
9321	build-release-$(KBUILD_TARGET_ARCH) \
9322	build-debug-$(KBUILD_TARGET_ARCH)
9323	both-x86-amd64 both-amd64-x86: \
9324	build-$(KBUILD_TYPE)-x86 \
9325	build-$(KBUILD_TYPE)-x86
9326	both-types-archs both-archs-types: \
9327	build-debug-x86 \
9328	build-release-x86 \
9329	build-debug-amd64 \
9330	build-release-amd64
9331
9332	build-release-x86:
9333	+$(MAKE) KBUILD_TYPE=release KBUILD_TARGET_ARCH=x86
9334
9335	build-debug-x86:
9336	+$(MAKE) KBUILD_TYPE=debug KBUILD_TARGET_ARCH=x86
9337
9338	build-release-amd64:
9339	+$(MAKE) KBUILD_TYPE=release KBUILD_TARGET_ARCH=amd64
9340
9341	build-debug-amd64:
9342	+$(MAKE) KBUILD_TYPE=debug KBUILD_TARGET_ARCH=amd64
9343
9344	build-release-arm64:
9345	+$(MAKE) KBUILD_TYPE=release KBUILD_TARGET_ARCH=arm64
9346
9347	build-debug-arm64:
9348	+$(MAKE) KBUILD_TYPE=debug KBUILD_TARGET_ARCH=arm64
9349
9350
9351	#
9352	# Some extra goals.
9353	#
9354	.PHONY: up update st stat status
9355	up update::
9356	$(SVN) up
9357
9358	up2 update2::
9359	$(SVN) up --ignore-externals
9360
9361	st stat status:
9362	$(SVN) status

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

Download in other formats:

Original Format