README
1# Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
2# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3#
4# This code is free software; you can redistribute it and/or modify it
5# under the terms of the GNU General Public License version 2 only, as
6# published by the Free Software Foundation.
7#
8# This code is distributed in the hope that it will be useful, but WITHOUT
9# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
11# version 2 for more details (a copy is included in the LICENSE file that
12# accompanied this code).
13#
14# You should have received a copy of the GNU General Public License version
15# 2 along with this work; if not, write to the Free Software Foundation,
16# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
17#
18# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
19# or visit www.oracle.com if you need additional information or have any
20# questions.
21
22##### Summary #####
23This test is used to check the interop compatibility on JSSE among different
24JDK releases. The oldest version supported by the test is JDK 8. Some of Java
25source files, like JdkInfoUtils.java, JdkProcServer.java and JdkProcClient.java,
26use only JDK 8-compliant language features and APIs, in order to allowing
27different JDK releases can load and run associated classes.
28
29##### Usage #####
30jtreg [-options] \
31 [-Dtest.debug=<true|false>] \
32 [-Dtest.jdk.list.file=</path/to/jdkListFile>] \
33 $JDK_WORKSPACE/test/jdk/javax/net/ssl/compatibility/<XXX.java>
34
35Besides the common jtreg options, like -jdk, this test introduces some more
36properties:
37test.debug
38 It indicates if the test enable -Djavax.net.debug=all. This is a boolean
39 property, and the default value is false.
40 It is not mandatory.
41
42test.jdk.list.file
43 It indicate the path of a file, which lists the absolute paths of different
44 JDK builds. If no this property, the current testing JDK, specified by JTREG
45 option -jdk, is used as the testing JDK.
46 It is not mandatory.
47
48##### Usage Examples #####
49$ cat /path/to/jdkList
50/path/to/jdk8
51/path/to/jdk9
52/path/to/jdk10
53
54$ jtreg -jdk:/path/to/latest/jdk \
55 -Ddebug=true \
56 -Dtest.jdk.list.file=/path/to/jdkList \
57 $JDK_WS/jdk/test/javax/net/ssl/compatibility/<XXX.java>
58The above example uses a file "/path/to/jdkList" to contain the paths of local
59different JDK builds through 8 to 10. The execution uses each of JDK builds as
60server and client respectively. And it enables SSL debug flag, and tests the
61full parameter value set.
62