\ listArg,\ T...\ elements)\ {
+\ \ \ \ for\ (T\ x\ :\ elements)\ {
+\ \ \ \ \ \ listArg.add(x);
+\ \ \ \ }
+\ \ }
+}
+\f[R]
+.fi
+.PP
+A non\-reifiable type is a type whose type information is not fully
+available at runtime.
+.PP
+The compiler generates the following warning for the definition of the
+method \f[CB]ArrayBuilder.addToList\f[R]:
+.IP
+.nf
+\f[CB]
+warning:\ [varargs]\ Possible\ heap\ pollution\ from\ parameterized\ vararg\ type\ T
+\f[R]
+.fi
+.PP
+When the compiler encounters a varargs method, it translates the
+\f[CB]varargs\f[R] formal parameter into an array.
+However, the Java programming language does not permit the creation of
+arrays of parameterized types.
+In the method \f[CB]ArrayBuilder.addToList\f[R], the compiler translates
+the \f[CB]varargs\f[R] formal parameter \f[CB]T...\f[R] elements to the
+formal parameter \f[CB]T[]\f[R] elements, an array.
+However, because of type erasure, the compiler converts the
+\f[CB]varargs\f[R] formal parameter to \f[CB]Object[]\f[R] elements.
+Consequently, there\[aq]s a possibility of heap pollution.
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/javadoc.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/javadoc.1
new file mode 100644
index 0000000..41f53c9
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/javadoc.1
@@ -0,0 +1,1282 @@
+.\" Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JAVADOC" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+javadoc \- generate HTML pages of API documentation from Java source
+files
+.SH SYNOPSIS
+.PP
+\f[CB]javadoc\f[R] [\f[I]options\f[R]] [\f[I]packagenames\f[R]]
+[\f[I]sourcefiles\f[R]] [\f[CB]\@\f[R]\f[I]files\f[R]]
+.TP
+.B \f[I]options\f[R]
+Specifies command\-line options, separated by spaces.
+See \f[B]Options for javadoc\f[R], \f[B]Extended Options\f[R],
+\f[B]Standard doclet Options\f[R], and \f[B]Additional Options Provided
+by the Standard doclet\f[R].
+.RS
+.RE
+.TP
+.B \f[I]packagenames\f[R]
+Specifies names of packages that you want to document, separated by
+spaces, for example \f[CB]java.lang\ java.lang.reflect\ java.awt\f[R].
+If you want to also document the subpackages, then use the
+\f[CB]\-subpackages\f[R] option to specify the packages.
+.RS
+.PP
+By default, \f[CB]javadoc\f[R] looks for the specified packages in the
+current directory and subdirectories.
+Use the \f[CB]\-sourcepath\f[R] option to specify the list of directories
+where to look for packages.
+.RE
+.TP
+.B \f[I]sourcefiles\f[R]
+Specifies names of Java source files that you want to document,
+separated by spaces, for example
+\f[CB]Class.java\ Object.java\ Button.java\f[R].
+By default, \f[CB]javadoc\f[R] looks for the specified classes in the
+current directory.
+However, you can specify the full path to the class file and use
+wildcard characters, for example
+\f[CB]/home/src/java/awt/Graphics*.java\f[R].
+You can also specify the path relative to the current directory.
+.RS
+.RE
+.TP
+.B \f[CB]\@\f[R]\f[I]files\f[R]
+Specifies names of files that contain a list of \f[CB]javadoc\f[R] tool
+options, package names, and source file names in any order.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]javadoc\f[R] tool parses the declarations and documentation
+comments in a set of Java source files and produces corresponding HTML
+pages that describe (by default) the public and protected classes,
+nested classes (but not anonymous inner classes), interfaces,
+constructors, methods, and fields.
+You can use the \f[CB]javadoc\f[R] tool to generate the API documentation
+or the implementation documentation for a set of source files.
+.PP
+You can run the \f[CB]javadoc\f[R] tool on entire packages, individual
+source files, or both.
+When documenting entire packages, you can use the \f[CB]\-subpackages\f[R]
+option either to recursively traverse a directory and its
+subdirectories, or to pass in an explicit list of package names.
+When you document individual source files, pass in a list of Java source
+file names.
+See \f[B]javadoc Overview\f[R]
+[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/13/tools&id=JSJAV\-GUID\-7A344353\-3BBF\-45C4\-8B28\-15025DDCC643]
+in Java Platform, Standard Edition Javadoc Guide for information about
+using the \f[CB]javadoc\f[R] tool.
+.SH CONFORMANCE
+.PP
+The standard doclet does not validate the content of documentation
+comments for conformance, nor does it attempt to correct any errors in
+documentation comments.
+Anyone running javadoc is advised to be aware of the problems that may
+arise when generating non\-conformant output or output containing
+executable content, such as JavaScript.
+The standard doclet does provide the \f[CB]doclint\f[R] feature to help
+developers detect common problems in documentation comments; but it is
+also recommended to check the generated output with any appropriate
+conformance and other checking tools.
+.PP
+For more details on the conformance requirements for HTML5 documents,
+see \f[B]Conformance requirements\f[R]
+[https://www.w3.org/TR/html5/infrastructure.html#conformance\-requirements]
+in the HTML5 Specification.
+For more details on security issues related to web pages, see the
+\f[B]Open Web Application Security Project (OWASP)\f[R]
+[https://www.owasp.org] page.
+.SH OPTIONS FOR JAVADOC
+.PP
+The following core \f[CB]javadoc\f[R] options are equivalent to
+corresponding \f[CB]javac\f[R] options.
+See \f[I]Standard Options\f[R] in \f[B]javac\f[R] for the detailed
+descriptions of using these options:
+.IP \[bu] 2
+\f[CB]\-\-add\-modules\f[R]
+.IP \[bu] 2
+\f[CB]\-bootclasspath\f[R]
+.IP \[bu] 2
+\f[CB]\-\-class\-path\f[R], \f[CB]\-classpath\f[R], or \f[CB]\-cp\f[R]
+.IP \[bu] 2
+\f[CB]\-\-enable\-preview\f[R]
+.IP \[bu] 2
+\f[CB]\-encoding\f[R]
+.IP \[bu] 2
+\f[CB]\-extdirs\f[R]
+.IP \[bu] 2
+\f[CB]\-\-limit\-modules\f[R]
+.IP \[bu] 2
+\f[CB]\-\-module\f[R]
+.IP \[bu] 2
+\f[CB]\-\-module\-path\f[R] or \f[CB]\-p\f[R]
+.IP \[bu] 2
+\f[CB]\-\-module\-source\-path\f[R]
+.IP \[bu] 2
+\f[CB]\-\-release\f[R]
+.IP \[bu] 2
+\f[CB]\-\-source\f[R] or \f[CB]\-source\f[R]
+.IP \[bu] 2
+\f[CB]\-\-source\-path\f[R] or \f[CB]\-sourcepath\f[R]
+.IP \[bu] 2
+\f[CB]\-\-system\f[R]
+.IP \[bu] 2
+\f[CB]\-\-upgrade\-module\-path\f[R]
+.PP
+The following options are the core \f[CB]javadoc\f[R] options that are not
+equivalent to a corresponding \f[CB]javac\f[R] option:
+.PP
+\f[B]Note:\f[R]
+.PP
+In tools that support \f[CB]\-\-\f[R] style options, the GNU\-style
+options can use the equal sign (=) instead of a white space to separate
+the name of an option from its value.
+.TP
+.B \f[CB]\-breakiterator\f[R]
+Computes the first sentence with \f[CB]BreakIterator\f[R].
+The first sentence is copied to the package, class, or member summary
+and to the alphabetic index.
+The \f[CB]BreakIterator\f[R] class is used to determine the end of a
+sentence for all languages except for English.
+.RS
+.IP \[bu] 2
+English default sentence\-break algorithm \-\-\- Stops at a period
+followed by a space or an HTML block tag, such as \f[CB]\f[R].
+.IP \[bu] 2
+Breakiterator sentence\-break algorithm \-\-\- Stops at a period,
+question mark, or exclamation point followed by a space when the next
+word starts with a capital letter.
+This is meant to handle most abbreviations (such as "The serial no.
+is valid", but will not handle "Mr.
+Smith").
+The \f[CB]\-breakiterator\f[R] option doesn\[aq]t stop at HTML tags or
+sentences that begin with numbers or symbols.
+The algorithm stops at the last period in \f[CB]\&../filename\f[R], even
+when embedded in an HTML tag.
+.RE
+.TP
+.B \f[CB]\-doclet\f[R] \f[I]class\f[R]
+Generates output by using an alternate doclet.
+Use the fully qualified name.
+This doclet defines the content and formats the output.
+If the \f[CB]\-doclet\f[R] option isn\[aq]t used, then the
+\f[CB]javadoc\f[R] tool uses the standard doclet for generating the
+default HTML format.
+This class must contain the \f[CB]start(Root)\f[R] method.
+The path to this starting class is defined by the \f[CB]\-docletpath\f[R]
+option.
+.RS
+.RE
+.TP
+.B \f[CB]\-docletpath\f[R] \f[I]path\f[R]
+Specifies where to find doclet class files (specified with the
+\f[CB]\-doclet\f[R] option) and any JAR files it depends on.
+If the starting class file is in a JAR file, then this option specifies
+the path to that JAR file.
+You can specify an absolute path or a path relative to the current
+directory.
+If \f[CB]classpathlist\f[R] contains multiple paths or JAR files, then
+they should be separated with a colon (\f[CB]:\f[R]) on Linux and a
+semi\-colon (\f[CB];\f[R]) on Windows.
+This option isn\[aq]t necessary when the \f[CB]doclet\f[R] starting class
+is already in the search path.
+.RS
+.RE
+.TP
+.B \f[CB]\-exclude\f[R] \f[I]pkglist\f[R]
+Unconditionally, excludes the specified packages and their subpackages
+from the list formed by \f[CB]\-subpackages\f[R].
+It excludes those packages even when they would otherwise be included by
+some earlier or later \f[CB]\-subpackages\f[R] option.
+.RS
+.PP
+The following example would include \f[CB]java.io\f[R],
+\f[CB]java.util\f[R], and \f[CB]java.math\f[R] (among others), but would
+exclude packages rooted at \f[CB]java.net\f[R] and \f[CB]java.lang\f[R].
+Notice that these examples exclude \f[CB]java.lang.ref\f[R], which is a
+subpackage of \f[CB]java.lang\f[R].
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-sourcepath\ /home/user/src\ \-subpackages\ java\ \-exclude\ java.net:java.lang\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-sourcepath\ \\user\\src\ \-subpackages\ java\ \-exclude\ java.net:java.lang\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-\-expand\-requires\f[R] \f[I]value\f[R]
+Instructs the javadoc tool to expand the set of modules to be
+documented.
+By default, only the modules given explicitly on the command line are
+documented.
+Supports the following values:
+.RS
+.IP \[bu] 2
+\f[CB]transitive\f[R]: additionally includes all the required transitive
+dependencies of those modules.
+.IP \[bu] 2
+\f[CB]all\f[R]: includes all dependencies.
+.RE
+.TP
+.B \f[CB]\-\-help\f[R], \f[CB]\-help\f[R], \f[CB]\-h\f[R], or \f[CB]\-?\f[R]
+Prints a synopsis of the standard options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R] or \f[CB]\-X\f[R]
+Prints a synopsis of the set of extra options.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]flag\f[R]
+Passes \f[I]flag\f[R] directly to the Java Runtime Environment (JRE) that
+runs the \f[CB]javadoc\f[R] tool.
+For example, if you must ensure that the system sets aside 32 MB of
+memory in which to process the generated documentation, then you would
+call the \f[CB]\-Xmx\f[R] option as follows:
+\f[CB]javadoc\ \-J\-Xmx32m\ \-J\-Xms32m\ com.mypackage\f[R].
+Be aware that \f[CB]\-Xms\f[R] is optional because it only sets the size
+of initial memory, which is useful when you know the minimum amount of
+memory required.
+.RS
+.PP
+There is no space between the \f[CB]J\f[R] and the \f[CB]flag\f[R].
+.PP
+Use the \f[CB]\-version\f[R] option to report the version of the JRE being
+used to run the \f[CB]javadoc\f[R] tool.
+.IP
+.nf
+\f[CB]
+javadoc\ \-J\-version
+java\ version\ "10\-ea"\ 2018\-03\-20
+Java(TM)\ SE\ Runtime\ Environment\ 18.3\ (build\ 10\-ea+36)
+Java\ HotSpot(TM)\ 64\-Bit\ Server\ VM\ 18.3\ (build\ 10\-ea+36,\ mixed\ mode)
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]\-locale\f[R] \f[I]name\f[R]
+Specifies the locale that the \f[CB]javadoc\f[R] tool uses when it
+generates documentation.
+The argument is the name of the locale, as described in
+\f[CB]java.util.Locale\f[R] documentation, such as \f[CB]en_US\f[R]
+(English, United States) or \f[CB]en_US_WIN\f[R] (Windows variant).
+.RS
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]\-locale\f[R] option must be placed ahead (to the left) of any
+options provided by the standard doclet or any other doclet.
+Otherwise, the navigation bars appear in English.
+This is the only command\-line option that depends on order.
+.PP
+Specifying a locale causes the \f[CB]javadoc\f[R] tool to choose the
+resource files of that locale for messages such as strings in the
+navigation bar, headings for lists and tables, help file contents,
+comments in the \f[CB]stylesheet.css\f[R] file, and so on.
+It also specifies the sorting order for lists sorted alphabetically, and
+the sentence separator to determine the end of the first sentence.
+The \f[CB]\-locale\f[R] option doesn\[aq]t determine the locale of the
+documentation comment text specified in the source files of the
+documented classes.
+.RE
+.TP
+.B \f[CB]\-package\f[R]
+Shows only package, protected, and public classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-private\f[R]
+Shows all classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-protected\f[R]
+Shows only protected and public classes and members.
+This is the default.
+.RS
+.RE
+.TP
+.B \f[CB]\-public\f[R]
+Shows only the public classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-quiet\f[R]
+Shuts off messages so that only the warnings and errors appear to make
+them easier to view.
+It also suppresses the \f[CB]version\f[R] string.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-members\f[R] \f[I]value\f[R]
+Specifies which members (fields or methods) are documented, where
+\f[I]value\f[R] can be any of the following:
+.RS
+.IP \[bu] 2
+\f[CB]protected\f[R]: The default value is protected.
+.IP \[bu] 2
+\f[CB]public\f[R]: Shows only public values.
+.IP \[bu] 2
+\f[CB]package\f[R]: Shows public, protected, and package members.
+.IP \[bu] 2
+\f[CB]private\f[R]: Shows all members.
+.RE
+.TP
+.B \f[CB]\-\-show\-module\-contents\f[R] \f[I]value\f[R]
+Specifies the documentation granularity of module declarations, where
+\f[I]value\f[R] can be \f[CB]api\f[R] or \f[CB]all\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-packages\f[R] \f[I]value\f[R]
+Specifies which modules packages are documented, where \f[I]value\f[R]
+can be \f[CB]exported\f[R] or \f[CB]all\f[R] packages.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-types\f[R] \f[I]value\f[R]
+Specifies which types (classes, interfaces, etc.) are documented, where
+\f[I]value\f[R] can be any of the following:
+.RS
+.IP \[bu] 2
+\f[CB]protected\f[R]: The default value.
+Shows public and protected types.
+.IP \[bu] 2
+\f[CB]public\f[R]: Shows only public values.
+.IP \[bu] 2
+\f[CB]package\f[R]: Shows public, protected, and package types.
+.IP \[bu] 2
+\f[CB]private\f[R]: Shows all types.
+.RE
+.TP
+.B \f[CB]\-subpackages\f[R] \f[I]subpkglist\f[R]
+Generates documentation from source files in the specified packages and
+recursively in their subpackages.
+This option is useful when adding new subpackages to the source code
+because they are automatically included.
+Each package argument is any top\-level subpackage (such as
+\f[CB]java\f[R]) or fully qualified package (such as \f[CB]javax.swing\f[R])
+that doesn\[aq]t need to contain source files.
+Arguments are separated by colons on all operating systems.
+Wild cards aren\[aq]t allowed.
+Use \f[CB]\-sourcepath\f[R] to specify where to find the packages.
+This option doesn\[aq]t process source files that are in the source tree
+but don\[aq]t belong to the packages.
+.RS
+.PP
+For example, the following commands generates documentation for packages
+named \f[CB]java\f[R] and \f[CB]javax.swing\f[R] and all of their
+subpackages.
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-d\ docs\ \-sourcepath\ /home/user/src\ \-subpackages\ java:javax.swing\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-d\ docs\ \-sourcepath\ \\user\\src\ \-subpackages\ java:javax.swing\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-verbose\f[R]
+Provides more detailed messages while the \f[CB]javadoc\f[R] tool runs.
+Without the \f[CB]\-verbose\f[R] option, messages appear for loading the
+source files, generating the documentation (one message per source
+file), and sorting.
+The \f[CB]\-verbose\f[R] option causes the printing of additional messages
+that specify the number of milliseconds to parse each Java source file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints version information.
+.RS
+.RE
+.TP
+.B \f[CB]\-Werror\f[R]
+Reports an error if any warnings occur.
+.RS
+.RE
+.SH EXTENDED OPTIONS
+.PP
+\f[B]Note:\f[R]
+.PP
+The extended options for \f[CB]javadoc\f[R] are subject to change without
+notice.
+.PP
+The following extended \f[CB]javadoc\f[R] options are equivalent to
+corresponding \f[CB]javac\f[R] options.
+See \f[I]Extra Options\f[R] in \f[B]javac\f[R] for the detailed
+descriptions of using these options:
+.IP \[bu] 2
+\f[CB]\-\-add\-exports\f[R]
+.IP \[bu] 2
+\f[CB]\-\-add\-reads\f[R]
+.IP \[bu] 2
+\f[CB]\-\-patch\-module\f[R]
+.IP \[bu] 2
+\f[CB]\-Xmaxerrs\f[R]
+.IP \[bu] 2
+\f[CB]\-Xmaxwarns\f[R]
+.SH STANDARD DOCLET OPTIONS
+.PP
+The following options are provided by the standard doclet.
+.TP
+.B \f[CB]\-\-add\-stylesheet\f[R] \f[I]file\f[R]
+Adds additional stylesheet file for the generated documentation.
+This option can be used one or more times to specify additional
+stylesheets included in the documentation.
+.RS
+.PP
+Command\-line example:
+.RS
+.PP
+\f[CB]javadoc\ \-\-add\-stylesheet\ new_stylesheet_1.css\ \-\-add\-stylesheet\ new_stylesheet_2.css\ pkg_foo\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-\-allow\-script\-in\-comments\f[R]
+Allow JavaScript in options and comments
+.RS
+.RE
+.TP
+.B \f[CB]\-author\f[R]
+Includes the \f[CB]\@author\f[R] text in the generated docs.
+.RS
+.RE
+.TP
+.B \f[CB]\-bottom\f[R] \f[I]html\-code\f[R]
+Specifies the text to be placed at the bottom of each output file.
+The text is placed at the bottom of the page, underneath the lower
+navigation bar.
+The text can contain HTML tags and white space, but when it does, the
+text must be enclosed in quotation marks.
+Use escape characters for any internal quotation marks within text.
+.RS
+.RE
+.TP
+.B \f[CB]\-charset\f[R] \f[I]name\f[R]
+Specifies the HTML character set for this document.
+The name should be a preferred MIME name as specified in the \f[B]IANA
+Registry, Character Sets\f[R]
+[http://www.iana.org/assignments/character\-sets].
+.RS
+.PP
+For example:
+.RS
+.PP
+\f[CB]javadoc\ \-charset\ "iso\-8859\-1"\ mypackage\f[R]
+.RE
+.PP
+This command inserts the following line in the head of every generated
+page:
+.RS
+.PP
+\f[CB]\f[R]
+.RE
+.PP
+The \f[CB]META\f[R] tag is described in the \f[B]HTML standard (4197265
+and 4137321), HTML Document Representation\f[R]
+[http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2].
+.RE
+.TP
+.B \f[CB]\-d\f[R] \f[I]directory\f[R]
+Specifies the destination directory where the \f[CB]javadoc\f[R] tool
+saves the generated HTML files.
+If you omit the \f[CB]\-d\f[R] option, then the files are saved to the
+current directory.
+The \f[CB]directory\f[R] value can be absolute or relative to the current
+working directory.
+The destination directory is automatically created when the
+\f[CB]javadoc\f[R] tool runs.
+.RS
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R] For example, the following command generates
+the documentation for the package \f[CB]com.mypackage\f[R] and saves the
+results in the \f[CB]/user/doc/\f[R] directory:
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-d\ /user/doc/\ com.mypackage\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R] For example, the following command generates the
+documentation for the package \f[CB]com.mypackage\f[R] and saves the
+results in the \f[CB]\\user\\doc\\\f[R] directory:
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-d\ \\user\\doc\\\ com.mypackage\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-docencoding\f[R] \f[I]name\f[R]
+Specifies the encoding of the generated HTML files.
+The name should be a preferred MIME name as specified in the \f[B]IANA
+Registry, Character Sets\f[R]
+[http://www.iana.org/assignments/character\-sets].
+.RS
+.PP
+Three options are available for use in a \f[CB]javadoc\f[R] encoding
+command.
+The \f[CB]\-encoding\f[R] option is used for encoding the files read by
+the \f[CB]javadoc\f[R] tool, while the \f[CB]\-docencoding\f[R] and
+\f[CB]\-charset\f[R] options are used for encoding the files written by
+the tool.
+Of the three available options, at most, only the input and an output
+encoding option are used in a single encoding command.
+If you specify both input and output encoding options in a command, they
+must be the same value.
+If you specify neither output option, it the tool defaults to the input
+encoding.
+.PP
+For example:
+.RS
+.PP
+\f[CB]javadoc\ \-docencoding\ "iso\-8859\-1"\ mypackage\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-docfilessubdirs\f[R]
+Recursively copies doc\-file subdirectories.
+.RS
+.RE
+.TP
+.B \f[CB]\-doctitle\f[R] \f[I]html\-code\f[R]
+Specifies the title to place near the top of the overview summary file.
+The text specified in the \f[CB]title\f[R] tag is placed as a centered,
+level\-one heading directly beneath the top navigation bar.
+The \f[CB]title\f[R] tag can contain HTML tags and white space, but when
+it does, you must enclose the title in quotation marks.
+Additional quotation marks within the \f[CB]title\f[R] tag must be
+escaped.
+For example,
+\f[CB]javadoc\ \-doctitle\ "My\ Library
v1.0"\ com.mypackage.\f[R]
+.RS
+.RE
+.TP
+.B \f[CB]\-excludedocfilessubdir\f[R] \f[I]name\f[R]
+Excludes any doc files sub directories with the given name.
+Enables deep copying of doc\-files directories.
+Subdirectories and all contents are recursively copied to the
+destination.
+For example, the directory \f[CB]doc\-files/example/images\f[R] and all of
+its contents are copied.
+There is also an option to exclude subdirectories.
+.RS
+.RE
+.TP
+.B \f[CB]\-footer\f[R] \f[I]html\-code\f[R]
+Specifies the footer text to be placed at the bottom of each output
+file.
+The\f[CB]html\-code\f[R] value is placed to the right of the lower
+navigation bar.
+The \f[CB]html\-code\f[R] value can contain HTML tags and white space, but
+when it does, the \f[CB]html\-code\f[R] value must be enclosed in
+quotation marks.
+Use escape characters for any internal quotation marks within a footer.
+.RS
+.RE
+.TP
+.B \f[CB]\-group\f[R] \f[I]namep1\f[R]\f[CB]:\f[R]\f[I]p2\f[R]
+Group the specified packages together in the Overview page.
+.RS
+.RE
+.TP
+.B \f[CB]\-header\f[R] \f[I]html\-code\f[R]
+Specifies the header text to be placed at the top of each output file.
+The header is placed to the right of the upper navigation bar.
+The \f[CB]header\f[R] can contain HTML tags and white space, but when it
+does, the \f[CB]header\f[R] must be enclosed in quotation marks.
+Use escape characters for internal quotation marks within a header.
+For example,
+\f[CB]javadoc\ \-header\ "My\ Library
v1.0"\ com.mypackage.\f[R]
+.RS
+.RE
+.TP
+.B \f[CB]\-helpfile\f[R] \f[I]filename\f[R]
+Includes the file that links to the \f[B]HELP\f[R] link in the top and
+bottom navigation bars .
+Without this option, the \f[CB]javadoc\f[R] tool creates a help file
+\f[CB]help\-doc.html\f[R] that is hard\-coded in the \f[CB]javadoc\f[R]
+tool.
+This option lets you override the default.
+The \f[I]filename\f[R] can be any name and isn\[aq]t restricted to
+\f[CB]help\-doc.html\f[R].
+The \f[CB]javadoc\f[R] tool adjusts the links in the navigation bar
+accordingly.
+For example:
+.RS
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-helpfile\ /home/user/myhelp.html\ java.awt.\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-helpfile\ C:\\user\\myhelp.html\ java.awt.\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-html5\f[R]
+This option is a no\-op and is just retained for backwards
+compatibility.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-javafx\f[R] or \f[CB]\-javafx\f[R]
+Enables JavaFX functionality.
+.RS
+.RE
+.TP
+.B \f[CB]\-keywords\f[R]
+Adds HTML keyword \f[CB]\f[R] tags to the generated file for each
+class.
+These tags can help search engines that look for \f[CB]\f[R] tags
+find the pages.
+Most search engines that search the entire Internet don\[aq]t look at
+\f[CB]\f[R] tags, because pages can misuse them.
+Search engines offered by companies that confine their searches to their
+own website can benefit by looking at \f[CB]\f[R] tags.
+The \f[CB]\f[R] tags include the fully qualified name of the class
+and the unqualified names of the fields and methods.
+Constructors aren\[aq]t included because they are identical to the class
+name.
+For example, the class \f[CB]String\f[R] starts with these keywords:
+.RS
+.IP
+.nf
+\f[CB]
+
+
+
+
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]\-link\f[R] \f[I]url\f[R]
+Creates links to existing \f[CB]javadoc\f[R] generated documentation of
+externally referenced classes.
+The \f[I]url\f[R] argument is the absolute or relative URL of the
+directory that contains the external \f[CB]javadoc\f[R] generated
+documentation.
+You can specify multiple \f[CB]\-link\f[R] options in a specified
+\f[CB]javadoc\f[R] tool run to link to multiple documents.
+.RS
+.PP
+Either a \f[CB]package\-list\f[R] or an \f[CB]element\-list\f[R] file must
+be in this \f[I]url\f[R] directory (otherwise, use the
+\f[CB]\-linkoffline\f[R] option).
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]package\-list\f[R] and \f[CB]element\-list\f[R] files are
+generated by the \f[CB]javadoc\f[R] tool when generating the API
+documentation and should not be modified by the user.
+.PP
+When you use the \f[CB]javadoc\f[R] tool to document packages, it uses the
+\f[CB]package\-list\f[R] file to determine the packages declared in an
+API.
+When you generate API documents for modules, the \f[CB]javadoc\f[R] tool
+uses the \f[CB]element\-list\f[R] file to determine the modules and
+packages declared in an API.
+.PP
+The \f[CB]javadoc\f[R] tool reads the names from the appropriate list file
+and then links to the packages or modules at that URL.
+.PP
+When the \f[CB]javadoc\f[R] tool runs, the \f[I]url\f[R] value is copied
+into the \f[CB]\f[R] links that are created.
+Therefore, \f[I]url\f[R] must be the URL to the directory and not to a
+file.
+.PP
+You can use an absolute link for \f[I]url\f[R] to enable your documents
+to link to a document on any web site, or you can use a relative link to
+link only to a relative location.
+If you use a relative link, then the value you pass in should be the
+relative path from the destination directory (specified with the
+\f[CB]\-d\f[R] option) to the directory containing the packages being
+linked to.
+When you specify an absolute link, you usually use an HTTP link.
+However, if you want to link to a file system that has no web server,
+then you can use a file link.
+Use a file link only when everyone who wants to access the generated
+documentation shares the same file system.
+In all cases, and on all operating systems, use a slash as the
+separator, whether the URL is absolute or relative, and \f[CB]https:\f[R],
+\f[CB]http:\f[R], or \f[CB]file:\f[R] as specified in the \f[B]URL Memo:
+Uniform Resource Locators\f[R] [http://www.ietf.org/rfc/rfc1738.txt].
+.IP
+.nf
+\f[CB]
+\-link\ https://///.../
+\-link\ http://///.../
+\-link\ file://///.../
+\-link\ //.../
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]\-linkoffline\f[R] \f[I]url1\f[R] \f[I]url2\f[R]
+This option is a variation of the \f[CB]\-link\f[R] option.
+They both create links to \f[CB]javadoc\f[R] generated documentation for
+externally referenced classes.
+You can specify multiple \f[CB]\-linkoffline\f[R] options in a specified
+\f[CB]javadoc\f[R] tool run.
+.RS
+.PP
+Use the \f[CB]\-linkoffline\f[R] option when:
+.IP \[bu] 2
+Linking to a document on the web that the \f[CB]javadoc\f[R] tool
+can\[aq]t access through a web connection
+.IP \[bu] 2
+The \f[CB]package\-list\f[R] or \f[CB]element\-list\f[R] file of the
+external document either isn\[aq]t accessible or doesn\[aq]t exist at
+the URL location, but does exist at a different location and can be
+specified by either the \f[CB]package\-list\f[R] or \f[CB]element\-list\f[R]
+file (typically local).
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]package\-list\f[R] and \f[CB]element\-list\f[R] files are
+generated by the \f[CB]javadoc\f[R] tool when generating the API
+documentation and should not be modified by the user.
+.PP
+If \f[I]url1\f[R] is accessible only on the World Wide Web, then the
+\f[CB]\-linkoffline\f[R] option removes the constraint that the
+\f[CB]javadoc\f[R] tool must have a web connection to generate
+documentation.
+.PP
+Another use of the \f[CB]\-linkoffline\f[R] option is as a work\-around to
+update documents.
+After you have run the \f[CB]javadoc\f[R] tool on a full set of packages
+or modules, you can run the \f[CB]javadoc\f[R] tool again on a smaller set
+of changed packages or modules, so that the updated files can be
+inserted back into the original set.
+.PP
+For example, the \f[CB]\-linkoffline\f[R] option takes two arguments.
+The first is for the string to be embedded in the \f[CB]\f[R]
+links, and the second tells the \f[CB]javadoc\f[R] tool where to find
+either the \f[CB]package\-list\f[R] or \f[CB]element\-list\f[R] file.
+.PP
+The \f[I]url1\f[R] or \f[I]url2\f[R] value is the absolute or relative URL
+of the directory that contains the external \f[CB]javadoc\f[R] generated
+documentation that you want to link to.
+When relative, the value should be the relative path from the
+destination directory (specified with the \f[CB]\-d\f[R] option) to the
+root of the packages being linked to.
+See \f[I]url\f[R] in the \f[CB]\-link\f[R] option.
+.RE
+.TP
+.B \f[CB]\-linksource\f[R]
+Creates an HTML version of each source file (with line numbers) and adds
+links to them from the standard HTML documentation.
+Links are created for classes, interfaces, constructors, methods, and
+fields whose declarations are in a source file.
+Otherwise, links aren\[aq]t created, such as for default constructors
+and generated classes.
+.RS
+.PP
+This option exposes all private implementation details in the included
+source files, including private classes, private fields, and the bodies
+of private methods, regardless of the \f[CB]\-public\f[R],
+\f[CB]\-package\f[R], \f[CB]\-protected\f[R], and \f[CB]\-private\f[R]
+options.
+Unless you also use the \f[CB]\-private\f[R] option, not all private
+classes or interfaces are accessible through links.
+.PP
+Each link appears on the name of the identifier in its declaration.
+For example, the link to the source code of the \f[CB]Button\f[R] class
+would be on the word \f[CB]Button\f[R]:
+.RS
+.PP
+\f[CB]public\ class\ Button\ extends\ Component\ implements\ Accessible\f[R]
+.RE
+.PP
+The link to the source code of the \f[CB]getLabel\f[R] method in the
+\f[CB]Button\f[R] class is on the word \f[CB]getLabel\f[R]:
+.RS
+.PP
+\f[CB]public\ String\ getLabel()\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-\-main\-stylesheet\f[R] \f[I]file\f[R] or \f[CB]\-stylesheetfile\f[R] \f[I]file\f[R]
+Specifies the path of an alternate stylesheet file that contains the
+definitions for the CSS styles used in the generated documentation.
+This option lets you override the default.
+If you do not specify the option, the \f[CB]javadoc\f[R] tool will create
+and use a default stylesheet.
+The file name can be any name and isn\[aq]t restricted to
+\f[CB]stylesheet.css\f[R].
+The \f[CB]\-\-main\-stylesheet\f[R] option is the preferred form.
+.RS
+.PP
+Command\-line example:
+.RS
+.PP
+\f[CB]javadoc\ \-\-main\-stylesheet\ main_stylesheet.css\ pkg_foo\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-nocomment\f[R]
+Suppresses the entire comment body, including the main description and
+all tags, and generate only declarations.
+This option lets you reuse source files that were originally intended
+for a different purpose so that you can produce skeleton HTML
+documentation during the early stages of a new project.
+.RS
+.RE
+.TP
+.B \f[CB]\-nodeprecated\f[R]
+Prevents the generation of any deprecated API in the documentation.
+This does what the \f[CB]\-nodeprecatedlist\f[R] option does, and it
+doesn\[aq]t generate any deprecated API throughout the rest of the
+documentation.
+This is useful when writing code when you don\[aq]t want to be
+distracted by the deprecated code.
+.RS
+.RE
+.TP
+.B \f[CB]\-nodeprecatedlist\f[R]
+Prevents the generation of the file that contains the list of deprecated
+APIs (\f[CB]deprecated\-list.html\f[R]) and the link in the navigation bar
+to that page.
+The \f[CB]javadoc\f[R] tool continues to generate the deprecated API
+throughout the rest of the document.
+This is useful when your source code contains no deprecated APIs, and
+you want to make the navigation bar cleaner.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-no\-frames\f[R]
+This option is a no\-op and is just retained for backwards
+compatibility.
+.RS
+.RE
+.TP
+.B \f[CB]\-nohelp\f[R]
+Omits the HELP link in the navigation bars at the top and bottom of each
+page of output.
+.RS
+.RE
+.TP
+.B \f[CB]\-noindex\f[R]
+Omits the index from the generated documents.
+The index is produced by default.
+.RS
+.RE
+.TP
+.B \f[CB]\-nonavbar\f[R]
+Prevents the generation of the navigation bar, header, and footer, that
+are usually found at the top and bottom of the generated pages.
+The \f[CB]\-nonavbar\f[R] option has no affect on the \f[CB]\-bottom\f[R]
+option.
+The \f[CB]\-nonavbar\f[R] option is useful when you are interested only in
+the content and have no need for navigation, such as when you are
+converting the files to PostScript or PDF for printing only.
+.RS
+.RE
+.TP
+.B \f[CB]\-noqualifier\f[R] \f[I]name1\f[R]\f[CB]:\f[R]\f[I]name2\f[R]...
+Excludes the list of qualifiers from the output.
+The package name is removed from places where class or interface names
+appear.
+.RS
+.PP
+The following example omits all package qualifiers:
+\f[CB]\-noqualifier\ all\f[R].
+.PP
+The following example omits \f[CB]java.lang\f[R] and \f[CB]java.io\f[R]
+package qualifiers: \f[CB]\-noqualifier\ java.lang:java.io\f[R].
+.PP
+The following example omits package qualifiers starting with
+\f[CB]java\f[R] and \f[CB]com.sun\f[R] subpackages, but not
+\f[CB]javax:\ \-noqualifier\ java.*:com.sun.*\f[R].
+.PP
+Where a package qualifier would appear due to the previous behavior, the
+name can be suitably shortened.
+This rule is in effect whether or not the \f[CB]\-noqualifier\f[R] option
+is used.
+.RE
+.TP
+.B \f[CB]\-nosince\f[R]
+Omits from the generated documents the \f[CB]Since\f[R] sections
+associated with the \f[CB]\@since\f[R] tags.
+.RS
+.RE
+.TP
+.B \f[CB]\-notimestamp\f[R]
+Suppresses the time stamp, which is hidden in an HTML comment in the
+generated HTML near the top of each page.
+The \f[CB]\-notimestamp\f[R] option is useful when you want to run the
+\f[CB]javadoc\f[R] tool on two source bases and get the differences
+between \f[CB]diff\f[R] them, because it prevents time stamps from causing
+a \f[CB]diff\f[R] (which would otherwise be a \f[CB]diff\f[R] on every
+page).
+The time stamp includes the \f[CB]javadoc\f[R] tool release number.
+.RS
+.RE
+.TP
+.B \f[CB]\-notree\f[R]
+Omits the class and interface hierarchy pages from the generated
+documents.
+These are the pages you reach using the Tree button in the navigation
+bar.
+The hierarchy is produced by default.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-override\-methods\f[R] (\f[CB]detail\f[R]|\f[CB]summary\f[R])
+Documents overridden methods in the detail or summary sections.
+.RS
+.RE
+.TP
+.B \f[CB]\-overview\f[R] \f[I]filename\f[R]
+Specifies that the \f[CB]javadoc\f[R] tool should retrieve the text for
+the overview documentation from the source file specified by
+\f[CB]filename\f[R] and place it on the Overview page
+(\f[CB]overview\-summary.html\f[R]).
+A relative path specified with the file name is relative to the current
+working directory.
+.RS
+.PP
+While you can use any name you want for the \f[CB]filename\f[R] value and
+place it anywhere you want for the path, it is typical to name it
+\f[CB]overview.html\f[R] and place it in the source tree at the directory
+that contains the topmost package directories.
+In this location, no path is needed when documenting packages, because
+the \f[CB]\-sourcepath\f[R] option points to this file.
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R] For example, if the source tree for the
+\f[CB]java.lang\f[R] package is \f[CB]/src/classes/java/lang/\f[R], then you
+could place the overview file at /src/classes/overview.html.
+.IP \[bu] 2
+\f[B]Windows:\f[R] For example, if the source tree for the
+\f[CB]java.lang\f[R] package is \f[CB]\\src\\classes\\java\\lang\\\f[R],
+then you could place the overview file at
+\f[CB]\\src\\classes\\overview.html\f[R]
+.PP
+The overview page is created only when you pass two or more package
+names to the \f[CB]javadoc\f[R] tool.
+The title on the overview page is set by \f[CB]\-doctitle\f[R].
+.RE
+.TP
+.B \f[CB]\-serialwarn\f[R]
+Generates compile\-time warnings for missing \f[CB]\@serial\f[R] tags.
+By default, Javadoc generates no serial warnings.
+Use this option to display the serial warnings, which helps to properly
+document default serializable fields and \f[CB]writeExternal\f[R] methods.
+.RS
+.RE
+.TP
+.B \f[CB]\-sourcetab\f[R] \f[I]tablength\f[R]
+Specifies the number of spaces each tab uses in the source.
+.RS
+.RE
+.TP
+.B \f[CB]\-splitindex\f[R]
+Splits the index file into multiple files, alphabetically, one file per
+letter, plus a file for any index entries that start with
+non\-alphabetical symbols.
+.RS
+.RE
+.TP
+.B \f[CB]\-tag\f[R] \f[I]name\f[R]:\f[I]locations\f[R]:\f[I]header\f[R]
+Specifies single argument custom tags.
+For the \f[CB]javadoc\f[R] tool to spell\-check tag names, it is important
+to include a \f[CB]\-tag\f[R] option for every custom tag that is present
+in the source code, disabling (with \f[CB]X\f[R]) those that aren\[aq]t
+being output in the current run.
+The colon (\f[CB]:\f[R]) is always the separator.
+The \f[CB]\-tag\f[R] option outputs the tag heading, \f[I]header\f[R], in
+bold, followed on the next line by the text from its single argument.
+Similar to any block tag, the argument text can contain inline tags,
+which are also interpreted.
+The output is similar to standard one\-argument tags, such as the
+\f[CB]\@return\f[R] and \f[CB]\@author\f[R] tags.
+Omitting a \f[I]header\f[R] value causes the \f[I]name\f[R] to be the
+heading.
+.RS
+.RE
+.TP
+.B \f[CB]\-taglet\f[R] \f[I]class\f[R]
+Specifies the fully qualified name of the taglet used in generating the
+documentation for that tag.
+Use the fully qualified name for the \f[I]class\f[R] value.
+This taglet also defines the number of text arguments that the custom
+tag has.
+The taglet accepts those arguments, processes them, and generates the
+output.
+.RS
+.PP
+Taglets are useful for block or inline tags.
+They can have any number of arguments and implement custom behavior,
+such as making text bold, formatting bullets, writing out the text to a
+file, or starting other processes.
+Taglets can only determine where a tag should appear and in what form.
+All other decisions are made by the doclet.
+A taglet can\[aq]t do things such as remove a class name from the list
+of included classes.
+However, it can execute side effects, such as printing the tag\[aq]s
+text to a file or triggering another process.
+Use the \f[CB]\-tagletpath\f[R] option to specify the path to the taglet.
+The following example inserts the To Do taglet after Parameters and
+ahead of Throws in the generated pages.
+.IP
+.nf
+\f[CB]
+\-taglet\ com.sun.tools.doclets.ToDoTaglet
+\-tagletpath\ /home/taglets
+\-tag\ return
+\-tag\ param
+\-tag\ todo
+\-tag\ throws
+\-tag\ see
+\f[R]
+.fi
+.PP
+Alternately, you can use the \f[CB]\-taglet\f[R] option in place of its
+\f[CB]\-tag\f[R] option, but that might be difficult to read.
+.RE
+.TP
+.B \f[CB]\-tagletpath\f[R] \f[I]tagletpathlist\f[R]
+Specifies the search paths for finding taglet class files.
+The \f[I]tagletpathlist\f[R] can contain multiple paths by separating
+them with the platform path separator (\f[CB];\f[R] on Windows; \f[CB]:\f[R]
+on other platforms.) The \f[CB]javadoc\f[R] tool searches all
+subdirectories of the specified paths.
+.RS
+.RE
+.TP
+.B \f[CB]\-top\f[R] \f[I]html\-code\f[R]
+Specifies the text to be placed at the top of each output file.
+.RS
+.RE
+.TP
+.B \f[CB]\-use\f[R]
+Creates class and package usage pages.
+Includes one Use page for each documented class and package.
+The page describes what packages, classes, methods, constructors and
+fields use any API of the specified class or package.
+Given class C, things that use class C would include subclasses of C,
+fields declared as C, methods that return C, and methods and
+constructors with parameters of type C.
+For example, you can look at the Use page for the \f[CB]String\f[R] type.
+Because the \f[CB]getName\f[R] method in the \f[CB]java.awt.Font\f[R] class
+returns type \f[CB]String\f[R], the \f[CB]getName\f[R] method uses
+\f[CB]String\f[R] and so the \f[CB]getName\f[R] method appears on the Use
+page for \f[CB]String\f[R].
+This documents only uses of the API, not the implementation.
+When a method uses \f[CB]String\f[R] in its implementation, but
+doesn\[aq]t take a string as an argument or return a string, that
+isn\[aq]t considered a use of \f[CB]String\f[R].To access the generated
+Use page, go to the class or package and click the \f[B]Use link\f[R] in
+the navigation bar.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R]
+Includes the version text in the generated docs.
+This text is omitted by default.
+To find out what version of the \f[CB]javadoc\f[R] tool you are using, use
+the \f[CB]\-J\-version\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-windowtitle\f[R] \f[I]title\f[R]
+Specifies the title to be placed in the HTML \f[CB]\f[R] tag.
+The text specified in the \f[CB]title\f[R] tag appears in the window title
+and in any browser bookmarks (favorite places) that someone creates for
+this page.
+This title shouldn\[aq]t contain any HTML tags because the browser
+doesn\[aq]t interpret them correctly.
+Use escape characters on any internal quotation marks within the
+\f[CB]title\f[R] tag.
+If the \f[CB]\-windowtitle\f[R] option is omitted, then the
+\f[CB]javadoc\f[R] tool uses the value of the \f[CB]\-doctitle\f[R] option
+for the \f[CB]\-windowtitle\f[R] option.
+For example,
+\f[CB]javadoc\ \-windowtitle\ "My\ Library"\ com.mypackage\f[R].
+.RS
+.RE
+.SH ADDITIONAL OPTIONS PROVIDED BY THE STANDARD DOCLET
+.PP
+The following are additional options provided by the standard doclet and
+are subject to change without notice.
+Additional options are less commonly used or are otherwise regarded as
+advanced.
+.TP
+.B \f[CB]\-Xdoclint\f[R]
+Enables recommended checks for problems in documentation comments.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdoclint:\f[R](\f[CB]all\f[R]|\f[CB]none\f[R]|[\f[CB]\-\f[R]]\f[I]group\f[R])
+Enable or disable specific checks for bad references, accessibility
+issues, missing documentation comments, errors in documentation comment
+syntax and missing HTML tags.
+.RS
+.PP
+This option enables the \f[CB]javadoc\f[R] tool to check for all
+documentation comments included in the generated output.
+You can select which items to include in the generated output with the
+standard options \f[CB]\-public\f[R], \f[CB]\-protected\f[R],
+\f[CB]\-package\f[R] and \f[CB]\-private\f[R].
+.PP
+When the \f[CB]\-Xdoclint\f[R] option is enabled, it reports issues with
+messages similar to the \f[CB]javac\f[R] command.
+The \f[CB]javadoc\f[R] tool prints a message, a copy of the source line,
+and a caret pointing at the exact position where the error was detected.
+Messages may be either warnings or errors, depending on their severity
+and the likelihood to cause an error if the generated documentation were
+to be run through a validator.
+For example: missing documentation comments, duplicate information, and
+extraneous comments do not cause the \f[CB]javadoc\f[R] tool to generate
+invalid HTML, so these issues are reported as warnings; syntax errors,
+missing required HTML end tags, and references to missing or misspelled
+elements cause the \f[CB]javadoc\f[R] tool to generate invalid output, so
+these issues are reported as errors.
+.PP
+\f[CB]\-Xdoclint\f[R] option validates input comments based upon the
+requested markup.
+.PP
+By default, the \f[CB]\-Xdoclint\f[R] option is enabled.
+Disable it with the option \f[CB]\-Xdoclint:none\f[R].
+.PP
+The following options change what the \f[CB]\-Xdoclint\f[R] option
+reports:
+.IP \[bu] 2
+\f[CB]\-Xdoclint\ none\f[R]: Disables the \f[CB]\-Xdoclint\f[R] option
+.IP \[bu] 2
+\f[CB]\-Xdoclint\f[R] \f[I]group\f[R]: Enables \f[I]group\f[R] checks
+.IP \[bu] 2
+\f[CB]\-Xdoclint\ all\f[R]: Enables all groups of checks
+.IP \[bu] 2
+\f[CB]\-Xdoclint\ all,\-\f[R]\f[I]group\f[R]: Enables all checks except
+\f[I]group\f[R] checks
+.PP
+The \f[I]group\f[R] variable has one of the following values:
+.IP \[bu] 2
+\f[CB]accessibility\f[R]: Checks for the issues to be detected by an
+accessibility checker (for example, no caption or summary attributes
+specified in a \f[CB]<table>\f[R] tag).
+.IP \[bu] 2
+\f[CB]html\f[R]: Detects high\-level HTML issues, such as putting block
+elements inside inline elements, or not closing elements that require an
+end tag.
+The rules are derived from the \f[B]HTML 4 Specification\f[R]
+[https://www.w3.org/TR/html4/] or the \f[B]HTML 5 Specification\f[R]
+[http://www.w3.org/TR/2014/REC\-html5\-20141028/] based on the standard
+doclet \f[CB]html\f[R] output generation selected.
+This type of check enables the \f[CB]javadoc\f[R] tool to detect HTML
+issues that some browsers might not interpret as intended.
+.IP \[bu] 2
+\f[CB]missing\f[R]: Checks for missing documentation comments or tags (for
+example, a missing comment or class, or a missing \f[CB]\@return\f[R] tag
+or similar tag on a method).
+.IP \[bu] 2
+\f[CB]reference\f[R]: Checks for issues relating to the references to Java
+API elements from documentation comment tags (for example, item not
+found in \f[CB]\@see\f[R], or a bad name after \f[CB]\@param)\f[R].
+.IP \[bu] 2
+\f[CB]syntax\f[R]: Checks for low level issues like unescaped angle
+brackets (\f[CB]<\f[R] and \f[CB]>\f[R]) and ampersands (\f[CB]&\f[R]) and
+invalid documentation comment tags.
+.PP
+You can specify the \f[CB]\-Xdoclint\f[R] option multiple times to enable
+the option to check errors and warnings in multiple categories.
+Alternatively, you can specify multiple error and warning categories by
+using the preceding options.
+For example, use either of the following commands to check for the HTML,
+syntax, and accessibility issues in the file \f[I]filename\f[R].
+.RS
+.PP
+\f[CB]javadoc\ \-Xdoclint:html\ \-Xdoclint:syntax\ \-Xdoclint:accessibility\f[R]
+\f[I]filename\f[R]
+.RE
+.RS
+.PP
+\f[CB]javadoc\ \-Xdoclint:html,syntax,accessibility\f[R] \f[I]filename\f[R]
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]javadoc\f[R] tool doesn\[aq]t guarantee the completeness of
+these checks.
+In particular, it isn\[aq]t a full HTML compliance checker.
+The goal of the \-\f[CB]Xdoclint\f[R] option is to enable the
+\f[CB]javadoc\f[R] tool to report majority of common errors.
+.PP
+The \f[CB]javadoc\f[R] tool doesn\[aq]t attempt to fix invalid input, it
+just reports it.
+.RE
+.TP
+.B \f[CB]\-Xdoclint/package:\f[R][\f[CB]\-\f[R]]\f[I]packages\f[R]
+Enables or disables checks in specific packages.
+\f[I]packages\f[R] is a comma separated list of package specifiers.
+A package specifier is either a qualified name of a package or a package
+name prefix followed by \f[CB]*\f[R], which expands to all sub packages of
+the given package.
+Prefix the package specifier with \f[CB]\-\f[R] to disable checks for the
+specified packages.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdocrootparent\f[R] \f[I]url\f[R]
+Replaces all \f[CB]\@docRoot\f[R] items followed by\f[CB]/..\f[R] in Javadoc
+comments with the \f[I]url\f[R].
+.RS
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/javap.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/javap.1
new file mode 100644
index 0000000..f62b8a0
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/javap.1
@@ -0,0 +1,280 @@
+.\" Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JAVAP" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+javap \- disassemble one or more class files
+.SH SYNOPSIS
+.PP
+\f[CB]javap\f[R] [\f[I]options\f[R]] \f[I]classes\f[R]...
+.TP
+.B \f[I]options\f[R]
+Specifies the command\-line options.
+See \f[B]Options for javap\f[R].
+.RS
+.RE
+.TP
+.B \f[I]classes\f[R]
+Specifies one or more classes separated by spaces to be processed for
+annotations.
+You can specify a class that can be found in the class path by its file
+name, URL, or by its fully qualified class name.
+.RS
+.PP
+Examples:
+.RS
+.PP
+\f[CB]path/to/MyClass.class\f[R]
+.RE
+.RS
+.PP
+\f[CB]jar:file:///path/to/MyJar.jar!/mypkg/MyClass.class\f[R]
+.RE
+.RS
+.PP
+\f[CB]java.lang.Object\f[R]
+.RE
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]javap\f[R] command disassembles one or more class files.
+The output depends on the options used.
+When no options are used, the \f[CB]javap\f[R] command prints the
+protected and public fields, and methods of the classes passed to it.
+.PP
+The \f[CB]javap\f[R] command isn\[aq]t multirelease JAR aware.
+Using the class path form of the command results in viewing the base
+entry in all JAR files, multirelease or not.
+Using the URL form, you can use the URL form of an argument to specify a
+specific version of a class to be disassembled.
+.PP
+The \f[CB]javap\f[R] command prints its output to \f[CB]stdout\f[R].
+.PP
+\f[B]Note:\f[R]
+.PP
+In tools that support \f[CB]\-\-\f[R] style options, the GNU\-style
+options can use the equal sign (\f[CB]=\f[R]) instead of a white space to
+separate the name of an option from its value.
+.SH OPTIONS FOR JAVAP
+.TP
+.B \f[CB]\-\-help\f[R], \f[CB]\-help\f[R] , \f[CB]\-h\f[R], or \f[CB]\-?\f[R]
+Prints a help message for the \f[CB]javap\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R]
+Prints release information.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose\f[R] or \f[CB]\-v\f[R]
+Prints additional information about the selected class.
+.RS
+.RE
+.TP
+.B \f[CB]\-l\f[R]
+Prints line and local variable tables.
+.RS
+.RE
+.TP
+.B \f[CB]\-public\f[R]
+Shows only public classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-protected\f[R]
+Shows only protected and public classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-package\f[R]
+Shows package/protected/public classes and members (default).
+.RS
+.RE
+.TP
+.B \f[CB]\-private\f[R] or \f[CB]\-p\f[R]
+Shows all classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-c\f[R]
+Prints disassembled code, for example, the instructions that comprise
+the Java bytecodes, for each of the methods in the class.
+.RS
+.RE
+.TP
+.B \f[CB]\-s\f[R]
+Prints internal type signatures.
+.RS
+.RE
+.TP
+.B \f[CB]\-sysinfo\f[R]
+Shows system information (path, size, date, SHA\-256 hash) of the class
+being processed.
+.RS
+.RE
+.TP
+.B \f[CB]\-constants\f[R]
+Shows \f[CB]static\ final\f[R] constants.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\f[R] \f[I]module\f[R] or \f[CB]\-m\f[R] \f[I]module\f[R]
+Specifies the module containing classes to be disassembled.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]path\f[R]
+Specifies where to find application modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-system\f[R] \f[I]jdk\f[R]
+Specifies where to find system modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-cp\f[R] \f[I]path\f[R]
+Specifies the path that the \f[CB]javap\f[R] command uses to find user
+class files.
+It overrides the default or the \f[CB]CLASSPATH\f[R] environment variable
+when it\[aq]s set.
+.RS
+.RE
+.TP
+.B \f[CB]\-bootclasspath\f[R] \f[I]path\f[R]
+Overrides the location of bootstrap class files.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-multi\-release\f[R] \f[I]version\f[R]
+Specifies the version to select in multi\-release JAR files.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Passes the specified option to the JVM.
+For example:
+.RS
+.IP
+.nf
+\f[CB]
+javap\ \-J\-version
+
+javap\ \-J\-Djava.security.manager\ \-J\-Djava.security.policy=MyPolicy\ MyClassName
+\f[R]
+.fi
+.PP
+See \f[I]Overview of Java Options\f[R] in \f[B]java\f[R].
+.RE
+.SH JAVAP EXAMPLE
+.PP
+Compile the following \f[CB]HelloWorldFrame\f[R] class:
+.IP
+.nf
+\f[CB]
+import\ java.awt.Graphics;
+
+import\ javax.swing.JFrame;
+import\ javax.swing.JPanel;
+
+public\ class\ HelloWorldFrame\ extends\ JFrame\ {
+
+\ \ \ String\ message\ =\ "Hello\ World!";
+
+\ \ \ public\ HelloWorldFrame(){
+\ \ \ \ \ \ \ \ setContentPane(new\ JPanel(){
+\ \ \ \ \ \ \ \ \ \ \ \ \@Override
+\ \ \ \ \ \ \ \ \ \ \ \ protected\ void\ paintComponent(Graphics\ g)\ {
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ g.drawString(message,\ 15,\ 30);
+\ \ \ \ \ \ \ \ \ \ \ \ }
+\ \ \ \ \ \ \ \ });
+\ \ \ \ \ \ \ \ setSize(100,\ 100);
+\ \ \ \ }
+\ \ \ \ public\ static\ void\ main(String[]\ args)\ {
+\ \ \ \ \ \ \ \ HelloWorldFrame\ frame\ =\ new\ HelloWorldFrame();
+\ \ \ \ \ \ \ \ frame.setVisible(true);
+
+\ \ \ \ }
+
+}
+\f[R]
+.fi
+.PP
+The output from the \f[CB]javap\ HelloWorldFrame.class\f[R] command yields
+the following:
+.IP
+.nf
+\f[CB]
+Compiled\ from\ "HelloWorldFrame.java"
+public\ class\ HelloWorldFrame\ extends\ javax.swing.JFrame\ {
+\ \ java.lang.String\ message;
+\ \ public\ HelloWorldFrame();
+\ \ public\ static\ void\ main(java.lang.String[]);
+}
+\f[R]
+.fi
+.PP
+The output from the \f[CB]javap\ \-c\ HelloWorldFrame.class\f[R] command
+yields the following:
+.IP
+.nf
+\f[CB]
+Compiled\ from\ "HelloWorldFrame.java"
+public\ class\ HelloWorldFrame\ extends\ javax.swing.JFrame\ {
+\ \ java.lang.String\ message;
+
+\ \ public\ HelloWorldFrame();
+\ \ \ \ Code:
+\ \ \ \ \ \ \ 0:\ aload_0
+\ \ \ \ \ \ \ 1:\ invokespecial\ #1\ \ \ \ \ \ \ \ //\ Method\ javax/swing/JFrame."<init>":()V
+\ \ \ \ \ \ \ 4:\ aload_0
+\ \ \ \ \ \ \ 5:\ ldc\ \ \ \ \ \ \ \ \ \ \ #2\ \ \ \ \ \ \ \ //\ String\ Hello\ World!
+\ \ \ \ \ \ \ 7:\ putfield\ \ \ \ \ \ #3\ \ \ \ \ \ \ \ //\ Field\ message:Ljava/lang/String;
+\ \ \ \ \ \ 10:\ aload_0
+\ \ \ \ \ \ 11:\ new\ \ \ \ \ \ \ \ \ \ \ #4\ \ \ \ \ \ \ \ //\ class\ HelloWorldFrame$1
+\ \ \ \ \ \ 14:\ dup
+\ \ \ \ \ \ 15:\ aload_0
+\ \ \ \ \ \ 16:\ invokespecial\ #5\ \ \ \ \ \ \ \ //\ Method\ HelloWorldFrame$1."<init>":(LHelloWorldFrame;)V
+\ \ \ \ \ \ 19:\ invokevirtual\ #6\ \ \ \ \ \ \ \ //\ Method\ setContentPane:(Ljava/awt/Container;)V
+\ \ \ \ \ \ 22:\ aload_0
+\ \ \ \ \ \ 23:\ bipush\ \ \ \ \ \ \ \ 100
+\ \ \ \ \ \ 25:\ bipush\ \ \ \ \ \ \ \ 100
+\ \ \ \ \ \ 27:\ invokevirtual\ #7\ \ \ \ \ \ \ \ //\ Method\ setSize:(II)V
+\ \ \ \ \ \ 30:\ return
+
+\ \ public\ static\ void\ main(java.lang.String[]);
+\ \ \ \ Code:
+\ \ \ \ \ \ \ 0:\ new\ \ \ \ \ \ \ \ \ \ \ #8\ \ \ \ \ \ \ \ //\ class\ HelloWorldFrame
+\ \ \ \ \ \ \ 3:\ dup
+\ \ \ \ \ \ \ 4:\ invokespecial\ #9\ \ \ \ \ \ \ \ //\ Method\ "<init>":()V
+\ \ \ \ \ \ \ 7:\ astore_1
+\ \ \ \ \ \ \ 8:\ aload_1
+\ \ \ \ \ \ \ 9:\ iconst_1
+\ \ \ \ \ \ 10:\ invokevirtual\ #10\ \ \ \ \ \ \ //\ Method\ setVisible:(Z)V
+\ \ \ \ \ \ 13:\ return
+}
+\f[R]
+.fi
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jcmd.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jcmd.1
new file mode 100644
index 0000000..9641bc1
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jcmd.1
@@ -0,0 +1,1112 @@
+.\" Copyright (c) 2012, 2022, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JCMD" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jcmd \- send diagnostic command requests to a running Java Virtual
+Machine (JVM)
+.SH SYNOPSIS
+.PP
+\f[CB]jcmd\f[R] [\f[I]pid\f[R] | \f[I]main\-class\f[R]] \f[I]command\f[R]...
+| \f[CB]PerfCounter.print\f[R] | \f[CB]\-f\f[R] \f[I]filename\f[R]
+.PP
+\f[CB]jcmd\f[R] [\f[CB]\-l\f[R]]
+.PP
+\f[CB]jcmd\f[R] \f[CB]\-h\f[R]
+.TP
+.B \f[I]pid\f[R]
+When used, the \f[CB]jcmd\f[R] utility sends the diagnostic command
+request to the process ID for the Java process.
+.RS
+.RE
+.TP
+.B \f[I]main\-class\f[R]
+When used, the \f[CB]jcmd\f[R] utility sends the diagnostic command
+request to all Java processes with the specified name of the main class.
+.RS
+.RE
+.TP
+.B \f[I]command\f[R]
+The \f[CB]command\f[R] must be a valid \f[CB]jcmd\f[R] command for the
+selected JVM.
+The list of available commands for \f[CB]jcmd\f[R] is obtained by running
+the \f[CB]help\f[R] command (\f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]help\f[R])
+where \f[I]pid\f[R] is the process ID for the running Java process.
+If the \f[I]pid\f[R] is \f[CB]0\f[R], commands will be sent to all Java
+processes.
+The main class argument will be used to match, either partially or
+fully, the class used to start Java.
+If no options are given, it lists the running Java process identifiers
+with the main class and command\-line arguments that were used to launch
+the process (the same as using \f[CB]\-l\f[R]).
+.RS
+.RE
+.TP
+.B \f[CB]Perfcounter.print\f[R]
+Prints the performance counters exposed by the specified Java process.
+.RS
+.RE
+.TP
+.B \f[CB]\-f\f[R] \f[I]filename\f[R]
+Reads and executes commands from a specified file, \f[I]filename\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-l\f[R]
+Displays the list of Java Virtual Machine process identifiers that are
+not running in a separate docker process along with the main class and
+command\-line arguments that were used to launch the process.
+If the JVM is in a docker process, you must use tools such as
+\f[CB]ps\f[R] to look up the PID.
+.RS
+.PP
+\f[B]Note:\f[R]
+.PP
+Using \f[CB]jcmd\f[R] without arguments is the same as using
+\f[CB]jcmd\ \-l\f[R].
+.RE
+.TP
+.B \f[CB]\-h\f[R]
+Displays the \f[CB]jcmd\f[R] utility\[aq]s command\-line help.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jcmd\f[R] utility is used to send diagnostic command requests to
+the JVM.
+It must be used on the same machine on which the JVM is running, and
+have the same effective user and group identifiers that were used to
+launch the JVM.
+Each diagnostic command has its own set of arguments.
+To display the description, syntax, and a list of available arguments
+for a diagnostic command, use the name of the command as the argument.
+For example:
+.RS
+.PP
+\f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]help\f[R] \f[I]command\f[R]
+.RE
+.PP
+If arguments contain spaces, then you must surround them with single or
+double quotation marks (\f[CB]\[aq]\f[R] or \f[CB]"\f[R]).
+In addition, you must escape single or double quotation marks with a
+backslash (\f[CB]\\\f[R]) to prevent the operating system shell from
+processing quotation marks.
+Alternatively, you can surround these arguments with single quotation
+marks and then with double quotation marks (or with double quotation
+marks and then with single quotation marks).
+.PP
+If you specify the process identifier (\f[I]pid\f[R]) or the main class
+(\f[I]main\-class\f[R]) as the first argument, then the \f[CB]jcmd\f[R]
+utility sends the diagnostic command request to the Java process with
+the specified identifier or to all Java processes with the specified
+name of the main class.
+You can also send the diagnostic command request to all available Java
+processes by specifying \f[CB]0\f[R] as the process identifier.
+.SH COMMANDS FOR JCMD
+.PP
+The \f[I]command\f[R] must be a valid \f[CB]jcmd\f[R] diagnostic command
+for the selected JVM.
+The list of available commands for \f[CB]jcmd\f[R] is obtained by running
+the \f[CB]help\f[R] command (\f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]help\f[R])
+where \f[I]pid\f[R] is the process ID for a running Java process.
+If the \f[I]pid\f[R] is \f[CB]0\f[R], commands will be sent to all Java
+processes.
+The main class argument will be used to match, either partially or
+fully, the class used to start Java.
+If no options are given, it lists the running Java process identifiers
+that are not in separate docker processes along with the main class and
+command\-line arguments that were used to launch the process (the same
+as using \f[CB]\-l\f[R]).
+.PP
+The following commands are available:
+.TP
+.B \f[CB]help\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
+For more information about a specific command.
+.RS
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]command name\f[R]: The name of the command for which we want help
+(STRING, no default value)
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-all\f[R]: (Optional) Show help for all commands (BOOLEAN, false) .
+.RE
+.TP
+.B \f[CB]Compiler.codecache\f[R]
+Prints code cache layout and bounds.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.codelist\f[R]
+Prints all compiled methods in code cache that are alive.
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.queue\f[R]
+Prints methods queued for compilation.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.directives_add\ *filename*\ *arguments*\f[R]
+Adds compiler directives from a file.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[I]arguments\f[R]:
+.PP
+\f[I]filename\f[R]: The name of the directives file (STRING, no default
+value)
+.RE
+.TP
+.B \f[CB]Compiler.directives_clear\f[R]
+Remove all compiler directives.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.directives_print\f[R]
+Prints all active compiler directives.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.directives_remove\f[R]
+Remove latest added compiler directive.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]GC.class_histogram\f[R] [\f[I]options\f[R]]
+Provides statistics about the Java heap usage.
+.RS
+.PP
+Impact: High \-\-\- depends on Java heap size and content.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-all\f[R]: (Optional) Inspects all objects, including unreachable
+objects (BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]GC.finalizer_info\f[R]
+Provides information about the Java finalization queue.
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]GC.heap_dump\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
+Generates a HPROF format dump of the Java heap.
+.RS
+.PP
+Impact: High \-\-\- depends on the Java heap size and content.
+Request a full GC unless the \f[CB]\-all\f[R] option is specified.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-all\f[R]: (Optional) Dump all objects, including unreachable
+objects (BOOLEAN, false)
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]filename\f[R]: The name of the dump file (STRING, no default value)
+.RE
+.TP
+.B \f[CB]GC.heap_info\f[R]
+Provides generic Java heap information.
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]GC.run\f[R]
+Calls \f[CB]java.lang.System.gc()\f[R].
+.RS
+.PP
+Impact: Medium \-\-\- depends on the Java heap size and content.
+.RE
+.TP
+.B \f[CB]GC.run_finalization\f[R]
+Calls \f[CB]java.lang.System.runFinalization()\f[R].
+.RS
+.PP
+Impact: Medium \-\-\- depends on the Java content.
+.RE
+.TP
+.B \f[CB]JFR.check\f[R] [\f[I]options\f[R]]
+Show information about a running flight recording
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+If no parameters are entered, information for all active recordings is
+shown.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]name\f[R]: (Optional) Name of the flight recording.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]verbose\f[R]: (Optional) Flag for printing the event settings for
+the recording (BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]JFR.configure\f[R] [\f[I]options\f[R]]
+Set the parameters for a flight recording
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+If no parameters are entered, the current settings are displayed.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]globalbuffercount\f[R]: (Optional) Number of global buffers.
+This option is a legacy option: change the \f[CB]memorysize\f[R] parameter
+to alter the number of global buffers.
+This value cannot be changed once JFR has been initalized.
+(STRING, default determined by the value for \f[CB]memorysize\f[R])
+.IP \[bu] 2
+\f[CB]globalbuffersize\f[R]: (Optional) Size of the global buffers, in
+bytes.
+This option is a legacy option: change the \f[CB]memorysize\f[R] parameter
+to alter the size of the global buffers.
+This value cannot be changed once JFR has been initalized.
+(STRING, default determined by the value for \f[CB]memorysize\f[R])
+.IP \[bu] 2
+\f[CB]maxchunksize\f[R]: (Optional) Maximum size of an individual data
+chunk in bytes if one of the following suffixes is not used: \[aq]m\[aq]
+or \[aq]M\[aq] for megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for
+gigabytes.
+This value cannot be changed once JFR has been initialized.
+(STRING, 12M)
+.IP \[bu] 2
+\f[CB]memorysize\f[R]: (Optional) Overall memory size, in bytes if one of
+the following suffixes is not used: \[aq]m\[aq] or \[aq]M\[aq] for
+megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for gigabytes.
+This value cannot be changed once JFR has been initialized.
+(STRING, 10M)
+.IP \[bu] 2
+\f[CB]repositorypath\f[R]: (Optional) Path to the location where
+recordings are stored until they are written to a permanent file.
+(STRING, The default location is the temporary directory for the
+operating system.
+On Linux operating systems, the temporary directory is \f[CB]/tmp\f[R].
+On Windwows, the temporary directory is specified by the \f[CB]TMP\f[R]
+environment variable.)
+.IP \[bu] 2
+\f[CB]stackdepth\f[R]: (Optional) Stack depth for stack traces.
+Setting this value greater than the default of 64 may cause a
+performance degradation.
+This value cannot be changed once JFR has been initialized.
+(LONG, 64)
+.IP \[bu] 2
+\f[CB]thread_buffer_size\f[R]: (Optional) Local buffer size for each
+thread in bytes if one of the following suffixes is not used:
+\[aq]k\[aq] or \[aq]K\[aq] for kilobytes or \[aq]m\[aq] or \[aq]M\[aq]
+for megabytes.
+Overriding this parameter could reduce performance and is not
+recommended.
+This value cannot be changed once JFR has been initialized.
+(STRING, 8k)
+.IP \[bu] 2
+\f[CB]samplethreads\f[R]: (Optional) Flag for activating thread sampling.
+(BOOLEAN, true)
+.RE
+.TP
+.B \f[CB]JFR.dump\f[R] [\f[I]options\f[R]]
+Write data to a file while a flight recording is running
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+No options are required.
+The recording continues to run after the data is written.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]begin\f[R]: (Optional) Specify the time from which recording data
+will be included in the dump file.
+The format is specified as local time.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]end\f[R]: (Optional) Specify the time to which recording data will
+be included in the dump file.
+The format is specified as local time.
+(STRING, no default value)
+.RS 2
+.PP
+\f[B]Note:\f[R] For both \f[CB]begin\f[R] and \f[CB]end\f[R], the time must
+be in a format that can be read by java.time.LocalTime::parse(STRING),
+java.time.LocalDateTime::parse(STRING) or
+java.time.Instant::parse(STRING).
+For example, "13:20:15", "2020\-03\-17T09:00:00" or
+"2020\-03\-17T09:00:00Z".
+.PP
+\f[B]Note:\f[R] \f[CB]begin\f[R] and \f[CB]end\f[R] times correspond to the
+timestamps found within the recorded information in the flight recording
+data.
+.PP
+Another option is to use a time relative to the current time that is
+specified by a negative integer followed by "s", "m" or "h".
+For example, "\-12h", "\-15m" or "\-30s"
+.RE
+.IP \[bu] 2
+\f[CB]filename\f[R]: (Optional) Name of the file to which the flight
+recording data is dumped.
+If no filename is given, a filename is generated from the PID and the
+current date.
+The filename may also be a directory in which case, the filename is
+generated from the PID and the current date in the specified directory.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]maxage\f[R]: (Optional) Length of time for dumping the flight
+recording data to a file.
+(INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for minutes or
+\[aq]h\[aq] for hours, no default value)
+.IP \[bu] 2
+\f[CB]maxsize\f[R]: (Optional) Maximum size for the amount of data to dump
+from a flight recording in bytes if one of the following suffixes is not
+used: \[aq]m\[aq] or \[aq]M\[aq] for megabytes OR \[aq]g\[aq] or
+\[aq]G\[aq] for gigabytes.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]name\f[R]: (Optional) Name of the recording.
+If no name is given, data from all recordings is dumped.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]path\-to\-gc\-root\f[R]: (Optional) Flag for saving the path to
+garbage collection (GC) roots at the time the recording data is dumped.
+The path information is useful for finding memory leaks but collecting
+it can cause the application to pause for a short period of time.
+Turn on this flag only when you have an application that you suspect has
+a memory leak.
+(BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]JFR.start\f[R] [\f[I]options\f[R]]
+Start a flight recording
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+If no parameters are entered, then a recording is started with default
+values.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]delay\f[R]: (Optional) Length of time to wait before starting to
+record (INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for
+minutes or \[aq]h\[aq] for hours, 0s)
+.IP \[bu] 2
+\f[CB]disk\f[R]: (Optional) Flag for also writing the data to disk while
+recording (BOOLEAN, true)
+.IP \[bu] 2
+\f[CB]dumponexit\f[R]: (Optional) Flag for writing the recording to disk
+when the Java Virtual Machine (JVM) shuts down.
+If set to \[aq]true\[aq] and no value is given for \f[CB]filename\f[R],
+the recording is written to a file in the directory where the process
+was started.
+The file name is a system\-generated name that contains the process ID,
+the recording ID and the current time stamp.
+(For example: \f[CB]id\-1\-2019_12_12_10_41.jfr\f[R]) (BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]duration\f[R]: (Optional) Length of time to record.
+Note that \f[CB]0s\f[R] means forever (INTEGER followed by \[aq]s\[aq] for
+seconds \[aq]m\[aq] for minutes or \[aq]h\[aq] for hours, 0s)
+.IP \[bu] 2
+\f[CB]filename\f[R]: (Optional) Name of the file to which the flight
+recording data is written when the recording is stopped.
+If no filename is given, a filename is generated from the PID and the
+current date and is placed in the directory where the process was
+started.
+The filename may also be a directory in which case, the filename is
+generated from the PID and the current date in the specified directory.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]maxage\f[R]: (Optional) Maximum time to keep the recorded data on
+disk.
+This parameter is valid only when the \f[CB]disk\f[R] parameter is set to
+\f[CB]true\f[R].
+Note \f[CB]0s\f[R] means forever.
+(INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for minutes or
+\[aq]h\[aq] for hours, 0s)
+.IP \[bu] 2
+\f[CB]maxsize\f[R]: (Optional) Maximum size of the data to keep on disk in
+bytes if one of the following suffixes is not used: \[aq]m\[aq] or
+\[aq]M\[aq] for megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for gigabytes.
+This parameter is valid only when the \f[CB]disk\f[R] parameter is set to
+\[aq]true\[aq].
+The value must not be less than the value for the \f[CB]maxchunksize\f[R]
+parameter set with the \f[CB]JFR.configure\f[R] command.
+(STRING, 0 (no maximum size))
+.IP \[bu] 2
+\f[CB]name\f[R]: (Optional) Name of the recording.
+If no name is provided, a name is generated.
+Make note of the generated name that is shown in the response to the
+command so that you can use it with other commands.
+(STRING, system\-generated default name)
+.IP \[bu] 2
+\f[CB]path\-to\-gc\-root\f[R]: (Optional) Flag for saving the path to
+garbage collection (GC) roots at the end of a recording.
+The path information is useful for finding memory leaks but collecting
+it is time consuming.
+Turn on this flag only when you have an application that you suspect has
+a memory leak.
+If the \f[CB]settings\f[R] parameter is set to \[aq]profile\[aq], then the
+information collected includes the stack trace from where the potential
+leaking object was allocated.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]settings\f[R]: (Optional) Name of the settings file that identifies
+which events to record.
+To specify more than one file, separate the names with a comma
+(\[aq],\[aq]).
+Include the path if the file is not in \f[CB]JAVA\-HOME\f[R]/lib/jfr.
+The following profiles are included with the JDK in the
+\f[CB]JAVA\-HOME\f[R]/lib/jfr directory: \[aq]default.jfc\[aq]: collects a
+predefined set of information with low overhead, so it has minimal
+impact on performance and can be used with recordings that run
+continuously; \[aq]profile.jfc\[aq]: Provides more data than the
+\[aq]default.jfc\[aq] profile, but with more overhead and impact on
+performance.
+Use this configuration for short periods of time when more information
+is needed.
+Use \f[CB]none\f[R] to start a recording without a predefined
+configuration file.
+(STRING, \f[CB]JAVA\-HOME\f[R]/lib/jfr/default.jfc)
+.PP
+Event settings and .jfc options can be specified using the following
+syntax:
+.IP \[bu] 2
+\f[CB]option\f[R]: (Optional) Specifies the option value to modify.
+To list available options, use the \f[CB]JAVA_HOME\f[R]/bin/jfr tool.
+.IP \[bu] 2
+\f[CB]event\-setting\f[R]: (Optional) Specifies the event setting value to
+modify.
+Use the form: #= To add a new event setting, prefix the event name with
+\[aq]+\[aq].
+.PP
+You can specify values for multiple event settings and .jfc options by
+separating them with a whitespace.
+In case of a conflict between a parameter and a .jfc option, the
+parameter will take precedence.
+The whitespace delimiter can be omitted for timespan values, i.e.
+20ms.
+For more information about the settings syntax, see Javadoc of the
+jdk.jfr package.
+.RE
+.TP
+.B \f[CB]JFR.stop\f[R] [\f[I]options\f[R]]
+Stop a flight recording
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+If no parameters are entered, then no recording is stopped.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]filename\f[R]: (Optional) Name of the file to which the recording is
+written when the recording is stopped.
+If no path is provided, the data from the recording is discarded.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]name\f[R]: (Optional) Name of the recording (STRING, no default
+value)
+.RE
+.TP
+.B \f[CB]JVMTI.agent_load\f[R] [\f[I]arguments\f[R]]
+Loads JVMTI native agent.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(control)\f[R]
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]library path\f[R]: Absolute path of the JVMTI agent to load.
+(STRING, no default value)
+.IP \[bu] 2
+\f[I]agent option\f[R]: (Optional) Option string to pass the agent.
+(STRING, no default value)
+.RE
+.TP
+.B \f[CB]JVMTI.data_dump\f[R]
+Signals the JVM to do a data\-dump request for JVMTI.
+.RS
+.PP
+Impact: High
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]ManagementAgent.start\f[R] [\f[I]options\f[R]]
+Starts remote management agent.
+.RS
+.PP
+Impact: Low \-\-\- no impact
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]config.file\f[R]: (Optional) Sets
+\f[CB]com.sun.management.config.file\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.host\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.host\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.port\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.port\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.rmi.port\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.rmi.port\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.ssl\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.registry.ssl\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.registry.ssl\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.authenticate\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.authenticate\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+jmxremote.password.file: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.password.file\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.access.file\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.acce\ ss.file\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.login.config\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.log\ in.config\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.enabled.cipher.suites\f[R]: (Optional) Sets
+\f[CB]com.sun.management\f[R].
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.enabled.cipher.suite\f[R]: (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.enabled.protocols\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxr\ emote.ssl.enabled.protocols\f[R] (STRING,
+no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.need.client.auth\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxre\ mote.need.client.auth\f[R] (STRING, no
+default value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.config.file\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.\ ssl_config_file\f[R] (STRING, no
+default value)
+.IP \[bu] 2
+\f[CB]jmxremote.autodiscovery\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.au\ todiscovery\f[R] (STRING, no
+default value)
+.IP \[bu] 2
+\f[CB]jdp.port\f[R]: (Optional) Sets \f[CB]com.sun.management.jdp.port\f[R]
+(INT, no default value)
+.IP \[bu] 2
+\f[CB]jdp.address\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jdp.address\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jdp.source_addr\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jdp.source_addr\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jdp.ttl\f[R]: (Optional) Sets \f[CB]com.sun.management.jdp.ttl\f[R]
+(INT, no default value)
+.IP \[bu] 2
+\f[CB]jdp.pause\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jdp.pause\f[R] (INT, no default value)
+.IP \[bu] 2
+\f[CB]jdp.name\f[R]: (Optional) Sets \f[CB]com.sun.management.jdp.name\f[R]
+(STRING, no default value)
+.RE
+.TP
+.B \f[CB]ManagementAgent.start_local\f[R]
+Starts the local management agent.
+.RS
+.PP
+Impact: Low \-\-\- no impact
+.RE
+.TP
+.B \f[CB]ManagementAgent.status\f[R]
+Print the management agent status.
+.RS
+.PP
+Impact: Low \-\-\- no impact
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]ManagementAgent.stop\f[R]
+Stops the remote management agent.
+.RS
+.PP
+Impact: Low \-\-\- no impact
+.RE
+.TP
+.B \f[CB]Thread.print\f[R] [\f[I]options\f[R]]
+Prints all threads with stacktraces.
+.RS
+.PP
+Impact: Medium \-\-\- depends on the number of threads.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-l\f[R]: (Optional) Prints \f[CB]java.util.concurrent\f[R] locks
+(BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]VM.cds\f[R] [\f[I]arguments\f[R]]
+Dumps a static or dynamic shared archive that includes all currently
+loaded classes.
+.RS
+.PP
+Impact: Medium \-\-\- pause time depends on number of loaded classes
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[CB]subcmd\f[R]: must be either \f[CB]static_dump\f[R] or
+.IP \[bu] 2
+\f[CB]filename\f[R]: (Optional) Name of the shared archive to be dumped
+(STRING, no default value)
+.PP
+If \f[CB]filename\f[R] is not specified, a default file name is chosen
+using the pid of the target JVM process.
+For example, java_pid1234_static.jsa, java_pid5678_dynamic.jsa, etc.
+.PP
+If \f[CB]filename\f[R] is not specified as an absolute path, the archive
+file is created in a directory relative to the current directory of the
+target JVM process.
+.RE
+.TP
+.B \f[CB]VM.classloaders\f[R] [\f[I]options\f[R]]
+Prints classloader hierarchy.
+.RS
+.PP
+Impact: Medium \-\-\- Depends on number of class loaders and classes
+loaded.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]show\-classes\f[R]: (Optional) Print loaded classes.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]verbose\f[R]: (Optional) Print detailed information.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]fold\f[R]: (Optional) Show loaders of the same name and class as
+one.
+(BOOLEAN, true)
+.RE
+.TP
+.B \f[CB]VM.classloader_stats\f[R]
+Prints statistics about all ClassLoaders.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]VM.class_hierarchy\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
+Prints a list of all loaded classes, indented to show the class
+hierarchy.
+The name of each class is followed by the ClassLoaderData* of its
+ClassLoader, or "null" if it is loaded by the bootstrap class loader.
+.RS
+.PP
+Impact: Medium \-\-\- depends on the number of loaded classes.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-i\f[R]: (Optional) Inherited interfaces should be printed.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]\-s\f[R]: (Optional) If a class name is specified, it prints the
+subclasses.
+If the class name is not specified, only the superclasses are printed.
+(BOOLEAN, false)
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]classname\f[R]: (Optional) The name of the class whose hierarchy
+should be printed.
+If not specified, all class hierarchies are printed.
+(STRING, no default value)
+.RE
+.TP
+.B \f[CB]VM.command_line\f[R]
+Prints the command line used to start this VM instance.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]VM.dynlibs\f[R]
+Prints the loaded dynamic libraries.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]VM.info\f[R]
+Prints information about the JVM environment and status.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]VM.log\f[R] [\f[I]options\f[R]]
+Lists current log configuration, enables/disables/configures a log
+output, or rotates all logs.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(control)\f[R]
+.PP
+\f[I]options\f[R]:
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.IP \[bu] 2
+\f[CB]output\f[R]: (Optional) The name or index (#) of output to
+configure.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]output_options\f[R]: (Optional) Options for the output.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]what\f[R]: (Optional) Configures what tags to log.
+(STRING, no default value )
+.IP \[bu] 2
+\f[CB]decorators\f[R]: (Optional) Configures which decorators to use.
+Use \[aq]none\[aq] or an empty value to remove all.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]disable\f[R]: (Optional) Turns off all logging and clears the log
+configuration.
+(BOOLEAN, no default value)
+.IP \[bu] 2
+\f[CB]list\f[R]: (Optional) Lists current log configuration.
+(BOOLEAN, no default value)
+.IP \[bu] 2
+\f[CB]rotate\f[R]: (Optional) Rotates all logs.
+(BOOLEAN, no default value)
+.RE
+.TP
+.B \f[CB]VM.flags\f[R] [\f[I]options\f[R]]
+Prints the VM flag options and their current values.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-all\f[R]: (Optional) Prints all flags supported by the VM
+(BOOLEAN, false).
+.RE
+.TP
+.B \f[CB]VM.native_memory\f[R] [\f[I]options\f[R]]
+Prints native memory usage
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]summary\f[R]: (Optional) Requests runtime to report current memory
+summary, which includes total reserved and committed memory, along with
+memory usage summary by each subsystem.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]detail\f[R]: (Optional) Requests runtime to report memory allocation
+>= 1K by each callsite.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]baseline\f[R]: (Optional) Requests runtime to baseline current
+memory usage, so it can be compared against in later time.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]summary.diff\f[R]: (Optional) Requests runtime to report memory
+summary comparison against previous baseline.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]detail.diff\f[R]: (Optional) Requests runtime to report memory
+detail comparison against previous baseline, which shows the memory
+allocation activities at different callsites.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]shutdown\f[R]: (Optional) Requests runtime to shutdown itself and
+free the memory used by runtime.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]statistics\f[R]: (Optional) Prints tracker statistics for tuning
+purpose.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]scale\f[R]: (Optional) Memory usage in which scale, KB, MB or GB
+(STRING, KB)
+.RE
+.TP
+.B \f[CB]VM.print_touched_methods\f[R]
+Prints all methods that have ever been touched during the lifetime of
+this JVM.
+.RS
+.PP
+Impact: Medium \-\-\- depends on Java content.
+.RE
+.TP
+.B \f[CB]VM.set_flag\f[R] [\f[I]arguments\f[R]]
+Sets the VM flag option by using the provided value.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(control)\f[R]
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]flag name\f[R]: The name of the flag that you want to set (STRING,
+no default value)
+.IP \[bu] 2
+\f[I]string value\f[R]: (Optional) The value that you want to set
+(STRING, no default value)
+.RE
+.TP
+.B \f[CB]VM.stringtable\f[R] [\f[I]options\f[R]]
+Dumps the string table.
+.RS
+.PP
+Impact: Medium \-\-\- depends on the Java content.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-verbose\f[R]: (Optional) Dumps the content of each string in the
+table (BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]VM.symboltable\f[R] [\f[I]options\f[R]]
+Dumps the symbol table.
+.RS
+.PP
+Impact: Medium \-\-\- depends on the Java content.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax).
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-verbose\f[R]: (Optional) Dumps the content of each symbol in the
+table (BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]VM.systemdictionary\f[R]
+Prints the statistics for dictionary hashtable sizes and bucket length.
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]verbose\f[R]: (Optional) Dump the content of each dictionary entry
+for all class loaders (BOOLEAN, false) .
+.RE
+.TP
+.B \f[CB]VM.system_properties\f[R]
+Prints the system properties.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.util.PropertyPermission(*,\ read)\f[R]
+.RE
+.TP
+.B \f[CB]VM.uptime\f[R] [\f[I]options\f[R]]
+Prints the VM uptime.
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-date\f[R]: (Optional) Adds a prefix with the current date
+(BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]VM.version\f[R]
+Prints JVM version information.
+.RS
+.PP
+Impact: Low
+.PP
+Permission:
+\f[CB]java.util.PropertyPermission(java.vm.version,\ read)\f[R]
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jconsole.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jconsole.1
new file mode 100644
index 0000000..e02bcca
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jconsole.1
@@ -0,0 +1,102 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JCONSOLE" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jconsole \- start a graphical console to monitor and manage Java
+applications
+.SH SYNOPSIS
+.PP
+\f[CB]jconsole\f[R] [\f[CB]\-interval=\f[R]\f[I]n\f[R]] [\f[CB]\-notile\f[R]]
+[\f[CB]\-plugin\f[R] \f[I]path\f[R]] [\f[CB]\-version\f[R]]
+[\f[I]connection\f[R] ...
+] [\f[CB]\-J\f[R]\f[I]input_arguments\f[R]]
+.PP
+\f[CB]jconsole\f[R] \f[CB]\-help\f[R]
+.SH OPTIONS
+.TP
+.B \f[CB]\-interval\f[R]
+Sets the update interval to \f[CB]n\f[R] seconds (default is 4 seconds).
+.RS
+.RE
+.TP
+.B \f[CB]\-notile\f[R]
+Doesn\[aq]t tile the windows for two or more connections.
+.RS
+.RE
+.TP
+.B \f[CB]\-pluginpath\f[R] \f[I]path\f[R]
+Specifies the path that \f[CB]jconsole\f[R] uses to look up plug\-ins.
+The plug\-in \f[I]path\f[R] should contain a provider\-configuration file
+named \f[CB]META\-INF/services/com.sun.tools.jconsole.JConsolePlugin\f[R]
+that contains one line for each plug\-in.
+The line specifies the fully qualified class name of the class
+implementing the \f[CB]com.sun.tools.jconsole.JConsolePlugin\f[R] class.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R]
+Prints the program version.
+.RS
+.RE
+.TP
+.B \f[I]connection\f[R] = \f[I]pid\f[R] | \f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] | \f[I]jmxURL\f[R]
+A connection is described by either \f[I]pid\f[R],
+\f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] or \f[I]jmxURL\f[R].
+.RS
+.IP \[bu] 2
+The \f[I]pid\f[R] value is the process ID of a target process.
+The JVM must be running with the same user ID as the user ID running the
+\f[CB]jconsole\f[R] command.
+.IP \[bu] 2
+The \f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] values are the name of the host
+system on which the JVM is running, and the port number specified by the
+system property \f[CB]com.sun.management.jmxremote.port\f[R] when the JVM
+was started.
+.IP \[bu] 2
+The \f[I]jmxUrl\f[R] value is the address of the JMX agent to be
+connected to as described in JMXServiceURL.
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]input_arguments\f[R]
+Passes \f[I]input_arguments\f[R] to the JVM on which the
+\f[CB]jconsole\f[R] command is run.
+.RS
+.RE
+.TP
+.B \f[CB]\-help\f[R] or \f[CB]\-\-help\f[R]
+Displays the help message for the command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jconsole\f[R] command starts a graphical console tool that lets
+you monitor and manage Java applications and virtual machines on a local
+or remote machine.
+.PP
+On Windows, the \f[CB]jconsole\f[R] command doesn\[aq]t associate with a
+console window.
+It does, however, display a dialog box with error information when the
+\f[CB]jconsole\f[R] command fails.
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jdb.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jdb.1
new file mode 100644
index 0000000..522fc68
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jdb.1
@@ -0,0 +1,263 @@
+.\" Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JDB" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jdb \- find and fix bugs in Java platform programs
+.SH SYNOPSIS
+.PP
+\f[CB]jdb\f[R] [\f[I]options\f[R]] [\f[I]classname\f[R]]
+[\f[I]arguments\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jdb\f[R] command\-line options.
+See \f[B]Options for the jdb command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]classname\f[R]
+This represents the name of the main class to debug.
+.RS
+.RE
+.TP
+.B \f[I]arguments\f[R]
+This represents the arguments that are passed to the \f[CB]main()\f[R]
+method of the class.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The Java Debugger (JDB) is a simple command\-line debugger for Java
+classes.
+The \f[CB]jdb\f[R] command and its options call the JDB.
+The \f[CB]jdb\f[R] command demonstrates the Java Platform Debugger
+Architecture and provides inspection and debugging of a local or remote
+JVM.
+.SH START A JDB SESSION
+.PP
+There are many ways to start a JDB session.
+The most frequently used way is to have the JDB launch a new JVM with
+the main class of the application to be debugged.
+Do this by substituting the \f[CB]jdb\f[R] command for the \f[CB]java\f[R]
+command in the command line.
+For example, if your application\[aq]s main class is \f[CB]MyClass\f[R],
+then use the following command to debug it under the JDB:
+.RS
+.PP
+\f[CB]jdb\ MyClass\f[R]
+.RE
+.PP
+When started this way, the \f[CB]jdb\f[R] command calls a second JVM with
+the specified parameters, loads the specified class, and stops the JVM
+before executing that class\[aq]s first instruction.
+.PP
+Another way to use the \f[CB]jdb\f[R] command is by attaching it to a JVM
+that\[aq]s already running.
+Syntax for starting a JVM to which the \f[CB]jdb\f[R] command attaches
+when the JVM is running is as follows.
+This loads in\-process debugging libraries and specifies the kind of
+connection to be made.
+.RS
+.PP
+\f[CB]java\ \-agentlib:jdwp=transport=dt_socket,server=y,suspend=n\ MyClass\f[R]
+.RE
+.PP
+You can then attach the \f[CB]jdb\f[R] command to the JVM with the
+following command:
+.RS
+.PP
+\f[CB]jdb\ \-attach\ 8000\f[R]
+.RE
+.PP
+8000 is the address of the running JVM.
+.PP
+The \f[CB]MyClass\f[R] argument isn\[aq]t specified in the \f[CB]jdb\f[R]
+command line in this case because the \f[CB]jdb\f[R] command is connecting
+to an existing JVM instead of launching a new JVM.
+.PP
+There are many other ways to connect the debugger to a JVM, and all of
+them are supported by the \f[CB]jdb\f[R] command.
+The Java Platform Debugger Architecture has additional documentation on
+these connection options.
+.SH BREAKPOINTS
+.PP
+Breakpoints can be set in the JDB at line numbers or at the first
+instruction of a method, for example:
+.IP \[bu] 2
+The command \f[CB]stop\ at\ MyClass:22\f[R] sets a breakpoint at the first
+instruction for line 22 of the source file containing \f[CB]MyClass\f[R].
+.IP \[bu] 2
+The command \f[CB]stop\ in\ java.lang.String.length\f[R] sets a breakpoint
+at the beginning of the method \f[CB]java.lang.String.length\f[R].
+.IP \[bu] 2
+The command \f[CB]stop\ in\ MyClass.<clinit>\f[R] uses \f[CB]<clinit>\f[R]
+to identify the static initialization code for \f[CB]MyClass\f[R].
+.PP
+When a method is overloaded, you must also specify its argument types so
+that the proper method can be selected for a breakpoint.
+For example, \f[CB]MyClass.myMethod(int,java.lang.String)\f[R] or
+\f[CB]MyClass.myMethod()\f[R].
+.PP
+The \f[CB]clear\f[R] command removes breakpoints using the following
+syntax: \f[CB]clear\ MyClass:45\f[R].
+Using the \f[CB]clear\f[R] or \f[CB]stop\f[R] command with no argument
+displays a list of all breakpoints currently set.
+The \f[CB]cont\f[R] command continues execution.
+.SH STEPPING
+.PP
+The \f[CB]step\f[R] command advances execution to the next line whether
+it\[aq]s in the current stack frame or a called method.
+The \f[CB]next\f[R] command advances execution to the next line in the
+current stack frame.
+.SH EXCEPTIONS
+.PP
+When an exception occurs for which there isn\[aq]t a \f[CB]catch\f[R]
+statement anywhere in the throwing thread\[aq]s call stack, the JVM
+typically prints an exception trace and exits.
+When running under the JDB, however, control returns to the JDB at the
+offending throw.
+You can then use the \f[CB]jdb\f[R] command to diagnose the cause of the
+exception.
+.PP
+Use the \f[CB]catch\f[R] command to cause the debugged application to stop
+at other thrown exceptions, for example:
+\f[CB]catch\ java.io.FileNotFoundException\f[R] or \f[CB]catch\f[R]
+\f[CB]mypackage.BigTroubleException\f[R].
+Any exception that\[aq]s an instance of the specified class or subclass
+stops the application at the point where the exception is thrown.
+.PP
+The \f[CB]ignore\f[R] command negates the effect of an earlier
+\f[CB]catch\f[R] command.
+The \f[CB]ignore\f[R] command doesn\[aq]t cause the debugged JVM to ignore
+specific exceptions, but only to ignore the debugger.
+.SH OPTIONS FOR THE JDB COMMAND
+.PP
+When you use the \f[CB]jdb\f[R] command instead of the \f[CB]java\f[R]
+command on the command line, the \f[CB]jdb\f[R] command accepts many of
+the same options as the \f[CB]java\f[R] command.
+.PP
+The following options are accepted by the \f[CB]jdb\f[R] command:
+.TP
+.B \f[CB]\-help\f[R]
+Displays a help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-sourcepath\f[R] \f[I]dir1\f[R]\f[CB]:\f[R]\f[I]dir2\f[R]\f[CB]:\f[R]...
+Uses the specified path to search for source files in the specified
+path.
+If this option is not specified, then use the default path of dot
+(\f[CB]\&.\f[R]).
+.RS
+.RE
+.TP
+.B \f[CB]\-attach\f[R] \f[I]address\f[R]
+Attaches the debugger to a running JVM with the default connection
+mechanism.
+.RS
+.RE
+.TP
+.B \f[CB]\-listen\f[R] \f[I]address\f[R]
+Waits for a running JVM to connect to the specified address with a
+standard connector.
+.RS
+.RE
+.TP
+.B \f[CB]\-listenany\f[R]
+Waits for a running JVM to connect at any available address using a
+standard connector.
+.RS
+.RE
+.TP
+.B \f[CB]\-launch\f[R]
+Starts the debugged application immediately upon startup of the
+\f[CB]jdb\f[R] command.
+The \f[CB]\-launch\f[R] option removes the need for the \f[CB]run\f[R]
+command.
+The debugged application is launched and then stopped just before the
+initial application class is loaded.
+At that point, you can set any necessary breakpoints and use the
+\f[CB]cont\f[R] command to continue execution.
+.RS
+.RE
+.TP
+.B \f[CB]\-listconnectors\f[R]
+Lists the connectors available in this JVM.
+.RS
+.RE
+.TP
+.B \f[CB]\-connect\f[R] \f[I]connector\-name\f[R]\f[CB]:\f[R]\f[I]name1\f[R]\f[CB]=\f[R]\f[I]value1\f[R]....
+Connects to the target JVM with the named connector and listed argument
+values.
+.RS
+.RE
+.TP
+.B \f[CB]\-dbgtrace\f[R] [\f[I]flags\f[R]]
+Prints information for debugging the \f[CB]jdb\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]\-tclient\f[R]
+Runs the application in the Java HotSpot VM client.
+.RS
+.RE
+.TP
+.B \f[CB]\-tserver\f[R]
+Runs the application in the Java HotSpot VM server.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Passes \f[I]option\f[R] to the JVM, where option is one of the options
+described on the reference page for the Java application launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+See \f[I]Overview of Java Options\f[R] in \f[B]java\f[R].
+.RS
+.RE
+.PP
+The following options are forwarded to the debuggee process:
+.TP
+.B \f[CB]\-v\f[R] or \f[CB]\-verbose\f[R][\f[CB]:\f[R]\f[I]class\f[R]|\f[CB]gc\f[R]|\f[CB]jni\f[R]]
+Turns on the verbose mode.
+.RS
+.RE
+.TP
+.B \f[CB]\-D\f[R]\f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Sets a system property.
+.RS
+.RE
+.TP
+.B \f[CB]\-classpath\f[R] \f[I]dir\f[R]
+Lists directories separated by colons in which to look for classes.
+.RS
+.RE
+.TP
+.B \f[CB]\-X\f[R] \f[I]option\f[R]
+A nonstandard target JVM option.
+.RS
+.RE
+.PP
+Other options are supported to provide alternate mechanisms for
+connecting the debugger to the JVM that it\[aq]s to debug.
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jdeprscan.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jdeprscan.1
new file mode 100644
index 0000000..e0dde77
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jdeprscan.1
@@ -0,0 +1,273 @@
+.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JDEPRSCAN" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jdeprscan \- static analysis tool that scans a jar file (or some other
+aggregation of class files) for uses of deprecated API elements
+.SH SYNOPSIS
+.PP
+\f[CB]jdeprscan\f[R] [\f[I]options\f[R]]
+{\f[I]dir\f[R]|\f[I]jar\f[R]|\f[I]class\f[R]}
+.TP
+.B \f[I]options\f[R]
+See \f[B]Options for the jdeprscan Command\f[R]
+.RS
+.RE
+.TP
+.B \f[I]dir\f[R]|\f[I]jar\f[R]|\f[I]class\f[R]
+\f[CB]jdeprscan\f[R] command scans each argument for usages of deprecated
+APIs.
+The arguments can be a:
+.RS
+.IP \[bu] 2
+\f[I]dir\f[R]: Directory
+.IP \[bu] 2
+\f[I]jar\f[R]: JAR file
+.IP \[bu] 2
+\f[I]class\f[R]: Class name or class file
+.PP
+The class name should use a dot (\f[CB]\&.\f[R]) as a separator.
+For example:
+.PP
+\f[CB]java.lang.Thread\f[R]
+.PP
+For nested classes, the dollar sign \f[CB]$\f[R] separator character
+should be used.
+For example:
+.PP
+\f[CB]java.lang.Thread$State\f[R]
+.PP
+A class file can also be named.
+For example:
+.PP
+\f[CB]build/classes/java/lang/Thread$State.class\f[R]
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jdeprscan\f[R] tool is a static analysis tool provided by the
+JDK that scans a JAR file or some other aggregation of class files for
+uses of deprecated API elements.
+The deprecated APIs identified by the \f[CB]jdeprscan\f[R] tool are only
+those that are defined by Java SE.
+Deprecated APIs defined by third\-party libraries aren\[aq]t reported.
+.PP
+To scan a JAR file or a set of class files, you must first ensure that
+all of the classes that the scanned classes depend upon are present in
+the class path.
+Set the class path using the \f[CB]\-\-class\-path\f[R] option described
+in \f[B]Options for the jdeprscan Command\f[R].
+Typically, you would use the same class path as the one that you use
+when invoking your application.
+.PP
+If the \f[CB]jdeprscan\f[R] can\[aq]t find all the dependent classes, it
+will generate an error message for each class that\[aq]s missing.
+These error messages are typically of the form:
+.RS
+.PP
+\f[CB]error:\ cannot\ find\ class\ ...\f[R]
+.RE
+.PP
+If these errors occur, then you must adjust the class path so that it
+includes all dependent classes.
+.SH OPTIONS FOR THE JDEPRSCAN COMMAND
+.PP
+The following options are available:
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Provides a search path for resolution of dependent classes.
+.RS
+.PP
+\f[I]path\f[R] can be a search path that consists of one or more
+directories separated by the system\-specific path separator.
+For example:
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]\-\-class\-path\ /some/directory:/another/different/dir\f[R]
+.RE
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+On Windows, use a semicolon (\f[CB];\f[R]) as the separator instead of a
+colon (\f[CB]:\f[R]).
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]\-\-class\-path\ \\some\\directory;\\another\\different\\dir\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-\-for\-removal\f[R]
+Limits scanning or listing to APIs that are deprecated for removal.
+Can\[aq]t be used with a release value of 6, 7, or 8.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-full\-version\f[R]
+Prints out the full version string of the tool.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R]
+Prints out a full help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\f[R] or \f[CB]\-l\f[R]
+Prints the set of deprecated APIs.
+No scanning is done, so no directory, jar, or class arguments should be
+provided.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-release\f[R] \f[CB]6\f[R]|\f[CB]7\f[R]|\f[CB]8\f[R]|\f[CB]9\f[R]
+Specifies the Java SE release that provides the set of deprecated APIs
+for scanning.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-verbose\f[R] or \f[CB]\-v\f[R]
+Enables additional message output during processing.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints out the abbreviated version string of the tool.
+.RS
+.RE
+.SH EXAMPLE OF JDEPRSCAN OUTPUT
+.PP
+The JAR file for this library will be named something similar to
+\f[CB]commons\-math3\-3.6.1.jar\f[R].
+To scan this JAR file for the use of deprecated APIs, run the following
+command:
+.RS
+.PP
+\f[CB]jdeprscan\ commons\-math3\-3.6.1.jar\f[R]
+.RE
+.PP
+This command produces several lines of output.
+For example, one line of output might be:
+.IP
+.nf
+\f[CB]
+class\ org/apache/commons/math3/util/MathUtils\ uses\ deprecated\ method\ java/lang/Double::<init>(D)V
+\f[R]
+.fi
+.PP
+\f[B]Note:\f[R]
+.PP
+The class name is specified using the slash\-separated binary name as
+described in JVMS 4.2.1.
+This is the form used internally in class files.
+.PP
+The deprecated API it uses is a method on the \f[CB]java.lang.Double\f[R]
+class.
+.PP
+The name of the deprecated method is \f[CB]<init>\f[R], which is a special
+name that means that the method is actually a constructor.
+Another special name is \f[CB]<clinit>\f[R], which indicates a class
+static initializer.
+.PP
+Other methods are listed just by their method name.
+Following the method name is the argument list and return type:
+.RS
+.PP
+\f[CB](D)V\f[R]
+.RE
+.PP
+This indicates that it takes just one double value (a primitive) and
+returns void.
+The argument and return types can become cryptic.
+For example, another line of output might be:
+.IP
+.nf
+\f[CB]
+class\ org/apache/commons/math3/util/Precision\ uses\ deprecated\ method\ java/math/BigDecimal::setScale(II)Ljava/math/BigDecimal;
+\f[R]
+.fi
+.PP
+In this line of output, the deprecated method is on class
+\f[CB]java.math.BigDecimal\f[R], and the method is \f[CB]setScale()\f[R].
+In this case, the \f[CB](II)\f[R] means that it takes two \f[CB]int\f[R]
+arguments.
+The \f[CB]Ljava/math/BigDecimal;\f[R] after the parentheses means that it
+returns a reference to \f[CB]java.math.BigDecimal\f[R].
+.SH JDEPRSCAN ANALYSIS CAN BE VERSION\-SPECIFIC
+.PP
+You can use \f[CB]jdeprscan\f[R] relative to the previous three JDK
+releases.
+For example, if you are running JDK 9, then you can check against JDK 8,
+7, and 6.
+.PP
+As an example, look at this code snippet:
+.IP
+.nf
+\f[CB]
+public\ class\ Deprecations\ {
+\ \ \ SecurityManager\ sm\ =\ new\ RMISecurityManager();\ \ \ \ //\ deprecated\ in\ 8
+\ \ \ Boolean\ b2\ =\ new\ Boolean(true);\ \ \ \ \ \ \ \ \ \ //\ deprecated\ in\ 9
+}
+\f[R]
+.fi
+.PP
+The complete class compiles without warnings in JDK 7.
+.PP
+If you run \f[CB]jdeprscan\f[R] on a system with JDK 9, then you see:
+.IP
+.nf
+\f[CB]
+$\ jdeprscan\ \-\-class\-path\ classes\ \-\-release\ 7\ example.Deprecations
+(no\ output)
+\f[R]
+.fi
+.PP
+Run \f[CB]jdeprscan\f[R] with a release value of 8:
+.IP
+.nf
+\f[CB]
+$\ jdeprscan\ \-\-class\-path\ classes\ \-\-release\ 8\ example.Deprecations
+class\ example/Deprecations\ uses\ type\ java/rmi/RMISecurityManager\ deprecated
+class\ example/Deprecations\ uses\ method\ in\ type\ java/rmi/RMISecurityManager\ deprecated
+\f[R]
+.fi
+.PP
+Run \f[CB]jdeprscan\f[R] on JDK 9:
+.IP
+.nf
+\f[CB]
+$\ jdeprscan\ \-\-class\-path\ classes\ example.Deprecations
+class\ example/Deprecations\ uses\ type\ java/rmi/RMISecurityManager\ deprecated
+class\ example/Deprecations\ uses\ method\ in\ type\ java/rmi/RMISecurityManager\ deprecated
+class\ example/Deprecations\ uses\ method\ java/lang/Boolean\ <init>\ (Z)V\ deprecated
+\f[R]
+.fi
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jdeps.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jdeps.1
new file mode 100644
index 0000000..50b6a1f
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jdeps.1
@@ -0,0 +1,403 @@
+.\" Copyright (c) 2013, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JDEPS" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jdeps \- launch the Java class dependency analyzer
+.SH SYNOPSIS
+.PP
+\f[CB]jdeps\f[R] [\f[I]options\f[R]] \f[I]path\f[R] ...
+.TP
+.B \f[I]options\f[R]
+Command\-line options.
+For detailed descriptions of the options that can be used, see
+.RS
+.IP \[bu] 2
+\f[B]Possible Options\f[R]
+.IP \[bu] 2
+\f[B]Module Dependence Analysis Options\f[R]
+.IP \[bu] 2
+\f[B]Options to Filter Dependences\f[R]
+.IP \[bu] 2
+\f[B]Options to Filter Classes to be Analyzed\f[R]
+.RE
+.TP
+.B \f[I]path\f[R]
+A pathname to the \f[CB]\&.class\f[R] file, directory, or JAR file to
+analyze.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jdeps\f[R] command shows the package\-level or class\-level
+dependencies of Java class files.
+The input class can be a path name to a \f[CB]\&.class\f[R] file, a
+directory, a JAR file, or it can be a fully qualified class name to
+analyze all class files.
+The options determine the output.
+By default, the \f[CB]jdeps\f[R] command writes the dependencies to the
+system output.
+The command can generate the dependencies in DOT language (see the
+\f[CB]\-dotoutput\f[R] option).
+.SH POSSIBLE OPTIONS
+.TP
+.B \f[CB]\-?\f[R] or \f[CB]\-h\f[R] or \f[CB]\-\-help\f[R]
+Prints the help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-dotoutput\f[R] \f[I]dir\f[R] or \f[CB]\-\-dot\-output\f[R] \f[I]dir\f[R]
+Specifies the destination directory for DOT file output.
+If this option is specified, then the \f[CB]jdeps\f[R]command generates
+one \f[CB]\&.dot\f[R] file for each analyzed archive named
+\f[CB]archive\-file\-name.dot\f[R] that lists the dependencies, and also a
+summary file named \f[CB]summary.dot\f[R] that lists the dependencies
+among the archive files.
+.RS
+.RE
+.TP
+.B \f[CB]\-s\f[R] or \f[CB]\-summary\f[R]
+Prints a dependency summary only.
+.RS
+.RE
+.TP
+.B \f[CB]\-v\f[R] or \f[CB]\-verbose\f[R]
+Prints all class\-level dependencies.
+This is equivalent to
+.RS
+.RS
+.PP
+\f[CB]\-verbose:class\ \-filter:none\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-verbose:package\f[R]
+Prints package\-level dependencies excluding, by default, dependences
+within the same package.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose:class\f[R]
+Prints class\-level dependencies excluding, by default, dependencies
+within the same archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-apionly\f[R] or \f[CB]\-\-api\-only\f[R]
+Restricts the analysis to APIs, for example, dependences from the
+signature of \f[CB]public\f[R] and \f[CB]protected\f[R] members of public
+classes including field type, method parameter types, returned type, and
+checked exception types.
+.RS
+.RE
+.TP
+.B \f[CB]\-jdkinternals\f[R] or \f[CB]\-\-jdk\-internals\f[R]
+Finds class\-level dependences in the JDK internal APIs.
+By default, this option analyzes all classes specified in the
+\f[CB]\-\-classpath\f[R] option and input files unless you specified the
+\f[CB]\-include\f[R] option.
+You can\[aq]t use this option with the \f[CB]\-p\f[R], \f[CB]\-e\f[R], and
+\f[CB]\-s\f[R] options.
+.RS
+.PP
+\f[B]Warning\f[R]: The JDK internal APIs are inaccessible.
+.RE
+.TP
+.B \f[CB]\-cp\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies where to find class files.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]module\-path\f[R]
+Specifies the module path.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-upgrade\-module\-path\f[R] \f[I]module\-path\f[R]
+Specifies the upgrade module path.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-system\f[R] \f[I]java\-home\f[R]
+Specifies an alternate system module path.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\-name\f[R][\f[CB],\f[R] \f[I]module\-name\f[R]...]
+Adds modules to the root set for analysis.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-multi\-release\f[R] \f[I]version\f[R]
+Specifies the version when processing multi\-release JAR files.
+\f[I]version\f[R] should be an integer >=9 or base.
+.RS
+.RE
+.TP
+.B \f[CB]\-q\f[R] or \f[CB]\-quiet\f[R]
+Doesn\[aq]t show missing dependencies from
+\f[CB]\-generate\-module\-info\f[R] output.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R] or \f[CB]\-\-version\f[R]
+Prints version information.
+.RS
+.RE
+.SH MODULE DEPENDENCE ANALYSIS OPTIONS
+.TP
+.B \f[CB]\-m\f[R] \f[I]module\-name\f[R] or \f[CB]\-\-module\f[R] \f[I]module\-name\f[R]
+Specifies the root module for analysis.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-generate\-module\-info\f[R] \f[I]dir\f[R]
+Generates \f[CB]module\-info.java\f[R] under the specified directory.
+The specified JAR files will be analyzed.
+This option cannot be used with \f[CB]\-\-dot\-output\f[R] or
+\f[CB]\-\-class\-path\f[R] options.
+Use the \f[CB]\-\-generate\-open\-module\f[R] option for open modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-generate\-open\-module\f[R] \f[I]dir\f[R]
+Generates \f[CB]module\-info.java\f[R] for the specified JAR files under
+the specified directory as open modules.
+This option cannot be used with the \f[CB]\-\-dot\-output\f[R] or
+\f[CB]\-\-class\-path\f[R] options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-check\f[R] \f[I]module\-name\f[R] [\f[CB],\f[R] \f[I]module\-name\f[R]...]
+Analyzes the dependence of the specified modules.
+It prints the module descriptor, the resulting module dependences after
+analysis and the graph after transition reduction.
+It also identifies any unused qualified exports.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\-deps\f[R]
+Lists the module dependences and also the package names of JDK internal
+APIs (if referenced).
+This option transitively analyzes libraries on class path and module
+path if referenced.
+Use \f[CB]\-\-no\-recursive\f[R] option for non\-transitive dependency
+analysis.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\-reduced\-deps\f[R]
+Same as \f[CB]\-\-list\-deps\f[R] without listing the implied reads edges
+from the module graph.
+If module M1 reads M2, and M2 requires transitive on M3, then M1 reading
+M3 is implied and is not shown in the graph.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-print\-module\-deps\f[R]
+Same as \f[CB]\-\-list\-reduced\-deps\f[R] with printing a
+comma\-separated list of module dependences.
+The output can be used by \f[CB]jlink\ \-\-add\-modules\f[R] to create a
+custom image that contains those modules and their transitive
+dependences.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-ignore\-missing\-deps\f[R]
+Ignore missing dependences.
+.RS
+.RE
+.SH OPTIONS TO FILTER DEPENDENCES
+.TP
+.B \f[CB]\-p\f[R] \f[I]pkg_name\f[R], \f[CB]\-package\f[R] \f[I]pkg_name\f[R], or \f[CB]\-\-package\f[R] \f[I]pkg_name\f[R]
+Finds dependences matching the specified package name.
+You can specify this option multiple times for different packages.
+The \f[CB]\-p\f[R] and \f[CB]\-e\f[R] options are mutually exclusive.
+.RS
+.RE
+.TP
+.B \f[CB]\-e\f[R] \f[I]regex\f[R], \f[CB]\-regex\f[R] \f[I]regex\f[R], or \f[CB]\-\-regex\f[R] \f[I]regex\f[R]
+Finds dependences matching the specified pattern.
+The \f[CB]\-p\f[R] and \f[CB]\-e\f[R] options are mutually exclusive.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-require\f[R] \f[I]module\-name\f[R]
+Finds dependences matching the given module name (may be given multiple
+times).
+The \f[CB]\-\-package\f[R], \f[CB]\-\-regex\f[R], and \f[CB]\-\-require\f[R]
+options are mutually exclusive.
+.RS
+.RE
+.TP
+.B \f[CB]\-f\f[R] \f[I]regex\f[R] or \f[CB]\-filter\f[R] \f[I]regex\f[R]
+Filters dependences matching the given pattern.
+If give multiple times, the last one will be selected.
+.RS
+.RE
+.TP
+.B \f[CB]\-filter:package\f[R]
+Filters dependences within the same package.
+This is the default.
+.RS
+.RE
+.TP
+.B \f[CB]\-filter:archive\f[R]
+Filters dependences within the same archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-filter:module\f[R]
+Filters dependences within the same module.
+.RS
+.RE
+.TP
+.B \f[CB]\-filter:none\f[R]
+No \f[CB]\-filter:package\f[R] and \f[CB]\-filter:archive\f[R] filtering.
+Filtering specified via the \f[CB]\-filter\f[R] option still applies.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-missing\-deps\f[R]
+Finds missing dependences.
+This option cannot be used with \f[CB]\-p\f[R], \f[CB]\-e\f[R] and
+\f[CB]\-s\f[R] options.
+.RS
+.RE
+.SH OPTIONS TO FILTER CLASSES TO BE ANALYZED
+.TP
+.B \f[CB]\-include\f[R] \f[I]regex\f[R]
+Restricts analysis to the classes matching pattern.
+This option filters the list of classes to be analyzed.
+It can be used together with \f[CB]\-p\f[R] and \f[CB]\-e\f[R], which apply
+the pattern to the dependencies.
+.RS
+.RE
+.TP
+.B \f[CB]\-P\f[R] or \f[CB]\-profile\f[R]
+Shows the profile containing a package.
+.RS
+.RE
+.TP
+.B \f[CB]\-R\f[R] or \f[CB]\-\-recursive\f[R]
+Recursively traverses all run\-time dependences.
+The \f[CB]\-R\f[R] option implies \f[CB]\-filter:none\f[R].
+If \f[CB]\-p\f[R], \f[CB]\-e\f[R], or \f[CB]\-f\f[R] options are specified,
+only the matching dependences are analyzed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-no\-recursive\f[R]
+Do not recursively traverse dependences.
+.RS
+.RE
+.TP
+.B \f[CB]\-I\f[R] or \f[CB]\-\-inverse\f[R]
+Analyzes the dependences per other given options and then finds all
+artifacts that directly and indirectly depend on the matching nodes.
+This is equivalent to the inverse of the compile\-time view analysis and
+the print dependency summary.
+This option must be used with the \f[CB]\-\-require\f[R],
+\f[CB]\-\-package\f[R], or \f[CB]\-\-regex\f[R] options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-compile\-time\f[R]
+Analyzes the compile\-time view of transitive dependencies, such as the
+compile\-time view of the \f[CB]\-R\f[R] option.
+Analyzes the dependences per other specified options.
+If a dependency is found from a directory, a JAR file or a module, all
+classes in that containing archive are analyzed.
+.RS
+.RE
+.SH EXAMPLE OF ANALYZING DEPENDENCIES
+.PP
+The following example demonstrates analyzing the dependencies of the
+\f[CB]Notepad.jar\f[R] file.
+.PP
+\f[B]Linux and OS X:\f[R]
+.IP
+.nf
+\f[CB]
+$\ jdeps\ demo/jfc/Notepad/Notepad.jar
+Notepad.jar\ \->\ java.base
+Notepad.jar\ \->\ java.desktop
+Notepad.jar\ \->\ java.logging
+\ \ \ <unnamed>\ (Notepad.jar)
+\ \ \ \ \ \ \->\ java.awt
+\ \ \ \ \ \ \->\ java.awt.event
+\ \ \ \ \ \ \->\ java.beans
+\ \ \ \ \ \ \->\ java.io
+\ \ \ \ \ \ \->\ java.lang
+\ \ \ \ \ \ \->\ java.net
+\ \ \ \ \ \ \->\ java.util
+\ \ \ \ \ \ \->\ java.util.logging
+\ \ \ \ \ \ \->\ javax.swing
+\ \ \ \ \ \ \->\ javax.swing.border
+\ \ \ \ \ \ \->\ javax.swing.event
+\ \ \ \ \ \ \->\ javax.swing.text
+\ \ \ \ \ \ \->\ javax.swing.tree
+\ \ \ \ \ \ \->\ javax.swing.undo
+\f[R]
+.fi
+.PP
+\f[B]Windows:\f[R]
+.IP
+.nf
+\f[CB]
+C:\\Java\\jdk1.9.0>jdeps\ demo\\jfc\\Notepad\\Notepad.jar
+Notepad.jar\ \->\ java.base
+Notepad.jar\ \->\ java.desktop
+Notepad.jar\ \->\ java.logging
+\ \ \ <unnamed>\ (Notepad.jar)
+\ \ \ \ \ \ \->\ java.awt
+\ \ \ \ \ \ \->\ java.awt.event
+\ \ \ \ \ \ \->\ java.beans
+\ \ \ \ \ \ \->\ java.io
+\ \ \ \ \ \ \->\ java.lang
+\ \ \ \ \ \ \->\ java.net
+\ \ \ \ \ \ \->\ java.util
+\ \ \ \ \ \ \->\ java.util.logging
+\ \ \ \ \ \ \->\ javax.swing
+\ \ \ \ \ \ \->\ javax.swing.border
+\ \ \ \ \ \ \->\ javax.swing.event
+\ \ \ \ \ \ \->\ javax.swing.text
+\ \ \ \ \ \ \->\ javax.swing.tree
+\ \ \ \ \ \ \->\ javax.swing.undo
+\f[R]
+.fi
+.SH EXAMPLE USING THE \-\-INVERSE OPTION
+.IP
+.nf
+\f[CB]
+\ $\ jdeps\ \-\-inverse\ \-\-require\ java.xml.bind
+Inverse\ transitive\ dependences\ on\ [java.xml.bind]
+java.xml.bind\ <\-\ java.se.ee
+java.xml.bind\ <\-\ jdk.xml.ws
+java.xml.bind\ <\-\ java.xml.ws\ <\-\ java.se.ee
+java.xml.bind\ <\-\ java.xml.ws\ <\-\ jdk.xml.ws
+java.xml.bind\ <\-\ jdk.xml.bind\ <\-\ jdk.xml.ws
+\f[R]
+.fi
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jfr.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jfr.1
new file mode 100644
index 0000000..6f85e0c
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jfr.1
@@ -0,0 +1,295 @@
+.\" Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JFR" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jfr \- parse and print Flight Recorder files
+.SH SYNOPSIS
+.PP
+To print the contents of a flight recording to standard out:
+.PP
+\f[CB]jfr\f[R] \f[CB]print\f[R] [\f[I]options\f[R]] \f[I]file\f[R]
+.PP
+To print metadata information about flight recording events:
+.PP
+\f[CB]jfr\f[R] \f[CB]metadata\f[R] \f[I]file\f[R]
+.PP
+To assemble chunk files into a flight recording file:
+.PP
+\f[CB]jfr\f[R] \f[CB]assemble\f[R] \f[I]repository\f[R] \f[I]file\f[R]
+.PP
+To disassemble a flight recording file into chunk files:
+.PP
+\f[CB]jfr\f[R] \f[CB]disassmble\f[R] [\f[I]options\f[R]] \f[I]file\f[R]
+.PP
+To view the summary statistics for a flight recording file:
+.PP
+\f[CB]jfr\f[R] \f[CB]summary\f[R] \f[I]file\f[R]
+.TP
+.B \f[I]options\f[R]
+Optional: Specifies command\-line options separated by spaces.
+See the individual subcomponent sections for descriptions of the
+available options.
+.RS
+.RE
+.TP
+.B \f[I]file\f[R]
+Specifies the name of the target flight recording file
+(\f[CB]\&.jfr\f[R]).
+.RS
+.RE
+.TP
+.B \f[I]repository\f[R]
+Specifies the location of the chunk files which are to be assembled into
+a flight recording.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jfr\f[R] command provides a tool for interacting with flight
+recorder files (\f[CB]\&.jfr\f[R]).
+The main function is to filter, summarize and output flight recording
+files into human readable format.
+There is also support for merging and splitting recording files.
+.PP
+Flight recording files are created and saved as binary formatted files.
+Having a tool that can extract the contents from a flight recording and
+manipulate the contents and translate them into human readable format
+helps developers to debug performance issues with Java applications.
+.SS Subcommands
+.PP
+The \f[CB]jfr\f[R] command has several subcommands:
+.IP \[bu] 2
+\f[CB]print\f[R]
+.IP \[bu] 2
+\f[CB]summary\f[R]
+.IP \[bu] 2
+\f[CB]assemble\f[R]
+.IP \[bu] 2
+\f[CB]disassemble\f[R]
+.IP \[bu] 2
+\f[CB]metadata\f[R]
+.SS \f[CB]jfr\ print\f[R] subcommand
+.PP
+Use \f[CB]jfr\ print\f[R] to print the contents of a flight recording file
+to standard out.
+The syntax is:
+.PP
+\f[CB]jfr\ print\f[R] [\f[CB]\-\-xml\f[R]|\f[CB]\-\-json\f[R]]
+[\f[CB]\-\-categories\f[R] <\f[I]filters\f[R]>] [\f[CB]\-\-events\f[R]
+<\f[I]filters\f[R]>] [\f[CB]\-\-stack\-depth\f[R] <\f[I]depth\f[R]>]
+<\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B \f[CB]\-\-xml\f[R]
+Print the recording in XML format
+.RS
+.RE
+.TP
+.B \f[CB]\-\-json\f[R]
+Print the recording in JSON format
+.RS
+.RE
+.TP
+.B \f[CB]\-\-categories\f[R] <\f[I]filters\f[R]>
+Select events matching a category name.
+The filter is a comma\-separated list of names, simple and/or qualified,
+and/or quoted glob patterns
+.RS
+.RE
+.TP
+.B \f[CB]\-\-events\f[R] <\f[I]filters\f[R]>
+Select events matching an event name.
+The filter is a comma\-separated list of names, simple and/or qualified,
+and/or quoted glob patterns
+.RS
+.RE
+.TP
+.B \f[CB]\-\-stack\-depth\f[R] <\f[I]depth\f[R]>
+Number of frames in stack traces, by default 5
+.RS
+.RE
+.TP
+.B <\f[I]file\f[R]>
+Location of the recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.PP
+The default format for printing the contents of the flight recording
+file is human readable form unless either \f[CB]xml\f[R] or \f[CB]json\f[R]
+is specified.
+These options provide machine\-readable output that can be further
+parsed or processed by user created scripts.
+.PP
+Use \f[CB]jfr\ \-\-help\ print\f[R] to see example usage of filters.
+.PP
+To reduce the amount of data displayed, it is possible to filter out
+events or categories of events.
+The filter operates on the symbolic name of an event, set by using the
+\f[CB]\@Name\f[R] annotation, or the category name, set by using the
+\f[CB]\@Category\f[R] annotation.
+If multiple filters are used, events from both filters will be included.
+If no filter is used, all the events will be printed.
+If a combination of a category filter and event filter is used, the
+selected events will be the union of the two filters.
+.PP
+For example, to show all GC events and the CPULoad event, the following
+command could be used:
+.PP
+\f[CB]jfr\ print\ \-\-categories\ GC\ \-\-events\ CPULoad\ recording.jfr\f[R]
+.PP
+Event values are formatted according to the content types that are being
+used.
+For example, a field with the \f[CB]jdk.jfr.Percentage\f[R] annotation
+that has the value 0.52 is formatted as 52%.
+.PP
+Stack traces are by default truncated to 5 frames, but the number can be
+increased/decreased using the \f[CB]\-\-stack\-depth\f[R] command\-line
+option.
+.SS \f[CB]jfr\ summary\f[R] subcommand
+.PP
+Use \f[CB]jfr\ summary\f[R] to print statistics for a recording.
+For example, a summary can illustrate the number of recorded events and
+how much disk space they used.
+This is useful for troubleshooting and understanding the impact of event
+settings.
+.PP
+The syntax is:
+.PP
+\f[CB]jfr\ summary\f[R] <\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B <\f[I]file\f[R]>
+Location of the flight recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.SS \f[CB]jfr\ metadata\f[R] subcommand
+.PP
+Use \f[CB]jfr\ metadata\f[R] to view information about events, such as
+event names, categories and field layout within a flight recording file.
+The syntax is:
+.PP
+\f[CB]jfr\ metadata\f[R] <\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B <\f[I]file\f[R]>
+Location of the flight recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.SS jfr \f[CB]assemble\f[R] subcommand
+.PP
+Use jfr \f[CB]assemble\f[R] to assemble chunk files into a recording file.
+.PP
+The syntax is:
+.PP
+\f[CB]jfr\ assemble\f[R] <\f[I]repository\f[R]> <\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B <\f[I]repository\f[R]>
+Directory where the repository containing chunk files is located
+.RS
+.RE
+.TP
+.B <\f[I]file\f[R]>
+Location of the flight recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.PP
+Flight recording information is written in chunks.
+A chunk contains all of the information necessary for parsing.
+A chunk typically contains events useful for troubleshooting.
+If a JVM should crash, these chunks can be recovered and used to create
+a flight recording file using this \f[CB]jfr\ assemble\f[R] command.
+These chunk files are concatenated in chronological order and chunk
+files that are not finished (.part) are excluded.
+.SS \f[CB]jfr\ disassemble\f[R] subcommand
+.PP
+Use \f[CB]jfr\ disassemble\f[R] to decompose a flight recording file into
+its chunk file pieces.
+The syntax is:
+.PP
+\f[CB]jfr\ disassemble\f[R] [\f[CB]\-\-max\-chunks\f[R] <\f[I]chunks\f[R]>]
+[\f[CB]\-\-output\f[R] <\f[I]directory\f[R]>] <\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B \f[CB]\-\-output\f[R] <\f[I]directory\f[R]>
+The location to write the disassembled file, by default the current
+directory
+.RS
+.RE
+.TP
+.B \f[CB]\-\-max\-chunks\f[R] <\f[I]chunks\f[R]>
+Maximum number of chunks per file, by default 5.
+The chunk size varies, but is typically around 15 MB.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-max\-size\f[R] <\f[I]size\f[R]>
+Maximum number of bytes per file.
+.RS
+.RE
+.TP
+.B <\f[I]file\f[R]>
+Location of the flight recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.PP
+This function can be useful for repairing a broken file by removing the
+faulty chunk.
+It can also be used to reduce the size of a file that is too large to
+transfer.
+The resulting chunk files are named \f[CB]myfile_1.jfr\f[R],
+\f[CB]myfile_2.jfr\f[R], etc.
+If needed, the resulting file names will be padded with zeros to
+preserve chronological order.
+For example, the chunk file name is \f[CB]myfile_001.jfr\f[R] if the
+recording consists of more than 100 chunks.
+.SS jfr version and help subcommands
+.PP
+Use \f[CB]jfr\ \-\-version\f[R] or \f[CB]jfr\ version\f[R] to view the
+version string information for this jfr command.
+.PP
+To get help on any of the jfr subcommands, use:
+.PP
+\f[CB]jfr\ <\-\-help|help>\f[R] [\f[I]subcommand\f[R]]
+.PP
+where:
+.PP
+[\f[I]subcommand\f[R]] is any of:
+.IP \[bu] 2
+\f[CB]print\f[R]
+.IP \[bu] 2
+\f[CB]metadata\f[R]
+.IP \[bu] 2
+\f[CB]summary\f[R]
+.IP \[bu] 2
+\f[CB]assemble\f[R]
+.IP \[bu] 2
+\f[CB]disassemble\f[R]
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jhsdb.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jhsdb.1
new file mode 100644
index 0000000..50c1732
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jhsdb.1
@@ -0,0 +1,260 @@
+.\" Copyright (c) 2019, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JHSDB" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jhsdb \- attach to a Java process or launch a postmortem debugger to
+analyze the content of a core dump from a crashed Java Virtual Machine
+(JVM)
+.SH SYNOPSIS
+.PP
+\f[CB]jhsdb\f[R] \f[CB]clhsdb\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R]
+\f[I]coredump\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]hsdb\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R]
+\f[I]coredump\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]debugd\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R]
+\f[I]coredump\f[R]) [\f[I]options\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]jstack\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]
+| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R])
+[\f[I]options\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]jmap\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]
+| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R])
+[\f[I]options\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]jinfo\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]
+| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R])
+[\f[I]options\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]jsnap\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]
+| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R])
+[\f[I]options\f[R]]
+.TP
+.B \f[I]pid\f[R]
+The process ID to which the \f[CB]jhsdb\f[R] tool should attach.
+The process must be a Java process.
+To get a list of Java processes running on a machine, use the
+\f[CB]ps\f[R] command or, if the JVM processes are not running in a
+separate docker instance, the \f[B]jps\f[R] command.
+.RS
+.RE
+.TP
+.B \f[I]executable\f[R]
+The Java executable file from which the core dump was produced.
+.RS
+.RE
+.TP
+.B \f[I]coredump\f[R]
+The core file to which the \f[CB]jhsdb\f[R] tool should attach.
+.RS
+.RE
+.TP
+.B \f[I][server\-id\@]debugd\-host\f[R]
+An optional server ID and the address of the remote debug server
+(debugd).
+.RS
+.RE
+.TP
+.B \f[I]options\f[R]
+The command\-line options for a \f[CB]jhsdb\f[R] mode.
+See \f[B]Options for the debugd Mode\f[R], \f[B]Options for the jstack
+Mode\f[R], \f[B]Options for the jmap Mode\f[R], \f[B]Options for the jinfo
+Mode\f[R], and \f[B]Options for the jsnap Mode\f[R].
+.RS
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+Either the \f[I]pid\f[R] or the pair of \f[I]executable\f[R] and
+\f[I]core\f[R] files or the \f[I][server\-id\@]debugd\-host\f[R] must be
+provided for \f[CB]debugd\f[R], \f[CB]jstack\f[R], \f[CB]jmap\f[R],
+\f[CB]jinfo\f[R] and \f[CB]jsnap\f[R] modes.
+.SH DESCRIPTION
+.PP
+You can use the \f[CB]jhsdb\f[R] tool to attach to a Java process or to
+launch a postmortem debugger to analyze the content of a core\-dump from
+a crashed Java Virtual Machine (JVM).
+This command is experimental and unsupported.
+.PP
+\f[B]Note:\f[R]
+.PP
+Attaching the \f[CB]jhsdb\f[R] tool to a live process will cause the
+process to hang and the process will probably crash when the debugger
+detaches.
+.PP
+The \f[CB]jhsdb\f[R] tool can be launched in any one of the following
+modes:
+.TP
+.B \f[CB]jhsdb\ clhsdb\f[R]
+Starts the interactive command\-line debugger.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ hsdb\f[R]
+Starts the interactive GUI debugger.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ debugd\f[R]
+Starts the remote debug server.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ jstack\f[R]
+Prints stack and locks information.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ jmap\f[R]
+Prints heap information.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ jinfo\f[R]
+Prints basic JVM information.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ jsnap\f[R]
+Prints performance counter information.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\f[R] \f[I]command\f[R] \f[CB]\-\-help\f[R]
+Displays the options available for the \f[I]command\f[R].
+.RS
+.RE
+.SH OPTIONS FOR THE DEBUGD MODE
+.TP
+.B \f[CB]\-\-serverid\f[R] \f[I]server\-id\f[R]
+An optional unique ID for this debug server.
+This is required if multiple debug servers are run on the same machine.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-rmiport\f[R] \f[I]port\f[R]
+Sets the port number to which the RMI connector is bound.
+If not specified a random available port is used.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-registryport\f[R] \f[I]port\f[R]
+Sets the RMI registry port.
+This option overrides the system property
+\[aq]sun.jvm.hotspot.rmi.port\[aq].
+If not specified, the system property is used.
+If the system property is not set, the default port 1099 is used.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-hostname\f[R] \f[I]hostname\f[R]
+Sets the hostname the RMI connector is bound.
+The value could be a hostname or an IPv4/IPv6 address.
+This option overrides the system property
+\[aq]java.rmi.server.hostname\[aq].
+If not specified, the system property is used.
+If the system property is not set, a system hostname is used.
+.RS
+.RE
+.SH OPTIONS FOR THE JINFO MODE
+.TP
+.B \f[CB]\-\-flags\f[R]
+Prints the VM flags.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-sysprops\f[R]
+Prints the Java system properties.
+.RS
+.RE
+.TP
+.B no option
+Prints the VM flags and the Java system properties.
+.RS
+.RE
+.SH OPTIONS FOR THE JMAP MODE
+.TP
+.B no option
+Prints the same information as Solaris \f[CB]pmap\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-heap\f[R]
+Prints the \f[CB]java\f[R] heap summary.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-binaryheap\f[R]
+Dumps the \f[CB]java\f[R] heap in \f[CB]hprof\f[R] binary format.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dumpfile\f[R] \f[I]name\f[R]
+The name of the dumpfile.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-histo\f[R]
+Prints the histogram of \f[CB]java\f[R] object heap.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-clstats\f[R]
+Prints the class loader statistics.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-finalizerinfo\f[R]
+Prints the information on objects awaiting finalization.
+.RS
+.RE
+.SH OPTIONS FOR THE JSTACK MODE
+.TP
+.B \f[CB]\-\-locks\f[R]
+Prints the \f[CB]java.util.concurrent\f[R] locks information.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mixed\f[R]
+Attempts to print both \f[CB]java\f[R] and native frames if the platform
+allows it.
+.RS
+.RE
+.SH OPTIONS FOR THE JSNAP MODE
+.TP
+.B \f[CB]\-\-all\f[R]
+Prints all performance counters.
+.RS
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jinfo.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jinfo.1
new file mode 100644
index 0000000..872da9c
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jinfo.1
@@ -0,0 +1,105 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JINFO" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jinfo \- generate Java configuration information for a specified Java
+process
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jinfo\f[R] [\f[I]option\f[R]] \f[I]pid\f[R]
+.TP
+.B \f[I]option\f[R]
+This represents the \f[CB]jinfo\f[R] command\-line options.
+See \f[B]Options for the jinfo Command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]pid\f[R]
+The process ID for which the configuration information is to be printed.
+The process must be a Java process.
+To get a list of Java processes running on a machine, use either the
+\f[CB]ps\f[R] command or, if the JVM processes are not running in a
+separate docker instance, the \f[B]jps\f[R] command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jinfo\f[R] command prints Java configuration information for a
+specified Java process.
+The configuration information includes Java system properties and JVM
+command\-line flags.
+If the specified process is running on a 64\-bit JVM, then you might
+need to specify the \f[CB]\-J\-d64\f[R] option, for example:
+.RS
+.PP
+\f[CB]jinfo\ \-J\-d64\ \-sysprops\f[R] \f[I]pid\f[R]
+.RE
+.PP
+This command is unsupported and might not be available in future
+releases of the JDK.
+In Windows Systems where \f[CB]dbgeng.dll\f[R] is not present, the
+Debugging Tools for Windows must be installed to have these tools work.
+The \f[CB]PATH\f[R] environment variable should contain the location of
+the \f[CB]jvm.dll\f[R] that\[aq]s used by the target process or the
+location from which the core dump file was produced.
+.SH OPTIONS FOR THE JINFO COMMAND
+.PP
+\f[B]Note:\f[R]
+.PP
+If none of the following options are used, both the command\-line flags
+and the system property name\-value pairs are printed.
+.TP
+.B \f[CB]\-flag\f[R] \f[I]name\f[R]
+Prints the name and value of the specified command\-line flag.
+.RS
+.RE
+.TP
+.B \f[CB]\-flag\f[R] [\f[CB]+\f[R]|\f[CB]\-\f[R]]\f[I]name\f[R]
+Enables or disables the specified Boolean command\-line flag.
+.RS
+.RE
+.TP
+.B \f[CB]\-flag\f[R] \f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Sets the specified command\-line flag to the specified value.
+.RS
+.RE
+.TP
+.B \f[CB]\-flags\f[R]
+Prints command\-line flags passed to the JVM.
+.RS
+.RE
+.TP
+.B \f[CB]\-sysprops\f[R]
+Prints Java system properties as name\-value pairs.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] or \f[CB]\-help\f[R]
+Prints a help message.
+.RS
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jlink.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jlink.1
new file mode 100644
index 0000000..638262b
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jlink.1
@@ -0,0 +1,434 @@
+.\" Copyright (c) 2017, 2019, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JLINK" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jlink \- assemble and optimize a set of modules and their dependencies
+into a custom runtime image
+.SH SYNOPSIS
+.PP
+\f[CB]jlink\f[R] [\f[I]options\f[R]] \f[CB]\-\-module\-path\f[R]
+\f[I]modulepath\f[R] \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R] [,
+\f[I]module\f[R]...]
+.TP
+.B \f[I]options\f[R]
+Command\-line options separated by spaces.
+See \f[B]jlink Options\f[R].
+.RS
+.RE
+.TP
+.B \f[I]modulepath\f[R]
+The path where the \f[CB]jlink\f[R] tool discovers observable modules.
+These modules can be modular JAR files, JMOD files, or exploded modules.
+.RS
+.RE
+.TP
+.B \f[I]module\f[R]
+The names of the modules to add to the runtime image.
+The \f[CB]jlink\f[R] tool adds these modules and their transitive
+dependencies.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jlink\f[R] tool links a set of modules, along with their
+transitive dependences, to create a custom runtime image.
+.PP
+\f[B]Note:\f[R]
+.PP
+Developers are responsible for updating their custom runtime images.
+.SH JLINK OPTIONS
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]mod\f[R] [\f[CB],\f[R] \f[I]mod\f[R]...]
+Adds the named modules, \f[I]mod\f[R], to the default set of root
+modules.
+The default set of root modules is empty.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-bind\-services\f[R]
+Link service provider modules and their dependencies.
+.RS
+.RE
+.TP
+.B \f[CB]\-c\ ={0|1|2}\f[R] or \f[CB]\-\-compress={0|1|2}\f[R]
+Enable compression of resources:
+.RS
+.IP \[bu] 2
+\f[CB]0\f[R]: No compression
+.IP \[bu] 2
+\f[CB]1\f[R]: Constant string sharing
+.IP \[bu] 2
+\f[CB]2\f[R]: ZIP
+.RE
+.TP
+.B \f[CB]\-\-disable\-plugin\f[R] \f[I]pluginname\f[R]
+Disables the specified plug\-in.
+See \f[B]jlink Plug\-ins\f[R] for the list of supported plug\-ins.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-endian\f[R] {\f[CB]little\f[R]|\f[CB]big\f[R]}
+Specifies the byte order of the generated image.
+The default value is the format of your system\[aq]s architecture.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] or \f[CB]\-\-help\f[R]
+Prints the help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-ignore\-signing\-information\f[R]
+Suppresses a fatal error when signed modular JARs are linked in the
+runtime image.
+The signature\-related files of the signed modular JARs aren\[aq]t
+copied to the runtime image.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-launcher\f[R] \f[I]command\f[R]\f[CB]=\f[R]\f[I]module\f[R] or \f[CB]\-\-launcher\f[R] \f[I]command\f[R]\f[CB]=\f[R]\f[I]module\f[R]\f[CB]/\f[R]\f[I]main\f[R]
+Specifies the launcher command name for the module or the command name
+for the module and main class (the module and the main class names are
+separated by a slash (\f[CB]/\f[R])).
+.RS
+.RE
+.TP
+.B \f[CB]\-\-limit\-modules\f[R] \f[I]mod\f[R] [\f[CB],\f[R] \f[I]mod\f[R]...]
+Limits the universe of observable modules to those in the transitive
+closure of the named modules, \f[CB]mod\f[R], plus the main module, if
+any, plus any further modules specified in the \f[CB]\-\-add\-modules\f[R]
+option.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\-plugins\f[R]
+Lists available plug\-ins, which you can access through command\-line
+options; see \f[B]jlink Plug\-ins\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-p\f[R] or \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies the module path.
+.RS
+.PP
+If this option is not specified, then the default module path is
+\f[CB]$JAVA_HOME/jmods\f[R].
+This directory contains the \f[CB]java.base\f[R] module and the other
+standard and JDK modules.
+If this option is specified but the \f[CB]java.base\f[R] module cannot be
+resolved from it, then the \f[CB]jlink\f[R] command appends
+\f[CB]$JAVA_HOME/jmods\f[R] to the module path.
+.RE
+.TP
+.B \f[CB]\-\-no\-header\-files\f[R]
+Excludes header files.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-no\-man\-pages\f[R]
+Excludes man pages.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-output\f[R] \f[I]path\f[R]
+Specifies the location of the generated runtime image.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-save\-opts\f[R] \f[I]filename\f[R]
+Saves \f[CB]jlink\f[R] options in the specified file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-suggest\-providers\f[R] [\f[I]name\f[R]\f[CB],\f[R] ...]
+Suggest providers that implement the given service types from the module
+path.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints version information.
+.RS
+.RE
+.TP
+.B \f[CB]\@\f[R]\f[I]filename\f[R]
+Reads options from the specified file.
+.RS
+.PP
+An options file is a text file that contains the options and values that
+you would typically enter in a command prompt.
+Options may appear on one line or on several lines.
+You may not specify environment variables for path names.
+You may comment out lines by prefixing a hash symbol (\f[CB]#\f[R]) to the
+beginning of the line.
+.PP
+The following is an example of an options file for the \f[CB]jlink\f[R]
+command:
+.IP
+.nf
+\f[CB]
+#Wed\ Dec\ 07\ 00:40:19\ EST\ 2016
+\-\-module\-path\ mlib
+\-\-add\-modules\ com.greetings
+\-\-output\ greetingsapp
+\f[R]
+.fi
+.RE
+.SH JLINK PLUG\-INS
+.PP
+\f[B]Note:\f[R]
+.PP
+Plug\-ins not listed in this section aren\[aq]t supported and are
+subject to change.
+.PP
+For plug\-in options that require a \f[I]pattern\-list\f[R], the value is
+a comma\-separated list of elements, with each element using one the
+following forms:
+.IP \[bu] 2
+\f[I]glob\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]glob:\f[R]\f[I]glob\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]regex:\f[R]\f[I]regex\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]\@\f[R]\f[I]filename\f[R]
+.RS 2
+.IP \[bu] 2
+\f[I]filename\f[R] is the name of a file that contains patterns to be
+used, one pattern per line.
+.RE
+.PP
+For a complete list of all available plug\-ins, run the command
+\f[CB]jlink\ \-\-list\-plugins\f[R].
+.SS Plugin \f[CB]compress\f[R]
+.TP
+.B Options
+\f[CB]\-\-compress=\f[R]{\f[CB]0\f[R]|\f[CB]1\f[R]|\f[CB]2\f[R]}[\f[CB]:filter=\f[R]\f[I]pattern\-list\f[R]]
+.RS
+.RE
+.TP
+.B Description
+Compresses all resources in the output image.
+.RS
+.IP \[bu] 2
+Level 0: No compression
+.IP \[bu] 2
+Level 1: Constant string sharing
+.IP \[bu] 2
+Level 2: ZIP
+.PP
+An optional \f[I]pattern\-list\f[R] filter can be specified to list the
+pattern of files to include.
+.RE
+.SS Plugin \f[CB]include\-locales\f[R]
+.TP
+.B Options
+\f[CB]\-\-include\-locales=\f[R]\f[I]langtag\f[R][\f[CB],\f[R]\f[I]langtag\f[R]]*
+.RS
+.RE
+.TP
+.B Description
+Includes the list of locales where \f[I]langtag\f[R] is a BCP 47 language
+tag.
+This option supports locale matching as defined in RFC 4647.
+Ensure that you add the module jdk.localedata when using this option.
+.RS
+.PP
+Example:
+.RS
+.PP
+\f[CB]\-\-add\-modules\ jdk.localedata\ \-\-include\-locales=en,ja,*\-IN\f[R]
+.RE
+.RE
+.SS Plugin \f[CB]order\-resources\f[R]
+.TP
+.B Options
+\f[CB]\-\-order\-resources=\f[R]\f[I]pattern\-list\f[R]
+.RS
+.RE
+.TP
+.B Description
+Orders the specified paths in priority order.
+If \f[CB]\@\f[R]\f[I]filename\f[R] is specified, then each line in
+\f[I]pattern\-list\f[R] must be an exact match for the paths to be
+ordered.
+.RS
+.PP
+Example:
+.RS
+.PP
+\f[CB]\-\-order\-resources=/module\-info.class,\@classlist,/java.base/java/lang/\f[R]
+.RE
+.RE
+.SS Plugin \f[CB]strip\-debug\f[R]
+.TP
+.B Options
+\f[CB]\-\-strip\-debug\f[R]
+.RS
+.RE
+.TP
+.B Description
+Strips debug information from the output image.
+.RS
+.RE
+.SH JLINK EXAMPLES
+.PP
+The following command creates a runtime image in the directory
+\f[CB]greetingsapp\f[R].
+This command links the module \f[CB]com.greetings\f[R], whose module
+definition is contained in the directory \f[CB]mlib\f[R].
+.IP
+.nf
+\f[CB]
+jlink\ \-\-module\-path\ mlib\ \-\-add\-modules\ com.greetings\ \-\-output\ greetingsapp
+\f[R]
+.fi
+.PP
+The following command lists the modules in the runtime image
+\f[CB]greetingsapp\f[R]:
+.IP
+.nf
+\f[CB]
+greetingsapp/bin/java\ \-\-list\-modules
+com.greetings
+java.base\@11
+java.logging\@11
+org.astro\@1.0
+\f[R]
+.fi
+.PP
+The following command creates a runtime image in the directory
+compressedrt that\[aq]s stripped of debug symbols, uses compression to
+reduce space, and includes French language locale information:
+.IP
+.nf
+\f[CB]
+jlink\ \-\-add\-modules\ jdk.localedata\ \-\-strip\-debug\ \-\-compress=2\ \-\-include\-locales=fr\ \-\-output\ compressedrt
+\f[R]
+.fi
+.PP
+The following example compares the size of the runtime image
+\f[CB]compressedrt\f[R] with \f[CB]fr_rt\f[R], which isn\[aq]t stripped of
+debug symbols and doesn\[aq]t use compression:
+.IP
+.nf
+\f[CB]
+jlink\ \-\-add\-modules\ jdk.localedata\ \-\-include\-locales=fr\ \-\-output\ fr_rt
+
+du\ \-sh\ ./compressedrt\ ./fr_rt
+23M\ \ \ \ \ ./compressedrt
+36M\ \ \ \ \ ./fr_rt
+\f[R]
+.fi
+.PP
+The following example lists the providers that implement
+\f[CB]java.security.Provider\f[R]:
+.IP
+.nf
+\f[CB]
+jlink\ \-\-suggest\-providers\ java.security.Provider
+
+Suggested\ providers:
+\ \ java.naming\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ java.security.jgss\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ java.security.sasl\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ java.smartcardio\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ java.xml.crypto\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ jdk.crypto.cryptoki\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ jdk.crypto.ec\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ jdk.crypto.mscapi\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ jdk.security.jgss\ provides\ java.security.Provider\ used\ by\ java.base
+\f[R]
+.fi
+.PP
+The following example creates a custom runtime image named
+\f[CB]mybuild\f[R] that includes only \f[CB]java.naming\f[R] and
+\f[CB]jdk.crypto.cryptoki\f[R] and their dependencies but no other
+providers.
+Note that these dependencies must exist in the module path:
+.IP
+.nf
+\f[CB]
+jlink\ \-\-add\-modules\ java.naming,jdk.crypto.cryptoki\ \-\-output\ mybuild
+\f[R]
+.fi
+.PP
+The following command is similar to the one that creates a runtime image
+named \f[CB]greetingsapp\f[R], except that it will link the modules
+resolved from root modules with service binding; see the
+\f[B]\f[BC]Configuration.resolveAndBind\f[B]\f[R] method.
+.IP
+.nf
+\f[CB]
+jlink\ \-\-module\-path\ mlib\ \-\-add\-modules\ com.greetings\ \-\-output\ greetingsapp\ \-\-bind\-services
+\f[R]
+.fi
+.PP
+The following command lists the modules in the runtime image
+greetingsapp created by this command:
+.IP
+.nf
+\f[CB]
+greetingsapp/bin/java\ \-\-list\-modules
+com.greetings
+java.base\@11
+java.compiler\@11
+java.datatransfer\@11
+java.desktop\@11
+java.logging\@11
+java.management\@11
+java.management.rmi\@11
+java.naming\@11
+java.prefs\@11
+java.rmi\@11
+java.security.jgss\@11
+java.security.sasl\@11
+java.smartcardio\@11
+java.xml\@11
+java.xml.crypto\@11
+jdk.accessibility\@11
+jdk.charsets\@11
+jdk.compiler\@11
+jdk.crypto.cryptoki\@11
+jdk.crypto.ec\@11
+jdk.crypto.mscapi\@11
+jdk.internal.opt\@11
+jdk.jartool\@11
+jdk.javadoc\@11
+jdk.jdeps\@11
+jdk.jfr\@11
+jdk.jlink\@11
+jdk.localedata\@11
+jdk.management\@11
+jdk.management.jfr\@11
+jdk.naming.dns\@11
+jdk.naming.rmi\@11
+jdk.security.auth\@11
+jdk.security.jgss\@11
+jdk.zipfs\@11
+org.astro\@1.0
+\f[R]
+.fi
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jmap.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jmap.1
new file mode 100644
index 0000000..d58aac7
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jmap.1
@@ -0,0 +1,101 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JMAP" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jmap \- print details of a specified process
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jmap\f[R] [\f[I]options\f[R]] \f[I]pid\f[R]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jmap\f[R] command\-line options.
+See \f[B]Options for the jmap Command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]pid\f[R]
+The process ID for which the information specified by the
+\f[I]options\f[R] is to be printed.
+The process must be a Java process.
+To get a list of Java processes running on a machine, use either the
+\f[CB]ps\f[R] command or, if the JVM processes are not running in a
+separate docker instance, the \f[B]jps\f[R] command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jmap\f[R] command prints details of a specified running process.
+.PP
+\f[B]Note:\f[R]
+.PP
+This command is unsupported and might not be available in future
+releases of the JDK.
+On Windows Systems where the \f[CB]dbgeng.dll\f[R] file isn\[aq]t present,
+the Debugging Tools for Windows must be installed to make these tools
+work.
+The \f[CB]PATH\f[R] environment variable should contain the location of
+the \f[CB]jvm.dll\f[R] file that\[aq]s used by the target process or the
+location from which the core dump file was produced.
+.SH OPTIONS FOR THE JMAP COMMAND
+.TP
+.B \f[CB]\-clstats\f[R] \f[I]pid\f[R]
+Connects to a running process and prints class loader statistics of Java
+heap.
+.RS
+.RE
+.TP
+.B \f[CB]\-finalizerinfo\f[R] \f[I]pid\f[R]
+Connects to a running process and prints information on objects awaiting
+finalization.
+.RS
+.RE
+.TP
+.B \f[CB]\-histo\f[R][\f[CB]:live\f[R]] \f[I]pid\f[R]
+Connects to a running process and prints a histogram of the Java object
+heap.
+If the \f[CB]live\f[R] suboption is specified, it then counts only live
+objects.
+.RS
+.RE
+.TP
+.B \f[CB]\-dump:\f[R]\f[I]dump_options\f[R] \f[I]pid\f[R]
+Connects to a running process and dumps the Java heap.
+The \f[I]dump_options\f[R] include:
+.RS
+.IP \[bu] 2
+\f[CB]live\f[R] \-\-\- When specified, dumps only the live objects; if not
+specified, then dumps all objects in the heap.
+.IP \[bu] 2
+\f[CB]format=b\f[R] \-\-\- Dumps the Java heap in \f[CB]hprof\f[R] binary
+format
+.IP \[bu] 2
+\f[CB]file=\f[R]\f[I]filename\f[R] \-\-\- Dumps the heap to
+\f[I]filename\f[R]
+.PP
+Example: \f[CB]jmap\ \-dump:live,format=b,file=heap.bin\f[R] \f[I]pid\f[R]
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jmod.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jmod.1
new file mode 100644
index 0000000..0ac0647
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jmod.1
@@ -0,0 +1,439 @@
+.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JMOD" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jmod \- create JMOD files and list the content of existing JMOD files
+.SH SYNOPSIS
+.PP
+\f[CB]jmod\f[R]
+(\f[CB]create\f[R]|\f[CB]extract\f[R]|\f[CB]list\f[R]|\f[CB]describe\f[R]|\f[CB]hash\f[R])
+[\f[I]options\f[R]] \f[I]jmod\-file\f[R]
+.PP
+Includes the following:
+.PP
+\f[B]Main operation modes\f[R]
+.TP
+.B \f[CB]create\f[R]
+Creates a new JMOD archive file.
+.RS
+.RE
+.TP
+.B \f[CB]extract\f[R]
+Extracts all the files from the JMOD archive file.
+.RS
+.RE
+.TP
+.B \f[CB]list\f[R]
+Prints the names of all the entries.
+.RS
+.RE
+.TP
+.B \f[CB]describe\f[R]
+Prints the module details.
+.RS
+.RE
+.TP
+.B \f[CB]hash\f[R]
+Determines leaf modules and records the hashes of the dependencies that
+directly and indirectly require them.
+.RS
+.RE
+.PP
+\f[B]Options\f[R]
+.TP
+.B \f[I]options\f[R]
+See \f[B]Options for jmod\f[R].
+.RS
+.RE
+.PP
+\f[B]Required\f[R]
+.TP
+.B \f[I]jmod\-file\f[R]
+Specifies the name of the JMOD file to create or from which to retrieve
+information.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+\f[B]Note:\f[R] For most development tasks, including deploying modules
+on the module path or publishing them to a Maven repository, continue to
+package modules in modular JAR files.
+The \f[CB]jmod\f[R] tool is intended for modules that have native
+libraries or other configuration files or for modules that you intend to
+link, with the \f[B]jlink\f[R] tool, to a runtime image.
+.PP
+The JMOD file format lets you aggregate files other than
+\f[CB]\&.class\f[R] files, metadata, and resources.
+This format is transportable but not executable, which means that you
+can use it during compile time or link time but not at run time.
+.PP
+Many \f[CB]jmod\f[R] options involve specifying a path whose contents are
+copied into the resulting JMOD files.
+These options copy all the contents of the specified path, including
+subdirectories and their contents, but exclude files whose names match
+the pattern specified by the \f[CB]\-\-exclude\f[R] option.
+.PP
+With the \f[CB]\-\-hash\-modules\f[R] option or the \f[CB]jmod\ hash\f[R]
+command, you can, in each module\[aq]s descriptor, record hashes of the
+content of the modules that are allowed to depend upon it, thus "tying"
+together these modules.
+This enables a package to be exported to one or more specifically\-named
+modules and to no others through qualified exports.
+The runtime verifies if the recorded hash of a module matches the one
+resolved at run time; if not, the runtime returns an error.
+.SH OPTIONS FOR JMOD
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the location of application JAR files or a directory
+containing classes to copy into the resulting JMOD file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-cmds\f[R] \f[I]path\f[R]
+Specifies the location of native commands to copy into the resulting
+JMOD file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-config\f[R] \f[I]path\f[R]
+Specifies the location of user\-editable configuration files to copy
+into the resulting JMOD file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dir\f[R] \f[I]path\f[R]
+Specifies the location where \f[CB]jmod\f[R] puts extracted files from the
+specified JMOD archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dry\-run\f[R]
+Performs a dry run of hash mode.
+It identifies leaf modules and their required modules without recording
+any hash values.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-exclude\f[R] \f[I]pattern\-list\f[R]
+Excludes files matching the supplied comma\-separated pattern list, each
+element using one the following forms:
+.RS
+.IP \[bu] 2
+\f[I]glob\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]glob:\f[R]\f[I]glob\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]regex:\f[R]\f[I]regex\-pattern\f[R]
+.PP
+See the \f[B]\f[BC]FileSystem.getPathMatcher\f[B]\f[R] method for the
+syntax of \f[I]glob\-pattern\f[R].
+See the \f[B]\f[BC]Pattern\f[B]\f[R] class for the syntax of
+\f[I]regex\-pattern\f[R], which represents a regular expression.
+.RE
+.TP
+.B \f[CB]\-\-hash\-modules\f[R] \f[I]regex\-pattern\f[R]
+Determines the leaf modules and records the hashes of the dependencies
+directly and indirectly requiring them, based on the module graph of the
+modules matching the given \f[I]regex\-pattern\f[R].
+The hashes are recorded in the JMOD archive file being created, or a
+JMOD archive or modular JAR on the module path specified by the
+\f[CB]jmod\ hash\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-header\-files\f[R] \f[I]path\f[R]
+Specifies the location of header files to copy into the resulting JMOD
+file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R]
+Prints a usage message.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R]
+Prints help for extra options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-legal\-notices\f[R] \f[I]path\f[R]
+Specifies the location of legal notices to copy into the resulting JMOD
+file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-libs\f[R] \f[I]path\f[R]
+Specifies location of native libraries to copy into the resulting JMOD
+file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-main\-class\f[R] \f[I]class\-name\f[R]
+Specifies main class to record in the module\-info.class file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-man\-pages\f[R] \f[I]path\f[R]
+Specifies the location of man pages to copy into the resulting JMOD
+file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-version\f[R] \f[I]module\-version\f[R]
+Specifies the module version to record in the module\-info.class file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]path\f[R] or \f[CB]\-p\f[R] \f[I]path\f[R]
+Specifies the module path.
+This option is required if you also specify \f[CB]\-\-hash\-modules\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-target\-platform\f[R] \f[I]platform\f[R]
+Specifies the target platform.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints version information of the \f[CB]jmod\f[R] tool.
+.RS
+.RE
+.TP
+.B \f[CB]\@\f[R]\f[I]filename\f[R]
+Reads options from the specified file.
+.RS
+.PP
+An options file is a text file that contains the options and values that
+you would ordinarily enter in a command prompt.
+Options may appear on one line or on several lines.
+You may not specify environment variables for path names.
+You may comment out lines by prefixinga hash symbol (\f[CB]#\f[R]) to the
+beginning of the line.
+.PP
+The following is an example of an options file for the \f[CB]jmod\f[R]
+command:
+.IP
+.nf
+\f[CB]
+#Wed\ Dec\ 07\ 00:40:19\ EST\ 2016
+create\ \-\-class\-path\ mods/com.greetings\ \-\-module\-path\ mlib
+\ \ \-\-cmds\ commands\ \-\-config\ configfiles\ \-\-header\-files\ src/h
+\ \ \-\-libs\ lib\ \-\-main\-class\ com.greetings.Main
+\ \ \-\-man\-pages\ man\ \-\-module\-version\ 1.0
+\ \ \-\-os\-arch\ "x86_x64"\ \-\-os\-name\ "Mac\ OS\ X"
+\ \ \-\-os\-version\ "10.10.5"\ greetingsmod
+\f[R]
+.fi
+.RE
+.SH EXTRA OPTIONS FOR JMOD
+.PP
+In addition to the options described in \f[B]Options for jmod\f[R], the
+following are extra options that can be used with the command.
+.TP
+.B \f[CB]\-\-do\-not\-resolve\-by\-default\f[R]
+Exclude from the default root set of modules
+.RS
+.RE
+.TP
+.B \f[CB]\-\-warn\-if\-resolved\f[R]
+Hint for a tool to issue a warning if the module is resolved.
+One of deprecated, deprecated\-for\-removal, or incubating.
+.RS
+.RE
+.SH JMOD CREATE EXAMPLE
+.PP
+The following is an example of creating a JMOD file:
+.IP
+.nf
+\f[CB]
+jmod\ create\ \-\-class\-path\ mods/com.greetings\ \-\-cmds\ commands
+\ \ \-\-config\ configfiles\ \-\-header\-files\ src/h\ \-\-libs\ lib
+\ \ \-\-main\-class\ com.greetings.Main\ \-\-man\-pages\ man\ \-\-module\-version\ 1.0
+\ \ \-\-os\-arch\ "x86_x64"\ \-\-os\-name\ "Mac\ OS\ X"
+\ \ \-\-os\-version\ "10.10.5"\ greetingsmod
+\f[R]
+.fi
+.SH JMOD HASH EXAMPLE
+.PP
+The following example demonstrates what happens when you try to link a
+leaf module (in this example, \f[CB]ma\f[R]) with a required module
+(\f[CB]mb\f[R]), and the hash value recorded in the required module
+doesn\[aq]t match that of the leaf module.
+.IP "1." 3
+Create and compile the following \f[CB]\&.java\f[R] files:
+.RS 4
+.IP \[bu] 2
+\f[CB]jmodhashex/src/ma/module\-info.java\f[R]
+.RS 2
+.IP
+.nf
+\f[CB]
+module\ ma\ {
+\ \ requires\ mb;
+}
+\f[R]
+.fi
+.RE
+.IP \[bu] 2
+\f[CB]jmodhashex/src/mb/module\-info.java\f[R]
+.RS 2
+.IP
+.nf
+\f[CB]
+module\ mb\ {
+}
+\f[R]
+.fi
+.RE
+.IP \[bu] 2
+\f[CB]jmodhashex2/src/ma/module\-info.java\f[R]
+.RS 2
+.IP
+.nf
+\f[CB]
+module\ ma\ {
+\ \ requires\ mb;
+}
+\f[R]
+.fi
+.RE
+.IP \[bu] 2
+\f[CB]jmodhashex2/src/mb/module\-info.java\f[R]
+.RS 2
+.IP
+.nf
+\f[CB]
+module\ mb\ {
+}
+\f[R]
+.fi
+.RE
+.RE
+.IP "2." 3
+Create a JMOD archive for each module.
+Create the directories \f[CB]jmodhashex/jmods\f[R] and
+\f[CB]jmodhashex2/jmods\f[R], and then run the following commands from the
+\f[CB]jmodhashex\f[R] directory, then from the \f[CB]jmodhashex2\f[R]
+directory:
+.RS 4
+.IP \[bu] 2
+\f[CB]jmod\ create\ \-\-class\-path\ mods/ma\ jmods/ma.jmod\f[R]
+.IP \[bu] 2
+\f[CB]jmod\ create\ \-\-class\-path\ mods/mb\ jmods/mb.jmod\f[R]
+.RE
+.IP "3." 3
+Optionally preview the \f[CB]jmod\ hash\f[R] command.
+Run the following command from the \f[CB]jmodhashex\f[R] directory:
+.RS 4
+.PP
+\f[CB]jmod\ hash\ \-\-dry\-run\ \-module\-path\ jmods\ \-\-hash\-modules\ .*\f[R]
+.PP
+The command prints the following:
+.IP
+.nf
+\f[CB]
+Dry\ run:
+mb
+\ \ hashes\ ma\ SHA\-256\ 07667d5032004b37b42ec2bb81b46df380cf29e66962a16481ace2e71e74073a
+\f[R]
+.fi
+.PP
+This indicates that the \f[CB]jmod\ hash\f[R] command (without the
+\f[CB]\-\-dry\-run\f[R] option) will record the hash value of the leaf
+module \f[CB]ma\f[R] in the module \f[CB]mb\f[R].
+.RE
+.IP "4." 3
+Record hash values in the JMOD archive files contained in the
+\f[CB]jmodhashex\f[R] directory.
+Run the following command from the \f[CB]jmodhashex\f[R] directory:
+.RS 4
+.RS
+.PP
+\f[CB]jmod\ hash\ \-\-module\-path\ jmods\ \-\-hash\-modules\ .*\f[R]
+.RE
+.PP
+The command prints the following:
+.RS
+.PP
+\f[CB]Hashes\ are\ recorded\ in\ module\ mb\f[R]
+.RE
+.RE
+.IP "5." 3
+Print information about each JMOD archive contained in the
+\f[CB]jmodhashex\f[R] directory.
+Run the highlighted commands from the \f[CB]jmodhashex\f[R] directory:
+.RS 4
+.IP
+.nf
+\f[CB]
+jmod\ describe\ jmods/ma.jmod
+
+ma
+\ \ requires\ mandated\ java.base
+\ \ requires\ mb
+
+jmod\ describe\ jmods/mb.jmod
+
+mb
+\ \ requires\ mandated\ java.base
+\ \ hashes\ ma\ SHA\-256\ 07667d5032004b37b42ec2bb81b46df380cf29e66962a16481ace2e71e74073a
+\f[R]
+.fi
+.RE
+.IP "6." 3
+Attempt to create a runtime image that contains the module \f[CB]ma\f[R]
+from the directory \f[CB]jmodhashex2\f[R] but the module \f[CB]mb\f[R] from
+the directory \f[CB]jmodhashex\f[R].
+Run the following command from the \f[CB]jmodhashex2\f[R] directory:
+.RS 4
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]jlink\ \-\-module\-path\ $JAVA_HOME/jmods:jmods/ma.jmod:../jmodhashex/jmods/mb.jmod\ \-\-add\-modules\ ma\ \-\-output\ ma\-app\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]jlink\ \-\-module\-path\ %JAVA_HOME%/jmods;jmods/ma.jmod;../jmodhashex/jmods/mb.jmod\ \-\-add\-modules\ ma\ \-\-output\ ma\-app\f[R]
+.RE
+.RE
+.PP
+The command prints an error message similar to the following:
+.IP
+.nf
+\f[CB]
+Error:\ Hash\ of\ ma\ (a2d77889b0cb067df02a3abc39b01ac1151966157a68dc4241562c60499150d2)\ differs\ to
+expected\ hash\ (07667d5032004b37b42ec2bb81b46df380cf29e66962a16481ace2e71e74073a)\ recorded\ in\ mb
+\f[R]
+.fi
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jpackage.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jpackage.1
new file mode 100644
index 0000000..eeefbfb
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jpackage.1
@@ -0,0 +1,525 @@
+.\" Copyright (c) 2018, 2021, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JPACKAGE" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jpackage \- tool for packaging self\-contained Java applications.
+.SH SYNOPSIS
+.PP
+\f[CB]jpackage\f[R] [\f[I]options\f[R]]
+.TP
+.B \f[I]options\f[R]
+Command\-line options separated by spaces.
+See \f[B]jpackage Options\f[R].
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jpackage\f[R] tool will take as input a Java application and a
+Java run\-time image, and produce a Java application image that includes
+all the necessary dependencies.
+It will be able to produce a native package in a platform\-specific
+format, such as an exe on Windows or a dmg on macOS.
+Each format must be built on the platform it runs on, there is no
+cross\-platform support.
+The tool will have options that allow packaged applications to be
+customized in various ways.
+.SH JPACKAGE OPTIONS
+.SS Generic Options:
+.TP
+.B \f[CB]\@\f[R]\f[I]filename\f[R]
+Read options from a file.
+.RS
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-type\f[R] or \f[CB]\-t\f[R] <type string>
+The type of package to create
+.RS
+.PP
+Valid values are: {"app\-image", "exe", "msi", "rpm", "deb", "pkg",
+"dmg"}
+.PP
+If this option is not specified a platform dependent default type will
+be created.
+.RE
+.TP
+.B \f[CB]\-\-app\-version\f[R] <version>
+Version of the application and/or package
+.RS
+.RE
+.TP
+.B \f[CB]\-\-copyright\f[R] <copyright string>
+Copyright for the application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-description\f[R] <description string>
+Description of the application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R]
+Print the usage text with a list and description of each valid option
+for the current platform to the output stream, and exit.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-icon\f[R] <icon file path>
+Path of the icon of the application package (absolute path or relative
+to the current directory)
+.RS
+.RE
+.TP
+.B \f[CB]\-\-name\f[R] or \f[CB]\-n\f[R] <name>
+Name of the application and/or package
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dest\f[R] or \f[CB]\-d\f[R] <output path>
+Path where generated output file is placed
+.RS
+.PP
+Defaults to the current working directory.
+(absolute path or relative to the current directory).
+.RE
+.TP
+.B \f[CB]\-\-temp\f[R] <directory path>
+Path of a new or empty directory used to create temporary files
+(absolute path or relative to the current directory)
+.RS
+.PP
+If specified, the temp dir will not be removed upon the task completion
+and must be removed manually.
+.PP
+If not specified, a temporary directory will be created and removed upon
+the task completion.
+.RE
+.TP
+.B \f[CB]\-\-vendor\f[R] <vendor string>
+Vendor of the application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-verbose\f[R]
+Enables verbose output.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Print the product version to the output stream and exit.
+.RS
+.RE
+.SS Options for creating the runtime image:
+.TP
+.B \f[CB]\-\-add\-modules\f[R] <module name> [\f[CB],\f[R]<module name>...]
+A comma (",") separated list of modules to add
+.RS
+.PP
+This module list, along with the main module (if specified) will be
+passed to jlink as the \-\-add\-module argument.
+If not specified, either just the main module (if \-\-module is
+specified), or the default set of modules (if \-\-main\-jar is
+specified) are used.
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] or \f[CB]\-p\f[R] <module path>...
+A File.pathSeparator separated list of paths
+.RS
+.PP
+Each path is either a directory of modules or the path to a modular jar,
+and is absolute or relative to the current directory.
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-jlink\-options\f[R] <jlink options>
+A space separated list of options to pass to jlink
+.RS
+.PP
+If not specified, defaults to "\-\-strip\-native\-commands
+\-\-strip\-debug \-\-no\-man\-pages \-\-no\-header\-files"
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-runtime\-image\f[R] <directory path>
+Path of the predefined runtime image that will be copied into the
+application image (absolute path or relative to the current directory)
+.RS
+.PP
+If \-\-runtime\-image is not specified, jpackage will run jlink to
+create the runtime image using options specified by \-\-jlink\-options.
+.RE
+.SS Options for creating the application image:
+.TP
+.B \f[CB]\-\-input\f[R] or \f[CB]\-i\f[R] <input path>
+Path of the input directory that contains the files to be packaged
+(absolute path or relative to the current directory)
+.RS
+.PP
+All files in the input directory will be packaged into the application
+image.
+.RE
+.SS Options for creating the application launcher(s):
+.TP
+.B \f[CB]\-\-add\-launcher\f[R] <launcher name>=<file path>
+Name of launcher, and a path to a Properties file that contains a list
+of key, value pairs (absolute path or relative to the current directory)
+.RS
+.PP
+The keys "module", "main\-jar", "main\-class", "arguments",
+"java\-options", "app\-version", "icon", "linux\-app\-category",
+"linux\-app\-release", and "win\-console" can be used.
+.PP
+These options are added to, or used to overwrite, the original command
+line options to build an additional alternative launcher.
+The main application launcher will be built from the command line
+options.
+Additional alternative launchers can be built using this option, and
+this option can be used multiple times to build multiple additional
+launchers.
+.RE
+.TP
+.B \f[CB]\-\-arguments\f[R] <main class arguments>
+Command line arguments to pass to the main class if no command line
+arguments are given to the launcher
+.RS
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-java\-options\f[R] <java options>
+Options to pass to the Java runtime
+.RS
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-main\-class\f[R] <class name>
+Qualified name of the application main class to execute
+.RS
+.PP
+This option can only be used if \-\-main\-jar is specified.
+.RE
+.TP
+.B \f[CB]\-\-main\-jar\f[R] <main jar file>
+The main JAR of the application; containing the main class (specified as
+a path relative to the input path)
+.RS
+.PP
+Either \-\-module or \-\-main\-jar option can be specified but not both.
+.RE
+.TP
+.B \f[CB]\-\-module\f[R] or \f[CB]\-m\f[R] <module name>/<main class>]
+The main module (and optionally main class) of the application
+.RS
+.PP
+This module must be located on the module path.
+.PP
+When this option is specified, the main module will be linked in the
+Java runtime image.
+Either \-\-module or \-\-main\-jar option can be specified but not both.
+.RE
+.SS Platform dependent option for creating the application launcher:
+.SS Windows platform options (available only when running on Windows):
+.TP
+.B \f[CB]\-\-win\-console\f[R]
+Creates a console launcher for the application, should be specified for
+application which requires console interactions
+.RS
+.RE
+.SS macOS platform options (available only when running on macOS):
+.TP
+.B \f[CB]\-\-mac\-package\-identifier\f[R] <ID string>
+An identifier that uniquely identifies the application for macOS
+.RS
+.PP
+Defaults to the the main class name.
+.PP
+May only use alphanumeric (A\-Z,a\-z,0\-9), hyphen (\-), and period (.)
+characters.
+.RE
+.TP
+.B \f[CB]\-\-mac\-package\-name\f[R] <name string>
+Name of the application as it appears in the Menu Bar
+.RS
+.PP
+This can be different from the application name.
+.PP
+This name must be less than 16 characters long and be suitable for
+displaying in the menu bar and the application Info window.
+Defaults to the application name.
+.RE
+.TP
+.B \f[CB]\-\-mac\-package\-signing\-prefix\f[R] <prefix string>
+When signing the application package, this value is prefixed to all
+components that need to be signed that don\[aq]t have an existing
+package identifier.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-sign\f[R]
+Request that the bundle be signed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-signing\-keychain\f[R] <keychain name>
+Name of the keychain to search for the signing identity
+.RS
+.PP
+If not specified, the standard keychains are used.
+.RE
+.TP
+.B \f[CB]\-\-mac\-signing\-key\-user\-name\f[R] <team name>
+Team or user name portion in Apple signing identities
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-app\-store\f[R]
+Indicates that the jpackage output is intended for the Mac App Store.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-entitlements\f[R] <file path>
+Path to file containing entitlements to use when signing executables and
+libraries in the bundle
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-app\-category\f[R] <category string>
+String used to construct LSApplicationCategoryType in application plist
+.RS
+.PP
+The default value is "utilities".
+.RE
+.SS Options for creating the application package:
+.TP
+.B \f[CB]\-\-about\-url\f[R] <url>
+URL of the application\[aq]s home page
+.RS
+.RE
+.TP
+.B \f[CB]\-\-app\-image\f[R] <directory path>
+Location of the predefined application image that is used to build an
+installable package
+.RS
+.PP
+(absolute path or relative to the current directory).
+.PP
+See create\-app\-image mode options to create the application image.
+.RE
+.TP
+.B \f[CB]\-\-file\-associations\f[R] <file path>
+Path to a Properties file that contains list of key, value pairs
+(absolute path or relative to the current directory)
+.RS
+.PP
+The keys "extension", "mime\-type", "icon", and "description" can be
+used to describe the association.
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-install\-dir\f[R] <directory path>
+Absolute path of the installation directory of the application (on macos
+or linux), or relative sub\-path of the installation directory such as
+"Program Files" or "AppData" (on Windows)
+.RS
+.RE
+.TP
+.B \f[CB]\-\-license\-file\f[R] <file path>
+Path to the license file (absolute path or relative to the current
+directory)
+.RS
+.RE
+.TP
+.B \f[CB]\-\-resource\-dir\f[R] <directory path>
+Path to override jpackage resources (absolute path or relative to the
+current directory)
+.RS
+.PP
+Icons, template files, and other resources of jpackage can be
+over\-ridden by adding replacement resources to this directory.
+.RE
+.TP
+.B \f[CB]\-\-runtime\-image\f[R] <directory path>
+Path of the predefined runtime image to install (absolute path or
+relative to the current directory)
+.RS
+.PP
+Option is required when creating a runtime installer.
+.RE
+.SS Platform dependent options for creating the application package:
+.SS Windows platform options (available only when running on Windows):
+.TP
+.B \f[CB]\-\-win\-dir\-chooser\f[R]
+Adds a dialog to enable the user to choose a directory in which the
+product is installed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-help\-url\f[R] <url>
+URL where user can obtain further information or technical support
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-menu\f[R]
+Request to add a Start Menu shortcut for this application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-menu\-group\f[R] <menu group name>
+Start Menu group this application is placed in
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-per\-user\-install\f[R]
+Request to perform an install on a per\-user basis
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-shortcut\f[R]
+Request to create a desktop shortcut for this application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-shortcut\-prompt\f[R]
+Adds a dialog to enable the user to choose if shortcuts will be created
+by installer
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-update\-url\f[R] <url>
+URL of available application update information
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-upgrade\-uuid\f[R] <id string>
+UUID associated with upgrades for this package
+.RS
+.RE
+.SS Linux platform options (available only when running on Linux):
+.TP
+.B \f[CB]\-\-linux\-package\-name\f[R] <package name>
+Name for Linux package
+.RS
+.PP
+Defaults to the application name.
+.RE
+.TP
+.B \f[CB]\-\-linux\-deb\-maintainer\f[R] <email address>
+Maintainer for .deb bundle
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-menu\-group\f[R] <menu\-group\-name>
+Menu group this application is placed in
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-package\-deps\f[R]
+Required packages or capabilities for the application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-rpm\-license\-type\f[R] <type string>
+Type of the license ("License: <value>" of the RPM .spec)
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-app\-release\f[R] <release string>
+Release value of the RPM <name>.spec file or Debian revision value of
+the DEB control file
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-app\-category\f[R] <category string>
+Group value of the RPM <name>.spec file or Section value of DEB control
+file
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-shortcut\f[R]
+Creates a shortcut for the application.
+.RS
+.RE
+.SH JPACKAGE EXAMPLES
+.IP
+.nf
+\f[CB]
+Generate\ an\ application\ package\ suitable\ for\ the\ host\ system:
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+For\ a\ modular\ application:
+\ \ \ \ jpackage\ \-n\ name\ \-p\ modulePath\ \-m\ moduleName/className
+For\ a\ non\-modular\ application:
+\ \ \ \ jpackage\ \-i\ inputDir\ \-n\ name\ \\
+\ \ \ \ \ \ \ \ \-\-main\-class\ className\ \-\-main\-jar\ myJar.jar
+From\ a\ pre\-built\ application\ image:
+\ \ \ \ jpackage\ \-n\ name\ \-\-app\-image\ appImageDir
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+Generate\ an\ application\ image:
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+For\ a\ modular\ application:
+\ \ \ \ jpackage\ \-\-type\ app\-image\ \-n\ name\ \-p\ modulePath\ \\
+\ \ \ \ \ \ \ \ \-m\ moduleName/className
+For\ a\ non\-modular\ application:
+\ \ \ \ jpackage\ \-\-type\ app\-image\ \-i\ inputDir\ \-n\ name\ \\
+\ \ \ \ \ \ \ \ \-\-main\-class\ className\ \-\-main\-jar\ myJar.jar
+To\ provide\ your\ own\ options\ to\ jlink,\ run\ jlink\ separately:
+\ \ \ \ jlink\ \-\-output\ appRuntimeImage\ \-p\ modulePath\ \\
+\ \ \ \ \ \ \ \ \-\-add\-modules\ moduleName\ \\
+\ \ \ \ \ \ \ \ \-\-no\-header\-files\ [<additional\ jlink\ options>...]
+\ \ \ \ jpackage\ \-\-type\ app\-image\ \-n\ name\ \\
+\ \ \ \ \ \ \ \ \-m\ moduleName/className\ \-\-runtime\-image\ appRuntimeImage
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+Generate\ a\ Java\ runtime\ package:
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+jpackage\ \-n\ name\ \-\-runtime\-image\ <runtime\-image>
+\f[R]
+.fi
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jps.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jps.1
new file mode 100644
index 0000000..20a8ddd
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jps.1
@@ -0,0 +1,233 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JPS" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jps \- list the instrumented JVMs on the target system
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jps\f[R] [\f[CB]\-q\f[R]] [\f[CB]\-mlvV\f[R]] [\f[I]hostid\f[R]]
+.PP
+\f[CB]jps\f[R] [\f[CB]\-help\f[R]]
+.SH OPTIONS
+.TP
+.B \f[CB]\-q\f[R]
+Suppresses the output of the class name, JAR file name, and arguments
+passed to the \f[CB]main\f[R] method, producing a list of only local JVM
+identifiers.
+.RS
+.RE
+.TP
+.B \f[CB]\-mlvV\f[R]
+You can specify any combination of these options.
+.RS
+.IP \[bu] 2
+\f[CB]\-m\f[R] displays the arguments passed to the \f[CB]main\f[R] method.
+The output may be \f[CB]null\f[R] for embedded JVMs.
+.IP \[bu] 2
+\f[CB]\-l\f[R] displays the full package name for the application\[aq]s
+\f[CB]main\f[R] class or the full path name to the application\[aq]s JAR
+file.
+.IP \[bu] 2
+\f[CB]\-v\f[R] displays the arguments passed to the JVM.
+.IP \[bu] 2
+\f[CB]\-V\f[R] suppresses the output of the class name, JAR file name, and
+arguments passed to the \f[CB]main\f[R] method, producing a list of only
+local JVM identifiers.
+.RE
+.TP
+.B \f[I]hostid\f[R]
+The identifier of the host for which the process report should be
+generated.
+The \f[CB]hostid\f[R] can include optional components that indicate the
+communications protocol, port number, and other implementation specific
+data.
+See \f[B]Host Identifier\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-help\f[R]
+Displays the help message for the \f[CB]jps\f[R] command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jps\f[R] command lists the instrumented Java HotSpot VMs on the
+target system.
+The command is limited to reporting information on JVMs for which it has
+the access permissions.
+.PP
+If the \f[CB]jps\f[R] command is run without specifying a \f[CB]hostid\f[R],
+then it searches for instrumented JVMs on the local host.
+If started with a \f[CB]hostid\f[R], then it searches for JVMs on the
+indicated host, using the specified protocol and port.
+A \f[CB]jstatd\f[R] process is assumed to be running on the target host.
+.PP
+The \f[CB]jps\f[R] command reports the local JVM identifier, or
+\f[CB]lvmid\f[R], for each instrumented JVM found on the target system.
+The \f[CB]lvmid\f[R] is typically, but not necessarily, the operating
+system\[aq]s process identifier for the JVM process.
+With no options, the \f[CB]jps\f[R] command lists each Java
+application\[aq]s \f[CB]lvmid\f[R] followed by the short form of the
+application\[aq]s class name or jar file name.
+The short form of the class name or JAR file name omits the class\[aq]s
+package information or the JAR files path information.
+.PP
+The \f[CB]jps\f[R] command uses the Java launcher to find the class name
+and arguments passed to the main method.
+If the target JVM is started with a custom launcher, then the class or
+JAR file name, and the arguments to the \f[CB]main\f[R] method aren\[aq]t
+available.
+In this case, the \f[CB]jps\f[R] command outputs the string
+\f[CB]Unknown\f[R] for the class name, or JAR file name, and for the
+arguments to the \f[CB]main\f[R] method.
+.PP
+The list of JVMs produced by the \f[CB]jps\f[R] command can be limited by
+the permissions granted to the principal running the command.
+The command lists only the JVMs for which the principal has access
+rights as determined by operating system\-specific access control
+mechanisms.
+.SH HOST IDENTIFIER
+.PP
+The host identifier, or \f[CB]hostid\f[R], is a string that indicates the
+target system.
+The syntax of the \f[CB]hostid\f[R] string corresponds to the syntax of a
+URI:
+.RS
+.PP
+[\f[I]protocol\f[R]\f[CB]:\f[R]][[\f[CB]//\f[R]]\f[I]hostname\f[R]][\f[CB]:\f[R]\f[I]port\f[R]][\f[CB]/\f[R]\f[I]servername\f[R]]
+.RE
+.TP
+.B \f[I]protocol\f[R]
+The communications protocol.
+If the \f[I]protocol\f[R] is omitted and a \f[I]hostname\f[R] isn\[aq]t
+specified, then the default protocol is a platform\-specific, optimized,
+local protocol.
+If the protocol is omitted and a host name is specified, then the
+default protocol is \f[CB]rmi\f[R].
+.RS
+.RE
+.TP
+.B \f[I]hostname\f[R]
+A host name or IP address that indicates the target host.
+If you omit the \f[I]hostname\f[R] parameter, then the target host is the
+local host.
+.RS
+.RE
+.TP
+.B \f[I]port\f[R]
+The default port for communicating with the remote server.
+If the \f[I]hostname\f[R] parameter is omitted or the \f[I]protocol\f[R]
+parameter specifies an optimized, local protocol, then the \f[I]port\f[R]
+parameter is ignored.
+Otherwise, treatment of the \f[I]port\f[R] parameter is
+implementation\-specific.
+For the default \f[CB]rmi\f[R] protocol, the \f[I]port\f[R] parameter
+indicates the port number for the \f[CB]rmiregistry\f[R] on the remote
+host.
+If the \f[I]port\f[R] parameter is omitted, and the \f[I]protocol\f[R]
+parameter indicates \f[CB]rmi\f[R], then the default \f[CB]rmiregistry\f[R]
+port (\f[CB]1099\f[R]) is used.
+.RS
+.RE
+.TP
+.B \f[I]servername\f[R]
+The treatment of this parameter depends on the implementation.
+For the optimized, local protocol, this field is ignored.
+For the \f[CB]rmi\f[R] protocol, this parameter is a string that
+represents the name of the RMI remote object on the remote host.
+See the \f[B]jstatd\f[R] command \f[CB]\-n\f[R] option.
+.RS
+.RE
+.SH OUTPUT FORMAT OF THE JPS COMMAND
+.PP
+The output of the \f[CB]jps\f[R] command has the following pattern:
+.RS
+.PP
+\f[I]lvmid\f[R] [ [ \f[I]classname\f[R] | \f[I]JARfilename\f[R] |
+\f[CB]"Unknown"\f[R]] [ \f[I]arg\f[R]* ] [ \f[I]jvmarg\f[R]* ] ]
+.RE
+.PP
+All output tokens are separated by white space.
+An \f[CB]arg\f[R] value that includes embedded white space introduces
+ambiguity when attempting to map arguments to their actual positional
+parameters.
+.PP
+\f[B]Note:\f[R]
+.PP
+It\[aq]s recommended that you don\[aq]t write scripts to parse
+\f[CB]jps\f[R] output because the format might change in future releases.
+If you write scripts that parse \f[CB]jps\f[R] output, then expect to
+modify them for future releases of this tool.
+.SH EXAMPLES
+.PP
+This section provides examples of the \f[CB]jps\f[R] command.
+.PP
+List the instrumented JVMs on the local host:
+.IP
+.nf
+\f[CB]
+jps
+18027\ Java2Demo.JAR
+18032\ jps
+18005\ jstat
+\f[R]
+.fi
+.PP
+The following example lists the instrumented JVMs on a remote host.
+This example assumes that the \f[CB]jstat\f[R] server and either the its
+internal RMI registry or a separate external \f[CB]rmiregistry\f[R]
+process are running on the remote host on the default port (port
+\f[CB]1099\f[R]).
+It also assumes that the local host has appropriate permissions to
+access the remote host.
+This example includes the \f[CB]\-l\f[R] option to output the long form of
+the class names or JAR file names.
+.IP
+.nf
+\f[CB]
+jps\ \-l\ remote.domain
+3002\ /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
+2857\ sun.tools.jstatd.jstatd
+\f[R]
+.fi
+.PP
+The following example lists the instrumented JVMs on a remote host with
+a nondefault port for the RMI registry.
+This example assumes that the \f[CB]jstatd\f[R] server, with an internal
+RMI registry bound to port \f[CB]2002\f[R], is running on the remote host.
+This example also uses the \f[CB]\-m\f[R] option to include the arguments
+passed to the \f[CB]main\f[R] method of each of the listed Java
+applications.
+.IP
+.nf
+\f[CB]
+jps\ \-m\ remote.domain:2002
+3002\ /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
+3102\ sun.tools.jstatd.jstatd\ \-p\ 2002
+\f[R]
+.fi
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jrunscript.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jrunscript.1
new file mode 100644
index 0000000..a9745d2
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jrunscript.1
@@ -0,0 +1,175 @@
+.\" Copyright (c) 2006, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JRUNSCRIPT" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jrunscript \- run a command\-line script shell that supports interactive
+and batch modes
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R]
+.PP
+This tool is \f[B]experimental\f[R] and unsupported.
+.PP
+\f[CB]jrunscript\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jrunscript\f[R] command\-line options that can
+be used.
+See \f[B]Options for the jrunscript Command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]arguments\f[R]
+Arguments, when used, follow immediately after options or the command
+name.
+See \f[B]Arguments\f[R].
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jrunscript\f[R] command is a language\-independent command\-line
+script shell.
+The \f[CB]jrunscript\f[R] command supports both an interactive
+(read\-eval\-print) mode and a batch (\f[CB]\-f\f[R] option) mode of
+script execution.
+By default, JavaScript is the language used, but the \f[CB]\-l\f[R] option
+can be used to specify a different language.
+By using Java to scripting language communication, the
+\f[CB]jrunscript\f[R] command supports an exploratory programming style.
+.PP
+If JavaScript is used, then before it evaluates a user defined script,
+the \f[CB]jrunscript\f[R] command initializes certain built\-in functions
+and objects, which are documented in the API Specification for
+\f[CB]jrunscript\f[R] JavaScript built\-in functions.
+.SH OPTIONS FOR THE JRUNSCRIPT COMMAND
+.TP
+.B \f[CB]\-cp\f[R] \f[I]path\f[R] or \f[CB]\-classpath\f[R] \f[I]path\f[R]
+Indicates where any class files are that the script needs to access.
+.RS
+.RE
+.TP
+.B \f[CB]\-D\f[R]\f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Sets a Java system property.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]flag\f[R]
+Passes \f[I]flag\f[R] directly to the Java Virtual Machine where the
+\f[CB]jrunscript\f[R] command is running.
+.RS
+.RE
+.TP
+.B \f[CB]\-l\f[R] \f[I]language\f[R]
+Uses the specified scripting language.
+By default, JavaScript is used.
+To use other scripting languages, you must specify the corresponding
+script engine\[aq]s JAR file with the \f[CB]\-cp\f[R] or
+\f[CB]\-classpath\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-e\f[R] \f[I]script\f[R]
+Evaluates the specified script.
+This option can be used to run one\-line scripts that are specified
+completely on the command line.
+.RS
+.RE
+.TP
+.B \f[CB]\-encoding\f[R] \f[I]encoding\f[R]
+Specifies the character encoding used to read script files.
+.RS
+.RE
+.TP
+.B \f[CB]\-f\f[R] \f[I]script\-file\f[R]
+Evaluates the specified script file (batch mode).
+.RS
+.RE
+.TP
+.B \f[CB]\-f\ \-\f[R]
+Enters interactive mode to read and evaluate a script from standard
+input.
+.RS
+.RE
+.TP
+.B \f[CB]\-help\f[R] or \f[CB]\-?\f[R]
+Displays a help message and exits.
+.RS
+.RE
+.TP
+.B \f[CB]\-q\f[R]
+Lists all script engines available and exits.
+.RS
+.RE
+.SH ARGUMENTS
+.PP
+If arguments are present and if no \f[CB]\-e\f[R] or \f[CB]\-f\f[R] option
+is used, then the first argument is the script file and the rest of the
+arguments, if any, are passed as script arguments.
+If arguments and the \f[CB]\-e\f[R] or the \f[CB]\-f\f[R] option are used,
+then all arguments are passed as script arguments.
+If arguments \f[CB]\-e\f[R] and \f[CB]\-f\f[R] are missing, then the
+interactive mode is used.
+.SH EXAMPLE OF EXECUTING INLINE SCRIPTS
+.RS
+.PP
+\f[CB]jrunscript\ \-e\ "print(\[aq]hello\ world\[aq])"\f[R]
+.RE
+.RS
+.PP
+\f[CB]jrunscript\ \-e\ "cat(\[aq]http://www.example.com\[aq])"\f[R]
+.RE
+.SH EXAMPLE OF USING SPECIFIED LANGUAGE AND EVALUATE THE SCRIPT FILE
+.RS
+.PP
+\f[CB]jrunscript\ \-l\ js\ \-f\ test.js\f[R]
+.RE
+.SH EXAMPLE OF INTERACTIVE MODE
+.IP
+.nf
+\f[CB]
+jrunscript
+js>\ print(\[aq]Hello\ World\\n\[aq]);
+Hello\ World
+js>\ 34\ +\ 55
+89.0
+js>\ t\ =\ new\ java.lang.Thread(function()\ {\ print(\[aq]Hello\ World\\n\[aq]);\ })
+Thread[Thread\-0,5,main]
+js>\ t.start()
+js>\ Hello\ World
+
+js>
+\f[R]
+.fi
+.SH RUN SCRIPT FILE WITH SCRIPT ARGUMENTS
+.PP
+In this example, the \f[CB]test.js\f[R] file is the script file.
+The \f[CB]arg1\f[R], \f[CB]arg2\f[R], and \f[CB]arg3\f[R] arguments are passed
+to the script.
+The script can access these arguments with an arguments array.
+.RS
+.PP
+\f[CB]jrunscript\ test.js\ arg1\ arg2\ arg3\f[R]
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jshell.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jshell.1
new file mode 100644
index 0000000..53bd760
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jshell.1
@@ -0,0 +1,1449 @@
+.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"t
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JSHELL" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jshell \- interactively evaluate declarations, statements, and
+expressions of the Java programming language in a read\-eval\-print loop
+(REPL)
+.SH SYNOPSIS
+.PP
+\f[CB]jshell\f[R] [\f[I]options\f[R]] [\f[I]load\-files\f[R]]
+.TP
+.B \f[I]options\f[R]
+Command\-line options, separated by spaces.
+See \f[B]Options for jshell\f[R].
+.RS
+.RE
+.TP
+.B \f[I]load\-files\f[R]
+One or more scripts to run when the tool is started.
+Scripts can contain any valid code snippets or JShell commands.
+.RS
+.PP
+The script can be a local file or one of following predefined scripts:
+.TP
+.B \f[CB]DEFAULT\f[R]
+Loads the default entries, which are commonly used as imports.
+.RS
+.RE
+.TP
+.B \f[CB]JAVASE\f[R]
+Imports all Java SE packages.
+.RS
+.RE
+.TP
+.B \f[CB]PRINTING\f[R]
+Defines \f[CB]print\f[R], \f[CB]println\f[R], and \f[CB]printf\f[R] as
+\f[CB]jshell\f[R] methods for use within the tool.
+.RS
+.RE
+.PP
+For more than one script, use a space to separate the names.
+Scripts are run in the order in which they\[aq]re entered on the command
+line.
+Command\-line scripts are run after startup scripts.
+To run a script after JShell is started, use the \f[CB]/open\f[R] command.
+.PP
+To accept input from standard input and suppress the interactive I/O,
+enter a hyphen (\-) for \f[I]load\-files\f[R].
+This option enables the use of the \f[CB]jshell\f[R] tool in pipe chains.
+.RE
+.SH DESCRIPTION
+.PP
+JShell provides a way to interactively evaluate declarations,
+statements, and expressions of the Java programming language, making it
+easier to learn the language, explore unfamiliar code and APIs, and
+prototype complex code.
+Java statements, variable definitions, method definitions, class
+definitions, import statements, and expressions are accepted.
+The bits of code entered are called snippets.
+.PP
+As snippets are entered, they\[aq]re evaluated, and feedback is
+provided.
+Feedback varies from the results and explanations of actions to nothing,
+depending on the snippet entered and the feedback mode chosen.
+Errors are described regardless of the feedback mode.
+Start with the verbose mode to get the most feedback while learning the
+tool.
+.PP
+Command\-line options are available for configuring the initial
+environment when JShell is started.
+Within JShell, commands are available for modifying the environment as
+needed.
+.PP
+Existing snippets can be loaded from a file to initialize a JShell
+session, or at any time within a session.
+Snippets can be modified within the session to try out different
+variations and make corrections.
+To keep snippets for later use, save them to a file.
+.SH OPTIONS FOR JSHELL
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]module\f[R]/\f[I]package\f[R]
+Specifies a package to be considered as exported from its defining
+module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+.RS
+.RE
+.TP
+.B \f[CB]\-C\f[R]\f[I]flag\f[R]
+Provides a flag to pass to the compiler.
+To pass more than one flag, provide an instance of this option for each
+flag or flag argument needed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the directories and archives that are searched to locate class
+files.
+This option overrides the path in the \f[CB]CLASSPATH\f[R] environment
+variable.
+If the environment variable isn\[aq]t set and this option isn\[aq]t
+used, then the current directory is searched.
+For Linux and macOS, use a colon (:) to separate items in the path.
+For Windows, use a semicolon (;) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-enable\-preview\f[R]
+Allows code to depend on the preview features of this release.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-execution\f[R] \f[I]specification\f[R]
+Specifies an alternate execution engine, where \f[I]specification\f[R] is
+an ExecutionControl spec.
+See the documentation of the package jdk.jshell.spi for the syntax of
+the spec.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-feedback\f[R] \f[I]mode\f[R]
+Sets the initial level of feedback provided in response to what\[aq]s
+entered.
+The initial level can be overridden within a session by using the
+\f[CB]/set\ feedback\f[R] \f[I]mode\f[R] command.
+The default is \f[CB]normal\f[R].
+.RS
+.PP
+The following values are valid for \f[I]mode\f[R]:
+.TP
+.B \f[CB]verbose\f[R]
+Provides detailed feedback for entries.
+Additional information about the action performed is displayed after the
+result of the action.
+The next prompt is separated from the feedback by a blank line.
+.RS
+.RE
+.TP
+.B \f[CB]normal\f[R]
+Provides an average amount of feedback.
+The next prompt is separated from the feedback by a blank line.
+.RS
+.RE
+.TP
+.B \f[CB]concise\f[R]
+Provides minimal feedback.
+The next prompt immediately follows the code snippet or feedback.
+.RS
+.RE
+.TP
+.B \f[CB]silent\f[R]
+Provides no feedback.
+The next prompt immediately follows the code snippet.
+.RS
+.RE
+.TP
+.B \f[I]custom\f[R]
+Provides custom feedback based on how the mode is defined.
+Custom feedback modes are created within JShell by using the
+\f[CB]/set\ mode\f[R] command.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R] or \f[CB]\-?\f[R]
+Prints a summary of standard options and exits the tool.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R] or \f[CB]\-X\f[R]
+Prints a summary of nonstandard options and exits the tool.
+Nonstandard options are subject to change without notice.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]flag\f[R]
+Provides a flag to pass to the runtime system.
+To pass more than one flag, provide an instance of this option for each
+flag or flag argument needed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies where to find application modules.
+For Linux and macOS, use a colon (:) to separate items in the path.
+For Windows, use a semicolon (;) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-no\-startup\f[R]
+Prevents startup scripts from running when JShell starts.
+Use this option to run only the scripts entered on the command line when
+JShell is started, or to start JShell without any preloaded information
+if no scripts are entered.
+This option can\[aq]t be used if the \f[CB]\-\-startup\f[R] option is
+used.
+.RS
+.RE
+.TP
+.B \f[CB]\-q\f[R]
+Sets the feedback mode to \f[CB]concise\f[R], which is the same as
+entering \f[CB]\-\-feedback\ concise\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-R\f[R]\f[I]flag\f[R]
+Provides a flag to pass to the remote runtime system.
+To pass more than one flag, provide an instance of this option for each
+flag or flag argument to pass.
+.RS
+.RE
+.TP
+.B \f[CB]\-s\f[R]
+Sets the feedback mode to \f[CB]silent\f[R], which is the same as entering
+\f[CB]\-\-feedback\ silent\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-version\f[R]
+Prints version information and enters the tool.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-startup\f[R] \f[I]file\f[R]
+Overrides the default startup script for this session.
+The script can contain any valid code snippets or commands.
+.RS
+.PP
+The script can be a local file or one of the following predefined
+scripts:
+.TP
+.B \f[CB]DEFAULT\f[R]
+Loads the default entries, which are commonly used as imports.
+.RS
+.RE
+.TP
+.B \f[CB]JAVASE\f[R]
+Imports all Java SE packages.
+.RS
+.RE
+.TP
+.B \f[CB]PRINTING\f[R]
+Defines \f[CB]print\f[R], \f[CB]println\f[R], and \f[CB]printf\f[R] as
+\f[CB]jshell\f[R] methods for use within the tool.
+.RS
+.RE
+.PP
+For more than one script, provide a separate instance of this option for
+each script.
+Startup scripts are run when JShell is first started and when the
+session is restarted with the \f[CB]/reset\f[R], \f[CB]/reload\f[R], or
+\f[CB]/env\f[R] command.
+Startup scripts are run in the order in which they\[aq]re entered on the
+command line.
+.PP
+This option can\[aq]t be used if the \f[CB]\-\-no\-startup\f[R] option is
+used.
+.RE
+.TP
+.B \f[CB]\-v\f[R]
+Sets the feedback mode to \f[CB]verbose\f[R], which is the same as
+entering \f[CB]\-\-feedback\ verbose\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints version information and exits the tool.
+.RS
+.RE
+.SH JSHELL COMMANDS
+.PP
+Within the \f[CB]jshell\f[R] tool, commands are used to modify the
+environment and manage code snippets.
+.TP
+.B \f[CB]/drop\f[R] {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Drops snippets identified by name, ID, or ID range, making them
+inactive.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]/edit\f[R] [\f[I]option\f[R]]
+Opens an editor.
+If no option is entered, then the editor opens with the active snippets.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Opens the editor with the snippets identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Opens the editor with all snippets, including startup snippets and
+snippets that failed, were overwritten, or were dropped.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Opens the editor with startup snippets that were evaluated when JShell
+was started.
+.RS
+.RE
+.PP
+To exit edit mode, close the editor window, or respond to the prompt
+provided if the \f[CB]\-wait\f[R] option was used when the editor was set.
+.PP
+Use the \f[CB]/set\ editor\f[R] command to specify the editor to use.
+If no editor is set, then the following environment variables are
+checked in order: \f[CB]JSHELLEDITOR\f[R], \f[CB]VISUAL\f[R], and
+\f[CB]EDITOR\f[R].
+If no editor is set in JShell and none of the editor environment
+variables is set, then a simple default editor is used.
+.RE
+.TP
+.B \f[CB]/env\f[R] [\f[I]options\f[R]]
+Displays the environment settings, or updates the environment settings
+and restarts the session.
+If no option is entered, then the current environment settings are
+displayed.
+If one or more options are entered, then the session is restarted as
+follows:
+.RS
+.IP \[bu] 2
+Updates the environment settings with the provided options.
+.IP \[bu] 2
+Resets the execution state.
+.IP \[bu] 2
+Runs the startup scripts.
+.IP \[bu] 2
+Silently replays the history in the order entered.
+The history includes all valid snippets or \f[CB]/drop\f[R] commands
+entered at the \f[CB]jshell\f[R] prompt, in scripts entered on the command
+line, or scripts entered with the \f[CB]/open\f[R] command.
+.PP
+Environment settings entered on the command line or provided with a
+previous \f[CB]/reset\f[R], \f[CB]/env\f[R], or \f[CB]/reload\f[R] command are
+maintained unless an \f[I]option\f[R] is entered that overwrites the
+setting.
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]source\-module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R][\f[CB],\f[R]\f[I]target\-module\f[R]]*
+Adds an export of \f[I]package\f[R] from \f[I]source\-module\f[R] to
+\f[I]target\-module\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the directories and archives that are searched to locate class
+files.
+This option overrides the path in the \f[CB]CLASSPATH\f[R] environment
+variable.
+If the environment variable isn\[aq]t set and this option isn\[aq]t
+used, then the current directory is searched.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies where to find application modules.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/exit\f[R] [\f[I]integer\-expression\-snippet\f[R]]
+Exits the tool.
+If no snippet is entered, the exit status is zero.
+If a snippet is entered and the result of the snippet is an integer, the
+result is used as the exit status.
+If an error occurs, or the result of the snippet is not an integer, an
+error is displayed and the tool remains active.
+.RS
+.RE
+.TP
+.B \f[CB]/history\f[R]
+Displays what was entered in this session.
+.RS
+.RE
+.TP
+.B \f[CB]/help\f[R] [\f[I]command\f[R]|\f[I]subject\f[R]]
+Displays information about commands and subjects.
+If no options are entered, then a summary of information for all
+commands and a list of available subjects are displayed.
+If a valid command is provided, then expanded information for that
+command is displayed.
+If a valid subject is entered, then information about that subject is
+displayed.
+.RS
+.PP
+The following values for \f[I]subject\f[R] are valid:
+.TP
+.B \f[CB]context\f[R]
+Describes the options that are available for configuring the
+environment.
+.RS
+.RE
+.TP
+.B \f[CB]intro\f[R]
+Provides an introduction to the tool.
+.RS
+.RE
+.TP
+.B \f[CB]shortcuts\f[R]
+Describes keystrokes for completing commands and snippets.
+See \f[B]Input Shortcuts\f[R].
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/imports\f[R]
+Displays the current active imports, including those from the startup
+scripts and scripts that were entered on the command line when JShell
+was started.
+.RS
+.RE
+.TP
+.B \f[CB]/list\f[R] [\f[I]option\f[R]]
+Displays a list of snippets and their IDs.
+If no option is entered, then all active snippets are displayed, but
+startup snippets aren\[aq]t.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Displays the snippets identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Displays all snippets, including startup snippets and snippets that
+failed, were overwritten, or were dropped.
+IDs that begin with \f[CB]s\f[R] are startup snippets.
+IDs that begin with \f[CB]e\f[R] are snippets that failed.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Displays startup snippets that were evaluated when JShell was started.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/methods\f[R] [\f[I]option\f[R]]
+Displays information about the methods that were entered.
+If no option is entered, then the name, parameter types, and return type
+of all active methods are displayed.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Displays information for methods identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Displays information for all methods, including those added when JShell
+was started, and methods that failed, were overwritten, or were dropped.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Displays information for startup methods that were added when JShell was
+started.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/open\f[R] \f[I]file\f[R]
+Opens the script specified and reads the snippets into the tool.
+The script can be a local file or one of the following predefined
+scripts:
+.RS
+.TP
+.B \f[CB]DEFAULT\f[R]
+Loads the default entries, which are commonly used as imports.
+.RS
+.RE
+.TP
+.B \f[CB]JAVASE\f[R]
+Imports all Java SE packages.
+.RS
+.RE
+.TP
+.B \f[CB]PRINTING\f[R]
+Defines \f[CB]print\f[R], \f[CB]println\f[R], and \f[CB]printf\f[R] as
+\f[CB]jshell\f[R] methods for use within the tool.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/reload\f[R] [\f[I]options\f[R]]
+Restarts the session as follows:
+.RS
+.IP \[bu] 2
+Updates the environment settings with the provided options, if any.
+.IP \[bu] 2
+Resets the execution state.
+.IP \[bu] 2
+Runs the startup scripts.
+.IP \[bu] 2
+Replays the history in the order entered.
+The history includes all valid snippets or \f[CB]/drop\f[R] commands
+entered at the \f[CB]jshell\f[R] prompt, in scripts entered on the command
+line, or scripts entered with the \f[CB]/open\f[R] command.
+.PP
+Environment settings entered on the command line or provided with a
+previous \f[CB]/reset\f[R], \f[CB]/env\f[R], or \f[CB]/reload\f[R] command are
+maintained unless an \f[I]option\f[R] is entered that overwrites the
+setting.
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]source\-module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R][\f[CB],\f[R]\f[I]target\-module\f[R]]*
+Adds an export of \f[I]package\f[R] from \f[I]source\-module\f[R] to
+\f[I]target\-module\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the directories and archives that are searched to locate class
+files.
+This option overrides the path in the \f[CB]CLASSPATH\f[R] environment
+variable.
+If the environment variable isn\[aq]t set and this option isn\[aq]t
+used, then the current directory is searched.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies where to find application modules.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-quiet\f[R]
+Replays the valid history without displaying it.
+Errors are displayed.
+.RS
+.RE
+.TP
+.B \f[CB]\-restore\f[R]
+Resets the environment to the state at the start of the previous run of
+the tool or to the last time a \f[CB]/reset\f[R], \f[CB]/reload\f[R], or
+\f[CB]/env\f[R] command was executed in the previous run.
+The valid history since that point is replayed.
+Use this option to restore a previous JShell session.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/reset\f[R] [\f[I]options\f[R]]
+Discards all entered snippets and restarts the session as follows:
+.RS
+.IP \[bu] 2
+Updates the environment settings with the provided options, if any.
+.IP \[bu] 2
+Resets the execution state.
+.IP \[bu] 2
+Runs the startup scripts.
+.PP
+History is not replayed.
+All code that was entered is lost.
+.PP
+Environment settings entered on the command line or provided with a
+previous \f[CB]/reset\f[R], \f[CB]/env\f[R], or \f[CB]/reload\f[R] command are
+maintained unless an \f[I]option\f[R] is entered that overwrites the
+setting.
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]source\-module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R][\f[CB],\f[R]\f[I]target\-module\f[R]]*
+Adds an export of \f[I]package\f[R] from \f[I]source\-module\f[R] to
+\f[I]target\-module\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the directories and archives that are searched to locate class
+files.
+This option overrides the path in the \f[CB]CLASSPATH\f[R] environment
+variable.
+If the environment variable isn\[aq]t set and this option isn\[aq]t
+used, then the current directory is searched.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies where to find application modules.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/save\f[R] [\f[I]options\f[R]] \f[I]file\f[R]
+Saves snippets and commands to the file specified.
+If no options are entered, then active snippets are saved.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Saves the snippets and commands identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of the code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Saves all snippets, including startup snippets and snippets that were
+overwritten or failed.
+.RS
+.RE
+.TP
+.B \f[CB]\-history\f[R]
+Saves the sequential history of all commands and snippets entered in the
+current session.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Saves the current startup settings.
+If no startup scripts were provided, then an empty file is saved.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/set\f[R] [\f[I]setting\f[R]]
+Sets configuration information, including the external editor, startup
+settings, and feedback mode.
+This command is also used to create a custom feedback mode with
+customized prompt, format, and truncation values.
+If no setting is entered, then the current setting for the editor,
+startup settings, and feedback mode are displayed.
+.RS
+.PP
+The following values are valid for \f[CB]setting\f[R]:
+.TP
+.B \f[CB]editor\f[R] [\f[I]options\f[R]] [\f[I]command\f[R]]
+Sets the command used to start an external editor when the
+\f[CB]/edit\f[R] command is entered.
+The command can include command arguments separated by spaces.
+If no command or options are entered, then the current setting is
+displayed.
+.RS
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-default\f[R]
+Sets the editor to the default editor provided with JShell.
+This option can\[aq]t be used if a command for starting an editor is
+entered.
+.RS
+.RE
+.TP
+.B \f[CB]\-delete\f[R]
+Sets the editor to the one in effect when the session started.
+If used with the \f[CB]\-retain\f[R] option, then the retained editor
+setting is deleted and the editor is set to the first of the following
+environment variables found: \f[CB]JSHELLEDITOR\f[R], \f[CB]VISUAL\f[R], or
+\f[CB]EDITOR\f[R].
+If none of the editor environment variables are set, then this option
+sets the editor to the default editor.
+.RS
+.PP
+This option can\[aq]t be used if a command for starting an editor is
+entered.
+.RE
+.TP
+.B \f[CB]\-retain\f[R]
+Saves the editor setting across sessions.
+If no other option or a command is entered, then the current setting is
+saved.
+.RS
+.RE
+.TP
+.B \f[CB]\-wait\f[R]
+Prompts the user to indicate when editing is complete.
+Otherwise control returns to JShell when the editor exits.
+Use this option if the editor being used exits immediately, for example,
+when an edit window already exists.
+This option is valid only when a command for starting an editor is
+entered.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]feedback\f[R] [\f[I]mode\f[R]]
+Sets the feedback mode used to respond to input.
+If no mode is entered, then the current mode is displayed.
+.RS
+.PP
+The following modes are valid: \f[CB]concise\f[R], \f[CB]normal\f[R],
+\f[CB]silent\f[R], \f[CB]verbose\f[R], and any custom mode created with the
+\f[CB]/set\ mode\f[R] command.
+.RE
+.TP
+.B \f[CB]format\f[R] \f[I]mode\f[R] \f[I]field\f[R] \f[CB]"\f[R]\f[I]format\-string\f[R]\f[CB]"\f[R] \f[I]selector\f[R]
+Sets the format of the feedback provided in response to input.
+If no mode is entered, then the current formats for all fields for all
+feedback modes are displayed.
+If only a mode is entered, then the current formats for that mode are
+displayed.
+If only a mode and field are entered, then the current formats for that
+field are displayed.
+.RS
+.PP
+To define a format, the following arguments are required:
+.TP
+.B \f[I]mode\f[R]
+Specifies a feedback mode to which the response format is applied.
+Only custom modes created with the \f[CB]/set\ mode\f[R] command can be
+modified.
+.RS
+.RE
+.TP
+.B \f[I]field\f[R]
+Specifies a context\-specific field to which the response format is
+applied.
+The fields are described in the online help, which is accessed from
+JShell using the \f[CB]/help\ /set\ format\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]"\f[R]\f[I]format\-string\f[R]\f[CB]"\f[R]
+Specifies the string to use as the response format for the specified
+field and selector.
+The structure of the format string is described in the online help,
+which is accessed from JShell using the \f[CB]/help\ /set\ format\f[R]
+command.
+.RS
+.RE
+.TP
+.B \f[I]selector\f[R]
+Specifies the context in which the response format is applied.
+The selectors are described in the online help, which is accessed from
+JShell using the \f[CB]/help\ /set\ format\f[R] command.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]mode\f[R] [\f[I]mode\-name\f[R]] [\f[I]existing\-mode\f[R]] [\f[I]options\f[R]]
+Creates a custom feedback mode with the mode name provided.
+If no mode name is entered, then the settings for all modes are
+displayed, which includes the mode, prompt, format, and truncation
+settings.
+If the name of an existing mode is provided, then the settings from the
+existing mode are copied to the mode being created.
+.RS
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-command\f[R]|\f[CB]\-quiet\f[R]
+Specifies the level of feedback displayed for commands when using the
+mode.
+This option is required when creating a feedback mode.
+Use \f[CB]\-command\f[R] to show information and verification feedback for
+commands.
+Use \f[CB]\-quiet\f[R] to show only essential feedback for commands, such
+as error messages.
+.RS
+.RE
+.TP
+.B \f[CB]\-delete\f[R]
+Deletes the named feedback mode for this session.
+The name of the mode to delete is required.
+To permanently delete a retained mode, use the \f[CB]\-retain\f[R] option
+with this option.
+Predefined modes can\[aq]t be deleted.
+.RS
+.RE
+.TP
+.B \f[CB]\-retain\f[R]
+Saves the named feedback mode across sessions.
+The name of the mode to retain is required.
+.RS
+.RE
+.PP
+Configure the new feedback mode using the \f[CB]/set\ prompt\f[R],
+\f[CB]/set\ format\f[R], and \f[CB]/set\ truncation\f[R] commands.
+.PP
+To start using the new mode, use the \f[CB]/set\ feedback\f[R] command.
+.RE
+.TP
+.B \f[CB]prompt\f[R] \f[I]mode\f[R] \f[CB]"\f[R]\f[I]prompt\-string\f[R]\f[CB]"\f[R] \f[CB]"\f[R]\f[I]continuation\-prompt\-string\f[R]\f[CB]"\f[R]
+Sets the prompts for input within JShell.
+If no mode is entered, then the current prompts for all feedback modes
+are displayed.
+If only a mode is entered, then the current prompts for that mode are
+displayed.
+.RS
+.PP
+To define a prompt, the following arguments are required:
+.TP
+.B \f[I]mode\f[R]
+Specifies the feedback mode to which the prompts are applied.
+Only custom modes created with the \f[CB]/set\ mode\f[R] command can be
+modified.
+.RS
+.RE
+.TP
+.B \f[CB]"\f[R]\f[I]prompt\-string\f[R]\f[CB]"\f[R]
+Specifies the string to use as the prompt for the first line of input.
+.RS
+.RE
+.TP
+.B \f[CB]"\f[R]\f[I]continuation\-prompt\-string\f[R]\f[CB]"\f[R]
+Specifies the string to use as the prompt for the additional input lines
+needed to complete a snippet.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]start\f[R] [\f[CB]\-retain\f[R]] [\f[I]file\f[R] [\f[I]file\f[R]...]|\f[I]option\f[R]]
+Sets the names of the startup scripts used when the next
+\f[CB]/reset\f[R], \f[CB]/reload\f[R], or \f[CB]/env\f[R] command is entered.
+If more than one script is entered, then the scripts are run in the
+order entered.
+If no scripts or options are entered, then the current startup settings
+are displayed.
+.RS
+.PP
+The scripts can be local files or one of the following predefined
+scripts:
+.TP
+.B \f[CB]DEFAULT\f[R]
+Loads the default entries, which are commonly used as imports.
+.RS
+.RE
+.TP
+.B \f[CB]JAVASE\f[R]
+Imports all Java SE packages.
+.RS
+.RE
+.TP
+.B \f[CB]PRINTING\f[R]
+Defines \f[CB]print\f[R], \f[CB]println\f[R], and \f[CB]printf\f[R] as
+\f[CB]jshell\f[R] methods for use within the tool.
+.RS
+.RE
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-default\f[R]
+Sets the startup settings to the default settings.
+.RS
+.RE
+.TP
+.B \f[CB]\-none\f[R]
+Specifies that no startup settings are used.
+.RS
+.RE
+.PP
+Use the \f[CB]\-retain\f[R] option to save the start setting across
+sessions.
+.RE
+.TP
+.B \f[CB]truncation\f[R] \f[I]mode\f[R] \f[I]length\f[R] \f[I]selector\f[R]
+Sets the maximum length of a displayed value.
+If no mode is entered, then the current truncation values for all
+feedback modes are displayed.
+If only a mode is entered, then the current truncation values for that
+mode are displayed.
+.RS
+.PP
+To define truncation values, the following arguments are required:
+.TP
+.B \f[I]mode\f[R]
+Specifies the feedback mode to which the truncation value is applied.
+Only custom modes created with the \f[CB]/set\ mode\f[R] command can be
+modified.
+.RS
+.RE
+.TP
+.B \f[I]length\f[R]
+Specifies the unsigned integer to use as the maximum length for the
+specified selector.
+.RS
+.RE
+.TP
+.B \f[I]selector\f[R]
+Specifies the context in which the truncation value is applied.
+The selectors are described in the online help, which is accessed from
+JShell using the \f[CB]/help\ /set\ truncation\f[R] command.
+.RS
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]/types\f[R] [\f[I]option\f[R]]
+Displays classes, interfaces, and enums that were entered.
+If no option is entered, then all current active classes, interfaces,
+and enums are displayed.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Displays information for classes, interfaces, and enums identified by
+name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of the code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Displays information for all classes, interfaces, and enums, including
+those added when JShell was started, and classes, interfaces, and enums
+that failed, were overwritten, or were dropped.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Displays information for startup classes, interfaces, and enums that
+were added when JShell was started.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/vars\f[R] [\f[I]option\f[R]]
+Displays the name, type, and value of variables that were entered.
+If no option is entered, then all current active variables are
+displayed.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Displays information for variables identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of the code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Displays information for all variables, including those added when
+JShell was started, and variables that failed, were overwritten, or were
+dropped.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Displays information for startup variables that were added when JShell
+was started.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/?\f[R]
+Same as the \f[CB]/help\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]/!\f[R]
+Reruns the last snippet.
+.RS
+.RE
+.TP
+.B \f[CB]/\f[R]{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Reruns the snippets identified by ID, range of IDs, or name.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+The first item in the list must be an ID or ID range.
+Use the \f[CB]/list\f[R] command to see the IDs of the code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]/\-\f[R]\f[I]n\f[R]
+Reruns the \-\f[I]n\f[R]th previous snippet.
+For example, if 15 code snippets were entered, then \f[CB]/\-4\f[R] runs
+the 11th snippet.
+Commands aren\[aq]t included in the count.
+.RS
+.RE
+.SH INPUT SHORTCUTS
+.PP
+The following shortcuts are available for entering commands and snippets
+in JShell.
+.SS Tab completion
+.TP
+.B \f[B]<tab>\f[R]
+When entering snippets, commands, subcommands, command arguments, or
+command options, use the Tab key to automatically complete the item.
+If the item can\[aq]t be determined from what was entered, then possible
+options are provided.
+.RS
+.PP
+When entering a method call, use the Tab key after the method call\[aq]s
+opening parenthesis to see the parameters for the method.
+If the method has more than one signature, then all signatures are
+displayed.
+Pressing the Tab key a second time displays the description of the
+method and the parameters for the first signature.
+Continue pressing the Tab key for a description of any additional
+signatures.
+.RE
+.TP
+.B \f[B]Shift+<Tab> V\f[R]
+After entering a complete expression, use this key sequence to convert
+the expression to a variable declaration of a type determined by the
+type of the expression.
+.RS
+.RE
+.TP
+.B \f[B]Shift+<Tab> M\f[R]
+After entering a complete expression or statement, use this key sequence
+to convert the expression or statement to a method declaration.
+If an expression is entered, the return type is based on the type of the
+expression.
+.RS
+.RE
+.TP
+.B \f[B]Shift+<Tab> I\f[R]
+When an identifier is entered that can\[aq]t be resolved, use this key
+sequence to show possible imports that resolve the identifier based on
+the content of the specified class path.
+.RS
+.RE
+.SS Command abbreviations
+.PP
+An abbreviation of a command is accepted if the abbreviation uniquely
+identifies a command.
+For example, \f[CB]/l\f[R] is recognized as the \f[CB]/list\f[R] command.
+However, \f[CB]/s\f[R] isn\[aq]t a valid abbreviation because it can\[aq]t
+be determined if the \f[CB]/set\f[R] or \f[CB]/save\f[R] command is meant.
+Use \f[CB]/se\f[R] for the \f[CB]/set\f[R] command or \f[CB]/sa\f[R] for the
+\f[CB]/save\f[R] command.
+.PP
+Abbreviations are also accepted for subcommands, command arguments, and
+command options.
+For example, use \f[CB]/m\ \-a\f[R] to display all methods.
+.SS History navigation
+.PP
+A history of what was entered is maintained across sessions.
+Use the up and down arrows to scroll through commands and snippets from
+the current and past sessions.
+Use the Ctrl key with the up and down arrows to skip all but the first
+line of multiline snippets.
+.SS History search
+.PP
+Use the Ctrl+R key combination to search the history for the string
+entered.
+The prompt changes to show the string and the match.
+Ctrl+R searches backwards from the current location in the history
+through earlier entries.
+Ctrl+S searches forward from the current location in the history though
+later entries.
+.SH INPUT EDITING
+.PP
+The editing capabilities of JShell are similar to that of other common
+shells.
+Keyboard keys and key combinations provide line editing shortcuts.
+The Ctrl key and Meta key are used in key combinations.
+If your keyboard doesn\[aq]t have a Meta key, then the Alt key is often
+mapped to provide Meta key functionality.
+.PP
+.TS
+tab(@);
+l l.
+T{
+Key or Key Combination
+T}@T{
+Action
+T}
+_
+T{
+Return
+T}@T{
+Enter the current line.
+T}
+T{
+Left arrow
+T}@T{
+Move the cursor to the left one character.
+T}
+T{
+Right arrow
+T}@T{
+Move the cursor to the right one character.
+T}
+T{
+Ctrl+A
+T}@T{
+Move the cursor to the beginning of the line.
+T}
+T{
+Ctrl+E
+T}@T{
+Move the cursor to the end of the line.
+T}
+T{
+Meta+B
+T}@T{
+Move the cursor to the left one word.
+T}
+T{
+Meta+F
+T}@T{
+Move the cursor to the right one word.
+T}
+T{
+Delete
+T}@T{
+Delete the character under the cursor.
+T}
+T{
+Backspace
+T}@T{
+Delete the character before the cursor.
+T}
+T{
+Ctrl+K
+T}@T{
+Delete the text from the cursor to the end of the line.
+T}
+T{
+Meta+D
+T}@T{
+Delete the text from the cursor to the end of the word.
+T}
+T{
+Ctrl+W
+T}@T{
+Delete the text from the cursor to the previous white space.
+T}
+T{
+Ctrl+Y
+T}@T{
+Paste the most recently deleted text into the line.
+T}
+T{
+Meta+Y
+T}@T{
+After Ctrl+Y, press to cycle through the previously deleted text.
+T}
+.TE
+.SH EXAMPLE OF STARTING AND STOPPING A JSHELL SESSION
+.PP
+JShell is provided with the JDK.
+To start a session, enter \f[CB]jshell\f[R] on the command line.
+A welcome message is printed, and a prompt for entering commands and
+snippets is provided.
+.IP
+.nf
+\f[CB]
+%\ jshell
+|\ \ Welcome\ to\ JShell\ \-\-\ Version\ 9
+|\ \ For\ an\ introduction\ type:\ /help\ intro
+
+jshell>
+\f[R]
+.fi
+.PP
+To see which snippets were automatically loaded when JShell started, use
+the \f[CB]/list\ \-start\f[R] command.
+The default startup snippets are import statements for common packages.
+The ID for each snippet begins with the letter \f[I]s\f[R], which
+indicates it\[aq]s a startup snippet.
+.IP
+.nf
+\f[CB]
+jshell>\ /list\ \-start
+
+\ \ s1\ :\ import\ java.io.*;
+\ \ s2\ :\ import\ java.math.*;
+\ \ s3\ :\ import\ java.net.*;
+\ \ s4\ :\ import\ java.nio.file.*;
+\ \ s5\ :\ import\ java.util.*;
+\ \ s6\ :\ import\ java.util.concurrent.*;
+\ \ s7\ :\ import\ java.util.function.*;
+\ \ s8\ :\ import\ java.util.prefs.*;
+\ \ s9\ :\ import\ java.util.regex.*;
+\ s10\ :\ import\ java.util.stream.*;
+
+jshell>
+\f[R]
+.fi
+.PP
+To end the session, use the \f[CB]/exit\f[R] command.
+.IP
+.nf
+\f[CB]
+jshell>\ /exit
+|\ \ Goodbye
+
+%
+\f[R]
+.fi
+.SH EXAMPLE OF ENTERING SNIPPETS
+.PP
+Snippets are Java statements, variable definitions, method definitions,
+class definitions, import statements, and expressions.
+Terminating semicolons are automatically added to the end of a completed
+snippet if they\[aq]re missing.
+.PP
+The following example shows two variables and a method being defined,
+and the method being run.
+Note that a scratch variable is automatically created to hold the result
+because no variable was provided.
+.IP
+.nf
+\f[CB]
+jshell>\ int\ a=4
+a\ ==>\ 4
+
+jshell>\ int\ b=8
+b\ ==>\ 8
+
+jshell>\ int\ square(int\ i1)\ {
+\ \ \ ...>\ return\ i1\ *\ i1;
+\ \ \ ...>\ }
+|\ \ created\ method\ square(int)
+
+jshell>\ square(b)
+$5\ ==>\ 64
+\f[R]
+.fi
+.SH EXAMPLE OF CHANGING SNIPPETS
+.PP
+Change the definition of a variable, method, or class by entering it
+again.
+.PP
+The following examples shows a method being defined and the method run:
+.IP
+.nf
+\f[CB]
+jshell>\ String\ grade(int\ testScore)\ {
+\ \ \ ...>\ \ \ \ \ if\ (testScore\ >=\ 90)\ {
+\ \ \ ...>\ \ \ \ \ \ \ \ \ return\ "Pass";
+\ \ \ ...>\ \ \ \ \ }
+\ \ \ ...>\ \ \ \ \ return\ "Fail";
+\ \ \ ...>\ }
+|\ \ created\ method\ grade(int)
+
+jshell>\ grade(88)
+$3\ ==>\ "Fail"
+\f[R]
+.fi
+.PP
+To change the method \f[CB]grade\f[R] to allow more students to pass,
+enter the method definition again and change the pass score to
+\f[CB]80\f[R].
+Use the up arrow key to retrieve the previous entries to avoid having to
+reenter them and make the change in the \f[CB]if\f[R] statement.
+The following example shows the new definition and reruns the method to
+show the new result:
+.IP
+.nf
+\f[CB]
+jshell>\ String\ grade(int\ testScore)\ {
+\ \ \ ...>\ \ \ \ \ if\ (testScore\ >=\ 80)\ {
+\ \ \ ...>\ \ \ \ \ \ \ \ \ return\ "Pass";
+\ \ \ ...>\ \ \ \ \ }
+\ \ \ ...>\ \ \ \ \ return\ "Fail";
+\ \ \ ...>\ }
+|\ \ modified\ method\ grade(int)
+
+jshell>\ grade(88)
+$5\ ==>\ "Pass"
+\f[R]
+.fi
+.PP
+For snippets that are more than a few lines long, or to make more than a
+few changes, use the \f[CB]/edit\f[R] command to open the snippet in an
+editor.
+After the changes are complete, close the edit window to return control
+to the JShell session.
+The following example shows the command and the feedback provided when
+the edit window is closed.
+The \f[CB]/list\f[R] command is used to show that the pass score was
+changed to \f[CB]85\f[R].
+.IP
+.nf
+\f[CB]
+jshell>\ /edit\ grade
+|\ \ modified\ method\ grade(int)
+jshell>\ /list\ grade
+
+\ \ \ 6\ :\ String\ grade(int\ testScore)\ {
+\ \ \ \ \ \ \ \ \ \ \ if\ (testScore\ >=\ 85)\ {
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ return\ "Pass";
+\ \ \ \ \ \ \ \ \ \ \ }
+\ \ \ \ \ \ \ \ \ \ \ return\ "Fail";
+\ \ \ \ \ \ \ }
+\f[R]
+.fi
+.SH EXAMPLE OF CREATING A CUSTOM FEEDBACK MODE
+.PP
+The feedback mode determines the prompt that\[aq]s displayed, the
+feedback messages that are provided as snippets are entered, and the
+maximum length of a displayed value.
+Predefined feedback modes are provided.
+Commands for creating custom feedback modes are also provided.
+.PP
+Use the \f[CB]/set\ mode\f[R] command to create a new feedback mode.
+In the following example, the new mode \f[CB]mymode\f[R], is based on the
+predefined feedback mode, \f[CB]normal\f[R], and verifying command
+feedback is displayed:
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ mode\ mymode\ normal\ \-command
+|\ \ Created\ new\ feedback\ mode:\ mymode
+\f[R]
+.fi
+.PP
+Because the new mode is based on the \f[CB]normal\f[R] mode, the prompts
+are the same.
+The following example shows how to see what prompts are used and then
+changes the prompts to custom strings.
+The first string represents the standard JShell prompt.
+The second string represents the prompt for additional lines in
+multiline snippets.
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ prompt\ mymode
+|\ \ /set\ prompt\ mymode\ "\\njshell>\ "\ "\ \ \ ...>\ "
+
+jshell>\ /set\ prompt\ mymode\ "\\nprompt$\ "\ "\ \ \ continue$\ "
+\f[R]
+.fi
+.PP
+The maximum length of a displayed value is controlled by the truncation
+setting.
+Different types of values can have different lengths.
+The following example sets an overall truncation value of 72, and a
+truncation value of 500 for variable value expressions:
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ truncation\ mymode\ 72
+
+jshell>\ /set\ truncation\ mymode\ 500\ varvalue
+\f[R]
+.fi
+.PP
+The feedback displayed after snippets are entered is controlled by the
+format setting and is based on the type of snippet entered and the
+action taken for that snippet.
+In the predefined mode \f[CB]normal\f[R], the string \f[CB]created\f[R] is
+displayed when a method is created.
+The following example shows how to change that string to
+\f[CB]defined\f[R]:
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ format\ mymode\ action\ "defined"\ added\-primary
+\f[R]
+.fi
+.PP
+Use the \f[CB]/set\ feedback\f[R] command to start using the feedback mode
+that was just created.
+The following example shows the custom mode in use:
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ feedback\ mymode
+|\ \ Feedback\ mode:\ mymode
+
+prompt$\ int\ square\ (int\ num1){
+\ \ \ continue$\ return\ num1*num1;
+\ \ \ continue$\ }
+|\ \ defined\ method\ square(int)
+
+prompt$
+\f[R]
+.fi
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jstack.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jstack.1
new file mode 100644
index 0000000..efbe089
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jstack.1
@@ -0,0 +1,83 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JSTACK" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jstack \- print Java stack traces of Java threads for a specified Java
+process
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jstack\f[R] [\f[I]options\f[R]] \f[I]pid\f[R]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jstack\f[R] command\-line options.
+See \f[B]Options for the jstack Command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]pid\f[R]
+The process ID for which the stack trace is printed.
+The process must be a Java process.
+To get a list of Java processes running on a machine, use either the
+\f[CB]ps\f[R] command or, if the JVM processes are not running in a
+separate docker instance, the \f[B]jps\f[R] command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jstack\f[R] command prints Java stack traces of Java threads for
+a specified Java process.
+For each Java frame, the full class name, method name, byte code index
+(BCI), and line number, when available, are printed.
+C++ mangled names aren\[aq]t demangled.
+To demangle C++ names, the output of this command can be piped to
+\f[CB]c++filt\f[R].
+When the specified process is running on a 64\-bit JVM, you might need
+to specify the \f[CB]\-J\-d64\f[R] option, for example:
+\f[CB]jstack\ \-J\-d64\f[R] \f[I]pid\f[R].
+.PP
+\f[B]Note:\f[R]
+.PP
+This command is unsupported and might not be available in future
+releases of the JDK.
+In Windows Systems where the \f[CB]dbgeng.dll\f[R] file isn\[aq]t present,
+the Debugging Tools for Windows must be installed so that these tools
+work.
+The \f[CB]PATH\f[R] environment variable needs to contain the location of
+the \f[CB]jvm.dll\f[R] that is used by the target process, or the location
+from which the core dump file was produced.
+.SH OPTIONS FOR THE JSTACK COMMAND
+.TP
+.B \f[CB]\-l\f[R]
+The long listing option prints additional information about locks.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] or \f[CB]\-help\f[R]
+Prints a help message.
+.RS
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jstat.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jstat.1
new file mode 100644
index 0000000..432a73d
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jstat.1
@@ -0,0 +1,702 @@
+.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JSTAT" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jstat \- monitor JVM statistics
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jstat\f[R] \f[I]generalOptions\f[R]
+.PP
+\f[CB]jstat\f[R] \f[I]outputOptions\f[R] [\f[CB]\-t\f[R]] [\f[CB]\-h\f[R]
+\f[I]lines\f[R]] \f[I]vmid\f[R] [\f[I]interval\f[R] [\f[I]count\f[R]]]
+.TP
+.B \f[I]generalOptions\f[R]
+A single general command\-line option.
+See \f[B]General Options\f[R].
+.RS
+.RE
+.TP
+.B \f[I]outputOptions\f[R]
+An option reported by the \f[CB]\-options\f[R] option.
+One or more output options that consist of a single \f[CB]statOption\f[R],
+plus any of the \f[CB]\-t\f[R], \f[CB]\-h\f[R], and \f[CB]\-J\f[R] options.
+See \f[B]Output Options for the jstat Command\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-t\f[R]
+Displays a time\-stamp column as the first column of output.
+The time stamp is the time since the start time of the target JVM.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] \f[I]n\f[R]
+Displays a column header every \f[I]n\f[R] samples (output rows), where
+\f[I]n\f[R] is a positive integer.
+The default value is \f[CB]0\f[R], which displays the column header of the
+first row of data.
+.RS
+.RE
+.TP
+.B \f[I]vmid\f[R]
+A virtual machine identifier, which is a string that indicates the
+target JVM.
+See \f[B]Virtual Machine Identifier\f[R].
+.RS
+.RE
+.TP
+.B \f[I]interval\f[R]
+The sampling interval in the specified units, seconds (s) or
+milliseconds (ms).
+Default units are milliseconds.
+This must be a positive integer.
+When specified, the \f[CB]jstat\f[R] command produces its output at each
+interval.
+.RS
+.RE
+.TP
+.B \f[I]count\f[R]
+The number of samples to display.
+The default value is infinity, which causes the \f[CB]jstat\f[R] command
+to display statistics until the target JVM terminates or the
+\f[CB]jstat\f[R] command is terminated.
+This value must be a positive integer.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jstat\f[R] command displays performance statistics for an
+instrumented Java HotSpot VM.
+The target JVM is identified by its virtual machine identifier, or
+\f[CB]vmid\f[R] option.
+.PP
+The \f[CB]jstat\f[R] command supports two types of options, general
+options and output options.
+General options cause the \f[CB]jstat\f[R] command to display simple usage
+and version information.
+Output options determine the content and format of the statistical
+output.
+.PP
+All options and their functionality are subject to change or removal in
+future releases.
+.SH GENERAL OPTIONS
+.PP
+If you specify one of the general options, then you can\[aq]t specify
+any other option or parameter.
+.TP
+.B \f[CB]\-help\f[R]
+Displays a help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-options\f[R]
+Displays a list of static options.
+See \f[B]Output Options for the jstat Command\f[R].
+.RS
+.RE
+.SH OUTPUT OPTIONS FOR THE JSTAT COMMAND
+.PP
+If you don\[aq]t specify a general option, then you can specify output
+options.
+Output options determine the content and format of the \f[CB]jstat\f[R]
+command\[aq]s output, and consist of a single \f[CB]statOption\f[R], plus
+any of the other output options (\f[CB]\-h\f[R], \f[CB]\-t\f[R], and
+\f[CB]\-J\f[R]).
+The \f[CB]statOption\f[R] must come first.
+.PP
+Output is formatted as a table, with columns that are separated by
+spaces.
+A header row with titles describes the columns.
+Use the \f[CB]\-h\f[R] option to set the frequency at which the header is
+displayed.
+Column header names are consistent among the different options.
+In general, if two options provide a column with the same name, then the
+data source for the two columns is the same.
+.PP
+Use the \f[CB]\-t\f[R] option to display a time\-stamp column, labeled
+Timestamp as the first column of output.
+The Timestamp column contains the elapsed time, in seconds, since the
+target JVM started.
+The resolution of the time stamp is dependent on various factors and is
+subject to variation due to delayed thread scheduling on heavily loaded
+systems.
+.PP
+Use the interval and count parameters to determine how frequently and
+how many times, respectively, the \f[CB]jstat\f[R] command displays its
+output.
+.PP
+\f[B]Note:\f[R]
+.PP
+Don\[aq]t write scripts to parse the \f[CB]jstat\f[R] command\[aq]s output
+because the format might change in future releases.
+If you write scripts that parse the \f[CB]jstat\f[R] command output, then
+expect to modify them for future releases of this tool.
+.TP
+.B \f[CB]\-statOption\f[R]
+Determines the statistics information that the \f[CB]jstat\f[R] command
+displays.
+The following lists the available options.
+Use the \f[CB]\-options\f[R] general option to display the list of options
+for a particular platform installation.
+See \f[B]Stat Options and Output\f[R].
+.RS
+.PP
+\f[CB]class\f[R]: Displays statistics about the behavior of the class
+loader.
+.PP
+\f[CB]compiler\f[R]: Displays statistics about the behavior of the Java
+HotSpot VM Just\-in\-Time compiler.
+.PP
+\f[CB]gc\f[R]: Displays statistics about the behavior of the garbage
+collected heap.
+.PP
+\f[CB]gccapacity\f[R]: Displays statistics about the capacities of the
+generations and their corresponding spaces.
+.PP
+\f[CB]gccause\f[R]: Displays a summary about garbage collection statistics
+(same as \f[CB]\-gcutil\f[R]), with the cause of the last and current
+(when applicable) garbage collection events.
+.PP
+\f[CB]gcnew\f[R]: Displays statistics about the behavior of the new
+generation.
+.PP
+\f[CB]gcnewcapacity\f[R]: Displays statistics about the sizes of the new
+generations and their corresponding spaces.
+.PP
+\f[CB]gcold\f[R]: Displays statistics about the behavior of the old
+generation and metaspace statistics.
+.PP
+\f[CB]gcoldcapacity\f[R]: Displays statistics about the sizes of the old
+generation.
+.PP
+\f[CB]gcmetacapacity\f[R]: Displays statistics about the sizes of the
+metaspace.
+.PP
+\f[CB]gcutil\f[R]: Displays a summary about garbage collection statistics.
+.PP
+\f[CB]printcompilation\f[R]: Displays Java HotSpot VM compilation method
+statistics.
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]javaOption\f[R]
+Passes \f[I]javaOption\f[R] to the Java application launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+For a complete list of options, see \f[B]java\f[R].
+.RS
+.RE
+.SH STAT OPTIONS AND OUTPUT
+.PP
+The following information summarizes the columns that the \f[CB]jstat\f[R]
+command outputs for each \f[I]statOption\f[R].
+.TP
+.B \f[CB]\-class\f[R] \f[I]option\f[R]
+Class loader statistics.
+.RS
+.PP
+\f[CB]Loaded\f[R]: Number of classes loaded.
+.PP
+\f[CB]Bytes\f[R]: Number of KB loaded.
+.PP
+\f[CB]Unloaded\f[R]: Number of classes unloaded.
+.PP
+\f[CB]Bytes\f[R]: Number of KB unloaded.
+.PP
+\f[CB]Time\f[R]: Time spent performing class loading and unloading
+operations.
+.RE
+.TP
+.B \f[CB]\-compiler\f[R] \f[I]option\f[R]
+Java HotSpot VM Just\-in\-Time compiler statistics.
+.RS
+.PP
+\f[CB]Compiled\f[R]: Number of compilation tasks performed.
+.PP
+\f[CB]Failed\f[R]: Number of compilations tasks failed.
+.PP
+\f[CB]Invalid\f[R]: Number of compilation tasks that were invalidated.
+.PP
+\f[CB]Time\f[R]: Time spent performing compilation tasks.
+.PP
+\f[CB]FailedType\f[R]: Compile type of the last failed compilation.
+.PP
+\f[CB]FailedMethod\f[R]: Class name and method of the last failed
+compilation.
+.RE
+.TP
+.B \f[CB]\-gc\f[R] \f[I]option\f[R]
+Garbage collected heap statistics.
+.RS
+.PP
+\f[CB]S0C\f[R]: Current survivor space 0 capacity (KB).
+.PP
+\f[CB]S1C\f[R]: Current survivor space 1 capacity (KB).
+.PP
+\f[CB]S0U\f[R]: Survivor space 0 utilization (KB).
+.PP
+\f[CB]S1U\f[R]: Survivor space 1 utilization (KB).
+.PP
+\f[CB]EC\f[R]: Current eden space capacity (KB).
+.PP
+\f[CB]EU\f[R]: Eden space utilization (KB).
+.PP
+\f[CB]OC\f[R]: Current old space capacity (KB).
+.PP
+\f[CB]OU\f[R]: Old space utilization (KB).
+.PP
+\f[CB]MC\f[R]: Metaspace Committed Size (KB).
+.PP
+\f[CB]MU\f[R]: Metaspace utilization (KB).
+.PP
+\f[CB]CCSC\f[R]: Compressed class committed size (KB).
+.PP
+\f[CB]CCSU\f[R]: Compressed class space used (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation garbage collection (GC) events.
+.PP
+\f[CB]YGCT\f[R]: Young generation garbage collection time.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gccapacity\f[R] \f[I]option\f[R]
+Memory pool generation and space capacities.
+.RS
+.PP
+\f[CB]NGCMN\f[R]: Minimum new generation capacity (KB).
+.PP
+\f[CB]NGCMX\f[R]: Maximum new generation capacity (KB).
+.PP
+\f[CB]NGC\f[R]: Current new generation capacity (KB).
+.PP
+\f[CB]S0C\f[R]: Current survivor space 0 capacity (KB).
+.PP
+\f[CB]S1C\f[R]: Current survivor space 1 capacity (KB).
+.PP
+\f[CB]EC\f[R]: Current eden space capacity (KB).
+.PP
+\f[CB]OGCMN\f[R]: Minimum old generation capacity (KB).
+.PP
+\f[CB]OGCMX\f[R]: Maximum old generation capacity (KB).
+.PP
+\f[CB]OGC\f[R]: Current old generation capacity (KB).
+.PP
+\f[CB]OC\f[R]: Current old space capacity (KB).
+.PP
+\f[CB]MCMN\f[R]: Minimum metaspace capacity (KB).
+.PP
+\f[CB]MCMX\f[R]: Maximum metaspace capacity (KB).
+.PP
+\f[CB]MC\f[R]: Metaspace Committed Size (KB).
+.PP
+\f[CB]CCSMN\f[R]: Compressed class space minimum capacity (KB).
+.PP
+\f[CB]CCSMX\f[R]: Compressed class space maximum capacity (KB).
+.PP
+\f[CB]CCSC\f[R]: Compressed class committed size (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.RE
+.TP
+.B \f[CB]\-gccause\f[R] \f[I]option\f[R]
+This option displays the same summary of garbage collection statistics
+as the \f[CB]\-gcutil\f[R] option, but includes the causes of the last
+garbage collection event and (when applicable), the current garbage
+collection event.
+In addition to the columns listed for \f[CB]\-gcutil\f[R], this option
+adds the following columns:
+.RS
+.PP
+\f[CB]LGCC\f[R]: Cause of last garbage collection
+.PP
+\f[CB]GCC\f[R]: Cause of current garbage collection
+.RE
+.TP
+.B \f[CB]\-gcnew\f[R] \f[I]option\f[R]
+New generation statistics.
+.RS
+.PP
+\f[CB]S0C\f[R]: Current survivor space 0 capacity (KB).
+.PP
+\f[CB]S1C\f[R]: Current survivor space 1 capacity (KB).
+.PP
+\f[CB]S0U\f[R]: Survivor space 0 utilization (KB).
+.PP
+\f[CB]S1U\f[R]: Survivor space 1 utilization (KB).
+.PP
+\f[CB]TT\f[R]: Tenuring threshold.
+.PP
+\f[CB]MTT\f[R]: Maximum tenuring threshold.
+.PP
+\f[CB]DSS\f[R]: Desired survivor size (KB).
+.PP
+\f[CB]EC\f[R]: Current eden space capacity (KB).
+.PP
+\f[CB]EU\f[R]: Eden space utilization (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]YGCT\f[R]: Young generation garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gcnewcapacity\f[R] \f[I]option\f[R]
+New generation space size statistics.
+.RS
+.PP
+\f[CB]NGCMN\f[R]: Minimum new generation capacity (KB).
+.PP
+\f[CB]NGCMX\f[R]: Maximum new generation capacity (KB).
+.PP
+\f[CB]NGC\f[R]: Current new generation capacity (KB).
+.PP
+\f[CB]S0CMX\f[R]: Maximum survivor space 0 capacity (KB).
+.PP
+\f[CB]S0C\f[R]: Current survivor space 0 capacity (KB).
+.PP
+\f[CB]S1CMX\f[R]: Maximum survivor space 1 capacity (KB).
+.PP
+\f[CB]S1C\f[R]: Current survivor space 1 capacity (KB).
+.PP
+\f[CB]ECMX\f[R]: Maximum eden space capacity (KB).
+.PP
+\f[CB]EC\f[R]: Current eden space capacity (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.RE
+.TP
+.B \f[CB]\-gcold\f[R] \f[I]option\f[R]
+Old generation size statistics.
+.RS
+.PP
+\f[CB]MC\f[R]: Metaspace Committed Size (KB).
+.PP
+\f[CB]MU\f[R]: Metaspace utilization (KB).
+.PP
+\f[CB]CCSC\f[R]: Compressed class committed size (KB).
+.PP
+\f[CB]CCSU\f[R]: Compressed class space used (KB).
+.PP
+\f[CB]OC\f[R]: Current old space capacity (KB).
+.PP
+\f[CB]OU\f[R]: Old space utilization (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gcoldcapacity\f[R] \f[I]option\f[R]
+Old generation statistics.
+.RS
+.PP
+\f[CB]OGCMN\f[R]: Minimum old generation capacity (KB).
+.PP
+\f[CB]OGCMX\f[R]: Maximum old generation capacity (KB).
+.PP
+\f[CB]OGC\f[R]: Current old generation capacity (KB).
+.PP
+\f[CB]OC\f[R]: Current old space capacity (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gcmetacapacity\f[R] \f[I]option\f[R]
+Metaspace size statistics.
+.RS
+.PP
+\f[CB]MCMN\f[R]: Minimum metaspace capacity (KB).
+.PP
+\f[CB]MCMX\f[R]: Maximum metaspace capacity (KB).
+.PP
+\f[CB]MC\f[R]: Metaspace Committed Size (KB).
+.PP
+\f[CB]CCSMN\f[R]: Compressed class space minimum capacity (KB).
+.PP
+\f[CB]CCSMX\f[R]: Compressed class space maximum capacity (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gcutil\f[R] \f[I]option\f[R]
+Summary of garbage collection statistics.
+.RS
+.PP
+\f[CB]S0\f[R]: Survivor space 0 utilization as a percentage of the
+space\[aq]s current capacity.
+.PP
+\f[CB]S1\f[R]: Survivor space 1 utilization as a percentage of the
+space\[aq]s current capacity.
+.PP
+\f[CB]E\f[R]: Eden space utilization as a percentage of the space\[aq]s
+current capacity.
+.PP
+\f[CB]O\f[R]: Old space utilization as a percentage of the space\[aq]s
+current capacity.
+.PP
+\f[CB]M\f[R]: Metaspace utilization as a percentage of the space\[aq]s
+current capacity.
+.PP
+\f[CB]CCS\f[R]: Compressed class space utilization as a percentage.
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]YGCT\f[R]: Young generation garbage collection time.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-printcompilation\f[R] \f[I]option\f[R]
+Java HotSpot VM compiler method statistics.
+.RS
+.PP
+\f[CB]Compiled\f[R]: Number of compilation tasks performed by the most
+recently compiled method.
+.PP
+\f[CB]Size\f[R]: Number of bytes of byte code of the most recently
+compiled method.
+.PP
+\f[CB]Type\f[R]: Compilation type of the most recently compiled method.
+.PP
+\f[CB]Method\f[R]: Class name and method name identifying the most
+recently compiled method.
+Class name uses a slash (/) instead of a dot (.) as a name space
+separator.
+The method name is the method within the specified class.
+The format for these two fields is consistent with the HotSpot
+\f[CB]\-XX:+PrintCompilation\f[R] option.
+.RE
+.SH VIRTUAL MACHINE IDENTIFIER
+.PP
+The syntax of the \f[CB]vmid\f[R] string corresponds to the syntax of a
+URI:
+.RS
+.PP
+[\f[I]protocol\f[R]\f[CB]:\f[R]][\f[CB]//\f[R]]\f[I]lvmid\f[R][\f[CB]\@\f[R]\f[I]hostname\f[R][\f[CB]:\f[R]\f[I]port\f[R]][\f[CB]/\f[R]\f[I]servername\f[R]]
+.RE
+.PP
+The syntax of the \f[CB]vmid\f[R] string corresponds to the syntax of a
+URI.
+The \f[CB]vmid\f[R] string can vary from a simple integer that represents
+a local JVM to a more complex construction that specifies a
+communications protocol, port number, and other implementation\-specific
+values.
+.TP
+.B \f[I]protocol\f[R]
+The communications protocol.
+If the \f[I]protocol\f[R] value is omitted and a host name isn\[aq]t
+specified, then the default protocol is a platform\-specific optimized
+local protocol.
+If the \f[I]protocol\f[R] value is omitted and a host name is specified,
+then the default protocol is \f[CB]rmi\f[R].
+.RS
+.RE
+.TP
+.B \f[I]lvmid\f[R]
+The local virtual machine identifier for the target JVM.
+The \f[I]lvmid\f[R] is a platform\-specific value that uniquely
+identifies a JVM on a system.
+The \f[I]lvmid\f[R] is the only required component of a virtual machine
+identifier.
+The \f[I]lvmid\f[R] is typically, but not necessarily, the operating
+system\[aq]s process identifier for the target JVM process.
+You can use the \f[CB]jps\f[R] command to determine the \f[I]lvmid\f[R]
+provided the JVM processes is not running in a separate docker instance.
+You can also determine the \f[I]lvmid\f[R] on Linux and OS X platforms
+with the \f[CB]ps\f[R] command, and on Windows with the Windows Task
+Manager.
+.RS
+.RE
+.TP
+.B \f[I]hostname\f[R]
+A host name or IP address that indicates the target host.
+If the \f[I]hostname\f[R] value is omitted, then the target host is the
+local host.
+.RS
+.RE
+.TP
+.B \f[I]port\f[R]
+The default port for communicating with the remote server.
+If the \f[I]hostname\f[R] value is omitted or the \f[I]protocol\f[R] value
+specifies an optimized, local protocol, then the \f[I]port\f[R] value is
+ignored.
+Otherwise, treatment of the \f[I]port\f[R] parameter is
+implementation\-specific.
+For the default \f[CB]rmi\f[R] protocol, the port value indicates the port
+number for the \f[CB]rmiregistry\f[R] on the remote host.
+If the \f[I]port\f[R] value is omitted and the \f[I]protocol\f[R] value
+indicates \f[CB]rmi\f[R], then the default rmiregistry port (1099) is
+used.
+.RS
+.RE
+.TP
+.B \f[I]servername\f[R]
+The treatment of the \f[I]servername\f[R] parameter depends on
+implementation.
+For the optimized local protocol, this field is ignored.
+For the \f[CB]rmi\f[R] protocol, it represents the name of the RMI remote
+object on the remote host.
+.RS
+.RE
+.SH EXAMPLES
+.PP
+This section presents some examples of monitoring a local JVM with an
+\f[I]lvmid\f[R] of 21891.
+.SH THE GCUTIL OPTION
+.PP
+This example attaches to lvmid 21891 and takes 7 samples at 250
+millisecond intervals and displays the output as specified by the
+\f[CB]\-gcutil\f[R] option.
+.PP
+The output of this example shows that a young generation collection
+occurred between the third and fourth sample.
+The collection took 0.078 seconds and promoted objects from the eden
+space (E) to the old space (O), resulting in an increase of old space
+utilization from 66.80% to 68.19%.
+Before the collection, the survivor space was 97.02% utilized, but after
+this collection it\[aq]s 91.03% utilized.
+.IP
+.nf
+\f[CB]
+jstat\ \-gcutil\ 21891\ 250\ 7
+\ \ S0\ \ \ \ \ S1\ \ \ \ \ E\ \ \ \ \ \ O\ \ \ \ \ \ M\ \ \ \ \ CCS\ \ \ \ YGC\ \ \ \ \ YGCT\ \ \ \ FGC\ \ \ \ FGCT\ \ \ \ \ GCT
+\ \ 0.00\ \ 97.02\ \ 70.31\ \ 66.80\ \ 95.52\ \ 89.14\ \ \ \ \ \ 7\ \ \ \ 0.300\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.300
+\ \ 0.00\ \ 97.02\ \ 86.23\ \ 66.80\ \ 95.52\ \ 89.14\ \ \ \ \ \ 7\ \ \ \ 0.300\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.300
+\ \ 0.00\ \ 97.02\ \ 96.53\ \ 66.80\ \ 95.52\ \ 89.14\ \ \ \ \ \ 7\ \ \ \ 0.300\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.300
+\ 91.03\ \ \ 0.00\ \ \ 1.98\ \ 68.19\ \ 95.89\ \ 91.24\ \ \ \ \ \ 8\ \ \ \ 0.378\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.378
+\ 91.03\ \ \ 0.00\ \ 15.82\ \ 68.19\ \ 95.89\ \ 91.24\ \ \ \ \ \ 8\ \ \ \ 0.378\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.378
+\ 91.03\ \ \ 0.00\ \ 17.80\ \ 68.19\ \ 95.89\ \ 91.24\ \ \ \ \ \ 8\ \ \ \ 0.378\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.378
+\ 91.03\ \ \ 0.00\ \ 17.80\ \ 68.19\ \ 95.89\ \ 91.24\ \ \ \ \ \ 8\ \ \ \ 0.378\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.378
+\f[R]
+.fi
+.SH REPEAT THE COLUMN HEADER STRING
+.PP
+This example attaches to lvmid 21891 and takes samples at 250
+millisecond intervals and displays the output as specified by
+\f[CB]\-gcnew\f[R] option.
+In addition, it uses the \f[CB]\-h3\f[R] option to output the column
+header after every 3 lines of data.
+.PP
+In addition to showing the repeating header string, this example shows
+that between the second and third samples, a young GC occurred.
+Its duration was 0.001 seconds.
+The collection found enough active data that the survivor space 0
+utilization (S0U) would have exceeded the desired survivor size (DSS).
+As a result, objects were promoted to the old generation (not visible in
+this output), and the tenuring threshold (TT) was lowered from 31 to 2.
+.PP
+Another collection occurs between the fifth and sixth samples.
+This collection found very few survivors and returned the tenuring
+threshold to 31.
+.IP
+.nf
+\f[CB]
+jstat\ \-gcnew\ \-h3\ 21891\ 250
+\ S0C\ \ \ \ S1C\ \ \ \ S0U\ \ \ \ S1U\ \ \ TT\ MTT\ \ DSS\ \ \ \ \ \ EC\ \ \ \ \ \ \ EU\ \ \ \ \ YGC\ \ \ \ \ YGCT
+\ \ 64.0\ \ \ 64.0\ \ \ \ 0.0\ \ \ 31.7\ 31\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 178.6\ \ \ \ 249\ \ \ \ 0.203
+\ \ 64.0\ \ \ 64.0\ \ \ \ 0.0\ \ \ 31.7\ 31\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 355.5\ \ \ \ 249\ \ \ \ 0.203
+\ \ 64.0\ \ \ 64.0\ \ \ 35.4\ \ \ \ 0.0\ \ 2\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ \ 21.9\ \ \ \ 250\ \ \ \ 0.204
+\ S0C\ \ \ \ S1C\ \ \ \ S0U\ \ \ \ S1U\ \ \ TT\ MTT\ \ DSS\ \ \ \ \ \ EC\ \ \ \ \ \ \ EU\ \ \ \ \ YGC\ \ \ \ \ YGCT
+\ \ 64.0\ \ \ 64.0\ \ \ 35.4\ \ \ \ 0.0\ \ 2\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 245.9\ \ \ \ 250\ \ \ \ 0.204
+\ \ 64.0\ \ \ 64.0\ \ \ 35.4\ \ \ \ 0.0\ \ 2\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 421.1\ \ \ \ 250\ \ \ \ 0.204
+\ \ 64.0\ \ \ 64.0\ \ \ \ 0.0\ \ \ 19.0\ 31\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ \ 84.4\ \ \ \ 251\ \ \ \ 0.204
+\ S0C\ \ \ \ S1C\ \ \ \ S0U\ \ \ \ S1U\ \ \ TT\ MTT\ \ DSS\ \ \ \ \ \ EC\ \ \ \ \ \ \ EU\ \ \ \ \ YGC\ \ \ \ \ YGCT
+\ \ 64.0\ \ \ 64.0\ \ \ \ 0.0\ \ \ 19.0\ 31\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 306.7\ \ \ \ 251\ \ \ \ 0.204
+\f[R]
+.fi
+.SH INCLUDE A TIME STAMP FOR EACH SAMPLE
+.PP
+This example attaches to lvmid 21891 and takes 3 samples at 250
+millisecond intervals.
+The \f[CB]\-t\f[R] option is used to generate a time stamp for each sample
+in the first column.
+.PP
+The Timestamp column reports the elapsed time in seconds since the start
+of the target JVM.
+In addition, the \f[CB]\-gcoldcapacity\f[R] output shows the old
+generation capacity (OGC) and the old space capacity (OC) increasing as
+the heap expands to meet allocation or promotion demands.
+The old generation capacity (OGC) has grown from 11,696 KB to 13,820 KB
+after the eighty\-first full garbage collection (FGC).
+The maximum capacity of the generation (and space) is 60,544 KB (OGCMX),
+so it still has room to expand.
+.IP
+.nf
+\f[CB]
+Timestamp\ \ \ \ \ \ OGCMN\ \ \ \ OGCMX\ \ \ \ \ OGC\ \ \ \ \ \ \ OC\ \ \ \ \ \ \ YGC\ \ \ FGC\ \ \ \ FGCT\ \ \ \ GCT
+\ \ \ \ \ \ \ \ \ \ 150.1\ \ \ 1408.0\ \ 60544.0\ \ 11696.0\ \ 11696.0\ \ \ 194\ \ \ \ 80\ \ \ \ 2.874\ \ \ 3.799
+\ \ \ \ \ \ \ \ \ \ 150.4\ \ \ 1408.0\ \ 60544.0\ \ 13820.0\ \ 13820.0\ \ \ 194\ \ \ \ 81\ \ \ \ 2.938\ \ \ 3.863
+\ \ \ \ \ \ \ \ \ \ 150.7\ \ \ 1408.0\ \ 60544.0\ \ 13820.0\ \ 13820.0\ \ \ 194\ \ \ \ 81\ \ \ \ 2.938\ \ \ 3.863
+\f[R]
+.fi
+.SH MONITOR INSTRUMENTATION FOR A REMOTE JVM
+.PP
+This example attaches to lvmid 40496 on the system named
+\f[CB]remote.domain\f[R] using the \f[CB]\-gcutil\f[R] option, with samples
+taken every second indefinitely.
+.PP
+The lvmid is combined with the name of the remote host to construct a
+vmid of \f[CB]40496\@remote.domain\f[R].
+This vmid results in the use of the \f[CB]rmi\f[R] protocol to communicate
+to the default \f[CB]jstatd\f[R] server on the remote host.
+The \f[CB]jstatd\f[R] server is located using the \f[CB]rmiregistry\f[R]
+command on \f[CB]remote.domain\f[R] that\[aq]s bound to the default port
+of the \f[CB]rmiregistry\f[R] command (port 1099).
+.IP
+.nf
+\f[CB]
+jstat\ \-gcutil\ 40496\@remote.domain\ 1000
+\&...\ output\ omitted
+\f[R]
+.fi
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/jstatd.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/jstatd.1
new file mode 100644
index 0000000..4361f55
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/jstatd.1
@@ -0,0 +1,217 @@
+.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JSTATD" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jstatd \- monitor the creation and termination of instrumented Java
+HotSpot VMs
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jstatd\f[R] [\f[I]options\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jstatd\f[R] command\-line options.
+See \f[B]Options for the jstatd Command\f[R].
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jstatd\f[R] command is an RMI server application that monitors
+for the creation and termination of instrumented Java HotSpot VMs and
+provides an interface to enable remote monitoring tools, \f[CB]jstat\f[R]
+and \f[CB]jps\f[R], to attach to JVMs that are running on the local host
+and collect information about the JVM process.
+.PP
+The \f[CB]jstatd\f[R] server requires an RMI registry on the local host.
+The \f[CB]jstatd\f[R] server attempts to attach to the RMI registry on the
+default port, or on the port you specify with the \f[CB]\-p\f[R]
+\f[CB]port\f[R] option.
+If an RMI registry is not found, then one is created within the
+\f[CB]jstatd\f[R] application that\[aq]s bound to the port that\[aq]s
+indicated by the \f[CB]\-p\f[R] \f[CB]port\f[R] option or to the default RMI
+registry port when the \f[CB]\-p\f[R] \f[CB]port\f[R] option is omitted.
+You can stop the creation of an internal RMI registry by specifying the
+\f[CB]\-nr\f[R] option.
+.SH OPTIONS FOR THE JSTATD COMMAND
+.TP
+.B \f[CB]\-nr\f[R]
+This option does not attempt to create an internal RMI registry within
+the \f[CB]jstatd\f[R] process when an existing RMI registry isn\[aq]t
+found.
+.RS
+.RE
+.TP
+.B \f[CB]\-p\f[R] \f[I]port\f[R]
+This option sets the port number where the RMI registry is expected to
+be found, or when not found, created if the \f[CB]\-nr\f[R] option
+isn\[aq]t specified.
+.RS
+.RE
+.TP
+.B \f[CB]\-r\f[R] \f[I]rmiport\f[R]
+This option sets the port number to which the RMI connector is bound.
+If not specified a random available port is used.
+.RS
+.RE
+.TP
+.B \f[CB]\-n\f[R] \f[I]rminame\f[R]
+This option sets the name to which the remote RMI object is bound in the
+RMI registry.
+The default name is \f[CB]JStatRemoteHost\f[R].
+If multiple \f[CB]jstatd\f[R] servers are started on the same host, then
+the name of the exported RMI object for each server can be made unique
+by specifying this option.
+However, doing so requires that the unique server name be included in
+the monitoring client\[aq]s \f[CB]hostid\f[R] and \f[CB]vmid\f[R] strings.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+This option passes a Java \f[CB]option\f[R] to the JVM, where the option
+is one of those described on the reference page for the Java application
+launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+See \f[B]java\f[R].
+.RS
+.RE
+.SH SECURITY
+.PP
+The \f[CB]jstatd\f[R] server can monitor only JVMs for which it has the
+appropriate native access permissions.
+Therefore, the \f[CB]jstatd\f[R] process must be running with the same
+user credentials as the target JVMs.
+Some user credentials, such as the root user in Linux and OS X operating
+systems, have permission to access the instrumentation exported by any
+JVM on the system.
+A \f[CB]jstatd\f[R] process running with such credentials can monitor any
+JVM on the system, but introduces additional security concerns.
+.PP
+The \f[CB]jstatd\f[R] server doesn\[aq]t provide any authentication of
+remote clients.
+Therefore, running a \f[CB]jstatd\f[R] server process exposes the
+instrumentation export by all JVMs for which the \f[CB]jstatd\f[R] process
+has access permissions to any user on the network.
+This exposure might be undesirable in your environment, and therefore,
+local security policies should be considered before you start the
+\f[CB]jstatd\f[R] process, particularly in production environments or on
+networks that aren\[aq]t secure.
+.PP
+The \f[CB]jstatd\f[R] server installs an instance of
+\f[CB]RMISecurityPolicy\f[R] when no other security manager is installed,
+and therefore, requires a security policy file to be specified.
+The policy file must conform to Default Policy Implementation and Policy
+File Syntax.
+.PP
+If your security concerns can\[aq]t be addressed with a customized
+policy file, then the safest action is to not run the \f[CB]jstatd\f[R]
+server and use the \f[CB]jstat\f[R] and \f[CB]jps\f[R] tools locally.
+However, when using \f[CB]jps\f[R] to get a list of instrumented JVMs, the
+list will not include any JVMs running in docker containers.
+.SH REMOTE INTERFACE
+.PP
+The interface exported by the \f[CB]jstatd\f[R] process is proprietary and
+guaranteed to change.
+Users and developers are discouraged from writing to this interface.
+.SH EXAMPLES
+.PP
+The following are examples of the \f[CB]jstatd\f[R] command.
+The \f[CB]jstatd\f[R] scripts automatically start the server in the
+background.
+.SH INTERNAL RMI REGISTRY
+.PP
+This example shows how to start a \f[CB]jstatd\f[R] session with an
+internal RMI registry.
+This example assumes that no other server is bound to the default RMI
+registry port (port \f[CB]1099\f[R]).
+.RS
+.PP
+\f[CB]jstatd\ \-J\-Djava.security.policy=all.policy\f[R]
+.RE
+.SH EXTERNAL RMI REGISTRY
+.PP
+This example starts a \f[CB]jstatd\f[R] session with an external RMI
+registry.
+.IP
+.nf
+\f[CB]
+rmiregistry&
+jstatd\ \-J\-Djava.security.policy=all.policy
+\f[R]
+.fi
+.PP
+This example starts a \f[CB]jstatd\f[R] session with an external RMI
+registry server on port \f[CB]2020\f[R].
+.IP
+.nf
+\f[CB]
+jrmiregistry\ 2020&
+jstatd\ \-J\-Djava.security.policy=all.policy\ \-p\ 2020
+\f[R]
+.fi
+.PP
+This example starts a \f[CB]jstatd\f[R] session with an external RMI
+registry server on port \f[CB]2020\f[R] and JMX connector bound to port
+\f[CB]2021\f[R].
+.IP
+.nf
+\f[CB]
+jrmiregistry\ 2020&
+jstatd\ \-J\-Djava.security.policy=all.policy\ \-p\ 2020\ \-r\ 2021
+\f[R]
+.fi
+.PP
+This example starts a \f[CB]jstatd\f[R] session with an external RMI
+registry on port 2020 that\[aq]s bound to
+\f[CB]AlternateJstatdServerName\f[R].
+.IP
+.nf
+\f[CB]
+rmiregistry\ 2020&
+jstatd\ \-J\-Djava.security.policy=all.policy\ \-p\ 2020\ \-n\ AlternateJstatdServerName
+\f[R]
+.fi
+.SH STOP THE CREATION OF AN IN\-PROCESS RMI REGISTRY
+.PP
+This example starts a \f[CB]jstatd\f[R] session that doesn\[aq]t create an
+RMI registry when one isn\[aq]t found.
+This example assumes an RMI registry is already running.
+If an RMI registry isn\[aq]t running, then an error message is
+displayed.
+.RS
+.PP
+\f[CB]jstatd\ \-J\-Djava.security.policy=all.policy\ \-nr\f[R]
+.RE
+.SH ENABLE RMI LOGGING
+.PP
+This example starts a \f[CB]jstatd\f[R] session with RMI logging
+capabilities enabled.
+This technique is useful as a troubleshooting aid or for monitoring
+server activities.
+.RS
+.PP
+\f[CB]jstatd\ \-J\-Djava.security.policy=all.policy\ \-J\-Djava.rmi.server.logCalls=true\f[R]
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/keytool.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/keytool.1
new file mode 100644
index 0000000..eda4c2c
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/keytool.1
@@ -0,0 +1,2965 @@
+.\" Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"t
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "KEYTOOL" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+keytool \- a key and certificate management utility
+.SH SYNOPSIS
+.PP
+\f[CB]keytool\f[R] [\f[I]commands\f[R]]
+.TP
+.B \f[I]commands\f[R]
+Commands for \f[CB]keytool\f[R] include the following:
+.RS
+.IP \[bu] 2
+\f[CB]\-certreq\f[R]: Generates a certificate request
+.IP \[bu] 2
+\f[CB]\-changealias\f[R]: Changes an entry\[aq]s alias
+.IP \[bu] 2
+\f[CB]\-delete\f[R]: Deletes an entry
+.IP \[bu] 2
+\f[CB]\-exportcert\f[R]: Exports certificate
+.IP \[bu] 2
+\f[CB]\-genkeypair\f[R]: Generates a key pair
+.IP \[bu] 2
+\f[CB]\-genseckey\f[R]: Generates a secret key
+.IP \[bu] 2
+\f[CB]\-gencert\f[R]: Generates a certificate from a certificate request
+.IP \[bu] 2
+\f[CB]\-importcert\f[R]: Imports a certificate or a certificate chain
+.IP \[bu] 2
+\f[CB]\-importpass\f[R]: Imports a password
+.IP \[bu] 2
+\f[CB]\-importkeystore\f[R]: Imports one or all entries from another
+keystore
+.IP \[bu] 2
+\f[CB]\-keypasswd\f[R]: Changes the key password of an entry
+.IP \[bu] 2
+\f[CB]\-list\f[R]: Lists entries in a keystore
+.IP \[bu] 2
+\f[CB]\-printcert\f[R]: Prints the content of a certificate
+.IP \[bu] 2
+\f[CB]\-printcertreq\f[R]: Prints the content of a certificate request
+.IP \[bu] 2
+\f[CB]\-printcrl\f[R]: Prints the content of a Certificate Revocation List
+(CRL) file
+.IP \[bu] 2
+\f[CB]\-storepasswd\f[R]: Changes the store password of a keystore
+.IP \[bu] 2
+\f[CB]\-showinfo\f[R]: Displays security\-related information
+.PP
+See \f[B]Commands and Options\f[R] for a description of these commands
+with their options.
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]keytool\f[R] command is a key and certificate management
+utility.
+It enables users to administer their own public/private key pairs and
+associated certificates for use in self\-authentication (where a user
+authenticates themselves to other users and services) or data integrity
+and authentication services, by using digital signatures.
+The \f[CB]keytool\f[R] command also enables users to cache the public keys
+(in the form of certificates) of their communicating peers.
+.PP
+A certificate is a digitally signed statement from one entity (person,
+company, and so on), which says that the public key (and some other
+information) of some other entity has a particular value.
+When data is digitally signed, the signature can be verified to check
+the data integrity and authenticity.
+Integrity means that the data hasn\[aq]t been modified or tampered with,
+and authenticity means that the data comes from the individual who
+claims to have created and signed it.
+.PP
+The \f[CB]keytool\f[R] command also enables users to administer secret
+keys and passphrases used in symmetric encryption and decryption (Data
+Encryption Standard).
+It can also display other security\-related information.
+.PP
+The \f[CB]keytool\f[R] command stores the keys and certificates in a
+keystore.
+.PP
+The \f[CB]keytool\f[R] command uses the
+\f[CB]jdk.certpath.disabledAlgorithms\f[R] and
+\f[CB]jdk.security.legacyAlgorithms\f[R] security properties to determine
+which algorithms are considered a security risk.
+It emits warnings when disabled or legacy algorithms are being used.
+The \f[CB]jdk.certpath.disabledAlgorithms\f[R] and
+\f[CB]jdk.security.legacyAlgorithms\f[R] security properties are defined
+in the \f[CB]java.security\f[R] file (located in the JDK\[aq]s
+\f[CB]$JAVA_HOME/conf/security\f[R] directory).
+.SH COMMAND AND OPTION NOTES
+.PP
+The following notes apply to the descriptions in \f[B]Commands and
+Options\f[R]:
+.IP \[bu] 2
+All command and option names are preceded by a hyphen sign
+(\f[CB]\-\f[R]).
+.IP \[bu] 2
+Only one command can be provided.
+.IP \[bu] 2
+Options for each command can be provided in any order.
+.IP \[bu] 2
+There are two kinds of options, one is single\-valued which should be
+only provided once.
+If a single\-valued option is provided multiple times, the value of the
+last one is used.
+The other type is multi\-valued, which can be provided multiple times
+and all values are used.
+The only multi\-valued option currently supported is the \f[CB]\-ext\f[R]
+option used to generate X.509v3 certificate extensions.
+.IP \[bu] 2
+All items not italicized or in braces ({ }) or brackets ([ ]) are
+required to appear as is.
+.IP \[bu] 2
+Braces surrounding an option signify that a default value is used when
+the option isn\[aq]t specified on the command line.
+Braces are also used around the \f[CB]\-v\f[R], \f[CB]\-rfc\f[R], and
+\f[CB]\-J\f[R] options, which have meaning only when they appear on the
+command line.
+They don\[aq]t have any default values.
+.IP \[bu] 2
+Brackets surrounding an option signify that the user is prompted for the
+values when the option isn\[aq]t specified on the command line.
+For the \f[CB]\-keypass\f[R] option, if you don\[aq]t specify the option
+on the command line, then the \f[CB]keytool\f[R] command first attempts to
+use the keystore password to recover the private/secret key.
+If this attempt fails, then the \f[CB]keytool\f[R] command prompts you for
+the private/secret key password.
+.IP \[bu] 2
+Items in italics (option values) represent the actual values that must
+be supplied.
+For example, here is the format of the \f[CB]\-printcert\f[R] command:
+.RS 2
+.RS
+.PP
+\f[CB]keytool\ \-printcert\f[R] {\f[CB]\-file\f[R] \f[I]cert_file\f[R]}
+{\f[CB]\-v\f[R]}
+.RE
+.PP
+When you specify a \f[CB]\-printcert\f[R] command, replace
+\f[I]cert_file\f[R] with the actual file name, as follows:
+\f[CB]keytool\ \-printcert\ \-file\ VScert.cer\f[R]
+.RE
+.IP \[bu] 2
+Option values must be enclosed in quotation marks when they contain a
+blank (space).
+.SH COMMANDS AND OPTIONS
+.PP
+The keytool commands and their options can be grouped by the tasks that
+they perform.
+.PP
+\f[B]Commands for Creating or Adding Data to the Keystore\f[R]:
+.IP \[bu] 2
+\f[CB]\-gencert\f[R]
+.IP \[bu] 2
+\f[CB]\-genkeypair\f[R]
+.IP \[bu] 2
+\f[CB]\-genseckey\f[R]
+.IP \[bu] 2
+\f[CB]\-importcert\f[R]
+.IP \[bu] 2
+\f[CB]\-importpass\f[R]
+.PP
+\f[B]Commands for Importing Contents from Another Keystore\f[R]:
+.IP \[bu] 2
+\f[CB]\-importkeystore\f[R]
+.PP
+\f[B]Commands for Generating a Certificate Request\f[R]:
+.IP \[bu] 2
+\f[CB]\-certreq\f[R]
+.PP
+\f[B]Commands for Exporting Data\f[R]:
+.IP \[bu] 2
+\f[CB]\-exportcert\f[R]
+.PP
+\f[B]Commands for Displaying Data\f[R]:
+.IP \[bu] 2
+\f[CB]\-list\f[R]
+.IP \[bu] 2
+\f[CB]\-printcert\f[R]
+.IP \[bu] 2
+\f[CB]\-printcertreq\f[R]
+.IP \[bu] 2
+\f[CB]\-printcrl\f[R]
+.PP
+\f[B]Commands for Managing the Keystore\f[R]:
+.IP \[bu] 2
+\f[CB]\-storepasswd\f[R]
+.IP \[bu] 2
+\f[CB]\-keypasswd\f[R]
+.IP \[bu] 2
+\f[CB]\-delete\f[R]
+.IP \[bu] 2
+\f[CB]\-changealias\f[R]
+.PP
+\f[B]Commands for Displaying Security\-related Information\f[R]:
+.IP \[bu] 2
+\f[CB]\-showinfo\f[R]
+.SH COMMANDS FOR CREATING OR ADDING DATA TO THE KEYSTORE
+.TP
+.B \f[CB]\-gencert\f[R]
+The following are the available options for the \f[CB]\-gencert\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-rfc\f[R]}: Output in RFC (Request For Comment) style
+.IP \[bu] 2
+{\f[CB]\-infile\f[R] \f[I]infile\f[R]}: Input file name
+.IP \[bu] 2
+{\f[CB]\-outfile\f[R] \f[I]outfile\f[R]}: Output file name
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-sigalg\f[R] \f[I]sigalg\f[R]}: Signature algorithm name
+.IP \[bu] 2
+{\f[CB]\-dname\f[R] \f[I]dname\f[R]}: Distinguished name
+.IP \[bu] 2
+{\f[CB]\-startdate\f[R] \f[I]startdate\f[R]}: Certificate validity start
+date and time
+.IP \[bu] 2
+{\f[CB]\-ext\f[R] \f[I]ext\f[R]}*: X.509 extension
+.IP \[bu] 2
+{\f[CB]\-validity\f[R] \f[I]days\f[R]}: Validity number of days
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Adds a security provider by name (such as SunPKCS11)
+with an optional configure argument.
+The value of the security provider is the name of a security provider
+that is defined in a module.
+.RS 2
+.PP
+For example,
+.RS
+.PP
+\f[CB]keytool\ \-addprovider\ SunPKCS11\ \-providerarg\ some.cfg\ ...\f[R]
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+For compatibility reasons, the SunPKCS11 provider can still be loaded
+with \f[CB]\-providerclass\ sun.security.pkcs11.SunPKCS11\f[R] even if it
+is now defined in a module.
+This is the only module included in the JDK that needs a configuration,
+and therefore the most widely used with the \f[CB]\-providerclass\f[R]
+option.
+For legacy security providers located on classpath and loaded by
+reflection, \f[CB]\-providerclass\f[R] should still be used.
+.RE
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.RS 2
+.PP
+For example, if \f[CB]MyProvider\f[R] is a legacy provider loaded via
+reflection,
+.RS
+.PP
+\f[CB]keytool\ \-providerclass\ com.example.MyProvider\ ...\f[R]
+.RE
+.RE
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-gencert\f[R] command to generate a certificate as a
+response to a certificate request file (which can be created by the
+\f[CB]keytool\ \-certreq\f[R] command).
+The command reads the request either from \f[I]infile\f[R] or, if
+omitted, from the standard input, signs it by using the alias\[aq]s
+private key, and outputs the X.509 certificate into either
+\f[I]outfile\f[R] or, if omitted, to the standard output.
+When \f[CB]\-rfc\f[R] is specified, the output format is Base64\-encoded
+PEM; otherwise, a binary DER is created.
+.PP
+The \f[CB]\-sigalg\f[R] value specifies the algorithm that should be used
+to sign the certificate.
+The \f[I]startdate\f[R] argument is the start time and date that the
+certificate is valid.
+The \f[I]days\f[R] argument tells the number of days for which the
+certificate should be considered valid.
+.PP
+When \f[I]dname\f[R] is provided, it is used as the subject of the
+generated certificate.
+Otherwise, the one from the certificate request is used.
+.PP
+The \f[CB]\-ext\f[R] value shows what X.509 extensions will be embedded in
+the certificate.
+Read \f[B]Common Command Options\f[R] for the grammar of \f[CB]\-ext\f[R].
+.PP
+The \f[CB]\-gencert\f[R] option enables you to create certificate chains.
+The following example creates a certificate, \f[CB]e1\f[R], that contains
+three certificates in its certificate chain.
+.PP
+The following commands creates four key pairs named \f[CB]ca\f[R],
+\f[CB]ca1\f[R], \f[CB]ca2\f[R], and \f[CB]e1\f[R]:
+.IP
+.nf
+\f[CB]
+keytool\ \-alias\ ca\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa
+keytool\ \-alias\ ca1\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa
+keytool\ \-alias\ ca2\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa
+keytool\ \-alias\ e1\ \-dname\ CN=E1\ \-genkeypair\ \-keyalg\ rsa
+\f[R]
+.fi
+.PP
+The following two commands create a chain of signed certificates;
+\f[CB]ca\f[R] signs \f[CB]ca1\f[R] and \f[CB]ca1\f[R] signs \f[CB]ca2\f[R], all
+of which are self\-issued:
+.IP
+.nf
+\f[CB]
+keytool\ \-alias\ ca1\ \-certreq\ |
+\ \ \ \ keytool\ \-alias\ ca\ \-gencert\ \-ext\ san=dns:ca1\ |
+\ \ \ \ keytool\ \-alias\ ca1\ \-importcert
+
+keytool\ \-alias\ ca2\ \-certreq\ |
+\ \ \ \ keytool\ \-alias\ ca1\ \-gencert\ \-ext\ san=dns:ca2\ |
+\ \ \ \ keytool\ \-alias\ ca2\ \-importcert
+\f[R]
+.fi
+.PP
+The following command creates the certificate \f[CB]e1\f[R] and stores it
+in the \f[CB]e1.cert\f[R] file, which is signed by \f[CB]ca2\f[R].
+As a result, \f[CB]e1\f[R] should contain \f[CB]ca\f[R], \f[CB]ca1\f[R], and
+\f[CB]ca2\f[R] in its certificate chain:
+.RS
+.PP
+\f[CB]keytool\ \-alias\ e1\ \-certreq\ |\ keytool\ \-alias\ ca2\ \-gencert\ >\ e1.cert\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-genkeypair\f[R]
+The following are the available options for the \f[CB]\-genkeypair\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+\f[CB]\-keyalg\f[R] \f[I]alg\f[R]: Key algorithm name
+.IP \[bu] 2
+{\f[CB]\-keysize\f[R] \f[I]size\f[R]}: Key bit size
+.IP \[bu] 2
+{\f[CB]\-groupname\f[R] \f[I]name\f[R]}: Group name.
+For example, an Elliptic Curve name.
+.IP \[bu] 2
+{\f[CB]\-sigalg\f[R] \f[I]alg\f[R]}: Signature algorithm name
+.IP \[bu] 2
+{\f[CB]\-signer\f[R] \f[I]alias\f[R]}: Signer alias
+.IP \[bu] 2
+[\f[CB]\-signerkeypass\f[R] \f[I]arg\f[R]]: Signer key password
+.IP \[bu] 2
+[\f[CB]\-dname\f[R] \f[I]name\f[R]]: Distinguished name
+.IP \[bu] 2
+{\f[CB]\-startdate\f[R] \f[I]date\f[R]}: Certificate validity start date
+and time
+.IP \[bu] 2
+{\f[CB]\-ext\f[R] \f[I]value\f[R]}*: X.509 extension
+.IP \[bu] 2
+{\f[CB]\-validity\f[R] \f[I]days\f[R]}: Validity number of days
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]] }: Add security provider by fully qualified class name
+with an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-genkeypair\f[R] command to generate a key pair (a public
+key and associated private key).
+When the \f[CB]\-signer\f[R] option is not specified, the public key is
+wrapped in an X.509 v3 self\-signed certificate and stored as a
+single\-element certificate chain.
+When the \f[CB]\-signer\f[R] option is specified, a new certificate is
+generated and signed by the designated signer and stored as a
+multiple\-element certificate chain (containing the generated
+certificate itself, and the signer???s certificate chain).
+The certificate chain and private key are stored in a new keystore entry
+that is identified by its alias.
+.PP
+The \f[CB]\-keyalg\f[R] value specifies the algorithm to be used to
+generate the key pair, and the \f[CB]\-keysize\f[R] value specifies the
+size of each key to be generated.
+The \f[CB]\-sigalg\f[R] value specifies the algorithm that should be used
+to sign the certificate.
+This algorithm must be compatible with the \f[CB]\-keyalg\f[R] value.
+.PP
+The \f[CB]\-groupname\f[R] value specifies the named group (for example,
+the standard or predefined name of an Elliptic Curve) of the key to be
+generated.
+Only one of \f[CB]\-groupname\f[R] and \f[CB]\-keysize\f[R] can be
+specified.
+.PP
+The \f[CB]\-signer\f[R] value specifies the alias of a
+\f[CB]PrivateKeyEntry\f[R] for the signer that already exists in the
+keystore.
+This option is used to sign the certificate with the signer???s private
+key.
+This is especially useful for key agreement algorithms (i.e.
+the \f[CB]\-keyalg\f[R] value is \f[CB]XDH\f[R], \f[CB]X25519\f[R],
+\f[CB]X448\f[R], or \f[CB]DH\f[R]) as these keys cannot be used for digital
+signatures, and therefore a self\-signed certificate cannot be created.
+.PP
+The \f[CB]\-signerkeypass\f[R] value specifies the password of the
+signer???s private key.
+It can be specified if the private key of the signer entry is protected
+by a password different from the store password.
+.PP
+The \f[CB]\-dname\f[R] value specifies the X.500 Distinguished Name to be
+associated with the value of \f[CB]\-alias\f[R].
+If the \f[CB]\-signer\f[R] option is not specified, the issuer and subject
+fields of the self\-signed certificate are populated with the specified
+distinguished name.
+If the \f[CB]\-signer\f[R] option is specified, the subject field of the
+certificate is populated with the specified distinguished name and the
+issuer field is populated with the subject field of the signer\[aq]s
+certificate.
+If a distinguished name is not provided at the command line, then the
+user is prompted for one.
+.PP
+The value of \f[CB]\-keypass\f[R] is a password used to protect the
+private key of the generated key pair.
+If a password is not provided, then the user is prompted for it.
+If you press the \f[B]Return\f[R] key at the prompt, then the key
+password is set to the same password as the keystore password.
+The \f[CB]\-keypass\f[R] value must have at least six characters.
+.PP
+The value of \f[CB]\-startdate\f[R] specifies the issue time of the
+certificate, also known as the "Not Before" value of the X.509
+certificate\[aq]s Validity field.
+.PP
+The option value can be set in one of these two forms:
+.PP
+([\f[CB]+\-\f[R]]\f[I]nnn\f[R][\f[CB]ymdHMS\f[R]])+
+.PP
+[\f[I]yyyy\f[R]\f[CB]/\f[R]\f[I]mm\f[R]\f[CB]/\f[R]\f[I]dd\f[R]]
+[\f[I]HH\f[R]\f[CB]:\f[R]\f[I]MM\f[R]\f[CB]:\f[R]\f[I]SS\f[R]]
+.PP
+With the first form, the issue time is shifted by the specified value
+from the current time.
+The value is a concatenation of a sequence of subvalues.
+Inside each subvalue, the plus sign (+) means shift forward, and the
+minus sign (\-) means shift backward.
+The time to be shifted is \f[I]nnn\f[R] units of years, months, days,
+hours, minutes, or seconds (denoted by a single character of \f[CB]y\f[R],
+\f[CB]m\f[R], \f[CB]d\f[R], \f[CB]H\f[R], \f[CB]M\f[R], or \f[CB]S\f[R]
+respectively).
+The exact value of the issue time is calculated by using the
+\f[CB]java.util.GregorianCalendar.add(int\ field,\ int\ amount)\f[R]
+method on each subvalue, from left to right.
+For example, the issue time can be specified by:
+.IP
+.nf
+\f[CB]
+Calendar\ c\ =\ new\ GregorianCalendar();
+c.add(Calendar.YEAR,\ \-1);
+c.add(Calendar.MONTH,\ 1);
+c.add(Calendar.DATE,\ \-1);
+return\ c.getTime()
+\f[R]
+.fi
+.PP
+With the second form, the user sets the exact issue time in two parts,
+year/month/day and hour:minute:second (using the local time zone).
+The user can provide only one part, which means the other part is the
+same as the current date (or time).
+The user must provide the exact number of digits shown in the format
+definition (padding with 0 when shorter).
+When both date and time are provided, there is one (and only one) space
+character between the two parts.
+The hour should always be provided in 24\-hour format.
+.PP
+When the option isn\[aq]t provided, the start date is the current time.
+The option can only be provided one time.
+.PP
+The value of \f[I]date\f[R] specifies the number of days (starting at the
+date specified by \f[CB]\-startdate\f[R], or the current date when
+\f[CB]\-startdate\f[R] isn\[aq]t specified) for which the certificate
+should be considered valid.
+.RE
+.TP
+.B \f[CB]\-genseckey\f[R]
+The following are the available options for the \f[CB]\-genseckey\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+\f[CB]\-keyalg\f[R] \f[I]alg\f[R]: Key algorithm name
+.IP \[bu] 2
+{\f[CB]\-keysize\f[R] \f[I]size\f[R]}: Key bit size
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-genseckey\f[R] command to generate a secret key and store
+it in a new \f[CB]KeyStore.SecretKeyEntry\f[R] identified by
+\f[CB]alias\f[R].
+.PP
+The value of \f[CB]\-keyalg\f[R] specifies the algorithm to be used to
+generate the secret key, and the value of \f[CB]\-keysize\f[R] specifies
+the size of the key that is generated.
+The \f[CB]\-keypass\f[R] value is a password that protects the secret key.
+If a password is not provided, then the user is prompted for it.
+If you press the \f[B]Return\f[R] key at the prompt, then the key
+password is set to the same password that is used for the
+\f[CB]\-keystore\f[R].
+The \f[CB]\-keypass\f[R] value must contain at least six characters.
+.RE
+.TP
+.B \f[CB]\-importcert\f[R]
+The following are the available options for the \f[CB]\-importcert\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-noprompt\f[R]}: Do not prompt
+.IP \[bu] 2
+{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]file\f[R]}: Input file name
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-importcert\f[R] command to read the certificate or
+certificate chain (where the latter is supplied in a PKCS#7 formatted
+reply or in a sequence of X.509 certificates) from \f[CB]\-file\f[R]
+\f[I]file\f[R], and store it in the \f[CB]keystore\f[R] entry identified by
+\f[CB]\-alias\f[R].
+If \f[CB]\-file\f[R] \f[I]file\f[R] is not specified, then the certificate
+or certificate chain is read from \f[CB]stdin\f[R].
+.PP
+The \f[CB]keytool\f[R] command can import X.509 v1, v2, and v3
+certificates, and PKCS#7 formatted certificate chains consisting of
+certificates of that type.
+The data to be imported must be provided either in binary encoding
+format or in printable encoding format (also known as Base64 encoding)
+as defined by the Internet RFC 1421 standard.
+In the latter case, the encoding must be bounded at the beginning by a
+string that starts with \f[CB]\-\-\-\-\-BEGIN\f[R], and bounded at the end
+by a string that starts with \f[CB]\-\-\-\-\-END\f[R].
+.PP
+You import a certificate for two reasons: To add it to the list of
+trusted certificates, and to import a certificate reply received from a
+certificate authority (CA) as the result of submitting a Certificate
+Signing Request (CSR) to that CA.
+See the \f[CB]\-certreq\f[R] command in \f[B]Commands for Generating a
+Certificate Request\f[R].
+.PP
+The type of import is indicated by the value of the \f[CB]\-alias\f[R]
+option.
+If the alias doesn\[aq]t point to a key entry, then the \f[CB]keytool\f[R]
+command assumes you are adding a trusted certificate entry.
+In this case, the alias shouldn\[aq]t already exist in the keystore.
+If the alias does exist, then the \f[CB]keytool\f[R] command outputs an
+error because a trusted certificate already exists for that alias, and
+doesn\[aq]t import the certificate.
+If \f[CB]\-alias\f[R] points to a key entry, then the \f[CB]keytool\f[R]
+command assumes that you\[aq]re importing a certificate reply.
+.RE
+.TP
+.B \f[CB]\-importpass\f[R]
+The following are the available options for the \f[CB]\-importpass\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keyalg\f[R] \f[I]alg\f[R]}: Key algorithm name
+.IP \[bu] 2
+{\f[CB]\-keysize\f[R] \f[I]size\f[R]}: Key bit size
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-importpass\f[R] command to imports a passphrase and store
+it in a new \f[CB]KeyStore.SecretKeyEntry\f[R] identified by
+\f[CB]\-alias\f[R].
+The passphrase may be supplied via the standard input stream; otherwise
+the user is prompted for it.
+The \f[CB]\-keypass\f[R] option provides a password to protect the
+imported passphrase.
+If a password is not provided, then the user is prompted for it.
+If you press the \f[B]Return\f[R] key at the prompt, then the key
+password is set to the same password as that used for the
+\f[CB]keystore\f[R].
+The \f[CB]\-keypass\f[R] value must contain at least six characters.
+.RE
+.SH COMMANDS FOR IMPORTING CONTENTS FROM ANOTHER KEYSTORE
+.TP
+.B \f[CB]\-importkeystore\f[R]
+The following are the available options for the
+\f[CB]\-importkeystore\f[R] command:
+.RS
+.IP \[bu] 2
+\f[CB]\-srckeystore\f[R] \f[I]keystore\f[R]: Source keystore name
+.IP \[bu] 2
+{\f[CB]\-destkeystore\f[R] \f[I]keystore\f[R]}: Destination keystore name
+.IP \[bu] 2
+{\f[CB]\-srcstoretype\f[R] \f[I]type\f[R]}: Source keystore type
+.IP \[bu] 2
+{\f[CB]\-deststoretype\f[R] \f[I]type\f[R]}: Destination keystore type
+.IP \[bu] 2
+[\f[CB]\-srcstorepass\f[R] \f[I]arg\f[R]]: Source keystore password
+.IP \[bu] 2
+[\f[CB]\-deststorepass\f[R] \f[I]arg\f[R]]: Destination keystore password
+.IP \[bu] 2
+{\f[CB]\-srcprotected\f[R]}: Source keystore password protected
+.IP \[bu] 2
+{\f[CB]\-destprotected\f[R]}: Destination keystore password protected
+.IP \[bu] 2
+{\f[CB]\-srcprovidername\f[R] \f[I]name\f[R]}: Source keystore provider
+name
+.IP \[bu] 2
+{\f[CB]\-destprovidername\f[R] \f[I]name\f[R]}: Destination keystore
+provider name
+.IP \[bu] 2
+{\f[CB]\-srcalias\f[R] \f[I]alias\f[R]}: Source alias
+.IP \[bu] 2
+{\f[CB]\-destalias\f[R] \f[I]alias\f[R]}: Destination alias
+.IP \[bu] 2
+[\f[CB]\-srckeypass\f[R] \f[I]arg\f[R]]: Source key password
+.IP \[bu] 2
+[\f[CB]\-destkeypass\f[R] \f[I]arg\f[R]]: Destination key password
+.IP \[bu] 2
+{\f[CB]\-noprompt\f[R]}: Do not prompt
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]: Add security provider by name (such as SunPKCS11) with an
+optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+\f[B]Note:\f[R]
+.PP
+This is the first line of all options:
+.RS
+.PP
+\f[CB]\-srckeystore\f[R] \f[I]keystore\f[R] \f[CB]\-destkeystore\f[R]
+\f[I]keystore\f[R]
+.RE
+.PP
+Use the \f[CB]\-importkeystore\f[R] command to import a single entry or
+all entries from a source keystore to a destination keystore.
+.PP
+\f[B]Note:\f[R]
+.PP
+If you do not specify \f[CB]\-destkeystore\f[R] when using the
+\f[CB]keytool\ \-importkeystore\f[R] command, then the default keystore
+used is \f[CB]$HOME/.keystore\f[R].
+.PP
+When the \f[CB]\-srcalias\f[R] option is provided, the command imports the
+single entry identified by the alias to the destination keystore.
+If a destination alias isn\[aq]t provided with \f[CB]\-destalias\f[R],
+then \f[CB]\-srcalias\f[R] is used as the destination alias.
+If the source entry is protected by a password, then
+\f[CB]\-srckeypass\f[R] is used to recover the entry.
+If \f[CB]\-srckeypass\f[R] isn\[aq]t provided, then the \f[CB]keytool\f[R]
+command attempts to use \f[CB]\-srcstorepass\f[R] to recover the entry.
+If \f[CB]\-srcstorepass\f[R] is not provided or is incorrect, then the
+user is prompted for a password.
+The destination entry is protected with \f[CB]\-destkeypass\f[R].
+If \f[CB]\-destkeypass\f[R] isn\[aq]t provided, then the destination entry
+is protected with the source entry password.
+For example, most third\-party tools require \f[CB]storepass\f[R] and
+\f[CB]keypass\f[R] in a PKCS #12 keystore to be the same.
+To create a PKCS#12 keystore for these tools, always specify a
+\f[CB]\-destkeypass\f[R] that is the same as \f[CB]\-deststorepass\f[R].
+.PP
+If the \f[CB]\-srcalias\f[R] option isn\[aq]t provided, then all entries
+in the source keystore are imported into the destination keystore.
+Each destination entry is stored under the alias from the source entry.
+If the source entry is protected by a password, then
+\f[CB]\-srcstorepass\f[R] is used to recover the entry.
+If \f[CB]\-srcstorepass\f[R] is not provided or is incorrect, then the
+user is prompted for a password.
+If a source keystore entry type isn\[aq]t supported in the destination
+keystore, or if an error occurs while storing an entry into the
+destination keystore, then the user is prompted either to skip the entry
+and continue or to quit.
+The destination entry is protected with the source entry password.
+.PP
+If the destination alias already exists in the destination keystore,
+then the user is prompted either to overwrite the entry or to create a
+new entry under a different alias name.
+.PP
+If the \f[CB]\-noprompt\f[R] option is provided, then the user isn\[aq]t
+prompted for a new destination alias.
+Existing entries are overwritten with the destination alias name.
+Entries that can\[aq]t be imported are skipped and a warning is
+displayed.
+.RE
+.SH COMMANDS FOR GENERATING A CERTIFICATE REQUEST
+.TP
+.B \f[CB]\-certreq\f[R]
+The following are the available options for the \f[CB]\-certreq\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-sigalg\f[R] \f[I]alg\f[R]}: Signature algorithm name
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]file\f[R]}: Output file name
+.IP \[bu] 2
+[ \f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-dname\f[R] \f[I]name\f[R]}: Distinguished name
+.IP \[bu] 2
+{\f[CB]\-ext\f[R] \f[I]value\f[R]}: X.509 extension
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-certreq\f[R] command to generate a Certificate Signing
+Request (CSR) using the PKCS #10 format.
+.PP
+A CSR is intended to be sent to a CA.
+The CA authenticates the certificate requestor (usually offline) and
+returns a certificate or certificate chain to replace the existing
+certificate chain (initially a self\-signed certificate) in the
+keystore.
+.PP
+The private key associated with \f[I]alias\f[R] is used to create the
+PKCS #10 certificate request.
+To access the private key, the correct password must be provided.
+If \f[CB]\-keypass\f[R] isn\[aq]t provided at the command line and is
+different from the password used to protect the integrity of the
+keystore, then the user is prompted for it.
+If \f[CB]\-dname\f[R] is provided, then it is used as the subject in the
+CSR.
+Otherwise, the X.500 Distinguished Name associated with alias is used.
+.PP
+The \f[CB]\-sigalg\f[R] value specifies the algorithm that should be used
+to sign the CSR.
+.PP
+The CSR is stored in the \f[CB]\-file\f[R] \f[I]file\f[R].
+If a file is not specified, then the CSR is output to \f[CB]\-stdout\f[R].
+.PP
+Use the \f[CB]\-importcert\f[R] command to import the response from the
+CA.
+.RE
+.SH COMMANDS FOR EXPORTING DATA
+.TP
+.B \f[CB]\-exportcert\f[R]
+The following are the available options for the \f[CB]\-exportcert\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-rfc\f[R]}: Output in RFC style
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]file\f[R]}: Output file name
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]] }: Add security provider by fully qualified class name
+with an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-exportcert\f[R] command to read a certificate from the
+keystore that is associated with \f[CB]\-alias\f[R] \f[I]alias\f[R] and
+store it in the \f[CB]\-file\f[R] \f[I]file\f[R].
+When a file is not specified, the certificate is output to
+\f[CB]stdout\f[R].
+.PP
+By default, the certificate is output in binary encoding.
+If the \f[CB]\-rfc\f[R] option is specified, then the output in the
+printable encoding format defined by the Internet RFC 1421 Certificate
+Encoding Standard.
+.PP
+If \f[CB]\-alias\f[R] refers to a trusted certificate, then that
+certificate is output.
+Otherwise, \f[CB]\-alias\f[R] refers to a key entry with an associated
+certificate chain.
+In that case, the first certificate in the chain is returned.
+This certificate authenticates the public key of the entity addressed by
+\f[CB]\-alias\f[R].
+.RE
+.SH COMMANDS FOR DISPLAYING DATA
+.TP
+.B \f[CB]\-list\f[R]
+The following are the available options for the \f[CB]\-list\f[R] command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-rfc\f[R]}: Output in RFC style
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]] }: Add security provider by fully qualified class name
+with an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-list\f[R] command to print the contents of the keystore
+entry identified by \f[CB]\-alias\f[R] to \f[CB]stdout\f[R].
+If \f[CB]\-alias\f[R] \f[I]alias\f[R] is not specified, then the contents
+of the entire keystore are printed.
+.PP
+By default, this command prints the SHA\-256 fingerprint of a
+certificate.
+If the \f[CB]\-v\f[R] option is specified, then the certificate is printed
+in human\-readable format, with additional information such as the
+owner, issuer, serial number, and any extensions.
+If the \f[CB]\-rfc\f[R] option is specified, then the certificate contents
+are printed by using the printable encoding format, as defined by the
+Internet RFC 1421 Certificate Encoding Standard.
+.PP
+\f[B]Note:\f[R]
+.PP
+You can\[aq]t specify both \f[CB]\-v\f[R] and \f[CB]\-rfc\f[R] in the same
+command.
+Otherwise, an error is reported.
+.RE
+.TP
+.B \f[CB]\-printcert\f[R]
+The following are the available options for the \f[CB]\-printcert\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-rfc\f[R]}: Output in RFC style
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]cert_file\f[R]}: Input file name
+.IP \[bu] 2
+{\f[CB]\-sslserver\f[R] \f[I]server\f[R][\f[CB]:\f[R]\f[I]port\f[R]]}:: Secure
+Sockets Layer (SSL) server host and port
+.IP \[bu] 2
+{\f[CB]\-jarfile\f[R] \f[I]JAR_file\f[R]}: Signed \f[CB]\&.jar\f[R] file
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-printcert\f[R] command to read and print the certificate
+from \f[CB]\-file\f[R] \f[I]cert_file\f[R], the SSL server located at
+\f[CB]\-sslserver\f[R] \f[I]server\f[R][\f[CB]:\f[R]\f[I]port\f[R]], or the
+signed JAR file specified by \f[CB]\-jarfile\f[R] \f[I]JAR_file\f[R].
+It prints its contents in a human\-readable format.
+When a port is not specified, the standard HTTPS port 443 is assumed.
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]\-sslserver\f[R] and \f[CB]\-file\f[R] options can\[aq]t be
+provided in the same command.
+Otherwise, an error is reported.
+If you don\[aq]t specify either option, then the certificate is read
+from \f[CB]stdin\f[R].
+.PP
+When\f[CB]\-rfc\f[R] is specified, the \f[CB]keytool\f[R] command prints the
+certificate in PEM mode as defined by the Internet RFC 1421 Certificate
+Encoding standard.
+.PP
+If the certificate is read from a file or \f[CB]stdin\f[R], then it might
+be either binary encoded or in printable encoding format, as defined by
+the RFC 1421 Certificate Encoding standard.
+.PP
+If the SSL server is behind a firewall, then the
+\f[CB]\-J\-Dhttps.proxyHost=proxyhost\f[R] and
+\f[CB]\-J\-Dhttps.proxyPort=proxyport\f[R] options can be specified on the
+command line for proxy tunneling.
+.PP
+\f[B]Note:\f[R]
+.PP
+This command can be used independently of a keystore.
+This command does not check for the weakness of a certificate\[aq]s
+signature algorithm if it is a trusted certificate in the user keystore
+(specified by \f[CB]\-keystore\f[R]) or in the \f[CB]cacerts\f[R] keystore
+(if \f[CB]\-trustcacerts\f[R] is specified).
+.RE
+.TP
+.B \f[CB]\-printcertreq\f[R]
+The following are the available options for the \f[CB]\-printcertreq\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]file\f[R]}: Input file name
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-printcertreq\f[R] command to print the contents of a PKCS
+#10 format certificate request, which can be generated by the
+\f[CB]keytool\ \-certreq\f[R] command.
+The command reads the request from file.
+If there is no file, then the request is read from the standard input.
+.RE
+.TP
+.B \f[CB]\-printcrl\f[R]
+The following are the available options for the \f[CB]\-printcrl\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-file\ crl\f[R]}: Input file name
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-printcrl\f[R] command to read the Certificate Revocation
+List (CRL) from \f[CB]\-file\ crl\f[R] .
+A CRL is a list of the digital certificates that were revoked by the CA
+that issued them.
+The CA generates the \f[CB]crl\f[R] file.
+.PP
+\f[B]Note:\f[R]
+.PP
+This command can be used independently of a keystore.
+This command attempts to verify the CRL using a certificate from the
+user keystore (specified by \f[CB]\-keystore\f[R]) or the \f[CB]cacerts\f[R]
+keystore (if \f[CB]\-trustcacerts\f[R] is specified), and will print out a
+warning if it cannot be verified.
+.RE
+.SH COMMANDS FOR MANAGING THE KEYSTORE
+.TP
+.B \f[CB]\-storepasswd\f[R]
+The following are the available options for the \f[CB]\-storepasswd\f[R]
+command:
+.RS
+.IP \[bu] 2
+[\f[CB]\-new\f[R] \f[I]arg\f[R]]: New password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-storepasswd\f[R] command to change the password used to
+protect the integrity of the keystore contents.
+The new password is set by \f[CB]\-new\f[R] \f[I]arg\f[R] and must contain
+at least six characters.
+.RE
+.TP
+.B \f[CB]\-keypasswd\f[R]
+The following are the available options for the \f[CB]\-keypasswd\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]old_keypass\f[R]]: Key password
+.IP \[bu] 2
+[\f[CB]\-new\f[R] \f[I]new_keypass\f[R]]: New password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-storepass\f[R] \f[I]arg\f[R]}: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-keypasswd\f[R] command to change the password (under which
+private/secret keys identified by \f[CB]\-alias\f[R] are protected) from
+\f[CB]\-keypass\f[R] \f[I]old_keypass\f[R] to \f[CB]\-new\f[R]
+\f[I]new_keypass\f[R].
+The password value must contain at least six characters.
+.PP
+If the \f[CB]\-keypass\f[R] option isn\[aq]t provided at the command line
+and the \f[CB]\-keypass\f[R] password is different from the keystore
+password (\f[CB]\-storepass\f[R] \f[I]arg\f[R]), then the user is prompted
+for it.
+.PP
+If the \f[CB]\-new\f[R] option isn\[aq]t provided at the command line,
+then the user is prompted for it.
+.RE
+.TP
+.B \f[CB]\-delete\f[R]
+The following are the available options for the \f[CB]\-delete\f[R]
+command:
+.RS
+.IP \[bu] 2
+[\f[CB]\-alias\f[R] \f[I]alias\f[R]]: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-delete\f[R] command to delete the \f[CB]\-alias\f[R]
+\f[I]alias\f[R] entry from the keystore.
+When not provided at the command line, the user is prompted for the
+\f[CB]alias\f[R].
+.RE
+.TP
+.B \f[CB]\-changealias\f[R]
+The following are the available options for the \f[CB]\-changealias\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+[\f[CB]\-destalias\f[R] \f[I]alias\f[R]]: Destination alias
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-changealias\f[R] command to move an existing keystore
+entry from \f[CB]\-alias\f[R] \f[I]alias\f[R] to a new \f[CB]\-destalias\f[R]
+\f[I]alias\f[R].
+If a destination alias is not provided, then the command prompts you for
+one.
+If the original entry is protected with an entry password, then the
+password can be supplied with the \f[CB]\-keypass\f[R] option.
+If a key password is not provided, then the \f[CB]\-storepass\f[R] (if
+provided) is attempted first.
+If the attempt fails, then the user is prompted for a password.
+.RE
+.SH COMMANDS FOR DISPLAYING SECURITY\-RELATED INFORMATION
+.TP
+.B \f[CB]\-showinfo\f[R]
+The following are the available options for the \f[CB]\-showinfo\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-tls\f[R]}: Displays TLS configuration information
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-showinfo\f[R] command to display various security\-related
+information.
+The \f[CB]\-tls\f[R] option displays TLS configurations, such as the list
+of enabled protocols and cipher suites.
+.RE
+.SH COMMANDS FOR DISPLAYING HELP INFORMATION
+.PP
+You can use \f[CB]\-\-help\f[R] to display a list of \f[CB]keytool\f[R]
+commands or to display help information about a specific
+\f[CB]keytool\f[R] command.
+.IP \[bu] 2
+To display a list of \f[CB]keytool\f[R] commands, enter:
+.RS 2
+.RS
+.PP
+\f[CB]keytool\ \-\-help\f[R]
+.RE
+.RE
+.IP \[bu] 2
+To display help information about a specific \f[CB]keytool\f[R] command,
+enter:
+.RS 2
+.RS
+.PP
+\f[CB]keytool\ \-<command>\ \-\-help\f[R]
+.RE
+.RE
+.SH COMMON COMMAND OPTIONS
+.PP
+The \f[CB]\-v\f[R] option can appear for all commands except
+\f[CB]\-\-help\f[R].
+When the \f[CB]\-v\f[R] option appears, it signifies verbose mode, which
+means that more information is provided in the output.
+.PP
+The \f[CB]\-J\f[R]\f[I]option\f[R] argument can appear for any command.
+When the \f[CB]\-J\f[R]\f[I]option\f[R] is used, the specified
+\f[I]option\f[R] string is passed directly to the Java interpreter.
+This option doesn\[aq]t contain any spaces.
+It\[aq]s useful for adjusting the execution environment or memory usage.
+For a list of possible interpreter options, enter \f[CB]java\ \-h\f[R] or
+\f[CB]java\ \-X\f[R] at the command line.
+.PP
+These options can appear for all commands operating on a keystore:
+.TP
+.B \f[CB]\-storetype\f[R] \f[I]storetype\f[R]
+This qualifier specifies the type of keystore to be instantiated.
+.RS
+.RE
+.TP
+.B \f[CB]\-keystore\f[R] \f[I]keystore\f[R]
+The keystore location.
+.RS
+.PP
+If the JKS \f[CB]storetype\f[R] is used and a keystore file doesn\[aq]t
+yet exist, then certain \f[CB]keytool\f[R] commands can result in a new
+keystore file being created.
+For example, if \f[CB]keytool\ \-genkeypair\f[R] is called and the
+\f[CB]\-keystore\f[R] option isn\[aq]t specified, the default keystore
+file named \f[CB]\&.keystore\f[R] is created in the user\[aq]s home
+directory if it doesn\[aq]t already exist.
+Similarly, if the \f[CB]\-keystore\ ks_file\f[R] option is specified but
+\f[CB]ks_file\f[R] doesn\[aq]t exist, then it is created.
+For more information on the JKS \f[CB]storetype\f[R], see the
+\f[B]KeyStore Implementation\f[R] section in \f[B]KeyStore aliases\f[R].
+.PP
+Note that the input stream from the \f[CB]\-keystore\f[R] option is passed
+to the \f[CB]KeyStore.load\f[R] method.
+If \f[CB]NONE\f[R] is specified as the URL, then a null stream is passed
+to the \f[CB]KeyStore.load\f[R] method.
+\f[CB]NONE\f[R] should be specified if the keystore isn\[aq]t file\-based.
+For example, when the keystore resides on a hardware token device.
+.RE
+.TP
+.B \f[CB]\-cacerts\f[R] \f[I]cacerts\f[R]
+Operates on the \f[I]cacerts\f[R] keystore .
+This option is equivalent to \f[CB]\-keystore\f[R]
+\f[I]path_to_cacerts\f[R] \f[CB]\-storetype\f[R] \f[I]type_of_cacerts\f[R].
+An error is reported if the \f[CB]\-keystore\f[R] or \f[CB]\-storetype\f[R]
+option is used with the \f[CB]\-cacerts\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-storepass\f[R] [\f[CB]:env\f[R] | \f[CB]:file\f[R] ] \f[I]argument\f[R]
+The password that is used to protect the integrity of the keystore.
+.RS
+.PP
+If the modifier \f[CB]env\f[R] or \f[CB]file\f[R] isn\[aq]t specified, then
+the password has the value \f[I]argument\f[R], which must contain at
+least six characters.
+Otherwise, the password is retrieved as follows:
+.IP \[bu] 2
+\f[CB]env\f[R]: Retrieve the password from the environment variable named
+\f[I]argument\f[R].
+.IP \[bu] 2
+\f[CB]file\f[R]: Retrieve the password from the file named
+\f[I]argument\f[R].
+.PP
+\f[B]Note:\f[R] All other options that require passwords, such as
+\f[CB]\-keypass\f[R], \f[CB]\-srckeypass\f[R], \f[CB]\-destkeypass\f[R],
+\f[CB]\-srcstorepass\f[R], and \f[CB]\-deststorepass\f[R], accept the
+\f[CB]env\f[R] and \f[CB]file\f[R] modifiers.
+Remember to separate the password option and the modifier with a colon
+(:).
+.PP
+The password must be provided to all commands that access the keystore
+contents.
+For such commands, when the \f[CB]\-storepass\f[R] option isn\[aq]t
+provided at the command line, the user is prompted for it.
+.PP
+When retrieving information from the keystore, the password is optional.
+If a password is not specified, then the integrity of the retrieved
+information can\[aq]t be verified and a warning is displayed.
+.RE
+.TP
+.B \f[CB]\-providername\f[R] \f[I]name\f[R]
+Used to identify a cryptographic service provider\[aq]s name when listed
+in the security properties file.
+.RS
+.RE
+.TP
+.B \f[CB]\-addprovider\f[R] \f[I]name\f[R]
+Used to add a security provider by name (such as SunPKCS11) .
+.RS
+.RE
+.TP
+.B \f[CB]\-providerclass\f[R] \f[I]class\f[R]
+Used to specify the name of a cryptographic service provider\[aq]s
+master class file when the service provider isn\[aq]t listed in the
+security properties file.
+.RS
+.RE
+.TP
+.B \f[CB]\-providerpath\f[R] \f[I]list\f[R]
+Used to specify the provider classpath.
+.RS
+.RE
+.TP
+.B \f[CB]\-providerarg\f[R] \f[I]arg\f[R]
+Used with the \f[CB]\-addprovider\f[R] or \f[CB]\-providerclass\f[R] option
+to represent an optional string input argument for the constructor of
+\f[I]class\f[R] name.
+.RS
+.RE
+.TP
+.B \f[CB]\-protected=true\f[R]|\f[CB]false\f[R]
+Specify this value as \f[CB]true\f[R] when a password must be specified by
+way of a protected authentication path, such as a dedicated PIN reader.
+Because there are two keystores involved in the
+\f[CB]\-importkeystore\f[R] command, the following two options,
+\f[CB]\-srcprotected\f[R] and \f[CB]\-destprotected\f[R], are provided for
+the source keystore and the destination keystore respectively.
+.RS
+.RE
+.TP
+.B \f[CB]\-ext\f[R] {\f[I]name\f[R]{\f[CB]:critical\f[R]} {\f[CB]=\f[R]\f[I]value\f[R]}}
+Denotes an X.509 certificate extension.
+The option can be used in \f[CB]\-genkeypair\f[R] and \f[CB]\-gencert\f[R]
+to embed extensions into the generated certificate, or in
+\f[CB]\-certreq\f[R] to show what extensions are requested in the
+certificate request.
+The option can appear multiple times.
+The \f[I]name\f[R] argument can be a supported extension name (see
+\f[B]Supported Named Extensions\f[R]) or an arbitrary OID number.
+The \f[I]value\f[R] argument, when provided, denotes the argument for the
+extension.
+When \f[I]value\f[R] is omitted, the default value of the extension or
+the extension itself requires no argument.
+The \f[CB]:critical\f[R] modifier, when provided, means the
+extension\[aq]s \f[CB]isCritical\f[R] attribute is \f[CB]true\f[R];
+otherwise, it is \f[CB]false\f[R].
+You can use \f[CB]:c\f[R] in place of \f[CB]:critical\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-conf\f[R] \f[I]file\f[R]
+Specifies a pre\-configured options file.
+.RS
+.RE
+.SH PRE\-CONFIGURED OPTIONS FILE
+.PP
+A pre\-configured options file is a Java properties file that can be
+specified with the \f[CB]\-conf\f[R] option.
+Each property represents the default option(s) for a keytool command
+using "keytool.\f[I]command_name\f[R]" as the property name.
+A special property named "keytool.all" represents the default option(s)
+applied to all commands.
+A property value can include \f[CB]${prop}\f[R] which will be expanded to
+the system property associated with it.
+If an option value includes white spaces inside, it should be surrounded
+by quotation marks (" or \[aq]).
+All property names must be in lower case.
+.PP
+When \f[CB]keytool\f[R] is launched with a pre\-configured options file,
+the value for "keytool.all" (if it exists) is prepended to the
+\f[CB]keytool\f[R] command line first, with the value for the command name
+(if it exists) comes next, and the existing options on the command line
+at last.
+For a single\-valued option, this allows the property for a specific
+command to override the "keytool.all" value, and the value specified on
+the command line to override both.
+For multiple\-valued options, all of them will be used by
+\f[CB]keytool\f[R].
+.PP
+For example, given the following file named \f[CB]preconfig\f[R]:
+.IP
+.nf
+\f[CB]
+\ \ \ \ #\ A\ tiny\ pre\-configured\ options\ file
+\ \ \ \ keytool.all\ =\ \-keystore\ ${user.home}/ks
+\ \ \ \ keytool.list\ =\ \-v
+\ \ \ \ keytool.genkeypair\ =\ \-keyalg\ rsa
+\f[R]
+.fi
+.PP
+\f[CB]keytool\ \-conf\ preconfig\ \-list\f[R] is identical to
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ ~/ks\ \-v\ \-list\f[R]
+.RE
+.PP
+\f[CB]keytool\ \-conf\ preconfig\ \-genkeypair\ \-alias\ me\f[R] is
+identical to
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ ~/ks\ \-keyalg\ rsa\ \-genkeypair\ \-alias\ me\f[R]
+.RE
+.PP
+\f[CB]keytool\ \-conf\ preconfig\ \-genkeypair\ \-alias\ you\ \-keyalg\ ec\f[R]
+is identical to
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ ~/ks\ \-keyalg\ rsa\ \-genkeypair\ \-alias\ you\ \-keyalg\ ec\f[R]
+.RE
+.PP
+which is equivalent to
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ ~/ks\ \-genkeypair\ \-alias\ you\ \-keyalg\ ec\f[R]
+.RE
+.PP
+because \f[CB]\-keyalg\f[R] is a single\-valued option and the \f[CB]ec\f[R]
+value specified on the command line overrides the preconfigured options
+file.
+.SH EXAMPLES OF OPTION VALUES
+.PP
+The following examples show the defaults for various option values:
+.IP
+.nf
+\f[CB]
+\-alias\ "mykey"
+
+\-keysize
+\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA",\ "DSA",\ "RSASSA\-PSS",\ or\ "DH")
+\ \ \ \ 256\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EC")
+\ \ \ \ 255\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EdDSA",\ or\ "XDH)
+\ \ \ \ 56\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DES")
+\ \ \ \ 168\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DESede")
+
+\-validity\ 90
+
+\-keystore\ <the\ file\ named\ .keystore\ in\ the\ user\[aq]s\ home\ directory>
+
+\-destkeystore\ <the\ file\ named\ .keystore\ in\ the\ user\[aq]s\ home\ directory>
+
+\-storetype\ <the\ value\ of\ the\ "keystore.type"\ property\ in\ the
+\ \ \ \ security\ properties\ file,\ which\ is\ returned\ by\ the\ static
+\ \ \ \ getDefaultType\ method\ in\ java.security.KeyStore>
+
+\-file
+\ \ \ \ stdin\ (if\ reading)
+\ \ \ \ stdout\ (if\ writing)
+
+\-protected\ false
+\f[R]
+.fi
+.PP
+When generating a certificate or a certificate request, the default
+signature algorithm (\f[CB]\-sigalg\f[R] option) is derived from the
+algorithm of the underlying private key to provide an appropriate level
+of security strength as follows:
+.PP
+.TS
+tab(@);
+l l l.
+T{
+keyalg
+T}@T{
+keysize
+T}@T{
+default sigalg
+T}
+_
+T{
+DSA
+T}@T{
+any size
+T}@T{
+SHA256withDSA
+T}
+T{
+RSA
+T}@T{
+<= 3072
+T}@T{
+SHA256withRSA
+T}
+T{
+T}@T{
+<= 7680
+T}@T{
+SHA384withRSA
+T}
+T{
+T}@T{
+> 7680
+T}@T{
+SHA512withRSA
+T}
+T{
+EC
+T}@T{
+< 384
+T}@T{
+SHA256withECDSA
+T}
+T{
+T}@T{
+< 512
+T}@T{
+SHA384withECDSA
+T}
+T{
+T}@T{
+= 512
+T}@T{
+SHA512withECDSA
+T}
+T{
+RSASSA\-PSS
+T}@T{
+<= 3072
+T}@T{
+RSASSA\-PSS (with SHA\-256)
+T}
+T{
+T}@T{
+<= 7680
+T}@T{
+RSASSA\-PSS (with SHA\-384)
+T}
+T{
+T}@T{
+> 7680
+T}@T{
+RSASSA\-PSS (with SHA\-512)
+T}
+T{
+EdDSA
+T}@T{
+255
+T}@T{
+Ed25519
+T}
+T{
+T}@T{
+448
+T}@T{
+Ed448
+T}
+T{
+Ed25519
+T}@T{
+255
+T}@T{
+Ed25519
+T}
+T{
+Ed448
+T}@T{
+448
+T}@T{
+Ed448
+T}
+.TE
+.IP \[bu] 2
+An RSASSA\-PSS signature algorithm uses a \f[CB]MessageDigest\f[R]
+algorithm as its hash and MGF1 algorithms.
+.IP \[bu] 2
+EdDSA supports 2 key sizes: Ed25519 and Ed448.
+When generating an EdDSA key pair using \f[CB]\-keyalg\ EdDSA\f[R], a user
+can specify \f[CB]\-keysize\ 255\f[R] or \f[CB]\-keysize\ 448\f[R] to
+generate Ed25519 or Ed448 key pairs.
+When no \f[CB]\-keysize\f[R] is specified, an Ed25519 key pair is
+generated.
+A user can also directly specify \f[CB]\-keyalg\ Ed25519\f[R] or
+\f[CB]\-keyalg\ Ed448\f[R] to generate a key pair with the expected key
+size.
+.PP
+\f[B]Note:\f[R]
+.PP
+To improve out of the box security, default key size and signature
+algorithm names are periodically updated to stronger values with each
+release of the JDK.
+If interoperability with older releases of the JDK is important, make
+sure that the defaults are supported by those releases.
+Alternatively, you can use the \f[CB]\-keysize\f[R] or \f[CB]\-sigalg\f[R]
+options to override the default values at your own risk.
+.SH SUPPORTED NAMED EXTENSIONS
+.PP
+The \f[CB]keytool\f[R] command supports these named extensions.
+The names aren\[aq]t case\-sensitive.
+.TP
+.B \f[CB]BC\f[R] or \f[CB]BasicContraints\f[R]
+Values:
+.RS
+.PP
+The full form is
+\f[CB]ca:\f[R]{\f[CB]true\f[R]|\f[CB]false\f[R]}[\f[CB],pathlen:\f[R]\f[I]len\f[R]]
+or \f[I]len\f[R], which is short for
+\f[CB]ca:true,pathlen:\f[R]\f[I]len\f[R].
+.PP
+When \f[I]len\f[R] is omitted, the resulting value is \f[CB]ca:true\f[R].
+.RE
+.TP
+.B \f[CB]KU\f[R] or \f[CB]KeyUsage\f[R]
+Values:
+.RS
+.PP
+\f[I]usage\f[R](\f[CB],\f[R] \f[I]usage\f[R])*
+.PP
+\f[I]usage\f[R] can be one of the following:
+.IP \[bu] 2
+\f[CB]digitalSignature\f[R]
+.IP \[bu] 2
+\f[CB]nonRepudiation\f[R] (\f[CB]contentCommitment\f[R])
+.IP \[bu] 2
+\f[CB]keyEncipherment\f[R]
+.IP \[bu] 2
+\f[CB]dataEncipherment\f[R]
+.IP \[bu] 2
+\f[CB]keyAgreement\f[R]
+.IP \[bu] 2
+\f[CB]keyCertSign\f[R]
+.IP \[bu] 2
+\f[CB]cRLSign\f[R]
+.IP \[bu] 2
+\f[CB]encipherOnly\f[R]
+.IP \[bu] 2
+\f[CB]decipherOnly\f[R]
+.PP
+Provided there is no ambiguity, the \f[I]usage\f[R] argument can be
+abbreviated with the first few letters (such as \f[CB]dig\f[R] for
+\f[CB]digitalSignature\f[R]) or in camel\-case style (such as \f[CB]dS\f[R]
+for \f[CB]digitalSignature\f[R] or \f[CB]cRLS\f[R] for \f[CB]cRLSign\f[R]).
+The \f[I]usage\f[R] values are case\-sensitive.
+.RE
+.TP
+.B \f[CB]EKU\f[R] or \f[CB]ExtendedKeyUsage\f[R]
+Values:
+.RS
+.PP
+\f[I]usage\f[R](\f[CB],\f[R] \f[I]usage\f[R])*
+.PP
+\f[I]usage\f[R] can be one of the following:
+.IP \[bu] 2
+\f[CB]anyExtendedKeyUsage\f[R]
+.IP \[bu] 2
+\f[CB]serverAuth\f[R]
+.IP \[bu] 2
+\f[CB]clientAuth\f[R]
+.IP \[bu] 2
+\f[CB]codeSigning\f[R]
+.IP \[bu] 2
+\f[CB]emailProtection\f[R]
+.IP \[bu] 2
+\f[CB]timeStamping\f[R]
+.IP \[bu] 2
+\f[CB]OCSPSigning\f[R]
+.IP \[bu] 2
+Any OID string
+.PP
+Provided there is no ambiguity, the \f[I]usage\f[R] argument can be
+abbreviated with the first few letters or in camel\-case style.
+The \f[I]usage\f[R] values are case\-sensitive.
+.RE
+.TP
+.B \f[CB]SAN\f[R] or \f[CB]SubjectAlternativeName\f[R]
+Values:
+.RS
+.PP
+\f[I]type\f[R]\f[CB]:\f[R]\f[I]value\f[R](\f[CB],\f[R]
+\f[I]type\f[R]\f[CB]:\f[R]\f[I]value\f[R])*
+.PP
+\f[I]type\f[R] can be one of the following:
+.IP \[bu] 2
+\f[CB]EMAIL\f[R]
+.IP \[bu] 2
+\f[CB]URI\f[R]
+.IP \[bu] 2
+\f[CB]DNS\f[R]
+.IP \[bu] 2
+\f[CB]IP\f[R]
+.IP \[bu] 2
+\f[CB]OID\f[R]
+.PP
+The \f[I]value\f[R] argument is the string format value for the
+\f[I]type\f[R].
+.RE
+.TP
+.B \f[CB]IAN\f[R] or \f[CB]IssuerAlternativeName\f[R]
+Values:
+.RS
+.PP
+Same as \f[CB]SAN\f[R] or \f[CB]SubjectAlternativeName\f[R].
+.RE
+.TP
+.B \f[CB]SIA\f[R] or \f[CB]SubjectInfoAccess\f[R]
+Values:
+.RS
+.PP
+\f[I]method\f[R]\f[CB]:\f[R]\f[I]location\-type\f[R]\f[CB]:\f[R]\f[I]location\-value\f[R](\f[CB],\f[R]
+\f[I]method\f[R]\f[CB]:\f[R]\f[I]location\-type\f[R]\f[CB]:\f[R]\f[I]location\-value\f[R])*
+.PP
+\f[I]method\f[R] can be one of the following:
+.IP \[bu] 2
+\f[CB]timeStamping\f[R]
+.IP \[bu] 2
+\f[CB]caRepository\f[R]
+.IP \[bu] 2
+Any OID
+.PP
+The \f[I]location\-type\f[R] and \f[I]location\-value\f[R] arguments can
+be any \f[I]type\f[R]\f[CB]:\f[R]\f[I]value\f[R] supported by the
+\f[CB]SubjectAlternativeName\f[R] extension.
+.RE
+.TP
+.B \f[CB]AIA\f[R] or \f[CB]AuthorityInfoAccess\f[R]
+Values:
+.RS
+.PP
+Same as \f[CB]SIA\f[R] or \f[CB]SubjectInfoAccess\f[R].
+.PP
+The \f[I]method\f[R] argument can be one of the following:
+.IP \[bu] 2
+\f[CB]ocsp\f[R]
+.IP \[bu] 2
+\f[CB]caIssuers\f[R]
+.IP \[bu] 2
+Any OID
+.RE
+.PP
+When \f[I]name\f[R] is OID, the value is the hexadecimal dumped Definite
+Encoding Rules (DER) encoding of the \f[CB]extnValue\f[R] for the
+extension excluding the OCTET STRING type and length bytes.
+Other than standard hexadecimal numbers (0\-9, a\-f, A\-F), any extra
+characters are ignored in the HEX string.
+Therefore, both 01:02:03:04 and 01020304 are accepted as identical
+values.
+When there is no value, the extension has an empty value field.
+.PP
+A special name \f[CB]honored\f[R], used only in \f[CB]\-gencert\f[R],
+denotes how the extensions included in the certificate request should be
+honored.
+The value for this name is a comma\-separated list of \f[CB]all\f[R] (all
+requested extensions are honored),
+\f[I]name\f[R]{\f[CB]:\f[R][\f[CB]critical\f[R]|\f[CB]non\-critical\f[R]]} (the
+named extension is honored, but it uses a different \f[CB]isCritical\f[R]
+attribute), and \f[CB]\-name\f[R] (used with \f[CB]all\f[R], denotes an
+exception).
+Requested extensions aren\[aq]t honored by default.
+.PP
+If, besides the\f[CB]\-ext\ honored\f[R] option, another named or OID
+\f[CB]\-ext\f[R] option is provided, this extension is added to those
+already honored.
+However, if this name (or OID) also appears in the honored value, then
+its value and criticality override that in the request.
+If an extension of the same type is provided multiple times through
+either a name or an OID, only the last extension is used.
+.PP
+The \f[CB]subjectKeyIdentifier\f[R] extension is always created.
+For non\-self\-signed certificates, the \f[CB]authorityKeyIdentifier\f[R]
+is created.
+.PP
+\f[B]CAUTION:\f[R]
+.PP
+Users should be aware that some combinations of extensions (and other
+certificate fields) may not conform to the Internet standard.
+See \f[B]Certificate Conformance Warning\f[R].
+.SH EXAMPLES OF TASKS IN CREATING A KEYSTORE
+.PP
+The following examples describe the sequence actions in creating a
+keystore for managing public/private key pairs and certificates from
+trusted entities.
+.IP \[bu] 2
+\f[B]Generating the Key Pair\f[R]
+.IP \[bu] 2
+\f[B]Requesting a Signed Certificate from a CA\f[R]
+.IP \[bu] 2
+\f[B]Importing a Certificate for the CA\f[R]
+.IP \[bu] 2
+\f[B]Importing the Certificate Reply from the CA\f[R]
+.IP \[bu] 2
+\f[B]Exporting a Certificate That Authenticates the Public Key\f[R]
+.IP \[bu] 2
+\f[B]Importing the Keystore\f[R]
+.IP \[bu] 2
+\f[B]Generating Certificates for an SSL Server\f[R]
+.SH GENERATING THE KEY PAIR
+.PP
+Create a keystore and then generate the key pair.
+.PP
+You can enter the command as a single line such as the following:
+.RS
+.PP
+\f[CB]keytool\ \-genkeypair\ \-dname\ "cn=myname,\ ou=mygroup,\ o=mycompany,\ c=mycountry"\ \-alias\ business\ \-keyalg\ rsa\ \-keypass\f[R]
+\f[I]password\f[R]
+\f[CB]\-keystore\ /working/mykeystore\ \-storepass\ password\ \-validity\ 180\f[R]
+.RE
+.PP
+The command creates the keystore named \f[CB]mykeystore\f[R] in the
+working directory (provided it doesn\[aq]t already exist), and assigns
+it the password specified by \f[CB]\-keypass\f[R].
+It generates a public/private key pair for the entity whose
+distinguished name is \f[CB]myname\f[R], \f[CB]mygroup\f[R],
+\f[CB]mycompany\f[R], and a two\-letter country code of
+\f[CB]mycountry\f[R].
+It uses the RSA key generation algorithm to create the keys; both are
+2048 bits
+.PP
+The command uses the default SHA256withRSA signature algorithm to create
+a self\-signed certificate that includes the public key and the
+distinguished name information.
+The certificate is valid for 180 days, and is associated with the
+private key in a keystore entry referred to by
+\f[CB]\-alias\ business\f[R].
+The private key is assigned the password specified by
+\f[CB]\-keypass\f[R].
+.PP
+The command is significantly shorter when the option defaults are
+accepted.
+In this case, only \f[CB]\-keyalg\f[R] is required, and the defaults are
+used for unspecified options that have default values.
+You are prompted for any required values.
+You could have the following:
+.RS
+.PP
+\f[CB]keytool\ \-genkeypair\ \-keyalg\ rsa\f[R]
+.RE
+.PP
+In this case, a keystore entry with the alias \f[CB]mykey\f[R] is created,
+with a newly generated key pair and a certificate that is valid for 90
+days.
+This entry is placed in your home directory in a keystore named
+\f[CB]\&.keystore\f[R] .
+\f[CB]\&.keystore\f[R] is created if it doesn\[aq]t already exist.
+You are prompted for the distinguished name information, the keystore
+password, and the private key password.
+.PP
+\f[B]Note:\f[R]
+.PP
+The rest of the examples assume that you responded to the prompts with
+values equal to those specified in the first \f[CB]\-genkeypair\f[R]
+command.
+For example, a distinguished name of
+\f[CB]cn=\f[R]\f[I]myname\f[R]\f[CB],\ ou=\f[R]\f[I]mygroup\f[R]\f[CB],\ o=\f[R]\f[I]mycompany\f[R]\f[CB],\ c=\f[R]\f[I]mycountry\f[R]).
+.SH REQUESTING A SIGNED CERTIFICATE FROM A CA
+.PP
+\f[B]Note:\f[R]
+.PP
+Generating the key pair created a self\-signed certificate; however, a
+certificate is more likely to be trusted by others when it is signed by
+a CA.
+.PP
+To get a CA signature, complete the following process:
+.IP "1." 3
+Generate a CSR:
+.RS 4
+.RS
+.PP
+\f[CB]keytool\ \-certreq\ \-file\ myname.csr\f[R]
+.RE
+.PP
+This creates a CSR for the entity identified by the default alias
+\f[CB]mykey\f[R] and puts the request in the file named
+\f[CB]myname.csr\f[R].
+.RE
+.IP "2." 3
+Submit \f[CB]myname.csr\f[R] to a CA, such as DigiCert.
+.PP
+The CA authenticates you, the requestor (usually offline), and returns a
+certificate, signed by them, authenticating your public key.
+In some cases, the CA returns a chain of certificates, each one
+authenticating the public key of the signer of the previous certificate
+in the chain.
+.SH IMPORTING A CERTIFICATE FOR THE CA
+.PP
+To import a certificate for the CA, complete the following process:
+.IP "1." 3
+Before you import the certificate reply from a CA, you need one or more
+trusted certificates either in your keystore or in the \f[CB]cacerts\f[R]
+keystore file.
+See \f[CB]\-importcert\f[R] in \f[B]Commands\f[R].
+.RS 4
+.IP \[bu] 2
+If the certificate reply is a certificate chain, then you need the top
+certificate of the chain.
+The root CA certificate that authenticates the public key of the CA.
+.IP \[bu] 2
+If the certificate reply is a single certificate, then you need a
+certificate for the issuing CA (the one that signed it).
+If that certificate isn\[aq]t self\-signed, then you need a certificate
+for its signer, and so on, up to a self\-signed root CA certificate.
+.PP
+The \f[CB]cacerts\f[R] keystore ships with a set of root certificates
+issued by the CAs of \f[B]the Oracle Java Root Certificate program\f[R]
+[http://www.oracle.com/technetwork/java/javase/javasecarootcertsprogram\-1876540.html].
+If you request a signed certificate from a CA, and a certificate
+authenticating that CA\[aq]s public key hasn\[aq]t been added to
+\f[CB]cacerts\f[R], then you must import a certificate from that CA as a
+trusted certificate.
+.PP
+A certificate from a CA is usually self\-signed or signed by another CA.
+If it is signed by another CA, you need a certificate that authenticates
+that CA\[aq]s public key.
+.PP
+For example, you have obtained a \f[I]X\f[R]\f[CB]\&.cer\f[R] file from a
+company that is a CA and the file is supposed to be a self\-signed
+certificate that authenticates that CA\[aq]s public key.
+Before you import it as a trusted certificate, you should ensure that
+the certificate is valid by:
+.IP "1." 3
+Viewing it with the \f[CB]keytool\ \-printcert\f[R] command or the
+\f[CB]keytool\ \-importcert\f[R] command without using the
+\f[CB]\-noprompt\f[R] option.
+Make sure that the displayed certificate fingerprints match the expected
+fingerprints.
+.IP "2." 3
+Calling the person who sent the certificate, and comparing the
+fingerprints that you see with the ones that they show or that a secure
+public key repository shows.
+.PP
+Only when the fingerprints are equal is it assured that the certificate
+wasn\[aq]t replaced in transit with somebody else\[aq]s certificate
+(such as an attacker\[aq]s certificate).
+If such an attack takes place, and you didn\[aq]t check the certificate
+before you imported it, then you would be trusting anything that the
+attacker signed.
+.RE
+.IP "2." 3
+Replace the self\-signed certificate with a certificate chain, where
+each certificate in the chain authenticates the public key of the signer
+of the previous certificate in the chain, up to a root CA.
+.RS 4
+.PP
+If you trust that the certificate is valid, then you can add it to your
+keystore by entering the following command:
+.RS
+.PP
+\f[CB]keytool\ \-importcert\ \-alias\f[R] \f[I]alias\f[R]
+\f[CB]\-file\ *X*\f[R].cer`
+.RE
+.PP
+This command creates a trusted certificate entry in the keystore from
+the data in the CA certificate file and assigns the values of the
+\f[I]alias\f[R] to the entry.
+.RE
+.SH IMPORTING THE CERTIFICATE REPLY FROM THE CA
+.PP
+After you import a certificate that authenticates the public key of the
+CA that you submitted your certificate signing request to (or there is
+already such a certificate in the \f[CB]cacerts\f[R] file), you can import
+the certificate reply and replace your self\-signed certificate with a
+certificate chain.
+.PP
+The certificate chain is one of the following:
+.IP \[bu] 2
+Returned by the CA when the CA reply is a chain.
+.IP \[bu] 2
+Constructed when the CA reply is a single certificate.
+This certificate chain is constructed by using the certificate reply and
+trusted certificates available either in the keystore where you import
+the reply or in the \f[CB]cacerts\f[R] keystore file.
+.PP
+For example, if you sent your certificate signing request to DigiCert,
+then you can import their reply by entering the following command:
+.PP
+\f[B]Note:\f[R]
+.PP
+In this example, the returned certificate is named
+\f[CB]DCmyname.cer\f[R].
+.RS
+.PP
+\f[CB]keytool\ \-importcert\ \-trustcacerts\ \-file\ DCmyname.cer\f[R]
+.RE
+.SH EXPORTING A CERTIFICATE THAT AUTHENTICATES THE PUBLIC KEY
+.PP
+\f[B]Note:\f[R]
+.PP
+If you used the \f[CB]jarsigner\f[R] command to sign a Java Archive (JAR)
+file, then clients that use the file will want to authenticate your
+signature.
+.PP
+One way that clients can authenticate you is by importing your public
+key certificate into their keystore as a trusted entry.
+You can then export the certificate and supply it to your clients.
+.PP
+For example:
+.IP "1." 3
+Copy your certificate to a file named \f[CB]myname.cer\f[R] by entering
+the following command:
+.RS 4
+.PP
+\f[B]Note:\f[R]
+.PP
+In this example, the entry has an alias of \f[CB]mykey\f[R].
+.RS
+.PP
+\f[CB]keytool\ \-exportcert\ \-alias\ mykey\ \-file\ myname.cer\f[R]
+.RE
+.RE
+.IP "2." 3
+With the certificate and the signed JAR file, a client can use the
+\f[CB]jarsigner\f[R] command to authenticate your signature.
+.SH IMPORTING THE KEYSTORE
+.PP
+Use the \f[CB]importkeystore\f[R] command to import an entire keystore
+into another keystore.
+This imports all entries from the source keystore, including keys and
+certificates, to the destination keystore with a single command.
+You can use this command to import entries from a different type of
+keystore.
+During the import, all new entries in the destination keystore will have
+the same alias names and protection passwords (for secret keys and
+private keys).
+If the \f[CB]keytool\f[R] command can\[aq]t recover the private keys or
+secret keys from the source keystore, then it prompts you for a
+password.
+If it detects alias duplication, then it asks you for a new alias, and
+you can specify a new alias or simply allow the \f[CB]keytool\f[R] command
+to overwrite the existing one.
+.PP
+For example, import entries from a typical JKS type keystore
+\f[CB]key.jks\f[R] into a PKCS #11 type hardware\-based keystore, by
+entering the following command:
+.RS
+.PP
+\f[CB]keytool\ \-importkeystore\ \-srckeystore\ key.jks\ \-destkeystore\ NONE\ \-srcstoretype\ JKS\ \-deststoretype\ PKCS11\ \-srcstorepass\f[R]
+\f[I]password\f[R] \f[CB]\-deststorepass\f[R] \f[I]password\f[R]
+.RE
+.PP
+The \f[CB]importkeystore\f[R] command can also be used to import a single
+entry from a source keystore to a destination keystore.
+In this case, besides the options you used in the previous example, you
+need to specify the alias you want to import.
+With the \f[CB]\-srcalias\f[R] option specified, you can also specify the
+destination alias name, protection password for a secret or private key,
+and the destination protection password you want as follows:
+.RS
+.PP
+\f[CB]keytool\ \-importkeystore\ \-srckeystore\ key.jks\ \-destkeystore\ NONE\ \-srcstoretype\ JKS\ \-deststoretype\ PKCS11\ \-srcstorepass\f[R]
+\f[I]password\f[R] \f[CB]\-deststorepass\f[R] \f[I]password\f[R]
+\f[CB]\-srcalias\ myprivatekey\ \-destalias\ myoldprivatekey\ \-srckeypass\f[R]
+\f[I]password\f[R] \f[CB]\-destkeypass\f[R] \f[I]password\f[R]
+\f[CB]\-noprompt\f[R]
+.RE
+.SH GENERATING CERTIFICATES FOR AN SSL SERVER
+.PP
+The following are \f[CB]keytool\f[R] commands used to generate key pairs
+and certificates for three entities:
+.IP \[bu] 2
+Root CA (\f[CB]root\f[R])
+.IP \[bu] 2
+Intermediate CA (\f[CB]ca\f[R])
+.IP \[bu] 2
+SSL server (\f[CB]server\f[R])
+.PP
+Ensure that you store all the certificates in the same keystore.
+.IP
+.nf
+\f[CB]
+keytool\ \-genkeypair\ \-keystore\ root.jks\ \-alias\ root\ \-ext\ bc:c\ \-keyalg\ rsa
+keytool\ \-genkeypair\ \-keystore\ ca.jks\ \-alias\ ca\ \-ext\ bc:c\ \-keyalg\ rsa
+keytool\ \-genkeypair\ \-keystore\ server.jks\ \-alias\ server\ \-keyalg\ rsa
+
+keytool\ \-keystore\ root.jks\ \-alias\ root\ \-exportcert\ \-rfc\ >\ root.pem
+
+keytool\ \-storepass\ password\ \-keystore\ ca.jks\ \-certreq\ \-alias\ ca\ |
+\ \ \ \ keytool\ \-storepass\ password\ \-keystore\ root.jks
+\ \ \ \ \-gencert\ \-alias\ root\ \-ext\ BC=0\ \-rfc\ >\ ca.pem
+keytool\ \-keystore\ ca.jks\ \-importcert\ \-alias\ ca\ \-file\ ca.pem
+
+keytool\ \-storepass\ password\ \-keystore\ server.jks\ \-certreq\ \-alias\ server\ |
+\ \ \ \ keytool\ \-storepass\ password\ \-keystore\ ca.jks\ \-gencert\ \-alias\ ca
+\ \ \ \ \-ext\ ku:c=dig,kE\ \-rfc\ >\ server.pem
+cat\ root.pem\ ca.pem\ server.pem\ |
+\ \ \ \ keytool\ \-keystore\ server.jks\ \-importcert\ \-alias\ server
+\f[R]
+.fi
+.SH TERMS
+.TP
+.B Keystore
+A keystore is a storage facility for cryptographic keys and
+certificates.
+.RS
+.RE
+.TP
+.B Keystore entries
+Keystores can have different types of entries.
+The two most applicable entry types for the \f[CB]keytool\f[R] command
+include the following:
+.RS
+.PP
+Key entries: Each entry holds very sensitive cryptographic key
+information, which is stored in a protected format to prevent
+unauthorized access.
+Typically, a key stored in this type of entry is a secret key, or a
+private key accompanied by the certificate chain for the corresponding
+public key.
+See \f[B]Certificate Chains\f[R].
+The \f[CB]keytool\f[R] command can handle both types of entries, while the
+\f[CB]jarsigner\f[R] tool only handles the latter type of entry, that is
+private keys and their associated certificate chains.
+.PP
+Trusted certificate entries: Each entry contains a single public key
+certificate that belongs to another party.
+The entry is called a trusted certificate because the keystore owner
+trusts that the public key in the certificate belongs to the identity
+identified by the subject (owner) of the certificate.
+The issuer of the certificate vouches for this, by signing the
+certificate.
+.RE
+.TP
+.B Keystore aliases
+All keystore entries (key and trusted certificate entries) are accessed
+by way of unique aliases.
+.RS
+.PP
+An alias is specified when you add an entity to the keystore with the
+\f[CB]\-genseckey\f[R] command to generate a secret key, the
+\f[CB]\-genkeypair\f[R] command to generate a key pair (public and private
+key), or the \f[CB]\-importcert\f[R] command to add a certificate or
+certificate chain to the list of trusted certificates.
+Subsequent \f[CB]keytool\f[R] commands must use this same alias to refer
+to the entity.
+.PP
+For example, you can use the alias \f[CB]duke\f[R] to generate a new
+public/private key pair and wrap the public key into a self\-signed
+certificate with the following command.
+See \f[B]Certificate Chains\f[R].
+.RS
+.PP
+\f[CB]keytool\ \-genkeypair\ \-alias\ duke\ \-keyalg\ rsa\ \-keypass\f[R]
+\f[I]passwd\f[R]
+.RE
+.PP
+This example specifies an initial \f[I]passwd\f[R] required by subsequent
+commands to access the private key associated with the alias
+\f[CB]duke\f[R].
+If you later want to change Duke\[aq]s private key password, use a
+command such as the following:
+.RS
+.PP
+\f[CB]keytool\ \-keypasswd\ \-alias\ duke\ \-keypass\f[R] \f[I]passwd\f[R]
+\f[CB]\-new\f[R] \f[I]newpasswd\f[R]
+.RE
+.PP
+This changes the initial \f[I]passwd\f[R] to \f[I]newpasswd\f[R].
+A password shouldn\[aq]t be specified on a command line or in a script
+unless it is for testing purposes, or you are on a secure system.
+If you don\[aq]t specify a required password option on a command line,
+then you are prompted for it.
+.RE
+.TP
+.B Keystore implementation
+The \f[CB]KeyStore\f[R] class provided in the \f[CB]java.security\f[R]
+package supplies well\-defined interfaces to access and modify the
+information in a keystore.
+It is possible for there to be multiple different concrete
+implementations, where each implementation is that for a particular type
+of keystore.
+.RS
+.PP
+Currently, two command\-line tools (\f[CB]keytool\f[R] and
+\f[CB]jarsigner\f[R]) make use of keystore implementations.
+Because the \f[CB]KeyStore\f[R] class is \f[CB]public\f[R], users can write
+additional security applications that use it.
+.PP
+In JDK 9 and later, the default keystore implementation is
+\f[CB]PKCS12\f[R].
+This is a cross platform keystore based on the RSA PKCS12 Personal
+Information Exchange Syntax Standard.
+This standard is primarily meant for storing or transporting a
+user\[aq]s private keys, certificates, and miscellaneous secrets.
+There is another built\-in implementation, provided by Oracle.
+It implements the keystore as a file with a proprietary keystore type
+(format) named \f[CB]JKS\f[R].
+It protects each private key with its individual password, and also
+protects the integrity of the entire keystore with a (possibly
+different) password.
+.PP
+Keystore implementations are provider\-based.
+More specifically, the application interfaces supplied by
+\f[CB]KeyStore\f[R] are implemented in terms of a Service Provider
+Interface (SPI).
+That is, there is a corresponding abstract \f[CB]KeystoreSpi\f[R] class,
+also in the \f[CB]java.security\ package\f[R], which defines the Service
+Provider Interface methods that providers must implement.
+The term \f[I]provider\f[R] refers to a package or a set of packages that
+supply a concrete implementation of a subset of services that can be
+accessed by the Java Security API.
+To provide a keystore implementation, clients must implement a provider
+and supply a \f[CB]KeystoreSpi\f[R] subclass implementation, as described
+in Steps to Implement and Integrate a Provider.
+.PP
+Applications can choose different types of keystore implementations from
+different providers, using the \f[CB]getInstance\f[R] factory method
+supplied in the \f[CB]KeyStore\f[R] class.
+A keystore type defines the storage and data format of the keystore
+information, and the algorithms used to protect private/secret keys in
+the keystore and the integrity of the keystore.
+Keystore implementations of different types aren\[aq]t compatible.
+.PP
+The \f[CB]keytool\f[R] command works on any file\-based keystore
+implementation.
+It treats the keystore location that is passed to it at the command line
+as a file name and converts it to a \f[CB]FileInputStream\f[R], from which
+it loads the keystore information.)The \f[CB]jarsigner\f[R] commands can
+read a keystore from any location that can be specified with a URL.
+.PP
+For \f[CB]keytool\f[R] and \f[CB]jarsigner\f[R], you can specify a keystore
+type at the command line, with the \f[CB]\-storetype\f[R] option.
+.PP
+If you don\[aq]t explicitly specify a keystore type, then the tools
+choose a keystore implementation based on the value of the
+\f[CB]keystore.type\f[R] property specified in the security properties
+file.
+The security properties file is called \f[CB]java.security\f[R], and
+resides in the security properties directory:
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R] \f[CB]java.home/lib/security\f[R]
+.IP \[bu] 2
+\f[B]Windows:\f[R] \f[CB]java.home\\lib\\security\f[R]
+.PP
+Each tool gets the \f[CB]keystore.type\f[R] value and then examines all
+the currently installed providers until it finds one that implements a
+keystores of that type.
+It then uses the keystore implementation from that provider.The
+\f[CB]KeyStore\f[R] class defines a static method named
+\f[CB]getDefaultType\f[R] that lets applications retrieve the value of the
+\f[CB]keystore.type\f[R] property.
+The following line of code creates an instance of the default keystore
+type as specified in the \f[CB]keystore.type\f[R] property:
+.RS
+.PP
+\f[CB]KeyStore\ keyStore\ =\ KeyStore.getInstance(KeyStore.getDefaultType());\f[R]
+.RE
+.PP
+The default keystore type is \f[CB]pkcs12\f[R], which is a cross\-platform
+keystore based on the RSA PKCS12 Personal Information Exchange Syntax
+Standard.
+This is specified by the following line in the security properties file:
+.RS
+.PP
+\f[CB]keystore.type=pkcs12\f[R]
+.RE
+.PP
+To have the tools utilize a keystore implementation other than the
+default, you can change that line to specify a different keystore type.
+For example, if you want to use the Oracle\[aq]s \f[CB]jks\f[R] keystore
+implementation, then change the line to the following:
+.RS
+.PP
+\f[CB]keystore.type=jks\f[R]
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+Case doesn\[aq]t matter in keystore type designations.
+For example, \f[CB]JKS\f[R] would be considered the same as \f[CB]jks\f[R].
+.RE
+.TP
+.B Certificate
+A certificate (or public\-key certificate) is a digitally signed
+statement from one entity (the issuer), saying that the public key and
+some other information of another entity (the subject) has some specific
+value.
+The following terms are related to certificates:
+.RS
+.IP \[bu] 2
+Public Keys: These are numbers associated with a particular entity, and
+are intended to be known to everyone who needs to have trusted
+interactions with that entity.
+Public keys are used to verify signatures.
+.IP \[bu] 2
+Digitally Signed: If some data is digitally signed, then it is stored
+with the identity of an entity and a signature that proves that entity
+knows about the data.
+The data is rendered unforgeable by signing with the entity\[aq]s
+private key.
+.IP \[bu] 2
+Identity: A known way of addressing an entity.
+In some systems, the identity is the public key, and in others it can be
+anything from an Oracle Solaris UID to an email address to an X.509
+distinguished name.
+.IP \[bu] 2
+Signature: A signature is computed over some data using the private key
+of an entity.
+The signer, which in the case of a certificate is also known as the
+issuer.
+.IP \[bu] 2
+Private Keys: These are numbers, each of which is supposed to be known
+only to the particular entity whose private key it is (that is, it is
+supposed to be kept secret).
+Private and public keys exist in pairs in all public key cryptography
+systems (also referred to as public key crypto systems).
+In a typical public key crypto system, such as DSA, a private key
+corresponds to exactly one public key.
+Private keys are used to compute signatures.
+.IP \[bu] 2
+Entity: An entity is a person, organization, program, computer,
+business, bank, or something else you are trusting to some degree.
+.PP
+Public key cryptography requires access to users\[aq] public keys.
+In a large\-scale networked environment, it is impossible to guarantee
+that prior relationships between communicating entities were established
+or that a trusted repository exists with all used public keys.
+Certificates were invented as a solution to this public key distribution
+problem.
+Now a Certification Authority (CA) can act as a trusted third party.
+CAs are entities such as businesses that are trusted to sign (issue)
+certificates for other entities.
+It is assumed that CAs only create valid and reliable certificates
+because they are bound by legal agreements.
+There are many public Certification Authorities, such as DigiCert,
+Comodo, Entrust, and so on.
+.PP
+You can also run your own Certification Authority using products such as
+Microsoft Certificate Server or the Entrust CA product for your
+organization.
+With the \f[CB]keytool\f[R] command, it is possible to display, import,
+and export certificates.
+It is also possible to generate self\-signed certificates.
+.PP
+The \f[CB]keytool\f[R] command currently handles X.509 certificates.
+.RE
+.TP
+.B X.509 Certificates
+The X.509 standard defines what information can go into a certificate
+and describes how to write it down (the data format).
+All the data in a certificate is encoded with two related standards
+called ASN.1/DER.
+Abstract Syntax Notation 1 describes data.
+The Definite Encoding Rules describe a single way to store and transfer
+that data.
+.RS
+.PP
+All X.509 certificates have the following data, in addition to the
+signature:
+.IP \[bu] 2
+Version: This identifies which version of the X.509 standard applies to
+this certificate, which affects what information can be specified in it.
+Thus far, three versions are defined.
+The \f[CB]keytool\f[R] command can import and export v1, v2, and v3
+certificates.
+It generates v3 certificates.
+.RS 2
+.IP \[bu] 2
+X.509 Version 1 has been available since 1988, is widely deployed, and
+is the most generic.
+.IP \[bu] 2
+X.509 Version 2 introduced the concept of subject and issuer unique
+identifiers to handle the possibility of reuse of subject or issuer
+names over time.
+Most certificate profile documents strongly recommend that names not be
+reused and that certificates shouldn\[aq]t make use of unique
+identifiers.
+Version 2 certificates aren\[aq]t widely used.
+.IP \[bu] 2
+X.509 Version 3 is the most recent (1996) and supports the notion of
+extensions where anyone can define an extension and include it in the
+certificate.
+Some common extensions are: KeyUsage (limits the use of the keys to
+particular purposes such as \f[CB]signing\-only\f[R]) and AlternativeNames
+(allows other identities to also be associated with this public key, for
+example.
+DNS names, email addresses, IP addresses).
+Extensions can be marked critical to indicate that the extension should
+be checked and enforced or used.
+For example, if a certificate has the KeyUsage extension marked critical
+and set to \f[CB]keyCertSign\f[R], then when this certificate is presented
+during SSL communication, it should be rejected because the certificate
+extension indicates that the associated private key should only be used
+for signing certificates and not for SSL use.
+.RE
+.IP \[bu] 2
+Serial number: The entity that created the certificate is responsible
+for assigning it a serial number to distinguish it from other
+certificates it issues.
+This information is used in numerous ways.
+For example, when a certificate is revoked its serial number is placed
+in a Certificate Revocation List (CRL).
+.IP \[bu] 2
+Signature algorithm identifier: This identifies the algorithm used by
+the CA to sign the certificate.
+.IP \[bu] 2
+Issuer name: The X.500 Distinguished Name of the entity that signed the
+certificate.
+This is typically a CA.
+Using this certificate implies trusting the entity that signed this
+certificate.
+In some cases, such as root or top\-level CA certificates, the issuer
+signs its own certificate.
+.IP \[bu] 2
+Validity period: Each certificate is valid only for a limited amount of
+time.
+This period is described by a start date and time and an end date and
+time, and can be as short as a few seconds or almost as long as a
+century.
+The validity period chosen depends on a number of factors, such as the
+strength of the private key used to sign the certificate, or the amount
+one is willing to pay for a certificate.
+This is the expected period that entities can rely on the public value,
+when the associated private key has not been compromised.
+.IP \[bu] 2
+Subject name: The name of the entity whose public key the certificate
+identifies.
+This name uses the X.500 standard, so it is intended to be unique across
+the Internet.
+This is the X.500 Distinguished Name (DN) of the entity.
+For example,
+.RS 2
+.RS
+.PP
+\f[CB]CN=Java\ Duke,\ OU=Java\ Software\ Division,\ O=Oracle\ Corporation,\ C=US\f[R]
+.RE
+.PP
+These refer to the subject\[aq]s common name (CN), organizational unit
+(OU), organization (O), and country (C).
+.RE
+.IP \[bu] 2
+Subject public key information: This is the public key of the entity
+being named with an algorithm identifier that specifies which public key
+crypto system this key belongs to and any associated key parameters.
+.RE
+.TP
+.B Certificate Chains
+The \f[CB]keytool\f[R] command can create and manage keystore key entries
+that each contain a private key and an associated certificate chain.
+The first certificate in the chain contains the public key that
+corresponds to the private key.
+.RS
+.PP
+When keys are first generated, the chain usually starts off containing a
+single element, a self\-signed certificate.
+See \-genkeypair in \f[B]Commands\f[R].
+A self\-signed certificate is one for which the issuer (signer) is the
+same as the subject.
+The subject is the entity whose public key is being authenticated by the
+certificate.
+When the \f[CB]\-genkeypair\f[R] command is called to generate a new
+public/private key pair, it also wraps the public key into a
+self\-signed certificate (unless the \f[CB]\-signer\f[R] option is
+specified).
+.PP
+Later, after a Certificate Signing Request (CSR) was generated with the
+\f[CB]\-certreq\f[R] command and sent to a Certification Authority (CA),
+the response from the CA is imported with \f[CB]\-importcert\f[R], and the
+self\-signed certificate is replaced by a chain of certificates.
+At the bottom of the chain is the certificate (reply) issued by the CA
+authenticating the subject\[aq]s public key.
+The next certificate in the chain is one that authenticates the CA\[aq]s
+public key.
+.PP
+In many cases, this is a self\-signed certificate, which is a
+certificate from the CA authenticating its own public key, and the last
+certificate in the chain.
+In other cases, the CA might return a chain of certificates.
+In this case, the bottom certificate in the chain is the same (a
+certificate signed by the CA, authenticating the public key of the key
+entry), but the second certificate in the chain is a certificate signed
+by a different CA that authenticates the public key of the CA you sent
+the CSR to.
+The next certificate in the chain is a certificate that authenticates
+the second CA\[aq]s key, and so on, until a self\-signed root
+certificate is reached.
+Each certificate in the chain (after the first) authenticates the public
+key of the signer of the previous certificate in the chain.
+.PP
+Many CAs only return the issued certificate, with no supporting chain,
+especially when there is a flat hierarchy (no intermediates CAs).
+In this case, the certificate chain must be established from trusted
+certificate information already stored in the keystore.
+.PP
+A different reply format (defined by the PKCS #7 standard) includes the
+supporting certificate chain in addition to the issued certificate.
+Both reply formats can be handled by the \f[CB]keytool\f[R] command.
+.PP
+The top\-level (root) CA certificate is self\-signed.
+However, the trust into the root\[aq]s public key doesn\[aq]t come from
+the root certificate itself, but from other sources such as a newspaper.
+This is because anybody could generate a self\-signed certificate with
+the distinguished name of, for example, the DigiCert root CA.
+The root CA public key is widely known.
+The only reason it is stored in a certificate is because this is the
+format understood by most tools, so the certificate in this case is only
+used as a vehicle to transport the root CA\[aq]s public key.
+Before you add the root CA certificate to your keystore, you should view
+it with the \f[CB]\-printcert\f[R] option and compare the displayed
+fingerprint with the well\-known fingerprint obtained from a newspaper,
+the root CA\[aq]s Web page, and so on.
+.RE
+.TP
+.B cacerts Certificates File
+A certificates file named \f[CB]cacerts\f[R] resides in the security
+properties directory:
+.RS
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R] \f[I]JAVA_HOME\f[R]\f[CB]/lib/security\f[R]
+.IP \[bu] 2
+\f[B]Windows:\f[R] \f[I]JAVA_HOME\f[R]\f[CB]\\lib\\security\f[R]
+.PP
+The \f[CB]cacerts\f[R] file represents a system\-wide keystore with CA
+certificates.
+System administrators can configure and manage that file with the
+\f[CB]keytool\f[R] command by specifying \f[CB]jks\f[R] as the keystore
+type.
+The \f[CB]cacerts\f[R] keystore file ships with a default set of root CA
+certificates.
+For Linux, OS X, and Windows, you can list the default certificates with
+the following command:
+.RS
+.PP
+\f[CB]keytool\ \-list\ \-cacerts\f[R]
+.RE
+.PP
+The initial password of the \f[CB]cacerts\f[R] keystore file is
+\f[CB]changeit\f[R].
+System administrators should change that password and the default access
+permission of that file upon installing the SDK.
+.PP
+\f[B]Note:\f[R]
+.PP
+It is important to verify your \f[CB]cacerts\f[R] file.
+Because you trust the CAs in the \f[CB]cacerts\f[R] file as entities for
+signing and issuing certificates to other entities, you must manage the
+\f[CB]cacerts\f[R] file carefully.
+The \f[CB]cacerts\f[R] file should contain only certificates of the CAs
+you trust.
+It is your responsibility to verify the trusted root CA certificates
+bundled in the \f[CB]cacerts\f[R] file and make your own trust decisions.
+.PP
+To remove an untrusted CA certificate from the \f[CB]cacerts\f[R] file,
+use the \f[CB]\-delete\f[R] option of the \f[CB]keytool\f[R] command.
+You can find the \f[CB]cacerts\f[R] file in the JDK\[aq]s
+\f[CB]$JAVA_HOME/lib/security\f[R] directory.
+Contact your system administrator if you don\[aq]t have permission to
+edit this file.
+.RE
+.TP
+.B Internet RFC 1421 Certificate Encoding Standard
+Certificates are often stored using the printable encoding format
+defined by the Internet RFC 1421 standard, instead of their binary
+encoding.
+This certificate format, also known as Base64 encoding, makes it easy to
+export certificates to other applications by email or through some other
+mechanism.
+.RS
+.PP
+Certificates read by the \f[CB]\-importcert\f[R] and \f[CB]\-printcert\f[R]
+commands can be in either this format or binary encoded.
+The \f[CB]\-exportcert\f[R] command by default outputs a certificate in
+binary encoding, but will instead output a certificate in the printable
+encoding format, when the \f[CB]\-rfc\f[R] option is specified.
+.PP
+The \f[CB]\-list\f[R] command by default prints the SHA\-256 fingerprint
+of a certificate.
+If the \f[CB]\-v\f[R] option is specified, then the certificate is printed
+in human\-readable format.
+If the \f[CB]\-rfc\f[R] option is specified, then the certificate is
+output in the printable encoding format.
+.PP
+In its printable encoding format, the encoded certificate is bounded at
+the beginning and end by the following text:
+.IP
+.nf
+\f[CB]
+\-\-\-\-\-BEGIN\ CERTIFICATE\-\-\-\-\-
+
+encoded\ certificate\ goes\ here.
+
+\-\-\-\-\-END\ CERTIFICATE\-\-\-\-\-
+\f[R]
+.fi
+.RE
+.TP
+.B X.500 Distinguished Names
+X.500 Distinguished Names are used to identify entities, such as those
+that are named by the \f[CB]subject\f[R] and \f[CB]issuer\f[R] (signer)
+fields of X.509 certificates.
+The \f[CB]keytool\f[R] command supports the following subparts:
+.RS
+.IP \[bu] 2
+commonName: The common name of a person such as Susan Jones.
+.IP \[bu] 2
+organizationUnit: The small organization (such as department or
+division) name.
+For example, Purchasing.
+.IP \[bu] 2
+localityName: The locality (city) name, for example, Palo Alto.
+.IP \[bu] 2
+stateName: State or province name, for example, California.
+.IP \[bu] 2
+country: Two\-letter country code, for example, CH.
+.PP
+When you supply a distinguished name string as the value of a
+\f[CB]\-dname\f[R] option, such as for the \f[CB]\-genkeypair\f[R] command,
+the string must be in the following format:
+.RS
+.PP
+\f[CB]CN=cName,\ OU=orgUnit,\ O=org,\ L=city,\ S=state,\ C=countryCode\f[R]
+.RE
+.PP
+All the following items represent actual values and the previous
+keywords are abbreviations for the following:
+.IP
+.nf
+\f[CB]
+CN=commonName
+OU=organizationUnit
+O=organizationName
+L=localityName
+S=stateName
+C=country
+\f[R]
+.fi
+.PP
+A sample distinguished name string is:
+.RS
+.PP
+\f[CB]CN=Mark\ Smith,\ OU=Java,\ O=Oracle,\ L=Cupertino,\ S=California,\ C=US\f[R]
+.RE
+.PP
+A sample command using such a string is:
+.RS
+.PP
+\f[CB]keytool\ \-genkeypair\ \-dname\ "CN=Mark\ Smith,\ OU=Java,\ O=Oracle,\ L=Cupertino,\ S=California,\ C=US"\ \-alias\ mark\ \-keyalg\ rsa\f[R]
+.RE
+.PP
+Case doesn\[aq]t matter for the keyword abbreviations.
+For example, CN, cn, and Cn are all treated the same.
+.PP
+Order matters; each subcomponent must appear in the designated order.
+However, it isn\[aq]t necessary to have all the subcomponents.
+You can use a subset, for example:
+.RS
+.PP
+\f[CB]CN=Smith,\ OU=Java,\ O=Oracle,\ C=US\f[R]
+.RE
+.PP
+If a distinguished name string value contains a comma, then the comma
+must be escaped by a backslash (\\) character when you specify the
+string on a command line, as in:
+.RS
+.PP
+\f[CB]cn=Jack,\ ou=Java\\,\ Product\ Development,\ o=Oracle,\ c=US\f[R]
+.RE
+.PP
+It is never necessary to specify a distinguished name string on a
+command line.
+When the distinguished name is needed for a command, but not supplied on
+the command line, the user is prompted for each of the subcomponents.
+In this case, a comma doesn\[aq]t need to be escaped by a backslash
+(\\).
+.RE
+.SH WARNINGS
+.SH IMPORTING TRUSTED CERTIFICATES WARNING
+.PP
+\f[B]Important\f[R]: Be sure to check a certificate very carefully before
+importing it as a trusted certificate.
+.PP
+\f[B]Windows Example:\f[R]
+.PP
+View the certificate first with the \f[CB]\-printcert\f[R] command or the
+\f[CB]\-importcert\f[R] command without the \f[CB]\-noprompt\f[R] option.
+Ensure that the displayed certificate fingerprints match the expected
+ones.
+For example, suppose someone sends or emails you a certificate that you
+put it in a file named \f[CB]\\tmp\\cert\f[R].
+Before you consider adding the certificate to your list of trusted
+certificates, you can execute a \f[CB]\-printcert\f[R] command to view its
+fingerprints, as follows:
+.IP
+.nf
+\f[CB]
+\ \ keytool\ \-printcert\ \-file\ \\tmp\\cert
+\ \ \ \ Owner:\ CN=ll,\ OU=ll,\ O=ll,\ L=ll,\ S=ll,\ C=ll
+\ \ \ \ Issuer:\ CN=ll,\ OU=ll,\ O=ll,\ L=ll,\ S=ll,\ C=ll
+\ \ \ \ Serial\ Number:\ 59092b34
+\ \ \ \ Valid\ from:\ Thu\ Jun\ 24\ 18:01:13\ PDT\ 2016\ until:\ Wed\ Jun\ 23\ 17:01:13\ PST\ 2016
+\ \ \ \ Certificate\ Fingerprints:
+
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ SHA\-1:\ 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ SHA\-256:\ 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4
+\f[R]
+.fi
+.PP
+\f[B]Linux Example:\f[R]
+.PP
+View the certificate first with the \f[CB]\-printcert\f[R] command or the
+\f[CB]\-importcert\f[R] command without the \f[CB]\-noprompt\f[R] option.
+Ensure that the displayed certificate fingerprints match the expected
+ones.
+For example, suppose someone sends or emails you a certificate that you
+put it in a file named \f[CB]/tmp/cert\f[R].
+Before you consider adding the certificate to your list of trusted
+certificates, you can execute a \f[CB]\-printcert\f[R] command to view its
+fingerprints, as follows:
+.IP
+.nf
+\f[CB]
+\ \ keytool\ \-printcert\ \-file\ /tmp/cert
+\ \ \ \ Owner:\ CN=ll,\ OU=ll,\ O=ll,\ L=ll,\ S=ll,\ C=ll
+\ \ \ \ Issuer:\ CN=ll,\ OU=ll,\ O=ll,\ L=ll,\ S=ll,\ C=ll
+\ \ \ \ Serial\ Number:\ 59092b34
+\ \ \ \ Valid\ from:\ Thu\ Jun\ 24\ 18:01:13\ PDT\ 2016\ until:\ Wed\ Jun\ 23\ 17:01:13\ PST\ 2016
+\ \ \ \ Certificate\ Fingerprints:
+
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ SHA\-1:\ 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ SHA\-256:\ 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4
+\f[R]
+.fi
+.PP
+Then call or otherwise contact the person who sent the certificate and
+compare the fingerprints that you see with the ones that they show.
+Only when the fingerprints are equal is it guaranteed that the
+certificate wasn\[aq]t replaced in transit with somebody else\[aq]s
+certificate such as an attacker\[aq]s certificate.
+If such an attack took place, and you didn\[aq]t check the certificate
+before you imported it, then you would be trusting anything the attacker
+signed, for example, a JAR file with malicious class files inside.
+.PP
+\f[B]Note:\f[R]
+.PP
+It isn\[aq]t required that you execute a \f[CB]\-printcert\f[R] command
+before importing a certificate.
+This is because before you add a certificate to the list of trusted
+certificates in the keystore, the \f[CB]\-importcert\f[R] command prints
+out the certificate information and prompts you to verify it.
+You can then stop the import operation.
+However, you can do this only when you call the \f[CB]\-importcert\f[R]
+command without the \f[CB]\-noprompt\f[R] option.
+If the \f[CB]\-noprompt\f[R] option is specified, then there is no
+interaction with the user.
+.SH PASSWORDS WARNING
+.PP
+Most commands that operate on a keystore require the store password.
+Some commands require a private/secret key password.
+Passwords can be specified on the command line in the
+\f[CB]\-storepass\f[R] and \f[CB]\-keypass\f[R] options.
+However, a password shouldn\[aq]t be specified on a command line or in a
+script unless it is for testing, or you are on a secure system.
+When you don\[aq]t specify a required password option on a command line,
+you are prompted for it.
+.SH CERTIFICATE CONFORMANCE WARNING
+.PP
+\f[B]Internet X.509 Public Key Infrastructure Certificate and
+Certificate Revocation List (CRL) Profile\f[R]
+[https://tools.ietf.org/rfc/rfc5280.txt] defined a profile on conforming
+X.509 certificates, which includes what values and value combinations
+are valid for certificate fields and extensions.
+.PP
+The \f[CB]keytool\f[R] command doesn\[aq]t enforce all of these rules so
+it can generate certificates that don\[aq]t conform to the standard,
+such as self\-signed certificates that would be used for internal
+testing purposes.
+Certificates that don\[aq]t conform to the standard might be rejected by
+the JDK or other applications.
+Users should ensure that they provide the correct options for
+\f[CB]\-dname\f[R], \f[CB]\-ext\f[R], and so on.
+.SH IMPORT A NEW TRUSTED CERTIFICATE
+.PP
+Before you add the certificate to the keystore, the \f[CB]keytool\f[R]
+command verifies it by attempting to construct a chain of trust from
+that certificate to a self\-signed certificate (belonging to a root CA),
+using trusted certificates that are already available in the keystore.
+.PP
+If the \f[CB]\-trustcacerts\f[R] option was specified, then additional
+certificates are considered for the chain of trust, namely the
+certificates in a file named \f[CB]cacerts\f[R].
+.PP
+If the \f[CB]keytool\f[R] command fails to establish a trust path from the
+certificate to be imported up to a self\-signed certificate (either from
+the keystore or the \f[CB]cacerts\f[R] file), then the certificate
+information is printed, and the user is prompted to verify it by
+comparing the displayed certificate fingerprints with the fingerprints
+obtained from some other (trusted) source of information, which might be
+the certificate owner.
+Be very careful to ensure the certificate is valid before importing it
+as a trusted certificate.
+The user then has the option of stopping the import operation.
+If the \f[CB]\-noprompt\f[R] option is specified, then there is no
+interaction with the user.
+.SH IMPORT A CERTIFICATE REPLY
+.PP
+When you import a certificate reply, the certificate reply is validated
+with trusted certificates from the keystore, and optionally, the
+certificates configured in the \f[CB]cacerts\f[R] keystore file when the
+\f[CB]\-trustcacerts\f[R] option is specified.
+.PP
+The methods of determining whether the certificate reply is trusted are
+as follows:
+.IP \[bu] 2
+If the reply is a single X.509 certificate, then the \f[CB]keytool\f[R]
+command attempts to establish a trust chain, starting at the certificate
+reply and ending at a self\-signed certificate (belonging to a root CA).
+The certificate reply and the hierarchy of certificates is used to
+authenticate the certificate reply from the new certificate chain of
+aliases.
+If a trust chain can\[aq]t be established, then the certificate reply
+isn\[aq]t imported.
+In this case, the \f[CB]keytool\f[R] command doesn\[aq]t print the
+certificate and prompt the user to verify it, because it is very
+difficult for a user to determine the authenticity of the certificate
+reply.
+.IP \[bu] 2
+If the reply is a PKCS #7 formatted certificate chain or a sequence of
+X.509 certificates, then the chain is ordered with the user certificate
+first followed by zero or more CA certificates.
+If the chain ends with a self\-signed root CA certificate and
+the\f[CB]\-trustcacerts\f[R] option was specified, the \f[CB]keytool\f[R]
+command attempts to match it with any of the trusted certificates in the
+keystore or the \f[CB]cacerts\f[R] keystore file.
+If the chain doesn\[aq]t end with a self\-signed root CA certificate and
+the \f[CB]\-trustcacerts\f[R] option was specified, the \f[CB]keytool\f[R]
+command tries to find one from the trusted certificates in the keystore
+or the \f[CB]cacerts\f[R] keystore file and add it to the end of the
+chain.
+If the certificate isn\[aq]t found and the \f[CB]\-noprompt\f[R] option
+isn\[aq]t specified, the information of the last certificate in the
+chain is printed, and the user is prompted to verify it.
+.PP
+If the public key in the certificate reply matches the user\[aq]s public
+key already stored with \f[CB]alias\f[R], then the old certificate chain
+is replaced with the new certificate chain in the reply.
+The old chain can only be replaced with a valid \f[CB]keypass\f[R], and so
+the password used to protect the private key of the entry is supplied.
+If no password is provided, and the private key password is different
+from the keystore password, the user is prompted for it.
+.PP
+This command was named \f[CB]\-import\f[R] in earlier releases.
+This old name is still supported in this release.
+The new name, \f[CB]\-importcert\f[R], is preferred.
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/rmiregistry.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/rmiregistry.1
new file mode 100644
index 0000000..8c97d1f
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/rmiregistry.1
@@ -0,0 +1,92 @@
+.\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "RMIREGISTRY" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+rmiregistry \- create and start a remote object registry on the
+specified port on the current host
+.SH SYNOPSIS
+.PP
+\f[CB]rmiregistry\f[R] [\f[I]options\f[R]] [\f[I]port\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the option for the \f[CB]rmiregistry\f[R] command.
+See \f[B]Options\f[R]
+.RS
+.RE
+.TP
+.B \f[I]port\f[R]
+The number of a port on the current host at which to start the remote
+object registry.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]rmiregistry\f[R] command creates and starts a remote object
+registry on the specified port on the current host.
+If the port is omitted, then the registry is started on port 1099.
+The \f[CB]rmiregistry\f[R] command produces no output and is typically run
+in the background, for example:
+.RS
+.PP
+\f[CB]rmiregistry\ &\f[R]
+.RE
+.PP
+A remote object registry is a bootstrap naming service that\[aq]s used
+by RMI servers on the same host to bind remote objects to names.
+Clients on local and remote hosts can then look up remote objects and
+make remote method invocations.
+.PP
+The registry is typically used to locate the first remote object on
+which an application needs to call methods.
+That object then provides application\-specific support for finding
+other objects.
+.PP
+The methods of the \f[CB]java.rmi.registry.LocateRegistry\f[R] class are
+used to get a registry operating on the local host or local host and
+port.
+.PP
+The URL\-based methods of the \f[CB]java.rmi.Naming\f[R] class operate on
+a registry and can be used to:
+.IP \[bu] 2
+Bind the specified name to a remote object
+.IP \[bu] 2
+Return an array of the names bound in the registry
+.IP \[bu] 2
+Return a reference, a stub, for the remote object associated with the
+specified name
+.IP \[bu] 2
+Rebind the specified name to a new remote object
+.IP \[bu] 2
+Destroy the binding for the specified name that\[aq]s associated with a
+remote object
+.SH OPTIONS
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Used with any Java option to pass the \f[I]option\f[R] following the
+\f[CB]\-J\f[R] (no spaces between the \f[CB]\-J\f[R] and the option) to the
+Java interpreter.
+.RS
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/man/man1/serialver.1 b/java/temurin-17/jdk-17.0.10+7/man/man1/serialver.1
new file mode 100644
index 0000000..0ba5021
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/man/man1/serialver.1
@@ -0,0 +1,84 @@
+.\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "SERIALVER" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+serialver \- return the \f[CB]serialVersionUID\f[R] for one or more
+classes in a form suitable for copying into an evolving class
+.SH SYNOPSIS
+.PP
+\f[CB]serialver\f[R] [\f[I]options\f[R]] [\f[I]classnames\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the command\-line options for the \f[CB]serialver\f[R]
+command.
+See \f[B]Options for serialver\f[R].
+.RS
+.RE
+.TP
+.B \f[I]classnames\f[R]
+The classes for which \f[CB]serialVersionUID\f[R] is to be returned.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]serialver\f[R] command returns the \f[CB]serialVersionUID\f[R] for
+one or more classes in a form suitable for copying into an evolving
+class.
+When called with no arguments, the \f[CB]serialver\f[R] command prints a
+usage line.
+.SH OPTIONS FOR SERIALVER
+.TP
+.B \f[CB]\-classpath\f[R] \f[I]path\-files\f[R]
+Sets the search path for application classes and resources.
+Separate classes and resources with a colon (:).
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Passes the specified \f[I]option\f[R] to the Java Virtual Machine, where
+\f[I]option\f[R] is one of the options described on the reference page
+for the Java application launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+.RS
+.RE
+.SH NOTES
+.PP
+The \f[CB]serialver\f[R] command loads and initializes the specified
+classes in its virtual machine, and by default, it doesn\[aq]t set a
+security manager.
+If the \f[CB]serialver\f[R] command is to be run with untrusted classes,
+then a security manager can be set with the following option:
+.RS
+.PP
+\f[CB]\-J\-Djava.security.manager\f[R]
+.RE
+.PP
+When necessary, a security policy can be specified with the following
+option:
+.RS
+.PP
+\f[CB]\-J\-Djava.security.policy=\f[R]\f[I]policy_file\f[R]
+.RE
diff --git a/java/temurin-17/jdk-17.0.10+7/release b/java/temurin-17/jdk-17.0.10+7/release
new file mode 100644
index 0000000..18a410b
--- /dev/null
+++ b/java/temurin-17/jdk-17.0.10+7/release
@@ -0,0 +1,19 @@
+IMPLEMENTOR="Eclipse Adoptium"
+IMPLEMENTOR_VERSION="Temurin-17.0.10+7"
+JAVA_RUNTIME_VERSION="17.0.10+7"
+JAVA_VERSION="17.0.10"
+JAVA_VERSION_DATE="2024-01-16"
+LIBC="gnu"
+MODULES="java.base java.compiler java.datatransfer java.xml java.prefs java.desktop java.instrument java.logging java.management java.security.sasl java.naming java.rmi java.management.rmi java.net.http java.scripting java.security.jgss java.transaction.xa java.sql java.sql.rowset java.xml.crypto java.se java.smartcardio jdk.accessibility jdk.internal.jvmstat jdk.attach jdk.charsets jdk.compiler jdk.crypto.ec jdk.crypto.cryptoki jdk.dynalink jdk.internal.ed jdk.editpad jdk.hotspot.agent jdk.httpserver jdk.incubator.foreign jdk.incubator.vector jdk.internal.le jdk.internal.opt jdk.internal.vm.ci jdk.internal.vm.compiler jdk.internal.vm.compiler.management jdk.jartool jdk.javadoc jdk.jcmd jdk.management jdk.management.agent jdk.jconsole jdk.jdeps jdk.jdwp.agent jdk.jdi jdk.jfr jdk.jlink jdk.jpackage jdk.jshell jdk.jsobject jdk.jstatd jdk.localedata jdk.management.jfr jdk.naming.dns jdk.naming.rmi jdk.net jdk.nio.mapmode jdk.random jdk.sctp jdk.security.auth jdk.security.jgss jdk.unsupported jdk.unsupported.desktop jdk.xml.dom jdk.zipfs"
+OS_ARCH="x86_64"
+OS_NAME="Linux"
+SOURCE=".:git:eb31abbd7251"
+BUILD_SOURCE="git:5bb80cb8d781321c3390d89ed2bbd100218a8e1b"
+BUILD_SOURCE_REPO="https://github.com/adoptium/temurin-build.git"
+SOURCE_REPO="https://github.com/adoptium/jdk17u.git"
+FULL_VERSION="17.0.10+7"
+SEMANTIC_VERSION="17.0.10+7"
+BUILD_INFO="OS: Linux Version: 5.4.0-126-generic"
+JVM_VARIANT="Hotspot"
+JVM_VERSION="17.0.10+7"
+IMAGE_TYPE="JDK"
diff --git a/java/temurin-17/jmods/java.base.jmod b/java/temurin-17/jmods/java.base.jmod
new file mode 100644
index 0000000..aaee5fa
Binary files /dev/null and b/java/temurin-17/jmods/java.base.jmod differ
diff --git a/java/temurin-17/jmods/java.compiler.jmod b/java/temurin-17/jmods/java.compiler.jmod
new file mode 100644
index 0000000..08210a0
Binary files /dev/null and b/java/temurin-17/jmods/java.compiler.jmod differ
diff --git a/java/temurin-17/jmods/java.datatransfer.jmod b/java/temurin-17/jmods/java.datatransfer.jmod
new file mode 100644
index 0000000..d8ad272
Binary files /dev/null and b/java/temurin-17/jmods/java.datatransfer.jmod differ
diff --git a/java/temurin-17/jmods/java.desktop.jmod b/java/temurin-17/jmods/java.desktop.jmod
new file mode 100644
index 0000000..9e6dd89
Binary files /dev/null and b/java/temurin-17/jmods/java.desktop.jmod differ
diff --git a/java/temurin-17/jmods/java.instrument.jmod b/java/temurin-17/jmods/java.instrument.jmod
new file mode 100644
index 0000000..4a048bf
Binary files /dev/null and b/java/temurin-17/jmods/java.instrument.jmod differ
diff --git a/java/temurin-17/jmods/java.logging.jmod b/java/temurin-17/jmods/java.logging.jmod
new file mode 100644
index 0000000..29aa037
Binary files /dev/null and b/java/temurin-17/jmods/java.logging.jmod differ
diff --git a/java/temurin-17/jmods/java.management.jmod b/java/temurin-17/jmods/java.management.jmod
new file mode 100644
index 0000000..9799759
Binary files /dev/null and b/java/temurin-17/jmods/java.management.jmod differ
diff --git a/java/temurin-17/jmods/java.management.rmi.jmod b/java/temurin-17/jmods/java.management.rmi.jmod
new file mode 100644
index 0000000..1e1c4c2
Binary files /dev/null and b/java/temurin-17/jmods/java.management.rmi.jmod differ
diff --git a/java/temurin-17/jmods/java.naming.jmod b/java/temurin-17/jmods/java.naming.jmod
new file mode 100644
index 0000000..f6640b0
Binary files /dev/null and b/java/temurin-17/jmods/java.naming.jmod differ
diff --git a/java/temurin-17/jmods/java.net.http.jmod b/java/temurin-17/jmods/java.net.http.jmod
new file mode 100644
index 0000000..f4244e9
Binary files /dev/null and b/java/temurin-17/jmods/java.net.http.jmod differ
diff --git a/java/temurin-17/jmods/java.prefs.jmod b/java/temurin-17/jmods/java.prefs.jmod
new file mode 100644
index 0000000..c25a0aa
Binary files /dev/null and b/java/temurin-17/jmods/java.prefs.jmod differ
diff --git a/java/temurin-17/jmods/java.rmi.jmod b/java/temurin-17/jmods/java.rmi.jmod
new file mode 100644
index 0000000..26afff3
Binary files /dev/null and b/java/temurin-17/jmods/java.rmi.jmod differ
diff --git a/java/temurin-17/jmods/java.scripting.jmod b/java/temurin-17/jmods/java.scripting.jmod
new file mode 100644
index 0000000..39f80f7
Binary files /dev/null and b/java/temurin-17/jmods/java.scripting.jmod differ
diff --git a/java/temurin-17/jmods/java.se.jmod b/java/temurin-17/jmods/java.se.jmod
new file mode 100644
index 0000000..0e2a3a8
Binary files /dev/null and b/java/temurin-17/jmods/java.se.jmod differ
diff --git a/java/temurin-17/jmods/java.security.jgss.jmod b/java/temurin-17/jmods/java.security.jgss.jmod
new file mode 100644
index 0000000..ca854a5
Binary files /dev/null and b/java/temurin-17/jmods/java.security.jgss.jmod differ
diff --git a/java/temurin-17/jmods/java.security.sasl.jmod b/java/temurin-17/jmods/java.security.sasl.jmod
new file mode 100644
index 0000000..186a954
Binary files /dev/null and b/java/temurin-17/jmods/java.security.sasl.jmod differ
diff --git a/java/temurin-17/jmods/java.smartcardio.jmod b/java/temurin-17/jmods/java.smartcardio.jmod
new file mode 100644
index 0000000..445aa7d
Binary files /dev/null and b/java/temurin-17/jmods/java.smartcardio.jmod differ
diff --git a/java/temurin-17/jmods/java.sql.jmod b/java/temurin-17/jmods/java.sql.jmod
new file mode 100644
index 0000000..5d293b0
Binary files /dev/null and b/java/temurin-17/jmods/java.sql.jmod differ
diff --git a/java/temurin-17/jmods/java.sql.rowset.jmod b/java/temurin-17/jmods/java.sql.rowset.jmod
new file mode 100644
index 0000000..badecaf
Binary files /dev/null and b/java/temurin-17/jmods/java.sql.rowset.jmod differ
diff --git a/java/temurin-17/jmods/java.transaction.xa.jmod b/java/temurin-17/jmods/java.transaction.xa.jmod
new file mode 100644
index 0000000..2e7e16c
Binary files /dev/null and b/java/temurin-17/jmods/java.transaction.xa.jmod differ
diff --git a/java/temurin-17/jmods/java.xml.crypto.jmod b/java/temurin-17/jmods/java.xml.crypto.jmod
new file mode 100644
index 0000000..4571caa
Binary files /dev/null and b/java/temurin-17/jmods/java.xml.crypto.jmod differ
diff --git a/java/temurin-17/jmods/java.xml.jmod b/java/temurin-17/jmods/java.xml.jmod
new file mode 100644
index 0000000..8e2bd36
Binary files /dev/null and b/java/temurin-17/jmods/java.xml.jmod differ
diff --git a/java/temurin-17/jmods/jdk.accessibility.jmod b/java/temurin-17/jmods/jdk.accessibility.jmod
new file mode 100644
index 0000000..0f443d3
Binary files /dev/null and b/java/temurin-17/jmods/jdk.accessibility.jmod differ
diff --git a/java/temurin-17/jmods/jdk.attach.jmod b/java/temurin-17/jmods/jdk.attach.jmod
new file mode 100644
index 0000000..110d60c
Binary files /dev/null and b/java/temurin-17/jmods/jdk.attach.jmod differ
diff --git a/java/temurin-17/jmods/jdk.charsets.jmod b/java/temurin-17/jmods/jdk.charsets.jmod
new file mode 100644
index 0000000..74e9191
Binary files /dev/null and b/java/temurin-17/jmods/jdk.charsets.jmod differ
diff --git a/java/temurin-17/jmods/jdk.compiler.jmod b/java/temurin-17/jmods/jdk.compiler.jmod
new file mode 100644
index 0000000..a6f5fac
Binary files /dev/null and b/java/temurin-17/jmods/jdk.compiler.jmod differ
diff --git a/java/temurin-17/jmods/jdk.crypto.cryptoki.jmod b/java/temurin-17/jmods/jdk.crypto.cryptoki.jmod
new file mode 100644
index 0000000..b9bc157
Binary files /dev/null and b/java/temurin-17/jmods/jdk.crypto.cryptoki.jmod differ
diff --git a/java/temurin-17/jmods/jdk.crypto.ec.jmod b/java/temurin-17/jmods/jdk.crypto.ec.jmod
new file mode 100644
index 0000000..819613f
Binary files /dev/null and b/java/temurin-17/jmods/jdk.crypto.ec.jmod differ
diff --git a/java/temurin-17/jmods/jdk.dynalink.jmod b/java/temurin-17/jmods/jdk.dynalink.jmod
new file mode 100644
index 0000000..ad20b95
Binary files /dev/null and b/java/temurin-17/jmods/jdk.dynalink.jmod differ
diff --git a/java/temurin-17/jmods/jdk.editpad.jmod b/java/temurin-17/jmods/jdk.editpad.jmod
new file mode 100644
index 0000000..658c798
Binary files /dev/null and b/java/temurin-17/jmods/jdk.editpad.jmod differ
diff --git a/java/temurin-17/jmods/jdk.hotspot.agent.jmod b/java/temurin-17/jmods/jdk.hotspot.agent.jmod
new file mode 100644
index 0000000..c22b8bc
Binary files /dev/null and b/java/temurin-17/jmods/jdk.hotspot.agent.jmod differ
diff --git a/java/temurin-17/jmods/jdk.httpserver.jmod b/java/temurin-17/jmods/jdk.httpserver.jmod
new file mode 100644
index 0000000..3868014
Binary files /dev/null and b/java/temurin-17/jmods/jdk.httpserver.jmod differ
diff --git a/java/temurin-17/jmods/jdk.incubator.foreign.jmod b/java/temurin-17/jmods/jdk.incubator.foreign.jmod
new file mode 100644
index 0000000..412fbe5
Binary files /dev/null and b/java/temurin-17/jmods/jdk.incubator.foreign.jmod differ
diff --git a/java/temurin-17/jmods/jdk.incubator.vector.jmod b/java/temurin-17/jmods/jdk.incubator.vector.jmod
new file mode 100644
index 0000000..5d4d1cf
Binary files /dev/null and b/java/temurin-17/jmods/jdk.incubator.vector.jmod differ
diff --git a/java/temurin-17/jmods/jdk.internal.ed.jmod b/java/temurin-17/jmods/jdk.internal.ed.jmod
new file mode 100644
index 0000000..f2ef32f
Binary files /dev/null and b/java/temurin-17/jmods/jdk.internal.ed.jmod differ
diff --git a/java/temurin-17/jmods/jdk.internal.jvmstat.jmod b/java/temurin-17/jmods/jdk.internal.jvmstat.jmod
new file mode 100644
index 0000000..4db7c52
Binary files /dev/null and b/java/temurin-17/jmods/jdk.internal.jvmstat.jmod differ
diff --git a/java/temurin-17/jmods/jdk.internal.le.jmod b/java/temurin-17/jmods/jdk.internal.le.jmod
new file mode 100644
index 0000000..e788df4
Binary files /dev/null and b/java/temurin-17/jmods/jdk.internal.le.jmod differ
diff --git a/java/temurin-17/jmods/jdk.internal.opt.jmod b/java/temurin-17/jmods/jdk.internal.opt.jmod
new file mode 100644
index 0000000..6e6d548
Binary files /dev/null and b/java/temurin-17/jmods/jdk.internal.opt.jmod differ
diff --git a/java/temurin-17/jmods/jdk.internal.vm.ci.jmod b/java/temurin-17/jmods/jdk.internal.vm.ci.jmod
new file mode 100644
index 0000000..8db7141
Binary files /dev/null and b/java/temurin-17/jmods/jdk.internal.vm.ci.jmod differ
diff --git a/java/temurin-17/jmods/jdk.internal.vm.compiler.jmod b/java/temurin-17/jmods/jdk.internal.vm.compiler.jmod
new file mode 100644
index 0000000..7700820
Binary files /dev/null and b/java/temurin-17/jmods/jdk.internal.vm.compiler.jmod differ
diff --git a/java/temurin-17/jmods/jdk.internal.vm.compiler.management.jmod b/java/temurin-17/jmods/jdk.internal.vm.compiler.management.jmod
new file mode 100644
index 0000000..d971301
Binary files /dev/null and b/java/temurin-17/jmods/jdk.internal.vm.compiler.management.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jartool.jmod b/java/temurin-17/jmods/jdk.jartool.jmod
new file mode 100644
index 0000000..c629453
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jartool.jmod differ
diff --git a/java/temurin-17/jmods/jdk.javadoc.jmod b/java/temurin-17/jmods/jdk.javadoc.jmod
new file mode 100644
index 0000000..93cae30
Binary files /dev/null and b/java/temurin-17/jmods/jdk.javadoc.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jcmd.jmod b/java/temurin-17/jmods/jdk.jcmd.jmod
new file mode 100644
index 0000000..50562c0
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jcmd.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jconsole.jmod b/java/temurin-17/jmods/jdk.jconsole.jmod
new file mode 100644
index 0000000..906a544
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jconsole.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jdeps.jmod b/java/temurin-17/jmods/jdk.jdeps.jmod
new file mode 100644
index 0000000..4e22117
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jdeps.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jdi.jmod b/java/temurin-17/jmods/jdk.jdi.jmod
new file mode 100644
index 0000000..674bce5
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jdi.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jdwp.agent.jmod b/java/temurin-17/jmods/jdk.jdwp.agent.jmod
new file mode 100644
index 0000000..a0eb1ad
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jdwp.agent.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jfr.jmod b/java/temurin-17/jmods/jdk.jfr.jmod
new file mode 100644
index 0000000..e026e6b
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jfr.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jlink.jmod b/java/temurin-17/jmods/jdk.jlink.jmod
new file mode 100644
index 0000000..377de80
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jlink.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jpackage.jmod b/java/temurin-17/jmods/jdk.jpackage.jmod
new file mode 100644
index 0000000..c82d54f
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jpackage.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jshell.jmod b/java/temurin-17/jmods/jdk.jshell.jmod
new file mode 100644
index 0000000..6f65471
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jshell.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jsobject.jmod b/java/temurin-17/jmods/jdk.jsobject.jmod
new file mode 100644
index 0000000..1b937a2
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jsobject.jmod differ
diff --git a/java/temurin-17/jmods/jdk.jstatd.jmod b/java/temurin-17/jmods/jdk.jstatd.jmod
new file mode 100644
index 0000000..7b13c9c
Binary files /dev/null and b/java/temurin-17/jmods/jdk.jstatd.jmod differ
diff --git a/java/temurin-17/jmods/jdk.localedata.jmod b/java/temurin-17/jmods/jdk.localedata.jmod
new file mode 100644
index 0000000..d8f3f27
Binary files /dev/null and b/java/temurin-17/jmods/jdk.localedata.jmod differ
diff --git a/java/temurin-17/jmods/jdk.management.agent.jmod b/java/temurin-17/jmods/jdk.management.agent.jmod
new file mode 100644
index 0000000..51a8c61
Binary files /dev/null and b/java/temurin-17/jmods/jdk.management.agent.jmod differ
diff --git a/java/temurin-17/jmods/jdk.management.jfr.jmod b/java/temurin-17/jmods/jdk.management.jfr.jmod
new file mode 100644
index 0000000..5f2f7ce
Binary files /dev/null and b/java/temurin-17/jmods/jdk.management.jfr.jmod differ
diff --git a/java/temurin-17/jmods/jdk.management.jmod b/java/temurin-17/jmods/jdk.management.jmod
new file mode 100644
index 0000000..5f85a65
Binary files /dev/null and b/java/temurin-17/jmods/jdk.management.jmod differ
diff --git a/java/temurin-17/jmods/jdk.naming.dns.jmod b/java/temurin-17/jmods/jdk.naming.dns.jmod
new file mode 100644
index 0000000..da77049
Binary files /dev/null and b/java/temurin-17/jmods/jdk.naming.dns.jmod differ
diff --git a/java/temurin-17/jmods/jdk.naming.rmi.jmod b/java/temurin-17/jmods/jdk.naming.rmi.jmod
new file mode 100644
index 0000000..5f7a0ed
Binary files /dev/null and b/java/temurin-17/jmods/jdk.naming.rmi.jmod differ
diff --git a/java/temurin-17/jmods/jdk.net.jmod b/java/temurin-17/jmods/jdk.net.jmod
new file mode 100644
index 0000000..40d5ad3
Binary files /dev/null and b/java/temurin-17/jmods/jdk.net.jmod differ
diff --git a/java/temurin-17/jmods/jdk.nio.mapmode.jmod b/java/temurin-17/jmods/jdk.nio.mapmode.jmod
new file mode 100644
index 0000000..39ba56c
Binary files /dev/null and b/java/temurin-17/jmods/jdk.nio.mapmode.jmod differ
diff --git a/java/temurin-17/jmods/jdk.random.jmod b/java/temurin-17/jmods/jdk.random.jmod
new file mode 100644
index 0000000..631ce85
Binary files /dev/null and b/java/temurin-17/jmods/jdk.random.jmod differ
diff --git a/java/temurin-17/jmods/jdk.sctp.jmod b/java/temurin-17/jmods/jdk.sctp.jmod
new file mode 100644
index 0000000..b3d2b80
Binary files /dev/null and b/java/temurin-17/jmods/jdk.sctp.jmod differ
diff --git a/java/temurin-17/jmods/jdk.security.auth.jmod b/java/temurin-17/jmods/jdk.security.auth.jmod
new file mode 100644
index 0000000..1bc4f5e
Binary files /dev/null and b/java/temurin-17/jmods/jdk.security.auth.jmod differ
diff --git a/java/temurin-17/jmods/jdk.security.jgss.jmod b/java/temurin-17/jmods/jdk.security.jgss.jmod
new file mode 100644
index 0000000..4c1ab67
Binary files /dev/null and b/java/temurin-17/jmods/jdk.security.jgss.jmod differ
diff --git a/java/temurin-17/jmods/jdk.unsupported.desktop.jmod b/java/temurin-17/jmods/jdk.unsupported.desktop.jmod
new file mode 100644
index 0000000..7711041
Binary files /dev/null and b/java/temurin-17/jmods/jdk.unsupported.desktop.jmod differ
diff --git a/java/temurin-17/jmods/jdk.unsupported.jmod b/java/temurin-17/jmods/jdk.unsupported.jmod
new file mode 100644
index 0000000..8d9afed
Binary files /dev/null and b/java/temurin-17/jmods/jdk.unsupported.jmod differ
diff --git a/java/temurin-17/jmods/jdk.xml.dom.jmod b/java/temurin-17/jmods/jdk.xml.dom.jmod
new file mode 100644
index 0000000..f697509
Binary files /dev/null and b/java/temurin-17/jmods/jdk.xml.dom.jmod differ
diff --git a/java/temurin-17/jmods/jdk.zipfs.jmod b/java/temurin-17/jmods/jdk.zipfs.jmod
new file mode 100644
index 0000000..ceb1bca
Binary files /dev/null and b/java/temurin-17/jmods/jdk.zipfs.jmod differ
diff --git a/java/temurin-17/legal/java.base/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.base/ADDITIONAL_LICENSE_INFO
new file mode 100644
index 0000000..ff700cd
--- /dev/null
+++ b/java/temurin-17/legal/java.base/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1,37 @@
+ ADDITIONAL INFORMATION ABOUT LICENSING
+
+Certain files distributed by Oracle America, Inc. and/or its affiliates are
+subject to the following clarification and special exception to the GPLv2,
+based on the GNU Project exception for its Classpath libraries, known as the
+GNU Classpath Exception.
+
+Note that Oracle includes multiple, independent programs in this software
+package. Some of those programs are provided under licenses deemed
+incompatible with the GPLv2 by the Free Software Foundation and others.
+For example, the package includes programs licensed under the Apache
+License, Version 2.0 and may include FreeType. Such programs are licensed
+to you under their original licenses.
+
+Oracle facilitates your further distribution of this package by adding the
+Classpath Exception to the necessary parts of its GPLv2 code, which permits
+you to use that code in combination with other independent modules not
+licensed under the GPLv2. However, note that this would not permit you to
+commingle code under an incompatible license with Oracle's GPLv2 licensed
+code by, for example, cutting and pasting such code into a file also
+containing Oracle's GPLv2 licensed code and then distributing the result.
+
+Additionally, if you were to remove the Classpath Exception from any of the
+files to which it applies and distribute the result, you would likely be
+required to license some or all of the other code in that distribution under
+the GPLv2 as well, and since the GPLv2 is incompatible with the license terms
+of some items included in the distribution by Oracle, removing the Classpath
+Exception could therefore effectively compromise your ability to further
+distribute the package.
+
+Failing to distribute notices associated with some files may also create
+unexpected legal consequences.
+
+Proceed with caution and we recommend that you obtain the advice of a lawyer
+skilled in open source matters before removing the Classpath Exception or
+making modifications to this package which may subsequently be redistributed
+and/or involve the use of third party software.
diff --git a/java/temurin-17/legal/java.base/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.base/ASSEMBLY_EXCEPTION
new file mode 100644
index 0000000..065b8d9
--- /dev/null
+++ b/java/temurin-17/legal/java.base/ASSEMBLY_EXCEPTION
@@ -0,0 +1,27 @@
+
+OPENJDK ASSEMBLY EXCEPTION
+
+The OpenJDK source code made available by Oracle America, Inc. (Oracle) at
+openjdk.java.net ("OpenJDK Code") is distributed under the terms of the GNU
+General Public License <http://www.gnu.org/copyleft/gpl.html> version 2
+only ("GPL2"), with the following clarification and special exception.
+
+ Linking this OpenJDK Code statically or dynamically with other code
+ is making a combined work based on this library. Thus, the terms
+ and conditions of GPL2 cover the whole combination.
+
+ As a special exception, Oracle gives you permission to link this
+ OpenJDK Code with certain code licensed by Oracle as indicated at
+ http://openjdk.java.net/legal/exception-modules-2007-05-08.html
+ ("Designated Exception Modules") to produce an executable,
+ regardless of the license terms of the Designated Exception Modules,
+ and to copy and distribute the resulting executable under GPL2,
+ provided that the Designated Exception Modules continue to be
+ governed by the licenses under which they were offered by Oracle.
+
+As such, it allows licensees and sublicensees of Oracle's GPL2 OpenJDK Code
+to build an executable that includes those portions of necessary code that
+Oracle could not provide under GPL2 (or that Oracle has provided under GPL2
+with the Classpath exception). If you modify or add to the OpenJDK code,
+that new GPL2 code may still be combined with Designated Exception Modules
+if the new code is made subject to this exception by its copyright holder.
diff --git a/java/temurin-17/legal/java.base/LICENSE b/java/temurin-17/legal/java.base/LICENSE
new file mode 100644
index 0000000..8b400c7
--- /dev/null
+++ b/java/temurin-17/legal/java.base/LICENSE
@@ -0,0 +1,347 @@
+The GNU General Public License (GPL)
+
+Version 2, June 1991
+
+Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+Everyone is permitted to copy and distribute verbatim copies of this license
+document, but changing it is not allowed.
+
+Preamble
+
+The licenses for most software are designed to take away your freedom to share
+and change it. By contrast, the GNU General Public License is intended to
+guarantee your freedom to share and change free software--to make sure the
+software is free for all its users. This General Public License applies to
+most of the Free Software Foundation's software and to any other program whose
+authors commit to using it. (Some other Free Software Foundation software is
+covered by the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our
+General Public Licenses are designed to make sure that you have the freedom to
+distribute copies of free software (and charge for this service if you wish),
+that you receive source code or can get it if you want it, that you can change
+the software or use pieces of it in new free programs; and that you know you
+can do these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny
+you these rights or to ask you to surrender the rights. These restrictions
+translate to certain responsibilities for you if you distribute copies of the
+software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for
+a fee, you must give the recipients all the rights that you have. You must
+make sure that they, too, receive or can get the source code. And you must
+show them these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2)
+offer you this license which gives you legal permission to copy, distribute
+and/or modify the software.
+
+Also, for each author's protection and ours, we want to make certain that
+everyone understands that there is no warranty for this free software. If the
+software is modified by someone else and passed on, we want its recipients to
+know that what they have is not the original, so that any problems introduced
+by others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We
+wish to avoid the danger that redistributors of a free program will
+individually obtain patent licenses, in effect making the program proprietary.
+To prevent this, we have made it clear that any patent must be licensed for
+everyone's free use or not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification
+follow.
+
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+0. This License applies to any program or other work which contains a notice
+placed by the copyright holder saying it may be distributed under the terms of
+this General Public License. The "Program", below, refers to any such program
+or work, and a "work based on the Program" means either the Program or any
+derivative work under copyright law: that is to say, a work containing the
+Program or a portion of it, either verbatim or with modifications and/or
+translated into another language. (Hereinafter, translation is included
+without limitation in the term "modification".) Each licensee is addressed as
+"you".
+
+Activities other than copying, distribution and modification are not covered by
+this License; they are outside its scope. The act of running the Program is
+not restricted, and the output from the Program is covered only if its contents
+constitute a work based on the Program (independent of having been made by
+running the Program). Whether that is true depends on what the Program does.
+
+1. You may copy and distribute verbatim copies of the Program's source code as
+you receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice and
+disclaimer of warranty; keep intact all the notices that refer to this License
+and to the absence of any warranty; and give any other recipients of the
+Program a copy of this License along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and you may
+at your option offer warranty protection in exchange for a fee.
+
+2. You may modify your copy or copies of the Program or any portion of it, thus
+forming a work based on the Program, and copy and distribute such modifications
+or work under the terms of Section 1 above, provided that you also meet all of
+these conditions:
+
+ a) You must cause the modified files to carry prominent notices stating
+ that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in whole or
+ in part contains or is derived from the Program or any part thereof, to be
+ licensed as a whole at no charge to all third parties under the terms of
+ this License.
+
+ c) If the modified program normally reads commands interactively when run,
+ you must cause it, when started running for such interactive use in the
+ most ordinary way, to print or display an announcement including an
+ appropriate copyright notice and a notice that there is no warranty (or
+ else, saying that you provide a warranty) and that users may redistribute
+ the program under these conditions, and telling the user how to view a copy
+ of this License. (Exception: if the Program itself is interactive but does
+ not normally print such an announcement, your work based on the Program is
+ not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If identifiable
+sections of that work are not derived from the Program, and can be reasonably
+considered independent and separate works in themselves, then this License, and
+its terms, do not apply to those sections when you distribute them as separate
+works. But when you distribute the same sections as part of a whole which is a
+work based on the Program, the distribution of the whole must be on the terms
+of this License, whose permissions for other licensees extend to the entire
+whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest your
+rights to work written entirely by you; rather, the intent is to exercise the
+right to control the distribution of derivative or collective works based on
+the Program.
+
+In addition, mere aggregation of another work not based on the Program with the
+Program (or with a work based on the Program) on a volume of a storage or
+distribution medium does not bring the other work under the scope of this
+License.
+
+3. You may copy and distribute the Program (or a work based on it, under
+Section 2) in object code or executable form under the terms of Sections 1 and
+2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable source
+ code, which must be distributed under the terms of Sections 1 and 2 above
+ on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three years, to
+ give any third party, for a charge no more than your cost of physically
+ performing source distribution, a complete machine-readable copy of the
+ corresponding source code, to be distributed under the terms of Sections 1
+ and 2 above on a medium customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer to
+ distribute corresponding source code. (This alternative is allowed only
+ for noncommercial distribution and only if you received the program in
+ object code or executable form with such an offer, in accord with
+ Subsection b above.)
+
+The source code for a work means the preferred form of the work for making
+modifications to it. For an executable work, complete source code means all
+the source code for all modules it contains, plus any associated interface
+definition files, plus the scripts used to control compilation and installation
+of the executable. However, as a special exception, the source code
+distributed need not include anything that is normally distributed (in either
+source or binary form) with the major components (compiler, kernel, and so on)
+of the operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the source
+code from the same place counts as distribution of the source code, even though
+third parties are not compelled to copy the source along with the object code.
+
+4. You may not copy, modify, sublicense, or distribute the Program except as
+expressly provided under this License. Any attempt otherwise to copy, modify,
+sublicense or distribute the Program is void, and will automatically terminate
+your rights under this License. However, parties who have received copies, or
+rights, from you under this License will not have their licenses terminated so
+long as such parties remain in full compliance.
+
+5. You are not required to accept this License, since you have not signed it.
+However, nothing else grants you permission to modify or distribute the Program
+or its derivative works. These actions are prohibited by law if you do not
+accept this License. Therefore, by modifying or distributing the Program (or
+any work based on the Program), you indicate your acceptance of this License to
+do so, and all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+6. Each time you redistribute the Program (or any work based on the Program),
+the recipient automatically receives a license from the original licensor to
+copy, distribute or modify the Program subject to these terms and conditions.
+You may not impose any further restrictions on the recipients' exercise of the
+rights granted herein. You are not responsible for enforcing compliance by
+third parties to this License.
+
+7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues), conditions
+are imposed on you (whether by court order, agreement or otherwise) that
+contradict the conditions of this License, they do not excuse you from the
+conditions of this License. If you cannot distribute so as to satisfy
+simultaneously your obligations under this License and any other pertinent
+obligations, then as a consequence you may not distribute the Program at all.
+For example, if a patent license would not permit royalty-free redistribution
+of the Program by all those who receive copies directly or indirectly through
+you, then the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply and
+the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any patents or
+other property right claims or to contest validity of any such claims; this
+section has the sole purpose of protecting the integrity of the free software
+distribution system, which is implemented by public license practices. Many
+people have made generous contributions to the wide range of software
+distributed through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing to
+distribute software through any other system and a licensee cannot impose that
+choice.
+
+This section is intended to make thoroughly clear what is believed to be a
+consequence of the rest of this License.
+
+8. If the distribution and/or use of the Program is restricted in certain
+countries either by patents or by copyrighted interfaces, the original
+copyright holder who places the Program under this License may add an explicit
+geographical distribution limitation excluding those countries, so that
+distribution is permitted only in or among countries not thus excluded. In
+such case, this License incorporates the limitation as if written in the body
+of this License.
+
+9. The Free Software Foundation may publish revised and/or new versions of the
+General Public License from time to time. Such new versions will be similar in
+spirit to the present version, but may differ in detail to address new problems
+or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any later
+version", you have the option of following the terms and conditions either of
+that version or of any later version published by the Free Software Foundation.
+If the Program does not specify a version number of this License, you may
+choose any version ever published by the Free Software Foundation.
+
+10. If you wish to incorporate parts of the Program into other free programs
+whose distribution conditions are different, write to the author to ask for
+permission. For software which is copyrighted by the Free Software Foundation,
+write to the Free Software Foundation; we sometimes make exceptions for this.
+Our decision will be guided by the two goals of preserving the free status of
+all derivatives of our free software and of promoting the sharing and reuse of
+software generally.
+
+NO WARRANTY
+
+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
+THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE
+STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE
+PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
+YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
+ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE
+PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
+INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
+BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER
+OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible
+use to the public, the best way to achieve this is to make it free software
+which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach
+them to the start of each source file to most effectively convey the exclusion
+of warranty; and each file should have at least the "copyright" line and a
+pointer to where the full notice is found.
+
+ One line to give the program's name and a brief idea of what it does.
+
+ Copyright (C) <year> <name of author>
+
+ This program is free software; you can redistribute it and/or modify it
+ under the terms of the GNU General Public License as published by the Free
+ Software Foundation; either version 2 of the License, or (at your option)
+ any later version.
+
+ This program is distributed in the hope that it will be useful, but WITHOUT
+ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ more details.
+
+ You should have received a copy of the GNU General Public License along
+ with this program; if not, write to the Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this when it
+starts in an interactive mode:
+
+ Gnomovision version 69, Copyright (C) year name of author Gnomovision comes
+ with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free
+ software, and you are welcome to redistribute it under certain conditions;
+ type 'show c' for details.
+
+The hypothetical commands 'show w' and 'show c' should show the appropriate
+parts of the General Public License. Of course, the commands you use may be
+called something other than 'show w' and 'show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your school,
+if any, to sign a "copyright disclaimer" for the program, if necessary. Here
+is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+ 'Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+ signature of Ty Coon, 1 April 1989
+
+ Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Library General Public
+License instead of this License.
+
+
+"CLASSPATH" EXCEPTION TO THE GPL
+
+Certain source files distributed by Oracle America and/or its affiliates are
+subject to the following clarification and special exception to the GPL, but
+only where Oracle has expressly included in the particular source file's header
+the words "Oracle designates this particular file as subject to the "Classpath"
+exception as provided by Oracle in the LICENSE file that accompanied this code."
+
+ Linking this library statically or dynamically with other modules is making
+ a combined work based on this library. Thus, the terms and conditions of
+ the GNU General Public License cover the whole combination.
+
+ As a special exception, the copyright holders of this library give you
+ permission to link this library with independent modules to produce an
+ executable, regardless of the license terms of these independent modules,
+ and to copy and distribute the resulting executable under terms of your
+ choice, provided that you also meet, for each linked independent module,
+ the terms and conditions of the license of that module. An independent
+ module is a module which is not derived from or based on this library. If
+ you modify this library, you may extend this exception to your version of
+ the library, but you are not obligated to do so. If you do not wish to do
+ so, delete this exception statement from your version.
diff --git a/java/temurin-17/legal/java.base/aes.md b/java/temurin-17/legal/java.base/aes.md
new file mode 100644
index 0000000..6d0ee2e
--- /dev/null
+++ b/java/temurin-17/legal/java.base/aes.md
@@ -0,0 +1,36 @@
+## Cryptix AES v3.2.0
+
+### Cryptix General License
+<pre>
+
+Cryptix General License
+
+Copyright (c) 1995-2005 The Cryptix Foundation Limited.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ 1. Redistributions of source code must retain the copyright notice,
+ this list of conditions and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE CRYPTIX FOUNDATION LIMITED AND
+CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE CRYPTIX FOUNDATION LIMITED OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+</pre>
diff --git a/java/temurin-17/legal/java.base/asm.md b/java/temurin-17/legal/java.base/asm.md
new file mode 100644
index 0000000..707ecda
--- /dev/null
+++ b/java/temurin-17/legal/java.base/asm.md
@@ -0,0 +1,36 @@
+## ASM Bytecode Manipulation Framework v8.0.1
+
+### ASM License
+<pre>
+
+Copyright (c) 2000-2011 France Télécom
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holders nor the names of its
+ contributors may be used to endorse or promote products derived from
+ this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+THE POSSIBILITY OF SUCH DAMAGE.
+
+</pre>
diff --git a/java/temurin-17/legal/java.base/c-libutl.md b/java/temurin-17/legal/java.base/c-libutl.md
new file mode 100644
index 0000000..8bc9880
--- /dev/null
+++ b/java/temurin-17/legal/java.base/c-libutl.md
@@ -0,0 +1,35 @@
+## c-libutl 20160225
+
+### c-libutl License
+```
+
+This software is distributed under the terms of the BSD license.
+
+== BSD LICENSE ===============================================================
+
+ (C) 2009 by Remo Dentato (rdentato@gmail.com)
+
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice,
+ this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+http://opensource.org/licenses/bsd-license.php
+
+```
diff --git a/java/temurin-17/legal/java.base/cldr.md b/java/temurin-17/legal/java.base/cldr.md
new file mode 100644
index 0000000..2f21c45
--- /dev/null
+++ b/java/temurin-17/legal/java.base/cldr.md
@@ -0,0 +1,105 @@
+## Unicode Common Local Data Repository (CLDR) v39
+
+### CLDR License
+
+```
+
+UNICODE, INC. LICENSE AGREEMENT - DATA FILES AND SOFTWARE
+
+See Terms of Use for definitions of Unicode Inc.'s
+Data Files and Software.
+
+NOTICE TO USER: Carefully read the following legal agreement.
+BY DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING UNICODE INC.'S
+DATA FILES ("DATA FILES"), AND/OR SOFTWARE ("SOFTWARE"),
+YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+TERMS AND CONDITIONS OF THIS AGREEMENT.
+IF YOU DO NOT AGREE, DO NOT DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE
+THE DATA FILES OR SOFTWARE.
+
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright © 1991-2021 Unicode, Inc. All rights reserved.
+Distributed under the Terms of Use in https://www.unicode.org/copyright.html.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Unicode data files and any associated documentation
+(the "Data Files") or Unicode software and any associated documentation
+(the "Software") to deal in the Data Files or Software
+without restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, and/or sell copies of
+the Data Files or Software, and to permit persons to whom the Data Files
+or Software are furnished to do so, provided that either
+(a) this copyright and permission notice appear with all copies
+of the Data Files or Software, or
+(b) this copyright and permission notice appear in associated
+Documentation.
+
+THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT OF THIRD PARTY RIGHTS.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS
+NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL
+DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THE DATA FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder
+shall not be used in advertising or otherwise to promote the sale,
+use or other dealings in these Data Files or Software without prior
+written authorization of the copyright holder.
+
+
+------------------------------------------------------------ Terms of Use ---------------------------------------------------------------
+
+Unicode® Copyright and Terms of Use
+For the general privacy policy governing access to this site, see the Unicode Privacy Policy.
+
+Unicode Copyright
+Copyright © 1991-2021 Unicode, Inc. All rights reserved.
+Definitions
+Unicode Data Files ("DATA FILES") include all data files under the directories:
+https://www.unicode.org/Public/
+https://www.unicode.org/reports/
+https://www.unicode.org/ivd/data/
+
+Unicode Data Files do not include PDF online code charts under the directory:
+https://www.unicode.org/Public/
+
+Unicode Software ("SOFTWARE") includes any source code published in the Unicode Standard
+or any source code or compiled code under the directories:
+https://www.unicode.org/Public/PROGRAMS/
+https://www.unicode.org/Public/cldr/
+http://site.icu-project.org/download/
+Terms of Use
+Certain documents and files on this website contain a legend indicating that "Modification is permitted." Any person is hereby authorized, without fee, to modify such documents and files to create derivative works conforming to the Unicode® Standard, subject to Terms and Conditions herein.
+Any person is hereby authorized, without fee, to view, use, reproduce, and distribute all documents and files, subject to the Terms and Conditions herein.
+Further specifications of rights and restrictions pertaining to the use of the Unicode DATA FILES and SOFTWARE can be found in the Unicode Data Files and Software License.
+Each version of the Unicode Standard has further specifications of rights and restrictions of use. For the book editions (Unicode 5.0 and earlier), these are found on the back of the title page.
+The Unicode PDF online code charts carry specific restrictions. Those restrictions are incorporated as the first page of each PDF code chart.
+All other files, including online documentation of the core specification for Unicode 6.0 and later, are covered under these general Terms of Use.
+No license is granted to "mirror" the Unicode website where a fee is charged for access to the "mirror" site.
+Modification is not permitted with respect to this document. All copies of this document must be verbatim.
+Restricted Rights Legend
+Any technical data or software which is licensed to the United States of America, its agencies and/or instrumentalities under this Agreement is commercial technical data or commercial computer software developed exclusively at private expense as defined in FAR 2.101, or DFARS 252.227-7014 (June 1995), as applicable. For technical data, use, duplication, or disclosure by the Government is subject to restrictions as set forth in DFARS 202.227-7015 Technical Data, Commercial and Items (Nov 1995) and this Agreement. For Software, in accordance with FAR 12-212 or DFARS 227-7202, as applicable, use, duplication or disclosure by the Government is subject to the restrictions set forth in this Agreement.
+Warranties and Disclaimers
+This publication and/or website may include technical or typographical errors or other inaccuracies. Changes are periodically added to the information herein; these changes will be incorporated in new editions of the publication and/or website. Unicode, Inc. may make improvements and/or changes in the product(s) and/or program(s) described in this publication and/or website at any time.
+If this file has been purchased on magnetic or optical media from Unicode, Inc. the sole and exclusive remedy for any claim will be exchange of the defective media within ninety (90) days of original purchase.
+EXCEPT AS PROVIDED IN SECTION E.2, THIS PUBLICATION AND/OR SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. UNICODE, INC. AND ITS LICENSORS ASSUME NO RESPONSIBILITY FOR ERRORS OR OMISSIONS IN THIS PUBLICATION AND/OR SOFTWARE OR OTHER DOCUMENTS WHICH ARE REFERENCED BY OR LINKED TO THIS PUBLICATION OR THE UNICODE WEBSITE.
+Waiver of Damages
+In no event shall Unicode, Inc. or its licensors be liable for any special, incidental, indirect or consequential damages of any kind, or any damages whatsoever, whether or not Unicode, Inc. was advised of the possibility of the damage, including, without limitation, those resulting from the following: loss of use, data or profits, in connection with the use, modification or distribution of this information or its derivatives.
+Trademarks & Logos
+The Unicode Word Mark and the Unicode Logo are trademarks of Unicode, Inc. “The Unicode Consortium” and “Unicode, Inc.” are trade names of Unicode, Inc. Use of the information and materials found on this website indicates your acknowledgement of Unicode, Inc.’s exclusive worldwide rights in the Unicode Word Mark, the Unicode Logo, and the Unicode trade names.
+The Unicode Consortium Name and Trademark Usage Policy (“Trademark Policy”) are incorporated herein by reference and you agree to abide by the provisions of the Trademark Policy, which may be changed from time to time in the sole discretion of Unicode, Inc.
+All third party trademarks referenced herein are the property of their respective owners.
+Miscellaneous
+Jurisdiction and Venue. This website is operated from a location in the State of California, United States of America. Unicode, Inc. makes no representation that the materials are appropriate for use in other locations. If you access this website from other locations, you are responsible for compliance with local laws. This Agreement, all use of this website and any claims and damages resulting from use of this website are governed solely by the laws of the State of California without regard to any principles which would apply the laws of a different jurisdiction. The user agrees that any disputes regarding this website shall be resolved solely in the courts located in Santa Clara County, California. The user agrees said courts have personal jurisdiction and agree to waive any right to transfer the dispute to any other forum.
+Modification by Unicode, Inc. Unicode, Inc. shall have the right to modify this Agreement at any time by posting it to this website. The user may not assign any part of this Agreement without Unicode, Inc.’s prior written consent.
+Taxes. The user agrees to pay any taxes arising from access to this website or use of the information herein, except for those based on Unicode’s net income.
+Severability. If any provision of this Agreement is declared invalid or unenforceable, the remaining provisions of this Agreement shall remain in effect.
+Entire Agreement. This Agreement constitutes the entire agreement between the parties.
+
+
+```
diff --git a/java/temurin-17/legal/java.base/icu.md b/java/temurin-17/legal/java.base/icu.md
new file mode 100644
index 0000000..ab850bf
--- /dev/null
+++ b/java/temurin-17/legal/java.base/icu.md
@@ -0,0 +1,140 @@
+## International Components for Unicode (ICU4J) v67.1
+
+### ICU4J License
+```
+
+COPYRIGHT AND PERMISSION NOTICE (ICU 58 and later)
+
+Copyright © 1991-2020 Unicode, Inc. All rights reserved.
+Distributed under the Terms of Use in https://www.unicode.org/copyright.html.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Unicode data files and any associated documentation
+(the "Data Files") or Unicode software and any associated documentation
+(the "Software") to deal in the Data Files or Software
+without restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, and/or sell copies of
+the Data Files or Software, and to permit persons to whom the Data Files
+or Software are furnished to do so, provided that either
+(a) this copyright and permission notice appear with all copies
+of the Data Files or Software, or
+(b) this copyright and permission notice appear in associated
+Documentation.
+
+THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT OF THIRD PARTY RIGHTS.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS
+NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL
+DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THE DATA FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder
+shall not be used in advertising or otherwise to promote the sale,
+use or other dealings in these Data Files or Software without prior
+written authorization of the copyright holder.
+
+---------------------
+
+Third-Party Software Licenses
+
+This section contains third-party software notices and/or additional
+terms for licensed third-party software components included within ICU
+libraries.
+
+1. ICU License - ICU 1.8.1 to ICU 57.1
+
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright (c) 1995-2016 International Business Machines Corporation and others
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, and/or sell copies of the Software, and to permit persons
+to whom the Software is furnished to do so, provided that the above
+copyright notice(s) and this permission notice appear in all copies of
+the Software and that both the above copyright notice(s) and this
+permission notice appear in supporting documentation.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY
+SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER
+RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
+CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
+CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder
+shall not be used in advertising or otherwise to promote the sale, use
+or other dealings in this Software without prior written authorization
+of the copyright holder.
+
+All trademarks and registered trademarks mentioned herein are the
+property of their respective owners.
+
+
+——————————————————————————————————————————————————————————————————————
+
+
+From: https://www.unicode.org/copyright.html:
+
+ Unicode® Copyright and Terms of Use
+
+ For the general privacy policy governing access to this site, see the Unicode Privacy Policy.
+
+ Unicode Copyright
+ Copyright © 1991-2020 Unicode, Inc. All rights reserved.
+ Definitions
+
+ Unicode Data Files ("DATA FILES") include all data files under the directories:
+ https://www.unicode.org/Public/
+ https://www.unicode.org/reports/
+ https://www.unicode.org/ivd/data/
+
+ Unicode Data Files do not include PDF online code charts under the directory:
+ https://www.unicode.org/Public/
+
+ Unicode Software ("SOFTWARE") includes any source code published in the Unicode Standard
+ or any source code or compiled code under the directories:
+ https://www.unicode.org/Public/PROGRAMS/
+ https://www.unicode.org/Public/cldr/
+ http://site.icu-project.org/download/
+
+ Terms of Use
+ Certain documents and files on this website contain a legend indicating that "Modification is permitted." Any person is hereby authorized, without fee, to modify such documents and files to create derivative works conforming to the Unicode® Standard, subject to Terms and Conditions herein.
+ Any person is hereby authorized, without fee, to view, use, reproduce, and distribute all documents and files, subject to the Terms and Conditions herein.
+ Further specifications of rights and restrictions pertaining to the use of the Unicode DATA FILES and SOFTWARE can be found in the Unicode Data Files and Software License.
+ Each version of the Unicode Standard has further specifications of rights and restrictions of use. For the book editions (Unicode 5.0 and earlier), these are found on the back of the title page.
+ The Unicode PDF online code charts carry specific restrictions. Those restrictions are incorporated as the first page of each PDF code chart.
+ All other files, including online documentation of the core specification for Unicode 6.0 and later, are covered under these general Terms of Use.
+ No license is granted to "mirror" the Unicode website where a fee is charged for access to the "mirror" site.
+ Modification is not permitted with respect to this document. All copies of this document must be verbatim.
+ Restricted Rights Legend
+ Any technical data or software which is licensed to the United States of America, its agencies and/or instrumentalities under this Agreement is commercial technical data or commercial computer software developed exclusively at private expense as defined in FAR 2.101, or DFARS 252.227-7014 (June 1995), as applicable. For technical data, use, duplication, or disclosure by the Government is subject to restrictions as set forth in DFARS 202.227-7015 Technical Data, Commercial and Items (Nov 1995) and this Agreement. For Software, in accordance with FAR 12-212 or DFARS 227-7202, as applicable, use, duplication or disclosure by the Government is subject to the restrictions set forth in this Agreement.
+ Warranties and Disclaimers
+ This publication and/or website may include technical or typographical errors or other inaccuracies. Changes are periodically added to the information herein; these changes will be incorporated in new editions of the publication and/or website. Unicode, Inc. may make improvements and/or changes in the product(s) and/or program(s) described in this publication and/or website at any time.
+ If this file has been purchased on magnetic or optical media from Unicode, Inc. the sole and exclusive remedy for any claim will be exchange of the defective media within ninety (90) days of original purchase.
+ EXCEPT AS PROVIDED IN SECTION E.2, THIS PUBLICATION AND/OR SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. UNICODE, INC. AND ITS LICENSORS ASSUME NO RESPONSIBILITY FOR ERRORS OR OMISSIONS IN THIS PUBLICATION AND/OR SOFTWARE OR OTHER DOCUMENTS WHICH ARE REFERENCED BY OR LINKED TO THIS PUBLICATION OR THE UNICODE WEBSITE.
+ Waiver of Damages
+ In no event shall Unicode, Inc. or its licensors be liable for any special, incidental, indirect or consequential damages of any kind, or any damages whatsoever, whether or not Unicode, Inc. was advised of the possibility of the damage, including, without limitation, those resulting from the following: loss of use, data or profits, in connection with the use, modification or distribution of this information or its derivatives.
+ Trademarks & Logos
+ The Unicode Word Mark and the Unicode Logo are trademarks of Unicode, Inc. “The Unicode Consortium” and “Unicode, Inc.” are trade names of Unicode, Inc. Use of the information and materials found on this website indicates your acknowledgement of Unicode, Inc.’s exclusive worldwide rights in the Unicode Word Mark, the Unicode Logo, and the Unicode trade names.
+ The Unicode Consortium Name and Trademark Usage Policy (“Trademark Policy”) are incorporated herein by reference and you agree to abide by the provisions of the Trademark Policy, which may be changed from time to time in the sole discretion of Unicode, Inc.
+ All third party trademarks referenced herein are the property of their respective owners.
+ Miscellaneous
+ Jurisdiction and Venue. This website is operated from a location in the State of California, United States of America. Unicode, Inc. makes no representation that the materials are appropriate for use in other locations. If you access this website from other locations, you are responsible for compliance with local laws. This Agreement, all use of this website and any claims and damages resulting from use of this website are governed solely by the laws of the State of California without regard to any principles which would apply the laws of a different jurisdiction. The user agrees that any disputes regarding this website shall be resolved solely in the courts located in Santa Clara County, California. The user agrees said courts have personal jurisdiction and agree to waive any right to transfer the dispute to any other forum.
+ Modification by Unicode, Inc. Unicode, Inc. shall have the right to modify this Agreement at any time by posting it to this website. The user may not assign any part of this Agreement without Unicode, Inc.’s prior written consent.
+ Taxes. The user agrees to pay any taxes arising from access to this website or use of the information herein, except for those based on Unicode’s net income.
+ Severability. If any provision of this Agreement is declared invalid or unenforceable, the remaining provisions of this Agreement shall remain in effect.
+ Entire Agreement. This Agreement constitutes the entire agreement between the parties.
+
+```
+
diff --git a/java/temurin-17/legal/java.base/public_suffix.md b/java/temurin-17/legal/java.base/public_suffix.md
new file mode 100644
index 0000000..d228ac2
--- /dev/null
+++ b/java/temurin-17/legal/java.base/public_suffix.md
@@ -0,0 +1,399 @@
+## Mozilla Public Suffix List
+
+### Public Suffix Notice
+```
+You are receiving a copy of the Mozilla Public Suffix List in the following
+file: <java-home>/lib/security/public_suffix_list.dat. The terms of the
+Oracle license do NOT apply to this file; it is licensed under the
+Mozilla Public License 2.0, separately from the Oracle programs you receive.
+If you do not wish to use the Public Suffix List, you may remove the
+<java-home>/lib/security/public_suffix_list.dat file.
+
+The Source Code of this file is available under the
+Mozilla Public License, v. 2.0 and is located at
+https://raw.githubusercontent.com/publicsuffix/list/88467c960d6cdad2ca1623e892e5e17506bc269f/public_suffix_list.dat.
+If a copy of the MPL was not distributed with this file, you can obtain one
+at https://mozilla.org/MPL/2.0/.
+
+Software distributed under the License is distributed on an "AS IS" basis,
+WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+for the specific language governing rights and limitations under the License.
+```
+
+### MPL v2.0
+```
+Mozilla Public License Version 2.0
+==================================
+
+1. Definitions
+--------------
+
+1.1. "Contributor"
+ means each individual or legal entity that creates, contributes to
+ the creation of, or owns Covered Software.
+
+1.2. "Contributor Version"
+ means the combination of the Contributions of others (if any) used
+ by a Contributor and that particular Contributor's Contribution.
+
+1.3. "Contribution"
+ means Covered Software of a particular Contributor.
+
+1.4. "Covered Software"
+ means Source Code Form to which the initial Contributor has attached
+ the notice in Exhibit A, the Executable Form of such Source Code
+ Form, and Modifications of such Source Code Form, in each case
+ including portions thereof.
+
+1.5. "Incompatible With Secondary Licenses"
+ means
+
+ (a) that the initial Contributor has attached the notice described
+ in Exhibit B to the Covered Software; or
+
+ (b) that the Covered Software was made available under the terms of
+ version 1.1 or earlier of the License, but not also under the
+ terms of a Secondary License.
+
+1.6. "Executable Form"
+ means any form of the work other than Source Code Form.
+
+1.7. "Larger Work"
+ means a work that combines Covered Software with other material, in
+ a separate file or files, that is not Covered Software.
+
+1.8. "License"
+ means this document.
+
+1.9. "Licensable"
+ means having the right to grant, to the maximum extent possible,
+ whether at the time of the initial grant or subsequently, any and
+ all of the rights conveyed by this License.
+
+1.10. "Modifications"
+ means any of the following:
+
+ (a) any file in Source Code Form that results from an addition to,
+ deletion from, or modification of the contents of Covered
+ Software; or
+
+ (b) any new file in Source Code Form that contains any Covered
+ Software.
+
+1.11. "Patent Claims" of a Contributor
+ means any patent claim(s), including without limitation, method,
+ process, and apparatus claims, in any patent Licensable by such
+ Contributor that would be infringed, but for the grant of the
+ License, by the making, using, selling, offering for sale, having
+ made, import, or transfer of either its Contributions or its
+ Contributor Version.
+
+1.12. "Secondary License"
+ means either the GNU General Public License, Version 2.0, the GNU
+ Lesser General Public License, Version 2.1, the GNU Affero General
+ Public License, Version 3.0, or any later versions of those
+ licenses.
+
+1.13. "Source Code Form"
+ means the form of the work preferred for making modifications.
+
+1.14. "You" (or "Your")
+ means an individual or a legal entity exercising rights under this
+ License. For legal entities, "You" includes any entity that
+ controls, is controlled by, or is under common control with You. For
+ purposes of this definition, "control" means (a) the power, direct
+ or indirect, to cause the direction or management of such entity,
+ whether by contract or otherwise, or (b) ownership of more than
+ fifty percent (50%) of the outstanding shares or beneficial
+ ownership of such entity.
+
+2. License Grants and Conditions
+--------------------------------
+
+2.1. Grants
+
+Each Contributor hereby grants You a world-wide, royalty-free,
+non-exclusive license:
+
+(a) under intellectual property rights (other than patent or trademark)
+ Licensable by such Contributor to use, reproduce, make available,
+ modify, display, perform, distribute, and otherwise exploit its
+ Contributions, either on an unmodified basis, with Modifications, or
+ as part of a Larger Work; and
+
+(b) under Patent Claims of such Contributor to make, use, sell, offer
+ for sale, have made, import, and otherwise transfer either its
+ Contributions or its Contributor Version.
+
+2.2. Effective Date
+
+The licenses granted in Section 2.1 with respect to any Contribution
+become effective for each Contribution on the date the Contributor first
+distributes such Contribution.
+
+2.3. Limitations on Grant Scope
+
+The licenses granted in this Section 2 are the only rights granted under
+this License. No additional rights or licenses will be implied from the
+distribution or licensing of Covered Software under this License.
+Notwithstanding Section 2.1(b) above, no patent license is granted by a
+Contributor:
+
+(a) for any code that a Contributor has removed from Covered Software;
+ or
+
+(b) for infringements caused by: (i) Your and any other third party's
+ modifications of Covered Software, or (ii) the combination of its
+ Contributions with other software (except as part of its Contributor
+ Version); or
+
+(c) under Patent Claims infringed by Covered Software in the absence of
+ its Contributions.
+
+This License does not grant any rights in the trademarks, service marks,
+or logos of any Contributor (except as may be necessary to comply with
+the notice requirements in Section 3.4).
+
+2.4. Subsequent Licenses
+
+No Contributor makes additional grants as a result of Your choice to
+distribute the Covered Software under a subsequent version of this
+License (see Section 10.2) or under the terms of a Secondary License (if
+permitted under the terms of Section 3.3).
+
+2.5. Representation
+
+Each Contributor represents that the Contributor believes its
+Contributions are its original creation(s) or it has sufficient rights
+to grant the rights to its Contributions conveyed by this License.
+
+2.6. Fair Use
+
+This License is not intended to limit any rights You have under
+applicable copyright doctrines of fair use, fair dealing, or other
+equivalents.
+
+2.7. Conditions
+
+Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
+in Section 2.1.
+
+3. Responsibilities
+-------------------
+
+3.1. Distribution of Source Form
+
+All distribution of Covered Software in Source Code Form, including any
+Modifications that You create or to which You contribute, must be under
+the terms of this License. You must inform recipients that the Source
+Code Form of the Covered Software is governed by the terms of this
+License, and how they can obtain a copy of this License. You may not
+attempt to alter or restrict the recipients' rights in the Source Code
+Form.
+
+3.2. Distribution of Executable Form
+
+If You distribute Covered Software in Executable Form then:
+
+(a) such Covered Software must also be made available in Source Code
+ Form, as described in Section 3.1, and You must inform recipients of
+ the Executable Form how they can obtain a copy of such Source Code
+ Form by reasonable means in a timely manner, at a charge no more
+ than the cost of distribution to the recipient; and
+
+(b) You may distribute such Executable Form under the terms of this
+ License, or sublicense it under different terms, provided that the
+ license for the Executable Form does not attempt to limit or alter
+ the recipients' rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+You may create and distribute a Larger Work under terms of Your choice,
+provided that You also comply with the requirements of this License for
+the Covered Software. If the Larger Work is a combination of Covered
+Software with a work governed by one or more Secondary Licenses, and the
+Covered Software is not Incompatible With Secondary Licenses, this
+License permits You to additionally distribute such Covered Software
+under the terms of such Secondary License(s), so that the recipient of
+the Larger Work may, at their option, further distribute the Covered
+Software under the terms of either this License or such Secondary
+License(s).
+
+3.4. Notices
+
+You may not remove or alter the substance of any license notices
+(including copyright notices, patent notices, disclaimers of warranty,
+or limitations of liability) contained within the Source Code Form of
+the Covered Software, except that You may alter any license notices to
+the extent required to remedy known factual inaccuracies.
+
+3.5. Application of Additional Terms
+
+You may choose to offer, and to charge a fee for, warranty, support,
+indemnity or liability obligations to one or more recipients of Covered
+Software. However, You may do so only on Your own behalf, and not on
+behalf of any Contributor. You must make it absolutely clear that any
+such warranty, support, indemnity, or liability obligation is offered by
+You alone, and You hereby agree to indemnify every Contributor for any
+liability incurred by such Contributor as a result of warranty, support,
+indemnity or liability terms You offer. You may include additional
+disclaimers of warranty and limitations of liability specific to any
+jurisdiction.
+
+4. Inability to Comply Due to Statute or Regulation
+---------------------------------------------------
+
+If it is impossible for You to comply with any of the terms of this
+License with respect to some or all of the Covered Software due to
+statute, judicial order, or regulation then You must: (a) comply with
+the terms of this License to the maximum extent possible; and (b)
+describe the limitations and the code they affect. Such description must
+be placed in a text file included with all distributions of the Covered
+Software under this License. Except to the extent prohibited by statute
+or regulation, such description must be sufficiently detailed for a
+recipient of ordinary skill to be able to understand it.
+
+5. Termination
+--------------
+
+5.1. The rights granted under this License will terminate automatically
+if You fail to comply with any of its terms. However, if You become
+compliant, then the rights granted under this License from a particular
+Contributor are reinstated (a) provisionally, unless and until such
+Contributor explicitly and finally terminates Your grants, and (b) on an
+ongoing basis, if such Contributor fails to notify You of the
+non-compliance by some reasonable means prior to 60 days after You have
+come back into compliance. Moreover, Your grants from a particular
+Contributor are reinstated on an ongoing basis if such Contributor
+notifies You of the non-compliance by some reasonable means, this is the
+first time You have received notice of non-compliance with this License
+from such Contributor, and You become compliant prior to 30 days after
+Your receipt of the notice.
+
+5.2. If You initiate litigation against any entity by asserting a patent
+infringement claim (excluding declaratory judgment actions,
+counter-claims, and cross-claims) alleging that a Contributor Version
+directly or indirectly infringes any patent, then the rights granted to
+You by any and all Contributors for the Covered Software under Section
+2.1 of this License shall terminate.
+
+5.3. In the event of termination under Sections 5.1 or 5.2 above, all
+end user license agreements (excluding distributors and resellers) which
+have been validly granted by You or Your distributors under this License
+prior to termination shall survive termination.
+
+************************************************************************
+* *
+* 6. Disclaimer of Warranty *
+* ------------------------- *
+* *
+* Covered Software is provided under this License on an "as is" *
+* basis, without warranty of any kind, either expressed, implied, or *
+* statutory, including, without limitation, warranties that the *
+* Covered Software is free of defects, merchantable, fit for a *
+* particular purpose or non-infringing. The entire risk as to the *
+* quality and performance of the Covered Software is with You. *
+* Should any Covered Software prove defective in any respect, You *
+* (not any Contributor) assume the cost of any necessary servicing, *
+* repair, or correction. This disclaimer of warranty constitutes an *
+* essential part of this License. No use of any Covered Software is *
+* authorized under this License except under this disclaimer. *
+* *
+************************************************************************
+
+************************************************************************
+* *
+* 7. Limitation of Liability *
+* -------------------------- *
+* *
+* Under no circumstances and under no legal theory, whether tort *
+* (including negligence), contract, or otherwise, shall any *
+* Contributor, or anyone who distributes Covered Software as *
+* permitted above, be liable to You for any direct, indirect, *
+* special, incidental, or consequential damages of any character *
+* including, without limitation, damages for lost profits, loss of *
+* goodwill, work stoppage, computer failure or malfunction, or any *
+* and all other commercial damages or losses, even if such party *
+* shall have been informed of the possibility of such damages. This *
+* limitation of liability shall not apply to liability for death or *
+* personal injury resulting from such party's negligence to the *
+* extent applicable law prohibits such limitation. Some *
+* jurisdictions do not allow the exclusion or limitation of *
+* incidental or consequential damages, so this exclusion and *
+* limitation may not apply to You. *
+* *
+************************************************************************
+
+8. Litigation
+-------------
+
+Any litigation relating to this License may be brought only in the
+courts of a jurisdiction where the defendant maintains its principal
+place of business and such litigation shall be governed by laws of that
+jurisdiction, without reference to its conflict-of-law provisions.
+Nothing in this Section shall prevent a party's ability to bring
+cross-claims or counter-claims.
+
+9. Miscellaneous
+----------------
+
+This License represents the complete agreement concerning the subject
+matter hereof. If any provision of this License is held to be
+unenforceable, such provision shall be reformed only to the extent
+necessary to make it enforceable. Any law or regulation which provides
+that the language of a contract shall be construed against the drafter
+shall not be used to construe this License against a Contributor.
+
+10. Versions of the License
+---------------------------
+
+10.1. New Versions
+
+Mozilla Foundation is the license steward. Except as provided in Section
+10.3, no one other than the license steward has the right to modify or
+publish new versions of this License. Each version will be given a
+distinguishing version number.
+
+10.2. Effect of New Versions
+
+You may distribute the Covered Software under the terms of the version
+of the License under which You originally received the Covered Software,
+or under the terms of any subsequent version published by the license
+steward.
+
+10.3. Modified Versions
+
+If you create software not governed by this License, and you want to
+create a new license for such software, you may create and use a
+modified version of this License if you rename the license and remove
+any references to the name of the license steward (except to note that
+such modified license differs from this License).
+
+10.4. Distributing Source Code Form that is Incompatible With Secondary
+Licenses
+
+If You choose to distribute Source Code Form that is Incompatible With
+Secondary Licenses under the terms of this version of the License, the
+notice described in Exhibit B of this License must be attached.
+
+Exhibit A - Source Code Form License Notice
+-------------------------------------------
+
+ This Source Code Form is subject to the terms of the Mozilla Public
+ License, v. 2.0. If a copy of the MPL was not distributed with this
+ file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+If it is not possible or desirable to put the notice in a particular
+file, then You may include the notice in a location (such as a LICENSE
+file in a relevant directory) where a recipient would be likely to look
+for such a notice.
+
+You may add additional accurate notices of copyright ownership.
+
+Exhibit B - "Incompatible With Secondary Licenses" Notice
+---------------------------------------------------------
+
+ This Source Code Form is "Incompatible With Secondary Licenses", as
+ defined by the Mozilla Public License, v. 2.0.
+
+```
diff --git a/java/temurin-17/legal/java.base/unicode.md b/java/temurin-17/legal/java.base/unicode.md
new file mode 100644
index 0000000..cff0c82
--- /dev/null
+++ b/java/temurin-17/legal/java.base/unicode.md
@@ -0,0 +1,54 @@
+## The Unicode Standard, Unicode Character Database, Version 13.0.0
+
+### Unicode Character Database
+```
+
+UNICODE, INC. LICENSE AGREEMENT - DATA FILES AND SOFTWARE
+
+See Terms of Use for definitions of Unicode Inc.'s
+Data Files and Software.
+
+NOTICE TO USER: Carefully read the following legal agreement.
+BY DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING UNICODE INC.'S
+DATA FILES ("DATA FILES"), AND/OR SOFTWARE ("SOFTWARE"),
+YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+TERMS AND CONDITIONS OF THIS AGREEMENT.
+IF YOU DO NOT AGREE, DO NOT DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE
+THE DATA FILES OR SOFTWARE.
+
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright © 1991-2020 Unicode, Inc. All rights reserved.
+Distributed under the Terms of Use in https://www.unicode.org/copyright.html.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Unicode data files and any associated documentation
+(the "Data Files") or Unicode software and any associated documentation
+(the "Software") to deal in the Data Files or Software
+without restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, and/or sell copies of
+the Data Files or Software, and to permit persons to whom the Data Files
+or Software are furnished to do so, provided that either
+(a) this copyright and permission notice appear with all copies
+of the Data Files or Software, or
+(b) this copyright and permission notice appear in associated
+Documentation.
+
+THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT OF THIRD PARTY RIGHTS.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS
+NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL
+DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THE DATA FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder
+shall not be used in advertising or otherwise to promote the sale,
+use or other dealings in these Data Files or Software without prior
+written authorization of the copyright holder.
+
+```
+
diff --git a/java/temurin-17/legal/java.base/zlib.md b/java/temurin-17/legal/java.base/zlib.md
new file mode 100644
index 0000000..d856af6
--- /dev/null
+++ b/java/temurin-17/legal/java.base/zlib.md
@@ -0,0 +1,27 @@
+## zlib v1.2.13
+
+### zlib License
+<pre>
+
+Copyright (C) 1995-2022 Jean-loup Gailly and Mark Adler
+
+This software is provided 'as-is', without any express or implied
+warranty. In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+ claim that you wrote the original software. If you use this software
+ in a product, an acknowledgment in the product documentation would be
+ appreciated but is not required.
+2. Altered source versions must be plainly marked as such, and must not be
+ misrepresented as being the original software.
+3. This notice may not be removed or altered from any source distribution.
+
+Jean-loup Gailly Mark Adler
+jloup@gzip.org madler@alumni.caltech.edu
+
+</pre>
diff --git a/java/temurin-17/legal/java.compiler/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.compiler/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.compiler/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.compiler/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.compiler/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.compiler/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.compiler/LICENSE b/java/temurin-17/legal/java.compiler/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.compiler/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.datatransfer/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.datatransfer/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.datatransfer/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.datatransfer/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.datatransfer/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.datatransfer/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.datatransfer/LICENSE b/java/temurin-17/legal/java.datatransfer/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.datatransfer/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.desktop/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.desktop/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.desktop/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.desktop/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.desktop/LICENSE b/java/temurin-17/legal/java.desktop/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.desktop/colorimaging.md b/java/temurin-17/legal/java.desktop/colorimaging.md
new file mode 100644
index 0000000..eeb9932
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/colorimaging.md
@@ -0,0 +1,7 @@
+## Eastman Kodak Company: Portions of color management and imaging software
+
+### Eastman Kodak Notice
+<pre>
+Portions Copyright Eastman Kodak Company 1991-2003
+</pre>
+
diff --git a/java/temurin-17/legal/java.desktop/giflib.md b/java/temurin-17/legal/java.desktop/giflib.md
new file mode 100644
index 0000000..0be4fb8
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/giflib.md
@@ -0,0 +1,30 @@
+## GIFLIB v5.2.1
+
+### GIFLIB License
+```
+
+The GIFLIB distribution is Copyright (c) 1997 Eric S. Raymond
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+https://sourceforge.net/p/giflib/code/ci/master/tree/openbsd-reallocarray.c
+
+Copyright (c) 2008 Otto Moerbeek <otto@drijf.net>
+SPDX-License-Identifier: MIT
diff --git a/java/temurin-17/legal/java.desktop/harfbuzz.md b/java/temurin-17/legal/java.desktop/harfbuzz.md
new file mode 100644
index 0000000..e2ed76a
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/harfbuzz.md
@@ -0,0 +1,95 @@
+## Harfbuzz v7.2.0
+
+### Harfbuzz License
+
+https://github.com/harfbuzz/harfbuzz/blob/7.2.0/COPYING
+
+<pre>
+
+HarfBuzz is licensed under the so-called "Old MIT" license. Details follow.
+For parts of HarfBuzz that are licensed under different licenses see individual
+files names COPYING in subdirectories where applicable.
+
+Copyright © 2010-2023 Google, Inc.
+Copyright © 2018-2020 Ebrahim Byagowi
+Copyright © 2004-2013 Red Hat, Inc.
+Copyright © 2019 Facebook, Inc.
+Copyright © 2007 Chris Wilson
+Copyright © 2018-2019 Adobe Inc.
+Copyright © 2006-2023 Behdad Esfahbod
+Copyright © 1998-2004 David Turner and Werner Lemberg
+Copyright © 2009 Keith Stribley
+Copyright © 2018 Khaled Hosny
+Copyright © 2016 Elie Roux <elie.roux@telecom-bretagne.eu>
+Copyright © 2016 Igalia S.L.
+Copyright © 2015 Mozilla Foundation.
+Copyright © 1999 David Turner
+Copyright © 2005 Werner Lemberg
+Copyright © 2013-2015 Alexei Podtelezhnikov
+Copyright © 2022 Matthias Clasen
+Copyright © 2011 Codethink Limited
+
+For full copyright notices consult the individual files in the package.
+
+
+Permission is hereby granted, without written agreement and without
+license or royalty fees, to use, copy, modify, and distribute this
+software and its documentation for any purpose, provided that the
+above copyright notice and the following two paragraphs appear in
+all copies of this software.
+
+IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
+DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
+ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
+IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGE.
+
+THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
+BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
+ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
+PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
+
+All source code, except for one section, is licensed as above. The one
+exception is licensed with a slightly different MIT variant:
+The contents of this directory are licensed under the following terms:
+
+---------------------------------
+The below license applies to the following files:
+libharfbuzz/hb-ucd.cc
+
+Copyright (C) 2012 Grigori Goronzy <greg@kinoho.net>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+</pre>
+
+### AUTHORS File Information
+```
+
+Behdad Esfahbod
+David Corbett
+David Turner
+Ebrahim Byagowi
+Garret Rieger
+Jonathan Kew
+Khaled Hosny
+Lars Knoll
+Martin Hosken
+Owen Taylor
+Roderick Sheeter
+Roozbeh Pournader
+Simon Hausmann
+Werner Lemberg
+
+```
diff --git a/java/temurin-17/legal/java.desktop/jpeg.md b/java/temurin-17/legal/java.desktop/jpeg.md
new file mode 100644
index 0000000..1a0d41c
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/jpeg.md
@@ -0,0 +1,77 @@
+## Independent JPEG Group: JPEG release 6b
+
+### JPEG License
+
+```
+****************************************************************************
+
+Copyright (C) 1991-1998, Thomas G. Lane.
+
+This software is the work of Tom Lane, Philip Gladstone, Jim Boucher,
+Lee Crocker, Julian Minguillon, Luis Ortiz, George Phillips, Davide Rossi,
+Guido Vollbeding, Ge' Weijers, and other members of the Independent JPEG
+Group.
+
+IJG is not affiliated with the official ISO JPEG standards committee.
+
+The authors make NO WARRANTY or representation, either express or implied,
+with respect to this software, its quality, accuracy, merchantability, or
+fitness for a particular purpose. This software is provided "AS IS",
+and you, its user, assume the entire risk as to its quality and accuracy.
+
+This software is copyright (C) 1991-1998, Thomas G. Lane.
+All Rights Reserved except as specified below.
+
+Permission is hereby granted to use, copy, modify, and distribute
+this software (or portions thereof) for any purpose, without fee,
+subject to these conditions:
+
+(1) If any part of the source code for this software is distributed,
+then this README file must be included, with this copyright and no-warranty
+notice unaltered; and any additions, deletions, or changes to the original
+files must be clearly indicated in accompanying documentation.
+
+(2) If only executable code is distributed, then the accompanying documentation
+must state that "this software is based in part on the work of the
+Independent JPEG Group".
+
+(3) Permission for use of this software is granted only if the user accepts
+full responsibility for any undesirable consequences; the authors accept
+NO LIABILITY for damages of any kind.
+
+These conditions apply to any software derived from or based on the IJG code,
+not just to the unmodified library. If you use our work, you ought to
+acknowledge us.
+
+Permission is NOT granted for the use of any IJG author's name or company name
+in advertising or publicity relating to this software or products derived
+from it. This software may be referred to only as "the Independent JPEG
+Group's software".
+
+We specifically permit and encourage the use of this software as the basis
+of commercial products, provided that all warranty or liability claims are
+assumed by the product vendor.
+
+It appears that the arithmetic coding option of the JPEG spec is covered
+by patents owned by IBM, AT&T, and Mitsubishi. Hence arithmetic coding
+cannot legally be used without obtaining one or more licenses. For this
+reason, support for arithmetic coding has been removed from the free
+JPEG software. (Since arithmetic coding provides only a marginal gain
+over the unpatented Huffman mode, it is unlikely that very many
+implementations will support it.) So far as we are aware, there are
+no patent restrictions on the remaining code.
+
+The IJG distribution formerly included code to read and write GIF files.
+To avoid entanglement with the Unisys LZW patent, GIF reading support
+has been removed altogether, and the GIF writer has been simplified to
+produce "uncompressed GIFs". This technique does not use the LZW algorithm;
+the resulting GIF files are larger than usual, but are readable by all
+standard GIF decoders.
+
+We are required to state that "The Graphics Interchange Format(c) is
+the Copyright property of CompuServe Incorporated. GIF(sm) is a
+Service Mark property of CompuServe Incorporated."
+
+****************************************************************************
+```
+
diff --git a/java/temurin-17/legal/java.desktop/lcms.md b/java/temurin-17/legal/java.desktop/lcms.md
new file mode 100644
index 0000000..da86a9c
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/lcms.md
@@ -0,0 +1,108 @@
+## Little Color Management System (LCMS) v2.15
+
+### LCMS License
+<pre>
+README.1ST file information
+
+LittleCMS core is released under MIT License
+
+---------------------------------
+
+Little CMS
+Copyright (c) 1998-2023 Marti Maria Saguer
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject
+to the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---------------------------------
+The below license applies to the following files:
+liblcms/cmssm.c
+
+Copyright 2001, softSurfer (www.softsurfer.com)
+
+This code may be freely used and modified for any purpose
+providing that this copyright notice is included with it.
+SoftSurfer makes no warranty for this code, and cannot be held
+liable for any real or imagined damage resulting from its use.
+Users of this code must verify correctness for their application.
+
+</pre>
+
+### AUTHORS File Information
+```
+
+
+Main Author
+------------
+Marti Maria
+
+
+Contributors
+------------
+Bob Friesenhahn
+Kai-Uwe Behrmann
+Stuart Nixon
+Jordi Vilar
+Richard Hughes
+Auke Nauta
+Chris Evans (Google)
+Lorenzo Ridolfi
+Robin Watts (Artifex)
+Shawn Pedersen
+Andrew Brygin
+Samuli Suominen
+Florian Hˆch
+Aurelien Jarno
+Claudiu Cebuc
+Michael Vhrel (Artifex)
+Michal Cihar
+Daniel Kaneider
+Mateusz Jurczyk (Google)
+Paul Miller
+SÈbastien LÈon
+Christian Schmitz
+XhmikosR
+Stanislav Brabec (SuSe)
+Leonhard Gruenschloss (Google)
+Patrick Noffke
+Christopher James Halse Rogers
+John Hein
+Thomas Weber (Debian)
+Mark Allen
+Noel Carboni
+Sergei Trofimovic
+Philipp Knechtges
+Amyspark
+Lovell Fuller
+Eli Schwartz
+
+Special Thanks
+--------------
+Artifex software
+AlienSkin software
+libVIPS
+Jan Morovic
+Jos Vernon (WebSupergoo)
+Harald Schneider (Maxon)
+Christian Albrecht
+Dimitrios Anastassakis
+Lemke Software
+Tim Zaman
+
+```
diff --git a/java/temurin-17/legal/java.desktop/libpng.md b/java/temurin-17/legal/java.desktop/libpng.md
new file mode 100644
index 0000000..f11cfe5
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/libpng.md
@@ -0,0 +1,204 @@
+## libpng v1.6.39
+
+### libpng License
+<pre>
+
+COPYRIGHT NOTICE, DISCLAIMER, and LICENSE
+=========================================
+
+PNG Reference Library License version 2
+---------------------------------------
+
+Copyright (c) 1995-2022 The PNG Reference Library Authors.
+Copyright (c) 2018-2022 Cosmin Truta
+Copyright (c) 1998-2018 Glenn Randers-Pehrson
+Copyright (c) 1996-1997 Andreas Dilger
+Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.
+
+The software is supplied "as is", without warranty of any kind,
+express or implied, including, without limitation, the warranties
+of merchantability, fitness for a particular purpose, title, and
+non-infringement. In no event shall the Copyright owners, or
+anyone distributing the software, be liable for any damages or
+other liability, whether in contract, tort or otherwise, arising
+from, out of, or in connection with the software, or the use or
+other dealings in the software, even if advised of the possibility
+of such damage.
+
+Permission is hereby granted to use, copy, modify, and distribute
+this software, or portions hereof, for any purpose, without fee,
+subject to the following restrictions:
+
+ 1. The origin of this software must not be misrepresented; you
+ must not claim that you wrote the original software. If you
+ use this software in a product, an acknowledgment in the product
+ documentation would be appreciated, but is not required.
+
+ 2. Altered source versions must be plainly marked as such, and must
+ not be misrepresented as being the original software.
+
+ 3. This Copyright notice may not be removed or altered from any
+ source or altered source distribution.
+
+
+PNG Reference Library License version 1 (for libpng 0.5 through 1.6.35)
+-----------------------------------------------------------------------
+
+libpng versions 1.0.7, July 1, 2000, through 1.6.35, July 15, 2018 are
+Copyright (c) 2000-2002, 2004, 2006-2018 Glenn Randers-Pehrson, are
+derived from libpng-1.0.6, and are distributed according to the same
+disclaimer and license as libpng-1.0.6 with the following individuals
+added to the list of Contributing Authors:
+
+ Simon-Pierre Cadieux
+ Eric S. Raymond
+ Mans Rullgard
+ Cosmin Truta
+ Gilles Vollant
+ James Yu
+ Mandar Sahastrabuddhe
+ Google Inc.
+ Vadim Barkov
+
+and with the following additions to the disclaimer:
+
+ There is no warranty against interference with your enjoyment of
+ the library or against infringement. There is no warranty that our
+ efforts or the library will fulfill any of your particular purposes
+ or needs. This library is provided with all faults, and the entire
+ risk of satisfactory quality, performance, accuracy, and effort is
+ with the user.
+
+Some files in the "contrib" directory and some configure-generated
+files that are distributed with libpng have other copyright owners, and
+are released under other open source licenses.
+
+libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
+Copyright (c) 1998-2000 Glenn Randers-Pehrson, are derived from
+libpng-0.96, and are distributed according to the same disclaimer and
+license as libpng-0.96, with the following individuals added to the
+list of Contributing Authors:
+
+ Tom Lane
+ Glenn Randers-Pehrson
+ Willem van Schaik
+
+libpng versions 0.89, June 1996, through 0.96, May 1997, are
+Copyright (c) 1996-1997 Andreas Dilger, are derived from libpng-0.88,
+and are distributed according to the same disclaimer and license as
+libpng-0.88, with the following individuals added to the list of
+Contributing Authors:
+
+ John Bowler
+ Kevin Bracey
+ Sam Bushell
+ Magnus Holmgren
+ Greg Roelofs
+ Tom Tanner
+
+Some files in the "scripts" directory have other copyright owners,
+but are released under this license.
+
+libpng versions 0.5, May 1995, through 0.88, January 1996, are
+Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.
+
+For the purposes of this copyright and license, "Contributing Authors"
+is defined as the following set of individuals:
+
+ Andreas Dilger
+ Dave Martindale
+ Guy Eric Schalnat
+ Paul Schmidt
+ Tim Wegner
+
+The PNG Reference Library is supplied "AS IS". The Contributing
+Authors and Group 42, Inc. disclaim all warranties, expressed or
+implied, including, without limitation, the warranties of
+merchantability and of fitness for any purpose. The Contributing
+Authors and Group 42, Inc. assume no liability for direct, indirect,
+incidental, special, exemplary, or consequential damages, which may
+result from the use of the PNG Reference Library, even if advised of
+the possibility of such damage.
+
+Permission is hereby granted to use, copy, modify, and distribute this
+source code, or portions hereof, for any purpose, without fee, subject
+to the following restrictions:
+
+ 1. The origin of this source code must not be misrepresented.
+
+ 2. Altered versions must be plainly marked as such and must not
+ be misrepresented as being the original source.
+
+ 3. This Copyright notice may not be removed or altered from any
+ source or altered source distribution.
+
+The Contributing Authors and Group 42, Inc. specifically permit,
+without fee, and encourage the use of this source code as a component
+to supporting the PNG file format in commercial products. If you use
+this source code in a product, acknowledgment is not required but would
+be appreciated.
+
+TRADEMARK
+=========
+
+The name "libpng" has not been registered by the Copyright owners
+as a trademark in any jurisdiction. However, because libpng has
+been distributed and maintained world-wide, continually since 1995,
+the Copyright owners claim "common-law trademark protection" in any
+jurisdiction where common-law trademark is recognized.
+
+</pre>
+
+### AUTHORS File Information
+```
+PNG REFERENCE LIBRARY AUTHORS
+=============================
+
+This is the list of PNG Reference Library ("libpng") Contributing
+Authors, for copyright and licensing purposes.
+
+ * Andreas Dilger
+ * Cosmin Truta
+ * Dave Martindale
+ * Eric S. Raymond
+ * Gilles Vollant
+ * Glenn Randers-Pehrson
+ * Greg Roelofs
+ * Guy Eric Schalnat
+ * James Yu
+ * John Bowler
+ * Kevin Bracey
+ * Magnus Holmgren
+ * Mandar Sahastrabuddhe
+ * Mans Rullgard
+ * Matt Sarett
+ * Mike Klein
+ * Pascal Massimino
+ * Paul Schmidt
+ * Qiang Zhou
+ * Sam Bushell
+ * Samuel Williams
+ * Simon-Pierre Cadieux
+ * Tim Wegner
+ * Tom Lane
+ * Tom Tanner
+ * Vadim Barkov
+ * Willem van Schaik
+ * Zhijie Liang
+ * Arm Holdings
+ - Richard Townsend
+ * Google Inc.
+ - Dan Field
+ - Leon Scroggins III
+ - Matt Sarett
+ - Mike Klein
+ - Sami Boukortt
+
+The build projects, the build scripts, the test scripts, and other
+files in the "ci", "projects", "scripts" and "tests" directories, have
+other copyright owners, but are released under the libpng license.
+
+Some files in the "contrib" directory, and some tools-generated files
+that are distributed with libpng, have other copyright owners, and are
+released under other open source licenses.
+```
diff --git a/java/temurin-17/legal/java.desktop/mesa3d.md b/java/temurin-17/legal/java.desktop/mesa3d.md
new file mode 100644
index 0000000..cdaa1ac
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/mesa3d.md
@@ -0,0 +1,134 @@
+## Mesa 3-D Graphics Library v21.0.3
+
+### Mesa License
+
+```
+Copyright (C) 1999-2007 Brian Paul All Rights Reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Attention, Contributors
+
+When contributing to the Mesa project you must agree to the licensing terms
+of the component to which you're contributing.
+The following section lists the primary components of the Mesa distribution
+and their respective licenses.
+Mesa Component Licenses
+
+
+
+Component Location License
+------------------------------------------------------------------
+Main Mesa code src/mesa/ MIT
+Device drivers src/mesa/drivers/* MIT, generally
+
+Gallium code src/gallium/ MIT
+
+Ext headers GL/glext.h Khronos
+ GL/glxext.h Khronos
+ GL/wglext.h Khronos
+ KHR/khrplatform.h Khronos
+
+*****************************************************************************
+
+----
+include/GL/gl.h :
+
+
+ Mesa 3-D graphics library
+
+ Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
+ Copyright (C) 2009 VMware, Inc. All Rights Reserved.
+
+ Permission is hereby granted, free of charge, to any person obtaining a
+ copy of this software and associated documentation files (the "Software"),
+ to deal in the Software without restriction, including without limitation
+ the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ and/or sell copies of the Software, and to permit persons to whom the
+ Software is furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice shall be included
+ in all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+ OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ OTHER DEALINGS IN THE SOFTWARE.
+
+ *****************************************************************************
+
+----
+include/GL/glext.h
+include/GL/glxext.h
+include/GL/wglxext.h :
+
+
+ Copyright (c) 2013 - 2018 The Khronos Group Inc.
+
+ Permission is hereby granted, free of charge, to any person obtaining a
+ copy of this software and/or associated documentation files (the
+ "Materials"), to deal in the Materials without restriction, including
+ without limitation the rights to use, copy, modify, merge, publish,
+ distribute, sublicense, and/or sell copies of the Materials, and to
+ permit persons to whom the Materials are furnished to do so, subject to
+ the following conditions:
+
+ The above copyright notice and this permission notice shall be included
+ in all copies or substantial portions of the Materials.
+
+ THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
+
+ *****************************************************************************
+
+----
+include/KHR/khrplatform.h :
+
+ Copyright (c) 2008 - 2018 The Khronos Group Inc.
+
+ Permission is hereby granted, free of charge, to any person obtaining a
+ copy of this software and/or associated documentation files (the
+ "Materials"), to deal in the Materials without restriction, including
+ without limitation the rights to use, copy, modify, merge, publish,
+ distribute, sublicense, and/or sell copies of the Materials, and to
+ permit persons to whom the Materials are furnished to do so, subject to
+ the following conditions:
+
+ The above copyright notice and this permission notice shall be included
+ in all copies or substantial portions of the Materials.
+
+ THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
+
+ *****************************************************************************
+
+```
diff --git a/java/temurin-17/legal/java.desktop/xwd.md b/java/temurin-17/legal/java.desktop/xwd.md
new file mode 100644
index 0000000..f3c5327
--- /dev/null
+++ b/java/temurin-17/legal/java.desktop/xwd.md
@@ -0,0 +1,34 @@
+## xwd v1.0.7
+
+### xwd utility
+<pre>
+
+This is the copyright for the files in src/java.desktop/unix/native/libawt_xawt:
+list.h, multiVis.h, wsutils.h, list.c, multiVis.c
+
+Copyright 1994 Hewlett-Packard Co.
+Copyright 1996, 1998 The Open Group
+
+Permission to use, copy, modify, distribute, and sell this software and its
+documentation for any purpose is hereby granted without fee, provided that
+the above copyright notice appear in all copies and that both that
+copyright notice and this permission notice appear in supporting
+documentation.
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+Except as contained in this notice, the name of The Open Group shall
+not be used in advertising or otherwise to promote the sale, use or
+other dealings in this Software without prior written authorization
+from The Open Group.
+
+</pre>
diff --git a/java/temurin-17/legal/java.instrument/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.instrument/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.instrument/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.instrument/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.instrument/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.instrument/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.instrument/LICENSE b/java/temurin-17/legal/java.instrument/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.instrument/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.logging/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.logging/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.logging/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.logging/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.logging/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.logging/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.logging/LICENSE b/java/temurin-17/legal/java.logging/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.logging/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.management.rmi/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.management.rmi/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.management.rmi/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.management.rmi/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.management.rmi/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.management.rmi/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.management.rmi/LICENSE b/java/temurin-17/legal/java.management.rmi/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.management.rmi/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.management/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.management/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.management/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.management/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.management/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.management/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.management/LICENSE b/java/temurin-17/legal/java.management/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.management/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.naming/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.naming/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.naming/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.naming/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.naming/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.naming/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.naming/LICENSE b/java/temurin-17/legal/java.naming/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.naming/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.net.http/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.net.http/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.net.http/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.net.http/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.net.http/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.net.http/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.net.http/LICENSE b/java/temurin-17/legal/java.net.http/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.net.http/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.prefs/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.prefs/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.prefs/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.prefs/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.prefs/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.prefs/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.prefs/LICENSE b/java/temurin-17/legal/java.prefs/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.prefs/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.rmi/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.rmi/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.rmi/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.rmi/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.rmi/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.rmi/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.rmi/LICENSE b/java/temurin-17/legal/java.rmi/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.rmi/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.scripting/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.scripting/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.scripting/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.scripting/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.scripting/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.scripting/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.scripting/LICENSE b/java/temurin-17/legal/java.scripting/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.scripting/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.se/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.se/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.se/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.se/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.se/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.se/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.se/LICENSE b/java/temurin-17/legal/java.se/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.se/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.security.jgss/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.security.jgss/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.security.jgss/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.security.jgss/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.security.jgss/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.security.jgss/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.security.jgss/LICENSE b/java/temurin-17/legal/java.security.jgss/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.security.jgss/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.security.sasl/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.security.sasl/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.security.sasl/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.security.sasl/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.security.sasl/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.security.sasl/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.security.sasl/LICENSE b/java/temurin-17/legal/java.security.sasl/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.security.sasl/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.smartcardio/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.smartcardio/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.smartcardio/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.smartcardio/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.smartcardio/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.smartcardio/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.smartcardio/LICENSE b/java/temurin-17/legal/java.smartcardio/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.smartcardio/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.smartcardio/pcsclite.md b/java/temurin-17/legal/java.smartcardio/pcsclite.md
new file mode 100644
index 0000000..99a9936
--- /dev/null
+++ b/java/temurin-17/legal/java.smartcardio/pcsclite.md
@@ -0,0 +1,57 @@
+## PC/SC Lite v1.9.9
+
+### PC/SC Lite Notice
+```
+MUSCLE SmartCard Development ( https://pcsclite.apdu.fr/ )
+
+Only 3 header files are included in this distribution: winscard.h, wintypes.h, pcsclite.h
+
+Copyright for winscard.h:
+ * Copyright (C) 1999-2003
+ * David Corcoran <corcoran@musclecard.com>
+ * Copyright (C) 2002-2009
+ * Ludovic Rousseau <ludovic.rousseau@free.fr>
+
+Copyright for wintypes.h:
+ * Copyright (C) 1999
+ * David Corcoran <corcoran@musclecard.com>
+ * Copyright (C) 2002-2011
+ * Ludovic Rousseau <ludovic.rousseau@free.fr>
+
+Copyright for pcsclite.h:
+ * Copyright (C) 1999-2004
+ * David Corcoran <corcoran@musclecard.com>
+ * Copyright (C) 2002-2011
+ * Ludovic Rousseau <ludovic.rousseau@free.fr>
+ * Copyright (C) 2005
+ * Martin Paljak <martin@paljak.pri.ee>
+
+```
+
+### PC/SC Lite License
+```
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+3. The name of the author may not be used to endorse or promote products
+ derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+```
diff --git a/java/temurin-17/legal/java.sql.rowset/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.sql.rowset/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.sql.rowset/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.sql.rowset/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.sql.rowset/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.sql.rowset/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.sql.rowset/LICENSE b/java/temurin-17/legal/java.sql.rowset/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.sql.rowset/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.sql/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.sql/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.sql/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.sql/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.sql/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.sql/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.sql/LICENSE b/java/temurin-17/legal/java.sql/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.sql/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.transaction.xa/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.transaction.xa/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.transaction.xa/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.transaction.xa/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.transaction.xa/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.transaction.xa/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.transaction.xa/LICENSE b/java/temurin-17/legal/java.transaction.xa/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.transaction.xa/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.xml.crypto/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.xml.crypto/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.xml.crypto/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.xml.crypto/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.xml.crypto/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.xml.crypto/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.xml.crypto/LICENSE b/java/temurin-17/legal/java.xml.crypto/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.xml.crypto/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.xml.crypto/santuario.md b/java/temurin-17/legal/java.xml.crypto/santuario.md
new file mode 100644
index 0000000..fa87128
--- /dev/null
+++ b/java/temurin-17/legal/java.xml.crypto/santuario.md
@@ -0,0 +1,225 @@
+## Apache Santuario v2.3.0
+
+### Apache Santuario Notice
+<pre>
+
+ Apache Santuario - XML Security for Java
+ Copyright 1999-2021 The Apache Software Foundation
+
+ This product includes software developed at
+ The Apache Software Foundation (http://www.apache.org/).
+
+ It was originally based on software copyright (c) 2001, Institute for
+ Data Communications Systems, <http://www.nue.et-inf.uni-siegen.de/>.
+
+ The development of this software was partly funded by the European
+ Commission in the <WebSig> project in the ISIS Programme.
+
+</pre>
+
+### Apache 2.0 License
+<pre>
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+</pre>
diff --git a/java/temurin-17/legal/java.xml/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/java.xml/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/java.xml/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.xml/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/java.xml/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/java.xml/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.xml/LICENSE b/java/temurin-17/legal/java.xml/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/java.xml/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/java.xml/bcel.md b/java/temurin-17/legal/java.xml/bcel.md
new file mode 100644
index 0000000..2c673d6
--- /dev/null
+++ b/java/temurin-17/legal/java.xml/bcel.md
@@ -0,0 +1,219 @@
+## Apache Commons Byte Code Engineering Library (BCEL) Version 6.7.0
+
+### Apache Commons BCEL Notice
+<pre>
+
+ Apache Commons BCEL
+ Copyright 2004-2022 The Apache Software Foundation
+
+ This product includes software developed at
+ The Apache Software Foundation (https://www.apache.org/).
+
+</pre>
+
+### Apache 2.0 License
+<pre>
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+</pre>
diff --git a/java/temurin-17/legal/java.xml/dom.md b/java/temurin-17/legal/java.xml/dom.md
new file mode 100644
index 0000000..4fe8093
--- /dev/null
+++ b/java/temurin-17/legal/java.xml/dom.md
@@ -0,0 +1,77 @@
+## DOM Level 3 Core Specification v1.0
+
+### W3C Software Notice
+<pre>
+Copyright © 2004 World Wide Web Consortium, (Massachusetts Institute of Technology,
+European Research Consortium for Informatics and Mathematics, Keio University).
+All Rights Reserved.
+
+The DOM bindings are published under the W3C Software Copyright Notice and License.
+The software license requires "Notice of any changes or modifications to the W3C
+files, including the date changes were made." Consequently, modified versions of
+the DOM bindings must document that they do not conform to the W3C standard; in the
+case of the IDL definitions, the pragma prefix can no longer be 'w3c.org'; in the
+case of the Java language binding, the package names can no longer be in the
+'org.w3c' package.
+</pre>
+
+### W3C License
+<pre>
+
+W3C SOFTWARE NOTICE AND LICENSE
+
+http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
+
+This work (and included software, documentation such as READMEs, or other
+related items) is being provided by the copyright holders under the following
+license. By obtaining, using and/or copying this work, you (the licensee)
+agree that you have read, understood, and will comply with the following terms
+and conditions.
+
+Permission to copy, modify, and distribute this software and its
+documentation, with or without modification, for any purpose and without fee
+or royalty is hereby granted, provided that you include the following on ALL
+copies of the software and documentation or portions thereof, including
+modifications:
+
+ 1.The full text of this NOTICE in a location viewable to users of the
+ redistributed or derivative work.
+
+ 2.Any pre-existing intellectual property disclaimers, notices, or terms and
+ conditions. If none exist, the W3C Software Short Notice should be included
+ (hypertext is preferred, text is permitted) within the body of any
+ redistributed or derivative code.
+
+ 3.Notice of any changes or modifications to the files, including the date
+ changes were made. (We recommend you provide URIs to the location from
+ which the code is derived.)
+
+THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS
+MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR
+PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY
+THIRD PARTY PATENTS,COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
+
+COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL
+OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR
+DOCUMENTATION. The name and trademarks of copyright holders may NOT be used
+in advertising or publicity pertaining to the software without specific,
+written prior permission. Title to copyright in this software and any
+associated documentation will at all times remain with copyright holders.
+
+____________________________________
+
+This formulation of W3C's notice and license became active on December 31
+2002. This version removes the copyright ownership notice such that this
+license can be used with materials other than those owned by the W3C, reflects
+that ERCIM is now a host of the W3C, includes references to this specific
+dated version of the license, and removes the ambiguous grant of "use".
+Otherwise, this version is the same as the previous version and is written so
+as to preserve the Free Software Foundation's assessment of GPL compatibility
+and OSI's certification under the Open Source Definition. Please see our
+Copyright FAQ for common questions about using materials from our site,
+including specific terms and conditions for packages like libwww, Amaya, and
+Jigsaw. Other questions about this notice can be directed to
+site-policy@w3.org.
+
+</pre>
diff --git a/java/temurin-17/legal/java.xml/jcup.md b/java/temurin-17/legal/java.xml/jcup.md
new file mode 100644
index 0000000..bc566b7
--- /dev/null
+++ b/java/temurin-17/legal/java.xml/jcup.md
@@ -0,0 +1,31 @@
+## CUP Parser Generator for Java v 0.11b
+
+### CUP Parser Generator License
+
+```
+Copyright 1996-2015 by Scott Hudson, Frank Flannery, C. Scott Ananian, Michael Petter
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted, provided
+that the above copyright notice appear in all copies and that both
+the copyright notice and this permission notice and warranty disclaimer
+appear in supporting documentation, and that the names of the authors or
+their employers not be used in advertising or publicity pertaining to
+distribution of the software without specific, written prior permission.
+
+The authors and their employers disclaim all warranties with regard to
+this software, including all implied warranties of merchantability and
+fitness. In no event shall the authors or their employers be liable for
+any special, indirect or consequential damages or any damages whatsoever
+resulting from loss of use, data or profits, whether in an action of
+contract, negligence or other tortious action, arising out of or in
+connection with the use or performance of this software.
+```
+---
+```
+This is an open source license. It is also GPL-Compatible (see entry for
+"Standard ML of New Jersey"). The portions of CUP output which are hard-coded
+into the CUP source code are (naturally) covered by this same license, as is
+the CUP runtime code linked with the generated parser.
+```
+
diff --git a/java/temurin-17/legal/java.xml/xalan.md b/java/temurin-17/legal/java.xml/xalan.md
new file mode 100644
index 0000000..924bce8
--- /dev/null
+++ b/java/temurin-17/legal/java.xml/xalan.md
@@ -0,0 +1,255 @@
+## Apache Xalan v2.7.2
+
+### Apache Xalan Notice
+<pre>
+
+ ======================================================================================
+ == NOTICE file corresponding to the section 4d of the Apache License, Version 2.0, ==
+ == in this case for the Apache Xalan distribution. ==
+ ======================================================================================
+
+ This product includes software developed by
+ The Apache Software Foundation (http://www.apache.org/).
+
+ Specifically, we only include the XSLTC portion of the source from the Xalan distribution.
+ The Xalan project has two processors: an interpretive one (Xalan Interpretive) and a
+ compiled one (The XSLT Compiler (XSLTC)). We *only* use the XSLTC part of Xalan; We use
+ the source from the packages that are part of the XSLTC sources.
+
+ Portions of this software was originally based on the following:
+
+ - software copyright (c) 1999-2002, Lotus Development Corporation., http://www.lotus.com.
+ - software copyright (c) 2001-2002, Sun Microsystems., http://www.sun.com.
+ - software copyright (c) 2003, IBM Corporation., http://www.ibm.com.
+ - voluntary contributions made by Ovidiu Predescu (ovidiu@cup.hp.com) on behalf of the
+ Apache Software Foundation and was originally developed at Hewlett Packard Company.
+
+</pre>
+
+### Apache 2.0 License
+<pre>
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+JLEX COPYRIGHT NOTICE, LICENSE AND DISCLAIMER.
+Copyright 1996-2003 by Elliot Joel Berk and C. Scott Ananian
+Permission to use, copy, modify, and distribute this software and
+its documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both the copyright notice and this permission notice and warranty
+disclaimer appear in supporting documentation, and that the name of
+the authors or their employers not be used in advertising or publicity
+pertaining to distribution of the software without specific, written
+prior permission.
+The authors and their employers disclaim all warranties with regard to
+this software, including all implied warranties of merchantability and
+fitness. In no event shall the authors or their employers be liable for
+any special, indirect or consequential damages or any damages whatsoever
+resulting from loss of use, data or profits, whether in an action of
+contract, negligence or other tortious action, arising out of or in
+connection with the use or performance of this software.The portions of
+JLex output which are hard-coded into the JLex source code are (naturally)
+covered by this same license.
+
+</pre>
diff --git a/java/temurin-17/legal/java.xml/xerces.md b/java/temurin-17/legal/java.xml/xerces.md
new file mode 100644
index 0000000..3790b7a
--- /dev/null
+++ b/java/temurin-17/legal/java.xml/xerces.md
@@ -0,0 +1,229 @@
+## Apache Xerces v2.12.2
+
+### Apache Xerces Notice
+<pre>
+ =========================================================================
+ == NOTICE file corresponding to section 4(d) of the Apache License, ==
+ == Version 2.0, in this case for the Apache Xerces Java distribution. ==
+ =========================================================================
+
+ Apache Xerces Java
+ Copyright 1999-2022 The Apache Software Foundation
+
+ This product includes software developed at
+ The Apache Software Foundation (http://www.apache.org/).
+
+ Portions of this software were originally based on the following:
+ - software copyright (c) 1999, IBM Corporation., http://www.ibm.com.
+ - software copyright (c) 1999, Sun Microsystems., http://www.sun.com.
+ - voluntary contributions made by Paul Eng on behalf of the
+ Apache Software Foundation that were originally developed at iClick, Inc.,
+ software copyright (c) 1999.
+</pre>
+
+### Apache 2.0 License
+<pre>
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+</pre>
diff --git a/java/temurin-17/legal/jdk.accessibility/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.accessibility/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.accessibility/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.accessibility/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.accessibility/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.accessibility/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.accessibility/LICENSE b/java/temurin-17/legal/jdk.accessibility/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.accessibility/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.attach/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.attach/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.attach/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.attach/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.attach/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.attach/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.attach/LICENSE b/java/temurin-17/legal/jdk.attach/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.attach/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.charsets/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.charsets/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.charsets/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.charsets/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.charsets/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.charsets/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.charsets/LICENSE b/java/temurin-17/legal/jdk.charsets/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.charsets/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.compiler/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.compiler/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.compiler/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.compiler/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.compiler/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.compiler/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.compiler/LICENSE b/java/temurin-17/legal/jdk.compiler/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.compiler/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.crypto.cryptoki/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.crypto.cryptoki/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.crypto.cryptoki/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.crypto.cryptoki/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.crypto.cryptoki/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.crypto.cryptoki/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.crypto.cryptoki/LICENSE b/java/temurin-17/legal/jdk.crypto.cryptoki/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.crypto.cryptoki/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.crypto.cryptoki/pkcs11cryptotoken.md b/java/temurin-17/legal/jdk.crypto.cryptoki/pkcs11cryptotoken.md
new file mode 100644
index 0000000..08d1e3c
--- /dev/null
+++ b/java/temurin-17/legal/jdk.crypto.cryptoki/pkcs11cryptotoken.md
@@ -0,0 +1,72 @@
+## OASIS PKCS #11 Cryptographic Token Interface v3.0
+
+### OASIS PKCS #11 Cryptographic Token Interface License
+<pre>
+
+Copyright © OASIS Open 2020. All Rights Reserved.
+
+ All capitalized terms in the following text have the meanings
+assigned to them in the OASIS Intellectual Property Rights Policy (the
+"OASIS IPR Policy"). The full Policy may be found at the OASIS website:
+[http://www.oasis-open.org/policies-guidelines/ipr]
+
+ This document and translations of it may be copied and furnished to
+others, and derivative works that comment on or otherwise explain it or
+assist in its implementation may be prepared, copied, published, and
+distributed, in whole or in part, without restriction of any kind,
+provided that the above copyright notice and this section are included
+on all such copies and derivative works. However, this document itself
+may not be modified in any way, including by removing the copyright
+notice or references to OASIS, except as needed for the purpose of
+developing any document or deliverable produced by an OASIS Technical
+Committee (in which case the rules applicable to copyrights, as set
+forth in the OASIS IPR Policy, must be followed) or as required to
+translate it into languages other than English.
+
+ The limited permissions granted above are perpetual and will not be
+revoked by OASIS or its successors or assigns.
+
+ This document and the information contained herein is provided on an
+"AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
+INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED
+WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. OASIS
+AND ITS MEMBERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THIS DOCUMENT OR ANY
+PART THEREOF.
+
+ [OASIS requests that any OASIS Party or any other party that
+believes it has patent claims that would necessarily be infringed by
+implementations of this OASIS Standards Final Deliverable, to notify
+OASIS TC Administrator and provide an indication of its willingness to
+grant patent licenses to such patent claims in a manner consistent with
+the IPR Mode of the OASIS Technical Committee that produced this
+deliverable.]
+
+ [OASIS invites any party to contact the OASIS TC Administrator if it
+is aware of a claim of ownership of any patent claims that would
+necessarily be infringed by implementations of this OASIS Standards
+Final Deliverable by a patent holder that is not willing to provide a
+license to such patent claims in a manner consistent with the IPR Mode
+of the OASIS Technical Committee that produced this OASIS Standards
+Final Deliverable. OASIS may include such claims on its website, but
+disclaims any obligation to do so.]
+
+ [OASIS takes no position regarding the validity or scope of any
+intellectual property or other rights that might be claimed to pertain
+to the implementation or use of the technology described in this OASIS
+Standards Final Deliverable or the extent to which any license under
+such rights might or might not be available; neither does it represent
+that it has made any effort to identify any such rights. Information on
+OASIS' procedures with respect to rights in any document or deliverable
+produced by an OASIS Technical Committee can be found on the OASIS
+website. Copies of claims of rights made available for publication and
+any assurances of licenses to be made available, or the result of an
+attempt made to obtain a general license or permission for the use of
+such proprietary rights by implementers or users of this OASIS Standards
+Final Deliverable, can be obtained from the OASIS TC Administrator.
+OASIS makes no representation that any information or list of
+intellectual property rights will at any time be complete, or that any
+claims in such list are, in fact, Essential Claims.]
+
+</pre>
diff --git a/java/temurin-17/legal/jdk.crypto.cryptoki/pkcs11wrapper.md b/java/temurin-17/legal/jdk.crypto.cryptoki/pkcs11wrapper.md
new file mode 100644
index 0000000..9eb453b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.crypto.cryptoki/pkcs11wrapper.md
@@ -0,0 +1,46 @@
+## IAIK (Institute for Applied Information Processing and Communication) PKCS#11 wrapper files v1
+
+### IAIK License
+<pre>
+
+Copyright (c) 2002 Graz University of Technology. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+
+3. The end-user documentation included with the redistribution, if any, must
+ include the following acknowledgment:
+
+ "This product includes software developed by IAIK of Graz University of
+ Technology."
+
+ Alternately, this acknowledgment may appear in the software itself, if and
+ wherever such third-party acknowledgments normally appear.
+
+4. The names "Graz University of Technology" and "IAIK of Graz University of
+ Technology" must not be used to endorse or promote products derived from this
+ software without prior written permission.
+
+5. Products derived from this software may not be called "IAIK PKCS Wrapper",
+ nor may "IAIK" appear in their name, without prior written permission of
+ Graz University of Technology.
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+LICENSOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+</pre>
diff --git a/java/temurin-17/legal/jdk.crypto.ec/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.crypto.ec/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.crypto.ec/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.crypto.ec/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.crypto.ec/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.crypto.ec/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.crypto.ec/LICENSE b/java/temurin-17/legal/jdk.crypto.ec/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.crypto.ec/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.dynalink/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.dynalink/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.dynalink/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.dynalink/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.dynalink/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.dynalink/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.dynalink/LICENSE b/java/temurin-17/legal/jdk.dynalink/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.dynalink/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.dynalink/dynalink.md b/java/temurin-17/legal/jdk.dynalink/dynalink.md
new file mode 100644
index 0000000..309efc7
--- /dev/null
+++ b/java/temurin-17/legal/jdk.dynalink/dynalink.md
@@ -0,0 +1,32 @@
+## Dynalink v.5
+
+### Dynalink License
+<pre>
+
+Copyright (c) 2009-2013, Attila Szegedi
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+* Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+* Neither the name of the copyright holder nor the names of
+ contributors may be used to endorse or promote products derived from
+ this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+</pre>
diff --git a/java/temurin-17/legal/jdk.editpad/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.editpad/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.editpad/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.editpad/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.editpad/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.editpad/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.editpad/LICENSE b/java/temurin-17/legal/jdk.editpad/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.editpad/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.hotspot.agent/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.hotspot.agent/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.hotspot.agent/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.hotspot.agent/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.hotspot.agent/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.hotspot.agent/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.hotspot.agent/LICENSE b/java/temurin-17/legal/jdk.hotspot.agent/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.hotspot.agent/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.httpserver/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.httpserver/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.httpserver/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.httpserver/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.httpserver/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.httpserver/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.httpserver/LICENSE b/java/temurin-17/legal/jdk.httpserver/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.httpserver/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.incubator.foreign/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.incubator.foreign/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.incubator.foreign/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.incubator.foreign/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.incubator.foreign/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.incubator.foreign/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.incubator.foreign/LICENSE b/java/temurin-17/legal/jdk.incubator.foreign/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.incubator.foreign/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.incubator.vector/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.incubator.vector/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.incubator.vector/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.incubator.vector/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.incubator.vector/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.incubator.vector/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.incubator.vector/LICENSE b/java/temurin-17/legal/jdk.incubator.vector/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.incubator.vector/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.ed/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.internal.ed/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.ed/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.ed/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.internal.ed/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.ed/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.ed/LICENSE b/java/temurin-17/legal/jdk.internal.ed/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.ed/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.jvmstat/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.internal.jvmstat/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.jvmstat/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.jvmstat/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.internal.jvmstat/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.jvmstat/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.jvmstat/LICENSE b/java/temurin-17/legal/jdk.internal.jvmstat/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.jvmstat/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.le/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.internal.le/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.le/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.le/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.internal.le/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.le/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.le/LICENSE b/java/temurin-17/legal/jdk.internal.le/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.le/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.le/jline.md b/java/temurin-17/legal/jdk.internal.le/jline.md
new file mode 100644
index 0000000..6840c69
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.le/jline.md
@@ -0,0 +1,41 @@
+## JLine v3.22.0
+
+### JLine License
+<pre>
+
+Copyright (c) 2002-2018, the original author or authors.
+All rights reserved.
+
+https://opensource.org/licenses/BSD-3-Clause
+
+Redistribution and use in source and binary forms, with or
+without modification, are permitted provided that the following
+conditions are met:
+
+Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with
+the distribution.
+
+Neither the name of JLine nor the names of its contributors
+may be used to endorse or promote products derived from this
+software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
+BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
+EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+OF THE POSSIBILITY OF SUCH DAMAGE.
+
+</pre>
diff --git a/java/temurin-17/legal/jdk.internal.opt/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.internal.opt/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.opt/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.opt/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.internal.opt/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.opt/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.opt/LICENSE b/java/temurin-17/legal/jdk.internal.opt/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.opt/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.opt/jopt-simple.md b/java/temurin-17/legal/jdk.internal.opt/jopt-simple.md
new file mode 100644
index 0000000..c08b3b4
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.opt/jopt-simple.md
@@ -0,0 +1,27 @@
+## jopt-simple v5.0.4
+
+### MIT License
+<pre>
+
+Copyright (c) 2004-2015 Paul R. Holser, Jr.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+</pre>
diff --git a/java/temurin-17/legal/jdk.internal.vm.ci/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.internal.vm.ci/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.ci/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.vm.ci/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.internal.vm.ci/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.ci/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.vm.ci/LICENSE b/java/temurin-17/legal/jdk.internal.vm.ci/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.ci/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.vm.compiler.management/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.internal.vm.compiler.management/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.compiler.management/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.vm.compiler.management/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.internal.vm.compiler.management/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.compiler.management/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.vm.compiler.management/LICENSE b/java/temurin-17/legal/jdk.internal.vm.compiler.management/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.compiler.management/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.vm.compiler/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.internal.vm.compiler/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.compiler/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.vm.compiler/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.internal.vm.compiler/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.compiler/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.internal.vm.compiler/LICENSE b/java/temurin-17/legal/jdk.internal.vm.compiler/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.internal.vm.compiler/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jartool/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jartool/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jartool/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jartool/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jartool/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jartool/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jartool/LICENSE b/java/temurin-17/legal/jdk.jartool/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jartool/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.javadoc/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.javadoc/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.javadoc/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.javadoc/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.javadoc/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.javadoc/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.javadoc/LICENSE b/java/temurin-17/legal/jdk.javadoc/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.javadoc/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.javadoc/jquery.md b/java/temurin-17/legal/jdk.javadoc/jquery.md
new file mode 100644
index 0000000..d468b31
--- /dev/null
+++ b/java/temurin-17/legal/jdk.javadoc/jquery.md
@@ -0,0 +1,72 @@
+## jQuery v3.6.1
+
+### jQuery License
+```
+jQuery v 3.6.1
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+******************************************
+
+The jQuery JavaScript Library v3.6.1 also includes Sizzle.js
+
+Sizzle.js includes the following license:
+
+Copyright JS Foundation and other contributors, https://js.foundation/
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/jquery/sizzle
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+All files located in the node_modules and external directories are
+externally maintained libraries used by this software which have their
+own licenses; we recommend you read them, as their terms may differ from
+the terms above.
+
+*********************
+
+```
diff --git a/java/temurin-17/legal/jdk.javadoc/jqueryUI.md b/java/temurin-17/legal/jdk.javadoc/jqueryUI.md
new file mode 100644
index 0000000..8bda9d7
--- /dev/null
+++ b/java/temurin-17/legal/jdk.javadoc/jqueryUI.md
@@ -0,0 +1,49 @@
+## jQuery UI v1.13.2
+
+### jQuery UI License
+```
+Copyright jQuery Foundation and other contributors, https://jquery.org/
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/jquery/jquery-ui
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code contained within the demos directory.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+All files located in the node_modules and external directories are
+externally maintained libraries used by this software which have their
+own licenses; we recommend you read them, as their terms may differ from
+the terms above.
+
+```
diff --git a/java/temurin-17/legal/jdk.jcmd/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jcmd/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jcmd/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jcmd/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jcmd/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jcmd/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jcmd/LICENSE b/java/temurin-17/legal/jdk.jcmd/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jcmd/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jconsole/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jconsole/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jconsole/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jconsole/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jconsole/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jconsole/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jconsole/LICENSE b/java/temurin-17/legal/jdk.jconsole/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jconsole/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdeps/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jdeps/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdeps/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdeps/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jdeps/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdeps/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdeps/LICENSE b/java/temurin-17/legal/jdk.jdeps/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdeps/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdi/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jdi/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdi/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdi/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jdi/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdi/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdi/LICENSE b/java/temurin-17/legal/jdk.jdi/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdi/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdwp.agent/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jdwp.agent/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdwp.agent/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdwp.agent/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jdwp.agent/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdwp.agent/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jdwp.agent/LICENSE b/java/temurin-17/legal/jdk.jdwp.agent/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jdwp.agent/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jfr/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jfr/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jfr/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jfr/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jfr/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jfr/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jfr/LICENSE b/java/temurin-17/legal/jdk.jfr/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jfr/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jlink/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jlink/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jlink/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jlink/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jlink/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jlink/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jlink/LICENSE b/java/temurin-17/legal/jdk.jlink/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jlink/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jpackage/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jpackage/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jpackage/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jpackage/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jpackage/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jpackage/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jpackage/LICENSE b/java/temurin-17/legal/jdk.jpackage/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jpackage/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jshell/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jshell/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jshell/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jshell/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jshell/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jshell/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jshell/LICENSE b/java/temurin-17/legal/jdk.jshell/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jshell/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jsobject/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jsobject/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jsobject/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jsobject/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jsobject/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jsobject/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jsobject/LICENSE b/java/temurin-17/legal/jdk.jsobject/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jsobject/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jstatd/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.jstatd/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jstatd/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jstatd/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.jstatd/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jstatd/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.jstatd/LICENSE b/java/temurin-17/legal/jdk.jstatd/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.jstatd/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.localedata/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.localedata/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.localedata/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.localedata/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.localedata/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.localedata/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.localedata/LICENSE b/java/temurin-17/legal/jdk.localedata/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.localedata/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.localedata/cldr.md b/java/temurin-17/legal/jdk.localedata/cldr.md
new file mode 120000
index 0000000..ed50236
--- /dev/null
+++ b/java/temurin-17/legal/jdk.localedata/cldr.md
@@ -0,0 +1 @@
+../java.base/cldr.md
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.localedata/thaidict.md b/java/temurin-17/legal/jdk.localedata/thaidict.md
new file mode 100644
index 0000000..f8b1133
--- /dev/null
+++ b/java/temurin-17/legal/jdk.localedata/thaidict.md
@@ -0,0 +1,31 @@
+## Thai Dictionary
+
+### Thai Dictionary License
+<pre>
+
+Copyright (C) 1982 The Royal Institute, Thai Royal Government.
+
+Copyright (C) 1998 National Electronics and Computer Technology Center,
+National Science and Technology Development Agency,
+Ministry of Science Technology and Environment,
+Thai Royal Government.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+</pre>
diff --git a/java/temurin-17/legal/jdk.management.agent/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.management.agent/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management.agent/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.management.agent/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.management.agent/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management.agent/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.management.agent/LICENSE b/java/temurin-17/legal/jdk.management.agent/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management.agent/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.management.jfr/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.management.jfr/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management.jfr/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.management.jfr/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.management.jfr/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management.jfr/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.management.jfr/LICENSE b/java/temurin-17/legal/jdk.management.jfr/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management.jfr/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.management/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.management/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.management/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.management/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.management/LICENSE b/java/temurin-17/legal/jdk.management/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.management/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.naming.dns/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.naming.dns/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.naming.dns/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.naming.dns/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.naming.dns/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.naming.dns/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.naming.dns/LICENSE b/java/temurin-17/legal/jdk.naming.dns/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.naming.dns/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.naming.rmi/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.naming.rmi/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.naming.rmi/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.naming.rmi/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.naming.rmi/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.naming.rmi/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.naming.rmi/LICENSE b/java/temurin-17/legal/jdk.naming.rmi/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.naming.rmi/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.net/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.net/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.net/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.net/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.net/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.net/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.net/LICENSE b/java/temurin-17/legal/jdk.net/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.net/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.nio.mapmode/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.nio.mapmode/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.nio.mapmode/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.nio.mapmode/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.nio.mapmode/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.nio.mapmode/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.nio.mapmode/LICENSE b/java/temurin-17/legal/jdk.nio.mapmode/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.nio.mapmode/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.random/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.random/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.random/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.random/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.random/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.random/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.random/LICENSE b/java/temurin-17/legal/jdk.random/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.random/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.sctp/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.sctp/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.sctp/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.sctp/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.sctp/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.sctp/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.sctp/LICENSE b/java/temurin-17/legal/jdk.sctp/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.sctp/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.security.auth/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.security.auth/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.security.auth/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.security.auth/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.security.auth/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.security.auth/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.security.auth/LICENSE b/java/temurin-17/legal/jdk.security.auth/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.security.auth/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.security.jgss/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.security.jgss/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.security.jgss/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.security.jgss/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.security.jgss/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.security.jgss/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.security.jgss/LICENSE b/java/temurin-17/legal/jdk.security.jgss/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.security.jgss/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.unsupported.desktop/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.unsupported.desktop/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.unsupported.desktop/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.unsupported.desktop/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.unsupported.desktop/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.unsupported.desktop/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.unsupported.desktop/LICENSE b/java/temurin-17/legal/jdk.unsupported.desktop/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.unsupported.desktop/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.unsupported/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.unsupported/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.unsupported/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.unsupported/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.unsupported/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.unsupported/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.unsupported/LICENSE b/java/temurin-17/legal/jdk.unsupported/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.unsupported/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.xml.dom/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.xml.dom/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.xml.dom/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.xml.dom/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.xml.dom/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.xml.dom/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.xml.dom/LICENSE b/java/temurin-17/legal/jdk.xml.dom/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.xml.dom/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.zipfs/ADDITIONAL_LICENSE_INFO b/java/temurin-17/legal/jdk.zipfs/ADDITIONAL_LICENSE_INFO
new file mode 120000
index 0000000..76b7b2f
--- /dev/null
+++ b/java/temurin-17/legal/jdk.zipfs/ADDITIONAL_LICENSE_INFO
@@ -0,0 +1 @@
+../java.base/ADDITIONAL_LICENSE_INFO
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.zipfs/ASSEMBLY_EXCEPTION b/java/temurin-17/legal/jdk.zipfs/ASSEMBLY_EXCEPTION
new file mode 120000
index 0000000..bd8da86
--- /dev/null
+++ b/java/temurin-17/legal/jdk.zipfs/ASSEMBLY_EXCEPTION
@@ -0,0 +1 @@
+../java.base/ASSEMBLY_EXCEPTION
\ No newline at end of file
diff --git a/java/temurin-17/legal/jdk.zipfs/LICENSE b/java/temurin-17/legal/jdk.zipfs/LICENSE
new file mode 120000
index 0000000..902705b
--- /dev/null
+++ b/java/temurin-17/legal/jdk.zipfs/LICENSE
@@ -0,0 +1 @@
+../java.base/LICENSE
\ No newline at end of file
diff --git a/java/temurin-17/lib/classlist b/java/temurin-17/lib/classlist
new file mode 100644
index 0000000..6aa883b
--- /dev/null
+++ b/java/temurin-17/lib/classlist
@@ -0,0 +1,1403 @@
+# NOTE: Do not modify this file.
+#
+# This file is generated via the -XX:DumpLoadedClassList=<class_list_file> option
+# and is used at CDS archive dump time (see -Xshare:dump).
+#
+java/io/BufferedInputStream
+java/io/BufferedOutputStream
+java/io/BufferedWriter
+java/io/ByteArrayInputStream
+java/io/ByteArrayOutputStream
+java/io/Closeable
+java/io/DataInput
+java/io/DataInputStream
+java/io/DataOutput
+java/io/DefaultFileSystem
+java/io/File
+java/io/File$PathStatus
+java/io/FileCleanable
+java/io/FileDescriptor
+java/io/FileDescriptor$1
+java/io/FileInputStream
+java/io/FileInputStream$1
+java/io/FileOutputStream
+java/io/FilePermission
+java/io/FileSystem
+java/io/FilterInputStream
+java/io/FilterOutputStream
+java/io/Flushable
+java/io/InputStream
+java/io/ObjectStreamField
+java/io/OutputStream
+java/io/OutputStreamWriter
+java/io/PrintStream
+java/io/RandomAccessFile
+java/io/RandomAccessFile$1
+java/io/RandomAccessFile$2
+java/io/Serializable
+java/io/UnixFileSystem
+java/io/Writer
+java/lang/AbstractStringBuilder
+java/lang/Appendable
+java/lang/ApplicationShutdownHooks
+java/lang/ApplicationShutdownHooks$1
+java/lang/ArithmeticException
+java/lang/ArrayStoreException
+java/lang/AssertionStatusDirectives
+java/lang/AutoCloseable
+java/lang/Boolean
+java/lang/BootstrapMethodError
+java/lang/Byte
+java/lang/Byte$ByteCache
+java/lang/CharSequence
+java/lang/Character
+java/lang/Character$CharacterCache
+java/lang/CharacterData
+java/lang/CharacterData00
+java/lang/CharacterDataLatin1
+java/lang/Class
+java/lang/Class$1
+java/lang/Class$3
+java/lang/Class$Atomic
+java/lang/Class$ReflectionData
+java/lang/ClassCastException
+java/lang/ClassLoader
+java/lang/ClassLoader$ParallelLoaders
+java/lang/ClassNotFoundException
+java/lang/ClassValue
+java/lang/ClassValue$Entry
+java/lang/ClassValue$Identity
+java/lang/ClassValue$Version
+java/lang/Cloneable
+java/lang/Comparable
+java/lang/CompoundEnumeration
+java/lang/Double
+java/lang/Enum
+java/lang/Error
+java/lang/Exception
+java/lang/Float
+java/lang/IllegalArgumentException
+java/lang/IllegalMonitorStateException
+java/lang/IncompatibleClassChangeError
+java/lang/Integer
+java/lang/Integer$IntegerCache
+java/lang/InternalError
+java/lang/Iterable
+java/lang/LinkageError
+java/lang/LiveStackFrame
+java/lang/LiveStackFrameInfo
+java/lang/Long
+java/lang/Long$LongCache
+java/lang/Math
+java/lang/Module
+java/lang/Module$ArchivedData
+java/lang/Module$ReflectionData
+java/lang/ModuleLayer
+java/lang/ModuleLayer$Controller
+java/lang/NamedPackage
+java/lang/NoClassDefFoundError
+java/lang/NoSuchFieldException
+java/lang/NoSuchMethodError
+java/lang/NoSuchMethodException
+java/lang/NullPointerException
+java/lang/Number
+java/lang/Object
+java/lang/OutOfMemoryError
+java/lang/Package
+java/lang/Package$VersionInfo
+java/lang/PublicMethods$Key
+java/lang/PublicMethods$MethodList
+java/lang/Readable
+java/lang/Record
+java/lang/ReflectiveOperationException
+java/lang/Runnable
+java/lang/Runtime
+java/lang/Runtime$Version
+java/lang/RuntimeException
+java/lang/RuntimePermission
+java/lang/SecurityManager
+java/lang/Short
+java/lang/Short$ShortCache
+java/lang/Shutdown
+java/lang/Shutdown$Lock
+java/lang/StackFrameInfo
+java/lang/StackOverflowError
+java/lang/StackStreamFactory$AbstractStackWalker
+java/lang/StackTraceElement
+java/lang/StackWalker
+java/lang/StackWalker$StackFrame
+java/lang/String
+java/lang/String$CaseInsensitiveComparator
+java/lang/StringBuffer
+java/lang/StringBuilder
+java/lang/StringCoding
+java/lang/StringConcatHelper
+java/lang/StringLatin1
+java/lang/StringLatin1$CharsSpliterator
+java/lang/StringUTF16
+java/lang/StringUTF16$CharsSpliterator
+java/lang/System
+java/lang/System$2
+java/lang/System$Logger
+java/lang/System$LoggerFinder
+java/lang/Terminator
+java/lang/Terminator$1
+java/lang/Thread
+java/lang/Thread$UncaughtExceptionHandler
+java/lang/ThreadDeath
+java/lang/ThreadGroup
+java/lang/ThreadLocal
+java/lang/ThreadLocal$ThreadLocalMap
+java/lang/ThreadLocal$ThreadLocalMap$Entry
+java/lang/Throwable
+java/lang/VersionProps
+java/lang/VirtualMachineError
+java/lang/Void
+java/lang/WeakPairMap
+java/lang/WeakPairMap$Pair
+java/lang/WeakPairMap$Pair$Lookup
+java/lang/annotation/Annotation
+java/lang/constant/Constable
+java/lang/constant/ConstantDesc
+java/lang/invoke/AbstractValidatingLambdaMetafactory
+java/lang/invoke/BootstrapMethodInvoker
+java/lang/invoke/BoundMethodHandle
+java/lang/invoke/BoundMethodHandle$Specializer
+java/lang/invoke/BoundMethodHandle$Specializer$Factory
+java/lang/invoke/BoundMethodHandle$SpeciesData
+java/lang/invoke/BoundMethodHandle$Species_D
+java/lang/invoke/BoundMethodHandle$Species_DL
+java/lang/invoke/BoundMethodHandle$Species_I
+java/lang/invoke/BoundMethodHandle$Species_IL
+java/lang/invoke/BoundMethodHandle$Species_L
+java/lang/invoke/BoundMethodHandle$Species_LJ
+java/lang/invoke/BoundMethodHandle$Species_LL
+java/lang/invoke/BoundMethodHandle$Species_LLL
+java/lang/invoke/BoundMethodHandle$Species_LLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLLLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLLLLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLLLLLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLLLLLLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLLLLLLLLL
+java/lang/invoke/BoundMethodHandle$Species_LLLLLLLLLLLLL
+java/lang/invoke/CallSite
+java/lang/invoke/ClassSpecializer
+java/lang/invoke/ClassSpecializer$1
+java/lang/invoke/ClassSpecializer$Factory
+java/lang/invoke/ClassSpecializer$SpeciesData
+java/lang/invoke/ConstantCallSite
+java/lang/invoke/DelegatingMethodHandle
+java/lang/invoke/DelegatingMethodHandle$Holder
+java/lang/invoke/DirectMethodHandle
+java/lang/invoke/DirectMethodHandle$2
+java/lang/invoke/DirectMethodHandle$Accessor
+java/lang/invoke/DirectMethodHandle$Constructor
+java/lang/invoke/DirectMethodHandle$Holder
+java/lang/invoke/DirectMethodHandle$Interface
+java/lang/invoke/InfoFromMemberName
+java/lang/invoke/InnerClassLambdaMetafactory
+java/lang/invoke/InnerClassLambdaMetafactory$1
+java/lang/invoke/InnerClassLambdaMetafactory$ForwardingMethodGenerator
+java/lang/invoke/InvokerBytecodeGenerator
+java/lang/invoke/InvokerBytecodeGenerator$2
+java/lang/invoke/InvokerBytecodeGenerator$ClassData
+java/lang/invoke/Invokers
+java/lang/invoke/Invokers$Holder
+java/lang/invoke/LambdaForm
+java/lang/invoke/LambdaForm$BasicType
+java/lang/invoke/LambdaForm$Holder
+java/lang/invoke/LambdaForm$Kind
+java/lang/invoke/LambdaForm$Name
+java/lang/invoke/LambdaForm$NamedFunction
+java/lang/invoke/LambdaFormBuffer
+java/lang/invoke/LambdaFormEditor
+java/lang/invoke/LambdaFormEditor$1
+java/lang/invoke/LambdaFormEditor$Transform
+java/lang/invoke/LambdaFormEditor$TransformKey
+java/lang/invoke/LambdaMetafactory
+java/lang/invoke/LambdaProxyClassArchive
+java/lang/invoke/MemberName
+java/lang/invoke/MemberName$Factory
+java/lang/invoke/MethodHandle
+java/lang/invoke/MethodHandleImpl
+java/lang/invoke/MethodHandleImpl$1
+java/lang/invoke/MethodHandleImpl$AsVarargsCollector
+java/lang/invoke/MethodHandleImpl$Intrinsic
+java/lang/invoke/MethodHandleImpl$IntrinsicMethodHandle
+java/lang/invoke/MethodHandleInfo
+java/lang/invoke/MethodHandleNatives
+java/lang/invoke/MethodHandleNatives$CallSiteContext
+java/lang/invoke/MethodHandleStatics
+java/lang/invoke/MethodHandles
+java/lang/invoke/MethodHandles$1
+java/lang/invoke/MethodHandles$Lookup
+java/lang/invoke/MethodHandles$Lookup$ClassDefiner
+java/lang/invoke/MethodHandles$Lookup$ClassFile
+java/lang/invoke/MethodHandles$Lookup$ClassOption
+java/lang/invoke/MethodType
+java/lang/invoke/MethodType$ConcurrentWeakInternSet
+java/lang/invoke/MethodType$ConcurrentWeakInternSet$WeakEntry
+java/lang/invoke/MethodTypeForm
+java/lang/invoke/MutableCallSite
+java/lang/invoke/ResolvedMethodName
+java/lang/invoke/SimpleMethodHandle
+java/lang/invoke/StringConcatFactory
+java/lang/invoke/StringConcatFactory$1
+java/lang/invoke/StringConcatFactory$2
+java/lang/invoke/StringConcatFactory$3
+java/lang/invoke/TypeConvertingMethodAdapter
+java/lang/invoke/TypeDescriptor
+java/lang/invoke/TypeDescriptor$OfField
+java/lang/invoke/TypeDescriptor$OfMethod
+java/lang/invoke/VarForm
+java/lang/invoke/VarHandle
+java/lang/invoke/VarHandle$1
+java/lang/invoke/VarHandle$AccessDescriptor
+java/lang/invoke/VarHandle$AccessMode
+java/lang/invoke/VarHandle$AccessType
+java/lang/invoke/VarHandleGuards
+java/lang/invoke/VarHandleInts$FieldInstanceReadOnly
+java/lang/invoke/VarHandleInts$FieldInstanceReadWrite
+java/lang/invoke/VarHandleInts$FieldStaticReadOnly
+java/lang/invoke/VarHandleInts$FieldStaticReadWrite
+java/lang/invoke/VarHandleLongs$FieldInstanceReadOnly
+java/lang/invoke/VarHandleLongs$FieldInstanceReadWrite
+java/lang/invoke/VarHandleReferences$Array
+java/lang/invoke/VarHandleReferences$FieldInstanceReadOnly
+java/lang/invoke/VarHandleReferences$FieldInstanceReadWrite
+java/lang/invoke/VarHandles
+java/lang/invoke/VarHandles$1
+java/lang/invoke/VolatileCallSite
+java/lang/module/Configuration
+java/lang/module/ModuleDescriptor
+java/lang/module/ModuleDescriptor$1
+java/lang/module/ModuleDescriptor$Builder
+java/lang/module/ModuleDescriptor$Exports
+java/lang/module/ModuleDescriptor$Modifier
+java/lang/module/ModuleDescriptor$Opens
+java/lang/module/ModuleDescriptor$Provides
+java/lang/module/ModuleDescriptor$Requires
+java/lang/module/ModuleDescriptor$Requires$Modifier
+java/lang/module/ModuleDescriptor$Version
+java/lang/module/ModuleFinder
+java/lang/module/ModuleFinder$1
+java/lang/module/ModuleFinder$2
+java/lang/module/ModuleReader
+java/lang/module/ModuleReference
+java/lang/module/ResolvedModule
+java/lang/module/Resolver
+java/lang/ref/Cleaner
+java/lang/ref/Cleaner$1
+java/lang/ref/Cleaner$Cleanable
+java/lang/ref/FinalReference
+java/lang/ref/Finalizer
+java/lang/ref/Finalizer$FinalizerThread
+java/lang/ref/PhantomReference
+java/lang/ref/Reference
+java/lang/ref/Reference$1
+java/lang/ref/Reference$ReferenceHandler
+java/lang/ref/ReferenceQueue
+java/lang/ref/ReferenceQueue$Lock
+java/lang/ref/ReferenceQueue$Null
+java/lang/ref/SoftReference
+java/lang/ref/WeakReference
+java/lang/reflect/AccessibleObject
+java/lang/reflect/AnnotatedElement
+java/lang/reflect/Array
+java/lang/reflect/Constructor
+java/lang/reflect/Executable
+java/lang/reflect/Field
+java/lang/reflect/GenericDeclaration
+java/lang/reflect/Member
+java/lang/reflect/Method
+java/lang/reflect/Modifier
+java/lang/reflect/Parameter
+java/lang/reflect/RecordComponent
+java/lang/reflect/ReflectAccess
+java/lang/reflect/ReflectPermission
+java/lang/reflect/Type
+java/math/BigDecimal
+java/math/BigInteger
+java/math/RoundingMode
+java/net/DefaultInterface
+java/net/Inet4Address
+java/net/Inet6Address
+java/net/Inet6Address$Inet6AddressHolder
+java/net/Inet6AddressImpl
+java/net/InetAddress
+java/net/InetAddress$1
+java/net/InetAddress$InetAddressHolder
+java/net/InetAddress$NameService
+java/net/InetAddress$PlatformNameService
+java/net/InetAddressImpl
+java/net/InetAddressImplFactory
+java/net/InterfaceAddress
+java/net/NetworkInterface
+java/net/URI
+java/net/URI$1
+java/net/URI$Parser
+java/net/URL
+java/net/URL$3
+java/net/URL$DefaultFactory
+java/net/URLStreamHandler
+java/net/URLStreamHandlerFactory
+java/nio/Bits
+java/nio/Bits$1
+java/nio/Buffer
+java/nio/Buffer$1
+java/nio/ByteBuffer
+java/nio/ByteOrder
+java/nio/CharBuffer
+java/nio/DirectByteBuffer
+java/nio/DirectByteBufferR
+java/nio/DirectIntBufferRU
+java/nio/DirectIntBufferU
+java/nio/DirectLongBufferU
+java/nio/HeapByteBuffer
+java/nio/HeapCharBuffer
+java/nio/IntBuffer
+java/nio/LongBuffer
+java/nio/MappedByteBuffer
+java/nio/charset/Charset
+java/nio/charset/CharsetEncoder
+java/nio/charset/CoderResult
+java/nio/charset/CodingErrorAction
+java/nio/charset/StandardCharsets
+java/nio/charset/spi/CharsetProvider
+java/nio/file/CopyOption
+java/nio/file/FileSystem
+java/nio/file/FileSystems
+java/nio/file/FileSystems$DefaultFileSystemHolder
+java/nio/file/FileSystems$DefaultFileSystemHolder$1
+java/nio/file/Files
+java/nio/file/LinkOption
+java/nio/file/OpenOption
+java/nio/file/Path
+java/nio/file/Paths
+java/nio/file/StandardOpenOption
+java/nio/file/Watchable
+java/nio/file/attribute/AttributeView
+java/nio/file/attribute/BasicFileAttributeView
+java/nio/file/attribute/BasicFileAttributes
+java/nio/file/attribute/DosFileAttributeView
+java/nio/file/attribute/DosFileAttributes
+java/nio/file/attribute/FileAttributeView
+java/nio/file/attribute/FileTime
+java/nio/file/attribute/PosixFileAttributes
+java/nio/file/attribute/UserDefinedFileAttributeView
+java/nio/file/spi/FileSystemProvider
+java/security/AccessControlContext
+java/security/AccessController
+java/security/AllPermission
+java/security/BasicPermission
+java/security/BasicPermissionCollection
+java/security/CodeSigner
+java/security/CodeSource
+java/security/Guard
+java/security/Permission
+java/security/PermissionCollection
+java/security/Permissions
+java/security/Principal
+java/security/PrivilegedAction
+java/security/PrivilegedExceptionAction
+java/security/ProtectionDomain
+java/security/ProtectionDomain$JavaSecurityAccessImpl
+java/security/ProtectionDomain$Key
+java/security/SecureClassLoader
+java/security/SecureClassLoader$1
+java/security/SecureClassLoader$CodeSourceKey
+java/security/SecureClassLoader$DebugHolder
+java/security/Security
+java/security/Security$1
+java/security/Security$2
+java/security/UnresolvedPermission
+java/security/cert/Certificate
+java/text/AttributedCharacterIterator$Attribute
+java/text/DateFormat
+java/text/DateFormat$Field
+java/text/DateFormatSymbols
+java/text/DecimalFormat
+java/text/DecimalFormatSymbols
+java/text/DigitList
+java/text/DontCareFieldPosition
+java/text/DontCareFieldPosition$1
+java/text/FieldPosition
+java/text/Format
+java/text/Format$Field
+java/text/Format$FieldDelegate
+java/text/NumberFormat
+java/text/NumberFormat$Field
+java/text/SimpleDateFormat
+java/text/spi/BreakIteratorProvider
+java/text/spi/CollatorProvider
+java/text/spi/DateFormatProvider
+java/text/spi/DateFormatSymbolsProvider
+java/text/spi/DecimalFormatSymbolsProvider
+java/text/spi/NumberFormatProvider
+java/time/Clock
+java/time/Clock$SystemClock
+java/time/Duration
+java/time/Instant
+java/time/InstantSource
+java/time/LocalDate
+java/time/LocalDate$1
+java/time/LocalDateTime
+java/time/LocalTime
+java/time/LocalTime$1
+java/time/Period
+java/time/ZoneId
+java/time/ZoneOffset
+java/time/ZoneRegion
+java/time/chrono/AbstractChronology
+java/time/chrono/ChronoLocalDate
+java/time/chrono/ChronoLocalDateTime
+java/time/chrono/ChronoPeriod
+java/time/chrono/Chronology
+java/time/chrono/IsoChronology
+java/time/format/DateTimeFormatter
+java/time/format/DateTimeFormatterBuilder
+java/time/format/DateTimeFormatterBuilder$1
+java/time/format/DateTimeFormatterBuilder$2
+java/time/format/DateTimeFormatterBuilder$CharLiteralPrinterParser
+java/time/format/DateTimeFormatterBuilder$CompositePrinterParser
+java/time/format/DateTimeFormatterBuilder$DateTimePrinterParser
+java/time/format/DateTimeFormatterBuilder$FractionPrinterParser
+java/time/format/DateTimeFormatterBuilder$InstantPrinterParser
+java/time/format/DateTimeFormatterBuilder$NumberPrinterParser
+java/time/format/DateTimeFormatterBuilder$OffsetIdPrinterParser
+java/time/format/DateTimeFormatterBuilder$SettingsParser
+java/time/format/DateTimeFormatterBuilder$StringLiteralPrinterParser
+java/time/format/DateTimeFormatterBuilder$TextPrinterParser
+java/time/format/DateTimeFormatterBuilder$ZoneIdPrinterParser
+java/time/format/DateTimePrintContext
+java/time/format/DateTimeTextProvider
+java/time/format/DateTimeTextProvider$1
+java/time/format/DateTimeTextProvider$LocaleStore
+java/time/format/DecimalStyle
+java/time/format/ResolverStyle
+java/time/format/SignStyle
+java/time/format/TextStyle
+java/time/temporal/ChronoField
+java/time/temporal/ChronoUnit
+java/time/temporal/IsoFields
+java/time/temporal/IsoFields$Field
+java/time/temporal/IsoFields$Field$1
+java/time/temporal/IsoFields$Field$2
+java/time/temporal/IsoFields$Field$3
+java/time/temporal/IsoFields$Field$4
+java/time/temporal/IsoFields$Unit
+java/time/temporal/JulianFields
+java/time/temporal/JulianFields$Field
+java/time/temporal/Temporal
+java/time/temporal/TemporalAccessor
+java/time/temporal/TemporalAdjuster
+java/time/temporal/TemporalAmount
+java/time/temporal/TemporalField
+java/time/temporal/TemporalQueries
+java/time/temporal/TemporalQueries$1
+java/time/temporal/TemporalQueries$2
+java/time/temporal/TemporalQueries$3
+java/time/temporal/TemporalQueries$4
+java/time/temporal/TemporalQueries$5
+java/time/temporal/TemporalQueries$6
+java/time/temporal/TemporalQueries$7
+java/time/temporal/TemporalQuery
+java/time/temporal/TemporalUnit
+java/time/temporal/ValueRange
+java/time/zone/ZoneOffsetTransitionRule
+java/time/zone/ZoneRules
+java/util/AbstractCollection
+java/util/AbstractList
+java/util/AbstractList$RandomAccessSpliterator
+java/util/AbstractMap
+java/util/AbstractMap$SimpleImmutableEntry
+java/util/AbstractSequentialList
+java/util/AbstractSet
+java/util/ArrayDeque
+java/util/ArrayDeque$DeqIterator
+java/util/ArrayList
+java/util/ArrayList$ArrayListSpliterator
+java/util/ArrayList$Itr
+java/util/ArrayList$SubList
+java/util/Arrays
+java/util/Arrays$ArrayItr
+java/util/Arrays$ArrayList
+java/util/Arrays$LegacyMergeSort
+java/util/Calendar
+java/util/Calendar$Builder
+java/util/Collection
+java/util/Collections
+java/util/Collections$1
+java/util/Collections$3
+java/util/Collections$EmptyEnumeration
+java/util/Collections$EmptyIterator
+java/util/Collections$EmptyList
+java/util/Collections$EmptyMap
+java/util/Collections$EmptySet
+java/util/Collections$SetFromMap
+java/util/Collections$SingletonMap
+java/util/Collections$SingletonSet
+java/util/Collections$SynchronizedCollection
+java/util/Collections$SynchronizedMap
+java/util/Collections$SynchronizedSet
+java/util/Collections$UnmodifiableCollection
+java/util/Collections$UnmodifiableCollection$1
+java/util/Collections$UnmodifiableList
+java/util/Collections$UnmodifiableRandomAccessList
+java/util/Collections$UnmodifiableSet
+java/util/Comparator
+java/util/Date
+java/util/Deque
+java/util/Dictionary
+java/util/EnumMap
+java/util/EnumMap$1
+java/util/EnumSet
+java/util/Enumeration
+java/util/Formattable
+java/util/Formatter
+java/util/Formatter$Conversion
+java/util/Formatter$Flags
+java/util/Formatter$FormatSpecifier
+java/util/Formatter$FormatString
+java/util/GregorianCalendar
+java/util/HashMap
+java/util/HashMap$EntryIterator
+java/util/HashMap$EntrySet
+java/util/HashMap$HashIterator
+java/util/HashMap$HashMapSpliterator
+java/util/HashMap$KeyIterator
+java/util/HashMap$KeySet
+java/util/HashMap$KeySpliterator
+java/util/HashMap$Node
+java/util/HashMap$TreeNode
+java/util/HashMap$ValueIterator
+java/util/HashMap$ValueSpliterator
+java/util/HashMap$Values
+java/util/HashSet
+java/util/Hashtable
+java/util/Hashtable$Entry
+java/util/Hashtable$Enumerator
+java/util/HexFormat
+java/util/IdentityHashMap
+java/util/IdentityHashMap$IdentityHashMapIterator
+java/util/IdentityHashMap$KeyIterator
+java/util/IdentityHashMap$KeySet
+java/util/IdentityHashMap$Values
+java/util/ImmutableCollections
+java/util/ImmutableCollections$AbstractImmutableCollection
+java/util/ImmutableCollections$AbstractImmutableList
+java/util/ImmutableCollections$AbstractImmutableMap
+java/util/ImmutableCollections$AbstractImmutableSet
+java/util/ImmutableCollections$List12
+java/util/ImmutableCollections$ListItr
+java/util/ImmutableCollections$ListN
+java/util/ImmutableCollections$Map1
+java/util/ImmutableCollections$MapN
+java/util/ImmutableCollections$MapN$1
+java/util/ImmutableCollections$MapN$MapNIterator
+java/util/ImmutableCollections$Set12
+java/util/ImmutableCollections$Set12$1
+java/util/ImmutableCollections$SetN
+java/util/ImmutableCollections$SetN$SetNIterator
+java/util/Iterator
+java/util/KeyValueHolder
+java/util/LinkedHashMap
+java/util/LinkedHashMap$Entry
+java/util/LinkedHashMap$LinkedEntryIterator
+java/util/LinkedHashMap$LinkedEntrySet
+java/util/LinkedHashMap$LinkedHashIterator
+java/util/LinkedHashSet
+java/util/LinkedList
+java/util/LinkedList$Node
+java/util/List
+java/util/ListIterator
+java/util/ListResourceBundle
+java/util/Locale
+java/util/Locale$Builder
+java/util/Locale$Cache
+java/util/Locale$Category
+java/util/Map
+java/util/Map$Entry
+java/util/NavigableMap
+java/util/NavigableSet
+java/util/Objects
+java/util/Optional
+java/util/OptionalInt
+java/util/Properties
+java/util/Properties$EntrySet
+java/util/Properties$LineReader
+java/util/Queue
+java/util/Random
+java/util/RandomAccess
+java/util/RegularEnumSet
+java/util/ResourceBundle
+java/util/ResourceBundle$1
+java/util/ResourceBundle$2
+java/util/ResourceBundle$Control
+java/util/ResourceBundle$Control$CandidateListCache
+java/util/ResourceBundle$NoFallbackControl
+java/util/ResourceBundle$ResourceBundleProviderHelper
+java/util/ResourceBundle$SingleFormatControl
+java/util/ServiceLoader
+java/util/ServiceLoader$1
+java/util/ServiceLoader$2
+java/util/ServiceLoader$3
+java/util/ServiceLoader$LazyClassPathLookupIterator
+java/util/ServiceLoader$ModuleServicesLookupIterator
+java/util/ServiceLoader$Provider
+java/util/ServiceLoader$ProviderImpl
+java/util/Set
+java/util/SortedMap
+java/util/SortedSet
+java/util/Spliterator
+java/util/Spliterator$OfDouble
+java/util/Spliterator$OfInt
+java/util/Spliterator$OfLong
+java/util/Spliterator$OfPrimitive
+java/util/Spliterators
+java/util/Spliterators$1Adapter
+java/util/Spliterators$AbstractSpliterator
+java/util/Spliterators$ArraySpliterator
+java/util/Spliterators$EmptySpliterator
+java/util/Spliterators$EmptySpliterator$OfDouble
+java/util/Spliterators$EmptySpliterator$OfInt
+java/util/Spliterators$EmptySpliterator$OfLong
+java/util/Spliterators$EmptySpliterator$OfRef
+java/util/Spliterators$IteratorSpliterator
+java/util/StringJoiner
+java/util/StringTokenizer
+java/util/TimSort
+java/util/TimeZone
+java/util/TreeMap
+java/util/TreeMap$Entry
+java/util/TreeMap$EntryIterator
+java/util/TreeMap$EntrySet
+java/util/TreeMap$PrivateEntryIterator
+java/util/WeakHashMap
+java/util/WeakHashMap$Entry
+java/util/WeakHashMap$KeySet
+java/util/concurrent/AbstractExecutorService
+java/util/concurrent/ConcurrentHashMap
+java/util/concurrent/ConcurrentHashMap$BaseIterator
+java/util/concurrent/ConcurrentHashMap$CollectionView
+java/util/concurrent/ConcurrentHashMap$CounterCell
+java/util/concurrent/ConcurrentHashMap$EntryIterator
+java/util/concurrent/ConcurrentHashMap$EntrySetView
+java/util/concurrent/ConcurrentHashMap$ForwardingNode
+java/util/concurrent/ConcurrentHashMap$KeyIterator
+java/util/concurrent/ConcurrentHashMap$KeySetView
+java/util/concurrent/ConcurrentHashMap$MapEntry
+java/util/concurrent/ConcurrentHashMap$Node
+java/util/concurrent/ConcurrentHashMap$ReservationNode
+java/util/concurrent/ConcurrentHashMap$Segment
+java/util/concurrent/ConcurrentHashMap$Traverser
+java/util/concurrent/ConcurrentHashMap$ValueIterator
+java/util/concurrent/ConcurrentHashMap$ValuesView
+java/util/concurrent/ConcurrentMap
+java/util/concurrent/ConcurrentNavigableMap
+java/util/concurrent/ConcurrentSkipListMap
+java/util/concurrent/ConcurrentSkipListMap$Index
+java/util/concurrent/ConcurrentSkipListMap$Node
+java/util/concurrent/ConcurrentSkipListSet
+java/util/concurrent/CopyOnWriteArrayList
+java/util/concurrent/CopyOnWriteArrayList$COWIterator
+java/util/concurrent/CountedCompleter
+java/util/concurrent/Executor
+java/util/concurrent/ExecutorService
+java/util/concurrent/ForkJoinPool
+java/util/concurrent/ForkJoinPool$1
+java/util/concurrent/ForkJoinPool$DefaultCommonPoolForkJoinWorkerThreadFactory
+java/util/concurrent/ForkJoinPool$DefaultCommonPoolForkJoinWorkerThreadFactory$1
+java/util/concurrent/ForkJoinPool$DefaultForkJoinWorkerThreadFactory
+java/util/concurrent/ForkJoinPool$ForkJoinWorkerThreadFactory
+java/util/concurrent/ForkJoinPool$WorkQueue
+java/util/concurrent/ForkJoinTask
+java/util/concurrent/ForkJoinTask$Aux
+java/util/concurrent/ForkJoinWorkerThread
+java/util/concurrent/Future
+java/util/concurrent/ThreadFactory
+java/util/concurrent/ThreadLocalRandom
+java/util/concurrent/TimeUnit
+java/util/concurrent/atomic/AtomicInteger
+java/util/concurrent/atomic/AtomicLong
+java/util/concurrent/atomic/LongAdder
+java/util/concurrent/atomic/Striped64
+java/util/concurrent/locks/AbstractOwnableSynchronizer
+java/util/concurrent/locks/AbstractQueuedSynchronizer
+java/util/concurrent/locks/Lock
+java/util/concurrent/locks/LockSupport
+java/util/concurrent/locks/ReentrantLock
+java/util/concurrent/locks/ReentrantLock$NonfairSync
+java/util/concurrent/locks/ReentrantLock$Sync
+java/util/function/BiConsumer
+java/util/function/BiFunction
+java/util/function/BinaryOperator
+java/util/function/Consumer
+java/util/function/Function
+java/util/function/IntConsumer
+java/util/function/IntFunction
+java/util/function/IntPredicate
+java/util/function/Predicate
+java/util/function/Supplier
+java/util/jar/Attributes
+java/util/jar/Attributes$Name
+java/util/jar/JarEntry
+java/util/jar/JarFile
+java/util/jar/JarFile$JarFileEntry
+java/util/jar/JarVerifier
+java/util/jar/JavaUtilJarAccessImpl
+java/util/jar/Manifest
+java/util/jar/Manifest$FastInputStream
+java/util/logging/Handler
+java/util/logging/Level
+java/util/logging/Level$KnownLevel
+java/util/logging/LogManager
+java/util/logging/LogManager$1
+java/util/logging/LogManager$2
+java/util/logging/LogManager$4
+java/util/logging/LogManager$Cleaner
+java/util/logging/LogManager$LogNode
+java/util/logging/LogManager$LoggerContext
+java/util/logging/LogManager$LoggerContext$1
+java/util/logging/LogManager$LoggerWeakRef
+java/util/logging/LogManager$LoggingProviderAccess
+java/util/logging/LogManager$RootLogger
+java/util/logging/LogManager$SystemLoggerContext
+java/util/logging/LogManager$VisitedLoggers
+java/util/logging/Logger
+java/util/logging/Logger$ConfigurationData
+java/util/logging/Logger$LoggerBundle
+java/util/logging/Logger$SystemLoggerHelper
+java/util/logging/Logger$SystemLoggerHelper$1
+java/util/logging/LoggingPermission
+java/util/random/RandomGenerator
+java/util/regex/ASCII
+java/util/regex/CharPredicates
+java/util/regex/IntHashSet
+java/util/regex/MatchResult
+java/util/regex/Matcher
+java/util/regex/Pattern
+java/util/regex/Pattern$BackRef
+java/util/regex/Pattern$Begin
+java/util/regex/Pattern$BitClass
+java/util/regex/Pattern$BmpCharPredicate
+java/util/regex/Pattern$BmpCharProperty
+java/util/regex/Pattern$BmpCharPropertyGreedy
+java/util/regex/Pattern$Branch
+java/util/regex/Pattern$BranchConn
+java/util/regex/Pattern$CharPredicate
+java/util/regex/Pattern$CharProperty
+java/util/regex/Pattern$CharPropertyGreedy
+java/util/regex/Pattern$Curly
+java/util/regex/Pattern$Dollar
+java/util/regex/Pattern$First
+java/util/regex/Pattern$GroupCurly
+java/util/regex/Pattern$GroupHead
+java/util/regex/Pattern$GroupTail
+java/util/regex/Pattern$LastNode
+java/util/regex/Pattern$Node
+java/util/regex/Pattern$Qtype
+java/util/regex/Pattern$Ques
+java/util/regex/Pattern$Slice
+java/util/regex/Pattern$SliceNode
+java/util/regex/Pattern$Start
+java/util/regex/Pattern$StartS
+java/util/regex/Pattern$TreeInfo
+java/util/spi/CalendarDataProvider
+java/util/spi/CurrencyNameProvider
+java/util/spi/LocaleNameProvider
+java/util/spi/LocaleServiceProvider
+java/util/spi/TimeZoneNameProvider
+java/util/stream/AbstractPipeline
+java/util/stream/AbstractTask
+java/util/stream/BaseStream
+java/util/stream/Collector
+java/util/stream/Collector$Characteristics
+java/util/stream/Collectors
+java/util/stream/Collectors$CollectorImpl
+java/util/stream/Collectors$Partition
+java/util/stream/Collectors$Partition$1
+java/util/stream/DistinctOps
+java/util/stream/DistinctOps$1
+java/util/stream/DistinctOps$1$2
+java/util/stream/FindOps
+java/util/stream/FindOps$FindOp
+java/util/stream/FindOps$FindSink
+java/util/stream/FindOps$FindSink$OfInt
+java/util/stream/FindOps$FindSink$OfRef
+java/util/stream/ForEachOps
+java/util/stream/ForEachOps$ForEachOp
+java/util/stream/ForEachOps$ForEachOp$OfRef
+java/util/stream/IntPipeline
+java/util/stream/IntPipeline$10
+java/util/stream/IntPipeline$10$1
+java/util/stream/IntPipeline$Head
+java/util/stream/IntPipeline$StatelessOp
+java/util/stream/IntStream
+java/util/stream/PipelineHelper
+java/util/stream/ReduceOps
+java/util/stream/ReduceOps$3
+java/util/stream/ReduceOps$3ReducingSink
+java/util/stream/ReduceOps$AccumulatingSink
+java/util/stream/ReduceOps$Box
+java/util/stream/ReduceOps$ReduceOp
+java/util/stream/ReduceOps$ReduceTask
+java/util/stream/ReferencePipeline
+java/util/stream/ReferencePipeline$2
+java/util/stream/ReferencePipeline$2$1
+java/util/stream/ReferencePipeline$3
+java/util/stream/ReferencePipeline$3$1
+java/util/stream/ReferencePipeline$7
+java/util/stream/ReferencePipeline$7$1
+java/util/stream/ReferencePipeline$Head
+java/util/stream/ReferencePipeline$StatefulOp
+java/util/stream/ReferencePipeline$StatelessOp
+java/util/stream/Sink
+java/util/stream/Sink$ChainedInt
+java/util/stream/Sink$ChainedReference
+java/util/stream/Sink$OfInt
+java/util/stream/Stream
+java/util/stream/Stream$Builder
+java/util/stream/StreamOpFlag
+java/util/stream/StreamOpFlag$MaskBuilder
+java/util/stream/StreamOpFlag$Type
+java/util/stream/StreamShape
+java/util/stream/StreamSupport
+java/util/stream/Streams
+java/util/stream/Streams$AbstractStreamBuilderImpl
+java/util/stream/Streams$StreamBuilderImpl
+java/util/stream/TerminalOp
+java/util/stream/TerminalSink
+java/util/zip/CRC32
+java/util/zip/Checksum
+java/util/zip/Checksum$1
+java/util/zip/Inflater
+java/util/zip/Inflater$InflaterZStreamRef
+java/util/zip/InflaterInputStream
+java/util/zip/ZipCoder
+java/util/zip/ZipCoder$UTF8ZipCoder
+java/util/zip/ZipConstants
+java/util/zip/ZipEntry
+java/util/zip/ZipFile
+java/util/zip/ZipFile$1
+java/util/zip/ZipFile$CleanableResource
+java/util/zip/ZipFile$EntrySpliterator
+java/util/zip/ZipFile$InflaterCleanupAction
+java/util/zip/ZipFile$Source
+java/util/zip/ZipFile$Source$End
+java/util/zip/ZipFile$Source$Key
+java/util/zip/ZipFile$ZipFileInflaterInputStream
+java/util/zip/ZipFile$ZipFileInputStream
+java/util/zip/ZipUtils
+jdk/internal/access/JavaIOFileDescriptorAccess
+jdk/internal/access/JavaIORandomAccessFileAccess
+jdk/internal/access/JavaLangAccess
+jdk/internal/access/JavaLangInvokeAccess
+jdk/internal/access/JavaLangModuleAccess
+jdk/internal/access/JavaLangRefAccess
+jdk/internal/access/JavaLangReflectAccess
+jdk/internal/access/JavaNetInetAddressAccess
+jdk/internal/access/JavaNetURLAccess
+jdk/internal/access/JavaNetUriAccess
+jdk/internal/access/JavaNioAccess
+jdk/internal/access/JavaSecurityAccess
+jdk/internal/access/JavaSecurityPropertiesAccess
+jdk/internal/access/JavaUtilJarAccess
+jdk/internal/access/JavaUtilResourceBundleAccess
+jdk/internal/access/JavaUtilZipFileAccess
+jdk/internal/access/SharedSecrets
+jdk/internal/invoke/NativeEntryPoint
+jdk/internal/jimage/BasicImageReader
+jdk/internal/jimage/BasicImageReader$1
+jdk/internal/jimage/ImageHeader
+jdk/internal/jimage/ImageLocation
+jdk/internal/jimage/ImageReader
+jdk/internal/jimage/ImageReader$SharedImageReader
+jdk/internal/jimage/ImageReaderFactory
+jdk/internal/jimage/ImageReaderFactory$1
+jdk/internal/jimage/ImageStrings
+jdk/internal/jimage/ImageStringsReader
+jdk/internal/jimage/NativeImageBuffer
+jdk/internal/jimage/NativeImageBuffer$1
+jdk/internal/jimage/decompressor/Decompressor
+jdk/internal/loader/AbstractClassLoaderValue
+jdk/internal/loader/AbstractClassLoaderValue$Memoizer
+jdk/internal/loader/ArchivedClassLoaders
+jdk/internal/loader/BootLoader
+jdk/internal/loader/BuiltinClassLoader
+jdk/internal/loader/BuiltinClassLoader$1
+jdk/internal/loader/BuiltinClassLoader$2
+jdk/internal/loader/BuiltinClassLoader$5
+jdk/internal/loader/BuiltinClassLoader$LoadedModule
+jdk/internal/loader/ClassLoaderHelper
+jdk/internal/loader/ClassLoaderValue
+jdk/internal/loader/ClassLoaders
+jdk/internal/loader/ClassLoaders$AppClassLoader
+jdk/internal/loader/ClassLoaders$BootClassLoader
+jdk/internal/loader/ClassLoaders$PlatformClassLoader
+jdk/internal/loader/FileURLMapper
+jdk/internal/loader/NativeLibraries
+jdk/internal/loader/NativeLibraries$1
+jdk/internal/loader/NativeLibraries$LibraryPaths
+jdk/internal/loader/NativeLibraries$NativeLibraryImpl
+jdk/internal/loader/NativeLibrary
+jdk/internal/loader/Resource
+jdk/internal/loader/URLClassPath
+jdk/internal/loader/URLClassPath$1
+jdk/internal/loader/URLClassPath$3
+jdk/internal/loader/URLClassPath$JarLoader
+jdk/internal/loader/URLClassPath$JarLoader$1
+jdk/internal/loader/URLClassPath$JarLoader$2
+jdk/internal/loader/URLClassPath$Loader
+jdk/internal/logger/BootstrapLogger
+jdk/internal/logger/BootstrapLogger$BootstrapExecutors
+jdk/internal/logger/BootstrapLogger$DetectBackend
+jdk/internal/logger/BootstrapLogger$DetectBackend$1
+jdk/internal/logger/BootstrapLogger$LoggingBackend
+jdk/internal/logger/BootstrapLogger$RedirectedLoggers
+jdk/internal/logger/DefaultLoggerFinder
+jdk/internal/logger/DefaultLoggerFinder$1
+jdk/internal/math/FDBigInteger
+jdk/internal/math/FloatingDecimal
+jdk/internal/math/FloatingDecimal$1
+jdk/internal/math/FloatingDecimal$ASCIIToBinaryConverter
+jdk/internal/math/FloatingDecimal$BinaryToASCIIBuffer
+jdk/internal/math/FloatingDecimal$BinaryToASCIIConverter
+jdk/internal/math/FloatingDecimal$ExceptionalBinaryToASCIIBuffer
+jdk/internal/math/FloatingDecimal$PreparedASCIIToBinaryBuffer
+jdk/internal/misc/CDS
+jdk/internal/misc/InnocuousThread
+jdk/internal/misc/OSEnvironment
+jdk/internal/misc/ScopedMemoryAccess
+jdk/internal/misc/Signal
+jdk/internal/misc/Signal$Handler
+jdk/internal/misc/Signal$NativeHandler
+jdk/internal/misc/TerminatingThreadLocal
+jdk/internal/misc/TerminatingThreadLocal$1
+jdk/internal/misc/Unsafe
+jdk/internal/misc/UnsafeConstants
+jdk/internal/misc/VM
+jdk/internal/misc/VM$BufferPool
+jdk/internal/module/ArchivedBootLayer
+jdk/internal/module/ArchivedModuleGraph
+jdk/internal/module/Builder
+jdk/internal/module/Checks
+jdk/internal/module/DefaultRoots
+jdk/internal/module/ModuleBootstrap
+jdk/internal/module/ModuleBootstrap$Counters
+jdk/internal/module/ModuleBootstrap$SafeModuleFinder
+jdk/internal/module/ModuleHashes
+jdk/internal/module/ModuleHashes$HashSupplier
+jdk/internal/module/ModuleInfo$Attributes
+jdk/internal/module/ModuleLoaderMap
+jdk/internal/module/ModuleLoaderMap$Mapper
+jdk/internal/module/ModuleLoaderMap$Modules
+jdk/internal/module/ModulePatcher
+jdk/internal/module/ModulePath
+jdk/internal/module/ModulePath$Patterns
+jdk/internal/module/ModuleReferenceImpl
+jdk/internal/module/ModuleReferences
+jdk/internal/module/ModuleResolution
+jdk/internal/module/ModuleTarget
+jdk/internal/module/Modules
+jdk/internal/module/Resources
+jdk/internal/module/ServicesCatalog
+jdk/internal/module/ServicesCatalog$ServiceProvider
+jdk/internal/module/SystemModuleFinders
+jdk/internal/module/SystemModuleFinders$2
+jdk/internal/module/SystemModuleFinders$SystemImage
+jdk/internal/module/SystemModuleFinders$SystemModuleFinder
+jdk/internal/module/SystemModuleFinders$SystemModuleReader
+jdk/internal/module/SystemModules
+jdk/internal/module/SystemModules$all
+jdk/internal/module/SystemModulesMap
+jdk/internal/org/objectweb/asm/AnnotationVisitor
+jdk/internal/org/objectweb/asm/AnnotationWriter
+jdk/internal/org/objectweb/asm/Attribute
+jdk/internal/org/objectweb/asm/ByteVector
+jdk/internal/org/objectweb/asm/ClassReader
+jdk/internal/org/objectweb/asm/ClassVisitor
+jdk/internal/org/objectweb/asm/ClassWriter
+jdk/internal/org/objectweb/asm/ConstantDynamic
+jdk/internal/org/objectweb/asm/FieldVisitor
+jdk/internal/org/objectweb/asm/FieldWriter
+jdk/internal/org/objectweb/asm/Frame
+jdk/internal/org/objectweb/asm/Handle
+jdk/internal/org/objectweb/asm/Handler
+jdk/internal/org/objectweb/asm/Label
+jdk/internal/org/objectweb/asm/MethodVisitor
+jdk/internal/org/objectweb/asm/MethodWriter
+jdk/internal/org/objectweb/asm/Symbol
+jdk/internal/org/objectweb/asm/SymbolTable
+jdk/internal/org/objectweb/asm/SymbolTable$Entry
+jdk/internal/org/objectweb/asm/Type
+jdk/internal/perf/Perf
+jdk/internal/perf/Perf$GetPerfAction
+jdk/internal/perf/PerfCounter
+jdk/internal/perf/PerfCounter$CoreCounters
+jdk/internal/ref/Cleaner
+jdk/internal/ref/CleanerFactory
+jdk/internal/ref/CleanerFactory$1
+jdk/internal/ref/CleanerImpl
+jdk/internal/ref/CleanerImpl$CleanerCleanable
+jdk/internal/ref/CleanerImpl$PhantomCleanableRef
+jdk/internal/ref/PhantomCleanable
+jdk/internal/reflect/CallerSensitive
+jdk/internal/reflect/ConstantPool
+jdk/internal/reflect/ConstructorAccessor
+jdk/internal/reflect/ConstructorAccessorImpl
+jdk/internal/reflect/DelegatingClassLoader
+jdk/internal/reflect/DelegatingConstructorAccessorImpl
+jdk/internal/reflect/DelegatingMethodAccessorImpl
+jdk/internal/reflect/FieldAccessor
+jdk/internal/reflect/FieldAccessorImpl
+jdk/internal/reflect/MagicAccessorImpl
+jdk/internal/reflect/MethodAccessor
+jdk/internal/reflect/MethodAccessorImpl
+jdk/internal/reflect/NativeConstructorAccessorImpl
+jdk/internal/reflect/NativeMethodAccessorImpl
+jdk/internal/reflect/Reflection
+jdk/internal/reflect/ReflectionFactory
+jdk/internal/reflect/ReflectionFactory$GetReflectionFactoryAction
+jdk/internal/reflect/UnsafeFieldAccessorImpl
+jdk/internal/reflect/UnsafeStaticFieldAccessorImpl
+jdk/internal/util/ArraysSupport
+jdk/internal/util/Preconditions
+jdk/internal/util/Preconditions$1
+jdk/internal/util/StaticProperty
+jdk/internal/util/SystemProps
+jdk/internal/util/SystemProps$Raw
+jdk/internal/util/jar/JarIndex
+jdk/internal/util/random/RandomSupport
+jdk/internal/vm/vector/VectorSupport
+jdk/internal/vm/vector/VectorSupport$Vector
+jdk/internal/vm/vector/VectorSupport$VectorMask
+jdk/internal/vm/vector/VectorSupport$VectorPayload
+jdk/internal/vm/vector/VectorSupport$VectorShuffle
+sun/invoke/empty/Empty
+sun/invoke/util/BytecodeDescriptor
+sun/invoke/util/ValueConversions
+sun/invoke/util/ValueConversions$WrapperCache
+sun/invoke/util/VerifyAccess
+sun/invoke/util/VerifyType
+sun/invoke/util/Wrapper
+sun/invoke/util/Wrapper$1
+sun/invoke/util/Wrapper$Format
+sun/launcher/LauncherHelper
+sun/net/util/IPAddressUtil
+sun/net/util/URLUtil
+sun/net/www/ParseUtil
+sun/net/www/protocol/file/Handler
+sun/net/www/protocol/jar/Handler
+sun/nio/ByteBuffered
+sun/nio/ch/DirectBuffer
+sun/nio/cs/HistoricallyNamedCharset
+sun/nio/cs/ISO_8859_1
+sun/nio/cs/StandardCharsets
+sun/nio/cs/StandardCharsets$Aliases
+sun/nio/cs/StandardCharsets$Cache
+sun/nio/cs/StreamEncoder
+sun/nio/cs/Surrogate
+sun/nio/cs/Surrogate$Parser
+sun/nio/cs/US_ASCII
+sun/nio/cs/US_ASCII$Encoder
+sun/nio/cs/UTF_16
+sun/nio/cs/UTF_16BE
+sun/nio/cs/UTF_16LE
+sun/nio/cs/UTF_8
+sun/nio/cs/Unicode
+sun/nio/fs/AbstractBasicFileAttributeView
+sun/nio/fs/AbstractFileSystemProvider
+sun/nio/fs/DefaultFileSystemProvider
+sun/nio/fs/DynamicFileAttributeView
+sun/nio/fs/LinuxFileSystem
+sun/nio/fs/LinuxFileSystemProvider
+sun/nio/fs/NativeBuffer
+sun/nio/fs/NativeBuffer$Deallocator
+sun/nio/fs/NativeBuffers
+sun/nio/fs/NativeBuffers$1
+sun/nio/fs/UnixFileAttributeViews
+sun/nio/fs/UnixFileAttributeViews$Basic
+sun/nio/fs/UnixFileAttributes
+sun/nio/fs/UnixFileAttributes$UnixAsBasicFileAttributes
+sun/nio/fs/UnixFileStoreAttributes
+sun/nio/fs/UnixFileSystem
+sun/nio/fs/UnixFileSystemProvider
+sun/nio/fs/UnixMountEntry
+sun/nio/fs/UnixNativeDispatcher
+sun/nio/fs/UnixPath
+sun/nio/fs/UnixUriUtils
+sun/nio/fs/Util
+sun/reflect/annotation/AnnotationParser
+sun/security/action/GetBooleanAction
+sun/security/action/GetIntegerAction
+sun/security/action/GetPropertyAction
+sun/security/util/Debug
+sun/security/util/FilePermCompat
+sun/security/util/LazyCodeSourcePermissionCollection
+sun/security/util/SecurityProperties
+sun/security/util/SignatureFileVerifier
+sun/text/resources/cldr/FormatData
+sun/util/PreHashedMap
+sun/util/calendar/AbstractCalendar
+sun/util/calendar/BaseCalendar
+sun/util/calendar/BaseCalendar$Date
+sun/util/calendar/CalendarDate
+sun/util/calendar/CalendarSystem
+sun/util/calendar/CalendarSystem$GregorianHolder
+sun/util/calendar/CalendarUtils
+sun/util/calendar/Gregorian
+sun/util/calendar/Gregorian$Date
+sun/util/calendar/ZoneInfo
+sun/util/calendar/ZoneInfoFile
+sun/util/calendar/ZoneInfoFile$1
+sun/util/calendar/ZoneInfoFile$ZoneOffsetTransitionRule
+sun/util/cldr/CLDRBaseLocaleDataMetaInfo
+sun/util/cldr/CLDRCalendarDataProviderImpl
+sun/util/cldr/CLDRLocaleProviderAdapter
+sun/util/locale/BaseLocale
+sun/util/locale/BaseLocale$Cache
+sun/util/locale/BaseLocale$Key
+sun/util/locale/InternalLocaleBuilder
+sun/util/locale/InternalLocaleBuilder$CaseInsensitiveChar
+sun/util/locale/LanguageTag
+sun/util/locale/LocaleObjectCache
+sun/util/locale/LocaleObjectCache$CacheEntry
+sun/util/locale/LocaleUtils
+sun/util/locale/ParseStatus
+sun/util/locale/StringTokenIterator
+sun/util/locale/provider/AvailableLanguageTags
+sun/util/locale/provider/CalendarDataProviderImpl
+sun/util/locale/provider/CalendarDataUtility
+sun/util/locale/provider/CalendarDataUtility$CalendarWeekParameterGetter
+sun/util/locale/provider/CalendarProviderImpl
+sun/util/locale/provider/DateFormatProviderImpl
+sun/util/locale/provider/DateFormatSymbolsProviderImpl
+sun/util/locale/provider/DecimalFormatSymbolsProviderImpl
+sun/util/locale/provider/JRELocaleProviderAdapter
+sun/util/locale/provider/LocaleDataMetaInfo
+sun/util/locale/provider/LocaleProviderAdapter
+sun/util/locale/provider/LocaleProviderAdapter$1
+sun/util/locale/provider/LocaleProviderAdapter$Type
+sun/util/locale/provider/LocaleResources
+sun/util/locale/provider/LocaleResources$ResourceReference
+sun/util/locale/provider/LocaleServiceProviderPool
+sun/util/locale/provider/LocaleServiceProviderPool$LocalizedObjectGetter
+sun/util/locale/provider/NumberFormatProviderImpl
+sun/util/locale/provider/ResourceBundleBasedAdapter
+sun/util/logging/PlatformLogger$Bridge
+sun/util/logging/PlatformLogger$ConfigurableBridge
+sun/util/logging/internal/LoggingProviderImpl
+sun/util/logging/internal/LoggingProviderImpl$LogManagerAccess
+sun/util/resources/Bundles
+sun/util/resources/Bundles$1
+sun/util/resources/Bundles$BundleReference
+sun/util/resources/Bundles$CacheKey
+sun/util/resources/Bundles$CacheKeyReference
+sun/util/resources/Bundles$Strategy
+sun/util/resources/LocaleData
+sun/util/resources/LocaleData$1
+sun/util/resources/LocaleData$LocaleDataStrategy
+sun/util/resources/cldr/CalendarData
+sun/util/spi/CalendarProvider
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder delegate L6_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L L3_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L LJI_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L LJJ_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L LJL3_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L LJLIL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L LJLJL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L LJL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L LLJ_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DelegatingMethodHandle$Holder reinvoke_L L_V
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder getDouble LL_D
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder getInt LL_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder getLong LL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder getReference LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeInterface L3_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L3I_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L3J_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L3_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L3_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L4_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L4_V
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L5_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L6_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L7_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial L8_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLD_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLII_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLIL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLI_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLI_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJI_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJJ_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJJ_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJL3_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJLIL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJLI_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJLJL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJLJ_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJLL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJ_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LLJ_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LL_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecial LL_V
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecialIFC L3I_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeSpecialIFC LLI_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L10_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L11_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L12_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L13_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L14_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L15_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L16_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L3DL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L3D_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L3IL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L3I_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L3_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L3_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L4J_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L4_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L5_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L5_V
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L6_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L7_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L8_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L9_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LD_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LI3_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LII_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LI_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LI_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LJI_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LJJ_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LJL3_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LJLIL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LJLJL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LJL_J
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LJ_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LLJ_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LL_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStatic L_V
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeStaticInit LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeVirtual L3_V
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder invokeVirtual LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder newInvokeSpecial L3_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder newInvokeSpecial L4_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder newInvokeSpecial LII_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder newInvokeSpecial LI_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder newInvokeSpecial LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.DirectMethodHandle$Holder newInvokeSpecial L_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder invokeExact_MT L7_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder invokeExact_MT L8_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder invoke_MT LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod DL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod IIL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod ILL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod IL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod JJL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod JL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod L3_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod L4_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod L5_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod L6_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod LIL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.Invokers$Holder linkToTargetMethod L_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.LambdaForm$Holder identity_D LD_D
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.LambdaForm$Holder identity_I LI_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.LambdaForm$Holder identity_L LL_L
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.LambdaForm$Holder zero_D L_D
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.LambdaForm$Holder zero_I L_I
+@lambda-form-invoker [LF_RESOLVE] java.lang.invoke.LambdaForm$Holder zero_L L_L
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_D
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_DL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_I
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_IL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_L
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LJ
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLLLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLLLLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLLLLLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLLLLLLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.BoundMethodHandle$Species_LLLLLLLLLLLLL
+@lambda-form-invoker [SPECIES_RESOLVE] java.lang.invoke.SimpleMethodHandle
+@lambda-proxy java/lang/module/ModuleDescriptor$Builder accept ()Ljava/util/function/Consumer; (Ljava/lang/Object;)V REF_invokeStatic jdk/internal/module/Checks requirePackageName (Ljava/lang/String;)Ljava/lang/String; (Ljava/lang/String;)V
+@lambda-proxy java/lang/module/ModuleFinder$2 accept (Ljava/lang/module/ModuleFinder$2;Ljava/lang/String;)Ljava/util/function/Consumer; (Ljava/lang/Object;)V REF_invokeVirtual java/lang/module/ModuleFinder$2 lambda$find$1 (Ljava/lang/String;Ljava/lang/module/ModuleReference;)V (Ljava/lang/module/ModuleReference;)V
+@lambda-proxy java/lang/module/ModuleFinder$2 accept (Ljava/lang/module/ModuleFinder$2;Ljava/util/Set;)Ljava/util/function/Consumer; (Ljava/lang/Object;)V REF_invokeVirtual java/lang/module/ModuleFinder$2 lambda$findAll$3 (Ljava/util/Set;Ljava/lang/module/ModuleReference;)V (Ljava/lang/module/ModuleReference;)V
+@lambda-proxy java/lang/module/ModuleFinder$2 apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeStatic java/lang/module/ModuleFinder$2 lambda$findAll$2 (Ljava/lang/module/ModuleFinder;)Ljava/util/stream/Stream; (Ljava/lang/module/ModuleFinder;)Ljava/util/stream/Stream;
+@lambda-proxy java/lang/module/ModuleFinder$2 apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/util/Optional stream ()Ljava/util/stream/Stream; (Ljava/util/Optional;)Ljava/util/stream/Stream;
+@lambda-proxy java/lang/module/ModuleFinder$2 apply (Ljava/lang/String;)Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeStatic java/lang/module/ModuleFinder$2 lambda$find$0 (Ljava/lang/String;Ljava/lang/module/ModuleFinder;)Ljava/util/Optional; (Ljava/lang/module/ModuleFinder;)Ljava/util/Optional;
+@lambda-proxy java/text/DecimalFormatSymbols test ()Ljava/util/function/IntPredicate; (I)Z REF_invokeStatic java/text/DecimalFormatSymbols lambda$findNonFormatChar$0 (I)Z (I)Z
+@lambda-proxy java/time/format/DateTimeFormatter queryFrom ()Ljava/time/temporal/TemporalQuery; (Ljava/time/temporal/TemporalAccessor;)Ljava/lang/Object; REF_invokeStatic java/time/format/DateTimeFormatter lambda$static$0 (Ljava/time/temporal/TemporalAccessor;)Ljava/time/Period; (Ljava/time/temporal/TemporalAccessor;)Ljava/time/Period;
+@lambda-proxy java/time/format/DateTimeFormatter queryFrom ()Ljava/time/temporal/TemporalQuery; (Ljava/time/temporal/TemporalAccessor;)Ljava/lang/Object; REF_invokeStatic java/time/format/DateTimeFormatter lambda$static$1 (Ljava/time/temporal/TemporalAccessor;)Ljava/lang/Boolean; (Ljava/time/temporal/TemporalAccessor;)Ljava/lang/Boolean;
+@lambda-proxy java/time/format/DateTimeFormatterBuilder queryFrom ()Ljava/time/temporal/TemporalQuery; (Ljava/time/temporal/TemporalAccessor;)Ljava/lang/Object; REF_invokeStatic java/time/format/DateTimeFormatterBuilder lambda$static$0 (Ljava/time/temporal/TemporalAccessor;)Ljava/time/ZoneId; (Ljava/time/temporal/TemporalAccessor;)Ljava/time/ZoneId;
+@lambda-proxy java/util/ResourceBundle$ResourceBundleProviderHelper run (Ljava/lang/reflect/Constructor;)Ljava/security/PrivilegedAction; ()Ljava/lang/Object; REF_invokeStatic java/util/ResourceBundle$ResourceBundleProviderHelper lambda$newResourceBundle$0 (Ljava/lang/reflect/Constructor;)Ljava/lang/Void; ()Ljava/lang/Void;
+@lambda-proxy java/util/logging/Level apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/util/logging/Level$KnownLevel mirrored ()Ljava/util/Optional; (Ljava/util/logging/Level$KnownLevel;)Ljava/util/Optional;
+@lambda-proxy java/util/logging/Level$KnownLevel apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeStatic java/util/logging/Level$KnownLevel lambda$add$3 (Ljava/lang/String;)Ljava/util/List; (Ljava/lang/String;)Ljava/util/List;
+@lambda-proxy java/util/logging/Level$KnownLevel apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeStatic java/util/logging/Level$KnownLevel lambda$add$4 (Ljava/lang/Integer;)Ljava/util/List; (Ljava/lang/Integer;)Ljava/util/List;
+@lambda-proxy java/util/logging/Level$KnownLevel apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/util/Optional stream ()Ljava/util/stream/Stream; (Ljava/util/Optional;)Ljava/util/stream/Stream;
+@lambda-proxy java/util/regex/CharPredicates is ()Ljava/util/regex/Pattern$BmpCharPredicate; (I)Z REF_invokeStatic java/util/regex/CharPredicates lambda$ASCII_DIGIT$18 (I)Z (I)Z
+@lambda-proxy java/util/regex/CharPredicates is ()Ljava/util/regex/Pattern$BmpCharPredicate; (I)Z REF_invokeStatic java/util/regex/CharPredicates lambda$ASCII_SPACE$20 (I)Z (I)Z
+@lambda-proxy java/util/regex/Pattern is (I)Ljava/util/regex/Pattern$BmpCharPredicate; (I)Z REF_invokeStatic java/util/regex/Pattern lambda$Single$7 (II)Z (I)Z
+@lambda-proxy java/util/regex/Pattern is (II)Ljava/util/regex/Pattern$BmpCharPredicate; (I)Z REF_invokeStatic java/util/regex/Pattern lambda$Range$10 (III)Z (I)Z
+@lambda-proxy java/util/regex/Pattern$BmpCharPredicate is (Ljava/util/regex/Pattern$BmpCharPredicate;Ljava/util/regex/Pattern$CharPredicate;)Ljava/util/regex/Pattern$BmpCharPredicate; (I)Z REF_invokeInterface java/util/regex/Pattern$BmpCharPredicate lambda$union$2 (Ljava/util/regex/Pattern$CharPredicate;I)Z (I)Z
+@lambda-proxy java/util/regex/Pattern$CharPredicate is (Ljava/util/regex/Pattern$CharPredicate;)Ljava/util/regex/Pattern$CharPredicate; (I)Z REF_invokeInterface java/util/regex/Pattern$CharPredicate lambda$negate$3 (I)Z (I)Z
+@lambda-proxy java/util/stream/Collectors accept ()Ljava/util/function/BiConsumer; (Ljava/lang/Object;Ljava/lang/Object;)V REF_invokeInterface java/util/Set add (Ljava/lang/Object;)Z (Ljava/util/HashSet;Ljava/lang/Object;)V
+@lambda-proxy java/util/stream/Collectors accept ()Ljava/util/function/BiConsumer; (Ljava/lang/Object;Ljava/lang/Object;)V REF_invokeVirtual java/util/StringJoiner add (Ljava/lang/CharSequence;)Ljava/util/StringJoiner; (Ljava/util/StringJoiner;Ljava/lang/CharSequence;)V
+@lambda-proxy java/util/stream/Collectors accept (Ljava/util/function/BiConsumer;Ljava/util/function/Predicate;)Ljava/util/function/BiConsumer; (Ljava/lang/Object;Ljava/lang/Object;)V REF_invokeStatic java/util/stream/Collectors lambda$partitioningBy$62 (Ljava/util/function/BiConsumer;Ljava/util/function/Predicate;Ljava/util/stream/Collectors$Partition;Ljava/lang/Object;)V (Ljava/util/stream/Collectors$Partition;Ljava/lang/Object;)V
+@lambda-proxy java/util/stream/Collectors apply ()Ljava/util/function/BinaryOperator; (Ljava/lang/Object;Ljava/lang/Object;)Ljava/lang/Object; REF_invokeStatic java/util/stream/Collectors lambda$toSet$7 (Ljava/util/HashSet;Ljava/util/HashSet;)Ljava/util/HashSet; (Ljava/util/HashSet;Ljava/util/HashSet;)Ljava/util/HashSet;
+@lambda-proxy java/util/stream/Collectors apply ()Ljava/util/function/BinaryOperator; (Ljava/lang/Object;Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/util/StringJoiner merge (Ljava/util/StringJoiner;)Ljava/util/StringJoiner; (Ljava/util/StringJoiner;Ljava/util/StringJoiner;)Ljava/util/StringJoiner;
+@lambda-proxy java/util/stream/Collectors apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeStatic java/util/stream/Collectors lambda$castingIdentity$2 (Ljava/lang/Object;)Ljava/lang/Object; (Ljava/lang/Object;)Ljava/lang/Object;
+@lambda-proxy java/util/stream/Collectors apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/util/StringJoiner toString ()Ljava/lang/String; (Ljava/util/StringJoiner;)Ljava/lang/String;
+@lambda-proxy java/util/stream/Collectors apply (Ljava/util/function/BinaryOperator;)Ljava/util/function/BinaryOperator; (Ljava/lang/Object;Ljava/lang/Object;)Ljava/lang/Object; REF_invokeStatic java/util/stream/Collectors lambda$partitioningBy$63 (Ljava/util/function/BinaryOperator;Ljava/util/stream/Collectors$Partition;Ljava/util/stream/Collectors$Partition;)Ljava/util/stream/Collectors$Partition; (Ljava/util/stream/Collectors$Partition;Ljava/util/stream/Collectors$Partition;)Ljava/util/stream/Collectors$Partition;
+@lambda-proxy java/util/stream/Collectors get ()Ljava/util/function/Supplier; ()Ljava/lang/Object; REF_newInvokeSpecial java/util/HashSet <init> ()V ()Ljava/util/HashSet;
+@lambda-proxy java/util/stream/Collectors get (Ljava/lang/CharSequence;Ljava/lang/CharSequence;Ljava/lang/CharSequence;)Ljava/util/function/Supplier; ()Ljava/lang/Object; REF_invokeStatic java/util/stream/Collectors lambda$joining$11 (Ljava/lang/CharSequence;Ljava/lang/CharSequence;Ljava/lang/CharSequence;)Ljava/util/StringJoiner; ()Ljava/util/StringJoiner;
+@lambda-proxy java/util/stream/Collectors get (Ljava/util/stream/Collector;)Ljava/util/function/Supplier; ()Ljava/lang/Object; REF_invokeStatic java/util/stream/Collectors lambda$partitioningBy$64 (Ljava/util/stream/Collector;)Ljava/util/stream/Collectors$Partition; ()Ljava/util/stream/Collectors$Partition;
+@lambda-proxy java/util/stream/FindOps$FindSink$OfInt get ()Ljava/util/function/Supplier; ()Ljava/lang/Object; REF_newInvokeSpecial java/util/stream/FindOps$FindSink$OfInt <init> ()V ()Ljava/util/stream/TerminalSink;
+@lambda-proxy java/util/stream/FindOps$FindSink$OfInt get ()Ljava/util/function/Supplier; ()Ljava/lang/Object; REF_newInvokeSpecial java/util/stream/FindOps$FindSink$OfInt <init> ()V ()Ljava/util/stream/TerminalSink;
+@lambda-proxy java/util/stream/FindOps$FindSink$OfInt test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeVirtual java/util/OptionalInt isPresent ()Z (Ljava/util/OptionalInt;)Z
+@lambda-proxy java/util/stream/FindOps$FindSink$OfInt test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeVirtual java/util/OptionalInt isPresent ()Z (Ljava/util/OptionalInt;)Z
+@lambda-proxy java/util/stream/FindOps$FindSink$OfRef get ()Ljava/util/function/Supplier; ()Ljava/lang/Object; REF_newInvokeSpecial java/util/stream/FindOps$FindSink$OfRef <init> ()V ()Ljava/util/stream/TerminalSink;
+@lambda-proxy java/util/stream/FindOps$FindSink$OfRef get ()Ljava/util/function/Supplier; ()Ljava/lang/Object; REF_newInvokeSpecial java/util/stream/FindOps$FindSink$OfRef <init> ()V ()Ljava/util/stream/TerminalSink;
+@lambda-proxy java/util/stream/FindOps$FindSink$OfRef test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeVirtual java/util/Optional isPresent ()Z (Ljava/util/Optional;)Z
+@lambda-proxy java/util/stream/FindOps$FindSink$OfRef test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeVirtual java/util/Optional isPresent ()Z (Ljava/util/Optional;)Z
+@lambda-proxy java/util/zip/ZipFile apply (Ljava/util/zip/ZipFile;)Ljava/util/function/IntFunction; (I)Ljava/lang/Object; REF_invokeVirtual java/util/zip/ZipFile lambda$jarStream$1 (I)Ljava/util/jar/JarEntry; (I)Ljava/util/jar/JarEntry;
+@lambda-proxy jdk/internal/module/DefaultRoots apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/lang/module/ModuleDescriptor name ()Ljava/lang/String; (Ljava/lang/module/ModuleDescriptor;)Ljava/lang/String;
+@lambda-proxy jdk/internal/module/DefaultRoots apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/lang/module/ModuleReference descriptor ()Ljava/lang/module/ModuleDescriptor; (Ljava/lang/module/ModuleReference;)Ljava/lang/module/ModuleDescriptor;
+@lambda-proxy jdk/internal/module/DefaultRoots test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeStatic jdk/internal/module/DefaultRoots lambda$compute$0 (Ljava/lang/module/ModuleReference;)Z (Ljava/lang/module/ModuleReference;)Z
+@lambda-proxy jdk/internal/module/DefaultRoots test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeStatic jdk/internal/module/DefaultRoots lambda$exportsAPI$2 (Ljava/lang/module/ModuleDescriptor$Exports;)Z (Ljava/lang/module/ModuleDescriptor$Exports;)Z
+@lambda-proxy jdk/internal/module/DefaultRoots test (Ljava/lang/module/ModuleFinder;)Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeStatic jdk/internal/module/DefaultRoots lambda$compute$1 (Ljava/lang/module/ModuleFinder;Ljava/lang/module/ModuleDescriptor;)Z (Ljava/lang/module/ModuleDescriptor;)Z
+@lambda-proxy jdk/internal/module/ModulePath apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/util/Optional stream ()Ljava/util/stream/Stream; (Ljava/util/Optional;)Ljava/util/stream/Stream;
+@lambda-proxy jdk/internal/module/ModulePath apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/util/Optional stream ()Ljava/util/stream/Stream; (Ljava/util/Optional;)Ljava/util/stream/Stream;
+@lambda-proxy jdk/internal/module/ModulePath apply ()Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual java/util/zip/ZipEntry getName ()Ljava/lang/String; (Ljava/util/jar/JarEntry;)Ljava/lang/String;
+@lambda-proxy jdk/internal/module/ModulePath apply (Ljdk/internal/module/ModulePath;)Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual jdk/internal/module/ModulePath toPackageName (Ljava/lang/String;)Ljava/util/Optional; (Ljava/lang/String;)Ljava/util/Optional;
+@lambda-proxy jdk/internal/module/ModulePath apply (Ljdk/internal/module/ModulePath;)Ljava/util/function/Function; (Ljava/lang/Object;)Ljava/lang/Object; REF_invokeVirtual jdk/internal/module/ModulePath toServiceName (Ljava/lang/String;)Ljava/util/Optional; (Ljava/lang/String;)Ljava/util/Optional;
+@lambda-proxy jdk/internal/module/ModulePath test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeStatic jdk/internal/module/ModulePath lambda$deriveModuleDescriptor$2 (Ljava/util/jar/JarEntry;)Z (Ljava/util/jar/JarEntry;)Z
+@lambda-proxy jdk/internal/module/ModulePath test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeStatic jdk/internal/module/ModulePath lambda$deriveModuleDescriptor$3 (Ljava/lang/String;)Z (Ljava/lang/String;)Z
+@lambda-proxy jdk/internal/module/ModulePath test ()Ljava/util/function/Predicate; (Ljava/lang/Object;)Z REF_invokeStatic jdk/internal/module/ModulePath lambda$deriveModuleDescriptor$4 (Ljava/lang/String;)Z (Ljava/lang/String;)Z
+@lambda-proxy jdk/internal/module/ModuleReferences generate (Ljava/util/function/Supplier;)Ljdk/internal/module/ModuleHashes$HashSupplier; (Ljava/lang/String;)[B REF_invokeStatic jdk/internal/module/ModuleReferences lambda$newJarModule$1 (Ljava/util/function/Supplier;Ljava/lang/String;)[B (Ljava/lang/String;)[B
+@lambda-proxy jdk/internal/module/ModuleReferences get (Ljava/nio/file/Path;Ljava/net/URI;)Ljava/util/function/Supplier; ()Ljava/lang/Object; REF_invokeStatic jdk/internal/module/ModuleReferences lambda$newJarModule$0 (Ljava/nio/file/Path;Ljava/net/URI;)Ljava/lang/module/ModuleReader; ()Ljava/lang/module/ModuleReader;
+@lambda-proxy sun/util/cldr/CLDRLocaleProviderAdapter run ()Ljava/security/PrivilegedExceptionAction; ()Ljava/lang/Object; REF_invokeStatic sun/util/cldr/CLDRLocaleProviderAdapter lambda$new$0 ()Lsun/util/locale/provider/LocaleDataMetaInfo; ()Lsun/util/locale/provider/LocaleDataMetaInfo;
+@lambda-proxy sun/util/cldr/CLDRLocaleProviderAdapter run (Lsun/util/cldr/CLDRLocaleProviderAdapter;)Ljava/security/PrivilegedAction; ()Ljava/lang/Object; REF_invokeVirtual sun/util/cldr/CLDRLocaleProviderAdapter lambda$getCalendarDataProvider$1 ()Ljava/util/spi/CalendarDataProvider; ()Ljava/util/spi/CalendarDataProvider;
+@lambda-proxy sun/util/locale/provider/JRELocaleProviderAdapter run (Lsun/util/locale/provider/JRELocaleProviderAdapter;)Ljava/security/PrivilegedAction; ()Ljava/lang/Object; REF_invokeVirtual sun/util/locale/provider/JRELocaleProviderAdapter lambda$getCalendarProvider$11 ()Lsun/util/spi/CalendarProvider; ()Lsun/util/spi/CalendarProvider;
+@lambda-proxy sun/util/locale/provider/JRELocaleProviderAdapter run (Lsun/util/locale/provider/JRELocaleProviderAdapter;)Ljava/security/PrivilegedAction; ()Ljava/lang/Object; REF_invokeVirtual sun/util/locale/provider/JRELocaleProviderAdapter lambda$getDateFormatProvider$2 ()Ljava/text/spi/DateFormatProvider; ()Ljava/text/spi/DateFormatProvider;
+@lambda-proxy sun/util/locale/provider/JRELocaleProviderAdapter run (Lsun/util/locale/provider/JRELocaleProviderAdapter;)Ljava/security/PrivilegedAction; ()Ljava/lang/Object; REF_invokeVirtual sun/util/locale/provider/JRELocaleProviderAdapter lambda$getDateFormatSymbolsProvider$3 ()Ljava/text/spi/DateFormatSymbolsProvider; ()Ljava/text/spi/DateFormatSymbolsProvider;
+@lambda-proxy sun/util/locale/provider/JRELocaleProviderAdapter run (Lsun/util/locale/provider/JRELocaleProviderAdapter;)Ljava/security/PrivilegedAction; ()Ljava/lang/Object; REF_invokeVirtual sun/util/locale/provider/JRELocaleProviderAdapter lambda$getDecimalFormatSymbolsProvider$4 ()Ljava/text/spi/DecimalFormatSymbolsProvider; ()Ljava/text/spi/DecimalFormatSymbolsProvider;
+@lambda-proxy sun/util/locale/provider/JRELocaleProviderAdapter run (Lsun/util/locale/provider/JRELocaleProviderAdapter;)Ljava/security/PrivilegedAction; ()Ljava/lang/Object; REF_invokeVirtual sun/util/locale/provider/JRELocaleProviderAdapter lambda$getNumberFormatProvider$5 ()Ljava/text/spi/NumberFormatProvider; ()Ljava/text/spi/NumberFormatProvider;
diff --git a/java/temurin-17/lib/ct.sym b/java/temurin-17/lib/ct.sym
new file mode 100644
index 0000000..0f50159
Binary files /dev/null and b/java/temurin-17/lib/ct.sym differ
diff --git a/java/temurin-17/lib/jexec b/java/temurin-17/lib/jexec
new file mode 100755
index 0000000..65a159a
Binary files /dev/null and b/java/temurin-17/lib/jexec differ
diff --git a/java/temurin-17/lib/jfr/default.jfc b/java/temurin-17/lib/jfr/default.jfc
new file mode 100644
index 0000000..9c265eb
--- /dev/null
+++ b/java/temurin-17/lib/jfr/default.jfc
@@ -0,0 +1,1069 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Recommended way to edit .jfc files is to use the configure command of
+ the 'jfr' tool, i.e. jfr configure, or JDK Mission Control
+ see Window -> Flight Recorder Template Manager
+-->
+
+<configuration version="2.0" label="Continuous" description="Low overhead configuration safe for continuous use in production environments, typically less than 1 % overhead." provider="Oracle">
+
+ <event name="jdk.ThreadAllocationStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.ClassLoadingStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.ClassLoaderStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.JavaThreadStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.SymbolTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.StringTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.PlaceholderTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.LoaderConstraintsTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.ProtectionDomainCacheTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.ThreadStart">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ThreadEnd">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.ThreadSleep">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.ThreadPark">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.JavaMonitorEnter">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.JavaMonitorWait">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.JavaMonitorInflate">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.SyncOnValueBasedClass">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.BiasedLockRevocation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.BiasedLockSelfRevocation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.BiasedLockClassRevocation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ReservedStackActivation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ClassLoad">
+ <setting name="enabled" control="class-loading">false</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ClassDefine">
+ <setting name="enabled" control="class-loading">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.RedefineClasses">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.RetransformClasses">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ClassRedefinition">
+ <setting name="enabled" control="class-loading">true</setting>
+ </event>
+
+ <event name="jdk.ClassUnload">
+ <setting name="enabled" control="class-loading">false</setting>
+ </event>
+
+ <event name="jdk.JVMInformation">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.InitialSystemProperty">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ExecutionSample">
+ <setting name="enabled" control="method-sampling-enabled">true</setting>
+ <setting name="period" control="method-sampling-java-interval">20 ms</setting>
+ </event>
+
+ <event name="jdk.NativeMethodSample">
+ <setting name="enabled" control="method-sampling-enabled">true</setting>
+ <setting name="period" control="method-sampling-native-interval">20 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointBegin">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointStateSynchronization">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointCleanup">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointCleanupTask">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointEnd">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.ExecuteVMOperation">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.Shutdown">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ThreadDump">
+ <setting name="enabled" control="thread-dump-enabled">true</setting>
+ <setting name="period" control="thread-dump">everyChunk</setting>
+ </event>
+
+ <event name="jdk.IntFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.UnsignedIntFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.LongFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.UnsignedLongFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.DoubleFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.BooleanFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.StringFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.IntFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.UnsignedIntFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.LongFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.UnsignedLongFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.DoubleFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.BooleanFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.StringFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.ObjectCount">
+ <setting name="enabled" control="gc-enabled-all">false</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.GCConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.GCHeapConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.YoungGenerationConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.GCTLABConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.GCSurvivorConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ObjectCountAfterGC">
+ <setting name="enabled">false</setting>
+ </event>
+
+ <event name="jdk.GCHeapSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.PSHeapSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1HeapSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceGCThreshold">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceAllocationFailure">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceOOM">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceChunkFreeListSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.GarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.SystemGC">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ParallelOldGarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.YoungGarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.OldGarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.G1GarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePause">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePauseLevel1">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePauseLevel2">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePauseLevel3">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePauseLevel4">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhaseConcurrent">
+ <setting name="enabled" control="gc-enabled-high">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhaseConcurrentLevel1">
+ <setting name="enabled" control="gc-enabled-high">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCReferenceStatistics">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.PromotionFailed">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.EvacuationFailed">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.EvacuationInformation">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1MMU">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1EvacuationYoungStatistics">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1EvacuationOldStatistics">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.GCPhaseParallel">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.G1BasicIHOP">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1AdaptiveIHOP">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.PromoteObjectInNewPLAB">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ </event>
+
+ <event name="jdk.PromoteObjectOutsidePLAB">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ </event>
+
+ <event name="jdk.ConcurrentModeFailure">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.AllocationRequiringGC">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.TenuringDistribution">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1HeapRegionInformation">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.G1HeapRegionTypeChange">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ </event>
+
+ <event name="jdk.ShenandoahHeapRegionInformation">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.ShenandoahHeapRegionStateChange">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ </event>
+
+ <event name="jdk.OldObjectSample">
+ <setting name="enabled" control="old-objects-enabled">true</setting>
+ <setting name="stackTrace" control="old-objects-stack-trace">false</setting>
+ <setting name="cutoff" control="old-objects-cutoff">0 ns</setting>
+ </event>
+
+ <event name="jdk.CompilerConfiguration">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.CompilerStatistics">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.Compilation">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="threshold" control="compiler-compilation-threshold">1000 ms</setting>
+ </event>
+
+ <event name="jdk.CompilerPhase">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="threshold" control="compiler-phase-threshold">60 s</setting>
+ </event>
+
+ <event name="jdk.CompilationFailure">
+ <setting name="enabled" control="compiler-enabled-failure">false</setting>
+ </event>
+
+ <event name="jdk.CompilerInlining">
+ <setting name="enabled" control="compiler-enabled-failure">false</setting>
+ </event>
+
+ <event name="jdk.JITRestart">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ </event>
+
+ <event name="jdk.CodeSweeperConfiguration">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.CodeSweeperStatistics">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.SweepCodeCache">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="threshold" control="compiler-sweeper-threshold">100 ms</setting>
+ </event>
+
+ <event name="jdk.CodeCacheConfiguration">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.CodeCacheStatistics">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.CodeCacheFull">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ </event>
+
+ <event name="jdk.OSInformation">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.VirtualizationInformation">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ContainerConfiguration">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ContainerCPUUsage">
+ <setting name="enabled">true</setting>
+ <setting name="period">30 s</setting>
+ </event>
+
+ <event name="jdk.ContainerCPUThrottling">
+ <setting name="enabled">true</setting>
+ <setting name="period">30 s</setting>
+ </event>
+
+ <event name="jdk.ContainerMemoryUsage">
+ <setting name="enabled">true</setting>
+ <setting name="period">30 s</setting>
+ </event>
+
+ <event name="jdk.ContainerIOUsage">
+ <setting name="enabled">true</setting>
+ <setting name="period">30 s</setting>
+ </event>
+
+ <event name="jdk.CPUInformation">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ThreadContextSwitchRate">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.CPULoad">
+ <setting name="enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.ThreadCPULoad">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.CPUTimeStampCounter">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.SystemProcess">
+ <setting name="enabled">true</setting>
+ <setting name="period">endChunk</setting>
+ </event>
+
+ <event name="jdk.ProcessStart">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.NetworkUtilization">
+ <setting name="enabled">true</setting>
+ <setting name="period">5 s</setting>
+ </event>
+
+ <event name="jdk.InitialEnvironmentVariable">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.PhysicalMemory">
+ <setting name="enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.ObjectAllocationInNewTLAB">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ObjectAllocationOutsideTLAB">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ObjectAllocationSample">
+ <setting name="enabled" control="object-allocation-enabled">true</setting>
+ <setting name="throttle" control="allocation-profiling">150/s</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.NativeLibrary">
+ <setting name="enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.ModuleRequire">
+ <setting name="enabled">true</setting>
+ <setting name="period">endChunk</setting>
+ </event>
+
+ <event name="jdk.ModuleExport">
+ <setting name="enabled">true</setting>
+ <setting name="period">endChunk</setting>
+ </event>
+
+ <event name="jdk.FileForce">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="file-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.FileRead">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="file-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.FileWrite">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="file-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.SocketRead">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="socket-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.SocketWrite">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="socket-threshold">20 ms</setting>
+ </event>
+
+ <event name="jdk.Deserialization">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.InitialSecurityProperty">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.SecurityPropertyModification">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.SecurityProviderService">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.TLSHandshake">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.X509Validation">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.X509Certificate">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.JavaExceptionThrow">
+ <setting name="enabled" control="enable-exceptions">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.JavaErrorThrow">
+ <setting name="enabled" control="enable-errors">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ExceptionStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.ActiveRecording">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.ActiveSetting">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.Flush">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ns</setting>
+ </event>
+
+ <event name="jdk.DataLoss">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.DumpReason">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.ZAllocationStall">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZPageAllocation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">1 ms</setting>
+ </event>
+
+ <event name="jdk.ZRelocationSet">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZRelocationSetGroup">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZStatisticsCounter">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZStatisticsSampler">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZThreadPhase">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZUncommit">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZUnmap">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.Deoptimization">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">false</setting>
+ </event>
+
+ <event name="jdk.HeapDump">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ns</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.DirectBufferStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">5 s</setting>
+ </event>
+
+ <event name="jdk.GCLocker">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">1 s</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <!--
+ Contents of the control element is not read by the JVM, it's used
+ by JDK Mission Control and the 'jfr' tool to change settings that
+ carry the control attribute.
+ -->
+ <control>
+ <selection name="gc" default="normal" label="Garbage Collector">
+ <option label="Off" name="off">off</option>
+ <option label="Normal" name="normal">normal</option>
+ <option label="Detailed" name="detailed">detailed</option>
+ <option label="High, incl. TLABs/PLABs (may cause many events)" name="high">high</option>
+ <option label="All, incl. Heap Statistics (may cause long GCs)" name="all">all</option>
+ </selection>
+
+ <condition name="gc-enabled-normal" true="true" false="false">
+ <or>
+ <test name="gc" operator="equal" value="normal"/>
+ <test name="gc" operator="equal" value="detailed"/>
+ <test name="gc" operator="equal" value="high"/>
+ <test name="gc" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="gc-enabled-detailed" true="true" false="false">
+ <or>
+ <test name="gc" operator="equal" value="detailed"/>
+ <test name="gc" operator="equal" value="high"/>
+ <test name="gc" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="gc-enabled-high" true="true" false="false">
+ <or>
+ <test name="gc" operator="equal" value="high"/>
+ <test name="gc" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="gc-enabled-all" true="true" false="false">
+ <test name="gc" operator="equal" value="all"/>
+ </condition>
+
+ <selection name="allocation-profiling" default="low" label="Allocation Profiling">
+ <option label="Off" name="off">0/s</option>
+ <option label="Low" name="low">150/s</option>
+ <option label="Medium" name="medium">300/s</option>
+ <option label="High" name="high">1000/s</option>
+ <option label="Maximum" name="maximum">1000000000/s</option>
+ </selection>
+
+ <condition name="object-allocation-enabled" true="true" false="false">
+ <not>
+ <test name="allocation-profiling" operator="equal" value="off"/>
+ </not>
+ </condition>
+
+ <selection name="compiler" default="normal" label="Compiler">
+ <option label="Off" name="off">off</option>
+ <option label="Normal" name="normal">normal</option>
+ <option label="Detailed" name="detailed">detailed</option>
+ <option label="All" name="all">all</option>
+ </selection>
+
+ <condition name="compiler-enabled" true="false" false="true">
+ <test name="compiler" operator="equal" value="off"/>
+ </condition>
+
+ <condition name="compiler-enabled-failure" true="true" false="false">
+ <or>
+ <test name="compiler" operator="equal" value="detailed"/>
+ <test name="compiler" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="compiler-sweeper-threshold" true="0 ms" false="100 ms">
+ <test name="compiler" operator="equal" value="all"/>
+ </condition>
+
+ <condition name="compiler-compilation-threshold" true="1000 ms">
+ <test name="compiler" operator="equal" value="normal"/>
+ </condition>
+
+ <condition name="compiler-compilation-threshold" true="100 ms">
+ <test name="compiler" operator="equal" value="detailed"/>
+ </condition>
+
+ <condition name="compiler-compilation-threshold" true="0 ms">
+ <test name="compiler" operator="equal" value="all"/>
+ </condition>
+
+ <condition name="compiler-phase-threshold" true="60 s">
+ <test name="compiler" operator="equal" value="normal"/>
+ </condition>
+
+ <condition name="compiler-phase-threshold" true="10 s">
+ <test name="compiler" operator="equal" value="detailed"/>
+ </condition>
+
+ <condition name="compiler-phase-threshold" true="0 s">
+ <test name="compiler" operator="equal" value="all"/>
+ </condition>
+
+ <selection name="method-profiling" default="normal" label="Method Profiling">
+ <option label="Off" name="off">off</option>
+ <option label="Normal" name="normal">normal</option>
+ <option label="High" name="high">high</option>
+ <option label="Maximum (High Overhead)" name="max">max</option>
+ </selection>
+
+ <condition name="method-sampling-java-interval" true="999 d">
+ <test name="method-profiling" operator="equal" value="off"/>
+ </condition>
+
+ <condition name="method-sampling-java-interval" true="20 ms">
+ <test name="method-profiling" operator="equal" value="normal"/>
+ </condition>
+
+ <condition name="method-sampling-java-interval" true="10 ms">
+ <test name="method-profiling" operator="equal" value="high"/>
+ </condition>
+
+ <condition name="method-sampling-java-interval" true="1 ms">
+ <test name="method-profiling" operator="equal" value="max"/>
+ </condition>
+
+ <condition name="method-sampling-native-interval" true="999 d">
+ <test name="method-profiling" operator="equal" value="off"/>
+ </condition>
+
+ <condition name="method-sampling-native-interval" true="20 ms">
+ <or>
+ <test name="method-profiling" operator="equal" value="normal"/>
+ <test name="method-profiling" operator="equal" value="high"/>
+ <test name="method-profiling" operator="equal" value="max"/>
+ </or>
+ </condition>
+
+ <condition name="method-sampling-enabled" true="false" false="true">
+ <test name="method-profiling" operator="equal" value="off"/>
+ </condition>
+
+ <selection name="thread-dump" default="once" label="Thread Dump">
+ <option label="Off" name="off">999 d</option>
+ <option label="At least Once" name="once">everyChunk</option>
+ <option label="Every 60 s" name="60s">60 s</option>
+ <option label="Every 10 s" name="10s">10 s</option>
+ <option label="Every 1 s" name="1s">1 s</option>
+ </selection>
+
+ <condition name="thread-dump-enabled" true="false" false="true">
+ <test name="thread-dump" operator="equal" value="999 d"/>
+ </condition>
+
+ <selection name="exceptions" default="errors" label="Exceptions">
+ <option label="Off" name="off">off</option>
+ <option label="Errors Only" name="errors">errors</option>
+ <option label="All Exceptions, including Errors" name="all">all</option>
+ </selection>
+
+ <condition name="enable-errors" true="true" false="false">
+ <or>
+ <test name="exceptions" operator="equal" value="errors"/>
+ <test name="exceptions" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="enable-exceptions" true="true" false="false">
+ <test name="exceptions" operator="equal" value="all"/>
+ </condition>
+
+ <selection name="memory-leaks" default="types" label="Memory Leak Detection">
+ <option label="Off" name="off">off</option>
+ <option label="Object Types" name="types">types</option>
+ <option label="Object Types + Allocation Stack Traces" name="stack-traces">stack-traces</option>
+ <option label="Object Types + Allocation Stack Traces + Path to GC Root" name="gc-roots">gc-roots</option>
+ </selection>
+
+ <condition name="old-objects-enabled" true="false" false="true">
+ <test name="memory-leaks" operator="equal" value="off"/>
+ </condition>
+
+ <condition name="old-objects-stack-trace" true="true" false="false">
+ <or>
+ <test name="memory-leaks" operator="equal" value="stack-traces"/>
+ <test name="memory-leaks" operator="equal" value="gc-roots"/>
+ </or>
+ </condition>
+
+ <condition name="old-objects-cutoff" true="1 h" false="0 ns">
+ <test name="memory-leaks" operator="equal" value="gc-roots"/>
+ </condition>
+
+ <text name="locking-threshold" label="Locking Threshold" contentType="timespan" minimum="0 s">20 ms</text>
+
+ <text name="file-threshold" label="File I/O Threshold" contentType="timespan" minimum="0 s">20 ms</text>
+
+ <text name="socket-threshold" label="Socket I/O Threshold" contentType="timespan" minimum="0 s">20 ms</text>
+
+ <flag name="class-loading" label="Class Loading">false</flag>
+
+ </control>
+
+</configuration>
diff --git a/java/temurin-17/lib/jfr/profile.jfc b/java/temurin-17/lib/jfr/profile.jfc
new file mode 100644
index 0000000..dd2708d
--- /dev/null
+++ b/java/temurin-17/lib/jfr/profile.jfc
@@ -0,0 +1,1069 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Recommended way to edit .jfc files is to use the configure command of
+ the 'jfr' tool, i.e. jfr configure, or JDK Mission Control
+ see Window -> Flight Recorder Template Manager
+-->
+
+<configuration version="2.0" label="Profiling" description="Low overhead configuration for profiling, typically around 2 % overhead." provider="Oracle">
+
+ <event name="jdk.ThreadAllocationStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.ClassLoadingStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.ClassLoaderStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.JavaThreadStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.SymbolTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.StringTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.PlaceholderTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.LoaderConstraintsTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.ProtectionDomainCacheTableStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.ThreadStart">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ThreadEnd">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.ThreadSleep">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.ThreadPark">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.JavaMonitorEnter">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.JavaMonitorWait">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.JavaMonitorInflate">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="locking-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.SyncOnValueBasedClass">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.BiasedLockRevocation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.BiasedLockSelfRevocation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.BiasedLockClassRevocation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ReservedStackActivation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ClassLoad">
+ <setting name="enabled" control="class-loading">false</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ClassDefine">
+ <setting name="enabled" control="class-loading">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.RedefineClasses">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.RetransformClasses">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ClassRedefinition">
+ <setting name="enabled" control="class-loading">true</setting>
+ </event>
+
+ <event name="jdk.ClassUnload">
+ <setting name="enabled" control="class-loading">false</setting>
+ </event>
+
+ <event name="jdk.JVMInformation">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.InitialSystemProperty">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ExecutionSample">
+ <setting name="enabled" control="method-sampling-enabled">true</setting>
+ <setting name="period" control="method-sampling-java-interval">10 ms</setting>
+ </event>
+
+ <event name="jdk.NativeMethodSample">
+ <setting name="enabled" control="method-sampling-enabled">true</setting>
+ <setting name="period" control="method-sampling-native-interval">20 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointBegin">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointStateSynchronization">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointCleanup">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointCleanupTask">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.SafepointEnd">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ExecuteVMOperation">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.Shutdown">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ThreadDump">
+ <setting name="enabled" control="thread-dump-enabled">true</setting>
+ <setting name="period" control="thread-dump">60 s</setting>
+ </event>
+
+ <event name="jdk.IntFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.UnsignedIntFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.LongFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.UnsignedLongFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.DoubleFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.BooleanFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.StringFlag">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.IntFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.UnsignedIntFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.LongFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.UnsignedLongFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.DoubleFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.BooleanFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.StringFlagChanged">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.ObjectCount">
+ <setting name="enabled" control="gc-enabled-all">false</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.GCConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.GCHeapConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.YoungGenerationConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.GCTLABConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.GCSurvivorConfiguration">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ObjectCountAfterGC">
+ <setting name="enabled">false</setting>
+ </event>
+
+ <event name="jdk.GCHeapSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.PSHeapSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1HeapSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceGCThreshold">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceAllocationFailure">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceOOM">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.MetaspaceChunkFreeListSummary">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.GarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.SystemGC">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ParallelOldGarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.YoungGarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.OldGarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.G1GarbageCollection">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePause">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePauseLevel1">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePauseLevel2">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePauseLevel3">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhasePauseLevel4">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhaseConcurrent">
+ <setting name="enabled" control="gc-enabled-high">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCPhaseConcurrentLevel1">
+ <setting name="enabled" control="gc-enabled-high">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.GCReferenceStatistics">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.PromotionFailed">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.EvacuationFailed">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.EvacuationInformation">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1MMU">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1EvacuationYoungStatistics">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1EvacuationOldStatistics">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.GCPhaseParallel">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.G1BasicIHOP">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1AdaptiveIHOP">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.PromoteObjectInNewPLAB">
+ <setting name="enabled" control="gc-enabled-high">true</setting>
+ </event>
+
+ <event name="jdk.PromoteObjectOutsidePLAB">
+ <setting name="enabled" control="gc-enabled-high">true</setting>
+ </event>
+
+ <event name="jdk.ConcurrentModeFailure">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.AllocationRequiringGC">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.TenuringDistribution">
+ <setting name="enabled" control="gc-enabled-normal">true</setting>
+ </event>
+
+ <event name="jdk.G1HeapRegionInformation">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.G1HeapRegionTypeChange">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ </event>
+
+ <event name="jdk.ShenandoahHeapRegionInformation">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.ShenandoahHeapRegionStateChange">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ </event>
+
+ <event name="jdk.OldObjectSample">
+ <setting name="enabled" control="old-objects-enabled">true</setting>
+ <setting name="stackTrace" control="old-objects-stack-trace">true</setting>
+ <setting name="cutoff" control="old-objects-cutoff">0 ns</setting>
+ </event>
+
+ <event name="jdk.CompilerConfiguration">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.CompilerStatistics">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.Compilation">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="threshold" control="compiler-compilation-threshold">100 ms</setting>
+ </event>
+
+ <event name="jdk.CompilerPhase">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="threshold" control="compiler-phase-threshold">10 s</setting>
+ </event>
+
+ <event name="jdk.CompilationFailure">
+ <setting name="enabled" control="compiler-enabled-failure">true</setting>
+ </event>
+
+ <event name="jdk.CompilerInlining">
+ <setting name="enabled" control="compiler-enabled-failure">false</setting>
+ </event>
+
+ <event name="jdk.JITRestart">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ </event>
+
+ <event name="jdk.CodeSweeperConfiguration">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.CodeSweeperStatistics">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.SweepCodeCache">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="threshold" control="compiler-sweeper-threshold">100 ms</setting>
+ </event>
+
+ <event name="jdk.CodeCacheConfiguration">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.CodeCacheStatistics">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.CodeCacheFull">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ </event>
+
+ <event name="jdk.OSInformation">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.VirtualizationInformation">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ContainerConfiguration">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ContainerCPUUsage">
+ <setting name="enabled">true</setting>
+ <setting name="period">30 s</setting>
+ </event>
+
+ <event name="jdk.ContainerCPUThrottling">
+ <setting name="enabled">true</setting>
+ <setting name="period">30 s</setting>
+ </event>
+
+ <event name="jdk.ContainerMemoryUsage">
+ <setting name="enabled">true</setting>
+ <setting name="period">30 s</setting>
+ </event>
+
+ <event name="jdk.ContainerIOUsage">
+ <setting name="enabled">true</setting>
+ <setting name="period">30 s</setting>
+ </event>
+
+ <event name="jdk.CPUInformation">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.ThreadContextSwitchRate">
+ <setting name="enabled" control="compiler-enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.CPULoad">
+ <setting name="enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.ThreadCPULoad">
+ <setting name="enabled">true</setting>
+ <setting name="period">10 s</setting>
+ </event>
+
+ <event name="jdk.CPUTimeStampCounter">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.SystemProcess">
+ <setting name="enabled">true</setting>
+ <setting name="period">endChunk</setting>
+ </event>
+
+ <event name="jdk.ProcessStart">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.NetworkUtilization">
+ <setting name="enabled">true</setting>
+ <setting name="period">5 s</setting>
+ </event>
+
+ <event name="jdk.InitialEnvironmentVariable">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.PhysicalMemory">
+ <setting name="enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.ObjectAllocationInNewTLAB">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ObjectAllocationOutsideTLAB">
+ <setting name="enabled" control="gc-enabled-high">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ObjectAllocationSample">
+ <setting name="enabled" control="object-allocation-enabled">true</setting>
+ <setting name="throttle" control="allocation-profiling">300/s</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.NativeLibrary">
+ <setting name="enabled">true</setting>
+ <setting name="period">everyChunk</setting>
+ </event>
+
+ <event name="jdk.ModuleRequire">
+ <setting name="enabled">true</setting>
+ <setting name="period">endChunk</setting>
+ </event>
+
+ <event name="jdk.ModuleExport">
+ <setting name="enabled">true</setting>
+ <setting name="period">endChunk</setting>
+ </event>
+
+ <event name="jdk.FileForce">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="file-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.FileRead">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="file-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.FileWrite">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="file-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.SocketRead">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="socket-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.SocketWrite">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold" control="socket-threshold">10 ms</setting>
+ </event>
+
+ <event name="jdk.Deserialization">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.InitialSecurityProperty">
+ <setting name="enabled">true</setting>
+ <setting name="period">beginChunk</setting>
+ </event>
+
+ <event name="jdk.SecurityPropertyModification">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.SecurityProviderService">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.TLSHandshake">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.X509Validation">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.X509Certificate">
+ <setting name="enabled">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.JavaExceptionThrow">
+ <setting name="enabled" control="enable-exceptions">false</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.JavaErrorThrow">
+ <setting name="enabled" control="enable-errors">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.ExceptionStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">1000 ms</setting>
+ </event>
+
+ <event name="jdk.ActiveRecording">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.ActiveSetting">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.Flush">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ns</setting>
+ </event>
+
+ <event name="jdk.DataLoss">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.DumpReason">
+ <setting name="enabled">true</setting>
+ </event>
+
+ <event name="jdk.ZAllocationStall">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZPageAllocation">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ <setting name="threshold">1 ms</setting>
+ </event>
+
+ <event name="jdk.ZRelocationSet">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZRelocationSetGroup">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZStatisticsCounter">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZStatisticsSampler">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZThreadPhase">
+ <setting name="enabled">false</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZUncommit">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.ZUnmap">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ms</setting>
+ </event>
+
+ <event name="jdk.Deoptimization">
+ <setting name="enabled">true</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.HeapDump">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">0 ns</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+ <event name="jdk.DirectBufferStatistics">
+ <setting name="enabled">true</setting>
+ <setting name="period">5 s</setting>
+ </event>
+
+ <event name="jdk.GCLocker">
+ <setting name="enabled">true</setting>
+ <setting name="threshold">100 ms</setting>
+ <setting name="stackTrace">true</setting>
+ </event>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <!--
+ Contents of the control element is not read by the JVM, it's used
+ by JDK Mission Control and the 'jfr' tool to change settings that
+ carry the control attribute.
+ -->
+ <control>
+ <selection name="gc" default="detailed" label="Garbage Collector">
+ <option label="Off" name="off">off</option>
+ <option label="Normal" name="normal">normal</option>
+ <option label="Detailed" name="detailed">detailed</option>
+ <option label="High, incl. TLABs/PLABs (may cause many events)" name="high">high</option>
+ <option label="All, incl. Heap Statistics (may cause long GCs)" name="all">all</option>
+ </selection>
+
+ <condition name="gc-enabled-normal" true="true" false="false">
+ <or>
+ <test name="gc" operator="equal" value="normal"/>
+ <test name="gc" operator="equal" value="detailed"/>
+ <test name="gc" operator="equal" value="high"/>
+ <test name="gc" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="gc-enabled-detailed" true="true" false="false">
+ <or>
+ <test name="gc" operator="equal" value="detailed"/>
+ <test name="gc" operator="equal" value="high"/>
+ <test name="gc" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="gc-enabled-high" true="true" false="false">
+ <or>
+ <test name="gc" operator="equal" value="high"/>
+ <test name="gc" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="gc-enabled-all" true="true" false="false">
+ <test name="gc" operator="equal" value="all"/>
+ </condition>
+
+ <selection name="allocation-profiling" default="medium" label="Allocation Profiling">
+ <option label="Off" name="off">0/s</option>
+ <option label="Low" name="low">150/s</option>
+ <option label="Medium" name="medium">300/s</option>
+ <option label="High" name="high">1000/s</option>
+ <option label="Maximum" name="maximum">1000000000/s</option>
+ </selection>
+
+ <condition name="object-allocation-enabled" true="true" false="false">
+ <not>
+ <test name="allocation-profiling" operator="equal" value="off"/>
+ </not>
+ </condition>
+
+ <selection name="compiler" default="detailed" label="Compiler">
+ <option label="Off" name="off">off</option>
+ <option label="Normal" name="normal">normal</option>
+ <option label="Detailed" name="detailed">detailed</option>
+ <option label="All" name="all">all</option>
+ </selection>
+
+ <condition name="compiler-enabled" true="false" false="true">
+ <test name="compiler" operator="equal" value="off"/>
+ </condition>
+
+ <condition name="compiler-enabled-failure" true="true" false="false">
+ <or>
+ <test name="compiler" operator="equal" value="detailed"/>
+ <test name="compiler" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="compiler-sweeper-threshold" true="0 ms" false="100 ms">
+ <test name="compiler" operator="equal" value="all"/>
+ </condition>
+
+ <condition name="compiler-compilation-threshold" true="1000 ms">
+ <test name="compiler" operator="equal" value="normal"/>
+ </condition>
+
+ <condition name="compiler-compilation-threshold" true="100 ms">
+ <test name="compiler" operator="equal" value="detailed"/>
+ </condition>
+
+ <condition name="compiler-compilation-threshold" true="0 ms">
+ <test name="compiler" operator="equal" value="all"/>
+ </condition>
+
+ <condition name="compiler-phase-threshold" true="60 s">
+ <test name="compiler" operator="equal" value="normal"/>
+ </condition>
+
+ <condition name="compiler-phase-threshold" true="10 s">
+ <test name="compiler" operator="equal" value="detailed"/>
+ </condition>
+
+ <condition name="compiler-phase-threshold" true="0 s">
+ <test name="compiler" operator="equal" value="all"/>
+ </condition>
+
+ <selection name="method-profiling" default="high" label="Method Profiling">
+ <option label="Off" name="off">off</option>
+ <option label="Normal" name="normal">normal</option>
+ <option label="High" name="high">high</option>
+ <option label="Maximum (High Overhead)" name="max">max</option>
+ </selection>
+
+ <condition name="method-sampling-java-interval" true="999 d">
+ <test name="method-profiling" operator="equal" value="off"/>
+ </condition>
+
+ <condition name="method-sampling-java-interval" true="20 ms">
+ <test name="method-profiling" operator="equal" value="normal"/>
+ </condition>
+
+ <condition name="method-sampling-java-interval" true="10 ms">
+ <test name="method-profiling" operator="equal" value="high"/>
+ </condition>
+
+ <condition name="method-sampling-java-interval" true="1 ms">
+ <test name="method-profiling" operator="equal" value="max"/>
+ </condition>
+
+ <condition name="method-sampling-native-interval" true="999 d">
+ <test name="method-profiling" operator="equal" value="off"/>
+ </condition>
+
+ <condition name="method-sampling-native-interval" true="20 ms">
+ <or>
+ <test name="method-profiling" operator="equal" value="normal"/>
+ <test name="method-profiling" operator="equal" value="high"/>
+ <test name="method-profiling" operator="equal" value="max"/>
+ </or>
+ </condition>
+
+ <condition name="method-sampling-enabled" true="false" false="true">
+ <test name="method-profiling" operator="equal" value="off"/>
+ </condition>
+
+ <selection name="thread-dump" default="once" label="Thread Dump">
+ <option label="Off" name="off">999 d</option>
+ <option label="At least Once" name="once">everyChunk</option>
+ <option label="Every 60 s" name="60s">60 s</option>
+ <option label="Every 10 s" name="10s">10 s</option>
+ <option label="Every 1 s" name="1s">1 s</option>
+ </selection>
+
+ <condition name="thread-dump-enabled" true="false" false="true">
+ <test name="thread-dump" operator="equal" value="999 d"/>
+ </condition>
+
+ <selection name="exceptions" default="errors" label="Exceptions">
+ <option label="Off" name="off">off</option>
+ <option label="Errors Only" name="errors">errors</option>
+ <option label="All Exceptions, including Errors" name="all">all</option>
+ </selection>
+
+ <condition name="enable-errors" true="true" false="false">
+ <or>
+ <test name="exceptions" operator="equal" value="errors"/>
+ <test name="exceptions" operator="equal" value="all"/>
+ </or>
+ </condition>
+
+ <condition name="enable-exceptions" true="true" false="false">
+ <test name="exceptions" operator="equal" value="all"/>
+ </condition>
+
+ <selection name="memory-leaks" default="stack-traces" label="Memory Leak Detection">
+ <option label="Off" name="off">off</option>
+ <option label="Object Types" name="types">types</option>
+ <option label="Object Types + Allocation Stack Traces" name="stack-traces">stack-traces</option>
+ <option label="Object Types + Allocation Stack Traces + Path to GC Root" name="gc-roots">gc-roots</option>
+ </selection>
+
+ <condition name="old-objects-enabled" true="false" false="true">
+ <test name="memory-leaks" operator="equal" value="off"/>
+ </condition>
+
+ <condition name="old-objects-stack-trace" true="true" false="false">
+ <or>
+ <test name="memory-leaks" operator="equal" value="stack-traces"/>
+ <test name="memory-leaks" operator="equal" value="gc-roots"/>
+ </or>
+ </condition>
+
+ <condition name="old-objects-cutoff" true="1 h" false="0 ns">
+ <test name="memory-leaks" operator="equal" value="gc-roots"/>
+ </condition>
+
+ <text name="locking-threshold" label="Locking Threshold" contentType="timespan" minimum="0 s">10 ms</text>
+
+ <text name="file-threshold" label="File I/O Threshold" contentType="timespan" minimum="0 s">10 ms</text>
+
+ <text name="socket-threshold" label="Socket I/O Threshold" contentType="timespan" minimum="0 s">10 ms</text>
+
+ <flag name="class-loading" label="Class Loading">false</flag>
+
+ </control>
+
+</configuration>
diff --git a/java/temurin-17/lib/jrt-fs.jar b/java/temurin-17/lib/jrt-fs.jar
new file mode 100644
index 0000000..7ce774c
Binary files /dev/null and b/java/temurin-17/lib/jrt-fs.jar differ
diff --git a/java/temurin-17/lib/jspawnhelper b/java/temurin-17/lib/jspawnhelper
new file mode 100755
index 0000000..41b5025
Binary files /dev/null and b/java/temurin-17/lib/jspawnhelper differ
diff --git a/java/temurin-17/lib/jvm.cfg b/java/temurin-17/lib/jvm.cfg
new file mode 100644
index 0000000..97225c8
--- /dev/null
+++ b/java/temurin-17/lib/jvm.cfg
@@ -0,0 +1,2 @@
+-server KNOWN
+-client IGNORE
diff --git a/java/temurin-17/lib/libattach.so b/java/temurin-17/lib/libattach.so
new file mode 100644
index 0000000..c389586
Binary files /dev/null and b/java/temurin-17/lib/libattach.so differ
diff --git a/java/temurin-17/lib/libawt.so b/java/temurin-17/lib/libawt.so
new file mode 100644
index 0000000..3c373eb
Binary files /dev/null and b/java/temurin-17/lib/libawt.so differ
diff --git a/java/temurin-17/lib/libawt_headless.so b/java/temurin-17/lib/libawt_headless.so
new file mode 100644
index 0000000..ba78dc7
Binary files /dev/null and b/java/temurin-17/lib/libawt_headless.so differ
diff --git a/java/temurin-17/lib/libawt_xawt.so b/java/temurin-17/lib/libawt_xawt.so
new file mode 100644
index 0000000..2b1d6f9
Binary files /dev/null and b/java/temurin-17/lib/libawt_xawt.so differ
diff --git a/java/temurin-17/lib/libdt_socket.so b/java/temurin-17/lib/libdt_socket.so
new file mode 100644
index 0000000..1b5e6de
Binary files /dev/null and b/java/temurin-17/lib/libdt_socket.so differ
diff --git a/java/temurin-17/lib/libextnet.so b/java/temurin-17/lib/libextnet.so
new file mode 100644
index 0000000..458cce1
Binary files /dev/null and b/java/temurin-17/lib/libextnet.so differ
diff --git a/java/temurin-17/lib/libfontmanager.so b/java/temurin-17/lib/libfontmanager.so
new file mode 100644
index 0000000..1696bbf
Binary files /dev/null and b/java/temurin-17/lib/libfontmanager.so differ
diff --git a/java/temurin-17/lib/libinstrument.so b/java/temurin-17/lib/libinstrument.so
new file mode 100644
index 0000000..e14987b
Binary files /dev/null and b/java/temurin-17/lib/libinstrument.so differ
diff --git a/java/temurin-17/lib/libj2gss.so b/java/temurin-17/lib/libj2gss.so
new file mode 100644
index 0000000..deb34e7
Binary files /dev/null and b/java/temurin-17/lib/libj2gss.so differ
diff --git a/java/temurin-17/lib/libj2pcsc.so b/java/temurin-17/lib/libj2pcsc.so
new file mode 100644
index 0000000..150ed54
Binary files /dev/null and b/java/temurin-17/lib/libj2pcsc.so differ
diff --git a/java/temurin-17/lib/libj2pkcs11.so b/java/temurin-17/lib/libj2pkcs11.so
new file mode 100644
index 0000000..b4edd32
Binary files /dev/null and b/java/temurin-17/lib/libj2pkcs11.so differ
diff --git a/java/temurin-17/lib/libjaas.so b/java/temurin-17/lib/libjaas.so
new file mode 100644
index 0000000..9ea39d4
Binary files /dev/null and b/java/temurin-17/lib/libjaas.so differ
diff --git a/java/temurin-17/lib/libjava.so b/java/temurin-17/lib/libjava.so
new file mode 100644
index 0000000..320da15
Binary files /dev/null and b/java/temurin-17/lib/libjava.so differ
diff --git a/java/temurin-17/lib/libjavajpeg.so b/java/temurin-17/lib/libjavajpeg.so
new file mode 100644
index 0000000..598af47
Binary files /dev/null and b/java/temurin-17/lib/libjavajpeg.so differ
diff --git a/java/temurin-17/lib/libjawt.so b/java/temurin-17/lib/libjawt.so
new file mode 100644
index 0000000..6a2806a
Binary files /dev/null and b/java/temurin-17/lib/libjawt.so differ
diff --git a/java/temurin-17/lib/libjdwp.so b/java/temurin-17/lib/libjdwp.so
new file mode 100644
index 0000000..276a39d
Binary files /dev/null and b/java/temurin-17/lib/libjdwp.so differ
diff --git a/java/temurin-17/lib/libjimage.so b/java/temurin-17/lib/libjimage.so
new file mode 100644
index 0000000..98414ef
Binary files /dev/null and b/java/temurin-17/lib/libjimage.so differ
diff --git a/java/temurin-17/lib/libjli.so b/java/temurin-17/lib/libjli.so
new file mode 100644
index 0000000..4a9c0fd
Binary files /dev/null and b/java/temurin-17/lib/libjli.so differ
diff --git a/java/temurin-17/lib/libjsig.so b/java/temurin-17/lib/libjsig.so
new file mode 100644
index 0000000..8e40f8c
Binary files /dev/null and b/java/temurin-17/lib/libjsig.so differ
diff --git a/java/temurin-17/lib/libjsound.so b/java/temurin-17/lib/libjsound.so
new file mode 100644
index 0000000..f3ac9ac
Binary files /dev/null and b/java/temurin-17/lib/libjsound.so differ
diff --git a/java/temurin-17/lib/libjsvml.so b/java/temurin-17/lib/libjsvml.so
new file mode 100644
index 0000000..d494ea4
Binary files /dev/null and b/java/temurin-17/lib/libjsvml.so differ
diff --git a/java/temurin-17/lib/liblcms.so b/java/temurin-17/lib/liblcms.so
new file mode 100644
index 0000000..9a5f0c7
Binary files /dev/null and b/java/temurin-17/lib/liblcms.so differ
diff --git a/java/temurin-17/lib/libmanagement.so b/java/temurin-17/lib/libmanagement.so
new file mode 100644
index 0000000..bad26a0
Binary files /dev/null and b/java/temurin-17/lib/libmanagement.so differ
diff --git a/java/temurin-17/lib/libmanagement_agent.so b/java/temurin-17/lib/libmanagement_agent.so
new file mode 100644
index 0000000..b85276d
Binary files /dev/null and b/java/temurin-17/lib/libmanagement_agent.so differ
diff --git a/java/temurin-17/lib/libmanagement_ext.so b/java/temurin-17/lib/libmanagement_ext.so
new file mode 100644
index 0000000..c730e98
Binary files /dev/null and b/java/temurin-17/lib/libmanagement_ext.so differ
diff --git a/java/temurin-17/lib/libmlib_image.so b/java/temurin-17/lib/libmlib_image.so
new file mode 100644
index 0000000..05bd000
Binary files /dev/null and b/java/temurin-17/lib/libmlib_image.so differ
diff --git a/java/temurin-17/lib/libnet.so b/java/temurin-17/lib/libnet.so
new file mode 100644
index 0000000..26bf820
Binary files /dev/null and b/java/temurin-17/lib/libnet.so differ
diff --git a/java/temurin-17/lib/libnio.so b/java/temurin-17/lib/libnio.so
new file mode 100644
index 0000000..a6432b2
Binary files /dev/null and b/java/temurin-17/lib/libnio.so differ
diff --git a/java/temurin-17/lib/libprefs.so b/java/temurin-17/lib/libprefs.so
new file mode 100644
index 0000000..325a939
Binary files /dev/null and b/java/temurin-17/lib/libprefs.so differ
diff --git a/java/temurin-17/lib/librmi.so b/java/temurin-17/lib/librmi.so
new file mode 100644
index 0000000..26a33e7
Binary files /dev/null and b/java/temurin-17/lib/librmi.so differ
diff --git a/java/temurin-17/lib/libsaproc.so b/java/temurin-17/lib/libsaproc.so
new file mode 100644
index 0000000..b569353
Binary files /dev/null and b/java/temurin-17/lib/libsaproc.so differ
diff --git a/java/temurin-17/lib/libsctp.so b/java/temurin-17/lib/libsctp.so
new file mode 100644
index 0000000..5b3621a
Binary files /dev/null and b/java/temurin-17/lib/libsctp.so differ
diff --git a/java/temurin-17/lib/libsplashscreen.so b/java/temurin-17/lib/libsplashscreen.so
new file mode 100644
index 0000000..be04b2f
Binary files /dev/null and b/java/temurin-17/lib/libsplashscreen.so differ
diff --git a/java/temurin-17/lib/libsyslookup.so b/java/temurin-17/lib/libsyslookup.so
new file mode 100644
index 0000000..85510fe
Binary files /dev/null and b/java/temurin-17/lib/libsyslookup.so differ
diff --git a/java/temurin-17/lib/libverify.so b/java/temurin-17/lib/libverify.so
new file mode 100644
index 0000000..f4d264e
Binary files /dev/null and b/java/temurin-17/lib/libverify.so differ
diff --git a/java/temurin-17/lib/libzip.so b/java/temurin-17/lib/libzip.so
new file mode 100644
index 0000000..ec934d6
Binary files /dev/null and b/java/temurin-17/lib/libzip.so differ
diff --git a/java/temurin-17/lib/modules b/java/temurin-17/lib/modules
new file mode 100644
index 0000000..4707bb9
Binary files /dev/null and b/java/temurin-17/lib/modules differ
diff --git a/java/temurin-17/lib/psfont.properties.ja b/java/temurin-17/lib/psfont.properties.ja
new file mode 100644
index 0000000..d17cf40
--- /dev/null
+++ b/java/temurin-17/lib/psfont.properties.ja
@@ -0,0 +1,119 @@
+#
+#
+# Copyright (c) 1996, 2000, Oracle and/or its affiliates. All rights reserved.
+# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+#
+# This code is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License version 2 only, as
+# published by the Free Software Foundation. Oracle designates this
+# particular file as subject to the "Classpath" exception as provided
+# by Oracle in the LICENSE file that accompanied this code.
+#
+# This code is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# version 2 for more details (a copy is included in the LICENSE file that
+# accompanied this code).
+#
+# You should have received a copy of the GNU General Public License version
+# 2 along with this work; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+# or visit www.oracle.com if you need additional information or have any
+# questions.
+#
+
+#
+# Japanese PostScript printer property file
+#
+font.num=16
+#
+serif=serif
+timesroman=serif
+sansserif=sansserif
+helvetica=sansserif
+monospaced=monospaced
+courier=monospaced
+dialog=sansserif
+dialoginput=monospaced
+#
+serif.latin1.plain=Times-Roman
+serif.latin1.italic=Times-Italic
+serif.latin1.bolditalic=Times-BoldItalic
+serif.latin1.bold=Times-Bold
+#
+sansserif.latin1.plain=Helvetica
+sansserif.latin1.italic=Helvetica-Oblique
+sansserif.latin1.bolditalic=Helvetica-BoldOblique
+sansserif.latin1.bold=Helvetica-Bold
+#
+monospaced.latin1.plain=Courier
+monospaced.latin1.italic=Courier-Oblique
+monospaced.latin1.bolditalic=Courier-BoldOblique
+monospaced.latin1.bold=Courier-Bold
+#
+serif.x11jis0208.plain=Ryumin-Light-H
+serif.x11jis0208.italic=Ryumin-Light-H
+serif.x11jis0208.bolditalic=Ryumin-Light-H
+serif.x11jis0208.bold=Ryumin-Light-H
+#
+sansserif.x11jis0208.plain=GothicBBB-Medium-H
+sansserif.x11jis0208.italic=GothicBBB-Medium-H
+sansserif.x11jis0208.bolditalic=GothicBBB-Medium-H
+sansserif.x11jis0208.bold=GothicBBB-Medium-H
+#
+monospaced.x11jis0208.plain=GothicBBB-Medium-H
+monospaced.x11jis0208.italic=GothicBBB-Medium-H
+monospaced.x11jis0208.bolditalic=GothicBBB-Medium-H
+monospaced.x11jis0208.bold=GothicBBB-Medium-H
+#
+serif.x11jis0201.plain=Ryumin-Light.Hankaku
+serif.x11jis0201.italic=Ryumin-Light.Hankaku
+serif.x11jis0201.bolditalic=Ryumin-Light.Hankaku
+serif.x11jis0201.bold=Ryumin-Light.Hankaku
+#
+sansserif.x11jis0201.plain=GothicBBB-Medium.Hankaku
+sansserif.x11jis0201.italic=GothicBBB-Medium.Hankaku
+sansserif.x11jis0201.bolditalic=GothicBBB-Medium.Hankaku
+sansserif.x11jis0201.bold=GothicBBB-Medium.Hankaku
+#
+monospaced.x11jis0201.plain=GothicBBB-Medium.Hankaku
+monospaced.x11jis0201.italic=GothicBBB-Medium.Hankaku
+monospaced.x11jis0201.bolditalic=GothicBBB-Medium.Hankaku
+monospaced.x11jis0201.bold=GothicBBB-Medium.Hankaku
+#
+Helvetica=0
+Helvetica-Bold=1
+Helvetica-Oblique=2
+Helvetica-BoldOblique=3
+Times-Roman=4
+Times-Bold=5
+Times-Italic=6
+Times-BoldItalic=7
+Courier=8
+Courier-Bold=9
+Courier-Oblique=10
+Courier-BoldOblique=11
+GothicBBB-Medium-H=12
+Ryumin-Light-H=13
+GothicBBB-Medium.Hankaku=14
+Ryumin-Light.Hankaku=15
+#
+font.0=Helvetica ISOF
+font.1=Helvetica-Bold ISOF
+font.2=Helvetica-Oblique ISOF
+font.3=Helvetica-BoldOblique ISOF
+font.4=Times-Roman ISOF
+font.5=Times-Bold ISOF
+font.6=Times-Italic ISOF
+font.7=Times-BoldItalic ISOF
+font.8=Courier ISOF
+font.9=Courier-Bold ISOF
+font.10=Courier-Oblique ISOF
+font.11=Courier-BoldOblique ISOF
+font.12=GothicBBB-Medium-H findfont
+font.13=Ryumin-Light-H findfont
+font.14=GothicBBB-Medium.Hankaku findfont
+font.15=Ryumin-Light.Hankaku findfont
+#
diff --git a/java/temurin-17/lib/psfontj2d.properties b/java/temurin-17/lib/psfontj2d.properties
new file mode 100644
index 0000000..5eb2c4b
--- /dev/null
+++ b/java/temurin-17/lib/psfontj2d.properties
@@ -0,0 +1,323 @@
+#
+#
+# Copyright (c) 1999, Oracle and/or its affiliates. All rights reserved.
+# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+#
+# This code is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License version 2 only, as
+# published by the Free Software Foundation. Oracle designates this
+# particular file as subject to the "Classpath" exception as provided
+# by Oracle in the LICENSE file that accompanied this code.
+#
+# This code is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# version 2 for more details (a copy is included in the LICENSE file that
+# accompanied this code).
+#
+# You should have received a copy of the GNU General Public License version
+# 2 along with this work; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+# or visit www.oracle.com if you need additional information or have any
+# questions.
+
+#
+# PostScript printer property file for Java 2D printing.
+#
+# WARNING: This is an internal implementation file, not a public file.
+# Any customisation or reliance on the existence of this file and its
+# contents or syntax is discouraged and unsupported.
+# It may be incompatibly changed or removed without any notice.
+#
+#
+font.num=35
+#
+# Legacy logical font family names and logical font aliases should all
+# map to the primary logical font names.
+#
+serif=serif
+times=serif
+timesroman=serif
+sansserif=sansserif
+helvetica=sansserif
+dialog=sansserif
+dialoginput=monospaced
+monospaced=monospaced
+courier=monospaced
+#
+# Next, physical fonts which can be safely mapped to standard postscript fonts
+# These keys generally map to a value which is the same as the key, so
+# the key/value is just a way to say the font has a mapping.
+# Sometimes however we map more than one screen font to the same PS font.
+#
+avantgarde=avantgarde_book
+avantgarde_book=avantgarde_book
+avantgarde_demi=avantgarde_demi
+avantgarde_book_oblique=avantgarde_book_oblique
+avantgarde_demi_oblique=avantgarde_demi_oblique
+#
+itcavantgarde=avantgarde_book
+itcavantgarde=avantgarde_book
+itcavantgarde_demi=avantgarde_demi
+itcavantgarde_oblique=avantgarde_book_oblique
+itcavantgarde_demi_oblique=avantgarde_demi_oblique
+#
+bookman=bookman_light
+bookman_light=bookman_light
+bookman_demi=bookman_demi
+bookman_light_italic=bookman_light_italic
+bookman_demi_italic=bookman_demi_italic
+#
+# Exclude "helvetica" on its own as that's a legacy name for a logical font
+helvetica_bold=helvetica_bold
+helvetica_oblique=helvetica_oblique
+helvetica_bold_oblique=helvetica_bold_oblique
+#
+itcbookman_light=bookman_light
+itcbookman_demi=bookman_demi
+itcbookman_light_italic=bookman_light_italic
+itcbookman_demi_italic=bookman_demi_italic
+#
+# Exclude "courier" on its own as that's a legacy name for a logical font
+courier_bold=courier_bold
+courier_oblique=courier_oblique
+courier_bold_oblique=courier_bold_oblique
+#
+courier_new=courier
+courier_new_bold=courier_bold
+#
+monotype_century_schoolbook=newcenturyschoolbook
+monotype_century_schoolbook_bold=newcenturyschoolbook_bold
+monotype_century_schoolbook_italic=newcenturyschoolbook_italic
+monotype_century_schoolbook_bold_italic=newcenturyschoolbook_bold_italic
+#
+newcenturyschoolbook=newcenturyschoolbook
+newcenturyschoolbook_bold=newcenturyschoolbook_bold
+newcenturyschoolbook_italic=newcenturyschoolbook_italic
+newcenturyschoolbook_bold_italic=newcenturyschoolbook_bold_italic
+#
+palatino=palatino
+palatino_bold=palatino_bold
+palatino_italic=palatino_italic
+palatino_bold_italic=palatino_bold_italic
+#
+# Exclude "times" on its own as that's a legacy name for a logical font
+times_bold=times_roman_bold
+times_italic=times_roman_italic
+times_bold_italic=times_roman_bold_italic
+#
+times_roman=times_roman
+times_roman_bold=times_roman_bold
+times_roman_italic=times_roman_italic
+times_roman_bold_italic=times_roman_bold_italic
+#
+times_new_roman=times_roman
+times_new_roman_bold=times_roman_bold
+times_new_roman_italic=times_roman_italic
+times_new_roman_bold_italic=times_roman_bold_italic
+#
+zapfchancery_italic=zapfchancery_italic
+itczapfchancery_italic=zapfchancery_italic
+#
+# Next the mapping of the font name + charset + style to Postscript font name
+# for the logical fonts.
+#
+serif.latin1.plain=Times-Roman
+serif.latin1.bold=Times-Bold
+serif.latin1.italic=Times-Italic
+serif.latin1.bolditalic=Times-BoldItalic
+serif.symbol.plain=Symbol
+serif.dingbats.plain=ZapfDingbats
+serif.symbol.bold=Symbol
+serif.dingbats.bold=ZapfDingbats
+serif.symbol.italic=Symbol
+serif.dingbats.italic=ZapfDingbats
+serif.symbol.bolditalic=Symbol
+serif.dingbats.bolditalic=ZapfDingbats
+#
+sansserif.latin1.plain=Helvetica
+sansserif.latin1.bold=Helvetica-Bold
+sansserif.latin1.italic=Helvetica-Oblique
+sansserif.latin1.bolditalic=Helvetica-BoldOblique
+sansserif.symbol.plain=Symbol
+sansserif.dingbats.plain=ZapfDingbats
+sansserif.symbol.bold=Symbol
+sansserif.dingbats.bold=ZapfDingbats
+sansserif.symbol.italic=Symbol
+sansserif.dingbats.italic=ZapfDingbats
+sansserif.symbol.bolditalic=Symbol
+sansserif.dingbats.bolditalic=ZapfDingbats
+#
+monospaced.latin1.plain=Courier
+monospaced.latin1.bold=Courier-Bold
+monospaced.latin1.italic=Courier-Oblique
+monospaced.latin1.bolditalic=Courier-BoldOblique
+monospaced.symbol.plain=Symbol
+monospaced.dingbats.plain=ZapfDingbats
+monospaced.symbol.bold=Symbol
+monospaced.dingbats.bold=ZapfDingbats
+monospaced.symbol.italic=Symbol
+monospaced.dingbats.italic=ZapfDingbats
+monospaced.symbol.bolditalic=Symbol
+monospaced.dingbats.bolditalic=ZapfDingbats
+#
+# Next the mapping of the font name + charset + style to Postscript font name
+# for the physical fonts. Since these always report style as plain, the
+# style key is always plain. So we map using the face name to the correct
+# style for the postscript font. This is possible since the face names can
+# be replied upon to be different for each style.
+# However an application may try to create a Font applying a style to an
+# physical name. We want to map to the correct Postscript font there too
+# if possible but we do not map cases where the application tries to
+# augment a style (eg ask for a bold version of a bold font)
+# Defer to the 2D package to attempt create an artificially styled version
+#
+avantgarde_book.latin1.plain=AvantGarde-Book
+avantgarde_demi.latin1.plain=AvantGarde-Demi
+avantgarde_book_oblique.latin1.plain=AvantGarde-BookOblique
+avantgarde_demi_oblique.latin1.plain=AvantGarde-DemiOblique
+#
+avantgarde_book.latin1.bold=AvantGarde-Demi
+avantgarde_book.latin1.italic=AvantGarde-BookOblique
+avantgarde_book.latin1.bolditalic=AvantGarde-DemiOblique
+avantgarde_demi.latin1.italic=AvantGarde-DemiOblique
+avantgarde_book_oblique.latin1.bold=AvantGarde-DemiOblique
+#
+bookman_light.latin1.plain=Bookman-Light
+bookman_demi.latin1.plain=Bookman-Demi
+bookman_light_italic.latin1.plain=Bookman-LightItalic
+bookman_demi_italic.latin1.plain=Bookman-DemiItalic
+#
+bookman_light.latin1.bold=Bookman-Demi
+bookman_light.latin1.italic=Bookman-LightItalic
+bookman_light.latin1.bolditalic=Bookman-DemiItalic
+bookman_light_bold.latin1.italic=Bookman-DemiItalic
+bookman_light_italic.latin1.bold=Bookman-DemiItalic
+#
+courier.latin1.plain=Courier
+courier_bold.latin1.plain=Courier-Bold
+courier_oblique.latin1.plain=Courier-Oblique
+courier_bold_oblique.latin1.plain=Courier-BoldOblique
+courier.latin1.bold=Courier-Bold
+courier.latin1.italic=Courier-Oblique
+courier.latin1.bolditalic=Courier-BoldOblique
+courier_bold.latin1.italic=Courier-BoldOblique
+courier_italic.latin1.bold=Courier-BoldOblique
+#
+helvetica_bold.latin1.plain=Helvetica-Bold
+helvetica_oblique.latin1.plain=Helvetica-Oblique
+helvetica_bold_oblique.latin1.plain=Helvetica-BoldOblique
+helvetica.latin1.bold=Helvetica-Bold
+helvetica.latin1.italic=Helvetica-Oblique
+helvetica.latin1.bolditalic=Helvetica-BoldOblique
+helvetica_bold.latin1.italic=Helvetica-BoldOblique
+helvetica_italic.latin1.bold=Helvetica-BoldOblique
+#
+newcenturyschoolbook.latin1.plain=NewCenturySchlbk-Roman
+newcenturyschoolbook_bold.latin1.plain=NewCenturySchlbk-Bold
+newcenturyschoolbook_italic.latin1.plain=NewCenturySchlbk-Italic
+newcenturyschoolbook_bold_italic.latin1.plain=NewCenturySchlbk-BoldItalic
+newcenturyschoolbook.latin1.bold=NewCenturySchlbk-Bold
+newcenturyschoolbook.latin1.italic=NewCenturySchlbk-Italic
+newcenturyschoolbook.latin1.bolditalic=NewCenturySchlbk-BoldItalic
+newcenturyschoolbook_bold.latin1.italic=NewCenturySchlbk-BoldItalic
+newcenturyschoolbook_italic.latin1.bold=NewCenturySchlbk-BoldItalic
+#
+palatino.latin1.plain=Palatino-Roman
+palatino_bold.latin1.plain=Palatino-Bold
+palatino_italic.latin1.plain=Palatino-Italic
+palatino_bold_italic.latin1.plain=Palatino-BoldItalic
+palatino.latin1.bold=Palatino-Bold
+palatino.latin1.italic=Palatino-Italic
+palatino.latin1.bolditalic=Palatino-BoldItalic
+palatino_bold.latin1.italic=Palatino-BoldItalic
+palatino_italic.latin1.bold=Palatino-BoldItalic
+#
+times_roman.latin1.plain=Times-Roman
+times_roman_bold.latin1.plain=Times-Bold
+times_roman_italic.latin1.plain=Times-Italic
+times_roman_bold_italic.latin1.plain=Times-BoldItalic
+times_roman.latin1.bold=Times-Bold
+times_roman.latin1.italic=Times-Italic
+times_roman.latin1.bolditalic=Times-BoldItalic
+times_roman_bold.latin1.italic=Times-BoldItalic
+times_roman_italic.latin1.bold=Times-BoldItalic
+#
+zapfchancery_italic.latin1.plain=ZapfChancery-MediumItalic
+#
+# Finally the mappings of PS font names to indexes.
+#
+AvantGarde-Book=0
+AvantGarde-BookOblique=1
+AvantGarde-Demi=2
+AvantGarde-DemiOblique=3
+Bookman-Demi=4
+Bookman-DemiItalic=5
+Bookman-Light=6
+Bookman-LightItalic=7
+Courier=8
+Courier-Bold=9
+Courier-BoldOblique=10
+Courier-Oblique=11
+Helvetica=12
+Helvetica-Bold=13
+Helvetica-BoldOblique=14
+Helvetica-Narrow=15
+Helvetica-Narrow-Bold=16
+Helvetica-Narrow-BoldOblique=17
+Helvetica-Narrow-Oblique=18
+Helvetica-Oblique=19
+NewCenturySchlbk-Bold=20
+NewCenturySchlbk-BoldItalic=21
+NewCenturySchlbk-Italic=22
+NewCenturySchlbk-Roman=23
+Palatino-Bold=24
+Palatino-BoldItalic=25
+Palatino-Italic=26
+Palatino-Roman=27
+Symbol=28
+Times-Bold=29
+Times-BoldItalic=30
+Times-Italic=31
+Times-Roman=32
+ZapfDingbats=33
+ZapfChancery-MediumItalic=34
+#
+font.0=AvantGarde-Book ISOF
+font.1=AvantGarde-BookOblique ISOF
+font.2=AvantGarde-Demi ISOF
+font.3=AvantGarde-DemiOblique ISOF
+font.4=Bookman-Demi ISOF
+font.5=Bookman-DemiItalic ISOF
+font.6=Bookman-Light ISOF
+font.7=Bookman-LightItalic ISOF
+font.8=Courier ISOF
+font.9=Courier-Bold ISOF
+font.10=Courier-BoldOblique ISOF
+font.11=Courier-Oblique ISOF
+font.12=Helvetica ISOF
+font.13=Helvetica-Bold ISOF
+font.14=Helvetica-BoldOblique ISOF
+font.15=Helvetica-Narrow ISOF
+font.16=Helvetica-Narrow-Bold ISOF
+font.17=Helvetica-Narrow-BoldOblique ISOF
+font.18=Helvetica-Narrow-Oblique ISOF
+font.19=Helvetica-Oblique ISOF
+font.20=NewCenturySchlbk-Bold ISOF
+font.21=NewCenturySchlbk-BoldItalic ISOF
+font.22=NewCenturySchlbk-Italic ISOF
+font.23=NewCenturySchlbk-Roman ISOF
+font.24=Palatino-Bold ISOF
+font.25=Palatino-BoldItalic ISOF
+font.26=Palatino-Italic ISOF
+font.27=Palatino-Roman ISOF
+font.28=Symbol findfont
+font.29=Times-Bold ISOF
+font.30=Times-BoldItalic ISOF
+font.31=Times-Italic ISOF
+font.32=Times-Roman ISOF
+font.33=ZapfDingbats findfont
+font.34=ZapfChancery-MediumItalic ISOF
+#
diff --git a/java/temurin-17/lib/security/blocked.certs b/java/temurin-17/lib/security/blocked.certs
new file mode 100644
index 0000000..beded9e
--- /dev/null
+++ b/java/temurin-17/lib/security/blocked.certs
@@ -0,0 +1,39 @@
+Algorithm=SHA-256
+03DB9E5E79FE6117177F81C11595AF598CB176AF766290DBCEB2C318B32E39A2
+08C396C006A21055D00826A5781A5CCFCE2C8D053AB3C197637A4A7A5BB9A650
+14E6D2764A4B06701C6CBC376A253775F79C782FBCB6C0EE6F99DE4BA1024ADD
+1C5E6985ACC09221DBD1A4B7BBC6D3A8C3F8540D19F20763A9537FDD42B4FFE7
+1F6BF8A3F2399AF7FD04516C2719C566CBAD51F412738F66D0457E1E6BDE6F2D
+2A464E4113141352C7962FBD1706ED4B88533EF24D7BBA6CCC5D797FD202F1C4
+31C8FD37DB9B56E708B03D1F01848B068C6DA66F36FB5D82C008C6040FA3E133
+3946901F46B0071E90D78279E82FABABCA177231A704BE72C5B0E8918566EA66
+3E11CF90719F6FB44D94EAC9A156B89BEBE7B8598F28EC58913F2BFCAF91D0C0
+423279423B9FC8CB06F1BB7C3B247522B948D5F18939F378ECC901126DE40BFB
+450F1B421BB05C8609854884559C323319619E8B06B001EA2DCBB74A23AA3BE2
+4CBBF8256BC9888A8007B2F386940A2E394378B0D903CBB3863C5A6394B889CE
+4FEE0163686ECBD65DB968E7494F55D84B25486D438E9DE558D629D28CD4D176
+535D04DFCE027C70BD5F8A9E0AD4F218E9AFDCF5BBCF9B6DE0D81E148E2E3172
+568FAF38D9F155F624838E2181B1CEB4D8459305EE652B0F810C97C3611BFE19
+585CFE6B7436CBD4E732763A2137D7F49599BA9B1790E688FCEC799C58EB84A6
+5E83124D68D24E8E177E306DF643D5EA99C5A94D6FC34B072F7544A1CABB7C7B
+71CB00749B9130FB2707A2664BFF958D0FCC8E161D9674C7450BA0FC2BEAF9D3
+76A45A496031E4DD2D7ED23E8F6FF97DBDEA980BAAC8B0BA94D7EDB551348645
+8A1BD21661C60015065212CC98B1ABB50DFD14C872A208E66BAE890F25C448AF
+9ED8F9B0E8E42A1656B8E1DD18F42BA42DC06FE52686173BA2FC70E756F207DC
+9FADCE80D62A959F9930D748488C1E22E821F4E1E4A43584B848C2FC11E04D77
+A686FEE577C88AB664D0787ECDFFF035F4806F3DE418DC9E4D516324FFF02083
+A90132CEA1D4F7185E4F688EFFD16F6AC14DFD78356A807599A5DABBEEF3333E
+B8686723E415534BC0DBD16326F9486F85B0B0799BF6639334E61DAAE67F36CD
+C0D1F42B9F4BF7ACC045B7BB5D4805E10737F67B6310CE505248D543D0D5FE07
+D0156949F1381943442C6974E9B5B49EF441BB799EF20477B90A89C3F33620CE
+D151962D954970501C60079258EBCFA38502E0A9F03CD640322B08C0A3117FE5
+D24566BF315F4E597D6E381C87119FB4198F5E9E2607F5F4AB362EF7E2E7672F
+D3A936E1A7775A45217C8296A1F22AC5631DCDEC45594099E78EEEBBEDCBA967
+D6CEAE5D9E047FAF7D797858D229AC991AD44316D1E2A37A21926D763153593A
+DF21016B00FC54F9FE3BC8B039911BB216E9162FAD2FD14D990AB96E951B49BE
+E0E740E4B0F8B3548181FF75B5372FAF4C70B99EC995D694ED0FB91B03FF8D21
+EC30C9C3065A06BB07DC5B1C6B497F370C1CA65C0F30C08E042BA6BCECC78F2C
+F5B6F88F75D391A4B1EB336F9E201239FB6B1377DB8CFA7B84736216E5AFFFD7
+FBB12938ABD86C125796EDF4162D291028890A7D6C0C1CCA75FD4B95EBFA7A1A
+FC02FD48DB92D4DCE6F11679D38354CF750CFC7F584A520EB90BDE80E241F2BD
+FDEDB5BDFCB67411513A61AEE5CB5B5D7C52AF06028EFC996CC1B05B1D6CEA2B
diff --git a/java/temurin-17/lib/security/cacerts b/java/temurin-17/lib/security/cacerts
new file mode 100644
index 0000000..44723b7
Binary files /dev/null and b/java/temurin-17/lib/security/cacerts differ
diff --git a/java/temurin-17/lib/security/default.policy b/java/temurin-17/lib/security/default.policy
new file mode 100644
index 0000000..b22f269
--- /dev/null
+++ b/java/temurin-17/lib/security/default.policy
@@ -0,0 +1,225 @@
+//
+// Permissions required by modules stored in a run-time image and loaded
+// by the platform class loader.
+//
+// NOTE that this file is not intended to be modified. If additional
+// permissions need to be granted to the modules in this file, it is
+// recommended that they be configured in a separate policy file or
+// ${java.home}/conf/security/java.policy.
+//
+
+
+grant codeBase "jrt:/java.compiler" {
+ permission java.security.AllPermission;
+};
+
+
+grant codeBase "jrt:/java.net.http" {
+ permission java.lang.RuntimePermission "accessClassInPackage.sun.net";
+ permission java.lang.RuntimePermission "accessClassInPackage.sun.net.util";
+ permission java.lang.RuntimePermission "accessClassInPackage.sun.net.www";
+ permission java.lang.RuntimePermission "accessClassInPackage.jdk.internal.misc";
+ permission java.lang.RuntimePermission "modifyThread";
+ permission java.net.SocketPermission "*","connect,resolve";
+ permission java.net.URLPermission "http:*","*:*";
+ permission java.net.URLPermission "https:*","*:*";
+ permission java.net.URLPermission "ws:*","*:*";
+ permission java.net.URLPermission "wss:*","*:*";
+ permission java.net.URLPermission "socket:*","CONNECT"; // proxy
+ // For request/response body processors, fromFile, asFile
+ permission java.io.FilePermission "<<ALL FILES>>","read,write,delete";
+ permission java.util.PropertyPermission "*","read";
+ permission java.net.NetPermission "getProxySelector";
+};
+
+grant codeBase "jrt:/java.scripting" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/java.security.jgss" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/java.smartcardio" {
+ permission javax.smartcardio.CardPermission "*", "*";
+ permission java.lang.RuntimePermission "loadLibrary.j2pcsc";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.sun.security.jca";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.sun.security.util";
+ permission java.util.PropertyPermission
+ "javax.smartcardio.TerminalFactory.DefaultType", "read";
+ permission java.util.PropertyPermission "os.name", "read";
+ permission java.util.PropertyPermission "os.arch", "read";
+ permission java.util.PropertyPermission "sun.arch.data.model", "read";
+ permission java.util.PropertyPermission
+ "sun.security.smartcardio.library", "read";
+ permission java.util.PropertyPermission
+ "sun.security.smartcardio.t0GetResponse", "read";
+ permission java.util.PropertyPermission
+ "sun.security.smartcardio.t1GetResponse", "read";
+ permission java.util.PropertyPermission
+ "sun.security.smartcardio.t1StripLe", "read";
+ // needed for looking up native PC/SC library
+ permission java.io.FilePermission "<<ALL FILES>>","read";
+ permission java.security.SecurityPermission "putProviderProperty.SunPCSC";
+ permission java.security.SecurityPermission
+ "clearProviderProperties.SunPCSC";
+ permission java.security.SecurityPermission
+ "removeProviderProperty.SunPCSC";
+};
+
+grant codeBase "jrt:/java.sql" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/java.sql.rowset" {
+ permission java.security.AllPermission;
+};
+
+
+grant codeBase "jrt:/java.xml.crypto" {
+ permission java.lang.RuntimePermission
+ "getStackWalkerWithClassReference";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.sun.security.util";
+ permission java.util.PropertyPermission "*", "read";
+ permission java.security.SecurityPermission "putProviderProperty.XMLDSig";
+ permission java.security.SecurityPermission
+ "clearProviderProperties.XMLDSig";
+ permission java.security.SecurityPermission
+ "removeProviderProperty.XMLDSig";
+ permission java.security.SecurityPermission
+ "com.sun.org.apache.xml.internal.security.register";
+ permission java.security.SecurityPermission
+ "getProperty.jdk.xml.dsig.secureValidationPolicy";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.com.sun.org.apache.xml.internal.*";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.com.sun.org.apache.xpath.internal";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.com.sun.org.apache.xpath.internal.*";
+ permission java.io.FilePermission "<<ALL FILES>>","read";
+ permission java.net.SocketPermission "*", "connect,resolve";
+};
+
+
+grant codeBase "jrt:/jdk.accessibility" {
+ permission java.lang.RuntimePermission "accessClassInPackage.sun.awt";
+};
+
+grant codeBase "jrt:/jdk.charsets" {
+ permission java.util.PropertyPermission "os.name", "read";
+ permission java.lang.RuntimePermission "charsetProvider";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.jdk.internal.access";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.jdk.internal.misc";
+ permission java.lang.RuntimePermission "accessClassInPackage.sun.nio.cs";
+};
+
+grant codeBase "jrt:/jdk.crypto.ec" {
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.sun.security.*";
+ permission java.lang.RuntimePermission "loadLibrary.sunec";
+ permission java.security.SecurityPermission "putProviderProperty.SunEC";
+ permission java.security.SecurityPermission "clearProviderProperties.SunEC";
+ permission java.security.SecurityPermission "removeProviderProperty.SunEC";
+};
+
+grant codeBase "jrt:/jdk.crypto.cryptoki" {
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.com.sun.crypto.provider";
+ permission java.lang.RuntimePermission "accessClassInPackage.jdk.internal.misc";
+ permission java.lang.RuntimePermission
+ "accessClassInPackage.sun.security.*";
+ permission java.lang.RuntimePermission "accessClassInPackage.sun.nio.ch";
+ permission java.lang.RuntimePermission "loadLibrary.j2pkcs11";
+ permission java.util.PropertyPermission "sun.security.pkcs11.allowSingleThreadedModules", "read";
+ permission java.util.PropertyPermission "sun.security.pkcs11.disableKeyExtraction", "read";
+ permission java.util.PropertyPermission "os.name", "read";
+ permission java.util.PropertyPermission "os.arch", "read";
+ permission java.util.PropertyPermission "jdk.crypto.KeyAgreement.legacyKDF", "read";
+ permission java.security.SecurityPermission "putProviderProperty.*";
+ permission java.security.SecurityPermission "clearProviderProperties.*";
+ permission java.security.SecurityPermission "removeProviderProperty.*";
+ permission java.security.SecurityPermission
+ "getProperty.auth.login.defaultCallbackHandler";
+ permission java.security.SecurityPermission "authProvider.*";
+ // Needed for reading PKCS11 config file and NSS library check
+ permission java.io.FilePermission "<<ALL FILES>>", "read";
+};
+
+grant codeBase "jrt:/jdk.dynalink" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.httpserver" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.internal.le" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.internal.vm.compiler" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.internal.vm.compiler.management" {
+ permission java.lang.RuntimePermission "accessClassInPackage.jdk.internal.vm.compiler.collections";
+ permission java.lang.RuntimePermission "accessClassInPackage.jdk.vm.ci.runtime";
+ permission java.lang.RuntimePermission "accessClassInPackage.jdk.vm.ci.services";
+ permission java.lang.RuntimePermission "accessClassInPackage.org.graalvm.compiler.core.common";
+ permission java.lang.RuntimePermission "accessClassInPackage.org.graalvm.compiler.debug";
+ permission java.lang.RuntimePermission "accessClassInPackage.org.graalvm.compiler.hotspot";
+ permission java.lang.RuntimePermission "accessClassInPackage.org.graalvm.compiler.options";
+ permission java.lang.RuntimePermission "accessClassInPackage.org.graalvm.compiler.phases.common.jmx";
+ permission java.lang.RuntimePermission "accessClassInPackage.org.graalvm.compiler.serviceprovider";
+};
+
+grant codeBase "jrt:/jdk.jsobject" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.localedata" {
+ permission java.lang.RuntimePermission "accessClassInPackage.sun.text.*";
+ permission java.lang.RuntimePermission "accessClassInPackage.sun.util.*";
+};
+
+grant codeBase "jrt:/jdk.naming.dns" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.scripting.nashorn" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.scripting.nashorn.shell" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.security.auth" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.security.jgss" {
+ permission java.security.AllPermission;
+};
+
+grant codeBase "jrt:/jdk.zipfs" {
+ permission java.io.FilePermission "<<ALL FILES>>", "read,write,delete";
+ permission java.lang.RuntimePermission "fileSystemProvider";
+ permission java.lang.RuntimePermission "accessUserInformation";
+ permission java.util.PropertyPermission "os.name", "read";
+ permission java.util.PropertyPermission "user.dir", "read";
+ permission java.util.PropertyPermission "user.name", "read";
+};
+
+// permissions needed by applications using java.desktop module
+grant {
+ permission java.lang.RuntimePermission "accessClassInPackage.com.sun.beans";
+ permission java.lang.RuntimePermission "accessClassInPackage.com.sun.beans.*";
+ permission java.lang.RuntimePermission "accessClassInPackage.com.sun.java.swing.plaf.*";
+ permission java.lang.RuntimePermission "accessClassInPackage.com.apple.*";
+};
diff --git a/java/temurin-17/lib/security/public_suffix_list.dat b/java/temurin-17/lib/security/public_suffix_list.dat
new file mode 100644
index 0000000..207d491
Binary files /dev/null and b/java/temurin-17/lib/security/public_suffix_list.dat differ
diff --git a/java/temurin-17/lib/server/classes.jsa b/java/temurin-17/lib/server/classes.jsa
new file mode 100644
index 0000000..0f6ca25
Binary files /dev/null and b/java/temurin-17/lib/server/classes.jsa differ
diff --git a/java/temurin-17/lib/server/classes_nocoops.jsa b/java/temurin-17/lib/server/classes_nocoops.jsa
new file mode 100644
index 0000000..68cb942
Binary files /dev/null and b/java/temurin-17/lib/server/classes_nocoops.jsa differ
diff --git a/java/temurin-17/lib/server/libjsig.so b/java/temurin-17/lib/server/libjsig.so
new file mode 100644
index 0000000..8e40f8c
Binary files /dev/null and b/java/temurin-17/lib/server/libjsig.so differ
diff --git a/java/temurin-17/lib/server/libjvm.so b/java/temurin-17/lib/server/libjvm.so
new file mode 100644
index 0000000..81be3ba
Binary files /dev/null and b/java/temurin-17/lib/server/libjvm.so differ
diff --git a/java/temurin-17/lib/src.zip b/java/temurin-17/lib/src.zip
new file mode 100644
index 0000000..ddfaf3e
Binary files /dev/null and b/java/temurin-17/lib/src.zip differ
diff --git a/java/temurin-17/lib/tzdb.dat b/java/temurin-17/lib/tzdb.dat
new file mode 100644
index 0000000..671b6fa
Binary files /dev/null and b/java/temurin-17/lib/tzdb.dat differ
diff --git a/java/temurin-17/man/man1/jar.1 b/java/temurin-17/man/man1/jar.1
new file mode 100644
index 0000000..c0edcd4
--- /dev/null
+++ b/java/temurin-17/man/man1/jar.1
@@ -0,0 +1,346 @@
+.\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JAR" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jar \- create an archive for classes and resources, and manipulate or
+restore individual classes or resources from an archive
+.SH SYNOPSIS
+.PP
+\f[CB]jar\f[R] [\f[I]OPTION\f[R] ...] [ [\f[CB]\-\-release\f[R]
+\f[I]VERSION\f[R]] [\f[CB]\-C\f[R] \f[I]dir\f[R]] \f[I]files\f[R]] ...
+.SH DESCRIPTION
+.PP
+The \f[CB]jar\f[R] command is a general\-purpose archiving and compression
+tool, based on the ZIP and ZLIB compression formats.
+Initially, the \f[CB]jar\f[R] command was designed to package Java applets
+(not supported since JDK 11) or applications; however, beginning with
+JDK 9, users can use the \f[CB]jar\f[R] command to create modular JARs.
+For transportation and deployment, it\[aq]s usually more convenient to
+package modules as modular JARs.
+.PP
+The syntax for the \f[CB]jar\f[R] command resembles the syntax for the
+\f[CB]tar\f[R] command.
+It has several main operation modes, defined by one of the mandatory
+operation arguments.
+Other arguments are either options that modify the behavior of the
+operation or are required to perform the operation.
+.PP
+When modules or the components of an application (files, images and
+sounds) are combined into a single archive, they can be downloaded by a
+Java agent (such as a browser) in a single HTTP transaction, rather than
+requiring a new connection for each piece.
+This dramatically improves download times.
+The \f[CB]jar\f[R] command also compresses files, which further improves
+download time.
+The \f[CB]jar\f[R] command also enables individual entries in a file to be
+signed so that their origin can be authenticated.
+A JAR file can be used as a class path entry, whether or not it\[aq]s
+compressed.
+.PP
+An archive becomes a modular JAR when you include a module descriptor,
+\f[CB]module\-info.class\f[R], in the root of the given directories or in
+the root of the \f[CB]\&.jar\f[R] archive.
+The following operations described in \f[B]Operation Modifiers Valid
+Only in Create and Update Modes\f[R] are valid only when creating or
+updating a modular jar or updating an existing non\-modular jar:
+.IP \[bu] 2
+\f[CB]\-\-module\-version\f[R]
+.IP \[bu] 2
+\f[CB]\-\-hash\-modules\f[R]
+.IP \[bu] 2
+\f[CB]\-\-module\-path\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+All mandatory or optional arguments for long options are also mandatory
+or optional for any corresponding short options.
+.SH MAIN OPERATION MODES
+.PP
+When using the \f[CB]jar\f[R] command, you must specify the operation for
+it to perform.
+You specify the operation mode for the \f[CB]jar\f[R] command by including
+the appropriate operation arguments described in this section.
+You can mix an operation argument with other one\-letter options.
+Generally the operation argument is the first argument specified on the
+command line.
+.TP
+.B \f[CB]\-c\f[R] or \f[CB]\-\-create\f[R]
+Creates the archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-i=\f[R]\f[I]FILE\f[R] or \f[CB]\-\-generate\-index=\f[R]\f[I]FILE\f[R]
+Generates index information for the specified JAR file.
+.RS
+.RE
+.TP
+.B \f[CB]\-t\f[R] or \f[CB]\-\-list\f[R]
+Lists the table of contents for the archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-u\f[R] or \f[CB]\-\-update\f[R]
+Updates an existing JAR file.
+.RS
+.RE
+.TP
+.B \f[CB]\-x\f[R] or \f[CB]\-\-extract\f[R]
+Extracts the named (or all) files from the archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-d\f[R] or \f[CB]\-\-describe\-module\f[R]
+Prints the module descriptor or automatic module name.
+.RS
+.RE
+.SH OPERATION MODIFIERS VALID IN ANY MODE
+.PP
+You can use the following options to customize the actions of any
+operation mode included in the \f[CB]jar\f[R] command.
+.TP
+.B \f[CB]\-C\f[R] \f[I]DIR\f[R]
+Changes the specified directory and includes the \f[I]files\f[R]
+specified at the end of the command line.
+.RS
+.PP
+\f[CB]jar\f[R] [\f[I]OPTION\f[R] ...] [ [\f[CB]\-\-release\f[R]
+\f[I]VERSION\f[R]] [\f[CB]\-C\f[R] \f[I]dir\f[R]] \f[I]files\f[R]]
+.RE
+.TP
+.B \f[CB]\-f=\f[R]\f[I]FILE\f[R] or \f[CB]\-\-file=\f[R]\f[I]FILE\f[R]
+Specifies the archive file name.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-release\f[R] \f[I]VERSION\f[R]
+Creates a multirelease JAR file.
+Places all files specified after the option into a versioned directory
+of the JAR file named
+\f[CB]META\-INF/versions/\f[R]\f[I]VERSION\f[R]\f[CB]/\f[R], where
+\f[I]VERSION\f[R] must be must be a positive integer whose value is 9 or
+greater.
+.RS
+.PP
+At run time, where more than one version of a class exists in the JAR,
+the JDK will use the first one it finds, searching initially in the
+directory tree whose \f[I]VERSION\f[R] number matches the JDK\[aq]s major
+version number.
+It will then look in directories with successively lower
+\f[I]VERSION\f[R] numbers, and finally look in the root of the JAR.
+.RE
+.TP
+.B \f[CB]\-v\f[R] or \f[CB]\-\-verbose\f[R]
+Sends or prints verbose output to standard output.
+.RS
+.RE
+.SH OPERATION MODIFIERS VALID ONLY IN CREATE AND UPDATE MODES
+.PP
+You can use the following options to customize the actions of the create
+and the update main operation modes:
+.TP
+.B \f[CB]\-e=\f[R]\f[I]CLASSNAME\f[R] or \f[CB]\-\-main\-class=\f[R]\f[I]CLASSNAME\f[R]
+Specifies the application entry point for standalone applications
+bundled into a modular or executable modular JAR file.
+.RS
+.RE
+.TP
+.B \f[CB]\-m=\f[R]\f[I]FILE\f[R] or \f[CB]\-\-manifest=\f[R]\f[I]FILE\f[R]
+Includes the manifest information from the given manifest file.
+.RS
+.RE
+.TP
+.B \f[CB]\-M\f[R] or \f[CB]\-\-no\-manifest\f[R]
+Doesn\[aq]t create a manifest file for the entries.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-version=\f[R]\f[I]VERSION\f[R]
+Specifies the module version, when creating or updating a modular JAR
+file, or updating a non\-modular JAR file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-hash\-modules=\f[R]\f[I]PATTERN\f[R]
+Computes and records the hashes of modules matched by the given pattern
+and that depend upon directly or indirectly on a modular JAR file being
+created or a non\-modular JAR file being updated.
+.RS
+.RE
+.TP
+.B \f[CB]\-p\f[R] or \f[CB]\-\-module\-path\f[R]
+Specifies the location of module dependence for generating the hash.
+.RS
+.RE
+.TP
+.B \f[CB]\@\f[R]\f[I]file\f[R]
+Reads \f[CB]jar\f[R] options and file names from a text file.
+.RS
+.RE
+.SH OPERATION MODIFIERS VALID ONLY IN CREATE, UPDATE, AND
+GENERATE\-INDEX MODES
+.PP
+You can use the following options to customize the actions of the create
+(\f[CB]\-c\f[R] or \f[CB]\-\-create\f[R]) the update (\f[CB]\-u\f[R] or
+\f[CB]\-\-update\f[R] ) and the generate\-index (\f[CB]\-i\f[R] or
+\f[CB]\-\-generate\-index=\f[R]\f[I]FILE\f[R]) main operation modes:
+.TP
+.B \f[CB]\-0\f[R] or \f[CB]\-\-no\-compress\f[R]
+Stores without using ZIP compression.
+.RS
+.RE
+.SH OTHER OPTIONS
+.PP
+The following options are recognized by the \f[CB]jar\f[R] command and not
+used with operation modes:
+.TP
+.B \f[CB]\-h\f[R] or \f[CB]\-\-help\f[R][\f[CB]:compat\f[R]]
+Displays the command\-line help for the \f[CB]jar\f[R] command or
+optionally the compatibility help.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R]
+Displays help on extra options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints the program version.
+.RS
+.RE
+.SH EXAMPLES OF JAR COMMAND SYNTAX
+.IP \[bu] 2
+Create an archive, \f[CB]classes.jar\f[R], that contains two class files,
+\f[CB]Foo.class\f[R] and \f[CB]Bar.class\f[R].
+.RS 2
+.RS
+.PP
+\f[CB]jar\ \-\-create\ \-\-file\ classes.jar\ Foo.class\ Bar.class\f[R]
+.RE
+.RE
+.IP \[bu] 2
+Create an archive, \f[CB]classes.jar\f[R], by using an existing manifest,
+\f[CB]mymanifest\f[R], that contains all of the files in the directory
+\f[CB]foo/\f[R].
+.RS 2
+.RS
+.PP
+\f[CB]jar\ \-\-create\ \-\-file\ classes.jar\ \-\-manifest\ mymanifest\ \-C\ foo/\f[R]
+.RE
+.RE
+.IP \[bu] 2
+Create a modular JAR archive,\f[CB]foo.jar\f[R], where the module
+descriptor is located in \f[CB]classes/module\-info.class\f[R].
+.RS 2
+.RS
+.PP
+\f[CB]jar\ \-\-create\ \-\-file\ foo.jar\ \-\-main\-class\ com.foo.Main\ \-\-module\-version\ 1.0\ \-C\ foo/classes\ resources\f[R]
+.RE
+.RE
+.IP \[bu] 2
+Update an existing non\-modular JAR, \f[CB]foo.jar\f[R], to a modular JAR
+file.
+.RS 2
+.RS
+.PP
+\f[CB]jar\ \-\-update\ \-\-file\ foo.jar\ \-\-main\-class\ com.foo.Main\ \-\-module\-version\ 1.0\ \-C\ foo/module\-info.class\f[R]
+.RE
+.RE
+.IP \[bu] 2
+Create a versioned or multi\-release JAR, \f[CB]foo.jar\f[R], that places
+the files in the \f[CB]classes\f[R] directory at the root of the JAR, and
+the files in the \f[CB]classes\-10\f[R] directory in the
+\f[CB]META\-INF/versions/10\f[R] directory of the JAR.
+.RS 2
+.PP
+In this example, the \f[CB]classes/com/foo\f[R] directory contains two
+classes, \f[CB]com.foo.Hello\f[R] (the entry point class) and
+\f[CB]com.foo.NameProvider\f[R], both compiled for JDK 8.
+The \f[CB]classes\-10/com/foo\f[R] directory contains a different version
+of the \f[CB]com.foo.NameProvider\f[R] class, this one containing JDK 10
+specific code and compiled for JDK 10.
+.PP
+Given this setup, create a multirelease JAR file \f[CB]foo.jar\f[R] by
+running the following command from the directory containing the
+directories \f[CB]classes\f[R] and \f[CB]classes\-10\f[R] .
+.RS
+.PP
+\f[CB]jar\ \-\-create\ \-\-file\ foo.jar\ \-\-main\-class\ com.foo.Hello\ \-C\ classes\ .\ \-\-release\ 10\ \-C\ classes\-10\ .\f[R]
+.RE
+.PP
+The JAR file \f[CB]foo.jar\f[R] now contains:
+.IP
+.nf
+\f[CB]
+%\ jar\ \-tf\ foo.jar
+
+META\-INF/
+META\-INF/MANIFEST.MF
+com/
+com/foo/
+com/foo/Hello.class
+com/foo/NameProvider.class
+META\-INF/versions/10/com/
+META\-INF/versions/10/com/foo/
+META\-INF/versions/10/com/foo/NameProvider.class
+\f[R]
+.fi
+.PP
+As well as other information, the file \f[CB]META\-INF/MANIFEST.MF\f[R],
+will contain the following lines to indicate that this is a multirelease
+JAR file with an entry point of \f[CB]com.foo.Hello\f[R].
+.IP
+.nf
+\f[CB]
+\&...
+Main\-Class:\ com.foo.Hello
+Multi\-Release:\ true
+\f[R]
+.fi
+.PP
+Assuming that the \f[CB]com.foo.Hello\f[R] class calls a method on the
+\f[CB]com.foo.NameProvider\f[R] class, running the program using JDK 10
+will ensure that the \f[CB]com.foo.NameProvider\f[R] class is the one in
+\f[CB]META\-INF/versions/10/com/foo/\f[R].
+Running the program using JDK 8 will ensure that the
+\f[CB]com.foo.NameProvider\f[R] class is the one at the root of the JAR,
+in \f[CB]com/foo\f[R].
+.RE
+.IP \[bu] 2
+Create an archive, \f[CB]my.jar\f[R], by reading options and lists of
+class files from the file \f[CB]classes.list\f[R].
+.RS 2
+.PP
+\f[B]Note:\f[R]
+.PP
+To shorten or simplify the \f[CB]jar\f[R] command, you can specify
+arguments in a separate text file and pass it to the \f[CB]jar\f[R]
+command with the at sign (\f[CB]\@\f[R]) as a prefix.
+.RS
+.PP
+\f[CB]jar\ \-\-create\ \-\-file\ my.jar\ \@classes.list\f[R]
+.RE
+.RE
diff --git a/java/temurin-17/man/man1/jarsigner.1 b/java/temurin-17/man/man1/jarsigner.1
new file mode 100644
index 0000000..55ebac0
--- /dev/null
+++ b/java/temurin-17/man/man1/jarsigner.1
@@ -0,0 +1,1484 @@
+.\" Copyright (c) 1998, 2021, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"t
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JARSIGNER" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jarsigner \- sign and verify Java Archive (JAR) files
+.SH SYNOPSIS
+.PP
+\f[CB]jarsigner\f[R] [\f[I]options\f[R]] \f[I]jar\-file\f[R] \f[I]alias\f[R]
+.PP
+\f[CB]jarsigner\f[R] \f[CB]\-verify\f[R] [\f[I]options\f[R]]
+\f[I]jar\-file\f[R] [\f[I]alias\f[R] ...]
+.TP
+.B \f[I]options\f[R]
+The command\-line options.
+See \f[B]Options for jarsigner\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-verify\f[R]
+The \f[CB]\-verify\f[R] option can take zero or more keystore alias names
+after the JAR file name.
+When the \f[CB]\-verify\f[R] option is specified, the \f[CB]jarsigner\f[R]
+command checks that the certificate used to verify each signed entry in
+the JAR file matches one of the keystore aliases.
+The aliases are defined in the keystore specified by \f[CB]\-keystore\f[R]
+or the default keystore.
+.RS
+.PP
+If you also specify the \f[CB]\-strict\f[R] option, and the
+\f[CB]jarsigner\f[R] command detects severe warnings, the message, "jar
+verified, with signer errors" is displayed.
+.RE
+.TP
+.B \f[I]jar\-file\f[R]
+The JAR file to be signed.
+.RS
+.PP
+If you also specified the \f[CB]\-strict\f[R] option, and the
+\f[CB]jarsigner\f[R] command detected severe warnings, the message, "jar
+signed, with signer errors" is displayed.
+.RE
+.TP
+.B \f[I]alias\f[R]
+The aliases are defined in the keystore specified by \f[CB]\-keystore\f[R]
+or the default keystore.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jarsigner\f[R] tool has two purposes:
+.IP \[bu] 2
+To sign Java Archive (JAR) files.
+.IP \[bu] 2
+To verify the signatures and integrity of signed JAR files.
+.PP
+The JAR feature enables the packaging of class files, images, sounds,
+and other digital data in a single file for faster and easier
+distribution.
+A tool named \f[CB]jar\f[R] enables developers to produce JAR files.
+(Technically, any ZIP file can also be considered a JAR file, although
+when created by the \f[CB]jar\f[R] command or processed by the
+\f[CB]jarsigner\f[R] command, JAR files also contain a
+\f[CB]META\-INF/MANIFEST.MF\f[R] file.)
+.PP
+A digital signature is a string of bits that is computed from some data
+(the data being signed) and the private key of an entity (a person,
+company, and so on).
+Similar to a handwritten signature, a digital signature has many useful
+characteristics:
+.IP \[bu] 2
+Its authenticity can be verified by a computation that uses the public
+key corresponding to the private key used to generate the signature.
+.IP \[bu] 2
+It can\[aq]t be forged, assuming the private key is kept secret.
+.IP \[bu] 2
+It is a function of the data signed and thus can\[aq]t be claimed to be
+the signature for other data as well.
+.IP \[bu] 2
+The signed data can\[aq]t be changed.
+If the data is changed, then the signature can\[aq]t be verified as
+authentic.
+.PP
+To generate an entity\[aq]s signature for a file, the entity must first
+have a public/private key pair associated with it and one or more
+certificates that authenticate its public key.
+A certificate is a digitally signed statement from one entity that says
+that the public key of another entity has a particular value.
+.PP
+The \f[CB]jarsigner\f[R] command uses key and certificate information from
+a keystore to generate digital signatures for JAR files.
+A keystore is a database of private keys and their associated X.509
+certificate chains that authenticate the corresponding public keys.
+The \f[CB]keytool\f[R] command is used to create and administer keystores.
+.PP
+The \f[CB]jarsigner\f[R] command uses an entity\[aq]s private key to
+generate a signature.
+The signed JAR file contains, among other things, a copy of the
+certificate from the keystore for the public key corresponding to the
+private key used to sign the file.
+The \f[CB]jarsigner\f[R] command can verify the digital signature of the
+signed JAR file using the certificate inside it (in its signature block
+file).
+.PP
+The \f[CB]jarsigner\f[R] command can generate signatures that include a
+time stamp that enables a systems or deployer to check whether the JAR
+file was signed while the signing certificate was still valid.
+.PP
+In addition, APIs allow applications to obtain the timestamp
+information.
+.PP
+At this time, the \f[CB]jarsigner\f[R] command can only sign JAR files
+created by the \f[CB]jar\f[R] command or zip files.
+JAR files are the same as zip files, except they also have a
+\f[CB]META\-INF/MANIFEST.MF\f[R] file.
+A \f[CB]META\-INF/MANIFEST.MF\f[R] file is created when the
+\f[CB]jarsigner\f[R] command signs a zip file.
+.PP
+The default \f[CB]jarsigner\f[R] command behavior is to sign a JAR or zip
+file.
+Use the \f[CB]\-verify\f[R] option to verify a signed JAR file.
+.PP
+The \f[CB]jarsigner\f[R] command also attempts to validate the
+signer\[aq]s certificate after signing or verifying.
+During validation, it checks the revocation status of each certificate
+in the signer\[aq]s certificate chain when the \f[CB]\-revCheck\f[R]
+option is specified.
+If there is a validation error or any other problem, the command
+generates warning messages.
+If you specify the \f[CB]\-strict\f[R] option, then the command treats
+severe warnings as errors.
+See \f[B]Errors and Warnings\f[R].
+.SH KEYSTORE ALIASES
+.PP
+All keystore entities are accessed with unique aliases.
+.PP
+When you use the \f[CB]jarsigner\f[R] command to sign a JAR file, you must
+specify the alias for the keystore entry that contains the private key
+needed to generate the signature.
+If no output file is specified, it overwrites the original JAR file with
+the signed JAR file.
+.PP
+Keystores are protected with a password, so the store password must be
+specified.
+You are prompted for it when you don\[aq]t specify it on the command
+line.
+Similarly, private keys are protected in a keystore with a password, so
+the private key\[aq]s password must be specified, and you are prompted
+for the password when you don\[aq]t specify it on the command line and
+it isn\[aq]t the same as the store password.
+.SH KEYSTORE LOCATION
+.PP
+The \f[CB]jarsigner\f[R] command has a \f[CB]\-keystore\f[R] option for
+specifying the URL of the keystore to be used.
+The keystore is by default stored in a file named \f[CB]\&.keystore\f[R]
+in the user\[aq]s home directory, as determined by the
+\f[CB]user.home\f[R] system property.
+.PP
+\f[B]Linux and OS X:\f[R] \f[CB]user.home\f[R] defaults to the user\[aq]s
+home directory.
+.PP
+The input stream from the \f[CB]\-keystore\f[R] option is passed to the
+\f[CB]KeyStore.load\f[R] method.
+If \f[CB]NONE\f[R] is specified as the URL, then a null stream is passed
+to the \f[CB]KeyStore.load\f[R] method.
+\f[CB]NONE\f[R] should be specified when the \f[CB]KeyStore\f[R] class
+isn\[aq]t file based, for example, when it resides on a hardware token
+device.
+.SH KEYSTORE IMPLEMENTATION
+.PP
+The \f[CB]KeyStore\f[R] class provided in the \f[CB]java.security\f[R]
+package supplies a number of well\-defined interfaces to access and
+modify the information in a keystore.
+You can have multiple different concrete implementations, where each
+implementation is for a particular type of keystore.
+.PP
+Currently, there are two command\-line tools that use keystore
+implementations (\f[CB]keytool\f[R] and \f[CB]jarsigner\f[R]).
+.PP
+The default keystore implementation is \f[CB]PKCS12\f[R].
+This is a cross platform keystore based on the RSA PKCS12 Personal
+Information Exchange Syntax Standard.
+This standard is primarily meant for storing or transporting a
+user\[aq]s private keys, certificates, and miscellaneous secrets.
+There is another built\-in implementation, provided by Oracle.
+It implements the keystore as a file with a proprietary keystore type
+(format) named \f[CB]JKS\f[R].
+It protects each private key with its individual password, and also
+protects the integrity of the entire keystore with a (possibly
+different) password.
+.PP
+Keystore implementations are provider\-based, which means the
+application interfaces supplied by the \f[CB]KeyStore\f[R] class are
+implemented in terms of a Service Provider Interface (SPI).
+There is a corresponding abstract \f[CB]KeystoreSpi\f[R] class, also in
+the \f[CB]java.security\ package\f[R], that defines the Service Provider
+Interface methods that providers must implement.
+The term provider refers to a package or a set of packages that supply a
+concrete implementation of a subset of services that can be accessed by
+the Java Security API.
+To provide a keystore implementation, clients must implement a provider
+and supply a \f[CB]KeystoreSpi\f[R] subclass implementation, as described
+in \f[B]How to Implement a Provider in the Java Cryptography
+Architecture\f[R]
+[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JSSEC\-GUID\-2BCFDD85\-D533\-4E6C\-8CE9\-29990DEB0190].
+.PP
+Applications can choose different types of keystore implementations from
+different providers, with the \f[CB]getInstance\f[R] factory method in the
+\f[CB]KeyStore\f[R] class.
+A keystore type defines the storage and data format of the keystore
+information and the algorithms used to protect private keys in the
+keystore and the integrity of the keystore itself.
+Keystore implementations of different types aren\[aq]t compatible.
+.PP
+The \f[CB]jarsigner\f[R] commands can read file\-based keystores from any
+location that can be specified using a URL.
+In addition, these commands can read non\-file\-based keystores such as
+those provided by MSCAPI on Windows and PKCS11 on all platforms.
+.PP
+For the \f[CB]jarsigner\f[R] and \f[CB]keytool\f[R] commands, you can
+specify a keystore type at the command line with the
+\f[CB]\-storetype\f[R] option.
+.PP
+If you don\[aq]t explicitly specify a keystore type, then the tools
+choose a keystore implementation based on the value of the
+\f[CB]keystore.type\f[R] property specified in the security properties
+file.
+The security properties file is called \f[CB]java.security\f[R], and it
+resides in the JDK security properties directory,
+\f[CB]java.home/conf/security\f[R].
+.PP
+Each tool gets the \f[CB]keystore.type\f[R] value and then examines all
+the installed providers until it finds one that implements keystores of
+that type.
+It then uses the keystore implementation from that provider.
+.PP
+The \f[CB]KeyStore\f[R] class defines a static method named
+\f[CB]getDefaultType\f[R] that lets applications retrieve the value of the
+\f[CB]keystore.type\f[R] property.
+The following line of code creates an instance of the default keystore
+type as specified in the \f[CB]keystore.type\f[R] property:
+.RS
+.PP
+\f[CB]KeyStore\ keyStore\ =\ KeyStore.getInstance(KeyStore.getDefaultType());\f[R]
+.RE
+.PP
+The default keystore type is \f[CB]pkcs12\f[R], which is a cross platform
+keystore based on the RSA PKCS12 Personal Information Exchange Syntax
+Standard.
+This is specified by the following line in the security properties file:
+.RS
+.PP
+\f[CB]keystore.type=pkcs12\f[R]
+.RE
+.PP
+Case doesn\[aq]t matter in keystore type designations.
+For example, \f[CB]JKS\f[R] is the same as \f[CB]jks\f[R].
+.PP
+To have the tools utilize a keystore implementation other than the
+default, you can change that line to specify a different keystore type.
+For example, if you want to use the Oracle\[aq]s \f[CB]jks\f[R] keystore
+implementation, then change the line to the following:
+.RS
+.PP
+\f[CB]keystore.type=jks\f[R]
+.RE
+.SH SUPPORTED ALGORITHMS
+.PP
+By default, the \f[CB]jarsigner\f[R] command signs a JAR file using one of
+the following algorithms and block file extensions depending on the type
+and size of the private key:
+.PP
+.TS
+tab(@);
+l l l l.
+T{
+keyalg
+T}@T{
+keysize
+T}@T{
+default sigalg
+T}@T{
+block file extension
+T}
+_
+T{
+DSA
+T}@T{
+any size
+T}@T{
+SHA256withDSA
+T}@T{
+\&.DSA
+T}
+T{
+RSA
+T}@T{
+<= 3072
+T}@T{
+SHA256withRSA
+T}@T{
+\&.RSA
+T}
+T{
+T}@T{
+<= 7680
+T}@T{
+SHA384withRSA
+T}@T{
+T}
+T{
+T}@T{
+> 7680
+T}@T{
+SHA512withRSA
+T}@T{
+T}
+T{
+EC
+T}@T{
+< 384
+T}@T{
+SHA256withECDSA
+T}@T{
+\&.EC
+T}
+T{
+T}@T{
+< 512
+T}@T{
+SHA384withECDSA
+T}@T{
+T}
+T{
+T}@T{
+= 512
+T}@T{
+SHA512withECDSA
+T}@T{
+T}
+T{
+RSASSA\-PSS
+T}@T{
+<= 3072
+T}@T{
+RSASSA\-PSS (with SHA\-256)
+T}@T{
+\&.RSA
+T}
+T{
+T}@T{
+<= 7680
+T}@T{
+RSASSA\-PSS (with SHA\-384)
+T}@T{
+T}
+T{
+T}@T{
+> 7680
+T}@T{
+RSASSA\-PSS (with SHA\-512)
+T}@T{
+T}
+T{
+EdDSA
+T}@T{
+255
+T}@T{
+Ed25519
+T}@T{
+\&.EC
+T}
+T{
+T}@T{
+448
+T}@T{
+Ed448
+T}@T{
+T}
+.TE
+.IP \[bu] 2
+If an RSASSA\-PSS key is encoded with parameters, then jarsigner will
+use the same parameters in the signature.
+Otherwise, jarsigner will use parameters that are determined by the size
+of the key as specified in the table above.
+For example, an 3072\-bit RSASSA\-PSS key will use RSASSA\-PSS as the
+signature algorithm and SHA\-256 as the hash and MGF1 algorithms.
+.PP
+These default signature algorithms can be overridden by using the
+\f[CB]\-sigalg\f[R] option.
+.PP
+The \f[CB]jarsigner\f[R] command uses the
+\f[CB]jdk.jar.disabledAlgorithms\f[R] and
+\f[CB]jdk.security.legacyAlgorithms\f[R] security properties to determine
+which algorithms are considered a security risk.
+If the JAR file was signed with any algorithms that are disabled, it
+will be treated as an unsigned JAR file.
+If the JAR file was signed with any legacy algorithms, it will be
+treated as signed with an informational warning to inform users that the
+legacy algorithm will be disabled in a future update.
+For detailed verification output, include
+\f[CB]\-J\-Djava.security.debug=jar\f[R].
+The \f[CB]jdk.jar.disabledAlgorithms\f[R] and
+\f[CB]jdk.security.legacyAlgorithms\f[R] security properties are defined
+in the \f[CB]java.security\f[R] file (located in the JDK\[aq]s
+\f[CB]$JAVA_HOME/conf/security\f[R] directory).
+.PP
+\f[B]Note:\f[R]
+.PP
+In order to improve out of the box security, default key size and
+signature algorithm names are periodically updated to stronger values
+with each release of the JDK.
+If interoperability with older releases of the JDK is important, please
+make sure the defaults are supported by those releases, or alternatively
+use the \f[CB]\-sigalg\f[R] option to override the default values at your
+own risk.
+.SH THE SIGNED JAR FILE
+.PP
+When the \f[CB]jarsigner\f[R] command is used to sign a JAR file, the
+output signed JAR file is exactly the same as the input JAR file, except
+that it has two additional files placed in the META\-INF directory:
+.IP \[bu] 2
+A signature file with an \f[CB]\&.SF\f[R] extension
+.IP \[bu] 2
+A signature block file with a \f[CB]\&.DSA\f[R], \f[CB]\&.RSA\f[R], or
+\f[CB]\&.EC\f[R] extension
+.PP
+The base file names for these two files come from the value of the
+\f[CB]\-sigfile\f[R] option.
+For example, when the option is \f[CB]\-sigfile\ MKSIGN\f[R], the files
+are named \f[CB]MKSIGN.SF\f[R] and \f[CB]MKSIGN.RSA\f[R].
+In this document, we assume the signer always uses an RSA key.
+.PP
+If no \f[CB]\-sigfile\f[R] option appears on the command line, then the
+base file name for the \f[CB]\&.SF\f[R] and the signature block files is
+the first 8 characters of the alias name specified on the command line,
+all converted to uppercase.
+If the alias name has fewer than 8 characters, then the full alias name
+is used.
+If the alias name contains any characters that aren\[aq]t allowed in a
+signature file name, then each such character is converted to an
+underscore (_) character in forming the file name.
+Valid characters include letters, digits, underscores, and hyphens.
+.SH SIGNATURE FILE
+.PP
+A signature file (\f[CB]\&.SF\f[R] file) looks similar to the manifest
+file that is always included in a JAR file when the \f[CB]jarsigner\f[R]
+command is used to sign the file.
+For each source file included in the JAR file, the \f[CB]\&.SF\f[R] file
+has two lines, such as in the manifest file, that list the following:
+.IP \[bu] 2
+File name
+.IP \[bu] 2
+Name of the digest algorithm (SHA)
+.IP \[bu] 2
+SHA digest value
+.PP
+\f[B]Note:\f[R]
+.PP
+The name of the digest algorithm (SHA) and the SHA digest value are on
+the same line.
+.PP
+In the manifest file, the SHA digest value for each source file is the
+digest (hash) of the binary data in the source file.
+In the \f[CB]\&.SF\f[R] file, the digest value for a specified source file
+is the hash of the two lines in the manifest file for the source file.
+.PP
+The signature file, by default, includes a header with a hash of the
+whole manifest file.
+The header also contains a hash of the manifest header.
+The presence of the header enables verification optimization.
+See \f[B]JAR File Verification\f[R].
+.SH SIGNATURE BLOCK FILE
+.PP
+The \f[CB]\&.SF\f[R] file is signed and the signature is placed in the
+signature block file.
+This file also contains, encoded inside it, the certificate or
+certificate chain from the keystore that authenticates the public key
+corresponding to the private key used for signing.
+The file has the extension \f[CB]\&.DSA\f[R], \f[CB]\&.RSA\f[R], or
+\f[CB]\&.EC\f[R], depending on the key algorithm used.
+See the table in \f[B]Supported Algorithms\f[R].
+.SH SIGNATURE TIME STAMP
+.PP
+The \f[CB]jarsigner\f[R] command used with the following options generates
+and stores a signature time stamp when signing a JAR file:
+.IP \[bu] 2
+\f[CB]\-tsa\f[R] \f[I]url\f[R]
+.IP \[bu] 2
+\f[CB]\-tsacert\f[R] \f[I]alias\f[R]
+.IP \[bu] 2
+\f[CB]\-tsapolicyid\f[R] \f[I]policyid\f[R]
+.IP \[bu] 2
+\f[CB]\-tsadigestalg\f[R] \f[I]algorithm\f[R]
+.PP
+See \f[B]Options for jarsigner\f[R].
+.SH JAR FILE VERIFICATION
+.PP
+A successful JAR file verification occurs when the signatures are valid,
+and none of the files that were in the JAR file when the signatures were
+generated have changed since then.
+JAR file verification involves the following steps:
+.IP "1." 3
+Verify the signature of the \f[CB]\&.SF\f[R] file.
+.RS 4
+.PP
+The verification ensures that the signature stored in each signature
+block file was generated using the private key corresponding to the
+public key whose certificate (or certificate chain) also appears in the
+signature block file.
+It also ensures that the signature is a valid signature of the
+corresponding signature (\f[CB]\&.SF\f[R]) file, and thus the
+\f[CB]\&.SF\f[R] file wasn\[aq]t tampered with.
+.RE
+.IP "2." 3
+Verify the digest listed in each entry in the \f[CB]\&.SF\f[R] file with
+each corresponding section in the manifest.
+.RS 4
+.PP
+The \f[CB]\&.SF\f[R] file by default includes a header that contains a
+hash of the entire manifest file.
+When the header is present, the verification can check to see whether or
+not the hash in the header matches the hash of the manifest file.
+If there is a match, then verification proceeds to the next step.
+.PP
+If there is no match, then a less optimized verification is required to
+ensure that the hash in each source file information section in the
+\f[CB]\&.SF\f[R] file equals the hash of its corresponding section in the
+manifest file.
+See Signature File.
+.PP
+One reason the hash of the manifest file that is stored in the
+\f[CB]\&.SF\f[R] file header might not equal the hash of the current
+manifest file is that it might contain sections for newly added files
+after the file was signed.
+For example, suppose one or more files were added to the signed JAR file
+(using the \f[CB]jar\f[R] tool) that already contains a signature and a
+\f[CB]\&.SF\f[R] file.
+If the JAR file is signed again by a different signer, then the manifest
+file is changed (sections are added to it for the new files by the
+\f[CB]jarsigner\f[R] tool) and a new \f[CB]\&.SF\f[R] file is created, but
+the original \f[CB]\&.SF\f[R] file is unchanged.
+A verification is still considered successful if none of the files that
+were in the JAR file when the original signature was generated have been
+changed since then.
+This is because the hashes in the non\-header sections of the
+\f[CB]\&.SF\f[R] file equal the hashes of the corresponding sections in
+the manifest file.
+.RE
+.IP "3." 3
+Read each file in the JAR file that has an entry in the \f[CB]\&.SF\f[R]
+file.
+While reading, compute the file\[aq]s digest and compare the result with
+the digest for this file in the manifest section.
+The digests should be the same or verification fails.
+.RS 4
+.PP
+If any serious verification failures occur during the verification
+process, then the process is stopped and a security exception is thrown.
+The \f[CB]jarsigner\f[R] command catches and displays the exception.
+.RE
+.IP "4." 3
+Check for disabled algorithm usage.
+See \f[B]Supported Algorithms\f[R].
+.PP
+\f[B]Note:\f[R]
+.PP
+You should read any addition warnings (or errors if you specified the
+\f[CB]\-strict\f[R] option), as well as the content of the certificate (by
+specifying the \f[CB]\-verbose\f[R] and \f[CB]\-certs\f[R] options) to
+determine if the signature can be trusted.
+.SH MULTIPLE SIGNATURES FOR A JAR FILE
+.PP
+A JAR file can be signed by multiple people by running the
+\f[CB]jarsigner\f[R] command on the file multiple times and specifying the
+alias for a different person each time, as follows:
+.IP
+.nf
+\f[CB]
+jarsigner\ myBundle.jar\ susan
+jarsigner\ myBundle.jar\ kevin
+\f[R]
+.fi
+.PP
+When a JAR file is signed multiple times, there are multiple
+\f[CB]\&.SF\f[R] and signature block files in the resulting JAR file, one
+pair for each signature.
+In the previous example, the output JAR file includes files with the
+following names:
+.IP
+.nf
+\f[CB]
+SUSAN.SF
+SUSAN.RSA
+KEVIN.SF
+KEVIN.RSA
+\f[R]
+.fi
+.SH OPTIONS FOR JARSIGNER
+.PP
+The following sections describe the options for the \f[CB]jarsigner\f[R].
+Be aware of the following standards:
+.IP \[bu] 2
+All option names are preceded by a hyphen sign (\-).
+.IP \[bu] 2
+The options can be provided in any order.
+.IP \[bu] 2
+Items that are in italics or underlined (option values) represent the
+actual values that must be supplied.
+.IP \[bu] 2
+The \f[CB]\-storepass\f[R], \f[CB]\-keypass\f[R], \f[CB]\-sigfile\f[R],
+\f[CB]\-sigalg\f[R], \f[CB]\-digestalg\f[R], \f[CB]\-signedjar\f[R], and
+TSA\-related options are only relevant when signing a JAR file; they
+aren\[aq]t relevant when verifying a signed JAR file.
+The \f[CB]\-keystore\f[R] option is relevant for signing and verifying a
+JAR file.
+In addition, aliases are specified when signing and verifying a JAR
+file.
+.TP
+.B \f[CB]\-keystore\f[R] \f[I]url\f[R]
+Specifies the URL that tells the keystore location.
+This defaults to the file \f[CB]\&.keystore\f[R] in the user\[aq]s home
+directory, as determined by the \f[CB]user.home\f[R] system property.
+.RS
+.PP
+A keystore is required when signing.
+You must explicitly specify a keystore when the default keystore
+doesn\[aq]t exist or if you want to use one other than the default.
+.PP
+A keystore isn\[aq]t required when verifying, but if one is specified or
+the default exists and the \f[CB]\-verbose\f[R] option was also specified,
+then additional information is output regarding whether or not any of
+the certificates used to verify the JAR file are contained in that
+keystore.
+.PP
+The \f[CB]\-keystore\f[R] argument can be a file name and path
+specification rather than a URL, in which case it is treated the same as
+a file: URL, for example, the following are equivalent:
+.IP \[bu] 2
+\f[CB]\-keystore\f[R] \f[I]filePathAndName\f[R]
+.IP \[bu] 2
+\f[CB]\-keystore\ file:\f[R]\f[I]filePathAndName\f[R]
+.PP
+If the Sun PKCS #11 provider was configured in the
+\f[CB]java.security\f[R] security properties file (located in the
+JDK\[aq]s \f[CB]$JAVA_HOME/conf/security\f[R] directory), then the
+\f[CB]keytool\f[R] and \f[CB]jarsigner\f[R] tools can operate on the PKCS
+#11 token by specifying these options:
+.RS
+.PP
+\f[CB]\-keystore\ NONE\ \-storetype\ PKCS11\f[R]
+.RE
+.PP
+For example, the following command lists the contents of the configured
+PKCS#11 token:
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ NONE\ \-storetype\ PKCS11\ \-list\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-storepass\f[R] [\f[CB]:env\f[R] | \f[CB]:file\f[R]] \f[I]argument\f[R]
+Specifies the password that is required to access the keystore.
+This is only needed when signing (not verifying) a JAR file.
+In that case, if a \f[CB]\-storepass\f[R] option isn\[aq]t provided at the
+command line, then the user is prompted for the password.
+.RS
+.PP
+If the modifier \f[CB]env\f[R] or \f[CB]file\f[R] isn\[aq]t specified, then
+the password has the value \f[CB]argument\f[R].
+Otherwise, the password is retrieved as follows:
+.IP \[bu] 2
+\f[CB]env\f[R]: Retrieve the password from the environment variable named
+\f[I]argument\f[R].
+.IP \[bu] 2
+\f[CB]file\f[R]: Retrieve the password from the file named
+\f[I]argument\f[R].
+.PP
+\f[B]Note:\f[R]
+.PP
+The password shouldn\[aq]t be specified on the command line or in a
+script unless it is for testing purposes, or you are on a secure system.
+.RE
+.TP
+.B \f[CB]\-storetype\f[R] \f[I]storetype\f[R]
+Specifies the type of keystore to be instantiated.
+The default keystore type is the one that is specified as the value of
+the \f[CB]keystore.type\f[R] property in the security properties file,
+which is returned by the static \f[CB]getDefaultType\f[R] method in
+\f[CB]java.security.KeyStore\f[R].
+.RS
+.PP
+The PIN for a PKCS #11 token can also be specified with the
+\f[CB]\-storepass\f[R] option.
+If none is specified, then the \f[CB]keytool\f[R] and \f[CB]jarsigner\f[R]
+commands prompt for the token PIN.
+If the token has a protected authentication path (such as a dedicated
+PIN\-pad or a biometric reader), then the \f[CB]\-protected\f[R] option
+must be specified and no password options can be specified.
+.RE
+.TP
+.B \f[CB]\-keypass\f[R] [\f[CB]:env\f[R] | \f[CB]:file\f[R]] \f[I]argument\f[R] \f[CB]\-certchain\f[R] \f[I]file\f[R]
+Specifies the password used to protect the private key of the keystore
+entry addressed by the alias specified on the command line.
+The password is required when using \f[CB]jarsigner\f[R] to sign a JAR
+file.
+If no password is provided on the command line, and the required
+password is different from the store password, then the user is prompted
+for it.
+.RS
+.PP
+If the modifier \f[CB]env\f[R] or \f[CB]file\f[R] isn\[aq]t specified, then
+the password has the value \f[CB]argument\f[R].
+Otherwise, the password is retrieved as follows:
+.IP \[bu] 2
+\f[CB]env\f[R]: Retrieve the password from the environment variable named
+\f[I]argument\f[R].
+.IP \[bu] 2
+\f[CB]file\f[R]: Retrieve the password from the file named
+\f[I]argument\f[R].
+.PP
+\f[B]Note:\f[R]
+.PP
+The password shouldn\[aq]t be specified on the command line or in a
+script unless it is for testing purposes, or you are on a secure system.
+.RE
+.TP
+.B \f[CB]\-certchain\f[R] \f[I]file\f[R]
+Specifies the certificate chain to be used when the certificate chain
+associated with the private key of the keystore entry that is addressed
+by the alias specified on the command line isn\[aq]t complete.
+This can happen when the keystore is located on a hardware token where
+there isn\[aq]t enough capacity to hold a complete certificate chain.
+The file can be a sequence of concatenated X.509 certificates, or a
+single PKCS#7 formatted data block, either in binary encoding format or
+in printable encoding format (also known as Base64 encoding) as defined
+by \f[B]Internet RFC 1421 Certificate Encoding Standard\f[R]
+[http://tools.ietf.org/html/rfc1421].
+.RS
+.RE
+.TP
+.B \f[CB]\-sigfile\f[R] \f[I]file\f[R]
+Specifies the base file name to be used for the generated \f[CB]\&.SF\f[R]
+and signature block files.
+For example, if file is \f[CB]DUKESIGN\f[R], then the generated
+\f[CB]\&.SF\f[R] and signature block files are named \f[CB]DUKESIGN.SF\f[R]
+and \f[CB]DUKESIGN.RSA\f[R], and placed in the \f[CB]META\-INF\f[R]
+directory of the signed JAR file.
+.RS
+.PP
+The characters in the file must come from the set
+\f[CB]a\-zA\-Z0\-9_\-\f[R].
+Only letters, numbers, underscore, and hyphen characters are allowed.
+All lowercase characters are converted to uppercase for the
+\f[CB]\&.SF\f[R] and signature block file names.
+.PP
+If no \f[CB]\-sigfile\f[R] option appears on the command line, then the
+base file name for the \f[CB]\&.SF\f[R] and signature block files is the
+first 8 characters of the alias name specified on the command line, all
+converted to upper case.
+If the alias name has fewer than 8 characters, then the full alias name
+is used.
+If the alias name contains any characters that aren\[aq]t valid in a
+signature file name, then each such character is converted to an
+underscore (_) character to form the file name.
+.RE
+.TP
+.B \f[CB]\-signedjar\f[R] \f[I]file\f[R]
+Specifies the name of signed JAR file.
+.RS
+.RE
+.TP
+.B \f[CB]\-digestalg\f[R] \f[I]algorithm\f[R]
+Specifies the name of the message digest algorithm to use when digesting
+the entries of a JAR file.
+.RS
+.PP
+For a list of standard message digest algorithm names, see Java Security
+Standard Algorithm Names.
+.PP
+If this option isn\[aq]t specified, then \f[CB]SHA256\f[R] is used.
+There must either be a statically installed provider supplying an
+implementation of the specified algorithm or the user must specify one
+with the \f[CB]\-addprovider\f[R] or \f[CB]\-providerClass\f[R] options;
+otherwise, the command will not succeed.
+.RE
+.TP
+.B \f[CB]\-sigalg\f[R] \f[I]algorithm\f[R]
+Specifies the name of the signature algorithm to use to sign the JAR
+file.
+.RS
+.PP
+This algorithm must be compatible with the private key used to sign the
+JAR file.
+If this option isn\[aq]t specified, then use a default algorithm
+matching the private key as described in the \f[B]Supported
+Algorithms\f[R] section.
+There must either be a statically installed provider supplying an
+implementation of the specified algorithm or you must specify one with
+the \f[CB]\-addprovider\f[R] or \f[CB]\-providerClass\f[R] option;
+otherwise, the command doesn\[aq]t succeed.
+.PP
+For a list of standard message digest algorithm names, see Java Security
+Standard Algorithm Names.
+.RE
+.TP
+.B \f[CB]\-verify\f[R]
+Verifies a signed JAR file.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose\f[R][\f[CB]:\f[R]\f[I]suboptions\f[R]]
+When the \f[CB]\-verbose\f[R] option appears on the command line, it
+indicates that the \f[CB]jarsigner\f[R] use the verbose mode when signing
+or verifying with the suboptions determining how much information is
+shown.
+This causes the , which causes \f[CB]jarsigner\f[R] to output extra
+information about the progress of the JAR signing or verification.
+The \f[I]suboptions\f[R] can be \f[CB]all\f[R], \f[CB]grouped\f[R], or
+\f[CB]summary\f[R].
+.RS
+.PP
+If the \f[CB]\-certs\f[R] option is also specified, then the default mode
+(or suboption \f[CB]all\f[R]) displays each entry as it is being
+processed, and after that, the certificate information for each signer
+of the JAR file.
+.PP
+If the \f[CB]\-certs\f[R] and the \f[CB]\-verbose:grouped\f[R] suboptions
+are specified, then entries with the same signer info are grouped and
+displayed together with their certificate information.
+.PP
+If \f[CB]\-certs\f[R] and the \f[CB]\-verbose:summary\f[R] suboptions are
+specified, then entries with the same signer information are grouped and
+displayed together with their certificate information.
+.PP
+Details about each entry are summarized and displayed as \f[I]one entry
+(and more)\f[R].
+See \f[B]Example of Verifying a Signed JAR File\f[R] and \f[B]Example of
+Verification with Certificate Information\f[R].
+.RE
+.TP
+.B \f[CB]\-certs\f[R]
+If the \f[CB]\-certs\f[R] option appears on the command line with the
+\f[CB]\-verify\f[R] and \f[CB]\-verbose\f[R] options, then the output
+includes certificate information for each signer of the JAR file.
+This information includes the name of the type of certificate (stored in
+the signature block file) that certifies the signer\[aq]s public key,
+and if the certificate is an X.509 certificate (an instance of the
+\f[CB]java.security.cert.X509Certificate\f[R]), then the distinguished
+name of the signer.
+.RS
+.PP
+The keystore is also examined.
+If no keystore value is specified on the command line, then the default
+keystore file (if any) is checked.
+If the public key certificate for a signer matches an entry in the
+keystore, then the alias name for the keystore entry for that signer is
+displayed in parentheses.
+.RE
+.TP
+.B \f[CB]\-revCheck\f[R]
+This option enables revocation checking of certificates when signing or
+verifying a JAR file.
+The \f[CB]jarsigner\f[R] command attempts to make network connections to
+fetch OCSP responses and CRLs if the \f[CB]\-revCheck\f[R] option is
+specified on the command line.
+Note that revocation checks are not enabled unless this option is
+specified.
+.RS
+.RE
+.TP
+.B \f[CB]\-tsa\f[R] \f[I]url\f[R]
+If \f[CB]\-tsa\ http://example.tsa.url\f[R] appears on the command line
+when signing a JAR file then a time stamp is generated for the
+signature.
+The URL, \f[CB]http://example.tsa.url\f[R], identifies the location of the
+Time Stamping Authority (TSA) and overrides any URL found with the
+\f[CB]\-tsacert\f[R] option.
+The \f[CB]\-tsa\f[R] option doesn\[aq]t require the TSA public key
+certificate to be present in the keystore.
+.RS
+.PP
+To generate the time stamp, \f[CB]jarsigner\f[R] communicates with the TSA
+with the Time\-Stamp Protocol (TSP) defined in RFC 3161.
+When successful, the time stamp token returned by the TSA is stored with
+the signature in the signature block file.
+.RE
+.TP
+.B \f[CB]\-tsacert\f[R] \f[I]alias\f[R]
+When \f[CB]\-tsacert\f[R] \f[I]alias\f[R] appears on the command line when
+signing a JAR file, a time stamp is generated for the signature.
+The alias identifies the TSA public key certificate in the keystore that
+is in effect.
+The entry\[aq]s certificate is examined for a Subject Information Access
+extension that contains a URL identifying the location of the TSA.
+.RS
+.PP
+The TSA public key certificate must be present in the keystore when
+using the \f[CB]\-tsacert\f[R] option.
+.RE
+.TP
+.B \f[CB]\-tsapolicyid\f[R] \f[I]policyid\f[R]
+Specifies the object identifier (OID) that identifies the policy ID to
+be sent to the TSA server.
+If this option isn\[aq]t specified, no policy ID is sent and the TSA
+server will choose a default policy ID.
+.RS
+.PP
+Object identifiers are defined by X.696, which is an ITU
+Telecommunication Standardization Sector (ITU\-T) standard.
+These identifiers are typically period\-separated sets of non\-negative
+digits like \f[CB]1.2.3.4\f[R], for example.
+.RE
+.TP
+.B \f[CB]\-tsadigestalg\f[R] \f[I]algorithm\f[R]
+Specifies the message digest algorithm that is used to generate the
+message imprint to be sent to the TSA server.
+If this option isn\[aq]t specified, SHA\-256 will be used.
+.RS
+.PP
+See \f[B]Supported Algorithms\f[R].
+.PP
+For a list of standard message digest algorithm names, see Java Security
+Standard Algorithm Names.
+.RE
+.TP
+.B \f[CB]\-internalsf\f[R]
+In the past, the signature block file generated when a JAR file was
+signed included a complete encoded copy of the \f[CB]\&.SF\f[R] file
+(signature file) also generated.
+This behavior has been changed.
+To reduce the overall size of the output JAR file, the signature block
+file by default doesn\[aq]t contain a copy of the \f[CB]\&.SF\f[R] file
+anymore.
+If \f[CB]\-internalsf\f[R] appears on the command line, then the old
+behavior is utilized.
+This option is useful for testing.
+In practice, don\[aq]t use the \f[CB]\-internalsf\f[R] option because it
+incurs higher overhead.
+.RS
+.RE
+.TP
+.B \f[CB]\-sectionsonly\f[R]
+If the \f[CB]\-sectionsonly\f[R] option appears on the command line, then
+the \f[CB]\&.SF\f[R] file (signature file) generated when a JAR file is
+signed doesn\[aq]t include a header that contains a hash of the whole
+manifest file.
+It contains only the information and hashes related to each individual
+source file included in the JAR file.
+See Signature File.
+.RS
+.PP
+By default, this header is added, as an optimization.
+When the header is present, whenever the JAR file is verified, the
+verification can first check to see whether the hash in the header
+matches the hash of the whole manifest file.
+When there is a match, verification proceeds to the next step.
+When there is no match, it is necessary to do a less optimized
+verification that the hash in each source file information section in
+the \f[CB]\&.SF\f[R] file equals the hash of its corresponding section in
+the manifest file.
+See \f[B]JAR File Verification\f[R].
+.PP
+The \f[CB]\-sectionsonly\f[R] option is primarily used for testing.
+It shouldn\[aq]t be used other than for testing because using it incurs
+higher overhead.
+.RE
+.TP
+.B \f[CB]\-protected\f[R]
+Values can be either \f[CB]true\f[R] or \f[CB]false\f[R].
+Specify \f[CB]true\f[R] when a password must be specified through a
+protected authentication path such as a dedicated PIN reader.
+.RS
+.RE
+.TP
+.B \f[CB]\-providerName\f[R] \f[I]providerName\f[R]
+If more than one provider was configured in the \f[CB]java.security\f[R]
+security properties file, then you can use the \f[CB]\-providerName\f[R]
+option to target a specific provider instance.
+The argument to this option is the name of the provider.
+.RS
+.PP
+For the Oracle PKCS #11 provider, \f[I]providerName\f[R] is of the form
+\f[CB]SunPKCS11\-\f[R]\f[I]TokenName\f[R], where \f[I]TokenName\f[R] is the
+name suffix that the provider instance has been configured with, as
+detailed in the configuration attributes table.
+For example, the following command lists the contents of the
+\f[CB]PKCS\ #11\f[R] keystore provider instance with name suffix
+\f[CB]SmartCard\f[R]:
+.RS
+.PP
+\f[CB]jarsigner\ \-keystore\ NONE\ \-storetype\ PKCS11\ \-providerName\ SunPKCS11\-SmartCard\ \-list\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerArg\f[R] \f[I]arg\f[R]]
+Adds a security provider by name (such as SunPKCS11) and an optional
+configure argument.
+The value of the security provider is the name of a security provider
+that is defined in a module.
+.RS
+.PP
+Used with the \f[CB]\-providerArg\ ConfigFilePath\f[R] option, the
+\f[CB]keytool\f[R] and \f[CB]jarsigner\f[R] tools install the provider
+dynamically and use \f[CB]ConfigFilePath\f[R] for the path to the token
+configuration file.
+The following example shows a command to list a \f[CB]PKCS\ #11\f[R]
+keystore when the Oracle PKCS #11 provider wasn\[aq]t configured in the
+security properties file.
+.RS
+.PP
+\f[CB]jarsigner\ \-keystore\ NONE\ \-storetype\ PKCS11\ \-addprovider\ SunPKCS11\ \-providerArg\ /mydir1/mydir2/token.config\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-providerClass\f[R] \f[I]provider\-class\-name\f[R] [\f[CB]\-providerArg\f[R] \f[I]arg\f[R]]
+Used to specify the name of cryptographic service provider\[aq]s master
+class file when the service provider isn\[aq]t listed in the
+\f[CB]java.security\f[R] security properties file.
+Adds a security provider by fully\-qualified class name and an optional
+configure argument.
+.RS
+.PP
+\f[B]Note:\f[R]
+.PP
+The preferred way to load PKCS11 is by using modules.
+See \f[CB]\-addprovider\f[R].
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]javaoption\f[R]
+Passes through the specified \f[I]javaoption\f[R] string directly to the
+Java interpreter.
+The \f[CB]jarsigner\f[R] command is a wrapper around the interpreter.
+This option shouldn\[aq]t contain any spaces.
+It is useful for adjusting the execution environment or memory usage.
+For a list of possible interpreter options, type \f[CB]java\ \-h\f[R] or
+\f[CB]java\ \-X\f[R] at the command line.
+.RS
+.RE
+.TP
+.B \f[CB]\-strict\f[R]
+During the signing or verifying process, the command may issue warning
+messages.
+If you specify this option, the exit code of the tool reflects the
+severe warning messages that this command found.
+See \f[B]Errors and Warnings\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-conf\f[R] \f[I]url\f[R]
+Specifies a pre\-configured options file.
+Read the \f[B]keytool documentation\f[R] for details.
+The property keys supported are "jarsigner.all" for all actions,
+"jarsigner.sign" for signing, and "jarsigner.verify" for verification.
+\f[CB]jarsigner\f[R] arguments including the JAR file name and alias
+name(s) cannot be set in this file.
+.RS
+.RE
+.SH DEPRECATED OPTIONS
+.PP
+The following \f[CB]jarsigner\f[R] options are deprecated as of JDK 9 and
+might be removed in a future JDK release.
+.TP
+.B \f[CB]\-altsigner\f[R] \f[I]class\f[R]
+This option specifies an alternative signing mechanism.
+The fully qualified class name identifies a class file that extends the
+\f[CB]com.sun.jarsigner.ContentSigner\f[R] abstract class.
+The path to this class file is defined by the \f[CB]\-altsignerpath\f[R]
+option.
+If the \f[CB]\-altsigner\f[R] option is used, then the \f[CB]jarsigner\f[R]
+command uses the signing mechanism provided by the specified class.
+Otherwise, the \f[CB]jarsigner\f[R] command uses its default signing
+mechanism.
+.RS
+.PP
+For example, to use the signing mechanism provided by a class named
+\f[CB]com.sun.sun.jarsigner.AuthSigner\f[R], use the \f[CB]jarsigner\f[R]
+option \f[CB]\-altsigner\ com.sun.jarsigner.AuthSigner\f[R].
+.RE
+.TP
+.B \f[CB]\-altsignerpath\f[R] \f[I]classpathlist\f[R]
+Specifies the path to the class file and any JAR file it depends on.
+The class file name is specified with the \f[CB]\-altsigner\f[R] option.
+If the class file is in a JAR file, then this option specifies the path
+to that JAR file.
+.RS
+.PP
+An absolute path or a path relative to the current directory can be
+specified.
+If \f[I]classpathlist\f[R] contains multiple paths or JAR files, then
+they should be separated with a:
+.IP \[bu] 2
+Colon (\f[CB]:\f[R]) on Linux and macOS
+.IP \[bu] 2
+Semicolon (\f[CB];\f[R]) on Windows
+.PP
+This option isn\[aq]t necessary when the class is already in the search
+path.
+.PP
+The following example shows how to specify the path to a JAR file that
+contains the class file.
+The JAR file name is included.
+.RS
+.PP
+\f[CB]\-altsignerpath\ /home/user/lib/authsigner.jar\f[R]
+.RE
+.PP
+The following example shows how to specify the path to the JAR file that
+contains the class file.
+The JAR file name is omitted.
+.RS
+.PP
+\f[CB]\-altsignerpath\ /home/user/classes/com/sun/tools/jarsigner/\f[R]
+.RE
+.RE
+.SH ERRORS AND WARNINGS
+.PP
+During the signing or verifying process, the \f[CB]jarsigner\f[R] command
+may issue various errors or warnings.
+.PP
+If there is a failure, the \f[CB]jarsigner\f[R] command exits with code 1.
+If there is no failure, but there are one or more severe warnings, the
+\f[CB]jarsigner\f[R] command exits with code 0 when the \f[CB]\-strict\f[R]
+option is \f[B]not\f[R] specified, or exits with the OR\-value of the
+warning codes when the \f[CB]\-strict\f[R] is specified.
+If there is only informational warnings or no warning at all, the
+command always exits with code 0.
+.PP
+For example, if a certificate used to sign an entry is expired and has a
+KeyUsage extension that doesn\[aq]t allow it to sign a file, the
+\f[CB]jarsigner\f[R] command exits with code 12 (=4+8) when the
+\f[CB]\-strict\f[R] option is specified.
+.PP
+\f[B]Note:\f[R] Exit codes are reused because only the values from 0 to
+255 are legal on Linux and OS X.
+.PP
+The following sections describes the names, codes, and descriptions of
+the errors and warnings that the \f[CB]jarsigner\f[R] command can issue.
+.SH FAILURE
+.PP
+Reasons why the \f[CB]jarsigner\f[R] command fails include (but aren\[aq]t
+limited to) a command line parsing error, the inability to find a
+keypair to sign the JAR file, or the verification of a signed JAR fails.
+.TP
+.B failure
+Code 1.
+The signing or verifying fails.
+.RS
+.RE
+.SH SEVERE WARNINGS
+.PP
+\f[B]Note:\f[R]
+.PP
+Severe warnings are reported as errors if you specify the
+\f[CB]\-strict\f[R] option.
+.PP
+Reasons why the \f[CB]jarsigner\f[R] command issues a severe warning
+include the certificate used to sign the JAR file has an error or the
+signed JAR file has other problems.
+.TP
+.B hasExpiredCert
+Code 4.
+This JAR contains entries whose signer certificate has expired.
+.RS
+.RE
+.TP
+.B hasExpiredTsaCert
+Code 4.
+The timestamp has expired.
+.RS
+.RE
+.TP
+.B notYetValidCert
+Code 4.
+This JAR contains entries whose signer certificate isn\[aq]t yet valid.
+.RS
+.RE
+.TP
+.B chainNotValidated
+Code 4.
+This JAR contains entries whose certificate chain isn\[aq]t validated.
+.RS
+.RE
+.TP
+.B tsaChainNotValidated
+Code 64.
+The timestamp is invalid.
+.RS
+.RE
+.TP
+.B signerSelfSigned
+Code 4.
+This JAR contains entries whose signer certificate is self signed.
+.RS
+.RE
+.TP
+.B disabledAlg
+Code 4.
+An algorithm used is considered a security risk and is disabled.
+.RS
+.RE
+.TP
+.B badKeyUsage
+Code 8.
+This JAR contains entries whose signer certificate\[aq]s KeyUsage
+extension doesn\[aq]t allow code signing.
+.RS
+.RE
+.TP
+.B badExtendedKeyUsage
+Code 8.
+This JAR contains entries whose signer certificate\[aq]s
+ExtendedKeyUsage extension doesn\[aq]t allow code signing.
+.RS
+.RE
+.TP
+.B badNetscapeCertType
+Code 8.
+This JAR contains entries whose signer certificate\[aq]s
+NetscapeCertType extension doesn\[aq]t allow code signing.
+.RS
+.RE
+.TP
+.B hasUnsignedEntry
+Code 16.
+This JAR contains unsigned entries which haven\[aq]t been
+integrity\-checked.
+.RS
+.RE
+.TP
+.B notSignedByAlias
+Code 32.
+This JAR contains signed entries which aren\[aq]t signed by the
+specified alias(es).
+.RS
+.RE
+.TP
+.B aliasNotInStore
+Code 32.
+This JAR contains signed entries that aren\[aq]t signed by alias in this
+keystore.
+.RS
+.RE
+.TP
+.B tsaChainNotValidated
+Code 64.
+This JAR contains entries whose TSA certificate chain is invalid.
+.RS
+.RE
+.SH INFORMATIONAL WARNINGS
+.PP
+Informational warnings include those that aren\[aq]t errors but regarded
+as bad practice.
+They don\[aq]t have a code.
+.TP
+.B extraAttributesDetected
+The POSIX file permissions and/or symlink attributes are detected during
+signing or verifying a JAR file.
+The \f[CB]jarsigner\f[R] tool preserves these attributes in the newly
+signed file but warns that these attributes are unsigned and not
+protected by the signature.
+.RS
+.RE
+.TP
+.B hasExpiringCert
+This JAR contains entries whose signer certificate expires within six
+months.
+.RS
+.RE
+.TP
+.B hasExpiringTsaCert
+The timestamp will expire within one year on \f[CB]YYYY\-MM\-DD\f[R].
+.RS
+.RE
+.TP
+.B legacyAlg
+An algorithm used is considered a security risk but not disabled.
+.RS
+.RE
+.TP
+.B noTimestamp
+This JAR contains signatures that doesn\[aq]t include a timestamp.
+Without a timestamp, users may not be able to validate this JAR file
+after the signer certificate\[aq]s expiration date
+(\f[CB]YYYY\-MM\-DD\f[R]) or after any future revocation date.
+.RS
+.RE
+.SH EXAMPLE OF SIGNING A JAR FILE
+.PP
+Use the following command to sign \f[CB]bundle.jar\f[R] with the private
+key of a user whose keystore alias is \f[CB]jane\f[R] in a keystore named
+\f[CB]mystore\f[R] in the \f[CB]working\f[R] directory and name the signed
+JAR file \f[CB]sbundle.jar\f[R]:
+.RS
+.PP
+\f[CB]jarsigner\ \-keystore\ /working/mystore\ \-storepass\f[R]
+\f[I]keystore_password\f[R] \f[CB]\-keypass\f[R]
+\f[I]private_key_password\f[R]
+\f[CB]\-signedjar\ sbundle.jar\ bundle.jar\ jane\f[R]
+.RE
+.PP
+There is no \f[CB]\-sigfile\f[R] specified in the previous command so the
+generated \f[CB]\&.SF\f[R] and signature block files to be placed in the
+signed JAR file have default names based on the alias name.
+They are named \f[CB]JANE.SF\f[R] and \f[CB]JANE.RSA\f[R].
+.PP
+If you want to be prompted for the store password and the private key
+password, then you could shorten the previous command to the following:
+.RS
+.PP
+\f[CB]jarsigner\ \-keystore\ /working/mystore\ \-signedjar\ sbundle.jar\ bundle.jar\ jane\f[R]
+.RE
+.PP
+If the \f[CB]keystore\f[R] is the default \f[CB]keystore\f[R]
+(\f[CB]\&.keystore\f[R] in your home directory), then you don\[aq]t need
+to specify a \f[CB]keystore\f[R], as follows:
+.RS
+.PP
+\f[CB]jarsigner\ \-signedjar\ sbundle.jar\ bundle.jar\ jane\f[R]
+.RE
+.PP
+If you want the signed JAR file to overwrite the input JAR file
+(\f[CB]bundle.jar\f[R]), then you don\[aq]t need to specify a
+\f[CB]\-signedjar\f[R] option, as follows:
+.RS
+.PP
+\f[CB]jarsigner\ bundle.jar\ jane\f[R]
+.RE
+.SH EXAMPLE OF VERIFYING A SIGNED JAR FILE
+.PP
+To verify a signed JAR file to ensure that the signature is valid and
+the JAR file wasn\[aq]t been tampered with, use a command such as the
+following:
+.RS
+.PP
+\f[CB]jarsigner\ \-verify\ ButtonDemo.jar\f[R]
+.RE
+.PP
+When the verification is successful, \f[CB]jar\ verified\f[R] is
+displayed.
+Otherwise, an error message is displayed.
+You can get more information when you use the \f[CB]\-verbose\f[R] option.
+A sample use of \f[CB]jarsigner\f[R] with the \f[CB]\-verbose\f[R] option
+follows:
+.IP
+.nf
+\f[CB]
+jarsigner\ \-verify\ \-verbose\ ButtonDemo.jar
+
+s\ \ \ \ \ \ \ 866\ Tue\ Sep\ 12\ 20:08:48\ EDT\ 2017\ META\-INF/MANIFEST.MF
+\ \ \ \ \ \ \ \ 825\ Tue\ Sep\ 12\ 20:08:48\ EDT\ 2017\ META\-INF/ORACLE_C.SF
+\ \ \ \ \ \ \ 7475\ Tue\ Sep\ 12\ 20:08:48\ EDT\ 2017\ META\-INF/ORACLE_C.RSA
+\ \ \ \ \ \ \ \ \ \ 0\ Tue\ Sep\ 12\ 20:07:54\ EDT\ 2017\ META\-INF/
+\ \ \ \ \ \ \ \ \ \ 0\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/
+\ \ \ \ \ \ \ \ \ \ 0\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/images/
+sm\ \ \ \ \ \ 523\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/ButtonDemo$1.class
+sm\ \ \ \ \ 3440\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/ButtonDemo.class
+sm\ \ \ \ \ 2346\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/ButtonDemo.jnlp
+sm\ \ \ \ \ \ 172\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/images/left.gif
+sm\ \ \ \ \ \ 235\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/images/middle.gif
+sm\ \ \ \ \ \ 172\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/images/right.gif
+
+\ \ s\ =\ signature\ was\ verified
+\ \ m\ =\ entry\ is\ listed\ in\ manifest
+\ \ k\ =\ at\ least\ one\ certificate\ was\ found\ in\ keystore
+
+\-\ Signed\ by\ "CN="Oracle\ America,\ Inc.",\ OU=Software\ Engineering,\ O="Oracle\ America,\ Inc.",\ L=Redwood\ City,\ ST=California,\ C=US"
+\ \ \ \ Digest\ algorithm:\ SHA\-256
+\ \ \ \ Signature\ algorithm:\ SHA256withRSA,\ 2048\-bit\ key
+\ \ Timestamped\ by\ "CN=Symantec\ Time\ Stamping\ Services\ Signer\ \-\ G4,\ O=Symantec\ Corporation,\ C=US"\ on\ Tue\ Sep\ 12\ 20:08:49\ UTC\ 2017
+\ \ \ \ Timestamp\ digest\ algorithm:\ SHA\-1
+\ \ \ \ Timestamp\ signature\ algorithm:\ SHA1withRSA,\ 2048\-bit\ key
+
+jar\ verified.
+
+The\ signer\ certificate\ expired\ on\ 2018\-02\-01.\ However,\ the\ JAR\ will\ be\ valid\ until\ the\ timestamp\ expires\ on\ 2020\-12\-29.
+\f[R]
+.fi
+.SH EXAMPLE OF VERIFICATION WITH CERTIFICATE INFORMATION
+.PP
+If you specify the \f[CB]\-certs\f[R] option with the \f[CB]\-verify\f[R]
+and \f[CB]\-verbose\f[R] options, then the output includes certificate
+information for each signer of the JAR file.
+The information includes the certificate type, the signer distinguished
+name information (when it is an X.509 certificate), and in parentheses,
+the keystore alias for the signer when the public key certificate in the
+JAR file matches the one in a keystore entry, for example:
+.IP
+.nf
+\f[CB]
+jarsigner\ \-keystore\ $JAVA_HOME/lib/security/cacerts\ \-verify\ \-verbose\ \-certs\ ButtonDemo.jar
+
+s\ k\ \ \ \ \ 866\ Tue\ Sep\ 12\ 20:08:48\ EDT\ 2017\ META\-INF/MANIFEST.MF
+
+\ \ \ \ \ \ >>>\ Signer
+\ \ \ \ \ \ X.509,\ CN="Oracle\ America,\ Inc.",\ OU=Software\ Engineering,\ O="Oracle\ America,\ Inc.",\ L=Redwood\ City,\ ST=California,\ C=US
+\ \ \ \ \ \ [certificate\ is\ valid\ from\ 2017\-01\-30,\ 7:00\ PM\ to\ 2018\-02\-01,\ 6:59\ PM]
+\ \ \ \ \ \ X.509,\ CN=Symantec\ Class\ 3\ SHA256\ Code\ Signing\ CA,\ OU=Symantec\ Trust\ Network,\ O=Symantec\ Corporation,\ C=US
+\ \ \ \ \ \ [certificate\ is\ valid\ from\ 2013\-12\-09,\ 7:00\ PM\ to\ 2023\-12\-09,\ 6:59\ PM]
+\ \ \ \ \ \ X.509,\ CN=VeriSign\ Class\ 3\ Public\ Primary\ Certification\ Authority\ \-\ G5,\ OU="(c)\ 2006\ VeriSign,\ Inc.\ \-\ For\ authorized\ use\ only",\ OU=VeriSign\ Trust\ Network,\ O="VeriSign,\ Inc.",\ C=US\ (verisignclass3g5ca\ [jdk])
+\ \ \ \ \ \ [trusted\ certificate]
+\ \ \ \ \ \ >>>\ TSA
+\ \ \ \ \ \ X.509,\ CN=Symantec\ Time\ Stamping\ Services\ Signer\ \-\ G4,\ O=Symantec\ Corporation,\ C=US
+\ \ \ \ \ \ [certificate\ is\ valid\ from\ 2012\-10\-17,\ 8:00\ PM\ to\ 2020\-12\-29,\ 6:59\ PM]
+\ \ \ \ \ \ X.509,\ CN=Symantec\ Time\ Stamping\ Services\ CA\ \-\ G2,\ O=Symantec\ Corporation,\ C=US
+\ \ \ \ \ \ [certificate\ is\ valid\ from\ 2012\-12\-20,\ 7:00\ PM\ to\ 2020\-12\-30,\ 6:59\ PM]
+
+\ \ \ \ \ \ \ \ 825\ Tue\ Sep\ 12\ 20:08:48\ EDT\ 2017\ META\-INF/ORACLE_C.SF
+\ \ \ \ \ \ \ 7475\ Tue\ Sep\ 12\ 20:08:48\ EDT\ 2017\ META\-INF/ORACLE_C.RSA
+\ \ \ \ \ \ \ \ \ \ 0\ Tue\ Sep\ 12\ 20:07:54\ EDT\ 2017\ META\-INF/
+\ \ \ \ \ \ \ \ \ \ 0\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/
+\ \ \ \ \ \ \ \ \ \ 0\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/images/
+smk\ \ \ \ \ 523\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/ButtonDemo$1.class
+
+\ \ \ \ \ \ [entry\ was\ signed\ on\ 2017\-09\-12,\ 4:08\ PM]
+\ \ \ \ \ \ >>>\ Signer
+\ \ \ \ \ \ X.509,\ CN="Oracle\ America,\ Inc.",\ OU=Software\ Engineering,\ O="Oracle\ America,\ Inc.",\ L=Redwood\ City,\ ST=California,\ C=US
+\ \ \ \ \ \ [certificate\ is\ valid\ from\ 2017\-01\-30,\ 7:00\ PM\ to\ 2018\-02\-01,\ 6:59\ PM]
+\ \ \ \ \ \ X.509,\ CN=Symantec\ Class\ 3\ SHA256\ Code\ Signing\ CA,\ OU=Symantec\ Trust\ Network,\ O=Symantec\ Corporation,\ C=US
+\ \ \ \ \ \ [certificate\ is\ valid\ from\ 2013\-12\-09,\ 7:00\ PM\ to\ 2023\-12\-09,\ 6:59\ PM]
+\ \ \ \ \ \ X.509,\ CN=VeriSign\ Class\ 3\ Public\ Primary\ Certification\ Authority\ \-\ G5,\ OU="(c)\ 2006\ VeriSign,\ Inc.\ \-\ For\ authorized\ use\ only",\ OU=VeriSign\ Trust\ Network,\ O="VeriSign,\ Inc.",\ C=US\ (verisignclass3g5ca\ [jdk])
+\ \ \ \ \ \ [trusted\ certificate]
+\ \ \ \ \ \ >>>\ TSA
+\ \ \ \ \ \ X.509,\ CN=Symantec\ Time\ Stamping\ Services\ Signer\ \-\ G4,\ O=Symantec\ Corporation,\ C=US
+\ \ \ \ \ \ [certificate\ is\ valid\ from\ 2012\-10\-17,\ 8:00\ PM\ to\ 2020\-12\-29,\ 6:59\ PM]
+\ \ \ \ \ \ X.509,\ CN=Symantec\ Time\ Stamping\ Services\ CA\ \-\ G2,\ O=Symantec\ Corporation,\ C=US
+\ \ \ \ \ \ [certificate\ is\ valid\ from\ 2012\-12\-20,\ 7:00\ PM\ to\ 2020\-12\-30,\ 6:59\ PM]
+
+smk\ \ \ \ 3440\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/ButtonDemo.class
+\&...
+smk\ \ \ \ 2346\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/ButtonDemo.jnlp
+\&...
+smk\ \ \ \ \ 172\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/images/left.gif
+\&...
+smk\ \ \ \ \ 235\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/images/middle.gif
+\&...
+smk\ \ \ \ \ 172\ Tue\ Sep\ 12\ 20:07:16\ EDT\ 2017\ components/images/right.gif
+\&...
+
+\ \ s\ =\ signature\ was\ verified
+\ \ m\ =\ entry\ is\ listed\ in\ manifest
+\ \ k\ =\ at\ least\ one\ certificate\ was\ found\ in\ keystore
+
+\-\ Signed\ by\ "CN="Oracle\ America,\ Inc.",\ OU=Software\ Engineering,\ O="Oracle\ America,\ Inc.",\ L=Redwood\ City,\ ST=California,\ C=US"
+\ \ \ \ Digest\ algorithm:\ SHA\-256
+\ \ \ \ Signature\ algorithm:\ SHA256withRSA,\ 2048\-bit\ key
+\ \ Timestamped\ by\ "CN=Symantec\ Time\ Stamping\ Services\ Signer\ \-\ G4,\ O=Symantec\ Corporation,\ C=US"\ on\ Tue\ Sep\ 12\ 20:08:49\ UTC\ 2017
+\ \ \ \ Timestamp\ digest\ algorithm:\ SHA\-1
+\ \ \ \ Timestamp\ signature\ algorithm:\ SHA1withRSA,\ 2048\-bit\ key
+
+jar\ verified.
+
+The\ signer\ certificate\ expired\ on\ 2018\-02\-01.\ However,\ the\ JAR\ will\ be\ valid\ until\ the\ timestamp\ expires\ on\ 2020\-12\-29.
+\f[R]
+.fi
+.PP
+If the certificate for a signer isn\[aq]t an X.509 certificate, then
+there is no distinguished name information.
+In that case, just the certificate type and the alias are shown.
+For example, if the certificate is a PGP certificate, and the alias is
+\f[CB]bob\f[R], then you would get: \f[CB]PGP,\ (bob)\f[R].
diff --git a/java/temurin-17/man/man1/java.1 b/java/temurin-17/man/man1/java.1
new file mode 100644
index 0000000..e867e29
--- /dev/null
+++ b/java/temurin-17/man/man1/java.1
@@ -0,0 +1,5582 @@
+.\" Copyright (c) 1994, 2022, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"t
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JAVA" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+java \- launch a Java application
+.SH SYNOPSIS
+.PP
+To launch a class file:
+.PP
+\f[CB]java\f[R] [\f[I]options\f[R]] \f[I]mainclass\f[R] [\f[I]args\f[R] ...]
+.PP
+To launch the main class in a JAR file:
+.PP
+\f[CB]java\f[R] [\f[I]options\f[R]] \f[CB]\-jar\f[R] \f[I]jarfile\f[R]
+[\f[I]args\f[R] ...]
+.PP
+To launch the main class in a module:
+.PP
+\f[CB]java\f[R] [\f[I]options\f[R]] \f[CB]\-m\f[R]
+\f[I]module\f[R][\f[CB]/\f[R]\f[I]mainclass\f[R]] [\f[I]args\f[R] ...]
+.PP
+or
+.PP
+\f[CB]java\f[R] [\f[I]options\f[R]] \f[CB]\-\-module\f[R]
+\f[I]module\f[R][\f[CB]/\f[R]\f[I]mainclass\f[R]] [\f[I]args\f[R] ...]
+.PP
+To launch a single source\-file program:
+.PP
+\f[CB]java\f[R] [\f[I]options\f[R]] \f[I]source\-file\f[R] [\f[I]args\f[R]
+\&...]
+.TP
+.B \f[I]options\f[R]
+Optional: Specifies command\-line options separated by spaces.
+See \f[B]Overview of Java Options\f[R] for a description of available
+options.
+.RS
+.RE
+.TP
+.B \f[I]mainclass\f[R]
+Specifies the name of the class to be launched.
+Command\-line entries following \f[CB]classname\f[R] are the arguments for
+the main method.
+.RS
+.RE
+.TP
+.B \f[CB]\-jar\f[R] \f[I]jarfile\f[R]
+Executes a program encapsulated in a JAR file.
+The \f[I]jarfile\f[R] argument is the name of a JAR file with a manifest
+that contains a line in the form \f[CB]Main\-Class:\f[R]\f[I]classname\f[R]
+that defines the class with the
+\f[CB]public\ static\ void\ main(String[]\ args)\f[R] method that serves
+as your application\[aq]s starting point.
+When you use \f[CB]\-jar\f[R], the specified JAR file is the source of all
+user classes, and other class path settings are ignored.
+If you\[aq]re using JAR files, then see \f[B]jar\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-m\f[R] or \f[CB]\-\-module\f[R] \f[I]module\f[R][\f[CB]/\f[R]\f[I]mainclass\f[R]]
+Executes the main class in a module specified by \f[I]mainclass\f[R] if
+it is given, or, if it is not given, the value in the \f[I]module\f[R].
+In other words, \f[I]mainclass\f[R] can be used when it is not specified
+by the module, or to override the value when it is specified.
+.RS
+.PP
+See \f[B]Standard Options for Java\f[R].
+.RE
+.TP
+.B \f[I]source\-file\f[R]
+Only used to launch a single source\-file program.
+Specifies the source file that contains the main class when using
+source\-file mode.
+See \f[B]Using Source\-File Mode to Launch Single\-File Source\-Code
+Programs\f[R]
+.RS
+.RE
+.TP
+.B \f[I]args\f[R] ...
+Optional: Arguments following \f[I]mainclass\f[R], \f[I]source\-file\f[R],
+\f[CB]\-jar\f[R] \f[I]jarfile\f[R], and \f[CB]\-m\f[R] or \f[CB]\-\-module\f[R]
+\f[I]module\f[R]\f[CB]/\f[R]\f[I]mainclass\f[R] are passed as arguments to
+the main class.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]java\f[R] command starts a Java application.
+It does this by starting the Java Virtual Machine (JVM), loading the
+specified class, and calling that class\[aq]s \f[CB]main()\f[R] method.
+The method must be declared \f[CB]public\f[R] and \f[CB]static\f[R], it must
+not return any value, and it must accept a \f[CB]String\f[R] array as a
+parameter.
+The method declaration has the following form:
+.RS
+.PP
+\f[CB]public\ static\ void\ main(String[]\ args)\f[R]
+.RE
+.PP
+In source\-file mode, the \f[CB]java\f[R] command can launch a class
+declared in a source file.
+See \f[B]Using Source\-File Mode to Launch Single\-File Source\-Code
+Programs\f[R] for a description of using the source\-file mode.
+.RS
+.PP
+\f[B]Note:\f[R] You can use the \f[CB]JDK_JAVA_OPTIONS\f[R] launcher
+environment variable to prepend its content to the actual command line
+of the \f[CB]java\f[R] launcher.
+See \f[B]Using the JDK_JAVA_OPTIONS Launcher Environment Variable\f[R].
+.RE
+.PP
+By default, the first argument that isn\[aq]t an option of the
+\f[CB]java\f[R] command is the fully qualified name of the class to be
+called.
+If \f[CB]\-jar\f[R] is specified, then its argument is the name of the JAR
+file containing class and resource files for the application.
+The startup class must be indicated by the \f[CB]Main\-Class\f[R] manifest
+header in its manifest file.
+.PP
+Arguments after the class file name or the JAR file name are passed to
+the \f[CB]main()\f[R] method.
+.SS \f[CB]javaw\f[R]
+.PP
+\f[B]Windows:\f[R] The \f[CB]javaw\f[R] command is identical to
+\f[CB]java\f[R], except that with \f[CB]javaw\f[R] there\[aq]s no associated
+console window.
+Use \f[CB]javaw\f[R] when you don\[aq]t want a command prompt window to
+appear.
+The \f[CB]javaw\f[R] launcher will, however, display a dialog box with
+error information if a launch fails.
+.SH USING SOURCE\-FILE MODE TO LAUNCH SINGLE\-FILE SOURCE\-CODE PROGRAMS
+.PP
+To launch a class declared in a source file, run the \f[CB]java\f[R]
+launcher in source\-file mode.
+Entering source\-file mode is determined by two items on the
+\f[CB]java\f[R] command line:
+.IP \[bu] 2
+The first item on the command line that is not an option or part of an
+option.
+In other words, the item in the command line that would otherwise be the
+main class name.
+.IP \[bu] 2
+The \f[CB]\-\-source\f[R] \f[I]version\f[R] option, if present.
+.PP
+If the class identifies an existing file that has a \f[CB]\&.java\f[R]
+extension, or if the \f[CB]\-\-source\f[R] option is specified, then
+source\-file mode is selected.
+The source file is then compiled and run.
+The \f[CB]\-\-source\f[R] option can be used to specify the source
+\f[I]version\f[R] or \f[I]N\f[R] of the source code.
+This determines the API that can be used.
+When you set \f[CB]\-\-source\f[R] \f[I]N\f[R], you can only use the public
+API that was defined in JDK \f[I]N\f[R].
+.RS
+.PP
+\f[B]Note:\f[R] The valid values of \f[I]N\f[R] change for each release,
+with new values added and old values removed.
+You\[aq]ll get an error message if you use a value of \f[I]N\f[R] that is
+no longer supported.
+The supported values of \f[I]N\f[R] are the current Java SE release
+(\f[CB]17\f[R]) and a limited number of previous releases, detailed in the
+command\-line help for \f[CB]javac\f[R], under the \f[CB]\-\-source\f[R] and
+\f[CB]\-\-release\f[R] options.
+.RE
+.PP
+If the file does not have the \f[CB]\&.java\f[R] extension, the
+\f[CB]\-\-source\f[R] option must be used to tell the \f[CB]java\f[R]
+command to use the source\-file mode.
+The \f[CB]\-\-source\f[R] option is used for cases when the source file is
+a "script" to be executed and the name of the source file does not
+follow the normal naming conventions for Java source files.
+.PP
+In source\-file mode, the effect is as though the source file is
+compiled into memory, and the first class found in the source file is
+executed.
+Any arguments placed after the name of the source file in the original
+command line are passed to the compiled class when it is executed.
+.PP
+For example, if a file were named \f[CB]HelloWorld.java\f[R] and contained
+a class named \f[CB]hello.World\f[R], then the source\-file mode command
+to launch the class would be:
+.RS
+.PP
+\f[CB]java\ HelloWorld.java\f[R]
+.RE
+.PP
+The example illustrates that the class can be in a named package, and
+does not need to be in the unnamed package.
+This use of source\-file mode is informally equivalent to using the
+following two commands where \f[CB]hello.World\f[R] is the name of the
+class in the package:
+.IP
+.nf
+\f[CB]
+javac\ \-d\ <memory>\ HelloWorld.java
+java\ \-cp\ <memory>\ hello.World
+\f[R]
+.fi
+.PP
+\f[B]In source\-file mode, any additional command\-line options are
+processed as follows:\f[R]
+.IP \[bu] 2
+The launcher scans the options specified before the source file for any
+that are relevant in order to compile the source file.
+.RS 2
+.PP
+This includes: \f[CB]\-\-class\-path\f[R], \f[CB]\-\-module\-path\f[R],
+\f[CB]\-\-add\-exports\f[R], \f[CB]\-\-add\-modules\f[R],
+\f[CB]\-\-limit\-modules\f[R], \f[CB]\-\-patch\-module\f[R],
+\f[CB]\-\-upgrade\-module\-path\f[R], and any variant forms of those
+options.
+It also includes the new \f[CB]\-\-enable\-preview\f[R] option, described
+in JEP 12.
+.RE
+.IP \[bu] 2
+No provision is made to pass any additional options to the compiler,
+such as \f[CB]\-processor\f[R] or \f[CB]\-Werror\f[R].
+.IP \[bu] 2
+Command\-line argument files (\f[CB]\@\f[R]\-files) may be used in the
+standard way.
+Long lists of arguments for either the VM or the program being invoked
+may be placed in files specified on the command\-line by prefixing the
+filename with an \f[CB]\@\f[R] character.
+.PP
+\f[B]In source\-file mode, compilation proceeds as follows:\f[R]
+.IP \[bu] 2
+Any command\-line options that are relevant to the compilation
+environment are taken into account.
+.IP \[bu] 2
+No other source files are found and compiled, as if the source path is
+set to an empty value.
+.IP \[bu] 2
+Annotation processing is disabled, as if \f[CB]\-proc:none\f[R] is in
+effect.
+.IP \[bu] 2
+If a version is specified, via the \f[CB]\-\-source\f[R] option, the value
+is used as the argument for an implicit \f[CB]\-\-release\f[R] option for
+the compilation.
+This sets both the source version accepted by compiler and the system
+API that may be used by the code in the source file.
+.IP \[bu] 2
+The source file is compiled in the context of an unnamed module.
+.IP \[bu] 2
+The source file should contain one or more top\-level classes, the first
+of which is taken as the class to be executed.
+.IP \[bu] 2
+The compiler does not enforce the optional restriction defined at the
+end of JLS ??7.6, that a type in a named package should exist in a file
+whose name is composed from the type name followed by the
+\f[CB]\&.java\f[R] extension.
+.IP \[bu] 2
+If the source file contains errors, appropriate error messages are
+written to the standard error stream, and the launcher exits with a
+non\-zero exit code.
+.PP
+\f[B]In source\-file mode, execution proceeds as follows:\f[R]
+.IP \[bu] 2
+The class to be executed is the first top\-level class found in the
+source file.
+It must contain a declaration of the standard
+\f[CB]public\ static\ void\ main(String[])\f[R] method.
+.IP \[bu] 2
+The compiled classes are loaded by a custom class loader, that delegates
+to the application class loader.
+This implies that classes appearing on the application class path cannot
+refer to any classes declared in the source file.
+.IP \[bu] 2
+The compiled classes are executed in the context of an unnamed module,
+as though \f[CB]\-\-add\-modules=ALL\-DEFAULT\f[R] is in effect.
+This is in addition to any other \f[CB]\-\-add\-module\f[R] options that
+may be have been specified on the command line.
+.IP \[bu] 2
+Any arguments appearing after the name of the file on the command line
+are passed to the standard main method in the obvious way.
+.IP \[bu] 2
+It is an error if there is a class on the application class path whose
+name is the same as that of the class to be executed.
+.PP
+See \f[B]JEP 330: Launch Single\-File Source\-Code Programs\f[R]
+[http://openjdk.java.net/jeps/330] for complete details.
+.SH USING THE JDK_JAVA_OPTIONS LAUNCHER ENVIRONMENT VARIABLE
+.PP
+\f[CB]JDK_JAVA_OPTIONS\f[R] prepends its content to the options parsed
+from the command line.
+The content of the \f[CB]JDK_JAVA_OPTIONS\f[R] environment variable is a
+list of arguments separated by white\-space characters (as determined by
+\f[CB]isspace()\f[R]).
+These are prepended to the command line arguments passed to
+\f[CB]java\f[R] launcher.
+The encoding requirement for the environment variable is the same as the
+\f[CB]java\f[R] command line on the system.
+\f[CB]JDK_JAVA_OPTIONS\f[R] environment variable content is treated in the
+same manner as that specified in the command line.
+.PP
+Single (\f[CB]\[aq]\f[R]) or double (\f[CB]"\f[R]) quotes can be used to
+enclose arguments that contain whitespace characters.
+All content between the open quote and the first matching close quote
+are preserved by simply removing the pair of quotes.
+In case a matching quote is not found, the launcher will abort with an
+error message.
+\f[CB]\@\f[R]\-files are supported as they are specified in the command
+line.
+However, as in \f[CB]\@\f[R]\-files, use of a wildcard is not supported.
+In order to mitigate potential misuse of \f[CB]JDK_JAVA_OPTIONS\f[R]
+behavior, options that specify the main class (such as \f[CB]\-jar\f[R])
+or cause the \f[CB]java\f[R] launcher to exit without executing the main
+class (such as \f[CB]\-h\f[R]) are disallowed in the environment variable.
+If any of these options appear in the environment variable, the launcher
+will abort with an error message.
+When \f[CB]JDK_JAVA_OPTIONS\f[R] is set, the launcher prints a message to
+stderr as a reminder.
+.PP
+\f[B]Example:\f[R]
+.IP
+.nf
+\f[CB]
+$\ export\ JDK_JAVA_OPTIONS=\[aq]\-g\ \@file1\ \-Dprop=value\ \@file2\ \-Dws.prop="white\ spaces"\[aq]
+$\ java\ \-Xint\ \@file3
+\f[R]
+.fi
+.PP
+is equivalent to the command line:
+.IP
+.nf
+\f[CB]
+java\ \-g\ \@file1\ \-Dprop=value\ \@file2\ \-Dws.prop="white\ spaces"\ \-Xint\ \@file3
+\f[R]
+.fi
+.SH OVERVIEW OF JAVA OPTIONS
+.PP
+The \f[CB]java\f[R] command supports a wide range of options in the
+following categories:
+.IP \[bu] 2
+\f[B]Standard Options for Java\f[R]: Options guaranteed to be supported
+by all implementations of the Java Virtual Machine (JVM).
+They\[aq]re used for common actions, such as checking the version of the
+JRE, setting the class path, enabling verbose output, and so on.
+.IP \[bu] 2
+\f[B]Extra Options for Java\f[R]: General purpose options that are
+specific to the Java HotSpot Virtual Machine.
+They aren\[aq]t guaranteed to be supported by all JVM implementations,
+and are subject to change.
+These options start with \f[CB]\-X\f[R].
+.PP
+The advanced options aren\[aq]t recommended for casual use.
+These are developer options used for tuning specific areas of the Java
+HotSpot Virtual Machine operation that often have specific system
+requirements and may require privileged access to system configuration
+parameters.
+Several examples of performance tuning are provided in \f[B]Performance
+Tuning Examples\f[R].
+These options aren\[aq]t guaranteed to be supported by all JVM
+implementations and are subject to change.
+Advanced options start with \f[CB]\-XX\f[R].
+.IP \[bu] 2
+\f[B]Advanced Runtime Options for Java\f[R]: Control the runtime behavior
+of the Java HotSpot VM.
+.IP \[bu] 2
+\f[B]Advanced JIT Compiler Options for java\f[R]: Control the dynamic
+just\-in\-time (JIT) compilation performed by the Java HotSpot VM.
+.IP \[bu] 2
+\f[B]Advanced Serviceability Options for Java\f[R]: Enable gathering
+system information and performing extensive debugging.
+.IP \[bu] 2
+\f[B]Advanced Garbage Collection Options for Java\f[R]: Control how
+garbage collection (GC) is performed by the Java HotSpot
+.PP
+Boolean options are used to either enable a feature that\[aq]s disabled
+by default or disable a feature that\[aq]s enabled by default.
+Such options don\[aq]t require a parameter.
+Boolean \f[CB]\-XX\f[R] options are enabled using the plus sign
+(\f[CB]\-XX:+\f[R]\f[I]OptionName\f[R]) and disabled using the minus sign
+(\f[CB]\-XX:\-\f[R]\f[I]OptionName\f[R]).
+.PP
+For options that require an argument, the argument may be separated from
+the option name by a space, a colon (:), or an equal sign (=), or the
+argument may directly follow the option (the exact syntax differs for
+each option).
+If you\[aq]re expected to specify the size in bytes, then you can use no
+suffix, or use the suffix \f[CB]k\f[R] or \f[CB]K\f[R] for kilobytes (KB),
+\f[CB]m\f[R] or \f[CB]M\f[R] for megabytes (MB), or \f[CB]g\f[R] or \f[CB]G\f[R]
+for gigabytes (GB).
+For example, to set the size to 8 GB, you can specify either
+\f[CB]8g\f[R], \f[CB]8192m\f[R], \f[CB]8388608k\f[R], or \f[CB]8589934592\f[R]
+as the argument.
+If you are expected to specify the percentage, then use a number from 0
+to 1.
+For example, specify \f[CB]0.25\f[R] for 25%.
+.PP
+The following sections describe the options that are obsolete,
+deprecated, and removed:
+.IP \[bu] 2
+\f[B]Deprecated Java Options\f[R]: Accepted and acted upon \-\-\- a
+warning is issued when they\[aq]re used.
+.IP \[bu] 2
+\f[B]Obsolete Java Options\f[R]: Accepted but ignored \-\-\- a warning is
+issued when they\[aq]re used.
+.IP \[bu] 2
+\f[B]Removed Java Options\f[R]: Removed \-\-\- using them results in an
+error.
+.SH STANDARD OPTIONS FOR JAVA
+.PP
+These are the most commonly used options supported by all
+implementations of the JVM.
+.RS
+.PP
+\f[B]Note:\f[R] To specify an argument for a long option, you can use
+either \f[CB]\-\-\f[R]\f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R] or
+\f[CB]\-\-\f[R]\f[I]name\f[R] \f[I]value\f[R].
+.RE
+.TP
+.B \f[CB]\-agentlib:\f[R]\f[I]libname\f[R][\f[CB]=\f[R]\f[I]options\f[R]]
+Loads the specified native agent library.
+After the library name, a comma\-separated list of options specific to
+the library can be used.
+.RS
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] If the option \f[CB]\-agentlib:foo\f[R] is
+specified, then the JVM attempts to load the library named
+\f[CB]libfoo.so\f[R] in the location specified by the
+\f[CB]LD_LIBRARY_PATH\f[R] system variable (on macOS this variable is
+\f[CB]DYLD_LIBRARY_PATH\f[R]).
+.IP \[bu] 2
+\f[B]Windows:\f[R] If the option \f[CB]\-agentlib:foo\f[R] is specified,
+then the JVM attempts to load the library named \f[CB]foo.dll\f[R] in the
+location specified by the \f[CB]PATH\f[R] system variable.
+.RS 2
+.PP
+The following example shows how to load the Java Debug Wire Protocol
+(JDWP) library and listen for the socket connection on port 8000,
+suspending the JVM before the main class loads:
+.RS
+.PP
+\f[CB]\-agentlib:jdwp=transport=dt_socket,server=y,address=8000\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-agentpath:\f[R]\f[I]pathname\f[R][\f[CB]=\f[R]\f[I]options\f[R]]
+Loads the native agent library specified by the absolute path name.
+This option is equivalent to \f[CB]\-agentlib\f[R] but uses the full path
+and file name of the library.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]classpath\f[R], \f[CB]\-classpath\f[R] \f[I]classpath\f[R], or \f[CB]\-cp\f[R] \f[I]classpath\f[R]
+A semicolon (\f[CB];\f[R]) separated list of directories, JAR archives,
+and ZIP archives to search for class files.
+.RS
+.PP
+Specifying \f[I]classpath\f[R] overrides any setting of the
+\f[CB]CLASSPATH\f[R] environment variable.
+If the class path option isn\[aq]t used and \f[I]classpath\f[R] isn\[aq]t
+set, then the user class path consists of the current directory (.).
+.PP
+As a special convenience, a class path element that contains a base name
+of an asterisk (*) is considered equivalent to specifying a list of all
+the files in the directory with the extension \f[CB]\&.jar\f[R] or
+\f[CB]\&.JAR\f[R] .
+A Java program can\[aq]t tell the difference between the two
+invocations.
+For example, if the directory mydir contains \f[CB]a.jar\f[R] and
+\f[CB]b.JAR\f[R], then the class path element mydir/* is expanded to
+\f[CB]A.jar:b.JAR\f[R], except that the order of JAR files is unspecified.
+All \f[CB]\&.jar\f[R] files in the specified directory, even hidden ones,
+are included in the list.
+A class path entry consisting of an asterisk (*) expands to a list of
+all the jar files in the current directory.
+The \f[CB]CLASSPATH\f[R] environment variable, where defined, is similarly
+expanded.
+Any class path wildcard expansion that occurs before the Java VM is
+started.
+Java programs never see wildcards that aren\[aq]t expanded except by
+querying the environment, such as by calling
+\f[CB]System.getenv("CLASSPATH")\f[R].
+.RE
+.TP
+.B \f[CB]\-\-disable\-\@files\f[R]
+Can be used anywhere on the command line, including in an argument file,
+to prevent further \f[CB]\@filename\f[R] expansion.
+This option stops expanding \f[CB]\@\f[R]\-argfiles after the option.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-enable\-preview\f[R]
+Allows classes to depend on \f[B]preview features\f[R]
+[https://docs.oracle.com/en/java/javase/12/language/index.html#JSLAN\-GUID\-5A82FE0E\-0CA4\-4F1F\-B075\-564874FE2823]
+of the release.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]... or \f[CB]\-p\f[R] \f[I]modulepath\f[R]
+A semicolon (\f[CB];\f[R]) separated list of directories in which each
+directory is a directory of modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-upgrade\-module\-path\f[R] \f[I]modulepath\f[R]...
+A semicolon (\f[CB];\f[R]) separated list of directories in which each
+directory is a directory of modules that replace upgradeable modules in
+the runtime image.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+\f[I]module\f[R] also can be \f[CB]ALL\-DEFAULT\f[R], \f[CB]ALL\-SYSTEM\f[R],
+and \f[CB]ALL\-MODULE\-PATH\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\-modules\f[R]
+Lists the observable modules and then exits.
+.RS
+.RE
+.TP
+.B \f[CB]\-d\f[R] \f[I]module_name\f[R] or \f[CB]\-\-describe\-module\f[R] \f[I]module_name\f[R]
+Describes a specified module and then exits.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dry\-run\f[R]
+Creates the VM but doesn\[aq]t execute the main method.
+This \f[CB]\-\-dry\-run\f[R] option might be useful for validating the
+command\-line options such as the module system configuration.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-validate\-modules\f[R]
+Validates all modules and exit.
+This option is helpful for finding conflicts and other errors with
+modules on the module path.
+.RS
+.RE
+.TP
+.B \f[CB]\-D\f[R]\f[I]property\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Sets a system property value.
+The \f[I]property\f[R] variable is a string with no spaces that
+represents the name of the property.
+The \f[I]value\f[R] variable is a string that represents the value of the
+property.
+If \f[I]value\f[R] is a string with spaces, then enclose it in quotation
+marks (for example \f[CB]\-Dfoo="foo\ bar"\f[R]).
+.RS
+.RE
+.TP
+.B \f[CB]\-disableassertions\f[R][\f[CB]:\f[R][\f[I]packagename\f[R]]...|\f[CB]:\f[R]\f[I]classname\f[R]] or \f[CB]\-da\f[R][\f[CB]:\f[R][\f[I]packagename\f[R]]...|\f[CB]:\f[R]\f[I]classname\f[R]]
+Disables assertions.
+By default, assertions are disabled in all packages and classes.
+With no arguments, \f[CB]\-disableassertions\f[R] (\f[CB]\-da\f[R]) disables
+assertions in all packages and classes.
+With the \f[I]packagename\f[R] argument ending in \f[CB]\&...\f[R], the
+switch disables assertions in the specified package and any subpackages.
+If the argument is simply \f[CB]\&...\f[R], then the switch disables
+assertions in the unnamed package in the current working directory.
+With the \f[I]classname\f[R] argument, the switch disables assertions in
+the specified class.
+.RS
+.PP
+The \f[CB]\-disableassertions\f[R] (\f[CB]\-da\f[R]) option applies to all
+class loaders and to system classes (which don\[aq]t have a class
+loader).
+There\[aq]s one exception to this rule: If the option is provided with
+no arguments, then it doesn\[aq]t apply to system classes.
+This makes it easy to disable assertions in all classes except for
+system classes.
+The \f[CB]\-disablesystemassertions\f[R] option enables you to disable
+assertions in all system classes.
+To explicitly enable assertions in specific packages or classes, use the
+\f[CB]\-enableassertions\f[R] (\f[CB]\-ea\f[R]) option.
+Both options can be used at the same time.
+For example, to run the \f[CB]MyClass\f[R] application with assertions
+enabled in the package \f[CB]com.wombat.fruitbat\f[R] (and any
+subpackages) but disabled in the class
+\f[CB]com.wombat.fruitbat.Brickbat\f[R], use the following command:
+.RS
+.PP
+\f[CB]java\ \-ea:com.wombat.fruitbat...\ \-da:com.wombat.fruitbat.Brickbat\ MyClass\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-disablesystemassertions\f[R] or \f[CB]\-dsa\f[R]
+Disables assertions in all system classes.
+.RS
+.RE
+.TP
+.B \f[CB]\-enableassertions\f[R][\f[CB]:\f[R][\f[I]packagename\f[R]]...|\f[CB]:\f[R]\f[I]classname\f[R]] or \f[CB]\-ea\f[R][\f[CB]:\f[R][\f[I]packagename\f[R]]...|\f[CB]:\f[R]\f[I]classname\f[R]]
+Enables assertions.
+By default, assertions are disabled in all packages and classes.
+With no arguments, \f[CB]\-enableassertions\f[R] (\f[CB]\-ea\f[R]) enables
+assertions in all packages and classes.
+With the \f[I]packagename\f[R] argument ending in \f[CB]\&...\f[R], the
+switch enables assertions in the specified package and any subpackages.
+If the argument is simply \f[CB]\&...\f[R], then the switch enables
+assertions in the unnamed package in the current working directory.
+With the \f[I]classname\f[R] argument, the switch enables assertions in
+the specified class.
+.RS
+.PP
+The \f[CB]\-enableassertions\f[R] (\f[CB]\-ea\f[R]) option applies to all
+class loaders and to system classes (which don\[aq]t have a class
+loader).
+There\[aq]s one exception to this rule: If the option is provided with
+no arguments, then it doesn\[aq]t apply to system classes.
+This makes it easy to enable assertions in all classes except for system
+classes.
+The \f[CB]\-enablesystemassertions\f[R] option provides a separate switch
+to enable assertions in all system classes.
+To explicitly disable assertions in specific packages or classes, use
+the \f[CB]\-disableassertions\f[R] (\f[CB]\-da\f[R]) option.
+If a single command contains multiple instances of these switches, then
+they\[aq]re processed in order, before loading any classes.
+For example, to run the \f[CB]MyClass\f[R] application with assertions
+enabled only in the package \f[CB]com.wombat.fruitbat\f[R] (and any
+subpackages) but disabled in the class
+\f[CB]com.wombat.fruitbat.Brickbat\f[R], use the following command:
+.RS
+.PP
+\f[CB]java\ \-ea:com.wombat.fruitbat...\ \-da:com.wombat.fruitbat.Brickbat\ MyClass\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-enablesystemassertions\f[R] or \f[CB]\-esa\f[R]
+Enables assertions in all system classes.
+.RS
+.RE
+.TP
+.B \f[CB]\-help\f[R], \f[CB]\-h\f[R], or \f[CB]\-?\f[R]
+Prints the help message to the error stream.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\f[R]
+Prints the help message to the output stream.
+.RS
+.RE
+.TP
+.B \f[CB]\-javaagent:\f[R]\f[I]jarpath\f[R][\f[CB]=\f[R]\f[I]options\f[R]]
+Loads the specified Java programming language agent.
+See \f[CB]java.lang.instrument\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-version\f[R]
+Prints the product version to the output stream and continues.
+.RS
+.RE
+.TP
+.B \f[CB]\-showversion\f[R]
+Prints the product version to the error stream and continues.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-module\-resolution\f[R]
+Shows module resolution output during startup.
+.RS
+.RE
+.TP
+.B \f[CB]\-splash:\f[R]\f[I]imagepath\f[R]
+Shows the splash screen with the image specified by \f[I]imagepath\f[R].
+HiDPI scaled images are automatically supported and used if available.
+The unscaled image file name, such as \f[CB]image.ext\f[R], should always
+be passed as the argument to the \f[CB]\-splash\f[R] option.
+The most appropriate scaled image provided is picked up automatically.
+.RS
+.PP
+For example, to show the \f[CB]splash.gif\f[R] file from the
+\f[CB]images\f[R] directory when starting your application, use the
+following option:
+.RS
+.PP
+\f[CB]\-splash:images/splash.gif\f[R]
+.RE
+.PP
+See the SplashScreen API documentation for more information.
+.RE
+.TP
+.B \f[CB]\-verbose:class\f[R]
+Displays information about each loaded class.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose:gc\f[R]
+Displays information about each garbage collection (GC) event.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose:jni\f[R]
+Displays information about the use of native methods and other Java
+Native Interface (JNI) activity.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose:module\f[R]
+Displays information about the modules in use.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints product version to the output stream and exits.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R]
+Prints product version to the error stream and exits.
+.RS
+.RE
+.TP
+.B \f[CB]\-X\f[R]
+Prints the help on extra options to the error stream.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R]
+Prints the help on extra options to the output stream.
+.RS
+.RE
+.TP
+.B \f[CB]\@\f[R]\f[I]argfile\f[R]
+Specifies one or more argument files prefixed by \f[CB]\@\f[R] used by the
+\f[CB]java\f[R] command.
+It isn\[aq]t uncommon for the \f[CB]java\f[R] command line to be very long
+because of the \f[CB]\&.jar\f[R] files needed in the classpath.
+The \f[CB]\@\f[R]\f[I]argfile\f[R] option overcomes command\-line length
+limitations by enabling the launcher to expand the contents of argument
+files after shell expansion, but before argument processing.
+Contents in the argument files are expanded because otherwise, they
+would be specified on the command line until the
+\f[CB]\-\-disable\-\@files\f[R] option was encountered.
+.RS
+.PP
+The argument files can also contain the main class name and all options.
+If an argument file contains all of the options required by the
+\f[CB]java\f[R] command, then the command line could simply be:
+.RS
+.PP
+\f[CB]java\ \@\f[R]\f[I]argfile\f[R]
+.RE
+.PP
+See \f[B]java Command\-Line Argument Files\f[R] for a description and
+examples of using \f[CB]\@\f[R]\-argfiles.
+.RE
+.SH EXTRA OPTIONS FOR JAVA
+.PP
+The following \f[CB]java\f[R] options are general purpose options that are
+specific to the Java HotSpot Virtual Machine.
+.TP
+.B \f[CB]\-Xbatch\f[R]
+Disables background compilation.
+By default, the JVM compiles the method as a background task, running
+the method in interpreter mode until the background compilation is
+finished.
+The \f[CB]\-Xbatch\f[R] flag disables background compilation so that
+compilation of all methods proceeds as a foreground task until
+completed.
+This option is equivalent to \f[CB]\-XX:\-BackgroundCompilation\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-Xbootclasspath/a:\f[R]\f[I]directories\f[R]|\f[I]zip\f[R]|\f[I]JAR\-files\f[R]
+Specifies a list of directories, JAR files, and ZIP archives to append
+to the end of the default bootstrap class path.
+.RS
+.PP
+\f[B]Linux and macOS:\f[R] Colons (\f[CB]:\f[R]) separate entities in this
+list.
+.PP
+\f[B]Windows:\f[R] Semicolons (\f[CB];\f[R]) separate entities in this
+list.
+.RE
+.TP
+.B \f[CB]\-Xcheck:jni\f[R]
+Performs additional checks for Java Native Interface (JNI) functions.
+.RS
+.PP
+The following checks are considered indicative of significant problems
+with the native code, and the JVM terminates with an irrecoverable error
+in such cases:
+.IP \[bu] 2
+The thread doing the call is not attached to the JVM.
+.IP \[bu] 2
+The thread doing the call is using the \f[CB]JNIEnv\f[R] belonging to
+another thread.
+.IP \[bu] 2
+A parameter validation check fails:
+.RS 2
+.IP \[bu] 2
+A \f[CB]jfieldID\f[R], or \f[CB]jmethodID\f[R], is detected as being
+invalid.
+For example:
+.RS 2
+.IP \[bu] 2
+Of the wrong type
+.IP \[bu] 2
+Associated with the wrong class
+.RE
+.IP \[bu] 2
+A parameter of the wrong type is detected.
+.IP \[bu] 2
+An invalid parameter value is detected.
+For example:
+.RS 2
+.IP \[bu] 2
+NULL where not permitted
+.IP \[bu] 2
+An out\-of\-bounds array index, or frame capacity
+.IP \[bu] 2
+A non\-UTF\-8 string
+.IP \[bu] 2
+An invalid JNI reference
+.IP \[bu] 2
+An attempt to use a \f[CB]ReleaseXXX\f[R] function on a parameter not
+produced by the corresponding \f[CB]GetXXX\f[R] function
+.RE
+.RE
+.PP
+The following checks only result in warnings being printed:
+.IP \[bu] 2
+A JNI call was made without checking for a pending exception from a
+previous JNI call, and the current call is not safe when an exception
+may be pending.
+.IP \[bu] 2
+The number of JNI local references existing when a JNI function
+terminates exceeds the number guaranteed to be available.
+See the \f[CB]EnsureLocalcapacity\f[R] function.
+.IP \[bu] 2
+A class descriptor is in decorated format (\f[CB]Lname;\f[R]) when it
+should not be.
+.IP \[bu] 2
+A \f[CB]NULL\f[R] parameter is allowed, but its use is questionable.
+.IP \[bu] 2
+Calling other JNI functions in the scope of
+\f[CB]Get/ReleasePrimitiveArrayCritical\f[R] or
+\f[CB]Get/ReleaseStringCritical\f[R]
+.PP
+Expect a performance degradation when this option is used.
+.RE
+.TP
+.B \f[CB]\-Xdebug\f[R]
+Does nothing.
+Provided for backward compatibility.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdiag\f[R]
+Shows additional diagnostic messages.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xint\f[R]
+Runs the application in interpreted\-only mode.
+Compilation to native code is disabled, and all bytecode is executed by
+the interpreter.
+The performance benefits offered by the just\-in\-time (JIT) compiler
+aren\[aq]t present in this mode.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xinternalversion\f[R]
+Displays more detailed JVM version information than the
+\f[CB]\-version\f[R] option, and then exits.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:\f[R]\f[I]option\f[R]
+Configure or enable logging with the Java Virtual Machine (JVM) unified
+logging framework.
+See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-Xmixed\f[R]
+Executes all bytecode by the interpreter except for hot methods, which
+are compiled to native code.
+On by default.
+Use \f[CB]\-Xint\f[R] to switch off.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xmn\f[R] \f[I]size\f[R]
+Sets the initial and maximum size (in bytes) of the heap for the young
+generation (nursery) in the generational collectors.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The young generation region of the heap is used for new objects.
+GC is performed in this region more often than in other regions.
+If the size for the young generation is too small, then a lot of minor
+garbage collections are performed.
+If the size is too large, then only full garbage collections are
+performed, which can take a long time to complete.
+It is recommended that you do not set the size for the young generation
+for the G1 collector, and keep the size for the young generation greater
+than 25% and less than 50% of the overall heap size for other
+collectors.
+The following examples show how to set the initial and maximum size of
+young generation to 256 MB using various units:
+.RS
+.IP
+.nf
+\f[CB]
+\-Xmn256m
+\-Xmn262144k
+\-Xmn268435456
+\f[R]
+.fi
+.PP
+Instead of the \f[CB]\-Xmn\f[R] option to set both the initial and maximum
+size of the heap for the young generation, you can use
+\f[CB]\-XX:NewSize\f[R] to set the initial size and
+\f[CB]\-XX:MaxNewSize\f[R] to set the maximum size.
+.RE
+.TP
+.B \f[CB]\-Xms\f[R] \f[I]size\f[R]
+Sets the minimum and initial size (in bytes) of the heap.
+This value must be a multiple of 1024 and greater than 1 MB.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, \f[CB]g\f[R] or \f[CB]G\f[R]
+to indicate gigabytes.
+The following examples show how to set the size of allocated memory to 6
+MB using various units:
+.RS
+.IP
+.nf
+\f[CB]
+\-Xms6291456
+\-Xms6144k
+\-Xms6m
+\f[R]
+.fi
+.PP
+Instead of the \f[CB]\-Xms\f[R] option to set both the minimum and initial
+size of the heap, you can use \f[CB]\-XX:MinHeapSize\f[R] to set the
+minimum size and \f[CB]\-XX:InitialHeapSize\f[R] to set the initial size.
+.PP
+If you don\[aq]t set this option, the initial size is set as the sum of
+the sizes allocated for the old generation and the young generation.
+The initial size of the heap for the young generation can be set using
+the \f[CB]\-Xmn\f[R] option or the \f[CB]\-XX:NewSize\f[R] option.
+.RE
+.TP
+.B \f[CB]\-Xmx\f[R] \f[I]size\f[R]
+Specifies the maximum size (in bytes) of the heap.
+This value must be a multiple of 1024 and greater than 2 MB.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default value is chosen at runtime based on system configuration.
+For server deployments, \f[CB]\-Xms\f[R] and \f[CB]\-Xmx\f[R] are often set
+to the same value.
+The following examples show how to set the maximum allowed size of
+allocated memory to 80 MB using various units:
+.RS
+.IP
+.nf
+\f[CB]
+\-Xmx83886080
+\-Xmx81920k
+\-Xmx80m
+\f[R]
+.fi
+.PP
+The \f[CB]\-Xmx\f[R] option is equivalent to \f[CB]\-XX:MaxHeapSize\f[R].
+.RE
+.TP
+.B \f[CB]\-Xnoclassgc\f[R]
+Disables garbage collection (GC) of classes.
+This can save some GC time, which shortens interruptions during the
+application run.
+When you specify \f[CB]\-Xnoclassgc\f[R] at startup, the class objects in
+the application are left untouched during GC and are always be
+considered live.
+This can result in more memory being permanently occupied which, if not
+used carefully, throws an out\-of\-memory exception.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xrs\f[R]
+Reduces the use of operating system signals by the JVM.
+Shutdown hooks enable the orderly shutdown of a Java application by
+running user cleanup code (such as closing database connections) at
+shutdown, even if the JVM terminates abruptly.
+.RS
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R]
+.RS 2
+.IP \[bu] 2
+The JVM catches signals to implement shutdown hooks for unexpected
+termination.
+The JVM uses \f[CB]SIGHUP\f[R], \f[CB]SIGINT\f[R], and \f[CB]SIGTERM\f[R] to
+initiate the running of shutdown hooks.
+.IP \[bu] 2
+Applications embedding the JVM frequently need to trap signals such as
+\f[CB]SIGINT\f[R] or \f[CB]SIGTERM\f[R], which can lead to interference with
+the JVM signal handlers.
+The \f[CB]\-Xrs\f[R] option is available to address this issue.
+When \f[CB]\-Xrs\f[R] is used, the signal masks for \f[CB]SIGINT\f[R],
+\f[CB]SIGTERM\f[R], \f[CB]SIGHUP\f[R], and \f[CB]SIGQUIT\f[R] aren\[aq]t
+changed by the JVM, and signal handlers for these signals aren\[aq]t
+installed.
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.IP \[bu] 2
+The JVM watches for console control events to implement shutdown hooks
+for unexpected termination.
+Specifically, the JVM registers a console control handler that begins
+shutdown\-hook processing and returns \f[CB]TRUE\f[R] for
+\f[CB]CTRL_C_EVENT\f[R], \f[CB]CTRL_CLOSE_EVENT\f[R],
+\f[CB]CTRL_LOGOFF_EVENT\f[R], and \f[CB]CTRL_SHUTDOWN_EVENT\f[R].
+.IP \[bu] 2
+The JVM uses a similar mechanism to implement the feature of dumping
+thread stacks for debugging purposes.
+The JVM uses \f[CB]CTRL_BREAK_EVENT\f[R] to perform thread dumps.
+.IP \[bu] 2
+If the JVM is run as a service (for example, as a servlet engine for a
+web server), then it can receive \f[CB]CTRL_LOGOFF_EVENT\f[R] but
+shouldn\[aq]t initiate shutdown because the operating system doesn\[aq]t
+actually terminate the process.
+To avoid possible interference such as this, the \f[CB]\-Xrs\f[R] option
+can be used.
+When the \f[CB]\-Xrs\f[R] option is used, the JVM doesn\[aq]t install a
+console control handler, implying that it doesn\[aq]t watch for or
+process \f[CB]CTRL_C_EVENT\f[R], \f[CB]CTRL_CLOSE_EVENT\f[R],
+\f[CB]CTRL_LOGOFF_EVENT\f[R], or \f[CB]CTRL_SHUTDOWN_EVENT\f[R].
+.RE
+.PP
+There are two consequences of specifying \f[CB]\-Xrs\f[R]:
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] \f[CB]SIGQUIT\f[R] thread dumps aren\[aq]t
+available.
+.IP \[bu] 2
+\f[B]Windows:\f[R] Ctrl + Break thread dumps aren\[aq]t available.
+.PP
+User code is responsible for causing shutdown hooks to run, for example,
+by calling the \f[CB]System.exit()\f[R] when the JVM is to be terminated.
+.RE
+.TP
+.B \f[CB]\-Xshare:\f[R]\f[I]mode\f[R]
+Sets the class data sharing (CDS) mode.
+.RS
+.PP
+Possible \f[I]mode\f[R] arguments for this option include the following:
+.TP
+.B \f[CB]auto\f[R]
+Use shared class data if possible (default).
+.RS
+.RE
+.TP
+.B \f[CB]on\f[R]
+Require using shared class data, otherwise fail.
+.RS
+.RE
+.RS
+.PP
+\f[B]Note:\f[R] The \f[CB]\-Xshare:on\f[R] option is used for testing
+purposes only.
+It may cause the VM to unexpectedly exit during start\-up when the CDS
+archive cannot be used (for example, when certain VM parameters are
+changed, or when a different JDK is used).
+This option should not be used in production environments.
+.RE
+.TP
+.B \f[CB]off\f[R]
+Do not attempt to use shared class data.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]\-XshowSettings\f[R]
+Shows all settings and then continues.
+.RS
+.RE
+.TP
+.B \f[CB]\-XshowSettings:\f[R]\f[I]category\f[R]
+Shows settings and continues.
+Possible \f[I]category\f[R] arguments for this option include the
+following:
+.RS
+.TP
+.B \f[CB]all\f[R]
+Shows all categories of settings.
+This is the default value.
+.RS
+.RE
+.TP
+.B \f[CB]locale\f[R]
+Shows settings related to locale.
+.RS
+.RE
+.TP
+.B \f[CB]properties\f[R]
+Shows settings related to system properties.
+.RS
+.RE
+.TP
+.B \f[CB]vm\f[R]
+Shows the settings of the JVM.
+.RS
+.RE
+.TP
+.B \f[CB]system\f[R]
+\f[B]Linux:\f[R] Shows host system or container configuration and
+continues.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]\-Xss\f[R] \f[I]size\f[R]
+Sets the thread stack size (in bytes).
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate KB, \f[CB]m\f[R] or
+\f[CB]M\f[R] to indicate MB, or \f[CB]g\f[R] or \f[CB]G\f[R] to indicate GB.
+The default value depends on the platform:
+.RS
+.IP \[bu] 2
+Linux/x64 (64\-bit): 1024 KB
+.IP \[bu] 2
+macOS (64\-bit): 1024 KB
+.IP \[bu] 2
+Windows: The default value depends on virtual memory
+.PP
+The following examples set the thread stack size to 1024 KB in different
+units:
+.IP
+.nf
+\f[CB]
+\-Xss1m
+\-Xss1024k
+\-Xss1048576
+\f[R]
+.fi
+.PP
+This option is similar to \f[CB]\-XX:ThreadStackSize\f[R].
+.RE
+.TP
+.B \f[CB]\-\-add\-reads\f[R] \f[I]module\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R](\f[CB],\f[R]\f[I]target\-module\f[R])*
+Updates \f[I]module\f[R] to read the \f[I]target\-module\f[R], regardless
+of the module declaration.
+\f[I]target\-module\f[R] can be all unnamed to read all unnamed modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R](\f[CB],\f[R]\f[I]target\-module\f[R])*
+Updates \f[I]module\f[R] to export \f[I]package\f[R] to
+\f[I]target\-module\f[R], regardless of module declaration.
+The \f[I]target\-module\f[R] can be all unnamed to export to all unnamed
+modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-opens\f[R] \f[I]module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R](\f[CB],\f[R]\f[I]target\-module\f[R])*
+Updates \f[I]module\f[R] to open \f[I]package\f[R] to
+\f[I]target\-module\f[R], regardless of module declaration.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-limit\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the limit of the universe of observable modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-patch\-module\f[R] \f[I]module\f[R]\f[CB]=\f[R]\f[I]file\f[R](\f[CB];\f[R]\f[I]file\f[R])*
+Overrides or augments a module with classes and resources in JAR files
+or directories.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-source\f[R] \f[I]version\f[R]
+Sets the version of the source in source\-file mode.
+.RS
+.RE
+.SH EXTRA OPTIONS FOR MACOS
+.PP
+The following extra options are macOS specific.
+.TP
+.B \f[CB]\-XstartOnFirstThread\f[R]
+Runs the \f[CB]main()\f[R] method on the first (AppKit) thread.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdock:name=\f[R]\f[I]application_name\f[R]
+Overrides the default application name displayed in dock.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdock:icon=\f[R]\f[I]path_to_icon_file\f[R]
+Overrides the default icon displayed in dock.
+.RS
+.RE
+.SH ADVANCED OPTIONS FOR JAVA
+.PP
+These \f[CB]java\f[R] options can be used to enable other advanced
+options.
+.TP
+.B \f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R]
+Unlocks the options intended for diagnosing the JVM.
+By default, this option is disabled and diagnostic options aren\[aq]t
+available.
+.RS
+.PP
+Command line options that are enabled with the use of this option are
+not supported.
+If you encounter issues while using any of these options, it is very
+likely that you will be required to reproduce the problem without using
+any of these unsupported options before Oracle Support can assist with
+an investigation.
+It is also possible that any of these options may be removed or their
+behavior changed without any warning.
+.RE
+.TP
+.B \f[CB]\-XX:+UnlockExperimentalVMOptions\f[R]
+Unlocks the options that provide experimental features in the JVM.
+By default, this option is disabled and experimental features aren\[aq]t
+available.
+.RS
+.RE
+.SH ADVANCED RUNTIME OPTIONS FOR JAVA
+.PP
+These \f[CB]java\f[R] options control the runtime behavior of the Java
+HotSpot VM.
+.TP
+.B \f[CB]\-XX:ActiveProcessorCount=\f[R]\f[I]x\f[R]
+Overrides the number of CPUs that the VM will use to calculate the size
+of thread pools it will use for various operations such as Garbage
+Collection and ForkJoinPool.
+.RS
+.PP
+The VM normally determines the number of available processors from the
+operating system.
+This flag can be useful for partitioning CPU resources when running
+multiple Java processes in docker containers.
+This flag is honored even if \f[CB]UseContainerSupport\f[R] is not
+enabled.
+See \f[CB]\-XX:\-UseContainerSupport\f[R] for a description of enabling
+and disabling container support.
+.RE
+.TP
+.B \f[CB]\-XX:AllocateHeapAt=\f[R]\f[I]path\f[R]
+Takes a path to the file system and uses memory mapping to allocate the
+object heap on the memory device.
+Using this option enables the HotSpot VM to allocate the Java object
+heap on an alternative memory device, such as an NV\-DIMM, specified by
+the user.
+.RS
+.PP
+Alternative memory devices that have the same semantics as DRAM,
+including the semantics of atomic operations, can be used instead of
+DRAM for the object heap without changing the existing application code.
+All other memory structures (such as the code heap, metaspace, and
+thread stacks) continue to reside in DRAM.
+.PP
+Some operating systems expose non\-DRAM memory through the file system.
+Memory\-mapped files in these file systems bypass the page cache and
+provide a direct mapping of virtual memory to the physical memory on the
+device.
+The existing heap related flags (such as \f[CB]\-Xmx\f[R] and
+\f[CB]\-Xms\f[R]) and garbage\-collection related flags continue to work
+as before.
+.RE
+.TP
+.B \f[CB]\-XX:\-CompactStrings\f[R]
+Disables the Compact Strings feature.
+By default, this option is enabled.
+When this option is enabled, Java Strings containing only single\-byte
+characters are internally represented and stored as
+single\-byte\-per\-character Strings using ISO\-8859\-1 / Latin\-1
+encoding.
+This reduces, by 50%, the amount of space required for Strings
+containing only single\-byte characters.
+For Java Strings containing at least one multibyte character: these are
+represented and stored as 2 bytes per character using UTF\-16 encoding.
+Disabling the Compact Strings feature forces the use of UTF\-16 encoding
+as the internal representation for all Java Strings.
+.RS
+.PP
+Cases where it may be beneficial to disable Compact Strings include the
+following:
+.IP \[bu] 2
+When it\[aq]s known that an application overwhelmingly will be
+allocating multibyte character Strings
+.IP \[bu] 2
+In the unexpected event where a performance regression is observed in
+migrating from Java SE 8 to Java SE 9 and an analysis shows that Compact
+Strings introduces the regression
+.PP
+In both of these scenarios, disabling Compact Strings makes sense.
+.RE
+.TP
+.B \f[CB]\-XX:ErrorFile=\f[R]\f[I]filename\f[R]
+Specifies the path and file name to which error data is written when an
+irrecoverable error occurs.
+By default, this file is created in the current working directory and
+named \f[CB]hs_err_pid\f[R]\f[I]pid\f[R]\f[CB]\&.log\f[R] where \f[I]pid\f[R]
+is the identifier of the process that encountered the error.
+.RS
+.PP
+The following example shows how to set the default log file (note that
+the identifier of the process is specified as \f[CB]%p\f[R]):
+.RS
+.PP
+\f[CB]\-XX:ErrorFile=./hs_err_pid%p.log\f[R]
+.RE
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] The following example shows how to set the
+error log to \f[CB]/var/log/java/java_error.log\f[R]:
+.RS 2
+.RS
+.PP
+\f[CB]\-XX:ErrorFile=/var/log/java/java_error.log\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R] The following example shows how to set the error log
+file to \f[CB]C:/log/java/java_error.log\f[R]:
+.RS 2
+.RS
+.PP
+\f[CB]\-XX:ErrorFile=C:/log/java/java_error.log\f[R]
+.RE
+.RE
+.PP
+If the file exists, and is writeable, then it will be overwritten.
+Otherwise, if the file can\[aq]t be created in the specified directory
+(due to insufficient space, permission problem, or another issue), then
+the file is created in the temporary directory for the operating system:
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] The temporary directory is \f[CB]/tmp\f[R].
+.IP \[bu] 2
+\f[B]Windows:\f[R] The temporary directory is specified by the value of
+the \f[CB]TMP\f[R] environment variable; if that environment variable
+isn\[aq]t defined, then the value of the \f[CB]TEMP\f[R] environment
+variable is used.
+.RE
+.TP
+.B \f[CB]\-XX:+ExtensiveErrorReports\f[R]
+Enables the reporting of more extensive error information in the
+\f[CB]ErrorFile\f[R].
+This option can be turned on in environments where maximal information
+is desired \- even if the resulting logs may be quite large and/or
+contain information that might be considered sensitive.
+The information can vary from release to release, and across different
+platforms.
+By default this option is disabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:FlightRecorderOptions=\f[R]\f[I]parameter\f[R]\f[CB]=\f[R]\f[I]value\f[R] (or)\f[CB]\-XX:FlightRecorderOptions:\f[R]\f[I]parameter\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Sets the parameters that control the behavior of JFR.
+.RS
+.PP
+The following list contains the available JFR
+\f[I]parameter\f[R]\f[CB]=\f[R]\f[I]value\f[R] entries:
+.TP
+.B \f[CB]globalbuffersize=\f[R]\f[I]size\f[R]
+Specifies the total amount of primary memory used for data retention.
+The default value is based on the value specified for
+\f[CB]memorysize\f[R].
+Change the \f[CB]memorysize\f[R] parameter to alter the size of global
+buffers.
+.RS
+.RE
+.TP
+.B \f[CB]maxchunksize=\f[R]\f[I]size\f[R]
+Specifies the maximum size (in bytes) of the data chunks in a recording.
+Append \f[CB]m\f[R] or \f[CB]M\f[R] to specify the size in megabytes (MB),
+or \f[CB]g\f[R] or \f[CB]G\f[R] to specify the size in gigabytes (GB).
+By default, the maximum size of data chunks is set to 12 MB.
+The minimum allowed is 1 MB.
+.RS
+.RE
+.TP
+.B \f[CB]memorysize=\f[R]\f[I]size\f[R]
+Determines how much buffer memory should be used, and sets the
+\f[CB]globalbuffersize\f[R] and \f[CB]numglobalbuffers\f[R] parameters based
+on the size specified.
+Append \f[CB]m\f[R] or \f[CB]M\f[R] to specify the size in megabytes (MB),
+or \f[CB]g\f[R] or \f[CB]G\f[R] to specify the size in gigabytes (GB).
+By default, the memory size is set to 10 MB.
+.RS
+.RE
+.TP
+.B \f[CB]numglobalbuffers\f[R]
+Specifies the number of global buffers used.
+The default value is based on the memory size specified.
+Change the \f[CB]memorysize\f[R] parameter to alter the number of global
+buffers.
+.RS
+.RE
+.TP
+.B \f[CB]old\-object\-queue\-size=number\-of\-objects\f[R]
+Maximum number of old objects to track.
+By default, the number of objects is set to 256.
+.RS
+.RE
+.TP
+.B \f[CB]repository=\f[R]\f[I]path\f[R]
+Specifies the repository (a directory) for temporary disk storage.
+By default, the system\[aq]s temporary directory is used.
+.RS
+.RE
+.TP
+.B \f[CB]retransform=\f[R]{\f[CB]true\f[R]|\f[CB]false\f[R]}
+Specifies whether event classes should be retransformed using JVMTI.
+If false, instrumentation is added when event classes are loaded.
+By default, this parameter is enabled.
+.RS
+.RE
+.TP
+.B \f[CB]samplethreads=\f[R]{\f[CB]true\f[R]|\f[CB]false\f[R]}
+Specifies whether thread sampling is enabled.
+Thread sampling occurs only if the sampling event is enabled along with
+this parameter.
+By default, this parameter is enabled.
+.RS
+.RE
+.TP
+.B \f[CB]stackdepth=\f[R]\f[I]depth\f[R]
+Stack depth for stack traces.
+By default, the depth is set to 64 method calls.
+The maximum is 2048.
+Values greater than 64 could create significant overhead and reduce
+performance.
+.RS
+.RE
+.TP
+.B \f[CB]threadbuffersize=\f[R]\f[I]size\f[R]
+Specifies the per\-thread local buffer size (in bytes).
+By default, the local buffer size is set to 8 kilobytes, with a minimum
+value of 4 kilobytes.
+Overriding this parameter could reduce performance and is not
+recommended.
+.RS
+.RE
+.PP
+You can specify values for multiple parameters by separating them with a
+comma.
+.RE
+.TP
+.B \f[CB]\-XX:LargePageSizeInBytes=\f[R]\f[I]size\f[R]
+Sets the maximum large page size (in bytes) used by the JVM.
+The \f[I]size\f[R] argument must be a valid page size supported by the
+environment to have any effect.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+By default, the size is set to 0, meaning that the JVM will use the
+default large page size for the environment as the maximum size for
+large pages.
+See \f[B]Large Pages\f[R].
+.RS
+.PP
+The following example describes how to set the large page size to 1
+gigabyte (GB):
+.RS
+.PP
+\f[CB]\-XX:LargePageSizeInBytes=1g\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxDirectMemorySize=\f[R]\f[I]size\f[R]
+Sets the maximum total size (in bytes) of the \f[CB]java.nio\f[R] package,
+direct\-buffer allocations.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+By default, the size is set to 0, meaning that the JVM chooses the size
+for NIO direct\-buffer allocations automatically.
+.RS
+.PP
+The following examples illustrate how to set the NIO size to 1024 KB in
+different units:
+.IP
+.nf
+\f[CB]
+\-XX:MaxDirectMemorySize=1m
+\-XX:MaxDirectMemorySize=1024k
+\-XX:MaxDirectMemorySize=1048576
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]\-XX:\-MaxFDLimit\f[R]
+Disables the attempt to set the soft limit for the number of open file
+descriptors to the hard limit.
+By default, this option is enabled on all platforms, but is ignored on
+Windows.
+The only time that you may need to disable this is on Mac OS, where its
+use imposes a maximum of 10240, which is lower than the actual system
+maximum.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:NativeMemoryTracking=\f[R]\f[I]mode\f[R]
+Specifies the mode for tracking JVM native memory usage.
+Possible \f[I]mode\f[R] arguments for this option include the following:
+.RS
+.TP
+.B \f[CB]off\f[R]
+Instructs not to track JVM native memory usage.
+This is the default behavior if you don\[aq]t specify the
+\f[CB]\-XX:NativeMemoryTracking\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]summary\f[R]
+Tracks memory usage only by JVM subsystems, such as Java heap, class,
+code, and thread.
+.RS
+.RE
+.TP
+.B \f[CB]detail\f[R]
+In addition to tracking memory usage by JVM subsystems, track memory
+usage by individual \f[CB]CallSite\f[R], individual virtual memory region
+and its committed regions.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:ObjectAlignmentInBytes=\f[R]\f[I]alignment\f[R]
+Sets the memory alignment of Java objects (in bytes).
+By default, the value is set to 8 bytes.
+The specified value should be a power of 2, and must be within the range
+of 8 and 256 (inclusive).
+This option makes it possible to use compressed pointers with large Java
+heap sizes.
+.RS
+.PP
+The heap size limit in bytes is calculated as:
+.RS
+.PP
+\f[CB]4GB\ *\ ObjectAlignmentInBytes\f[R]
+.RE
+.RS
+.PP
+\f[B]Note:\f[R] As the alignment value increases, the unused space
+between objects also increases.
+As a result, you may not realize any benefits from using compressed
+pointers with large Java heap sizes.
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:OnError=\f[R]\f[I]string\f[R]
+Sets a custom command or a series of semicolon\-separated commands to
+run when an irrecoverable error occurs.
+If the string contains spaces, then it must be enclosed in quotation
+marks.
+.RS
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] The following example shows how the
+\f[CB]\-XX:OnError\f[R] option can be used to run the \f[CB]gcore\f[R]
+command to create a core image, and start the \f[CB]gdb\f[R] debugger to
+attach to the process in case of an irrecoverable error (the \f[CB]%p\f[R]
+designates the current process identifier):
+.RS 2
+.RS
+.PP
+\f[CB]\-XX:OnError="gcore\ %p;gdb\ \-p\ %p"\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R] The following example shows how the
+\f[CB]\-XX:OnError\f[R] option can be used to run the
+\f[CB]userdump.exe\f[R] utility to obtain a crash dump in case of an
+irrecoverable error (the \f[CB]%p\f[R] designates the current process
+identifier).
+This example assumes that the path to the \f[CB]userdump.exe\f[R] utility
+is specified in the \f[CB]PATH\f[R] environment variable:
+.RS 2
+.RS
+.PP
+\f[CB]\-XX:OnError="userdump.exe\ %p"\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:OnOutOfMemoryError=\f[R]\f[I]string\f[R]
+Sets a custom command or a series of semicolon\-separated commands to
+run when an \f[CB]OutOfMemoryError\f[R] exception is first thrown.
+If the string contains spaces, then it must be enclosed in quotation
+marks.
+For an example of a command string, see the description of the
+\f[CB]\-XX:OnError\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+PrintCommandLineFlags\f[R]
+Enables printing of ergonomically selected JVM flags that appeared on
+the command line.
+It can be useful to know the ergonomic values set by the JVM, such as
+the heap space size and the selected garbage collector.
+By default, this option is disabled and flags aren\[aq]t printed.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+PreserveFramePointer\f[R]
+Selects between using the RBP register as a general purpose register
+(\f[CB]\-XX:\-PreserveFramePointer\f[R]) and using the RBP register to
+hold the frame pointer of the currently executing method
+(\f[CB]\-XX:+PreserveFramePointer\f[R] .
+If the frame pointer is available, then external profiling tools (for
+example, Linux perf) can construct more accurate stack traces.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+PrintNMTStatistics\f[R]
+Enables printing of collected native memory tracking data at JVM exit
+when native memory tracking is enabled (see
+\f[CB]\-XX:NativeMemoryTracking\f[R]).
+By default, this option is disabled and native memory tracking data
+isn\[aq]t printed.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:SharedArchiveFile=\f[R]\f[I]path\f[R]
+Specifies the path and name of the class data sharing (CDS) archive file
+.RS
+.PP
+See \f[B]Application Class Data Sharing\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:SharedArchiveConfigFile\f[R]=\f[I]shared_config_file\f[R]
+Specifies additional shared data added to the archive file.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:SharedClassListFile=\f[R]\f[I]file_name\f[R]
+Specifies the text file that contains the names of the classes to store
+in the class data sharing (CDS) archive.
+This file contains the full name of one class per line, except slashes
+(\f[CB]/\f[R]) replace dots (\f[CB]\&.\f[R]).
+For example, to specify the classes \f[CB]java.lang.Object\f[R] and
+\f[CB]hello.Main\f[R], create a text file that contains the following two
+lines:
+.RS
+.IP
+.nf
+\f[CB]
+java/lang/Object
+hello/Main
+\f[R]
+.fi
+.PP
+The classes that you specify in this text file should include the
+classes that are commonly used by the application.
+They may include any classes from the application, extension, or
+bootstrap class paths.
+.PP
+See \f[B]Application Class Data Sharing\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:+ShowCodeDetailsInExceptionMessages\f[R]
+Enables printing of improved \f[CB]NullPointerException\f[R] messages.
+When an application throws a \f[CB]NullPointerException\f[R], the option
+enables the JVM to analyze the program\[aq]s bytecode instructions to
+determine precisely which reference is \f[CB]null\f[R], and describes the
+source with a null\-detail message.
+The null\-detail message is calculated and returned by
+\f[CB]NullPointerException.getMessage()\f[R], and will be printed as the
+exception message along with the method, filename, and line number.
+By default, this option is enabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+ShowMessageBoxOnError\f[R]
+Enables the display of a dialog box when the JVM experiences an
+irrecoverable error.
+This prevents the JVM from exiting and keeps the process active so that
+you can attach a debugger to it to investigate the cause of the error.
+By default, this option is disabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:StartFlightRecording=\f[R]\f[I]parameter\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Starts a JFR recording for the Java application.
+This option is equivalent to the \f[CB]JFR.start\f[R] diagnostic command
+that starts a recording during runtime.
+You can set the following \f[I]parameter\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+entries when starting a JFR recording:
+.RS
+.TP
+.B \f[CB]delay=\f[R]\f[I]time\f[R]
+Specifies the delay between the Java application launch time and the
+start of the recording.
+Append \f[CB]s\f[R] to specify the time in seconds, \f[CB]m\f[R] for
+minutes, \f[CB]h\f[R] for hours, or \f[CB]d\f[R] for days (for example,
+specifying \f[CB]10m\f[R] means 10 minutes).
+By default, there\[aq]s no delay, and this parameter is set to 0.
+.RS
+.RE
+.TP
+.B \f[CB]disk=\f[R]{\f[CB]true\f[R]|\f[CB]false\f[R]}
+Specifies whether to write data to disk while recording.
+By default, this parameter is enabled.
+.RS
+.RE
+.TP
+.B \f[CB]dumponexit=\f[R]{\f[CB]true\f[R]|\f[CB]false\f[R]}
+Specifies if the running recording is dumped when the JVM shuts down.
+If enabled and a \f[CB]filename\f[R] is not entered, the recording is
+written to a file in the directory where the process was started.
+The file name is a system\-generated name that contains the process ID,
+recording ID, and current timestamp, similar to
+\f[CB]hotspot\-pid\-47496\-id\-1\-2018_01_25_19_10_41.jfr\f[R].
+By default, this parameter is disabled.
+.RS
+.RE
+.TP
+.B \f[CB]duration=\f[R]\f[I]time\f[R]
+Specifies the duration of the recording.
+Append \f[CB]s\f[R] to specify the time in seconds, \f[CB]m\f[R] for
+minutes, \f[CB]h\f[R] for hours, or \f[CB]d\f[R] for days (for example,
+specifying \f[CB]5h\f[R] means 5 hours).
+By default, the duration isn\[aq]t limited, and this parameter is set to
+0.
+.RS
+.RE
+.TP
+.B \f[CB]filename=\f[R]\f[I]path\f[R]
+Specifies the path and name of the file to which the recording is
+written when the recording is stopped, for example:
+.RS
+.IP \[bu] 2
+\f[CB]recording.jfr\f[R]
+.IP \[bu] 2
+\f[CB]/home/user/recordings/recording.jfr\f[R]
+.IP \[bu] 2
+\f[CB]c:\\recordings\\recording.jfr\f[R]
+.RE
+.TP
+.B \f[CB]name=\f[R]\f[I]identifier\f[R]
+Takes both the name and the identifier of a recording.
+.RS
+.RE
+.TP
+.B \f[CB]maxage=\f[R]\f[I]time\f[R]
+Specifies the maximum age of disk data to keep for the recording.
+This parameter is valid only when the \f[CB]disk\f[R] parameter is set to
+\f[CB]true\f[R].
+Append \f[CB]s\f[R] to specify the time in seconds, \f[CB]m\f[R] for
+minutes, \f[CB]h\f[R] for hours, or \f[CB]d\f[R] for days (for example,
+specifying \f[CB]30s\f[R] means 30 seconds).
+By default, the maximum age isn\[aq]t limited, and this parameter is set
+to \f[CB]0s\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]maxsize=\f[R]\f[I]size\f[R]
+Specifies the maximum size (in bytes) of disk data to keep for the
+recording.
+This parameter is valid only when the \f[CB]disk\f[R] parameter is set to
+\f[CB]true\f[R].
+The value must not be less than the value for the \f[CB]maxchunksize\f[R]
+parameter set with \f[CB]\-XX:FlightRecorderOptions\f[R].
+Append \f[CB]m\f[R] or \f[CB]M\f[R] to specify the size in megabytes, or
+\f[CB]g\f[R] or \f[CB]G\f[R] to specify the size in gigabytes.
+By default, the maximum size of disk data isn\[aq]t limited, and this
+parameter is set to \f[CB]0\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]path\-to\-gc\-roots=\f[R]{\f[CB]true\f[R]|\f[CB]false\f[R]}
+Specifies whether to collect the path to garbage collection (GC) roots
+at the end of a recording.
+By default, this parameter is disabled.
+.RS
+.PP
+The path to GC roots is useful for finding memory leaks, but collecting
+it is time\-consuming.
+Enable this option only when you start a recording for an application
+that you suspect has a memory leak.
+If the \f[CB]settings\f[R] parameter is set to \f[CB]profile\f[R], the stack
+trace from where the potential leaking object was allocated is included
+in the information collected.
+.RE
+.TP
+.B \f[CB]settings=\f[R]\f[I]path\f[R]
+Specifies the path and name of the event settings file (of type JFC).
+By default, the \f[CB]default.jfc\f[R] file is used, which is located in
+\f[CB]JAVA_HOME/lib/jfr\f[R].
+This default settings file collects a predefined set of information with
+low overhead, so it has minimal impact on performance and can be used
+with recordings that run continuously.
+.RS
+.PP
+A second settings file is also provided, profile.jfc, which provides
+more data than the default configuration, but can have more overhead and
+impact performance.
+Use this configuration for short periods of time when more information
+is needed.
+.RE
+.PP
+You can specify values for multiple parameters by separating them with a
+comma.
+Event settings and .jfc options can be specified using the following
+syntax:
+.TP
+.B \f[CB]option=\f[R]\f[I]value\f[R]
+Specifies the option value to modify.
+To list available options, use the \f[CB]JAVA_HOME\f[R]/bin/jfr tool.
+.RS
+.RE
+.TP
+.B \f[CB]event\-setting\f[R]=\f[I]value\f[R]
+Specifies the event setting value to modify.
+Use the form: #= To add a new event setting, prefix the event name with
+\[aq]+\[aq].
+.RS
+.RE
+.PP
+You can specify values for multiple event settings and .jfc options by
+separating them with a comma.
+In case of a conflict between a parameter and a .jfc option, the
+parameter will take precedence.
+The whitespace delimiter can be omitted for timespan values, i.e.
+20ms.
+For more information about the settings syntax, see Javadoc of the
+jdk.jfr package.
+.RE
+.TP
+.B \f[CB]\-XX:ThreadStackSize=\f[R]\f[I]size\f[R]
+Sets the Java thread stack size (in kilobytes).
+Use of a scaling suffix, such as \f[CB]k\f[R], results in the scaling of
+the kilobytes value so that \f[CB]\-XX:ThreadStackSize=1k\f[R] sets the
+Java thread stack size to 1024*1024 bytes or 1 megabyte.
+The default value depends on the platform:
+.RS
+.IP \[bu] 2
+Linux/x64 (64\-bit): 1024 KB
+.IP \[bu] 2
+macOS (64\-bit): 1024 KB
+.IP \[bu] 2
+Windows: The default value depends on virtual memory
+.PP
+The following examples show how to set the thread stack size to 1
+megabyte in different units:
+.IP
+.nf
+\f[CB]
+\-XX:ThreadStackSize=1k
+\-XX:ThreadStackSize=1024
+\f[R]
+.fi
+.PP
+This option is similar to \f[CB]\-Xss\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:\-UseCompressedOops\f[R]
+Disables the use of compressed pointers.
+By default, this option is enabled, and compressed pointers are used.
+This will automatically limit the maximum ergonomically determined Java
+heap size to the maximum amount of memory that can be covered by
+compressed pointers.
+By default this range is 32 GB.
+.RS
+.PP
+With compressed oops enabled, object references are represented as
+32\-bit offsets instead of 64\-bit pointers, which typically increases
+performance when running the application with Java heap sizes smaller
+than the compressed oops pointer range.
+This option works only for 64\-bit JVMs.
+.PP
+It\[aq]s possible to use compressed pointers with Java heap sizes
+greater than 32 GB.
+See the \f[CB]\-XX:ObjectAlignmentInBytes\f[R] option.
+.RE
+.TP
+.B \f[CB]\-XX:\-UseContainerSupport\f[R]
+The VM now provides automatic container detection support, which allows
+the VM to determine the amount of memory and number of processors that
+are available to a Java process running in docker containers.
+It uses this information to allocate system resources.
+This support is only available on Linux x64 platforms.
+If supported, the default for this flag is \f[CB]true\f[R], and container
+support is enabled by default.
+It can be disabled with \f[CB]\-XX:\-UseContainerSupport\f[R].
+.RS
+.PP
+Unified Logging is available to help to diagnose issues related to this
+support.
+.PP
+Use \f[CB]\-Xlog:os+container=trace\f[R] for maximum logging of container
+information.
+See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R] for a
+description of using Unified Logging.
+.RE
+.TP
+.B \f[CB]\-XX:+UseHugeTLBFS\f[R]
+\f[B]Linux only:\f[R] This option is the equivalent of specifying
+\f[CB]\-XX:+UseLargePages\f[R].
+This option is disabled by default.
+This option pre\-allocates all large pages up\-front, when memory is
+reserved; consequently the JVM can\[aq]t dynamically grow or shrink
+large pages memory areas; see \f[CB]\-XX:UseTransparentHugePages\f[R] if
+you want this behavior.
+.RS
+.PP
+See \f[B]Large Pages\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:+UseLargePages\f[R]
+Enables the use of large page memory.
+By default, this option is disabled and large page memory isn\[aq]t
+used.
+.RS
+.PP
+See \f[B]Large Pages\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:+UseTransparentHugePages\f[R]
+\f[B]Linux only:\f[R] Enables the use of large pages that can dynamically
+grow or shrink.
+This option is disabled by default.
+You may encounter performance problems with transparent huge pages as
+the OS moves other pages around to create huge pages; this option is
+made available for experimentation.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+AllowUserSignalHandlers\f[R]
+Enables installation of signal handlers by the application.
+By default, this option is disabled and the application isn\[aq]t
+allowed to install signal handlers.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:VMOptionsFile=\f[R]\f[I]filename\f[R]
+Allows user to specify VM options in a file, for example,
+\f[CB]java\ \-XX:VMOptionsFile=/var/my_vm_options\ HelloWorld\f[R].
+.RS
+.RE
+.SH ADVANCED JIT COMPILER OPTIONS FOR JAVA
+.PP
+These \f[CB]java\f[R] options control the dynamic just\-in\-time (JIT)
+compilation performed by the Java HotSpot VM.
+.TP
+.B \f[CB]\-XX:AllocateInstancePrefetchLines=\f[R]\f[I]lines\f[R]
+Sets the number of lines to prefetch ahead of the instance allocation
+pointer.
+By default, the number of lines to prefetch is set to 1:
+.RS
+.RS
+.PP
+\f[CB]\-XX:AllocateInstancePrefetchLines=1\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:AllocatePrefetchDistance=\f[R]\f[I]size\f[R]
+Sets the size (in bytes) of the prefetch distance for object allocation.
+Memory about to be written with the value of new objects is prefetched
+up to this distance starting from the address of the last allocated
+object.
+Each Java thread has its own allocation point.
+.RS
+.PP
+Negative values denote that prefetch distance is chosen based on the
+platform.
+Positive values are bytes to prefetch.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default value is set to \-1.
+.PP
+The following example shows how to set the prefetch distance to 1024
+bytes:
+.RS
+.PP
+\f[CB]\-XX:AllocatePrefetchDistance=1024\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:AllocatePrefetchInstr=\f[R]\f[I]instruction\f[R]
+Sets the prefetch instruction to prefetch ahead of the allocation
+pointer.
+Possible values are from 0 to 3.
+The actual instructions behind the values depend on the platform.
+By default, the prefetch instruction is set to 0:
+.RS
+.RS
+.PP
+\f[CB]\-XX:AllocatePrefetchInstr=0\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:AllocatePrefetchLines=\f[R]\f[I]lines\f[R]
+Sets the number of cache lines to load after the last object allocation
+by using the prefetch instructions generated in compiled code.
+The default value is 1 if the last allocated object was an instance, and
+3 if it was an array.
+.RS
+.PP
+The following example shows how to set the number of loaded cache lines
+to 5:
+.RS
+.PP
+\f[CB]\-XX:AllocatePrefetchLines=5\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:AllocatePrefetchStepSize=\f[R]\f[I]size\f[R]
+Sets the step size (in bytes) for sequential prefetch instructions.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, \f[CB]g\f[R] or \f[CB]G\f[R]
+to indicate gigabytes.
+By default, the step size is set to 16 bytes:
+.RS
+.RS
+.PP
+\f[CB]\-XX:AllocatePrefetchStepSize=16\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:AllocatePrefetchStyle=\f[R]\f[I]style\f[R]
+Sets the generated code style for prefetch instructions.
+The \f[I]style\f[R] argument is an integer from 0 to 3:
+.RS
+.TP
+.B \f[CB]0\f[R]
+Don\[aq]t generate prefetch instructions.
+.RS
+.RE
+.TP
+.B \f[CB]1\f[R]
+Execute prefetch instructions after each allocation.
+This is the default setting.
+.RS
+.RE
+.TP
+.B \f[CB]2\f[R]
+Use the thread\-local allocation block (TLAB) watermark pointer to
+determine when prefetch instructions are executed.
+.RS
+.RE
+.TP
+.B \f[CB]3\f[R]
+Generate one prefetch instruction per cache line.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+BackgroundCompilation\f[R]
+Enables background compilation.
+This option is enabled by default.
+To disable background compilation, specify
+\f[CB]\-XX:\-BackgroundCompilation\f[R] (this is equivalent to specifying
+\f[CB]\-Xbatch\f[R]).
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:CICompilerCount=\f[R]\f[I]threads\f[R]
+Sets the number of compiler threads to use for compilation.
+By default, the number of compiler threads is selected automatically
+depending on the number of CPUs and memory available for compiled code.
+The following example shows how to set the number of threads to 2:
+.RS
+.RS
+.PP
+\f[CB]\-XX:CICompilerCount=2\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+UseDynamicNumberOfCompilerThreads\f[R]
+Dynamically create compiler thread up to the limit specified by
+\f[CB]\-XX:CICompilerCount\f[R].
+This option is enabled by default.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:CompileCommand=\f[R]\f[I]command\f[R]\f[CB],\f[R]\f[I]method\f[R][\f[CB],\f[R]\f[I]option\f[R]]
+Specifies a \f[I]command\f[R] to perform on a \f[I]method\f[R].
+For example, to exclude the \f[CB]indexOf()\f[R] method of the
+\f[CB]String\f[R] class from being compiled, use the following:
+.RS
+.RS
+.PP
+\f[CB]\-XX:CompileCommand=exclude,java/lang/String.indexOf\f[R]
+.RE
+.PP
+Note that the full class name is specified, including all packages and
+subpackages separated by a slash (\f[CB]/\f[R]).
+For easier cut\-and\-paste operations, it\[aq]s also possible to use the
+method name format produced by the \f[CB]\-XX:+PrintCompilation\f[R] and
+\f[CB]\-XX:+LogCompilation\f[R] options:
+.RS
+.PP
+\f[CB]\-XX:CompileCommand=exclude,java.lang.String::indexOf\f[R]
+.RE
+.PP
+If the method is specified without the signature, then the command is
+applied to all methods with the specified name.
+However, you can also specify the signature of the method in the class
+file format.
+In this case, you should enclose the arguments in quotation marks,
+because otherwise the shell treats the semicolon as a command end.
+For example, if you want to exclude only the \f[CB]indexOf(String)\f[R]
+method of the \f[CB]String\f[R] class from being compiled, use the
+following:
+.RS
+.PP
+\f[CB]\-XX:CompileCommand="exclude,java/lang/String.indexOf,(Ljava/lang/String;)I"\f[R]
+.RE
+.PP
+You can also use the asterisk (*) as a wildcard for class and method
+names.
+For example, to exclude all \f[CB]indexOf()\f[R] methods in all classes
+from being compiled, use the following:
+.RS
+.PP
+\f[CB]\-XX:CompileCommand=exclude,*.indexOf\f[R]
+.RE
+.PP
+The commas and periods are aliases for spaces, making it easier to pass
+compiler commands through a shell.
+You can pass arguments to \f[CB]\-XX:CompileCommand\f[R] using spaces as
+separators by enclosing the argument in quotation marks:
+.RS
+.PP
+\f[CB]\-XX:CompileCommand="exclude\ java/lang/String\ indexOf"\f[R]
+.RE
+.PP
+Note that after parsing the commands passed on the command line using
+the \f[CB]\-XX:CompileCommand\f[R] options, the JIT compiler then reads
+commands from the \f[CB]\&.hotspot_compiler\f[R] file.
+You can add commands to this file or specify a different file using the
+\f[CB]\-XX:CompileCommandFile\f[R] option.
+.PP
+To add several commands, either specify the \f[CB]\-XX:CompileCommand\f[R]
+option multiple times, or separate each argument with the new line
+separator (\f[CB]\\n\f[R]).
+The following commands are available:
+.TP
+.B \f[CB]break\f[R]
+Sets a breakpoint when debugging the JVM to stop at the beginning of
+compilation of the specified method.
+.RS
+.RE
+.TP
+.B \f[CB]compileonly\f[R]
+Excludes all methods from compilation except for the specified method.
+As an alternative, you can use the \f[CB]\-XX:CompileOnly\f[R] option,
+which lets you specify several methods.
+.RS
+.RE
+.TP
+.B \f[CB]dontinline\f[R]
+Prevents inlining of the specified method.
+.RS
+.RE
+.TP
+.B \f[CB]exclude\f[R]
+Excludes the specified method from compilation.
+.RS
+.RE
+.TP
+.B \f[CB]help\f[R]
+Prints a help message for the \f[CB]\-XX:CompileCommand\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]inline\f[R]
+Attempts to inline the specified method.
+.RS
+.RE
+.TP
+.B \f[CB]log\f[R]
+Excludes compilation logging (with the \f[CB]\-XX:+LogCompilation\f[R]
+option) for all methods except for the specified method.
+By default, logging is performed for all compiled methods.
+.RS
+.RE
+.TP
+.B \f[CB]option\f[R]
+Passes a JIT compilation option to the specified method in place of the
+last argument (\f[CB]option\f[R]).
+The compilation option is set at the end, after the method name.
+For example, to enable the \f[CB]BlockLayoutByFrequency\f[R] option for
+the \f[CB]append()\f[R] method of the \f[CB]StringBuffer\f[R] class, use the
+following:
+.RS
+.RS
+.PP
+\f[CB]\-XX:CompileCommand=option,java/lang/StringBuffer.append,BlockLayoutByFrequency\f[R]
+.RE
+.PP
+You can specify multiple compilation options, separated by commas or
+spaces.
+.RE
+.TP
+.B \f[CB]print\f[R]
+Prints generated assembler code after compilation of the specified
+method.
+.RS
+.RE
+.TP
+.B \f[CB]quiet\f[R]
+Instructs not to print the compile commands.
+By default, the commands that you specify with the
+\f[CB]\-XX:CompileCommand\f[R] option are printed; for example, if you
+exclude from compilation the \f[CB]indexOf()\f[R] method of the
+\f[CB]String\f[R] class, then the following is printed to standard output:
+.RS
+.RS
+.PP
+\f[CB]CompilerOracle:\ exclude\ java/lang/String.indexOf\f[R]
+.RE
+.PP
+You can suppress this by specifying the
+\f[CB]\-XX:CompileCommand=quiet\f[R] option before other
+\f[CB]\-XX:CompileCommand\f[R] options.
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:CompileCommandFile=\f[R]\f[I]filename\f[R]
+Sets the file from which JIT compiler commands are read.
+By default, the \f[CB]\&.hotspot_compiler\f[R] file is used to store
+commands performed by the JIT compiler.
+.RS
+.PP
+Each line in the command file represents a command, a class name, and a
+method name for which the command is used.
+For example, this line prints assembly code for the \f[CB]toString()\f[R]
+method of the \f[CB]String\f[R] class:
+.RS
+.PP
+\f[CB]print\ java/lang/String\ toString\f[R]
+.RE
+.PP
+If you\[aq]re using commands for the JIT compiler to perform on methods,
+then see the \f[CB]\-XX:CompileCommand\f[R] option.
+.RE
+.TP
+.B \f[CB]\-XX:CompilerDirectivesFile=\f[R]\f[I]file\f[R]
+Adds directives from a file to the directives stack when a program
+starts.
+See \f[B]Compiler Control\f[R]
+[https://docs.oracle.com/en/java/javase/12/vm/compiler\-control1.html#GUID\-94AD8194\-786A\-4F19\-BFFF\-278F8E237F3A].
+.RS
+.PP
+The \f[CB]\-XX:CompilerDirectivesFile\f[R] option has to be used together
+with the \f[CB]\-XX:UnlockDiagnosticVMOptions\f[R] option that unlocks
+diagnostic JVM options.
+.RE
+.TP
+.B \f[CB]\-XX:+CompilerDirectivesPrint\f[R]
+Prints the directives stack when the program starts or when a new
+directive is added.
+.RS
+.PP
+The \f[CB]\-XX:+CompilerDirectivesPrint\f[R] option has to be used
+together with the \f[CB]\-XX:UnlockDiagnosticVMOptions\f[R] option that
+unlocks diagnostic JVM options.
+.RE
+.TP
+.B \f[CB]\-XX:CompileOnly=\f[R]\f[I]methods\f[R]
+Sets the list of methods (separated by commas) to which compilation
+should be restricted.
+Only the specified methods are compiled.
+Specify each method with the full class name (including the packages and
+subpackages).
+For example, to compile only the \f[CB]length()\f[R] method of the
+\f[CB]String\f[R] class and the \f[CB]size()\f[R] method of the
+\f[CB]List\f[R] class, use the following:
+.RS
+.RS
+.PP
+\f[CB]\-XX:CompileOnly=java/lang/String.length,java/util/List.size\f[R]
+.RE
+.PP
+Note that the full class name is specified, including all packages and
+subpackages separated by a slash (\f[CB]/\f[R]).
+For easier cut and paste operations, it\[aq]s also possible to use the
+method name format produced by the \f[CB]\-XX:+PrintCompilation\f[R] and
+\f[CB]\-XX:+LogCompilation\f[R] options:
+.RS
+.PP
+\f[CB]\-XX:CompileOnly=java.lang.String::length,java.util.List::size\f[R]
+.RE
+.PP
+Although wildcards aren\[aq]t supported, you can specify only the class
+or package name to compile all methods in that class or package, as well
+as specify just the method to compile methods with this name in any
+class:
+.IP
+.nf
+\f[CB]
+\-XX:CompileOnly=java/lang/String
+\-XX:CompileOnly=java/lang
+\-XX:CompileOnly=.length
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]\-XX:CompileThresholdScaling=\f[R]\f[I]scale\f[R]
+Provides unified control of first compilation.
+This option controls when methods are first compiled for both the tiered
+and the nontiered modes of operation.
+The \f[CB]CompileThresholdScaling\f[R] option has a floating point value
+between 0 and +Inf and scales the thresholds corresponding to the
+current mode of operation (both tiered and nontiered).
+Setting \f[CB]CompileThresholdScaling\f[R] to a value less than 1.0
+results in earlier compilation while values greater than 1.0 delay
+compilation.
+Setting \f[CB]CompileThresholdScaling\f[R] to 0 is equivalent to disabling
+compilation.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+DoEscapeAnalysis\f[R]
+Enables the use of escape analysis.
+This option is enabled by default.
+To disable the use of escape analysis, specify
+\f[CB]\-XX:\-DoEscapeAnalysis\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:InitialCodeCacheSize=\f[R]\f[I]size\f[R]
+Sets the initial code cache size (in bytes).
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default value depends on the platform.
+The initial code cache size shouldn\[aq]t be less than the system\[aq]s
+minimal memory page size.
+The following example shows how to set the initial code cache size to 32
+KB:
+.RS
+.RS
+.PP
+\f[CB]\-XX:InitialCodeCacheSize=32k\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+Inline\f[R]
+Enables method inlining.
+This option is enabled by default to increase performance.
+To disable method inlining, specify \f[CB]\-XX:\-Inline\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:InlineSmallCode=\f[R]\f[I]size\f[R]
+Sets the maximum code size (in bytes) for already compiled methods that
+may be inlined.
+This flag only applies to the C2 compiler.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default value depends on the platform and on whether tiered
+compilation is enabled.
+In the following example it is set to 1000 bytes:
+.RS
+.RS
+.PP
+\f[CB]\-XX:InlineSmallCode=1000\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+LogCompilation\f[R]
+Enables logging of compilation activity to a file named
+\f[CB]hotspot.log\f[R] in the current working directory.
+You can specify a different log file path and name using the
+\f[CB]\-XX:LogFile\f[R] option.
+.RS
+.PP
+By default, this option is disabled and compilation activity isn\[aq]t
+logged.
+The \f[CB]\-XX:+LogCompilation\f[R] option has to be used together with
+the \f[CB]\-XX:UnlockDiagnosticVMOptions\f[R] option that unlocks
+diagnostic JVM options.
+.PP
+You can enable verbose diagnostic output with a message printed to the
+console every time a method is compiled by using the
+\f[CB]\-XX:+PrintCompilation\f[R] option.
+.RE
+.TP
+.B \f[CB]\-XX:FreqInlineSize=\f[R]\f[I]size\f[R]
+Sets the maximum bytecode size (in bytes) of a hot method to be inlined.
+This flag only applies to the C2 compiler.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default value depends on the platform.
+In the following example it is set to 325 bytes:
+.RS
+.RS
+.PP
+\f[CB]\-XX:FreqInlineSize=325\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxInlineSize=\f[R]\f[I]size\f[R]
+Sets the maximum bytecode size (in bytes) of a cold method to be
+inlined.
+This flag only applies to the C2 compiler.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+By default, the maximum bytecode size is set to 35 bytes:
+.RS
+.RS
+.PP
+\f[CB]\-XX:MaxInlineSize=35\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:C1MaxInlineSize=\f[R]\f[I]size\f[R]
+Sets the maximum bytecode size (in bytes) of a cold method to be
+inlined.
+This flag only applies to the C1 compiler.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+By default, the maximum bytecode size is set to 35 bytes:
+.RS
+.RS
+.PP
+\f[CB]\-XX:MaxInlineSize=35\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxTrivialSize=\f[R]\f[I]size\f[R]
+Sets the maximum bytecode size (in bytes) of a trivial method to be
+inlined.
+This flag only applies to the C2 compiler.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+By default, the maximum bytecode size of a trivial method is set to 6
+bytes:
+.RS
+.RS
+.PP
+\f[CB]\-XX:MaxTrivialSize=6\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:C1MaxTrivialSize=\f[R]\f[I]size\f[R]
+Sets the maximum bytecode size (in bytes) of a trivial method to be
+inlined.
+This flag only applies to the C1 compiler.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+By default, the maximum bytecode size of a trivial method is set to 6
+bytes:
+.RS
+.RS
+.PP
+\f[CB]\-XX:MaxTrivialSize=6\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxNodeLimit=\f[R]\f[I]nodes\f[R]
+Sets the maximum number of nodes to be used during single method
+compilation.
+By default the value depends on the features enabled.
+In the following example the maximum number of nodes is set to 100,000:
+.RS
+.RS
+.PP
+\f[CB]\-XX:MaxNodeLimit=100000\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:NonNMethodCodeHeapSize=\f[R]\f[I]size\f[R]
+Sets the size in bytes of the code segment containing nonmethod code.
+.RS
+.PP
+A nonmethod code segment containing nonmethod code, such as compiler
+buffers and the bytecode interpreter.
+This code type stays in the code cache forever.
+This flag is used only if \f[CB]\-XX:SegmentedCodeCache\f[R] is enabled.
+.RE
+.TP
+.B \f[CB]\-XX:NonProfiledCodeHeapSize=\f[R]\f[I]size\f[R]
+Sets the size in bytes of the code segment containing nonprofiled
+methods.
+This flag is used only if \f[CB]\-XX:SegmentedCodeCache\f[R] is enabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+OptimizeStringConcat\f[R]
+Enables the optimization of \f[CB]String\f[R] concatenation operations.
+This option is enabled by default.
+To disable the optimization of \f[CB]String\f[R] concatenation operations,
+specify \f[CB]\-XX:\-OptimizeStringConcat\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+PrintAssembly\f[R]
+Enables printing of assembly code for bytecoded and native methods by
+using the external \f[CB]hsdis\-<arch>.so\f[R] or \f[CB]\&.dll\f[R] library.
+For 64\-bit VM on Windows, it\[aq]s \f[CB]hsdis\-amd64.dll\f[R].
+This lets you to see the generated code, which may help you to diagnose
+performance issues.
+.RS
+.PP
+By default, this option is disabled and assembly code isn\[aq]t printed.
+The \f[CB]\-XX:+PrintAssembly\f[R] option has to be used together with the
+\f[CB]\-XX:UnlockDiagnosticVMOptions\f[R] option that unlocks diagnostic
+JVM options.
+.RE
+.TP
+.B \f[CB]\-XX:ProfiledCodeHeapSize=\f[R]\f[I]size\f[R]
+Sets the size in bytes of the code segment containing profiled methods.
+This flag is used only if \f[CB]\-XX:SegmentedCodeCache\f[R] is enabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+PrintCompilation\f[R]
+Enables verbose diagnostic output from the JVM by printing a message to
+the console every time a method is compiled.
+This lets you to see which methods actually get compiled.
+By default, this option is disabled and diagnostic output isn\[aq]t
+printed.
+.RS
+.PP
+You can also log compilation activity to a file by using the
+\f[CB]\-XX:+LogCompilation\f[R] option.
+.RE
+.TP
+.B \f[CB]\-XX:+PrintInlining\f[R]
+Enables printing of inlining decisions.
+This let\[aq]s you see which methods are getting inlined.
+.RS
+.PP
+By default, this option is disabled and inlining information isn\[aq]t
+printed.
+The \f[CB]\-XX:+PrintInlining\f[R] option has to be used together with the
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R] option that unlocks diagnostic
+JVM options.
+.RE
+.TP
+.B \f[CB]\-XX:ReservedCodeCacheSize=\f[R]\f[I]size\f[R]
+Sets the maximum code cache size (in bytes) for JIT\-compiled code.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default maximum code cache size is 240 MB; if you disable tiered
+compilation with the option \f[CB]\-XX:\-TieredCompilation\f[R], then the
+default size is 48 MB.
+This option has a limit of 2 GB; otherwise, an error is generated.
+The maximum code cache size shouldn\[aq]t be less than the initial code
+cache size; see the option \f[CB]\-XX:InitialCodeCacheSize\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:RTMAbortRatio=\f[R]\f[I]abort_ratio\f[R]
+Specifies the RTM abort ratio is specified as a percentage (%) of all
+executed RTM transactions.
+If a number of aborted transactions becomes greater than this ratio,
+then the compiled code is deoptimized.
+This ratio is used when the \f[CB]\-XX:+UseRTMDeopt\f[R] option is
+enabled.
+The default value of this option is 50.
+This means that the compiled code is deoptimized if 50% of all
+transactions are aborted.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:RTMRetryCount=\f[R]\f[I]number_of_retries\f[R]
+Specifies the number of times that the RTM locking code is retried, when
+it is aborted or busy, before falling back to the normal locking
+mechanism.
+The default value for this option is 5.
+The \f[CB]\-XX:UseRTMLocking\f[R] option must be enabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+SegmentedCodeCache\f[R]
+Enables segmentation of the code cache.
+Without the \f[CB]\-XX:+SegmentedCodeCache\f[R], the code cache consists
+of one large segment.
+With \f[CB]\-XX:+SegmentedCodeCache\f[R], we have separate segments for
+nonmethod, profiled method, and nonprofiled method code.
+These segments aren\[aq]t resized at runtime.
+The feature is enabled by default if tiered compilation is enabled
+(\f[CB]\-XX:+TieredCompilation\f[R] ) and
+\f[CB]\-XX:ReservedCodeCacheSize\f[R] >= 240 MB.
+The advantages are better control of the memory footprint, reduced code
+fragmentation, and better iTLB/iCache behavior due to improved locality.
+iTLB/iCache is a CPU\-specific term meaning Instruction Translation
+Lookaside Buffer (ITLB).
+ICache is an instruction cache in theCPU.
+The implementation of the code cache can be found in the file:
+\f[CB]/share/vm/code/codeCache.cpp\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:StartAggressiveSweepingAt=\f[R]\f[I]percent\f[R]
+Forces stack scanning of active methods to aggressively remove unused
+code when only the given percentage of the code cache is free.
+The default value is 10%.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:\-TieredCompilation\f[R]
+Disables the use of tiered compilation.
+By default, this option is enabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:UseSSE=\f[R]\f[I]version\f[R]
+Enables the use of SSE instruction set of a specified version.
+Is set by default to the highest supported version available (x86 only).
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:UseAVX=\f[R]\f[I]version\f[R]
+Enables the use of AVX instruction set of a specified version.
+Is set by default to the highest supported version available (x86 only).
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseAES\f[R]
+Enables hardware\-based AES intrinsics for hardware that supports it.
+This option is on by default on hardware that has the necessary
+instructions.
+The \f[CB]\-XX:+UseAES\f[R] is used in conjunction with UseAESIntrinsics.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseAESIntrinsics\f[R]
+Enables AES intrinsics.
+Specifying\f[CB]\-XX:+UseAESIntrinsics\f[R] is equivalent to also enabling
+\f[CB]\-XX:+UseAES\f[R].
+To disable hardware\-based AES intrinsics, specify
+\f[CB]\-XX:\-UseAES\ \-XX:\-UseAESIntrinsics\f[R].
+For example, to enable hardware AES, use the following flags:
+.RS
+.RS
+.PP
+\f[CB]\-XX:+UseAES\ \-XX:+UseAESIntrinsics\f[R]
+.RE
+.PP
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:+UseAESCTRIntrinsics\f[R]
+Analogous to \f[CB]\-XX:+UseAESIntrinsics\f[R] enables AES/CTR intrinsics.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseGHASHIntrinsics\f[R]
+Controls the use of GHASH intrinsics.
+Enabled by default on platforms that support the corresponding
+instructions.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseBASE64Intrinsics\f[R]
+Controls the use of accelerated BASE64 encoding routines for
+\f[CB]java.util.Base64\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseAdler32Intrinsics\f[R]
+Controls the use of Adler32 checksum algorithm intrinsic for
+\f[CB]java.util.zip.Adler32\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseCRC32Intrinsics\f[R]
+Controls the use of CRC32 intrinsics for \f[CB]java.util.zip.CRC32\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseCRC32CIntrinsics\f[R]
+Controls the use of CRC32C intrinsics for \f[CB]java.util.zip.CRC32C\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseSHA\f[R]
+Enables hardware\-based intrinsics for SHA crypto hash functions for
+some hardware.
+The \f[CB]UseSHA\f[R] option is used in conjunction with the
+\f[CB]UseSHA1Intrinsics\f[R], \f[CB]UseSHA256Intrinsics\f[R], and
+\f[CB]UseSHA512Intrinsics\f[R] options.
+.RS
+.PP
+The \f[CB]UseSHA\f[R] and \f[CB]UseSHA*Intrinsics\f[R] flags are enabled by
+default on machines that support the corresponding instructions.
+.PP
+This feature is applicable only when using the
+\f[CB]sun.security.provider.Sun\f[R] provider for SHA operations.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.PP
+To disable all hardware\-based SHA intrinsics, specify the
+\f[CB]\-XX:\-UseSHA\f[R].
+To disable only a particular SHA intrinsic, use the appropriate
+corresponding option.
+For example: \f[CB]\-XX:\-UseSHA256Intrinsics\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:+UseSHA1Intrinsics\f[R]
+Enables intrinsics for SHA\-1 crypto hash function.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseSHA256Intrinsics\f[R]
+Enables intrinsics for SHA\-224 and SHA\-256 crypto hash functions.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseSHA512Intrinsics\f[R]
+Enables intrinsics for SHA\-384 and SHA\-512 crypto hash functions.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseMathExactIntrinsics\f[R]
+Enables intrinsification of various \f[CB]java.lang.Math.*Exact()\f[R]
+functions.
+Enabled by default.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseMultiplyToLenIntrinsic\f[R]
+Enables intrinsification of \f[CB]BigInteger.multiplyToLen()\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \-XX:+UseSquareToLenIntrinsic
+Enables intrinsification of \f[CB]BigInteger.squareToLen()\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \-XX:+UseMulAddIntrinsic
+Enables intrinsification of \f[CB]BigInteger.mulAdd()\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \-XX:+UseMontgomeryMultiplyIntrinsic
+Enables intrinsification of \f[CB]BigInteger.montgomeryMultiply()\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \-XX:+UseMontgomerySquareIntrinsic
+Enables intrinsification of \f[CB]BigInteger.montgomerySquare()\f[R].
+Enabled by default on platforms that support it.
+Flags that control intrinsics now require the option
+\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseCMoveUnconditionally\f[R]
+Generates CMove (scalar and vector) instructions regardless of
+profitability analysis.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseCodeCacheFlushing\f[R]
+Enables flushing of the code cache before shutting down the compiler.
+This option is enabled by default.
+To disable flushing of the code cache before shutting down the compiler,
+specify \f[CB]\-XX:\-UseCodeCacheFlushing\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseCondCardMark\f[R]
+Enables checking if the card is already marked before updating the card
+table.
+This option is disabled by default.
+It should be used only on machines with multiple sockets, where it
+increases the performance of Java applications that rely on concurrent
+operations.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseCountedLoopSafepoints\f[R]
+Keeps safepoints in counted loops.
+Its default value depends on whether the selected garbage collector
+requires low latency safepoints.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:LoopStripMiningIter=\f[R]\f[I]number_of_iterations\f[R]
+Controls the number of iterations in the inner strip mined loop.
+Strip mining transforms counted loops into two level nested loops.
+Safepoints are kept in the outer loop while the inner loop can execute
+at full speed.
+This option controls the maximum number of iterations in the inner loop.
+The default value is 1,000.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:LoopStripMiningIterShortLoop\f[R]=\f[I]number_of_iterations\f[R]
+Controls loop strip mining optimization.
+Loops with the number of iterations less than specified will not have
+safepoints in them.
+Default value is 1/10th of \f[CB]\-XX:LoopStripMiningIter\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseFMA\f[R]
+Enables hardware\-based FMA intrinsics for hardware where FMA
+instructions are available (such as, Intel and ARM64).
+FMA intrinsics are generated for the
+\f[CB]java.lang.Math.fma(\f[R]\f[I]a\f[R]\f[CB],\f[R] \f[I]b\f[R]\f[CB],\f[R]
+\f[I]c\f[R]\f[CB])\f[R] methods that calculate the value of \f[CB](\f[R]
+\f[I]a\f[R] \f[CB]*\f[R] \f[I]b\f[R] \f[CB]+\f[R] \f[I]c\f[R] \f[CB])\f[R]
+expressions.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseRTMDeopt\f[R]
+Autotunes RTM locking depending on the abort ratio.
+This ratio is specified by the \f[CB]\-XX:RTMAbortRatio\f[R] option.
+If the number of aborted transactions exceeds the abort ratio, then the
+method containing the lock is deoptimized and recompiled with all locks
+as normal locks.
+This option is disabled by default.
+The \f[CB]\-XX:+UseRTMLocking\f[R] option must be enabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseRTMLocking\f[R]
+Generates Restricted Transactional Memory (RTM) locking code for all
+inflated locks, with the normal locking mechanism as the fallback
+handler.
+This option is disabled by default.
+Options related to RTM are available only on x86 CPUs that support
+Transactional Synchronization Extensions (TSX).
+.RS
+.PP
+RTM is part of Intel\[aq]s TSX, which is an x86 instruction set
+extension and facilitates the creation of multithreaded applications.
+RTM introduces the new instructions \f[CB]XBEGIN\f[R], \f[CB]XABORT\f[R],
+\f[CB]XEND\f[R], and \f[CB]XTEST\f[R].
+The \f[CB]XBEGIN\f[R] and \f[CB]XEND\f[R] instructions enclose a set of
+instructions to run as a transaction.
+If no conflict is found when running the transaction, then the memory
+and register modifications are committed together at the \f[CB]XEND\f[R]
+instruction.
+The \f[CB]XABORT\f[R] instruction can be used to explicitly abort a
+transaction and the \f[CB]XTEST\f[R] instruction checks if a set of
+instructions is being run in a transaction.
+.PP
+A lock on a transaction is inflated when another thread tries to access
+the same transaction, thereby blocking the thread that didn\[aq]t
+originally request access to the transaction.
+RTM requires that a fallback set of operations be specified in case a
+transaction aborts or fails.
+An RTM lock is a lock that has been delegated to the TSX\[aq]s system.
+.PP
+RTM improves performance for highly contended locks with low conflict in
+a critical region (which is code that must not be accessed by more than
+one thread concurrently).
+RTM also improves the performance of coarse\-grain locking, which
+typically doesn\[aq]t perform well in multithreaded applications.
+(Coarse\-grain locking is the strategy of holding locks for long periods
+to minimize the overhead of taking and releasing locks, while
+fine\-grained locking is the strategy of trying to achieve maximum
+parallelism by locking only when necessary and unlocking as soon as
+possible.) Also, for lightly contended locks that are used by different
+threads, RTM can reduce false cache line sharing, also known as cache
+line ping\-pong.
+This occurs when multiple threads from different processors are
+accessing different resources, but the resources share the same cache
+line.
+As a result, the processors repeatedly invalidate the cache lines of
+other processors, which forces them to read from main memory instead of
+their cache.
+.RE
+.TP
+.B \f[CB]\-XX:+UseSuperWord\f[R]
+Enables the transformation of scalar operations into superword
+operations.
+Superword is a vectorization optimization.
+This option is enabled by default.
+To disable the transformation of scalar operations into superword
+operations, specify \f[CB]\-XX:\-UseSuperWord\f[R].
+.RS
+.RE
+.SH ADVANCED SERVICEABILITY OPTIONS FOR JAVA
+.PP
+These \f[CB]java\f[R] options provide the ability to gather system
+information and perform extensive debugging.
+.TP
+.B \f[CB]\-XX:+DisableAttachMechanism\f[R]
+Disables the mechanism that lets tools attach to the JVM.
+By default, this option is disabled, meaning that the attach mechanism
+is enabled and you can use diagnostics and troubleshooting tools such as
+\f[CB]jcmd\f[R], \f[CB]jstack\f[R], \f[CB]jmap\f[R], and \f[CB]jinfo\f[R].
+.RS
+.RS
+.PP
+\f[B]Note:\f[R] The tools such as \f[B]jcmd\f[R], \f[B]jinfo\f[R],
+\f[B]jmap\f[R], and \f[B]jstack\f[R] shipped with the JDK aren\[aq]t
+supported when using the tools from one JDK version to troubleshoot a
+different JDK version.
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+ExtendedDTraceProbes\f[R]
+\f[B]Linux and macOS:\f[R] Enables additional \f[CB]dtrace\f[R] tool probes
+that affect the performance.
+By default, this option is disabled and \f[CB]dtrace\f[R] performs only
+standard probes.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+HeapDumpOnOutOfMemoryError\f[R]
+Enables the dumping of the Java heap to a file in the current directory
+by using the heap profiler (HPROF) when a
+\f[CB]java.lang.OutOfMemoryError\f[R] exception is thrown.
+You can explicitly set the heap dump file path and name using the
+\f[CB]\-XX:HeapDumpPath\f[R] option.
+By default, this option is disabled and the heap isn\[aq]t dumped when
+an \f[CB]OutOfMemoryError\f[R] exception is thrown.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:HeapDumpPath=path\f[R]
+Sets the path and file name for writing the heap dump provided by the
+heap profiler (HPROF) when the \f[CB]\-XX:+HeapDumpOnOutOfMemoryError\f[R]
+option is set.
+By default, the file is created in the current working directory, and
+it\[aq]s named \f[CB]java_pid<pid>.hprof\f[R] where \f[CB]<pid>\f[R] is the
+identifier of the process that caused the error.
+The following example shows how to set the default file explicitly
+(\f[CB]%p\f[R] represents the current process identifier):
+.RS
+.RS
+.PP
+\f[CB]\-XX:HeapDumpPath=./java_pid%p.hprof\f[R]
+.RE
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] The following example shows how to set the
+heap dump file to \f[CB]/var/log/java/java_heapdump.hprof\f[R]:
+.RS 2
+.RS
+.PP
+\f[CB]\-XX:HeapDumpPath=/var/log/java/java_heapdump.hprof\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R] The following example shows how to set the heap dump
+file to \f[CB]C:/log/java/java_heapdump.log\f[R]:
+.RS 2
+.RS
+.PP
+\f[CB]\-XX:HeapDumpPath=C:/log/java/java_heapdump.log\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:LogFile=\f[R]\f[I]path\f[R]
+Sets the path and file name to where log data is written.
+By default, the file is created in the current working directory, and
+it\[aq]s named \f[CB]hotspot.log\f[R].
+.RS
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] The following example shows how to set the log
+file to \f[CB]/var/log/java/hotspot.log\f[R]:
+.RS 2
+.RS
+.PP
+\f[CB]\-XX:LogFile=/var/log/java/hotspot.log\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R] The following example shows how to set the log file to
+\f[CB]C:/log/java/hotspot.log\f[R]:
+.RS 2
+.RS
+.PP
+\f[CB]\-XX:LogFile=C:/log/java/hotspot.log\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+PrintClassHistogram\f[R]
+Enables printing of a class instance histogram after one of the
+following events:
+.RS
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] \f[CB]Control+Break\f[R]
+.IP \[bu] 2
+\f[B]Windows:\f[R] \f[CB]Control+C\f[R] (\f[CB]SIGTERM\f[R])
+.PP
+By default, this option is disabled.
+.PP
+Setting this option is equivalent to running the \f[CB]jmap\ \-histo\f[R]
+command, or the \f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]GC.class_histogram\f[R]
+command, where \f[I]pid\f[R] is the current Java process identifier.
+.RE
+.TP
+.B \f[CB]\-XX:+PrintConcurrentLocks\f[R]
+Enables printing of \f[CB]java.util.concurrent\f[R] locks after one of the
+following events:
+.RS
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R] \f[CB]Control+Break\f[R]
+.IP \[bu] 2
+\f[B]Windows:\f[R] \f[CB]Control+C\f[R] (\f[CB]SIGTERM\f[R])
+.PP
+By default, this option is disabled.
+.PP
+Setting this option is equivalent to running the \f[CB]jstack\ \-l\f[R]
+command or the \f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]Thread.print\ \-l\f[R]
+command, where \f[I]pid\f[R] is the current Java process identifier.
+.RE
+.TP
+.B \f[CB]\-XX:+PrintFlagsRanges\f[R]
+Prints the range specified and allows automatic testing of the values.
+See \f[B]Validate Java Virtual Machine Flag Arguments\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+PerfDataSaveToFile\f[R]
+If enabled, saves \f[B]jstat\f[R] binary data when the Java application
+exits.
+This binary data is saved in a file named
+\f[CB]hsperfdata_\f[R]\f[I]pid\f[R], where \f[I]pid\f[R] is the process
+identifier of the Java application that you ran.
+Use the \f[CB]jstat\f[R] command to display the performance data contained
+in this file as follows:
+.RS
+.RS
+.PP
+\f[CB]jstat\ \-class\ file:///\f[R]\f[I]path\f[R]\f[CB]/hsperfdata_\f[R]\f[I]pid\f[R]
+.RE
+.RS
+.PP
+\f[CB]jstat\ \-gc\ file:///\f[R]\f[I]path\f[R]\f[CB]/hsperfdata_\f[R]\f[I]pid\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+UsePerfData\f[R]
+Enables the \f[CB]perfdata\f[R] feature.
+This option is enabled by default to allow JVM monitoring and
+performance testing.
+Disabling it suppresses the creation of the \f[CB]hsperfdata_userid\f[R]
+directories.
+To disable the \f[CB]perfdata\f[R] feature, specify
+\f[CB]\-XX:\-UsePerfData\f[R].
+.RS
+.RE
+.SH ADVANCED GARBAGE COLLECTION OPTIONS FOR JAVA
+.PP
+These \f[CB]java\f[R] options control how garbage collection (GC) is
+performed by the Java HotSpot VM.
+.TP
+.B \f[CB]\-XX:+AggressiveHeap\f[R]
+Enables Java heap optimization.
+This sets various parameters to be optimal for long\-running jobs with
+intensive memory allocation, based on the configuration of the computer
+(RAM and CPU).
+By default, the option is disabled and the heap sizes are configured
+less aggressively.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+AlwaysPreTouch\f[R]
+Requests the VM to touch every page on the Java heap after requesting it
+from the operating system and before handing memory out to the
+application.
+By default, this option is disabled and all pages are committed as the
+application uses the heap space.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:ConcGCThreads=\f[R]\f[I]threads\f[R]
+Sets the number of threads used for concurrent GC.
+Sets \f[I]\f[CI]threads\f[I]\f[R] to approximately 1/4 of the number of
+parallel garbage collection threads.
+The default value depends on the number of CPUs available to the JVM.
+.RS
+.PP
+For example, to set the number of threads for concurrent GC to 2,
+specify the following option:
+.RS
+.PP
+\f[CB]\-XX:ConcGCThreads=2\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+DisableExplicitGC\f[R]
+Enables the option that disables processing of calls to the
+\f[CB]System.gc()\f[R] method.
+This option is disabled by default, meaning that calls to
+\f[CB]System.gc()\f[R] are processed.
+If processing of calls to \f[CB]System.gc()\f[R] is disabled, then the JVM
+still performs GC when necessary.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+ExplicitGCInvokesConcurrent\f[R]
+Enables invoking of concurrent GC by using the \f[CB]System.gc()\f[R]
+request.
+This option is disabled by default and can be enabled only with the
+\f[CB]\-XX:+UseG1GC\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:G1AdaptiveIHOPNumInitialSamples=\f[R]\f[I]number\f[R]
+When \f[CB]\-XX:UseAdaptiveIHOP\f[R] is enabled, this option sets the
+number of completed marking cycles used to gather samples until G1
+adaptively determines the optimum value of
+\f[CB]\-XX:InitiatingHeapOccupancyPercent\f[R].
+Before, G1 uses the value of
+\f[CB]\-XX:InitiatingHeapOccupancyPercent\f[R] directly for this purpose.
+The default value is 3.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:G1HeapRegionSize=size\f[R]
+Sets the size of the regions into which the Java heap is subdivided when
+using the garbage\-first (G1) collector.
+The value is a power of 2 and can range from 1 MB to 32 MB.
+The default region size is determined ergonomically based on the heap
+size with a goal of approximately 2048 regions.
+.RS
+.PP
+The following example sets the size of the subdivisions to 16 MB:
+.RS
+.PP
+\f[CB]\-XX:G1HeapRegionSize=16m\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:G1HeapWastePercent=\f[R]\f[I]percent\f[R]
+Sets the percentage of heap that you\[aq]re willing to waste.
+The Java HotSpot VM doesn\[aq]t initiate the mixed garbage collection
+cycle when the reclaimable percentage is less than the heap waste
+percentage.
+The default is 5 percent.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:G1MaxNewSizePercent=\f[R]\f[I]percent\f[R]
+Sets the percentage of the heap size to use as the maximum for the young
+generation size.
+The default value is 60 percent of your Java heap.
+.RS
+.PP
+This is an experimental flag.
+This setting replaces the \f[CB]\-XX:DefaultMaxNewGenPercent\f[R] setting.
+.RE
+.TP
+.B \f[CB]\-XX:G1MixedGCCountTarget=\f[R]\f[I]number\f[R]
+Sets the target number of mixed garbage collections after a marking
+cycle to collect old regions with at most
+\f[CB]G1MixedGCLIveThresholdPercent\f[R] live data.
+The default is 8 mixed garbage collections.
+The goal for mixed collections is to be within this target number.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:G1MixedGCLiveThresholdPercent=\f[R]\f[I]percent\f[R]
+Sets the occupancy threshold for an old region to be included in a mixed
+garbage collection cycle.
+The default occupancy is 85 percent.
+.RS
+.PP
+This is an experimental flag.
+This setting replaces the
+\f[CB]\-XX:G1OldCSetRegionLiveThresholdPercent\f[R] setting.
+.RE
+.TP
+.B \f[CB]\-XX:G1NewSizePercent=\f[R]\f[I]percent\f[R]
+Sets the percentage of the heap to use as the minimum for the young
+generation size.
+The default value is 5 percent of your Java heap.
+.RS
+.PP
+This is an experimental flag.
+This setting replaces the \f[CB]\-XX:DefaultMinNewGenPercent\f[R] setting.
+.RE
+.TP
+.B \f[CB]\-XX:G1OldCSetRegionThresholdPercent=\f[R]\f[I]percent\f[R]
+Sets an upper limit on the number of old regions to be collected during
+a mixed garbage collection cycle.
+The default is 10 percent of the Java heap.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:G1ReservePercent=\f[R]\f[I]percent\f[R]
+Sets the percentage of the heap (0 to 50) that\[aq]s reserved as a false
+ceiling to reduce the possibility of promotion failure for the G1
+collector.
+When you increase or decrease the percentage, ensure that you adjust the
+total Java heap by the same amount.
+By default, this option is set to 10%.
+.RS
+.PP
+The following example sets the reserved heap to 20%:
+.RS
+.PP
+\f[CB]\-XX:G1ReservePercent=20\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+G1UseAdaptiveIHOP\f[R]
+Controls adaptive calculation of the old generation occupancy to start
+background work preparing for an old generation collection.
+If enabled, G1 uses \f[CB]\-XX:InitiatingHeapOccupancyPercent\f[R] for the
+first few times as specified by the value of
+\f[CB]\-XX:G1AdaptiveIHOPNumInitialSamples\f[R], and after that adaptively
+calculates a new optimum value for the initiating occupancy
+automatically.
+Otherwise, the old generation collection process always starts at the
+old generation occupancy determined by
+\f[CB]\-XX:InitiatingHeapOccupancyPercent\f[R].
+.RS
+.PP
+The default is enabled.
+.RE
+.TP
+.B \f[CB]\-XX:InitialHeapSize=\f[R]\f[I]size\f[R]
+Sets the initial size (in bytes) of the memory allocation pool.
+This value must be either 0, or a multiple of 1024 and greater than 1
+MB.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default value is selected at run time based on the system
+configuration.
+.RS
+.PP
+The following examples show how to set the size of allocated memory to 6
+MB using various units:
+.IP
+.nf
+\f[CB]
+\-XX:InitialHeapSize=6291456
+\-XX:InitialHeapSize=6144k
+\-XX:InitialHeapSize=6m
+\f[R]
+.fi
+.PP
+If you set this option to 0, then the initial size is set as the sum of
+the sizes allocated for the old generation and the young generation.
+The size of the heap for the young generation can be set using the
+\f[CB]\-XX:NewSize\f[R] option.
+.RE
+.TP
+.B \f[CB]\-XX:InitialRAMPercentage=\f[R]\f[I]percent\f[R]
+Sets the initial amount of memory that the JVM will use for the Java
+heap before applying ergonomics heuristics as a percentage of the
+maximum amount determined as described in the \f[CB]\-XX:MaxRAM\f[R]
+option.
+The default value is 1.5625 percent.
+.RS
+.PP
+The following example shows how to set the percentage of the initial
+amount of memory used for the Java heap:
+.RS
+.PP
+\f[CB]\-XX:InitialRAMPercentage=5\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:InitialSurvivorRatio=\f[R]\f[I]ratio\f[R]
+Sets the initial survivor space ratio used by the throughput garbage
+collector (which is enabled by the \f[CB]\-XX:+UseParallelGC\f[R] option).
+Adaptive sizing is enabled by default with the throughput garbage
+collector by using the \f[CB]\-XX:+UseParallelGC\f[R] option, and the
+survivor space is resized according to the application behavior,
+starting with the initial value.
+If adaptive sizing is disabled (using the
+\f[CB]\-XX:\-UseAdaptiveSizePolicy\f[R] option), then the
+\f[CB]\-XX:SurvivorRatio\f[R] option should be used to set the size of the
+survivor space for the entire execution of the application.
+.RS
+.PP
+The following formula can be used to calculate the initial size of
+survivor space (S) based on the size of the young generation (Y), and
+the initial survivor space ratio (R):
+.RS
+.PP
+\f[CB]S=Y/(R+2)\f[R]
+.RE
+.PP
+The 2 in the equation denotes two survivor spaces.
+The larger the value specified as the initial survivor space ratio, the
+smaller the initial survivor space size.
+.PP
+By default, the initial survivor space ratio is set to 8.
+If the default value for the young generation space size is used (2 MB),
+then the initial size of the survivor space is 0.2 MB.
+.PP
+The following example shows how to set the initial survivor space ratio
+to 4:
+.RS
+.PP
+\f[CB]\-XX:InitialSurvivorRatio=4\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:InitiatingHeapOccupancyPercent=\f[R]\f[I]percent\f[R]
+Sets the percentage of the old generation occupancy (0 to 100) at which
+to start the first few concurrent marking cycles for the G1 garbage
+collector.
+.RS
+.PP
+By default, the initiating value is set to 45%.
+A value of 0 implies nonstop concurrent GC cycles from the beginning
+until G1 adaptively sets this value.
+.PP
+See also the \f[CB]\-XX:G1UseAdaptiveIHOP\f[R] and
+\f[CB]\-XX:G1AdaptiveIHOPNumInitialSamples\f[R] options.
+.PP
+The following example shows how to set the initiating heap occupancy to
+75%:
+.RS
+.PP
+\f[CB]\-XX:InitiatingHeapOccupancyPercent=75\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxGCPauseMillis=\f[R]\f[I]time\f[R]
+Sets a target for the maximum GC pause time (in milliseconds).
+This is a soft goal, and the JVM will make its best effort to achieve
+it.
+The specified value doesn\[aq]t adapt to your heap size.
+By default, for G1 the maximum pause time target is 200 milliseconds.
+The other generational collectors do not use a pause time goal by
+default.
+.RS
+.PP
+The following example shows how to set the maximum target pause time to
+500 ms:
+.RS
+.PP
+\f[CB]\-XX:MaxGCPauseMillis=500\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxHeapSize=\f[R]\f[I]size\f[R]
+Sets the maximum size (in byes) of the memory allocation pool.
+This value must be a multiple of 1024 and greater than 2 MB.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default value is selected at run time based on the system
+configuration.
+For server deployments, the options \f[CB]\-XX:InitialHeapSize\f[R] and
+\f[CB]\-XX:MaxHeapSize\f[R] are often set to the same value.
+.RS
+.PP
+The following examples show how to set the maximum allowed size of
+allocated memory to 80 MB using various units:
+.IP
+.nf
+\f[CB]
+\-XX:MaxHeapSize=83886080
+\-XX:MaxHeapSize=81920k
+\-XX:MaxHeapSize=80m
+\f[R]
+.fi
+.PP
+The \f[CB]\-XX:MaxHeapSize\f[R] option is equivalent to \f[CB]\-Xmx\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:MaxHeapFreeRatio=\f[R]\f[I]percent\f[R]
+Sets the maximum allowed percentage of free heap space (0 to 100) after
+a GC event.
+If free heap space expands above this value, then the heap is shrunk.
+By default, this value is set to 70%.
+.RS
+.PP
+Minimize the Java heap size by lowering the values of the parameters
+\f[CB]MaxHeapFreeRatio\f[R] (default value is 70%) and
+\f[CB]MinHeapFreeRatio\f[R] (default value is 40%) with the command\-line
+options \f[CB]\-XX:MaxHeapFreeRatio\f[R] and
+\f[CB]\-XX:MinHeapFreeRatio\f[R].
+Lowering \f[CB]MaxHeapFreeRatio\f[R] to as low as 10% and
+\f[CB]MinHeapFreeRatio\f[R] to 5% has successfully reduced the heap size
+without too much performance regression; however, results may vary
+greatly depending on your application.
+Try different values for these parameters until they\[aq]re as low as
+possible yet still retain acceptable performance.
+.RS
+.PP
+\f[CB]\-XX:MaxHeapFreeRatio=10\ \-XX:MinHeapFreeRatio=5\f[R]
+.RE
+.PP
+Customers trying to keep the heap small should also add the option
+\f[CB]\-XX:\-ShrinkHeapInSteps\f[R].
+See \f[B]Performance Tuning Examples\f[R] for a description of using this
+option to keep the Java heap small by reducing the dynamic footprint for
+embedded applications.
+.RE
+.TP
+.B \f[CB]\-XX:MaxMetaspaceSize=\f[R]\f[I]size\f[R]
+Sets the maximum amount of native memory that can be allocated for class
+metadata.
+By default, the size isn\[aq]t limited.
+The amount of metadata for an application depends on the application
+itself, other running applications, and the amount of memory available
+on the system.
+.RS
+.PP
+The following example shows how to set the maximum class metadata size
+to 256 MB:
+.RS
+.PP
+\f[CB]\-XX:MaxMetaspaceSize=256m\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxNewSize=\f[R]\f[I]size\f[R]
+Sets the maximum size (in bytes) of the heap for the young generation
+(nursery).
+The default value is set ergonomically.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:MaxRAM=\f[R]\f[I]size\f[R]
+Sets the maximum amount of memory that the JVM may use for the Java heap
+before applying ergonomics heuristics.
+The default value is the maximum amount of available memory to the JVM
+process or 128 GB, whichever is lower.
+.RS
+.PP
+The maximum amount of available memory to the JVM process is the minimum
+of the machine\[aq]s physical memory and any constraints set by the
+environment (e.g.
+container).
+.PP
+Specifying this option disables automatic use of compressed oops if the
+combined result of this and other options influencing the maximum amount
+of memory is larger than the range of memory addressable by compressed
+oops.
+See \f[CB]\-XX:UseCompressedOops\f[R] for further information about
+compressed oops.
+.PP
+The following example shows how to set the maximum amount of available
+memory for sizing the Java heap to 2 GB:
+.RS
+.PP
+\f[CB]\-XX:MaxRAM=2G\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxRAMPercentage=\f[R]\f[I]percent\f[R]
+Sets the maximum amount of memory that the JVM may use for the Java heap
+before applying ergonomics heuristics as a percentage of the maximum
+amount determined as described in the \f[CB]\-XX:MaxRAM\f[R] option.
+The default value is 25 percent.
+.RS
+.PP
+Specifying this option disables automatic use of compressed oops if the
+combined result of this and other options influencing the maximum amount
+of memory is larger than the range of memory addressable by compressed
+oops.
+See \f[CB]\-XX:UseCompressedOops\f[R] for further information about
+compressed oops.
+.PP
+The following example shows how to set the percentage of the maximum
+amount of memory used for the Java heap:
+.RS
+.PP
+\f[CB]\-XX:MaxRAMPercentage=75\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MinRAMPercentage=\f[R]\f[I]percent\f[R]
+Sets the maximum amount of memory that the JVM may use for the Java heap
+before applying ergonomics heuristics as a percentage of the maximum
+amount determined as described in the \f[CB]\-XX:MaxRAM\f[R] option for
+small heaps.
+A small heap is a heap of approximately 125 MB.
+The default value is 50 percent.
+.RS
+.PP
+The following example shows how to set the percentage of the maximum
+amount of memory used for the Java heap for small heaps:
+.RS
+.PP
+\f[CB]\-XX:MinRAMPercentage=75\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MaxTenuringThreshold=\f[R]\f[I]threshold\f[R]
+Sets the maximum tenuring threshold for use in adaptive GC sizing.
+The largest value is 15.
+The default value is 15 for the parallel (throughput) collector.
+.RS
+.PP
+The following example shows how to set the maximum tenuring threshold to
+10:
+.RS
+.PP
+\f[CB]\-XX:MaxTenuringThreshold=10\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:MetaspaceSize=\f[R]\f[I]size\f[R]
+Sets the size of the allocated class metadata space that triggers a
+garbage collection the first time it\[aq]s exceeded.
+This threshold for a garbage collection is increased or decreased
+depending on the amount of metadata used.
+The default size depends on the platform.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:MinHeapFreeRatio=\f[R]\f[I]percent\f[R]
+Sets the minimum allowed percentage of free heap space (0 to 100) after
+a GC event.
+If free heap space falls below this value, then the heap is expanded.
+By default, this value is set to 40%.
+.RS
+.PP
+Minimize Java heap size by lowering the values of the parameters
+\f[CB]MaxHeapFreeRatio\f[R] (default value is 70%) and
+\f[CB]MinHeapFreeRatio\f[R] (default value is 40%) with the command\-line
+options \f[CB]\-XX:MaxHeapFreeRatio\f[R] and
+\f[CB]\-XX:MinHeapFreeRatio\f[R].
+Lowering \f[CB]MaxHeapFreeRatio\f[R] to as low as 10% and
+\f[CB]MinHeapFreeRatio\f[R] to 5% has successfully reduced the heap size
+without too much performance regression; however, results may vary
+greatly depending on your application.
+Try different values for these parameters until they\[aq]re as low as
+possible, yet still retain acceptable performance.
+.RS
+.PP
+\f[CB]\-XX:MaxHeapFreeRatio=10\ \-XX:MinHeapFreeRatio=5\f[R]
+.RE
+.PP
+Customers trying to keep the heap small should also add the option
+\f[CB]\-XX:\-ShrinkHeapInSteps\f[R].
+See \f[B]Performance Tuning Examples\f[R] for a description of using this
+option to keep the Java heap small by reducing the dynamic footprint for
+embedded applications.
+.RE
+.TP
+.B \f[CB]\-XX:MinHeapSize=\f[R]\f[I]size\f[R]
+Sets the minimum size (in bytes) of the memory allocation pool.
+This value must be either 0, or a multiple of 1024 and greater than 1
+MB.
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+The default value is selected at run time based on the system
+configuration.
+.RS
+.PP
+The following examples show how to set the mimimum size of allocated
+memory to 6 MB using various units:
+.IP
+.nf
+\f[CB]
+\-XX:MinHeapSize=6291456
+\-XX:MinHeapSize=6144k
+\-XX:MinHeapSize=6m
+\f[R]
+.fi
+.PP
+If you set this option to 0, then the minimum size is set to the same
+value as the initial size.
+.RE
+.TP
+.B \f[CB]\-XX:NewRatio=\f[R]\f[I]ratio\f[R]
+Sets the ratio between young and old generation sizes.
+By default, this option is set to 2.
+The following example shows how to set the young\-to\-old ratio to 1:
+.RS
+.RS
+.PP
+\f[CB]\-XX:NewRatio=1\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:NewSize=\f[R]\f[I]size\f[R]
+Sets the initial size (in bytes) of the heap for the young generation
+(nursery).
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+.RS
+.PP
+The young generation region of the heap is used for new objects.
+GC is performed in this region more often than in other regions.
+If the size for the young generation is too low, then a large number of
+minor GCs are performed.
+If the size is too high, then only full GCs are performed, which can
+take a long time to complete.
+It is recommended that you keep the size for the young generation
+greater than 25% and less than 50% of the overall heap size.
+.PP
+The following examples show how to set the initial size of the young
+generation to 256 MB using various units:
+.IP
+.nf
+\f[CB]
+\-XX:NewSize=256m
+\-XX:NewSize=262144k
+\-XX:NewSize=268435456
+\f[R]
+.fi
+.PP
+The \f[CB]\-XX:NewSize\f[R] option is equivalent to \f[CB]\-Xmn\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:ParallelGCThreads=\f[R]\f[I]threads\f[R]
+Sets the number of the stop\-the\-world (STW) worker threads.
+The default value depends on the number of CPUs available to the JVM and
+the garbage collector selected.
+.RS
+.PP
+For example, to set the number of threads for G1 GC to 2, specify the
+following option:
+.RS
+.PP
+\f[CB]\-XX:ParallelGCThreads=2\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+ParallelRefProcEnabled\f[R]
+Enables parallel reference processing.
+By default, this option is disabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+PrintAdaptiveSizePolicy\f[R]
+Enables printing of information about adaptive\-generation sizing.
+By default, this option is disabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+ScavengeBeforeFullGC\f[R]
+Enables GC of the young generation before each full GC.
+This option is enabled by default.
+It is recommended that you \f[I]don\[aq]t\f[R] disable it, because
+scavenging the young generation before a full GC can reduce the number
+of objects reachable from the old generation space into the young
+generation space.
+To disable GC of the young generation before each full GC, specify the
+option \f[CB]\-XX:\-ScavengeBeforeFullGC\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:SoftRefLRUPolicyMSPerMB=\f[R]\f[I]time\f[R]
+Sets the amount of time (in milliseconds) a softly reachable object is
+kept active on the heap after the last time it was referenced.
+The default value is one second of lifetime per free megabyte in the
+heap.
+The \f[CB]\-XX:SoftRefLRUPolicyMSPerMB\f[R] option accepts integer values
+representing milliseconds per one megabyte of the current heap size (for
+Java HotSpot Client VM) or the maximum possible heap size (for Java
+HotSpot Server VM).
+This difference means that the Client VM tends to flush soft references
+rather than grow the heap, whereas the Server VM tends to grow the heap
+rather than flush soft references.
+In the latter case, the value of the \f[CB]\-Xmx\f[R] option has a
+significant effect on how quickly soft references are garbage collected.
+.RS
+.PP
+The following example shows how to set the value to 2.5 seconds:
+.PP
+\f[CB]\-XX:SoftRefLRUPolicyMSPerMB=2500\f[R]
+.RE
+.TP
+.B \f[CB]\-XX:\-ShrinkHeapInSteps\f[R]
+Incrementally reduces the Java heap to the target size, specified by the
+option \f[CB]\-XX:MaxHeapFreeRatio\f[R].
+This option is enabled by default.
+If disabled, then it immediately reduces the Java heap to the target
+size instead of requiring multiple garbage collection cycles.
+Disable this option if you want to minimize the Java heap size.
+You will likely encounter performance degradation when this option is
+disabled.
+.RS
+.PP
+See \f[B]Performance Tuning Examples\f[R] for a description of using the
+\f[CB]MaxHeapFreeRatio\f[R] option to keep the Java heap small by reducing
+the dynamic footprint for embedded applications.
+.RE
+.TP
+.B \f[CB]\-XX:StringDeduplicationAgeThreshold=\f[R]\f[I]threshold\f[R]
+Identifies \f[CB]String\f[R] objects reaching the specified age that are
+considered candidates for deduplication.
+An object\[aq]s age is a measure of how many times it has survived
+garbage collection.
+This is sometimes referred to as tenuring.
+.RS
+.RS
+.PP
+\f[B]Note:\f[R] \f[CB]String\f[R] objects that are promoted to an old heap
+region before this age has been reached are always considered candidates
+for deduplication.
+The default value for this option is \f[CB]3\f[R].
+See the \f[CB]\-XX:+UseStringDeduplication\f[R] option.
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:SurvivorRatio=\f[R]\f[I]ratio\f[R]
+Sets the ratio between eden space size and survivor space size.
+By default, this option is set to 8.
+The following example shows how to set the eden/survivor space ratio to
+4:
+.RS
+.RS
+.PP
+\f[CB]\-XX:SurvivorRatio=4\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:TargetSurvivorRatio=\f[R]\f[I]percent\f[R]
+Sets the desired percentage of survivor space (0 to 100) used after
+young garbage collection.
+By default, this option is set to 50%.
+.RS
+.PP
+The following example shows how to set the target survivor space ratio
+to 30%:
+.RS
+.PP
+\f[CB]\-XX:TargetSurvivorRatio=30\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:TLABSize=\f[R]\f[I]size\f[R]
+Sets the initial size (in bytes) of a thread\-local allocation buffer
+(TLAB).
+Append the letter \f[CB]k\f[R] or \f[CB]K\f[R] to indicate kilobytes,
+\f[CB]m\f[R] or \f[CB]M\f[R] to indicate megabytes, or \f[CB]g\f[R] or
+\f[CB]G\f[R] to indicate gigabytes.
+If this option is set to 0, then the JVM selects the initial size
+automatically.
+.RS
+.PP
+The following example shows how to set the initial TLAB size to 512 KB:
+.RS
+.PP
+\f[CB]\-XX:TLABSize=512k\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-XX:+UseAdaptiveSizePolicy\f[R]
+Enables the use of adaptive generation sizing.
+This option is enabled by default.
+To disable adaptive generation sizing, specify
+\f[CB]\-XX:\-UseAdaptiveSizePolicy\f[R] and set the size of the memory
+allocation pool explicitly.
+See the \f[CB]\-XX:SurvivorRatio\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseG1GC\f[R]
+Enables the use of the garbage\-first (G1) garbage collector.
+It\[aq]s a server\-style garbage collector, targeted for multiprocessor
+machines with a large amount of RAM.
+This option meets GC pause time goals with high probability, while
+maintaining good throughput.
+The G1 collector is recommended for applications requiring large heaps
+(sizes of around 6 GB or larger) with limited GC latency requirements (a
+stable and predictable pause time below 0.5 seconds).
+By default, this option is enabled and G1 is used as the default garbage
+collector.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseGCOverheadLimit\f[R]
+Enables the use of a policy that limits the proportion of time spent by
+the JVM on GC before an \f[CB]OutOfMemoryError\f[R] exception is thrown.
+This option is enabled, by default, and the parallel GC will throw an
+\f[CB]OutOfMemoryError\f[R] if more than 98% of the total time is spent on
+garbage collection and less than 2% of the heap is recovered.
+When the heap is small, this feature can be used to prevent applications
+from running for long periods of time with little or no progress.
+To disable this option, specify the option
+\f[CB]\-XX:\-UseGCOverheadLimit\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseNUMA\f[R]
+Enables performance optimization of an application on a machine with
+nonuniform memory architecture (NUMA) by increasing the
+application\[aq]s use of lower latency memory.
+By default, this option is disabled and no optimization for NUMA is
+made.
+The option is available only when the parallel garbage collector is used
+(\f[CB]\-XX:+UseParallelGC\f[R]).
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseParallelGC\f[R]
+Enables the use of the parallel scavenge garbage collector (also known
+as the throughput collector) to improve the performance of your
+application by leveraging multiple processors.
+.RS
+.PP
+By default, this option is disabled and the default collector is used.
+.RE
+.TP
+.B \f[CB]\-XX:+UseSerialGC\f[R]
+Enables the use of the serial garbage collector.
+This is generally the best choice for small and simple applications that
+don\[aq]t require any special functionality from garbage collection.
+By default, this option is disabled and the default collector is used.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseSHM\f[R]
+\f[B]Linux only:\f[R] Enables the JVM to use shared memory to set up
+large pages.
+.RS
+.PP
+See \f[B]Large Pages\f[R] for setting up large pages.
+.RE
+.TP
+.B \f[CB]\-XX:+UseStringDeduplication\f[R]
+Enables string deduplication.
+By default, this option is disabled.
+To use this option, you must enable the garbage\-first (G1) garbage
+collector.
+.RS
+.PP
+String deduplication reduces the memory footprint of \f[CB]String\f[R]
+objects on the Java heap by taking advantage of the fact that many
+\f[CB]String\f[R] objects are identical.
+Instead of each \f[CB]String\f[R] object pointing to its own character
+array, identical \f[CB]String\f[R] objects can point to and share the same
+character array.
+.RE
+.TP
+.B \f[CB]\-XX:+UseTLAB\f[R]
+Enables the use of thread\-local allocation blocks (TLABs) in the young
+generation space.
+This option is enabled by default.
+To disable the use of TLABs, specify the option \f[CB]\-XX:\-UseTLAB\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+UseZGC\f[R]
+Enables the use of the Z garbage collector (ZGC).
+This is a low latency garbage collector, providing max pause times of a
+few milliseconds, at some throughput cost.
+Pause times are independent of what heap size is used.
+Supports heap sizes from 8MB to 16TB.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:ZAllocationSpikeTolerance\f[R]=\f[I]factor\f[R]
+Sets the allocation spike tolerance for ZGC.
+By default, this option is set to 2.0.
+This factor describes the level of allocation spikes to expect.
+For example, using a factor of 3.0 means the current allocation rate can
+be expected to triple at any time.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:ZCollectionInterval\f[R]=\f[I]seconds\f[R]
+Sets the maximum interval (in seconds) between two GC cycles when using
+ZGC.
+By default, this option is set to 0 (disabled).
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:ZFragmentationLimit\f[R]=\f[I]percent\f[R]
+Sets the maximum acceptable heap fragmentation (in percent) for ZGC.
+By default, this option is set to 25.
+Using a lower value will cause the heap to be compacted more
+aggressively, to reclaim more memory at the cost of using more CPU time.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+ZProactive\f[R]
+Enables proactive GC cycles when using ZGC.
+By default, this option is enabled.
+ZGC will start a proactive GC cycle if doing so is expected to have
+minimal impact on the running application.
+This is useful if the application is mostly idle or allocates very few
+objects, but you still want to keep the heap size down and allow
+reference processing to happen even when there are a lot of free space
+on the heap.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+ZUncommit\f[R]
+Enables uncommitting of unused heap memory when using ZGC.
+By default, this option is enabled.
+Uncommitting unused heap memory will lower the memory footprint of the
+JVM, and make that memory available for other processes to use.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:ZUncommitDelay\f[R]=\f[I]seconds\f[R]
+Sets the amount of time (in seconds) that heap memory must have been
+unused before being uncommitted.
+By default, this option is set to 300 (5 minutes).
+Committing and uncommitting memory are relatively expensive operations.
+Using a lower value will cause heap memory to be uncommitted earlier, at
+the risk of soon having to commit it again.
+.RS
+.RE
+.SH DEPRECATED JAVA OPTIONS
+.PP
+These \f[CB]java\f[R] options are deprecated and might be removed in a
+future JDK release.
+They\[aq]re still accepted and acted upon, but a warning is issued when
+they\[aq]re used.
+.TP
+.B \f[CB]\-Xfuture\f[R]
+Enables strict class\-file format checks that enforce close conformance
+to the class\-file format specification.
+Developers should use this flag when developing new code.
+Stricter checks may become the default in future releases.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xloggc:\f[R]\f[I]filename\f[R]
+Sets the file to which verbose GC events information should be
+redirected for logging.
+The \f[CB]\-Xloggc\f[R] option overrides \f[CB]\-verbose:gc\f[R] if both are
+given with the same java command.
+\f[CB]\-Xloggc:\f[R]\f[I]filename\f[R] is replaced by
+\f[CB]\-Xlog:gc:\f[R]\f[I]filename\f[R].
+See Enable Logging with the JVM Unified Logging Framework.
+.RS
+.PP
+Example:
+.PP
+\f[CB]\-Xlog:gc:garbage\-collection.log\f[R]
+.RE
+.TP
+.B \f[CB]\-XX:+FlightRecorder\f[R]
+Enables the use of Java Flight Recorder (JFR) during the runtime of the
+application.
+Since JDK 8u40 this option has not been required to use JFR.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:InitialRAMFraction=\f[R]\f[I]ratio\f[R]
+Sets the initial amount of memory that the JVM may use for the Java heap
+before applying ergonomics heuristics as a ratio of the maximum amount
+determined as described in the \f[CB]\-XX:MaxRAM\f[R] option.
+The default value is 64.
+.RS
+.PP
+Use the option \f[CB]\-XX:InitialRAMPercentage\f[R] instead.
+.RE
+.TP
+.B \f[CB]\-XX:MaxRAMFraction=\f[R]\f[I]ratio\f[R]
+Sets the maximum amount of memory that the JVM may use for the Java heap
+before applying ergonomics heuristics as a fraction of the maximum
+amount determined as described in the \f[CB]\-XX:MaxRAM\f[R] option.
+The default value is 4.
+.RS
+.PP
+Specifying this option disables automatic use of compressed oops if the
+combined result of this and other options influencing the maximum amount
+of memory is larger than the range of memory addressable by compressed
+oops.
+See \f[CB]\-XX:UseCompressedOops\f[R] for further information about
+compressed oops.
+.PP
+Use the option \f[CB]\-XX:MaxRAMPercentage\f[R] instead.
+.RE
+.TP
+.B \f[CB]\-XX:MinRAMFraction=\f[R]\f[I]ratio\f[R]
+Sets the maximum amount of memory that the JVM may use for the Java heap
+before applying ergonomics heuristics as a fraction of the maximum
+amount determined as described in the \f[CB]\-XX:MaxRAM\f[R] option for
+small heaps.
+A small heap is a heap of approximately 125 MB.
+The default value is 2.
+.RS
+.PP
+Use the option \f[CB]\-XX:MinRAMPercentage\f[R] instead.
+.RE
+.TP
+.B \f[CB]\-XX:+UseBiasedLocking\f[R]
+Enables the use of biased locking.
+Some applications with significant amounts of uncontended
+synchronization may attain significant speedups with this flag enabled,
+but applications with certain patterns of locking may see slowdowns.
+.RS
+.PP
+By default, this option is disabled.
+.RE
+.SH OBSOLETE JAVA OPTIONS
+.PP
+These \f[CB]java\f[R] options are still accepted but ignored, and a
+warning is issued when they\[aq]re used.
+.TP
+.B \f[CB]\-\-illegal\-access=\f[R]\f[I]parameter\f[R]
+Controlled \f[I]relaxed strong encapsulation\f[R], as defined in \f[B]JEP
+261\f[R]
+[https://openjdk.java.net/jeps/261#Relaxed\-strong\-encapsulation].
+This option was deprecated in JDK 16 by \f[B]JEP 396\f[R]
+[https://openjdk.java.net/jeps/396] and made obsolete in JDK 17 by
+\f[B]JEP 403\f[R] [https://openjdk.java.net/jeps/403].
+.RS
+.RE
+.SH REMOVED JAVA OPTIONS
+.PP
+These \f[CB]java\f[R] options have been removed in JDK 17 and using them
+results in an error of:
+.RS
+.PP
+\f[CB]Unrecognized\ VM\ option\f[R] \f[I]option\-name\f[R]
+.RE
+.TP
+.B \f[CB]\-XX:+UseMembar\f[R]
+Enabled issuing membars on thread\-state transitions.
+This option was disabled by default on all platforms except ARM servers,
+where it was enabled.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:MaxPermSize=\f[R]\f[I]size\f[R]
+Sets the maximum permanent generation space size (in bytes).
+This option was deprecated in JDK 8 and superseded by the
+\f[CB]\-XX:MaxMetaspaceSize\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:PermSize=\f[R]\f[I]size\f[R]
+Sets the space (in bytes) allocated to the permanent generation that
+triggers a garbage collection if it\[aq]s exceeded.
+This option was deprecated in JDK 8 and superseded by the
+\f[CB]\-XX:MetaspaceSize\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-XX:+TraceClassLoading\f[R]
+Enables tracing of classes as they are loaded.
+By default, this option is disabled and classes aren\[aq]t traced.
+.RS
+.PP
+The replacement Unified Logging syntax is
+\f[CB]\-Xlog:class+load=\f[R]\f[I]level\f[R].
+See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R]
+.PP
+Use \f[I]level\f[R]=\f[CB]info\f[R] for regular information, or
+\f[I]level\f[R]=\f[CB]debug\f[R] for additional information.
+In Unified Logging syntax, \f[CB]\-verbose:class\f[R] equals
+\f[CB]\-Xlog:class+load=info,class+unload=info\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:+TraceClassLoadingPreorder\f[R]
+Enables tracing of all loaded classes in the order in which they\[aq]re
+referenced.
+By default, this option is disabled and classes aren\[aq]t traced.
+.RS
+.PP
+The replacement Unified Logging syntax is
+\f[CB]\-Xlog:class+preorder=debug\f[R].
+See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:+TraceClassResolution\f[R]
+Enables tracing of constant pool resolutions.
+By default, this option is disabled and constant pool resolutions
+aren\[aq]t traced.
+.RS
+.PP
+The replacement Unified Logging syntax is
+\f[CB]\-Xlog:class+resolve=debug\f[R].
+See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R].
+.RE
+.TP
+.B \f[CB]\-XX:+TraceLoaderConstraints\f[R]
+Enables tracing of the loader constraints recording.
+By default, this option is disabled and loader constraints recording
+isn\[aq]t traced.
+.RS
+.PP
+The replacement Unified Logging syntax is
+\f[CB]\-Xlog:class+loader+constraints=info\f[R].
+See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R].
+.RE
+.PP
+For the lists and descriptions of options removed in previous releases
+see the \f[I]Removed Java Options\f[R] section in:
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 16\f[R]
+[https://docs.oracle.com/en/java/javase/16/docs/specs/man/java.html]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 15\f[R]
+[https://docs.oracle.com/en/java/javase/15/docs/specs/man/java.html]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 14\f[R]
+[https://docs.oracle.com/en/java/javase/14/docs/specs/man/java.html]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 13\f[R]
+[https://docs.oracle.com/en/java/javase/13/docs/specs/man/java.html]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 12\f[R]
+[https://docs.oracle.com/en/java/javase/12/tools/java.html#GUID\-3B1CE181\-CD30\-4178\-9602\-230B800D4FAE]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 11\f[R]
+[https://docs.oracle.com/en/java/javase/11/tools/java.html#GUID\-741FC470\-AA3E\-494A\-8D2B\-1B1FE4A990D1]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 10\f[R]
+[https://docs.oracle.com/javase/10/tools/java.htm#JSWOR624]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 9\f[R]
+[https://docs.oracle.com/javase/9/tools/java.htm#JSWOR624]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 8 for
+Oracle JDK on Windows\f[R]
+[https://docs.oracle.com/javase/8/docs/technotes/tools/windows/java.html#BGBCIEFC]
+.IP \[bu] 2
+\f[B]Java Platform, Standard Edition Tools Reference, Release 8 for
+Oracle JDK on Solaris, Linux, and macOS\f[R]
+[https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BGBCIEFC]
+.SH JAVA COMMAND\-LINE ARGUMENT FILES
+.PP
+You can shorten or simplify the \f[CB]java\f[R] command by using
+\f[CB]\@\f[R] argument files to specify one or more text files that
+contain arguments, such as options and class names, which are passed to
+the \f[CB]java\f[R] command.
+This let\[aq]s you to create \f[CB]java\f[R] commands of any length on any
+operating system.
+.PP
+In the command line, use the at sign (\f[CB]\@\f[R]) prefix to identify an
+argument file that contains \f[CB]java\f[R] options and class names.
+When the \f[CB]java\f[R] command encounters a file beginning with the at
+sign (\f[CB]\@\f[R]), it expands the contents of that file into an
+argument list just as they would be specified on the command line.
+.PP
+The \f[CB]java\f[R] launcher expands the argument file contents until it
+encounters the \f[CB]\-\-disable\-\@files\f[R] option.
+You can use the \f[CB]\-\-disable\-\@files\f[R] option anywhere on the
+command line, including in an argument file, to stop \f[CB]\@\f[R]
+argument files expansion.
+.PP
+The following items describe the syntax of \f[CB]java\f[R] argument files:
+.IP \[bu] 2
+The argument file must contain only ASCII characters or characters in
+system default encoding that\[aq]s ASCII friendly, such as UTF\-8.
+.IP \[bu] 2
+The argument file size must not exceed MAXINT (2,147,483,647) bytes.
+.IP \[bu] 2
+The launcher doesn\[aq]t expand wildcards that are present within an
+argument file.
+.IP \[bu] 2
+Use white space or new line characters to separate arguments included in
+the file.
+.IP \[bu] 2
+White space includes a white space character, \f[CB]\\t\f[R],
+\f[CB]\\n\f[R], \f[CB]\\r\f[R], and \f[CB]\\f\f[R].
+.RS 2
+.PP
+For example, it is possible to have a path with a space, such as
+\f[CB]c:\\Program\ Files\f[R] that can be specified as either
+\f[CB]"c:\\\\Program\ Files"\f[R] or, to avoid an escape,
+\f[CB]c:\\Program"\ "Files\f[R].
+.RE
+.IP \[bu] 2
+Any option that contains spaces, such as a path component, must be
+within quotation marks using quotation (\[aq]"\[aq]) characters in its
+entirety.
+.IP \[bu] 2
+A string within quotation marks may contain the characters \f[CB]\\n\f[R],
+\f[CB]\\r\f[R], \f[CB]\\t\f[R], and \f[CB]\\f\f[R].
+They are converted to their respective ASCII codes.
+.IP \[bu] 2
+If a file name contains embedded spaces, then put the whole file name in
+double quotation marks.
+.IP \[bu] 2
+File names in an argument file are relative to the current directory,
+not to the location of the argument file.
+.IP \[bu] 2
+Use the number sign \f[CB]#\f[R] in the argument file to identify
+comments.
+All characters following the \f[CB]#\f[R] are ignored until the end of
+line.
+.IP \[bu] 2
+Additional at sign \f[CB]\@\f[R] prefixes to \f[CB]\@\f[R] prefixed options
+act as an escape, (the first \f[CB]\@\f[R] is removed and the rest of the
+arguments are presented to the launcher literally).
+.IP \[bu] 2
+Lines may be continued using the continuation character (\f[CB]\\\f[R]) at
+the end\-of\-line.
+The two lines are concatenated with the leading white spaces trimmed.
+To prevent trimming the leading white spaces, a continuation character
+(\f[CB]\\\f[R]) may be placed at the first column.
+.IP \[bu] 2
+Because backslash (\\) is an escape character, a backslash character
+must be escaped with another backslash character.
+.IP \[bu] 2
+Partial quote is allowed and is closed by an end\-of\-file.
+.IP \[bu] 2
+An open quote stops at end\-of\-line unless \f[CB]\\\f[R] is the last
+character, which then joins the next line by removing all leading white
+space characters.
+.IP \[bu] 2
+Wildcards (*) aren\[aq]t allowed in these lists (such as specifying
+\f[CB]*.java\f[R]).
+.IP \[bu] 2
+Use of the at sign (\f[CB]\@\f[R]) to recursively interpret files
+isn\[aq]t supported.
+.SS Example of Open or Partial Quotes in an Argument File
+.PP
+In the argument file,
+.IP
+.nf
+\f[CB]
+\-cp\ "lib/
+cool/
+app/
+jars
+\f[R]
+.fi
+.PP
+this is interpreted as:
+.RS
+.PP
+\f[CB]\-cp\ lib/cool/app/jars\f[R]
+.RE
+.SS Example of a Backslash Character Escaped with Another Backslash
+Character in an Argument File
+.PP
+To output the following:
+.RS
+.PP
+\f[CB]\-cp\ c:\\Program\ Files\ (x86)\\Java\\jre\\lib\\ext;c:\\Program\ Files\\Java\\jre9\\lib\\ext\f[R]
+.RE
+.PP
+The backslash character must be specified in the argument file as:
+.RS
+.PP
+\f[CB]\-cp\ "c:\\\\Program\ Files\ (x86)\\\\Java\\\\jre\\\\lib\\\\ext;c:\\\\Program\ Files\\\\Java\\\\jre9\\\\lib\\\\ext"\f[R]
+.RE
+.SS Example of an EOL Escape Used to Force Concatenation of Lines in an
+Argument File
+.PP
+In the argument file,
+.IP
+.nf
+\f[CB]
+\-cp\ "/lib/cool\ app/jars:\\
+\ \ \ \ /lib/another\ app/jars"
+\f[R]
+.fi
+.PP
+This is interpreted as:
+.RS
+.PP
+\f[CB]\-cp\ /lib/cool\ app/jars:/lib/another\ app/jars\f[R]
+.RE
+.SS Example of Line Continuation with Leading Spaces in an Argument File
+.PP
+In the argument file,
+.IP
+.nf
+\f[CB]
+\-cp\ "/lib/cool\\
+\\app/jars???
+\f[R]
+.fi
+.PP
+This is interpreted as:
+.PP
+\f[CB]\-cp\ /lib/cool\ app/jars\f[R]
+.SS Examples of Using Single Argument File
+.PP
+You can use a single argument file, such as \f[CB]myargumentfile\f[R] in
+the following example, to hold all required \f[CB]java\f[R] arguments:
+.RS
+.PP
+\f[CB]java\ \@myargumentfile\f[R]
+.RE
+.SS Examples of Using Argument Files with Paths
+.PP
+You can include relative paths in argument files; however, they\[aq]re
+relative to the current working directory and not to the paths of the
+argument files themselves.
+In the following example, \f[CB]path1/options\f[R] and
+\f[CB]path2/options\f[R] represent argument files with different paths.
+Any relative paths that they contain are relative to the current working
+directory and not to the argument files:
+.RS
+.PP
+\f[CB]java\ \@path1/options\ \@path2/classes\f[R]
+.RE
+.SH CODE HEAP STATE ANALYTICS
+.SS Overview
+.PP
+There are occasions when having insight into the current state of the
+JVM code heap would be helpful to answer questions such as:
+.IP \[bu] 2
+Why was the JIT turned off and then on again and again?
+.IP \[bu] 2
+Where has all the code heap space gone?
+.IP \[bu] 2
+Why is the method sweeper not working effectively?
+.PP
+To provide this insight, a code heap state analytics feature has been
+implemented that enables on\-the\-fly analysis of the code heap.
+The analytics process is divided into two parts.
+The first part examines the entire code heap and aggregates all
+information that is believed to be useful or important.
+The second part consists of several independent steps that print the
+collected information with an emphasis on different aspects of the data.
+Data collection and printing are done on an "on request" basis.
+.SS Syntax
+.PP
+Requests for real\-time, on\-the\-fly analysis can be issued with the
+following command:
+.RS
+.PP
+\f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]Compiler.CodeHeap_Analytics\f[R]
+[\f[I]function\f[R]] [\f[I]granularity\f[R]]
+.RE
+.PP
+If you are only interested in how the code heap looks like after running
+a sample workload, you can use the command line option:
+.RS
+.PP
+\f[CB]\-Xlog:codecache=Trace\f[R]
+.RE
+.PP
+To see the code heap state when a "CodeCache full" condition exists,
+start the VM with the command line option:
+.RS
+.PP
+\f[CB]\-Xlog:codecache=Debug\f[R]
+.RE
+.PP
+See \f[B]CodeHeap State Analytics (OpenJDK)\f[R]
+[https://bugs.openjdk.java.net/secure/attachment/75649/JVM_CodeHeap_StateAnalytics_V2.pdf]
+for a detailed description of the code heap state analytics feature, the
+supported functions, and the granularity options.
+.SH ENABLE LOGGING WITH THE JVM UNIFIED LOGGING FRAMEWORK
+.PP
+You use the \f[CB]\-Xlog\f[R] option to configure or enable logging with
+the Java Virtual Machine (JVM) unified logging framework.
+.SS Synopsis
+.RS
+.PP
+\f[CB]\-Xlog\f[R][\f[CB]:\f[R][\f[I]what\f[R]][\f[CB]:\f[R][\f[I]output\f[R]][\f[CB]:\f[R][\f[I]decorators\f[R]][\f[CB]:\f[R]\f[I]output\-options\f[R][\f[CB],\f[R]...]]]]]
+.PP
+\f[CB]\-Xlog:\f[R]\f[I]directive\f[R]
+.RE
+.TP
+.B \f[I]what\f[R]
+Specifies a combination of tags and levels of the form
+\f[I]tag1\f[R][\f[CB]+\f[R]\f[I]tag2\f[R]...][\f[CB]*\f[R]][\f[CB]=\f[R]\f[I]level\f[R]][\f[CB],\f[R]...].
+Unless the wildcard (\f[CB]*\f[R]) is specified, only log messages tagged
+with exactly the tags specified are matched.
+See \f[B]\-Xlog Tags and Levels\f[R].
+.RS
+.RE
+.TP
+.B \f[I]output\f[R]
+Sets the type of output.
+Omitting the \f[I]output\f[R] type defaults to \f[CB]stdout\f[R].
+See \f[B]\-Xlog Output\f[R].
+.RS
+.RE
+.TP
+.B \f[I]decorators\f[R]
+Configures the output to use a custom set of decorators.
+Omitting \f[I]decorators\f[R] defaults to \f[CB]uptime\f[R],
+\f[CB]level\f[R], and \f[CB]tags\f[R].
+See \f[B]Decorations\f[R].
+.RS
+.RE
+.TP
+.B \f[I]output\-options\f[R]
+Sets the \f[CB]\-Xlog\f[R] logging output options.
+.RS
+.RE
+.TP
+.B \f[I]directive\f[R]
+A global option or subcommand: help, disable, async
+.RS
+.RE
+.SS Description
+.PP
+The Java Virtual Machine (JVM) unified logging framework provides a
+common logging system for all components of the JVM.
+GC logging for the JVM has been changed to use the new logging
+framework.
+The mapping of old GC flags to the corresponding new Xlog configuration
+is described in \f[B]Convert GC Logging Flags to Xlog\f[R].
+In addition, runtime logging has also been changed to use the JVM
+unified logging framework.
+The mapping of legacy runtime logging flags to the corresponding new
+Xlog configuration is described in \f[B]Convert Runtime Logging Flags to
+Xlog\f[R].
+.PP
+The following provides quick reference to the \f[CB]\-Xlog\f[R] command
+and syntax for options:
+.TP
+.B \f[CB]\-Xlog\f[R]
+Enables JVM logging on an \f[CB]info\f[R] level.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:help\f[R]
+Prints \f[CB]\-Xlog\f[R] usage syntax and available tags, levels, and
+decorators along with example command lines with explanations.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:disable\f[R]
+Turns off all logging and clears all configuration of the logging
+framework including the default configuration for warnings and errors.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog\f[R][\f[CB]:\f[R]\f[I]option\f[R]]
+Applies multiple arguments in the order that they appear on the command
+line.
+Multiple \f[CB]\-Xlog\f[R] arguments for the same output override each
+other in their given order.
+.RS
+.PP
+The \f[I]option\f[R] is set as:
+.RS
+.PP
+[\f[I]tag\-selection\f[R]][\f[CB]:\f[R][\f[I]output\f[R]][\f[CB]:\f[R][\f[I]decorators\f[R]][\f[CB]:\f[R]\f[I]output\-options\f[R]]]]
+.RE
+.PP
+Omitting the \f[I]tag\-selection\f[R] defaults to a tag\-set of
+\f[CB]all\f[R] and a level of \f[CB]info\f[R].
+.RS
+.PP
+\f[I]tag\f[R][\f[CB]+\f[R]...] \f[CB]all\f[R]
+.RE
+.PP
+The \f[CB]all\f[R] tag is a meta tag consisting of all tag\-sets
+available.
+The asterisk \f[CB]*\f[R] in a tag set definition denotes a wildcard tag
+match.
+Matching with a wildcard selects all tag sets that contain \f[I]at
+least\f[R] the specified tags.
+Without the wildcard, only exact matches of the specified tag sets are
+selected.
+.PP
+\f[I]output\-options\f[R] is
+.RS
+.PP
+\f[CB]filecount=\f[R]\f[I]file\-count\f[R] \f[CB]filesize=\f[R]\f[I]file size
+with optional K, M or G suffix\f[R]
+.RE
+.RE
+.SS Default Configuration
+.PP
+When the \f[CB]\-Xlog\f[R] option and nothing else is specified on the
+command line, the default configuration is used.
+The default configuration logs all messages with a level that matches
+either warning or error regardless of what tags the message is
+associated with.
+The default configuration is equivalent to entering the following on the
+command line:
+.RS
+.PP
+\f[CB]\-Xlog:all=warning:stdout:uptime,level,tags\f[R]
+.RE
+.SS Controlling Logging at Runtime
+.PP
+Logging can also be controlled at run time through Diagnostic Commands
+(with the \f[B]jcmd\f[R] utility).
+Everything that can be specified on the command line can also be
+specified dynamically with the \f[CB]VM.log\f[R] command.
+As the diagnostic commands are automatically exposed as MBeans, you can
+use JMX to change logging configuration at run time.
+.SS \-Xlog Tags and Levels
+.PP
+Each log message has a level and a tag set associated with it.
+The level of the message corresponds to its details, and the tag set
+corresponds to what the message contains or which JVM component it
+involves (such as, \f[CB]gc\f[R], \f[CB]jit\f[R], or \f[CB]os\f[R]).
+Mapping GC flags to the Xlog configuration is described in \f[B]Convert
+GC Logging Flags to Xlog\f[R].
+Mapping legacy runtime logging flags to the corresponding Xlog
+configuration is described in \f[B]Convert Runtime Logging Flags to
+Xlog\f[R].
+.PP
+\f[B]Available log levels:\f[R]
+.IP \[bu] 2
+\f[CB]off\f[R]
+.IP \[bu] 2
+\f[CB]trace\f[R]
+.IP \[bu] 2
+\f[CB]debug\f[R]
+.IP \[bu] 2
+\f[CB]info\f[R]
+.IP \[bu] 2
+\f[CB]warning\f[R]
+.IP \[bu] 2
+\f[CB]error\f[R]
+.PP
+\f[B]Available log tags:\f[R]
+.PP
+There are literally dozens of log tags, which in the right combinations,
+will enable a range of logging output.
+The full set of available log tags can be seen using
+\f[CB]\-Xlog:help\f[R].
+Specifying \f[CB]all\f[R] instead of a tag combination matches all tag
+combinations.
+.SS \-Xlog Output
+.PP
+The \f[CB]\-Xlog\f[R] option supports the following types of outputs:
+.IP \[bu] 2
+\f[CB]stdout\f[R] \-\-\- Sends output to stdout
+.IP \[bu] 2
+\f[CB]stderr\f[R] \-\-\- Sends output to stderr
+.IP \[bu] 2
+\f[CB]file=\f[R]\f[I]filename\f[R] \-\-\- Sends output to text file(s).
+.PP
+When using \f[CB]file=\f[R]\f[I]filename\f[R], specifying \f[CB]%p\f[R]
+and/or \f[CB]%t\f[R] in the file name expands to the JVM\[aq]s PID and
+startup timestamp, respectively.
+You can also configure text files to handle file rotation based on file
+size and a number of files to rotate.
+For example, to rotate the log file every 10 MB and keep 5 files in
+rotation, specify the options \f[CB]filesize=10M,\ filecount=5\f[R].
+The target size of the files isn\[aq]t guaranteed to be exact, it\[aq]s
+just an approximate value.
+Files are rotated by default with up to 5 rotated files of target size
+20 MB, unless configured otherwise.
+Specifying \f[CB]filecount=0\f[R] means that the log file shouldn\[aq]t be
+rotated.
+There\[aq]s a possibility of the pre\-existing log file getting
+overwritten.
+.SS \-Xlog Output Mode
+.PP
+By default logging messages are output synchronously \- each log message
+is written to the designated output when the logging call is made.
+But you can instead use asynchronous logging mode by specifying:
+.TP
+.B \f[CB]\-Xlog:async\f[R]
+Write all logging asynchronously.
+.RS
+.RE
+.PP
+In asynchronous logging mode, log sites enqueue all logging messages to
+an intermediate buffer and a standalone thread is responsible for
+flushing them to the corresponding outputs.
+The intermediate buffer is bounded and on buffer exhaustion the
+enqueuing message is discarded.
+Log entry write operations are guaranteed non\-blocking.
+.PP
+The option \f[CB]\-XX:AsyncLogBufferSize=N\f[R] specifies the memory
+budget in bytes for the intermediate buffer.
+The default value should be big enough to cater for most cases.
+Users can provide a custom value to trade memory overhead for log
+accuracy if they need to.
+.SS Decorations
+.PP
+Logging messages are decorated with information about the message.
+You can configure each output to use a custom set of decorators.
+The order of the output is always the same as listed in the table.
+You can configure the decorations to be used at run time.
+Decorations are prepended to the log message.
+For example:
+.IP
+.nf
+\f[CB]
+[6.567s][info][gc,old]\ Old\ collection\ complete
+\f[R]
+.fi
+.PP
+Omitting \f[CB]decorators\f[R] defaults to \f[CB]uptime\f[R],
+\f[CB]level\f[R], and \f[CB]tags\f[R].
+The \f[CB]none\f[R] decorator is special and is used to turn off all
+decorations.
+.PP
+\f[CB]time\f[R] (\f[CB]t\f[R]), \f[CB]utctime\f[R] (\f[CB]utc\f[R]),
+\f[CB]uptime\f[R] (\f[CB]u\f[R]), \f[CB]timemillis\f[R] (\f[CB]tm\f[R]),
+\f[CB]uptimemillis\f[R] (\f[CB]um\f[R]), \f[CB]timenanos\f[R] (\f[CB]tn\f[R]),
+\f[CB]uptimenanos\f[R] (\f[CB]un\f[R]), \f[CB]hostname\f[R] (\f[CB]hn\f[R]),
+\f[CB]pid\f[R] (\f[CB]p\f[R]), \f[CB]tid\f[R] (\f[CB]ti\f[R]), \f[CB]level\f[R]
+(\f[CB]l\f[R]), \f[CB]tags\f[R] (\f[CB]tg\f[R]) decorators can also be
+specified as \f[CB]none\f[R] for no decoration.
+.PP
+.TS
+tab(@);
+lw(14.9n) lw(55.1n).
+T{
+Decorations
+T}@T{
+Description
+T}
+_
+T{
+\f[CB]time\f[R] or \f[CB]t\f[R]
+T}@T{
+Current time and date in ISO\-8601 format.
+T}
+T{
+\f[CB]utctime\f[R] or \f[CB]utc\f[R]
+T}@T{
+Universal Time Coordinated or Coordinated Universal Time.
+T}
+T{
+\f[CB]uptime\f[R] or \f[CB]u\f[R]
+T}@T{
+Time since the start of the JVM in seconds and milliseconds.
+For example, 6.567s.
+T}
+T{
+\f[CB]timemillis\f[R] or \f[CB]tm\f[R]
+T}@T{
+The same value as generated by \f[CB]System.currentTimeMillis()\f[R]
+T}
+T{
+\f[CB]uptimemillis\f[R] or \f[CB]um\f[R]
+T}@T{
+Milliseconds since the JVM started.
+T}
+T{
+\f[CB]timenanos\f[R] or \f[CB]tn\f[R]
+T}@T{
+The same value generated by \f[CB]System.nanoTime()\f[R].
+T}
+T{
+\f[CB]uptimenanos\f[R] or \f[CB]un\f[R]
+T}@T{
+Nanoseconds since the JVM started.
+T}
+T{
+\f[CB]hostname\f[R] or \f[CB]hn\f[R]
+T}@T{
+The host name.
+T}
+T{
+\f[CB]pid\f[R] or \f[CB]p\f[R]
+T}@T{
+The process identifier.
+T}
+T{
+\f[CB]tid\f[R] or \f[CB]ti\f[R]
+T}@T{
+The thread identifier.
+T}
+T{
+\f[CB]level\f[R] or \f[CB]l\f[R]
+T}@T{
+The level associated with the log message.
+T}
+T{
+\f[CB]tags\f[R] or \f[CB]tg\f[R]
+T}@T{
+The tag\-set associated with the log message.
+T}
+.TE
+.SS Convert GC Logging Flags to Xlog
+.PP
+.TS
+tab(@);
+lw(22.4n) lw(16.5n) lw(31.2n).
+T{
+Legacy Garbage Collection (GC) Flag
+T}@T{
+Xlog Configuration
+T}@T{
+Comment
+T}
+_
+T{
+\f[CB]G1PrintHeapRegions\f[R]
+T}@T{
+\f[CB]\-Xlog:gc+region=trace\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]GCLogFileSize\f[R]
+T}@T{
+No configuration available
+T}@T{
+Log rotation is handled by the framework.
+T}
+T{
+\f[CB]NumberOfGCLogFiles\f[R]
+T}@T{
+Not Applicable
+T}@T{
+Log rotation is handled by the framework.
+T}
+T{
+\f[CB]PrintAdaptiveSizePolicy\f[R]
+T}@T{
+\f[CB]\-Xlog:gc+ergo*=\f[R]\f[I]level\f[R]
+T}@T{
+Use a \f[I]level\f[R] of \f[CB]debug\f[R] for most of the information, or a
+\f[I]level\f[R] of \f[CB]trace\f[R] for all of what was logged for
+\f[CB]PrintAdaptiveSizePolicy\f[R].
+T}
+T{
+\f[CB]PrintGC\f[R]
+T}@T{
+\f[CB]\-Xlog:gc\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]PrintGCApplicationConcurrentTime\f[R]
+T}@T{
+\f[CB]\-Xlog:safepoint\f[R]
+T}@T{
+Note that \f[CB]PrintGCApplicationConcurrentTime\f[R] and
+\f[CB]PrintGCApplicationStoppedTime\f[R] are logged on the same tag and
+aren\[aq]t separated in the new logging.
+T}
+T{
+\f[CB]PrintGCApplicationStoppedTime\f[R]
+T}@T{
+\f[CB]\-Xlog:safepoint\f[R]
+T}@T{
+Note that \f[CB]PrintGCApplicationConcurrentTime\f[R] and
+\f[CB]PrintGCApplicationStoppedTime\f[R] are logged on the same tag and
+not separated in the new logging.
+T}
+T{
+\f[CB]PrintGCCause\f[R]
+T}@T{
+Not Applicable
+T}@T{
+GC cause is now always logged.
+T}
+T{
+\f[CB]PrintGCDateStamps\f[R]
+T}@T{
+Not Applicable
+T}@T{
+Date stamps are logged by the framework.
+T}
+T{
+\f[CB]PrintGCDetails\f[R]
+T}@T{
+\f[CB]\-Xlog:gc*\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]PrintGCID\f[R]
+T}@T{
+Not Applicable
+T}@T{
+GC ID is now always logged.
+T}
+T{
+\f[CB]PrintGCTaskTimeStamps\f[R]
+T}@T{
+\f[CB]\-Xlog:gc+task*=debug\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]PrintGCTimeStamps\f[R]
+T}@T{
+Not Applicable
+T}@T{
+Time stamps are logged by the framework.
+T}
+T{
+\f[CB]PrintHeapAtGC\f[R]
+T}@T{
+\f[CB]\-Xlog:gc+heap=trace\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]PrintReferenceGC\f[R]
+T}@T{
+\f[CB]\-Xlog:gc+ref*=debug\f[R]
+T}@T{
+Note that in the old logging, \f[CB]PrintReferenceGC\f[R] had an effect
+only if \f[CB]PrintGCDetails\f[R] was also enabled.
+T}
+T{
+\f[CB]PrintStringDeduplicationStatistics\f[R]
+T}@T{
+`\-Xlog:gc+stringdedup*=debug
+T}@T{
+` Not Applicable
+T}
+T{
+\f[CB]PrintTenuringDistribution\f[R]
+T}@T{
+\f[CB]\-Xlog:gc+age*=\f[R]\f[I]level\f[R]
+T}@T{
+Use a \f[I]level\f[R] of \f[CB]debug\f[R] for the most relevant
+information, or a \f[I]level\f[R] of \f[CB]trace\f[R] for all of what was
+logged for \f[CB]PrintTenuringDistribution\f[R].
+T}
+T{
+\f[CB]UseGCLogFileRotation\f[R]
+T}@T{
+Not Applicable
+T}@T{
+What was logged for \f[CB]PrintTenuringDistribution\f[R].
+T}
+.TE
+.SS Convert Runtime Logging Flags to Xlog
+.PP
+These legacy flags are no longer recognized and will cause an error if
+used directly.
+Use their unified logging equivalent instead.
+.PP
+.TS
+tab(@);
+lw(15.0n) lw(20.2n) lw(34.7n).
+T{
+Legacy Runtime Flag
+T}@T{
+Xlog Configuration
+T}@T{
+Comment
+T}
+_
+T{
+\f[CB]TraceExceptions\f[R]
+T}@T{
+\f[CB]\-Xlog:exceptions=info\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceClassLoading\f[R]
+T}@T{
+\f[CB]\-Xlog:class+load=\f[R]\f[I]level\f[R]
+T}@T{
+Use \f[I]level\f[R]=\f[CB]info\f[R] for regular information, or
+\f[I]level\f[R]=\f[CB]debug\f[R] for additional information.
+In Unified Logging syntax, \f[CB]\-verbose:class\f[R] equals
+\f[CB]\-Xlog:class+load=info,class+unload=info\f[R].
+T}
+T{
+\f[CB]TraceClassLoadingPreorder\f[R]
+T}@T{
+\f[CB]\-Xlog:class+preorder=debug\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceClassUnloading\f[R]
+T}@T{
+\f[CB]\-Xlog:class+unload=\f[R]\f[I]level\f[R]
+T}@T{
+Use \f[I]level\f[R]=\f[CB]info\f[R] for regular information, or
+\f[I]level\f[R]=\f[CB]trace\f[R] for additional information.
+In Unified Logging syntax, \f[CB]\-verbose:class\f[R] equals
+\f[CB]\-Xlog:class+load=info,class+unload=info\f[R].
+T}
+T{
+\f[CB]VerboseVerification\f[R]
+T}@T{
+\f[CB]\-Xlog:verification=info\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceClassPaths\f[R]
+T}@T{
+\f[CB]\-Xlog:class+path=info\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceClassResolution\f[R]
+T}@T{
+\f[CB]\-Xlog:class+resolve=debug\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceClassInitialization\f[R]
+T}@T{
+\f[CB]\-Xlog:class+init=info\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceLoaderConstraints\f[R]
+T}@T{
+\f[CB]\-Xlog:class+loader+constraints=info\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceClassLoaderData\f[R]
+T}@T{
+\f[CB]\-Xlog:class+loader+data=\f[R]\f[I]level\f[R]
+T}@T{
+Use \f[I]level\f[R]=\f[CB]debug\f[R] for regular information or
+\f[I]level\f[R]=\f[CB]trace\f[R] for additional information.
+T}
+T{
+\f[CB]TraceSafepointCleanupTime\f[R]
+T}@T{
+\f[CB]\-Xlog:safepoint+cleanup=info\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceSafepoint\f[R]
+T}@T{
+\f[CB]\-Xlog:safepoint=debug\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceMonitorInflation\f[R]
+T}@T{
+\f[CB]\-Xlog:monitorinflation=debug\f[R]
+T}@T{
+Not Applicable
+T}
+T{
+\f[CB]TraceBiasedLocking\f[R]
+T}@T{
+\f[CB]\-Xlog:biasedlocking=\f[R]\f[I]level\f[R]
+T}@T{
+Use \f[I]level\f[R]=\f[CB]info\f[R] for regular information, or
+\f[I]level\f[R]=\f[CB]trace\f[R] for additional information.
+T}
+T{
+\f[CB]TraceRedefineClasses\f[R]
+T}@T{
+\f[CB]\-Xlog:redefine+class*=\f[R]\f[I]level\f[R]
+T}@T{
+\f[I]level\f[R]=\f[CB]info\f[R], \f[CB]debug\f[R], and \f[CB]trace\f[R] provide
+increasing amounts of information.
+T}
+.TE
+.SS \-Xlog Usage Examples
+.PP
+The following are \f[CB]\-Xlog\f[R] examples.
+.TP
+.B \f[CB]\-Xlog\f[R]
+Logs all messages by using the \f[CB]info\f[R] level to \f[CB]stdout\f[R]
+with \f[CB]uptime\f[R], \f[CB]levels\f[R], and \f[CB]tags\f[R] decorations.
+This is equivalent to using:
+.RS
+.RS
+.PP
+\f[CB]\-Xlog:all=info:stdout:uptime,levels,tags\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-Xlog:gc\f[R]
+Logs messages tagged with the \f[CB]gc\f[R] tag using \f[CB]info\f[R] level
+to \f[CB]stdout\f[R].
+The default configuration for all other messages at level
+\f[CB]warning\f[R] is in effect.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:gc,safepoint\f[R]
+Logs messages tagged either with the \f[CB]gc\f[R] or \f[CB]safepoint\f[R]
+tags, both using the \f[CB]info\f[R] level, to \f[CB]stdout\f[R], with
+default decorations.
+Messages tagged with both \f[CB]gc\f[R] and \f[CB]safepoint\f[R] won\[aq]t
+be logged.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:gc+ref=debug\f[R]
+Logs messages tagged with both \f[CB]gc\f[R] and \f[CB]ref\f[R] tags, using
+the \f[CB]debug\f[R] level to \f[CB]stdout\f[R], with default decorations.
+Messages tagged only with one of the two tags won\[aq]t be logged.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:gc=debug:file=gc.txt:none\f[R]
+Logs messages tagged with the \f[CB]gc\f[R] tag using the \f[CB]debug\f[R]
+level to a file called \f[CB]gc.txt\f[R] with no decorations.
+The default configuration for all other messages at level
+\f[CB]warning\f[R] is still in effect.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:gc=trace:file=gctrace.txt:uptimemillis,pids:filecount=5,filesize=1024\f[R]
+Logs messages tagged with the \f[CB]gc\f[R] tag using the \f[CB]trace\f[R]
+level to a rotating file set with 5 files with size 1 MB with the base
+name \f[CB]gctrace.txt\f[R] and uses decorations \f[CB]uptimemillis\f[R] and
+\f[CB]pid\f[R].
+.RS
+.PP
+The default configuration for all other messages at level
+\f[CB]warning\f[R] is still in effect.
+.RE
+.TP
+.B \f[CB]\-Xlog:gc::uptime,tid\f[R]
+Logs messages tagged with the \f[CB]gc\f[R] tag using the default
+\[aq]info\[aq] level to default the output \f[CB]stdout\f[R] and uses
+decorations \f[CB]uptime\f[R] and \f[CB]tid\f[R].
+The default configuration for all other messages at level
+\f[CB]warning\f[R] is still in effect.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:gc*=info,safepoint*=off\f[R]
+Logs messages tagged with at least \f[CB]gc\f[R] using the \f[CB]info\f[R]
+level, but turns off logging of messages tagged with \f[CB]safepoint\f[R].
+Messages tagged with both \f[CB]gc\f[R] and \f[CB]safepoint\f[R] won\[aq]t
+be logged.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:disable\ \-Xlog:safepoint=trace:safepointtrace.txt\f[R]
+Turns off all logging, including warnings and errors, and then enables
+messages tagged with \f[CB]safepoint\f[R]using \f[CB]trace\f[R]level to the
+file \f[CB]safepointtrace.txt\f[R].
+The default configuration doesn\[aq]t apply, because the command line
+started with \f[CB]\-Xlog:disable\f[R].
+.RS
+.RE
+.SS Complex \-Xlog Usage Examples
+.PP
+The following describes a few complex examples of using the
+\f[CB]\-Xlog\f[R] option.
+.TP
+.B \f[CB]\-Xlog:gc+class*=debug\f[R]
+Logs messages tagged with at least \f[CB]gc\f[R] and \f[CB]class\f[R] tags
+using the \f[CB]debug\f[R] level to \f[CB]stdout\f[R].
+The default configuration for all other messages at the level
+\f[CB]warning\f[R] is still in effect
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:gc+meta*=trace,class*=off:file=gcmetatrace.txt\f[R]
+Logs messages tagged with at least the \f[CB]gc\f[R] and \f[CB]meta\f[R]
+tags using the \f[CB]trace\f[R] level to the file \f[CB]metatrace.txt\f[R]
+but turns off all messages tagged with \f[CB]class\f[R].
+Messages tagged with \f[CB]gc\f[R], \f[CB]meta\f[R], and \f[CB]class\f[R]
+aren\[aq]t be logged as \f[CB]class*\f[R] is set to off.
+The default configuration for all other messages at level
+\f[CB]warning\f[R] is in effect except for those that include
+\f[CB]class\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:gc+meta=trace\f[R]
+Logs messages tagged with exactly the \f[CB]gc\f[R] and \f[CB]meta\f[R] tags
+using the \f[CB]trace\f[R] level to \f[CB]stdout\f[R].
+The default configuration for all other messages at level
+\f[CB]warning\f[R] is still be in effect.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlog:gc+class+heap*=debug,meta*=warning,threads*=off\f[R]
+Logs messages tagged with at least \f[CB]gc\f[R], \f[CB]class\f[R], and
+\f[CB]heap\f[R] tags using the \f[CB]trace\f[R] level to \f[CB]stdout\f[R] but
+only log messages tagged with \f[CB]meta\f[R] with level.
+The default configuration for all other messages at the level
+\f[CB]warning\f[R] is in effect except for those that include
+\f[CB]threads\f[R].
+.RS
+.RE
+.SH VALIDATE JAVA VIRTUAL MACHINE FLAG ARGUMENTS
+.PP
+You use values provided to all Java Virtual Machine (JVM) command\-line
+flags for validation and, if the input value is invalid or
+out\-of\-range, then an appropriate error message is displayed.
+.PP
+Whether they\[aq]re set ergonomically, in a command line, by an input
+tool, or through the APIs (for example, classes contained in the package
+\f[CB]java.lang.management\f[R]) the values provided to all Java Virtual
+Machine (JVM) command\-line flags are validated.
+Ergonomics are described in Java Platform, Standard Edition HotSpot
+Virtual Machine Garbage Collection Tuning Guide.
+.PP
+Range and constraints are validated either when all flags have their
+values set during JVM initialization or a flag\[aq]s value is changed
+during runtime (for example using the \f[CB]jcmd\f[R] tool).
+The JVM is terminated if a value violates either the range or constraint
+check and an appropriate error message is printed on the error stream.
+.PP
+For example, if a flag violates a range or a constraint check, then the
+JVM exits with an error:
+.IP
+.nf
+\f[CB]
+java\ \-XX:AllocatePrefetchStyle=5\ \-version
+intx\ AllocatePrefetchStyle=5\ is\ outside\ the\ allowed\ range\ [\ 0\ ...\ 3\ ]
+Improperly\ specified\ VM\ option\ \[aq]AllocatePrefetchStyle=5\[aq]
+Error:\ Could\ not\ create\ the\ Java\ Virtual\ Machine.
+Error:\ A\ fatal\ exception\ has\ occurred.\ Program\ will\ exit.
+\f[R]
+.fi
+.PP
+The flag \f[CB]\-XX:+PrintFlagsRanges\f[R] prints the range of all the
+flags.
+This flag allows automatic testing of the flags by the values provided
+by the ranges.
+For the flags that have the ranges specified, the type, name, and the
+actual range is printed in the output.
+.PP
+For example,
+.IP
+.nf
+\f[CB]
+intx\ \ \ ThreadStackSize\ [\ 0\ ...\ 9007199254740987\ ]\ {pd\ product}
+\f[R]
+.fi
+.PP
+For the flags that don\[aq]t have the range specified, the values
+aren\[aq]t displayed in the print out.
+For example:
+.IP
+.nf
+\f[CB]
+size_t\ NewSize\ \ \ \ \ \ \ \ \ [\ \ \ ...\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ ]\ {product}
+\f[R]
+.fi
+.PP
+This helps to identify the flags that need to be implemented.
+The automatic testing framework can skip those flags that don\[aq]t have
+values and aren\[aq]t implemented.
+.SH LARGE PAGES
+.PP
+You use large pages, also known as huge pages, as memory pages that are
+significantly larger than the standard memory page size (which varies
+depending on the processor and operating system).
+Large pages optimize processor Translation\-Lookaside Buffers.
+.PP
+A Translation\-Lookaside Buffer (TLB) is a page translation cache that
+holds the most\-recently used virtual\-to\-physical address
+translations.
+A TLB is a scarce system resource.
+A TLB miss can be costly because the processor must then read from the
+hierarchical page table, which may require multiple memory accesses.
+By using a larger memory page size, a single TLB entry can represent a
+larger memory range.
+This results in less pressure on a TLB, and memory\-intensive
+applications may have better performance.
+.PP
+However, using large pages can negatively affect system performance.
+For example, when a large amount of memory is pinned by an application,
+it may create a shortage of regular memory and cause excessive paging in
+other applications and slow down the entire system.
+Also, a system that has been up for a long time could produce excessive
+fragmentation, which could make it impossible to reserve enough large
+page memory.
+When this happens, either the OS or JVM reverts to using regular pages.
+.PP
+Linux and Windows support large pages.
+.SS Large Pages Support for Linux
+.PP
+Linux supports large pages since version 2.6.
+To check if your environment supports large pages, try the following:
+.IP
+.nf
+\f[CB]
+#\ cat\ /proc/meminfo\ |\ grep\ Huge
+HugePages_Total:\ 0
+HugePages_Free:\ 0
+\&...
+Hugepagesize:\ 2048\ kB
+\f[R]
+.fi
+.PP
+If the output contains items prefixed with "Huge", then your system
+supports large pages.
+The values may vary depending on environment.
+The \f[CB]Hugepagesize\f[R] field shows the default large page size in
+your environment, and the other fields show details for large pages of
+this size.
+Newer kernels have support for multiple large page sizes.
+To list the supported page sizes, run this:
+.IP
+.nf
+\f[CB]
+#\ ls\ /sys/kernel/mm/hugepages/
+hugepages\-1048576kB\ \ hugepages\-2048kB
+\f[R]
+.fi
+.PP
+The above environment supports 2 MB and 1 GB large pages, but they need
+to be configured so that the JVM can use them.
+When using large pages and not enabling transparent huge pages (option
+\f[CB]\-XX:+UseTransparentHugePages\f[R]), the number of large pages must
+be pre\-allocated.
+For example, to enable 8 GB of memory to be backed by 2 MB large pages,
+login as \f[CB]root\f[R] and run:
+.RS
+.PP
+\f[CB]#\ echo\ 4096\ >\ /sys/kernel/mm/hugepages/hugepages\-2048kB/nr_hugepages\f[R]
+.RE
+.PP
+It is always recommended to check the value of \f[CB]nr_hugepages\f[R]
+after the request to make sure the kernel was able to allocate the
+requested number of large pages.
+.PP
+When using the option \f[CB]\-XX:+UseSHM\f[R] to enable large pages you
+also need to make sure the \f[CB]SHMMAX\f[R] parameter is configured to
+allow large enough shared memory segments to be allocated.
+To allow a maximum shared segment of 8 GB, login as \f[CB]root\f[R] and
+run:
+.RS
+.PP
+\f[CB]#\ echo\ 8589934592\ >\ /proc/sys/kernel/shmmax\f[R]
+.RE
+.PP
+In some environments this is not needed since the default value is large
+enough, but it is important to make sure the value is large enough to
+fit the amount of memory intended to be backed by large pages.
+.RS
+.PP
+\f[B]Note:\f[R] The values contained in \f[CB]/proc\f[R] and \f[CB]/sys\f[R]
+reset after you reboot your system, so may want to set them in an
+initialization script (for example, \f[CB]rc.local\f[R] or
+\f[CB]sysctl.conf\f[R]).
+.RE
+.PP
+If you configure the OS kernel parameters to enable use of large pages,
+the Java processes may allocate large pages for the Java heap as well as
+other internal areas, for example:
+.IP \[bu] 2
+Code cache
+.IP \[bu] 2
+Marking bitmaps
+.PP
+Consequently, if you configure the \f[CB]nr_hugepages\f[R] parameter to
+the size of the Java heap, then the JVM can still fail to allocate the
+heap using large pages because other areas such as the code cache might
+already have used some of the configured large pages.
+.SS Large Pages Support for Windows
+.PP
+To use large pages support on Windows, the administrator must first
+assign additional privileges to the user who is running the application:
+.IP "1." 3
+Select \f[B]Control Panel\f[R], \f[B]Administrative Tools\f[R], and then
+\f[B]Local Security Policy\f[R].
+.IP "2." 3
+Select \f[B]Local Policies\f[R] and then \f[B]User Rights Assignment\f[R].
+.IP "3." 3
+Double\-click \f[B]Lock pages in memory\f[R], then add users and/or
+groups.
+.IP "4." 3
+Reboot your system.
+.PP
+Note that these steps are required even if it\[aq]s the administrator
+who\[aq]s running the application, because administrators by default
+don\[aq]t have the privilege to lock pages in memory.
+.SH APPLICATION CLASS DATA SHARING
+.PP
+Application Class Data Sharing (AppCDS) stores classes used by your
+applications in an archive file.
+Since these classes are stored in a format that can be loaded very
+quickly (compared to classes stored in a JAR file), AppCDS can improve
+the start\-up time of your applications.
+In addition, AppCDS can reduce the runtime memory footprint by sharing
+parts of these classes across multiple processes.
+.PP
+Classes in the CDS archive are stored in an optimized format that\[aq]s
+about 2 to 5 times larger than classes stored in JAR files or the JDK
+runtime image.
+Therefore, it\[aq]s a good idea to archive only those classes that are
+actually used by your application.
+These usually are just a small portion of all available classes.
+For example, your application may use only a few APIs provided by a
+large library.
+.SS Using CDS Archives
+.PP
+By default, in most JDK distributions, unless \f[CB]\-Xshare:off\f[R] is
+specified, the JVM starts up with a default CDS archive, which is
+usually located in \f[CB]JAVA_HOME/lib/server/classes.jsa\f[R] (or
+\f[CB]JAVA_HOME\\bin\\server\\classes.jsa\f[R] on Windows).
+This archive contains about 1300 core library classes that are used by
+most applications.
+.PP
+To use CDS for the exact set of classes used by your application, you
+can use the \f[CB]\-XX:SharedArchiveFile\f[R] option, which has the
+general form:
+.RS
+.PP
+\f[CB]\-XX:SharedArchiveFile=<static_archive>:<dynamic_archive>\f[R]
+.RE
+.IP \[bu] 2
+The \f[CB]<static_archive>\f[R] overrides the default CDS archive.
+.IP \[bu] 2
+The \f[CB]<dynamic_archive>\f[R] provides additional classes that can be
+loaded on top of those in the \f[CB]<static_archive>\f[R].
+.IP \[bu] 2
+On Windows, the above path delimiter \f[CB]:\f[R] should be replaced with
+\f[CB];\f[R]
+.PP
+(The names "static" and "dyanmic" are used for historical reasons.
+The only significance is that the "static" archive is loaded first and
+the "dynamic" archive is loaded second).
+.PP
+The JVM can use up to two archives.
+To use only a single \f[CB]<static_archive>\f[R], you can omit the
+\f[CB]<dynamic_archive>\f[R] portion:
+.RS
+.PP
+\f[CB]\-XX:SharedArchiveFile=<static_archive>\f[R]
+.RE
+.PP
+For convenience, the \f[CB]<dynamic_archive>\f[R] records the location of
+the \f[CB]<static_archive>\f[R].
+Therefore, you can omit the \f[CB]<static_archive>\f[R] by saying only:
+.RS
+.PP
+\f[CB]\-XX:SharedArchiveFile=<dynamic_archive>\f[R]
+.RE
+.SS Creating CDS Archives
+.PP
+CDS archives can be created with several methods:
+.IP \[bu] 2
+\f[CB]\-Xshare:dump\f[R]
+.IP \[bu] 2
+\f[CB]\-XX:ArchiveClassesAtExit\f[R]
+.IP \[bu] 2
+\f[CB]jcmd\ VM.cds\f[R]
+.PP
+One common operation in all these methods is a "trial run", where you
+run the application once to determine the classes that should be stored
+in the archive.
+.SS Creating a Static CDS Archive File with \-Xshare:dump
+.PP
+The following steps create a static CDS archive file that contains all
+the classes used by the \f[CB]test.Hello\f[R] application.
+.IP "1." 3
+Create a list of all classes used by the \f[CB]test.Hello\f[R]
+application.
+The following command creates a file named \f[CB]hello.classlist\f[R] that
+contains a list of all classes used by this application:
+.RS 4
+.RS
+.PP
+\f[CB]java\ \-Xshare:off\ \-XX:DumpLoadedClassList=hello.classlist\ \-cp\ hello.jar\ test.Hello\f[R]
+.RE
+.PP
+The classpath specified by the \f[CB]\-cp\f[R] parameter must contain only
+JAR files.
+.RE
+.IP "2." 3
+Create a static archive, named \f[CB]hello.jsa\f[R], that contains all the
+classes in \f[CB]hello.classlist\f[R]:
+.RS 4
+.RS
+.PP
+\f[CB]java\ \-Xshare:dump\ \-XX:SharedArchiveFile=hello.jsa\ \-XX:SharedClassListFile=hello.classlist\ \-cp\ hello.jar\f[R]
+.RE
+.RE
+.IP "3." 3
+Run the application \f[CB]test.Hello\f[R] with the archive
+\f[CB]hello.jsa\f[R]:
+.RS 4
+.RS
+.PP
+\f[CB]java\ \-XX:SharedArchiveFile=hello.jsa\ \-cp\ hello.jar\ test.Hello\f[R]
+.RE
+.RE
+.IP "4." 3
+\f[B]Optional\f[R] Verify that the \f[CB]test.Hello\f[R] application is
+using the class contained in the \f[CB]hello.jsa\f[R] shared archive:
+.RS 4
+.RS
+.PP
+\f[CB]java\ \-XX:SharedArchiveFile=hello.jsa\ \-cp\ hello.jar\ \-Xlog:class+load\ test.Hello\f[R]
+.RE
+.PP
+The output of this command should contain the following text:
+.RS
+.PP
+\f[CB][info][class,load]\ test.Hello\ source:\ shared\ objects\ file\f[R]
+.RE
+.RE
+.SS Creating a Dynamic CDS Archive File with \-XX:SharedArchiveFile
+.PP
+Advantages of dynamic CDS archives are:
+.IP \[bu] 2
+They usually use less disk space, since they don\[aq]t need to store the
+classes that are already in the static archive.
+.IP \[bu] 2
+They are created with one fewer step than the comparable static archive.
+.PP
+The following steps create a dynamic CDS archive file that contains the
+classes that are used by the \f[CB]test.Hello\f[R] application, excluding
+those that are already in the default CDS archive.
+.IP "1." 3
+Create a dynamic CDS archive, named \f[CB]hello.jsa\f[R], that contains
+all the classes in \f[CB]hello.jar\f[R] loaded by the application
+\f[CB]test.Hello\f[R]:
+.RS 4
+.RS
+.PP
+\f[CB]java\ \-XX:ArchiveClassesAtExit=hello.jsa\ \-cp\ hello.jar\ Hello\f[R]
+.RE
+.RE
+.IP "2." 3
+Run the application \f[CB]test.Hello\f[R] with the shared archive
+\f[CB]hello.jsa\f[R]:
+.RS 4
+.RS
+.PP
+\f[CB]java\ \-XX:SharedArchiveFile=hello.jsa\ \-cp\ hello.jar\ test.Hello\f[R]
+.RE
+.RE
+.IP "3." 3
+\f[B]Optional\f[R] Repeat step 4 of the previous section to verify that
+the \f[CB]test.Hello\f[R] application is using the class contained in the
+\f[CB]hello.jsa\f[R] shared archive.
+.PP
+It\[aq]s also possible to create a dynamic CDS archive with a
+non\-default static CDS archive.
+E.g.,
+.RS
+.PP
+\f[CB]java\ \-XX:SharedArchiveFile=base.jsa\ \-XX:ArchiveClassesAtExit=hello.jsa\ \-cp\ hello.jar\ Hello\f[R]
+.RE
+.PP
+To run the application using this dynamic CDS archive:
+.RS
+.PP
+\f[CB]java\ \-XX:SharedArchiveFile=base.jsa:hello.jsa\ \-cp\ hello.jar\ Hello\f[R]
+.RE
+.PP
+(On Windows, the above path delimiter \f[CB]:\f[R] should be replaced with
+\f[CB];\f[R])
+.PP
+As mention above, the name of the static archive can be skipped:
+.RS
+.PP
+\f[CB]java\ \-XX:SharedArchiveFile=hello.jsa\ \-cp\ hello.jar\ Hello\f[R]
+.RE
+.SS Creating CDS Archive Files with jcmd
+.PP
+The previous two sections require you to modify the application\[aq]s
+start\-up script in order to create a CDS archive.
+Sometimes this could be difficult, for example, if the application\[aq]s
+class path is set up by complex routines.
+.PP
+The \f[CB]jcmd\ VM.cds\f[R] command provides a less intrusive way for
+creating a CDS archive by connecting to a running JVM process.
+You can create either a static:
+.RS
+.PP
+\f[CB]jcmd\ <pid>\ VM.cds\ static_dump\ my_static_archive.jsa\f[R]
+.RE
+.PP
+or a dynamic archive:
+.RS
+.PP
+\f[CB]jcmd\ <pid>\ VM.cds\ dynamic_dump\ my_dynamic_archive.jsa\f[R]
+.RE
+.PP
+To use the resulting archive file in a subsequent run of the application
+without modifying the application\[aq]s start\-up script, you can use
+the following technique:
+.RS
+.PP
+\f[CB]env\ JAVA_TOOL_OPTIONS=\-XX:SharedArchiveFile=my_static_archive.jsa\ bash\ app_start.sh\f[R]
+.RE
+.PP
+Note: to use \f[CB]jcmd\ <pid>\ VM.cds\ dynamic_dump\f[R], the JVM process
+identified by \f[CB]<pid>\f[R] must be started with
+\f[CB]\-XX:+RecordDynamicDumpInfo\f[R], which can also be passed to the
+application start\-up script with the same technique:
+.RS
+.PP
+\f[CB]env\ JAVA_TOOL_OPTIONS=\-XX:+RecordDynamicDumpInfo\ bash\ app_start.sh\f[R]
+.RE
+.SS Restrictions on Class Path and Module Path
+.IP \[bu] 2
+Neither the class path (\f[CB]\-classpath\f[R] and
+\f[CB]\-Xbootclasspath/a\f[R]) nor the module path
+(\f[CB]\-\-module\-path\f[R]) can contain non\-empty directories.
+.IP \[bu] 2
+Only modular JAR files are supported in \f[CB]\-\-module\-path\f[R].
+Exploded modules are not supported.
+.IP \[bu] 2
+The class path used at archive creation time must be the same as (or a
+prefix of) the class path used at run time.
+(There\[aq]s no such requirement for the module path.)
+.IP \[bu] 2
+The CDS archive cannot be loaded if any JAR files in the class path or
+module path are modified after the archive is generated.
+.IP \[bu] 2
+If any of the VM options \f[CB]\-\-upgrade\-module\-path\f[R],
+\f[CB]\-\-patch\-module\f[R] or \f[CB]\-\-limit\-modules\f[R] are specified,
+CDS is disabled.
+This means that the JVM will execute without loading any CDS archives.
+In addition, if you try to create a CDS archive with any of these 3
+options specified, the JVM will report an error.
+.SH PERFORMANCE TUNING EXAMPLES
+.PP
+You can use the Java advanced runtime options to optimize the
+performance of your applications.
+.SS Tuning for Higher Throughput
+.PP
+Use the following commands and advanced options to achieve higher
+throughput performance for your application:
+.RS
+.PP
+\f[CB]java\ \-server\ \-XX:+UseParallelGC\ \-XX:+UseLargePages\ \-Xmn10g\ \ \-Xms26g\ \-Xmx26g\f[R]
+.RE
+.SS Tuning for Lower Response Time
+.PP
+Use the following commands and advanced options to achieve lower
+response times for your application:
+.RS
+.PP
+\f[CB]java\ \-XX:+UseG1GC\ \-XX:MaxGCPauseMillis=100\f[R]
+.RE
+.SS Keeping the Java Heap Small and Reducing the Dynamic Footprint of
+Embedded Applications
+.PP
+Use the following advanced runtime options to keep the Java heap small
+and reduce the dynamic footprint of embedded applications:
+.RS
+.PP
+\f[CB]\-XX:MaxHeapFreeRatio=10\ \-XX:MinHeapFreeRatio=5\f[R]
+.RE
+.RS
+.PP
+\f[B]Note:\f[R] The defaults for these two options are 70% and 40%
+respectively.
+Because performance sacrifices can occur when using these small
+settings, you should optimize for a small footprint by reducing these
+settings as much as possible without introducing unacceptable
+performance degradation.
+.RE
+.SH EXIT STATUS
+.PP
+The following exit values are typically returned by the launcher when
+the launcher is called with the wrong arguments, serious errors, or
+exceptions thrown by the JVM.
+However, a Java application may choose to return any value by using the
+API call \f[CB]System.exit(exitValue)\f[R].
+The values are:
+.IP \[bu] 2
+\f[CB]0\f[R]: Successful completion
+.IP \[bu] 2
+\f[CB]>0\f[R]: An error occurred
diff --git a/java/temurin-17/man/man1/javac.1 b/java/temurin-17/man/man1/javac.1
new file mode 100644
index 0000000..6b85df5
--- /dev/null
+++ b/java/temurin-17/man/man1/javac.1
@@ -0,0 +1,2381 @@
+.\" Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JAVAC" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+javac \- read Java declarations and compile them into class files
+.SH SYNOPSIS
+.PP
+\f[CB]javac\f[R] [\f[I]options\f[R]] [\f[I]sourcefiles\-or\-classnames\f[R]]
+.TP
+.B \f[I]options\f[R]
+Command\-line options.
+.RS
+.RE
+.TP
+.B \f[I]sourcefiles\-or\-classnames\f[R]
+Source files to be compiled (for example, \f[CB]Shape.java\f[R]) or the
+names of previously compiled classes to be processed for annotations
+(for example, \f[CB]geometry.MyShape\f[R]).
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]javac\f[R] command reads \f[I]source files\f[R] that contain
+module, package and type declarations written in the Java programming
+language, and compiles them into \f[I]class files\f[R] that run on the
+Java Virtual Machine.
+.PP
+The \f[CB]javac\f[R] command can also \f[B]process annotations\f[R] in Java
+source files and classes.
+.PP
+Source files must have a file name extension of \f[CB]\&.java\f[R].
+Class files have a file name extension of \f[CB]\&.class\f[R].
+Both source and class files normally have file names that identify the
+contents.
+For example, a class called \f[CB]Shape\f[R] would be declared in a source
+file called \f[CB]Shape.java\f[R], and compiled into a class file called
+\f[CB]Shape.class\f[R].
+.PP
+There are two ways to specify source files to \f[CB]javac\f[R]:
+.IP \[bu] 2
+For a small number of source files, you can list their file names on the
+command line.
+.IP \[bu] 2
+For a large number of source files, you can use the
+\f[B]\f[BC]\@\f[B]\f[BI]filename\f[B]\f[R] option on the command line to
+specify an \f[I]argument file\f[R] that lists their file names.
+See \f[B]Standard Options\f[R] for a description of the option and
+\f[B]Command\-Line Argument Files\f[R] for a description of
+\f[CB]javac\f[R] argument files.
+.PP
+The order of source files specified on the command line or in an
+argument file is not important.
+\f[CB]javac\f[R] will compile the files together, as a group, and will
+automatically resolve any dependencies between the declarations in the
+various source files.
+.PP
+\f[CB]javac\f[R] expects that source files are arranged in one or more
+directory hierarchies on the file system, described in \f[B]Arrangement
+of Source Code\f[R].
+.PP
+To compile a source file, \f[CB]javac\f[R] needs to find the declaration
+of every class or interface that is used, extended, or implemented by
+the code in the source file.
+This lets \f[CB]javac\f[R] check that the code has the right to access
+those classes and interfaces.
+Rather than specifying the source files of those classes and interfaces
+explicitly, you can use command\-line options to tell \f[CB]javac\f[R]
+where to search for their source files.
+If you have compiled those source files previously, you can use options
+to tell \f[CB]javac\f[R] where to search for the corresponding class
+files.
+The options, which all have names ending in "path", are described in
+\f[B]Standard Options\f[R], and further described in \f[B]Configuring a
+Compilation\f[R] and \f[B]Searching for Module, Package and Type
+Declarations\f[R].
+.PP
+By default, \f[CB]javac\f[R] compiles each source file to a class file in
+the same directory as the source file.
+However, it is recommended to specify a separate destination directory
+with the \f[B]\f[BC]\-d\f[B]\f[R] option.
+.PP
+Command\-line \f[B]options\f[R] and \f[B]environment variables\f[R] also
+control how \f[CB]javac\f[R] performs various tasks:
+.IP \[bu] 2
+Compiling code to run on earlier releases of the JDK.
+.IP \[bu] 2
+Compiling code to run under a debugger.
+.IP \[bu] 2
+Checking for stylistic issues in Java source code.
+.IP \[bu] 2
+Checking for problems in \f[CB]javadoc\f[R] comments
+(\f[CB]/**\ ...\ */\f[R]).
+.IP \[bu] 2
+Processing annotations in source files and class files.
+.IP \[bu] 2
+Upgrading and patching modules in the compile\-time environment.
+.PP
+\f[CB]javac\f[R] supports \f[B]Compiling for Earlier Releases Of The
+Platform\f[R] and can also be invoked from Java code using one of a
+number of \f[B]APIs\f[R]
+.SH OPTIONS
+.PP
+\f[CB]javac\f[R] provides \f[B]standard options\f[R], and \f[B]extra
+options\f[R] that are either non\-standard or are for advanced use.
+.PP
+Some options take one or more arguments.
+If an argument contains spaces or other whitespace characters, the value
+should be quoted according to the conventions of the environment being
+used to invoke javac.
+If the option begins with a single dash (\f[CB]\-\f[R]) the argument
+should either directly follow the option name, or should be separated
+with a colon (\f[CB]:\f[R]) or whitespace, depending on the option.
+If the option begins with a double dash (\f[CB]\-\-\f[R]), the argument
+may be separated either by whitespace or by an equals (\f[CB]=\f[R])
+character with no additional whitespace.
+For example,
+.IP
+.nf
+\f[CB]
+\-Aname="J.\ Duke"
+\-proc:only
+\-d\ myDirectory
+\-\-module\-version\ 3
+\-\-module\-version=3
+\f[R]
+.fi
+.PP
+In the following lists of options, an argument of \f[I]path\f[R]
+represents a search path, composed of a list of file system locations
+separated by the platform path separator character, (semicolon
+\f[CB];\f[R] on Windows, or colon \f[CB]:\f[R] on other systems.) Depending
+on the option, the file system locations may be directories, JAR files
+or JMOD files.
+.SS Standard Options
+.TP
+.B \f[CB]\@\f[R]\f[I]filename\f[R]
+Reads options and file names from a file.
+To shorten or simplify the \f[CB]javac\f[R] command, you can specify one
+or more files that contain arguments to the \f[CB]javac\f[R] command
+(except \f[B]\f[BC]\-J\f[B]\f[R] options).
+This lets you to create \f[CB]javac\f[R] commands of any length on any
+operating system.
+See \f[B]Command\-Line Argument Files\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-A\f[R]\f[I]key\f[R][\f[CB]=\f[R]\f[I]value\f[R]]
+Specifies options to pass to annotation processors.
+These options are not interpreted by \f[CB]javac\f[R] directly, but are
+made available for use by individual processors.
+The \f[I]key\f[R] value should be one or more identifiers separated by a
+dot (\f[CB]\&.\f[R]).
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R]\f[CB],\f[R]\f[I]module\f[R]
+Specifies root modules to resolve in addition to the initial modules, or
+all modules on the module path if \f[I]module\f[R] is
+\f[CB]ALL\-MODULE\-PATH\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-boot\-class\-path\f[R] \f[I]path\f[R] or \f[CB]\-bootclasspath\f[R] \f[I]path\f[R]
+Overrides the location of the bootstrap class files.
+.RS
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+For JDK 9 or later, see \f[B]\f[BC]\-\-system\f[B]\f[R].
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-cp\f[R] \f[I]path\f[R]
+Specifies where to find user class files and annotation processors.
+This class path overrides the user class path in the \f[CB]CLASSPATH\f[R]
+environment variable.
+.RS
+.IP \[bu] 2
+If \f[CB]\-\-class\-path\f[R], \f[CB]\-classpath\f[R], or \f[CB]\-cp\f[R] are
+not specified, then the user class path is the value of the
+\f[CB]CLASSPATH\f[R] environment variable, if that is set, or else the
+current directory.
+.IP \[bu] 2
+If not compiling code for modules, if the
+\f[B]\f[BC]\-\-source\-path\f[B]\f[R] or \-sourcepath` option is not
+specified, then the user class path is also searched for source files.
+.IP \[bu] 2
+If the \f[B]\f[BC]\-processorpath\f[B]\f[R] option is not specified, then
+the class path is also searched for annotation processors.
+.RE
+.TP
+.B \f[CB]\-d\f[R] \f[I]directory\f[R]
+Sets the destination directory (or \f[I]class output directory\f[R]) for
+class files.
+If a class is part of a package, then \f[CB]javac\f[R] puts the class file
+in a subdirectory that reflects the module name (if appropriate) and
+package name.
+The directory, and any necessary subdirectories, will be created if they
+do not already exist.
+.RS
+.PP
+If the \f[CB]\-d\f[R] option is not specified, then \f[CB]javac\f[R] puts
+each class file in the same directory as the source file from which it
+was generated.
+.PP
+Except when compiling code for multiple modules, the contents of the
+class output directory will be organized in a package hierarchy.
+When compiling code for multiple modules, the contents of the output
+directory will be organized in a module hierarchy, with the contents of
+each module in a separate subdirectory, each organized as a package
+hierarchy.
+.PP
+\f[B]Note:\f[R] When compiling code for one or more modules, the class
+output directory will automatically be checked when searching for
+previously compiled classes.
+When not compiling for modules, for backwards compatibility, the
+directory is \f[I]not\f[R] automatically checked for previously compiled
+classes, and so it is recommended to specify the class output directory
+as one of the locations on the user class path, using the
+\f[CB]\-\-class\-path\f[R] option or one of its alternate forms.
+.RE
+.TP
+.B \f[CB]\-deprecation\f[R]
+Shows a description of each use or override of a deprecated member or
+class.
+Without the \f[CB]\-deprecation\f[R] option, \f[CB]javac\f[R] shows a
+summary of the source files that use or override deprecated members or
+classes.
+The \f[CB]\-deprecation\f[R] option is shorthand for
+\f[CB]\-Xlint:deprecation\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-enable\-preview\f[R]
+Enables preview language features.
+Used in conjunction with either \f[B]\f[BC]\-source\f[B]\f[R] or
+\f[B]\f[BC]\-\-release\f[B]\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-encoding\f[R] \f[I]encoding\f[R]
+Specifies character encoding used by source files, such as EUC\-JP and
+UTF\-8.
+If the \f[CB]\-encoding\f[R] option is not specified, then the platform
+default converter is used.
+.RS
+.RE
+.TP
+.B \f[CB]\-endorseddirs\f[R] \f[I]directories\f[R]
+Overrides the location of the endorsed standards path.
+.RS
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+.RE
+.TP
+.B \f[CB]\-extdirs\f[R] \f[I]directories\f[R]
+Overrides the location of the installed extensions.
+\f[CB]directories\f[R] is a list of directories, separated by the platform
+path separator (\f[CB];\f[R] on Windows, and \f[CB]:\f[R] otherwise).
+Each JAR file in the specified directories is searched for class files.
+All JAR files found become part of the class path.
+.RS
+.PP
+If you are compiling for a release of the platform that supports the
+Extension Mechanism, then this option specifies the directories that
+contain the extension classes.
+See [Compiling for Other Releases of the Platform].
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+.RE
+.TP
+.B \f[CB]\-g\f[R]
+Generates all debugging information, including local variables.
+By default, only line number and source file information is generated.
+.RS
+.RE
+.TP
+.B \f[CB]\-g:\f[R][\f[CB]lines\f[R], \f[CB]vars\f[R], \f[CB]source\f[R]]
+Generates only the kinds of debugging information specified by the
+comma\-separated list of keywords.
+Valid keywords are:
+.RS
+.TP
+.B \f[CB]lines\f[R]
+Line number debugging information.
+.RS
+.RE
+.TP
+.B \f[CB]vars\f[R]
+Local variable debugging information.
+.RS
+.RE
+.TP
+.B \f[CB]source\f[R]
+Source file debugging information.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]\-g:none\f[R]
+Does not generate debugging information.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] \f[I]directory\f[R]
+Specifies where to place generated native header files.
+.RS
+.PP
+When you specify this option, a native header file is generated for each
+class that contains native methods or that has one or more constants
+annotated with the \f[B]\f[BC]java.lang.annotation.Native\f[B]\f[R]
+annotation.
+If the class is part of a package, then the compiler puts the native
+header file in a subdirectory that reflects the module name (if
+appropriate) and package name.
+The directory, and any necessary subdirectories, will be created if they
+do not already exist.
+.RE
+.TP
+.B \f[CB]\-\-help\f[R], \f[CB]\-help\f[R] or \f[CB]\-?\f[R]
+Prints a synopsis of the standard options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R] or \f[CB]\-X\f[R]
+Prints a synopsis of the set of extra options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-lint\f[R]
+Prints the supported keys for the \f[CB]\-Xlint\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-implicit:\f[R][\f[CB]none\f[R], \f[CB]class\f[R]]
+Specifies whether or not to generate class files for implicitly
+referenced files:
+.RS
+.IP \[bu] 2
+\f[CB]\-implicit:class\f[R] \-\-\- Automatically generates class files.
+.IP \[bu] 2
+\f[CB]\-implicit:none\f[R] \-\-\- Suppresses class file generation.
+.PP
+If this option is not specified, then the default automatically
+generates class files.
+In this case, the compiler issues a warning if any class files are
+generated when also doing annotation processing.
+The warning is not issued when the \f[CB]\-implicit\f[R] option is
+explicitly set.
+See \f[B]Searching for Module, Package and Type Declarations\f[R].
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Passes \f[I]option\f[R] to the runtime system, where \f[I]option\f[R] is
+one of the Java options described on \f[B]java\f[R] command.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+.RS
+.PP
+\f[B]Note:\f[R] The \f[CB]CLASSPATH\f[R] environment variable,
+\f[CB]\-classpath\f[R] option, \f[CB]\-bootclasspath\f[R] option, and
+\f[CB]\-extdirs\f[R] option do not specify the classes used to run
+\f[CB]javac\f[R].
+Trying to customize the compiler implementation with these options and
+variables is risky and often does not accomplish what you want.
+If you must customize the compiler implementation, then use the
+\f[CB]\-J\f[R] option to pass options through to the underlying Java
+launcher.
+.RE
+.TP
+.B \f[CB]\-\-limit\-modules\f[R] \f[I]module\f[R]\f[CB],\f[R]\f[I]module\f[R]*
+Limits the universe of observable modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\f[R] \f[I]module\-name\f[R] (\f[CB],\f[R]\f[I]module\-name\f[R])* or \f[CB]\-m\f[R] \f[I]module\-name\f[R] (\f[CB],\f[R]\f[I]module\-name\f[R])*
+Compiles those source files in the named modules that are newer than the
+corresponding files in the output directory.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]path\f[R] or \f[CB]\-p\f[R] \f[I]path\f[R]
+Specifies where to find application modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-source\-path\f[R] \f[I]module\-source\-path\f[R]
+Specifies where to find source files when compiling code in multiple
+modules.
+See [Compilation Modes] and \f[B]The Module Source Path Option\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-version\f[R] \f[I]version\f[R]
+Specifies the version of modules that are being compiled.
+.RS
+.RE
+.TP
+.B \f[CB]\-nowarn\f[R]
+Disables warning messages.
+This option operates the same as the \f[CB]\-Xlint:none\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-parameters\f[R]
+Generates metadata for reflection on method parameters.
+Stores formal parameter names of constructors and methods in the
+generated class file so that the method
+\f[CB]java.lang.reflect.Executable.getParameters\f[R] from the Reflection
+API can retrieve them.
+.RS
+.RE
+.TP
+.B \f[CB]\-proc:\f[R][\f[CB]none\f[R], \f[CB]only\f[R]]
+Controls whether annotation processing and compilation are done.
+\f[CB]\-proc:none\f[R] means that compilation takes place without
+annotation processing.
+\f[CB]\-proc:only\f[R] means that only annotation processing is done,
+without any subsequent compilation.
+.RS
+.RE
+.TP
+.B \f[CB]\-processor\f[R] \f[I]class1\f[R][\f[CB],\f[R]\f[I]class2\f[R]\f[CB],\f[R]\f[I]class3\f[R]...]
+Names of the annotation processors to run.
+This bypasses the default discovery process.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-processor\-module\-path\f[R] \f[I]path\f[R]
+Specifies the module path used for finding annotation processors.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-processor\-path\f[R] \f[I]path\f[R] or \f[CB]\-processorpath\f[R] \f[I]path\f[R]
+Specifies where to find annotation processors.
+If this option is not used, then the class path is searched for
+processors.
+.RS
+.RE
+.TP
+.B \f[CB]\-profile\f[R] \f[I]profile\f[R]
+Checks that the API used is available in the specified profile.
+.RS
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+.RE
+.TP
+.B \f[CB]\-\-release\f[R] \f[I]release\f[R]
+Compiles source code according to the rules of the Java programming
+language for the specified Java SE release, generating class files which
+target that release.
+Source code is compiled against the combined Java SE and JDK API for the
+specified release.
+.RS
+.PP
+The supported values of \f[I]release\f[R] are the current Java SE release
+and a limited number of previous releases, detailed in the command\-line
+help.
+.PP
+For the current release, the Java SE API consists of the
+\f[CB]java.*\f[R], \f[CB]javax.*\f[R], and \f[CB]org.*\f[R] packages that are
+exported by the Java SE modules in the release; the JDK API consists of
+the \f[CB]com.*\f[R] and \f[CB]jdk.*\f[R] packages that are exported by the
+JDK modules in the release, plus the \f[CB]javax.*\f[R] packages that are
+exported by standard, but non\-Java SE, modules in the release.
+.PP
+For previous releases, the Java SE API and the JDK API are as defined in
+that release.
+.PP
+\f[B]Note:\f[R] When using \f[CB]\-\-release\f[R], you cannot also use the
+\f[B]\f[BC]\-\-source\f[B]\f[R]/\f[CB]\-source\f[R] or
+\f[B]\f[BC]\-\-target\f[B]\f[R]/\f[CB]\-target\f[R] options.
+.PP
+\f[B]Note:\f[R] When using \f[CB]\-\-release\f[R] to specify a release that
+supports the Java Platform Module System, the \f[CB]\-\-add\-exports\f[R]
+option cannot be used to enlarge the set of packages exported by the
+Java SE, JDK, and standard modules in the specified release.
+.RE
+.TP
+.B \f[CB]\-s\f[R] \f[I]directory\f[R]
+Specifies the directory used to place the generated source files.
+If a class is part of a package, then the compiler puts the source file
+in a subdirectory that reflects the module name (if appropriate) and
+package name.
+The directory, and any necessary subdirectories, will be created if they
+do not already exist.
+.RS
+.PP
+Except when compiling code for multiple modules, the contents of the
+source output directory will be organized in a package hierarchy.
+When compiling code for multiple modules, the contents of the source
+output directory will be organized in a module hierarchy, with the
+contents of each module in a separate subdirectory, each organized as a
+package hierarchy.
+.RE
+.TP
+.B \f[CB]\-\-source\f[R] \f[I]release\f[R] or \f[CB]\-source\f[R] \f[I]release\f[R]
+Compiles source code according to the rules of the Java programming
+language for the specified Java SE release.
+The supported values of \f[I]release\f[R] are the current Java SE release
+and a limited number of previous releases, detailed in the command\-line
+help.
+.RS
+.PP
+If the option is not specified, the default is to compile source code
+according to the rules of the Java programming language for the current
+Java SE release.
+.RE
+.TP
+.B \f[CB]\-\-source\-path\f[R] \f[I]path\f[R] or \f[CB]\-sourcepath\f[R] \f[I]path\f[R]
+Specifies where to find source files.
+Except when compiling multiple modules together, this is the source code
+path used to search for class or interface definitions.
+.RS
+.PP
+\f[B]Note:\f[R] Classes found through the class path might be recompiled
+when their source files are also found.
+See \f[B]Searching for Module, Package and Type Declarations\f[R].
+.RE
+.TP
+.B \f[CB]\-\-system\f[R] \f[I]jdk\f[R] | \f[CB]none\f[R]
+Overrides the location of system modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-target\f[R] \f[I]release\f[R] or \f[CB]\-target\f[R] \f[I]release\f[R]
+Generates \f[CB]class\f[R] files suitable for the specified Java SE
+release.
+The supported values of \f[I]release\f[R] are the current Java SE release
+and a limited number of previous releases, detailed in the command\-line
+help.
+.RS
+.PP
+\f[B]Note:\f[R] The target release must be equal to or higher than the
+source release.
+(See \f[B]\f[BC]\-\-source\f[B]\f[R].)
+.RE
+.TP
+.B \f[CB]\-\-upgrade\-module\-path\f[R] \f[I]path\f[R]
+Overrides the location of upgradeable modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose\f[R]
+Outputs messages about what the compiler is doing.
+Messages include information about each class loaded and each source
+file compiled.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R] or \f[CB]\-version\f[R]
+Prints version information.
+.RS
+.RE
+.TP
+.B \f[CB]\-Werror\f[R]
+Terminates compilation when warnings occur.
+.RS
+.RE
+.SS Extra Options
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]other\-module\f[R](\f[CB],\f[R]\f[I]other\-module\f[R])*
+Specifies a package to be considered as exported from its defining
+module to additional modules or to all unnamed modules when the value of
+\f[I]other\-module\f[R] is \f[CB]ALL\-UNNAMED\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-reads\f[R] \f[I]module\f[R]\f[CB]=\f[R]\f[I]other\-module\f[R](\f[CB],\f[R]\f[I]other\-module\f[R])*
+Specifies additional modules to be considered as required by a given
+module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-default\-module\-for\-created\-files\f[R] \f[I]module\-name\f[R]
+Specifies the fallback target module for files created by annotation
+processors, if none is specified or inferred.
+.RS
+.RE
+.TP
+.B \f[CB]\-Djava.endorsed.dirs=\f[R]\f[I]dirs\f[R]
+Overrides the location of the endorsed standards path.
+.RS
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+.RE
+.TP
+.B \f[CB]\-Djava.ext.dirs=\f[R]\f[I]dirs\f[R]
+Overrides the location of installed extensions.
+.RS
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+.RE
+.TP
+.B \f[CB]\-\-patch\-module\f[R] \f[I]module\f[R]\f[CB]=\f[R]\f[I]path\f[R]
+Overrides or augments a module with classes and resources in JAR files
+or directories.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xbootclasspath:\f[R]\f[I]path\f[R]
+Overrides the location of the bootstrap class files.
+.RS
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+.RE
+.TP
+.B \f[CB]\-Xbootclasspath/a:\f[R]\f[I]path\f[R]
+Adds a suffix to the bootstrap class path.
+.RS
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+.RE
+.TP
+.B \f[CB]\-Xbootclasspath/p:\f[R]\f[I]path\f[R]
+Adds a prefix to the bootstrap class path.
+.RS
+.PP
+\f[B]Note:\f[R] This can only be used when compiling for releases prior
+to JDK 9.
+As applicable, see the descriptions in \f[B]\f[BC]\-\-release\f[B]\f[R],
+\f[B]\f[BC]\-source\f[B]\f[R], or \f[B]\f[BC]\-target\f[B]\f[R] for
+details.
+.RE
+.TP
+.B \f[CB]\-Xdiags:\f[R][\f[CB]compact\f[R], \f[CB]verbose\f[R]]
+Selects a diagnostic mode.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdoclint\f[R]
+Enables recommended checks for problems in \f[CB]javadoc\f[R] comments
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdoclint:\f[R](\f[CB]all\f[R]|\f[CB]none\f[R]|[\f[CB]\-\f[R]]\f[I]group\f[R])[\f[CB]/\f[R]\f[I]access\f[R]]
+Enables or disables specific groups of checks,
+.RS
+.PP
+\f[I]group\f[R] can have one of the following values:
+.IP \[bu] 2
+\f[CB]accessibility\f[R]
+.IP \[bu] 2
+\f[CB]html\f[R]
+.IP \[bu] 2
+\f[CB]missing\f[R]
+.IP \[bu] 2
+\f[CB]reference\f[R]
+.IP \[bu] 2
+\f[CB]syntax\f[R]
+.PP
+The variable \f[I]access\f[R] specifies the minimum visibility level of
+classes and members that the \f[CB]\-Xdoclint\f[R] option checks.
+It can have one of the following values (in order of most to least
+visible):
+.IP \[bu] 2
+\f[CB]public\f[R]
+.IP \[bu] 2
+\f[CB]protected\f[R]
+.IP \[bu] 2
+\f[CB]package\f[R]
+.IP \[bu] 2
+\f[CB]private\f[R]
+.PP
+The default \f[I]access\f[R] level is \f[CB]private\f[R].
+.PP
+For more information about these groups of checks, see the
+\f[CB]\-Xdoclint\f[R] option of the \f[CB]javadoc\f[R] command.
+The \f[CB]\-Xdoclint\f[R] option is disabled by default in the
+\f[CB]javac\f[R] command.
+.PP
+For example, the following option checks classes and members (with all
+groups of checks) that have the access level of protected and higher
+(which includes protected and public):
+.RS
+.PP
+\f[CB]\-Xdoclint:all/protected\f[R]
+.RE
+.PP
+The following option enables all groups of checks for all access levels,
+except it will not check for HTML errors for classes and members that
+have the access level of package and higher (which includes package,
+protected and public):
+.RS
+.PP
+\f[CB]\-Xdoclint:all,\-html/package\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-Xdoclint/package:\f[R][\f[CB]\-\f[R]]\f[I]packages\f[R](\f[CB],\f[R][\f[CB]\-\f[R]]\f[I]package\f[R])*
+Enables or disables checks in specific packages.
+Each \f[I]package\f[R] is either the qualified name of a package or a
+package name prefix followed by \f[CB]\&.*\f[R], which expands to all
+sub\-packages of the given package.
+Each \f[I]package\f[R] can be prefixed with a hyphen (\f[CB]\-\f[R]) to
+disable checks for a specified package or packages.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlint\f[R]
+Enables all recommended warnings.
+In this release, enabling all available warnings is recommended.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xlint:\f[R][\f[CB]\-\f[R]]\f[I]key\f[R](\f[CB],\f[R][\f[CB]\-\f[R]]\f[I]key\f[R])*
+Supplies warnings to enable or disable, separated by comma.
+Precede a key by a hyphen (\f[CB]\-\f[R]) to disable the specified
+warning.
+.RS
+.PP
+Supported values for \f[I]key\f[R] are:
+.IP \[bu] 2
+\f[CB]all\f[R]: Enables all warnings.
+.IP \[bu] 2
+\f[CB]auxiliaryclass\f[R]: Warns about an auxiliary class that\[aq]s
+hidden in a source file, and is used from other files.
+.IP \[bu] 2
+\f[CB]cast\f[R]: Warns about the use of unnecessary casts.
+.IP \[bu] 2
+\f[CB]classfile\f[R]: Warns about the issues related to classfile
+contents.
+.IP \[bu] 2
+\f[CB]deprecation\f[R]: Warns about the use of deprecated items.
+.IP \[bu] 2
+\f[CB]dep\-ann\f[R]: Warns about the items marked as deprecated in
+\f[CB]javadoc\f[R] but without the \f[CB]\@Deprecated\f[R] annotation.
+.IP \[bu] 2
+\f[CB]divzero\f[R]: Warns about the division by the constant integer 0.
+.IP \[bu] 2
+\f[CB]empty\f[R]: Warns about an empty statement after \f[CB]if\f[R].
+.IP \[bu] 2
+\f[CB]exports\f[R]: Warns about the issues regarding module exports.
+.IP \[bu] 2
+\f[CB]fallthrough\f[R]: Warns about the falling through from one case of a
+switch statement to the next.
+.IP \[bu] 2
+\f[CB]finally\f[R]: Warns about \f[CB]finally\f[R] clauses that do not
+terminate normally.
+.IP \[bu] 2
+\f[CB]module\f[R]: Warns about the module system\-related issues.
+.IP \[bu] 2
+\f[CB]opens\f[R]: Warns about the issues related to module opens.
+.IP \[bu] 2
+\f[CB]options\f[R]: Warns about the issues relating to use of command line
+options.
+.IP \[bu] 2
+\f[CB]overloads\f[R]: Warns about the issues related to method overloads.
+.IP \[bu] 2
+\f[CB]overrides\f[R]: Warns about the issues related to method overrides.
+.IP \[bu] 2
+\f[CB]path\f[R]: Warns about the invalid path elements on the command l
+ine.
+.IP \[bu] 2
+\f[CB]processing\f[R]: Warns about the issues related to annotation
+processing.
+.IP \[bu] 2
+\f[CB]rawtypes\f[R]: Warns about the use of raw types.
+.IP \[bu] 2
+\f[CB]removal\f[R]: Warns about the use of an API that has been marked for
+removal.
+.IP \[bu] 2
+\f[CB]requires\-automatic\f[R]: Warns developers about the use of
+automatic modules in requires clauses.
+.IP \[bu] 2
+\f[CB]requires\-transitive\-automatic\f[R]: Warns about automatic modules
+in requires transitive.
+.IP \[bu] 2
+\f[CB]serial\f[R]: Warns about the serializable classes that do not
+provide a serial version ID.
+Also warns about access to non\-public members from a serializable
+element.
+.IP \[bu] 2
+\f[CB]static\f[R]: Warns about the accessing a static member using an
+instance.
+.IP \[bu] 2
+\f[CB]try\f[R]: Warns about the issues relating to the use of try blocks (
+that is, try\-with\-resources).
+.IP \[bu] 2
+\f[CB]unchecked\f[R]: Warns about the unchecked operations.
+.IP \[bu] 2
+\f[CB]varargs\f[R]: Warns about the potentially unsafe \f[CB]vararg\f[R]
+methods.
+.IP \[bu] 2
+\f[CB]none\f[R]: Disables all warnings.
+.PP
+See \f[B]Examples of Using \-Xlint keys\f[R].
+.RE
+.TP
+.B \f[CB]\-Xmaxerrs\f[R] \f[I]number\f[R]
+Sets the maximum number of errors to print.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xmaxwarns\f[R] \f[I]number\f[R]
+Sets the maximum number of warnings to print.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xpkginfo:\f[R][\f[CB]always\f[R], \f[CB]legacy\f[R], \f[CB]nonempty\f[R]]
+Specifies when and how the \f[CB]javac\f[R] command generates
+\f[CB]package\-info.class\f[R] files from \f[CB]package\-info.java\f[R]
+files using one of the following options:
+.RS
+.TP
+.B \f[CB]always\f[R]
+Generates a \f[CB]package\-info.class\f[R] file for every
+\f[CB]package\-info.java\f[R] file.
+This option may be useful if you use a build system such as Ant, which
+checks that each \f[CB]\&.java\f[R] file has a corresponding
+\f[CB]\&.class\f[R] file.
+.RS
+.RE
+.TP
+.B \f[CB]legacy\f[R]
+Generates a \f[CB]package\-info.class\f[R] file only if
+\f[CB]package\-info.java\f[R] contains annotations.
+This option does not generate a \f[CB]package\-info.class\f[R] file if
+\f[CB]package\-info.java\f[R] contains only comments.
+.RS
+.PP
+\f[B]Note:\f[R] A \f[CB]package\-info.class\f[R] file might be generated
+but be empty if all the annotations in the \f[CB]package\-info.java\f[R]
+file have \f[CB]RetentionPolicy.SOURCE\f[R].
+.RE
+.TP
+.B \f[CB]nonempty\f[R]
+Generates a \f[CB]package\-info.class\f[R] file only if
+\f[CB]package\-info.java\f[R] contains annotations with
+\f[CB]RetentionPolicy.CLASS\f[R] or \f[CB]RetentionPolicy.RUNTIME\f[R].
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]\-Xplugin:\f[R]\f[I]name\f[R] \f[I]args\f[R]
+Specifies the name and optional arguments for a plug\-in to be run.
+If \f[I]args\f[R] are provided, \f[I]name\f[R] and \f[I]args\f[R] should be
+quoted or otherwise escape the whitespace characters between the name
+and all the arguments.
+For details on the API for a plugin, see the API documentation for
+\f[B]jdk.compiler/com.sun.source.util.Plugin\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-Xprefer:\f[R][\f[CB]source\f[R], \f[CB]newer\f[R]]
+Specifies which file to read when both a source file and class file are
+found for an implicitly compiled class using one of the following
+options.
+See \f[B]Searching for Module, Package and Type Declarations\f[R].
+.RS
+.IP \[bu] 2
+\f[CB]\-Xprefer:newer\f[R]: Reads the newer of the source or class files
+for a type (default).
+.IP \[bu] 2
+\f[CB]\-Xprefer:source\f[R] : Reads the source file.
+Use \f[CB]\-Xprefer:source\f[R] when you want to be sure that any
+annotation processors can access annotations declared with a retention
+policy of \f[CB]SOURCE\f[R].
+.RE
+.TP
+.B \f[CB]\-Xprint\f[R]
+Prints a textual representation of specified types for debugging
+purposes.
+This does not perform annotation processing or compilation.
+The format of the output could change.
+.RS
+.RE
+.TP
+.B \f[CB]\-XprintProcessorInfo\f[R]
+Prints information about which annotations a processor is asked to
+process.
+.RS
+.RE
+.TP
+.B \f[CB]\-XprintRounds\f[R]
+Prints information about initial and subsequent annotation processing
+rounds.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xstdout\f[R] \f[I]filename\f[R]
+Sends compiler messages to the named file.
+By default, compiler messages go to \f[CB]System.err\f[R].
+.RS
+.RE
+.SH ENVIRONMENT VARIABLES
+.SS CLASSPATH
+.PP
+If the \f[B]\f[BC]\-\-class\-path\f[B]\f[R] option or any of its
+alternate forms are not specified, the class path will default to the
+value of the \f[CB]CLASSPATH\f[R] environment variable if it is set.
+However, it is recommended that this environment variable should
+\f[I]not\f[R] be set, and that the \f[CB]\-\-class\-path\f[R] option should
+be used to provide an explicit value for the class path when one is
+required.
+.SS JDK_JAVAC_OPTIONS
+.PP
+The content of the \f[CB]JDK_JAVAC_OPTIONS\f[R] environment variable,
+separated by white\-spaces ( ) or white\-space characters (\f[CB]\\n\f[R],
+\f[CB]\\t\f[R], \f[CB]\\r\f[R], or \f[CB]\\f\f[R]) is prepended to the command
+line arguments passed to \f[CB]javac\f[R] as a list of arguments.
+.PP
+The encoding requirement for the environment variable is the same as the
+\f[CB]javac\f[R] command line on the system.
+\f[CB]JDK_JAVAC_OPTIONS\f[R] environment variable content is treated in
+the same manner as that specified in the command line.
+.PP
+Single quotes (\f[CB]\[aq]\f[R]) or double quotes (\f[CB]"\f[R]) can be used
+to enclose arguments that contain whitespace characters.
+All content between the open quote and the first matching close quote
+are preserved by simply removing the pair of quotes.
+In case a matching quote is not found, the launcher will abort with an
+error message.
+\f[CB]\@\f[R]\f[I]files\f[R] are supported as they are specified in the
+command line.
+However, as in \f[CB]\@\f[R]\f[I]files\f[R], use of a wildcard is not
+supported.
+.PP
+\f[B]Examples of quoting arguments containing white spaces:\f[R]
+.RS
+.PP
+\f[CB]export\ JDK_JAVAC_OPTIONS=\[aq]\@"C:\\white\ spaces\\argfile"\[aq]\f[R]
+.RE
+.RS
+.PP
+\f[CB]export\ JDK_JAVAC_OPTIONS=\[aq]"\@C:\\white\ spaces\\argfile"\[aq]\f[R]
+.RE
+.RS
+.PP
+\f[CB]export\ JDK_JAVAC_OPTIONS=\[aq]\@C:\\"white\ spaces"\\argfile\[aq]\f[R]
+.RE
+.SH COMMAND\-LINE ARGUMENT FILES
+.PP
+An argument file can include command\-line options and source file names
+in any combination.
+The arguments within a file can be separated by spaces or new line
+characters.
+If a file name contains embedded spaces, then put the whole file name in
+double quotation marks.
+.PP
+File names within an argument file are relative to the current
+directory, not to the location of the argument file.
+Wildcards (\f[CB]*\f[R]) are not allowed in these lists (such as for
+specifying \f[CB]*.java\f[R]).
+Use of the at sign (\f[CB]\@\f[R]) to recursively interpret files is not
+supported.
+The \f[CB]\-J\f[R] options are not supported because they\[aq]re passed to
+the launcher, which does not support argument files.
+.PP
+When executing the \f[CB]javac\f[R] command, pass in the path and name of
+each argument file with the at sign (\f[CB]\@\f[R]) leading character.
+When the \f[CB]javac\f[R] command encounters an argument beginning with
+the at sign (\f[CB]\@\f[R]), it expands the contents of that file into the
+argument list.
+.SS Examples of Using javac \@filename
+.TP
+.B Single Argument File
+You could use a single argument file named \f[CB]argfile\f[R] to hold all
+\f[CB]javac\f[R] arguments:
+.RS
+.RS
+.PP
+\f[CB]javac\ \@argfile\f[R]
+.RE
+.PP
+This argument file could contain the contents of both files shown in the
+following \f[B]Two Argument Files\f[R] example.
+.RE
+.TP
+.B Two Argument Files
+You can create two argument files: one for the \f[CB]javac\f[R] options
+and the other for the source file names.
+Note that the following lists have no line\-continuation characters.
+.RS
+.PP
+Create a file named \f[CB]options\f[R] that contains the following:
+.PP
+\f[B]Linux and macOS:\f[R]
+.IP
+.nf
+\f[CB]
+\-d\ classes
+\-g
+\-sourcepath\ /java/pubs/ws/1.3/src/share/classes
+\f[R]
+.fi
+.PP
+\f[B]Windows:\f[R]
+.IP
+.nf
+\f[CB]
+\-d\ classes
+\-g
+\-sourcepath\ C:\\java\\pubs\\ws\\1.3\\src\\share\\classes
+\f[R]
+.fi
+.PP
+Create a file named \f[CB]classes\f[R] that contains the following:
+.IP
+.nf
+\f[CB]
+MyClass1.java
+MyClass2.java
+MyClass3.java
+\f[R]
+.fi
+.PP
+Then, run the \f[CB]javac\f[R] command as follows:
+.RS
+.PP
+\f[CB]javac\ \@options\ \@classes\f[R]
+.RE
+.RE
+.TP
+.B Argument Files with Paths
+The argument files can have paths, but any file names inside the files
+are relative to the current working directory (not \f[CB]path1\f[R] or
+\f[CB]path2\f[R]):
+.RS
+.RS
+.PP
+\f[CB]javac\ \@path1/options\ \@path2/classes\f[R]
+.RE
+.RE
+.SH ARRANGEMENT OF SOURCE CODE
+.PP
+In the Java language, classes and interfaces can be organized into
+packages, and packages can be organized into modules.
+\f[CB]javac\f[R] expects that the physical arrangement of source files in
+directories of the file system will mirror the organization of classes
+into packages, and packages into modules.
+.PP
+It is a widely adopted convention that module names and package names
+begin with a lower\-case letter, and that class names begin with an
+upper\-case letter.
+.SS Arrangement of Source Code for a Package
+.PP
+When classes and interfaces are organized into a package, the package is
+represented as a directory, and any subpackages are represented as
+subdirectories.
+.PP
+For example:
+.IP \[bu] 2
+The package \f[CB]p\f[R] is represented as a directory called \f[CB]p\f[R].
+.IP \[bu] 2
+The package \f[CB]p.q\f[R] \-\- that is, the subpackage \f[CB]q\f[R] of
+package \f[CB]p\f[R] \-\- is represented as the subdirectory \f[CB]q\f[R] of
+directory \f[CB]p\f[R].
+The directory tree representing package \f[CB]p.q\f[R] is therefore
+\f[CB]p\\q\f[R] on Windows, and \f[CB]p/q\f[R] on other systems.
+.IP \[bu] 2
+The package \f[CB]p.q.r\f[R] is represented as the directory tree
+\f[CB]p\\q\\r\f[R] (on Windows) or \f[CB]p/q/r\f[R] (on other systems).
+.PP
+Within a directory or subdirectory, \f[CB]\&.java\f[R] files represent
+classes and interfaces in the corresponding package or subpackage.
+.PP
+For example:
+.IP \[bu] 2
+The class \f[CB]X\f[R] declared in package \f[CB]p\f[R] is represented by
+the file \f[CB]X.java\f[R] in the \f[CB]p\f[R] directory.
+.IP \[bu] 2
+The class \f[CB]Y\f[R] declared in package \f[CB]p.q\f[R] is represented by
+the file \f[CB]Y.java\f[R] in the \f[CB]q\f[R] subdirectory of directory
+\f[CB]p\f[R].
+.IP \[bu] 2
+The class \f[CB]Z\f[R] declared in package \f[CB]p.q.r\f[R] is represented
+by the file \f[CB]Z.java\f[R] in the \f[CB]r\f[R] subdirectory of
+\f[CB]p\\q\f[R] (on Windows) or \f[CB]p/q\f[R] (on other systems).
+.PP
+In some situations, it is convenient to split the code into separate
+directories, each structured as described above, and the aggregate list
+of directories specified to \f[CB]javac\f[R].
+.SS Arrangement of Source Code for a Module
+.PP
+In the Java language, a module is a set of packages designed for reuse.
+In addition to \f[CB]\&.java\f[R] files for classes and interfaces, each
+module has a source file called \f[CB]module\-info.java\f[R] which:
+.IP "1." 3
+declares the module\[aq]s name;
+.IP "2." 3
+lists the packages exported by the module (to allow reuse by other
+modules);
+.IP "3." 3
+lists other modules required by the module (to reuse their exported
+packages).
+.PP
+When packages are organized into a module, the module is represented by
+one or more directories representing the packages in the module, one of
+which contains the \f[CB]module\-info.java\f[R] file.
+It may be convenient, but it is not required, to use a single directory,
+named after the module, to contain the \f[CB]module\-info.java\f[R] file
+alongside the directory tree which represents the packages in the module
+(i.e., the \f[I]package hierarchy\f[R] described above).
+The exact arrangement of source code for a module is typically dictated
+by the conventions adopted by a development environment (IDE) or build
+system.
+.PP
+For example:
+.IP \[bu] 2
+The module \f[CB]a.b.c\f[R] may be represented by the directory
+\f[CB]a.b.c\f[R], on all systems.
+.IP \[bu] 2
+The module\[aq]s declaration is represented by the file
+\f[CB]module\-info.java\f[R] in the \f[CB]a.b.c\f[R] directory.
+.IP \[bu] 2
+If the module contains package \f[CB]p.q.r\f[R], then the \f[CB]a.b.c\f[R]
+directory contains the directory tree \f[CB]p\\q\\r\f[R] (on Windows) or
+\f[CB]p/q/r\f[R] (on other systems).
+.PP
+The development environment may prescribe some directory hierarchy
+between the directory named for the module and the source files to be
+read by \f[CB]javac\f[R].
+.PP
+For example:
+.IP \[bu] 2
+The module \f[CB]a.b.c\f[R] may be represented by the directory
+\f[CB]a.b.c\f[R]
+.IP \[bu] 2
+The module\[aq]s declaration and the module\[aq]s packages may be in
+some subdirectory of \f[CB]a.b.c\f[R], such as \f[CB]src\\main\\java\f[R]
+(on Windows) or \f[CB]src/main/java\f[R] (on other systems).
+.SH CONFIGURING A COMPILATION
+.PP
+This section describes how to configure \f[CB]javac\f[R] to perform a
+basic compilation.
+.PP
+See \f[B]Configuring the Module System\f[R] for additional details for
+use when compiling for a release of the platform that supports modules.
+.SS Source Files
+.IP \[bu] 2
+Specify the source files to be compiled on the command line.
+.PP
+If there are no compilation errors, the corresponding class files will
+be placed in the \f[B]output directory\f[R].
+.PP
+Some systems may limit the amount you can put on a command line; to work
+around those limits, you can use \f[B]argument files\f[R].
+.PP
+When compiling code for modules, you can also specify source files
+indirectly, by using the \f[B]\f[BC]\-\-module\f[B]\f[R] or \f[CB]\-m\f[R]
+option.
+.SS Output Directory
+.IP \[bu] 2
+Use the \f[B]\f[BC]\-d\f[B]\f[R] option to specify an output directory in
+which to put the compiled class files.
+.PP
+This will normally be organized in a \f[B]package hierarchy\f[R], unless
+you are compiling source code from multiple modules, in which case it
+will be organized as a \f[B]module hierarchy\f[R].
+.PP
+When the compilation has been completed, if you are compiling one or
+more modules, you can place the output directory on the module path for
+the Java \f[B]launcher\f[R]; otherwise, you can place the place the
+output directory on the class path for the Java launcher.
+.SS Precompiled Code
+.PP
+The code to be compiled may refer to libraries beyond what is provided
+by the platform.
+If so, you must place these libraries on the class path or module path.
+If the library code is not in a module, place it on the class path; if
+it is in a module, place it on the module path.
+.IP \[bu] 2
+Use the \f[B]\f[BC]\-\-class\-path\f[B]\f[R] option to specify libraries
+to be placed on the class path.
+Locations on the class path should be organized in a \f[B]package
+hierarchy\f[R].
+You can also use alternate forms of the option: \f[CB]\-classpath\f[R] or
+\f[CB]\-cp\f[R].
+.IP \[bu] 2
+Use the \f[B]\f[BC]\-\-module\-path\f[B]\f[R] option to specify libraries
+to be placed on the module path.
+Locations on the module path should either be modules or directories of
+modules.
+You can also use an alternate form of the option: \f[CB]\-p\f[R].
+.RS 2
+.PP
+See \f[B]Configuring the Module System\f[R] for details on how to modify
+the default configuration of library modules.
+.RE
+.PP
+\f[B]Note\f[R]: the options for the class path and module path are not
+mutually exclusive, although it is not common to specify the class path
+when compiling code for one or more modules.
+.SS Additional Source Files
+.PP
+The code to be compiled may refer to types in additional source files
+that are not specified on the command line.
+If so, you must put those source files on either the source path or
+module path.
+You can only specify one of these options: if you are not compiling code
+for a module, or if you are only compiling code for a single module, use
+the source path; if you are compiling code for multiple modules, use the
+module source path.
+.IP \[bu] 2
+Use the \f[B]\f[BC]\-\-source\-path\f[B]\f[R] option to specify the
+locations of additional source files that may be read by javac.
+Locations on the source path should be organized in a \f[B]package
+hierarchy\f[R].
+You can also use an alternate form of the option: \f[CB]\-sourcepath\f[R].
+.IP \[bu] 2
+Use the \f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R] option one or more
+times to specify the location of additional source files in different
+modules that may be read by javac, or when compiling source files in
+multiple modules.
+You can either specify the locations for each module
+\f[B]individually\f[R], or you can organize the source files so that you
+can specify the locations all \f[B]together\f[R].
+For more details, see \f[B]The Module Source Path Option\f[R].
+.PP
+If you want to be able to refer to types in additional source files but
+do not want them to be compiled, use the \f[B]\f[BC]\-implicit\f[B]\f[R]
+option.
+.PP
+\f[B]Note\f[R]: if you are compiling code for multiple modules, you must
+always specify a module source path, and all source files specified on
+the command line must be in one of the directories on the module source
+path, or in a subdirectory thereof.
+.SS Example of Compiling Multiple Source Files
+.PP
+This example compiles the \f[CB]Aloha.java\f[R], \f[CB]GutenTag.java\f[R],
+\f[CB]Hello.java\f[R], and \f[CB]Hi.java\f[R] source files in the
+\f[CB]greetings\f[R] package.
+.PP
+\f[B]Linux and macOS:\f[R]
+.IP
+.nf
+\f[CB]
+%\ javac\ greetings/*.java
+%\ ls\ greetings
+Aloha.class\ \ \ \ \ \ \ \ \ GutenTag.class\ \ \ \ \ \ Hello.class\ \ \ \ \ \ \ \ \ Hi.class
+Aloha.java\ \ \ \ \ \ \ \ \ \ GutenTag.java\ \ \ \ \ \ \ Hello.java\ \ \ \ \ \ \ \ \ \ Hi.java
+\f[R]
+.fi
+.PP
+\f[B]Windows:\f[R]
+.IP
+.nf
+\f[CB]
+C:\\>javac\ greetings\\*.java
+C:\\>dir\ greetings
+Aloha.class\ \ \ \ \ \ \ \ \ GutenTag.class\ \ \ \ \ \ Hello.class\ \ \ \ \ \ \ \ \ Hi.class
+Aloha.java\ \ \ \ \ \ \ \ \ \ GutenTag.java\ \ \ \ \ \ \ Hello.java\ \ \ \ \ \ \ \ \ \ Hi.java
+\f[R]
+.fi
+.SS Example of Specifying a User Class Path
+.PP
+After changing one of the source files in the previous example,
+recompile it:
+.PP
+\f[B]Linux and macOS:\f[R]
+.IP
+.nf
+\f[CB]
+pwd
+/examples
+javac\ greetings/Hi.java
+\f[R]
+.fi
+.PP
+\f[B]Windows:\f[R]
+.IP
+.nf
+\f[CB]
+C:\\>cd
+\\examples
+C:\\>javac\ greetings\\Hi.java
+\f[R]
+.fi
+.PP
+Because \f[CB]greetings.Hi\f[R] refers to other classes in the
+\f[CB]greetings\f[R] package, the compiler needs to find these other
+classes.
+The previous example works because the default user class path is the
+directory that contains the package directory.
+If you want to recompile this file without concern for which directory
+you are in, then add the examples directory to the user class path by
+setting \f[CB]CLASSPATH\f[R].
+This example uses the \f[CB]\-classpath\f[R] option.
+.PP
+\f[B]Linux and macOS:\f[R]
+.RS
+.PP
+\f[CB]javac\ \-classpath\ /examples\ /examples/greetings/Hi.java\f[R]
+.RE
+.PP
+\f[B]Windows:\f[R]
+.RS
+.PP
+\f[CB]C:\\>javac\ \-classpath\ \\examples\ \\examples\\greetings\\Hi.java\f[R]
+.RE
+.PP
+If you change \f[CB]greetings.Hi\f[R] to use a banner utility, then that
+utility also needs to be accessible through the user class path.
+.PP
+\f[B]Linux and macOS:\f[R]
+.IP
+.nf
+\f[CB]
+javac\ \-classpath\ /examples:/lib/Banners.jar\ \\
+\ \ \ \ \ \ \ \ \ \ \ \ /examples/greetings/Hi.java
+\f[R]
+.fi
+.PP
+\f[B]Windows:\f[R]
+.IP
+.nf
+\f[CB]
+C:\\>javac\ \-classpath\ \\examples;\\lib\\Banners.jar\ ^
+\ \ \ \ \ \ \ \ \ \ \ \ \\examples\\greetings\\Hi.java
+\f[R]
+.fi
+.PP
+To execute a class in the \f[CB]greetings\f[R] package, the program needs
+access to the \f[CB]greetings\f[R] package, and to the classes that the
+\f[CB]greetings\f[R] classes use.
+.PP
+\f[B]Linux and macOS:\f[R]
+.RS
+.PP
+\f[CB]java\ \-classpath\ /examples:/lib/Banners.jar\ greetings.Hi\f[R]
+.RE
+.PP
+\f[B]Windows:\f[R]
+.RS
+.PP
+\f[CB]C:\\>java\ \-classpath\ \\examples;\\lib\\Banners.jar\ greetings.Hi\f[R]
+.RE
+.SH CONFIGURING THE MODULE SYSTEM
+.PP
+If you want to include additional modules in your compilation, use the
+\f[B]\f[BC]\-\-add\-modules\f[B]\f[R] option.
+This may be necessary when you are compiling code that is not in a
+module, or which is in an automatic module, and the code refers to API
+in the additional modules.
+.PP
+If you want to restrict the set of modules in your compilation, use the
+\f[B]\f[BC]\-\-limit\-modules\f[B]\f[R] option.
+This may be useful if you want to ensure that the code you are compiling
+is capable of running on a system with a limited set of modules
+installed.
+.PP
+If you want to break encapsulation and specify that additional packages
+should be considered as exported from a module, use the
+\f[B]\f[BC]\-\-add\-exports\f[B]\f[R] option.
+This may be useful when performing white\-box testing; relying on access
+to internal API in production code is strongly discouraged.
+.PP
+If you want to specify that additional packages should be considered as
+required by a module, use the \f[B]\f[BC]\-\-add\-reads\f[B]\f[R] option.
+This may be useful when performing white\-box testing; relying on access
+to internal API in production code is strongly discouraged.
+.PP
+You can patch additional content into any module using the
+\f[B]\f[BC]\-\-patch\-module\f[B]\f[R] option.
+See [Patching a Module] for more details.
+.SH SEARCHING FOR MODULE, PACKAGE AND TYPE DECLARATIONS
+.PP
+To compile a source file, the compiler often needs information about a
+module or type, but the declaration is not in the source files specified
+on the command line.
+.PP
+\f[CB]javac\f[R] needs type information for every class or interface used,
+extended, or implemented in the source file.
+This includes classes and interfaces not explicitly mentioned in the
+source file, but that provide information through inheritance.
+.PP
+For example, when you create a subclass of \f[CB]java.awt.Window\f[R], you
+are also using the ancestor classes of \f[CB]Window\f[R]:
+\f[CB]java.awt.Container\f[R], \f[CB]java.awt.Component\f[R], and
+\f[CB]java.lang.Object\f[R].
+.PP
+When compiling code for a module, the compiler also needs to have
+available the declaration of that module.
+.PP
+A successful search may produce a class file, a source file, or both.
+If both are found, then you can use the \f[B]\f[BC]\-Xprefer\f[B]\f[R]
+option to instruct the compiler which to use.
+.PP
+If a search finds and uses a source file, then by default \f[CB]javac\f[R]
+compiles that source file.
+This behavior can be altered with \f[B]\f[BC]\-implicit\f[B]\f[R].
+.PP
+The compiler might not discover the need for some type information until
+after annotation processing completes.
+When the type information is found in a source file and no
+\f[B]\f[BC]\-implicit\f[B]\f[R] option is specified, the compiler gives a
+warning that the file is being compiled without being subject to
+annotation processing.
+To disable the warning, either specify the file on the command line (so
+that it will be subject to annotation processing) or use the
+\f[B]\f[BC]\-implicit\f[B]\f[R] option to specify whether or not class
+files should be generated for such source files.
+.PP
+The way that \f[CB]javac\f[R] locates the declarations of those types
+depends on whether the reference exists within code for a module or not.
+.SS Searching Package Oriented Paths
+.PP
+When searching for a source or class file on a path composed of package
+oriented locations, \f[CB]javac\f[R] will check each location on the path
+in turn for the possible presence of the file.
+The first occurrence of a particular file shadows (hides) any subsequent
+occurrences of like\-named files.
+This shadowing does not affect any search for any files with a different
+name.
+This can be convenient when searching for source files, which may be
+grouped in different locations, such as shared code, platform\-specific
+code and generated code.
+It can also be useful when injecting alternate versions of a class file
+into a package, to debugging or other instrumentation reasons.
+But, it can also be dangerous, such as when putting incompatible
+different versions of a library on the class path.
+.SS Searching Module Oriented Paths
+.PP
+Prior to scanning any module paths for any package or type declarations,
+\f[CB]javac\f[R] will lazily scan the following paths and locations to
+determine the modules that will be used in the compilation.
+.IP \[bu] 2
+The module source path (see the
+\f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R] option)
+.IP \[bu] 2
+The path for upgradeable modules (see the
+\f[B]\f[BC]\-\-upgrade\-module\-path\f[B]\f[R] option)
+.IP \[bu] 2
+The system modules (see the \f[B]\f[BC]\-\-system\f[B]\f[R] option)
+.IP \[bu] 2
+The user module path ( see the \f[B]\f[BC]\-\-module\-path\f[B]\f[R]
+option)
+.PP
+For any module, the first occurrence of the module during the scan
+completely shadows (hides) any subsequent appearance of a like\-named
+module.
+While locating the modules, \f[CB]javac\f[R] is able to determine the
+packages exported by the module and to associate with each module a
+package oriented path for the contents of the module.
+For any previously compiled module, this path will typically be a single
+entry for either a directory or a file that provides an internal
+directory\-like hierarchy, such as a JAR file.
+Thus, when searching for a type that is in a package that is known to be
+exported by a module, \f[CB]javac\f[R] can locate the declaration directly
+and efficiently.
+.SS Searching for the Declaration of a Module
+.PP
+If the module has been previously compiled, the module declaration is
+located in a file named \f[CB]module\-info.class\f[R] in the root of the
+package hierarchy for the content of the module.
+.PP
+If the module is one of those currently being compiled, the module
+declaration will be either the file named \f[CB]module\-info.class\f[R] in
+the root of the package hierarchy for the module in the class output
+directory, or the file named \f[CB]module\-info.java\f[R] in one of the
+locations on the source path or one the module source path for the
+module.
+.SS Searching for the Declaration of a Type When the Reference is not in
+a Module
+.PP
+When searching for a type that is referenced in code that is not in a
+module, \f[CB]javac\f[R] will look in the following places:
+.IP \[bu] 2
+The platform classes (or the types in exported packages of the platform
+modules) (This is for compiled class files only.)
+.IP \[bu] 2
+Types in exported packages of any modules on the module path, if
+applicable.
+(This is for compiled class files only.)
+.IP \[bu] 2
+Types in packages on the class path and/or source path:
+.RS 2
+.IP \[bu] 2
+If both are specified, \f[CB]javac\f[R] looks for compiled class files on
+the class path and for source files on the source path.
+.IP \[bu] 2
+If the class path is specified, but not source path, \f[CB]javac\f[R]
+looks for both compiled class files and source files on the class path.
+.IP \[bu] 2
+If the class path is not specified, it defaults to the current
+directory.
+.RE
+.PP
+When looking for a type on the class path and/or source path, if both a
+compiled class file and a source file are found, the most recently
+modified file will be used by default.
+If the source file is newer, it will be compiled and will may override
+any previously compiled version of the file.
+You can use the \f[B]\f[BC]\-Xprefer\f[B]\f[R] option to override the
+default behavior.
+.SS Searching for the Declaration of a Type When the Reference is in a
+Module
+.PP
+When searching for a type that is referenced in code in a module,
+\f[CB]javac\f[R] will examine the declaration of the enclosing module to
+determine if the type is in a package that is exported from another
+module that is readable by the enclosing module.
+If so, \f[CB]javac\f[R] will simply and directly go to the definition of
+that module to find the definition of the required type.
+Unless the module is another of the modules being compiled,
+\f[CB]javac\f[R] will only look for compiled class files files.
+In other words, \f[CB]javac\f[R] will not look for source files in
+platform modules or modules on the module path.
+.PP
+If the type being referenced is not in some other readable module,
+\f[CB]javac\f[R] will examine the module being compiled to try and find
+the declaration of the type.
+\f[CB]javac\f[R] will look for the declaration of the type as follows:
+.IP \[bu] 2
+Source files specified on the command line or on the source path or
+module source path.
+.IP \[bu] 2
+Previously compiled files in the output directory.
+.SH DIRECTORY HIERARCHIES
+.PP
+\f[CB]javac\f[R] generally assumes that source files and compiled class
+files will be organized in a file system directory hierarchy or in a
+type of file that supports in an internal directory hierarchy, such as a
+JAR file.
+Three different kinds of hierarchy are supported: a \f[I]package
+hierarchy\f[R], a \f[I]module hierarchy\f[R], and a \f[I]module source
+hierarchy\f[R].
+.PP
+While \f[CB]javac\f[R] is fairly relaxed about the organization of source
+code, beyond the expectation that source will be organized in one or
+package hierarchies, and can generally accommodate organizations
+prescribed by development environments and build tools, Java tools in
+general, and \f[CB]javac\f[R] and the Java launcher in particular, are
+more stringent regarding the organization of compiled class files, and
+will be organized in package hierarchies or module hierarchies, as
+appropriate.
+.PP
+The location of these hierarchies are specified to \f[CB]javac\f[R] with
+command\-line options, whose names typically end in "path", like
+\f[B]\f[BC]\-\-source\-path\f[B]\f[R] or
+\f[B]\f[BC]\-\-class\-path\f[B]\f[R].
+Also as a general rule, path options whose name includes the word
+\f[CB]module\f[R], like \f[B]\f[BC]\-\-module\-path\f[B]\f[R], are used to
+specify module hierarchies, although some module\-related path options
+allow a package hierarchy to be specified on a per\-module basis.
+All other path options are used to specify package hierarchies.
+.SS Package Hierarchy
+.PP
+In a package hierarchy, directories and subdirectories are used to
+represent the component parts of the package name, with the source file
+or compiled class file for a type being stored as a file with an
+extension of \f[CB]\&.java\f[R] or \f[CB]\&.class\f[R] in the most nested
+directory.
+.PP
+For example, in a package hierarchy, the source file for a class
+\f[CB]com.example.MyClass\f[R] will be stored in the file
+\f[I]com/example/MyClass.java\f[R]
+.SS Module Hierarchy
+.PP
+In a module hierarchy, the first level of directories are named for the
+modules in the hierarchy; within each of those directories the contents
+of the module are organized in package hierarchies.
+.PP
+For example, in a module hierarchy, the compiled class file for a type
+called \f[CB]com.example.MyClass\f[R] in a module called
+\f[CB]my.library\f[R] will be stored in
+\f[I]my.library/com/example/MyClass.class\f[R].
+.PP
+The various output directories used by \f[CB]javac\f[R] (the class output
+directory, the source output directory, and native header output
+directory) will all be organized in a module hierarchy when multiple
+modules are being compiled.
+.SS Module Source Hierarchy
+.PP
+Although the source for each individual module should always be
+organized in a package hierarchy, it may be convenient to group those
+hierarchies into a module source hierarchy.
+This is similar to a module hierarchy, except that there may be
+intervening directories between the directory for the module and the
+directory that is the root of the package hierarchy for the source code
+of the module.
+.PP
+For example, in a module source hierarchy, the source file for a type
+called \f[CB]com.example.MyClass\f[R] in a module called
+\f[CB]my.library\f[R] may be stored in a file such as
+\f[I]my.library/src/main/java/com/example/MyClass.java\f[R].
+.SH THE MODULE SOURCE PATH OPTION
+.PP
+The \f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R] option has two forms: a
+\f[I]module\-specific form\f[R], in which a package path is given for
+each module containing code to be compiled, and a
+\f[I]module\-pattern\f[R] form, in which the source path for each module
+is specified by a pattern.
+The module\-specific form is generally simpler to use when only a small
+number of modules are involved; the module\-pattern form may be more
+convenient when the number of modules is large and the modules are
+organized in a regular manner that can be described by a pattern.
+.PP
+Multiple instances of the \f[CB]\-\-module\-source\-path\f[R] option may
+be given, each one using either the module\-pattern form or the
+module\-specific form, subject to the following limitations:
+.IP \[bu] 2
+the module\-pattern form may be used at most once
+.IP \[bu] 2
+the module\-specific form may be used at most once for any given module
+.PP
+If the module\-specific form is used for any module, the associated
+search path overrides any path that might otherwise have been inferred
+from the module\-pattern form.
+.SS Module\-specific form
+.PP
+The module\-specific form allows an explicit search path to be given for
+any specific module.
+This form is:
+.IP \[bu] 2
+\f[CB]\-\-module\-source\-path\f[R]
+\f[I]module\-name\f[R]\f[CB]=\f[R]\f[I]file\-path\f[R]
+(\f[I]path\-separator\f[R] \f[I]file\-path\f[R])*
+.PP
+The path separator character is \f[CB];\f[R] on Windows, and \f[CB]:\f[R]
+otherwise.
+.PP
+\f[B]Note:\f[R] this is similar to the form used for the
+\f[B]\f[BC]\-\-patch\-module\f[B]\f[R] option.
+.SS Module\-pattern form
+.PP
+The module\-pattern form allows a concise specification of the module
+source path for any number of modules organized in regular manner.
+.IP \[bu] 2
+\f[CB]\-\-module\-source\-path\f[R] \f[I]pattern\f[R]
+.PP
+The pattern is defined by the following rules, which are applied in
+order:
+.IP \[bu] 2
+The argument is considered to be a series of segments separated by the
+path separator character (\f[CB];\f[R] on Windows, and \f[CB]:\f[R]
+otherwise).
+.IP \[bu] 2
+Each segment containing curly braces of the form
+.RS 2
+.IP
+.nf
+\f[CB]
+string1{alt1\ (\ ,alt2\ )*\ }\ string2
+\f[R]
+.fi
+.PP
+is considered to be replaced by a series of segments formed by
+"expanding" the braces:
+.IP
+.nf
+\f[CB]
+string1\ alt1\ string2
+string1\ alt2\ string2
+and\ so\ on...
+\f[R]
+.fi
+.PP
+The braces may be nested.
+.PP
+This rule is applied for all such usages of braces.
+.RE
+.IP \[bu] 2
+Each segment must have at most one asterisk (\f[CB]*\f[R]).
+If a segment does not contain an asterisk, it is considered to be as
+though the file separator character and an asterisk are appended.
+.RS 2
+.PP
+For any module \f[I]M\f[R], the source path for that module is formed
+from the series of segments obtained by substituting the module name
+\f[I]M\f[R] for the asterisk in each segment.
+.PP
+\f[B]Note\f[R]: in this context, the asterisk is just used as a special
+marker, to denote the position in the path of the module name.
+It should not be confused with the use of \f[CB]*\f[R] as a file name
+wildcard character, as found on most operating systems.
+.RE
+.SH PATCHING MODULES
+.PP
+javac allows any content, whether in source or compiled form, to be
+patched into any module using the \f[B]\f[BC]\-\-patch\-module\f[B]\f[R]
+option.
+You may want to do this to compile alternative implementations of a
+class to be patched at runtime into a JVM, or to inject additional
+classes into the module, such as when testing.
+.PP
+The form of the option is:
+.IP \[bu] 2
+\f[CB]\-\-patch\-module\f[R]
+\f[I]module\-name\f[R]\f[CB]=\f[R]\f[I]file\-path\f[R]
+(\f[I]path\-separator\f[R] \f[I]file\-path\f[R] )*
+.PP
+The path separator character is \f[CB];\f[R] on Windows, and \f[CB]:\f[R]
+otherwise.
+The paths given for the module must specify the root of a package
+hierarchy for the contents of the module
+.PP
+The option may be given at most once for any given module.
+Any content on the path will hide any like\-named content later in the
+path and in the patched module.
+.PP
+When patching source code into more than one module, the
+\f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R] must also be used, so that
+the output directory is organized in a module hierarchy, and capable of
+holding the compiled class files for the modules being compiled.
+.SH ANNOTATION PROCESSING
+.PP
+The \f[CB]javac\f[R] command provides direct support for annotation
+processing.
+.PP
+The API for annotation processors is defined in the
+\f[CB]javax.annotation.processing\f[R] and \f[CB]javax.lang.model\f[R]
+packages and subpackages.
+.SS How Annotation Processing Works
+.PP
+Unless annotation processing is disabled with the
+\f[B]\f[BC]\-proc:none\f[B]\f[R] option, the compiler searches for any
+annotation processors that are available.
+The search path can be specified with the
+\f[B]\f[BC]\-processorpath\f[B]\f[R] option.
+If no path is specified, then the user class path is used.
+Processors are located by means of service provider\-configuration files
+named \f[CB]META\-INF/services/javax.annotation.processing\f[R].
+Processor on the search path.
+Such files should contain the names of any annotation processors to be
+used, listed one per line.
+Alternatively, processors can be specified explicitly, using the
+\f[B]\f[BC]\-processor\f[B]\f[R] option.
+.PP
+After scanning the source files and classes on the command line to
+determine what annotations are present, the compiler queries the
+processors to determine what annotations they process.
+When a match is found, the processor is called.
+A processor can claim the annotations it processes, in which case no
+further attempt is made to find any processors for those annotations.
+After all of the annotations are claimed, the compiler does not search
+for additional processors.
+.PP
+If any processors generate new source files, then another round of
+annotation processing occurs: Any newly generated source files are
+scanned, and the annotations processed as before.
+Any processors called on previous rounds are also called on all
+subsequent rounds.
+This continues until no new source files are generated.
+.PP
+After a round occurs where no new source files are generated, the
+annotation processors are called one last time, to give them a chance to
+complete any remaining work.
+Finally, unless the \f[B]\f[BC]\-proc:only\f[B]\f[R] option is used, the
+compiler compiles the original and all generated source files.
+.PP
+If you use an annotation processor that generates additional source
+files to be included in the compilation, you can specify a default
+module to be used for the newly generated files, for use when a module
+declaration is not also generated.
+In this case, use the
+\f[B]\f[BC]\-\-default\-module\-for\-created\-files\f[B]\f[R] option.
+.SS Compilation Environment and Runtime Environment.
+.PP
+The declarations in source files and previously compiled class files are
+analyzed by \f[CB]javac\f[R] in a \f[I]compilation environment\f[R] that is
+distinct from the \f[I]runtime environment\f[R] used to execute
+\f[CB]javac\f[R] itself.
+Although there is a deliberate similarity between many \f[CB]javac\f[R]
+options and like\-named options for the Java \f[B]launcher\f[R], such as
+\f[CB]\-\-class\-path\f[R], \f[CB]\-\-module\-path\f[R] and so on, it is
+important to understand that in general the \f[CB]javac\f[R] options just
+affect the environment in which the source files are compiled, and do
+not affect the operation of \f[CB]javac\f[R] itself.
+.PP
+The distinction between the compilation environment and runtime
+environment is significant when it comes to using annotation processors.
+Although annotations processors process elements (declarations) that
+exist in the compilation environment, the annotation processor itself is
+executed in the runtime environment.
+If an annotation processor has dependencies on libraries that are not in
+modules, the libraries can be placed, along with the annotation
+processor itself, on the processor path.
+(See the \f[B]\f[BC]\-\-processor\-path\f[B]\f[R] option.) If the
+annotation processor and its dependencies are in modules, you should use
+the processor module path instead.
+(See the \f[B]\f[BC]\-\-processor\-module\-path\f[B]\f[R] option.) When
+those are insufficient, it may be necessary to provide further
+configuration of the runtime environment.
+This can be done in two ways:
+.IP "1." 3
+If \f[CB]javac\f[R] is invoked from the command line, options can be
+passed to the underlying runtime by prefixing the option with
+\f[B]\f[BC]\-J\f[B]\f[R].
+.IP "2." 3
+You can start an instance of a Java Virtual Machine directly and use
+command line options and API to configure an environment in which
+\f[CB]javac\f[R] can be invoked via one of its \f[B]APIs\f[R].
+.SH COMPILING FOR EARLIER RELEASES OF THE PLATFORM
+.PP
+\f[CB]javac\f[R] can compile code that is to be used on other releases of
+the platform, using either the \f[B]\f[BC]\-\-release\f[B]\f[R] option,
+or the \f[B]\f[BC]\-\-source\f[B]\f[R]/\f[CB]\-source\f[R] and
+\f[B]\f[BC]\-\-target\f[B]\f[R]/\f[CB]\-target\f[R] options, together with
+additional options to specify the platform classes.
+.PP
+Depending on the desired platform release, there are some restrictions
+on some of the options that can be used.
+.IP \[bu] 2
+When compiling for JDK 8 and earlier releases, you cannot use any option
+that is intended for use with the module system.
+This includes all of the following options:
+.RS 2
+.IP \[bu] 2
+\f[B]\f[BC]\-\-module\-source\-path\f[B]\f[R],
+\f[B]\f[BC]\-\-upgrade\-module\-path\f[B]\f[R],
+\f[B]\f[BC]\-\-system\f[B]\f[R], \f[B]\f[BC]\-\-module\-path\f[B]\f[R],
+\f[B]\f[BC]\-\-add\-modules\f[B]\f[R],
+\f[B]\f[BC]\-\-add\-exports\f[B]\f[R], \f[CB]\-\-add\-opens\f[R],
+\f[B]\f[BC]\-\-add\-reads\f[B]\f[R],
+\f[B]\f[BC]\-\-limit\-modules\f[B]\f[R],
+\f[B]\f[BC]\-\-patch\-module\f[B]\f[R]
+.PP
+If you use the \f[CB]\-\-source\f[R]/\f[CB]\-source\f[R] or
+\f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options, you should also set the
+appropriate platform classes using the boot class path family of
+options.
+.RE
+.IP \[bu] 2
+When compiling for JDK 9 and later releases, you cannot use any option
+that is intended to configure the boot class path.
+This includes all of the following options:
+.RS 2
+.IP \[bu] 2
+\f[B]\f[BC]\-Xbootclasspath/p:\f[B]\f[R],
+\f[B]\f[BC]\-Xbootclasspath\f[B]\f[R],
+\f[B]\f[BC]\-Xbootclasspath/a:\f[B]\f[R],
+\f[B]\f[BC]\-endorseddirs\f[B]\f[R],
+\f[B]\f[BC]\-Djava.endorsed.dirs\f[B]\f[R],
+\f[B]\f[BC]\-extdirs\f[B]\f[R], \f[B]\f[BC]\-Djava.ext.dirs\f[B]\f[R],
+\f[B]\f[BC]\-profile\f[B]\f[R]
+.PP
+If you use the \f[CB]\-\-source\f[R]/\f[CB]\-source\f[R] or
+\f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options, you should also set the
+appropriate platform classes using the \f[CB]\-\-system\f[R] option to
+give the location of an appropriate installed release of JDK.
+.RE
+.PP
+When using the \f[CB]\-\-release\f[R] option, only the supported
+documented API for that release may be used; you cannot use any options
+to break encapsulation to access any internal classes.
+.SH APIS
+.PP
+The \f[CB]javac\f[R] compiler can be invoked using an API in three
+different ways:
+.TP
+.B The \f[B]Java Compiler API\f[R]
+This provides the most flexible way to invoke the compiler, including
+the ability to compile source files provided in memory buffers or other
+non\-standard file systems.
+.RS
+.RE
+.TP
+.B The \f[B]ToolProvider API\f[R]
+A \f[CB]ToolProvider\f[R] for \f[CB]javac\f[R] can be obtained by calling
+\f[CB]ToolProvider.findFirst("javac")\f[R].
+This returns an object with the equivalent functionality of the
+command\-line tool.
+.RS
+.PP
+\f[B]Note\f[R]: This API should not be confused with the like\-named API
+in the \f[B]\f[BC]javax.tools\f[B]\f[R] package.
+.RE
+.TP
+.B The \f[CB]javac\f[R] \f[B]Legacy API\f[R]
+This API is retained for backward compatibility only.
+All new code should use either the Java Compiler API or the ToolProvider
+API.
+.RS
+.RE
+.PP
+\f[B]Note:\f[R] All other classes and methods found in a package with
+names that start with \f[CB]com.sun.tools.javac\f[R] (subpackages of
+\f[CB]com.sun.tools.javac\f[R]) are strictly internal and subject to
+change at any time.
+.SH EXAMPLES OF USING \-XLINT KEYS
+.TP
+.B \f[CB]cast\f[R]
+Warns about unnecessary and redundant casts, for example:
+.RS
+.RS
+.PP
+\f[CB]String\ s\ =\ (String)\ "Hello!"\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]classfile\f[R]
+Warns about issues related to class file contents.
+.RS
+.RE
+.TP
+.B \f[CB]deprecation\f[R]
+Warns about the use of deprecated items.
+For example:
+.RS
+.IP
+.nf
+\f[CB]
+java.util.Date\ myDate\ =\ new\ java.util.Date();
+int\ currentDay\ =\ myDate.getDay();
+\f[R]
+.fi
+.PP
+The method \f[CB]java.util.Date.getDay\f[R] has been deprecated since JDK
+1.1.
+.RE
+.TP
+.B \f[CB]dep\-ann\f[R]
+Warns about items that are documented with the \f[CB]\@deprecated\f[R]
+Javadoc comment, but do not have the \f[CB]\@Deprecated\f[R] annotation,
+for example:
+.RS
+.IP
+.nf
+\f[CB]
+/**
+\ \ *\ \@deprecated\ As\ of\ Java\ SE\ 7,\ replaced\ by\ {\@link\ #newMethod()}
+\ \ */
+public\ static\ void\ deprecatedMethod()\ {\ }
+public\ static\ void\ newMethod()\ {\ }
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]divzero\f[R]
+Warns about division by the constant integer 0, for example:
+.RS
+.RS
+.PP
+\f[CB]int\ divideByZero\ =\ 42\ /\ 0;\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]empty\f[R]
+Warns about empty statements after \f[CB]if\f[R]statements, for example:
+.RS
+.IP
+.nf
+\f[CB]
+class\ E\ {
+\ \ \ \ void\ m()\ {
+\ \ \ \ \ \ \ \ \ if\ (true)\ ;
+\ \ \ \ }
+}
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]fallthrough\f[R]
+Checks the switch blocks for fall\-through cases and provides a warning
+message for any that are found.
+Fall\-through cases are cases in a switch block, other than the last
+case in the block, whose code does not include a \f[CB]break\f[R]
+statement, allowing code execution to fall through from that case to the
+next case.
+For example, the code following the case 1 label in this switch block
+does not end with a \f[CB]break\f[R] statement:
+.RS
+.IP
+.nf
+\f[CB]
+switch\ (x)\ {
+case\ 1:
+\ \ System.out.println("1");
+\ \ //\ No\ break\ statement\ here.
+case\ 2:
+\ \ System.out.println("2");
+}
+\f[R]
+.fi
+.PP
+If the \f[CB]\-Xlint:fallthrough\f[R] option was used when compiling this
+code, then the compiler emits a warning about possible fall\-through
+into case, with the line number of the case in question.
+.RE
+.TP
+.B \f[CB]finally\f[R]
+Warns about \f[CB]finally\f[R] clauses that cannot be completed normally,
+for example:
+.RS
+.IP
+.nf
+\f[CB]
+public\ static\ int\ m()\ {
+\ \ try\ {
+\ \ \ \ \ throw\ new\ NullPointerException();
+\ \ }\ \ catch\ (NullPointerException();\ {
+\ \ \ \ \ System.err.println("Caught\ NullPointerException.");
+\ \ \ \ \ return\ 1;
+\ \ \ }\ finally\ {
+\ \ \ \ \ return\ 0;
+\ \ \ }
+\ \ }
+\f[R]
+.fi
+.PP
+The compiler generates a warning for the \f[CB]finally\f[R] block in this
+example.
+When the \f[CB]int\f[R] method is called, it returns a value of 0.
+A \f[CB]finally\f[R] block executes when the \f[CB]try\f[R] block exits.
+In this example, when control is transferred to the \f[CB]catch\f[R]
+block, the \f[CB]int\f[R] method exits.
+However, the \f[CB]finally\f[R] block must execute, so it\[aq]s executed,
+even though control was transferred outside the method.
+.RE
+.TP
+.B \f[CB]options\f[R]
+Warns about issues that related to the use of command\-line options.
+See \f[B]Compiling for Earlier Releases of the Platform\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]overrides\f[R]
+Warns about issues related to method overrides.
+For example, consider the following two classes:
+.RS
+.IP
+.nf
+\f[CB]
+public\ class\ ClassWithVarargsMethod\ {
+\ \ void\ varargsMethod(String...\ s)\ {\ }
+}
+
+public\ class\ ClassWithOverridingMethod\ extends\ ClassWithVarargsMethod\ {
+\ \ \ \@Override
+\ \ \ void\ varargsMethod(String[]\ s)\ {\ }
+}
+\f[R]
+.fi
+.PP
+The compiler generates a warning similar to the following:.
+.IP
+.nf
+\f[CB]
+warning:\ [override]\ varargsMethod(String[])\ in\ ClassWithOverridingMethod
+overrides\ varargsMethod(String...)\ in\ ClassWithVarargsMethod;\ overriding
+method\ is\ missing\ \[aq]...\[aq]
+\f[R]
+.fi
+.PP
+When the compiler encounters a \f[CB]varargs\f[R] method, it translates
+the \f[CB]varargs\f[R] formal parameter into an array.
+In the method \f[CB]ClassWithVarargsMethod.varargsMethod\f[R], the
+compiler translates the \f[CB]varargs\f[R] formal parameter
+\f[CB]String...\ s\f[R] to the formal parameter \f[CB]String[]\ s\f[R], an
+array that matches the formal parameter of the method
+\f[CB]ClassWithOverridingMethod.varargsMethod\f[R].
+Consequently, this example compiles.
+.RE
+.TP
+.B \f[CB]path\f[R]
+Warns about invalid path elements and nonexistent path directories on
+the command line (with regard to the class path, the source path, and
+other paths).
+Such warnings cannot be suppressed with the \f[CB]\@SuppressWarnings\f[R]
+annotation.
+For example:
+.RS
+.IP \[bu] 2
+\f[B]Linux and macOS:\f[R]
+\f[CB]javac\ \-Xlint:path\ \-classpath\ /nonexistentpath\ Example.java\f[R]
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+\f[CB]javac\ \-Xlint:path\ \-classpath\ C:\\nonexistentpath\ Example.java\f[R]
+.RE
+.TP
+.B \f[CB]processing\f[R]
+Warns about issues related to annotation processing.
+The compiler generates this warning when you have a class that has an
+annotation, and you use an annotation processor that cannot handle that
+type of annotation.
+For example, the following is a simple annotation processor:
+.RS
+.PP
+\f[B]Source file AnnoProc.java\f[R]:
+.IP
+.nf
+\f[CB]
+import\ java.util.*;
+import\ javax.annotation.processing.*;
+import\ javax.lang.model.*;
+import\ javax.lang.model.element.*;
+
+\@SupportedAnnotationTypes("NotAnno")
+public\ class\ AnnoProc\ extends\ AbstractProcessor\ {
+\ \ public\ boolean\ process(Set<?\ extends\ TypeElement>\ elems,\ RoundEnvironment\ renv){
+\ \ \ \ \ return\ true;
+\ \ }
+
+\ \ public\ SourceVersion\ getSupportedSourceVersion()\ {
+\ \ \ \ \ return\ SourceVersion.latest();
+\ \ \ }
+}
+\f[R]
+.fi
+.PP
+\f[B]Source file AnnosWithoutProcessors.java\f[R]:
+.IP
+.nf
+\f[CB]
+\@interface\ Anno\ {\ }
+
+\@Anno
+class\ AnnosWithoutProcessors\ {\ }
+\f[R]
+.fi
+.PP
+The following commands compile the annotation processor
+\f[CB]AnnoProc\f[R], then run this annotation processor against the source
+file \f[CB]AnnosWithoutProcessors.java\f[R]:
+.IP
+.nf
+\f[CB]
+javac\ AnnoProc.java
+javac\ \-cp\ .\ \-Xlint:processing\ \-processor\ AnnoProc\ \-proc:only\ AnnosWithoutProcessors.java
+\f[R]
+.fi
+.PP
+When the compiler runs the annotation processor against the source file
+\f[CB]AnnosWithoutProcessors.java\f[R], it generates the following
+warning:
+.IP
+.nf
+\f[CB]
+warning:\ [processing]\ No\ processor\ claimed\ any\ of\ these\ annotations:\ Anno
+\f[R]
+.fi
+.PP
+To resolve this issue, you can rename the annotation defined and used in
+the class \f[CB]AnnosWithoutProcessors\f[R] from \f[CB]Anno\f[R] to
+\f[CB]NotAnno\f[R].
+.RE
+.TP
+.B \f[CB]rawtypes\f[R]
+Warns about unchecked operations on raw types.
+The following statement generates a \f[CB]rawtypes\f[R] warning:
+.RS
+.RS
+.PP
+\f[CB]void\ countElements(List\ l)\ {\ ...\ }\f[R]
+.RE
+.PP
+The following example does not generate a \f[CB]rawtypes\f[R] warning:
+.RS
+.PP
+\f[CB]void\ countElements(List<?>\ l)\ {\ ...\ }\f[R]
+.RE
+.PP
+\f[CB]List\f[R] is a raw type.
+However, \f[CB]List<?>\f[R] is an unbounded wildcard parameterized type.
+Because \f[CB]List\f[R] is a parameterized interface, always specify its
+type argument.
+In this example, the \f[CB]List\f[R] formal argument is specified with an
+unbounded wildcard (\f[CB]?\f[R]) as its formal type parameter, which
+means that the \f[CB]countElements\f[R] method can accept any
+instantiation of the \f[CB]List\f[R] interface.
+.RE
+.TP
+.B \f[CB]serial\f[R]
+Warns about missing \f[CB]serialVersionUID\f[R] definitions on
+serializable classes.
+For example:
+.RS
+.IP
+.nf
+\f[CB]
+public\ class\ PersistentTime\ implements\ Serializable
+{
+\ \ private\ Date\ time;
+
+\ \ \ public\ PersistentTime()\ {
+\ \ \ \ \ time\ =\ Calendar.getInstance().getTime();
+\ \ \ }
+
+\ \ \ public\ Date\ getTime()\ {
+\ \ \ \ \ return\ time;
+\ \ \ }
+}
+\f[R]
+.fi
+.PP
+The compiler generates the following warning:
+.IP
+.nf
+\f[CB]
+warning:\ [serial]\ serializable\ class\ PersistentTime\ has\ no\ definition\ of
+serialVersionUID
+\f[R]
+.fi
+.PP
+If a serializable class does not explicitly declare a field named
+\f[CB]serialVersionUID\f[R], then the serialization runtime environment
+calculates a default \f[CB]serialVersionUID\f[R] value for that class
+based on various aspects of the class, as described in the Java Object
+Serialization Specification.
+However, it\[aq]s strongly recommended that all serializable classes
+explicitly declare \f[CB]serialVersionUID\f[R] values because the default
+process of computing \f[CB]serialVersionUID\f[R] values is highly
+sensitive to class details that can vary depending on compiler
+implementations.
+As a result, this might cause an unexpected
+\f[CB]InvalidClassExceptions\f[R] during deserialization.
+To guarantee a consistent \f[CB]serialVersionUID\f[R] value across
+different Java compiler implementations, a serializable class must
+declare an explicit \f[CB]serialVersionUID\f[R] value.
+.RE
+.TP
+.B \f[CB]static\f[R]
+Warns about issues relating to the use of static variables, for example:
+.RS
+.IP
+.nf
+\f[CB]
+class\ XLintStatic\ {
+\ \ \ \ static\ void\ m1()\ {\ }
+\ \ \ \ void\ m2()\ {\ this.m1();\ }
+}
+\f[R]
+.fi
+.PP
+The compiler generates the following warning:
+.IP
+.nf
+\f[CB]
+warning:\ [static]\ static\ method\ should\ be\ qualified\ by\ type\ name,
+XLintStatic,\ instead\ of\ by\ an\ expression
+\f[R]
+.fi
+.PP
+To resolve this issue, you can call the \f[CB]static\f[R] method
+\f[CB]m1\f[R] as follows:
+.RS
+.PP
+\f[CB]XLintStatic.m1();\f[R]
+.RE
+.PP
+Alternately, you can remove the \f[CB]static\f[R] keyword from the
+declaration of the method \f[CB]m1\f[R].
+.RE
+.TP
+.B \f[CB]try\f[R]
+Warns about issues relating to the use of \f[CB]try\f[R] blocks, including
+try\-with\-resources statements.
+For example, a warning is generated for the following statement because
+the resource \f[CB]ac\f[R] declared in the \f[CB]try\f[R] block is not used:
+.RS
+.IP
+.nf
+\f[CB]
+try\ (\ AutoCloseable\ ac\ =\ getResource()\ )\ {\ \ \ \ //\ do\ nothing}
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]unchecked\f[R]
+Gives more detail for unchecked conversion warnings that are mandated by
+the Java Language Specification, for example:
+.RS
+.IP
+.nf
+\f[CB]
+List\ l\ =\ new\ ArrayList<Number>();
+List<String>\ ls\ =\ l;\ \ \ \ \ \ \ //\ unchecked\ warning
+\f[R]
+.fi
+.PP
+During type erasure, the types \f[CB]ArrayList<Number>\f[R] and
+\f[CB]List<String>\f[R] become \f[CB]ArrayList\f[R] and \f[CB]List\f[R],
+respectively.
+.PP
+The \f[CB]ls\f[R] command has the parameterized type
+\f[CB]List<String>\f[R].
+When the \f[CB]List\f[R] referenced by \f[CB]l\f[R] is assigned to
+\f[CB]ls\f[R], the compiler generates an unchecked warning.
+At compile time, the compiler and JVM cannot determine whether
+\f[CB]l\f[R] refers to a \f[CB]List<String>\f[R] type.
+In this case, \f[CB]l\f[R] does not refer to a \f[CB]List<String>\f[R] type.
+As a result, heap pollution occurs.
+.PP
+A heap pollution situation occurs when the \f[CB]List\f[R] object
+\f[CB]l\f[R], whose static type is \f[CB]List<Number>\f[R], is assigned to
+another \f[CB]List\f[R] object, \f[CB]ls\f[R], that has a different static
+type, \f[CB]List<String>\f[R].
+However, the compiler still allows this assignment.
+It must allow this assignment to preserve backward compatibility with
+releases of Java SE that do not support generics.
+Because of type erasure, \f[CB]List<Number>\f[R] and \f[CB]List<String>\f[R]
+both become \f[CB]List\f[R].
+Consequently, the compiler allows the assignment of the object
+\f[CB]l\f[R], which has a raw type of \f[CB]List\f[R], to the object
+\f[CB]ls\f[R].
+.RE
+.TP
+.B \f[CB]varargs\f[R]
+Warns about unsafe use of variable arguments (\f[CB]varargs\f[R]) methods,
+in particular, those that contain non\-reifiable arguments, for example:
+.RS
+.IP
+.nf
+\f[CB]
+public\ class\ ArrayBuilder\ {
+\ \ public\ static\ <T>\ void\ addToList\ (List<T>\ listArg,\ T...\ elements)\ {
+\ \ \ \ for\ (T\ x\ :\ elements)\ {
+\ \ \ \ \ \ listArg.add(x);
+\ \ \ \ }
+\ \ }
+}
+\f[R]
+.fi
+.PP
+A non\-reifiable type is a type whose type information is not fully
+available at runtime.
+.PP
+The compiler generates the following warning for the definition of the
+method \f[CB]ArrayBuilder.addToList\f[R]:
+.IP
+.nf
+\f[CB]
+warning:\ [varargs]\ Possible\ heap\ pollution\ from\ parameterized\ vararg\ type\ T
+\f[R]
+.fi
+.PP
+When the compiler encounters a varargs method, it translates the
+\f[CB]varargs\f[R] formal parameter into an array.
+However, the Java programming language does not permit the creation of
+arrays of parameterized types.
+In the method \f[CB]ArrayBuilder.addToList\f[R], the compiler translates
+the \f[CB]varargs\f[R] formal parameter \f[CB]T...\f[R] elements to the
+formal parameter \f[CB]T[]\f[R] elements, an array.
+However, because of type erasure, the compiler converts the
+\f[CB]varargs\f[R] formal parameter to \f[CB]Object[]\f[R] elements.
+Consequently, there\[aq]s a possibility of heap pollution.
+.RE
diff --git a/java/temurin-17/man/man1/javadoc.1 b/java/temurin-17/man/man1/javadoc.1
new file mode 100644
index 0000000..41f53c9
--- /dev/null
+++ b/java/temurin-17/man/man1/javadoc.1
@@ -0,0 +1,1282 @@
+.\" Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JAVADOC" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+javadoc \- generate HTML pages of API documentation from Java source
+files
+.SH SYNOPSIS
+.PP
+\f[CB]javadoc\f[R] [\f[I]options\f[R]] [\f[I]packagenames\f[R]]
+[\f[I]sourcefiles\f[R]] [\f[CB]\@\f[R]\f[I]files\f[R]]
+.TP
+.B \f[I]options\f[R]
+Specifies command\-line options, separated by spaces.
+See \f[B]Options for javadoc\f[R], \f[B]Extended Options\f[R],
+\f[B]Standard doclet Options\f[R], and \f[B]Additional Options Provided
+by the Standard doclet\f[R].
+.RS
+.RE
+.TP
+.B \f[I]packagenames\f[R]
+Specifies names of packages that you want to document, separated by
+spaces, for example \f[CB]java.lang\ java.lang.reflect\ java.awt\f[R].
+If you want to also document the subpackages, then use the
+\f[CB]\-subpackages\f[R] option to specify the packages.
+.RS
+.PP
+By default, \f[CB]javadoc\f[R] looks for the specified packages in the
+current directory and subdirectories.
+Use the \f[CB]\-sourcepath\f[R] option to specify the list of directories
+where to look for packages.
+.RE
+.TP
+.B \f[I]sourcefiles\f[R]
+Specifies names of Java source files that you want to document,
+separated by spaces, for example
+\f[CB]Class.java\ Object.java\ Button.java\f[R].
+By default, \f[CB]javadoc\f[R] looks for the specified classes in the
+current directory.
+However, you can specify the full path to the class file and use
+wildcard characters, for example
+\f[CB]/home/src/java/awt/Graphics*.java\f[R].
+You can also specify the path relative to the current directory.
+.RS
+.RE
+.TP
+.B \f[CB]\@\f[R]\f[I]files\f[R]
+Specifies names of files that contain a list of \f[CB]javadoc\f[R] tool
+options, package names, and source file names in any order.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]javadoc\f[R] tool parses the declarations and documentation
+comments in a set of Java source files and produces corresponding HTML
+pages that describe (by default) the public and protected classes,
+nested classes (but not anonymous inner classes), interfaces,
+constructors, methods, and fields.
+You can use the \f[CB]javadoc\f[R] tool to generate the API documentation
+or the implementation documentation for a set of source files.
+.PP
+You can run the \f[CB]javadoc\f[R] tool on entire packages, individual
+source files, or both.
+When documenting entire packages, you can use the \f[CB]\-subpackages\f[R]
+option either to recursively traverse a directory and its
+subdirectories, or to pass in an explicit list of package names.
+When you document individual source files, pass in a list of Java source
+file names.
+See \f[B]javadoc Overview\f[R]
+[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/13/tools&id=JSJAV\-GUID\-7A344353\-3BBF\-45C4\-8B28\-15025DDCC643]
+in Java Platform, Standard Edition Javadoc Guide for information about
+using the \f[CB]javadoc\f[R] tool.
+.SH CONFORMANCE
+.PP
+The standard doclet does not validate the content of documentation
+comments for conformance, nor does it attempt to correct any errors in
+documentation comments.
+Anyone running javadoc is advised to be aware of the problems that may
+arise when generating non\-conformant output or output containing
+executable content, such as JavaScript.
+The standard doclet does provide the \f[CB]doclint\f[R] feature to help
+developers detect common problems in documentation comments; but it is
+also recommended to check the generated output with any appropriate
+conformance and other checking tools.
+.PP
+For more details on the conformance requirements for HTML5 documents,
+see \f[B]Conformance requirements\f[R]
+[https://www.w3.org/TR/html5/infrastructure.html#conformance\-requirements]
+in the HTML5 Specification.
+For more details on security issues related to web pages, see the
+\f[B]Open Web Application Security Project (OWASP)\f[R]
+[https://www.owasp.org] page.
+.SH OPTIONS FOR JAVADOC
+.PP
+The following core \f[CB]javadoc\f[R] options are equivalent to
+corresponding \f[CB]javac\f[R] options.
+See \f[I]Standard Options\f[R] in \f[B]javac\f[R] for the detailed
+descriptions of using these options:
+.IP \[bu] 2
+\f[CB]\-\-add\-modules\f[R]
+.IP \[bu] 2
+\f[CB]\-bootclasspath\f[R]
+.IP \[bu] 2
+\f[CB]\-\-class\-path\f[R], \f[CB]\-classpath\f[R], or \f[CB]\-cp\f[R]
+.IP \[bu] 2
+\f[CB]\-\-enable\-preview\f[R]
+.IP \[bu] 2
+\f[CB]\-encoding\f[R]
+.IP \[bu] 2
+\f[CB]\-extdirs\f[R]
+.IP \[bu] 2
+\f[CB]\-\-limit\-modules\f[R]
+.IP \[bu] 2
+\f[CB]\-\-module\f[R]
+.IP \[bu] 2
+\f[CB]\-\-module\-path\f[R] or \f[CB]\-p\f[R]
+.IP \[bu] 2
+\f[CB]\-\-module\-source\-path\f[R]
+.IP \[bu] 2
+\f[CB]\-\-release\f[R]
+.IP \[bu] 2
+\f[CB]\-\-source\f[R] or \f[CB]\-source\f[R]
+.IP \[bu] 2
+\f[CB]\-\-source\-path\f[R] or \f[CB]\-sourcepath\f[R]
+.IP \[bu] 2
+\f[CB]\-\-system\f[R]
+.IP \[bu] 2
+\f[CB]\-\-upgrade\-module\-path\f[R]
+.PP
+The following options are the core \f[CB]javadoc\f[R] options that are not
+equivalent to a corresponding \f[CB]javac\f[R] option:
+.PP
+\f[B]Note:\f[R]
+.PP
+In tools that support \f[CB]\-\-\f[R] style options, the GNU\-style
+options can use the equal sign (=) instead of a white space to separate
+the name of an option from its value.
+.TP
+.B \f[CB]\-breakiterator\f[R]
+Computes the first sentence with \f[CB]BreakIterator\f[R].
+The first sentence is copied to the package, class, or member summary
+and to the alphabetic index.
+The \f[CB]BreakIterator\f[R] class is used to determine the end of a
+sentence for all languages except for English.
+.RS
+.IP \[bu] 2
+English default sentence\-break algorithm \-\-\- Stops at a period
+followed by a space or an HTML block tag, such as \f[CB]<P>\f[R].
+.IP \[bu] 2
+Breakiterator sentence\-break algorithm \-\-\- Stops at a period,
+question mark, or exclamation point followed by a space when the next
+word starts with a capital letter.
+This is meant to handle most abbreviations (such as "The serial no.
+is valid", but will not handle "Mr.
+Smith").
+The \f[CB]\-breakiterator\f[R] option doesn\[aq]t stop at HTML tags or
+sentences that begin with numbers or symbols.
+The algorithm stops at the last period in \f[CB]\&../filename\f[R], even
+when embedded in an HTML tag.
+.RE
+.TP
+.B \f[CB]\-doclet\f[R] \f[I]class\f[R]
+Generates output by using an alternate doclet.
+Use the fully qualified name.
+This doclet defines the content and formats the output.
+If the \f[CB]\-doclet\f[R] option isn\[aq]t used, then the
+\f[CB]javadoc\f[R] tool uses the standard doclet for generating the
+default HTML format.
+This class must contain the \f[CB]start(Root)\f[R] method.
+The path to this starting class is defined by the \f[CB]\-docletpath\f[R]
+option.
+.RS
+.RE
+.TP
+.B \f[CB]\-docletpath\f[R] \f[I]path\f[R]
+Specifies where to find doclet class files (specified with the
+\f[CB]\-doclet\f[R] option) and any JAR files it depends on.
+If the starting class file is in a JAR file, then this option specifies
+the path to that JAR file.
+You can specify an absolute path or a path relative to the current
+directory.
+If \f[CB]classpathlist\f[R] contains multiple paths or JAR files, then
+they should be separated with a colon (\f[CB]:\f[R]) on Linux and a
+semi\-colon (\f[CB];\f[R]) on Windows.
+This option isn\[aq]t necessary when the \f[CB]doclet\f[R] starting class
+is already in the search path.
+.RS
+.RE
+.TP
+.B \f[CB]\-exclude\f[R] \f[I]pkglist\f[R]
+Unconditionally, excludes the specified packages and their subpackages
+from the list formed by \f[CB]\-subpackages\f[R].
+It excludes those packages even when they would otherwise be included by
+some earlier or later \f[CB]\-subpackages\f[R] option.
+.RS
+.PP
+The following example would include \f[CB]java.io\f[R],
+\f[CB]java.util\f[R], and \f[CB]java.math\f[R] (among others), but would
+exclude packages rooted at \f[CB]java.net\f[R] and \f[CB]java.lang\f[R].
+Notice that these examples exclude \f[CB]java.lang.ref\f[R], which is a
+subpackage of \f[CB]java.lang\f[R].
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-sourcepath\ /home/user/src\ \-subpackages\ java\ \-exclude\ java.net:java.lang\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-sourcepath\ \\user\\src\ \-subpackages\ java\ \-exclude\ java.net:java.lang\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-\-expand\-requires\f[R] \f[I]value\f[R]
+Instructs the javadoc tool to expand the set of modules to be
+documented.
+By default, only the modules given explicitly on the command line are
+documented.
+Supports the following values:
+.RS
+.IP \[bu] 2
+\f[CB]transitive\f[R]: additionally includes all the required transitive
+dependencies of those modules.
+.IP \[bu] 2
+\f[CB]all\f[R]: includes all dependencies.
+.RE
+.TP
+.B \f[CB]\-\-help\f[R], \f[CB]\-help\f[R], \f[CB]\-h\f[R], or \f[CB]\-?\f[R]
+Prints a synopsis of the standard options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R] or \f[CB]\-X\f[R]
+Prints a synopsis of the set of extra options.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]flag\f[R]
+Passes \f[I]flag\f[R] directly to the Java Runtime Environment (JRE) that
+runs the \f[CB]javadoc\f[R] tool.
+For example, if you must ensure that the system sets aside 32 MB of
+memory in which to process the generated documentation, then you would
+call the \f[CB]\-Xmx\f[R] option as follows:
+\f[CB]javadoc\ \-J\-Xmx32m\ \-J\-Xms32m\ com.mypackage\f[R].
+Be aware that \f[CB]\-Xms\f[R] is optional because it only sets the size
+of initial memory, which is useful when you know the minimum amount of
+memory required.
+.RS
+.PP
+There is no space between the \f[CB]J\f[R] and the \f[CB]flag\f[R].
+.PP
+Use the \f[CB]\-version\f[R] option to report the version of the JRE being
+used to run the \f[CB]javadoc\f[R] tool.
+.IP
+.nf
+\f[CB]
+javadoc\ \-J\-version
+java\ version\ "10\-ea"\ 2018\-03\-20
+Java(TM)\ SE\ Runtime\ Environment\ 18.3\ (build\ 10\-ea+36)
+Java\ HotSpot(TM)\ 64\-Bit\ Server\ VM\ 18.3\ (build\ 10\-ea+36,\ mixed\ mode)
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]\-locale\f[R] \f[I]name\f[R]
+Specifies the locale that the \f[CB]javadoc\f[R] tool uses when it
+generates documentation.
+The argument is the name of the locale, as described in
+\f[CB]java.util.Locale\f[R] documentation, such as \f[CB]en_US\f[R]
+(English, United States) or \f[CB]en_US_WIN\f[R] (Windows variant).
+.RS
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]\-locale\f[R] option must be placed ahead (to the left) of any
+options provided by the standard doclet or any other doclet.
+Otherwise, the navigation bars appear in English.
+This is the only command\-line option that depends on order.
+.PP
+Specifying a locale causes the \f[CB]javadoc\f[R] tool to choose the
+resource files of that locale for messages such as strings in the
+navigation bar, headings for lists and tables, help file contents,
+comments in the \f[CB]stylesheet.css\f[R] file, and so on.
+It also specifies the sorting order for lists sorted alphabetically, and
+the sentence separator to determine the end of the first sentence.
+The \f[CB]\-locale\f[R] option doesn\[aq]t determine the locale of the
+documentation comment text specified in the source files of the
+documented classes.
+.RE
+.TP
+.B \f[CB]\-package\f[R]
+Shows only package, protected, and public classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-private\f[R]
+Shows all classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-protected\f[R]
+Shows only protected and public classes and members.
+This is the default.
+.RS
+.RE
+.TP
+.B \f[CB]\-public\f[R]
+Shows only the public classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-quiet\f[R]
+Shuts off messages so that only the warnings and errors appear to make
+them easier to view.
+It also suppresses the \f[CB]version\f[R] string.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-members\f[R] \f[I]value\f[R]
+Specifies which members (fields or methods) are documented, where
+\f[I]value\f[R] can be any of the following:
+.RS
+.IP \[bu] 2
+\f[CB]protected\f[R]: The default value is protected.
+.IP \[bu] 2
+\f[CB]public\f[R]: Shows only public values.
+.IP \[bu] 2
+\f[CB]package\f[R]: Shows public, protected, and package members.
+.IP \[bu] 2
+\f[CB]private\f[R]: Shows all members.
+.RE
+.TP
+.B \f[CB]\-\-show\-module\-contents\f[R] \f[I]value\f[R]
+Specifies the documentation granularity of module declarations, where
+\f[I]value\f[R] can be \f[CB]api\f[R] or \f[CB]all\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-packages\f[R] \f[I]value\f[R]
+Specifies which modules packages are documented, where \f[I]value\f[R]
+can be \f[CB]exported\f[R] or \f[CB]all\f[R] packages.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-types\f[R] \f[I]value\f[R]
+Specifies which types (classes, interfaces, etc.) are documented, where
+\f[I]value\f[R] can be any of the following:
+.RS
+.IP \[bu] 2
+\f[CB]protected\f[R]: The default value.
+Shows public and protected types.
+.IP \[bu] 2
+\f[CB]public\f[R]: Shows only public values.
+.IP \[bu] 2
+\f[CB]package\f[R]: Shows public, protected, and package types.
+.IP \[bu] 2
+\f[CB]private\f[R]: Shows all types.
+.RE
+.TP
+.B \f[CB]\-subpackages\f[R] \f[I]subpkglist\f[R]
+Generates documentation from source files in the specified packages and
+recursively in their subpackages.
+This option is useful when adding new subpackages to the source code
+because they are automatically included.
+Each package argument is any top\-level subpackage (such as
+\f[CB]java\f[R]) or fully qualified package (such as \f[CB]javax.swing\f[R])
+that doesn\[aq]t need to contain source files.
+Arguments are separated by colons on all operating systems.
+Wild cards aren\[aq]t allowed.
+Use \f[CB]\-sourcepath\f[R] to specify where to find the packages.
+This option doesn\[aq]t process source files that are in the source tree
+but don\[aq]t belong to the packages.
+.RS
+.PP
+For example, the following commands generates documentation for packages
+named \f[CB]java\f[R] and \f[CB]javax.swing\f[R] and all of their
+subpackages.
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-d\ docs\ \-sourcepath\ /home/user/src\ \-subpackages\ java:javax.swing\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-d\ docs\ \-sourcepath\ \\user\\src\ \-subpackages\ java:javax.swing\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-verbose\f[R]
+Provides more detailed messages while the \f[CB]javadoc\f[R] tool runs.
+Without the \f[CB]\-verbose\f[R] option, messages appear for loading the
+source files, generating the documentation (one message per source
+file), and sorting.
+The \f[CB]\-verbose\f[R] option causes the printing of additional messages
+that specify the number of milliseconds to parse each Java source file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints version information.
+.RS
+.RE
+.TP
+.B \f[CB]\-Werror\f[R]
+Reports an error if any warnings occur.
+.RS
+.RE
+.SH EXTENDED OPTIONS
+.PP
+\f[B]Note:\f[R]
+.PP
+The extended options for \f[CB]javadoc\f[R] are subject to change without
+notice.
+.PP
+The following extended \f[CB]javadoc\f[R] options are equivalent to
+corresponding \f[CB]javac\f[R] options.
+See \f[I]Extra Options\f[R] in \f[B]javac\f[R] for the detailed
+descriptions of using these options:
+.IP \[bu] 2
+\f[CB]\-\-add\-exports\f[R]
+.IP \[bu] 2
+\f[CB]\-\-add\-reads\f[R]
+.IP \[bu] 2
+\f[CB]\-\-patch\-module\f[R]
+.IP \[bu] 2
+\f[CB]\-Xmaxerrs\f[R]
+.IP \[bu] 2
+\f[CB]\-Xmaxwarns\f[R]
+.SH STANDARD DOCLET OPTIONS
+.PP
+The following options are provided by the standard doclet.
+.TP
+.B \f[CB]\-\-add\-stylesheet\f[R] \f[I]file\f[R]
+Adds additional stylesheet file for the generated documentation.
+This option can be used one or more times to specify additional
+stylesheets included in the documentation.
+.RS
+.PP
+Command\-line example:
+.RS
+.PP
+\f[CB]javadoc\ \-\-add\-stylesheet\ new_stylesheet_1.css\ \-\-add\-stylesheet\ new_stylesheet_2.css\ pkg_foo\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-\-allow\-script\-in\-comments\f[R]
+Allow JavaScript in options and comments
+.RS
+.RE
+.TP
+.B \f[CB]\-author\f[R]
+Includes the \f[CB]\@author\f[R] text in the generated docs.
+.RS
+.RE
+.TP
+.B \f[CB]\-bottom\f[R] \f[I]html\-code\f[R]
+Specifies the text to be placed at the bottom of each output file.
+The text is placed at the bottom of the page, underneath the lower
+navigation bar.
+The text can contain HTML tags and white space, but when it does, the
+text must be enclosed in quotation marks.
+Use escape characters for any internal quotation marks within text.
+.RS
+.RE
+.TP
+.B \f[CB]\-charset\f[R] \f[I]name\f[R]
+Specifies the HTML character set for this document.
+The name should be a preferred MIME name as specified in the \f[B]IANA
+Registry, Character Sets\f[R]
+[http://www.iana.org/assignments/character\-sets].
+.RS
+.PP
+For example:
+.RS
+.PP
+\f[CB]javadoc\ \-charset\ "iso\-8859\-1"\ mypackage\f[R]
+.RE
+.PP
+This command inserts the following line in the head of every generated
+page:
+.RS
+.PP
+\f[CB]<META\ http\-equiv="Content\-Type"\ content="text/html;\ charset=ISO\-8859\-1">\f[R]
+.RE
+.PP
+The \f[CB]META\f[R] tag is described in the \f[B]HTML standard (4197265
+and 4137321), HTML Document Representation\f[R]
+[http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2].
+.RE
+.TP
+.B \f[CB]\-d\f[R] \f[I]directory\f[R]
+Specifies the destination directory where the \f[CB]javadoc\f[R] tool
+saves the generated HTML files.
+If you omit the \f[CB]\-d\f[R] option, then the files are saved to the
+current directory.
+The \f[CB]directory\f[R] value can be absolute or relative to the current
+working directory.
+The destination directory is automatically created when the
+\f[CB]javadoc\f[R] tool runs.
+.RS
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R] For example, the following command generates
+the documentation for the package \f[CB]com.mypackage\f[R] and saves the
+results in the \f[CB]/user/doc/\f[R] directory:
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-d\ /user/doc/\ com.mypackage\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R] For example, the following command generates the
+documentation for the package \f[CB]com.mypackage\f[R] and saves the
+results in the \f[CB]\\user\\doc\\\f[R] directory:
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-d\ \\user\\doc\\\ com.mypackage\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-docencoding\f[R] \f[I]name\f[R]
+Specifies the encoding of the generated HTML files.
+The name should be a preferred MIME name as specified in the \f[B]IANA
+Registry, Character Sets\f[R]
+[http://www.iana.org/assignments/character\-sets].
+.RS
+.PP
+Three options are available for use in a \f[CB]javadoc\f[R] encoding
+command.
+The \f[CB]\-encoding\f[R] option is used for encoding the files read by
+the \f[CB]javadoc\f[R] tool, while the \f[CB]\-docencoding\f[R] and
+\f[CB]\-charset\f[R] options are used for encoding the files written by
+the tool.
+Of the three available options, at most, only the input and an output
+encoding option are used in a single encoding command.
+If you specify both input and output encoding options in a command, they
+must be the same value.
+If you specify neither output option, it the tool defaults to the input
+encoding.
+.PP
+For example:
+.RS
+.PP
+\f[CB]javadoc\ \-docencoding\ "iso\-8859\-1"\ mypackage\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-docfilessubdirs\f[R]
+Recursively copies doc\-file subdirectories.
+.RS
+.RE
+.TP
+.B \f[CB]\-doctitle\f[R] \f[I]html\-code\f[R]
+Specifies the title to place near the top of the overview summary file.
+The text specified in the \f[CB]title\f[R] tag is placed as a centered,
+level\-one heading directly beneath the top navigation bar.
+The \f[CB]title\f[R] tag can contain HTML tags and white space, but when
+it does, you must enclose the title in quotation marks.
+Additional quotation marks within the \f[CB]title\f[R] tag must be
+escaped.
+For example,
+\f[CB]javadoc\ \-doctitle\ "<b>My\ Library</b><br>v1.0"\ com.mypackage.\f[R]
+.RS
+.RE
+.TP
+.B \f[CB]\-excludedocfilessubdir\f[R] \f[I]name\f[R]
+Excludes any doc files sub directories with the given name.
+Enables deep copying of doc\-files directories.
+Subdirectories and all contents are recursively copied to the
+destination.
+For example, the directory \f[CB]doc\-files/example/images\f[R] and all of
+its contents are copied.
+There is also an option to exclude subdirectories.
+.RS
+.RE
+.TP
+.B \f[CB]\-footer\f[R] \f[I]html\-code\f[R]
+Specifies the footer text to be placed at the bottom of each output
+file.
+The\f[CB]html\-code\f[R] value is placed to the right of the lower
+navigation bar.
+The \f[CB]html\-code\f[R] value can contain HTML tags and white space, but
+when it does, the \f[CB]html\-code\f[R] value must be enclosed in
+quotation marks.
+Use escape characters for any internal quotation marks within a footer.
+.RS
+.RE
+.TP
+.B \f[CB]\-group\f[R] \f[I]namep1\f[R]\f[CB]:\f[R]\f[I]p2\f[R]
+Group the specified packages together in the Overview page.
+.RS
+.RE
+.TP
+.B \f[CB]\-header\f[R] \f[I]html\-code\f[R]
+Specifies the header text to be placed at the top of each output file.
+The header is placed to the right of the upper navigation bar.
+The \f[CB]header\f[R] can contain HTML tags and white space, but when it
+does, the \f[CB]header\f[R] must be enclosed in quotation marks.
+Use escape characters for internal quotation marks within a header.
+For example,
+\f[CB]javadoc\ \-header\ "<b>My\ Library</b><br>v1.0"\ com.mypackage.\f[R]
+.RS
+.RE
+.TP
+.B \f[CB]\-helpfile\f[R] \f[I]filename\f[R]
+Includes the file that links to the \f[B]HELP\f[R] link in the top and
+bottom navigation bars .
+Without this option, the \f[CB]javadoc\f[R] tool creates a help file
+\f[CB]help\-doc.html\f[R] that is hard\-coded in the \f[CB]javadoc\f[R]
+tool.
+This option lets you override the default.
+The \f[I]filename\f[R] can be any name and isn\[aq]t restricted to
+\f[CB]help\-doc.html\f[R].
+The \f[CB]javadoc\f[R] tool adjusts the links in the navigation bar
+accordingly.
+For example:
+.RS
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-helpfile\ /home/user/myhelp.html\ java.awt.\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]javadoc\ \-helpfile\ C:\\user\\myhelp.html\ java.awt.\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-html5\f[R]
+This option is a no\-op and is just retained for backwards
+compatibility.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-javafx\f[R] or \f[CB]\-javafx\f[R]
+Enables JavaFX functionality.
+.RS
+.RE
+.TP
+.B \f[CB]\-keywords\f[R]
+Adds HTML keyword \f[CB]<META>\f[R] tags to the generated file for each
+class.
+These tags can help search engines that look for \f[CB]<META>\f[R] tags
+find the pages.
+Most search engines that search the entire Internet don\[aq]t look at
+\f[CB]<META>\f[R] tags, because pages can misuse them.
+Search engines offered by companies that confine their searches to their
+own website can benefit by looking at \f[CB]<META>\f[R] tags.
+The \f[CB]<META>\f[R] tags include the fully qualified name of the class
+and the unqualified names of the fields and methods.
+Constructors aren\[aq]t included because they are identical to the class
+name.
+For example, the class \f[CB]String\f[R] starts with these keywords:
+.RS
+.IP
+.nf
+\f[CB]
+<META\ NAME="keywords"\ CONTENT="java.lang.String\ class">
+<META\ NAME="keywords"\ CONTENT="CASE_INSENSITIVE_ORDER">
+<META\ NAME="keywords"\ CONTENT="length()">
+<META\ NAME="keywords"\ CONTENT="charAt()">
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]\-link\f[R] \f[I]url\f[R]
+Creates links to existing \f[CB]javadoc\f[R] generated documentation of
+externally referenced classes.
+The \f[I]url\f[R] argument is the absolute or relative URL of the
+directory that contains the external \f[CB]javadoc\f[R] generated
+documentation.
+You can specify multiple \f[CB]\-link\f[R] options in a specified
+\f[CB]javadoc\f[R] tool run to link to multiple documents.
+.RS
+.PP
+Either a \f[CB]package\-list\f[R] or an \f[CB]element\-list\f[R] file must
+be in this \f[I]url\f[R] directory (otherwise, use the
+\f[CB]\-linkoffline\f[R] option).
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]package\-list\f[R] and \f[CB]element\-list\f[R] files are
+generated by the \f[CB]javadoc\f[R] tool when generating the API
+documentation and should not be modified by the user.
+.PP
+When you use the \f[CB]javadoc\f[R] tool to document packages, it uses the
+\f[CB]package\-list\f[R] file to determine the packages declared in an
+API.
+When you generate API documents for modules, the \f[CB]javadoc\f[R] tool
+uses the \f[CB]element\-list\f[R] file to determine the modules and
+packages declared in an API.
+.PP
+The \f[CB]javadoc\f[R] tool reads the names from the appropriate list file
+and then links to the packages or modules at that URL.
+.PP
+When the \f[CB]javadoc\f[R] tool runs, the \f[I]url\f[R] value is copied
+into the \f[CB]<A\ HREF>\f[R] links that are created.
+Therefore, \f[I]url\f[R] must be the URL to the directory and not to a
+file.
+.PP
+You can use an absolute link for \f[I]url\f[R] to enable your documents
+to link to a document on any web site, or you can use a relative link to
+link only to a relative location.
+If you use a relative link, then the value you pass in should be the
+relative path from the destination directory (specified with the
+\f[CB]\-d\f[R] option) to the directory containing the packages being
+linked to.
+When you specify an absolute link, you usually use an HTTP link.
+However, if you want to link to a file system that has no web server,
+then you can use a file link.
+Use a file link only when everyone who wants to access the generated
+documentation shares the same file system.
+In all cases, and on all operating systems, use a slash as the
+separator, whether the URL is absolute or relative, and \f[CB]https:\f[R],
+\f[CB]http:\f[R], or \f[CB]file:\f[R] as specified in the \f[B]URL Memo:
+Uniform Resource Locators\f[R] [http://www.ietf.org/rfc/rfc1738.txt].
+.IP
+.nf
+\f[CB]
+\-link\ https://<host>/<directory>/<directory>/.../<name>
+\-link\ http://<host>/<directory>/<directory>/.../<name>
+\-link\ file://<host>/<directory>/<directory>/.../<name>
+\-link\ <directory>/<directory>/.../<name>
+\f[R]
+.fi
+.RE
+.TP
+.B \f[CB]\-linkoffline\f[R] \f[I]url1\f[R] \f[I]url2\f[R]
+This option is a variation of the \f[CB]\-link\f[R] option.
+They both create links to \f[CB]javadoc\f[R] generated documentation for
+externally referenced classes.
+You can specify multiple \f[CB]\-linkoffline\f[R] options in a specified
+\f[CB]javadoc\f[R] tool run.
+.RS
+.PP
+Use the \f[CB]\-linkoffline\f[R] option when:
+.IP \[bu] 2
+Linking to a document on the web that the \f[CB]javadoc\f[R] tool
+can\[aq]t access through a web connection
+.IP \[bu] 2
+The \f[CB]package\-list\f[R] or \f[CB]element\-list\f[R] file of the
+external document either isn\[aq]t accessible or doesn\[aq]t exist at
+the URL location, but does exist at a different location and can be
+specified by either the \f[CB]package\-list\f[R] or \f[CB]element\-list\f[R]
+file (typically local).
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]package\-list\f[R] and \f[CB]element\-list\f[R] files are
+generated by the \f[CB]javadoc\f[R] tool when generating the API
+documentation and should not be modified by the user.
+.PP
+If \f[I]url1\f[R] is accessible only on the World Wide Web, then the
+\f[CB]\-linkoffline\f[R] option removes the constraint that the
+\f[CB]javadoc\f[R] tool must have a web connection to generate
+documentation.
+.PP
+Another use of the \f[CB]\-linkoffline\f[R] option is as a work\-around to
+update documents.
+After you have run the \f[CB]javadoc\f[R] tool on a full set of packages
+or modules, you can run the \f[CB]javadoc\f[R] tool again on a smaller set
+of changed packages or modules, so that the updated files can be
+inserted back into the original set.
+.PP
+For example, the \f[CB]\-linkoffline\f[R] option takes two arguments.
+The first is for the string to be embedded in the \f[CB]<a\ href>\f[R]
+links, and the second tells the \f[CB]javadoc\f[R] tool where to find
+either the \f[CB]package\-list\f[R] or \f[CB]element\-list\f[R] file.
+.PP
+The \f[I]url1\f[R] or \f[I]url2\f[R] value is the absolute or relative URL
+of the directory that contains the external \f[CB]javadoc\f[R] generated
+documentation that you want to link to.
+When relative, the value should be the relative path from the
+destination directory (specified with the \f[CB]\-d\f[R] option) to the
+root of the packages being linked to.
+See \f[I]url\f[R] in the \f[CB]\-link\f[R] option.
+.RE
+.TP
+.B \f[CB]\-linksource\f[R]
+Creates an HTML version of each source file (with line numbers) and adds
+links to them from the standard HTML documentation.
+Links are created for classes, interfaces, constructors, methods, and
+fields whose declarations are in a source file.
+Otherwise, links aren\[aq]t created, such as for default constructors
+and generated classes.
+.RS
+.PP
+This option exposes all private implementation details in the included
+source files, including private classes, private fields, and the bodies
+of private methods, regardless of the \f[CB]\-public\f[R],
+\f[CB]\-package\f[R], \f[CB]\-protected\f[R], and \f[CB]\-private\f[R]
+options.
+Unless you also use the \f[CB]\-private\f[R] option, not all private
+classes or interfaces are accessible through links.
+.PP
+Each link appears on the name of the identifier in its declaration.
+For example, the link to the source code of the \f[CB]Button\f[R] class
+would be on the word \f[CB]Button\f[R]:
+.RS
+.PP
+\f[CB]public\ class\ Button\ extends\ Component\ implements\ Accessible\f[R]
+.RE
+.PP
+The link to the source code of the \f[CB]getLabel\f[R] method in the
+\f[CB]Button\f[R] class is on the word \f[CB]getLabel\f[R]:
+.RS
+.PP
+\f[CB]public\ String\ getLabel()\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-\-main\-stylesheet\f[R] \f[I]file\f[R] or \f[CB]\-stylesheetfile\f[R] \f[I]file\f[R]
+Specifies the path of an alternate stylesheet file that contains the
+definitions for the CSS styles used in the generated documentation.
+This option lets you override the default.
+If you do not specify the option, the \f[CB]javadoc\f[R] tool will create
+and use a default stylesheet.
+The file name can be any name and isn\[aq]t restricted to
+\f[CB]stylesheet.css\f[R].
+The \f[CB]\-\-main\-stylesheet\f[R] option is the preferred form.
+.RS
+.PP
+Command\-line example:
+.RS
+.PP
+\f[CB]javadoc\ \-\-main\-stylesheet\ main_stylesheet.css\ pkg_foo\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-nocomment\f[R]
+Suppresses the entire comment body, including the main description and
+all tags, and generate only declarations.
+This option lets you reuse source files that were originally intended
+for a different purpose so that you can produce skeleton HTML
+documentation during the early stages of a new project.
+.RS
+.RE
+.TP
+.B \f[CB]\-nodeprecated\f[R]
+Prevents the generation of any deprecated API in the documentation.
+This does what the \f[CB]\-nodeprecatedlist\f[R] option does, and it
+doesn\[aq]t generate any deprecated API throughout the rest of the
+documentation.
+This is useful when writing code when you don\[aq]t want to be
+distracted by the deprecated code.
+.RS
+.RE
+.TP
+.B \f[CB]\-nodeprecatedlist\f[R]
+Prevents the generation of the file that contains the list of deprecated
+APIs (\f[CB]deprecated\-list.html\f[R]) and the link in the navigation bar
+to that page.
+The \f[CB]javadoc\f[R] tool continues to generate the deprecated API
+throughout the rest of the document.
+This is useful when your source code contains no deprecated APIs, and
+you want to make the navigation bar cleaner.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-no\-frames\f[R]
+This option is a no\-op and is just retained for backwards
+compatibility.
+.RS
+.RE
+.TP
+.B \f[CB]\-nohelp\f[R]
+Omits the HELP link in the navigation bars at the top and bottom of each
+page of output.
+.RS
+.RE
+.TP
+.B \f[CB]\-noindex\f[R]
+Omits the index from the generated documents.
+The index is produced by default.
+.RS
+.RE
+.TP
+.B \f[CB]\-nonavbar\f[R]
+Prevents the generation of the navigation bar, header, and footer, that
+are usually found at the top and bottom of the generated pages.
+The \f[CB]\-nonavbar\f[R] option has no affect on the \f[CB]\-bottom\f[R]
+option.
+The \f[CB]\-nonavbar\f[R] option is useful when you are interested only in
+the content and have no need for navigation, such as when you are
+converting the files to PostScript or PDF for printing only.
+.RS
+.RE
+.TP
+.B \f[CB]\-noqualifier\f[R] \f[I]name1\f[R]\f[CB]:\f[R]\f[I]name2\f[R]...
+Excludes the list of qualifiers from the output.
+The package name is removed from places where class or interface names
+appear.
+.RS
+.PP
+The following example omits all package qualifiers:
+\f[CB]\-noqualifier\ all\f[R].
+.PP
+The following example omits \f[CB]java.lang\f[R] and \f[CB]java.io\f[R]
+package qualifiers: \f[CB]\-noqualifier\ java.lang:java.io\f[R].
+.PP
+The following example omits package qualifiers starting with
+\f[CB]java\f[R] and \f[CB]com.sun\f[R] subpackages, but not
+\f[CB]javax:\ \-noqualifier\ java.*:com.sun.*\f[R].
+.PP
+Where a package qualifier would appear due to the previous behavior, the
+name can be suitably shortened.
+This rule is in effect whether or not the \f[CB]\-noqualifier\f[R] option
+is used.
+.RE
+.TP
+.B \f[CB]\-nosince\f[R]
+Omits from the generated documents the \f[CB]Since\f[R] sections
+associated with the \f[CB]\@since\f[R] tags.
+.RS
+.RE
+.TP
+.B \f[CB]\-notimestamp\f[R]
+Suppresses the time stamp, which is hidden in an HTML comment in the
+generated HTML near the top of each page.
+The \f[CB]\-notimestamp\f[R] option is useful when you want to run the
+\f[CB]javadoc\f[R] tool on two source bases and get the differences
+between \f[CB]diff\f[R] them, because it prevents time stamps from causing
+a \f[CB]diff\f[R] (which would otherwise be a \f[CB]diff\f[R] on every
+page).
+The time stamp includes the \f[CB]javadoc\f[R] tool release number.
+.RS
+.RE
+.TP
+.B \f[CB]\-notree\f[R]
+Omits the class and interface hierarchy pages from the generated
+documents.
+These are the pages you reach using the Tree button in the navigation
+bar.
+The hierarchy is produced by default.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-override\-methods\f[R] (\f[CB]detail\f[R]|\f[CB]summary\f[R])
+Documents overridden methods in the detail or summary sections.
+.RS
+.RE
+.TP
+.B \f[CB]\-overview\f[R] \f[I]filename\f[R]
+Specifies that the \f[CB]javadoc\f[R] tool should retrieve the text for
+the overview documentation from the source file specified by
+\f[CB]filename\f[R] and place it on the Overview page
+(\f[CB]overview\-summary.html\f[R]).
+A relative path specified with the file name is relative to the current
+working directory.
+.RS
+.PP
+While you can use any name you want for the \f[CB]filename\f[R] value and
+place it anywhere you want for the path, it is typical to name it
+\f[CB]overview.html\f[R] and place it in the source tree at the directory
+that contains the topmost package directories.
+In this location, no path is needed when documenting packages, because
+the \f[CB]\-sourcepath\f[R] option points to this file.
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R] For example, if the source tree for the
+\f[CB]java.lang\f[R] package is \f[CB]/src/classes/java/lang/\f[R], then you
+could place the overview file at /src/classes/overview.html.
+.IP \[bu] 2
+\f[B]Windows:\f[R] For example, if the source tree for the
+\f[CB]java.lang\f[R] package is \f[CB]\\src\\classes\\java\\lang\\\f[R],
+then you could place the overview file at
+\f[CB]\\src\\classes\\overview.html\f[R]
+.PP
+The overview page is created only when you pass two or more package
+names to the \f[CB]javadoc\f[R] tool.
+The title on the overview page is set by \f[CB]\-doctitle\f[R].
+.RE
+.TP
+.B \f[CB]\-serialwarn\f[R]
+Generates compile\-time warnings for missing \f[CB]\@serial\f[R] tags.
+By default, Javadoc generates no serial warnings.
+Use this option to display the serial warnings, which helps to properly
+document default serializable fields and \f[CB]writeExternal\f[R] methods.
+.RS
+.RE
+.TP
+.B \f[CB]\-sourcetab\f[R] \f[I]tablength\f[R]
+Specifies the number of spaces each tab uses in the source.
+.RS
+.RE
+.TP
+.B \f[CB]\-splitindex\f[R]
+Splits the index file into multiple files, alphabetically, one file per
+letter, plus a file for any index entries that start with
+non\-alphabetical symbols.
+.RS
+.RE
+.TP
+.B \f[CB]\-tag\f[R] \f[I]name\f[R]:\f[I]locations\f[R]:\f[I]header\f[R]
+Specifies single argument custom tags.
+For the \f[CB]javadoc\f[R] tool to spell\-check tag names, it is important
+to include a \f[CB]\-tag\f[R] option for every custom tag that is present
+in the source code, disabling (with \f[CB]X\f[R]) those that aren\[aq]t
+being output in the current run.
+The colon (\f[CB]:\f[R]) is always the separator.
+The \f[CB]\-tag\f[R] option outputs the tag heading, \f[I]header\f[R], in
+bold, followed on the next line by the text from its single argument.
+Similar to any block tag, the argument text can contain inline tags,
+which are also interpreted.
+The output is similar to standard one\-argument tags, such as the
+\f[CB]\@return\f[R] and \f[CB]\@author\f[R] tags.
+Omitting a \f[I]header\f[R] value causes the \f[I]name\f[R] to be the
+heading.
+.RS
+.RE
+.TP
+.B \f[CB]\-taglet\f[R] \f[I]class\f[R]
+Specifies the fully qualified name of the taglet used in generating the
+documentation for that tag.
+Use the fully qualified name for the \f[I]class\f[R] value.
+This taglet also defines the number of text arguments that the custom
+tag has.
+The taglet accepts those arguments, processes them, and generates the
+output.
+.RS
+.PP
+Taglets are useful for block or inline tags.
+They can have any number of arguments and implement custom behavior,
+such as making text bold, formatting bullets, writing out the text to a
+file, or starting other processes.
+Taglets can only determine where a tag should appear and in what form.
+All other decisions are made by the doclet.
+A taglet can\[aq]t do things such as remove a class name from the list
+of included classes.
+However, it can execute side effects, such as printing the tag\[aq]s
+text to a file or triggering another process.
+Use the \f[CB]\-tagletpath\f[R] option to specify the path to the taglet.
+The following example inserts the To Do taglet after Parameters and
+ahead of Throws in the generated pages.
+.IP
+.nf
+\f[CB]
+\-taglet\ com.sun.tools.doclets.ToDoTaglet
+\-tagletpath\ /home/taglets
+\-tag\ return
+\-tag\ param
+\-tag\ todo
+\-tag\ throws
+\-tag\ see
+\f[R]
+.fi
+.PP
+Alternately, you can use the \f[CB]\-taglet\f[R] option in place of its
+\f[CB]\-tag\f[R] option, but that might be difficult to read.
+.RE
+.TP
+.B \f[CB]\-tagletpath\f[R] \f[I]tagletpathlist\f[R]
+Specifies the search paths for finding taglet class files.
+The \f[I]tagletpathlist\f[R] can contain multiple paths by separating
+them with the platform path separator (\f[CB];\f[R] on Windows; \f[CB]:\f[R]
+on other platforms.) The \f[CB]javadoc\f[R] tool searches all
+subdirectories of the specified paths.
+.RS
+.RE
+.TP
+.B \f[CB]\-top\f[R] \f[I]html\-code\f[R]
+Specifies the text to be placed at the top of each output file.
+.RS
+.RE
+.TP
+.B \f[CB]\-use\f[R]
+Creates class and package usage pages.
+Includes one Use page for each documented class and package.
+The page describes what packages, classes, methods, constructors and
+fields use any API of the specified class or package.
+Given class C, things that use class C would include subclasses of C,
+fields declared as C, methods that return C, and methods and
+constructors with parameters of type C.
+For example, you can look at the Use page for the \f[CB]String\f[R] type.
+Because the \f[CB]getName\f[R] method in the \f[CB]java.awt.Font\f[R] class
+returns type \f[CB]String\f[R], the \f[CB]getName\f[R] method uses
+\f[CB]String\f[R] and so the \f[CB]getName\f[R] method appears on the Use
+page for \f[CB]String\f[R].
+This documents only uses of the API, not the implementation.
+When a method uses \f[CB]String\f[R] in its implementation, but
+doesn\[aq]t take a string as an argument or return a string, that
+isn\[aq]t considered a use of \f[CB]String\f[R].To access the generated
+Use page, go to the class or package and click the \f[B]Use link\f[R] in
+the navigation bar.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R]
+Includes the version text in the generated docs.
+This text is omitted by default.
+To find out what version of the \f[CB]javadoc\f[R] tool you are using, use
+the \f[CB]\-J\-version\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-windowtitle\f[R] \f[I]title\f[R]
+Specifies the title to be placed in the HTML \f[CB]<title>\f[R] tag.
+The text specified in the \f[CB]title\f[R] tag appears in the window title
+and in any browser bookmarks (favorite places) that someone creates for
+this page.
+This title shouldn\[aq]t contain any HTML tags because the browser
+doesn\[aq]t interpret them correctly.
+Use escape characters on any internal quotation marks within the
+\f[CB]title\f[R] tag.
+If the \f[CB]\-windowtitle\f[R] option is omitted, then the
+\f[CB]javadoc\f[R] tool uses the value of the \f[CB]\-doctitle\f[R] option
+for the \f[CB]\-windowtitle\f[R] option.
+For example,
+\f[CB]javadoc\ \-windowtitle\ "My\ Library"\ com.mypackage\f[R].
+.RS
+.RE
+.SH ADDITIONAL OPTIONS PROVIDED BY THE STANDARD DOCLET
+.PP
+The following are additional options provided by the standard doclet and
+are subject to change without notice.
+Additional options are less commonly used or are otherwise regarded as
+advanced.
+.TP
+.B \f[CB]\-Xdoclint\f[R]
+Enables recommended checks for problems in documentation comments.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdoclint:\f[R](\f[CB]all\f[R]|\f[CB]none\f[R]|[\f[CB]\-\f[R]]\f[I]group\f[R])
+Enable or disable specific checks for bad references, accessibility
+issues, missing documentation comments, errors in documentation comment
+syntax and missing HTML tags.
+.RS
+.PP
+This option enables the \f[CB]javadoc\f[R] tool to check for all
+documentation comments included in the generated output.
+You can select which items to include in the generated output with the
+standard options \f[CB]\-public\f[R], \f[CB]\-protected\f[R],
+\f[CB]\-package\f[R] and \f[CB]\-private\f[R].
+.PP
+When the \f[CB]\-Xdoclint\f[R] option is enabled, it reports issues with
+messages similar to the \f[CB]javac\f[R] command.
+The \f[CB]javadoc\f[R] tool prints a message, a copy of the source line,
+and a caret pointing at the exact position where the error was detected.
+Messages may be either warnings or errors, depending on their severity
+and the likelihood to cause an error if the generated documentation were
+to be run through a validator.
+For example: missing documentation comments, duplicate information, and
+extraneous comments do not cause the \f[CB]javadoc\f[R] tool to generate
+invalid HTML, so these issues are reported as warnings; syntax errors,
+missing required HTML end tags, and references to missing or misspelled
+elements cause the \f[CB]javadoc\f[R] tool to generate invalid output, so
+these issues are reported as errors.
+.PP
+\f[CB]\-Xdoclint\f[R] option validates input comments based upon the
+requested markup.
+.PP
+By default, the \f[CB]\-Xdoclint\f[R] option is enabled.
+Disable it with the option \f[CB]\-Xdoclint:none\f[R].
+.PP
+The following options change what the \f[CB]\-Xdoclint\f[R] option
+reports:
+.IP \[bu] 2
+\f[CB]\-Xdoclint\ none\f[R]: Disables the \f[CB]\-Xdoclint\f[R] option
+.IP \[bu] 2
+\f[CB]\-Xdoclint\f[R] \f[I]group\f[R]: Enables \f[I]group\f[R] checks
+.IP \[bu] 2
+\f[CB]\-Xdoclint\ all\f[R]: Enables all groups of checks
+.IP \[bu] 2
+\f[CB]\-Xdoclint\ all,\-\f[R]\f[I]group\f[R]: Enables all checks except
+\f[I]group\f[R] checks
+.PP
+The \f[I]group\f[R] variable has one of the following values:
+.IP \[bu] 2
+\f[CB]accessibility\f[R]: Checks for the issues to be detected by an
+accessibility checker (for example, no caption or summary attributes
+specified in a \f[CB]<table>\f[R] tag).
+.IP \[bu] 2
+\f[CB]html\f[R]: Detects high\-level HTML issues, such as putting block
+elements inside inline elements, or not closing elements that require an
+end tag.
+The rules are derived from the \f[B]HTML 4 Specification\f[R]
+[https://www.w3.org/TR/html4/] or the \f[B]HTML 5 Specification\f[R]
+[http://www.w3.org/TR/2014/REC\-html5\-20141028/] based on the standard
+doclet \f[CB]html\f[R] output generation selected.
+This type of check enables the \f[CB]javadoc\f[R] tool to detect HTML
+issues that some browsers might not interpret as intended.
+.IP \[bu] 2
+\f[CB]missing\f[R]: Checks for missing documentation comments or tags (for
+example, a missing comment or class, or a missing \f[CB]\@return\f[R] tag
+or similar tag on a method).
+.IP \[bu] 2
+\f[CB]reference\f[R]: Checks for issues relating to the references to Java
+API elements from documentation comment tags (for example, item not
+found in \f[CB]\@see\f[R], or a bad name after \f[CB]\@param)\f[R].
+.IP \[bu] 2
+\f[CB]syntax\f[R]: Checks for low level issues like unescaped angle
+brackets (\f[CB]<\f[R] and \f[CB]>\f[R]) and ampersands (\f[CB]&\f[R]) and
+invalid documentation comment tags.
+.PP
+You can specify the \f[CB]\-Xdoclint\f[R] option multiple times to enable
+the option to check errors and warnings in multiple categories.
+Alternatively, you can specify multiple error and warning categories by
+using the preceding options.
+For example, use either of the following commands to check for the HTML,
+syntax, and accessibility issues in the file \f[I]filename\f[R].
+.RS
+.PP
+\f[CB]javadoc\ \-Xdoclint:html\ \-Xdoclint:syntax\ \-Xdoclint:accessibility\f[R]
+\f[I]filename\f[R]
+.RE
+.RS
+.PP
+\f[CB]javadoc\ \-Xdoclint:html,syntax,accessibility\f[R] \f[I]filename\f[R]
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]javadoc\f[R] tool doesn\[aq]t guarantee the completeness of
+these checks.
+In particular, it isn\[aq]t a full HTML compliance checker.
+The goal of the \-\f[CB]Xdoclint\f[R] option is to enable the
+\f[CB]javadoc\f[R] tool to report majority of common errors.
+.PP
+The \f[CB]javadoc\f[R] tool doesn\[aq]t attempt to fix invalid input, it
+just reports it.
+.RE
+.TP
+.B \f[CB]\-Xdoclint/package:\f[R][\f[CB]\-\f[R]]\f[I]packages\f[R]
+Enables or disables checks in specific packages.
+\f[I]packages\f[R] is a comma separated list of package specifiers.
+A package specifier is either a qualified name of a package or a package
+name prefix followed by \f[CB]*\f[R], which expands to all sub packages of
+the given package.
+Prefix the package specifier with \f[CB]\-\f[R] to disable checks for the
+specified packages.
+.RS
+.RE
+.TP
+.B \f[CB]\-Xdocrootparent\f[R] \f[I]url\f[R]
+Replaces all \f[CB]\@docRoot\f[R] items followed by\f[CB]/..\f[R] in Javadoc
+comments with the \f[I]url\f[R].
+.RS
+.RE
diff --git a/java/temurin-17/man/man1/javap.1 b/java/temurin-17/man/man1/javap.1
new file mode 100644
index 0000000..f62b8a0
--- /dev/null
+++ b/java/temurin-17/man/man1/javap.1
@@ -0,0 +1,280 @@
+.\" Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JAVAP" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+javap \- disassemble one or more class files
+.SH SYNOPSIS
+.PP
+\f[CB]javap\f[R] [\f[I]options\f[R]] \f[I]classes\f[R]...
+.TP
+.B \f[I]options\f[R]
+Specifies the command\-line options.
+See \f[B]Options for javap\f[R].
+.RS
+.RE
+.TP
+.B \f[I]classes\f[R]
+Specifies one or more classes separated by spaces to be processed for
+annotations.
+You can specify a class that can be found in the class path by its file
+name, URL, or by its fully qualified class name.
+.RS
+.PP
+Examples:
+.RS
+.PP
+\f[CB]path/to/MyClass.class\f[R]
+.RE
+.RS
+.PP
+\f[CB]jar:file:///path/to/MyJar.jar!/mypkg/MyClass.class\f[R]
+.RE
+.RS
+.PP
+\f[CB]java.lang.Object\f[R]
+.RE
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]javap\f[R] command disassembles one or more class files.
+The output depends on the options used.
+When no options are used, the \f[CB]javap\f[R] command prints the
+protected and public fields, and methods of the classes passed to it.
+.PP
+The \f[CB]javap\f[R] command isn\[aq]t multirelease JAR aware.
+Using the class path form of the command results in viewing the base
+entry in all JAR files, multirelease or not.
+Using the URL form, you can use the URL form of an argument to specify a
+specific version of a class to be disassembled.
+.PP
+The \f[CB]javap\f[R] command prints its output to \f[CB]stdout\f[R].
+.PP
+\f[B]Note:\f[R]
+.PP
+In tools that support \f[CB]\-\-\f[R] style options, the GNU\-style
+options can use the equal sign (\f[CB]=\f[R]) instead of a white space to
+separate the name of an option from its value.
+.SH OPTIONS FOR JAVAP
+.TP
+.B \f[CB]\-\-help\f[R], \f[CB]\-help\f[R] , \f[CB]\-h\f[R], or \f[CB]\-?\f[R]
+Prints a help message for the \f[CB]javap\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R]
+Prints release information.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose\f[R] or \f[CB]\-v\f[R]
+Prints additional information about the selected class.
+.RS
+.RE
+.TP
+.B \f[CB]\-l\f[R]
+Prints line and local variable tables.
+.RS
+.RE
+.TP
+.B \f[CB]\-public\f[R]
+Shows only public classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-protected\f[R]
+Shows only protected and public classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-package\f[R]
+Shows package/protected/public classes and members (default).
+.RS
+.RE
+.TP
+.B \f[CB]\-private\f[R] or \f[CB]\-p\f[R]
+Shows all classes and members.
+.RS
+.RE
+.TP
+.B \f[CB]\-c\f[R]
+Prints disassembled code, for example, the instructions that comprise
+the Java bytecodes, for each of the methods in the class.
+.RS
+.RE
+.TP
+.B \f[CB]\-s\f[R]
+Prints internal type signatures.
+.RS
+.RE
+.TP
+.B \f[CB]\-sysinfo\f[R]
+Shows system information (path, size, date, SHA\-256 hash) of the class
+being processed.
+.RS
+.RE
+.TP
+.B \f[CB]\-constants\f[R]
+Shows \f[CB]static\ final\f[R] constants.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\f[R] \f[I]module\f[R] or \f[CB]\-m\f[R] \f[I]module\f[R]
+Specifies the module containing classes to be disassembled.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]path\f[R]
+Specifies where to find application modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-system\f[R] \f[I]jdk\f[R]
+Specifies where to find system modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-cp\f[R] \f[I]path\f[R]
+Specifies the path that the \f[CB]javap\f[R] command uses to find user
+class files.
+It overrides the default or the \f[CB]CLASSPATH\f[R] environment variable
+when it\[aq]s set.
+.RS
+.RE
+.TP
+.B \f[CB]\-bootclasspath\f[R] \f[I]path\f[R]
+Overrides the location of bootstrap class files.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-multi\-release\f[R] \f[I]version\f[R]
+Specifies the version to select in multi\-release JAR files.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Passes the specified option to the JVM.
+For example:
+.RS
+.IP
+.nf
+\f[CB]
+javap\ \-J\-version
+
+javap\ \-J\-Djava.security.manager\ \-J\-Djava.security.policy=MyPolicy\ MyClassName
+\f[R]
+.fi
+.PP
+See \f[I]Overview of Java Options\f[R] in \f[B]java\f[R].
+.RE
+.SH JAVAP EXAMPLE
+.PP
+Compile the following \f[CB]HelloWorldFrame\f[R] class:
+.IP
+.nf
+\f[CB]
+import\ java.awt.Graphics;
+
+import\ javax.swing.JFrame;
+import\ javax.swing.JPanel;
+
+public\ class\ HelloWorldFrame\ extends\ JFrame\ {
+
+\ \ \ String\ message\ =\ "Hello\ World!";
+
+\ \ \ public\ HelloWorldFrame(){
+\ \ \ \ \ \ \ \ setContentPane(new\ JPanel(){
+\ \ \ \ \ \ \ \ \ \ \ \ \@Override
+\ \ \ \ \ \ \ \ \ \ \ \ protected\ void\ paintComponent(Graphics\ g)\ {
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ g.drawString(message,\ 15,\ 30);
+\ \ \ \ \ \ \ \ \ \ \ \ }
+\ \ \ \ \ \ \ \ });
+\ \ \ \ \ \ \ \ setSize(100,\ 100);
+\ \ \ \ }
+\ \ \ \ public\ static\ void\ main(String[]\ args)\ {
+\ \ \ \ \ \ \ \ HelloWorldFrame\ frame\ =\ new\ HelloWorldFrame();
+\ \ \ \ \ \ \ \ frame.setVisible(true);
+
+\ \ \ \ }
+
+}
+\f[R]
+.fi
+.PP
+The output from the \f[CB]javap\ HelloWorldFrame.class\f[R] command yields
+the following:
+.IP
+.nf
+\f[CB]
+Compiled\ from\ "HelloWorldFrame.java"
+public\ class\ HelloWorldFrame\ extends\ javax.swing.JFrame\ {
+\ \ java.lang.String\ message;
+\ \ public\ HelloWorldFrame();
+\ \ public\ static\ void\ main(java.lang.String[]);
+}
+\f[R]
+.fi
+.PP
+The output from the \f[CB]javap\ \-c\ HelloWorldFrame.class\f[R] command
+yields the following:
+.IP
+.nf
+\f[CB]
+Compiled\ from\ "HelloWorldFrame.java"
+public\ class\ HelloWorldFrame\ extends\ javax.swing.JFrame\ {
+\ \ java.lang.String\ message;
+
+\ \ public\ HelloWorldFrame();
+\ \ \ \ Code:
+\ \ \ \ \ \ \ 0:\ aload_0
+\ \ \ \ \ \ \ 1:\ invokespecial\ #1\ \ \ \ \ \ \ \ //\ Method\ javax/swing/JFrame."<init>":()V
+\ \ \ \ \ \ \ 4:\ aload_0
+\ \ \ \ \ \ \ 5:\ ldc\ \ \ \ \ \ \ \ \ \ \ #2\ \ \ \ \ \ \ \ //\ String\ Hello\ World!
+\ \ \ \ \ \ \ 7:\ putfield\ \ \ \ \ \ #3\ \ \ \ \ \ \ \ //\ Field\ message:Ljava/lang/String;
+\ \ \ \ \ \ 10:\ aload_0
+\ \ \ \ \ \ 11:\ new\ \ \ \ \ \ \ \ \ \ \ #4\ \ \ \ \ \ \ \ //\ class\ HelloWorldFrame$1
+\ \ \ \ \ \ 14:\ dup
+\ \ \ \ \ \ 15:\ aload_0
+\ \ \ \ \ \ 16:\ invokespecial\ #5\ \ \ \ \ \ \ \ //\ Method\ HelloWorldFrame$1."<init>":(LHelloWorldFrame;)V
+\ \ \ \ \ \ 19:\ invokevirtual\ #6\ \ \ \ \ \ \ \ //\ Method\ setContentPane:(Ljava/awt/Container;)V
+\ \ \ \ \ \ 22:\ aload_0
+\ \ \ \ \ \ 23:\ bipush\ \ \ \ \ \ \ \ 100
+\ \ \ \ \ \ 25:\ bipush\ \ \ \ \ \ \ \ 100
+\ \ \ \ \ \ 27:\ invokevirtual\ #7\ \ \ \ \ \ \ \ //\ Method\ setSize:(II)V
+\ \ \ \ \ \ 30:\ return
+
+\ \ public\ static\ void\ main(java.lang.String[]);
+\ \ \ \ Code:
+\ \ \ \ \ \ \ 0:\ new\ \ \ \ \ \ \ \ \ \ \ #8\ \ \ \ \ \ \ \ //\ class\ HelloWorldFrame
+\ \ \ \ \ \ \ 3:\ dup
+\ \ \ \ \ \ \ 4:\ invokespecial\ #9\ \ \ \ \ \ \ \ //\ Method\ "<init>":()V
+\ \ \ \ \ \ \ 7:\ astore_1
+\ \ \ \ \ \ \ 8:\ aload_1
+\ \ \ \ \ \ \ 9:\ iconst_1
+\ \ \ \ \ \ 10:\ invokevirtual\ #10\ \ \ \ \ \ \ //\ Method\ setVisible:(Z)V
+\ \ \ \ \ \ 13:\ return
+}
+\f[R]
+.fi
diff --git a/java/temurin-17/man/man1/jcmd.1 b/java/temurin-17/man/man1/jcmd.1
new file mode 100644
index 0000000..9641bc1
--- /dev/null
+++ b/java/temurin-17/man/man1/jcmd.1
@@ -0,0 +1,1112 @@
+.\" Copyright (c) 2012, 2022, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JCMD" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jcmd \- send diagnostic command requests to a running Java Virtual
+Machine (JVM)
+.SH SYNOPSIS
+.PP
+\f[CB]jcmd\f[R] [\f[I]pid\f[R] | \f[I]main\-class\f[R]] \f[I]command\f[R]...
+| \f[CB]PerfCounter.print\f[R] | \f[CB]\-f\f[R] \f[I]filename\f[R]
+.PP
+\f[CB]jcmd\f[R] [\f[CB]\-l\f[R]]
+.PP
+\f[CB]jcmd\f[R] \f[CB]\-h\f[R]
+.TP
+.B \f[I]pid\f[R]
+When used, the \f[CB]jcmd\f[R] utility sends the diagnostic command
+request to the process ID for the Java process.
+.RS
+.RE
+.TP
+.B \f[I]main\-class\f[R]
+When used, the \f[CB]jcmd\f[R] utility sends the diagnostic command
+request to all Java processes with the specified name of the main class.
+.RS
+.RE
+.TP
+.B \f[I]command\f[R]
+The \f[CB]command\f[R] must be a valid \f[CB]jcmd\f[R] command for the
+selected JVM.
+The list of available commands for \f[CB]jcmd\f[R] is obtained by running
+the \f[CB]help\f[R] command (\f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]help\f[R])
+where \f[I]pid\f[R] is the process ID for the running Java process.
+If the \f[I]pid\f[R] is \f[CB]0\f[R], commands will be sent to all Java
+processes.
+The main class argument will be used to match, either partially or
+fully, the class used to start Java.
+If no options are given, it lists the running Java process identifiers
+with the main class and command\-line arguments that were used to launch
+the process (the same as using \f[CB]\-l\f[R]).
+.RS
+.RE
+.TP
+.B \f[CB]Perfcounter.print\f[R]
+Prints the performance counters exposed by the specified Java process.
+.RS
+.RE
+.TP
+.B \f[CB]\-f\f[R] \f[I]filename\f[R]
+Reads and executes commands from a specified file, \f[I]filename\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-l\f[R]
+Displays the list of Java Virtual Machine process identifiers that are
+not running in a separate docker process along with the main class and
+command\-line arguments that were used to launch the process.
+If the JVM is in a docker process, you must use tools such as
+\f[CB]ps\f[R] to look up the PID.
+.RS
+.PP
+\f[B]Note:\f[R]
+.PP
+Using \f[CB]jcmd\f[R] without arguments is the same as using
+\f[CB]jcmd\ \-l\f[R].
+.RE
+.TP
+.B \f[CB]\-h\f[R]
+Displays the \f[CB]jcmd\f[R] utility\[aq]s command\-line help.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jcmd\f[R] utility is used to send diagnostic command requests to
+the JVM.
+It must be used on the same machine on which the JVM is running, and
+have the same effective user and group identifiers that were used to
+launch the JVM.
+Each diagnostic command has its own set of arguments.
+To display the description, syntax, and a list of available arguments
+for a diagnostic command, use the name of the command as the argument.
+For example:
+.RS
+.PP
+\f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]help\f[R] \f[I]command\f[R]
+.RE
+.PP
+If arguments contain spaces, then you must surround them with single or
+double quotation marks (\f[CB]\[aq]\f[R] or \f[CB]"\f[R]).
+In addition, you must escape single or double quotation marks with a
+backslash (\f[CB]\\\f[R]) to prevent the operating system shell from
+processing quotation marks.
+Alternatively, you can surround these arguments with single quotation
+marks and then with double quotation marks (or with double quotation
+marks and then with single quotation marks).
+.PP
+If you specify the process identifier (\f[I]pid\f[R]) or the main class
+(\f[I]main\-class\f[R]) as the first argument, then the \f[CB]jcmd\f[R]
+utility sends the diagnostic command request to the Java process with
+the specified identifier or to all Java processes with the specified
+name of the main class.
+You can also send the diagnostic command request to all available Java
+processes by specifying \f[CB]0\f[R] as the process identifier.
+.SH COMMANDS FOR JCMD
+.PP
+The \f[I]command\f[R] must be a valid \f[CB]jcmd\f[R] diagnostic command
+for the selected JVM.
+The list of available commands for \f[CB]jcmd\f[R] is obtained by running
+the \f[CB]help\f[R] command (\f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]help\f[R])
+where \f[I]pid\f[R] is the process ID for a running Java process.
+If the \f[I]pid\f[R] is \f[CB]0\f[R], commands will be sent to all Java
+processes.
+The main class argument will be used to match, either partially or
+fully, the class used to start Java.
+If no options are given, it lists the running Java process identifiers
+that are not in separate docker processes along with the main class and
+command\-line arguments that were used to launch the process (the same
+as using \f[CB]\-l\f[R]).
+.PP
+The following commands are available:
+.TP
+.B \f[CB]help\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
+For more information about a specific command.
+.RS
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]command name\f[R]: The name of the command for which we want help
+(STRING, no default value)
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-all\f[R]: (Optional) Show help for all commands (BOOLEAN, false) .
+.RE
+.TP
+.B \f[CB]Compiler.codecache\f[R]
+Prints code cache layout and bounds.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.codelist\f[R]
+Prints all compiled methods in code cache that are alive.
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.queue\f[R]
+Prints methods queued for compilation.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.directives_add\ *filename*\ *arguments*\f[R]
+Adds compiler directives from a file.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[I]arguments\f[R]:
+.PP
+\f[I]filename\f[R]: The name of the directives file (STRING, no default
+value)
+.RE
+.TP
+.B \f[CB]Compiler.directives_clear\f[R]
+Remove all compiler directives.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.directives_print\f[R]
+Prints all active compiler directives.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]Compiler.directives_remove\f[R]
+Remove latest added compiler directive.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]GC.class_histogram\f[R] [\f[I]options\f[R]]
+Provides statistics about the Java heap usage.
+.RS
+.PP
+Impact: High \-\-\- depends on Java heap size and content.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-all\f[R]: (Optional) Inspects all objects, including unreachable
+objects (BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]GC.finalizer_info\f[R]
+Provides information about the Java finalization queue.
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]GC.heap_dump\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
+Generates a HPROF format dump of the Java heap.
+.RS
+.PP
+Impact: High \-\-\- depends on the Java heap size and content.
+Request a full GC unless the \f[CB]\-all\f[R] option is specified.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-all\f[R]: (Optional) Dump all objects, including unreachable
+objects (BOOLEAN, false)
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]filename\f[R]: The name of the dump file (STRING, no default value)
+.RE
+.TP
+.B \f[CB]GC.heap_info\f[R]
+Provides generic Java heap information.
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]GC.run\f[R]
+Calls \f[CB]java.lang.System.gc()\f[R].
+.RS
+.PP
+Impact: Medium \-\-\- depends on the Java heap size and content.
+.RE
+.TP
+.B \f[CB]GC.run_finalization\f[R]
+Calls \f[CB]java.lang.System.runFinalization()\f[R].
+.RS
+.PP
+Impact: Medium \-\-\- depends on the Java content.
+.RE
+.TP
+.B \f[CB]JFR.check\f[R] [\f[I]options\f[R]]
+Show information about a running flight recording
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+If no parameters are entered, information for all active recordings is
+shown.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]name\f[R]: (Optional) Name of the flight recording.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]verbose\f[R]: (Optional) Flag for printing the event settings for
+the recording (BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]JFR.configure\f[R] [\f[I]options\f[R]]
+Set the parameters for a flight recording
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+If no parameters are entered, the current settings are displayed.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]globalbuffercount\f[R]: (Optional) Number of global buffers.
+This option is a legacy option: change the \f[CB]memorysize\f[R] parameter
+to alter the number of global buffers.
+This value cannot be changed once JFR has been initalized.
+(STRING, default determined by the value for \f[CB]memorysize\f[R])
+.IP \[bu] 2
+\f[CB]globalbuffersize\f[R]: (Optional) Size of the global buffers, in
+bytes.
+This option is a legacy option: change the \f[CB]memorysize\f[R] parameter
+to alter the size of the global buffers.
+This value cannot be changed once JFR has been initalized.
+(STRING, default determined by the value for \f[CB]memorysize\f[R])
+.IP \[bu] 2
+\f[CB]maxchunksize\f[R]: (Optional) Maximum size of an individual data
+chunk in bytes if one of the following suffixes is not used: \[aq]m\[aq]
+or \[aq]M\[aq] for megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for
+gigabytes.
+This value cannot be changed once JFR has been initialized.
+(STRING, 12M)
+.IP \[bu] 2
+\f[CB]memorysize\f[R]: (Optional) Overall memory size, in bytes if one of
+the following suffixes is not used: \[aq]m\[aq] or \[aq]M\[aq] for
+megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for gigabytes.
+This value cannot be changed once JFR has been initialized.
+(STRING, 10M)
+.IP \[bu] 2
+\f[CB]repositorypath\f[R]: (Optional) Path to the location where
+recordings are stored until they are written to a permanent file.
+(STRING, The default location is the temporary directory for the
+operating system.
+On Linux operating systems, the temporary directory is \f[CB]/tmp\f[R].
+On Windwows, the temporary directory is specified by the \f[CB]TMP\f[R]
+environment variable.)
+.IP \[bu] 2
+\f[CB]stackdepth\f[R]: (Optional) Stack depth for stack traces.
+Setting this value greater than the default of 64 may cause a
+performance degradation.
+This value cannot be changed once JFR has been initialized.
+(LONG, 64)
+.IP \[bu] 2
+\f[CB]thread_buffer_size\f[R]: (Optional) Local buffer size for each
+thread in bytes if one of the following suffixes is not used:
+\[aq]k\[aq] or \[aq]K\[aq] for kilobytes or \[aq]m\[aq] or \[aq]M\[aq]
+for megabytes.
+Overriding this parameter could reduce performance and is not
+recommended.
+This value cannot be changed once JFR has been initialized.
+(STRING, 8k)
+.IP \[bu] 2
+\f[CB]samplethreads\f[R]: (Optional) Flag for activating thread sampling.
+(BOOLEAN, true)
+.RE
+.TP
+.B \f[CB]JFR.dump\f[R] [\f[I]options\f[R]]
+Write data to a file while a flight recording is running
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+No options are required.
+The recording continues to run after the data is written.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]begin\f[R]: (Optional) Specify the time from which recording data
+will be included in the dump file.
+The format is specified as local time.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]end\f[R]: (Optional) Specify the time to which recording data will
+be included in the dump file.
+The format is specified as local time.
+(STRING, no default value)
+.RS 2
+.PP
+\f[B]Note:\f[R] For both \f[CB]begin\f[R] and \f[CB]end\f[R], the time must
+be in a format that can be read by java.time.LocalTime::parse(STRING),
+java.time.LocalDateTime::parse(STRING) or
+java.time.Instant::parse(STRING).
+For example, "13:20:15", "2020\-03\-17T09:00:00" or
+"2020\-03\-17T09:00:00Z".
+.PP
+\f[B]Note:\f[R] \f[CB]begin\f[R] and \f[CB]end\f[R] times correspond to the
+timestamps found within the recorded information in the flight recording
+data.
+.PP
+Another option is to use a time relative to the current time that is
+specified by a negative integer followed by "s", "m" or "h".
+For example, "\-12h", "\-15m" or "\-30s"
+.RE
+.IP \[bu] 2
+\f[CB]filename\f[R]: (Optional) Name of the file to which the flight
+recording data is dumped.
+If no filename is given, a filename is generated from the PID and the
+current date.
+The filename may also be a directory in which case, the filename is
+generated from the PID and the current date in the specified directory.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]maxage\f[R]: (Optional) Length of time for dumping the flight
+recording data to a file.
+(INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for minutes or
+\[aq]h\[aq] for hours, no default value)
+.IP \[bu] 2
+\f[CB]maxsize\f[R]: (Optional) Maximum size for the amount of data to dump
+from a flight recording in bytes if one of the following suffixes is not
+used: \[aq]m\[aq] or \[aq]M\[aq] for megabytes OR \[aq]g\[aq] or
+\[aq]G\[aq] for gigabytes.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]name\f[R]: (Optional) Name of the recording.
+If no name is given, data from all recordings is dumped.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]path\-to\-gc\-root\f[R]: (Optional) Flag for saving the path to
+garbage collection (GC) roots at the time the recording data is dumped.
+The path information is useful for finding memory leaks but collecting
+it can cause the application to pause for a short period of time.
+Turn on this flag only when you have an application that you suspect has
+a memory leak.
+(BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]JFR.start\f[R] [\f[I]options\f[R]]
+Start a flight recording
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+If no parameters are entered, then a recording is started with default
+values.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]delay\f[R]: (Optional) Length of time to wait before starting to
+record (INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for
+minutes or \[aq]h\[aq] for hours, 0s)
+.IP \[bu] 2
+\f[CB]disk\f[R]: (Optional) Flag for also writing the data to disk while
+recording (BOOLEAN, true)
+.IP \[bu] 2
+\f[CB]dumponexit\f[R]: (Optional) Flag for writing the recording to disk
+when the Java Virtual Machine (JVM) shuts down.
+If set to \[aq]true\[aq] and no value is given for \f[CB]filename\f[R],
+the recording is written to a file in the directory where the process
+was started.
+The file name is a system\-generated name that contains the process ID,
+the recording ID and the current time stamp.
+(For example: \f[CB]id\-1\-2019_12_12_10_41.jfr\f[R]) (BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]duration\f[R]: (Optional) Length of time to record.
+Note that \f[CB]0s\f[R] means forever (INTEGER followed by \[aq]s\[aq] for
+seconds \[aq]m\[aq] for minutes or \[aq]h\[aq] for hours, 0s)
+.IP \[bu] 2
+\f[CB]filename\f[R]: (Optional) Name of the file to which the flight
+recording data is written when the recording is stopped.
+If no filename is given, a filename is generated from the PID and the
+current date and is placed in the directory where the process was
+started.
+The filename may also be a directory in which case, the filename is
+generated from the PID and the current date in the specified directory.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]maxage\f[R]: (Optional) Maximum time to keep the recorded data on
+disk.
+This parameter is valid only when the \f[CB]disk\f[R] parameter is set to
+\f[CB]true\f[R].
+Note \f[CB]0s\f[R] means forever.
+(INTEGER followed by \[aq]s\[aq] for seconds \[aq]m\[aq] for minutes or
+\[aq]h\[aq] for hours, 0s)
+.IP \[bu] 2
+\f[CB]maxsize\f[R]: (Optional) Maximum size of the data to keep on disk in
+bytes if one of the following suffixes is not used: \[aq]m\[aq] or
+\[aq]M\[aq] for megabytes OR \[aq]g\[aq] or \[aq]G\[aq] for gigabytes.
+This parameter is valid only when the \f[CB]disk\f[R] parameter is set to
+\[aq]true\[aq].
+The value must not be less than the value for the \f[CB]maxchunksize\f[R]
+parameter set with the \f[CB]JFR.configure\f[R] command.
+(STRING, 0 (no maximum size))
+.IP \[bu] 2
+\f[CB]name\f[R]: (Optional) Name of the recording.
+If no name is provided, a name is generated.
+Make note of the generated name that is shown in the response to the
+command so that you can use it with other commands.
+(STRING, system\-generated default name)
+.IP \[bu] 2
+\f[CB]path\-to\-gc\-root\f[R]: (Optional) Flag for saving the path to
+garbage collection (GC) roots at the end of a recording.
+The path information is useful for finding memory leaks but collecting
+it is time consuming.
+Turn on this flag only when you have an application that you suspect has
+a memory leak.
+If the \f[CB]settings\f[R] parameter is set to \[aq]profile\[aq], then the
+information collected includes the stack trace from where the potential
+leaking object was allocated.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]settings\f[R]: (Optional) Name of the settings file that identifies
+which events to record.
+To specify more than one file, separate the names with a comma
+(\[aq],\[aq]).
+Include the path if the file is not in \f[CB]JAVA\-HOME\f[R]/lib/jfr.
+The following profiles are included with the JDK in the
+\f[CB]JAVA\-HOME\f[R]/lib/jfr directory: \[aq]default.jfc\[aq]: collects a
+predefined set of information with low overhead, so it has minimal
+impact on performance and can be used with recordings that run
+continuously; \[aq]profile.jfc\[aq]: Provides more data than the
+\[aq]default.jfc\[aq] profile, but with more overhead and impact on
+performance.
+Use this configuration for short periods of time when more information
+is needed.
+Use \f[CB]none\f[R] to start a recording without a predefined
+configuration file.
+(STRING, \f[CB]JAVA\-HOME\f[R]/lib/jfr/default.jfc)
+.PP
+Event settings and .jfc options can be specified using the following
+syntax:
+.IP \[bu] 2
+\f[CB]option\f[R]: (Optional) Specifies the option value to modify.
+To list available options, use the \f[CB]JAVA_HOME\f[R]/bin/jfr tool.
+.IP \[bu] 2
+\f[CB]event\-setting\f[R]: (Optional) Specifies the event setting value to
+modify.
+Use the form: #= To add a new event setting, prefix the event name with
+\[aq]+\[aq].
+.PP
+You can specify values for multiple event settings and .jfc options by
+separating them with a whitespace.
+In case of a conflict between a parameter and a .jfc option, the
+parameter will take precedence.
+The whitespace delimiter can be omitted for timespan values, i.e.
+20ms.
+For more information about the settings syntax, see Javadoc of the
+jdk.jfr package.
+.RE
+.TP
+.B \f[CB]JFR.stop\f[R] [\f[I]options\f[R]]
+Stop a flight recording
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[I]options\f[R] must be specified using either \f[I]key\f[R] or
+\f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+If no parameters are entered, then no recording is stopped.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]filename\f[R]: (Optional) Name of the file to which the recording is
+written when the recording is stopped.
+If no path is provided, the data from the recording is discarded.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]name\f[R]: (Optional) Name of the recording (STRING, no default
+value)
+.RE
+.TP
+.B \f[CB]JVMTI.agent_load\f[R] [\f[I]arguments\f[R]]
+Loads JVMTI native agent.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(control)\f[R]
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]library path\f[R]: Absolute path of the JVMTI agent to load.
+(STRING, no default value)
+.IP \[bu] 2
+\f[I]agent option\f[R]: (Optional) Option string to pass the agent.
+(STRING, no default value)
+.RE
+.TP
+.B \f[CB]JVMTI.data_dump\f[R]
+Signals the JVM to do a data\-dump request for JVMTI.
+.RS
+.PP
+Impact: High
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]ManagementAgent.start\f[R] [\f[I]options\f[R]]
+Starts remote management agent.
+.RS
+.PP
+Impact: Low \-\-\- no impact
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]config.file\f[R]: (Optional) Sets
+\f[CB]com.sun.management.config.file\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.host\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.host\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.port\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.port\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.rmi.port\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.rmi.port\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.ssl\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.registry.ssl\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.registry.ssl\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.authenticate\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.authenticate\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+jmxremote.password.file: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.password.file\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.access.file\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.acce\ ss.file\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.login.config\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.log\ in.config\f[R] (STRING, no default
+value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.enabled.cipher.suites\f[R]: (Optional) Sets
+\f[CB]com.sun.management\f[R].
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.enabled.cipher.suite\f[R]: (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.enabled.protocols\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxr\ emote.ssl.enabled.protocols\f[R] (STRING,
+no default value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.need.client.auth\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxre\ mote.need.client.auth\f[R] (STRING, no
+default value)
+.IP \[bu] 2
+\f[CB]jmxremote.ssl.config.file\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.\ ssl_config_file\f[R] (STRING, no
+default value)
+.IP \[bu] 2
+\f[CB]jmxremote.autodiscovery\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jmxremote.au\ todiscovery\f[R] (STRING, no
+default value)
+.IP \[bu] 2
+\f[CB]jdp.port\f[R]: (Optional) Sets \f[CB]com.sun.management.jdp.port\f[R]
+(INT, no default value)
+.IP \[bu] 2
+\f[CB]jdp.address\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jdp.address\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jdp.source_addr\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jdp.source_addr\f[R] (STRING, no default value)
+.IP \[bu] 2
+\f[CB]jdp.ttl\f[R]: (Optional) Sets \f[CB]com.sun.management.jdp.ttl\f[R]
+(INT, no default value)
+.IP \[bu] 2
+\f[CB]jdp.pause\f[R]: (Optional) Sets
+\f[CB]com.sun.management.jdp.pause\f[R] (INT, no default value)
+.IP \[bu] 2
+\f[CB]jdp.name\f[R]: (Optional) Sets \f[CB]com.sun.management.jdp.name\f[R]
+(STRING, no default value)
+.RE
+.TP
+.B \f[CB]ManagementAgent.start_local\f[R]
+Starts the local management agent.
+.RS
+.PP
+Impact: Low \-\-\- no impact
+.RE
+.TP
+.B \f[CB]ManagementAgent.status\f[R]
+Print the management agent status.
+.RS
+.PP
+Impact: Low \-\-\- no impact
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]ManagementAgent.stop\f[R]
+Stops the remote management agent.
+.RS
+.PP
+Impact: Low \-\-\- no impact
+.RE
+.TP
+.B \f[CB]Thread.print\f[R] [\f[I]options\f[R]]
+Prints all threads with stacktraces.
+.RS
+.PP
+Impact: Medium \-\-\- depends on the number of threads.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-l\f[R]: (Optional) Prints \f[CB]java.util.concurrent\f[R] locks
+(BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]VM.cds\f[R] [\f[I]arguments\f[R]]
+Dumps a static or dynamic shared archive that includes all currently
+loaded classes.
+.RS
+.PP
+Impact: Medium \-\-\- pause time depends on number of loaded classes
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[CB]subcmd\f[R]: must be either \f[CB]static_dump\f[R] or
+.IP \[bu] 2
+\f[CB]filename\f[R]: (Optional) Name of the shared archive to be dumped
+(STRING, no default value)
+.PP
+If \f[CB]filename\f[R] is not specified, a default file name is chosen
+using the pid of the target JVM process.
+For example, java_pid1234_static.jsa, java_pid5678_dynamic.jsa, etc.
+.PP
+If \f[CB]filename\f[R] is not specified as an absolute path, the archive
+file is created in a directory relative to the current directory of the
+target JVM process.
+.RE
+.TP
+.B \f[CB]VM.classloaders\f[R] [\f[I]options\f[R]]
+Prints classloader hierarchy.
+.RS
+.PP
+Impact: Medium \-\-\- Depends on number of class loaders and classes
+loaded.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]show\-classes\f[R]: (Optional) Print loaded classes.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]verbose\f[R]: (Optional) Print detailed information.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]fold\f[R]: (Optional) Show loaders of the same name and class as
+one.
+(BOOLEAN, true)
+.RE
+.TP
+.B \f[CB]VM.classloader_stats\f[R]
+Prints statistics about all ClassLoaders.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]VM.class_hierarchy\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
+Prints a list of all loaded classes, indented to show the class
+hierarchy.
+The name of each class is followed by the ClassLoaderData* of its
+ClassLoader, or "null" if it is loaded by the bootstrap class loader.
+.RS
+.PP
+Impact: Medium \-\-\- depends on the number of loaded classes.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-i\f[R]: (Optional) Inherited interfaces should be printed.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]\-s\f[R]: (Optional) If a class name is specified, it prints the
+subclasses.
+If the class name is not specified, only the superclasses are printed.
+(BOOLEAN, false)
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]classname\f[R]: (Optional) The name of the class whose hierarchy
+should be printed.
+If not specified, all class hierarchies are printed.
+(STRING, no default value)
+.RE
+.TP
+.B \f[CB]VM.command_line\f[R]
+Prints the command line used to start this VM instance.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]VM.dynlibs\f[R]
+Prints the loaded dynamic libraries.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]VM.info\f[R]
+Prints information about the JVM environment and status.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.RE
+.TP
+.B \f[CB]VM.log\f[R] [\f[I]options\f[R]]
+Lists current log configuration, enables/disables/configures a log
+output, or rotates all logs.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(control)\f[R]
+.PP
+\f[I]options\f[R]:
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.IP \[bu] 2
+\f[CB]output\f[R]: (Optional) The name or index (#) of output to
+configure.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]output_options\f[R]: (Optional) Options for the output.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]what\f[R]: (Optional) Configures what tags to log.
+(STRING, no default value )
+.IP \[bu] 2
+\f[CB]decorators\f[R]: (Optional) Configures which decorators to use.
+Use \[aq]none\[aq] or an empty value to remove all.
+(STRING, no default value)
+.IP \[bu] 2
+\f[CB]disable\f[R]: (Optional) Turns off all logging and clears the log
+configuration.
+(BOOLEAN, no default value)
+.IP \[bu] 2
+\f[CB]list\f[R]: (Optional) Lists current log configuration.
+(BOOLEAN, no default value)
+.IP \[bu] 2
+\f[CB]rotate\f[R]: (Optional) Rotates all logs.
+(BOOLEAN, no default value)
+.RE
+.TP
+.B \f[CB]VM.flags\f[R] [\f[I]options\f[R]]
+Prints the VM flag options and their current values.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-all\f[R]: (Optional) Prints all flags supported by the VM
+(BOOLEAN, false).
+.RE
+.TP
+.B \f[CB]VM.native_memory\f[R] [\f[I]options\f[R]]
+Prints native memory usage
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]summary\f[R]: (Optional) Requests runtime to report current memory
+summary, which includes total reserved and committed memory, along with
+memory usage summary by each subsystem.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]detail\f[R]: (Optional) Requests runtime to report memory allocation
+>= 1K by each callsite.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]baseline\f[R]: (Optional) Requests runtime to baseline current
+memory usage, so it can be compared against in later time.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]summary.diff\f[R]: (Optional) Requests runtime to report memory
+summary comparison against previous baseline.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]detail.diff\f[R]: (Optional) Requests runtime to report memory
+detail comparison against previous baseline, which shows the memory
+allocation activities at different callsites.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]shutdown\f[R]: (Optional) Requests runtime to shutdown itself and
+free the memory used by runtime.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]statistics\f[R]: (Optional) Prints tracker statistics for tuning
+purpose.
+(BOOLEAN, false)
+.IP \[bu] 2
+\f[CB]scale\f[R]: (Optional) Memory usage in which scale, KB, MB or GB
+(STRING, KB)
+.RE
+.TP
+.B \f[CB]VM.print_touched_methods\f[R]
+Prints all methods that have ever been touched during the lifetime of
+this JVM.
+.RS
+.PP
+Impact: Medium \-\-\- depends on Java content.
+.RE
+.TP
+.B \f[CB]VM.set_flag\f[R] [\f[I]arguments\f[R]]
+Sets the VM flag option by using the provided value.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(control)\f[R]
+.PP
+\f[I]arguments\f[R]:
+.IP \[bu] 2
+\f[I]flag name\f[R]: The name of the flag that you want to set (STRING,
+no default value)
+.IP \[bu] 2
+\f[I]string value\f[R]: (Optional) The value that you want to set
+(STRING, no default value)
+.RE
+.TP
+.B \f[CB]VM.stringtable\f[R] [\f[I]options\f[R]]
+Dumps the string table.
+.RS
+.PP
+Impact: Medium \-\-\- depends on the Java content.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-verbose\f[R]: (Optional) Dumps the content of each string in the
+table (BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]VM.symboltable\f[R] [\f[I]options\f[R]]
+Dumps the symbol table.
+.RS
+.PP
+Impact: Medium \-\-\- depends on the Java content.
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax).
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-verbose\f[R]: (Optional) Dumps the content of each symbol in the
+table (BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]VM.systemdictionary\f[R]
+Prints the statistics for dictionary hashtable sizes and bucket length.
+.RS
+.PP
+Impact: Medium
+.PP
+Permission: \f[CB]java.lang.management.ManagementPermission(monitor)\f[R]
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]verbose\f[R]: (Optional) Dump the content of each dictionary entry
+for all class loaders (BOOLEAN, false) .
+.RE
+.TP
+.B \f[CB]VM.system_properties\f[R]
+Prints the system properties.
+.RS
+.PP
+Impact: Low
+.PP
+Permission: \f[CB]java.util.PropertyPermission(*,\ read)\f[R]
+.RE
+.TP
+.B \f[CB]VM.uptime\f[R] [\f[I]options\f[R]]
+Prints the VM uptime.
+.RS
+.PP
+Impact: Low
+.PP
+\f[B]Note:\f[R]
+.PP
+The following \f[I]options\f[R] must be specified using either
+\f[I]key\f[R] or \f[I]key\f[R]\f[CB]=\f[R]\f[I]value\f[R] syntax.
+.PP
+\f[I]options\f[R]:
+.IP \[bu] 2
+\f[CB]\-date\f[R]: (Optional) Adds a prefix with the current date
+(BOOLEAN, false)
+.RE
+.TP
+.B \f[CB]VM.version\f[R]
+Prints JVM version information.
+.RS
+.PP
+Impact: Low
+.PP
+Permission:
+\f[CB]java.util.PropertyPermission(java.vm.version,\ read)\f[R]
+.RE
diff --git a/java/temurin-17/man/man1/jconsole.1 b/java/temurin-17/man/man1/jconsole.1
new file mode 100644
index 0000000..e02bcca
--- /dev/null
+++ b/java/temurin-17/man/man1/jconsole.1
@@ -0,0 +1,102 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JCONSOLE" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jconsole \- start a graphical console to monitor and manage Java
+applications
+.SH SYNOPSIS
+.PP
+\f[CB]jconsole\f[R] [\f[CB]\-interval=\f[R]\f[I]n\f[R]] [\f[CB]\-notile\f[R]]
+[\f[CB]\-plugin\f[R] \f[I]path\f[R]] [\f[CB]\-version\f[R]]
+[\f[I]connection\f[R] ...
+] [\f[CB]\-J\f[R]\f[I]input_arguments\f[R]]
+.PP
+\f[CB]jconsole\f[R] \f[CB]\-help\f[R]
+.SH OPTIONS
+.TP
+.B \f[CB]\-interval\f[R]
+Sets the update interval to \f[CB]n\f[R] seconds (default is 4 seconds).
+.RS
+.RE
+.TP
+.B \f[CB]\-notile\f[R]
+Doesn\[aq]t tile the windows for two or more connections.
+.RS
+.RE
+.TP
+.B \f[CB]\-pluginpath\f[R] \f[I]path\f[R]
+Specifies the path that \f[CB]jconsole\f[R] uses to look up plug\-ins.
+The plug\-in \f[I]path\f[R] should contain a provider\-configuration file
+named \f[CB]META\-INF/services/com.sun.tools.jconsole.JConsolePlugin\f[R]
+that contains one line for each plug\-in.
+The line specifies the fully qualified class name of the class
+implementing the \f[CB]com.sun.tools.jconsole.JConsolePlugin\f[R] class.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R]
+Prints the program version.
+.RS
+.RE
+.TP
+.B \f[I]connection\f[R] = \f[I]pid\f[R] | \f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] | \f[I]jmxURL\f[R]
+A connection is described by either \f[I]pid\f[R],
+\f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] or \f[I]jmxURL\f[R].
+.RS
+.IP \[bu] 2
+The \f[I]pid\f[R] value is the process ID of a target process.
+The JVM must be running with the same user ID as the user ID running the
+\f[CB]jconsole\f[R] command.
+.IP \[bu] 2
+The \f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] values are the name of the host
+system on which the JVM is running, and the port number specified by the
+system property \f[CB]com.sun.management.jmxremote.port\f[R] when the JVM
+was started.
+.IP \[bu] 2
+The \f[I]jmxUrl\f[R] value is the address of the JMX agent to be
+connected to as described in JMXServiceURL.
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]input_arguments\f[R]
+Passes \f[I]input_arguments\f[R] to the JVM on which the
+\f[CB]jconsole\f[R] command is run.
+.RS
+.RE
+.TP
+.B \f[CB]\-help\f[R] or \f[CB]\-\-help\f[R]
+Displays the help message for the command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jconsole\f[R] command starts a graphical console tool that lets
+you monitor and manage Java applications and virtual machines on a local
+or remote machine.
+.PP
+On Windows, the \f[CB]jconsole\f[R] command doesn\[aq]t associate with a
+console window.
+It does, however, display a dialog box with error information when the
+\f[CB]jconsole\f[R] command fails.
diff --git a/java/temurin-17/man/man1/jdb.1 b/java/temurin-17/man/man1/jdb.1
new file mode 100644
index 0000000..522fc68
--- /dev/null
+++ b/java/temurin-17/man/man1/jdb.1
@@ -0,0 +1,263 @@
+.\" Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JDB" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jdb \- find and fix bugs in Java platform programs
+.SH SYNOPSIS
+.PP
+\f[CB]jdb\f[R] [\f[I]options\f[R]] [\f[I]classname\f[R]]
+[\f[I]arguments\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jdb\f[R] command\-line options.
+See \f[B]Options for the jdb command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]classname\f[R]
+This represents the name of the main class to debug.
+.RS
+.RE
+.TP
+.B \f[I]arguments\f[R]
+This represents the arguments that are passed to the \f[CB]main()\f[R]
+method of the class.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The Java Debugger (JDB) is a simple command\-line debugger for Java
+classes.
+The \f[CB]jdb\f[R] command and its options call the JDB.
+The \f[CB]jdb\f[R] command demonstrates the Java Platform Debugger
+Architecture and provides inspection and debugging of a local or remote
+JVM.
+.SH START A JDB SESSION
+.PP
+There are many ways to start a JDB session.
+The most frequently used way is to have the JDB launch a new JVM with
+the main class of the application to be debugged.
+Do this by substituting the \f[CB]jdb\f[R] command for the \f[CB]java\f[R]
+command in the command line.
+For example, if your application\[aq]s main class is \f[CB]MyClass\f[R],
+then use the following command to debug it under the JDB:
+.RS
+.PP
+\f[CB]jdb\ MyClass\f[R]
+.RE
+.PP
+When started this way, the \f[CB]jdb\f[R] command calls a second JVM with
+the specified parameters, loads the specified class, and stops the JVM
+before executing that class\[aq]s first instruction.
+.PP
+Another way to use the \f[CB]jdb\f[R] command is by attaching it to a JVM
+that\[aq]s already running.
+Syntax for starting a JVM to which the \f[CB]jdb\f[R] command attaches
+when the JVM is running is as follows.
+This loads in\-process debugging libraries and specifies the kind of
+connection to be made.
+.RS
+.PP
+\f[CB]java\ \-agentlib:jdwp=transport=dt_socket,server=y,suspend=n\ MyClass\f[R]
+.RE
+.PP
+You can then attach the \f[CB]jdb\f[R] command to the JVM with the
+following command:
+.RS
+.PP
+\f[CB]jdb\ \-attach\ 8000\f[R]
+.RE
+.PP
+8000 is the address of the running JVM.
+.PP
+The \f[CB]MyClass\f[R] argument isn\[aq]t specified in the \f[CB]jdb\f[R]
+command line in this case because the \f[CB]jdb\f[R] command is connecting
+to an existing JVM instead of launching a new JVM.
+.PP
+There are many other ways to connect the debugger to a JVM, and all of
+them are supported by the \f[CB]jdb\f[R] command.
+The Java Platform Debugger Architecture has additional documentation on
+these connection options.
+.SH BREAKPOINTS
+.PP
+Breakpoints can be set in the JDB at line numbers or at the first
+instruction of a method, for example:
+.IP \[bu] 2
+The command \f[CB]stop\ at\ MyClass:22\f[R] sets a breakpoint at the first
+instruction for line 22 of the source file containing \f[CB]MyClass\f[R].
+.IP \[bu] 2
+The command \f[CB]stop\ in\ java.lang.String.length\f[R] sets a breakpoint
+at the beginning of the method \f[CB]java.lang.String.length\f[R].
+.IP \[bu] 2
+The command \f[CB]stop\ in\ MyClass.<clinit>\f[R] uses \f[CB]<clinit>\f[R]
+to identify the static initialization code for \f[CB]MyClass\f[R].
+.PP
+When a method is overloaded, you must also specify its argument types so
+that the proper method can be selected for a breakpoint.
+For example, \f[CB]MyClass.myMethod(int,java.lang.String)\f[R] or
+\f[CB]MyClass.myMethod()\f[R].
+.PP
+The \f[CB]clear\f[R] command removes breakpoints using the following
+syntax: \f[CB]clear\ MyClass:45\f[R].
+Using the \f[CB]clear\f[R] or \f[CB]stop\f[R] command with no argument
+displays a list of all breakpoints currently set.
+The \f[CB]cont\f[R] command continues execution.
+.SH STEPPING
+.PP
+The \f[CB]step\f[R] command advances execution to the next line whether
+it\[aq]s in the current stack frame or a called method.
+The \f[CB]next\f[R] command advances execution to the next line in the
+current stack frame.
+.SH EXCEPTIONS
+.PP
+When an exception occurs for which there isn\[aq]t a \f[CB]catch\f[R]
+statement anywhere in the throwing thread\[aq]s call stack, the JVM
+typically prints an exception trace and exits.
+When running under the JDB, however, control returns to the JDB at the
+offending throw.
+You can then use the \f[CB]jdb\f[R] command to diagnose the cause of the
+exception.
+.PP
+Use the \f[CB]catch\f[R] command to cause the debugged application to stop
+at other thrown exceptions, for example:
+\f[CB]catch\ java.io.FileNotFoundException\f[R] or \f[CB]catch\f[R]
+\f[CB]mypackage.BigTroubleException\f[R].
+Any exception that\[aq]s an instance of the specified class or subclass
+stops the application at the point where the exception is thrown.
+.PP
+The \f[CB]ignore\f[R] command negates the effect of an earlier
+\f[CB]catch\f[R] command.
+The \f[CB]ignore\f[R] command doesn\[aq]t cause the debugged JVM to ignore
+specific exceptions, but only to ignore the debugger.
+.SH OPTIONS FOR THE JDB COMMAND
+.PP
+When you use the \f[CB]jdb\f[R] command instead of the \f[CB]java\f[R]
+command on the command line, the \f[CB]jdb\f[R] command accepts many of
+the same options as the \f[CB]java\f[R] command.
+.PP
+The following options are accepted by the \f[CB]jdb\f[R] command:
+.TP
+.B \f[CB]\-help\f[R]
+Displays a help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-sourcepath\f[R] \f[I]dir1\f[R]\f[CB]:\f[R]\f[I]dir2\f[R]\f[CB]:\f[R]...
+Uses the specified path to search for source files in the specified
+path.
+If this option is not specified, then use the default path of dot
+(\f[CB]\&.\f[R]).
+.RS
+.RE
+.TP
+.B \f[CB]\-attach\f[R] \f[I]address\f[R]
+Attaches the debugger to a running JVM with the default connection
+mechanism.
+.RS
+.RE
+.TP
+.B \f[CB]\-listen\f[R] \f[I]address\f[R]
+Waits for a running JVM to connect to the specified address with a
+standard connector.
+.RS
+.RE
+.TP
+.B \f[CB]\-listenany\f[R]
+Waits for a running JVM to connect at any available address using a
+standard connector.
+.RS
+.RE
+.TP
+.B \f[CB]\-launch\f[R]
+Starts the debugged application immediately upon startup of the
+\f[CB]jdb\f[R] command.
+The \f[CB]\-launch\f[R] option removes the need for the \f[CB]run\f[R]
+command.
+The debugged application is launched and then stopped just before the
+initial application class is loaded.
+At that point, you can set any necessary breakpoints and use the
+\f[CB]cont\f[R] command to continue execution.
+.RS
+.RE
+.TP
+.B \f[CB]\-listconnectors\f[R]
+Lists the connectors available in this JVM.
+.RS
+.RE
+.TP
+.B \f[CB]\-connect\f[R] \f[I]connector\-name\f[R]\f[CB]:\f[R]\f[I]name1\f[R]\f[CB]=\f[R]\f[I]value1\f[R]....
+Connects to the target JVM with the named connector and listed argument
+values.
+.RS
+.RE
+.TP
+.B \f[CB]\-dbgtrace\f[R] [\f[I]flags\f[R]]
+Prints information for debugging the \f[CB]jdb\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]\-tclient\f[R]
+Runs the application in the Java HotSpot VM client.
+.RS
+.RE
+.TP
+.B \f[CB]\-tserver\f[R]
+Runs the application in the Java HotSpot VM server.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Passes \f[I]option\f[R] to the JVM, where option is one of the options
+described on the reference page for the Java application launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+See \f[I]Overview of Java Options\f[R] in \f[B]java\f[R].
+.RS
+.RE
+.PP
+The following options are forwarded to the debuggee process:
+.TP
+.B \f[CB]\-v\f[R] or \f[CB]\-verbose\f[R][\f[CB]:\f[R]\f[I]class\f[R]|\f[CB]gc\f[R]|\f[CB]jni\f[R]]
+Turns on the verbose mode.
+.RS
+.RE
+.TP
+.B \f[CB]\-D\f[R]\f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Sets a system property.
+.RS
+.RE
+.TP
+.B \f[CB]\-classpath\f[R] \f[I]dir\f[R]
+Lists directories separated by colons in which to look for classes.
+.RS
+.RE
+.TP
+.B \f[CB]\-X\f[R] \f[I]option\f[R]
+A nonstandard target JVM option.
+.RS
+.RE
+.PP
+Other options are supported to provide alternate mechanisms for
+connecting the debugger to the JVM that it\[aq]s to debug.
diff --git a/java/temurin-17/man/man1/jdeprscan.1 b/java/temurin-17/man/man1/jdeprscan.1
new file mode 100644
index 0000000..e0dde77
--- /dev/null
+++ b/java/temurin-17/man/man1/jdeprscan.1
@@ -0,0 +1,273 @@
+.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JDEPRSCAN" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jdeprscan \- static analysis tool that scans a jar file (or some other
+aggregation of class files) for uses of deprecated API elements
+.SH SYNOPSIS
+.PP
+\f[CB]jdeprscan\f[R] [\f[I]options\f[R]]
+{\f[I]dir\f[R]|\f[I]jar\f[R]|\f[I]class\f[R]}
+.TP
+.B \f[I]options\f[R]
+See \f[B]Options for the jdeprscan Command\f[R]
+.RS
+.RE
+.TP
+.B \f[I]dir\f[R]|\f[I]jar\f[R]|\f[I]class\f[R]
+\f[CB]jdeprscan\f[R] command scans each argument for usages of deprecated
+APIs.
+The arguments can be a:
+.RS
+.IP \[bu] 2
+\f[I]dir\f[R]: Directory
+.IP \[bu] 2
+\f[I]jar\f[R]: JAR file
+.IP \[bu] 2
+\f[I]class\f[R]: Class name or class file
+.PP
+The class name should use a dot (\f[CB]\&.\f[R]) as a separator.
+For example:
+.PP
+\f[CB]java.lang.Thread\f[R]
+.PP
+For nested classes, the dollar sign \f[CB]$\f[R] separator character
+should be used.
+For example:
+.PP
+\f[CB]java.lang.Thread$State\f[R]
+.PP
+A class file can also be named.
+For example:
+.PP
+\f[CB]build/classes/java/lang/Thread$State.class\f[R]
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jdeprscan\f[R] tool is a static analysis tool provided by the
+JDK that scans a JAR file or some other aggregation of class files for
+uses of deprecated API elements.
+The deprecated APIs identified by the \f[CB]jdeprscan\f[R] tool are only
+those that are defined by Java SE.
+Deprecated APIs defined by third\-party libraries aren\[aq]t reported.
+.PP
+To scan a JAR file or a set of class files, you must first ensure that
+all of the classes that the scanned classes depend upon are present in
+the class path.
+Set the class path using the \f[CB]\-\-class\-path\f[R] option described
+in \f[B]Options for the jdeprscan Command\f[R].
+Typically, you would use the same class path as the one that you use
+when invoking your application.
+.PP
+If the \f[CB]jdeprscan\f[R] can\[aq]t find all the dependent classes, it
+will generate an error message for each class that\[aq]s missing.
+These error messages are typically of the form:
+.RS
+.PP
+\f[CB]error:\ cannot\ find\ class\ ...\f[R]
+.RE
+.PP
+If these errors occur, then you must adjust the class path so that it
+includes all dependent classes.
+.SH OPTIONS FOR THE JDEPRSCAN COMMAND
+.PP
+The following options are available:
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Provides a search path for resolution of dependent classes.
+.RS
+.PP
+\f[I]path\f[R] can be a search path that consists of one or more
+directories separated by the system\-specific path separator.
+For example:
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]\-\-class\-path\ /some/directory:/another/different/dir\f[R]
+.RE
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+On Windows, use a semicolon (\f[CB];\f[R]) as the separator instead of a
+colon (\f[CB]:\f[R]).
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]\-\-class\-path\ \\some\\directory;\\another\\different\\dir\f[R]
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]\-\-for\-removal\f[R]
+Limits scanning or listing to APIs that are deprecated for removal.
+Can\[aq]t be used with a release value of 6, 7, or 8.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-full\-version\f[R]
+Prints out the full version string of the tool.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R]
+Prints out a full help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\f[R] or \f[CB]\-l\f[R]
+Prints the set of deprecated APIs.
+No scanning is done, so no directory, jar, or class arguments should be
+provided.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-release\f[R] \f[CB]6\f[R]|\f[CB]7\f[R]|\f[CB]8\f[R]|\f[CB]9\f[R]
+Specifies the Java SE release that provides the set of deprecated APIs
+for scanning.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-verbose\f[R] or \f[CB]\-v\f[R]
+Enables additional message output during processing.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints out the abbreviated version string of the tool.
+.RS
+.RE
+.SH EXAMPLE OF JDEPRSCAN OUTPUT
+.PP
+The JAR file for this library will be named something similar to
+\f[CB]commons\-math3\-3.6.1.jar\f[R].
+To scan this JAR file for the use of deprecated APIs, run the following
+command:
+.RS
+.PP
+\f[CB]jdeprscan\ commons\-math3\-3.6.1.jar\f[R]
+.RE
+.PP
+This command produces several lines of output.
+For example, one line of output might be:
+.IP
+.nf
+\f[CB]
+class\ org/apache/commons/math3/util/MathUtils\ uses\ deprecated\ method\ java/lang/Double::<init>(D)V
+\f[R]
+.fi
+.PP
+\f[B]Note:\f[R]
+.PP
+The class name is specified using the slash\-separated binary name as
+described in JVMS 4.2.1.
+This is the form used internally in class files.
+.PP
+The deprecated API it uses is a method on the \f[CB]java.lang.Double\f[R]
+class.
+.PP
+The name of the deprecated method is \f[CB]<init>\f[R], which is a special
+name that means that the method is actually a constructor.
+Another special name is \f[CB]<clinit>\f[R], which indicates a class
+static initializer.
+.PP
+Other methods are listed just by their method name.
+Following the method name is the argument list and return type:
+.RS
+.PP
+\f[CB](D)V\f[R]
+.RE
+.PP
+This indicates that it takes just one double value (a primitive) and
+returns void.
+The argument and return types can become cryptic.
+For example, another line of output might be:
+.IP
+.nf
+\f[CB]
+class\ org/apache/commons/math3/util/Precision\ uses\ deprecated\ method\ java/math/BigDecimal::setScale(II)Ljava/math/BigDecimal;
+\f[R]
+.fi
+.PP
+In this line of output, the deprecated method is on class
+\f[CB]java.math.BigDecimal\f[R], and the method is \f[CB]setScale()\f[R].
+In this case, the \f[CB](II)\f[R] means that it takes two \f[CB]int\f[R]
+arguments.
+The \f[CB]Ljava/math/BigDecimal;\f[R] after the parentheses means that it
+returns a reference to \f[CB]java.math.BigDecimal\f[R].
+.SH JDEPRSCAN ANALYSIS CAN BE VERSION\-SPECIFIC
+.PP
+You can use \f[CB]jdeprscan\f[R] relative to the previous three JDK
+releases.
+For example, if you are running JDK 9, then you can check against JDK 8,
+7, and 6.
+.PP
+As an example, look at this code snippet:
+.IP
+.nf
+\f[CB]
+public\ class\ Deprecations\ {
+\ \ \ SecurityManager\ sm\ =\ new\ RMISecurityManager();\ \ \ \ //\ deprecated\ in\ 8
+\ \ \ Boolean\ b2\ =\ new\ Boolean(true);\ \ \ \ \ \ \ \ \ \ //\ deprecated\ in\ 9
+}
+\f[R]
+.fi
+.PP
+The complete class compiles without warnings in JDK 7.
+.PP
+If you run \f[CB]jdeprscan\f[R] on a system with JDK 9, then you see:
+.IP
+.nf
+\f[CB]
+$\ jdeprscan\ \-\-class\-path\ classes\ \-\-release\ 7\ example.Deprecations
+(no\ output)
+\f[R]
+.fi
+.PP
+Run \f[CB]jdeprscan\f[R] with a release value of 8:
+.IP
+.nf
+\f[CB]
+$\ jdeprscan\ \-\-class\-path\ classes\ \-\-release\ 8\ example.Deprecations
+class\ example/Deprecations\ uses\ type\ java/rmi/RMISecurityManager\ deprecated
+class\ example/Deprecations\ uses\ method\ in\ type\ java/rmi/RMISecurityManager\ deprecated
+\f[R]
+.fi
+.PP
+Run \f[CB]jdeprscan\f[R] on JDK 9:
+.IP
+.nf
+\f[CB]
+$\ jdeprscan\ \-\-class\-path\ classes\ example.Deprecations
+class\ example/Deprecations\ uses\ type\ java/rmi/RMISecurityManager\ deprecated
+class\ example/Deprecations\ uses\ method\ in\ type\ java/rmi/RMISecurityManager\ deprecated
+class\ example/Deprecations\ uses\ method\ java/lang/Boolean\ <init>\ (Z)V\ deprecated
+\f[R]
+.fi
diff --git a/java/temurin-17/man/man1/jdeps.1 b/java/temurin-17/man/man1/jdeps.1
new file mode 100644
index 0000000..50b6a1f
--- /dev/null
+++ b/java/temurin-17/man/man1/jdeps.1
@@ -0,0 +1,403 @@
+.\" Copyright (c) 2013, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JDEPS" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jdeps \- launch the Java class dependency analyzer
+.SH SYNOPSIS
+.PP
+\f[CB]jdeps\f[R] [\f[I]options\f[R]] \f[I]path\f[R] ...
+.TP
+.B \f[I]options\f[R]
+Command\-line options.
+For detailed descriptions of the options that can be used, see
+.RS
+.IP \[bu] 2
+\f[B]Possible Options\f[R]
+.IP \[bu] 2
+\f[B]Module Dependence Analysis Options\f[R]
+.IP \[bu] 2
+\f[B]Options to Filter Dependences\f[R]
+.IP \[bu] 2
+\f[B]Options to Filter Classes to be Analyzed\f[R]
+.RE
+.TP
+.B \f[I]path\f[R]
+A pathname to the \f[CB]\&.class\f[R] file, directory, or JAR file to
+analyze.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jdeps\f[R] command shows the package\-level or class\-level
+dependencies of Java class files.
+The input class can be a path name to a \f[CB]\&.class\f[R] file, a
+directory, a JAR file, or it can be a fully qualified class name to
+analyze all class files.
+The options determine the output.
+By default, the \f[CB]jdeps\f[R] command writes the dependencies to the
+system output.
+The command can generate the dependencies in DOT language (see the
+\f[CB]\-dotoutput\f[R] option).
+.SH POSSIBLE OPTIONS
+.TP
+.B \f[CB]\-?\f[R] or \f[CB]\-h\f[R] or \f[CB]\-\-help\f[R]
+Prints the help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-dotoutput\f[R] \f[I]dir\f[R] or \f[CB]\-\-dot\-output\f[R] \f[I]dir\f[R]
+Specifies the destination directory for DOT file output.
+If this option is specified, then the \f[CB]jdeps\f[R]command generates
+one \f[CB]\&.dot\f[R] file for each analyzed archive named
+\f[CB]archive\-file\-name.dot\f[R] that lists the dependencies, and also a
+summary file named \f[CB]summary.dot\f[R] that lists the dependencies
+among the archive files.
+.RS
+.RE
+.TP
+.B \f[CB]\-s\f[R] or \f[CB]\-summary\f[R]
+Prints a dependency summary only.
+.RS
+.RE
+.TP
+.B \f[CB]\-v\f[R] or \f[CB]\-verbose\f[R]
+Prints all class\-level dependencies.
+This is equivalent to
+.RS
+.RS
+.PP
+\f[CB]\-verbose:class\ \-filter:none\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-verbose:package\f[R]
+Prints package\-level dependencies excluding, by default, dependences
+within the same package.
+.RS
+.RE
+.TP
+.B \f[CB]\-verbose:class\f[R]
+Prints class\-level dependencies excluding, by default, dependencies
+within the same archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-apionly\f[R] or \f[CB]\-\-api\-only\f[R]
+Restricts the analysis to APIs, for example, dependences from the
+signature of \f[CB]public\f[R] and \f[CB]protected\f[R] members of public
+classes including field type, method parameter types, returned type, and
+checked exception types.
+.RS
+.RE
+.TP
+.B \f[CB]\-jdkinternals\f[R] or \f[CB]\-\-jdk\-internals\f[R]
+Finds class\-level dependences in the JDK internal APIs.
+By default, this option analyzes all classes specified in the
+\f[CB]\-\-classpath\f[R] option and input files unless you specified the
+\f[CB]\-include\f[R] option.
+You can\[aq]t use this option with the \f[CB]\-p\f[R], \f[CB]\-e\f[R], and
+\f[CB]\-s\f[R] options.
+.RS
+.PP
+\f[B]Warning\f[R]: The JDK internal APIs are inaccessible.
+.RE
+.TP
+.B \f[CB]\-cp\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies where to find class files.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]module\-path\f[R]
+Specifies the module path.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-upgrade\-module\-path\f[R] \f[I]module\-path\f[R]
+Specifies the upgrade module path.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-system\f[R] \f[I]java\-home\f[R]
+Specifies an alternate system module path.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\-name\f[R][\f[CB],\f[R] \f[I]module\-name\f[R]...]
+Adds modules to the root set for analysis.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-multi\-release\f[R] \f[I]version\f[R]
+Specifies the version when processing multi\-release JAR files.
+\f[I]version\f[R] should be an integer >=9 or base.
+.RS
+.RE
+.TP
+.B \f[CB]\-q\f[R] or \f[CB]\-quiet\f[R]
+Doesn\[aq]t show missing dependencies from
+\f[CB]\-generate\-module\-info\f[R] output.
+.RS
+.RE
+.TP
+.B \f[CB]\-version\f[R] or \f[CB]\-\-version\f[R]
+Prints version information.
+.RS
+.RE
+.SH MODULE DEPENDENCE ANALYSIS OPTIONS
+.TP
+.B \f[CB]\-m\f[R] \f[I]module\-name\f[R] or \f[CB]\-\-module\f[R] \f[I]module\-name\f[R]
+Specifies the root module for analysis.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-generate\-module\-info\f[R] \f[I]dir\f[R]
+Generates \f[CB]module\-info.java\f[R] under the specified directory.
+The specified JAR files will be analyzed.
+This option cannot be used with \f[CB]\-\-dot\-output\f[R] or
+\f[CB]\-\-class\-path\f[R] options.
+Use the \f[CB]\-\-generate\-open\-module\f[R] option for open modules.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-generate\-open\-module\f[R] \f[I]dir\f[R]
+Generates \f[CB]module\-info.java\f[R] for the specified JAR files under
+the specified directory as open modules.
+This option cannot be used with the \f[CB]\-\-dot\-output\f[R] or
+\f[CB]\-\-class\-path\f[R] options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-check\f[R] \f[I]module\-name\f[R] [\f[CB],\f[R] \f[I]module\-name\f[R]...]
+Analyzes the dependence of the specified modules.
+It prints the module descriptor, the resulting module dependences after
+analysis and the graph after transition reduction.
+It also identifies any unused qualified exports.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\-deps\f[R]
+Lists the module dependences and also the package names of JDK internal
+APIs (if referenced).
+This option transitively analyzes libraries on class path and module
+path if referenced.
+Use \f[CB]\-\-no\-recursive\f[R] option for non\-transitive dependency
+analysis.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\-reduced\-deps\f[R]
+Same as \f[CB]\-\-list\-deps\f[R] without listing the implied reads edges
+from the module graph.
+If module M1 reads M2, and M2 requires transitive on M3, then M1 reading
+M3 is implied and is not shown in the graph.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-print\-module\-deps\f[R]
+Same as \f[CB]\-\-list\-reduced\-deps\f[R] with printing a
+comma\-separated list of module dependences.
+The output can be used by \f[CB]jlink\ \-\-add\-modules\f[R] to create a
+custom image that contains those modules and their transitive
+dependences.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-ignore\-missing\-deps\f[R]
+Ignore missing dependences.
+.RS
+.RE
+.SH OPTIONS TO FILTER DEPENDENCES
+.TP
+.B \f[CB]\-p\f[R] \f[I]pkg_name\f[R], \f[CB]\-package\f[R] \f[I]pkg_name\f[R], or \f[CB]\-\-package\f[R] \f[I]pkg_name\f[R]
+Finds dependences matching the specified package name.
+You can specify this option multiple times for different packages.
+The \f[CB]\-p\f[R] and \f[CB]\-e\f[R] options are mutually exclusive.
+.RS
+.RE
+.TP
+.B \f[CB]\-e\f[R] \f[I]regex\f[R], \f[CB]\-regex\f[R] \f[I]regex\f[R], or \f[CB]\-\-regex\f[R] \f[I]regex\f[R]
+Finds dependences matching the specified pattern.
+The \f[CB]\-p\f[R] and \f[CB]\-e\f[R] options are mutually exclusive.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-require\f[R] \f[I]module\-name\f[R]
+Finds dependences matching the given module name (may be given multiple
+times).
+The \f[CB]\-\-package\f[R], \f[CB]\-\-regex\f[R], and \f[CB]\-\-require\f[R]
+options are mutually exclusive.
+.RS
+.RE
+.TP
+.B \f[CB]\-f\f[R] \f[I]regex\f[R] or \f[CB]\-filter\f[R] \f[I]regex\f[R]
+Filters dependences matching the given pattern.
+If give multiple times, the last one will be selected.
+.RS
+.RE
+.TP
+.B \f[CB]\-filter:package\f[R]
+Filters dependences within the same package.
+This is the default.
+.RS
+.RE
+.TP
+.B \f[CB]\-filter:archive\f[R]
+Filters dependences within the same archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-filter:module\f[R]
+Filters dependences within the same module.
+.RS
+.RE
+.TP
+.B \f[CB]\-filter:none\f[R]
+No \f[CB]\-filter:package\f[R] and \f[CB]\-filter:archive\f[R] filtering.
+Filtering specified via the \f[CB]\-filter\f[R] option still applies.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-missing\-deps\f[R]
+Finds missing dependences.
+This option cannot be used with \f[CB]\-p\f[R], \f[CB]\-e\f[R] and
+\f[CB]\-s\f[R] options.
+.RS
+.RE
+.SH OPTIONS TO FILTER CLASSES TO BE ANALYZED
+.TP
+.B \f[CB]\-include\f[R] \f[I]regex\f[R]
+Restricts analysis to the classes matching pattern.
+This option filters the list of classes to be analyzed.
+It can be used together with \f[CB]\-p\f[R] and \f[CB]\-e\f[R], which apply
+the pattern to the dependencies.
+.RS
+.RE
+.TP
+.B \f[CB]\-P\f[R] or \f[CB]\-profile\f[R]
+Shows the profile containing a package.
+.RS
+.RE
+.TP
+.B \f[CB]\-R\f[R] or \f[CB]\-\-recursive\f[R]
+Recursively traverses all run\-time dependences.
+The \f[CB]\-R\f[R] option implies \f[CB]\-filter:none\f[R].
+If \f[CB]\-p\f[R], \f[CB]\-e\f[R], or \f[CB]\-f\f[R] options are specified,
+only the matching dependences are analyzed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-no\-recursive\f[R]
+Do not recursively traverse dependences.
+.RS
+.RE
+.TP
+.B \f[CB]\-I\f[R] or \f[CB]\-\-inverse\f[R]
+Analyzes the dependences per other given options and then finds all
+artifacts that directly and indirectly depend on the matching nodes.
+This is equivalent to the inverse of the compile\-time view analysis and
+the print dependency summary.
+This option must be used with the \f[CB]\-\-require\f[R],
+\f[CB]\-\-package\f[R], or \f[CB]\-\-regex\f[R] options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-compile\-time\f[R]
+Analyzes the compile\-time view of transitive dependencies, such as the
+compile\-time view of the \f[CB]\-R\f[R] option.
+Analyzes the dependences per other specified options.
+If a dependency is found from a directory, a JAR file or a module, all
+classes in that containing archive are analyzed.
+.RS
+.RE
+.SH EXAMPLE OF ANALYZING DEPENDENCIES
+.PP
+The following example demonstrates analyzing the dependencies of the
+\f[CB]Notepad.jar\f[R] file.
+.PP
+\f[B]Linux and OS X:\f[R]
+.IP
+.nf
+\f[CB]
+$\ jdeps\ demo/jfc/Notepad/Notepad.jar
+Notepad.jar\ \->\ java.base
+Notepad.jar\ \->\ java.desktop
+Notepad.jar\ \->\ java.logging
+\ \ \ <unnamed>\ (Notepad.jar)
+\ \ \ \ \ \ \->\ java.awt
+\ \ \ \ \ \ \->\ java.awt.event
+\ \ \ \ \ \ \->\ java.beans
+\ \ \ \ \ \ \->\ java.io
+\ \ \ \ \ \ \->\ java.lang
+\ \ \ \ \ \ \->\ java.net
+\ \ \ \ \ \ \->\ java.util
+\ \ \ \ \ \ \->\ java.util.logging
+\ \ \ \ \ \ \->\ javax.swing
+\ \ \ \ \ \ \->\ javax.swing.border
+\ \ \ \ \ \ \->\ javax.swing.event
+\ \ \ \ \ \ \->\ javax.swing.text
+\ \ \ \ \ \ \->\ javax.swing.tree
+\ \ \ \ \ \ \->\ javax.swing.undo
+\f[R]
+.fi
+.PP
+\f[B]Windows:\f[R]
+.IP
+.nf
+\f[CB]
+C:\\Java\\jdk1.9.0>jdeps\ demo\\jfc\\Notepad\\Notepad.jar
+Notepad.jar\ \->\ java.base
+Notepad.jar\ \->\ java.desktop
+Notepad.jar\ \->\ java.logging
+\ \ \ <unnamed>\ (Notepad.jar)
+\ \ \ \ \ \ \->\ java.awt
+\ \ \ \ \ \ \->\ java.awt.event
+\ \ \ \ \ \ \->\ java.beans
+\ \ \ \ \ \ \->\ java.io
+\ \ \ \ \ \ \->\ java.lang
+\ \ \ \ \ \ \->\ java.net
+\ \ \ \ \ \ \->\ java.util
+\ \ \ \ \ \ \->\ java.util.logging
+\ \ \ \ \ \ \->\ javax.swing
+\ \ \ \ \ \ \->\ javax.swing.border
+\ \ \ \ \ \ \->\ javax.swing.event
+\ \ \ \ \ \ \->\ javax.swing.text
+\ \ \ \ \ \ \->\ javax.swing.tree
+\ \ \ \ \ \ \->\ javax.swing.undo
+\f[R]
+.fi
+.SH EXAMPLE USING THE \-\-INVERSE OPTION
+.IP
+.nf
+\f[CB]
+\ $\ jdeps\ \-\-inverse\ \-\-require\ java.xml.bind
+Inverse\ transitive\ dependences\ on\ [java.xml.bind]
+java.xml.bind\ <\-\ java.se.ee
+java.xml.bind\ <\-\ jdk.xml.ws
+java.xml.bind\ <\-\ java.xml.ws\ <\-\ java.se.ee
+java.xml.bind\ <\-\ java.xml.ws\ <\-\ jdk.xml.ws
+java.xml.bind\ <\-\ jdk.xml.bind\ <\-\ jdk.xml.ws
+\f[R]
+.fi
diff --git a/java/temurin-17/man/man1/jfr.1 b/java/temurin-17/man/man1/jfr.1
new file mode 100644
index 0000000..6f85e0c
--- /dev/null
+++ b/java/temurin-17/man/man1/jfr.1
@@ -0,0 +1,295 @@
+.\" Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JFR" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jfr \- parse and print Flight Recorder files
+.SH SYNOPSIS
+.PP
+To print the contents of a flight recording to standard out:
+.PP
+\f[CB]jfr\f[R] \f[CB]print\f[R] [\f[I]options\f[R]] \f[I]file\f[R]
+.PP
+To print metadata information about flight recording events:
+.PP
+\f[CB]jfr\f[R] \f[CB]metadata\f[R] \f[I]file\f[R]
+.PP
+To assemble chunk files into a flight recording file:
+.PP
+\f[CB]jfr\f[R] \f[CB]assemble\f[R] \f[I]repository\f[R] \f[I]file\f[R]
+.PP
+To disassemble a flight recording file into chunk files:
+.PP
+\f[CB]jfr\f[R] \f[CB]disassmble\f[R] [\f[I]options\f[R]] \f[I]file\f[R]
+.PP
+To view the summary statistics for a flight recording file:
+.PP
+\f[CB]jfr\f[R] \f[CB]summary\f[R] \f[I]file\f[R]
+.TP
+.B \f[I]options\f[R]
+Optional: Specifies command\-line options separated by spaces.
+See the individual subcomponent sections for descriptions of the
+available options.
+.RS
+.RE
+.TP
+.B \f[I]file\f[R]
+Specifies the name of the target flight recording file
+(\f[CB]\&.jfr\f[R]).
+.RS
+.RE
+.TP
+.B \f[I]repository\f[R]
+Specifies the location of the chunk files which are to be assembled into
+a flight recording.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jfr\f[R] command provides a tool for interacting with flight
+recorder files (\f[CB]\&.jfr\f[R]).
+The main function is to filter, summarize and output flight recording
+files into human readable format.
+There is also support for merging and splitting recording files.
+.PP
+Flight recording files are created and saved as binary formatted files.
+Having a tool that can extract the contents from a flight recording and
+manipulate the contents and translate them into human readable format
+helps developers to debug performance issues with Java applications.
+.SS Subcommands
+.PP
+The \f[CB]jfr\f[R] command has several subcommands:
+.IP \[bu] 2
+\f[CB]print\f[R]
+.IP \[bu] 2
+\f[CB]summary\f[R]
+.IP \[bu] 2
+\f[CB]assemble\f[R]
+.IP \[bu] 2
+\f[CB]disassemble\f[R]
+.IP \[bu] 2
+\f[CB]metadata\f[R]
+.SS \f[CB]jfr\ print\f[R] subcommand
+.PP
+Use \f[CB]jfr\ print\f[R] to print the contents of a flight recording file
+to standard out.
+The syntax is:
+.PP
+\f[CB]jfr\ print\f[R] [\f[CB]\-\-xml\f[R]|\f[CB]\-\-json\f[R]]
+[\f[CB]\-\-categories\f[R] <\f[I]filters\f[R]>] [\f[CB]\-\-events\f[R]
+<\f[I]filters\f[R]>] [\f[CB]\-\-stack\-depth\f[R] <\f[I]depth\f[R]>]
+<\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B \f[CB]\-\-xml\f[R]
+Print the recording in XML format
+.RS
+.RE
+.TP
+.B \f[CB]\-\-json\f[R]
+Print the recording in JSON format
+.RS
+.RE
+.TP
+.B \f[CB]\-\-categories\f[R] <\f[I]filters\f[R]>
+Select events matching a category name.
+The filter is a comma\-separated list of names, simple and/or qualified,
+and/or quoted glob patterns
+.RS
+.RE
+.TP
+.B \f[CB]\-\-events\f[R] <\f[I]filters\f[R]>
+Select events matching an event name.
+The filter is a comma\-separated list of names, simple and/or qualified,
+and/or quoted glob patterns
+.RS
+.RE
+.TP
+.B \f[CB]\-\-stack\-depth\f[R] <\f[I]depth\f[R]>
+Number of frames in stack traces, by default 5
+.RS
+.RE
+.TP
+.B <\f[I]file\f[R]>
+Location of the recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.PP
+The default format for printing the contents of the flight recording
+file is human readable form unless either \f[CB]xml\f[R] or \f[CB]json\f[R]
+is specified.
+These options provide machine\-readable output that can be further
+parsed or processed by user created scripts.
+.PP
+Use \f[CB]jfr\ \-\-help\ print\f[R] to see example usage of filters.
+.PP
+To reduce the amount of data displayed, it is possible to filter out
+events or categories of events.
+The filter operates on the symbolic name of an event, set by using the
+\f[CB]\@Name\f[R] annotation, or the category name, set by using the
+\f[CB]\@Category\f[R] annotation.
+If multiple filters are used, events from both filters will be included.
+If no filter is used, all the events will be printed.
+If a combination of a category filter and event filter is used, the
+selected events will be the union of the two filters.
+.PP
+For example, to show all GC events and the CPULoad event, the following
+command could be used:
+.PP
+\f[CB]jfr\ print\ \-\-categories\ GC\ \-\-events\ CPULoad\ recording.jfr\f[R]
+.PP
+Event values are formatted according to the content types that are being
+used.
+For example, a field with the \f[CB]jdk.jfr.Percentage\f[R] annotation
+that has the value 0.52 is formatted as 52%.
+.PP
+Stack traces are by default truncated to 5 frames, but the number can be
+increased/decreased using the \f[CB]\-\-stack\-depth\f[R] command\-line
+option.
+.SS \f[CB]jfr\ summary\f[R] subcommand
+.PP
+Use \f[CB]jfr\ summary\f[R] to print statistics for a recording.
+For example, a summary can illustrate the number of recorded events and
+how much disk space they used.
+This is useful for troubleshooting and understanding the impact of event
+settings.
+.PP
+The syntax is:
+.PP
+\f[CB]jfr\ summary\f[R] <\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B <\f[I]file\f[R]>
+Location of the flight recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.SS \f[CB]jfr\ metadata\f[R] subcommand
+.PP
+Use \f[CB]jfr\ metadata\f[R] to view information about events, such as
+event names, categories and field layout within a flight recording file.
+The syntax is:
+.PP
+\f[CB]jfr\ metadata\f[R] <\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B <\f[I]file\f[R]>
+Location of the flight recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.SS jfr \f[CB]assemble\f[R] subcommand
+.PP
+Use jfr \f[CB]assemble\f[R] to assemble chunk files into a recording file.
+.PP
+The syntax is:
+.PP
+\f[CB]jfr\ assemble\f[R] <\f[I]repository\f[R]> <\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B <\f[I]repository\f[R]>
+Directory where the repository containing chunk files is located
+.RS
+.RE
+.TP
+.B <\f[I]file\f[R]>
+Location of the flight recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.PP
+Flight recording information is written in chunks.
+A chunk contains all of the information necessary for parsing.
+A chunk typically contains events useful for troubleshooting.
+If a JVM should crash, these chunks can be recovered and used to create
+a flight recording file using this \f[CB]jfr\ assemble\f[R] command.
+These chunk files are concatenated in chronological order and chunk
+files that are not finished (.part) are excluded.
+.SS \f[CB]jfr\ disassemble\f[R] subcommand
+.PP
+Use \f[CB]jfr\ disassemble\f[R] to decompose a flight recording file into
+its chunk file pieces.
+The syntax is:
+.PP
+\f[CB]jfr\ disassemble\f[R] [\f[CB]\-\-max\-chunks\f[R] <\f[I]chunks\f[R]>]
+[\f[CB]\-\-output\f[R] <\f[I]directory\f[R]>] <\f[I]file\f[R]>
+.PP
+where:
+.TP
+.B \f[CB]\-\-output\f[R] <\f[I]directory\f[R]>
+The location to write the disassembled file, by default the current
+directory
+.RS
+.RE
+.TP
+.B \f[CB]\-\-max\-chunks\f[R] <\f[I]chunks\f[R]>
+Maximum number of chunks per file, by default 5.
+The chunk size varies, but is typically around 15 MB.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-max\-size\f[R] <\f[I]size\f[R]>
+Maximum number of bytes per file.
+.RS
+.RE
+.TP
+.B <\f[I]file\f[R]>
+Location of the flight recording file (\f[CB]\&.jfr\f[R])
+.RS
+.RE
+.PP
+This function can be useful for repairing a broken file by removing the
+faulty chunk.
+It can also be used to reduce the size of a file that is too large to
+transfer.
+The resulting chunk files are named \f[CB]myfile_1.jfr\f[R],
+\f[CB]myfile_2.jfr\f[R], etc.
+If needed, the resulting file names will be padded with zeros to
+preserve chronological order.
+For example, the chunk file name is \f[CB]myfile_001.jfr\f[R] if the
+recording consists of more than 100 chunks.
+.SS jfr version and help subcommands
+.PP
+Use \f[CB]jfr\ \-\-version\f[R] or \f[CB]jfr\ version\f[R] to view the
+version string information for this jfr command.
+.PP
+To get help on any of the jfr subcommands, use:
+.PP
+\f[CB]jfr\ <\-\-help|help>\f[R] [\f[I]subcommand\f[R]]
+.PP
+where:
+.PP
+[\f[I]subcommand\f[R]] is any of:
+.IP \[bu] 2
+\f[CB]print\f[R]
+.IP \[bu] 2
+\f[CB]metadata\f[R]
+.IP \[bu] 2
+\f[CB]summary\f[R]
+.IP \[bu] 2
+\f[CB]assemble\f[R]
+.IP \[bu] 2
+\f[CB]disassemble\f[R]
diff --git a/java/temurin-17/man/man1/jhsdb.1 b/java/temurin-17/man/man1/jhsdb.1
new file mode 100644
index 0000000..50c1732
--- /dev/null
+++ b/java/temurin-17/man/man1/jhsdb.1
@@ -0,0 +1,260 @@
+.\" Copyright (c) 2019, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JHSDB" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jhsdb \- attach to a Java process or launch a postmortem debugger to
+analyze the content of a core dump from a crashed Java Virtual Machine
+(JVM)
+.SH SYNOPSIS
+.PP
+\f[CB]jhsdb\f[R] \f[CB]clhsdb\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R]
+\f[I]coredump\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]hsdb\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R]
+\f[I]coredump\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]debugd\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R]
+\f[I]coredump\f[R]) [\f[I]options\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]jstack\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]
+| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R])
+[\f[I]options\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]jmap\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]
+| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R])
+[\f[I]options\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]jinfo\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]
+| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R])
+[\f[I]options\f[R]]
+.PP
+\f[CB]jhsdb\f[R] \f[CB]jsnap\f[R] (\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
+\f[CB]\-\-exe\f[R] \f[I]executable\f[R] \f[CB]\-\-core\f[R] \f[I]coredump\f[R]
+| \f[CB]\-\-connect\f[R] \f[I][server\-id\@]debugd\-host\f[R])
+[\f[I]options\f[R]]
+.TP
+.B \f[I]pid\f[R]
+The process ID to which the \f[CB]jhsdb\f[R] tool should attach.
+The process must be a Java process.
+To get a list of Java processes running on a machine, use the
+\f[CB]ps\f[R] command or, if the JVM processes are not running in a
+separate docker instance, the \f[B]jps\f[R] command.
+.RS
+.RE
+.TP
+.B \f[I]executable\f[R]
+The Java executable file from which the core dump was produced.
+.RS
+.RE
+.TP
+.B \f[I]coredump\f[R]
+The core file to which the \f[CB]jhsdb\f[R] tool should attach.
+.RS
+.RE
+.TP
+.B \f[I][server\-id\@]debugd\-host\f[R]
+An optional server ID and the address of the remote debug server
+(debugd).
+.RS
+.RE
+.TP
+.B \f[I]options\f[R]
+The command\-line options for a \f[CB]jhsdb\f[R] mode.
+See \f[B]Options for the debugd Mode\f[R], \f[B]Options for the jstack
+Mode\f[R], \f[B]Options for the jmap Mode\f[R], \f[B]Options for the jinfo
+Mode\f[R], and \f[B]Options for the jsnap Mode\f[R].
+.RS
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+Either the \f[I]pid\f[R] or the pair of \f[I]executable\f[R] and
+\f[I]core\f[R] files or the \f[I][server\-id\@]debugd\-host\f[R] must be
+provided for \f[CB]debugd\f[R], \f[CB]jstack\f[R], \f[CB]jmap\f[R],
+\f[CB]jinfo\f[R] and \f[CB]jsnap\f[R] modes.
+.SH DESCRIPTION
+.PP
+You can use the \f[CB]jhsdb\f[R] tool to attach to a Java process or to
+launch a postmortem debugger to analyze the content of a core\-dump from
+a crashed Java Virtual Machine (JVM).
+This command is experimental and unsupported.
+.PP
+\f[B]Note:\f[R]
+.PP
+Attaching the \f[CB]jhsdb\f[R] tool to a live process will cause the
+process to hang and the process will probably crash when the debugger
+detaches.
+.PP
+The \f[CB]jhsdb\f[R] tool can be launched in any one of the following
+modes:
+.TP
+.B \f[CB]jhsdb\ clhsdb\f[R]
+Starts the interactive command\-line debugger.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ hsdb\f[R]
+Starts the interactive GUI debugger.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ debugd\f[R]
+Starts the remote debug server.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ jstack\f[R]
+Prints stack and locks information.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ jmap\f[R]
+Prints heap information.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ jinfo\f[R]
+Prints basic JVM information.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\ jsnap\f[R]
+Prints performance counter information.
+.RS
+.RE
+.TP
+.B \f[CB]jhsdb\f[R] \f[I]command\f[R] \f[CB]\-\-help\f[R]
+Displays the options available for the \f[I]command\f[R].
+.RS
+.RE
+.SH OPTIONS FOR THE DEBUGD MODE
+.TP
+.B \f[CB]\-\-serverid\f[R] \f[I]server\-id\f[R]
+An optional unique ID for this debug server.
+This is required if multiple debug servers are run on the same machine.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-rmiport\f[R] \f[I]port\f[R]
+Sets the port number to which the RMI connector is bound.
+If not specified a random available port is used.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-registryport\f[R] \f[I]port\f[R]
+Sets the RMI registry port.
+This option overrides the system property
+\[aq]sun.jvm.hotspot.rmi.port\[aq].
+If not specified, the system property is used.
+If the system property is not set, the default port 1099 is used.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-hostname\f[R] \f[I]hostname\f[R]
+Sets the hostname the RMI connector is bound.
+The value could be a hostname or an IPv4/IPv6 address.
+This option overrides the system property
+\[aq]java.rmi.server.hostname\[aq].
+If not specified, the system property is used.
+If the system property is not set, a system hostname is used.
+.RS
+.RE
+.SH OPTIONS FOR THE JINFO MODE
+.TP
+.B \f[CB]\-\-flags\f[R]
+Prints the VM flags.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-sysprops\f[R]
+Prints the Java system properties.
+.RS
+.RE
+.TP
+.B no option
+Prints the VM flags and the Java system properties.
+.RS
+.RE
+.SH OPTIONS FOR THE JMAP MODE
+.TP
+.B no option
+Prints the same information as Solaris \f[CB]pmap\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-heap\f[R]
+Prints the \f[CB]java\f[R] heap summary.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-binaryheap\f[R]
+Dumps the \f[CB]java\f[R] heap in \f[CB]hprof\f[R] binary format.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dumpfile\f[R] \f[I]name\f[R]
+The name of the dumpfile.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-histo\f[R]
+Prints the histogram of \f[CB]java\f[R] object heap.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-clstats\f[R]
+Prints the class loader statistics.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-finalizerinfo\f[R]
+Prints the information on objects awaiting finalization.
+.RS
+.RE
+.SH OPTIONS FOR THE JSTACK MODE
+.TP
+.B \f[CB]\-\-locks\f[R]
+Prints the \f[CB]java.util.concurrent\f[R] locks information.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mixed\f[R]
+Attempts to print both \f[CB]java\f[R] and native frames if the platform
+allows it.
+.RS
+.RE
+.SH OPTIONS FOR THE JSNAP MODE
+.TP
+.B \f[CB]\-\-all\f[R]
+Prints all performance counters.
+.RS
+.RE
diff --git a/java/temurin-17/man/man1/jinfo.1 b/java/temurin-17/man/man1/jinfo.1
new file mode 100644
index 0000000..872da9c
--- /dev/null
+++ b/java/temurin-17/man/man1/jinfo.1
@@ -0,0 +1,105 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JINFO" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jinfo \- generate Java configuration information for a specified Java
+process
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jinfo\f[R] [\f[I]option\f[R]] \f[I]pid\f[R]
+.TP
+.B \f[I]option\f[R]
+This represents the \f[CB]jinfo\f[R] command\-line options.
+See \f[B]Options for the jinfo Command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]pid\f[R]
+The process ID for which the configuration information is to be printed.
+The process must be a Java process.
+To get a list of Java processes running on a machine, use either the
+\f[CB]ps\f[R] command or, if the JVM processes are not running in a
+separate docker instance, the \f[B]jps\f[R] command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jinfo\f[R] command prints Java configuration information for a
+specified Java process.
+The configuration information includes Java system properties and JVM
+command\-line flags.
+If the specified process is running on a 64\-bit JVM, then you might
+need to specify the \f[CB]\-J\-d64\f[R] option, for example:
+.RS
+.PP
+\f[CB]jinfo\ \-J\-d64\ \-sysprops\f[R] \f[I]pid\f[R]
+.RE
+.PP
+This command is unsupported and might not be available in future
+releases of the JDK.
+In Windows Systems where \f[CB]dbgeng.dll\f[R] is not present, the
+Debugging Tools for Windows must be installed to have these tools work.
+The \f[CB]PATH\f[R] environment variable should contain the location of
+the \f[CB]jvm.dll\f[R] that\[aq]s used by the target process or the
+location from which the core dump file was produced.
+.SH OPTIONS FOR THE JINFO COMMAND
+.PP
+\f[B]Note:\f[R]
+.PP
+If none of the following options are used, both the command\-line flags
+and the system property name\-value pairs are printed.
+.TP
+.B \f[CB]\-flag\f[R] \f[I]name\f[R]
+Prints the name and value of the specified command\-line flag.
+.RS
+.RE
+.TP
+.B \f[CB]\-flag\f[R] [\f[CB]+\f[R]|\f[CB]\-\f[R]]\f[I]name\f[R]
+Enables or disables the specified Boolean command\-line flag.
+.RS
+.RE
+.TP
+.B \f[CB]\-flag\f[R] \f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Sets the specified command\-line flag to the specified value.
+.RS
+.RE
+.TP
+.B \f[CB]\-flags\f[R]
+Prints command\-line flags passed to the JVM.
+.RS
+.RE
+.TP
+.B \f[CB]\-sysprops\f[R]
+Prints Java system properties as name\-value pairs.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] or \f[CB]\-help\f[R]
+Prints a help message.
+.RS
+.RE
diff --git a/java/temurin-17/man/man1/jlink.1 b/java/temurin-17/man/man1/jlink.1
new file mode 100644
index 0000000..638262b
--- /dev/null
+++ b/java/temurin-17/man/man1/jlink.1
@@ -0,0 +1,434 @@
+.\" Copyright (c) 2017, 2019, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JLINK" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jlink \- assemble and optimize a set of modules and their dependencies
+into a custom runtime image
+.SH SYNOPSIS
+.PP
+\f[CB]jlink\f[R] [\f[I]options\f[R]] \f[CB]\-\-module\-path\f[R]
+\f[I]modulepath\f[R] \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R] [,
+\f[I]module\f[R]...]
+.TP
+.B \f[I]options\f[R]
+Command\-line options separated by spaces.
+See \f[B]jlink Options\f[R].
+.RS
+.RE
+.TP
+.B \f[I]modulepath\f[R]
+The path where the \f[CB]jlink\f[R] tool discovers observable modules.
+These modules can be modular JAR files, JMOD files, or exploded modules.
+.RS
+.RE
+.TP
+.B \f[I]module\f[R]
+The names of the modules to add to the runtime image.
+The \f[CB]jlink\f[R] tool adds these modules and their transitive
+dependencies.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jlink\f[R] tool links a set of modules, along with their
+transitive dependences, to create a custom runtime image.
+.PP
+\f[B]Note:\f[R]
+.PP
+Developers are responsible for updating their custom runtime images.
+.SH JLINK OPTIONS
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]mod\f[R] [\f[CB],\f[R] \f[I]mod\f[R]...]
+Adds the named modules, \f[I]mod\f[R], to the default set of root
+modules.
+The default set of root modules is empty.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-bind\-services\f[R]
+Link service provider modules and their dependencies.
+.RS
+.RE
+.TP
+.B \f[CB]\-c\ ={0|1|2}\f[R] or \f[CB]\-\-compress={0|1|2}\f[R]
+Enable compression of resources:
+.RS
+.IP \[bu] 2
+\f[CB]0\f[R]: No compression
+.IP \[bu] 2
+\f[CB]1\f[R]: Constant string sharing
+.IP \[bu] 2
+\f[CB]2\f[R]: ZIP
+.RE
+.TP
+.B \f[CB]\-\-disable\-plugin\f[R] \f[I]pluginname\f[R]
+Disables the specified plug\-in.
+See \f[B]jlink Plug\-ins\f[R] for the list of supported plug\-ins.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-endian\f[R] {\f[CB]little\f[R]|\f[CB]big\f[R]}
+Specifies the byte order of the generated image.
+The default value is the format of your system\[aq]s architecture.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] or \f[CB]\-\-help\f[R]
+Prints the help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-ignore\-signing\-information\f[R]
+Suppresses a fatal error when signed modular JARs are linked in the
+runtime image.
+The signature\-related files of the signed modular JARs aren\[aq]t
+copied to the runtime image.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-launcher\f[R] \f[I]command\f[R]\f[CB]=\f[R]\f[I]module\f[R] or \f[CB]\-\-launcher\f[R] \f[I]command\f[R]\f[CB]=\f[R]\f[I]module\f[R]\f[CB]/\f[R]\f[I]main\f[R]
+Specifies the launcher command name for the module or the command name
+for the module and main class (the module and the main class names are
+separated by a slash (\f[CB]/\f[R])).
+.RS
+.RE
+.TP
+.B \f[CB]\-\-limit\-modules\f[R] \f[I]mod\f[R] [\f[CB],\f[R] \f[I]mod\f[R]...]
+Limits the universe of observable modules to those in the transitive
+closure of the named modules, \f[CB]mod\f[R], plus the main module, if
+any, plus any further modules specified in the \f[CB]\-\-add\-modules\f[R]
+option.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-list\-plugins\f[R]
+Lists available plug\-ins, which you can access through command\-line
+options; see \f[B]jlink Plug\-ins\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-p\f[R] or \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies the module path.
+.RS
+.PP
+If this option is not specified, then the default module path is
+\f[CB]$JAVA_HOME/jmods\f[R].
+This directory contains the \f[CB]java.base\f[R] module and the other
+standard and JDK modules.
+If this option is specified but the \f[CB]java.base\f[R] module cannot be
+resolved from it, then the \f[CB]jlink\f[R] command appends
+\f[CB]$JAVA_HOME/jmods\f[R] to the module path.
+.RE
+.TP
+.B \f[CB]\-\-no\-header\-files\f[R]
+Excludes header files.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-no\-man\-pages\f[R]
+Excludes man pages.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-output\f[R] \f[I]path\f[R]
+Specifies the location of the generated runtime image.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-save\-opts\f[R] \f[I]filename\f[R]
+Saves \f[CB]jlink\f[R] options in the specified file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-suggest\-providers\f[R] [\f[I]name\f[R]\f[CB],\f[R] ...]
+Suggest providers that implement the given service types from the module
+path.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints version information.
+.RS
+.RE
+.TP
+.B \f[CB]\@\f[R]\f[I]filename\f[R]
+Reads options from the specified file.
+.RS
+.PP
+An options file is a text file that contains the options and values that
+you would typically enter in a command prompt.
+Options may appear on one line or on several lines.
+You may not specify environment variables for path names.
+You may comment out lines by prefixing a hash symbol (\f[CB]#\f[R]) to the
+beginning of the line.
+.PP
+The following is an example of an options file for the \f[CB]jlink\f[R]
+command:
+.IP
+.nf
+\f[CB]
+#Wed\ Dec\ 07\ 00:40:19\ EST\ 2016
+\-\-module\-path\ mlib
+\-\-add\-modules\ com.greetings
+\-\-output\ greetingsapp
+\f[R]
+.fi
+.RE
+.SH JLINK PLUG\-INS
+.PP
+\f[B]Note:\f[R]
+.PP
+Plug\-ins not listed in this section aren\[aq]t supported and are
+subject to change.
+.PP
+For plug\-in options that require a \f[I]pattern\-list\f[R], the value is
+a comma\-separated list of elements, with each element using one the
+following forms:
+.IP \[bu] 2
+\f[I]glob\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]glob:\f[R]\f[I]glob\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]regex:\f[R]\f[I]regex\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]\@\f[R]\f[I]filename\f[R]
+.RS 2
+.IP \[bu] 2
+\f[I]filename\f[R] is the name of a file that contains patterns to be
+used, one pattern per line.
+.RE
+.PP
+For a complete list of all available plug\-ins, run the command
+\f[CB]jlink\ \-\-list\-plugins\f[R].
+.SS Plugin \f[CB]compress\f[R]
+.TP
+.B Options
+\f[CB]\-\-compress=\f[R]{\f[CB]0\f[R]|\f[CB]1\f[R]|\f[CB]2\f[R]}[\f[CB]:filter=\f[R]\f[I]pattern\-list\f[R]]
+.RS
+.RE
+.TP
+.B Description
+Compresses all resources in the output image.
+.RS
+.IP \[bu] 2
+Level 0: No compression
+.IP \[bu] 2
+Level 1: Constant string sharing
+.IP \[bu] 2
+Level 2: ZIP
+.PP
+An optional \f[I]pattern\-list\f[R] filter can be specified to list the
+pattern of files to include.
+.RE
+.SS Plugin \f[CB]include\-locales\f[R]
+.TP
+.B Options
+\f[CB]\-\-include\-locales=\f[R]\f[I]langtag\f[R][\f[CB],\f[R]\f[I]langtag\f[R]]*
+.RS
+.RE
+.TP
+.B Description
+Includes the list of locales where \f[I]langtag\f[R] is a BCP 47 language
+tag.
+This option supports locale matching as defined in RFC 4647.
+Ensure that you add the module jdk.localedata when using this option.
+.RS
+.PP
+Example:
+.RS
+.PP
+\f[CB]\-\-add\-modules\ jdk.localedata\ \-\-include\-locales=en,ja,*\-IN\f[R]
+.RE
+.RE
+.SS Plugin \f[CB]order\-resources\f[R]
+.TP
+.B Options
+\f[CB]\-\-order\-resources=\f[R]\f[I]pattern\-list\f[R]
+.RS
+.RE
+.TP
+.B Description
+Orders the specified paths in priority order.
+If \f[CB]\@\f[R]\f[I]filename\f[R] is specified, then each line in
+\f[I]pattern\-list\f[R] must be an exact match for the paths to be
+ordered.
+.RS
+.PP
+Example:
+.RS
+.PP
+\f[CB]\-\-order\-resources=/module\-info.class,\@classlist,/java.base/java/lang/\f[R]
+.RE
+.RE
+.SS Plugin \f[CB]strip\-debug\f[R]
+.TP
+.B Options
+\f[CB]\-\-strip\-debug\f[R]
+.RS
+.RE
+.TP
+.B Description
+Strips debug information from the output image.
+.RS
+.RE
+.SH JLINK EXAMPLES
+.PP
+The following command creates a runtime image in the directory
+\f[CB]greetingsapp\f[R].
+This command links the module \f[CB]com.greetings\f[R], whose module
+definition is contained in the directory \f[CB]mlib\f[R].
+.IP
+.nf
+\f[CB]
+jlink\ \-\-module\-path\ mlib\ \-\-add\-modules\ com.greetings\ \-\-output\ greetingsapp
+\f[R]
+.fi
+.PP
+The following command lists the modules in the runtime image
+\f[CB]greetingsapp\f[R]:
+.IP
+.nf
+\f[CB]
+greetingsapp/bin/java\ \-\-list\-modules
+com.greetings
+java.base\@11
+java.logging\@11
+org.astro\@1.0
+\f[R]
+.fi
+.PP
+The following command creates a runtime image in the directory
+compressedrt that\[aq]s stripped of debug symbols, uses compression to
+reduce space, and includes French language locale information:
+.IP
+.nf
+\f[CB]
+jlink\ \-\-add\-modules\ jdk.localedata\ \-\-strip\-debug\ \-\-compress=2\ \-\-include\-locales=fr\ \-\-output\ compressedrt
+\f[R]
+.fi
+.PP
+The following example compares the size of the runtime image
+\f[CB]compressedrt\f[R] with \f[CB]fr_rt\f[R], which isn\[aq]t stripped of
+debug symbols and doesn\[aq]t use compression:
+.IP
+.nf
+\f[CB]
+jlink\ \-\-add\-modules\ jdk.localedata\ \-\-include\-locales=fr\ \-\-output\ fr_rt
+
+du\ \-sh\ ./compressedrt\ ./fr_rt
+23M\ \ \ \ \ ./compressedrt
+36M\ \ \ \ \ ./fr_rt
+\f[R]
+.fi
+.PP
+The following example lists the providers that implement
+\f[CB]java.security.Provider\f[R]:
+.IP
+.nf
+\f[CB]
+jlink\ \-\-suggest\-providers\ java.security.Provider
+
+Suggested\ providers:
+\ \ java.naming\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ java.security.jgss\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ java.security.sasl\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ java.smartcardio\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ java.xml.crypto\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ jdk.crypto.cryptoki\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ jdk.crypto.ec\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ jdk.crypto.mscapi\ provides\ java.security.Provider\ used\ by\ java.base
+\ \ jdk.security.jgss\ provides\ java.security.Provider\ used\ by\ java.base
+\f[R]
+.fi
+.PP
+The following example creates a custom runtime image named
+\f[CB]mybuild\f[R] that includes only \f[CB]java.naming\f[R] and
+\f[CB]jdk.crypto.cryptoki\f[R] and their dependencies but no other
+providers.
+Note that these dependencies must exist in the module path:
+.IP
+.nf
+\f[CB]
+jlink\ \-\-add\-modules\ java.naming,jdk.crypto.cryptoki\ \-\-output\ mybuild
+\f[R]
+.fi
+.PP
+The following command is similar to the one that creates a runtime image
+named \f[CB]greetingsapp\f[R], except that it will link the modules
+resolved from root modules with service binding; see the
+\f[B]\f[BC]Configuration.resolveAndBind\f[B]\f[R] method.
+.IP
+.nf
+\f[CB]
+jlink\ \-\-module\-path\ mlib\ \-\-add\-modules\ com.greetings\ \-\-output\ greetingsapp\ \-\-bind\-services
+\f[R]
+.fi
+.PP
+The following command lists the modules in the runtime image
+greetingsapp created by this command:
+.IP
+.nf
+\f[CB]
+greetingsapp/bin/java\ \-\-list\-modules
+com.greetings
+java.base\@11
+java.compiler\@11
+java.datatransfer\@11
+java.desktop\@11
+java.logging\@11
+java.management\@11
+java.management.rmi\@11
+java.naming\@11
+java.prefs\@11
+java.rmi\@11
+java.security.jgss\@11
+java.security.sasl\@11
+java.smartcardio\@11
+java.xml\@11
+java.xml.crypto\@11
+jdk.accessibility\@11
+jdk.charsets\@11
+jdk.compiler\@11
+jdk.crypto.cryptoki\@11
+jdk.crypto.ec\@11
+jdk.crypto.mscapi\@11
+jdk.internal.opt\@11
+jdk.jartool\@11
+jdk.javadoc\@11
+jdk.jdeps\@11
+jdk.jfr\@11
+jdk.jlink\@11
+jdk.localedata\@11
+jdk.management\@11
+jdk.management.jfr\@11
+jdk.naming.dns\@11
+jdk.naming.rmi\@11
+jdk.security.auth\@11
+jdk.security.jgss\@11
+jdk.zipfs\@11
+org.astro\@1.0
+\f[R]
+.fi
diff --git a/java/temurin-17/man/man1/jmap.1 b/java/temurin-17/man/man1/jmap.1
new file mode 100644
index 0000000..d58aac7
--- /dev/null
+++ b/java/temurin-17/man/man1/jmap.1
@@ -0,0 +1,101 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JMAP" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jmap \- print details of a specified process
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jmap\f[R] [\f[I]options\f[R]] \f[I]pid\f[R]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jmap\f[R] command\-line options.
+See \f[B]Options for the jmap Command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]pid\f[R]
+The process ID for which the information specified by the
+\f[I]options\f[R] is to be printed.
+The process must be a Java process.
+To get a list of Java processes running on a machine, use either the
+\f[CB]ps\f[R] command or, if the JVM processes are not running in a
+separate docker instance, the \f[B]jps\f[R] command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jmap\f[R] command prints details of a specified running process.
+.PP
+\f[B]Note:\f[R]
+.PP
+This command is unsupported and might not be available in future
+releases of the JDK.
+On Windows Systems where the \f[CB]dbgeng.dll\f[R] file isn\[aq]t present,
+the Debugging Tools for Windows must be installed to make these tools
+work.
+The \f[CB]PATH\f[R] environment variable should contain the location of
+the \f[CB]jvm.dll\f[R] file that\[aq]s used by the target process or the
+location from which the core dump file was produced.
+.SH OPTIONS FOR THE JMAP COMMAND
+.TP
+.B \f[CB]\-clstats\f[R] \f[I]pid\f[R]
+Connects to a running process and prints class loader statistics of Java
+heap.
+.RS
+.RE
+.TP
+.B \f[CB]\-finalizerinfo\f[R] \f[I]pid\f[R]
+Connects to a running process and prints information on objects awaiting
+finalization.
+.RS
+.RE
+.TP
+.B \f[CB]\-histo\f[R][\f[CB]:live\f[R]] \f[I]pid\f[R]
+Connects to a running process and prints a histogram of the Java object
+heap.
+If the \f[CB]live\f[R] suboption is specified, it then counts only live
+objects.
+.RS
+.RE
+.TP
+.B \f[CB]\-dump:\f[R]\f[I]dump_options\f[R] \f[I]pid\f[R]
+Connects to a running process and dumps the Java heap.
+The \f[I]dump_options\f[R] include:
+.RS
+.IP \[bu] 2
+\f[CB]live\f[R] \-\-\- When specified, dumps only the live objects; if not
+specified, then dumps all objects in the heap.
+.IP \[bu] 2
+\f[CB]format=b\f[R] \-\-\- Dumps the Java heap in \f[CB]hprof\f[R] binary
+format
+.IP \[bu] 2
+\f[CB]file=\f[R]\f[I]filename\f[R] \-\-\- Dumps the heap to
+\f[I]filename\f[R]
+.PP
+Example: \f[CB]jmap\ \-dump:live,format=b,file=heap.bin\f[R] \f[I]pid\f[R]
+.RE
diff --git a/java/temurin-17/man/man1/jmod.1 b/java/temurin-17/man/man1/jmod.1
new file mode 100644
index 0000000..0ac0647
--- /dev/null
+++ b/java/temurin-17/man/man1/jmod.1
@@ -0,0 +1,439 @@
+.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JMOD" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jmod \- create JMOD files and list the content of existing JMOD files
+.SH SYNOPSIS
+.PP
+\f[CB]jmod\f[R]
+(\f[CB]create\f[R]|\f[CB]extract\f[R]|\f[CB]list\f[R]|\f[CB]describe\f[R]|\f[CB]hash\f[R])
+[\f[I]options\f[R]] \f[I]jmod\-file\f[R]
+.PP
+Includes the following:
+.PP
+\f[B]Main operation modes\f[R]
+.TP
+.B \f[CB]create\f[R]
+Creates a new JMOD archive file.
+.RS
+.RE
+.TP
+.B \f[CB]extract\f[R]
+Extracts all the files from the JMOD archive file.
+.RS
+.RE
+.TP
+.B \f[CB]list\f[R]
+Prints the names of all the entries.
+.RS
+.RE
+.TP
+.B \f[CB]describe\f[R]
+Prints the module details.
+.RS
+.RE
+.TP
+.B \f[CB]hash\f[R]
+Determines leaf modules and records the hashes of the dependencies that
+directly and indirectly require them.
+.RS
+.RE
+.PP
+\f[B]Options\f[R]
+.TP
+.B \f[I]options\f[R]
+See \f[B]Options for jmod\f[R].
+.RS
+.RE
+.PP
+\f[B]Required\f[R]
+.TP
+.B \f[I]jmod\-file\f[R]
+Specifies the name of the JMOD file to create or from which to retrieve
+information.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+\f[B]Note:\f[R] For most development tasks, including deploying modules
+on the module path or publishing them to a Maven repository, continue to
+package modules in modular JAR files.
+The \f[CB]jmod\f[R] tool is intended for modules that have native
+libraries or other configuration files or for modules that you intend to
+link, with the \f[B]jlink\f[R] tool, to a runtime image.
+.PP
+The JMOD file format lets you aggregate files other than
+\f[CB]\&.class\f[R] files, metadata, and resources.
+This format is transportable but not executable, which means that you
+can use it during compile time or link time but not at run time.
+.PP
+Many \f[CB]jmod\f[R] options involve specifying a path whose contents are
+copied into the resulting JMOD files.
+These options copy all the contents of the specified path, including
+subdirectories and their contents, but exclude files whose names match
+the pattern specified by the \f[CB]\-\-exclude\f[R] option.
+.PP
+With the \f[CB]\-\-hash\-modules\f[R] option or the \f[CB]jmod\ hash\f[R]
+command, you can, in each module\[aq]s descriptor, record hashes of the
+content of the modules that are allowed to depend upon it, thus "tying"
+together these modules.
+This enables a package to be exported to one or more specifically\-named
+modules and to no others through qualified exports.
+The runtime verifies if the recorded hash of a module matches the one
+resolved at run time; if not, the runtime returns an error.
+.SH OPTIONS FOR JMOD
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the location of application JAR files or a directory
+containing classes to copy into the resulting JMOD file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-cmds\f[R] \f[I]path\f[R]
+Specifies the location of native commands to copy into the resulting
+JMOD file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-config\f[R] \f[I]path\f[R]
+Specifies the location of user\-editable configuration files to copy
+into the resulting JMOD file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dir\f[R] \f[I]path\f[R]
+Specifies the location where \f[CB]jmod\f[R] puts extracted files from the
+specified JMOD archive.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dry\-run\f[R]
+Performs a dry run of hash mode.
+It identifies leaf modules and their required modules without recording
+any hash values.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-exclude\f[R] \f[I]pattern\-list\f[R]
+Excludes files matching the supplied comma\-separated pattern list, each
+element using one the following forms:
+.RS
+.IP \[bu] 2
+\f[I]glob\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]glob:\f[R]\f[I]glob\-pattern\f[R]
+.IP \[bu] 2
+\f[CB]regex:\f[R]\f[I]regex\-pattern\f[R]
+.PP
+See the \f[B]\f[BC]FileSystem.getPathMatcher\f[B]\f[R] method for the
+syntax of \f[I]glob\-pattern\f[R].
+See the \f[B]\f[BC]Pattern\f[B]\f[R] class for the syntax of
+\f[I]regex\-pattern\f[R], which represents a regular expression.
+.RE
+.TP
+.B \f[CB]\-\-hash\-modules\f[R] \f[I]regex\-pattern\f[R]
+Determines the leaf modules and records the hashes of the dependencies
+directly and indirectly requiring them, based on the module graph of the
+modules matching the given \f[I]regex\-pattern\f[R].
+The hashes are recorded in the JMOD archive file being created, or a
+JMOD archive or modular JAR on the module path specified by the
+\f[CB]jmod\ hash\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-header\-files\f[R] \f[I]path\f[R]
+Specifies the location of header files to copy into the resulting JMOD
+file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R]
+Prints a usage message.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R]
+Prints help for extra options.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-legal\-notices\f[R] \f[I]path\f[R]
+Specifies the location of legal notices to copy into the resulting JMOD
+file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-libs\f[R] \f[I]path\f[R]
+Specifies location of native libraries to copy into the resulting JMOD
+file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-main\-class\f[R] \f[I]class\-name\f[R]
+Specifies main class to record in the module\-info.class file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-man\-pages\f[R] \f[I]path\f[R]
+Specifies the location of man pages to copy into the resulting JMOD
+file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-version\f[R] \f[I]module\-version\f[R]
+Specifies the module version to record in the module\-info.class file.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]path\f[R] or \f[CB]\-p\f[R] \f[I]path\f[R]
+Specifies the module path.
+This option is required if you also specify \f[CB]\-\-hash\-modules\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-target\-platform\f[R] \f[I]platform\f[R]
+Specifies the target platform.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints version information of the \f[CB]jmod\f[R] tool.
+.RS
+.RE
+.TP
+.B \f[CB]\@\f[R]\f[I]filename\f[R]
+Reads options from the specified file.
+.RS
+.PP
+An options file is a text file that contains the options and values that
+you would ordinarily enter in a command prompt.
+Options may appear on one line or on several lines.
+You may not specify environment variables for path names.
+You may comment out lines by prefixinga hash symbol (\f[CB]#\f[R]) to the
+beginning of the line.
+.PP
+The following is an example of an options file for the \f[CB]jmod\f[R]
+command:
+.IP
+.nf
+\f[CB]
+#Wed\ Dec\ 07\ 00:40:19\ EST\ 2016
+create\ \-\-class\-path\ mods/com.greetings\ \-\-module\-path\ mlib
+\ \ \-\-cmds\ commands\ \-\-config\ configfiles\ \-\-header\-files\ src/h
+\ \ \-\-libs\ lib\ \-\-main\-class\ com.greetings.Main
+\ \ \-\-man\-pages\ man\ \-\-module\-version\ 1.0
+\ \ \-\-os\-arch\ "x86_x64"\ \-\-os\-name\ "Mac\ OS\ X"
+\ \ \-\-os\-version\ "10.10.5"\ greetingsmod
+\f[R]
+.fi
+.RE
+.SH EXTRA OPTIONS FOR JMOD
+.PP
+In addition to the options described in \f[B]Options for jmod\f[R], the
+following are extra options that can be used with the command.
+.TP
+.B \f[CB]\-\-do\-not\-resolve\-by\-default\f[R]
+Exclude from the default root set of modules
+.RS
+.RE
+.TP
+.B \f[CB]\-\-warn\-if\-resolved\f[R]
+Hint for a tool to issue a warning if the module is resolved.
+One of deprecated, deprecated\-for\-removal, or incubating.
+.RS
+.RE
+.SH JMOD CREATE EXAMPLE
+.PP
+The following is an example of creating a JMOD file:
+.IP
+.nf
+\f[CB]
+jmod\ create\ \-\-class\-path\ mods/com.greetings\ \-\-cmds\ commands
+\ \ \-\-config\ configfiles\ \-\-header\-files\ src/h\ \-\-libs\ lib
+\ \ \-\-main\-class\ com.greetings.Main\ \-\-man\-pages\ man\ \-\-module\-version\ 1.0
+\ \ \-\-os\-arch\ "x86_x64"\ \-\-os\-name\ "Mac\ OS\ X"
+\ \ \-\-os\-version\ "10.10.5"\ greetingsmod
+\f[R]
+.fi
+.SH JMOD HASH EXAMPLE
+.PP
+The following example demonstrates what happens when you try to link a
+leaf module (in this example, \f[CB]ma\f[R]) with a required module
+(\f[CB]mb\f[R]), and the hash value recorded in the required module
+doesn\[aq]t match that of the leaf module.
+.IP "1." 3
+Create and compile the following \f[CB]\&.java\f[R] files:
+.RS 4
+.IP \[bu] 2
+\f[CB]jmodhashex/src/ma/module\-info.java\f[R]
+.RS 2
+.IP
+.nf
+\f[CB]
+module\ ma\ {
+\ \ requires\ mb;
+}
+\f[R]
+.fi
+.RE
+.IP \[bu] 2
+\f[CB]jmodhashex/src/mb/module\-info.java\f[R]
+.RS 2
+.IP
+.nf
+\f[CB]
+module\ mb\ {
+}
+\f[R]
+.fi
+.RE
+.IP \[bu] 2
+\f[CB]jmodhashex2/src/ma/module\-info.java\f[R]
+.RS 2
+.IP
+.nf
+\f[CB]
+module\ ma\ {
+\ \ requires\ mb;
+}
+\f[R]
+.fi
+.RE
+.IP \[bu] 2
+\f[CB]jmodhashex2/src/mb/module\-info.java\f[R]
+.RS 2
+.IP
+.nf
+\f[CB]
+module\ mb\ {
+}
+\f[R]
+.fi
+.RE
+.RE
+.IP "2." 3
+Create a JMOD archive for each module.
+Create the directories \f[CB]jmodhashex/jmods\f[R] and
+\f[CB]jmodhashex2/jmods\f[R], and then run the following commands from the
+\f[CB]jmodhashex\f[R] directory, then from the \f[CB]jmodhashex2\f[R]
+directory:
+.RS 4
+.IP \[bu] 2
+\f[CB]jmod\ create\ \-\-class\-path\ mods/ma\ jmods/ma.jmod\f[R]
+.IP \[bu] 2
+\f[CB]jmod\ create\ \-\-class\-path\ mods/mb\ jmods/mb.jmod\f[R]
+.RE
+.IP "3." 3
+Optionally preview the \f[CB]jmod\ hash\f[R] command.
+Run the following command from the \f[CB]jmodhashex\f[R] directory:
+.RS 4
+.PP
+\f[CB]jmod\ hash\ \-\-dry\-run\ \-module\-path\ jmods\ \-\-hash\-modules\ .*\f[R]
+.PP
+The command prints the following:
+.IP
+.nf
+\f[CB]
+Dry\ run:
+mb
+\ \ hashes\ ma\ SHA\-256\ 07667d5032004b37b42ec2bb81b46df380cf29e66962a16481ace2e71e74073a
+\f[R]
+.fi
+.PP
+This indicates that the \f[CB]jmod\ hash\f[R] command (without the
+\f[CB]\-\-dry\-run\f[R] option) will record the hash value of the leaf
+module \f[CB]ma\f[R] in the module \f[CB]mb\f[R].
+.RE
+.IP "4." 3
+Record hash values in the JMOD archive files contained in the
+\f[CB]jmodhashex\f[R] directory.
+Run the following command from the \f[CB]jmodhashex\f[R] directory:
+.RS 4
+.RS
+.PP
+\f[CB]jmod\ hash\ \-\-module\-path\ jmods\ \-\-hash\-modules\ .*\f[R]
+.RE
+.PP
+The command prints the following:
+.RS
+.PP
+\f[CB]Hashes\ are\ recorded\ in\ module\ mb\f[R]
+.RE
+.RE
+.IP "5." 3
+Print information about each JMOD archive contained in the
+\f[CB]jmodhashex\f[R] directory.
+Run the highlighted commands from the \f[CB]jmodhashex\f[R] directory:
+.RS 4
+.IP
+.nf
+\f[CB]
+jmod\ describe\ jmods/ma.jmod
+
+ma
+\ \ requires\ mandated\ java.base
+\ \ requires\ mb
+
+jmod\ describe\ jmods/mb.jmod
+
+mb
+\ \ requires\ mandated\ java.base
+\ \ hashes\ ma\ SHA\-256\ 07667d5032004b37b42ec2bb81b46df380cf29e66962a16481ace2e71e74073a
+\f[R]
+.fi
+.RE
+.IP "6." 3
+Attempt to create a runtime image that contains the module \f[CB]ma\f[R]
+from the directory \f[CB]jmodhashex2\f[R] but the module \f[CB]mb\f[R] from
+the directory \f[CB]jmodhashex\f[R].
+Run the following command from the \f[CB]jmodhashex2\f[R] directory:
+.RS 4
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]jlink\ \-\-module\-path\ $JAVA_HOME/jmods:jmods/ma.jmod:../jmodhashex/jmods/mb.jmod\ \-\-add\-modules\ ma\ \-\-output\ ma\-app\f[R]
+.RE
+.RE
+.IP \[bu] 2
+\f[B]Windows:\f[R]
+.RS 2
+.RS
+.PP
+\f[CB]jlink\ \-\-module\-path\ %JAVA_HOME%/jmods;jmods/ma.jmod;../jmodhashex/jmods/mb.jmod\ \-\-add\-modules\ ma\ \-\-output\ ma\-app\f[R]
+.RE
+.RE
+.PP
+The command prints an error message similar to the following:
+.IP
+.nf
+\f[CB]
+Error:\ Hash\ of\ ma\ (a2d77889b0cb067df02a3abc39b01ac1151966157a68dc4241562c60499150d2)\ differs\ to
+expected\ hash\ (07667d5032004b37b42ec2bb81b46df380cf29e66962a16481ace2e71e74073a)\ recorded\ in\ mb
+\f[R]
+.fi
+.RE
diff --git a/java/temurin-17/man/man1/jpackage.1 b/java/temurin-17/man/man1/jpackage.1
new file mode 100644
index 0000000..eeefbfb
--- /dev/null
+++ b/java/temurin-17/man/man1/jpackage.1
@@ -0,0 +1,525 @@
+.\" Copyright (c) 2018, 2021, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JPACKAGE" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jpackage \- tool for packaging self\-contained Java applications.
+.SH SYNOPSIS
+.PP
+\f[CB]jpackage\f[R] [\f[I]options\f[R]]
+.TP
+.B \f[I]options\f[R]
+Command\-line options separated by spaces.
+See \f[B]jpackage Options\f[R].
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jpackage\f[R] tool will take as input a Java application and a
+Java run\-time image, and produce a Java application image that includes
+all the necessary dependencies.
+It will be able to produce a native package in a platform\-specific
+format, such as an exe on Windows or a dmg on macOS.
+Each format must be built on the platform it runs on, there is no
+cross\-platform support.
+The tool will have options that allow packaged applications to be
+customized in various ways.
+.SH JPACKAGE OPTIONS
+.SS Generic Options:
+.TP
+.B \f[CB]\@\f[R]\f[I]filename\f[R]
+Read options from a file.
+.RS
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-type\f[R] or \f[CB]\-t\f[R] <type string>
+The type of package to create
+.RS
+.PP
+Valid values are: {"app\-image", "exe", "msi", "rpm", "deb", "pkg",
+"dmg"}
+.PP
+If this option is not specified a platform dependent default type will
+be created.
+.RE
+.TP
+.B \f[CB]\-\-app\-version\f[R] <version>
+Version of the application and/or package
+.RS
+.RE
+.TP
+.B \f[CB]\-\-copyright\f[R] <copyright string>
+Copyright for the application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-description\f[R] <description string>
+Description of the application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R]
+Print the usage text with a list and description of each valid option
+for the current platform to the output stream, and exit.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-icon\f[R] <icon file path>
+Path of the icon of the application package (absolute path or relative
+to the current directory)
+.RS
+.RE
+.TP
+.B \f[CB]\-\-name\f[R] or \f[CB]\-n\f[R] <name>
+Name of the application and/or package
+.RS
+.RE
+.TP
+.B \f[CB]\-\-dest\f[R] or \f[CB]\-d\f[R] <output path>
+Path where generated output file is placed
+.RS
+.PP
+Defaults to the current working directory.
+(absolute path or relative to the current directory).
+.RE
+.TP
+.B \f[CB]\-\-temp\f[R] <directory path>
+Path of a new or empty directory used to create temporary files
+(absolute path or relative to the current directory)
+.RS
+.PP
+If specified, the temp dir will not be removed upon the task completion
+and must be removed manually.
+.PP
+If not specified, a temporary directory will be created and removed upon
+the task completion.
+.RE
+.TP
+.B \f[CB]\-\-vendor\f[R] <vendor string>
+Vendor of the application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-verbose\f[R]
+Enables verbose output.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Print the product version to the output stream and exit.
+.RS
+.RE
+.SS Options for creating the runtime image:
+.TP
+.B \f[CB]\-\-add\-modules\f[R] <module name> [\f[CB],\f[R]<module name>...]
+A comma (",") separated list of modules to add
+.RS
+.PP
+This module list, along with the main module (if specified) will be
+passed to jlink as the \-\-add\-module argument.
+If not specified, either just the main module (if \-\-module is
+specified), or the default set of modules (if \-\-main\-jar is
+specified) are used.
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] or \f[CB]\-p\f[R] <module path>...
+A File.pathSeparator separated list of paths
+.RS
+.PP
+Each path is either a directory of modules or the path to a modular jar,
+and is absolute or relative to the current directory.
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-jlink\-options\f[R] <jlink options>
+A space separated list of options to pass to jlink
+.RS
+.PP
+If not specified, defaults to "\-\-strip\-native\-commands
+\-\-strip\-debug \-\-no\-man\-pages \-\-no\-header\-files"
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-runtime\-image\f[R] <directory path>
+Path of the predefined runtime image that will be copied into the
+application image (absolute path or relative to the current directory)
+.RS
+.PP
+If \-\-runtime\-image is not specified, jpackage will run jlink to
+create the runtime image using options specified by \-\-jlink\-options.
+.RE
+.SS Options for creating the application image:
+.TP
+.B \f[CB]\-\-input\f[R] or \f[CB]\-i\f[R] <input path>
+Path of the input directory that contains the files to be packaged
+(absolute path or relative to the current directory)
+.RS
+.PP
+All files in the input directory will be packaged into the application
+image.
+.RE
+.SS Options for creating the application launcher(s):
+.TP
+.B \f[CB]\-\-add\-launcher\f[R] <launcher name>=<file path>
+Name of launcher, and a path to a Properties file that contains a list
+of key, value pairs (absolute path or relative to the current directory)
+.RS
+.PP
+The keys "module", "main\-jar", "main\-class", "arguments",
+"java\-options", "app\-version", "icon", "linux\-app\-category",
+"linux\-app\-release", and "win\-console" can be used.
+.PP
+These options are added to, or used to overwrite, the original command
+line options to build an additional alternative launcher.
+The main application launcher will be built from the command line
+options.
+Additional alternative launchers can be built using this option, and
+this option can be used multiple times to build multiple additional
+launchers.
+.RE
+.TP
+.B \f[CB]\-\-arguments\f[R] <main class arguments>
+Command line arguments to pass to the main class if no command line
+arguments are given to the launcher
+.RS
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-java\-options\f[R] <java options>
+Options to pass to the Java runtime
+.RS
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-main\-class\f[R] <class name>
+Qualified name of the application main class to execute
+.RS
+.PP
+This option can only be used if \-\-main\-jar is specified.
+.RE
+.TP
+.B \f[CB]\-\-main\-jar\f[R] <main jar file>
+The main JAR of the application; containing the main class (specified as
+a path relative to the input path)
+.RS
+.PP
+Either \-\-module or \-\-main\-jar option can be specified but not both.
+.RE
+.TP
+.B \f[CB]\-\-module\f[R] or \f[CB]\-m\f[R] <module name>/<main class>]
+The main module (and optionally main class) of the application
+.RS
+.PP
+This module must be located on the module path.
+.PP
+When this option is specified, the main module will be linked in the
+Java runtime image.
+Either \-\-module or \-\-main\-jar option can be specified but not both.
+.RE
+.SS Platform dependent option for creating the application launcher:
+.SS Windows platform options (available only when running on Windows):
+.TP
+.B \f[CB]\-\-win\-console\f[R]
+Creates a console launcher for the application, should be specified for
+application which requires console interactions
+.RS
+.RE
+.SS macOS platform options (available only when running on macOS):
+.TP
+.B \f[CB]\-\-mac\-package\-identifier\f[R] <ID string>
+An identifier that uniquely identifies the application for macOS
+.RS
+.PP
+Defaults to the the main class name.
+.PP
+May only use alphanumeric (A\-Z,a\-z,0\-9), hyphen (\-), and period (.)
+characters.
+.RE
+.TP
+.B \f[CB]\-\-mac\-package\-name\f[R] <name string>
+Name of the application as it appears in the Menu Bar
+.RS
+.PP
+This can be different from the application name.
+.PP
+This name must be less than 16 characters long and be suitable for
+displaying in the menu bar and the application Info window.
+Defaults to the application name.
+.RE
+.TP
+.B \f[CB]\-\-mac\-package\-signing\-prefix\f[R] <prefix string>
+When signing the application package, this value is prefixed to all
+components that need to be signed that don\[aq]t have an existing
+package identifier.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-sign\f[R]
+Request that the bundle be signed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-signing\-keychain\f[R] <keychain name>
+Name of the keychain to search for the signing identity
+.RS
+.PP
+If not specified, the standard keychains are used.
+.RE
+.TP
+.B \f[CB]\-\-mac\-signing\-key\-user\-name\f[R] <team name>
+Team or user name portion in Apple signing identities
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-app\-store\f[R]
+Indicates that the jpackage output is intended for the Mac App Store.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-entitlements\f[R] <file path>
+Path to file containing entitlements to use when signing executables and
+libraries in the bundle
+.RS
+.RE
+.TP
+.B \f[CB]\-\-mac\-app\-category\f[R] <category string>
+String used to construct LSApplicationCategoryType in application plist
+.RS
+.PP
+The default value is "utilities".
+.RE
+.SS Options for creating the application package:
+.TP
+.B \f[CB]\-\-about\-url\f[R] <url>
+URL of the application\[aq]s home page
+.RS
+.RE
+.TP
+.B \f[CB]\-\-app\-image\f[R] <directory path>
+Location of the predefined application image that is used to build an
+installable package
+.RS
+.PP
+(absolute path or relative to the current directory).
+.PP
+See create\-app\-image mode options to create the application image.
+.RE
+.TP
+.B \f[CB]\-\-file\-associations\f[R] <file path>
+Path to a Properties file that contains list of key, value pairs
+(absolute path or relative to the current directory)
+.RS
+.PP
+The keys "extension", "mime\-type", "icon", and "description" can be
+used to describe the association.
+.PP
+This option can be used multiple times.
+.RE
+.TP
+.B \f[CB]\-\-install\-dir\f[R] <directory path>
+Absolute path of the installation directory of the application (on macos
+or linux), or relative sub\-path of the installation directory such as
+"Program Files" or "AppData" (on Windows)
+.RS
+.RE
+.TP
+.B \f[CB]\-\-license\-file\f[R] <file path>
+Path to the license file (absolute path or relative to the current
+directory)
+.RS
+.RE
+.TP
+.B \f[CB]\-\-resource\-dir\f[R] <directory path>
+Path to override jpackage resources (absolute path or relative to the
+current directory)
+.RS
+.PP
+Icons, template files, and other resources of jpackage can be
+over\-ridden by adding replacement resources to this directory.
+.RE
+.TP
+.B \f[CB]\-\-runtime\-image\f[R] <directory path>
+Path of the predefined runtime image to install (absolute path or
+relative to the current directory)
+.RS
+.PP
+Option is required when creating a runtime installer.
+.RE
+.SS Platform dependent options for creating the application package:
+.SS Windows platform options (available only when running on Windows):
+.TP
+.B \f[CB]\-\-win\-dir\-chooser\f[R]
+Adds a dialog to enable the user to choose a directory in which the
+product is installed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-help\-url\f[R] <url>
+URL where user can obtain further information or technical support
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-menu\f[R]
+Request to add a Start Menu shortcut for this application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-menu\-group\f[R] <menu group name>
+Start Menu group this application is placed in
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-per\-user\-install\f[R]
+Request to perform an install on a per\-user basis
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-shortcut\f[R]
+Request to create a desktop shortcut for this application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-shortcut\-prompt\f[R]
+Adds a dialog to enable the user to choose if shortcuts will be created
+by installer
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-update\-url\f[R] <url>
+URL of available application update information
+.RS
+.RE
+.TP
+.B \f[CB]\-\-win\-upgrade\-uuid\f[R] <id string>
+UUID associated with upgrades for this package
+.RS
+.RE
+.SS Linux platform options (available only when running on Linux):
+.TP
+.B \f[CB]\-\-linux\-package\-name\f[R] <package name>
+Name for Linux package
+.RS
+.PP
+Defaults to the application name.
+.RE
+.TP
+.B \f[CB]\-\-linux\-deb\-maintainer\f[R] <email address>
+Maintainer for .deb bundle
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-menu\-group\f[R] <menu\-group\-name>
+Menu group this application is placed in
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-package\-deps\f[R]
+Required packages or capabilities for the application
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-rpm\-license\-type\f[R] <type string>
+Type of the license ("License: <value>" of the RPM .spec)
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-app\-release\f[R] <release string>
+Release value of the RPM <name>.spec file or Debian revision value of
+the DEB control file
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-app\-category\f[R] <category string>
+Group value of the RPM <name>.spec file or Section value of DEB control
+file
+.RS
+.RE
+.TP
+.B \f[CB]\-\-linux\-shortcut\f[R]
+Creates a shortcut for the application.
+.RS
+.RE
+.SH JPACKAGE EXAMPLES
+.IP
+.nf
+\f[CB]
+Generate\ an\ application\ package\ suitable\ for\ the\ host\ system:
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+For\ a\ modular\ application:
+\ \ \ \ jpackage\ \-n\ name\ \-p\ modulePath\ \-m\ moduleName/className
+For\ a\ non\-modular\ application:
+\ \ \ \ jpackage\ \-i\ inputDir\ \-n\ name\ \\
+\ \ \ \ \ \ \ \ \-\-main\-class\ className\ \-\-main\-jar\ myJar.jar
+From\ a\ pre\-built\ application\ image:
+\ \ \ \ jpackage\ \-n\ name\ \-\-app\-image\ appImageDir
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+Generate\ an\ application\ image:
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+For\ a\ modular\ application:
+\ \ \ \ jpackage\ \-\-type\ app\-image\ \-n\ name\ \-p\ modulePath\ \\
+\ \ \ \ \ \ \ \ \-m\ moduleName/className
+For\ a\ non\-modular\ application:
+\ \ \ \ jpackage\ \-\-type\ app\-image\ \-i\ inputDir\ \-n\ name\ \\
+\ \ \ \ \ \ \ \ \-\-main\-class\ className\ \-\-main\-jar\ myJar.jar
+To\ provide\ your\ own\ options\ to\ jlink,\ run\ jlink\ separately:
+\ \ \ \ jlink\ \-\-output\ appRuntimeImage\ \-p\ modulePath\ \\
+\ \ \ \ \ \ \ \ \-\-add\-modules\ moduleName\ \\
+\ \ \ \ \ \ \ \ \-\-no\-header\-files\ [<additional\ jlink\ options>...]
+\ \ \ \ jpackage\ \-\-type\ app\-image\ \-n\ name\ \\
+\ \ \ \ \ \ \ \ \-m\ moduleName/className\ \-\-runtime\-image\ appRuntimeImage
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+Generate\ a\ Java\ runtime\ package:
+\f[R]
+.fi
+.IP
+.nf
+\f[CB]
+jpackage\ \-n\ name\ \-\-runtime\-image\ <runtime\-image>
+\f[R]
+.fi
diff --git a/java/temurin-17/man/man1/jps.1 b/java/temurin-17/man/man1/jps.1
new file mode 100644
index 0000000..20a8ddd
--- /dev/null
+++ b/java/temurin-17/man/man1/jps.1
@@ -0,0 +1,233 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JPS" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jps \- list the instrumented JVMs on the target system
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jps\f[R] [\f[CB]\-q\f[R]] [\f[CB]\-mlvV\f[R]] [\f[I]hostid\f[R]]
+.PP
+\f[CB]jps\f[R] [\f[CB]\-help\f[R]]
+.SH OPTIONS
+.TP
+.B \f[CB]\-q\f[R]
+Suppresses the output of the class name, JAR file name, and arguments
+passed to the \f[CB]main\f[R] method, producing a list of only local JVM
+identifiers.
+.RS
+.RE
+.TP
+.B \f[CB]\-mlvV\f[R]
+You can specify any combination of these options.
+.RS
+.IP \[bu] 2
+\f[CB]\-m\f[R] displays the arguments passed to the \f[CB]main\f[R] method.
+The output may be \f[CB]null\f[R] for embedded JVMs.
+.IP \[bu] 2
+\f[CB]\-l\f[R] displays the full package name for the application\[aq]s
+\f[CB]main\f[R] class or the full path name to the application\[aq]s JAR
+file.
+.IP \[bu] 2
+\f[CB]\-v\f[R] displays the arguments passed to the JVM.
+.IP \[bu] 2
+\f[CB]\-V\f[R] suppresses the output of the class name, JAR file name, and
+arguments passed to the \f[CB]main\f[R] method, producing a list of only
+local JVM identifiers.
+.RE
+.TP
+.B \f[I]hostid\f[R]
+The identifier of the host for which the process report should be
+generated.
+The \f[CB]hostid\f[R] can include optional components that indicate the
+communications protocol, port number, and other implementation specific
+data.
+See \f[B]Host Identifier\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-help\f[R]
+Displays the help message for the \f[CB]jps\f[R] command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jps\f[R] command lists the instrumented Java HotSpot VMs on the
+target system.
+The command is limited to reporting information on JVMs for which it has
+the access permissions.
+.PP
+If the \f[CB]jps\f[R] command is run without specifying a \f[CB]hostid\f[R],
+then it searches for instrumented JVMs on the local host.
+If started with a \f[CB]hostid\f[R], then it searches for JVMs on the
+indicated host, using the specified protocol and port.
+A \f[CB]jstatd\f[R] process is assumed to be running on the target host.
+.PP
+The \f[CB]jps\f[R] command reports the local JVM identifier, or
+\f[CB]lvmid\f[R], for each instrumented JVM found on the target system.
+The \f[CB]lvmid\f[R] is typically, but not necessarily, the operating
+system\[aq]s process identifier for the JVM process.
+With no options, the \f[CB]jps\f[R] command lists each Java
+application\[aq]s \f[CB]lvmid\f[R] followed by the short form of the
+application\[aq]s class name or jar file name.
+The short form of the class name or JAR file name omits the class\[aq]s
+package information or the JAR files path information.
+.PP
+The \f[CB]jps\f[R] command uses the Java launcher to find the class name
+and arguments passed to the main method.
+If the target JVM is started with a custom launcher, then the class or
+JAR file name, and the arguments to the \f[CB]main\f[R] method aren\[aq]t
+available.
+In this case, the \f[CB]jps\f[R] command outputs the string
+\f[CB]Unknown\f[R] for the class name, or JAR file name, and for the
+arguments to the \f[CB]main\f[R] method.
+.PP
+The list of JVMs produced by the \f[CB]jps\f[R] command can be limited by
+the permissions granted to the principal running the command.
+The command lists only the JVMs for which the principal has access
+rights as determined by operating system\-specific access control
+mechanisms.
+.SH HOST IDENTIFIER
+.PP
+The host identifier, or \f[CB]hostid\f[R], is a string that indicates the
+target system.
+The syntax of the \f[CB]hostid\f[R] string corresponds to the syntax of a
+URI:
+.RS
+.PP
+[\f[I]protocol\f[R]\f[CB]:\f[R]][[\f[CB]//\f[R]]\f[I]hostname\f[R]][\f[CB]:\f[R]\f[I]port\f[R]][\f[CB]/\f[R]\f[I]servername\f[R]]
+.RE
+.TP
+.B \f[I]protocol\f[R]
+The communications protocol.
+If the \f[I]protocol\f[R] is omitted and a \f[I]hostname\f[R] isn\[aq]t
+specified, then the default protocol is a platform\-specific, optimized,
+local protocol.
+If the protocol is omitted and a host name is specified, then the
+default protocol is \f[CB]rmi\f[R].
+.RS
+.RE
+.TP
+.B \f[I]hostname\f[R]
+A host name or IP address that indicates the target host.
+If you omit the \f[I]hostname\f[R] parameter, then the target host is the
+local host.
+.RS
+.RE
+.TP
+.B \f[I]port\f[R]
+The default port for communicating with the remote server.
+If the \f[I]hostname\f[R] parameter is omitted or the \f[I]protocol\f[R]
+parameter specifies an optimized, local protocol, then the \f[I]port\f[R]
+parameter is ignored.
+Otherwise, treatment of the \f[I]port\f[R] parameter is
+implementation\-specific.
+For the default \f[CB]rmi\f[R] protocol, the \f[I]port\f[R] parameter
+indicates the port number for the \f[CB]rmiregistry\f[R] on the remote
+host.
+If the \f[I]port\f[R] parameter is omitted, and the \f[I]protocol\f[R]
+parameter indicates \f[CB]rmi\f[R], then the default \f[CB]rmiregistry\f[R]
+port (\f[CB]1099\f[R]) is used.
+.RS
+.RE
+.TP
+.B \f[I]servername\f[R]
+The treatment of this parameter depends on the implementation.
+For the optimized, local protocol, this field is ignored.
+For the \f[CB]rmi\f[R] protocol, this parameter is a string that
+represents the name of the RMI remote object on the remote host.
+See the \f[B]jstatd\f[R] command \f[CB]\-n\f[R] option.
+.RS
+.RE
+.SH OUTPUT FORMAT OF THE JPS COMMAND
+.PP
+The output of the \f[CB]jps\f[R] command has the following pattern:
+.RS
+.PP
+\f[I]lvmid\f[R] [ [ \f[I]classname\f[R] | \f[I]JARfilename\f[R] |
+\f[CB]"Unknown"\f[R]] [ \f[I]arg\f[R]* ] [ \f[I]jvmarg\f[R]* ] ]
+.RE
+.PP
+All output tokens are separated by white space.
+An \f[CB]arg\f[R] value that includes embedded white space introduces
+ambiguity when attempting to map arguments to their actual positional
+parameters.
+.PP
+\f[B]Note:\f[R]
+.PP
+It\[aq]s recommended that you don\[aq]t write scripts to parse
+\f[CB]jps\f[R] output because the format might change in future releases.
+If you write scripts that parse \f[CB]jps\f[R] output, then expect to
+modify them for future releases of this tool.
+.SH EXAMPLES
+.PP
+This section provides examples of the \f[CB]jps\f[R] command.
+.PP
+List the instrumented JVMs on the local host:
+.IP
+.nf
+\f[CB]
+jps
+18027\ Java2Demo.JAR
+18032\ jps
+18005\ jstat
+\f[R]
+.fi
+.PP
+The following example lists the instrumented JVMs on a remote host.
+This example assumes that the \f[CB]jstat\f[R] server and either the its
+internal RMI registry or a separate external \f[CB]rmiregistry\f[R]
+process are running on the remote host on the default port (port
+\f[CB]1099\f[R]).
+It also assumes that the local host has appropriate permissions to
+access the remote host.
+This example includes the \f[CB]\-l\f[R] option to output the long form of
+the class names or JAR file names.
+.IP
+.nf
+\f[CB]
+jps\ \-l\ remote.domain
+3002\ /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
+2857\ sun.tools.jstatd.jstatd
+\f[R]
+.fi
+.PP
+The following example lists the instrumented JVMs on a remote host with
+a nondefault port for the RMI registry.
+This example assumes that the \f[CB]jstatd\f[R] server, with an internal
+RMI registry bound to port \f[CB]2002\f[R], is running on the remote host.
+This example also uses the \f[CB]\-m\f[R] option to include the arguments
+passed to the \f[CB]main\f[R] method of each of the listed Java
+applications.
+.IP
+.nf
+\f[CB]
+jps\ \-m\ remote.domain:2002
+3002\ /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
+3102\ sun.tools.jstatd.jstatd\ \-p\ 2002
+\f[R]
+.fi
diff --git a/java/temurin-17/man/man1/jrunscript.1 b/java/temurin-17/man/man1/jrunscript.1
new file mode 100644
index 0000000..a9745d2
--- /dev/null
+++ b/java/temurin-17/man/man1/jrunscript.1
@@ -0,0 +1,175 @@
+.\" Copyright (c) 2006, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JRUNSCRIPT" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jrunscript \- run a command\-line script shell that supports interactive
+and batch modes
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R]
+.PP
+This tool is \f[B]experimental\f[R] and unsupported.
+.PP
+\f[CB]jrunscript\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jrunscript\f[R] command\-line options that can
+be used.
+See \f[B]Options for the jrunscript Command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]arguments\f[R]
+Arguments, when used, follow immediately after options or the command
+name.
+See \f[B]Arguments\f[R].
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jrunscript\f[R] command is a language\-independent command\-line
+script shell.
+The \f[CB]jrunscript\f[R] command supports both an interactive
+(read\-eval\-print) mode and a batch (\f[CB]\-f\f[R] option) mode of
+script execution.
+By default, JavaScript is the language used, but the \f[CB]\-l\f[R] option
+can be used to specify a different language.
+By using Java to scripting language communication, the
+\f[CB]jrunscript\f[R] command supports an exploratory programming style.
+.PP
+If JavaScript is used, then before it evaluates a user defined script,
+the \f[CB]jrunscript\f[R] command initializes certain built\-in functions
+and objects, which are documented in the API Specification for
+\f[CB]jrunscript\f[R] JavaScript built\-in functions.
+.SH OPTIONS FOR THE JRUNSCRIPT COMMAND
+.TP
+.B \f[CB]\-cp\f[R] \f[I]path\f[R] or \f[CB]\-classpath\f[R] \f[I]path\f[R]
+Indicates where any class files are that the script needs to access.
+.RS
+.RE
+.TP
+.B \f[CB]\-D\f[R]\f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R]
+Sets a Java system property.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]flag\f[R]
+Passes \f[I]flag\f[R] directly to the Java Virtual Machine where the
+\f[CB]jrunscript\f[R] command is running.
+.RS
+.RE
+.TP
+.B \f[CB]\-l\f[R] \f[I]language\f[R]
+Uses the specified scripting language.
+By default, JavaScript is used.
+To use other scripting languages, you must specify the corresponding
+script engine\[aq]s JAR file with the \f[CB]\-cp\f[R] or
+\f[CB]\-classpath\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-e\f[R] \f[I]script\f[R]
+Evaluates the specified script.
+This option can be used to run one\-line scripts that are specified
+completely on the command line.
+.RS
+.RE
+.TP
+.B \f[CB]\-encoding\f[R] \f[I]encoding\f[R]
+Specifies the character encoding used to read script files.
+.RS
+.RE
+.TP
+.B \f[CB]\-f\f[R] \f[I]script\-file\f[R]
+Evaluates the specified script file (batch mode).
+.RS
+.RE
+.TP
+.B \f[CB]\-f\ \-\f[R]
+Enters interactive mode to read and evaluate a script from standard
+input.
+.RS
+.RE
+.TP
+.B \f[CB]\-help\f[R] or \f[CB]\-?\f[R]
+Displays a help message and exits.
+.RS
+.RE
+.TP
+.B \f[CB]\-q\f[R]
+Lists all script engines available and exits.
+.RS
+.RE
+.SH ARGUMENTS
+.PP
+If arguments are present and if no \f[CB]\-e\f[R] or \f[CB]\-f\f[R] option
+is used, then the first argument is the script file and the rest of the
+arguments, if any, are passed as script arguments.
+If arguments and the \f[CB]\-e\f[R] or the \f[CB]\-f\f[R] option are used,
+then all arguments are passed as script arguments.
+If arguments \f[CB]\-e\f[R] and \f[CB]\-f\f[R] are missing, then the
+interactive mode is used.
+.SH EXAMPLE OF EXECUTING INLINE SCRIPTS
+.RS
+.PP
+\f[CB]jrunscript\ \-e\ "print(\[aq]hello\ world\[aq])"\f[R]
+.RE
+.RS
+.PP
+\f[CB]jrunscript\ \-e\ "cat(\[aq]http://www.example.com\[aq])"\f[R]
+.RE
+.SH EXAMPLE OF USING SPECIFIED LANGUAGE AND EVALUATE THE SCRIPT FILE
+.RS
+.PP
+\f[CB]jrunscript\ \-l\ js\ \-f\ test.js\f[R]
+.RE
+.SH EXAMPLE OF INTERACTIVE MODE
+.IP
+.nf
+\f[CB]
+jrunscript
+js>\ print(\[aq]Hello\ World\\n\[aq]);
+Hello\ World
+js>\ 34\ +\ 55
+89.0
+js>\ t\ =\ new\ java.lang.Thread(function()\ {\ print(\[aq]Hello\ World\\n\[aq]);\ })
+Thread[Thread\-0,5,main]
+js>\ t.start()
+js>\ Hello\ World
+
+js>
+\f[R]
+.fi
+.SH RUN SCRIPT FILE WITH SCRIPT ARGUMENTS
+.PP
+In this example, the \f[CB]test.js\f[R] file is the script file.
+The \f[CB]arg1\f[R], \f[CB]arg2\f[R], and \f[CB]arg3\f[R] arguments are passed
+to the script.
+The script can access these arguments with an arguments array.
+.RS
+.PP
+\f[CB]jrunscript\ test.js\ arg1\ arg2\ arg3\f[R]
+.RE
diff --git a/java/temurin-17/man/man1/jshell.1 b/java/temurin-17/man/man1/jshell.1
new file mode 100644
index 0000000..53bd760
--- /dev/null
+++ b/java/temurin-17/man/man1/jshell.1
@@ -0,0 +1,1449 @@
+.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"t
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JSHELL" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jshell \- interactively evaluate declarations, statements, and
+expressions of the Java programming language in a read\-eval\-print loop
+(REPL)
+.SH SYNOPSIS
+.PP
+\f[CB]jshell\f[R] [\f[I]options\f[R]] [\f[I]load\-files\f[R]]
+.TP
+.B \f[I]options\f[R]
+Command\-line options, separated by spaces.
+See \f[B]Options for jshell\f[R].
+.RS
+.RE
+.TP
+.B \f[I]load\-files\f[R]
+One or more scripts to run when the tool is started.
+Scripts can contain any valid code snippets or JShell commands.
+.RS
+.PP
+The script can be a local file or one of following predefined scripts:
+.TP
+.B \f[CB]DEFAULT\f[R]
+Loads the default entries, which are commonly used as imports.
+.RS
+.RE
+.TP
+.B \f[CB]JAVASE\f[R]
+Imports all Java SE packages.
+.RS
+.RE
+.TP
+.B \f[CB]PRINTING\f[R]
+Defines \f[CB]print\f[R], \f[CB]println\f[R], and \f[CB]printf\f[R] as
+\f[CB]jshell\f[R] methods for use within the tool.
+.RS
+.RE
+.PP
+For more than one script, use a space to separate the names.
+Scripts are run in the order in which they\[aq]re entered on the command
+line.
+Command\-line scripts are run after startup scripts.
+To run a script after JShell is started, use the \f[CB]/open\f[R] command.
+.PP
+To accept input from standard input and suppress the interactive I/O,
+enter a hyphen (\-) for \f[I]load\-files\f[R].
+This option enables the use of the \f[CB]jshell\f[R] tool in pipe chains.
+.RE
+.SH DESCRIPTION
+.PP
+JShell provides a way to interactively evaluate declarations,
+statements, and expressions of the Java programming language, making it
+easier to learn the language, explore unfamiliar code and APIs, and
+prototype complex code.
+Java statements, variable definitions, method definitions, class
+definitions, import statements, and expressions are accepted.
+The bits of code entered are called snippets.
+.PP
+As snippets are entered, they\[aq]re evaluated, and feedback is
+provided.
+Feedback varies from the results and explanations of actions to nothing,
+depending on the snippet entered and the feedback mode chosen.
+Errors are described regardless of the feedback mode.
+Start with the verbose mode to get the most feedback while learning the
+tool.
+.PP
+Command\-line options are available for configuring the initial
+environment when JShell is started.
+Within JShell, commands are available for modifying the environment as
+needed.
+.PP
+Existing snippets can be loaded from a file to initialize a JShell
+session, or at any time within a session.
+Snippets can be modified within the session to try out different
+variations and make corrections.
+To keep snippets for later use, save them to a file.
+.SH OPTIONS FOR JSHELL
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]module\f[R]/\f[I]package\f[R]
+Specifies a package to be considered as exported from its defining
+module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+.RS
+.RE
+.TP
+.B \f[CB]\-C\f[R]\f[I]flag\f[R]
+Provides a flag to pass to the compiler.
+To pass more than one flag, provide an instance of this option for each
+flag or flag argument needed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the directories and archives that are searched to locate class
+files.
+This option overrides the path in the \f[CB]CLASSPATH\f[R] environment
+variable.
+If the environment variable isn\[aq]t set and this option isn\[aq]t
+used, then the current directory is searched.
+For Linux and macOS, use a colon (:) to separate items in the path.
+For Windows, use a semicolon (;) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-enable\-preview\f[R]
+Allows code to depend on the preview features of this release.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-execution\f[R] \f[I]specification\f[R]
+Specifies an alternate execution engine, where \f[I]specification\f[R] is
+an ExecutionControl spec.
+See the documentation of the package jdk.jshell.spi for the syntax of
+the spec.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-feedback\f[R] \f[I]mode\f[R]
+Sets the initial level of feedback provided in response to what\[aq]s
+entered.
+The initial level can be overridden within a session by using the
+\f[CB]/set\ feedback\f[R] \f[I]mode\f[R] command.
+The default is \f[CB]normal\f[R].
+.RS
+.PP
+The following values are valid for \f[I]mode\f[R]:
+.TP
+.B \f[CB]verbose\f[R]
+Provides detailed feedback for entries.
+Additional information about the action performed is displayed after the
+result of the action.
+The next prompt is separated from the feedback by a blank line.
+.RS
+.RE
+.TP
+.B \f[CB]normal\f[R]
+Provides an average amount of feedback.
+The next prompt is separated from the feedback by a blank line.
+.RS
+.RE
+.TP
+.B \f[CB]concise\f[R]
+Provides minimal feedback.
+The next prompt immediately follows the code snippet or feedback.
+.RS
+.RE
+.TP
+.B \f[CB]silent\f[R]
+Provides no feedback.
+The next prompt immediately follows the code snippet.
+.RS
+.RE
+.TP
+.B \f[I]custom\f[R]
+Provides custom feedback based on how the mode is defined.
+Custom feedback modes are created within JShell by using the
+\f[CB]/set\ mode\f[R] command.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]\-\-help\f[R] or \f[CB]\-h\f[R] or \f[CB]\-?\f[R]
+Prints a summary of standard options and exits the tool.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-help\-extra\f[R] or \f[CB]\-X\f[R]
+Prints a summary of nonstandard options and exits the tool.
+Nonstandard options are subject to change without notice.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]flag\f[R]
+Provides a flag to pass to the runtime system.
+To pass more than one flag, provide an instance of this option for each
+flag or flag argument needed.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies where to find application modules.
+For Linux and macOS, use a colon (:) to separate items in the path.
+For Windows, use a semicolon (;) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-no\-startup\f[R]
+Prevents startup scripts from running when JShell starts.
+Use this option to run only the scripts entered on the command line when
+JShell is started, or to start JShell without any preloaded information
+if no scripts are entered.
+This option can\[aq]t be used if the \f[CB]\-\-startup\f[R] option is
+used.
+.RS
+.RE
+.TP
+.B \f[CB]\-q\f[R]
+Sets the feedback mode to \f[CB]concise\f[R], which is the same as
+entering \f[CB]\-\-feedback\ concise\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-R\f[R]\f[I]flag\f[R]
+Provides a flag to pass to the remote runtime system.
+To pass more than one flag, provide an instance of this option for each
+flag or flag argument to pass.
+.RS
+.RE
+.TP
+.B \f[CB]\-s\f[R]
+Sets the feedback mode to \f[CB]silent\f[R], which is the same as entering
+\f[CB]\-\-feedback\ silent\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-show\-version\f[R]
+Prints version information and enters the tool.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-startup\f[R] \f[I]file\f[R]
+Overrides the default startup script for this session.
+The script can contain any valid code snippets or commands.
+.RS
+.PP
+The script can be a local file or one of the following predefined
+scripts:
+.TP
+.B \f[CB]DEFAULT\f[R]
+Loads the default entries, which are commonly used as imports.
+.RS
+.RE
+.TP
+.B \f[CB]JAVASE\f[R]
+Imports all Java SE packages.
+.RS
+.RE
+.TP
+.B \f[CB]PRINTING\f[R]
+Defines \f[CB]print\f[R], \f[CB]println\f[R], and \f[CB]printf\f[R] as
+\f[CB]jshell\f[R] methods for use within the tool.
+.RS
+.RE
+.PP
+For more than one script, provide a separate instance of this option for
+each script.
+Startup scripts are run when JShell is first started and when the
+session is restarted with the \f[CB]/reset\f[R], \f[CB]/reload\f[R], or
+\f[CB]/env\f[R] command.
+Startup scripts are run in the order in which they\[aq]re entered on the
+command line.
+.PP
+This option can\[aq]t be used if the \f[CB]\-\-no\-startup\f[R] option is
+used.
+.RE
+.TP
+.B \f[CB]\-v\f[R]
+Sets the feedback mode to \f[CB]verbose\f[R], which is the same as
+entering \f[CB]\-\-feedback\ verbose\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-version\f[R]
+Prints version information and exits the tool.
+.RS
+.RE
+.SH JSHELL COMMANDS
+.PP
+Within the \f[CB]jshell\f[R] tool, commands are used to modify the
+environment and manage code snippets.
+.TP
+.B \f[CB]/drop\f[R] {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Drops snippets identified by name, ID, or ID range, making them
+inactive.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]/edit\f[R] [\f[I]option\f[R]]
+Opens an editor.
+If no option is entered, then the editor opens with the active snippets.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Opens the editor with the snippets identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Opens the editor with all snippets, including startup snippets and
+snippets that failed, were overwritten, or were dropped.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Opens the editor with startup snippets that were evaluated when JShell
+was started.
+.RS
+.RE
+.PP
+To exit edit mode, close the editor window, or respond to the prompt
+provided if the \f[CB]\-wait\f[R] option was used when the editor was set.
+.PP
+Use the \f[CB]/set\ editor\f[R] command to specify the editor to use.
+If no editor is set, then the following environment variables are
+checked in order: \f[CB]JSHELLEDITOR\f[R], \f[CB]VISUAL\f[R], and
+\f[CB]EDITOR\f[R].
+If no editor is set in JShell and none of the editor environment
+variables is set, then a simple default editor is used.
+.RE
+.TP
+.B \f[CB]/env\f[R] [\f[I]options\f[R]]
+Displays the environment settings, or updates the environment settings
+and restarts the session.
+If no option is entered, then the current environment settings are
+displayed.
+If one or more options are entered, then the session is restarted as
+follows:
+.RS
+.IP \[bu] 2
+Updates the environment settings with the provided options.
+.IP \[bu] 2
+Resets the execution state.
+.IP \[bu] 2
+Runs the startup scripts.
+.IP \[bu] 2
+Silently replays the history in the order entered.
+The history includes all valid snippets or \f[CB]/drop\f[R] commands
+entered at the \f[CB]jshell\f[R] prompt, in scripts entered on the command
+line, or scripts entered with the \f[CB]/open\f[R] command.
+.PP
+Environment settings entered on the command line or provided with a
+previous \f[CB]/reset\f[R], \f[CB]/env\f[R], or \f[CB]/reload\f[R] command are
+maintained unless an \f[I]option\f[R] is entered that overwrites the
+setting.
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]source\-module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R][\f[CB],\f[R]\f[I]target\-module\f[R]]*
+Adds an export of \f[I]package\f[R] from \f[I]source\-module\f[R] to
+\f[I]target\-module\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the directories and archives that are searched to locate class
+files.
+This option overrides the path in the \f[CB]CLASSPATH\f[R] environment
+variable.
+If the environment variable isn\[aq]t set and this option isn\[aq]t
+used, then the current directory is searched.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies where to find application modules.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/exit\f[R] [\f[I]integer\-expression\-snippet\f[R]]
+Exits the tool.
+If no snippet is entered, the exit status is zero.
+If a snippet is entered and the result of the snippet is an integer, the
+result is used as the exit status.
+If an error occurs, or the result of the snippet is not an integer, an
+error is displayed and the tool remains active.
+.RS
+.RE
+.TP
+.B \f[CB]/history\f[R]
+Displays what was entered in this session.
+.RS
+.RE
+.TP
+.B \f[CB]/help\f[R] [\f[I]command\f[R]|\f[I]subject\f[R]]
+Displays information about commands and subjects.
+If no options are entered, then a summary of information for all
+commands and a list of available subjects are displayed.
+If a valid command is provided, then expanded information for that
+command is displayed.
+If a valid subject is entered, then information about that subject is
+displayed.
+.RS
+.PP
+The following values for \f[I]subject\f[R] are valid:
+.TP
+.B \f[CB]context\f[R]
+Describes the options that are available for configuring the
+environment.
+.RS
+.RE
+.TP
+.B \f[CB]intro\f[R]
+Provides an introduction to the tool.
+.RS
+.RE
+.TP
+.B \f[CB]shortcuts\f[R]
+Describes keystrokes for completing commands and snippets.
+See \f[B]Input Shortcuts\f[R].
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/imports\f[R]
+Displays the current active imports, including those from the startup
+scripts and scripts that were entered on the command line when JShell
+was started.
+.RS
+.RE
+.TP
+.B \f[CB]/list\f[R] [\f[I]option\f[R]]
+Displays a list of snippets and their IDs.
+If no option is entered, then all active snippets are displayed, but
+startup snippets aren\[aq]t.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Displays the snippets identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Displays all snippets, including startup snippets and snippets that
+failed, were overwritten, or were dropped.
+IDs that begin with \f[CB]s\f[R] are startup snippets.
+IDs that begin with \f[CB]e\f[R] are snippets that failed.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Displays startup snippets that were evaluated when JShell was started.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/methods\f[R] [\f[I]option\f[R]]
+Displays information about the methods that were entered.
+If no option is entered, then the name, parameter types, and return type
+of all active methods are displayed.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Displays information for methods identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Displays information for all methods, including those added when JShell
+was started, and methods that failed, were overwritten, or were dropped.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Displays information for startup methods that were added when JShell was
+started.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/open\f[R] \f[I]file\f[R]
+Opens the script specified and reads the snippets into the tool.
+The script can be a local file or one of the following predefined
+scripts:
+.RS
+.TP
+.B \f[CB]DEFAULT\f[R]
+Loads the default entries, which are commonly used as imports.
+.RS
+.RE
+.TP
+.B \f[CB]JAVASE\f[R]
+Imports all Java SE packages.
+.RS
+.RE
+.TP
+.B \f[CB]PRINTING\f[R]
+Defines \f[CB]print\f[R], \f[CB]println\f[R], and \f[CB]printf\f[R] as
+\f[CB]jshell\f[R] methods for use within the tool.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/reload\f[R] [\f[I]options\f[R]]
+Restarts the session as follows:
+.RS
+.IP \[bu] 2
+Updates the environment settings with the provided options, if any.
+.IP \[bu] 2
+Resets the execution state.
+.IP \[bu] 2
+Runs the startup scripts.
+.IP \[bu] 2
+Replays the history in the order entered.
+The history includes all valid snippets or \f[CB]/drop\f[R] commands
+entered at the \f[CB]jshell\f[R] prompt, in scripts entered on the command
+line, or scripts entered with the \f[CB]/open\f[R] command.
+.PP
+Environment settings entered on the command line or provided with a
+previous \f[CB]/reset\f[R], \f[CB]/env\f[R], or \f[CB]/reload\f[R] command are
+maintained unless an \f[I]option\f[R] is entered that overwrites the
+setting.
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]source\-module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R][\f[CB],\f[R]\f[I]target\-module\f[R]]*
+Adds an export of \f[I]package\f[R] from \f[I]source\-module\f[R] to
+\f[I]target\-module\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the directories and archives that are searched to locate class
+files.
+This option overrides the path in the \f[CB]CLASSPATH\f[R] environment
+variable.
+If the environment variable isn\[aq]t set and this option isn\[aq]t
+used, then the current directory is searched.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies where to find application modules.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-quiet\f[R]
+Replays the valid history without displaying it.
+Errors are displayed.
+.RS
+.RE
+.TP
+.B \f[CB]\-restore\f[R]
+Resets the environment to the state at the start of the previous run of
+the tool or to the last time a \f[CB]/reset\f[R], \f[CB]/reload\f[R], or
+\f[CB]/env\f[R] command was executed in the previous run.
+The valid history since that point is replayed.
+Use this option to restore a previous JShell session.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/reset\f[R] [\f[I]options\f[R]]
+Discards all entered snippets and restarts the session as follows:
+.RS
+.IP \[bu] 2
+Updates the environment settings with the provided options, if any.
+.IP \[bu] 2
+Resets the execution state.
+.IP \[bu] 2
+Runs the startup scripts.
+.PP
+History is not replayed.
+All code that was entered is lost.
+.PP
+Environment settings entered on the command line or provided with a
+previous \f[CB]/reset\f[R], \f[CB]/env\f[R], or \f[CB]/reload\f[R] command are
+maintained unless an \f[I]option\f[R] is entered that overwrites the
+setting.
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R][\f[CB],\f[R]\f[I]module\f[R]...]
+Specifies the root modules to resolve in addition to the initial module.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-add\-exports\f[R] \f[I]source\-module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]target\-module\f[R][\f[CB],\f[R]\f[I]target\-module\f[R]]*
+Adds an export of \f[I]package\f[R] from \f[I]source\-module\f[R] to
+\f[I]target\-module\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R]
+Specifies the directories and archives that are searched to locate class
+files.
+This option overrides the path in the \f[CB]CLASSPATH\f[R] environment
+variable.
+If the environment variable isn\[aq]t set and this option isn\[aq]t
+used, then the current directory is searched.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.TP
+.B \f[CB]\-\-module\-path\f[R] \f[I]modulepath\f[R]
+Specifies where to find application modules.
+For Linux and macOS, use a colon (\f[CB]:\f[R]) to separate items in the
+path.
+For Windows, use a semicolon (\f[CB];\f[R]) to separate items.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/save\f[R] [\f[I]options\f[R]] \f[I]file\f[R]
+Saves snippets and commands to the file specified.
+If no options are entered, then active snippets are saved.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Saves the snippets and commands identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of the code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Saves all snippets, including startup snippets and snippets that were
+overwritten or failed.
+.RS
+.RE
+.TP
+.B \f[CB]\-history\f[R]
+Saves the sequential history of all commands and snippets entered in the
+current session.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Saves the current startup settings.
+If no startup scripts were provided, then an empty file is saved.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/set\f[R] [\f[I]setting\f[R]]
+Sets configuration information, including the external editor, startup
+settings, and feedback mode.
+This command is also used to create a custom feedback mode with
+customized prompt, format, and truncation values.
+If no setting is entered, then the current setting for the editor,
+startup settings, and feedback mode are displayed.
+.RS
+.PP
+The following values are valid for \f[CB]setting\f[R]:
+.TP
+.B \f[CB]editor\f[R] [\f[I]options\f[R]] [\f[I]command\f[R]]
+Sets the command used to start an external editor when the
+\f[CB]/edit\f[R] command is entered.
+The command can include command arguments separated by spaces.
+If no command or options are entered, then the current setting is
+displayed.
+.RS
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-default\f[R]
+Sets the editor to the default editor provided with JShell.
+This option can\[aq]t be used if a command for starting an editor is
+entered.
+.RS
+.RE
+.TP
+.B \f[CB]\-delete\f[R]
+Sets the editor to the one in effect when the session started.
+If used with the \f[CB]\-retain\f[R] option, then the retained editor
+setting is deleted and the editor is set to the first of the following
+environment variables found: \f[CB]JSHELLEDITOR\f[R], \f[CB]VISUAL\f[R], or
+\f[CB]EDITOR\f[R].
+If none of the editor environment variables are set, then this option
+sets the editor to the default editor.
+.RS
+.PP
+This option can\[aq]t be used if a command for starting an editor is
+entered.
+.RE
+.TP
+.B \f[CB]\-retain\f[R]
+Saves the editor setting across sessions.
+If no other option or a command is entered, then the current setting is
+saved.
+.RS
+.RE
+.TP
+.B \f[CB]\-wait\f[R]
+Prompts the user to indicate when editing is complete.
+Otherwise control returns to JShell when the editor exits.
+Use this option if the editor being used exits immediately, for example,
+when an edit window already exists.
+This option is valid only when a command for starting an editor is
+entered.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]feedback\f[R] [\f[I]mode\f[R]]
+Sets the feedback mode used to respond to input.
+If no mode is entered, then the current mode is displayed.
+.RS
+.PP
+The following modes are valid: \f[CB]concise\f[R], \f[CB]normal\f[R],
+\f[CB]silent\f[R], \f[CB]verbose\f[R], and any custom mode created with the
+\f[CB]/set\ mode\f[R] command.
+.RE
+.TP
+.B \f[CB]format\f[R] \f[I]mode\f[R] \f[I]field\f[R] \f[CB]"\f[R]\f[I]format\-string\f[R]\f[CB]"\f[R] \f[I]selector\f[R]
+Sets the format of the feedback provided in response to input.
+If no mode is entered, then the current formats for all fields for all
+feedback modes are displayed.
+If only a mode is entered, then the current formats for that mode are
+displayed.
+If only a mode and field are entered, then the current formats for that
+field are displayed.
+.RS
+.PP
+To define a format, the following arguments are required:
+.TP
+.B \f[I]mode\f[R]
+Specifies a feedback mode to which the response format is applied.
+Only custom modes created with the \f[CB]/set\ mode\f[R] command can be
+modified.
+.RS
+.RE
+.TP
+.B \f[I]field\f[R]
+Specifies a context\-specific field to which the response format is
+applied.
+The fields are described in the online help, which is accessed from
+JShell using the \f[CB]/help\ /set\ format\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]"\f[R]\f[I]format\-string\f[R]\f[CB]"\f[R]
+Specifies the string to use as the response format for the specified
+field and selector.
+The structure of the format string is described in the online help,
+which is accessed from JShell using the \f[CB]/help\ /set\ format\f[R]
+command.
+.RS
+.RE
+.TP
+.B \f[I]selector\f[R]
+Specifies the context in which the response format is applied.
+The selectors are described in the online help, which is accessed from
+JShell using the \f[CB]/help\ /set\ format\f[R] command.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]mode\f[R] [\f[I]mode\-name\f[R]] [\f[I]existing\-mode\f[R]] [\f[I]options\f[R]]
+Creates a custom feedback mode with the mode name provided.
+If no mode name is entered, then the settings for all modes are
+displayed, which includes the mode, prompt, format, and truncation
+settings.
+If the name of an existing mode is provided, then the settings from the
+existing mode are copied to the mode being created.
+.RS
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-command\f[R]|\f[CB]\-quiet\f[R]
+Specifies the level of feedback displayed for commands when using the
+mode.
+This option is required when creating a feedback mode.
+Use \f[CB]\-command\f[R] to show information and verification feedback for
+commands.
+Use \f[CB]\-quiet\f[R] to show only essential feedback for commands, such
+as error messages.
+.RS
+.RE
+.TP
+.B \f[CB]\-delete\f[R]
+Deletes the named feedback mode for this session.
+The name of the mode to delete is required.
+To permanently delete a retained mode, use the \f[CB]\-retain\f[R] option
+with this option.
+Predefined modes can\[aq]t be deleted.
+.RS
+.RE
+.TP
+.B \f[CB]\-retain\f[R]
+Saves the named feedback mode across sessions.
+The name of the mode to retain is required.
+.RS
+.RE
+.PP
+Configure the new feedback mode using the \f[CB]/set\ prompt\f[R],
+\f[CB]/set\ format\f[R], and \f[CB]/set\ truncation\f[R] commands.
+.PP
+To start using the new mode, use the \f[CB]/set\ feedback\f[R] command.
+.RE
+.TP
+.B \f[CB]prompt\f[R] \f[I]mode\f[R] \f[CB]"\f[R]\f[I]prompt\-string\f[R]\f[CB]"\f[R] \f[CB]"\f[R]\f[I]continuation\-prompt\-string\f[R]\f[CB]"\f[R]
+Sets the prompts for input within JShell.
+If no mode is entered, then the current prompts for all feedback modes
+are displayed.
+If only a mode is entered, then the current prompts for that mode are
+displayed.
+.RS
+.PP
+To define a prompt, the following arguments are required:
+.TP
+.B \f[I]mode\f[R]
+Specifies the feedback mode to which the prompts are applied.
+Only custom modes created with the \f[CB]/set\ mode\f[R] command can be
+modified.
+.RS
+.RE
+.TP
+.B \f[CB]"\f[R]\f[I]prompt\-string\f[R]\f[CB]"\f[R]
+Specifies the string to use as the prompt for the first line of input.
+.RS
+.RE
+.TP
+.B \f[CB]"\f[R]\f[I]continuation\-prompt\-string\f[R]\f[CB]"\f[R]
+Specifies the string to use as the prompt for the additional input lines
+needed to complete a snippet.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]start\f[R] [\f[CB]\-retain\f[R]] [\f[I]file\f[R] [\f[I]file\f[R]...]|\f[I]option\f[R]]
+Sets the names of the startup scripts used when the next
+\f[CB]/reset\f[R], \f[CB]/reload\f[R], or \f[CB]/env\f[R] command is entered.
+If more than one script is entered, then the scripts are run in the
+order entered.
+If no scripts or options are entered, then the current startup settings
+are displayed.
+.RS
+.PP
+The scripts can be local files or one of the following predefined
+scripts:
+.TP
+.B \f[CB]DEFAULT\f[R]
+Loads the default entries, which are commonly used as imports.
+.RS
+.RE
+.TP
+.B \f[CB]JAVASE\f[R]
+Imports all Java SE packages.
+.RS
+.RE
+.TP
+.B \f[CB]PRINTING\f[R]
+Defines \f[CB]print\f[R], \f[CB]println\f[R], and \f[CB]printf\f[R] as
+\f[CB]jshell\f[R] methods for use within the tool.
+.RS
+.RE
+.PP
+The following options are valid:
+.TP
+.B \f[CB]\-default\f[R]
+Sets the startup settings to the default settings.
+.RS
+.RE
+.TP
+.B \f[CB]\-none\f[R]
+Specifies that no startup settings are used.
+.RS
+.RE
+.PP
+Use the \f[CB]\-retain\f[R] option to save the start setting across
+sessions.
+.RE
+.TP
+.B \f[CB]truncation\f[R] \f[I]mode\f[R] \f[I]length\f[R] \f[I]selector\f[R]
+Sets the maximum length of a displayed value.
+If no mode is entered, then the current truncation values for all
+feedback modes are displayed.
+If only a mode is entered, then the current truncation values for that
+mode are displayed.
+.RS
+.PP
+To define truncation values, the following arguments are required:
+.TP
+.B \f[I]mode\f[R]
+Specifies the feedback mode to which the truncation value is applied.
+Only custom modes created with the \f[CB]/set\ mode\f[R] command can be
+modified.
+.RS
+.RE
+.TP
+.B \f[I]length\f[R]
+Specifies the unsigned integer to use as the maximum length for the
+specified selector.
+.RS
+.RE
+.TP
+.B \f[I]selector\f[R]
+Specifies the context in which the truncation value is applied.
+The selectors are described in the online help, which is accessed from
+JShell using the \f[CB]/help\ /set\ truncation\f[R] command.
+.RS
+.RE
+.RE
+.RE
+.TP
+.B \f[CB]/types\f[R] [\f[I]option\f[R]]
+Displays classes, interfaces, and enums that were entered.
+If no option is entered, then all current active classes, interfaces,
+and enums are displayed.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Displays information for classes, interfaces, and enums identified by
+name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of the code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Displays information for all classes, interfaces, and enums, including
+those added when JShell was started, and classes, interfaces, and enums
+that failed, were overwritten, or were dropped.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Displays information for startup classes, interfaces, and enums that
+were added when JShell was started.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/vars\f[R] [\f[I]option\f[R]]
+Displays the name, type, and value of variables that were entered.
+If no option is entered, then all current active variables are
+displayed.
+.RS
+.PP
+The following options are valid:
+.TP
+.B {\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Displays information for variables identified by name, ID, or ID range.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+Use the \f[CB]/list\f[R] command to see the IDs of the code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]\-all\f[R]
+Displays information for all variables, including those added when
+JShell was started, and variables that failed, were overwritten, or were
+dropped.
+.RS
+.RE
+.TP
+.B \f[CB]\-start\f[R]
+Displays information for startup variables that were added when JShell
+was started.
+.RS
+.RE
+.RE
+.TP
+.B \f[CB]/?\f[R]
+Same as the \f[CB]/help\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]/!\f[R]
+Reruns the last snippet.
+.RS
+.RE
+.TP
+.B \f[CB]/\f[R]{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]} [{\f[I]name\f[R]|\f[I]id\f[R]|\f[I]startID\f[R]\f[CB]\-\f[R]\f[I]endID\f[R]}...]
+Reruns the snippets identified by ID, range of IDs, or name.
+For a range of IDs, provide the starting ID and ending ID separated with
+a hyphen.
+To provide a list, separate the items in the list with a space.
+The first item in the list must be an ID or ID range.
+Use the \f[CB]/list\f[R] command to see the IDs of the code snippets.
+.RS
+.RE
+.TP
+.B \f[CB]/\-\f[R]\f[I]n\f[R]
+Reruns the \-\f[I]n\f[R]th previous snippet.
+For example, if 15 code snippets were entered, then \f[CB]/\-4\f[R] runs
+the 11th snippet.
+Commands aren\[aq]t included in the count.
+.RS
+.RE
+.SH INPUT SHORTCUTS
+.PP
+The following shortcuts are available for entering commands and snippets
+in JShell.
+.SS Tab completion
+.TP
+.B \f[B]<tab>\f[R]
+When entering snippets, commands, subcommands, command arguments, or
+command options, use the Tab key to automatically complete the item.
+If the item can\[aq]t be determined from what was entered, then possible
+options are provided.
+.RS
+.PP
+When entering a method call, use the Tab key after the method call\[aq]s
+opening parenthesis to see the parameters for the method.
+If the method has more than one signature, then all signatures are
+displayed.
+Pressing the Tab key a second time displays the description of the
+method and the parameters for the first signature.
+Continue pressing the Tab key for a description of any additional
+signatures.
+.RE
+.TP
+.B \f[B]Shift+<Tab> V\f[R]
+After entering a complete expression, use this key sequence to convert
+the expression to a variable declaration of a type determined by the
+type of the expression.
+.RS
+.RE
+.TP
+.B \f[B]Shift+<Tab> M\f[R]
+After entering a complete expression or statement, use this key sequence
+to convert the expression or statement to a method declaration.
+If an expression is entered, the return type is based on the type of the
+expression.
+.RS
+.RE
+.TP
+.B \f[B]Shift+<Tab> I\f[R]
+When an identifier is entered that can\[aq]t be resolved, use this key
+sequence to show possible imports that resolve the identifier based on
+the content of the specified class path.
+.RS
+.RE
+.SS Command abbreviations
+.PP
+An abbreviation of a command is accepted if the abbreviation uniquely
+identifies a command.
+For example, \f[CB]/l\f[R] is recognized as the \f[CB]/list\f[R] command.
+However, \f[CB]/s\f[R] isn\[aq]t a valid abbreviation because it can\[aq]t
+be determined if the \f[CB]/set\f[R] or \f[CB]/save\f[R] command is meant.
+Use \f[CB]/se\f[R] for the \f[CB]/set\f[R] command or \f[CB]/sa\f[R] for the
+\f[CB]/save\f[R] command.
+.PP
+Abbreviations are also accepted for subcommands, command arguments, and
+command options.
+For example, use \f[CB]/m\ \-a\f[R] to display all methods.
+.SS History navigation
+.PP
+A history of what was entered is maintained across sessions.
+Use the up and down arrows to scroll through commands and snippets from
+the current and past sessions.
+Use the Ctrl key with the up and down arrows to skip all but the first
+line of multiline snippets.
+.SS History search
+.PP
+Use the Ctrl+R key combination to search the history for the string
+entered.
+The prompt changes to show the string and the match.
+Ctrl+R searches backwards from the current location in the history
+through earlier entries.
+Ctrl+S searches forward from the current location in the history though
+later entries.
+.SH INPUT EDITING
+.PP
+The editing capabilities of JShell are similar to that of other common
+shells.
+Keyboard keys and key combinations provide line editing shortcuts.
+The Ctrl key and Meta key are used in key combinations.
+If your keyboard doesn\[aq]t have a Meta key, then the Alt key is often
+mapped to provide Meta key functionality.
+.PP
+.TS
+tab(@);
+l l.
+T{
+Key or Key Combination
+T}@T{
+Action
+T}
+_
+T{
+Return
+T}@T{
+Enter the current line.
+T}
+T{
+Left arrow
+T}@T{
+Move the cursor to the left one character.
+T}
+T{
+Right arrow
+T}@T{
+Move the cursor to the right one character.
+T}
+T{
+Ctrl+A
+T}@T{
+Move the cursor to the beginning of the line.
+T}
+T{
+Ctrl+E
+T}@T{
+Move the cursor to the end of the line.
+T}
+T{
+Meta+B
+T}@T{
+Move the cursor to the left one word.
+T}
+T{
+Meta+F
+T}@T{
+Move the cursor to the right one word.
+T}
+T{
+Delete
+T}@T{
+Delete the character under the cursor.
+T}
+T{
+Backspace
+T}@T{
+Delete the character before the cursor.
+T}
+T{
+Ctrl+K
+T}@T{
+Delete the text from the cursor to the end of the line.
+T}
+T{
+Meta+D
+T}@T{
+Delete the text from the cursor to the end of the word.
+T}
+T{
+Ctrl+W
+T}@T{
+Delete the text from the cursor to the previous white space.
+T}
+T{
+Ctrl+Y
+T}@T{
+Paste the most recently deleted text into the line.
+T}
+T{
+Meta+Y
+T}@T{
+After Ctrl+Y, press to cycle through the previously deleted text.
+T}
+.TE
+.SH EXAMPLE OF STARTING AND STOPPING A JSHELL SESSION
+.PP
+JShell is provided with the JDK.
+To start a session, enter \f[CB]jshell\f[R] on the command line.
+A welcome message is printed, and a prompt for entering commands and
+snippets is provided.
+.IP
+.nf
+\f[CB]
+%\ jshell
+|\ \ Welcome\ to\ JShell\ \-\-\ Version\ 9
+|\ \ For\ an\ introduction\ type:\ /help\ intro
+
+jshell>
+\f[R]
+.fi
+.PP
+To see which snippets were automatically loaded when JShell started, use
+the \f[CB]/list\ \-start\f[R] command.
+The default startup snippets are import statements for common packages.
+The ID for each snippet begins with the letter \f[I]s\f[R], which
+indicates it\[aq]s a startup snippet.
+.IP
+.nf
+\f[CB]
+jshell>\ /list\ \-start
+
+\ \ s1\ :\ import\ java.io.*;
+\ \ s2\ :\ import\ java.math.*;
+\ \ s3\ :\ import\ java.net.*;
+\ \ s4\ :\ import\ java.nio.file.*;
+\ \ s5\ :\ import\ java.util.*;
+\ \ s6\ :\ import\ java.util.concurrent.*;
+\ \ s7\ :\ import\ java.util.function.*;
+\ \ s8\ :\ import\ java.util.prefs.*;
+\ \ s9\ :\ import\ java.util.regex.*;
+\ s10\ :\ import\ java.util.stream.*;
+
+jshell>
+\f[R]
+.fi
+.PP
+To end the session, use the \f[CB]/exit\f[R] command.
+.IP
+.nf
+\f[CB]
+jshell>\ /exit
+|\ \ Goodbye
+
+%
+\f[R]
+.fi
+.SH EXAMPLE OF ENTERING SNIPPETS
+.PP
+Snippets are Java statements, variable definitions, method definitions,
+class definitions, import statements, and expressions.
+Terminating semicolons are automatically added to the end of a completed
+snippet if they\[aq]re missing.
+.PP
+The following example shows two variables and a method being defined,
+and the method being run.
+Note that a scratch variable is automatically created to hold the result
+because no variable was provided.
+.IP
+.nf
+\f[CB]
+jshell>\ int\ a=4
+a\ ==>\ 4
+
+jshell>\ int\ b=8
+b\ ==>\ 8
+
+jshell>\ int\ square(int\ i1)\ {
+\ \ \ ...>\ return\ i1\ *\ i1;
+\ \ \ ...>\ }
+|\ \ created\ method\ square(int)
+
+jshell>\ square(b)
+$5\ ==>\ 64
+\f[R]
+.fi
+.SH EXAMPLE OF CHANGING SNIPPETS
+.PP
+Change the definition of a variable, method, or class by entering it
+again.
+.PP
+The following examples shows a method being defined and the method run:
+.IP
+.nf
+\f[CB]
+jshell>\ String\ grade(int\ testScore)\ {
+\ \ \ ...>\ \ \ \ \ if\ (testScore\ >=\ 90)\ {
+\ \ \ ...>\ \ \ \ \ \ \ \ \ return\ "Pass";
+\ \ \ ...>\ \ \ \ \ }
+\ \ \ ...>\ \ \ \ \ return\ "Fail";
+\ \ \ ...>\ }
+|\ \ created\ method\ grade(int)
+
+jshell>\ grade(88)
+$3\ ==>\ "Fail"
+\f[R]
+.fi
+.PP
+To change the method \f[CB]grade\f[R] to allow more students to pass,
+enter the method definition again and change the pass score to
+\f[CB]80\f[R].
+Use the up arrow key to retrieve the previous entries to avoid having to
+reenter them and make the change in the \f[CB]if\f[R] statement.
+The following example shows the new definition and reruns the method to
+show the new result:
+.IP
+.nf
+\f[CB]
+jshell>\ String\ grade(int\ testScore)\ {
+\ \ \ ...>\ \ \ \ \ if\ (testScore\ >=\ 80)\ {
+\ \ \ ...>\ \ \ \ \ \ \ \ \ return\ "Pass";
+\ \ \ ...>\ \ \ \ \ }
+\ \ \ ...>\ \ \ \ \ return\ "Fail";
+\ \ \ ...>\ }
+|\ \ modified\ method\ grade(int)
+
+jshell>\ grade(88)
+$5\ ==>\ "Pass"
+\f[R]
+.fi
+.PP
+For snippets that are more than a few lines long, or to make more than a
+few changes, use the \f[CB]/edit\f[R] command to open the snippet in an
+editor.
+After the changes are complete, close the edit window to return control
+to the JShell session.
+The following example shows the command and the feedback provided when
+the edit window is closed.
+The \f[CB]/list\f[R] command is used to show that the pass score was
+changed to \f[CB]85\f[R].
+.IP
+.nf
+\f[CB]
+jshell>\ /edit\ grade
+|\ \ modified\ method\ grade(int)
+jshell>\ /list\ grade
+
+\ \ \ 6\ :\ String\ grade(int\ testScore)\ {
+\ \ \ \ \ \ \ \ \ \ \ if\ (testScore\ >=\ 85)\ {
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ return\ "Pass";
+\ \ \ \ \ \ \ \ \ \ \ }
+\ \ \ \ \ \ \ \ \ \ \ return\ "Fail";
+\ \ \ \ \ \ \ }
+\f[R]
+.fi
+.SH EXAMPLE OF CREATING A CUSTOM FEEDBACK MODE
+.PP
+The feedback mode determines the prompt that\[aq]s displayed, the
+feedback messages that are provided as snippets are entered, and the
+maximum length of a displayed value.
+Predefined feedback modes are provided.
+Commands for creating custom feedback modes are also provided.
+.PP
+Use the \f[CB]/set\ mode\f[R] command to create a new feedback mode.
+In the following example, the new mode \f[CB]mymode\f[R], is based on the
+predefined feedback mode, \f[CB]normal\f[R], and verifying command
+feedback is displayed:
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ mode\ mymode\ normal\ \-command
+|\ \ Created\ new\ feedback\ mode:\ mymode
+\f[R]
+.fi
+.PP
+Because the new mode is based on the \f[CB]normal\f[R] mode, the prompts
+are the same.
+The following example shows how to see what prompts are used and then
+changes the prompts to custom strings.
+The first string represents the standard JShell prompt.
+The second string represents the prompt for additional lines in
+multiline snippets.
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ prompt\ mymode
+|\ \ /set\ prompt\ mymode\ "\\njshell>\ "\ "\ \ \ ...>\ "
+
+jshell>\ /set\ prompt\ mymode\ "\\nprompt$\ "\ "\ \ \ continue$\ "
+\f[R]
+.fi
+.PP
+The maximum length of a displayed value is controlled by the truncation
+setting.
+Different types of values can have different lengths.
+The following example sets an overall truncation value of 72, and a
+truncation value of 500 for variable value expressions:
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ truncation\ mymode\ 72
+
+jshell>\ /set\ truncation\ mymode\ 500\ varvalue
+\f[R]
+.fi
+.PP
+The feedback displayed after snippets are entered is controlled by the
+format setting and is based on the type of snippet entered and the
+action taken for that snippet.
+In the predefined mode \f[CB]normal\f[R], the string \f[CB]created\f[R] is
+displayed when a method is created.
+The following example shows how to change that string to
+\f[CB]defined\f[R]:
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ format\ mymode\ action\ "defined"\ added\-primary
+\f[R]
+.fi
+.PP
+Use the \f[CB]/set\ feedback\f[R] command to start using the feedback mode
+that was just created.
+The following example shows the custom mode in use:
+.IP
+.nf
+\f[CB]
+jshell>\ /set\ feedback\ mymode
+|\ \ Feedback\ mode:\ mymode
+
+prompt$\ int\ square\ (int\ num1){
+\ \ \ continue$\ return\ num1*num1;
+\ \ \ continue$\ }
+|\ \ defined\ method\ square(int)
+
+prompt$
+\f[R]
+.fi
diff --git a/java/temurin-17/man/man1/jstack.1 b/java/temurin-17/man/man1/jstack.1
new file mode 100644
index 0000000..efbe089
--- /dev/null
+++ b/java/temurin-17/man/man1/jstack.1
@@ -0,0 +1,83 @@
+.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JSTACK" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jstack \- print Java stack traces of Java threads for a specified Java
+process
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jstack\f[R] [\f[I]options\f[R]] \f[I]pid\f[R]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jstack\f[R] command\-line options.
+See \f[B]Options for the jstack Command\f[R].
+.RS
+.RE
+.TP
+.B \f[I]pid\f[R]
+The process ID for which the stack trace is printed.
+The process must be a Java process.
+To get a list of Java processes running on a machine, use either the
+\f[CB]ps\f[R] command or, if the JVM processes are not running in a
+separate docker instance, the \f[B]jps\f[R] command.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jstack\f[R] command prints Java stack traces of Java threads for
+a specified Java process.
+For each Java frame, the full class name, method name, byte code index
+(BCI), and line number, when available, are printed.
+C++ mangled names aren\[aq]t demangled.
+To demangle C++ names, the output of this command can be piped to
+\f[CB]c++filt\f[R].
+When the specified process is running on a 64\-bit JVM, you might need
+to specify the \f[CB]\-J\-d64\f[R] option, for example:
+\f[CB]jstack\ \-J\-d64\f[R] \f[I]pid\f[R].
+.PP
+\f[B]Note:\f[R]
+.PP
+This command is unsupported and might not be available in future
+releases of the JDK.
+In Windows Systems where the \f[CB]dbgeng.dll\f[R] file isn\[aq]t present,
+the Debugging Tools for Windows must be installed so that these tools
+work.
+The \f[CB]PATH\f[R] environment variable needs to contain the location of
+the \f[CB]jvm.dll\f[R] that is used by the target process, or the location
+from which the core dump file was produced.
+.SH OPTIONS FOR THE JSTACK COMMAND
+.TP
+.B \f[CB]\-l\f[R]
+The long listing option prints additional information about locks.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] or \f[CB]\-help\f[R]
+Prints a help message.
+.RS
+.RE
diff --git a/java/temurin-17/man/man1/jstat.1 b/java/temurin-17/man/man1/jstat.1
new file mode 100644
index 0000000..432a73d
--- /dev/null
+++ b/java/temurin-17/man/man1/jstat.1
@@ -0,0 +1,702 @@
+.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JSTAT" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jstat \- monitor JVM statistics
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jstat\f[R] \f[I]generalOptions\f[R]
+.PP
+\f[CB]jstat\f[R] \f[I]outputOptions\f[R] [\f[CB]\-t\f[R]] [\f[CB]\-h\f[R]
+\f[I]lines\f[R]] \f[I]vmid\f[R] [\f[I]interval\f[R] [\f[I]count\f[R]]]
+.TP
+.B \f[I]generalOptions\f[R]
+A single general command\-line option.
+See \f[B]General Options\f[R].
+.RS
+.RE
+.TP
+.B \f[I]outputOptions\f[R]
+An option reported by the \f[CB]\-options\f[R] option.
+One or more output options that consist of a single \f[CB]statOption\f[R],
+plus any of the \f[CB]\-t\f[R], \f[CB]\-h\f[R], and \f[CB]\-J\f[R] options.
+See \f[B]Output Options for the jstat Command\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-t\f[R]
+Displays a time\-stamp column as the first column of output.
+The time stamp is the time since the start time of the target JVM.
+.RS
+.RE
+.TP
+.B \f[CB]\-h\f[R] \f[I]n\f[R]
+Displays a column header every \f[I]n\f[R] samples (output rows), where
+\f[I]n\f[R] is a positive integer.
+The default value is \f[CB]0\f[R], which displays the column header of the
+first row of data.
+.RS
+.RE
+.TP
+.B \f[I]vmid\f[R]
+A virtual machine identifier, which is a string that indicates the
+target JVM.
+See \f[B]Virtual Machine Identifier\f[R].
+.RS
+.RE
+.TP
+.B \f[I]interval\f[R]
+The sampling interval in the specified units, seconds (s) or
+milliseconds (ms).
+Default units are milliseconds.
+This must be a positive integer.
+When specified, the \f[CB]jstat\f[R] command produces its output at each
+interval.
+.RS
+.RE
+.TP
+.B \f[I]count\f[R]
+The number of samples to display.
+The default value is infinity, which causes the \f[CB]jstat\f[R] command
+to display statistics until the target JVM terminates or the
+\f[CB]jstat\f[R] command is terminated.
+This value must be a positive integer.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jstat\f[R] command displays performance statistics for an
+instrumented Java HotSpot VM.
+The target JVM is identified by its virtual machine identifier, or
+\f[CB]vmid\f[R] option.
+.PP
+The \f[CB]jstat\f[R] command supports two types of options, general
+options and output options.
+General options cause the \f[CB]jstat\f[R] command to display simple usage
+and version information.
+Output options determine the content and format of the statistical
+output.
+.PP
+All options and their functionality are subject to change or removal in
+future releases.
+.SH GENERAL OPTIONS
+.PP
+If you specify one of the general options, then you can\[aq]t specify
+any other option or parameter.
+.TP
+.B \f[CB]\-help\f[R]
+Displays a help message.
+.RS
+.RE
+.TP
+.B \f[CB]\-options\f[R]
+Displays a list of static options.
+See \f[B]Output Options for the jstat Command\f[R].
+.RS
+.RE
+.SH OUTPUT OPTIONS FOR THE JSTAT COMMAND
+.PP
+If you don\[aq]t specify a general option, then you can specify output
+options.
+Output options determine the content and format of the \f[CB]jstat\f[R]
+command\[aq]s output, and consist of a single \f[CB]statOption\f[R], plus
+any of the other output options (\f[CB]\-h\f[R], \f[CB]\-t\f[R], and
+\f[CB]\-J\f[R]).
+The \f[CB]statOption\f[R] must come first.
+.PP
+Output is formatted as a table, with columns that are separated by
+spaces.
+A header row with titles describes the columns.
+Use the \f[CB]\-h\f[R] option to set the frequency at which the header is
+displayed.
+Column header names are consistent among the different options.
+In general, if two options provide a column with the same name, then the
+data source for the two columns is the same.
+.PP
+Use the \f[CB]\-t\f[R] option to display a time\-stamp column, labeled
+Timestamp as the first column of output.
+The Timestamp column contains the elapsed time, in seconds, since the
+target JVM started.
+The resolution of the time stamp is dependent on various factors and is
+subject to variation due to delayed thread scheduling on heavily loaded
+systems.
+.PP
+Use the interval and count parameters to determine how frequently and
+how many times, respectively, the \f[CB]jstat\f[R] command displays its
+output.
+.PP
+\f[B]Note:\f[R]
+.PP
+Don\[aq]t write scripts to parse the \f[CB]jstat\f[R] command\[aq]s output
+because the format might change in future releases.
+If you write scripts that parse the \f[CB]jstat\f[R] command output, then
+expect to modify them for future releases of this tool.
+.TP
+.B \f[CB]\-statOption\f[R]
+Determines the statistics information that the \f[CB]jstat\f[R] command
+displays.
+The following lists the available options.
+Use the \f[CB]\-options\f[R] general option to display the list of options
+for a particular platform installation.
+See \f[B]Stat Options and Output\f[R].
+.RS
+.PP
+\f[CB]class\f[R]: Displays statistics about the behavior of the class
+loader.
+.PP
+\f[CB]compiler\f[R]: Displays statistics about the behavior of the Java
+HotSpot VM Just\-in\-Time compiler.
+.PP
+\f[CB]gc\f[R]: Displays statistics about the behavior of the garbage
+collected heap.
+.PP
+\f[CB]gccapacity\f[R]: Displays statistics about the capacities of the
+generations and their corresponding spaces.
+.PP
+\f[CB]gccause\f[R]: Displays a summary about garbage collection statistics
+(same as \f[CB]\-gcutil\f[R]), with the cause of the last and current
+(when applicable) garbage collection events.
+.PP
+\f[CB]gcnew\f[R]: Displays statistics about the behavior of the new
+generation.
+.PP
+\f[CB]gcnewcapacity\f[R]: Displays statistics about the sizes of the new
+generations and their corresponding spaces.
+.PP
+\f[CB]gcold\f[R]: Displays statistics about the behavior of the old
+generation and metaspace statistics.
+.PP
+\f[CB]gcoldcapacity\f[R]: Displays statistics about the sizes of the old
+generation.
+.PP
+\f[CB]gcmetacapacity\f[R]: Displays statistics about the sizes of the
+metaspace.
+.PP
+\f[CB]gcutil\f[R]: Displays a summary about garbage collection statistics.
+.PP
+\f[CB]printcompilation\f[R]: Displays Java HotSpot VM compilation method
+statistics.
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]javaOption\f[R]
+Passes \f[I]javaOption\f[R] to the Java application launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+For a complete list of options, see \f[B]java\f[R].
+.RS
+.RE
+.SH STAT OPTIONS AND OUTPUT
+.PP
+The following information summarizes the columns that the \f[CB]jstat\f[R]
+command outputs for each \f[I]statOption\f[R].
+.TP
+.B \f[CB]\-class\f[R] \f[I]option\f[R]
+Class loader statistics.
+.RS
+.PP
+\f[CB]Loaded\f[R]: Number of classes loaded.
+.PP
+\f[CB]Bytes\f[R]: Number of KB loaded.
+.PP
+\f[CB]Unloaded\f[R]: Number of classes unloaded.
+.PP
+\f[CB]Bytes\f[R]: Number of KB unloaded.
+.PP
+\f[CB]Time\f[R]: Time spent performing class loading and unloading
+operations.
+.RE
+.TP
+.B \f[CB]\-compiler\f[R] \f[I]option\f[R]
+Java HotSpot VM Just\-in\-Time compiler statistics.
+.RS
+.PP
+\f[CB]Compiled\f[R]: Number of compilation tasks performed.
+.PP
+\f[CB]Failed\f[R]: Number of compilations tasks failed.
+.PP
+\f[CB]Invalid\f[R]: Number of compilation tasks that were invalidated.
+.PP
+\f[CB]Time\f[R]: Time spent performing compilation tasks.
+.PP
+\f[CB]FailedType\f[R]: Compile type of the last failed compilation.
+.PP
+\f[CB]FailedMethod\f[R]: Class name and method of the last failed
+compilation.
+.RE
+.TP
+.B \f[CB]\-gc\f[R] \f[I]option\f[R]
+Garbage collected heap statistics.
+.RS
+.PP
+\f[CB]S0C\f[R]: Current survivor space 0 capacity (KB).
+.PP
+\f[CB]S1C\f[R]: Current survivor space 1 capacity (KB).
+.PP
+\f[CB]S0U\f[R]: Survivor space 0 utilization (KB).
+.PP
+\f[CB]S1U\f[R]: Survivor space 1 utilization (KB).
+.PP
+\f[CB]EC\f[R]: Current eden space capacity (KB).
+.PP
+\f[CB]EU\f[R]: Eden space utilization (KB).
+.PP
+\f[CB]OC\f[R]: Current old space capacity (KB).
+.PP
+\f[CB]OU\f[R]: Old space utilization (KB).
+.PP
+\f[CB]MC\f[R]: Metaspace Committed Size (KB).
+.PP
+\f[CB]MU\f[R]: Metaspace utilization (KB).
+.PP
+\f[CB]CCSC\f[R]: Compressed class committed size (KB).
+.PP
+\f[CB]CCSU\f[R]: Compressed class space used (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation garbage collection (GC) events.
+.PP
+\f[CB]YGCT\f[R]: Young generation garbage collection time.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gccapacity\f[R] \f[I]option\f[R]
+Memory pool generation and space capacities.
+.RS
+.PP
+\f[CB]NGCMN\f[R]: Minimum new generation capacity (KB).
+.PP
+\f[CB]NGCMX\f[R]: Maximum new generation capacity (KB).
+.PP
+\f[CB]NGC\f[R]: Current new generation capacity (KB).
+.PP
+\f[CB]S0C\f[R]: Current survivor space 0 capacity (KB).
+.PP
+\f[CB]S1C\f[R]: Current survivor space 1 capacity (KB).
+.PP
+\f[CB]EC\f[R]: Current eden space capacity (KB).
+.PP
+\f[CB]OGCMN\f[R]: Minimum old generation capacity (KB).
+.PP
+\f[CB]OGCMX\f[R]: Maximum old generation capacity (KB).
+.PP
+\f[CB]OGC\f[R]: Current old generation capacity (KB).
+.PP
+\f[CB]OC\f[R]: Current old space capacity (KB).
+.PP
+\f[CB]MCMN\f[R]: Minimum metaspace capacity (KB).
+.PP
+\f[CB]MCMX\f[R]: Maximum metaspace capacity (KB).
+.PP
+\f[CB]MC\f[R]: Metaspace Committed Size (KB).
+.PP
+\f[CB]CCSMN\f[R]: Compressed class space minimum capacity (KB).
+.PP
+\f[CB]CCSMX\f[R]: Compressed class space maximum capacity (KB).
+.PP
+\f[CB]CCSC\f[R]: Compressed class committed size (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.RE
+.TP
+.B \f[CB]\-gccause\f[R] \f[I]option\f[R]
+This option displays the same summary of garbage collection statistics
+as the \f[CB]\-gcutil\f[R] option, but includes the causes of the last
+garbage collection event and (when applicable), the current garbage
+collection event.
+In addition to the columns listed for \f[CB]\-gcutil\f[R], this option
+adds the following columns:
+.RS
+.PP
+\f[CB]LGCC\f[R]: Cause of last garbage collection
+.PP
+\f[CB]GCC\f[R]: Cause of current garbage collection
+.RE
+.TP
+.B \f[CB]\-gcnew\f[R] \f[I]option\f[R]
+New generation statistics.
+.RS
+.PP
+\f[CB]S0C\f[R]: Current survivor space 0 capacity (KB).
+.PP
+\f[CB]S1C\f[R]: Current survivor space 1 capacity (KB).
+.PP
+\f[CB]S0U\f[R]: Survivor space 0 utilization (KB).
+.PP
+\f[CB]S1U\f[R]: Survivor space 1 utilization (KB).
+.PP
+\f[CB]TT\f[R]: Tenuring threshold.
+.PP
+\f[CB]MTT\f[R]: Maximum tenuring threshold.
+.PP
+\f[CB]DSS\f[R]: Desired survivor size (KB).
+.PP
+\f[CB]EC\f[R]: Current eden space capacity (KB).
+.PP
+\f[CB]EU\f[R]: Eden space utilization (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]YGCT\f[R]: Young generation garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gcnewcapacity\f[R] \f[I]option\f[R]
+New generation space size statistics.
+.RS
+.PP
+\f[CB]NGCMN\f[R]: Minimum new generation capacity (KB).
+.PP
+\f[CB]NGCMX\f[R]: Maximum new generation capacity (KB).
+.PP
+\f[CB]NGC\f[R]: Current new generation capacity (KB).
+.PP
+\f[CB]S0CMX\f[R]: Maximum survivor space 0 capacity (KB).
+.PP
+\f[CB]S0C\f[R]: Current survivor space 0 capacity (KB).
+.PP
+\f[CB]S1CMX\f[R]: Maximum survivor space 1 capacity (KB).
+.PP
+\f[CB]S1C\f[R]: Current survivor space 1 capacity (KB).
+.PP
+\f[CB]ECMX\f[R]: Maximum eden space capacity (KB).
+.PP
+\f[CB]EC\f[R]: Current eden space capacity (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.RE
+.TP
+.B \f[CB]\-gcold\f[R] \f[I]option\f[R]
+Old generation size statistics.
+.RS
+.PP
+\f[CB]MC\f[R]: Metaspace Committed Size (KB).
+.PP
+\f[CB]MU\f[R]: Metaspace utilization (KB).
+.PP
+\f[CB]CCSC\f[R]: Compressed class committed size (KB).
+.PP
+\f[CB]CCSU\f[R]: Compressed class space used (KB).
+.PP
+\f[CB]OC\f[R]: Current old space capacity (KB).
+.PP
+\f[CB]OU\f[R]: Old space utilization (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gcoldcapacity\f[R] \f[I]option\f[R]
+Old generation statistics.
+.RS
+.PP
+\f[CB]OGCMN\f[R]: Minimum old generation capacity (KB).
+.PP
+\f[CB]OGCMX\f[R]: Maximum old generation capacity (KB).
+.PP
+\f[CB]OGC\f[R]: Current old generation capacity (KB).
+.PP
+\f[CB]OC\f[R]: Current old space capacity (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gcmetacapacity\f[R] \f[I]option\f[R]
+Metaspace size statistics.
+.RS
+.PP
+\f[CB]MCMN\f[R]: Minimum metaspace capacity (KB).
+.PP
+\f[CB]MCMX\f[R]: Maximum metaspace capacity (KB).
+.PP
+\f[CB]MC\f[R]: Metaspace Committed Size (KB).
+.PP
+\f[CB]CCSMN\f[R]: Compressed class space minimum capacity (KB).
+.PP
+\f[CB]CCSMX\f[R]: Compressed class space maximum capacity (KB).
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-gcutil\f[R] \f[I]option\f[R]
+Summary of garbage collection statistics.
+.RS
+.PP
+\f[CB]S0\f[R]: Survivor space 0 utilization as a percentage of the
+space\[aq]s current capacity.
+.PP
+\f[CB]S1\f[R]: Survivor space 1 utilization as a percentage of the
+space\[aq]s current capacity.
+.PP
+\f[CB]E\f[R]: Eden space utilization as a percentage of the space\[aq]s
+current capacity.
+.PP
+\f[CB]O\f[R]: Old space utilization as a percentage of the space\[aq]s
+current capacity.
+.PP
+\f[CB]M\f[R]: Metaspace utilization as a percentage of the space\[aq]s
+current capacity.
+.PP
+\f[CB]CCS\f[R]: Compressed class space utilization as a percentage.
+.PP
+\f[CB]YGC\f[R]: Number of young generation GC events.
+.PP
+\f[CB]YGCT\f[R]: Young generation garbage collection time.
+.PP
+\f[CB]FGC\f[R]: Number of full GC events.
+.PP
+\f[CB]FGCT\f[R]: Full garbage collection time.
+.PP
+\f[CB]GCT\f[R]: Total garbage collection time.
+.RE
+.TP
+.B \f[CB]\-printcompilation\f[R] \f[I]option\f[R]
+Java HotSpot VM compiler method statistics.
+.RS
+.PP
+\f[CB]Compiled\f[R]: Number of compilation tasks performed by the most
+recently compiled method.
+.PP
+\f[CB]Size\f[R]: Number of bytes of byte code of the most recently
+compiled method.
+.PP
+\f[CB]Type\f[R]: Compilation type of the most recently compiled method.
+.PP
+\f[CB]Method\f[R]: Class name and method name identifying the most
+recently compiled method.
+Class name uses a slash (/) instead of a dot (.) as a name space
+separator.
+The method name is the method within the specified class.
+The format for these two fields is consistent with the HotSpot
+\f[CB]\-XX:+PrintCompilation\f[R] option.
+.RE
+.SH VIRTUAL MACHINE IDENTIFIER
+.PP
+The syntax of the \f[CB]vmid\f[R] string corresponds to the syntax of a
+URI:
+.RS
+.PP
+[\f[I]protocol\f[R]\f[CB]:\f[R]][\f[CB]//\f[R]]\f[I]lvmid\f[R][\f[CB]\@\f[R]\f[I]hostname\f[R][\f[CB]:\f[R]\f[I]port\f[R]][\f[CB]/\f[R]\f[I]servername\f[R]]
+.RE
+.PP
+The syntax of the \f[CB]vmid\f[R] string corresponds to the syntax of a
+URI.
+The \f[CB]vmid\f[R] string can vary from a simple integer that represents
+a local JVM to a more complex construction that specifies a
+communications protocol, port number, and other implementation\-specific
+values.
+.TP
+.B \f[I]protocol\f[R]
+The communications protocol.
+If the \f[I]protocol\f[R] value is omitted and a host name isn\[aq]t
+specified, then the default protocol is a platform\-specific optimized
+local protocol.
+If the \f[I]protocol\f[R] value is omitted and a host name is specified,
+then the default protocol is \f[CB]rmi\f[R].
+.RS
+.RE
+.TP
+.B \f[I]lvmid\f[R]
+The local virtual machine identifier for the target JVM.
+The \f[I]lvmid\f[R] is a platform\-specific value that uniquely
+identifies a JVM on a system.
+The \f[I]lvmid\f[R] is the only required component of a virtual machine
+identifier.
+The \f[I]lvmid\f[R] is typically, but not necessarily, the operating
+system\[aq]s process identifier for the target JVM process.
+You can use the \f[CB]jps\f[R] command to determine the \f[I]lvmid\f[R]
+provided the JVM processes is not running in a separate docker instance.
+You can also determine the \f[I]lvmid\f[R] on Linux and OS X platforms
+with the \f[CB]ps\f[R] command, and on Windows with the Windows Task
+Manager.
+.RS
+.RE
+.TP
+.B \f[I]hostname\f[R]
+A host name or IP address that indicates the target host.
+If the \f[I]hostname\f[R] value is omitted, then the target host is the
+local host.
+.RS
+.RE
+.TP
+.B \f[I]port\f[R]
+The default port for communicating with the remote server.
+If the \f[I]hostname\f[R] value is omitted or the \f[I]protocol\f[R] value
+specifies an optimized, local protocol, then the \f[I]port\f[R] value is
+ignored.
+Otherwise, treatment of the \f[I]port\f[R] parameter is
+implementation\-specific.
+For the default \f[CB]rmi\f[R] protocol, the port value indicates the port
+number for the \f[CB]rmiregistry\f[R] on the remote host.
+If the \f[I]port\f[R] value is omitted and the \f[I]protocol\f[R] value
+indicates \f[CB]rmi\f[R], then the default rmiregistry port (1099) is
+used.
+.RS
+.RE
+.TP
+.B \f[I]servername\f[R]
+The treatment of the \f[I]servername\f[R] parameter depends on
+implementation.
+For the optimized local protocol, this field is ignored.
+For the \f[CB]rmi\f[R] protocol, it represents the name of the RMI remote
+object on the remote host.
+.RS
+.RE
+.SH EXAMPLES
+.PP
+This section presents some examples of monitoring a local JVM with an
+\f[I]lvmid\f[R] of 21891.
+.SH THE GCUTIL OPTION
+.PP
+This example attaches to lvmid 21891 and takes 7 samples at 250
+millisecond intervals and displays the output as specified by the
+\f[CB]\-gcutil\f[R] option.
+.PP
+The output of this example shows that a young generation collection
+occurred between the third and fourth sample.
+The collection took 0.078 seconds and promoted objects from the eden
+space (E) to the old space (O), resulting in an increase of old space
+utilization from 66.80% to 68.19%.
+Before the collection, the survivor space was 97.02% utilized, but after
+this collection it\[aq]s 91.03% utilized.
+.IP
+.nf
+\f[CB]
+jstat\ \-gcutil\ 21891\ 250\ 7
+\ \ S0\ \ \ \ \ S1\ \ \ \ \ E\ \ \ \ \ \ O\ \ \ \ \ \ M\ \ \ \ \ CCS\ \ \ \ YGC\ \ \ \ \ YGCT\ \ \ \ FGC\ \ \ \ FGCT\ \ \ \ \ GCT
+\ \ 0.00\ \ 97.02\ \ 70.31\ \ 66.80\ \ 95.52\ \ 89.14\ \ \ \ \ \ 7\ \ \ \ 0.300\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.300
+\ \ 0.00\ \ 97.02\ \ 86.23\ \ 66.80\ \ 95.52\ \ 89.14\ \ \ \ \ \ 7\ \ \ \ 0.300\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.300
+\ \ 0.00\ \ 97.02\ \ 96.53\ \ 66.80\ \ 95.52\ \ 89.14\ \ \ \ \ \ 7\ \ \ \ 0.300\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.300
+\ 91.03\ \ \ 0.00\ \ \ 1.98\ \ 68.19\ \ 95.89\ \ 91.24\ \ \ \ \ \ 8\ \ \ \ 0.378\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.378
+\ 91.03\ \ \ 0.00\ \ 15.82\ \ 68.19\ \ 95.89\ \ 91.24\ \ \ \ \ \ 8\ \ \ \ 0.378\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.378
+\ 91.03\ \ \ 0.00\ \ 17.80\ \ 68.19\ \ 95.89\ \ 91.24\ \ \ \ \ \ 8\ \ \ \ 0.378\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.378
+\ 91.03\ \ \ 0.00\ \ 17.80\ \ 68.19\ \ 95.89\ \ 91.24\ \ \ \ \ \ 8\ \ \ \ 0.378\ \ \ \ \ 0\ \ \ \ 0.000\ \ \ \ 0.378
+\f[R]
+.fi
+.SH REPEAT THE COLUMN HEADER STRING
+.PP
+This example attaches to lvmid 21891 and takes samples at 250
+millisecond intervals and displays the output as specified by
+\f[CB]\-gcnew\f[R] option.
+In addition, it uses the \f[CB]\-h3\f[R] option to output the column
+header after every 3 lines of data.
+.PP
+In addition to showing the repeating header string, this example shows
+that between the second and third samples, a young GC occurred.
+Its duration was 0.001 seconds.
+The collection found enough active data that the survivor space 0
+utilization (S0U) would have exceeded the desired survivor size (DSS).
+As a result, objects were promoted to the old generation (not visible in
+this output), and the tenuring threshold (TT) was lowered from 31 to 2.
+.PP
+Another collection occurs between the fifth and sixth samples.
+This collection found very few survivors and returned the tenuring
+threshold to 31.
+.IP
+.nf
+\f[CB]
+jstat\ \-gcnew\ \-h3\ 21891\ 250
+\ S0C\ \ \ \ S1C\ \ \ \ S0U\ \ \ \ S1U\ \ \ TT\ MTT\ \ DSS\ \ \ \ \ \ EC\ \ \ \ \ \ \ EU\ \ \ \ \ YGC\ \ \ \ \ YGCT
+\ \ 64.0\ \ \ 64.0\ \ \ \ 0.0\ \ \ 31.7\ 31\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 178.6\ \ \ \ 249\ \ \ \ 0.203
+\ \ 64.0\ \ \ 64.0\ \ \ \ 0.0\ \ \ 31.7\ 31\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 355.5\ \ \ \ 249\ \ \ \ 0.203
+\ \ 64.0\ \ \ 64.0\ \ \ 35.4\ \ \ \ 0.0\ \ 2\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ \ 21.9\ \ \ \ 250\ \ \ \ 0.204
+\ S0C\ \ \ \ S1C\ \ \ \ S0U\ \ \ \ S1U\ \ \ TT\ MTT\ \ DSS\ \ \ \ \ \ EC\ \ \ \ \ \ \ EU\ \ \ \ \ YGC\ \ \ \ \ YGCT
+\ \ 64.0\ \ \ 64.0\ \ \ 35.4\ \ \ \ 0.0\ \ 2\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 245.9\ \ \ \ 250\ \ \ \ 0.204
+\ \ 64.0\ \ \ 64.0\ \ \ 35.4\ \ \ \ 0.0\ \ 2\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 421.1\ \ \ \ 250\ \ \ \ 0.204
+\ \ 64.0\ \ \ 64.0\ \ \ \ 0.0\ \ \ 19.0\ 31\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ \ 84.4\ \ \ \ 251\ \ \ \ 0.204
+\ S0C\ \ \ \ S1C\ \ \ \ S0U\ \ \ \ S1U\ \ \ TT\ MTT\ \ DSS\ \ \ \ \ \ EC\ \ \ \ \ \ \ EU\ \ \ \ \ YGC\ \ \ \ \ YGCT
+\ \ 64.0\ \ \ 64.0\ \ \ \ 0.0\ \ \ 19.0\ 31\ \ 31\ \ \ 32.0\ \ \ \ 512.0\ \ \ \ 306.7\ \ \ \ 251\ \ \ \ 0.204
+\f[R]
+.fi
+.SH INCLUDE A TIME STAMP FOR EACH SAMPLE
+.PP
+This example attaches to lvmid 21891 and takes 3 samples at 250
+millisecond intervals.
+The \f[CB]\-t\f[R] option is used to generate a time stamp for each sample
+in the first column.
+.PP
+The Timestamp column reports the elapsed time in seconds since the start
+of the target JVM.
+In addition, the \f[CB]\-gcoldcapacity\f[R] output shows the old
+generation capacity (OGC) and the old space capacity (OC) increasing as
+the heap expands to meet allocation or promotion demands.
+The old generation capacity (OGC) has grown from 11,696 KB to 13,820 KB
+after the eighty\-first full garbage collection (FGC).
+The maximum capacity of the generation (and space) is 60,544 KB (OGCMX),
+so it still has room to expand.
+.IP
+.nf
+\f[CB]
+Timestamp\ \ \ \ \ \ OGCMN\ \ \ \ OGCMX\ \ \ \ \ OGC\ \ \ \ \ \ \ OC\ \ \ \ \ \ \ YGC\ \ \ FGC\ \ \ \ FGCT\ \ \ \ GCT
+\ \ \ \ \ \ \ \ \ \ 150.1\ \ \ 1408.0\ \ 60544.0\ \ 11696.0\ \ 11696.0\ \ \ 194\ \ \ \ 80\ \ \ \ 2.874\ \ \ 3.799
+\ \ \ \ \ \ \ \ \ \ 150.4\ \ \ 1408.0\ \ 60544.0\ \ 13820.0\ \ 13820.0\ \ \ 194\ \ \ \ 81\ \ \ \ 2.938\ \ \ 3.863
+\ \ \ \ \ \ \ \ \ \ 150.7\ \ \ 1408.0\ \ 60544.0\ \ 13820.0\ \ 13820.0\ \ \ 194\ \ \ \ 81\ \ \ \ 2.938\ \ \ 3.863
+\f[R]
+.fi
+.SH MONITOR INSTRUMENTATION FOR A REMOTE JVM
+.PP
+This example attaches to lvmid 40496 on the system named
+\f[CB]remote.domain\f[R] using the \f[CB]\-gcutil\f[R] option, with samples
+taken every second indefinitely.
+.PP
+The lvmid is combined with the name of the remote host to construct a
+vmid of \f[CB]40496\@remote.domain\f[R].
+This vmid results in the use of the \f[CB]rmi\f[R] protocol to communicate
+to the default \f[CB]jstatd\f[R] server on the remote host.
+The \f[CB]jstatd\f[R] server is located using the \f[CB]rmiregistry\f[R]
+command on \f[CB]remote.domain\f[R] that\[aq]s bound to the default port
+of the \f[CB]rmiregistry\f[R] command (port 1099).
+.IP
+.nf
+\f[CB]
+jstat\ \-gcutil\ 40496\@remote.domain\ 1000
+\&...\ output\ omitted
+\f[R]
+.fi
diff --git a/java/temurin-17/man/man1/jstatd.1 b/java/temurin-17/man/man1/jstatd.1
new file mode 100644
index 0000000..4361f55
--- /dev/null
+++ b/java/temurin-17/man/man1/jstatd.1
@@ -0,0 +1,217 @@
+.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "JSTATD" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+jstatd \- monitor the creation and termination of instrumented Java
+HotSpot VMs
+.SH SYNOPSIS
+.PP
+\f[B]Note:\f[R] This command is experimental and unsupported.
+.PP
+\f[CB]jstatd\f[R] [\f[I]options\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the \f[CB]jstatd\f[R] command\-line options.
+See \f[B]Options for the jstatd Command\f[R].
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]jstatd\f[R] command is an RMI server application that monitors
+for the creation and termination of instrumented Java HotSpot VMs and
+provides an interface to enable remote monitoring tools, \f[CB]jstat\f[R]
+and \f[CB]jps\f[R], to attach to JVMs that are running on the local host
+and collect information about the JVM process.
+.PP
+The \f[CB]jstatd\f[R] server requires an RMI registry on the local host.
+The \f[CB]jstatd\f[R] server attempts to attach to the RMI registry on the
+default port, or on the port you specify with the \f[CB]\-p\f[R]
+\f[CB]port\f[R] option.
+If an RMI registry is not found, then one is created within the
+\f[CB]jstatd\f[R] application that\[aq]s bound to the port that\[aq]s
+indicated by the \f[CB]\-p\f[R] \f[CB]port\f[R] option or to the default RMI
+registry port when the \f[CB]\-p\f[R] \f[CB]port\f[R] option is omitted.
+You can stop the creation of an internal RMI registry by specifying the
+\f[CB]\-nr\f[R] option.
+.SH OPTIONS FOR THE JSTATD COMMAND
+.TP
+.B \f[CB]\-nr\f[R]
+This option does not attempt to create an internal RMI registry within
+the \f[CB]jstatd\f[R] process when an existing RMI registry isn\[aq]t
+found.
+.RS
+.RE
+.TP
+.B \f[CB]\-p\f[R] \f[I]port\f[R]
+This option sets the port number where the RMI registry is expected to
+be found, or when not found, created if the \f[CB]\-nr\f[R] option
+isn\[aq]t specified.
+.RS
+.RE
+.TP
+.B \f[CB]\-r\f[R] \f[I]rmiport\f[R]
+This option sets the port number to which the RMI connector is bound.
+If not specified a random available port is used.
+.RS
+.RE
+.TP
+.B \f[CB]\-n\f[R] \f[I]rminame\f[R]
+This option sets the name to which the remote RMI object is bound in the
+RMI registry.
+The default name is \f[CB]JStatRemoteHost\f[R].
+If multiple \f[CB]jstatd\f[R] servers are started on the same host, then
+the name of the exported RMI object for each server can be made unique
+by specifying this option.
+However, doing so requires that the unique server name be included in
+the monitoring client\[aq]s \f[CB]hostid\f[R] and \f[CB]vmid\f[R] strings.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+This option passes a Java \f[CB]option\f[R] to the JVM, where the option
+is one of those described on the reference page for the Java application
+launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+See \f[B]java\f[R].
+.RS
+.RE
+.SH SECURITY
+.PP
+The \f[CB]jstatd\f[R] server can monitor only JVMs for which it has the
+appropriate native access permissions.
+Therefore, the \f[CB]jstatd\f[R] process must be running with the same
+user credentials as the target JVMs.
+Some user credentials, such as the root user in Linux and OS X operating
+systems, have permission to access the instrumentation exported by any
+JVM on the system.
+A \f[CB]jstatd\f[R] process running with such credentials can monitor any
+JVM on the system, but introduces additional security concerns.
+.PP
+The \f[CB]jstatd\f[R] server doesn\[aq]t provide any authentication of
+remote clients.
+Therefore, running a \f[CB]jstatd\f[R] server process exposes the
+instrumentation export by all JVMs for which the \f[CB]jstatd\f[R] process
+has access permissions to any user on the network.
+This exposure might be undesirable in your environment, and therefore,
+local security policies should be considered before you start the
+\f[CB]jstatd\f[R] process, particularly in production environments or on
+networks that aren\[aq]t secure.
+.PP
+The \f[CB]jstatd\f[R] server installs an instance of
+\f[CB]RMISecurityPolicy\f[R] when no other security manager is installed,
+and therefore, requires a security policy file to be specified.
+The policy file must conform to Default Policy Implementation and Policy
+File Syntax.
+.PP
+If your security concerns can\[aq]t be addressed with a customized
+policy file, then the safest action is to not run the \f[CB]jstatd\f[R]
+server and use the \f[CB]jstat\f[R] and \f[CB]jps\f[R] tools locally.
+However, when using \f[CB]jps\f[R] to get a list of instrumented JVMs, the
+list will not include any JVMs running in docker containers.
+.SH REMOTE INTERFACE
+.PP
+The interface exported by the \f[CB]jstatd\f[R] process is proprietary and
+guaranteed to change.
+Users and developers are discouraged from writing to this interface.
+.SH EXAMPLES
+.PP
+The following are examples of the \f[CB]jstatd\f[R] command.
+The \f[CB]jstatd\f[R] scripts automatically start the server in the
+background.
+.SH INTERNAL RMI REGISTRY
+.PP
+This example shows how to start a \f[CB]jstatd\f[R] session with an
+internal RMI registry.
+This example assumes that no other server is bound to the default RMI
+registry port (port \f[CB]1099\f[R]).
+.RS
+.PP
+\f[CB]jstatd\ \-J\-Djava.security.policy=all.policy\f[R]
+.RE
+.SH EXTERNAL RMI REGISTRY
+.PP
+This example starts a \f[CB]jstatd\f[R] session with an external RMI
+registry.
+.IP
+.nf
+\f[CB]
+rmiregistry&
+jstatd\ \-J\-Djava.security.policy=all.policy
+\f[R]
+.fi
+.PP
+This example starts a \f[CB]jstatd\f[R] session with an external RMI
+registry server on port \f[CB]2020\f[R].
+.IP
+.nf
+\f[CB]
+jrmiregistry\ 2020&
+jstatd\ \-J\-Djava.security.policy=all.policy\ \-p\ 2020
+\f[R]
+.fi
+.PP
+This example starts a \f[CB]jstatd\f[R] session with an external RMI
+registry server on port \f[CB]2020\f[R] and JMX connector bound to port
+\f[CB]2021\f[R].
+.IP
+.nf
+\f[CB]
+jrmiregistry\ 2020&
+jstatd\ \-J\-Djava.security.policy=all.policy\ \-p\ 2020\ \-r\ 2021
+\f[R]
+.fi
+.PP
+This example starts a \f[CB]jstatd\f[R] session with an external RMI
+registry on port 2020 that\[aq]s bound to
+\f[CB]AlternateJstatdServerName\f[R].
+.IP
+.nf
+\f[CB]
+rmiregistry\ 2020&
+jstatd\ \-J\-Djava.security.policy=all.policy\ \-p\ 2020\ \-n\ AlternateJstatdServerName
+\f[R]
+.fi
+.SH STOP THE CREATION OF AN IN\-PROCESS RMI REGISTRY
+.PP
+This example starts a \f[CB]jstatd\f[R] session that doesn\[aq]t create an
+RMI registry when one isn\[aq]t found.
+This example assumes an RMI registry is already running.
+If an RMI registry isn\[aq]t running, then an error message is
+displayed.
+.RS
+.PP
+\f[CB]jstatd\ \-J\-Djava.security.policy=all.policy\ \-nr\f[R]
+.RE
+.SH ENABLE RMI LOGGING
+.PP
+This example starts a \f[CB]jstatd\f[R] session with RMI logging
+capabilities enabled.
+This technique is useful as a troubleshooting aid or for monitoring
+server activities.
+.RS
+.PP
+\f[CB]jstatd\ \-J\-Djava.security.policy=all.policy\ \-J\-Djava.rmi.server.logCalls=true\f[R]
+.RE
diff --git a/java/temurin-17/man/man1/keytool.1 b/java/temurin-17/man/man1/keytool.1
new file mode 100644
index 0000000..eda4c2c
--- /dev/null
+++ b/java/temurin-17/man/man1/keytool.1
@@ -0,0 +1,2965 @@
+.\" Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"t
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "KEYTOOL" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+keytool \- a key and certificate management utility
+.SH SYNOPSIS
+.PP
+\f[CB]keytool\f[R] [\f[I]commands\f[R]]
+.TP
+.B \f[I]commands\f[R]
+Commands for \f[CB]keytool\f[R] include the following:
+.RS
+.IP \[bu] 2
+\f[CB]\-certreq\f[R]: Generates a certificate request
+.IP \[bu] 2
+\f[CB]\-changealias\f[R]: Changes an entry\[aq]s alias
+.IP \[bu] 2
+\f[CB]\-delete\f[R]: Deletes an entry
+.IP \[bu] 2
+\f[CB]\-exportcert\f[R]: Exports certificate
+.IP \[bu] 2
+\f[CB]\-genkeypair\f[R]: Generates a key pair
+.IP \[bu] 2
+\f[CB]\-genseckey\f[R]: Generates a secret key
+.IP \[bu] 2
+\f[CB]\-gencert\f[R]: Generates a certificate from a certificate request
+.IP \[bu] 2
+\f[CB]\-importcert\f[R]: Imports a certificate or a certificate chain
+.IP \[bu] 2
+\f[CB]\-importpass\f[R]: Imports a password
+.IP \[bu] 2
+\f[CB]\-importkeystore\f[R]: Imports one or all entries from another
+keystore
+.IP \[bu] 2
+\f[CB]\-keypasswd\f[R]: Changes the key password of an entry
+.IP \[bu] 2
+\f[CB]\-list\f[R]: Lists entries in a keystore
+.IP \[bu] 2
+\f[CB]\-printcert\f[R]: Prints the content of a certificate
+.IP \[bu] 2
+\f[CB]\-printcertreq\f[R]: Prints the content of a certificate request
+.IP \[bu] 2
+\f[CB]\-printcrl\f[R]: Prints the content of a Certificate Revocation List
+(CRL) file
+.IP \[bu] 2
+\f[CB]\-storepasswd\f[R]: Changes the store password of a keystore
+.IP \[bu] 2
+\f[CB]\-showinfo\f[R]: Displays security\-related information
+.PP
+See \f[B]Commands and Options\f[R] for a description of these commands
+with their options.
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]keytool\f[R] command is a key and certificate management
+utility.
+It enables users to administer their own public/private key pairs and
+associated certificates for use in self\-authentication (where a user
+authenticates themselves to other users and services) or data integrity
+and authentication services, by using digital signatures.
+The \f[CB]keytool\f[R] command also enables users to cache the public keys
+(in the form of certificates) of their communicating peers.
+.PP
+A certificate is a digitally signed statement from one entity (person,
+company, and so on), which says that the public key (and some other
+information) of some other entity has a particular value.
+When data is digitally signed, the signature can be verified to check
+the data integrity and authenticity.
+Integrity means that the data hasn\[aq]t been modified or tampered with,
+and authenticity means that the data comes from the individual who
+claims to have created and signed it.
+.PP
+The \f[CB]keytool\f[R] command also enables users to administer secret
+keys and passphrases used in symmetric encryption and decryption (Data
+Encryption Standard).
+It can also display other security\-related information.
+.PP
+The \f[CB]keytool\f[R] command stores the keys and certificates in a
+keystore.
+.PP
+The \f[CB]keytool\f[R] command uses the
+\f[CB]jdk.certpath.disabledAlgorithms\f[R] and
+\f[CB]jdk.security.legacyAlgorithms\f[R] security properties to determine
+which algorithms are considered a security risk.
+It emits warnings when disabled or legacy algorithms are being used.
+The \f[CB]jdk.certpath.disabledAlgorithms\f[R] and
+\f[CB]jdk.security.legacyAlgorithms\f[R] security properties are defined
+in the \f[CB]java.security\f[R] file (located in the JDK\[aq]s
+\f[CB]$JAVA_HOME/conf/security\f[R] directory).
+.SH COMMAND AND OPTION NOTES
+.PP
+The following notes apply to the descriptions in \f[B]Commands and
+Options\f[R]:
+.IP \[bu] 2
+All command and option names are preceded by a hyphen sign
+(\f[CB]\-\f[R]).
+.IP \[bu] 2
+Only one command can be provided.
+.IP \[bu] 2
+Options for each command can be provided in any order.
+.IP \[bu] 2
+There are two kinds of options, one is single\-valued which should be
+only provided once.
+If a single\-valued option is provided multiple times, the value of the
+last one is used.
+The other type is multi\-valued, which can be provided multiple times
+and all values are used.
+The only multi\-valued option currently supported is the \f[CB]\-ext\f[R]
+option used to generate X.509v3 certificate extensions.
+.IP \[bu] 2
+All items not italicized or in braces ({ }) or brackets ([ ]) are
+required to appear as is.
+.IP \[bu] 2
+Braces surrounding an option signify that a default value is used when
+the option isn\[aq]t specified on the command line.
+Braces are also used around the \f[CB]\-v\f[R], \f[CB]\-rfc\f[R], and
+\f[CB]\-J\f[R] options, which have meaning only when they appear on the
+command line.
+They don\[aq]t have any default values.
+.IP \[bu] 2
+Brackets surrounding an option signify that the user is prompted for the
+values when the option isn\[aq]t specified on the command line.
+For the \f[CB]\-keypass\f[R] option, if you don\[aq]t specify the option
+on the command line, then the \f[CB]keytool\f[R] command first attempts to
+use the keystore password to recover the private/secret key.
+If this attempt fails, then the \f[CB]keytool\f[R] command prompts you for
+the private/secret key password.
+.IP \[bu] 2
+Items in italics (option values) represent the actual values that must
+be supplied.
+For example, here is the format of the \f[CB]\-printcert\f[R] command:
+.RS 2
+.RS
+.PP
+\f[CB]keytool\ \-printcert\f[R] {\f[CB]\-file\f[R] \f[I]cert_file\f[R]}
+{\f[CB]\-v\f[R]}
+.RE
+.PP
+When you specify a \f[CB]\-printcert\f[R] command, replace
+\f[I]cert_file\f[R] with the actual file name, as follows:
+\f[CB]keytool\ \-printcert\ \-file\ VScert.cer\f[R]
+.RE
+.IP \[bu] 2
+Option values must be enclosed in quotation marks when they contain a
+blank (space).
+.SH COMMANDS AND OPTIONS
+.PP
+The keytool commands and their options can be grouped by the tasks that
+they perform.
+.PP
+\f[B]Commands for Creating or Adding Data to the Keystore\f[R]:
+.IP \[bu] 2
+\f[CB]\-gencert\f[R]
+.IP \[bu] 2
+\f[CB]\-genkeypair\f[R]
+.IP \[bu] 2
+\f[CB]\-genseckey\f[R]
+.IP \[bu] 2
+\f[CB]\-importcert\f[R]
+.IP \[bu] 2
+\f[CB]\-importpass\f[R]
+.PP
+\f[B]Commands for Importing Contents from Another Keystore\f[R]:
+.IP \[bu] 2
+\f[CB]\-importkeystore\f[R]
+.PP
+\f[B]Commands for Generating a Certificate Request\f[R]:
+.IP \[bu] 2
+\f[CB]\-certreq\f[R]
+.PP
+\f[B]Commands for Exporting Data\f[R]:
+.IP \[bu] 2
+\f[CB]\-exportcert\f[R]
+.PP
+\f[B]Commands for Displaying Data\f[R]:
+.IP \[bu] 2
+\f[CB]\-list\f[R]
+.IP \[bu] 2
+\f[CB]\-printcert\f[R]
+.IP \[bu] 2
+\f[CB]\-printcertreq\f[R]
+.IP \[bu] 2
+\f[CB]\-printcrl\f[R]
+.PP
+\f[B]Commands for Managing the Keystore\f[R]:
+.IP \[bu] 2
+\f[CB]\-storepasswd\f[R]
+.IP \[bu] 2
+\f[CB]\-keypasswd\f[R]
+.IP \[bu] 2
+\f[CB]\-delete\f[R]
+.IP \[bu] 2
+\f[CB]\-changealias\f[R]
+.PP
+\f[B]Commands for Displaying Security\-related Information\f[R]:
+.IP \[bu] 2
+\f[CB]\-showinfo\f[R]
+.SH COMMANDS FOR CREATING OR ADDING DATA TO THE KEYSTORE
+.TP
+.B \f[CB]\-gencert\f[R]
+The following are the available options for the \f[CB]\-gencert\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-rfc\f[R]}: Output in RFC (Request For Comment) style
+.IP \[bu] 2
+{\f[CB]\-infile\f[R] \f[I]infile\f[R]}: Input file name
+.IP \[bu] 2
+{\f[CB]\-outfile\f[R] \f[I]outfile\f[R]}: Output file name
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-sigalg\f[R] \f[I]sigalg\f[R]}: Signature algorithm name
+.IP \[bu] 2
+{\f[CB]\-dname\f[R] \f[I]dname\f[R]}: Distinguished name
+.IP \[bu] 2
+{\f[CB]\-startdate\f[R] \f[I]startdate\f[R]}: Certificate validity start
+date and time
+.IP \[bu] 2
+{\f[CB]\-ext\f[R] \f[I]ext\f[R]}*: X.509 extension
+.IP \[bu] 2
+{\f[CB]\-validity\f[R] \f[I]days\f[R]}: Validity number of days
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Adds a security provider by name (such as SunPKCS11)
+with an optional configure argument.
+The value of the security provider is the name of a security provider
+that is defined in a module.
+.RS 2
+.PP
+For example,
+.RS
+.PP
+\f[CB]keytool\ \-addprovider\ SunPKCS11\ \-providerarg\ some.cfg\ ...\f[R]
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+For compatibility reasons, the SunPKCS11 provider can still be loaded
+with \f[CB]\-providerclass\ sun.security.pkcs11.SunPKCS11\f[R] even if it
+is now defined in a module.
+This is the only module included in the JDK that needs a configuration,
+and therefore the most widely used with the \f[CB]\-providerclass\f[R]
+option.
+For legacy security providers located on classpath and loaded by
+reflection, \f[CB]\-providerclass\f[R] should still be used.
+.RE
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.RS 2
+.PP
+For example, if \f[CB]MyProvider\f[R] is a legacy provider loaded via
+reflection,
+.RS
+.PP
+\f[CB]keytool\ \-providerclass\ com.example.MyProvider\ ...\f[R]
+.RE
+.RE
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-gencert\f[R] command to generate a certificate as a
+response to a certificate request file (which can be created by the
+\f[CB]keytool\ \-certreq\f[R] command).
+The command reads the request either from \f[I]infile\f[R] or, if
+omitted, from the standard input, signs it by using the alias\[aq]s
+private key, and outputs the X.509 certificate into either
+\f[I]outfile\f[R] or, if omitted, to the standard output.
+When \f[CB]\-rfc\f[R] is specified, the output format is Base64\-encoded
+PEM; otherwise, a binary DER is created.
+.PP
+The \f[CB]\-sigalg\f[R] value specifies the algorithm that should be used
+to sign the certificate.
+The \f[I]startdate\f[R] argument is the start time and date that the
+certificate is valid.
+The \f[I]days\f[R] argument tells the number of days for which the
+certificate should be considered valid.
+.PP
+When \f[I]dname\f[R] is provided, it is used as the subject of the
+generated certificate.
+Otherwise, the one from the certificate request is used.
+.PP
+The \f[CB]\-ext\f[R] value shows what X.509 extensions will be embedded in
+the certificate.
+Read \f[B]Common Command Options\f[R] for the grammar of \f[CB]\-ext\f[R].
+.PP
+The \f[CB]\-gencert\f[R] option enables you to create certificate chains.
+The following example creates a certificate, \f[CB]e1\f[R], that contains
+three certificates in its certificate chain.
+.PP
+The following commands creates four key pairs named \f[CB]ca\f[R],
+\f[CB]ca1\f[R], \f[CB]ca2\f[R], and \f[CB]e1\f[R]:
+.IP
+.nf
+\f[CB]
+keytool\ \-alias\ ca\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa
+keytool\ \-alias\ ca1\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa
+keytool\ \-alias\ ca2\ \-dname\ CN=CA\ \-genkeypair\ \-keyalg\ rsa
+keytool\ \-alias\ e1\ \-dname\ CN=E1\ \-genkeypair\ \-keyalg\ rsa
+\f[R]
+.fi
+.PP
+The following two commands create a chain of signed certificates;
+\f[CB]ca\f[R] signs \f[CB]ca1\f[R] and \f[CB]ca1\f[R] signs \f[CB]ca2\f[R], all
+of which are self\-issued:
+.IP
+.nf
+\f[CB]
+keytool\ \-alias\ ca1\ \-certreq\ |
+\ \ \ \ keytool\ \-alias\ ca\ \-gencert\ \-ext\ san=dns:ca1\ |
+\ \ \ \ keytool\ \-alias\ ca1\ \-importcert
+
+keytool\ \-alias\ ca2\ \-certreq\ |
+\ \ \ \ keytool\ \-alias\ ca1\ \-gencert\ \-ext\ san=dns:ca2\ |
+\ \ \ \ keytool\ \-alias\ ca2\ \-importcert
+\f[R]
+.fi
+.PP
+The following command creates the certificate \f[CB]e1\f[R] and stores it
+in the \f[CB]e1.cert\f[R] file, which is signed by \f[CB]ca2\f[R].
+As a result, \f[CB]e1\f[R] should contain \f[CB]ca\f[R], \f[CB]ca1\f[R], and
+\f[CB]ca2\f[R] in its certificate chain:
+.RS
+.PP
+\f[CB]keytool\ \-alias\ e1\ \-certreq\ |\ keytool\ \-alias\ ca2\ \-gencert\ >\ e1.cert\f[R]
+.RE
+.RE
+.TP
+.B \f[CB]\-genkeypair\f[R]
+The following are the available options for the \f[CB]\-genkeypair\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+\f[CB]\-keyalg\f[R] \f[I]alg\f[R]: Key algorithm name
+.IP \[bu] 2
+{\f[CB]\-keysize\f[R] \f[I]size\f[R]}: Key bit size
+.IP \[bu] 2
+{\f[CB]\-groupname\f[R] \f[I]name\f[R]}: Group name.
+For example, an Elliptic Curve name.
+.IP \[bu] 2
+{\f[CB]\-sigalg\f[R] \f[I]alg\f[R]}: Signature algorithm name
+.IP \[bu] 2
+{\f[CB]\-signer\f[R] \f[I]alias\f[R]}: Signer alias
+.IP \[bu] 2
+[\f[CB]\-signerkeypass\f[R] \f[I]arg\f[R]]: Signer key password
+.IP \[bu] 2
+[\f[CB]\-dname\f[R] \f[I]name\f[R]]: Distinguished name
+.IP \[bu] 2
+{\f[CB]\-startdate\f[R] \f[I]date\f[R]}: Certificate validity start date
+and time
+.IP \[bu] 2
+{\f[CB]\-ext\f[R] \f[I]value\f[R]}*: X.509 extension
+.IP \[bu] 2
+{\f[CB]\-validity\f[R] \f[I]days\f[R]}: Validity number of days
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]] }: Add security provider by fully qualified class name
+with an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-genkeypair\f[R] command to generate a key pair (a public
+key and associated private key).
+When the \f[CB]\-signer\f[R] option is not specified, the public key is
+wrapped in an X.509 v3 self\-signed certificate and stored as a
+single\-element certificate chain.
+When the \f[CB]\-signer\f[R] option is specified, a new certificate is
+generated and signed by the designated signer and stored as a
+multiple\-element certificate chain (containing the generated
+certificate itself, and the signer???s certificate chain).
+The certificate chain and private key are stored in a new keystore entry
+that is identified by its alias.
+.PP
+The \f[CB]\-keyalg\f[R] value specifies the algorithm to be used to
+generate the key pair, and the \f[CB]\-keysize\f[R] value specifies the
+size of each key to be generated.
+The \f[CB]\-sigalg\f[R] value specifies the algorithm that should be used
+to sign the certificate.
+This algorithm must be compatible with the \f[CB]\-keyalg\f[R] value.
+.PP
+The \f[CB]\-groupname\f[R] value specifies the named group (for example,
+the standard or predefined name of an Elliptic Curve) of the key to be
+generated.
+Only one of \f[CB]\-groupname\f[R] and \f[CB]\-keysize\f[R] can be
+specified.
+.PP
+The \f[CB]\-signer\f[R] value specifies the alias of a
+\f[CB]PrivateKeyEntry\f[R] for the signer that already exists in the
+keystore.
+This option is used to sign the certificate with the signer???s private
+key.
+This is especially useful for key agreement algorithms (i.e.
+the \f[CB]\-keyalg\f[R] value is \f[CB]XDH\f[R], \f[CB]X25519\f[R],
+\f[CB]X448\f[R], or \f[CB]DH\f[R]) as these keys cannot be used for digital
+signatures, and therefore a self\-signed certificate cannot be created.
+.PP
+The \f[CB]\-signerkeypass\f[R] value specifies the password of the
+signer???s private key.
+It can be specified if the private key of the signer entry is protected
+by a password different from the store password.
+.PP
+The \f[CB]\-dname\f[R] value specifies the X.500 Distinguished Name to be
+associated with the value of \f[CB]\-alias\f[R].
+If the \f[CB]\-signer\f[R] option is not specified, the issuer and subject
+fields of the self\-signed certificate are populated with the specified
+distinguished name.
+If the \f[CB]\-signer\f[R] option is specified, the subject field of the
+certificate is populated with the specified distinguished name and the
+issuer field is populated with the subject field of the signer\[aq]s
+certificate.
+If a distinguished name is not provided at the command line, then the
+user is prompted for one.
+.PP
+The value of \f[CB]\-keypass\f[R] is a password used to protect the
+private key of the generated key pair.
+If a password is not provided, then the user is prompted for it.
+If you press the \f[B]Return\f[R] key at the prompt, then the key
+password is set to the same password as the keystore password.
+The \f[CB]\-keypass\f[R] value must have at least six characters.
+.PP
+The value of \f[CB]\-startdate\f[R] specifies the issue time of the
+certificate, also known as the "Not Before" value of the X.509
+certificate\[aq]s Validity field.
+.PP
+The option value can be set in one of these two forms:
+.PP
+([\f[CB]+\-\f[R]]\f[I]nnn\f[R][\f[CB]ymdHMS\f[R]])+
+.PP
+[\f[I]yyyy\f[R]\f[CB]/\f[R]\f[I]mm\f[R]\f[CB]/\f[R]\f[I]dd\f[R]]
+[\f[I]HH\f[R]\f[CB]:\f[R]\f[I]MM\f[R]\f[CB]:\f[R]\f[I]SS\f[R]]
+.PP
+With the first form, the issue time is shifted by the specified value
+from the current time.
+The value is a concatenation of a sequence of subvalues.
+Inside each subvalue, the plus sign (+) means shift forward, and the
+minus sign (\-) means shift backward.
+The time to be shifted is \f[I]nnn\f[R] units of years, months, days,
+hours, minutes, or seconds (denoted by a single character of \f[CB]y\f[R],
+\f[CB]m\f[R], \f[CB]d\f[R], \f[CB]H\f[R], \f[CB]M\f[R], or \f[CB]S\f[R]
+respectively).
+The exact value of the issue time is calculated by using the
+\f[CB]java.util.GregorianCalendar.add(int\ field,\ int\ amount)\f[R]
+method on each subvalue, from left to right.
+For example, the issue time can be specified by:
+.IP
+.nf
+\f[CB]
+Calendar\ c\ =\ new\ GregorianCalendar();
+c.add(Calendar.YEAR,\ \-1);
+c.add(Calendar.MONTH,\ 1);
+c.add(Calendar.DATE,\ \-1);
+return\ c.getTime()
+\f[R]
+.fi
+.PP
+With the second form, the user sets the exact issue time in two parts,
+year/month/day and hour:minute:second (using the local time zone).
+The user can provide only one part, which means the other part is the
+same as the current date (or time).
+The user must provide the exact number of digits shown in the format
+definition (padding with 0 when shorter).
+When both date and time are provided, there is one (and only one) space
+character between the two parts.
+The hour should always be provided in 24\-hour format.
+.PP
+When the option isn\[aq]t provided, the start date is the current time.
+The option can only be provided one time.
+.PP
+The value of \f[I]date\f[R] specifies the number of days (starting at the
+date specified by \f[CB]\-startdate\f[R], or the current date when
+\f[CB]\-startdate\f[R] isn\[aq]t specified) for which the certificate
+should be considered valid.
+.RE
+.TP
+.B \f[CB]\-genseckey\f[R]
+The following are the available options for the \f[CB]\-genseckey\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+\f[CB]\-keyalg\f[R] \f[I]alg\f[R]: Key algorithm name
+.IP \[bu] 2
+{\f[CB]\-keysize\f[R] \f[I]size\f[R]}: Key bit size
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-genseckey\f[R] command to generate a secret key and store
+it in a new \f[CB]KeyStore.SecretKeyEntry\f[R] identified by
+\f[CB]alias\f[R].
+.PP
+The value of \f[CB]\-keyalg\f[R] specifies the algorithm to be used to
+generate the secret key, and the value of \f[CB]\-keysize\f[R] specifies
+the size of the key that is generated.
+The \f[CB]\-keypass\f[R] value is a password that protects the secret key.
+If a password is not provided, then the user is prompted for it.
+If you press the \f[B]Return\f[R] key at the prompt, then the key
+password is set to the same password that is used for the
+\f[CB]\-keystore\f[R].
+The \f[CB]\-keypass\f[R] value must contain at least six characters.
+.RE
+.TP
+.B \f[CB]\-importcert\f[R]
+The following are the available options for the \f[CB]\-importcert\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-noprompt\f[R]}: Do not prompt
+.IP \[bu] 2
+{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]file\f[R]}: Input file name
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-importcert\f[R] command to read the certificate or
+certificate chain (where the latter is supplied in a PKCS#7 formatted
+reply or in a sequence of X.509 certificates) from \f[CB]\-file\f[R]
+\f[I]file\f[R], and store it in the \f[CB]keystore\f[R] entry identified by
+\f[CB]\-alias\f[R].
+If \f[CB]\-file\f[R] \f[I]file\f[R] is not specified, then the certificate
+or certificate chain is read from \f[CB]stdin\f[R].
+.PP
+The \f[CB]keytool\f[R] command can import X.509 v1, v2, and v3
+certificates, and PKCS#7 formatted certificate chains consisting of
+certificates of that type.
+The data to be imported must be provided either in binary encoding
+format or in printable encoding format (also known as Base64 encoding)
+as defined by the Internet RFC 1421 standard.
+In the latter case, the encoding must be bounded at the beginning by a
+string that starts with \f[CB]\-\-\-\-\-BEGIN\f[R], and bounded at the end
+by a string that starts with \f[CB]\-\-\-\-\-END\f[R].
+.PP
+You import a certificate for two reasons: To add it to the list of
+trusted certificates, and to import a certificate reply received from a
+certificate authority (CA) as the result of submitting a Certificate
+Signing Request (CSR) to that CA.
+See the \f[CB]\-certreq\f[R] command in \f[B]Commands for Generating a
+Certificate Request\f[R].
+.PP
+The type of import is indicated by the value of the \f[CB]\-alias\f[R]
+option.
+If the alias doesn\[aq]t point to a key entry, then the \f[CB]keytool\f[R]
+command assumes you are adding a trusted certificate entry.
+In this case, the alias shouldn\[aq]t already exist in the keystore.
+If the alias does exist, then the \f[CB]keytool\f[R] command outputs an
+error because a trusted certificate already exists for that alias, and
+doesn\[aq]t import the certificate.
+If \f[CB]\-alias\f[R] points to a key entry, then the \f[CB]keytool\f[R]
+command assumes that you\[aq]re importing a certificate reply.
+.RE
+.TP
+.B \f[CB]\-importpass\f[R]
+The following are the available options for the \f[CB]\-importpass\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keyalg\f[R] \f[I]alg\f[R]}: Key algorithm name
+.IP \[bu] 2
+{\f[CB]\-keysize\f[R] \f[I]size\f[R]}: Key bit size
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-importpass\f[R] command to imports a passphrase and store
+it in a new \f[CB]KeyStore.SecretKeyEntry\f[R] identified by
+\f[CB]\-alias\f[R].
+The passphrase may be supplied via the standard input stream; otherwise
+the user is prompted for it.
+The \f[CB]\-keypass\f[R] option provides a password to protect the
+imported passphrase.
+If a password is not provided, then the user is prompted for it.
+If you press the \f[B]Return\f[R] key at the prompt, then the key
+password is set to the same password as that used for the
+\f[CB]keystore\f[R].
+The \f[CB]\-keypass\f[R] value must contain at least six characters.
+.RE
+.SH COMMANDS FOR IMPORTING CONTENTS FROM ANOTHER KEYSTORE
+.TP
+.B \f[CB]\-importkeystore\f[R]
+The following are the available options for the
+\f[CB]\-importkeystore\f[R] command:
+.RS
+.IP \[bu] 2
+\f[CB]\-srckeystore\f[R] \f[I]keystore\f[R]: Source keystore name
+.IP \[bu] 2
+{\f[CB]\-destkeystore\f[R] \f[I]keystore\f[R]}: Destination keystore name
+.IP \[bu] 2
+{\f[CB]\-srcstoretype\f[R] \f[I]type\f[R]}: Source keystore type
+.IP \[bu] 2
+{\f[CB]\-deststoretype\f[R] \f[I]type\f[R]}: Destination keystore type
+.IP \[bu] 2
+[\f[CB]\-srcstorepass\f[R] \f[I]arg\f[R]]: Source keystore password
+.IP \[bu] 2
+[\f[CB]\-deststorepass\f[R] \f[I]arg\f[R]]: Destination keystore password
+.IP \[bu] 2
+{\f[CB]\-srcprotected\f[R]}: Source keystore password protected
+.IP \[bu] 2
+{\f[CB]\-destprotected\f[R]}: Destination keystore password protected
+.IP \[bu] 2
+{\f[CB]\-srcprovidername\f[R] \f[I]name\f[R]}: Source keystore provider
+name
+.IP \[bu] 2
+{\f[CB]\-destprovidername\f[R] \f[I]name\f[R]}: Destination keystore
+provider name
+.IP \[bu] 2
+{\f[CB]\-srcalias\f[R] \f[I]alias\f[R]}: Source alias
+.IP \[bu] 2
+{\f[CB]\-destalias\f[R] \f[I]alias\f[R]}: Destination alias
+.IP \[bu] 2
+[\f[CB]\-srckeypass\f[R] \f[I]arg\f[R]]: Source key password
+.IP \[bu] 2
+[\f[CB]\-destkeypass\f[R] \f[I]arg\f[R]]: Destination key password
+.IP \[bu] 2
+{\f[CB]\-noprompt\f[R]}: Do not prompt
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]: Add security provider by name (such as SunPKCS11) with an
+optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+\f[B]Note:\f[R]
+.PP
+This is the first line of all options:
+.RS
+.PP
+\f[CB]\-srckeystore\f[R] \f[I]keystore\f[R] \f[CB]\-destkeystore\f[R]
+\f[I]keystore\f[R]
+.RE
+.PP
+Use the \f[CB]\-importkeystore\f[R] command to import a single entry or
+all entries from a source keystore to a destination keystore.
+.PP
+\f[B]Note:\f[R]
+.PP
+If you do not specify \f[CB]\-destkeystore\f[R] when using the
+\f[CB]keytool\ \-importkeystore\f[R] command, then the default keystore
+used is \f[CB]$HOME/.keystore\f[R].
+.PP
+When the \f[CB]\-srcalias\f[R] option is provided, the command imports the
+single entry identified by the alias to the destination keystore.
+If a destination alias isn\[aq]t provided with \f[CB]\-destalias\f[R],
+then \f[CB]\-srcalias\f[R] is used as the destination alias.
+If the source entry is protected by a password, then
+\f[CB]\-srckeypass\f[R] is used to recover the entry.
+If \f[CB]\-srckeypass\f[R] isn\[aq]t provided, then the \f[CB]keytool\f[R]
+command attempts to use \f[CB]\-srcstorepass\f[R] to recover the entry.
+If \f[CB]\-srcstorepass\f[R] is not provided or is incorrect, then the
+user is prompted for a password.
+The destination entry is protected with \f[CB]\-destkeypass\f[R].
+If \f[CB]\-destkeypass\f[R] isn\[aq]t provided, then the destination entry
+is protected with the source entry password.
+For example, most third\-party tools require \f[CB]storepass\f[R] and
+\f[CB]keypass\f[R] in a PKCS #12 keystore to be the same.
+To create a PKCS#12 keystore for these tools, always specify a
+\f[CB]\-destkeypass\f[R] that is the same as \f[CB]\-deststorepass\f[R].
+.PP
+If the \f[CB]\-srcalias\f[R] option isn\[aq]t provided, then all entries
+in the source keystore are imported into the destination keystore.
+Each destination entry is stored under the alias from the source entry.
+If the source entry is protected by a password, then
+\f[CB]\-srcstorepass\f[R] is used to recover the entry.
+If \f[CB]\-srcstorepass\f[R] is not provided or is incorrect, then the
+user is prompted for a password.
+If a source keystore entry type isn\[aq]t supported in the destination
+keystore, or if an error occurs while storing an entry into the
+destination keystore, then the user is prompted either to skip the entry
+and continue or to quit.
+The destination entry is protected with the source entry password.
+.PP
+If the destination alias already exists in the destination keystore,
+then the user is prompted either to overwrite the entry or to create a
+new entry under a different alias name.
+.PP
+If the \f[CB]\-noprompt\f[R] option is provided, then the user isn\[aq]t
+prompted for a new destination alias.
+Existing entries are overwritten with the destination alias name.
+Entries that can\[aq]t be imported are skipped and a warning is
+displayed.
+.RE
+.SH COMMANDS FOR GENERATING A CERTIFICATE REQUEST
+.TP
+.B \f[CB]\-certreq\f[R]
+The following are the available options for the \f[CB]\-certreq\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-sigalg\f[R] \f[I]alg\f[R]}: Signature algorithm name
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]file\f[R]}: Output file name
+.IP \[bu] 2
+[ \f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-dname\f[R] \f[I]name\f[R]}: Distinguished name
+.IP \[bu] 2
+{\f[CB]\-ext\f[R] \f[I]value\f[R]}: X.509 extension
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-certreq\f[R] command to generate a Certificate Signing
+Request (CSR) using the PKCS #10 format.
+.PP
+A CSR is intended to be sent to a CA.
+The CA authenticates the certificate requestor (usually offline) and
+returns a certificate or certificate chain to replace the existing
+certificate chain (initially a self\-signed certificate) in the
+keystore.
+.PP
+The private key associated with \f[I]alias\f[R] is used to create the
+PKCS #10 certificate request.
+To access the private key, the correct password must be provided.
+If \f[CB]\-keypass\f[R] isn\[aq]t provided at the command line and is
+different from the password used to protect the integrity of the
+keystore, then the user is prompted for it.
+If \f[CB]\-dname\f[R] is provided, then it is used as the subject in the
+CSR.
+Otherwise, the X.500 Distinguished Name associated with alias is used.
+.PP
+The \f[CB]\-sigalg\f[R] value specifies the algorithm that should be used
+to sign the CSR.
+.PP
+The CSR is stored in the \f[CB]\-file\f[R] \f[I]file\f[R].
+If a file is not specified, then the CSR is output to \f[CB]\-stdout\f[R].
+.PP
+Use the \f[CB]\-importcert\f[R] command to import the response from the
+CA.
+.RE
+.SH COMMANDS FOR EXPORTING DATA
+.TP
+.B \f[CB]\-exportcert\f[R]
+The following are the available options for the \f[CB]\-exportcert\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-rfc\f[R]}: Output in RFC style
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]file\f[R]}: Output file name
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]] }: Add security provider by fully qualified class name
+with an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-exportcert\f[R] command to read a certificate from the
+keystore that is associated with \f[CB]\-alias\f[R] \f[I]alias\f[R] and
+store it in the \f[CB]\-file\f[R] \f[I]file\f[R].
+When a file is not specified, the certificate is output to
+\f[CB]stdout\f[R].
+.PP
+By default, the certificate is output in binary encoding.
+If the \f[CB]\-rfc\f[R] option is specified, then the output in the
+printable encoding format defined by the Internet RFC 1421 Certificate
+Encoding Standard.
+.PP
+If \f[CB]\-alias\f[R] refers to a trusted certificate, then that
+certificate is output.
+Otherwise, \f[CB]\-alias\f[R] refers to a key entry with an associated
+certificate chain.
+In that case, the first certificate in the chain is returned.
+This certificate authenticates the public key of the entity addressed by
+\f[CB]\-alias\f[R].
+.RE
+.SH COMMANDS FOR DISPLAYING DATA
+.TP
+.B \f[CB]\-list\f[R]
+The following are the available options for the \f[CB]\-list\f[R] command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-rfc\f[R]}: Output in RFC style
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]] }: Add security provider by fully qualified class name
+with an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-list\f[R] command to print the contents of the keystore
+entry identified by \f[CB]\-alias\f[R] to \f[CB]stdout\f[R].
+If \f[CB]\-alias\f[R] \f[I]alias\f[R] is not specified, then the contents
+of the entire keystore are printed.
+.PP
+By default, this command prints the SHA\-256 fingerprint of a
+certificate.
+If the \f[CB]\-v\f[R] option is specified, then the certificate is printed
+in human\-readable format, with additional information such as the
+owner, issuer, serial number, and any extensions.
+If the \f[CB]\-rfc\f[R] option is specified, then the certificate contents
+are printed by using the printable encoding format, as defined by the
+Internet RFC 1421 Certificate Encoding Standard.
+.PP
+\f[B]Note:\f[R]
+.PP
+You can\[aq]t specify both \f[CB]\-v\f[R] and \f[CB]\-rfc\f[R] in the same
+command.
+Otherwise, an error is reported.
+.RE
+.TP
+.B \f[CB]\-printcert\f[R]
+The following are the available options for the \f[CB]\-printcert\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-rfc\f[R]}: Output in RFC style
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]cert_file\f[R]}: Input file name
+.IP \[bu] 2
+{\f[CB]\-sslserver\f[R] \f[I]server\f[R][\f[CB]:\f[R]\f[I]port\f[R]]}:: Secure
+Sockets Layer (SSL) server host and port
+.IP \[bu] 2
+{\f[CB]\-jarfile\f[R] \f[I]JAR_file\f[R]}: Signed \f[CB]\&.jar\f[R] file
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-printcert\f[R] command to read and print the certificate
+from \f[CB]\-file\f[R] \f[I]cert_file\f[R], the SSL server located at
+\f[CB]\-sslserver\f[R] \f[I]server\f[R][\f[CB]:\f[R]\f[I]port\f[R]], or the
+signed JAR file specified by \f[CB]\-jarfile\f[R] \f[I]JAR_file\f[R].
+It prints its contents in a human\-readable format.
+When a port is not specified, the standard HTTPS port 443 is assumed.
+.PP
+\f[B]Note:\f[R]
+.PP
+The \f[CB]\-sslserver\f[R] and \f[CB]\-file\f[R] options can\[aq]t be
+provided in the same command.
+Otherwise, an error is reported.
+If you don\[aq]t specify either option, then the certificate is read
+from \f[CB]stdin\f[R].
+.PP
+When\f[CB]\-rfc\f[R] is specified, the \f[CB]keytool\f[R] command prints the
+certificate in PEM mode as defined by the Internet RFC 1421 Certificate
+Encoding standard.
+.PP
+If the certificate is read from a file or \f[CB]stdin\f[R], then it might
+be either binary encoded or in printable encoding format, as defined by
+the RFC 1421 Certificate Encoding standard.
+.PP
+If the SSL server is behind a firewall, then the
+\f[CB]\-J\-Dhttps.proxyHost=proxyhost\f[R] and
+\f[CB]\-J\-Dhttps.proxyPort=proxyport\f[R] options can be specified on the
+command line for proxy tunneling.
+.PP
+\f[B]Note:\f[R]
+.PP
+This command can be used independently of a keystore.
+This command does not check for the weakness of a certificate\[aq]s
+signature algorithm if it is a trusted certificate in the user keystore
+(specified by \f[CB]\-keystore\f[R]) or in the \f[CB]cacerts\f[R] keystore
+(if \f[CB]\-trustcacerts\f[R] is specified).
+.RE
+.TP
+.B \f[CB]\-printcertreq\f[R]
+The following are the available options for the \f[CB]\-printcertreq\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-file\f[R] \f[I]file\f[R]}: Input file name
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-printcertreq\f[R] command to print the contents of a PKCS
+#10 format certificate request, which can be generated by the
+\f[CB]keytool\ \-certreq\f[R] command.
+The command reads the request from file.
+If there is no file, then the request is read from the standard input.
+.RE
+.TP
+.B \f[CB]\-printcrl\f[R]
+The following are the available options for the \f[CB]\-printcrl\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-file\ crl\f[R]}: Input file name
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-printcrl\f[R] command to read the Certificate Revocation
+List (CRL) from \f[CB]\-file\ crl\f[R] .
+A CRL is a list of the digital certificates that were revoked by the CA
+that issued them.
+The CA generates the \f[CB]crl\f[R] file.
+.PP
+\f[B]Note:\f[R]
+.PP
+This command can be used independently of a keystore.
+This command attempts to verify the CRL using a certificate from the
+user keystore (specified by \f[CB]\-keystore\f[R]) or the \f[CB]cacerts\f[R]
+keystore (if \f[CB]\-trustcacerts\f[R] is specified), and will print out a
+warning if it cannot be verified.
+.RE
+.SH COMMANDS FOR MANAGING THE KEYSTORE
+.TP
+.B \f[CB]\-storepasswd\f[R]
+The following are the available options for the \f[CB]\-storepasswd\f[R]
+command:
+.RS
+.IP \[bu] 2
+[\f[CB]\-new\f[R] \f[I]arg\f[R]]: New password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-storepasswd\f[R] command to change the password used to
+protect the integrity of the keystore contents.
+The new password is set by \f[CB]\-new\f[R] \f[I]arg\f[R] and must contain
+at least six characters.
+.RE
+.TP
+.B \f[CB]\-keypasswd\f[R]
+The following are the available options for the \f[CB]\-keypasswd\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]old_keypass\f[R]]: Key password
+.IP \[bu] 2
+[\f[CB]\-new\f[R] \f[I]new_keypass\f[R]]: New password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-storepass\f[R] \f[I]arg\f[R]}: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-keypasswd\f[R] command to change the password (under which
+private/secret keys identified by \f[CB]\-alias\f[R] are protected) from
+\f[CB]\-keypass\f[R] \f[I]old_keypass\f[R] to \f[CB]\-new\f[R]
+\f[I]new_keypass\f[R].
+The password value must contain at least six characters.
+.PP
+If the \f[CB]\-keypass\f[R] option isn\[aq]t provided at the command line
+and the \f[CB]\-keypass\f[R] password is different from the keystore
+password (\f[CB]\-storepass\f[R] \f[I]arg\f[R]), then the user is prompted
+for it.
+.PP
+If the \f[CB]\-new\f[R] option isn\[aq]t provided at the command line,
+then the user is prompted for it.
+.RE
+.TP
+.B \f[CB]\-delete\f[R]
+The following are the available options for the \f[CB]\-delete\f[R]
+command:
+.RS
+.IP \[bu] 2
+[\f[CB]\-alias\f[R] \f[I]alias\f[R]]: Alias name of the entry to process
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-delete\f[R] command to delete the \f[CB]\-alias\f[R]
+\f[I]alias\f[R] entry from the keystore.
+When not provided at the command line, the user is prompted for the
+\f[CB]alias\f[R].
+.RE
+.TP
+.B \f[CB]\-changealias\f[R]
+The following are the available options for the \f[CB]\-changealias\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-alias\f[R] \f[I]alias\f[R]}: Alias name of the entry to process
+.IP \[bu] 2
+[\f[CB]\-destalias\f[R] \f[I]alias\f[R]]: Destination alias
+.IP \[bu] 2
+[\f[CB]\-keypass\f[R] \f[I]arg\f[R]]: Key password
+.IP \[bu] 2
+{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
+.IP \[bu] 2
+{\f[CB]\-cacerts\f[R]}: Access the cacerts keystore
+.IP \[bu] 2
+[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
+.IP \[bu] 2
+{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
+.IP \[bu] 2
+{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
+.IP \[bu] 2
+{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
+\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
+an optional configure argument.
+.IP \[bu] 2
+{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.IP \[bu] 2
+{\f[CB]\-protected\f[R]}: Password provided through a protected mechanism
+.PP
+Use the \f[CB]\-changealias\f[R] command to move an existing keystore
+entry from \f[CB]\-alias\f[R] \f[I]alias\f[R] to a new \f[CB]\-destalias\f[R]
+\f[I]alias\f[R].
+If a destination alias is not provided, then the command prompts you for
+one.
+If the original entry is protected with an entry password, then the
+password can be supplied with the \f[CB]\-keypass\f[R] option.
+If a key password is not provided, then the \f[CB]\-storepass\f[R] (if
+provided) is attempted first.
+If the attempt fails, then the user is prompted for a password.
+.RE
+.SH COMMANDS FOR DISPLAYING SECURITY\-RELATED INFORMATION
+.TP
+.B \f[CB]\-showinfo\f[R]
+The following are the available options for the \f[CB]\-showinfo\f[R]
+command:
+.RS
+.IP \[bu] 2
+{\f[CB]\-tls\f[R]}: Displays TLS configuration information
+.IP \[bu] 2
+{\f[CB]\-v\f[R]}: Verbose output
+.PP
+Use the \f[CB]\-showinfo\f[R] command to display various security\-related
+information.
+The \f[CB]\-tls\f[R] option displays TLS configurations, such as the list
+of enabled protocols and cipher suites.
+.RE
+.SH COMMANDS FOR DISPLAYING HELP INFORMATION
+.PP
+You can use \f[CB]\-\-help\f[R] to display a list of \f[CB]keytool\f[R]
+commands or to display help information about a specific
+\f[CB]keytool\f[R] command.
+.IP \[bu] 2
+To display a list of \f[CB]keytool\f[R] commands, enter:
+.RS 2
+.RS
+.PP
+\f[CB]keytool\ \-\-help\f[R]
+.RE
+.RE
+.IP \[bu] 2
+To display help information about a specific \f[CB]keytool\f[R] command,
+enter:
+.RS 2
+.RS
+.PP
+\f[CB]keytool\ \-<command>\ \-\-help\f[R]
+.RE
+.RE
+.SH COMMON COMMAND OPTIONS
+.PP
+The \f[CB]\-v\f[R] option can appear for all commands except
+\f[CB]\-\-help\f[R].
+When the \f[CB]\-v\f[R] option appears, it signifies verbose mode, which
+means that more information is provided in the output.
+.PP
+The \f[CB]\-J\f[R]\f[I]option\f[R] argument can appear for any command.
+When the \f[CB]\-J\f[R]\f[I]option\f[R] is used, the specified
+\f[I]option\f[R] string is passed directly to the Java interpreter.
+This option doesn\[aq]t contain any spaces.
+It\[aq]s useful for adjusting the execution environment or memory usage.
+For a list of possible interpreter options, enter \f[CB]java\ \-h\f[R] or
+\f[CB]java\ \-X\f[R] at the command line.
+.PP
+These options can appear for all commands operating on a keystore:
+.TP
+.B \f[CB]\-storetype\f[R] \f[I]storetype\f[R]
+This qualifier specifies the type of keystore to be instantiated.
+.RS
+.RE
+.TP
+.B \f[CB]\-keystore\f[R] \f[I]keystore\f[R]
+The keystore location.
+.RS
+.PP
+If the JKS \f[CB]storetype\f[R] is used and a keystore file doesn\[aq]t
+yet exist, then certain \f[CB]keytool\f[R] commands can result in a new
+keystore file being created.
+For example, if \f[CB]keytool\ \-genkeypair\f[R] is called and the
+\f[CB]\-keystore\f[R] option isn\[aq]t specified, the default keystore
+file named \f[CB]\&.keystore\f[R] is created in the user\[aq]s home
+directory if it doesn\[aq]t already exist.
+Similarly, if the \f[CB]\-keystore\ ks_file\f[R] option is specified but
+\f[CB]ks_file\f[R] doesn\[aq]t exist, then it is created.
+For more information on the JKS \f[CB]storetype\f[R], see the
+\f[B]KeyStore Implementation\f[R] section in \f[B]KeyStore aliases\f[R].
+.PP
+Note that the input stream from the \f[CB]\-keystore\f[R] option is passed
+to the \f[CB]KeyStore.load\f[R] method.
+If \f[CB]NONE\f[R] is specified as the URL, then a null stream is passed
+to the \f[CB]KeyStore.load\f[R] method.
+\f[CB]NONE\f[R] should be specified if the keystore isn\[aq]t file\-based.
+For example, when the keystore resides on a hardware token device.
+.RE
+.TP
+.B \f[CB]\-cacerts\f[R] \f[I]cacerts\f[R]
+Operates on the \f[I]cacerts\f[R] keystore .
+This option is equivalent to \f[CB]\-keystore\f[R]
+\f[I]path_to_cacerts\f[R] \f[CB]\-storetype\f[R] \f[I]type_of_cacerts\f[R].
+An error is reported if the \f[CB]\-keystore\f[R] or \f[CB]\-storetype\f[R]
+option is used with the \f[CB]\-cacerts\f[R] option.
+.RS
+.RE
+.TP
+.B \f[CB]\-storepass\f[R] [\f[CB]:env\f[R] | \f[CB]:file\f[R] ] \f[I]argument\f[R]
+The password that is used to protect the integrity of the keystore.
+.RS
+.PP
+If the modifier \f[CB]env\f[R] or \f[CB]file\f[R] isn\[aq]t specified, then
+the password has the value \f[I]argument\f[R], which must contain at
+least six characters.
+Otherwise, the password is retrieved as follows:
+.IP \[bu] 2
+\f[CB]env\f[R]: Retrieve the password from the environment variable named
+\f[I]argument\f[R].
+.IP \[bu] 2
+\f[CB]file\f[R]: Retrieve the password from the file named
+\f[I]argument\f[R].
+.PP
+\f[B]Note:\f[R] All other options that require passwords, such as
+\f[CB]\-keypass\f[R], \f[CB]\-srckeypass\f[R], \f[CB]\-destkeypass\f[R],
+\f[CB]\-srcstorepass\f[R], and \f[CB]\-deststorepass\f[R], accept the
+\f[CB]env\f[R] and \f[CB]file\f[R] modifiers.
+Remember to separate the password option and the modifier with a colon
+(:).
+.PP
+The password must be provided to all commands that access the keystore
+contents.
+For such commands, when the \f[CB]\-storepass\f[R] option isn\[aq]t
+provided at the command line, the user is prompted for it.
+.PP
+When retrieving information from the keystore, the password is optional.
+If a password is not specified, then the integrity of the retrieved
+information can\[aq]t be verified and a warning is displayed.
+.RE
+.TP
+.B \f[CB]\-providername\f[R] \f[I]name\f[R]
+Used to identify a cryptographic service provider\[aq]s name when listed
+in the security properties file.
+.RS
+.RE
+.TP
+.B \f[CB]\-addprovider\f[R] \f[I]name\f[R]
+Used to add a security provider by name (such as SunPKCS11) .
+.RS
+.RE
+.TP
+.B \f[CB]\-providerclass\f[R] \f[I]class\f[R]
+Used to specify the name of a cryptographic service provider\[aq]s
+master class file when the service provider isn\[aq]t listed in the
+security properties file.
+.RS
+.RE
+.TP
+.B \f[CB]\-providerpath\f[R] \f[I]list\f[R]
+Used to specify the provider classpath.
+.RS
+.RE
+.TP
+.B \f[CB]\-providerarg\f[R] \f[I]arg\f[R]
+Used with the \f[CB]\-addprovider\f[R] or \f[CB]\-providerclass\f[R] option
+to represent an optional string input argument for the constructor of
+\f[I]class\f[R] name.
+.RS
+.RE
+.TP
+.B \f[CB]\-protected=true\f[R]|\f[CB]false\f[R]
+Specify this value as \f[CB]true\f[R] when a password must be specified by
+way of a protected authentication path, such as a dedicated PIN reader.
+Because there are two keystores involved in the
+\f[CB]\-importkeystore\f[R] command, the following two options,
+\f[CB]\-srcprotected\f[R] and \f[CB]\-destprotected\f[R], are provided for
+the source keystore and the destination keystore respectively.
+.RS
+.RE
+.TP
+.B \f[CB]\-ext\f[R] {\f[I]name\f[R]{\f[CB]:critical\f[R]} {\f[CB]=\f[R]\f[I]value\f[R]}}
+Denotes an X.509 certificate extension.
+The option can be used in \f[CB]\-genkeypair\f[R] and \f[CB]\-gencert\f[R]
+to embed extensions into the generated certificate, or in
+\f[CB]\-certreq\f[R] to show what extensions are requested in the
+certificate request.
+The option can appear multiple times.
+The \f[I]name\f[R] argument can be a supported extension name (see
+\f[B]Supported Named Extensions\f[R]) or an arbitrary OID number.
+The \f[I]value\f[R] argument, when provided, denotes the argument for the
+extension.
+When \f[I]value\f[R] is omitted, the default value of the extension or
+the extension itself requires no argument.
+The \f[CB]:critical\f[R] modifier, when provided, means the
+extension\[aq]s \f[CB]isCritical\f[R] attribute is \f[CB]true\f[R];
+otherwise, it is \f[CB]false\f[R].
+You can use \f[CB]:c\f[R] in place of \f[CB]:critical\f[R].
+.RS
+.RE
+.TP
+.B \f[CB]\-conf\f[R] \f[I]file\f[R]
+Specifies a pre\-configured options file.
+.RS
+.RE
+.SH PRE\-CONFIGURED OPTIONS FILE
+.PP
+A pre\-configured options file is a Java properties file that can be
+specified with the \f[CB]\-conf\f[R] option.
+Each property represents the default option(s) for a keytool command
+using "keytool.\f[I]command_name\f[R]" as the property name.
+A special property named "keytool.all" represents the default option(s)
+applied to all commands.
+A property value can include \f[CB]${prop}\f[R] which will be expanded to
+the system property associated with it.
+If an option value includes white spaces inside, it should be surrounded
+by quotation marks (" or \[aq]).
+All property names must be in lower case.
+.PP
+When \f[CB]keytool\f[R] is launched with a pre\-configured options file,
+the value for "keytool.all" (if it exists) is prepended to the
+\f[CB]keytool\f[R] command line first, with the value for the command name
+(if it exists) comes next, and the existing options on the command line
+at last.
+For a single\-valued option, this allows the property for a specific
+command to override the "keytool.all" value, and the value specified on
+the command line to override both.
+For multiple\-valued options, all of them will be used by
+\f[CB]keytool\f[R].
+.PP
+For example, given the following file named \f[CB]preconfig\f[R]:
+.IP
+.nf
+\f[CB]
+\ \ \ \ #\ A\ tiny\ pre\-configured\ options\ file
+\ \ \ \ keytool.all\ =\ \-keystore\ ${user.home}/ks
+\ \ \ \ keytool.list\ =\ \-v
+\ \ \ \ keytool.genkeypair\ =\ \-keyalg\ rsa
+\f[R]
+.fi
+.PP
+\f[CB]keytool\ \-conf\ preconfig\ \-list\f[R] is identical to
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ ~/ks\ \-v\ \-list\f[R]
+.RE
+.PP
+\f[CB]keytool\ \-conf\ preconfig\ \-genkeypair\ \-alias\ me\f[R] is
+identical to
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ ~/ks\ \-keyalg\ rsa\ \-genkeypair\ \-alias\ me\f[R]
+.RE
+.PP
+\f[CB]keytool\ \-conf\ preconfig\ \-genkeypair\ \-alias\ you\ \-keyalg\ ec\f[R]
+is identical to
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ ~/ks\ \-keyalg\ rsa\ \-genkeypair\ \-alias\ you\ \-keyalg\ ec\f[R]
+.RE
+.PP
+which is equivalent to
+.RS
+.PP
+\f[CB]keytool\ \-keystore\ ~/ks\ \-genkeypair\ \-alias\ you\ \-keyalg\ ec\f[R]
+.RE
+.PP
+because \f[CB]\-keyalg\f[R] is a single\-valued option and the \f[CB]ec\f[R]
+value specified on the command line overrides the preconfigured options
+file.
+.SH EXAMPLES OF OPTION VALUES
+.PP
+The following examples show the defaults for various option values:
+.IP
+.nf
+\f[CB]
+\-alias\ "mykey"
+
+\-keysize
+\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA",\ "DSA",\ "RSASSA\-PSS",\ or\ "DH")
+\ \ \ \ 256\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EC")
+\ \ \ \ 255\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EdDSA",\ or\ "XDH)
+\ \ \ \ 56\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DES")
+\ \ \ \ 168\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DESede")
+
+\-validity\ 90
+
+\-keystore\ <the\ file\ named\ .keystore\ in\ the\ user\[aq]s\ home\ directory>
+
+\-destkeystore\ <the\ file\ named\ .keystore\ in\ the\ user\[aq]s\ home\ directory>
+
+\-storetype\ <the\ value\ of\ the\ "keystore.type"\ property\ in\ the
+\ \ \ \ security\ properties\ file,\ which\ is\ returned\ by\ the\ static
+\ \ \ \ getDefaultType\ method\ in\ java.security.KeyStore>
+
+\-file
+\ \ \ \ stdin\ (if\ reading)
+\ \ \ \ stdout\ (if\ writing)
+
+\-protected\ false
+\f[R]
+.fi
+.PP
+When generating a certificate or a certificate request, the default
+signature algorithm (\f[CB]\-sigalg\f[R] option) is derived from the
+algorithm of the underlying private key to provide an appropriate level
+of security strength as follows:
+.PP
+.TS
+tab(@);
+l l l.
+T{
+keyalg
+T}@T{
+keysize
+T}@T{
+default sigalg
+T}
+_
+T{
+DSA
+T}@T{
+any size
+T}@T{
+SHA256withDSA
+T}
+T{
+RSA
+T}@T{
+<= 3072
+T}@T{
+SHA256withRSA
+T}
+T{
+T}@T{
+<= 7680
+T}@T{
+SHA384withRSA
+T}
+T{
+T}@T{
+> 7680
+T}@T{
+SHA512withRSA
+T}
+T{
+EC
+T}@T{
+< 384
+T}@T{
+SHA256withECDSA
+T}
+T{
+T}@T{
+< 512
+T}@T{
+SHA384withECDSA
+T}
+T{
+T}@T{
+= 512
+T}@T{
+SHA512withECDSA
+T}
+T{
+RSASSA\-PSS
+T}@T{
+<= 3072
+T}@T{
+RSASSA\-PSS (with SHA\-256)
+T}
+T{
+T}@T{
+<= 7680
+T}@T{
+RSASSA\-PSS (with SHA\-384)
+T}
+T{
+T}@T{
+> 7680
+T}@T{
+RSASSA\-PSS (with SHA\-512)
+T}
+T{
+EdDSA
+T}@T{
+255
+T}@T{
+Ed25519
+T}
+T{
+T}@T{
+448
+T}@T{
+Ed448
+T}
+T{
+Ed25519
+T}@T{
+255
+T}@T{
+Ed25519
+T}
+T{
+Ed448
+T}@T{
+448
+T}@T{
+Ed448
+T}
+.TE
+.IP \[bu] 2
+An RSASSA\-PSS signature algorithm uses a \f[CB]MessageDigest\f[R]
+algorithm as its hash and MGF1 algorithms.
+.IP \[bu] 2
+EdDSA supports 2 key sizes: Ed25519 and Ed448.
+When generating an EdDSA key pair using \f[CB]\-keyalg\ EdDSA\f[R], a user
+can specify \f[CB]\-keysize\ 255\f[R] or \f[CB]\-keysize\ 448\f[R] to
+generate Ed25519 or Ed448 key pairs.
+When no \f[CB]\-keysize\f[R] is specified, an Ed25519 key pair is
+generated.
+A user can also directly specify \f[CB]\-keyalg\ Ed25519\f[R] or
+\f[CB]\-keyalg\ Ed448\f[R] to generate a key pair with the expected key
+size.
+.PP
+\f[B]Note:\f[R]
+.PP
+To improve out of the box security, default key size and signature
+algorithm names are periodically updated to stronger values with each
+release of the JDK.
+If interoperability with older releases of the JDK is important, make
+sure that the defaults are supported by those releases.
+Alternatively, you can use the \f[CB]\-keysize\f[R] or \f[CB]\-sigalg\f[R]
+options to override the default values at your own risk.
+.SH SUPPORTED NAMED EXTENSIONS
+.PP
+The \f[CB]keytool\f[R] command supports these named extensions.
+The names aren\[aq]t case\-sensitive.
+.TP
+.B \f[CB]BC\f[R] or \f[CB]BasicContraints\f[R]
+Values:
+.RS
+.PP
+The full form is
+\f[CB]ca:\f[R]{\f[CB]true\f[R]|\f[CB]false\f[R]}[\f[CB],pathlen:\f[R]\f[I]len\f[R]]
+or \f[I]len\f[R], which is short for
+\f[CB]ca:true,pathlen:\f[R]\f[I]len\f[R].
+.PP
+When \f[I]len\f[R] is omitted, the resulting value is \f[CB]ca:true\f[R].
+.RE
+.TP
+.B \f[CB]KU\f[R] or \f[CB]KeyUsage\f[R]
+Values:
+.RS
+.PP
+\f[I]usage\f[R](\f[CB],\f[R] \f[I]usage\f[R])*
+.PP
+\f[I]usage\f[R] can be one of the following:
+.IP \[bu] 2
+\f[CB]digitalSignature\f[R]
+.IP \[bu] 2
+\f[CB]nonRepudiation\f[R] (\f[CB]contentCommitment\f[R])
+.IP \[bu] 2
+\f[CB]keyEncipherment\f[R]
+.IP \[bu] 2
+\f[CB]dataEncipherment\f[R]
+.IP \[bu] 2
+\f[CB]keyAgreement\f[R]
+.IP \[bu] 2
+\f[CB]keyCertSign\f[R]
+.IP \[bu] 2
+\f[CB]cRLSign\f[R]
+.IP \[bu] 2
+\f[CB]encipherOnly\f[R]
+.IP \[bu] 2
+\f[CB]decipherOnly\f[R]
+.PP
+Provided there is no ambiguity, the \f[I]usage\f[R] argument can be
+abbreviated with the first few letters (such as \f[CB]dig\f[R] for
+\f[CB]digitalSignature\f[R]) or in camel\-case style (such as \f[CB]dS\f[R]
+for \f[CB]digitalSignature\f[R] or \f[CB]cRLS\f[R] for \f[CB]cRLSign\f[R]).
+The \f[I]usage\f[R] values are case\-sensitive.
+.RE
+.TP
+.B \f[CB]EKU\f[R] or \f[CB]ExtendedKeyUsage\f[R]
+Values:
+.RS
+.PP
+\f[I]usage\f[R](\f[CB],\f[R] \f[I]usage\f[R])*
+.PP
+\f[I]usage\f[R] can be one of the following:
+.IP \[bu] 2
+\f[CB]anyExtendedKeyUsage\f[R]
+.IP \[bu] 2
+\f[CB]serverAuth\f[R]
+.IP \[bu] 2
+\f[CB]clientAuth\f[R]
+.IP \[bu] 2
+\f[CB]codeSigning\f[R]
+.IP \[bu] 2
+\f[CB]emailProtection\f[R]
+.IP \[bu] 2
+\f[CB]timeStamping\f[R]
+.IP \[bu] 2
+\f[CB]OCSPSigning\f[R]
+.IP \[bu] 2
+Any OID string
+.PP
+Provided there is no ambiguity, the \f[I]usage\f[R] argument can be
+abbreviated with the first few letters or in camel\-case style.
+The \f[I]usage\f[R] values are case\-sensitive.
+.RE
+.TP
+.B \f[CB]SAN\f[R] or \f[CB]SubjectAlternativeName\f[R]
+Values:
+.RS
+.PP
+\f[I]type\f[R]\f[CB]:\f[R]\f[I]value\f[R](\f[CB],\f[R]
+\f[I]type\f[R]\f[CB]:\f[R]\f[I]value\f[R])*
+.PP
+\f[I]type\f[R] can be one of the following:
+.IP \[bu] 2
+\f[CB]EMAIL\f[R]
+.IP \[bu] 2
+\f[CB]URI\f[R]
+.IP \[bu] 2
+\f[CB]DNS\f[R]
+.IP \[bu] 2
+\f[CB]IP\f[R]
+.IP \[bu] 2
+\f[CB]OID\f[R]
+.PP
+The \f[I]value\f[R] argument is the string format value for the
+\f[I]type\f[R].
+.RE
+.TP
+.B \f[CB]IAN\f[R] or \f[CB]IssuerAlternativeName\f[R]
+Values:
+.RS
+.PP
+Same as \f[CB]SAN\f[R] or \f[CB]SubjectAlternativeName\f[R].
+.RE
+.TP
+.B \f[CB]SIA\f[R] or \f[CB]SubjectInfoAccess\f[R]
+Values:
+.RS
+.PP
+\f[I]method\f[R]\f[CB]:\f[R]\f[I]location\-type\f[R]\f[CB]:\f[R]\f[I]location\-value\f[R](\f[CB],\f[R]
+\f[I]method\f[R]\f[CB]:\f[R]\f[I]location\-type\f[R]\f[CB]:\f[R]\f[I]location\-value\f[R])*
+.PP
+\f[I]method\f[R] can be one of the following:
+.IP \[bu] 2
+\f[CB]timeStamping\f[R]
+.IP \[bu] 2
+\f[CB]caRepository\f[R]
+.IP \[bu] 2
+Any OID
+.PP
+The \f[I]location\-type\f[R] and \f[I]location\-value\f[R] arguments can
+be any \f[I]type\f[R]\f[CB]:\f[R]\f[I]value\f[R] supported by the
+\f[CB]SubjectAlternativeName\f[R] extension.
+.RE
+.TP
+.B \f[CB]AIA\f[R] or \f[CB]AuthorityInfoAccess\f[R]
+Values:
+.RS
+.PP
+Same as \f[CB]SIA\f[R] or \f[CB]SubjectInfoAccess\f[R].
+.PP
+The \f[I]method\f[R] argument can be one of the following:
+.IP \[bu] 2
+\f[CB]ocsp\f[R]
+.IP \[bu] 2
+\f[CB]caIssuers\f[R]
+.IP \[bu] 2
+Any OID
+.RE
+.PP
+When \f[I]name\f[R] is OID, the value is the hexadecimal dumped Definite
+Encoding Rules (DER) encoding of the \f[CB]extnValue\f[R] for the
+extension excluding the OCTET STRING type and length bytes.
+Other than standard hexadecimal numbers (0\-9, a\-f, A\-F), any extra
+characters are ignored in the HEX string.
+Therefore, both 01:02:03:04 and 01020304 are accepted as identical
+values.
+When there is no value, the extension has an empty value field.
+.PP
+A special name \f[CB]honored\f[R], used only in \f[CB]\-gencert\f[R],
+denotes how the extensions included in the certificate request should be
+honored.
+The value for this name is a comma\-separated list of \f[CB]all\f[R] (all
+requested extensions are honored),
+\f[I]name\f[R]{\f[CB]:\f[R][\f[CB]critical\f[R]|\f[CB]non\-critical\f[R]]} (the
+named extension is honored, but it uses a different \f[CB]isCritical\f[R]
+attribute), and \f[CB]\-name\f[R] (used with \f[CB]all\f[R], denotes an
+exception).
+Requested extensions aren\[aq]t honored by default.
+.PP
+If, besides the\f[CB]\-ext\ honored\f[R] option, another named or OID
+\f[CB]\-ext\f[R] option is provided, this extension is added to those
+already honored.
+However, if this name (or OID) also appears in the honored value, then
+its value and criticality override that in the request.
+If an extension of the same type is provided multiple times through
+either a name or an OID, only the last extension is used.
+.PP
+The \f[CB]subjectKeyIdentifier\f[R] extension is always created.
+For non\-self\-signed certificates, the \f[CB]authorityKeyIdentifier\f[R]
+is created.
+.PP
+\f[B]CAUTION:\f[R]
+.PP
+Users should be aware that some combinations of extensions (and other
+certificate fields) may not conform to the Internet standard.
+See \f[B]Certificate Conformance Warning\f[R].
+.SH EXAMPLES OF TASKS IN CREATING A KEYSTORE
+.PP
+The following examples describe the sequence actions in creating a
+keystore for managing public/private key pairs and certificates from
+trusted entities.
+.IP \[bu] 2
+\f[B]Generating the Key Pair\f[R]
+.IP \[bu] 2
+\f[B]Requesting a Signed Certificate from a CA\f[R]
+.IP \[bu] 2
+\f[B]Importing a Certificate for the CA\f[R]
+.IP \[bu] 2
+\f[B]Importing the Certificate Reply from the CA\f[R]
+.IP \[bu] 2
+\f[B]Exporting a Certificate That Authenticates the Public Key\f[R]
+.IP \[bu] 2
+\f[B]Importing the Keystore\f[R]
+.IP \[bu] 2
+\f[B]Generating Certificates for an SSL Server\f[R]
+.SH GENERATING THE KEY PAIR
+.PP
+Create a keystore and then generate the key pair.
+.PP
+You can enter the command as a single line such as the following:
+.RS
+.PP
+\f[CB]keytool\ \-genkeypair\ \-dname\ "cn=myname,\ ou=mygroup,\ o=mycompany,\ c=mycountry"\ \-alias\ business\ \-keyalg\ rsa\ \-keypass\f[R]
+\f[I]password\f[R]
+\f[CB]\-keystore\ /working/mykeystore\ \-storepass\ password\ \-validity\ 180\f[R]
+.RE
+.PP
+The command creates the keystore named \f[CB]mykeystore\f[R] in the
+working directory (provided it doesn\[aq]t already exist), and assigns
+it the password specified by \f[CB]\-keypass\f[R].
+It generates a public/private key pair for the entity whose
+distinguished name is \f[CB]myname\f[R], \f[CB]mygroup\f[R],
+\f[CB]mycompany\f[R], and a two\-letter country code of
+\f[CB]mycountry\f[R].
+It uses the RSA key generation algorithm to create the keys; both are
+2048 bits
+.PP
+The command uses the default SHA256withRSA signature algorithm to create
+a self\-signed certificate that includes the public key and the
+distinguished name information.
+The certificate is valid for 180 days, and is associated with the
+private key in a keystore entry referred to by
+\f[CB]\-alias\ business\f[R].
+The private key is assigned the password specified by
+\f[CB]\-keypass\f[R].
+.PP
+The command is significantly shorter when the option defaults are
+accepted.
+In this case, only \f[CB]\-keyalg\f[R] is required, and the defaults are
+used for unspecified options that have default values.
+You are prompted for any required values.
+You could have the following:
+.RS
+.PP
+\f[CB]keytool\ \-genkeypair\ \-keyalg\ rsa\f[R]
+.RE
+.PP
+In this case, a keystore entry with the alias \f[CB]mykey\f[R] is created,
+with a newly generated key pair and a certificate that is valid for 90
+days.
+This entry is placed in your home directory in a keystore named
+\f[CB]\&.keystore\f[R] .
+\f[CB]\&.keystore\f[R] is created if it doesn\[aq]t already exist.
+You are prompted for the distinguished name information, the keystore
+password, and the private key password.
+.PP
+\f[B]Note:\f[R]
+.PP
+The rest of the examples assume that you responded to the prompts with
+values equal to those specified in the first \f[CB]\-genkeypair\f[R]
+command.
+For example, a distinguished name of
+\f[CB]cn=\f[R]\f[I]myname\f[R]\f[CB],\ ou=\f[R]\f[I]mygroup\f[R]\f[CB],\ o=\f[R]\f[I]mycompany\f[R]\f[CB],\ c=\f[R]\f[I]mycountry\f[R]).
+.SH REQUESTING A SIGNED CERTIFICATE FROM A CA
+.PP
+\f[B]Note:\f[R]
+.PP
+Generating the key pair created a self\-signed certificate; however, a
+certificate is more likely to be trusted by others when it is signed by
+a CA.
+.PP
+To get a CA signature, complete the following process:
+.IP "1." 3
+Generate a CSR:
+.RS 4
+.RS
+.PP
+\f[CB]keytool\ \-certreq\ \-file\ myname.csr\f[R]
+.RE
+.PP
+This creates a CSR for the entity identified by the default alias
+\f[CB]mykey\f[R] and puts the request in the file named
+\f[CB]myname.csr\f[R].
+.RE
+.IP "2." 3
+Submit \f[CB]myname.csr\f[R] to a CA, such as DigiCert.
+.PP
+The CA authenticates you, the requestor (usually offline), and returns a
+certificate, signed by them, authenticating your public key.
+In some cases, the CA returns a chain of certificates, each one
+authenticating the public key of the signer of the previous certificate
+in the chain.
+.SH IMPORTING A CERTIFICATE FOR THE CA
+.PP
+To import a certificate for the CA, complete the following process:
+.IP "1." 3
+Before you import the certificate reply from a CA, you need one or more
+trusted certificates either in your keystore or in the \f[CB]cacerts\f[R]
+keystore file.
+See \f[CB]\-importcert\f[R] in \f[B]Commands\f[R].
+.RS 4
+.IP \[bu] 2
+If the certificate reply is a certificate chain, then you need the top
+certificate of the chain.
+The root CA certificate that authenticates the public key of the CA.
+.IP \[bu] 2
+If the certificate reply is a single certificate, then you need a
+certificate for the issuing CA (the one that signed it).
+If that certificate isn\[aq]t self\-signed, then you need a certificate
+for its signer, and so on, up to a self\-signed root CA certificate.
+.PP
+The \f[CB]cacerts\f[R] keystore ships with a set of root certificates
+issued by the CAs of \f[B]the Oracle Java Root Certificate program\f[R]
+[http://www.oracle.com/technetwork/java/javase/javasecarootcertsprogram\-1876540.html].
+If you request a signed certificate from a CA, and a certificate
+authenticating that CA\[aq]s public key hasn\[aq]t been added to
+\f[CB]cacerts\f[R], then you must import a certificate from that CA as a
+trusted certificate.
+.PP
+A certificate from a CA is usually self\-signed or signed by another CA.
+If it is signed by another CA, you need a certificate that authenticates
+that CA\[aq]s public key.
+.PP
+For example, you have obtained a \f[I]X\f[R]\f[CB]\&.cer\f[R] file from a
+company that is a CA and the file is supposed to be a self\-signed
+certificate that authenticates that CA\[aq]s public key.
+Before you import it as a trusted certificate, you should ensure that
+the certificate is valid by:
+.IP "1." 3
+Viewing it with the \f[CB]keytool\ \-printcert\f[R] command or the
+\f[CB]keytool\ \-importcert\f[R] command without using the
+\f[CB]\-noprompt\f[R] option.
+Make sure that the displayed certificate fingerprints match the expected
+fingerprints.
+.IP "2." 3
+Calling the person who sent the certificate, and comparing the
+fingerprints that you see with the ones that they show or that a secure
+public key repository shows.
+.PP
+Only when the fingerprints are equal is it assured that the certificate
+wasn\[aq]t replaced in transit with somebody else\[aq]s certificate
+(such as an attacker\[aq]s certificate).
+If such an attack takes place, and you didn\[aq]t check the certificate
+before you imported it, then you would be trusting anything that the
+attacker signed.
+.RE
+.IP "2." 3
+Replace the self\-signed certificate with a certificate chain, where
+each certificate in the chain authenticates the public key of the signer
+of the previous certificate in the chain, up to a root CA.
+.RS 4
+.PP
+If you trust that the certificate is valid, then you can add it to your
+keystore by entering the following command:
+.RS
+.PP
+\f[CB]keytool\ \-importcert\ \-alias\f[R] \f[I]alias\f[R]
+\f[CB]\-file\ *X*\f[R].cer`
+.RE
+.PP
+This command creates a trusted certificate entry in the keystore from
+the data in the CA certificate file and assigns the values of the
+\f[I]alias\f[R] to the entry.
+.RE
+.SH IMPORTING THE CERTIFICATE REPLY FROM THE CA
+.PP
+After you import a certificate that authenticates the public key of the
+CA that you submitted your certificate signing request to (or there is
+already such a certificate in the \f[CB]cacerts\f[R] file), you can import
+the certificate reply and replace your self\-signed certificate with a
+certificate chain.
+.PP
+The certificate chain is one of the following:
+.IP \[bu] 2
+Returned by the CA when the CA reply is a chain.
+.IP \[bu] 2
+Constructed when the CA reply is a single certificate.
+This certificate chain is constructed by using the certificate reply and
+trusted certificates available either in the keystore where you import
+the reply or in the \f[CB]cacerts\f[R] keystore file.
+.PP
+For example, if you sent your certificate signing request to DigiCert,
+then you can import their reply by entering the following command:
+.PP
+\f[B]Note:\f[R]
+.PP
+In this example, the returned certificate is named
+\f[CB]DCmyname.cer\f[R].
+.RS
+.PP
+\f[CB]keytool\ \-importcert\ \-trustcacerts\ \-file\ DCmyname.cer\f[R]
+.RE
+.SH EXPORTING A CERTIFICATE THAT AUTHENTICATES THE PUBLIC KEY
+.PP
+\f[B]Note:\f[R]
+.PP
+If you used the \f[CB]jarsigner\f[R] command to sign a Java Archive (JAR)
+file, then clients that use the file will want to authenticate your
+signature.
+.PP
+One way that clients can authenticate you is by importing your public
+key certificate into their keystore as a trusted entry.
+You can then export the certificate and supply it to your clients.
+.PP
+For example:
+.IP "1." 3
+Copy your certificate to a file named \f[CB]myname.cer\f[R] by entering
+the following command:
+.RS 4
+.PP
+\f[B]Note:\f[R]
+.PP
+In this example, the entry has an alias of \f[CB]mykey\f[R].
+.RS
+.PP
+\f[CB]keytool\ \-exportcert\ \-alias\ mykey\ \-file\ myname.cer\f[R]
+.RE
+.RE
+.IP "2." 3
+With the certificate and the signed JAR file, a client can use the
+\f[CB]jarsigner\f[R] command to authenticate your signature.
+.SH IMPORTING THE KEYSTORE
+.PP
+Use the \f[CB]importkeystore\f[R] command to import an entire keystore
+into another keystore.
+This imports all entries from the source keystore, including keys and
+certificates, to the destination keystore with a single command.
+You can use this command to import entries from a different type of
+keystore.
+During the import, all new entries in the destination keystore will have
+the same alias names and protection passwords (for secret keys and
+private keys).
+If the \f[CB]keytool\f[R] command can\[aq]t recover the private keys or
+secret keys from the source keystore, then it prompts you for a
+password.
+If it detects alias duplication, then it asks you for a new alias, and
+you can specify a new alias or simply allow the \f[CB]keytool\f[R] command
+to overwrite the existing one.
+.PP
+For example, import entries from a typical JKS type keystore
+\f[CB]key.jks\f[R] into a PKCS #11 type hardware\-based keystore, by
+entering the following command:
+.RS
+.PP
+\f[CB]keytool\ \-importkeystore\ \-srckeystore\ key.jks\ \-destkeystore\ NONE\ \-srcstoretype\ JKS\ \-deststoretype\ PKCS11\ \-srcstorepass\f[R]
+\f[I]password\f[R] \f[CB]\-deststorepass\f[R] \f[I]password\f[R]
+.RE
+.PP
+The \f[CB]importkeystore\f[R] command can also be used to import a single
+entry from a source keystore to a destination keystore.
+In this case, besides the options you used in the previous example, you
+need to specify the alias you want to import.
+With the \f[CB]\-srcalias\f[R] option specified, you can also specify the
+destination alias name, protection password for a secret or private key,
+and the destination protection password you want as follows:
+.RS
+.PP
+\f[CB]keytool\ \-importkeystore\ \-srckeystore\ key.jks\ \-destkeystore\ NONE\ \-srcstoretype\ JKS\ \-deststoretype\ PKCS11\ \-srcstorepass\f[R]
+\f[I]password\f[R] \f[CB]\-deststorepass\f[R] \f[I]password\f[R]
+\f[CB]\-srcalias\ myprivatekey\ \-destalias\ myoldprivatekey\ \-srckeypass\f[R]
+\f[I]password\f[R] \f[CB]\-destkeypass\f[R] \f[I]password\f[R]
+\f[CB]\-noprompt\f[R]
+.RE
+.SH GENERATING CERTIFICATES FOR AN SSL SERVER
+.PP
+The following are \f[CB]keytool\f[R] commands used to generate key pairs
+and certificates for three entities:
+.IP \[bu] 2
+Root CA (\f[CB]root\f[R])
+.IP \[bu] 2
+Intermediate CA (\f[CB]ca\f[R])
+.IP \[bu] 2
+SSL server (\f[CB]server\f[R])
+.PP
+Ensure that you store all the certificates in the same keystore.
+.IP
+.nf
+\f[CB]
+keytool\ \-genkeypair\ \-keystore\ root.jks\ \-alias\ root\ \-ext\ bc:c\ \-keyalg\ rsa
+keytool\ \-genkeypair\ \-keystore\ ca.jks\ \-alias\ ca\ \-ext\ bc:c\ \-keyalg\ rsa
+keytool\ \-genkeypair\ \-keystore\ server.jks\ \-alias\ server\ \-keyalg\ rsa
+
+keytool\ \-keystore\ root.jks\ \-alias\ root\ \-exportcert\ \-rfc\ >\ root.pem
+
+keytool\ \-storepass\ password\ \-keystore\ ca.jks\ \-certreq\ \-alias\ ca\ |
+\ \ \ \ keytool\ \-storepass\ password\ \-keystore\ root.jks
+\ \ \ \ \-gencert\ \-alias\ root\ \-ext\ BC=0\ \-rfc\ >\ ca.pem
+keytool\ \-keystore\ ca.jks\ \-importcert\ \-alias\ ca\ \-file\ ca.pem
+
+keytool\ \-storepass\ password\ \-keystore\ server.jks\ \-certreq\ \-alias\ server\ |
+\ \ \ \ keytool\ \-storepass\ password\ \-keystore\ ca.jks\ \-gencert\ \-alias\ ca
+\ \ \ \ \-ext\ ku:c=dig,kE\ \-rfc\ >\ server.pem
+cat\ root.pem\ ca.pem\ server.pem\ |
+\ \ \ \ keytool\ \-keystore\ server.jks\ \-importcert\ \-alias\ server
+\f[R]
+.fi
+.SH TERMS
+.TP
+.B Keystore
+A keystore is a storage facility for cryptographic keys and
+certificates.
+.RS
+.RE
+.TP
+.B Keystore entries
+Keystores can have different types of entries.
+The two most applicable entry types for the \f[CB]keytool\f[R] command
+include the following:
+.RS
+.PP
+Key entries: Each entry holds very sensitive cryptographic key
+information, which is stored in a protected format to prevent
+unauthorized access.
+Typically, a key stored in this type of entry is a secret key, or a
+private key accompanied by the certificate chain for the corresponding
+public key.
+See \f[B]Certificate Chains\f[R].
+The \f[CB]keytool\f[R] command can handle both types of entries, while the
+\f[CB]jarsigner\f[R] tool only handles the latter type of entry, that is
+private keys and their associated certificate chains.
+.PP
+Trusted certificate entries: Each entry contains a single public key
+certificate that belongs to another party.
+The entry is called a trusted certificate because the keystore owner
+trusts that the public key in the certificate belongs to the identity
+identified by the subject (owner) of the certificate.
+The issuer of the certificate vouches for this, by signing the
+certificate.
+.RE
+.TP
+.B Keystore aliases
+All keystore entries (key and trusted certificate entries) are accessed
+by way of unique aliases.
+.RS
+.PP
+An alias is specified when you add an entity to the keystore with the
+\f[CB]\-genseckey\f[R] command to generate a secret key, the
+\f[CB]\-genkeypair\f[R] command to generate a key pair (public and private
+key), or the \f[CB]\-importcert\f[R] command to add a certificate or
+certificate chain to the list of trusted certificates.
+Subsequent \f[CB]keytool\f[R] commands must use this same alias to refer
+to the entity.
+.PP
+For example, you can use the alias \f[CB]duke\f[R] to generate a new
+public/private key pair and wrap the public key into a self\-signed
+certificate with the following command.
+See \f[B]Certificate Chains\f[R].
+.RS
+.PP
+\f[CB]keytool\ \-genkeypair\ \-alias\ duke\ \-keyalg\ rsa\ \-keypass\f[R]
+\f[I]passwd\f[R]
+.RE
+.PP
+This example specifies an initial \f[I]passwd\f[R] required by subsequent
+commands to access the private key associated with the alias
+\f[CB]duke\f[R].
+If you later want to change Duke\[aq]s private key password, use a
+command such as the following:
+.RS
+.PP
+\f[CB]keytool\ \-keypasswd\ \-alias\ duke\ \-keypass\f[R] \f[I]passwd\f[R]
+\f[CB]\-new\f[R] \f[I]newpasswd\f[R]
+.RE
+.PP
+This changes the initial \f[I]passwd\f[R] to \f[I]newpasswd\f[R].
+A password shouldn\[aq]t be specified on a command line or in a script
+unless it is for testing purposes, or you are on a secure system.
+If you don\[aq]t specify a required password option on a command line,
+then you are prompted for it.
+.RE
+.TP
+.B Keystore implementation
+The \f[CB]KeyStore\f[R] class provided in the \f[CB]java.security\f[R]
+package supplies well\-defined interfaces to access and modify the
+information in a keystore.
+It is possible for there to be multiple different concrete
+implementations, where each implementation is that for a particular type
+of keystore.
+.RS
+.PP
+Currently, two command\-line tools (\f[CB]keytool\f[R] and
+\f[CB]jarsigner\f[R]) make use of keystore implementations.
+Because the \f[CB]KeyStore\f[R] class is \f[CB]public\f[R], users can write
+additional security applications that use it.
+.PP
+In JDK 9 and later, the default keystore implementation is
+\f[CB]PKCS12\f[R].
+This is a cross platform keystore based on the RSA PKCS12 Personal
+Information Exchange Syntax Standard.
+This standard is primarily meant for storing or transporting a
+user\[aq]s private keys, certificates, and miscellaneous secrets.
+There is another built\-in implementation, provided by Oracle.
+It implements the keystore as a file with a proprietary keystore type
+(format) named \f[CB]JKS\f[R].
+It protects each private key with its individual password, and also
+protects the integrity of the entire keystore with a (possibly
+different) password.
+.PP
+Keystore implementations are provider\-based.
+More specifically, the application interfaces supplied by
+\f[CB]KeyStore\f[R] are implemented in terms of a Service Provider
+Interface (SPI).
+That is, there is a corresponding abstract \f[CB]KeystoreSpi\f[R] class,
+also in the \f[CB]java.security\ package\f[R], which defines the Service
+Provider Interface methods that providers must implement.
+The term \f[I]provider\f[R] refers to a package or a set of packages that
+supply a concrete implementation of a subset of services that can be
+accessed by the Java Security API.
+To provide a keystore implementation, clients must implement a provider
+and supply a \f[CB]KeystoreSpi\f[R] subclass implementation, as described
+in Steps to Implement and Integrate a Provider.
+.PP
+Applications can choose different types of keystore implementations from
+different providers, using the \f[CB]getInstance\f[R] factory method
+supplied in the \f[CB]KeyStore\f[R] class.
+A keystore type defines the storage and data format of the keystore
+information, and the algorithms used to protect private/secret keys in
+the keystore and the integrity of the keystore.
+Keystore implementations of different types aren\[aq]t compatible.
+.PP
+The \f[CB]keytool\f[R] command works on any file\-based keystore
+implementation.
+It treats the keystore location that is passed to it at the command line
+as a file name and converts it to a \f[CB]FileInputStream\f[R], from which
+it loads the keystore information.)The \f[CB]jarsigner\f[R] commands can
+read a keystore from any location that can be specified with a URL.
+.PP
+For \f[CB]keytool\f[R] and \f[CB]jarsigner\f[R], you can specify a keystore
+type at the command line, with the \f[CB]\-storetype\f[R] option.
+.PP
+If you don\[aq]t explicitly specify a keystore type, then the tools
+choose a keystore implementation based on the value of the
+\f[CB]keystore.type\f[R] property specified in the security properties
+file.
+The security properties file is called \f[CB]java.security\f[R], and
+resides in the security properties directory:
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R] \f[CB]java.home/lib/security\f[R]
+.IP \[bu] 2
+\f[B]Windows:\f[R] \f[CB]java.home\\lib\\security\f[R]
+.PP
+Each tool gets the \f[CB]keystore.type\f[R] value and then examines all
+the currently installed providers until it finds one that implements a
+keystores of that type.
+It then uses the keystore implementation from that provider.The
+\f[CB]KeyStore\f[R] class defines a static method named
+\f[CB]getDefaultType\f[R] that lets applications retrieve the value of the
+\f[CB]keystore.type\f[R] property.
+The following line of code creates an instance of the default keystore
+type as specified in the \f[CB]keystore.type\f[R] property:
+.RS
+.PP
+\f[CB]KeyStore\ keyStore\ =\ KeyStore.getInstance(KeyStore.getDefaultType());\f[R]
+.RE
+.PP
+The default keystore type is \f[CB]pkcs12\f[R], which is a cross\-platform
+keystore based on the RSA PKCS12 Personal Information Exchange Syntax
+Standard.
+This is specified by the following line in the security properties file:
+.RS
+.PP
+\f[CB]keystore.type=pkcs12\f[R]
+.RE
+.PP
+To have the tools utilize a keystore implementation other than the
+default, you can change that line to specify a different keystore type.
+For example, if you want to use the Oracle\[aq]s \f[CB]jks\f[R] keystore
+implementation, then change the line to the following:
+.RS
+.PP
+\f[CB]keystore.type=jks\f[R]
+.RE
+.PP
+\f[B]Note:\f[R]
+.PP
+Case doesn\[aq]t matter in keystore type designations.
+For example, \f[CB]JKS\f[R] would be considered the same as \f[CB]jks\f[R].
+.RE
+.TP
+.B Certificate
+A certificate (or public\-key certificate) is a digitally signed
+statement from one entity (the issuer), saying that the public key and
+some other information of another entity (the subject) has some specific
+value.
+The following terms are related to certificates:
+.RS
+.IP \[bu] 2
+Public Keys: These are numbers associated with a particular entity, and
+are intended to be known to everyone who needs to have trusted
+interactions with that entity.
+Public keys are used to verify signatures.
+.IP \[bu] 2
+Digitally Signed: If some data is digitally signed, then it is stored
+with the identity of an entity and a signature that proves that entity
+knows about the data.
+The data is rendered unforgeable by signing with the entity\[aq]s
+private key.
+.IP \[bu] 2
+Identity: A known way of addressing an entity.
+In some systems, the identity is the public key, and in others it can be
+anything from an Oracle Solaris UID to an email address to an X.509
+distinguished name.
+.IP \[bu] 2
+Signature: A signature is computed over some data using the private key
+of an entity.
+The signer, which in the case of a certificate is also known as the
+issuer.
+.IP \[bu] 2
+Private Keys: These are numbers, each of which is supposed to be known
+only to the particular entity whose private key it is (that is, it is
+supposed to be kept secret).
+Private and public keys exist in pairs in all public key cryptography
+systems (also referred to as public key crypto systems).
+In a typical public key crypto system, such as DSA, a private key
+corresponds to exactly one public key.
+Private keys are used to compute signatures.
+.IP \[bu] 2
+Entity: An entity is a person, organization, program, computer,
+business, bank, or something else you are trusting to some degree.
+.PP
+Public key cryptography requires access to users\[aq] public keys.
+In a large\-scale networked environment, it is impossible to guarantee
+that prior relationships between communicating entities were established
+or that a trusted repository exists with all used public keys.
+Certificates were invented as a solution to this public key distribution
+problem.
+Now a Certification Authority (CA) can act as a trusted third party.
+CAs are entities such as businesses that are trusted to sign (issue)
+certificates for other entities.
+It is assumed that CAs only create valid and reliable certificates
+because they are bound by legal agreements.
+There are many public Certification Authorities, such as DigiCert,
+Comodo, Entrust, and so on.
+.PP
+You can also run your own Certification Authority using products such as
+Microsoft Certificate Server or the Entrust CA product for your
+organization.
+With the \f[CB]keytool\f[R] command, it is possible to display, import,
+and export certificates.
+It is also possible to generate self\-signed certificates.
+.PP
+The \f[CB]keytool\f[R] command currently handles X.509 certificates.
+.RE
+.TP
+.B X.509 Certificates
+The X.509 standard defines what information can go into a certificate
+and describes how to write it down (the data format).
+All the data in a certificate is encoded with two related standards
+called ASN.1/DER.
+Abstract Syntax Notation 1 describes data.
+The Definite Encoding Rules describe a single way to store and transfer
+that data.
+.RS
+.PP
+All X.509 certificates have the following data, in addition to the
+signature:
+.IP \[bu] 2
+Version: This identifies which version of the X.509 standard applies to
+this certificate, which affects what information can be specified in it.
+Thus far, three versions are defined.
+The \f[CB]keytool\f[R] command can import and export v1, v2, and v3
+certificates.
+It generates v3 certificates.
+.RS 2
+.IP \[bu] 2
+X.509 Version 1 has been available since 1988, is widely deployed, and
+is the most generic.
+.IP \[bu] 2
+X.509 Version 2 introduced the concept of subject and issuer unique
+identifiers to handle the possibility of reuse of subject or issuer
+names over time.
+Most certificate profile documents strongly recommend that names not be
+reused and that certificates shouldn\[aq]t make use of unique
+identifiers.
+Version 2 certificates aren\[aq]t widely used.
+.IP \[bu] 2
+X.509 Version 3 is the most recent (1996) and supports the notion of
+extensions where anyone can define an extension and include it in the
+certificate.
+Some common extensions are: KeyUsage (limits the use of the keys to
+particular purposes such as \f[CB]signing\-only\f[R]) and AlternativeNames
+(allows other identities to also be associated with this public key, for
+example.
+DNS names, email addresses, IP addresses).
+Extensions can be marked critical to indicate that the extension should
+be checked and enforced or used.
+For example, if a certificate has the KeyUsage extension marked critical
+and set to \f[CB]keyCertSign\f[R], then when this certificate is presented
+during SSL communication, it should be rejected because the certificate
+extension indicates that the associated private key should only be used
+for signing certificates and not for SSL use.
+.RE
+.IP \[bu] 2
+Serial number: The entity that created the certificate is responsible
+for assigning it a serial number to distinguish it from other
+certificates it issues.
+This information is used in numerous ways.
+For example, when a certificate is revoked its serial number is placed
+in a Certificate Revocation List (CRL).
+.IP \[bu] 2
+Signature algorithm identifier: This identifies the algorithm used by
+the CA to sign the certificate.
+.IP \[bu] 2
+Issuer name: The X.500 Distinguished Name of the entity that signed the
+certificate.
+This is typically a CA.
+Using this certificate implies trusting the entity that signed this
+certificate.
+In some cases, such as root or top\-level CA certificates, the issuer
+signs its own certificate.
+.IP \[bu] 2
+Validity period: Each certificate is valid only for a limited amount of
+time.
+This period is described by a start date and time and an end date and
+time, and can be as short as a few seconds or almost as long as a
+century.
+The validity period chosen depends on a number of factors, such as the
+strength of the private key used to sign the certificate, or the amount
+one is willing to pay for a certificate.
+This is the expected period that entities can rely on the public value,
+when the associated private key has not been compromised.
+.IP \[bu] 2
+Subject name: The name of the entity whose public key the certificate
+identifies.
+This name uses the X.500 standard, so it is intended to be unique across
+the Internet.
+This is the X.500 Distinguished Name (DN) of the entity.
+For example,
+.RS 2
+.RS
+.PP
+\f[CB]CN=Java\ Duke,\ OU=Java\ Software\ Division,\ O=Oracle\ Corporation,\ C=US\f[R]
+.RE
+.PP
+These refer to the subject\[aq]s common name (CN), organizational unit
+(OU), organization (O), and country (C).
+.RE
+.IP \[bu] 2
+Subject public key information: This is the public key of the entity
+being named with an algorithm identifier that specifies which public key
+crypto system this key belongs to and any associated key parameters.
+.RE
+.TP
+.B Certificate Chains
+The \f[CB]keytool\f[R] command can create and manage keystore key entries
+that each contain a private key and an associated certificate chain.
+The first certificate in the chain contains the public key that
+corresponds to the private key.
+.RS
+.PP
+When keys are first generated, the chain usually starts off containing a
+single element, a self\-signed certificate.
+See \-genkeypair in \f[B]Commands\f[R].
+A self\-signed certificate is one for which the issuer (signer) is the
+same as the subject.
+The subject is the entity whose public key is being authenticated by the
+certificate.
+When the \f[CB]\-genkeypair\f[R] command is called to generate a new
+public/private key pair, it also wraps the public key into a
+self\-signed certificate (unless the \f[CB]\-signer\f[R] option is
+specified).
+.PP
+Later, after a Certificate Signing Request (CSR) was generated with the
+\f[CB]\-certreq\f[R] command and sent to a Certification Authority (CA),
+the response from the CA is imported with \f[CB]\-importcert\f[R], and the
+self\-signed certificate is replaced by a chain of certificates.
+At the bottom of the chain is the certificate (reply) issued by the CA
+authenticating the subject\[aq]s public key.
+The next certificate in the chain is one that authenticates the CA\[aq]s
+public key.
+.PP
+In many cases, this is a self\-signed certificate, which is a
+certificate from the CA authenticating its own public key, and the last
+certificate in the chain.
+In other cases, the CA might return a chain of certificates.
+In this case, the bottom certificate in the chain is the same (a
+certificate signed by the CA, authenticating the public key of the key
+entry), but the second certificate in the chain is a certificate signed
+by a different CA that authenticates the public key of the CA you sent
+the CSR to.
+The next certificate in the chain is a certificate that authenticates
+the second CA\[aq]s key, and so on, until a self\-signed root
+certificate is reached.
+Each certificate in the chain (after the first) authenticates the public
+key of the signer of the previous certificate in the chain.
+.PP
+Many CAs only return the issued certificate, with no supporting chain,
+especially when there is a flat hierarchy (no intermediates CAs).
+In this case, the certificate chain must be established from trusted
+certificate information already stored in the keystore.
+.PP
+A different reply format (defined by the PKCS #7 standard) includes the
+supporting certificate chain in addition to the issued certificate.
+Both reply formats can be handled by the \f[CB]keytool\f[R] command.
+.PP
+The top\-level (root) CA certificate is self\-signed.
+However, the trust into the root\[aq]s public key doesn\[aq]t come from
+the root certificate itself, but from other sources such as a newspaper.
+This is because anybody could generate a self\-signed certificate with
+the distinguished name of, for example, the DigiCert root CA.
+The root CA public key is widely known.
+The only reason it is stored in a certificate is because this is the
+format understood by most tools, so the certificate in this case is only
+used as a vehicle to transport the root CA\[aq]s public key.
+Before you add the root CA certificate to your keystore, you should view
+it with the \f[CB]\-printcert\f[R] option and compare the displayed
+fingerprint with the well\-known fingerprint obtained from a newspaper,
+the root CA\[aq]s Web page, and so on.
+.RE
+.TP
+.B cacerts Certificates File
+A certificates file named \f[CB]cacerts\f[R] resides in the security
+properties directory:
+.RS
+.IP \[bu] 2
+\f[B]Linux and OS X:\f[R] \f[I]JAVA_HOME\f[R]\f[CB]/lib/security\f[R]
+.IP \[bu] 2
+\f[B]Windows:\f[R] \f[I]JAVA_HOME\f[R]\f[CB]\\lib\\security\f[R]
+.PP
+The \f[CB]cacerts\f[R] file represents a system\-wide keystore with CA
+certificates.
+System administrators can configure and manage that file with the
+\f[CB]keytool\f[R] command by specifying \f[CB]jks\f[R] as the keystore
+type.
+The \f[CB]cacerts\f[R] keystore file ships with a default set of root CA
+certificates.
+For Linux, OS X, and Windows, you can list the default certificates with
+the following command:
+.RS
+.PP
+\f[CB]keytool\ \-list\ \-cacerts\f[R]
+.RE
+.PP
+The initial password of the \f[CB]cacerts\f[R] keystore file is
+\f[CB]changeit\f[R].
+System administrators should change that password and the default access
+permission of that file upon installing the SDK.
+.PP
+\f[B]Note:\f[R]
+.PP
+It is important to verify your \f[CB]cacerts\f[R] file.
+Because you trust the CAs in the \f[CB]cacerts\f[R] file as entities for
+signing and issuing certificates to other entities, you must manage the
+\f[CB]cacerts\f[R] file carefully.
+The \f[CB]cacerts\f[R] file should contain only certificates of the CAs
+you trust.
+It is your responsibility to verify the trusted root CA certificates
+bundled in the \f[CB]cacerts\f[R] file and make your own trust decisions.
+.PP
+To remove an untrusted CA certificate from the \f[CB]cacerts\f[R] file,
+use the \f[CB]\-delete\f[R] option of the \f[CB]keytool\f[R] command.
+You can find the \f[CB]cacerts\f[R] file in the JDK\[aq]s
+\f[CB]$JAVA_HOME/lib/security\f[R] directory.
+Contact your system administrator if you don\[aq]t have permission to
+edit this file.
+.RE
+.TP
+.B Internet RFC 1421 Certificate Encoding Standard
+Certificates are often stored using the printable encoding format
+defined by the Internet RFC 1421 standard, instead of their binary
+encoding.
+This certificate format, also known as Base64 encoding, makes it easy to
+export certificates to other applications by email or through some other
+mechanism.
+.RS
+.PP
+Certificates read by the \f[CB]\-importcert\f[R] and \f[CB]\-printcert\f[R]
+commands can be in either this format or binary encoded.
+The \f[CB]\-exportcert\f[R] command by default outputs a certificate in
+binary encoding, but will instead output a certificate in the printable
+encoding format, when the \f[CB]\-rfc\f[R] option is specified.
+.PP
+The \f[CB]\-list\f[R] command by default prints the SHA\-256 fingerprint
+of a certificate.
+If the \f[CB]\-v\f[R] option is specified, then the certificate is printed
+in human\-readable format.
+If the \f[CB]\-rfc\f[R] option is specified, then the certificate is
+output in the printable encoding format.
+.PP
+In its printable encoding format, the encoded certificate is bounded at
+the beginning and end by the following text:
+.IP
+.nf
+\f[CB]
+\-\-\-\-\-BEGIN\ CERTIFICATE\-\-\-\-\-
+
+encoded\ certificate\ goes\ here.
+
+\-\-\-\-\-END\ CERTIFICATE\-\-\-\-\-
+\f[R]
+.fi
+.RE
+.TP
+.B X.500 Distinguished Names
+X.500 Distinguished Names are used to identify entities, such as those
+that are named by the \f[CB]subject\f[R] and \f[CB]issuer\f[R] (signer)
+fields of X.509 certificates.
+The \f[CB]keytool\f[R] command supports the following subparts:
+.RS
+.IP \[bu] 2
+commonName: The common name of a person such as Susan Jones.
+.IP \[bu] 2
+organizationUnit: The small organization (such as department or
+division) name.
+For example, Purchasing.
+.IP \[bu] 2
+localityName: The locality (city) name, for example, Palo Alto.
+.IP \[bu] 2
+stateName: State or province name, for example, California.
+.IP \[bu] 2
+country: Two\-letter country code, for example, CH.
+.PP
+When you supply a distinguished name string as the value of a
+\f[CB]\-dname\f[R] option, such as for the \f[CB]\-genkeypair\f[R] command,
+the string must be in the following format:
+.RS
+.PP
+\f[CB]CN=cName,\ OU=orgUnit,\ O=org,\ L=city,\ S=state,\ C=countryCode\f[R]
+.RE
+.PP
+All the following items represent actual values and the previous
+keywords are abbreviations for the following:
+.IP
+.nf
+\f[CB]
+CN=commonName
+OU=organizationUnit
+O=organizationName
+L=localityName
+S=stateName
+C=country
+\f[R]
+.fi
+.PP
+A sample distinguished name string is:
+.RS
+.PP
+\f[CB]CN=Mark\ Smith,\ OU=Java,\ O=Oracle,\ L=Cupertino,\ S=California,\ C=US\f[R]
+.RE
+.PP
+A sample command using such a string is:
+.RS
+.PP
+\f[CB]keytool\ \-genkeypair\ \-dname\ "CN=Mark\ Smith,\ OU=Java,\ O=Oracle,\ L=Cupertino,\ S=California,\ C=US"\ \-alias\ mark\ \-keyalg\ rsa\f[R]
+.RE
+.PP
+Case doesn\[aq]t matter for the keyword abbreviations.
+For example, CN, cn, and Cn are all treated the same.
+.PP
+Order matters; each subcomponent must appear in the designated order.
+However, it isn\[aq]t necessary to have all the subcomponents.
+You can use a subset, for example:
+.RS
+.PP
+\f[CB]CN=Smith,\ OU=Java,\ O=Oracle,\ C=US\f[R]
+.RE
+.PP
+If a distinguished name string value contains a comma, then the comma
+must be escaped by a backslash (\\) character when you specify the
+string on a command line, as in:
+.RS
+.PP
+\f[CB]cn=Jack,\ ou=Java\\,\ Product\ Development,\ o=Oracle,\ c=US\f[R]
+.RE
+.PP
+It is never necessary to specify a distinguished name string on a
+command line.
+When the distinguished name is needed for a command, but not supplied on
+the command line, the user is prompted for each of the subcomponents.
+In this case, a comma doesn\[aq]t need to be escaped by a backslash
+(\\).
+.RE
+.SH WARNINGS
+.SH IMPORTING TRUSTED CERTIFICATES WARNING
+.PP
+\f[B]Important\f[R]: Be sure to check a certificate very carefully before
+importing it as a trusted certificate.
+.PP
+\f[B]Windows Example:\f[R]
+.PP
+View the certificate first with the \f[CB]\-printcert\f[R] command or the
+\f[CB]\-importcert\f[R] command without the \f[CB]\-noprompt\f[R] option.
+Ensure that the displayed certificate fingerprints match the expected
+ones.
+For example, suppose someone sends or emails you a certificate that you
+put it in a file named \f[CB]\\tmp\\cert\f[R].
+Before you consider adding the certificate to your list of trusted
+certificates, you can execute a \f[CB]\-printcert\f[R] command to view its
+fingerprints, as follows:
+.IP
+.nf
+\f[CB]
+\ \ keytool\ \-printcert\ \-file\ \\tmp\\cert
+\ \ \ \ Owner:\ CN=ll,\ OU=ll,\ O=ll,\ L=ll,\ S=ll,\ C=ll
+\ \ \ \ Issuer:\ CN=ll,\ OU=ll,\ O=ll,\ L=ll,\ S=ll,\ C=ll
+\ \ \ \ Serial\ Number:\ 59092b34
+\ \ \ \ Valid\ from:\ Thu\ Jun\ 24\ 18:01:13\ PDT\ 2016\ until:\ Wed\ Jun\ 23\ 17:01:13\ PST\ 2016
+\ \ \ \ Certificate\ Fingerprints:
+
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ SHA\-1:\ 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ SHA\-256:\ 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4
+\f[R]
+.fi
+.PP
+\f[B]Linux Example:\f[R]
+.PP
+View the certificate first with the \f[CB]\-printcert\f[R] command or the
+\f[CB]\-importcert\f[R] command without the \f[CB]\-noprompt\f[R] option.
+Ensure that the displayed certificate fingerprints match the expected
+ones.
+For example, suppose someone sends or emails you a certificate that you
+put it in a file named \f[CB]/tmp/cert\f[R].
+Before you consider adding the certificate to your list of trusted
+certificates, you can execute a \f[CB]\-printcert\f[R] command to view its
+fingerprints, as follows:
+.IP
+.nf
+\f[CB]
+\ \ keytool\ \-printcert\ \-file\ /tmp/cert
+\ \ \ \ Owner:\ CN=ll,\ OU=ll,\ O=ll,\ L=ll,\ S=ll,\ C=ll
+\ \ \ \ Issuer:\ CN=ll,\ OU=ll,\ O=ll,\ L=ll,\ S=ll,\ C=ll
+\ \ \ \ Serial\ Number:\ 59092b34
+\ \ \ \ Valid\ from:\ Thu\ Jun\ 24\ 18:01:13\ PDT\ 2016\ until:\ Wed\ Jun\ 23\ 17:01:13\ PST\ 2016
+\ \ \ \ Certificate\ Fingerprints:
+
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ SHA\-1:\ 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ SHA\-256:\ 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4
+\f[R]
+.fi
+.PP
+Then call or otherwise contact the person who sent the certificate and
+compare the fingerprints that you see with the ones that they show.
+Only when the fingerprints are equal is it guaranteed that the
+certificate wasn\[aq]t replaced in transit with somebody else\[aq]s
+certificate such as an attacker\[aq]s certificate.
+If such an attack took place, and you didn\[aq]t check the certificate
+before you imported it, then you would be trusting anything the attacker
+signed, for example, a JAR file with malicious class files inside.
+.PP
+\f[B]Note:\f[R]
+.PP
+It isn\[aq]t required that you execute a \f[CB]\-printcert\f[R] command
+before importing a certificate.
+This is because before you add a certificate to the list of trusted
+certificates in the keystore, the \f[CB]\-importcert\f[R] command prints
+out the certificate information and prompts you to verify it.
+You can then stop the import operation.
+However, you can do this only when you call the \f[CB]\-importcert\f[R]
+command without the \f[CB]\-noprompt\f[R] option.
+If the \f[CB]\-noprompt\f[R] option is specified, then there is no
+interaction with the user.
+.SH PASSWORDS WARNING
+.PP
+Most commands that operate on a keystore require the store password.
+Some commands require a private/secret key password.
+Passwords can be specified on the command line in the
+\f[CB]\-storepass\f[R] and \f[CB]\-keypass\f[R] options.
+However, a password shouldn\[aq]t be specified on a command line or in a
+script unless it is for testing, or you are on a secure system.
+When you don\[aq]t specify a required password option on a command line,
+you are prompted for it.
+.SH CERTIFICATE CONFORMANCE WARNING
+.PP
+\f[B]Internet X.509 Public Key Infrastructure Certificate and
+Certificate Revocation List (CRL) Profile\f[R]
+[https://tools.ietf.org/rfc/rfc5280.txt] defined a profile on conforming
+X.509 certificates, which includes what values and value combinations
+are valid for certificate fields and extensions.
+.PP
+The \f[CB]keytool\f[R] command doesn\[aq]t enforce all of these rules so
+it can generate certificates that don\[aq]t conform to the standard,
+such as self\-signed certificates that would be used for internal
+testing purposes.
+Certificates that don\[aq]t conform to the standard might be rejected by
+the JDK or other applications.
+Users should ensure that they provide the correct options for
+\f[CB]\-dname\f[R], \f[CB]\-ext\f[R], and so on.
+.SH IMPORT A NEW TRUSTED CERTIFICATE
+.PP
+Before you add the certificate to the keystore, the \f[CB]keytool\f[R]
+command verifies it by attempting to construct a chain of trust from
+that certificate to a self\-signed certificate (belonging to a root CA),
+using trusted certificates that are already available in the keystore.
+.PP
+If the \f[CB]\-trustcacerts\f[R] option was specified, then additional
+certificates are considered for the chain of trust, namely the
+certificates in a file named \f[CB]cacerts\f[R].
+.PP
+If the \f[CB]keytool\f[R] command fails to establish a trust path from the
+certificate to be imported up to a self\-signed certificate (either from
+the keystore or the \f[CB]cacerts\f[R] file), then the certificate
+information is printed, and the user is prompted to verify it by
+comparing the displayed certificate fingerprints with the fingerprints
+obtained from some other (trusted) source of information, which might be
+the certificate owner.
+Be very careful to ensure the certificate is valid before importing it
+as a trusted certificate.
+The user then has the option of stopping the import operation.
+If the \f[CB]\-noprompt\f[R] option is specified, then there is no
+interaction with the user.
+.SH IMPORT A CERTIFICATE REPLY
+.PP
+When you import a certificate reply, the certificate reply is validated
+with trusted certificates from the keystore, and optionally, the
+certificates configured in the \f[CB]cacerts\f[R] keystore file when the
+\f[CB]\-trustcacerts\f[R] option is specified.
+.PP
+The methods of determining whether the certificate reply is trusted are
+as follows:
+.IP \[bu] 2
+If the reply is a single X.509 certificate, then the \f[CB]keytool\f[R]
+command attempts to establish a trust chain, starting at the certificate
+reply and ending at a self\-signed certificate (belonging to a root CA).
+The certificate reply and the hierarchy of certificates is used to
+authenticate the certificate reply from the new certificate chain of
+aliases.
+If a trust chain can\[aq]t be established, then the certificate reply
+isn\[aq]t imported.
+In this case, the \f[CB]keytool\f[R] command doesn\[aq]t print the
+certificate and prompt the user to verify it, because it is very
+difficult for a user to determine the authenticity of the certificate
+reply.
+.IP \[bu] 2
+If the reply is a PKCS #7 formatted certificate chain or a sequence of
+X.509 certificates, then the chain is ordered with the user certificate
+first followed by zero or more CA certificates.
+If the chain ends with a self\-signed root CA certificate and
+the\f[CB]\-trustcacerts\f[R] option was specified, the \f[CB]keytool\f[R]
+command attempts to match it with any of the trusted certificates in the
+keystore or the \f[CB]cacerts\f[R] keystore file.
+If the chain doesn\[aq]t end with a self\-signed root CA certificate and
+the \f[CB]\-trustcacerts\f[R] option was specified, the \f[CB]keytool\f[R]
+command tries to find one from the trusted certificates in the keystore
+or the \f[CB]cacerts\f[R] keystore file and add it to the end of the
+chain.
+If the certificate isn\[aq]t found and the \f[CB]\-noprompt\f[R] option
+isn\[aq]t specified, the information of the last certificate in the
+chain is printed, and the user is prompted to verify it.
+.PP
+If the public key in the certificate reply matches the user\[aq]s public
+key already stored with \f[CB]alias\f[R], then the old certificate chain
+is replaced with the new certificate chain in the reply.
+The old chain can only be replaced with a valid \f[CB]keypass\f[R], and so
+the password used to protect the private key of the entry is supplied.
+If no password is provided, and the private key password is different
+from the keystore password, the user is prompted for it.
+.PP
+This command was named \f[CB]\-import\f[R] in earlier releases.
+This old name is still supported in this release.
+The new name, \f[CB]\-importcert\f[R], is preferred.
diff --git a/java/temurin-17/man/man1/rmiregistry.1 b/java/temurin-17/man/man1/rmiregistry.1
new file mode 100644
index 0000000..8c97d1f
--- /dev/null
+++ b/java/temurin-17/man/man1/rmiregistry.1
@@ -0,0 +1,92 @@
+.\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "RMIREGISTRY" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+rmiregistry \- create and start a remote object registry on the
+specified port on the current host
+.SH SYNOPSIS
+.PP
+\f[CB]rmiregistry\f[R] [\f[I]options\f[R]] [\f[I]port\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the option for the \f[CB]rmiregistry\f[R] command.
+See \f[B]Options\f[R]
+.RS
+.RE
+.TP
+.B \f[I]port\f[R]
+The number of a port on the current host at which to start the remote
+object registry.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]rmiregistry\f[R] command creates and starts a remote object
+registry on the specified port on the current host.
+If the port is omitted, then the registry is started on port 1099.
+The \f[CB]rmiregistry\f[R] command produces no output and is typically run
+in the background, for example:
+.RS
+.PP
+\f[CB]rmiregistry\ &\f[R]
+.RE
+.PP
+A remote object registry is a bootstrap naming service that\[aq]s used
+by RMI servers on the same host to bind remote objects to names.
+Clients on local and remote hosts can then look up remote objects and
+make remote method invocations.
+.PP
+The registry is typically used to locate the first remote object on
+which an application needs to call methods.
+That object then provides application\-specific support for finding
+other objects.
+.PP
+The methods of the \f[CB]java.rmi.registry.LocateRegistry\f[R] class are
+used to get a registry operating on the local host or local host and
+port.
+.PP
+The URL\-based methods of the \f[CB]java.rmi.Naming\f[R] class operate on
+a registry and can be used to:
+.IP \[bu] 2
+Bind the specified name to a remote object
+.IP \[bu] 2
+Return an array of the names bound in the registry
+.IP \[bu] 2
+Return a reference, a stub, for the remote object associated with the
+specified name
+.IP \[bu] 2
+Rebind the specified name to a new remote object
+.IP \[bu] 2
+Destroy the binding for the specified name that\[aq]s associated with a
+remote object
+.SH OPTIONS
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Used with any Java option to pass the \f[I]option\f[R] following the
+\f[CB]\-J\f[R] (no spaces between the \f[CB]\-J\f[R] and the option) to the
+Java interpreter.
+.RS
+.RE
diff --git a/java/temurin-17/man/man1/serialver.1 b/java/temurin-17/man/man1/serialver.1
new file mode 100644
index 0000000..0ba5021
--- /dev/null
+++ b/java/temurin-17/man/man1/serialver.1
@@ -0,0 +1,84 @@
+.\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+.\"
+.\" This code is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "SERIALVER" "1" "2021" "JDK 17" "JDK Commands"
+.hy
+.SH NAME
+.PP
+serialver \- return the \f[CB]serialVersionUID\f[R] for one or more
+classes in a form suitable for copying into an evolving class
+.SH SYNOPSIS
+.PP
+\f[CB]serialver\f[R] [\f[I]options\f[R]] [\f[I]classnames\f[R]]
+.TP
+.B \f[I]options\f[R]
+This represents the command\-line options for the \f[CB]serialver\f[R]
+command.
+See \f[B]Options for serialver\f[R].
+.RS
+.RE
+.TP
+.B \f[I]classnames\f[R]
+The classes for which \f[CB]serialVersionUID\f[R] is to be returned.
+.RS
+.RE
+.SH DESCRIPTION
+.PP
+The \f[CB]serialver\f[R] command returns the \f[CB]serialVersionUID\f[R] for
+one or more classes in a form suitable for copying into an evolving
+class.
+When called with no arguments, the \f[CB]serialver\f[R] command prints a
+usage line.
+.SH OPTIONS FOR SERIALVER
+.TP
+.B \f[CB]\-classpath\f[R] \f[I]path\-files\f[R]
+Sets the search path for application classes and resources.
+Separate classes and resources with a colon (:).
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Passes the specified \f[I]option\f[R] to the Java Virtual Machine, where
+\f[I]option\f[R] is one of the options described on the reference page
+for the Java application launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+.RS
+.RE
+.SH NOTES
+.PP
+The \f[CB]serialver\f[R] command loads and initializes the specified
+classes in its virtual machine, and by default, it doesn\[aq]t set a
+security manager.
+If the \f[CB]serialver\f[R] command is to be run with untrusted classes,
+then a security manager can be set with the following option:
+.RS
+.PP
+\f[CB]\-J\-Djava.security.manager\f[R]
+.RE
+.PP
+When necessary, a security policy can be specified with the following
+option:
+.RS
+.PP
+\f[CB]\-J\-Djava.security.policy=\f[R]\f[I]policy_file\f[R]
+.RE
diff --git a/java/temurin-17/release b/java/temurin-17/release
new file mode 100644
index 0000000..18a410b
--- /dev/null
+++ b/java/temurin-17/release
@@ -0,0 +1,19 @@
+IMPLEMENTOR="Eclipse Adoptium"
+IMPLEMENTOR_VERSION="Temurin-17.0.10+7"
+JAVA_RUNTIME_VERSION="17.0.10+7"
+JAVA_VERSION="17.0.10"
+JAVA_VERSION_DATE="2024-01-16"
+LIBC="gnu"
+MODULES="java.base java.compiler java.datatransfer java.xml java.prefs java.desktop java.instrument java.logging java.management java.security.sasl java.naming java.rmi java.management.rmi java.net.http java.scripting java.security.jgss java.transaction.xa java.sql java.sql.rowset java.xml.crypto java.se java.smartcardio jdk.accessibility jdk.internal.jvmstat jdk.attach jdk.charsets jdk.compiler jdk.crypto.ec jdk.crypto.cryptoki jdk.dynalink jdk.internal.ed jdk.editpad jdk.hotspot.agent jdk.httpserver jdk.incubator.foreign jdk.incubator.vector jdk.internal.le jdk.internal.opt jdk.internal.vm.ci jdk.internal.vm.compiler jdk.internal.vm.compiler.management jdk.jartool jdk.javadoc jdk.jcmd jdk.management jdk.management.agent jdk.jconsole jdk.jdeps jdk.jdwp.agent jdk.jdi jdk.jfr jdk.jlink jdk.jpackage jdk.jshell jdk.jsobject jdk.jstatd jdk.localedata jdk.management.jfr jdk.naming.dns jdk.naming.rmi jdk.net jdk.nio.mapmode jdk.random jdk.sctp jdk.security.auth jdk.security.jgss jdk.unsupported jdk.unsupported.desktop jdk.xml.dom jdk.zipfs"
+OS_ARCH="x86_64"
+OS_NAME="Linux"
+SOURCE=".:git:eb31abbd7251"
+BUILD_SOURCE="git:5bb80cb8d781321c3390d89ed2bbd100218a8e1b"
+BUILD_SOURCE_REPO="https://github.com/adoptium/temurin-build.git"
+SOURCE_REPO="https://github.com/adoptium/jdk17u.git"
+FULL_VERSION="17.0.10+7"
+SEMANTIC_VERSION="17.0.10+7"
+BUILD_INFO="OS: Linux Version: 5.4.0-126-generic"
+JVM_VARIANT="Hotspot"
+JVM_VERSION="17.0.10+7"
+IMAGE_TYPE="JDK"
diff --git a/maven/apache-maven-3.9.11-bin.tar.gz b/maven/apache-maven-3.9.11-bin.tar.gz
new file mode 100644
index 0000000..3f2fbb8
Binary files /dev/null and b/maven/apache-maven-3.9.11-bin.tar.gz differ
diff --git a/maven/apache-maven-3.9.11/LICENSE b/maven/apache-maven-3.9.11/LICENSE
new file mode 100644
index 0000000..0dc9a9f
--- /dev/null
+++ b/maven/apache-maven-3.9.11/LICENSE
@@ -0,0 +1,616 @@
+
+
+Apache Maven includes a number of components and libraries with separate
+copyright notices and license terms. Your use of those components are
+subject to the terms and conditions of the following licenses:
+
+
+
+
+
+
+
+
+
+
+
+- lib/aopalliance-1.0.jar: aopalliance:aopalliance:jar:1.0
+ Project: AOP alliance
+Project URL: http://aopalliance.sourceforge.net
+ License: Public Domain (unrecognized)
+
+ License URL: $license.url (lib/aopalliance.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/gson-2.13.1.jar: com.google.code.gson:gson:jar:2.13.1
+ Project: Gson
+Project URL: https://github.com/google/gson
+ License: Apache-2.0 (Apache-2.0)
+
+ License URL: https://www.apache.org/licenses/LICENSE-2.0.txt (lib/gson.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/error_prone_annotations-2.38.0.jar: com.google.errorprone:error_prone_annotations:jar:2.38.0
+ Project: error-prone annotations
+Project URL: https://errorprone.info/error_prone_annotations
+ License: Apache 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/error_prone_annotations.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/failureaccess-1.0.3.jar: com.google.guava:failureaccess:jar:1.0.3
+ Project: Guava InternalFutureFailureAccess and InternalFutures
+Project URL: https://github.com/google/guava/
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/failureaccess.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/guava-33.4.8-jre.jar: com.google.guava:guava:bundle:33.4.8-jre
+ Project: Guava: Google Core Libraries for Java
+Project URL: https://github.com/google/guava
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/guava.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/guice-5.1.0.jar: com.google.inject:guice:jar:5.1.0
+ Project: Google Guice - Core Library
+Project URL: https://github.com/google/guice/
+ License: The Apache Software License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/guice.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/commons-cli-1.9.0.jar: commons-cli:commons-cli:jar:1.9.0
+ Project: Apache Commons CLI
+Project URL: https://commons.apache.org/proper/commons-cli/
+ License: Apache-2.0 (Apache-2.0)
+
+ License URL: https://www.apache.org/licenses/LICENSE-2.0.txt (lib/commons-cli.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/commons-codec-1.18.0.jar: commons-codec:commons-codec:jar:1.18.0
+ Project: Apache Commons Codec
+Project URL: https://commons.apache.org/proper/commons-codec/
+ License: Apache-2.0 (Apache-2.0)
+
+ License URL: https://www.apache.org/licenses/LICENSE-2.0.txt (lib/commons-codec.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/javax.annotation-api-1.3.2.jar: javax.annotation:javax.annotation-api:jar:1.3.2
+ Project: javax.annotation API
+Project URL: http://jcp.org/en/jsr/detail?id=250
+ License: CDDL + GPLv2 with classpath exception (unrecognized)
+
+ License URL: https://github.com/javaee/javax.annotation/blob/master/LICENSE (lib/javax.annotation-api.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/javax.inject-1.jar: javax.inject:javax.inject:jar:1
+ Project: javax.inject
+Project URL: http://code.google.com/p/atinject/
+ License: The Apache Software License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/javax.inject.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/httpclient-4.5.14.jar: org.apache.httpcomponents:httpclient:jar:4.5.14
+ Project: Apache HttpClient
+Project URL: http://hc.apache.org/httpcomponents-client-ga
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/httpclient.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/httpcore-4.4.16.jar: org.apache.httpcomponents:httpcore:jar:4.4.16
+ Project: Apache HttpCore
+Project URL: http://hc.apache.org/httpcomponents-core-ga
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/httpcore.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/plexus-cipher-2.0.jar: org.codehaus.plexus:plexus-cipher:jar:2.0
+ Project: Plexus Cipher: encryption/decryption Component
+Project URL: https://codehaus-plexus.github.io/plexus-cipher/
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/plexus-cipher.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- boot/plexus-classworlds-2.9.0.jar: org.codehaus.plexus:plexus-classworlds:bundle:2.9.0
+ Project: Plexus Classworlds
+Project URL: https://codehaus-plexus.github.io/plexus-classworlds/
+ License: Apache-2.0 (Apache-2.0)
+
+ License URL: https://www.apache.org/licenses/LICENSE-2.0.txt (boot/plexus-classworlds.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/plexus-component-annotations-2.2.0.jar: org.codehaus.plexus:plexus-component-annotations:jar:2.2.0
+ Project: Plexus :: Component Annotations (deprecated)
+Project URL: https://codehaus-plexus.github.io/plexus-containers/plexus-component-annotations/
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: https://www.apache.org/licenses/LICENSE-2.0.txt (lib/plexus-component-annotations.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/plexus-interpolation-1.28.jar: org.codehaus.plexus:plexus-interpolation:bundle:1.28
+ Project: Plexus Interpolation API
+Project URL: https://codehaus-plexus.github.io/plexus-pom/plexus-interpolation/
+ License: Apache-2.0 (Apache-2.0)
+
+ License URL: https://www.apache.org/licenses/LICENSE-2.0.txt (lib/plexus-interpolation.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/plexus-sec-dispatcher-2.0.jar: org.codehaus.plexus:plexus-sec-dispatcher:jar:2.0
+ Project: Plexus Security Dispatcher Component
+Project URL: https://codehaus-plexus.github.io/plexus-sec-dispatcher/
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/plexus-sec-dispatcher.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/plexus-utils-3.6.0.jar: org.codehaus.plexus:plexus-utils:jar:3.6.0
+ Project: Plexus Common Utilities
+Project URL: https://codehaus-plexus.github.io/plexus-utils/
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: https://www.apache.org/licenses/LICENSE-2.0.txt (lib/plexus-utils.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/org.eclipse.sisu.inject-0.9.0.M4.jar: org.eclipse.sisu:org.eclipse.sisu.inject:jar:0.9.0.M4
+ Project: org.eclipse.sisu:org.eclipse.sisu.inject
+Project URL: https://eclipse.dev/sisu/org.eclipse.sisu.inject/
+ License: Eclipse Public License, Version 2.0 (EPL-2.0)
+
+ License URL: https://www.eclipse.org/legal/epl-v20.html (lib/org.eclipse.sisu.inject.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/org.eclipse.sisu.plexus-0.9.0.M4.jar: org.eclipse.sisu:org.eclipse.sisu.plexus:jar:0.9.0.M4
+ Project: org.eclipse.sisu:org.eclipse.sisu.plexus
+Project URL: https://eclipse.dev/sisu/org.eclipse.sisu.plexus/
+ License: Eclipse Public License, Version 2.0 (EPL-2.0)
+
+ License URL: https://www.eclipse.org/legal/epl-v20.html (lib/org.eclipse.sisu.plexus.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/jansi-2.4.2.jar: org.fusesource.jansi:jansi:jar:2.4.2
+ Project: Jansi
+Project URL: http://fusesource.github.io/jansi
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/jansi.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/jspecify-1.0.0.jar: org.jspecify:jspecify:jar:1.0.0
+ Project: JSpecify annotations
+Project URL: http://jspecify.org/
+ License: The Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: http://www.apache.org/licenses/LICENSE-2.0.txt (lib/jspecify.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/asm-9.8.jar: org.ow2.asm:asm:jar:9.8
+ Project: asm
+Project URL: http://asm.ow2.io/
+ License: BSD-3-Clause (unrecognized)
+
+ License URL: https://asm.ow2.io/license.html (lib/asm.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/jcl-over-slf4j-1.7.36.jar: org.slf4j:jcl-over-slf4j:jar:1.7.36
+ Project: JCL 1.2 implemented over SLF4J
+Project URL: http://www.slf4j.org
+ License: Apache License, Version 2.0 (Apache-2.0)
+
+ License URL: https://www.apache.org/licenses/LICENSE-2.0.txt (lib/jcl-over-slf4j.license)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- lib/slf4j-api-1.7.36.jar: org.slf4j:slf4j-api:jar:1.7.36
+ Project: SLF4J API Module
+Project URL: http://www.slf4j.org
+ License: MIT License (MIT)
+
+ License URL: http://www.opensource.org/licenses/mit-license.php (lib/slf4j-api.license)
+
+
+
diff --git a/maven/apache-maven-3.9.11/NOTICE b/maven/apache-maven-3.9.11/NOTICE
new file mode 100644
index 0000000..c058817
--- /dev/null
+++ b/maven/apache-maven-3.9.11/NOTICE
@@ -0,0 +1,98 @@
+This software bundles the following NOTICE files from third party library providers:
+
+META-INF/NOTICE in archive lib/guice-5.1.0.jar
+Google Guice - Core Library
+Copyright 2006-2022 Google, Inc.
+This product includes software developed at
+The Apache Software Foundation (http://www.apache.org/).
+
+META-INF/NOTICE in archive lib/plexus-utils-3.2.1.jar
+This product includes software developed by the Indiana University
+ Extreme! Lab (http://www.extreme.indiana.edu/).
+This product includes software developed by
+The Apache Software Foundation (http://www.apache.org/).
+This product includes software developed by
+ThoughtWorks (http://www.thoughtworks.com).
+This product includes software developed by
+javolution (http://javolution.org/).
+This product includes software developed by
+Rome (https://rome.dev.java.net/).
+
+about.html in archive lib/org.eclipse.sisu.inject-0.3.5.jar
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"/>
+<title>About org.eclipse.sisu.inject
+
+
+About org.eclipse.sisu.inject
+
+November 5, 2013
+License
+
+The Eclipse Foundation makes available all content in this plug-in ("Content"). Unless otherwise
+indicated below, the Content is provided to you under the terms and conditions of the
+Eclipse Public License Version 1.0 ("EPL"). A copy of the EPL is available
+at http://www.eclipse.org/legal/epl-v10.html.
+For purposes of the EPL, "Program" will mean the Content.
+
+If you did not receive this Content directly from the Eclipse Foundation, the Content is
+being redistributed by another party ("Redistributor") and different terms and conditions may
+apply to your use of any object code in the Content. Check the Redistributor's license that was
+provided with the Content. If no such license exists, contact the Redistributor. Unless otherwise
+indicated below, the terms and conditions of the EPL still apply to any source code in the Content
+and such source code may be obtained at http://www.eclipse.org.
+
+Third Party Content
+The Content includes items that have been sourced from third parties as set
+out below. If you did not receive this Content directly from the Eclipse Foundation,
+the following is provided for informational purposes only, and you should look
+to the Redistributor's license for terms and conditions of use.
+
+ASM 4.1
+The plug-in includes software developed by the ObjectWeb consortium as part
+of the ASM project at http://asm.ow2.org/.
+
+A subset of ASM is re-packaged within the source and binary of the plug-in (org.eclipse.sisu.space.asm.*)
+to avoid version collisions with other usage and is also available from the plug-in's github repository.
+
+Your use of the ASM code is subject to the terms and conditions of the ASM License
+below which is also available at http://asm.ow2.org/license.html.
+
+
+Copyright (c) 2000-2011 INRIA, France Telecom
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holders nor the names of its
+ contributors may be used to endorse or promote products derived from
+ this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+THE POSSIBILITY OF SUCH DAMAGE.
+
+
+
+