VirtualBox

source: vbox/trunk/src/VBox/VMM/Makefile.kmk@ 94768

Last change on this file since 94768 was 94768, checked in by vboxsync, 3 years ago

VMM/IEM: Split up IEMAll.cpp into a few more compilation units. bugref:9898

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 26.4 KB
Line 
1# $Id: Makefile.kmk 94768 2022-05-01 22:02:17Z vboxsync $
2## @file
3# Top-level makefile for the VMM.
4#
5
6#
7# Copyright (C) 2006-2022 Oracle Corporation
8#
9# This file is part of VirtualBox Open Source Edition (OSE), as
10# available from http://www.virtualbox.org. This file is free software;
11# you can redistribute it and/or modify it under the terms of the GNU
12# General Public License (GPL) as published by the Free Software
13# Foundation, in version 2 as it comes in the "COPYING" file of the
14# VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15# hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16#
17
18SUB_DEPTH = ../../..
19include $(KBUILD_PATH)/subheader.kmk
20
21# Include our Config.kmk if kmk is invoked from a parent directory.
22ifndef VBOX_VMM_CONFIG_KMK_INCLUDED
23 include $(PATH_SUB_CURRENT)/Config.kmk
24endif
25
26# Include sub-makefiles.
27ifndef VBOX_ONLY_EXTPACKS
28 include $(PATH_SUB_CURRENT)/tools/Makefile.kmk
29 include $(PATH_SUB_CURRENT)/testcase/Makefile.kmk
30endif
31
32
33# Fail on unsupported hosts.
34ifeq ($(KBUILD_TARGET_ARCH),x86)
35 ifeq ($(KBUILD_TARGET),darwin)
36$(error 32-bit darwin is no longer a supported VirtualBox host. Go back to 4.3 or older for 32-bit host support.)
37 else ifeq ($(KBUILD_TARGET),solaris)
38$(error 32-bit solaris is no longer a supported VirtualBox host. Go back to 4.2 or older for 32-bit host support.)
39 else ifn1of ($(KBUILD_TARGET_ARCH), $(VBOX_SUPPORTED_HOST_ARCHS))
40$(error 32-bit builds of the VirtualBox host are no longer supported. Go back to 6.0 or older for 32-bit host support.)
41 endif
42endif
43
44
45#
46# The VMM DLL.
47#
48ifndef VBOX_ONLY_EXTPACKS_USE_IMPLIBS
49 DLLS += VBoxVMM
50endif
51VBoxVMM_TEMPLATE = VBoxR3DllNoPic
52VBoxVMM_SONAME.linux = VBoxVMM.so
53
54VBoxVMM_DEFS = VBOX_IN_VMM IN_VMM_R3 IN_DIS IN_GMM_R3 IN_DBG $(VMM_COMMON_DEFS)
55## @todo eliminate IN_GMM_R3
56ifdef VBOX_WITH_PREALLOC_RAM_BY_DEFAULT
57VBoxVMM_DEFS += VBOX_WITH_PREALLOC_RAM_BY_DEFAULT
58endif
59ifdef VBOX_WITH_VUSB
60VBoxVMM_DEFS += VBOX_WITH_USB
61endif
62ifdef VBOX_WITH_PDM_ASYNC_COMPLETION
63VBoxVMM_DEFS += VBOX_WITH_PDM_ASYNC_COMPLETION
64endif
65ifdef VBOX_WITH_NETSHAPER
66VBoxVMM_DEFS += VBOX_WITH_NETSHAPER
67endif
68ifdef VBOX_WITH_IOMMU_AMD
69VBoxVMM_DEFS += VBOX_WITH_IOMMU_AMD
70endif
71ifdef VBOX_WITH_IOMMU_INTEL
72VBoxVMM_DEFS += VBOX_WITH_IOMMU_INTEL
73endif
74ifdef VBOX_WITH_DBGF_TRACING
75VBoxVMM_DEFS += VBOX_WITH_DBGF_TRACING
76endif
77ifdef VBOX_WITH_DBGF_FLOW_TRACING
78VBoxVMM_DEFS += VBOX_WITH_DBGF_FLOW_TRACING
79endif
80if "$(KBUILD_TYPE)" == "debug" && "$(USERNAME)" == "bird" && 0
81VBoxVMM_DEFS += RTMEM_WRAP_TO_EF_APIS
82endif
83
84VBoxVMM_SDKS = VBOX_SOFTFLOAT
85
86VBoxVMM_INCS = \
87 include \
88 $(VBoxVMM_0_OUTDIR)/CommonGenIncs
89VBoxVMM_ASINCS = .
90
91VBoxVMM_SOURCES = \
92 VBoxVMM.d \
93 VMMR3/VMMR3VTable.cpp \
94 VMMR3/APIC.cpp \
95 VMMR3/CFGM.cpp \
96 VMMR3/CPUM.cpp \
97 VMMR3/CPUMR3CpuId.cpp \
98 VMMR3/CPUMR3Db.cpp \
99 VMMR3/CPUMDbg.cpp \
100 VMMR3/DBGF.cpp \
101 VMMR3/DBGFAddr.cpp \
102 VMMR3/DBGFAddrSpace.cpp \
103 VMMR3/DBGFR3Bp.cpp \
104 VMMR3/DBGFR3BugCheck.cpp \
105 VMMR3/DBGFCoreWrite.cpp \
106 VMMR3/DBGFCpu.cpp \
107 VMMR3/DBGFDisas.cpp \
108 VMMR3/DBGFInfo.cpp \
109 VMMR3/DBGFLog.cpp \
110 VMMR3/DBGFMem.cpp \
111 VMMR3/DBGFR3ModInMem.cpp \
112 VMMR3/DBGFOS.cpp \
113 VMMR3/DBGFR3PlugIn.cpp \
114 VMMR3/DBGFReg.cpp \
115 VMMR3/DBGFStack.cpp \
116 VMMR3/DBGFR3Flow.cpp \
117 $(if-expr defined(VBOX_WITH_DBGF_FLOW_TRACING), VMMR3/DBGFR3FlowTrace.cpp,) \
118 VMMR3/DBGFR3Trace.cpp \
119 $(if-expr defined(VBOX_WITH_DBGF_TRACING), VMMR3/DBGFR3Tracer.cpp,) \
120 VMMR3/DBGFR3SampleReport.cpp \
121 VMMR3/DBGFR3Type.cpp \
122 VMMR3/EM.cpp \
123 VMMR3/EMR3Dbg.cpp \
124 VMMR3/EMHM.cpp \
125 VMMR3/EMR3Nem.cpp \
126 VMMR3/GIM.cpp \
127 VMMR3/GIMHv.cpp \
128 VMMR3/GIMKvm.cpp \
129 VMMR3/GIMMinimal.cpp \
130 VMMR3/IEMR3.cpp \
131 VMMR3/IOM.cpp \
132 VMMR3/IOMR3IoPort.cpp \
133 VMMR3/IOMR3Mmio.cpp \
134 VMMR3/GMM.cpp \
135 VMMR3/GVMMR3.cpp \
136 VMMR3/MM.cpp \
137 VMMR3/MMHeap.cpp \
138 VMMR3/NEMR3.cpp \
139 VMMR3/PDM.cpp \
140 VMMR3/PDMBlkCache.cpp \
141 VMMR3/PDMDevice.cpp \
142 VMMR3/PDMDevHlp.cpp \
143 $(if-expr defined(VBOX_WITH_DBGF_TRACING), VMMR3/PDMDevHlpTracing.cpp,) \
144 VMMR3/PDMDevMiscHlp.cpp \
145 VMMR3/PDMDriver.cpp \
146 VMMR3/PDMLdr.cpp \
147 VMMR3/PDMCritSect.cpp \
148 VMMR3/PDMQueue.cpp \
149 VMMR3/PDMR3Task.cpp \
150 VMMR3/PDMThread.cpp \
151 VMMR3/PGM.cpp \
152 VMMR3/PGMDbg.cpp \
153 VMMR3/PGMHandler.cpp \
154 VMMR3/PGMPhys.cpp \
155 VMMR3/PGMPool.cpp \
156 VMMR3/PGMSavedState.cpp \
157 VMMR3/PGMSharedPage.cpp \
158 VMMR3/SELM.cpp \
159 VMMR3/SSM.cpp \
160 VMMR3/STAM.cpp \
161 VMMR3/TM.cpp \
162 VMMR3/TRPM.cpp \
163 VMMR3/VM.cpp \
164 VMMR3/VMEmt.cpp \
165 VMMR3/VMReq.cpp \
166 VMMR3/VMM.cpp \
167 VMMR3/VMMGuruMeditation.cpp \
168 VMMR3/VMMTests.cpp \
169 VMMR3/HM.cpp \
170 VMMAll/APICAll.cpp \
171 VMMAll/CPUMAllRegs.cpp \
172 VMMAll/CPUMAllMsrs.cpp \
173 VMMAll/DBGFAll.cpp \
174 VMMAll/DBGFAllBp.cpp \
175 $(if-expr defined(VBOX_WITH_DBGF_TRACING), VMMAll/DBGFAllTracer.cpp,) \
176 VMMAll/HMAll.cpp \
177 VMMAll/HMSVMAll.cpp \
178 VMMAll/HMVMXAll.cpp \
179 VMMAll/IEMAll.cpp \
180 VMMAll/IEMAllInstructionsInterpretOnly.cpp \
181 VMMAll/IEMAllAImplC.cpp \
182 VMMAll/IEMAllCImpl.cpp \
183 VMMAll/IEMAllCImplSvmInstr.cpp \
184 VMMAll/IEMAllCImplVmxInstr.cpp \
185 VMMAll/IOMAll.cpp \
186 VMMAll/IOMAllMmioNew.cpp \
187 VMMAll/MMAll.cpp \
188 VMMAll/NEMAll.cpp \
189 VMMAll/PDMAll.cpp \
190 VMMAll/PDMAllCritSect.cpp \
191 VMMAll/PDMAllCritSectRw.cpp \
192 VMMAll/PDMAllCritSectBoth.cpp \
193 $(if-expr defined(VBOX_WITH_IOMMU_AMD) || defined(VBOX_WITH_IOMMU_INTEL), VMMAll/PDMAllIommu.cpp,) \
194 VMMAll/PDMAllQueue.cpp \
195 VMMAll/PDMAllTask.cpp \
196 VMMAll/PGMAll.cpp \
197 VMMAll/PGMAllHandler.cpp \
198 VMMAll/PGMAllPhys.cpp \
199 VMMAll/PGMAllPool.cpp \
200 VMMAll/SELMAll.cpp \
201 VMMAll/EMAll.cpp \
202 VMMAll/GIMAll.cpp \
203 VMMAll/GIMAllHv.cpp \
204 VMMAll/GIMAllKvm.cpp \
205 VMMAll/TMAll.cpp \
206 VMMAll/TMAllCpu.cpp \
207 VMMAll/TMAllReal.cpp \
208 VMMAll/TMAllVirtual.cpp \
209 VMMAll/TRPMAll.cpp \
210 VMMAll/VMAll.cpp \
211 VMMAll/VMMAll.cpp
212VBoxVMM_SOURCES.amd64 += \
213 VMMR3/PGMR3DbgA.asm \
214 $(if-expr !defined(IEM_WITHOUT_ASSEMBLY),VMMAll/IEMAllAImpl.asm,) \
215 VMMAll/VMMAllA.asm
216ifdef VBOX_WITH_VUSB
217VBoxVMM_SOURCES += VMMR3/PDMUsb.cpp
218endif
219ifdef VBOX_WITH_PDM_ASYNC_COMPLETION
220VBoxVMM_SOURCES += \
221 VMMR3/PDMAsyncCompletion.cpp \
222 VMMR3/PDMAsyncCompletionFile.cpp \
223 VMMR3/PDMAsyncCompletionFileFailsafe.cpp \
224 VMMR3/PDMAsyncCompletionFileNormal.cpp
225endif
226ifdef VBOX_WITH_NETSHAPER
227VBoxVMM_SOURCES += \
228 VMMR3/PDMNetShaper.cpp \
229 VMMAll/PDMAllNetShaper.cpp
230endif
231
232ifdef VBOX_WITH_NATIVE_NEM
233VBoxVMM_SOURCES.linux.amd64 += VMMR3/NEMR3Native-linux.cpp
234
235VBoxVMM_SOURCES.win.amd64 += VMMR3/NEMR3Native-win.cpp
236VBoxVMM_DEFS.win.amd64 += VBOX_WITH_NATIVE_NEM
237VBoxVMM_SDKS.win += VBOX_NTDLL
238VMMR3/NEMR3Native-win.cpp_DEFS.amd64 = _AMD64_
239VMMR3/NEMR3Native-win.cpp_INCS = \
240 $(KBUILD_DEVTOOLS)/win.x86/sdk/v10.0.17134.0/include/10.0.17134.0/um \
241 $(KBUILD_DEVTOOLS)/win.x86/sdk/v10.0.17134.0/include/10.0.17134.0/shared
242
243VBoxVMM_SOURCES.darwin.amd64 += \
244 VMMR3/NEMR3Native-darwin.cpp
245VBoxVMM_DEFS.darwin.amd64 += VBOX_WITH_NATIVE_NEM
246endif
247
248VBoxVMM_LIBS = \
249 $(PATH_STAGE_LIB)/DisasmR3$(VBOX_SUFF_LIB)
250ifdef VBOX_WITH_DEBUGGER
251VBoxVMM_LIBS += \
252 $(PATH_STAGE_LIB)/Debugger$(VBOX_SUFF_LIB)
253endif
254VBoxVMM_LIBS += \
255 $(LIB_REM) \
256 $(LIB_RUNTIME)
257
258VBoxVMM_LIBS.win = $(PATH_TOOL_$(VBOX_VCC_TOOL)_LIB)/delayimp.lib
259VBoxVMM_LDFLAGS.linux = $(VBOX_GCC_NO_UNDEFINED)
260VBoxVMM_LDFLAGS.darwin = -install_name $(VBOX_DYLD_EXECUTABLE_PATH)/VBoxVMM.dylib
261VBoxVMM_LDFLAGS.solaris = -mimpure-text
262
263# SSM wish to know the build type, host os and arch.
264ifdef VBOX_WITH_AUTOMATIC_DEFS_QUOTING
265VMMR3/SSM.cpp_DEFS +=\
266 KBUILD_TYPE="$(KBUILD_TYPE)" \
267 KBUILD_TARGET="$(KBUILD_TARGET)" \
268 KBUILD_TARGET_ARCH="$(KBUILD_TARGET_ARCH)"
269else
270VMMR3/SSM.cpp_DEFS += \
271 KBUILD_TYPE=\"$(KBUILD_TYPE)\" \
272 KBUILD_TARGET=\"$(KBUILD_TARGET)\" \
273 KBUILD_TARGET_ARCH=\"$(KBUILD_TARGET_ARCH)\"
274endif
275
276ifdef VBOX_WITH_GCC_SANITIZER
277VMMR3/PGMPool.cpp_CXXFLAGS.linux += -fno-sanitize=address
278endif
279
280#ifdef VBOX_WITH_PDM_ASYNC_COMPLETION
281# ifeq ($(KBUILD_HOST), linux)
282#VBoxVMM_LIBS += aio
283# endif
284#endif
285
286if "$(USERNAME)" == "bird" && "$(KBUILD_TARGET)" == "win"
287VBoxVMM_VMMAll/IEMAll.cpp_CXXFLAGS = /FAcs /Fa$(subst /,\\,$(outbase).cod)
288VBoxVMM_VMMAll/IEMAllInstructionsInterpretOnly.cpp_CXXFLAGS = /FAcs /Fa$(subst /,\\,$(outbase).cod)
289VBoxVMM_VMMAll/IEMAllAImplC.cpp_CXXFLAGS = /FAcs /Fa$(subst /,\\,$(outbase).cod)
290VBoxVMM_VMMAll/PGMAll.cpp_CXXFLAGS = /FAcs /Fa$(subst /,\\,$(outbase).cod)
291VBoxVMM_VMMAll/PDMAllCritSect.cpp_CXXFLAGS = /FAcs /Fa$(subst /,\\,$(outbase).cod)
292VBoxVMM_CLEAN += $(addprefix $(VBoxVMM_0_OUTDIR)/VMMAll/, IEMAll.cod IEMAllAImplC.cod IEMAllInstructionsInterpretOnly.cod PGMAll.cod PDMAllCritSect.cod)
293endif
294
295$(call VBOX_SET_VER_INFO_DLL,VBoxVMM,VirtualBox VMM) # Version info / description.
296
297
298#
299# This'll apply to both VBoxVMM and VMMR0.
300#
301ifdef IEM_WITHOUT_ASSEMBLY
302VMMAll/IEMAllAImplC.cpp_DEFS = IEM_WITHOUT_ASSEMBLY
303endif
304
305
306#
307# Generate macro template for IEM instruction statistics.
308#
309$(call KB_FN_DO_PASS0_ON_TARGET,VBoxVMM) # Set VBoxVMM_0_OUTDIR
310VBoxVMM_INTERMEDIATES += $(VBoxVMM_0_OUTDIR)/CommonGenIncs/IEMInstructionStatisticsTmpl.h
311VBoxVMM_CLEAN += \
312 $(VBoxVMM_0_OUTDIR)/CommonGenIncs/IEMInstructionStatisticsTmpl.h.ts \
313 $(VBoxVMM_0_OUTDIR)/CommonGenIncs/IEMInstructionStatisticsTmpl.h
314$(call KB_FN_AUTO_CMD_DEPS,$(VBoxVMM_0_OUTDIR)/CommonGenIncs/IEMInstructionStatisticsTmpl.h.ts)
315$(VBoxVMM_0_OUTDIR)/CommonGenIncs/IEMInstructionStatisticsTmpl.h.ts \
316+| $(VBoxVMM_0_OUTDIR)/CommonGenIncs/IEMInstructionStatisticsTmpl.h: \
317 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructionsInterpretOnly.cpp \
318 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructionsOneByte.cpp.h \
319 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructionsTwoByte0f.cpp.h \
320 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructionsThree0f38.cpp.h \
321 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructionsThree0f3a.cpp.h \
322 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructionsVexMap1.cpp.h \
323 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructionsVexMap2.cpp.h \
324 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructionsVexMap3.cpp.h \
325 $(PATH_SUB_CURRENT)/VMMAll/IEMAllInstructions3DNow.cpp.h
326 $(QUIET)$(call MSG_GENERATE,VBoxVMM,$@,VMMAll/IEMAllInstructions*.cpp.h)
327 $(QUIET)$(RM) -f -- "$@.tmp" "$@.tmp" "$@.sorted"
328 $(QUIET)$(MKDIR) -p -- "$(dir $@)"
329 $(call KB_FN_AUTO_CMD_DEPS_COMMANDS)
330 $(QUIET)$(SED) \
331 -e '/IEMOP_MNEMONIC\(\|[01234]\|[01234]EX\)(/!d' \
332 -e ':look-for-end-of-invocation' \
333 -e '/)/bend-of-invocation' \
334 -e 'N' \
335 -e 'blook-for-end-of-invocation' \
336 -e ':end-of-invocation' \
337 -e 's/\n/ /g' \
338 -e 's/ */ /g' \
339 -e 's/^.*IEMOP_MNEMONIC\(\|[01234]\|[01234]EX\)(/IEM_DO_INSTR_STAT\1(/' \
340 -e 's/;.*$(DOLLAR)//' \
341 --output "$@.tmp" $(filter %.cpp.h %IEMAllInstructionsInterpretOnly.cpp,$^)
342# Windows sort does some kind of seeking. So, we must use a temporary file and kmk_cat to define and undefine our macros.
343 $(QUIET)$(REDIRECT) -wto "$@.sorted" -- sort "$@.tmp"
344 $(QUIET)$(APPEND) -nt "$@" \
345 '/* Warning autogenerated by VMM/Makefile.kmk. */ ' \
346 '#define IEM_DO_INSTR_STAT0(f,u,l,fd,fi) IEM_DO_INSTR_STAT(l, #l)' \
347 '#define IEM_DO_INSTR_STAT1(f,u,l,o1,fd,fi) IEM_DO_INSTR_STAT(l ## _ ## o1, #l " " #o1)' \
348 '#define IEM_DO_INSTR_STAT2(f,u,l,o1,o2,fd,fi) IEM_DO_INSTR_STAT(l ## _ ## o1 ## _ ## o2, #l " " #o1 "," #o2)' \
349 '#define IEM_DO_INSTR_STAT3(f,u,l,o1,o2,o3,fd,fi) IEM_DO_INSTR_STAT(l ## _ ## o1 ## _ ## o2 ## _ ## o3, #l " " #o1 "," #o2 "," #o3)' \
350 '#define IEM_DO_INSTR_STAT4(f,u,l,o1,o2,o3,o4,fd,fi) IEM_DO_INSTR_STAT(l ## _ ## o1 ## _ ## o2 ## _ ## o3 ## _ ## o4, #l " " #o1 "," #o2 "," #o3 "," #o4)' \
351 '#define IEM_DO_INSTR_STAT0EX(s,m,f,u,l,fd,fi) IEM_DO_INSTR_STAT(s,m)' \
352 '#define IEM_DO_INSTR_STAT1EX(s,m,f,u,l,o1,fd,fi) IEM_DO_INSTR_STAT(s,m)' \
353 '#define IEM_DO_INSTR_STAT2EX(s,m,f,u,l,o1,o2,fd,fi) IEM_DO_INSTR_STAT(s,m)' \
354 '#define IEM_DO_INSTR_STAT3EX(s,m,f,u,l,o1,o2,o3,fd,fi) IEM_DO_INSTR_STAT(s,m)' \
355 '#define IEM_DO_INSTR_STAT4EX(s,m,f,u,l,o1,o2,o3,o4,fd,fi) IEM_DO_INSTR_STAT(s,m)' \
356 ''
357 $(QUIET)$(REDIRECT) -ato "$@" -- $(CAT_EXT) "$@.sorted"
358 $(QUIET)$(APPEND) -n "$@" \
359 '' \
360 '#undef IEM_DO_INSTR_STAT0' \
361 '#undef IEM_DO_INSTR_STAT1' \
362 '#undef IEM_DO_INSTR_STAT2' \
363 '#undef IEM_DO_INSTR_STAT3' \
364 '#undef IEM_DO_INSTR_STAT4' \
365 '#undef IEM_DO_INSTR_STAT0EX' \
366 '#undef IEM_DO_INSTR_STAT1EX' \
367 '#undef IEM_DO_INSTR_STAT2EX' \
368 '#undef IEM_DO_INSTR_STAT3EX' \
369 '#undef IEM_DO_INSTR_STAT4EX' \
370 ''
371 $(QUIET)$(RM) -f -- "$@.tmp" "$@.sorted"
372 $(QUIET)$(CP) -v -f --changed -- "$@" "$(patsubst %.ts,%,$@)"
373
374foobar: $(VBoxVMM_0_OUTDIR)/CommonGenIncs/IEMInstructionStatisticsTmpl.h
375
376if "$(KBUILD_TARGET)" == "win" && !defined(VBOX_ONLY_EXTPACKS_USE_IMPLIBS)
377#
378# Debug type info hack for VMCPU, VM and similar.
379#
380# The microsoft linker seems to be using the last occurence of the structures
381# when writing the module PDB file. So, we put the fully complete structures
382# in a library which is at the end of the library list.
383#
384VBoxVMM_LIBS += $(VBoxVMMPdbTypeHack_1_TARGET)
385VBoxVMM_LDFLAGS += /Export:PdbTypeHack
386
387LIBRARIES += VBoxVMMPdbTypeHack
388VBoxVMMPdbTypeHack_TEMPLATE = $(VBoxVMM_TEMPLATE)
389VBoxVMMPdbTypeHack_SOURCES = VMMAll/AllPdbTypeHack.cpp
390VBoxVMMPdbTypeHack_DEFS = $(VBoxVMM_DEFS)
391VBoxVMMPdbTypeHack_DEFS.win = $(VBoxVMM_DEFS.win)
392VBoxVMMPdbTypeHack_DEFS.win.x86 = $(VBoxVMM_DEFS.win.x86)
393VBoxVMMPdbTypeHack_DEFS.win.amd64 = $(VBoxVMM_DEFS.win.amd64)
394VBoxVMMPdbTypeHack_INCS = $(VBoxVMM_INCS)
395VBoxVMMPdbTypeHack_INTERMEDIATES = $(VBoxVMM_INTERMEDIATES)
396endif
397
398
399if1of ($(VBOX_LDR_FMT), pe lx)
400#
401# VMMR0Imp.lib
402#
403LIBRARIES += VMMR0Imp
404VMMR0Imp_TEMPLATE = VBoxR0
405VMMR0Imp_SOURCES = $(VMMR0Imp_0_OUTDIR)/VMMR0.def
406VMMR0Imp_CLEAN = $(VMMR0Imp_0_OUTDIR)/VMMR0.def
407 ifeq ($(KBUILD_TARGET),win) # Experiment: Let's see how blunt the ones messing our NULL_THUNK_DATA entries on W10 are.
408VMMR0Imp_POST_CMDS = $(KLIBTWEAKER_EXT) --clear-timestamps --fill-null_thunk_data $(out)
409 endif
410$(call KB_FN_DO_PASS0_ON_TARGET,VMMR0Imp)
411
412$(call KB_FN_AUTO_CMD_DEPS,$(VMMR0Imp_0_OUTDIR)/VMMR0.def)
413$(VMMR0Imp_0_OUTDIR)/VMMR0.def: $(VMMR0Imp_DEFPATH)/VMMR0/VMMR0.def | $$(dir $$@)
414 $(call KB_FN_AUTO_CMD_DEPS_COMMANDS)
415 ifeq ($(VBOX_LDR_FMT),lx)
416 $(SED) \
417 -e '/not-os2/d' \
418 -e '/not-amd64/d' \
419 -e 's/^[ \t][ \t]*\([a-zA-Z]\)/ _\1/' \
420 -e 's/[ \t]DATA[ \t]*/ /' \
421 --output $@ $(VMMR0Imp_DEFPATH)/VMMR0/VMMR0.def
422 $(APPEND) "$@" ""
423 $(APPEND) "$@" " ___ehInit"
424 else
425 $(SED) \
426 -e '/not-win/d' \
427 -e '/not-$(KBUILD_TARGET_ARCH)/d' \
428 --output $@ $(VMMR0Imp_DEFPATH)/VMMR0/VMMR0.def
429 endif
430endif # R0: pe + lx
431
432
433#
434# VMMR3Imp.lib
435#
436IMPORT_LIBS += VMMR3Imp
437$(call VBOX_GENERATE_IMPORT_TARGET_FN,VMMR3Imp,VBoxVMM,VMMR3/VMMR3.def)
438
439
440#
441# VMMR0.r0
442#
443if defined(VBOX_WITH_R0_MODULES) && !defined(VBOX_ONLY_EXTPACKS)
444 ifdef VBOX_WITH_VBOXR0_AS_DLL
445 DLLS += VMMR0
446 else
447 SYSMODS += VMMR0
448 endif
449 VMMR0_TEMPLATE = VBoxR0
450 VMMR0_SYSSUFF = .r0
451
452 VMMR0_DEFS = VBOX_IN_VMM IN_VMM_R0 IN_RT_R0 IN_DIS DIS_CORE_ONLY IN_GVMM_R0 IN_GMM_R0 IN_INTNET_R0 \
453 $(VMM_COMMON_DEFS) RTASSERT_HAVE_SHOULD_PANIC
454 ## @todo eliminate IN_GVMM_R0 IN_GMM_R0
455 ifdef VBOX_WITH_PCI_PASSTHROUGH
456 VMMR0_DEFS += IN_PCIRAW_R0
457 endif
458 ifdef VBOX_WITH_TRIPLE_FAULT_HACK
459 VMMR0_DEFS += VBOX_WITH_TRIPLE_FAULT_HACK
460 endif
461 ifdef VBOX_WITH_IOMMU_AMD
462 VMMR0_DEFS += VBOX_WITH_IOMMU_AMD
463 endif
464 ifdef VBOX_WITH_DBGF_TRACING
465 VMMR0_DEFS += VBOX_WITH_DBGF_TRACING
466 endif
467 if1of ($(KBUILD_TARGET), darwin linux win)
468 VMMR0_DEFS += VMM_R0_TOUCH_FPU
469 endif
470 VMMR0_DEFS.win.amd64 = VBOX_WITH_KERNEL_USING_XMM
471
472 ifeq ($(VBOX_LDR_FMT),elf)
473 VMMR0_CXXFLAGS += -Wunused -Wunused-variable -Wno-unused-parameter
474 endif
475
476 VMMR0_SDKS = VBOX_SOFTFLOATR0
477
478 VMMR0_INCS = \
479 include \
480 $(VBoxVMM_0_OUTDIR)/CommonGenIncs
481
482 VMMR0_SOURCES = \
483 VBoxVMM.d \
484 VMMR0/CPUMR0.cpp \
485 VMMR0/CPUMR0A.asm \
486 VMMR0/DBGFR0.cpp \
487 VMMR0/DBGFR0Bp.cpp \
488 $(if-expr defined(VBOX_WITH_DBGF_TRACING), VMMR0/DBGFR0Tracer.cpp,) \
489 VMMR0/GIMR0.cpp \
490 VMMR0/GIMR0Hv.cpp \
491 VMMR0/GMMR0.cpp \
492 VMMR0/GVMMR0.cpp \
493 VMMR0/EMR0.cpp \
494 VMMR0/HMR0.cpp \
495 VMMR0/HMR0A.asm \
496 VMMR0/HMR0UtilA.asm \
497 VMMR0/HMVMXR0.cpp \
498 VMMR0/HMSVMR0.cpp \
499 VMMR0/IEMR0.cpp \
500 VMMR0/IOMR0.cpp \
501 VMMR0/IOMR0IoPort.cpp \
502 VMMR0/IOMR0Mmio.cpp \
503 VMMR0/PDMR0Device.cpp \
504 VMMR0/PDMR0DevHlp.cpp \
505 $(if-expr defined(VBOX_WITH_DBGF_TRACING), VMMR0/PDMR0DevHlpTracing.cpp,) \
506 VMMR0/PDMR0Driver.cpp \
507 VMMR0/PDMR0Queue.cpp \
508 VMMR0/PGMR0.cpp \
509 VMMR0/PGMR0Pool.cpp \
510 VMMR0/PGMR0SharedPage.cpp \
511 VMMR0/TMR0.cpp \
512 VMMR0/VMMR0.cpp \
513 VMMRZ/CPUMRZ.cpp \
514 VMMRZ/CPUMRZA.asm \
515 VMMRZ/VMMRZ.cpp \
516 VMMAll/APICAll.cpp \
517 VMMAll/CPUMAllRegs.cpp \
518 VMMAll/CPUMAllMsrs.cpp \
519 VMMAll/DBGFAll.cpp \
520 VMMAll/DBGFAllBp.cpp \
521 $(if-expr defined(VBOX_WITH_DBGF_TRACING), VMMAll/DBGFAllTracer.cpp,) \
522 VMMAll/EMAll.cpp \
523 VMMAll/GIMAll.cpp \
524 VMMAll/GIMAllHv.cpp \
525 VMMAll/GIMAllKvm.cpp \
526 VMMAll/HMAll.cpp \
527 VMMAll/HMSVMAll.cpp \
528 VMMAll/HMVMXAll.cpp \
529 VMMAll/IEMAll.cpp \
530 VMMAll/IEMAllInstructionsInterpretOnly.cpp \
531 $(if-expr !defined(IEM_WITHOUT_ASSEMBLY),VMMAll/IEMAllAImpl.asm,) \
532 VMMAll/IEMAllAImplC.cpp \
533 VMMAll/IEMAllCImpl.cpp \
534 VMMAll/IEMAllCImplSvmInstr.cpp \
535 VMMAll/IEMAllCImplVmxInstr.cpp \
536 VMMAll/IOMAll.cpp \
537 VMMAll/IOMAllMmioNew.cpp \
538 VMMAll/MMAll.cpp \
539 VMMAll/NEMAll.cpp \
540 VMMAll/PDMAll.cpp \
541 VMMAll/PDMAllCritSect.cpp \
542 VMMAll/PDMAllCritSectRw.cpp \
543 VMMAll/PDMAllCritSectBoth.cpp \
544 $(if-expr defined(VBOX_WITH_IOMMU_AMD) || defined(VBOX_WITH_IOMMU_INTEL), VMMAll/PDMAllIommu.cpp,) \
545 VMMAll/PDMAllQueue.cpp \
546 VMMAll/PDMAllTask.cpp \
547 VMMAll/PGMAll.cpp \
548 VMMAll/PGMAllHandler.cpp \
549 VMMAll/PGMAllPhys.cpp \
550 VMMAll/PGMAllPool.cpp \
551 VMMAll/SELMAll.cpp \
552 VMMAll/TMAll.cpp \
553 VMMAll/TMAllCpu.cpp \
554 VMMAll/TMAllReal.cpp \
555 VMMAll/TMAllVirtual.cpp \
556 VMMAll/TRPMAll.cpp \
557 VMMAll/VMAll.cpp \
558 VMMAll/VMMAll.cpp \
559 VMMAll/VMMAllA.asm
560 if1of ($(VBOX_LDR_FMT), pe lx)
561 VMMR0_SOURCES += $(VMMR0Imp_0_OUTDIR)/VMMR0.def
562 endif
563 ifdef VBOX_WITH_TRIPLE_FAULT_HACK
564 VMMR0_SOURCES += \
565 VMMR0/VMMR0TripleFaultHack.cpp \
566 VMMR0/VMMR0TripleFaultHackA.asm
567 endif
568 ifdef VBOX_WITH_NETSHAPER
569 VMMR0_SOURCES += \
570 VMMAll/PDMAllNetShaper.cpp
571 endif
572 VMMR0_SOURCES.amd64 = \
573 VMMR0/VMMR0JmpA-amd64.asm
574 VMMR0_SOURCES.x86 = \
575 VMMR0/VMMR0JmpA-x86.asm
576
577 VMMR0_LIBS = \
578 $(PATH_STAGE_LIB)/ServicesR0$(VBOX_SUFF_LIB) \
579 $(PATH_STAGE_LIB)/RuntimeR0$(VBOX_SUFF_LIB) \
580 $(PATH_STAGE_LIB)/DisasmR0$(VBOX_SUFF_LIB) \
581 $(VBOX_LIB_SUPR0)
582 ifdef VBOX_WITH_NATIVE_NEM
583 VMMR0_SOURCES.linux.amd64 += VMMR0/NEMR0Native-stubs.cpp
584 VMMR0_SOURCES.win.amd64 += VMMR0/NEMR0Native-stubs.cpp
585 VMMR0_SOURCES.darwin.amd64 += VMMR0/NEMR0Native-stubs.cpp
586 VMMR0_DEFS.darwin.amd64 += VBOX_WITH_NATIVE_NEM VBOX_WITH_NEM_R0
587 endif
588
589 $(call VBOX_SET_VER_INFO_R0,VMMR0,VirtualBox VMM - ring-0 context parts) # Version info / description.
590
591 if "$(USERNAME)" == "bird" && "$(KBUILD_TARGET)" == "win"
592 VMMR0_VMMAll/IEMAll.cpp_CXXFLAGS = /FAcs /Fa$(subst /,\\,$(outbase).cod)
593 VMMR0_VMMAll/IEMAllAImplC.cpp_CXXFLAGS = /FAcs /Fa$(subst /,\\,$(outbase).cod)
594 VMMR0_VMMAll/PGMAll.cpp_CXXFLAGS = /FAcs /Fa$(subst /,\\,$(outbase).cod)
595 VMMR0_CLEAN += $(addprefix $(VMMR0_0_OUTDIR)/VMMAll/, IEMAll.cod IEMAllAImplC.cod PGMAll.cod)
596 endif
597
598 VMMR0_INTERMEDIATES += $(VBoxVMM_0_OUTDIR)/CommonGenIncs/IEMInstructionStatisticsTmpl.h
599
600 if "$(KBUILD_TARGET)" == "win"
601 # Debug type info hack for VMCPU, VM and similar. See VBoxVMM for details.
602 VMMR0_LIBS += $(VMMR0PdbTypeHack_1_TARGET)
603 VMMR0_LDFLAGS += /Export:PdbTypeHack
604
605 LIBRARIES += VMMR0PdbTypeHack
606 VMMR0PdbTypeHack_TEMPLATE = $(VMMR0_TEMPLATE)
607 VMMR0PdbTypeHack_SOURCES = VMMAll/AllPdbTypeHack.cpp
608 VMMR0PdbTypeHack_DEFS = $(VMMR0_DEFS)
609 VMMR0PdbTypeHack_DEFS.win = $(VMMR0_DEFS.win)
610 VMMR0PdbTypeHack_DEFS.win.x86 = $(VMMR0_DEFS.win.x86)
611 VMMR0PdbTypeHack_DEFS.win.amd64 = $(VMMR0_DEFS.win.amd64)
612 VMMR0PdbTypeHack_INCS = $(VMMR0_INCS)
613 VMMR0PdbTypeHack_INTERMEDIATES = $(VMMR0_INTERMEDIATES)
614 endif
615
616 ifdef VBOX_WITH_KMOD_WRAPPED_R0_MODS
617 # Wrapper kmod for VMMR0.r0
618 INSTALLS.linux += vbox_vmmr0-src
619 vbox_vmmr0-src_INST = bin/src/vbox_vmmr0/
620 vbox_vmmr0-src_SYMLINKS = \
621 SUPWrapperMod-linux.c=>../common/SUPWrapperMod-linux.c \
622 Makefile-wrapper.gmk=>../common/Makefile-wrapper.gmk
623 vbox_vmmr0-src_SOURCES = \
624 $(PATH_ROOT)/src/VBox/HostDrivers/Support/linux/Makefile-vbox_vmmr0.gmk=>Makefile \
625 $(VMMR0_0_OUTDIR)/VMMR0.r0=>VMMR0.r0 \
626 $(VMMR0_0_OUTDIR)/VMMR0.debug=>VMMR0.debug
627 endif
628
629endif # defined(VBOX_WITH_R0_MODULES) && !defined(VBOX_ONLY_EXTPACKS)
630
631
632
633ifndef VBOX_ONLY_EXTPACKS
634#
635# SSMStandalone.lib/a for linking with VBoxSVC and other executables.
636#
637LIBRARIES += SSMStandalone
638SSMStandalone_TEMPLATE = VBOXR3EXE
639SSMStandalone_DEFS = VBOX_IN_VMM IN_VMM_R3 IN_VMM_STATIC SSM_STANDALONE CPUM_DB_STANDALONE $(VMM_COMMON_DEFS)
640SSMStandalone_INCS = include
641SSMStandalone_SOURCES = \
642 VMMR3/SSM.cpp \
643 VMMR3/CPUMR3Db.cpp
644endif # !VBOX_ONLY_EXTPACKS
645
646
647if !defined(VBOX_ONLY_EXTPACKS) \
648 && ( defined(VBOX_WITH_DTRACE_R3) \
649 || defined(VBOX_WITH_DTRACE_R0) \
650 || defined(VBOX_WITH_DTRACE_RC))
651#
652# Install the dtrace library files.
653#
654INSTALLS += VMMLibDTrace
655VMMLibDTrace_INST = $(VBOX_INST_DTRACE_LIB)$(KBUILD_TARGET_ARCH)/
656VMMLibDTrace_SOURCES = \
657 dtrace/lib/vbox-types.d \
658 dtrace/lib/$(KBUILD_TARGET_ARCH)/vbox-arch-types.d \
659 $(VMMLibDTrace_0_OUTDIR)/vm.d \
660 $(VMMLibDTrace_0_OUTDIR)/cpumctx.d \
661 $(VMMLibDTrace_0_OUTDIR)/cpum.d \
662 $(VMMLibDTrace_0_OUTDIR)/CPUMInternal.d \
663 $(VMMLibDTrace_0_OUTDIR)/x86.d
664$(call KB_FN_DO_PASS0_ON_TARGET,VMMLibDTrace)
665
666
667##
668# Turn the header $2 into the DTrace library script $1.
669#
670 define def_vmm_lib_dtrace_preprocess
671$$(call KB_FN_AUTO_CMD_DEPS,$$(VMMLibDTrace_0_OUTDIR)/$1)
672$$(VMMLibDTrace_0_OUTDIR)/$1: $2 $$(VBOX_VBOXCPP) | $$$$(dir $$$$@)
673 $$(call KB_FN_AUTO_CMD_DEPS_COMMANDS)
674 $$(QUIET)$$(call MSG_GENERATE,VMMLibDTrace,$$@,$2)
675 $$(QUIET)$(VBOX_VBOXCPP) -d \
676 -D VBOX_FOR_DTRACE_LIB \
677 -D VBOX_FOR_DTRACE_LIB_$(toupper $(KBUILD_TARGET_ARCH)) \
678 -D IN_RING0 \
679 -D RT_C_DECLS_BEGIN= \
680 -D RT_C_DECLS_END= \
681 -D RT_GCC_EXTENSION= \
682 -D 'RCPTRTYPE(a_Type)=RTRCPTR' \
683 -D 'R3PTRTYPE(a_Type)=RTR3PTR' \
684 -D 'R0PTRTYPE(a_Type)=a_Type' \
685 -D 'AssertCompile(a_Expr)=' \
686 -D 'AssertCompileSize(a_Stuct, a_Size)=' \
687 -D 'bool=uint8_t' \
688 $$(foreach def,\
689 $$(DEFS) \
690 $$(DEFS.$$(KBUILD_TARGET)) \
691 $$(DEFS.$(KBUILD_TARGET_ARCH)) \
692 $$(VMM_COMMON_DEFS) \
693 $$(ARCH_BITS_DEFS)\
694 ,-D '$$(def)') \
695 $2 \
696 $$@
697 $$(QUIET)$$(CHMOD) 644 $$@
698
699 VMMLibDTrace_CLEAN += $(VMMLibDTrace_0_OUTDIR)/$1
700 endef
701$(evalcall2 def_vmm_lib_dtrace_preprocess,vm.d,$(PATH_ROOT)/include/VBox/vmm/vm.h)
702$(evalcall2 def_vmm_lib_dtrace_preprocess,cpumctx.d,$(PATH_ROOT)/include/VBox/vmm/cpumctx.h)
703$(evalcall2 def_vmm_lib_dtrace_preprocess,cpum.d,$(PATH_ROOT)/include/VBox/vmm/cpum.h)
704$(evalcall2 def_vmm_lib_dtrace_preprocess,CPUMInternal.d,$(PATH_SUB_CURRENT)/include/CPUMInternal.h)
705$(evalcall2 def_vmm_lib_dtrace_preprocess,x86.d,$(PATH_ROOT)/include/iprt/x86.h)
706
707endif
708
709
710
711#
712# For vmmGetSvnRev.
713#
714VMMAll/VMMAll.cpp_DEFS = VBOX_SVN_REV=$(VBOX_SVN_REV)
715
716#
717# Disable annoying warnings about array subscript above array bounds in aPages[]
718#
719ifneq ($(KBUILD_TARGET),win)
720VMMR3/PGMPool.cpp_CXXFLAGS = $(VBOX_GCC_Wno-array_bounds)
721VMMAll/PGMAllPool.cpp_CXXFLAGS = $(VBOX_GCC_Wno-array_bounds)
722VMMAll/PGMAll.cpp_CXXFLAGS = -Wno-unused-function
723VMMAll/IEMAll.cpp_CXXFLAGS = -Wno-unused-function
724VMMR0/GMMR0.cpp_CXXFLAGS = -Wno-unused-value
725endif
726
727#
728# Always optimize the interpreter.
729#
730#if "$(KBUILD_TYPE)" == "release" || ($(USERNAME) != "bird" && $(USERNAME) != "aeichner")
731if "$(KBUILD_TYPE)" == "release" || ($(USERNAME) != "aeichner")
732 if1of ($(KBUILD_TARGET), win)
733# -noover is recognized despite the statement saying otherwise. It silences these warnings:
734# cl : Command line warning D9025 : overriding '/Od' with '/O2'
735# cl : Command line warning D9025 : overriding '/Oy-' with '/Oy'
736VMMAll/IEMAll.cpp_CXXFLAGS += -noover -O2xy
737VMMAll/IEMAllAImplC.cpp_CXXFLAGS += -noover -O2xy
738 else
739VMMAll/IEMAll.cpp_CXXFLAGS += -O2
740VMMAll/IEMAllAImplC.cpp_CXXFLAGS += -O2 -fomit-frame-pointer
741#VMMAll/IEMAll.cpp_CXXFLAGS += -fno-align-functions -fno-align-jumps -fno-align-loops # Saves a few of percents, not worth it.
742#VMMAll/IEMAll.cpp_CXXFLAGS += -fno-reorder-blocks # Saves one or two percent ... never mind.
743VMMAll/IEMAll.cpp_CXXFLAGS += -fomit-frame-pointer # Omitting the frame pointer results in larger code, but it might be worth it. (esp addressing vs ebp?)
744 endif
745endif # bird wants good stacks (aeichner as well)
746
747
748# Alias the CPU database entries.
749$(foreach base,$(notdir $(basename $(wildcard $(PATH_SUB_CURRENT)/VMMR3/cpus/*.h))), $(eval $(base).o $(base).obj: CPUMR3Db.o))
750
751
752#
753# Process python source(s).
754#
755BLDDIRS += $(PATH_TARGET)/pylint
756
757define def_vbox_vmm_py_check
758$(eval name:=$(basename $(notdir $(py))))
759
760pylint: $(name)-py-phony.o
761$(name).o: $(name)-py-phony.o
762$(PATH_TARGET)/pylint/$(name).o $(name)-py-phony.o:: $(py) | $(PATH_TARGET)/pylint/
763ifdef VBOX_WITH_PYLINT
764 $(QUIET2)$(call MSG_L1,Subjecting $(py) to pylint...)
765 $(QUIET)$(REDIRECT) -C "$(dir $(py))" -E LC_ALL=C -- \
766 $(VBOX_PYLINT) --rcfile=$(PATH_TARGET)/no-such-pylintrc \
767 $$(VBOX_PYLINT_FLAGS) $$($(py)_VBOX_PYLINT_FLAGS) ./$(notdir $(py))
768endif
769 $(QUIET)$(APPEND) -t "$(PATH_TARGET)/pylint/$(name).o"
770
771TESTING += $(name)-py-phony.o
772endef # def_vbox_vmm_py_check
773
774$(foreach py, $(addprefix $(PATH_SUB_CURRENT)/VMMAll/, IEMAllInstructionsPython.py ) , $(eval $(def_vbox_vmm_py_check)))
775
776
777include $(FILE_KBUILD_SUB_FOOTER)
778
779
780# Alias the PGM templates to the object in which they are defined.
781PGMInternal.o: PGM.o
782
783PGMAllBth.o PGMAllGst.o PGMAllShw.o \
784PGMAllBth.obj PGMAllGst.obj PGMAllShw.obj: PGMAll.o
785
786PGMRCBth.o PGMRCGst.o PGMRCShw.o \
787PGMRCBth.obj PGMRCGst.obj PGMRCShw.obj: PGMRC.o
788
789PGMPhysRWTmpl.o PGMPhysRWTmpl.obj: PGMPhys.o
790
791PGMInline.o PGMInline.obj: PGMDbg.o
792
793# Alias the IEM templates to the object in which they are instantiated.
794IEMAllInstructions.cpp.o IEMAllInstructions.cpp.obj \
795IEMAllInstructionsOneByte.cpp.o IEMAllInstructionsOneByte.cpp.obj \
796IEMAllInstructionsTwoByte0f.cpp.o IEMAllInstructionsTwoByte0f.cpp.obj \
797IEMAllInstructionsThree0f38.cpp.o IEMAllInstructionsThree0f38.cpp.obj \
798IEMAllInstructionsThree0f3a.cpp.o IEMAllInstructionsThree0f3a.cpp.obj \
799IEMAllInstructionsVexMap1.cpp.o IEMAllInstructionsVexMap1.cpp.obj \
800IEMAllInstructionsVexMap2.cpp.o IEMAllInstructionsVexMap2.cpp.obj \
801IEMAllInstructionsVexMap3.cpp.o IEMAllInstructionsVexMap3.cpp.obj \
802IEMAllInstructions3DNow.cpp.o IEMAllInstructions3DNow.cpp.obj: IEMAllInstructionsInterpretOnly.o
803
804IEMInternal.o IEMInternal.obj: IEMAll.o
805
806IEMAllCImplStrInstr.cpp.o IEMAllCImplStrInstr.cpp.obj: IEMAllCImpl.o
807
808# Alias the NEM template to the objects where it is used:
809NEMAllNativeTemplate-win.cpp.o: NEMR3Native-win.o
810
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette