VirtualBox

source: vbox/trunk/src/VBox/Frontends/VBoxManage/Makefile.kmk@ 77910

Last change on this file since 77910 was 77883, checked in by vboxsync, 5 years ago

bugref:9404. Added two new commands for VBoxManage - one displays the list of cloud machine instances, second displays the list of cloud images. The generated documentation uses new style.
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 7.8 KB
Line 
1# $Id: Makefile.kmk 77883 2019-03-26 16:01:42Z vboxsync $
2## @file
3# Sub-Makefile for VBoxManage (the cli frontend).
4#
5
6#
7# Copyright (C) 2006-2019 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
21include $(PATH_ROOT)/doc/manual/Config.kmk
22
23
24VBOX_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) \
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) \
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) \
43 $(if $(VBOX_WITH_RECORDING),VBOX_WITH_RECORDING) \
44 $(if $(VBOX_WITH_AUDIO_RECORDING),VBOX_WITH_AUDIO_RECORDING) \
45 $(if $(VBOX_WITH_NAT_SERVICE),VBOX_WITH_NAT_SERVICE) \
46 $(if $(VBOX_WITH_VMSVGA),VBOX_WITH_VMSVGA)
47
48
49ifdef VBOX_WITH_DOCS
50 PROGRAMS += VBoxManageHelp
51endif
52VBoxManageHelp_TEMPLATE = VBoxAdvBldProg
53VBoxManageHelp_DEFS += \
54 VBOX_ONLY_DOCS \
55 $(VBOX_COMMON_VBOXMANAGE_DEFS)
56VBoxManageHelp_SOURCES = \
57 VBoxManage.cpp \
58 VBoxManageHelp.cpp \
59 $(if $(VBOX_WITH_GUEST_PROPS),VBoxManageGuestProp.cpp) \
60 $(if $(VBOX_WITH_GUEST_CONTROL),VBoxManageGuestCtrl.cpp)
61
62ifndef VBOX_ONLY_DOCS
63 PROGRAMS += VBoxManage
64 VBoxManage_TEMPLATE = VBOXMAINCLIENTEXE
65 VBoxManage_DEFS += $(VBOX_COMMON_VBOXMANAGE_DEFS)
66 VBoxManage_DEFS.win = _WIN32_WINNT=0x0500
67 VBoxManage_INCS = \
68 $(VBoxManage_0_OUTDIR)
69 VBoxManage_INTERMEDIATES = \
70 $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h
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 \
84 $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp \
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,) \
95 $(if $(VBOX_WITH_NAT_SERVICE),../../NetworkServices/NetLib/VBoxNetPortForwardString.cpp,) \
96 VBoxManageCloud.cpp
97 VBoxManage_SOURCES.win = \
98 VBoxManage.rc
99 VBoxManage_LIBS += $(LIB_DDU)
100
101 # VBoxNetPortForwardString.h
102 VBoxManageNATNetwork.cpp_INCS += ../../NetworkServices/NetLib/
103
104endif # VBOX_ONLY_DOCS
105
106ifneq ($(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 += \
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),)
115 VBoxManageHelp_CXXFLAGS.release = $(VBoxManage_CXXFLAGS.release)
116endif
117
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
124VBoxManage_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)) \
135, $(evalcall2 def_vbox_refentry_preprocess_for_manpage,$(VBoxManage_0_OUTDIR),$(file),$(VBOX_PATH_MANUAL_SRC)/en_US/$(file),replace-xrefs))
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
208include $(FILE_KBUILD_SUB_FOOTER)
209
Note: See TracBrowser for help on using the repository browser.

© 2023 Oracle
Contact – Privacy policy – Terms of Use