[2478] | 1 | # $Id: Makefile.kmk 77883 2019-03-26 16:01:42Z vboxsync $
|
---|
| 2 | ## @file
|
---|
[6759] | 3 | # Sub-Makefile for VBoxManage (the cli frontend).
|
---|
[1] | 4 | #
|
---|
| 5 |
|
---|
| 6 | #
|
---|
[76553] | 7 | # Copyright (C) 2006-2019 Oracle Corporation
|
---|
[5999] | 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 | #
|
---|
[1] | 17 |
|
---|
[10058] | 18 | SUB_DEPTH = ../../../..
|
---|
[8760] | 19 | include $(KBUILD_PATH)/subheader.kmk
|
---|
[1] | 20 |
|
---|
[68860] | 21 | include $(PATH_ROOT)/doc/manual/Config.kmk
|
---|
| 22 |
|
---|
| 23 |
|
---|
[56465] | 24 | VBOX_COMMON_VBOXMANAGE_DEFS = \
|
---|
| 25 | $(if $(VBOX_WITH_AHCI), VBOX_WITH_AHCI) \
|
---|
| 26 | $(if $(VBOX_WITH_COPYTOGUEST),VBOX_WITH_COPYTOGUEST) \
|
---|
| 27 | $(if $(VBOX_WITH_E1000),VBOX_WITH_E1000) \
|
---|
| 28 | $(if $(VBOX_WITH_GUEST_CONTROL),VBOX_WITH_GUEST_CONTROL) \
|
---|
| 29 | $(if $(VBOX_WITH_GUEST_PROPS),VBOX_WITH_GUEST_PROPS) \
|
---|
| 30 | $(if $(VBOX_WITH_HEADLESS), VBOX_WITH_HEADLESS) \
|
---|
| 31 | $(if $(VBOX_WITH_HGCM), VBOX_WITH_HGCM) \
|
---|
| 32 | $(if $(VBOX_WITH_HOSTNETIF_API), VBOX_WITH_HOSTNETIF_API) \
|
---|
| 33 | $(if $(VBOX_WITH_NETFLT), VBOX_WITH_NETFLT) \
|
---|
[62585] | 34 | $(if $(VBOX_WITH_AUDIO_OSS), VBOX_WITH_AUDIO_OSS) \
|
---|
| 35 | $(if $(VBOX_WITH_AUDIO_ALSA), VBOX_WITH_AUDIO_ALSA) \
|
---|
| 36 | $(if $(VBOX_WITH_AUDIO_PULSE),VBOX_WITH_AUDIO_PULSE) \
|
---|
[56465] | 37 | $(if $(VBOX_WITH_SCSI), VBOX_WITH_SCSI) \
|
---|
| 38 | $(if $(VBOX_WITH_VBOXSDL), VBOX_WITH_VBOXSDL) \
|
---|
| 39 | $(if $(VBOX_WITH_VIDEOHWACCEL), VBOX_WITH_VIDEOHWACCEL) \
|
---|
| 40 | $(if $(VBOX_WITH_VIRTIO),VBOX_WITH_VIRTIO) \
|
---|
| 41 | $(if $(VBOX_WITH_USB_CARDREADER),VBOX_WITH_USB_CARDREADER) \
|
---|
| 42 | $(if $(VBOX_WITH_PCI_PASSTHROUGH),VBOX_WITH_PCI_PASSTHROUGH) \
|
---|
[75345] | 43 | $(if $(VBOX_WITH_RECORDING),VBOX_WITH_RECORDING) \
|
---|
| 44 | $(if $(VBOX_WITH_AUDIO_RECORDING),VBOX_WITH_AUDIO_RECORDING) \
|
---|
[56465] | 45 | $(if $(VBOX_WITH_NAT_SERVICE),VBOX_WITH_NAT_SERVICE) \
|
---|
| 46 | $(if $(VBOX_WITH_VMSVGA),VBOX_WITH_VMSVGA)
|
---|
| 47 |
|
---|
| 48 |
|
---|
[38416] | 49 | ifdef VBOX_WITH_DOCS
|
---|
| 50 | PROGRAMS += VBoxManageHelp
|
---|
| 51 | endif
|
---|
| 52 | VBoxManageHelp_TEMPLATE = VBoxAdvBldProg
|
---|
[49621] | 53 | VBoxManageHelp_DEFS += \
|
---|
| 54 | VBOX_ONLY_DOCS \
|
---|
[56465] | 55 | $(VBOX_COMMON_VBOXMANAGE_DEFS)
|
---|
[49621] | 56 | VBoxManageHelp_SOURCES = \
|
---|
[11703] | 57 | VBoxManage.cpp \
|
---|
[36630] | 58 | VBoxManageHelp.cpp \
|
---|
| 59 | $(if $(VBOX_WITH_GUEST_PROPS),VBoxManageGuestProp.cpp) \
|
---|
[32712] | 60 | $(if $(VBOX_WITH_GUEST_CONTROL),VBoxManageGuestCtrl.cpp)
|
---|
[38416] | 61 |
|
---|
| 62 | ifndef VBOX_ONLY_DOCS
|
---|
| 63 | PROGRAMS += VBoxManage
|
---|
[56344] | 64 | VBoxManage_TEMPLATE = VBOXMAINCLIENTEXE
|
---|
[56465] | 65 | VBoxManage_DEFS += $(VBOX_COMMON_VBOXMANAGE_DEFS)
|
---|
[56344] | 66 | VBoxManage_DEFS.win = _WIN32_WINNT=0x0500
|
---|
[68860] | 67 | VBoxManage_INCS = \
|
---|
| 68 | $(VBoxManage_0_OUTDIR)
|
---|
| 69 | VBoxManage_INTERMEDIATES = \
|
---|
| 70 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h
|
---|
[56344] | 71 | VBoxManage_SOURCES = \
|
---|
| 72 | VBoxManage.cpp \
|
---|
| 73 | VBoxInternalManage.cpp \
|
---|
| 74 | VBoxManageAppliance.cpp \
|
---|
| 75 | VBoxManageBandwidthControl.cpp \
|
---|
| 76 | VBoxManageControlVM.cpp \
|
---|
| 77 | VBoxManageDebugVM.cpp \
|
---|
| 78 | VBoxManageDHCPServer.cpp \
|
---|
| 79 | VBoxManageDisk.cpp \
|
---|
| 80 | $(if $(VBOX_WITH_GUEST_CONTROL),VBoxManageGuestCtrl.cpp) \
|
---|
| 81 | $(if $(VBOX_WITH_GUEST_CONTROL),VBoxManageGuestCtrlListener.cpp) \
|
---|
| 82 | $(if $(VBOX_WITH_GUEST_PROPS),VBoxManageGuestProp.cpp) \
|
---|
| 83 | VBoxManageHelp.cpp \
|
---|
[68860] | 84 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp \
|
---|
[56344] | 85 | VBoxManageHostonly.cpp \
|
---|
| 86 | VBoxManageInfo.cpp \
|
---|
| 87 | VBoxManageList.cpp \
|
---|
| 88 | VBoxManageMetrics.cpp \
|
---|
| 89 | VBoxManageMisc.cpp \
|
---|
| 90 | VBoxManageModifyVM.cpp \
|
---|
| 91 | VBoxManageSnapshot.cpp \
|
---|
| 92 | VBoxManageStorageController.cpp \
|
---|
| 93 | VBoxManageUSB.cpp \
|
---|
| 94 | $(if $(VBOX_WITH_NAT_SERVICE),VBoxManageNATNetwork.cpp,) \
|
---|
[77883] | 95 | $(if $(VBOX_WITH_NAT_SERVICE),../../NetworkServices/NetLib/VBoxNetPortForwardString.cpp,) \
|
---|
| 96 | VBoxManageCloud.cpp
|
---|
[56344] | 97 | VBoxManage_SOURCES.win = \
|
---|
| 98 | VBoxManage.rc
|
---|
| 99 | VBoxManage_LIBS += $(LIB_DDU)
|
---|
[32712] | 100 |
|
---|
[56344] | 101 | # VBoxNetPortForwardString.h
|
---|
| 102 | VBoxManageNATNetwork.cpp_INCS += ../../NetworkServices/NetLib/
|
---|
[45559] | 103 |
|
---|
[56344] | 104 | endif # VBOX_ONLY_DOCS
|
---|
| 105 |
|
---|
[11345] | 106 | ifneq ($(KBUILD_TARGET),win)
|
---|
| 107 | # Workaround for buggy gcc-4.3 compilers, see
|
---|
| 108 | #
|
---|
| 109 | # http://gcc.gnu.org/bugzilla/show_bug.cgi?id=36474
|
---|
| 110 | #
|
---|
| 111 | # Some later revisions of version 4.3.1 are known to work so we assume
|
---|
| 112 | # that version 4.3.2 or later has this bug definitely fixed.
|
---|
| 113 | VBoxManage_CXXFLAGS.release += \
|
---|
[13855] | 114 | $(if $(VBOX_GCC_VERSION_CXX),$(if-expr $(VBOX_GCC_VERSION_CXX) < 40300 || $(VBOX_GCC_VERSION_CXX) > 40301,,--param max-fields-for-field-sensitive=0),)
|
---|
[38416] | 115 | VBoxManageHelp_CXXFLAGS.release = $(VBoxManage_CXXFLAGS.release)
|
---|
[11345] | 116 | endif
|
---|
[1] | 117 |
|
---|
[68860] | 118 |
|
---|
| 119 | #
|
---|
| 120 | # VBoxManage built-in help from XML refentry in doc/manual/en_US/.
|
---|
| 121 | #
|
---|
| 122 | $(call KB_FN_DO_PASS0_ON_TARGET,VBoxManage)
|
---|
| 123 |
|
---|
| 124 | VBoxManage_CLEAN += \
|
---|
| 125 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp \
|
---|
| 126 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp.ts \
|
---|
| 127 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h \
|
---|
| 128 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h.ts \
|
---|
| 129 | $(addprefix $(VBoxManage_0_OUTDIR)/,$(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES)))
|
---|
| 130 |
|
---|
| 131 |
|
---|
| 132 |
|
---|
| 133 | # Preprocess the xml files, applying remarks.
|
---|
| 134 | $(foreach file,$(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES)) \
|
---|
[77353] | 135 | , $(evalcall2 def_vbox_refentry_preprocess_for_manpage,$(VBoxManage_0_OUTDIR),$(file),$(VBOX_PATH_MANUAL_SRC)/en_US/$(file),replace-xrefs))
|
---|
[68860] | 136 |
|
---|
| 137 |
|
---|
| 138 | # Generate the .cpp file.
|
---|
| 139 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp.ts \
|
---|
| 140 | +| $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp: \
|
---|
| 141 | $(VBOX_DOCBOOK_REFENTRY_TO_C_HELP) \
|
---|
| 142 | $(addprefix $(VBoxManage_0_OUTDIR)/,$(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES))) \
|
---|
| 143 | $(VBOX_XML_CATALOG) $(VBOX_XML_CATALOG_DOCBOOK) $(MAKEFILE) | $$(dir $$@)
|
---|
| 144 | $(call MSG_TOOL,xsltproc $(notdir $(firstword $(filter %.xsl,$^))),,$(filter %.xml,$^),$(patsubst %.ts,%,$@))
|
---|
| 145 | $(QUIET)$(APPEND) -tn "$@" \
|
---|
| 146 | '/* Autogenerated by $<, do not edit! */' \
|
---|
| 147 | '' \
|
---|
| 148 | '#include "VBoxManageBuiltInHelp.h"' \
|
---|
| 149 | ''
|
---|
| 150 | $(foreach refentry,$(filter %.xml,$^) \
|
---|
| 151 | ,$(NLTAB)$(QUIET)$(call VBOX_XSLTPROC_WITH_CAT, -a+to "$@") $< $(refentry))
|
---|
| 152 | $(QUIET)$(APPEND) -n "$@" \
|
---|
| 153 | '' \
|
---|
| 154 | 'PCRTMSGREFENTRY g_apHelpEntries[] = ' \
|
---|
| 155 | '{'
|
---|
| 156 | $(foreach refentry,$(filter %.xml,$^) \
|
---|
| 157 | ,$(NLTAB)$(QUIET)$(APPEND) -n "$@" \
|
---|
| 158 | ' &g_$(subst -,_,$(tolower $(patsubst man_%,%,$(notdir $(basename $(refentry)))))), ')
|
---|
| 159 | $(QUIET)$(APPEND) -n "$@" \
|
---|
| 160 | '};' \
|
---|
| 161 | 'const uint32_t g_cHelpEntries = RT_ELEMENTS(g_apHelpEntries);' \
|
---|
| 162 | ''
|
---|
| 163 | $(QUIET)$(CP) --changed -- "$@" "$(patsubst %.ts,%,$@)"
|
---|
| 164 | # The above APPEND stuff trigger some kind of problem on some boxes when not split up...
|
---|
| 165 | # update: Fixed in SVN (strcpy -> memmove in new_job(), job.c - r2591). Just need to rebuild all platforms.
|
---|
| 166 |
|
---|
| 167 |
|
---|
| 168 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h.ts \
|
---|
| 169 | +| $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h: \
|
---|
| 170 | $(VBOX_DOCBOOK_REFENTRY_TO_H_HELP) \
|
---|
| 171 | $(addprefix $(VBoxManage_0_OUTDIR)/,$(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES))) \
|
---|
| 172 | $(VBOX_XML_CATALOG) $(VBOX_XML_CATALOG_DOCBOOK) $(MAKEFILE) | $$(dir $$@)
|
---|
| 173 | $(call MSG_TOOL,xsltproc $(notdir $(firstword $(filter %.xsl,$^))),,$(filter %.xml,$^),$(patsubst %.ts,%,$@))
|
---|
| 174 | $(QUIET)$(APPEND) -tn "$@" \
|
---|
| 175 | '/* Autogenerated by $<, do not edit! */' \
|
---|
| 176 | '' \
|
---|
| 177 | '#ifndef ___VBoxManageBuiltInHelp_h___' \
|
---|
| 178 | '#define ___VBoxManageBuiltInHelp_h___' \
|
---|
| 179 | '' \
|
---|
| 180 | '#include <iprt/message.h>' \
|
---|
| 181 | '' \
|
---|
| 182 | 'RT_C_DECLS_BEGIN' \
|
---|
| 183 | '' \
|
---|
| 184 | 'typedef enum HELP_CMD_VBOXMANAGE' \
|
---|
| 185 | '{' \
|
---|
| 186 | ' HELP_CMD_VBOXMANAGE_INVALID = 0,'
|
---|
| 187 | $(foreach refentry,$(filter %.xml,$^) \
|
---|
| 188 | ,$(NLTAB)$(QUIET)$(call VBOX_XSLTPROC_WITH_CAT, -a+to "$@") \
|
---|
| 189 | --stringparam 'g_sMode' 'cmd' $< $(refentry))
|
---|
| 190 | $(QUIET)$(APPEND) -n "$@" \
|
---|
| 191 | ' HELP_CMD_VBOXMANAGE_END' \
|
---|
| 192 | '} HELP_CMD_VBOXMANAGE;'
|
---|
| 193 | $(foreach refentry,$(filter %.xml,$^) \
|
---|
| 194 | ,$(NLTAB)$(QUIET)$(call VBOX_XSLTPROC_WITH_CAT, -a+to "$@") \
|
---|
| 195 | --stringparam 'g_sMode' 'subcmd' $< $(refentry))
|
---|
| 196 | $(QUIET)$(APPEND) -n "$@" \
|
---|
| 197 | '' \
|
---|
| 198 | 'extern PCRTMSGREFENTRY g_apHelpEntries[];' \
|
---|
| 199 | 'extern const uint32_t g_cHelpEntries;' \
|
---|
| 200 | '' \
|
---|
| 201 | 'RT_C_DECLS_END' \
|
---|
| 202 | '' \
|
---|
| 203 | '#endif' \
|
---|
| 204 | ''
|
---|
| 205 | $(QUIET)$(CP) --changed -- "$@" "$(patsubst %.ts,%,$@)"
|
---|
| 206 |
|
---|
| 207 |
|
---|
[41477] | 208 | include $(FILE_KBUILD_SUB_FOOTER)
|
---|
[68860] | 209 |
|
---|