build.xml 36.8 KB
Newer Older
1 2 3 4 5
<project
	name="disl" default="build" basedir="."
	xmlns:ivy="antlib:org.apache.ivy.ant"
	xmlns:ac="antlib:net.sf.ant-contrib"
>
Lukáš Marek's avatar
Lukáš Marek committed
6

7
	<property name="build.sysclasspath" value="ignore"/>
8

9
	<property file="disl.version"/>
10

11 12
	<property file="dependencies.local.properties"/>
	<property file="dependencies.properties"/>
13

14 15
	<property file="build.local.properties"/>
	<property file="build.properties"/>
Lukáš Marek's avatar
Lukáš Marek committed
16

17

18 19 20 21
	<!-- ================================================================== -->
	<!-- IVY SETUP & TASKS                                                  -->
	<!-- ================================================================== -->

22
	<!--
23
		Downloads the Ivy dependency manager from the Maven central repository.
24
	-->
25
	<available file="${build.ivy.path}" property="build.ivy.downloaded"/>
26
	<target name="-download-ivy" unless="build.ivy.downloaded">
27
		<mkdir dir="${lib.ant.dir}"/>
28 29
		<get src="${build.ivy.url}" dest="${build.ivy.path}" usetimestamp="true"/>
	</target>
30 31 32


	<!--
33
		Registers Ivy tasks within Ant.
34
	-->
35
	<target name="-setup-ivy" depends="-download-ivy">
36
		<taskdef resource="org/apache/ivy/ant/antlib.xml" uri="antlib:org.apache.ivy.ant" classpath="${build.ivy.path}"/>
37
	</target>
38

39

40 41 42 43 44 45
	<!--
		Downloads dependencies for compilation. This target should allow
		unconditional execution so that the download can be always forced.
	-->
	<target name="download-deps" depends="-setup-ivy" description="Downloads dependencies for compilation.">
		<ivy:resolve conf="ant,disl,test" file="${build.ivy.file}"/>
46
		<ivy:retrieve pattern="${lib.dir}/[conf]/[artifact].[ext]"/>
47
	</target>
František Haas's avatar
František Haas committed
48

49

50 51 52 53 54 55 56
	<!--
		Downloads dependency sources (for IDE integration).
	-->
	<target name="download-sources" depends="download-deps" description="Downloads dependency sources (for IDE integration).">
		<ivy:resolve conf="devel" file="${build.ivy.file}"/>
		<ivy:retrieve type="source" pattern="${lib.dir}/[conf]/[artifact]-[type].[ext]"/>
	</target>
57 58


59 60 61
	<!-- ================================================================== -->
	<!-- ARTIFACT LIST                                                      -->
	<!-- ================================================================== -->
62

63
	<!--
64
		Downloads dependencies and stores the list of retrieved artifacts
65
		so that their presence can be checked in subsequent invocations
66
		without Ivy. This target should allow unconditional execution so
67 68 69 70
		that the update of the artifact list can be always forced.
	-->
	<target name="update-artifact-list" depends="download-deps" description="Updates the list of expected dependency artifacts.">
		<collect-artifacts id="build.artifacts"/>
71

72 73 74 75 76 77
		<local name="artifacts.text"/>
		<path-to-text
			property="artifacts.text" refid="build.artifacts"
			mapfrom="${basedir}${file.separator}${lib.dir}"
			mapto="${lib.dir}"
		/>
78

79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100
		<echo file="${build.artifacts.list}">${artifacts.text}</echo>
	</target>


	<!--
		Determines whether the artifact list is up-to-date and sets the value
		of the 'build.artifacts.list.uptodate' property accordingly. The list
		is considered up-to-date if it contains at least one non-empty line
		and is newer than both the files describing the dependency properties.
	-->
	<target name="-check-artifact-list">
		<condition property="build.artifacts.list.uptodate"><and>
			<resourcecount when="greater" count="0">
				<tokens><concat>
					<filterchain>
						<tokenfilter><ignoreblank/></tokenfilter>
					</filterchain>
					<file file="${build.artifacts.list}"/>
				</concat></tokens>
			</resourcecount>

			<uptodate targetfile="${build.artifacts.list}">
101
				<srcfiles dir="${basedir}" includes="dependencies*.properties"/>
