VirtualBox

source: vbox/trunk/src/VBox/Main/webservice/Makefile.kmk@ 108684

Last change on this file since 108684 was 108684, checked in by vboxsync, 6 weeks ago

Main/webservice: Find the gsoap binaries required to build vboxwebsrv on linux.arm64, bugref:10391

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 42.9 KB
Line 
1# $Id: Makefile.kmk 108684 2025-03-21 10:01:51Z vboxsync $
2## @file
3# Sub-Makefile for the VBox web service.
4#
5# Warning! This is a seriously complicated makefile!
6#
7
8#
9# Copyright (C) 2007-2024 Oracle and/or its affiliates.
10#
11# This file is part of VirtualBox base platform packages, as
12# available from https://www.virtualbox.org.
13#
14# This program is free software; you can redistribute it and/or
15# modify it under the terms of the GNU General Public License
16# as published by the Free Software Foundation, in version 3 of the
17# License.
18#
19# This program is distributed in the hope that it will be useful, but
20# WITHOUT ANY WARRANTY; without even the implied warranty of
21# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22# General Public License for more details.
23#
24# You should have received a copy of the GNU General Public License
25# along with this program; if not, see <https://www.gnu.org/licenses>.
26#
27# SPDX-License-Identifier: GPL-3.0-only
28#
29
30# Define VBOX_GSOAP_INSTALLED to something if you have gSOAP's
31# "wsdl2h" and "soapcpp2" executables on your PATH somewhere.
32
33#
34# Here's an overview how all this works. It's complicated. Essentially,
35# lots of files get generated automatically from our XML XIDL file that
36# describes the VirtualBox API (../idl/VirtualBox.xidl); as a result,
37# no manual coding is necessary when the API changes. All generated
38# web service code gets adjusted automatically.
39#
40# In more detail:
41#
42# 1) We use xsltproc and websrv-wsdl.xsl to generate a WSDL file from
43# our XML IDL file. WSDL (Web Service Description language) is an XML
44# industry standard that publicly describes a web service.
45# So, the WSDL generated here describes the VirtualBox web
46# service to third-party clients; for example, one can feed it to
47# Java or Perl or some other toolkit that understands WSDL and thus
48# easily write a short script that connects to the web service properly.
49# This WSDL file ends up in $(VBOXWEB_OUT_DIR)/vboxweb.wsdl.
50#
51# 2) We use xsltproc and websrv-wsdl2gsoapH.xsl to generate a so-called
52# "gSoap header file": $(VBOXWEB_OUT_DIR)/gsoapH_from_xslt.h from
53# the WSDL previously generated.
54# This file looks like a C header file, but really isn't meant
55# to be included by a C compiler. Instead, it just happens to be the
56# format that gSOAP uses to specify SOAP interfaces instead of WSDL.
57# (The reason for this appears to be that gSOAP predates WSDL and
58# thus needed some format to describe the syntax of a web service.)
59#
60# Note that gSOAP now also comes with its own WSDL-to-gsoap.h converter,
61# but the readme mentions some funny license restrictions, so instead we
62# have our own converter in XSLT.
63#
64# 3) We then feed that pseudo-header file to gSOAP's soapcpp2 compiler,
65# which generates a ton of files in $(VBOXWEB_OUT_DIR), most importantly:
66#
67# SOAP_CLIENT_H = $(VBOXWEB_OUT_DIR)/soapStub.h (header file for webservice clients)
68# SOAP_SERVER_H = $(VBOXWEB_OUT_DIR)/soapH.h (header file for webservice servers)
69#
70# These are "real" header files that one can use to program a) a webservice client
71# and b) a webservice server. Of course to build b) one will have to write method
72# implementations with useful code that does something. This is where more
73# code generation via XSLT comes in:
74#
75# 4) We use xsltproc to generate tons of C++ code directly from the XIDL that
76# maps each SOAP method to our COM methods. This large C++ file is
77# $(VBOXWEB_OUT_DIR)/methodmaps.cpp. The actual webservice executable (vboxwebsrv,
78# which acts as an HTTP server) is composed of this file, plus hard-coded
79# method implementations in vboxweb.cpp, plus gSOAP library code for the HTTP
80# server.
81#
82
83SUB_DEPTH = ../../../..
84include $(KBUILD_PATH)/subheader.kmk
85
86#
87# Find the gSOAP toolkit.
88#
89# Note! We're not using the gSOAP toolkit correctly. The main issue is that
90# compiling soapcpp2.cpp instead of using the library. So, in order
91# to make this work with a locally installed gSOAP toolkit there are
92# some hoops to jump thru to say the least... Shipping soapcpp2.cpp/h
93# is out of the question without also including the two soap tools.
94#
95# Some observations on distros for OSE / configure:
96# The proposed gentoo ebuild screws up several things in the install phase
97# and thus fails to ship stdsoap2.cpp and relatives.
98#
99# debian (2.7.9l-0.2) stuffs stdsoap2.cpp and a handful of the import files
100# into /usr/include/gsoap.
101#
102# fedora (2.7.12-fc10.x86_64) uses the default install layout and does not
103# ship stdsoap2.cpp and friends.
104#
105ifeq ($(VBOX_GSOAP_INSTALLED),)
106 VBOX_GSOAP_INSTALLED = 1
107 VBOX_PATH_GSOAP := $(firstfile $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS)/common/gsoap/*)))
108 ifeq ($(VBOX_PATH_GSOAP),)
109 VBOX_PATH_GSOAP := $(firstfile $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_HST)/gsoap/*)))
110 endif
111 if "$(VBOX_PATH_GSOAP)" == "" && defined(KBUILD_DEVTOOLS_HST)
112 VBOX_PATH_GSOAP := $(firstfile $(rversortfiles $(qwildcard ,$(KBUILD_DEVTOOLS_HST_ALT)/gsoap/*)))
113 endif
114 ifeq ($(VBOX_PATH_GSOAP),)
115 $(warning VBOX_PATH_GSOAP not found...)
116 VBOX_GSOAP_INSTALLED =
117 endif
118else
119 VBOX_PATH_GSOAP := $(VBOX_PATH_GSOAP)
120endif
121VBOX_PATH_GSOAP_BIN := $(strip $(VBOX_PATH_GSOAP_BIN))
122if "$(VBOX_PATH_GSOAP_BIN)" == ""
123 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP)/bin
124 if "$(KBUILD_HOST)" == "darwin"
125 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/macosx
126 else if "$(KBUILD_HOST)" == "win"
127 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/win32
128 else if "$(KBUILD_HOST).$(KBUILD_HOST_ARCH)" == "linux.arm64"
129 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/$(KBUILD_HOST).$(KBUILD_HOST_ARCH)
130 else
131 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/$(KBUILD_HOST).x86
132 endif
133 if !exists($(VBOX_PATH_GSOAP_BIN))
134 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP)/bin
135 endif
136endif
137VBOX_SOAPCPP2 := $(VBOX_PATH_GSOAP_BIN)/soapcpp2$(HOSTSUFF_EXE)
138VBOX_WSDL2H := $(VBOX_PATH_GSOAP_BIN)/wsdl2h$(HOSTSUFF_EXE)
139VBOX_STUBMAKER = $(firstword $(which stubmaker stubmaker.pl) stubmaker_not_found)
140# Keep in mind that Python ZSI only exists for Python 2.x, so this hardcodes
141# some things. If you want to build using Python 3.x only you need to disable
142# the creation of the Python webservice bindings anyway.
143if "$(KBUILD_HOST)" != "win"
144 VBOX_WSDL2PY = $(firstword $(which wsdl2py) wsdl2py_not_found)
145else
146 VBOX_WSDL2PY = $(firstword $(wildcard C:/Python27/Scripts/wsdl2py.exe) wsdl2py_not_found)
147endif
148
149VBOX_PATH_GSOAP_IMPORT := $(strip $(if $(VBOX_PATH_GSOAP_IMPORT),$(VBOX_PATH_GSOAP_IMPORT),$(VBOX_PATH_GSOAP)/import))
150VBOX_GSOAP_INCS := $(strip $(if $(VBOX_GSOAP_INCS),$(VBOX_GSOAP_INCS),$(VBOX_PATH_GSOAP) $(VBOX_PATH_GSOAP_IMPORT) ))
151# note: $(if $(defined FOO)) does not work here!
152VBOX_GSOAP_CXX_SOURCES := $(strip $(if-expr "$(origin VBOX_GSOAP_CXX_SOURCES)" != "undefined",$(VBOX_GSOAP_CXX_SOURCES),$(VBOX_PATH_GSOAP)/stdsoap2.cpp))
153VBOX_GSOAP_CXX_LIBS := $(strip $(if-expr "$(origin VBOX_GSOAP_CXX_LIBS)" != "undefined",$(VBOX_GSOAP_CXX_LIBS),))
154
155
156#
157# Globals
158#
159VBOXWEB_OUT_DIR := $(PATH_TARGET)/webservice
160BLDDIRS += $(VBOXWEB_OUT_DIR)
161
162# The webservice location
163VBOX_PATH_WEBSERVICE := $(PATH_SUB_CURRENT)
164
165# The IDL subdirectory (contains some XSLT files)
166VBOX_PATH_IDL := $(abspath $(PATH_SUB_CURRENT)/../idl)
167
168# If this is set, all webservice files are considered out-of-date every time
169# this makefile is touched. Otherwise, set this to empty.
170RECOMPILE_ON_MAKEFILE_CURRENT := $(MAKEFILE_CURRENT)
171
172PATH_TARGET_SOAPDEMOXML := $(VBOXWEB_OUT_DIR)/demo_soapxml
173PATH_TARGET_SOAPDEMOHEADERS := $(VBOXWEB_OUT_DIR)/demo_headers
174PATH_TARGET_SOAPDEMONSMAPS := $(VBOXWEB_OUT_DIR)/demo_namespacemaps
175PATH_TARGET_WEBTEST := $(VBOXWEB_OUT_DIR)/webtest
176
177# the original XIDL file (has to include documentation as we need it):
178VBOXWEB_IDL_SRC_ORIG := $(VBOX_XIDL_FILE_SRC)
179# the original XIDL file without documentation
180VBOXWEB_IDL_SRC_STRIPPED := $(VBOX_XIDL_FILE)
181# platform-specific XIDL file generated from $(VBOXWEB_IDL_SRC_STRIPPED):
182VBOXWEB_IDL_SRC := $(VBOXWEB_OUT_DIR)/VirtualBox.xidl
183
184VBOXWEB_WSDL = $(VBOXWEB_OUT_DIR)/vboxweb.wsdl
185VBOXWEBSERVICE_WSDL = $(VBOXWEB_OUT_DIR)/vboxwebService.wsdl
186
187VBOXWEB_TYPEMAP := $(VBOXWEB_OUT_DIR)/typemap.dat
188
189VBOXWEB_GSOAPH_FROM_XSLT := $(VBOXWEB_OUT_DIR)/gsoapH_from_xslt.h
190ifdef VBOX_GSOAP_INSTALLED
191 VBOXWEB_GSOAPH_FROM_GSOAP := $(VBOXWEB_OUT_DIR)/gsoapH_from_gsoap.h
192else
193 VBOXWEB_GSOAPH_FROM_GSOAP :=
194endif
195VBOXWEB_SOAP_CLIENT_H := $(VBOXWEB_OUT_DIR)/soapStub.h
196VBOXWEB_SOAP_SERVER_H := $(VBOXWEB_OUT_DIR)/soapH.h
197
198
199ifdef VBOX_GSOAP_VERBOSE
200 VBOXWEB_XSLTPROC_VERBOSE = --stringparam G_argDebug '1'
201 VBOXWEB_WSDL_VERBOSE = -v
202else
203 VBOXWEB_SOAPCPP2_SKIP_FILES = -x
204endif
205
206
207## @todo VBOXWEB_GSOAPH_FROM_XSLT should probably be a indirect dep of something.
208VBOXWEB_OTHERS += \
209 $(VBOXWEB_GSOAPH_FROM_XSLT)
210
211
212# GCC 9.2 doesn't cope ver well with the split soapC.cpp files (internal error).
213# Seemingly, the issue goes away when we strip inline functions from soapH.h.
214ifdef VBOX_WITHOUT_NOINLINE_SOAPH
215 if !defined(VBOX_WITHOUT_SPLIT_SOAPC) && !defined(VBOX_WITH_SPLIT_SOAPC) && $(VBOX_GCC_VERSION_CXX) >= 90200
216 $(info Triggering VBOX_WITHOUT_SPLIT_SOAPC because of VBOX_GCC_VERSION_CXX=$(VBOX_GCC_VERSION_CXX) and VBOX_WITHOUT_NOINLINE_SOAPH)
217 VBOX_WITHOUT_SPLIT_SOAPC := 1
218 endif
219endif
220
221#
222# Template that disables -fvisibility=hidden as the SOAP stuff does not
223# properly set the visibility attributes (or at least it didn't).
224#
225TEMPLATE_VBoxWebR3Exe = Webservices without -fvisibility=hidden
226TEMPLATE_VBoxWebR3Exe_EXTENDS = VBoxR3Exe
227TEMPLATE_VBoxWebR3Exe_DEFS.win += WIN32_LEAN_AND_MEAN $(TEMPLATE_VBoxR3Exe_DEFS.win) # Makes the redefinition warnings go away.
228ifn1of ($(KBUILD_TARGET), win)
229 TEMPLATE_VBoxWebR3Exe_CXXFLAGS = $(filter-out $(VBOX_GCC_fvisibility-hidden) $(VBOX_GCC_fvisibility-inlines-hidden), \
230 $(TEMPLATE_VBoxR3Exe_CXXFLAGS))
231 TEMPLATE_VBoxWebR3Exe_CXXFLAGS += $(VBOX_GCC_Wno-misleading-indentation)
232else if1of ($(KBUILD_TARGET_ARCH), arm64) # RTCsu blows up on arm64 with fatal error C1053: function too big (soapC-4.cpp).
233 TEMPLATE_VBoxWebR3Exe_PCHFLAGS.debug = $(filter-out -RTC%,$(TEMPLATE_VBoxR3Exe_PCHFLAGS.debug))
234 TEMPLATE_VBoxWebR3Exe_CXXFLAGS.debug = $(filter-out -RTC%,$(TEMPLATE_VBoxR3Exe_CXXFLAGS.debug))
235endif
236if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
237 # -wd4774: string(532): warning C4774: 'sprintf_s' : format string expected in argument 3 is not a string literal
238 # -wd4458: stdsoap2.h(2644): warning C4458: declaration of 'type' hides class member
239 # -wd5039: x509v3.h(883): warning C5039: 'OPENSSL_sk_set_cmp_func': pointer or reference to potentially throwing function passed to 'extern "C"' function under -EHc. Undefined behavior may occur if this function throws an exception.
240 # soapc-1.cpp(182) : warning C4883: 'soap_getelement': function size suppresses optimizations
241 TEMPLATE_VBoxWebR3Exe_CXXFLAGS.win = $(TEMPLATE_VBoxR3Exe_CXXFLAGS.win) -wd4774 -wd4458 -wd4883 -wd5039
242endif
243if "$(VBOX_VCC_TOOL_STEM)" >= "VCC143"
244 # -wd5267: soapStub.h(8118): warning C5267: definition of implicit assignment operator for 'vbox__IPCIDeviceAttachment' is deprecated because it has a user-provided destructor
245 TEMPLATE_VBoxWebR3Exe_CXXFLAGS.win += -wd5267
246endif
247
248ifdef VBOX_GSOAP_INSTALLED
249 ifndef VBOX_ONLY_SDK
250 #
251 # soapC and soapH-noinline file splitter.
252 #
253 BLDPROGS += split-soapC
254 split-soapC_TEMPLATE = VBoxBldProg
255 split-soapC_SOURCES = split-soapC.cpp
256
257 #
258 # vboxsoap - Library used by both the programs (save build time).
259 #
260 LIBRARIES += vboxsoap
261 vboxsoap_TEMPLATE = VBoxWebR3Exe
262 ifndef VBOX_WITHOUT_PRECOMPILED_HEADERS
263 ifeq ($(KBUILD_TARGET),win)
264 vboxsoap_USES = vccprecomp
265 vboxsoap_PCH_HDR := $(VBOXWEB_SOAP_SERVER_H)
266 vboxsoap_CXXFLAGS += -Zm127
267 endif
268 endif
269 vboxsoap_CXXFLAGS += $(VBOX_C_CXX_FLAGS_NO_UNUSED_PARAMETERS)
270 vboxsoap_CXXFLAGS.win += -bigobj
271 vboxsoap_CXXFLAGS.win += -wd4702 # soapc-4.cpp(16) : warning C4702: unreachable code
272 ifn1of ($(KBUILD_TARGET), win)
273 vboxsoap_CXXFLAGS += -Wno-shadow -Wno-parentheses $(VBOX_GCC_Wno-literal-suffix) \
274 $(VBOX_GCC_Wno-stringop-overflow) $(VBOX_GCC_Wno-stringop-truncation) \
275 $(VBOX_GCC_Wno-vla) -Wno-format -Wno-deprecated-declarations $(VBOX_GCC_fno-printf-return-value)
276 ifn1of ($(KBUILD_TYPE), debug) # Save time+memory by using -O0 instead of -O2.
277 vboxsoap_CXXFLAGS += -O0 ## @todo this could be interesting for g++ (not clang++): -fcprop-registers
278 endif
279 endif
280 vboxsoap_INCS := \
281 $(VBOX_GSOAP_INCS) \
282 $(VBOXWEB_OUT_DIR) \
283 $(PATH_SUB_CURRENT)
284 ifdef VBOX_WITH_WEBSERVICES_SSL
285 vboxsoap_DEFS += WITH_OPENSSL
286 vboxsoap_SDKS += VBoxOpenSsl
287 endif
288 ifdef VBOX_WITHOUT_SPLIT_SOAPC
289 vboxsoap_SOURCES = \
290 $(VBOXWEB_OUT_DIR)/soapC.cpp
291 else
292 vboxsoap_SOURCES = \
293 $(VBOXWEB_OUT_DIR)/soapC-1.cpp \
294 $(VBOXWEB_OUT_DIR)/soapC-2.cpp \
295 $(VBOXWEB_OUT_DIR)/soapC-3.cpp \
296 $(VBOXWEB_OUT_DIR)/soapC-4.cpp \
297 $(VBOXWEB_OUT_DIR)/soapC-5.cpp \
298 $(VBOXWEB_OUT_DIR)/soapC-6.cpp \
299 $(VBOXWEB_OUT_DIR)/soapC-7.cpp \
300 $(VBOXWEB_OUT_DIR)/soapC-8.cpp \
301 $(VBOXWEB_OUT_DIR)/soapC-9.cpp \
302 $(VBOXWEB_OUT_DIR)/soapC-10.cpp \
303 $(VBOXWEB_OUT_DIR)/soapC-11.cpp \
304 $(VBOXWEB_OUT_DIR)/soapC-12.cpp \
305 $(VBOXWEB_OUT_DIR)/soapC-13.cpp \
306 $(VBOXWEB_OUT_DIR)/soapC-14.cpp \
307 $(VBOXWEB_OUT_DIR)/soapC-15.cpp \
308 $(VBOXWEB_OUT_DIR)/soapC-16.cpp \
309 $(VBOXWEB_OUT_DIR)/soapC-17.cpp \
310 $(VBOXWEB_OUT_DIR)/soapC-18.cpp \
311 $(VBOXWEB_OUT_DIR)/soapC-19.cpp \
312 $(VBOXWEB_OUT_DIR)/soapC-20.cpp \
313 $(VBOXWEB_OUT_DIR)/soapC-21.cpp \
314 $(VBOXWEB_OUT_DIR)/soapC-22.cpp \
315 $(VBOXWEB_OUT_DIR)/soapC-23.cpp \
316 $(VBOXWEB_OUT_DIR)/soapC-24.cpp \
317 $(VBOXWEB_OUT_DIR)/soapC-25.cpp \
318 $(VBOXWEB_OUT_DIR)/soapC-26.cpp \
319 $(VBOXWEB_OUT_DIR)/soapC-27.cpp \
320 $(VBOXWEB_OUT_DIR)/soapC-28.cpp \
321 $(VBOXWEB_OUT_DIR)/soapC-29.cpp
322 endif
323 ifndef VBOX_WITHOUT_NOINLINE_SOAPH
324 vboxsoap_SOURCES += \
325 $(VBOXWEB_OUT_DIR)/soapH-noinline-1.cpp \
326 $(VBOXWEB_OUT_DIR)/soapH-noinline-2.cpp \
327 $(VBOXWEB_OUT_DIR)/soapH-noinline-3.cpp \
328 $(VBOXWEB_OUT_DIR)/soapH-noinline-4.cpp \
329 $(VBOXWEB_OUT_DIR)/soapH-noinline-5.cpp \
330 $(VBOXWEB_OUT_DIR)/soapH-noinline-6.cpp \
331 $(VBOXWEB_OUT_DIR)/soapH-noinline-7.cpp \
332 $(VBOXWEB_OUT_DIR)/soapH-noinline-8.cpp \
333 $(VBOXWEB_OUT_DIR)/soapH-noinline-9.cpp \
334 $(VBOXWEB_OUT_DIR)/soapH-noinline-10.cpp \
335 $(VBOXWEB_OUT_DIR)/soapH-noinline-11.cpp \
336 $(VBOXWEB_OUT_DIR)/soapH-noinline-12.cpp
337 endif
338 vboxsoap_CLEAN := $(vboxsoap_SOURCES) # lazy bird
339 vboxsoap_SOURCES <= \
340 $(VBOX_GSOAP_CXX_SOURCES)
341 vboxsoap_ORDERDEPS = \
342 $(VBOXWEB_IDL_SRC) \
343 $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
344 ifn1of ($(KBUILD_TARGET), win)
345 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS = \
346 -Wno-format \
347 $(VBOX_GCC_Wno-int-in-bool-context) \
348 $(VBOX_GCC_Wno-logical-op)
349 # currently necessary when compiling against OpenSSL 1.0 due to a missing
350 # typecase from 'const v3_ext_method*' to 'aka v3_ext_method*'.
351 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS += -fpermissive
352 # Necessary with gcc 9.2.1 for some reason:
353 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS += -Wno-deprecated-declarations
354 endif
355
356 if "$(KBUILD_TARGET)" == "win" && "$(VBOX_GSOAP_CXX_SOURCES)" != ""
357 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS.win += -wd4668 # preprocessor / windows.h
358 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS.win += -wd4211 # nonstandard extension used: redefined extern to static
359 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS.win += -wd4310 # cast truncates constant value
360 if1of ($(VBOX_VCC_TOOL_STEM), VCC120)
361 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS.win += -wd4056 # v2.8.36/stdsoap2.cpp(14008) : warning C4056: overflow in floating-point constant arithmetic
362 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS.win += -wd4756 # v2.8.36/stdsoap2.cpp(14008) : warning C4756: overflow in constant arithmetic
363 endif
364 if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
365 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS.win += -wd4456 # stdsoap2.cpp(3127): warning C4456: declaration of 'i' hides previous local declaration
366 endif
367 endif
368
369 ifdef VBOX_SOAP_PRECOMPILED_HEADER
370 # This'll save a few seconds, but the compiler invocation currently makes it impracticable. This will
371 # be addressed in a future kBuild version, by adding PCH support or/and by adding some helpers to
372 # gather the required data (DEFS,INCS,CXXTOOL,CXXFLAGS).
373 vboxsoap_INTERMEDIATES += $(VBOXWEB_OUT_DIR)/soapH.h.gch
374 vboxsoap_CXXFLAGS += -Winvalid-pch -H
375 vboxsoap_CLEAN += $(VBOXWEB_OUT_DIR)/soapH.h.gch
376
377 $(VBOXWEB_OUT_DIR)/soapH.h.gch: $(VBOXWEB_OUT_DIR)/soapH.h
378 g++ -x c++-header -g -g -Wall -pedantic -Wno-long-long -Wno-trigraphs -Wno-variadic-macros -pipe -O0 -fno-omit-frame-pointer \
379 -fno-strict-aliasing -fvisibility-inlines-hidden -fvisibility=hidden -DVBOX_HAVE_VISIBILITY_HIDDEN \
380 -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk -m32 \
381 -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/src/VBox/Main/webservice/gsoap \
382 -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/out/darwin.x86/debug/obj/src/VBox/Main \
383 -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/src/VBox/Main/webservice \
384 -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/include -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/out/darwin.x86/debug
385 \-DVBOX -DVBOX_WITH_DEBUGGER -DVBOX_WITH_DEBUGGER_GUI -DDEBUG -DDEBUG_bird -DDEBUG_USERNAME=bird -DRT_OS_DARWIN \
386 -D__DARWIN__ -DRT_ARCH_X86 -D__X86__ -DVBOX_WITH_HYBRID_32BIT_KERNEL -DIN_RING3 -DHC_ARCH_BITS=32 -DGC_ARCH_BITS=32 \
387 -DMAC_OS_X_VERSION_MIN_REQUIRED=1040 -DMAC_OS_X_VERSION_MAX_ALLOWED=1040 \
388 $< -o $@
389 endif
390
391 # Tweak for systems with too many CPUs compared to memory.
392 ifdef VBOX_WITH_SOAP_NOT_PARALLEL
393 .NOTPARALLEL: $$(vboxsoap_2_OBJS)
394 endif
395 endif # !VBOX_ONLY_SDK
396
397
398 ifndef VBOX_ONLY_SDK
399 #
400 # vboxwebsrv - webservice server process
401 #
402 PROGRAMS += vboxwebsrv
403 vboxwebsrv_TEMPLATE = VBoxMainClientExe
404 vboxwebsrv_DEFS += SOCKET_CLOSE_ON_EXEC
405 vboxwebsrv_DEFS.win += WIN32_LEAN_AND_MEAN
406 vboxwebsrv_INCS = \
407 $(VBOX_GSOAP_INCS) \
408 $(VBOXWEB_OUT_DIR) \
409 .
410 vboxwebsrv_CXXFLAGS.win += -bigobj
411 if "$(VBOX_VCC_TOOL_STEM)" >= "VCC140"
412 vboxwebsrv_CXXFLAGS.win += -wd4774 # string(532): warning C4774: 'sprintf_s' : format string expected in argument 3 is not a string literal
413 vboxwebsrv_CXXFLAGS.win += -wd4458 # stdsoap2.h(2644): warning C4458: declaration of 'type' hides class member
414 vboxwebsrv_CXXFLAGS.win += -wd5039 # x509v3.h(883): warning C5039: 'OPENSSL_sk_set_cmp_func': pointer or reference to potentially throwing function passed to 'extern "C"' function under -EHc. Undefined behavior may occur if this function throws an exception.
415 endif
416 ifn1of ($(KBUILD_TARGET), win)
417 vboxwebsrv_CXXFLAGS += -Wno-shadow $(VBOX_GCC_Wno-literal-suffix) $(VBOX_GCC_Wno-misleading-indentation)
418 ifn1of ($(KBUILD_TYPE), debug) # Save time+memory by using -O1 instead of -O2.
419 vboxwebsrv_CXXFLAGS += -O0
420 endif
421 endif
422 vboxwebsrv_LIBS += \
423 $(PATH_STAGE_LIB)/vboxsoap$(VBOX_SUFF_LIB) \
424 $(VBOX_GSOAP_CXX_LIBS) \
425 $(LIB_RUNTIME)
426 vboxwebsrv_LIBS.solaris += socket nsl
427 ifdef VBOX_WITH_WEBSERVICES_SSL
428 vboxwebsrv_DEFS += WITH_OPENSSL
429 vboxwebsrv_SDKS += VBoxOpenSsl
430 endif
431 vboxwebsrv_SOURCES = \
432 vboxweb.cpp \
433 $(VBOXWEB_OUT_DIR)/methodmaps.cpp \
434 $(VBOXWEB_OUT_DIR)/soapServer.cpp \
435 $(VBOXWEB_OUT_DIR)/vboxweb-wsdl.c
436 vboxwebsrv_SOURCES.win = \
437 VBoxWebSrv.rc
438 vboxwebsrv_CLEAN = \
439 $(VBOXWEB_OUT_DIR)/methodmaps.cpp \
440 $(VBOXWEB_OUT_DIR)/soapServer.cpp \
441 $(VBOXWEB_OUT_DIR)/vboxweb-wsdl.c
442 vboxwebsrv_ORDERDEPS = $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
443 endif # !VBOX_ONLY_SDK
444
445 ifdef VBOX_WITH_JWS
446 INSTALLS += VBoxJWs-inst-jar
447
448 #
449 # Java glue JAR files
450 #
451 VBOX_JWS_JAR = $(VBoxJWs-inst-jar_0_OUTDIR)/vboxjws.jar
452 VBOX_JWSDOC_JAR = $(VBoxJWs-inst-jar_0_OUTDIR)/vboxjws-doc.jar
453 VBOX_JWSSRC_JAR = $(VBoxJWs-inst-jar_0_OUTDIR)/vboxjws-src.jar
454 VBOX_JWS_TARGET := $(PATH_TARGET)/vboxjws-gen
455 VBOX_JWS_GEN = $(VBOX_JWS_TARGET)/jwsgen
456 VBOX_JWS_GEN_RAWSRC = $(VBOX_JWS_GEN)/merged.file
457 VBOX_JWS_JDEST := $(VBOX_JWS_TARGET)/jdest
458 VBOX_JWSDOC_JDEST := $(VBOX_JWS_TARGET)/jdest-doc
459 VBOX_GLUE_XSLT_DIR := $(PATH_ROOT)/src/VBox/Main/glue
460 VBOX_JAXLIB_DIR := $(PATH_ROOT)/src/VBox/Main/webservice/jaxlibs
461
462 VBoxJWs-inst-jar_INST = $(INST_SDK)bindings/webservice/java/jax-ws/
463 VBoxJWs-inst-jar_MODE = a+r,u+w
464 VBoxJWs-inst-jar_SOURCES = \
465 $(VBOX_JWS_JAR) \
466 $(VBOX_JWSDOC_JAR) \
467 $(VBOX_JWSSRC_JAR)
468 VBoxJWs-inst-jar_CLEAN = \
469 $(VBOX_JWS_JAR) \
470 $(VBOX_JWSDOC_JAR) \
471 $(VBOX_JWSSRC_JAR) \
472 $(VBOX_JWS_GEN)/jwsglue.list \
473 $(VBOX_JWSDOC_JDEST)/package-list \
474 $(wildcard \
475 $(VBOX_JWS_GEN)/java/*/*/*.java \
476 $(VBOX_JWS_GEN)/java/*/*/*/*.java \
477 $(VBOX_JWS_JDEST)/*.class \
478 $(VBOX_JWS_JDEST)/*/*.class \
479 $(VBOX_JWS_JDEST)/*/*/*.class \
480 $(VBOX_JWS_JDEST)/*/*/*/*.class \
481 $(VBOX_JWSDOC_JDEST)/*.html \
482 $(VBOX_JWSDOC_JDEST)/*.css \
483 $(VBOX_JWSDOC_JDEST)/*/*.gif \
484 $(VBOX_JWSDOC_JDEST)/*/*/*.html \
485 $(VBOX_JWSDOC_JDEST)/*/*/*/*.html \
486 )
487 VBoxJWs-inst-jar_BLDDIRS += $(VBOX_JWS_GEN)/java
488 VBoxJWs-inst-jar_GENERATEDSOURCES = $(addprefix $(VBoxJWs-inst-jar_BLDDIRS)/,$(VBoxJWS_VBOX_JWSGLUEFILES))
489
490 VBoxJWSGlue_KMK = $(PATH_OUT)/vboxjwsglue.kmk
491 include $(VBoxJWSGlue_KMK)
492
493 $(VBoxJWSGlue_KMK).ts +| $(VBoxJWSGlue_KMK): $(VBOXWEB_IDL_SRC_ORIG) $(VBOX_GLUE_XSLT_DIR)/glue-java.xsl $(VBOX_VERSION_STAMP)
494 $(call MSG_GENERATE,,$(VBoxJWSGlue_KMK))
495 $(QUIET)$(RM) -f $@
496 $(QUIET)$(MKDIR) -p $(@D)
497 $(QUIET)$(VBOX_XSLTPROC) \
498 --stringparam filelistonly VBoxJWS_VBOX_JWSGLUEFILES \
499 --stringparam G_vboxApiSuffix $(VBOX_API_SUFFIX) \
500 --stringparam G_vboxGlueStyle jaxws \
501 --stringparam G_vboxDirPrefix org/virtualbox$(VBOX_API_SUFFIX)/ \
502 --stringparam g_uVBoxCopyrightYear "$(VBOX_C_YEAR)" \
503 -o $@ $(VBOX_GLUE_XSLT_DIR)/glue-java.xsl $<
504 $(QUIET)$(CP) --changed -fv $@ $(VBoxJWSGlue_KMK)
505
506 $(VBOX_JWS_GEN_RAWSRC) \
507 +| $(VBoxJWs-inst-jar_GENERATEDSOURCES): \
508 $(VBOXWEB_IDL_SRC_ORIG) \
509 $(VBOX_GLUE_XSLT_DIR)/glue-java.xsl \
510 $(VBOX_FILESPLIT) \
511 $(VBOX_VERSION_STAMP)
512 $(call MSG_L1,Generating JAX-WS Java glue files from XIDL)
513 $(QUIET)$(RM) -f $(filter-out $(VBoxJWs-inst-jar_GENERATEDSOURCES),$(wildcard $(VBOX_JWS_GEN)/java/*/*/*.java))
514 $(QUIET)$(MKDIR) -p $(@D)
515 $(QUIET)$(VBOX_XSLTPROC) \
516 --stringparam filelistonly "" \
517 --stringparam G_vboxApiSuffix $(VBOX_API_SUFFIX) \
518 --stringparam G_vboxGlueStyle jaxws \
519 --stringparam G_vboxDirPrefix org/virtualbox$(VBOX_API_SUFFIX)/ \
520 --stringparam g_uVBoxCopyrightYear "$(VBOX_C_YEAR)" \
521 -o $(VBOX_JWS_GEN_RAWSRC) $(VBOX_GLUE_XSLT_DIR)/glue-java.xsl $<
522 $(QUIET)$(MKDIR) -p $(VBOX_JWS_GEN)/java/org/virtualbox$(VBOX_API_SUFFIX)
523 $(QUIET)$(VBOX_FILESPLIT) $(VBOX_JWS_GEN_RAWSRC) $(VBOX_JWS_GEN)/java
524
525 ## @todo somehow also find out the authoritative list of files generated by
526 # wsimport (before running it), then we could rely on proper dependencies
527 # instead of creating jwsglue.list. Would allow avoiding a lot of unnecessary
528 # compilation with incremental builds, when almost nothing changed in the IDL
529 # file. Currently everything is recompiled if only one file is changed.
530 $(VBOX_JWS_GEN)/jwsglue.list.ts +| $(VBOX_JWS_GEN)/jwsglue.list: \
531 $(VBOXWEB_IDL_SRC) \
532 $(VBOX_FILESPLIT) \
533 $(VBOXWEBSERVICE_WSDL) \
534 $(VBOXWEB_WSDL) \
535 $(VBoxJWs-inst-jar_GENERATEDSOURCES) \
536 | $(VBOX_JWS_GEN)/java/
537 $(QUIET)$(RM) -f -- $(wildcard $(VBOX_JWS_GEN)/java/*/*/*/*.java)
538 $(call MSG_GENERATE,,$(VBOX_JWS_GEN)/jwsglue.list,JAX-WS for Java 1.6 bindings using $(VBOXWEBSERVICE_WSDL))
539 $(VBOX_WSIMPORT) -Xnocompile -p $(VBOX_JAVA_PACKAGE).jaxws -d $(VBOX_JWS_GEN)/java $(VBOXWEBSERVICE_WSDL)
540 $(QUIET)echo $(VBoxJWs-inst-jar_GENERATEDSOURCES) > $@
541 $(QUIET)echo $(VBOX_JWS_GEN)/java/*/*/*/*.java >> $@
542 $(QUIET)$(CP) --changed -fv $@ $(VBOX_JWS_GEN)/jwsglue.list
543
544 $$(VBOX_JWS_JAR): $(VBOX_JWS_GEN)/jwsglue.list $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL) $(VBOX_JWS_GEN)/MANIFEST.MF | $$(dir $$@)
545 $(call MSG_TOOL,javac,$(notdir $@),jwsgen.list,)
546 $(QUIET)$(RM) -Rf $(VBOX_JWS_JDEST)
547 $(QUIET)$(MKDIR) -p $(VBOX_JWS_JDEST)
548 $(call MSG_L1,Compiling bridge code)
549 $(VBOX_JAVAC) $(VBOX_JAVAC_OPTS) $(VBOX_JAVA_WS_OPTS) \
550 @$(VBOX_JWS_GEN)/jwsglue.list \
551 -d $(VBOX_JWS_JDEST) -classpath $(VBOX_JWS_JDEST)$(VBOX_SEP)$(VBOX_JAVA_WS_EXTRA_JARS)
552 $(QUIET)$(SED) -e "s/vboxweb.wsdl/vboxweb$(VBOX_API_SUFFIX).wsdl/" < $(VBOXWEBSERVICE_WSDL) > $(VBOX_JWS_JDEST)/vboxwebService$(VBOX_API_SUFFIX).wsdl
553 $(QUIET)$(CP) -f $(VBOXWEB_WSDL) $(VBOX_JWS_JDEST)/vboxweb$(VBOX_API_SUFFIX).wsdl
554 $(call MSG_LINK,$(notdir $@),$@)
555 $(VBOX_JAR) cfm $@ $(VBOX_JWS_GEN)/MANIFEST.MF -C $(VBOX_JWS_JDEST) .
556
557 $(VBOX_JWS_GEN)/MANIFEST.MF: $(VBOX_PATH_WEBSERVICE)/MANIFEST.MF.in
558 $(QUIET)$(RM) -f -- $@
559 $(QUIET)$(MKDIR) -p $(VBOX_JWS_GEN)
560 $(QUIET)$(SED) \
561 -e 's/@VBOX_VERSION_STRING@/$(VBOX_VERSION_STRING)/' \
562 -e 's/@VBOX_VERSION_MAJOR@/$(VBOX_VERSION_MAJOR)/' \
563 -e 's/@VBOX_VERSION_MINOR@/$(VBOX_VERSION_MINOR)/' \
564 -e 's/@VBOX_API_SUFFIX@/$(VBOX_API_SUFFIX)/' \
565 < $< > $@
566
567 $$(VBOX_JWSDOC_JAR): $(VBOX_JWS_GEN)/jwsglue.list $$(VBoxJWs-inst-jar_GENERATEDSOURCES) $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL) $$(VBOX_JWS_JAR) | $$(dir $$@)
568 $(call MSG_TOOL,javadoc,$(notdir $@),jwsgen.list,)
569 $(QUIET)$(RM) -Rf $(VBOX_JWSDOC_JDEST)
570 $(QUIET)$(MKDIR) -p $(VBOX_JWSDOC_JDEST)
571 $(call MSG_L1,Generating javadoc html documentation)
572 $(VBOX_JAVADOC) $(VBOX_JAVADOC_OPTS) $(VBOX_JAVA_WS_OPTS) -quiet \
573 -sourcepath $(VBOX_JWS_GEN)/java org.virtualbox$(VBOX_API_SUFFIX) \
574 -d $(VBOX_JWSDOC_JDEST) -classpath $(VBOX_SEP)$(VBOX_JAVA_WS_EXTRA_JARS)
575 $(call MSG_LINK,$(notdir $@),$@)
576 $(VBOX_JAR) cf $@ -C $(VBOX_JWSDOC_JDEST) .
577
578 $$(VBOX_JWSSRC_JAR): $$(VBOX_JWS_JAR) | $$(dir $$@)
579 $(call MSG_LINK,$(notdir $@),$@)
580 $(VBOX_JAR) cf $@ -C $(VBOX_JWS_GEN)/java .
581
582 ## @todo compile ../glue/tests/TestVBox.java to have sanity checking
583
584 endif # VBOX_WITH_JWS
585
586 ifndef VBOX_ONLY_SDK
587 #
588 # webtest - webservice sample client in C++
589 #
590 PROGRAMS += webtest
591 webtest_TEMPLATE = VBoxWebR3Exe
592 webtest_CXXFLAGS.win += -bigobj
593 ifn1of ($(KBUILD_TARGET), win)
594 webtest_CXXFLAGS += -Wno-shadow
595 endif
596 webtest_INCS := \
597 $(VBOX_GSOAP_INCS) \
598 $(VBOXWEB_OUT_DIR) \
599 .
600 webtest_LIBS += \
601 $(PATH_STAGE_LIB)/vboxsoap$(VBOX_SUFF_LIB) \
602 $(VBOX_GSOAP_CXX_LIBS) \
603 $(LIB_RUNTIME)
604 webtest_LIBS.solaris += nsl
605 ifdef VBOX_WITH_WEBSERVICES_SSL
606 webtest_DEFS += WITH_OPENSSL
607 webtest_SDKS += VBoxOpenSsl
608 endif
609 webtest_SOURCES = \
610 webtest.cpp \
611 $(VBOXWEB_OUT_DIR)/soapClient.cpp
612 webtest_CLEAN = \
613 $(VBOXWEB_OUT_DIR)/soapClient.cpp
614
615 webtest_ORDERDEPS = $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
616 endif # !VBOX_ONLY_SDK
617
618
619 #
620 # Additional mess to cleanup (applies to both webtest and vboxwebsrv).
621 #
622 ## @todo figure out whether the SDK really needs this or not...
623 OTHER_CLEAN += \
624 $(wildcard $(VBOXWEB_OUT_DIR)/soap*.h) \
625 $(wildcard $(VBOXWEB_OUT_DIR)/soap*.cpp) \
626 $(wildcard $(VBOXWEB_OUT_DIR)/*.nsmap) \
627 $(VBOXWEB_GSOAPH_FROM_XSLT) \
628 $(VBOXWEB_GSOAPH_FROM_GSOAP) \
629 $(VBOXWEB_SOAP_CLIENT_H) \
630 $(VBOXWEB_SOAP_SERVER_H) \
631 $(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts \
632 $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts \
633 $(wildcard $(PATH_TARGET_SOAPDEMOXML)/*) \
634 $(PATH_TARGET_SOAPDEMOXML)/dummy_file \
635 $(wildcard $(PATH_TARGET_SOAPDEMOHEADERS)/*) \
636 $(PATH_TARGET_SOAPDEMOHEADERS)/dummy_file \
637 $(wildcard $(PATH_TARGET_SOAPDEMONSMAPS)/*) \
638 $(PATH_TARGET_SOAPDEMONSMAPS)/dummy_file
639
640endif # VBOX_GSOAP_INSTALLED
641
642
643if defined(VBOX_ONLY_SDK) && ("$(KBUILD_TARGET)" != "win" || defined(VBOX_FORCE_SDK))
644 #
645 # Globals relevant to the SDK.
646 #
647 VBOXWEB_GLUE_PYTHON = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_wrappers.py
648 # The following 3 files are generated by Python ZSI 2.1_a1 (alpha version
649 # shipped by many Linux distributions). Only the first two are actually used.
650 # The 4th and 5th file is created by ZSI 2.0 (released in 2007), and gets
651 # renamed to the 1st/2nd file for simplicity reasons.
652 # ZSI 1.x used different file names. Not worth supporting any more. If you're
653 # curious, check the VirtualBox 4.3 sources.
654 VBOXWEB_WS_PYTHON = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_client.py
655 VBOXWEB_WS_PYTHON_TYPES = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_types.py
656 VBOXWEB_WS_PYTHON_SERVER = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_server.py
657 VBOXWEB_WS_PYTHON_ALTERNATIVE = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_services.py
658 VBOXWEB_WS_PERL = $(VBOX_PATH_SDK)/bindings/webservice/perl/lib/vboxService.pm
659 VBOXWEB_WS_PHP = $(VBOX_PATH_SDK)/bindings/webservice/php/lib/vboxServiceWrappers.php
660 VBOXWEB_SAMPLES_JAXWS_DIR = $(VBOX_PATH_SDK)/bindings/webservice/java/jax-ws/samples
661 VBOXWEB_JAXWSSAMPLE = $(VBOXWEB_SAMPLES_JAXWS_DIR)/clienttest.java
662 VBOXWEB_METRICSAMPLE = $(VBOXWEB_SAMPLES_JAXWS_DIR)/metrictest.java
663
664 VBOXWEB_OTHERS += \
665 $(if $(VBOX_WITH_PYTHON),$(VBOXWEB_GLUE_PYTHON),) \
666 $(if $(VBOX_WITH_PYTHON),$(VBOXWEB_WS_PYTHON),) \
667 $(if $(VBOX_WITH_PYTHON),$(VBOXWEB_WS_PYTHON_TYPES),) \
668 $(if $(VBOX_WITH_PERL),$(VBOXWEB_WS_PERL),) \
669 $(if $(VBOX_WITH_PHP),$(VBOXWEB_WS_PHP),)
670
671
672 #
673 # Install sample code.
674 #
675 INSTALLS += vboxwebinst
676 vboxwebinst_INST = $(INST_SDK)bindings/webservice/
677 vboxwebinst_MODE = a+rx,u+w
678 vboxwebinst_SOURCES = \
679 $(if $(VBOX_WITH_PERL),samples/perl/clienttest.pl=>perl/samples/clienttest.pl,) \
680 $(if $(VBOX_WITH_PHP),samples/php/clienttest.php=>php/samples/clienttest.php,) \
681 $(if $(VBOX_WITH_PYTHON),samples/python/clienttest.py=>python/samples/clienttest.py,)
682
683 INSTALLS += vboxwebinst_nox
684 vboxwebinst_nox_INST = $(INST_SDK)bindings/webservice/
685 vboxwebinst_nox_MODE = a+r,u+w
686 vboxwebinst_nox_SOURCES = \
687 $(if $(VBOX_WITH_PYTHON),samples/python/Makefile=>python/samples/Makefile,) \
688 $(if $(VBOX_WITH_PYTHON),samples/python/Makefile.glue=>python/lib/Makefile,) \
689 $(if ($VBOX_WITH_JWS),$(PATH_ROOT)/COPYING.LIB=>java/jax-ws/COPYING.LIB,)
690
691 INSTALLS += vboxwebinst_wsdl
692 vboxwebinst_wsdl_INST = $(INST_SDK)bindings/webservice/
693 vboxwebinst_wsdl_MODE = a+r,u+w
694 vboxwebinst_wsdl_SOURCES = \
695 $(VBOXWEB_WSDL)=>vboxweb.wsdl \
696 $(VBOXWEBSERVICE_WSDL)=>vboxwebService.wsdl
697
698 INSTALLS += vboxwebinst_webtest
699 vboxwebinst_webtest_INST = $(INST_SDK)bindings/webservice/
700 vboxwebinst_webtest_MODE = a+r,u+w
701 vboxwebinst_webtest_SOURCES = \
702 $(VBOX_PATH_WEBSERVICE)/websrv-wsdl2gsoapH.xsl=>xsl/websrv-wsdl2gsoapH.xsl \
703 $(VBOX_PATH_WEBSERVICE)/websrv-nsmap.xsl=>xsl/websrv-nsmap.xsl \
704 $(VBOX_PATH_IDL)/typemap-shared.inc.xsl=>idl/typemap-shared.inc.xsl \
705 $(VBOX_PATH_WEBSERVICE)/split-soapC.cpp=>tools/split-soapC.cpp \
706 $(VBOX_PATH_WEBSERVICE)/webtest.cpp=>cpp/samples/webtest/webtest.cpp \
707 $(VBOX_PATH_WEBSERVICE)/Makefile.webtest=>cpp/samples/webtest/Makefile
708
709endif # VBOX_ONLY_SDK
710
711#
712# Update the OTHERS and OTHER_CLEAN lists with VBOXWEB_OTHERS and some more stuff.
713#
714# We can't just built up OTHERS and append it to OTHER_CLEAN because we're sharing
715# OTHERS with all the other VBox makefiles, thus VBOXWEB_OTHERS.
716#
717OTHERS += $(VBOXWEB_OTHERS)
718OTHER_CLEAN += \
719 $(VBOXWEB_OTHERS) \
720 $(if $(VBOX_WITH_PYTHON),$(VBOXWEB_WS_PYTHON_SERVER),) \
721 $(VBOXWEB_WSDL) \
722 $(VBOXWEBSERVICE_WSDL) \
723 $(VBOXWEB_TYPEMAP) \
724 $(VBOXWEB_IDL_SRC)
725
726# generate platform-specific XIDL file from original XIDL file
727$(VBOXWEB_IDL_SRC): $(VBOXWEB_IDL_SRC_STRIPPED) $(VBOX_PATH_WEBSERVICE)/platform-xidl.xsl | $$(dir $$@)
728 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using platform-xidl.xsl)
729 $(QUIET)$(RM) -f -- $@
730 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/platform-xidl.xsl $<
731
732# generate WSDL from main XIDL file
733$(VBOXWEB_WSDL): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-wsdl.xsl $(VBOX_PATH_IDL)/typemap-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
734 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-wsdl.xsl)
735 $(QUIET)$(RM) -f -- $@
736 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl.xsl $<
737
738$(VBOXWEBSERVICE_WSDL): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-wsdl-service.xsl $(VBOX_PATH_IDL)/typemap-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
739 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-wsdl-service.xsl)
740 $(QUIET)$(RM) -f -- $@
741 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl-service.xsl $<
742
743ifdef VBOX_ONLY_SDK
744
745 $(VBOXWEB_GLUE_PYTHON): $(VBOXWEB_IDL_SRC) $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL) $(VBOX_PATH_WEBSERVICE)/websrv-python.xsl
746 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-python.xsl)
747 $(QUIET)$(RM) -f -- $@
748 $(QUIET)$(MKDIR) -p $(@D)
749 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) \
750 --stringparam g_uVBoxCopyrightYear "$(VBOX_C_YEAR)" \
751 -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-python.xsl $<
752
753 $(VBOXWEB_WS_PYTHON) \
754 + $(VBOXWEB_WS_PYTHON_TYPES): $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL)
755 $(call MSG_GENERATE,,$@, WS Python bindings)
756 $(QUIET)$(RM) -f -- $@
757 $(QUIET)$(MKDIR) -p $(@D)
758 # Change directory to the "source", as otherwise ZSI 2.0 has trouble finding
759 # the 2nd WSDL file included in the main one. ZSI 2.1 is smarter, but some
760 # versions floating around (especially on Linux) lack the --file option.
761 if "$(KBUILD_HOST)" != "win"
762 $(QUIET)$(REDIRECT) -C $(dir $(VBOXWEBSERVICE_WSDL)) -- $(SHELL) -c "$(VBOX_WSDL2PY) -b --output-dir $(@D) $(VBOXWEBSERVICE_WSDL) || $(VBOX_WSDL2PY) -b --file $(VBOXWEBSERVICE_WSDL) --output-dir $(@D)"
763 else
764 $(QUIET)$(REDIRECT) -C $(dir $(VBOXWEBSERVICE_WSDL)) -- $(VBOX_WSDL2PY) -b --file $(subst /,\\\\,$(VBOXWEBSERVICE_WSDL)) --output-dir $(@D)
765 endif
766 # Hack: some wsdl2py versions generate VirtualBox_client.py, some generate
767 # VirtualBox_services.py. Standardize on the former.
768 -$(QUIET)$(MV) -f $(VBOXWEB_WS_PYTHON_ALTERNATIVE) $(VBOXWEB_WS_PYTHON)
769 # We do not ever need the VirtualBox_server.py file. Delete it immediately
770 # so that it will not get packaged in the SDK.
771 $(QUIET)$(RM) -f -- $(VBOXWEB_WS_PYTHON_SERVER)
772 $(QUIET)$(APPEND) $@ ''
773
774 $(VBOXWEB_WS_PERL): $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL)
775 $(call MSG_GENERATE,,$@, WS Perl bindings)
776 $(QUIET)$(MKDIR) -p $(@D)
777 $(QUIET)$(REDIRECT) -C $(@D) -- $(VBOX_STUBMAKER) file://$(VBOXWEBSERVICE_WSDL)
778 # Ugly, ugly, ugly, make me right once
779 $(QUIET)$(SED) -e "s+http://www.virtualbox.org/Service+http://www.virtualbox.org/+" --output $(VBOXWEB_WS_PERL).tmp $(VBOXWEB_WS_PERL)
780 $(QUIET)$(MV) $(VBOXWEB_WS_PERL).tmp $(VBOXWEB_WS_PERL)
781 $(QUIET)$(APPEND) $@ ''
782
783 $(VBOXWEB_WS_PHP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-php.xsl
784 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-php.xsl)
785 $(QUIET)$(RM) -f -- $@
786 $(QUIET)$(MKDIR) -p $(@D)
787 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) \
788 --stringparam g_uVBoxCopyrightYear "$(VBOX_C_YEAR)" \
789 -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-php.xsl $<
790
791endif # VBOX_ONLY_SDK
792
793# generate typemap.dat (used by wsdl2h) from main XIDL file
794$(VBOXWEB_TYPEMAP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-typemap.xsl $(VBOX_PATH_IDL)/typemap-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
795 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-typemap.xsl)
796 $(QUIET)$(RM) -f -- $@
797 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-typemap.xsl $<
798
799# generate gsoap pseudo-C header file from that WSDL; once via XSLT...
800$(VBOXWEB_GSOAPH_FROM_XSLT): $(VBOXWEB_WSDL) $(VBOX_PATH_WEBSERVICE)/websrv-wsdl2gsoapH.xsl $(VBOX_PATH_IDL)/typemap-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
801 $(call MSG_GENERATE,,$@,$(VBOXWEB_WSDL) using websrv-wsdl2gsoapH.xsl)
802 $(QUIET)$(RM) -f -- $@
803 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl2gsoapH.xsl $<
804
805VBOX_NSMAP = $(VBOXWEB_OUT_DIR)/vboxwebsrv.nsmap
806$(VBOX_NSMAP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-nsmap.xsl $(VBOX_PATH_IDL)/typemap-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
807 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-nsmap.xsl)
808 $(QUIET)$(RM) -f -- $@
809 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-nsmap.xsl $<
810
811ifdef VBOX_GSOAP_INSTALLED
812 # ... and once with the gSOAP tool (just for comparison, we don't use it for licensing reasons)
813 $(VBOXWEB_GSOAPH_FROM_GSOAP): $(VBOXWEB_WSDL) $(VBOXWEB_TYPEMAP) | $$(dir $$@)
814 $(call MSG_GENERATE,,$@,)
815 $(QUIET)$(RM) -f -- $@
816 $(VBOX_WSDL2H) $(VBOXWEB_WSDL_VERBOSE) -t$(VBOXWEB_TYPEMAP) -nvbox -o $@ $<
817
818 # this sets the gsoap header that we use for further compilation; if stuff works, then the
819 # one we generate via XSLT produces the same end result as the one from the gSOAP tool;
820 # with this variable we can swap for testing, but shipped code must use VBOXWEB_GSOAPH_FROM_XSLT
821 GSOAPH_RELEVANT = $(VBOXWEB_GSOAPH_FROM_XSLT)
822
823 # wsdl2h -v: verbose
824 # wsdl2h -e: don't qualify enum names
825 # wsdl2h -n<prefix>: namespace header prefix
826
827 ## @todo change this to state explicitly what will be generated?
828
829 #
830 # Generate server and client code from gsoap pseudo-C header file.
831 #
832 # Options for soapcpp2:
833 # -2: generate SOAP 1.2 calls
834 # -L: don't generate soapClientLib/soapServerLib
835 # -w: don't generate WSDL and schema files
836 # -x: don't generate sample XML files (VBOXWEB_SOAPCPP2_SKIP_FILES).
837 #
838 $(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts \
839 + $(VBOXWEB_OUT_DIR)/soapH.h \
840 $(if-expr !defined(VBOX_WITHOUT_NOINLINE_SOAPH), \
841 + $(VBOXWEB_OUT_DIR)/soapH-noinline-1.cpp \
842 + $(VBOXWEB_OUT_DIR)/soapH-noinline-2.cpp \
843 + $(VBOXWEB_OUT_DIR)/soapH-noinline-3.cpp \
844 + $(VBOXWEB_OUT_DIR)/soapH-noinline-4.cpp \
845 + $(VBOXWEB_OUT_DIR)/soapH-noinline-5.cpp \
846 + $(VBOXWEB_OUT_DIR)/soapH-noinline-6.cpp \
847 + $(VBOXWEB_OUT_DIR)/soapH-noinline-7.cpp \
848 + $(VBOXWEB_OUT_DIR)/soapH-noinline-8.cpp \
849 + $(VBOXWEB_OUT_DIR)/soapH-noinline-9.cpp \
850 + $(VBOXWEB_OUT_DIR)/soapH-noinline-10.cpp \
851 + $(VBOXWEB_OUT_DIR)/soapH-noinline-11.cpp \
852 + $(VBOXWEB_OUT_DIR)/soapH-noinline-12.cpp,) \
853 + $(VBOXWEB_SOAP_CLIENT_H) \
854 + $(VBOXWEB_OUT_DIR)/soapC.cpp \
855 + $(VBOXWEB_OUT_DIR)/soapClient.cpp \
856 + $(VBOXWEB_OUT_DIR)/soapServer.cpp: \
857 $(VBOXWEB_GSOAPH_FROM_GSOAP) $(VBOXWEB_GSOAPH_FROM_XSLT) $(VBOX_NSMAP) \
858 $(VBOX_PATH_WEBSERVICE)/stdsoap2.sed \
859 $(VBOX_PATH_WEBSERVICE)/soap-header-to-inline-source-file.sed \
860 $(VBOX_PATH_WEBSERVICE)/soap-header-strip-inline.sed \
861 $$(split-soapC_1_TARGET) \
862 $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
863 $(call MSG_GENERATE,,lots of files,$(GSOAPH_RELEVANT))
864 $(RM) -f $@
865 $(REDIRECT) -C $(VBOXWEB_OUT_DIR) -- $(VBOX_SOAPCPP2) $(VBOXWEB_SOAPCPP2_SKIP_FILES) -L -2 -w -I$(VBOX_PATH_GSOAP_IMPORT) $(GSOAPH_RELEVANT)
866 ifeq ($(KBUILD_TARGET),win) # MSC -Wall workaround.
867 $(CP) -f "$(VBOXWEB_SOAP_CLIENT_H)" "$(VBOXWEB_SOAP_CLIENT_H).tmp"
868 $(SED) -f $(VBOX_PATH_WEBSERVICE)/stdsoap2.sed --output "$(VBOXWEB_SOAP_CLIENT_H)" "$(VBOXWEB_SOAP_CLIENT_H).tmp"
869 $(RM) -f "$(VBOXWEB_SOAP_CLIENT_H).tmp"
870 endif
871 ifndef VBOX_WITHOUT_NOINLINE_SOAPH
872 $(MV) -f -- "$(VBOXWEB_OUT_DIR)/soapH.h" "$(VBOXWEB_OUT_DIR)/soapH.h.tmp"
873 $(SED) -f $(VBOX_PATH_WEBSERVICE)/soap-header-to-inline-source-file.sed \
874 --output "$(VBOXWEB_OUT_DIR)/soapH-noinline.cpp" \
875 "$(VBOXWEB_OUT_DIR)/soapH.h.tmp"
876 $(split-soapC_1_TARGET) $(VBOXWEB_OUT_DIR)/soapH-noinline.cpp $(VBOXWEB_OUT_DIR)/soapH-noinline- 12
877 $(SED) -f $(VBOX_PATH_WEBSERVICE)/soap-header-strip-inline.sed \
878 --output "$(VBOXWEB_OUT_DIR)/soapH.h" \
879 "$(VBOXWEB_OUT_DIR)/soapH.h.tmp"
880 $(RM) -f -- "$(VBOXWEB_OUT_DIR)/soapH.h.tmp" "$(VBOXWEB_OUT_DIR)/soapH-noinline.cpp"
881 endif
882 $(APPEND) $@ done
883
884 # Copy the generated headers and stuff. This was split into a separate rule
885 # way back because we thought we could use $(wildcard ) and avoid the shell,
886 # however we cannot as it is subject to caching. Let the shell do the globbing.
887 # GSOAP versions 2.8 and later do not generate the unneeded soapvbox*.h files
888 # any more. Ignoring the exit code is the simple solution, accepting the error.
889 $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts: $(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts | $$(dir $$@)
890 $(RM) -f $@
891 $(MKDIR) -p $(PATH_TARGET_SOAPDEMOXML) $(PATH_TARGET_SOAPDEMOHEADERS) $(PATH_TARGET_SOAPDEMONSMAPS)
892 ifdef VBOX_GSOAP_VERBOSE
893 $(MV_EXT) -f -- $(VBOXWEB_OUT_DIR)/*.req.xml $(VBOXWEB_OUT_DIR)/*.res.xml $(PATH_TARGET_SOAPDEMOXML)/
894 endif
895 -$(MV_EXT) -f -- $(VBOXWEB_OUT_DIR)/soapvbox*.h $(PATH_TARGET_SOAPDEMOHEADERS)/
896 $(MV_EXT) -f -- $(VBOXWEB_OUT_DIR)/vboxBinding.nsmap $(PATH_TARGET_SOAPDEMONSMAPS)/
897 $(APPEND) $@ done
898
899 $(PATH_TARGET_SOAPDEMONSMAPS) \
900 $(PATH_TARGET_SOAPDEMOHEADERS)/soapvboxBindingProxy.h \
901 $(PATH_TARGET_SOAPDEMOHEADERS)/soapvboxBindingObject.h: $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
902
903 hack: $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
904
905 ifndef VBOX_WITHOUT_SPLIT_SOAPC
906 #
907 # Split up the soapC.cpp monster into manageable bits that can be
908 # built in parallel and without exhausting all available memory.
909 #
910 $(VBOXWEB_OUT_DIR)/soapC-1.cpp \
911 + $(VBOXWEB_OUT_DIR)/soapC-2.cpp \
912 + $(VBOXWEB_OUT_DIR)/soapC-3.cpp \
913 + $(VBOXWEB_OUT_DIR)/soapC-4.cpp \
914 + $(VBOXWEB_OUT_DIR)/soapC-5.cpp \
915 + $(VBOXWEB_OUT_DIR)/soapC-6.cpp \
916 + $(VBOXWEB_OUT_DIR)/soapC-7.cpp \
917 + $(VBOXWEB_OUT_DIR)/soapC-8.cpp \
918 + $(VBOXWEB_OUT_DIR)/soapC-9.cpp \
919 + $(VBOXWEB_OUT_DIR)/soapC-10.cpp \
920 + $(VBOXWEB_OUT_DIR)/soapC-11.cpp \
921 + $(VBOXWEB_OUT_DIR)/soapC-12.cpp \
922 + $(VBOXWEB_OUT_DIR)/soapC-13.cpp \
923 + $(VBOXWEB_OUT_DIR)/soapC-14.cpp \
924 + $(VBOXWEB_OUT_DIR)/soapC-15.cpp \
925 + $(VBOXWEB_OUT_DIR)/soapC-16.cpp \
926 + $(VBOXWEB_OUT_DIR)/soapC-17.cpp \
927 + $(VBOXWEB_OUT_DIR)/soapC-18.cpp \
928 + $(VBOXWEB_OUT_DIR)/soapC-19.cpp \
929 + $(VBOXWEB_OUT_DIR)/soapC-20.cpp \
930 + $(VBOXWEB_OUT_DIR)/soapC-21.cpp \
931 + $(VBOXWEB_OUT_DIR)/soapC-22.cpp \
932 + $(VBOXWEB_OUT_DIR)/soapC-23.cpp \
933 + $(VBOXWEB_OUT_DIR)/soapC-24.cpp \
934 + $(VBOXWEB_OUT_DIR)/soapC-25.cpp \
935 + $(VBOXWEB_OUT_DIR)/soapC-26.cpp \
936 + $(VBOXWEB_OUT_DIR)/soapC-27.cpp \
937 + $(VBOXWEB_OUT_DIR)/soapC-28.cpp \
938 + $(VBOXWEB_OUT_DIR)/soapC-29.cpp: \
939 $(VBOXWEB_OUT_DIR)/soapC.cpp $$(split-soapC_1_TARGET) | $$(dir $$@)
940 $(RM) -f -- $(wildcard $(VBOXWEB_OUT_DIR)/soapC-?.cpp $(VBOXWEB_OUT_DIR)/soapC-??.cpp)
941 $(split-soapC_1_TARGET) $(VBOXWEB_OUT_DIR)/soapC.cpp $(VBOXWEB_OUT_DIR)/soapC- 29
942 endif # !VBOX_WITHOUT_SPLIT_SOAPC
943
944endif # VBOX_GSOAP_INSTALLED
945
946
947
948# generate method maps in server: map wsdl operations to com/xpcom method calls
949$(VBOXWEB_OUT_DIR)/methodmaps.cpp: $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-cpp.xsl $(VBOX_PATH_IDL)/typemap-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
950 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-cpp.xsl)
951 $(QUIET)$(VBOX_XSLTPROC) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-cpp.xsl $<
952
953# generate C file which contains vboxweb.wsdl
954$$(VBOXWEB_OUT_DIR)/vboxweb-wsdl.c: $(VBOXWEB_WSDL) $(VBOX_BIN2C)
955 $(call MSG_TOOL,bin2c,vboxweb-wsdl,$<,$@)
956 $(QUIET)$(VBOX_BIN2C) -ascii VBoxWebWSDL $< $@
957
958
959ifdef VBOX_ONLY_SDK
960
961 $(VBOXWEB_JAXWSSAMPLE): $(VBOX_PATH_WEBSERVICE)/samples/java/jax-ws/clienttest.java
962 $(QUIET)$(RM) -f -- $@
963 $(QUIET)$(MKDIR) -p $(VBOXWEB_SAMPLES_JAXWS_DIR)
964 $(QUIET)$(SED) -e 's/{VBOX_API_SUFFIX}/$(VBOX_API_SUFFIX)/' < $< > $@
965
966 $(VBOXWEB_METRICSAMPLE): $(VBOX_PATH_WEBSERVICE)/samples/java/jax-ws/metrictest.java
967 $(QUIET)$(RM) -f -- $@
968 $(QUIET)$(MKDIR) -p $(VBOXWEB_SAMPLES_JAXWS_DIR)
969 $(QUIET)$(SED) -e 's/{VBOX_API_SUFFIX}/$(VBOX_API_SUFFIX)/' < $< > $@
970
971endif # VBOX_ONLY_SDK
972
973include $(FILE_KBUILD_SUB_FOOTER)
974
Note: See TracBrowser for help on using the repository browser.

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