VirtualBox

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

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

Webservices warning fixes (gcc 9.2).

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