102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155
			</uptodate>
		</and></condition>
	</target>


	<!--
		Creates artifact list if it is missing or not up-to-date. This will
		trigger an initial download of artifacts so that the list is build
		from the downloaded artifacts.
	-->
	<target name="-create-artifact-list" depends="-check-artifact-list" unless="build.artifacts.list.uptodate">
		<antcall target="update-artifact-list"/>
	</target>


	<!--
		Collects downloaded artifacts into a fileset.
	-->
	<macrodef name="collect-artifacts">
		<attribute name="id"/>
		<sequential>
			<fileset dir="${basedir}" id="@{id}">
				<include name="${lib.ant.dir}/*.jar"/>
				<include name="${lib.disl.dir}/*.jar"/>
				<include name="${lib.test.dir}/*.jar"/>
			</fileset>
		</sequential>
	</macrodef>


	<!--
		Converts a path-like entity to text, one entry per line.
		Optionally performs mapping from one path prefix to another.
	-->
	<macrodef name="path-to-text">
		<attribute name="property"/>
		<attribute name="refid"/>
		<attribute name="mapfrom" default=""/>
		<attribute name="mapto" default=""/>
		<sequential>
			<pathconvert pathsep="${line.separator}" property="@{property}" refid="@{refid}">
				<map from="@{mapfrom}" to="@{mapto}"/>
			</pathconvert>
		</sequential>
	</macrodef>


	<!-- ================================================================== -->
	<!-- DEPENDENCY CHECKS                                                  -->
	<!-- ================================================================== -->

	<!--
		Determines if any of the expected artifacts are missing and sets
		the value of the 'build.artifacts.missing' property accordingly.
156
		This may trigger creating the list of expected artifacts after an
157 158 159 160 161 162 163 164 165 166 167 168 169 170 171
		initial download of dependencies.
	-->
	<target name="-check-artifacts" depends="-create-artifact-list">
		<find-missing-files file="${build.artifacts.list}" id="build.artifacts.missing.list"/>

		<condition property="build.artifacts.missing">
			<not><resourcecount refid="build.artifacts.missing.list" count="0"/></not>
		</condition>
	</target>


	<!--
		Download dependency artifacts if they are missing.
	-->
	<target name="-download-artifacts" depends="-check-artifacts" if="build.artifacts.missing">
172
		<antcall target="download-deps"/>
173 174 175 176 177 178 179 180 181 182 183 184 185 186
	</target>


	<!--
		Checks that none of the required artifacts are missing. This may
		trigger an initial download of dependency artifacts, but generally
		they will checked against a list of expected artifacts. If any of
		the artifacts are missing at this point, the build will fail.
	-->
	<target name="-check-deps" depends="-download-artifacts">
		<find-missing-files file="${build.artifacts.list}" id="build.artifacts.really.missing.list"/>

		<!-- Sanitize the path names of potentially missing artifacts. -->
		<local name="missing.text"/>
187
		<path-to-text
188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228
			property="missing.text" refid="build.artifacts.really.missing.list"
			mapfrom="${basedir}${file.separator}${lib.dir}"
			mapto="${lib.dir}"
		/>

		<!-- Fail if there are any missing artifacts. -->
		<fail message="missing artifacts${line.separator}${missing.text}${line.separator}Try running 'ant download-deps' to re-download dependencies.">
			<condition>
				<not><resourcecount refid="build.artifacts.really.missing.list" count="0"/></not>
			</condition>
		</fail>
	</target>


	<!--
		Loads a list of files and selects those that are missing.
	-->
	<macrodef name="find-missing-files">
		<attribute name="file"/>
		<attribute name="id"/>
		<sequential>
			<restrict id="@{id}">
				<resourcelist>
					<file file="@{file}"/>
				</resourcelist>
				<not><exists/></not>
			</restrict>
		</sequential>
	</macrodef>


	<!-- ================================================================== -->
	<!-- INITIALIZATION                                                     -->
	<!-- ================================================================== -->

	<!--
		Setup Ant extensions and define class paths involving both the
		downloaded artifacts and project classes.
	-->
	<target name="-init" depends="-check-deps">
		<path id="build.ant.classpath">
229
			<fileset dir="${lib.ant.dir}" includes="*.jar"/>
230 231
		</path>

232
		<taskdef resource="net/sf/antcontrib/antlib.xml" uri="antlib:net.sf.ant-contrib" classpathref="build.ant.classpath"/>
233 234 235

		<!-- Dependency class paths -->
		<path id="asm.classpath">
236
			<fileset dir="${lib.disl.dir}" includes="asm*.jar" id="asm.fileset"/>
237 238 239
		</path>

		<!-- Get ASM libs from ASM class path. -->
240
		<pathconvert pathsep=" " property="asm.libs" refid="asm.classpath">
241 242 243 244
			<mapper type="flatten"/>
		</pathconvert>

		<path id="log4j.classpath">
245
			<fileset dir="${lib.disl.dir}" includes="log4j*.jar"/>
246 247 248
		</path>

		<path id="junit.classpath">
249
			<fileset dir="${lib.test.dir}" includes="*.jar"/>
250 251
		</path>

252 253 254 255 256 257 258 259 260
		<path id="protobuf.classpath">
			<fileset dir="${lib.disl.dir}" includes="protobuf*.jar"/>
		</path>

		<!-- Get ProtoBuf Java libs from ProtoBuf class path. -->
		<pathconvert pathsep=" " property="protobuf.libs" refid="protobuf.classpath">
			<mapper type="flatten"/>
		</pathconvert>

261 262
		<!-- Project class paths -->
		<path id="util.classpath">
263
			<pathelement location="${build.util}"/>
264 265 266
		</path>

		<path id="disl.classpath">
267
			<pathelement location="${build.disl}"/>
268 269 270
		</path>

		<path id="disl.bypass.classpath">
