From f88b3add41d41de674712d9b5ce06a0f2a2f63bf Mon Sep 17 00:00:00 2001
From: Brian Hinz <bphinz@users.sourceforge.net>
Date: Mon, 2 Dec 2013 02:53:10 +0000
Subject: Added attributes to the Java viewer MANIFEST file in order to conform
 to upcoming JRE requirements.  Added support for specifying a signing
 certificate in place of the self-signed certificate.

git-svn-id: svn://svn.code.sf.net/p/tigervnc/code/trunk@5145 3789f03b-4d11-0410-bbf8-ca57d06f2519
---
 BUILDING.txt | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

(limited to 'BUILDING.txt')

diff --git a/BUILDING.txt b/BUILDING.txt
index 4ed06671..98c7c6b0 100644
--- a/BUILDING.txt
+++ b/BUILDING.txt
@@ -385,6 +385,28 @@ Similarly, if the Java viewer is built along with the Unix TigerVNC Server
 (Xvnc), then the build system will include the Java viewer in the server
 tarball.
 
+By default, a self-signed certificate will be generated and used to sign the
+jar file.  By specifying the following command line arguments to the CMake
+command line, an alternate certificate may be used for signing.
+
+  -DJAVA_KEYSTORE=${keystore_location_or_url}
+  -DJAVA_KEYSTORE_TYPE=${keystore_type} (Default: "jks")
+  -DJAVA_KEY_ALIAS=${keytore_key_alias}
+  -DJAVA_STOREPASS=${keystore_password}
+  -DJAVA_KEYPASS=${keystore_entry_password}
+  -DJAVA_TSA_URL=${url_of_timestamping_authority}
+
+The values of the JAVA_STOREPASS and JAVA_KEYPASS arguments may optionally be
+read from file or environment variables by prefixing the value with ":env " 
+or ":file " (see the jarsigner documentation for more info): 
+
+  export StorePass=tigervnc
+  export KeyPass=tigervnc
+  cmake \
+    ...
+    -DJAVA_STOREPASS=":env StorePass"
+    -DJAVA_KEYPASS=":env KeyPass"
+
 
 ======================================
 Building Native Language Support (NLS)
-- 
cgit v1.2.3