<watermark>

Description

Add a watermark to a jar using the PreMark™ watermarker. The jar can either be unobfuscated or previously obfuscated using PreEmptive Protection - DashO.


Task Specific Parameters

Attribute Description Required
src The name of the jar to be watermarked. Yes
value The watermark itself. Note that its contents will be constrained by the encoding setting. Yes
destfile The name of the jar that will be created. No; defaults to dashowm.jar.
truncate If true when the watermark is too long to be applied to the jar it will be truncated. If false the task will fail when the watermark is too long. No; defaults to false.
passphrase Passphrase used to encrypt the watermark. If not used the watermark is not encrypted. No
encoding The encoding for the watermark text. No; defaults to 6bit-a

General Parameters

Attribute Description Required
append If true the file specified by output and error will have output appended rather than being overwritten. No; defaults to false
dashohome The location of DashOPro.jar. See Setting DashO Home for details. No
dir The directory where the process will be invoked. No; defaults to the basedir of the buildfile.
error Name of a file to which to write the error output. (Error messages print to the error output) No
errorProperty Name of a property in which to store the standard error output. (Error messages print to the standard error output) No
failonerror If true stops the buildprocess if the process exits with a returncode other than 0. No; defaults to true
if Execute only if the named property has been set. No
jvm The command used to invoke the Java Virtual Machine. The command is resolved by java.lang.Runtime.exec(). No; default is java.
maxmemory Max amount of memory to allocate to the process. No
newenvironment If true the old environment settings will not be propogated when new environment variables are specified. No; defaults to false.
output Name of a file to which to write the output of the process. No
outputProperty Name of a property in which to store the standard output. No
printstacktraces If true stack traces will be printed for errors. No; defaults to false.
quiet If true output will be terse. No; defaults to false.
resultproperty The property name which will contain the return code from the task. No
timeout Stop the process if it doesn't finish within the specified time in milliseconds. No
unless Execute only if the named property has not been set. No
verbose If true additional information will be printed. No; defaults to false.

Parameters specified as nested elements

arg and jvmarg

Use nested <arg> and <jvmarg> elements to specify arguments to DashO and the JVM respectively. See Command line arguments.

sysproperty

Use nested <sysproperty> elements to specify system properties required by DashO. This tag uses the same syntax as <env>: see the <exec> task for details.

env

Use nested <env> elements to add or replace environment variables passed to the process. See the <exec> task for details.

Example

<property name="watermark" value="YOYODYNE PROPULSION"/>

<target name="watermark">
    <watermark src="ovthrust-control.jar" quiet="true" value="${watermark}">
        <jvmarg value="-verbose:gc"/>
    </watermark>
</target>