271
			<pathelement location="${build.disl.bypass}/dynamic"/>
272 273 274
		</path>

		<path id="shvm.classpath">
275 276
			<pathelement location="${build.shvm}"/>
			<pathelement location="${build.shvm.dispatch}"/>
277 278 279 280 281 282 283 284 285 286
		</path>
	</target>


	<!--
		Determines the names of native agent libraries.
		Mac OS X (Darwin) is considered a Unix family.
	-->
	<target name="-determine-lib-names" depends="-init">
		<ac:if>
287
			<os family="windows"/>
288
			<ac:then>
289 290
				<property name="dl.prefix" value=""/>
				<property name="dl.suffix" value=".dll"/>
291
				<property name="disl.agent.os" value="windows"/>
292 293
			</ac:then><ac:else>
				<ac:if>
294
					<os family="unix"/>
295
					<ac:then>
296
						<property name="dl.prefix" value="lib"/>
297
						<ac:if>
298
							<os name="Mac OS X"/>
299
							<ac:then>
300
								<property name="dl.suffix" value=".jnilib"/>
301
								<property name="disl.agent.os" value="macosx"/>
302
							</ac:then><ac:else>
303
								<property name="dl.suffix" value=".so"/>
304
								<property name="disl.agent.os" value="linux"/>
305 306 307
							</ac:else>
						</ac:if>
					</ac:then><ac:else>
308
						<fail message="Unsupported operating system: ${os.name}"/>
309 310 311 312
					</ac:else>
				</ac:if>
			</ac:else>
		</ac:if>
313

314 315 316
		<ac:switch value="${os.arch}" caseinsensitive="true">
			<case value="x86_64"><property name="disl.agent.arch" value="x86_64"/></case>
			<case value="amd64"><property name="disl.agent.arch" value="x86_64"/></case>
Matteo Basso's avatar
Matteo Basso committed
317
			<case value="ppc64"><property name="disl.agent.arch" value="ppc64"/></case>
318 319 320
			<default><property name="disl.agent.arch" value="x86"/></default>
		</ac:switch>

321 322
		<property name="disl.agent.lib" value="${dl.prefix}${disl.agent.lib.base}${dl.suffix}"/>
		<property name="shvm.agent.lib" value="${dl.prefix}${shvm.agent.lib.base}${dl.suffix}"/>
323 324 325
	</target>


326 327 328 329 330 331
	<!--
		Looks for a class file or a source file with a given name, and
		sets the value of a given property to the fully qualified
		class name when a matching class (or source) file is found.
	-->
	<macrodef name="find-class">
332 333 334 335 336
		<attribute name="dir"/>
		<attribute name="name"/>
		<attribute name="property"/>
		<attribute name="suffix" default=".class"/>
		<attribute name="setonempty" default="true"/>
337 338
		<sequential>
			<pathconvert property="@{property}" setonempty="@{setonempty}">
339 340
				<fileset dir="@{dir}" includes="**/@{name}@{suffix}"/>
				<mapper type="package" from="${basedir}/@{dir}/*@{suffix}" to="*"/>
341 342 343 344 345
			</pathconvert>
		</sequential>
	</macrodef>


346 347
	<!-- Build tools -->

348
	<target name="compile-tools" depends="-init">
349
		<mkdir dir="${build.tools}"/>
350 351
		<javac destdir="${build.tools}" srcdir="${src.tools}">
			<classpath>
352 353
				<path refid="asm.classpath"/>
				<path location="${ant.core.lib}"/>
354 355 356 357 358
			</classpath>
		</javac>
	</target>


359 360
	<!-- DiSL bypass -->

361 362 363 364 365 366 367 368
	<!--
		To compile DiSL bypass code, we need an extended Thread class
		containing a public "bypass" field used by the dynamic bypass
		code. When running an application with DiSL instrumentation,
		the Thread class will be extended at load time, but we need
		one also for compilation.

		Here we first check if the extended Thread class exists, and
369 370
		if not, we use a thread extended from build tools to generate
		the extended Thread class.
371
	-->
372
	<!-- pathconvert property="build.disl.thread.available" setonempty="false">
373
		<fileset dir="." includes="${build.disl.thread}/**/Thread.class"/>
374
	</pathconvert -->
375 376 377 378 379 380 381 382 383 384
	<target name="-check-disl-thread">
		<condition property="build.disl.thread.available"><and>
			<available file="${build.disl.thread}/java/lang/Thread.class"/>
			<length file="${build.disl.thread}/java/lang/Thread.class" when="greater" length="1024"/>
		</and></condition>
	</target>

	<target name="-create-disl-thread-if-needed" unless="build.disl.thread.available" depends="-check-disl-thread">
		<antcall target="-create-disl-thread"/>
	</target>
Lukáš Marek's avatar
Lukáš Marek committed
385

386
	<target name="-create-disl-thread" depends="compile-tools">
387 388
		<local name="extender.class"/>
		<find-class property="extender.class" dir="${build.tools}" name="ExtendThread"/>
389

390
		<mkdir dir="${build.disl.thread}"/>
391
		<java classname="${extender.class}" fork="true">
392
			<classpath>
393 394
				<path location="${build.tools}"/>
				<path refid="asm.classpath"/>
395
			</classpath>
396
			<arg value="${basedir}/${build.disl.thread}"/>
397
		</java>
Lukáš Marek's avatar
Lukáš Marek committed
398 399 400
	</target>


401 402 403 404 405 406
	<!--
		Compile multiple versions of the bypass code: one which always
		bypasses the instrumentation, one which never bypasses the
		instrumentation, and one that checks the "bypass" field in
		the extended Thread class to determine whether to bypass the
		instrumentation or not.
Lukáš Marek's avatar
Lukáš Marek committed
407

408 409 410 411 412 413 414
		After compiling, create a file set of default bypass classes.
		The DiSL agent requires those so that instrumented application
		can find the BypassCheck class, and after switch to dynamic
		bypass performed by the agent, also the DynamicBypass class.
		The DiSL server requires both classes to create class literals
		in the weaver code.
	-->
415
	<target name="compile-disl-bypass" depends="-init,-create-disl-thread-if-needed">
416
		<ac:for list="always,never,dynamic" param="variant">
417
			<sequential>
418
				<mkdir dir="${build.disl.bypass}/@{variant}"/>
419
				<javac destdir="${build.disl.bypass}/@{variant}" srcdir="${src.disl.bypass}/@{variant}" debug="true" source="${target.disl.bypass}" target="${target.disl.bypass}">
420
					<compilerarg value="-Xbootclasspath/p:${basedir}/${build.disl.thread}"/>
421 422
				</javac>
			</sequential>
423
		</ac:for>
424

425
		<union id="disl.bypass.files">
426 427
			<fileset dir="${build.disl.bypass}/always" includes="**/BypassCheck.class"/>
			<fileset dir="${build.disl.bypass}/dynamic" includes="**/DynamicBypass.class"/>
428
		</union>
429 430
	</target>

431

432 433 434 435 436 437 438 439
	<!--
		Package the default variant of the bypass code which will
		be included in the boot classpath. By default, we include
		a BypassCheck variant that always bypasses instrumentation.
		We also include DynamicBypass class that is needed by the
		dynamic variant of the BypassCheck class, which will be
		substituted by the DiSL agent in place of the default on.
	-->
440
	<target name="build-disl-bypass" depends="compile-disl-bypass">
441
		<jar destfile="${out.lib}/${disl.bypass.lib}">
442
			<resources refid="disl.bypass.files"/>
443
		</jar>
444 445
	</target>

446 447 448

	<!-- Shared utility code -->

449
	<target name="compile-util" depends="-init">
450
		<mkdir dir="${build.util}"/>
451
		<javac destdir="${build.util}" srcdir="${src.util}" debug="true">
452
			<classpath refid="asm.classpath"/>
453
			<classpath refid="log4j.classpath"/>
454
		</javac>
455 456 457

		<!-- Register logging providers -->
		<!--
458 459
		<local name="service.dir"/>
		<property name="service.dir" value="${build.util}/META-INF/services"/>
460

461 462
		<local name="logging.package"/>
		<property name="logging.package" value="ch.usi.dag.util.logging"/>
463

464 465 466 467
		<local name="service.file"/>
		<property name="service.file" value="${service.dir}/${logging.package}.Provider"/>

		<mkdir dir="${service.dir}"/>
468 469 470
		<echo file="${service.file}" append="false">${logging.package}.JavaProvider${line.separator}</echo>
		<echo file="${service.file}" append="true">${logging.package}.Log4jProvider${line.separator}</echo>
		-->
471 472
	</target>

473 474 475

	<!-- DiSL -->

476
	<target name="compile-disl" depends="compile-util,compile-disl-bypass">
477
		<mkdir dir="${build.disl}"/>
478
		<javac destdir="${build.disl}" srcdir="${src.disl}" debug="true">
479
			<classpath>
480 481 482
				<path refid="disl.bypass.classpath"/>
				<path refid="util.classpath"/>
				<path refid="asm.classpath"/>
483
				<path refid="protobuf.classpath"/>
484
			</classpath>
485 486 487
		</javac>
	</target>

Lukáš Marek's avatar
Lukáš Marek committed
488

489
	<target name="build-disl" depends="compile-disl,build-disl-bypass">
490 491 492 493 494
		<local name="server.class"/>
		<find-class property="server.class" dir="${build.disl}" name="DiSLServer"/>

		<local name="classfinder.class"/>
		<find-class property="classfinder.class" dir="${build.disl}" name="DislClassFinder"/>
495 496

		<jar destfile="${out.lib}/${disl.lib}">
497
			<manifest>
498
				<attribute name="Class-Path" value="${asm.libs} ${protobuf.libs}"/>
499 500
				<attribute name="Main-Class" value="${server.class}"/>
				<attribute name="DiSL-Version" value="${disl.version}"/>
501
			</manifest>
502

503
			<service type="javax.annotation.processing.Processor" provider="${classfinder.class}"/>
504

