Config.kmk@ 95893

Last change on this file since 95893 was 95893, checked in by vboxsync, 2 years ago
tools/Makefile.kmk: Update WiX to 3.11.2, bugref:8515
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 412.1 KB

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

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

Download in other formats:

Original Format