505 506 507
			<fileset dir="${build.util}"/>
			<fileset dir="${build.disl}"/>
			<resources refid="disl.bypass.files"/>
508 509 510
		</jar>
	</target>

511 512 513

	<!-- DiSL agent -->

514 515 516
	<!--
		The DiSL agent requires a header file containing flags for
		various code generation options. This target generates the
517
		header using "javac -h" after compiling DiSL.
518
	-->
519
	<target name="-check-disl-agent-codeflags">
520
		<property name="build.disl.agent.codeflags.path" value="${src.disl.agent}/codeflags.h"/>
521
		<uptodate property="build.disl.agent.codeflags.uptodate" targetfile="${build.disl.agent.codeflags.path}">
522
			<srcfiles dir="${src.disl}" includes="**/DiSL.java"/>
523
		</uptodate>
524 525
	</target>

526 527 528
	<target name="-generate-disl-agent-codeflags-if-needed" unless="build.disl.agent.codeflags.uptodate" depends="-check-disl-agent-codeflags">
		<antcall target="-generate-disl-agent-codeflags"/>
	</target>
529

530
	<target name="-generate-disl-agent-codeflags" depends="compile-disl">
531 532
	    <delete dir="${build.disl.native}" />
        <mkdir dir="${build.disl.native}" />
533

534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549
		<javac srcdir="${src.disl}" destdir="${build.disl.native}" nativeheaderdir="${build.disl.native}" debug="false" includeantruntime="false">
			<include name="**/DiSL.java"/>
			<classpath>
				<path refid="disl.classpath"/>
				<path refid="disl.bypass.classpath"/>
				<path refid="util.classpath"/>
				<path refid="asm.classpath"/>
				<path refid="protobuf.classpath"/>
			</classpath>
		</javac>

		<concat destfile="${build.disl.agent.codeflags.path}">
			<fileset file="${build.disl.native}/*.h" />
		</concat>

		<delete dir="${build.disl.native}"/>
550 551 552 553 554
	</target>


	<!--
		The DiSL agent requires the bytecode of several bypass
555 556
		classes. This target generates the "bytecode.c" containing
		the necessary bytecode.
557
	-->
558
	<target name="-check-disl-agent-bytecode">
559
		<property name="build.disl.agent.bytecode.path" value="${src.disl.agent}/bytecode.c"/>
560
		<uptodate property="build.disl.agent.bytecode.uptodate" targetfile="${build.disl.agent.bytecode.path}">
561
			<srcfiles dir="${src.disl.bypass}"/>
562
		</uptodate>
563 564
	</target>

565
	<target name="-generate-disl-agent-bytecode-if-needed" unless="build.disl.agent.bytecode.uptodate" depends="-check-disl-agent-bytecode">
566
		<antcall target="-generate-disl-agent-bytecode"/>
567
	</target>
568

569
	<target name="-generate-disl-agent-bytecode" depends="compile-disl,compile-tools">
570 571
		<taskdef name="bytedump" classname="ch.usi.dag.disl.tools.ByteDumpTask">
			<classpath>
572
				<pathelement location="${build.tools}"/>
573 574 575
			</classpath>
		</taskdef>

576 577
		<local name="output.file"/>
		<property name="output.file" value="${build.disl.agent.bytecode.path}"/>
578

579 580 581
		<echo file="${output.file}">/**${line.separator}</echo>
		<echo file="${output.file}" append="true"> * DO NOT EDIT!${line.separator}</echo>
		<echo file="${output.file}" append="true"> *${line.separator}</echo>
582
		<echo file="${output.file}" append="true"> * This file was generated using the '-generate-disl-agent-bytecode' target.${line.separator}</echo>
583 584
		<echo file="${output.file}" append="true"> */${line.separator}</echo>
		<echo file="${output.file}" append="true">#include &lt;jvmti.h&gt;${line.separator}</echo>
585

586
		<ac:for param="file.path">
587
			<path>
588
				<fileset dir="${build.disl.bypass}" includes="**/BypassCheck.class"/>
589 590 591
				<!-- fileset dir="${build.disl.bypass}" includes="**/DynamicBypass.class" /-->
			</path>
			<sequential>
592
				<!-- Variant of the class, i.e., the top-level directory name. -->
593
				<local name="file.variant"/>
594
				<pathconvert property="file.variant">
595 596
					<path path="@{file.path}"/>
					<mapper type="regexp" from="${basedir}/${build.disl.bypass}/([^/]+)/.*" to="\1"/>
597
				</pathconvert>
598 599

				<!-- Name of the class. -->
600
				<local name="file.class"/>
601
				<pathconvert property="file.class">
602 603
					<path path="@{file.path}"/>
					<mapper type="regexp" from=".*/([^/]+).class" to="\1"/>
604 605
				</pathconvert>

606 607
				<local name="file.length"/>
				<length property="file.length" file="@{file.path}"/>
608 609

				<!-- Define a structure for each class file. -->
610 611 612
				<echo file="${output.file}" append="true">${line.separator}jvmtiClassDefinition ${file.variant}_${file.class}_classdef = {${line.separator}</echo>
				<echo file="${output.file}" append="true">&#9;.class_byte_count = ${file.length},${line.separator}</echo>
				<echo file="${output.file}" append="true">&#9;.class_bytes = (unsigned char *)${line.separator}</echo>
613
				<bytedump
614
					srcFile="@{file.path}" destFile="${output.file}" append="true"
615 616 617
					blockLength="16"  byteFormat="\x%02x"
					blockPrefix="&#9;&#9;&quot;" blockSuffix="&quot;${line.separator}" lastSuffix="&quot;,${line.separator}"
				/>
618
				<echo file="${output.file}" append="true">};${line.separator}</echo>
619
			</sequential>
620
		</ac:for>
621 622
	</target>

623

624
	<target name="prepare-disl-agent" depends="-generate-disl-agent-codeflags-if-needed,-generate-disl-agent-bytecode-if-needed"/>
625 626


627 628
	<target name="compile-disl-agent" depends="prepare-disl-agent">
		<exec executable="make" dir="${src.disl.agent}"/>
629 630 631 632 633 634 635 636
	</target>


	<!--
		This target cross-compiles the DiSL agent library for
		Windows using MinGW. It is currently not used in the
		default build, but should be used for binary releases.
	-->
637
	<target name="compile-disl-agent-mingw" depends="prepare-disl-agent">
638
		<exec executable="make" dir="${src.disl.agent}">
639 640
			<arg value="WHOLE=1"/>
			<arg value="TARGET_ENV=MinGW"/>
641
		</exec>
Lukáš Marek's avatar
Lukáš Marek committed
642 643 644
	</target>


645
	<target name="build-disl-agent" depends="compile-disl-agent,-determine-lib-names">
646
		<copy file="${src.disl.agent}/${disl.agent.os}-${disl.agent.arch}/${disl.agent.lib}" todir="${out.lib}"/>
647
	</target>
Lukáš Marek's avatar
Lukáš Marek committed
648 649


650
	<!-- Shadow VM -->
Lukáš Marek's avatar
Lukáš Marek committed
651

652
	<target name="compile-shvm-dispatch">
653 654
		<mkdir dir="${build.shvm.dispatch}"/>
		<javac destdir="${build.shvm.dispatch}" srcdir="${src.shvm.dispatch}" debug="true" source="${target.shvm.dispatch}" target="${target.shvm.dispatch}"/>
655 656 657
	</target>


658
	<target name="build-shvm-dispatch" depends="compile-shvm-dispatch">
659
		<jar destfile="${out.lib}/${shvm.dispatch.lib}" basedir="${build.shvm.dispatch}"/>
660 661 662
	</target>


663
	<target name="compile-shvm" depends="compile-util,compile-shvm-dispatch">
664
		<mkdir dir="${build.shvm}"/>
665
		<javac destdir="${build.shvm}" srcdir="${src.shvm}" debug="true">
666 667
			<classpath refid="util.classpath"/>
			<classpath refid="asm.classpath"/>
668
		</javac>
Lukáš Marek's avatar
Lukáš Marek committed
669 670
	</target>

671

672
	<target name="build-shvm" depends="compile-shvm,build-shvm-dispatch">
673 674
		<local name="shvm.server.class"/>
		<find-class property="shvm.server.class" dir="${build.shvm}" name="DiSLREServer"/>
675

676
		<jar destfile="${out.lib}/${shvm.lib}">
677
			<manifest>
678 679 680
				<attribute name="Class-Path" value="${asm.libs}"/>
				<attribute name="Main-Class" value="${shvm.server.class}"/>
				<attribute name="DiSL-Version" value="${disl.version}"/>
681
			</manifest>
682

683 684
			<fileset dir="${build.util}"/>
			<fileset dir="${build.shvm}"/>
685 686 687
		</jar>
	</target>

688
	<!-- Shadow VM agent -->
Lukáš Marek's avatar
Lukáš Marek committed
689

690
	<target name="compile-shvm-agent">
691
		<exec executable="make" dir="${src.shvm.agent}">
692
			<arg value="WHOLE=1"/>
693
		</exec>
694 695 696
	</target>


697
	<target name="build-shvm-agent" depends="compile-shvm-agent,-determine-lib-names">
698
		<copy file="${src.shvm.agent}/${shvm.agent.lib}" todir="${out.lib}"/>
699
	</target>
František Haas's avatar
František Haas committed
700

701

702
	<!-- JUnit tests and DiSL/Shadow VM test suites -->
703

704
	<path id="test.classpath">
705 706 707 708 709
		<path refid="util.classpath"/>
		<path refid="disl.classpath"/>
		<path refid="shvm.classpath"/>
		<path refid="junit.classpath"/>
		<path refid="asm.classpath"/>
710 711
	</path>

712
	<target name="compile-test" depends="-init,compile-util,compile-disl,compile-shvm">
713
		<mkdir dir="${build.test}"/>
714
		<javac destdir="${build.test}" srcdir="${src.test}" debug="true">
715
			<classpath refid="test.classpath"/>
716
		</javac>
František Haas's avatar
František Haas committed
717

718 719 720
		<!-- Copy test resource files from source to class output directory. -->
		<copy todir="${build.test}">
			<fileset dir="${src.test}">
721
				<include name="**/*.resource"/>
722 723
			</fileset>
		</copy>
František Haas's avatar
František Haas committed
724 725 726
	</target>


727
	<macrodef name="package2path">
728 729
		<attribute name="package"/>
		<attribute name="property"/>
730 731
		<sequential>
			<pathconvert property="@{property}">
732 733
				<path path="@{package}"/>
				<mapper type="unpackage" from="${basedir}/*" to="*"/>
734 735 736
			</pathconvert>
		</sequential>
	</macrodef>
František Haas's avatar
František Haas committed
737

František Haas's avatar
František Haas committed
738

739
	<target name="build-test" depends="-init,compile-test">
740 741
		<property name="suite.base.pkg" value="ch.usi.dag.disl.test.suite"/>
		<package2path package="${suite.base.pkg}" property="suite.base.path"/>
742 743

		<condition property="test.suites" value="${test.name}" else="*">
744
			<isset property="test.name"/>
745
		</condition>
František Haas's avatar
František Haas committed
746

747
		<ac:for param="suite.path">
František Haas's avatar
František Haas committed
748
			<path>
749
				<dirset dir="${src.test}/${suite.base.path}">
750
					<include name="${test.suites}"/>
František Haas's avatar
František Haas committed
751 752 753
				</dirset>
			</path>
			<sequential>
754 755 756
				<local name="suite.name"/>
				<basename file="@{suite.path}" property="suite.name"/>
				<build-test-suite name="${suite.name}" path="${suite.base.path}/${suite.name}" pkg="${suite.base.pkg}.${suite.name}"/>
František Haas's avatar
František Haas committed
757
			</sequential>
758
		</ac:for>
František Haas's avatar
František Haas committed
759 760
	</target>

František Haas's avatar
František Haas committed
761

762 763 764 765 766 767 768
	<macrodef name="build-test-suite">
		<attribute name="name"/>
		<attribute name="path"/>
		<attribute name="pkg"/>
		<sequential>
			<!-- Package target application classes. -->
			<jar destfile="${out.test}/@{name}-app.jar">
769
				<fileset dir="${build.test}" includes="@{path}/app/**"/>
770
				<manifest>
771
					<attribute name="Main-Class" value="@{pkg}.app.TargetClass"/>
772 773 774 775 776 777 778 779 780 781 782 783
				</manifest>
			</jar>

			<!--
				Process annotations to find DiSL classes.

				Use an empty directory as destination for the classes to
				make the "javac" task actually execute "javac" with the
				source files. Using the normal build destination directory
				would result in "javac" task excluding all source files
				for which it could find up-to-date class files.
			-->
784 785
			<local name="classfinder.output"/>
			<tempfile property="classfinder.output" prefix="@{name}-disl-classes-" suffix=".lst" destDir="${out.dir}" createFile="true" deleteOnExit="true"/>
786

787 788
			<local name="classfinder.class"/>
			<find-class property="classfinder.class" dir="${build.disl}" name="DislClassFinder"/>
789

790
			<mkdir dir="${out.dir}/empty"/>
791
			<javac srcdir="${src.test}" destDir="${out.dir}/empty">
792
				<classpath refid="test.classpath"/>
793

794 795 796 797
				<compilerArg value="-proc:only"/>
				<compilerArg line="-processor ${classfinder.class}"/>
				<compilerArg value="-Adisl.classfinder.output=${classfinder.output}"/>
				<compilerArg value="-Adisl.classfinder.separator=,"/>
798

799
				<include name="@{path}/**/*.java"/>
800 801
			</javac>

802 803
			<local name="disl.classes"/>
			<loadfile property="disl.classes" srcFile="${classfinder.output}"/>
804 805 806 807

			<!-- Package instrumentation classes. -->
			<jar destfile="${out.test}/@{name}-inst.jar">
				<manifest>
808
					<attribute name="DiSL-Classes" value="${disl.classes}"/>
809 810
				</manifest>

811
				<fileset dir="${build.test}" includes="@{path}/instr/**"/>
812 813 814
			</jar>
		</sequential>
	</macrodef>
František Haas's avatar
František Haas committed
815 816


817
	<target name="test" depends="build,build-test" description="Runs all tests or a selected (-Dtest.name=...) test suite.">
818 819 820 821
		<!--
			If test.name is set to a name of a test suite, only include the test suite
			in the batch of tests to be run, otherwise include all tests and suites.
		-->
822
		<ac:if>
823
			<isset property="test.name"/>
824
			<ac:then>
825 826
				<echo>Running a single test suite: ${test.name}</echo>
				<fileset id="test.batch" dir="${src.test}">
827
					<include name="**/suite/${test.name}/junit/*Test.java"/>
828
				</fileset>
829
			</ac:then><ac:else>
830 831
				<echo>Running all tests.</echo>
				<fileset id="test.batch" dir="${src.test}">
832 833 834
					<include name="**/junit/*Test.java"/>
					<include name="**/disl/*Test.java"/>
					<include name="**/disl/scope/*Test.java"/>
835
					<include name="**/disl/util/cfg/*Test.java"/>
836
					<include name="**/dislreserver/shadow/*Test.java"/>
837
				</fileset>
838 839
			</ac:else>
		</ac:if>
František Haas's avatar
František Haas committed
840

841 842 843
		<!--
			Run the batch of junit tests and junit-wrapped test suites.
		-->
844
		<mkdir dir="${out.junit}"/>
František Haas's avatar
František Haas committed
845
		<junit haltonfailure="no" haltonerror="no" failureproperty="junit.failure">
846 847
			<formatter type="brief" usefile="false"/>
			<formatter type="xml"/>
848 849

			<classpath>
850 851 852 853 854 855
				<path refid="asm.classpath"/>
				<path refid="junit.classpath"/>
				<pathelement location="${build.test}"/>
				<pathelement location="${build.util}"/>
				<pathelement location="${build.disl}"/>
				<pathelement location="${build.shvm}"/>
856 857
			</classpath>

858
			<!-- pass properties starting with "disl.", "dislserver.", and "dislreserver." to the tests -->
František Haas's avatar
František Haas committed
859
			<syspropertyset>
860 861 862
				<propertyref prefix="disl."/>
				<propertyref prefix="dislserver."/>
				<propertyref prefix="dislreserver."/>
František Haas's avatar
František Haas committed
863
			</syspropertyset>
864

865 866 867 868 869 870
			<sysproperty key="runner.disl.lib.dir" value="${out.lib}"/>
			<sysproperty key="runner.lib.dir" value="${out.test}"/>
			<sysproperty key="runner.disl.agent.lib" value="${disl.agent.lib}"/>
			<sysproperty key="runner.shvm.agent.lib" value="${shvm.agent.lib}"/>
			<sysproperty key="runner.debug" value="${test.debug}"/>
			<sysproperty key="test.verbose" value="${test.verbose}"/>
871

872
			<batchtest fork="yes" todir="${out.junit}">
873
				<fileset refid="test.batch"/>
František Haas's avatar
František Haas committed
874 875 876
			</batchtest>
		</junit>
	</target>
877 878 879 880


	<!-- Eclipse support -->

881
	<target name="build-eclipse-agent">
882 883
		<local name="agent.class"/>
		<find-class property="agent.class" dir="${src.test}" name="Agent" suffix=".java"/>
884 885

		<jar destfile="${out.lib}/${eclipse.agent.lib}">
886
			<manifest>
887
				<attribute name="Premain-Class" value="${agent.class}"/>
888 889 890 891 892 893 894
			</manifest>
		</jar>
	</target>


	<!-- Documentation -->

895
	<macrodef name="pdflatex">
896 897
		<attribute name="dir" default="."/>
		<element name="exec-elements" implicit="yes"/>
898
		<sequential>
899 900
			<local name="pdflatex.output"/>
			<local name="pdflatex.result"/>
901

902
			<exec executable="pdflatex" dir="@{dir}" outputProperty="pdflatex.output" resultProperty="pdflatex.result">
903
				<exec-elements/>
904 905
			</exec>
			<fail message="${pdflatex.output}">
906
				<condition><isfailure code="${pdflatex.result}"/></condition>
907 908 909 910 911 912
			</fail>
		</sequential>
	</macrodef>


	<target name="check-doc">
913 914 915
		<property name="doc.intro.tex" value="dislintro.tex"/>
		<property name="doc.intro.pdf" value="${build.doc.intro}/dislintro.pdf"/>
		<fileset id="doc.intro.files" dir="${src.doc.intro}"/>
916

917
		<uptodate property="doc.intro.uptodate" targetFile="${doc.intro.pdf}">
918
			<srcfiles refid="doc.intro.files"/>
919 920 921 922 923
		</uptodate>
	</target>


	<target name="build-doc" depends="check-doc" unless="doc.intro.uptodate">
924
		<delete dir="${build.doc.intro}"/>
925
		<copy todir="${build.doc.intro}">
926
			<fileset refid="doc.intro.files"/>
927
		</copy>
928 929 930

		<echo>Compiling Introduction to Instrumentation with DiSL</echo>
		<pdflatex dir="${build.doc.intro}">
931 932
			<arg value="-draftmode"/>
			<arg value="${doc.intro.tex}"/>
933 934 935
		</pdflatex>

		<pdflatex dir="${build.doc.intro}">
936
			<arg value="${doc.intro.tex}"/>
937
		</pdflatex>
938 939 940
	</target>


941
	<target name="build-jdoc" depends="-init,compile">
942
		<mkdir dir="${out.doc.jdoc}"/>
943 944
		<javadoc destdir="${out.doc.jdoc}"
			access="public" author="true" version="true" use="true"
945 946
			noDeprecated="false" nodeprecatedlist="false"
			noIndex="false" splitIndex="true" noNavbar="false" noTree="false"
947
			overview="${src.doc.jdoc}/overview