stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8237058: Update all nroff manpages for JDK 14 release

Browse Source 
Reviewed-by: dholmes
This commit is contained in:
Jonathan Gibbons 2020-01-14 15:01:34 -08:00
parent 0b70f01e98
commit 9ec4001d87
31 changed files with 1322 additions and 506 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

513
src/java.base/share/man/java.1
View File

@ -8,7 +8,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -22,7 +22,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JAVA" "1" "2019" "JDK 13" "JDK Commands"
.TH "JAVA" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -181,8 +181,8 @@ 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.
Supported values of \f[I]N\f[R] for this release are \f[CB]7\f[R],
\f[CB]8\f[R], \f[CB]9\f[R], \f[CB]10\f[R], \f[CB]11\f[R], \f[CB]12\f[R], and
\f[CB]13\f[R].
\f[CB]8\f[R], \f[CB]9\f[R], \f[CB]10\f[R], \f[CB]11\f[R], \f[CB]12\f[R],
\f[CB]13\f[R], and \f[CB]14\f[R].
.RE
.PP
If the file does not have the \f[CB]\&.java\f[R] extension, the
@ -267,7 +267,7 @@ 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
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
@ -315,7 +315,7 @@ The encoding requirement for the environment variable is the same as 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.
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
@ -802,20 +802,6 @@ Expect a performance degradation when this option is used.
.RS
.RE
.TP
.B \f[CB]\-Xcomp\f[R]
Forces compilation of methods on first invocation.
By default, the Client VM (\f[CB]\-client\f[R]) performs 1,000 interpreted
method invocations and the Server VM (\f[CB]\-server\f[R]) performs 10,000
interpreted method invocations to gather information for efficient
compilation.
Specifying the \f[CB]\-Xcomp\f[R] option disables interpreted method
invocations to increase compilation performance at the expense of
efficiency.
You can also change the number of interpreted method invocations before
compilation using the \f[CB]\-XX:CompileThreshold\f[R] option.
.RS
.RE
.TP
.B \f[CB]\-Xdebug\f[R]
Does nothing.
Provided for backward compatibility.
@ -852,6 +838,8 @@ See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R].
.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
@ -1643,7 +1631,7 @@ 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
If the frame pointer is available, then external profiling tools (for
example, Linux perf) can construct more accurate stack traces.
.RS
.RE
@ -1694,6 +1682,19 @@ bootstrap class paths.
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 disabled.
.RS
.RE
.TP
.B \f[CB]\-XX:+ShowMessageBoxOnError\f[R]
Enables the display of a dialog box when the JVM experiences an
irrecoverable error.
@ -1830,7 +1831,7 @@ comma.
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.
Java thread stack size to 1024*1024 bytes or 1 megabyte.
The default value depends on the platform:
.RS
.IP \[bu] 2
@ -1892,9 +1893,9 @@ 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].
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
@ -1964,8 +1965,6 @@ By default, the number of lines to prefetch is set to 1:
.PP
\f[CB]\-XX:AllocateInstancePrefetchLines=1\f[R]
.RE
.PP
Only the Java HotSpot Server VM supports this option.
.RE
.TP
.B \f[CB]\-XX:AllocatePrefetchDistance=\f[R]\f[I]size\f[R]
@ -1990,14 +1989,11 @@ bytes:
.PP
\f[CB]\-XX:AllocatePrefetchDistance=1024\f[R]
.RE
.PP
Only the Java HotSpot Server VM supports this option.
.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.
Only the Java HotSpot Server VM supports this option.
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:
@ -2006,8 +2002,6 @@ By default, the prefetch instruction is set to 0:
.PP
\f[CB]\-XX:AllocatePrefetchInstr=0\f[R]
.RE
.PP
Only the Java HotSpot Server VM supports this option.
.RE
.TP
.B \f[CB]\-XX:AllocatePrefetchLines=\f[R]\f[I]lines\f[R]
@ -2023,8 +2017,6 @@ to 5:
.PP
\f[CB]\-XX:AllocatePrefetchLines=5\f[R]
.RE
.PP
Only the Java HotSpot Server VM supports this option.
.RE
.TP
.B \f[CB]\-XX:AllocatePrefetchStepSize=\f[R]\f[I]size\f[R]
@ -2038,8 +2030,6 @@ By default, the step size is set to 16 bytes:
.PP
\f[CB]\-XX:AllocatePrefetchStepSize=16\f[R]
.RE
.PP
Only the Java HotSpot Server VM supports this option.
.RE
.TP
.B \f[CB]\-XX:AllocatePrefetchStyle=\f[R]\f[I]style\f[R]
@ -2054,7 +2044,7 @@ Don\[aq]t generate prefetch instructions.
.TP
.B \f[CB]1\f[R]
Execute prefetch instructions after each allocation.
This is the default parameter.
This is the default setting.
.RS
.RE
.TP
@ -2065,11 +2055,9 @@ determine when prefetch instructions are executed.
.RE
.TP
.B \f[CB]3\f[R]
Use BIS instruction on SPARC for allocation prefetch.
Generate one prefetch instruction per cache line.
.RS
.RE
.PP
Only the Java HotSpot Server VM supports this option.
.RE
.TP
.B \f[CB]\-XX:+BackgroundCompilation\f[R]
@ -2083,9 +2071,8 @@ To disable background compilation, specify
.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 threads is set to 2 for the server JVM, to 1
for the client JVM, and it scales to the number of cores if tiered
compilation is used.
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
@ -2094,6 +2081,13 @@ The following example shows how to set the number of threads to 2:
.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
@ -2318,33 +2312,13 @@ class:
.fi
.RE
.TP
.B \f[CB]\-XX:CompileThreshold=\f[R]\f[I]invocations\f[R]
Sets the number of interpreted method invocations before compilation.
By default, in the server JVM, the JIT compiler performs 10,000
interpreted method invocations to gather information for efficient
compilation.
For the client JVM, the default setting is 1,500 invocations.
This option is ignored when tiered compilation is enabled; see the
option \f[CB]\-XX:\-TieredCompilation\f[R].
The following example shows how to set the number of interpreted method
invocations to 5,000:
.RS
.RS
.PP
\f[CB]\-XX:CompileThreshold=5000\f[R]
.RE
.PP
You can completely disable interpretation of Java methods before
compilation by specifying the \f[CB]\-Xcomp\f[R] option.
.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 an integer value between
0 and +Inf and scales the thresholds corresponding to the current mode
of operation (both tiered and nontiered).
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.
@ -2358,7 +2332,6 @@ 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].
Only the Java HotSpot Server VM supports this option.
.RS
.RE
.TP
@ -2367,7 +2340,7 @@ 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 is set to 500 KB.
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
@ -2387,14 +2360,14 @@ To disable method inlining, specify \f[CB]\-XX:\-Inline\f[R].
.RE
.TP
.B \f[CB]\-XX:InlineSmallCode=\f[R]\f[I]size\f[R]
Sets the maximum code size (in bytes) for compiled methods that should
be inlined.
Sets the maximum code size (in bytes) for already compiled methods that
may be inlined.
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.
Only compiled methods with the size smaller than the specified size is
inlined.
By default, the maximum code size is set to 1000 bytes:
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
@ -2420,8 +2393,23 @@ 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.
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 method to be inlined.
Sets the maximum bytecode size (in bytes) of a cold method to be
inlined.
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.
@ -2433,14 +2421,30 @@ By default, the maximum bytecode size is set to 35 bytes:
.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 maximum number of nodes is set to 65,000:
.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.
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:MaxNodeLimit=65000\f[R]
\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
@ -2461,27 +2465,11 @@ This flag is used only if \f[CB]\-XX:SegmentedCodeCache\f[R] is enabled.
.RS
.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.
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:+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].
Only the Java HotSpot Server VM supports this option.
.RS
.RE
.TP
@ -2595,15 +2583,25 @@ The default value is 10%.
.B \f[CB]\-XX:\-TieredCompilation\f[R]
Disables the use of tiered compilation.
By default, this option is enabled.
Only the Java HotSpot Server VM supports this option.
.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 Intel, AMD, and SPARC
hardware.
Intel Westmere (2010 and newer), AMD Bulldozer (2011 and newer), and
SPARC (T4 and newer) are the supported hardware.
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].
@ -2611,8 +2609,9 @@ Flags that control intrinsics now require the option
.RE
.TP
.B \f[CB]\-XX:+UseAESIntrinsics\f[R]
Enables \f[CB]\-XX:+UseAES\f[R] and \f[CB]\-XX:+UseAESIntrinsics\f[R] flags
by default and are supported only for the Java HotSpot Server VM.
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:
@ -2624,9 +2623,147 @@ For example, to enable hardware AES, use the following flags:
.PP
Flags that control intrinsics now require the option
\f[CB]\-XX:+UnlockDiagnosticVMOptions\f[R].
To support UseAES and UseAESIntrinsics flags, use the \f[CB]\-server\f[R]
option to select the Java HotSpot Server VM.
These flags aren\[aq]t supported on Client VM.
.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
SPARC 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]
@ -2650,13 +2787,31 @@ 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.
Only the Java HotSpot Server VM supports this option.
.RS
.RE
.TP
.B \f[CB]\-XX:+UseCountedLoopSafepoints\f[R]
Keeps safepoints in counted loops.
Its default value is false.\
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
@ -2687,8 +2842,8 @@ 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 for the Java HotSpot Server VM
on x86 CPUs that support Transactional Synchronization Extensions (TSX).
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
@ -2731,51 +2886,6 @@ other processors, which forces them to read from main memory instead of
their cache.
.RE
.TP
.B \f[CB]\-XX:+UseSHA\f[R]
Enables hardware\-based intrinsics for SHA crypto hash functions for
SPARC 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, and are supported only for Java HotSpot Server VM 64\-bit on
SPARC T4 and newer.
.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:+UseSuperWord\f[R]
Enables the transformation of scalar operations into superword
operations.
@ -2783,7 +2893,6 @@ 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].
Only the Java HotSpot Server VM supports this option.
.RS
.RE
.SH ADVANCED SERVICEABILITY OPTIONS FOR JAVA
@ -2975,7 +3084,6 @@ By default, this option is disabled and all pages are committed as the
application uses the heap space.
.RS
.RE
.RE
.TP
.B \f[CB]\-XX:ConcGCThreads=\f[R]\f[I]threads\f[R]
Sets the number of threads used for concurrent GC.
@ -3707,14 +3815,6 @@ If it\[aq]s enabled, then the \f[CB]\-XX:+UseParallelOldGC\f[R] option is
automatically enabled, unless you explicitly disable it.
.RE
.TP
.B \f[CB]\-XX:+UseParallelOldGC\f[R]
Enables the use of the parallel garbage collector for full GCs.
By default, this option is disabled.
Enabling it automatically enables the \f[CB]\-XX:+UseParallelGC\f[R]
option.
.RS
.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
@ -3799,15 +3899,6 @@ Example:
\f[CB]\-Xlog:gc:garbage\-collection.log\f[R]
.RE
.TP
.B \f[CB]\-XX:+FailOverToOldVerifier\f[R]
Enables automatic failover to the old verifier when the new type checker
fails.
By default, this option is disabled and it\[aq]s ignored (that is,
treated as disabled) for classes with a recent bytecode version.
You can enable it only for classes with older versions of the bytecode.
.RS
.RE
.TP
.B \f[CB]\-XX:+FlightRecorder\f[R]
Enables the use of Java Flight Recorder (JFR) during the runtime of the
application.
@ -3902,6 +3993,27 @@ The replacement Unified Logging syntax is
See \f[B]Enable Logging with the JVM Unified Logging Framework\f[R].
.RE
.TP
.B \f[CB]\-XX:+UseParallelOldGC\f[R]
Enables the use of the parallel garbage collector for full GCs.
By default, this option is disabled.
Enabling it automatically enables the \f[CB]\-XX:+UseParallelGC\f[R]
option.
.RS
.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]\-XX:+FailOverToOldVerifier\f[R]
Enables automatic failover to the old verifier when the new type checker
fails.
By default, this option is disabled and it\[aq]s ignored (that is,
treated as disabled) for classes with a recent bytecode version.
You can enable it only for classes with older versions of the bytecode.
.RS
.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,
@ -3925,23 +4037,14 @@ This option was deprecated in JDK 8 and superseded by the
.RE
.SH REMOVED JAVA OPTIONS
.PP
These \f[CB]java\f[R] options have been removed in JDK 13 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:+AggressiveOpts\f[R]
Enabled the use of aggressive performance optimization features.
By default, this option was disabled and experimental performance
features were not used.
.RS
.RE
No documented \f[CB]java\f[R] options have been removed in JDK 14.
.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 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
@ -4012,7 +4115,6 @@ entirety.
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.
@ -4032,11 +4134,11 @@ arguments are presented to the launcher literally).
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
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.
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
@ -4067,7 +4169,7 @@ this is interpreted as:
.PP
\f[CB]\-cp\ lib/cool/app/jars\f[R]
.RE
.SS Example of a Backslash Character\ Escaped with Another Backslash
.SS Example of a Backslash Character Escaped with Another Backslash
Character in an Argument File
.PP
To output the following:
@ -4079,7 +4181,7 @@ To output the following:
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]
\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
@ -4105,7 +4207,7 @@ In the argument file,
.nf
\f[CB]
\-cp\ "/lib/cool\\
\\app/jars”
\\app/jars???
\f[R]
.fi
.PP
@ -4894,10 +4996,10 @@ 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.\ \
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
@ -5571,18 +5673,19 @@ additional shared data to add to the archive file.
\f[CB]\-XX:SharedArchiveConfigFile=\f[R]\f[I]shared_config_file\f[R]
.RE
.PP
JDK 9 and later supports adding both symbols and\ string objects to an
archive for memory sharing\ when you have multiple JVM processes running
JDK 9 and later supports adding both symbols and string objects to an
archive for memory sharing when you have multiple JVM processes running
on the same host.
An example of this is having multiple JVM processes that use the same
set of Java EE classes.
When these common classes are loaded and used, new symbols and strings
may be created and added to the JVM\[aq]s internal "symbol" and "string"
tables.\ At runtime, the symbols or string objects mapped from the
archive file can be shared across multiple JVM processes, resulting in a
reduction of overall memory usage.\ In addition, archiving strings also
provides added performance benefits in both startup time and runtime
execution.
tables.
At runtime, the symbols or string objects mapped from the archive file
can be shared across multiple JVM processes, resulting in a reduction of
overall memory usage.
In addition, archiving strings also provides added performance benefits
in both startup time and runtime execution.
.PP
In JDK 10 and later, CONSTANT_String entries in archived classes are
resolved to interned String objects at dump time, and all interned
@ -5597,7 +5700,7 @@ running JVM process.
See \f[B]jcmd\f[R].
.PP
The following is an example of the symbol dumping command in
\f[CB]jcmd\f[R]:\
\f[CB]jcmd\f[R]:
.RS
.PP
\f[CB]jcmd\f[R] \f[I]pid\f[R] \f[CB]VM.symboltable\ \-verbose\f[R]

4
src/java.base/share/man/jfr.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JFR" "1" "2019" "JDK 13" "JDK Commands"
.TH "JFR" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

61
src/java.base/share/man/keytool.1
View File

@ -8,7 +8,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -22,7 +22,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "KEYTOOL" "1" "2019" "JDK 13" "JDK Commands"
.TH "KEYTOOL" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -325,10 +325,10 @@ The following commands creates four key pairs named \f[CB]ca\f[R],
.IP
.nf
\f[CB]
keytool\ \-alias\ ca\ \-dname\ CN=CA\ \-genkeypair
keytool\ \-alias\ ca1\ \-dname\ CN=CA\ \-genkeypair
keytool\ \-alias\ ca2\ \-dname\ CN=CA\ \-genkeypair
keytool\ \-alias\ e1\ \-dname\ CN=E1\ \-genkeypair
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
@ -365,7 +365,7 @@ command:
.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
\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
@ -379,7 +379,7 @@ For example, an Elliptic Curve name.
{\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
{\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
@ -503,7 +503,7 @@ command:
.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
\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
@ -675,7 +675,7 @@ 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
\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
@ -1028,7 +1028,7 @@ 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
{\f[CB]\-file\ crl\f[R]}: Input file name
.IP \[bu] 2
{\f[CB]\-v\f[R]}: Verbose output
.PP
@ -1470,10 +1470,6 @@ The following examples show the defaults for various option values:
\f[CB]
\-alias\ "mykey"
\-keyalg
\ \ \ \ "DSA"\ (when\ using\ \-genkeypair)
\ \ \ \ "DES"\ (when\ using\ \-genseckey)
\-keysize
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA")
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "DSA")
@ -1523,7 +1519,7 @@ T}@T{
SHA256withDSA
T}
T{
RSA \ \ \
RSA
T}@T{
<= 3072
T}@T{
@ -1778,7 +1774,7 @@ Create a keystore and then generate the key pair.
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\ \-keypass\f[R]
\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
@ -1790,10 +1786,10 @@ 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 default DSA key generation algorithm to create the keys;
both are 2048 bits
It uses the RSA key generation algorithm to create the keys; both are
2048 bits
.PP
The command uses the default SHA256withDSA signature algorithm to create
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
@ -1804,13 +1800,13 @@ The private key is assigned the password specified by
.PP
The command is significantly shorter when the option defaults are
accepted.
In this case, no options are required, and the defaults are used for
unspecified options that have default values.
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\f[R]
\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,
@ -1824,10 +1820,9 @@ password, and the private key password.
.PP
\f[B]Note:\f[R]
.PP
The rest of the examples assume that you executed the
\f[CB]\-genkeypair\f[R] command without specifying options, and that you
responded to the prompts with values equal to those specified in the
first \f[CB]\-genkeypair\f[R] command.
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
@ -2042,13 +2037,12 @@ Intermediate CA (\f[CB]ca\f[R])
SSL server (\f[CB]server\f[R])
.PP
Ensure that you store all the certificates in the same keystore.
In the following examples, RSA is the recommended the key algorithm.
.IP
.nf
\f[CB]
keytool\ \-genkeypair\ \-keystore\ root.jks\ \-alias\ root\ \-ext\ bc:c
keytool\ \-genkeypair\ \-keystore\ ca.jks\ \-alias\ ca\ \-ext\ bc:c
keytool\ \-genkeypair\ \-keystore\ server.jks\ \-alias\ server
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
@ -2117,7 +2111,8 @@ certificate with the following command.
See \f[B]Certificate Chains\f[R].
.RS
.PP
\f[CB]keytool\ \-genkeypair\ \-alias\ duke\ \-keypass\f[R] \f[I]passwd\f[R]
\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
@ -2615,7 +2610,7 @@ A sample distinguished name string is:
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\f[R]
\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.

4
src/java.rmi/share/man/rmid.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "RMID" "1" "2018" "JDK 13" "JDK Commands"
.TH "RMID" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/java.rmi/share/man/rmiregistry.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "RMIREGISTRY" "1" "2018" "JDK 13" "JDK Commands"
.TH "RMIREGISTRY" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

6
src/java.scripting/share/man/jrunscript.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JRUNSCRIPT" "1" "2018" "JDK 13" "JDK Commands"
.TH "JRUNSCRIPT" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -31,7 +31,7 @@ and batch modes
.PP
\f[B]Note:\f[R]
.PP
This tool is \f[B]experimental\f[R]\ and unsupported.
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

6
src/jdk.aot/share/man/jaotc.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JAOTC" "1" "2019" "JDK 13" "JDK Commands"
.TH "JAOTC" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -204,6 +204,6 @@ Specify a generated AOT library during application execution:
.IP
.nf
\f[CB]
java\ \-XX:AOTLibrary=./libHelloWorld.so\ HelloWorld
java\ \-XX:+UnlockExperimentalVMOptions\ \-XX:AOTLibrary=./libHelloWorld.so\ HelloWorld
\f[R]
.fi

249
src/jdk.compiler/share/man/javac.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JAVAC" "1" "2019" "JDK 13" "JDK Commands"
.TH "JAVAC" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -65,8 +65,8 @@ 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[CB]\@\f[R]\f[I]filename\f[R] option on the command line to specify an
\f[I]argument file\f[R] that lists their file names.
\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.
@ -100,7 +100,7 @@ Declarations\f[R].
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[CB]\-d\f[R] option described in \f[B]Standard Options\f[R].
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:
@ -160,7 +160,7 @@ or JMOD files.
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[CB]\-J\f[R] options).
(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].
@ -179,7 +179,7 @@ dot (\f[CB]\&.\f[R]).
.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]
\f[CB]ALL\-MODULE\-PATH\f[R].
.RS
.RE
.TP
@ -189,9 +189,10 @@ Overrides the location of the bootstrap class files.
.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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
For JDK 9 or later, see \f[CB]\-\-system\f[R].
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]
@ -205,12 +206,12 @@ 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[CB]\-\-source\-path\f[R] or
\-sourcepath` option is not specified, then the user class path is also
searched for source files.
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[CB]\-processorpath\f[R] option is not specified, then the class
path is also searched for annotation processors.
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]
@ -257,8 +258,8 @@ The \f[CB]\-deprecation\f[R] option is shorthand for
.TP
.B \f[CB]\-\-enable\-preview\f[R]
Enables preview language features.
Used in conjunction with either \f[CB]\-source\f[R] or
\f[CB]\-\-release\f[R].
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
@ -276,8 +277,9 @@ Overrides the location of the endorsed standards path.
.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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
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]
@ -295,8 +297,9 @@ 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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
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]
@ -468,8 +471,9 @@ Checks that the API used is available in the specified profile.
.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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
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]
@ -495,8 +499,8 @@ 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[CB]\-\-source\f[R]/\f[CB]\-source\f[R] or
\f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options.
\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]
@ -560,7 +564,7 @@ help.
.PP
\f[B]Note:\f[R] The target release must be equal to or higher than the
source release.
(See \f[CB]\-\-source\f[R].)
(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]
@ -611,8 +615,9 @@ Overrides the location of the endorsed standards path.
.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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
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]
@ -621,8 +626,9 @@ Overrides the location of installed extensions.
.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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
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]\-\-doclint\-format\f[R] [\f[CB]html4\f[R]|\f[CB]html5\f[R]]
@ -642,8 +648,9 @@ Overrides the location of the bootstrap class files.
.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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
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]
@ -652,8 +659,9 @@ Adds a suffix to the bootstrap class path.
.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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
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]
@ -662,8 +670,9 @@ Adds a prefix to the bootstrap class path.
.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[CB]\-\-release\f[R],
\f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.
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]]
@ -929,9 +938,9 @@ By default, compiler messages go to \f[CB]System.err\f[R].
.SH ENVIRONMENT VARIABLES
.SS CLASSPATH
.PP
If the \f[CB]\-\-class\-path\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.
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
@ -1181,12 +1190,12 @@ 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[CB]\-\-module\f[R] or \f[CB]\-m\f[R] option; see
\f[B]Standard Options\f[R].
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[CB]\-d\f[R] option to specify an output directory in which to
put the compiled class files.
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
@ -1204,15 +1213,15 @@ 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[CB]\-\-class\-path\f[R] option to specify libraries to be
placed on the class path.
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[CB]\-\-module\-path\f[R] option to specify libraries to be
placed on the module path.
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].
@ -1236,23 +1245,24 @@ 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[CB]\-\-source\-path\f[R] option to specify the locations of
additional source files that may be read by javac.
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[CB]\-\-module\-source\-path\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.
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[CB]\-implicit\f[R] option.
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
@ -1371,30 +1381,30 @@ access to the \f[CB]greetings\f[R] package, and to the classes that the
.SH CONFIGURING THE MODULE SYSTEM
.PP
If you want to include additional modules in your compilation, use the
\f[CB]\-\-add\-modules\f[R] option.
\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[CB]\-\-limit\-modules\f[R] option.
\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[CB]\-\-add\-exports\f[R] option.
\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[CB]\-\-add\-reads\f[R] option.
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[CB]\-\-patch\-module\f[R] option.
\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
@ -1416,24 +1426,23 @@ 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[CB]\-Xprefer\f[R] option to
instruct the compiler which to use; see \f[B]Extra Options\f[R].
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[CB]\-implicit\f[R]; see \f[B]Standard
Options\f[R].
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[CB]\-implicit\f[R] option is specified, the compiler gives a warning
that the file is being compiled without being subject to annotation
processing.
\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[CB]\-implicit\f[R] option to specify whether or not class files should
be generated for such source files.
\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.
@ -1459,15 +1468,16 @@ 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[CB]\-\-module\-source\-path\f[R]
option)
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[CB]\-\-upgrade\-module\-path\f[R] option)
\f[B]\f[BC]\-\-upgrade\-module\-path\f[B]\f[R] option)
.IP \[bu] 2
The system modules (see the \f[CB]\-\-system\f[R] option)
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[CB]\-\-module\-path\f[R] option)
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
@ -1524,8 +1534,8 @@ 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[CB]\-Xprefer\f[R] option to override the default
behavior.
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
@ -1570,11 +1580,12 @@ 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[CB]\-\-source\-path\f[R] or \f[CB]\-\-class\-path\f[R].
\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[CB]\-\-module\-path\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.
\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
@ -1618,7 +1629,7 @@ called \f[CB]com.example.MyClass\f[R] in a module called
\f[I]my.library/src/main/java/com/example/MyClass.java\f[R].
.SH THE MODULE SOURCE PATH OPTION
.PP
The \f[CB]\-\-module\-source\-path\f[R] option has two forms: a
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
@ -1653,7 +1664,7 @@ 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[CB]\-\-patch\-module\f[R] option.
\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
@ -1710,7 +1721,8 @@ wildcard character, as found on most operating systems.
.SH PATCHING MODULES
.PP
javac allows any content, whether in source or compiled form, to be
patched into any module using the \f[CB]\-\-patch\-module\f[R] option.
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.
@ -1731,9 +1743,9 @@ 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[CB]\-\-module\-source\-path\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.
\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
@ -1744,11 +1756,11 @@ The API for annotation processors is defined in the
packages and subpackages.
.SS How Annotation Processing Works
.PP
Unless annotation processing is disabled with the \f[CB]\-proc:none\f[R]
option, the compiler searches for any annotation processors that are
available.
The search path can be specified with the \f[CB]\-processorpath\f[R]
option.
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].
@ -1756,7 +1768,7 @@ 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[CB]\-processor\f[R] option.
\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
@ -1777,15 +1789,15 @@ This continues until no new source files are generated.
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[CB]\-proc:only\f[R] option is used, the compiler
compiles the original and all generated source files.
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[CB]\-\-default\-module\-for\-created\-files\f[R]
option.
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
@ -1807,18 +1819,17 @@ 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[CB]\-\-processor\-path\f[R] option.) If the annotation
processor and its dependencies are in modules, you should use the
processor module path instead.
(See the \f[CB]\-\-processor\-module\-path\f[R] option.) When those are
insufficient, it may be necessary to provide further configuration of
the runtime environment.
(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[CB]\-J\f[R].
(See the \f[CB]\-J\f[R] option.)
\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
@ -1826,10 +1837,10 @@ command line options and API to configure an environment in which
.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[CB]\-\-release\f[R] option, or the
\f[CB]\-\-source\f[R]/\f[CB]\-source\f[R] and
\f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options, together with additional
options to specify the platform classes.
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.
@ -1839,11 +1850,14 @@ that is intended for use with the module system.
This includes all of the following options:
.RS 2
.IP \[bu] 2
\f[CB]\-\-module\-source\-path\f[R], \f[CB]\-\-upgrade\-module\-path\f[R],
\f[CB]\-\-system\f[R], \f[CB]\-\-module\-path\f[R],
\f[CB]\-\-add\-modules\f[R], \f[CB]\-\-add\-exports\f[R],
\f[CB]\-\-add\-opens\f[R], \f[CB]\-\-add\-reads\f[R],
\f[CB]\-\-limit\-modules\f[R], \f[CB]\-\-patch\-module\f[R]
\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
@ -1856,10 +1870,13 @@ that is intended to configure the boot class path.
This includes all of the following options:
.RS 2
.IP \[bu] 2
\f[CB]\-Xbootclasspath/p:\f[R], \f[CB]\-Xbootclasspath\f[R],
\f[CB]\-Xbootclasspath/a:\f[R], \f[CB]\-endorseddirs\f[R],
\f[CB]\-Djava.endorsed.dirs\f[R], \f[CB]\-extdirs\f[R],
\f[CB]\-Djava.ext.dirs\f[R], \f[CB]\-profile\f[R]
\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

4
src/jdk.compiler/share/man/serialver.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "SERIALVER" "1" "2018" "JDK 13" "JDK Commands"
.TH "SERIALVER" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

115
src/jdk.hotspot.agent/share/man/jhsdb.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JHSDB" "1" "2018" "JDK 13" "JDK Commands"
.TH "JHSDB" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -34,28 +34,33 @@ analyze the content of a core dump from a crashed Java Virtual Machine
\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[I]options\f[R]] (\f[I]pid\f[R] |
\f[I]executable\f[R] \f[I]coredump\f[R]) [\f[I]server\-id\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]jstack\f[R] [\f[CB]\-\-pid\f[R] \f[I]pid\f[R] |
\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]]
\f[I]coredump\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[I]options\f[R]]
\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]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[I]options\f[R]]
\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]jsnap\f[R] [\f[I]options\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]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.
@ -74,12 +79,6 @@ in a docker container, you must use tools such as \f[CB]ps\f[R] to look up
the PID of the JVM.
.RE
.TP
.B \f[I]server\-id\f[R]
An optional unique ID to use when multiple debug servers are running on
the same remote host.
.RS
.RE
.TP
.B \f[I]executable\f[R]
The Java executable file from which the core dump was produced.
.RS
@ -90,19 +89,26 @@ 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]Common Options for jhsdb Modes\f[R], \f[B]Options for the debugd
Mode\f[R], \f[B]Options for the jinfo Mode\f[R], \f[B]Options for the jmap
Mode\f[R], \f[B]Options for the jmap Mode\f[R], \f[B]Options for the
jstack Mode\f[R], and \f[B]Options for the jsnap Mode\f[R].
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 must be provided.
\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
@ -124,13 +130,13 @@ Starts the interactive command\-line debugger.
.RS
.RE
.TP
.B \f[CB]jhsdb\ debugd\f[R]
Starts the remote debug server.
.B \f[CB]jhsdb\ hsdb\f[R]
Starts the interactive GUI debugger.
.RS
.RE
.TP
.B \f[CB]jhsdb\ hsdb\f[R]
Starts the interactive GUI debugger.
.B \f[CB]jhsdb\ debugd\f[R]
Starts the remote debug server.
.RS
.RE
.TP
@ -153,44 +159,19 @@ Prints basic JVM information.
Prints performance counter information.
.RS
.RE
.SH COMMON OPTIONS FOR JHSDB MODES
.PP
In addition to any required \f[CB]jstack\f[R], \f[CB]jmap\f[R],
\f[CB]jinfo\f[R] or \f[CB]jsnap\f[R] mode specific options, the
\f[CB]pid\f[R], \f[CB]exe\f[R], or \f[CB]core\f[R] options must be provided
for all modes.
The following options are available for all modes.
.TP
.B \f[CB]\-\-pid\f[R]
The process ID of the hanging process.
.RS
.RE
.TP
.B \f[CB]\-\-exe\f[R]
The executable file name.
.RS
.RE
.TP
.B \f[CB]\-\-core\f[R]
The core dump file name.
.RS
.RE
.TP
.B \f[CB]\-\-help\f[R]
Displays the options available for the command.
.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[I]server\-id\f[R]
.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
.SH OPTIONS FOR THE JINFO MODE
.PP
Without specified options, the \f[CB]jhsdb\ jinfo\f[R] prints both flags
and properties.
.TP
.B \f[CB]\-\-flags\f[R]
Prints the VM flags.
@ -207,10 +188,6 @@ Prints the VM flags and the Java system properties.
.RS
.RE
.SH OPTIONS FOR THE JMAP MODE
.PP
In addition to the following mode specific options, the \f[CB]pid\f[R],
\f[CB]exe\f[R], or \f[CB]core\f[R] options described in \f[B]Common Options
for jhsdb Modes\f[R] must be provided.
.TP
.B no option
Prints the same information as Solaris \f[CB]pmap\f[R].
@ -227,8 +204,8 @@ 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]
Prints the name of the dumpfile.
.B \f[CB]\-\-dumpfile\f[R] \f[I]name\f[R]
The name of the dumpfile.
.RS
.RE
.TP
@ -247,10 +224,6 @@ Prints the information on objects awaiting finalization.
.RS
.RE
.SH OPTIONS FOR THE JSTACK MODE
.PP
In addition to the following mode specific options, the \f[CB]pid\f[R],
\f[CB]exe\f[R], or \f[CB]core\f[R] options described in \f[B]Common Options
for jhsdb Modes\f[R] must be provided.
.TP
.B \f[CB]\-\-locks\f[R]
Prints the \f[CB]java.util.concurrent\f[R] locks information.
@ -263,10 +236,6 @@ allows it.
.RS
.RE
.SH OPTIONS FOR THE JSNAP MODE
.PP
In addition to the following mode specific option, the \f[CB]pid\f[R],
\f[CB]exe\f[R], or \f[CB]core\f[R] options described in \f[B]Common Options
for jhsdb Modes\f[R] must be provided.
.TP
.B \f[CB]\-\-all\f[R]
Prints all performance counters.

483
src/jdk.incubator.jpackage/share/man/jpackage.1 Normal file
View File

@ -0,0 +1,483 @@
.\" Copyright (c) 1994, 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 "JPACKAGE" "1" "2019" "JDK 14" "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 and/or mode 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] \f[I]type string\f[R]
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] \f[I]version\f[R]
Version of the application and/or package`
.RS
.RE
.TP
.B \f[CB]\-\-copyright\f[R] \f[I]copyright string\f[R]
Copyright for the application.
.RS
.RE
.TP
.B \f[CB]\-\-description\f[R] \f[I]description string\f[R]
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]\-\-name\f[R] or \f[CB]\-n\f[R] \f[I]name\f[R]
Name of the application and/or package.
.RS
.RE
.TP
.B \f[CB]\-\-dest\f[R] or \f[CB]\-d\f[R] \f[I]output path\f[R]
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] \f[I]file path\f[R]
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] \f[I]vendor string\f[R]
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] \f[I]module name\f[R] [\f[CB],\f[R]\f[I]module name\f[R]...]
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] \f[I]module path\f[R]...
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]\-\-bind\-services\f[R]
Pass on \-\-bind\-services option to jlink (which will link in service
provider modules and their dependences).
.RS
.RE
.TP
.B \f[CB]\-\-runtime\-image\f[R] \f[I]file path\f[R]
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: \-\-strip\-debug,
\-\-no\-header\-files, \-\-no\-man\-pages, and
\-\-strip\-native\-commands.
.RE
.SS Options for creating the application image:
.TP
.B \f[CB]\-\-icon\f[R] \f[I]icon file path\f[R]
Path of the icon of the application bundle (absolute path or relative to
the current directory).
.RS
.RE
.TP
.B \f[CB]\-\-input\f[R] or \f[CB]\-i\f[R] \f[I]input path\f[R]
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] \f[I]launcher name\f[R]=\f[I]file path\f[R]
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", "add\-modules", "main\-jar", "main\-class",
"arguments", "java\-options", "app\-version", "icon", 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] \f[I]main class arguments\f[R]
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] \f[I]java options\f[R]
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] \f[I]class name\f[R]
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] \f[I]main jar file\f[R]
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] \f[I]module name\f[R]/\f[I]main class\f[R]]
The main module (and optionally main class) of the application This
module must be located on the module path.
.RS
.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] \f[I]ID string\f[R]
An identifier that uniquely identifies the application for macOSX.
.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] \f[I]name string\f[R]
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\-bundle\-signing\-prefix\f[R] \f[I]prefix string\f[R]
When signing the application bundle, this value is prefixed to all
components that need to be signed that don\[aq]t have an existing bundle
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] \f[I]file path\f[R]
Path of the keychain to search for the signing identity (absolute path
or relative to the current directory).
.RS
.PP
If not specified, the standard keychains are used.
.RE
.TP
.B \f[CB]\-\-mac\-signing\-key\-user\-name\f[R] \f[I]team name\f[R]
Team name portion in Apple signing identities\[aq] names.
.RS
.PP
For example "Developer ID Application: "
.RE
.SS Options for creating the application package:
.TP
.B \f[CB]\-\-app\-image\f[R] \f[I]file path\f[R]
Location of the predefined application image that is used to build an
installable package (absolute path or relative to the current
directory).
.RS
.PP
See create\-app\-image mode options to create the application image.
.RE
.TP
.B \f[CB]\-\-file\-associations\f[R] \f[I]file path\f[R]
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] \f[I]file path\f[R]
Absolute path of the installation directory of the application on OS X
or Linux.
Relative sub\-path of the installation location of the application such
as "Program Files" or "AppData" on Windows.
.RS
.RE
.TP
.B \f[CB]\-\-license\-file\f[R] \f[I]file path\f[R]
Path to the license file (absolute path or relative to the current
directory).
.RS
.RE
.TP
.B \f[CB]\-\-resource\-dir\f[R] \f[I]path\f[R]
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] \f[I]file\-path\f[R]
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\-menu\f[R]
Adds the application to the system menu.
.RS
.RE
.TP
.B \f[CB]\-\-win\-menu\-group\f[R] \f[I]menu group name\f[R]
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]
Creates a desktop shortcut for the application.
.RS
.RE
.TP
.B \f[CB]\-\-win\-upgrade\-uuid\f[R] \f[I]id string\f[R]
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] \f[I]package name\f[R]
Name for Linux package, defaults to the application name.
.RS
.RE
.TP
.B \f[CB]\-\-linux\-deb\-maintainer\f[R] \f[I]email address\f[R]
Maintainer for .deb bundle.
.RS
.RE
.TP
.B \f[CB]\-\-linux\-menu\-group\f[R] \f[I]menu\-group\-name\f[R]
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] \f[I]type string\f[R]
Type of the license ("License: " of the RPM .spec).
.RS
.RE
.TP
.B \f[CB]\-\-linux\-app\-release\f[R] \f[I]release string\f[R]
Release value of the RPM .spec file or Debian revision value of the DEB
control file.
.RS
.RE
.TP
.B \f[CB]\-\-linux\-app\-category\f[R] \f[I]category string\f[R]
Group value of the RPM .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\ \-m\ 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

4
src/jdk.jartool/share/man/jar.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JAR" "1" "2018" "JDK 13" "JDK Commands"
.TH "JAR" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

6
src/jdk.jartool/share/man/jarsigner.1
View File

@ -8,7 +8,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -22,7 +22,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JARSIGNER" "1" "2019" "JDK 13" "JDK Commands"
.TH "JARSIGNER" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -309,7 +309,7 @@ T}@T{
SHA256withDSA
T}
T{
RSA \ \ \
RSA
T}@T{
<= 3072
T}@T{

7
src/jdk.javadoc/share/man/javadoc.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JAVADOC" "1" "2018" "JDK 13" "JDK Commands"
.TH "JAVADOC" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -173,7 +173,8 @@ 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").
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

286
src/jdk.jcmd/share/man/jcmd.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JCMD" "1" "2018" "JDK 13" "JDK Commands"
.TH "JCMD" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -89,7 +89,7 @@ Using \f[CB]jcmd\f[R] without arguments is the same as using
.RE
.TP
.B \f[CB]\-h\f[R]
Displays the\f[CB]jcmd\f[R] utility\[aq]s command\-line help.
Displays the \f[CB]jcmd\f[R] utility\[aq]s command\-line help.
.RS
.RE
.SH DESCRIPTION
@ -249,7 +249,7 @@ objects (BOOLEAN, false)
.RE
.TP
.B \f[CB]GC.class_stats\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
Provide statistics about Java class meta data.
(Deprecated) Provide statistics about Java class meta data.
.RS
.PP
Impact: High \-\-\- depends on Java heap size and content.
@ -357,38 +357,286 @@ Impact: Medium \-\-\- depends on the Java content.
.RE
.TP
.B \f[CB]JFR.check\f[R] [\f[I]options\f[R]]
See \f[B]JFR.check\f[R]
[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-DA391CC1\-B5D8\-44F1\-AEDD\-9A534C8DD009]
in the Java Flight Recorder Command Reference.
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]]
See \f[B]JFR.configure\f[R]
[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-737D234E\-FD69\-4E8E\-A9F7\-06AE073648DD]
in the Java Flight Recorder Command Reference.
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]]
See \f[B]JFR.dump\f[R]
[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-6EB11926\-4DAF\-4B99\-AF20\-7FCD284EE6C1]
in the Java Flight Recorder Command Reference.
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]]
See \f[B]JFR.start\f[R]
[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-8DC13618\-1515\-4479\-B0FC\-9F4394BE5455]
in the Java Flight Recorder Command Reference.
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)
.RE
.TP
.B \f[CB]JFR.stop\f[R] [\f[I]options\f[R]]
See \f[B]JFR.stop\f[R]
[https://www.oracle.com/pls/topic/lookup?ctx=en/java/javase/11/tools&id=JFRCR\-GUID\-66CC94C8\-8EDF\-4BB6\-8E7A\-49973025D4D9]
in the Java Flight Recorder Command Reference.
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]]

6
src/jdk.jcmd/share/man/jinfo.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JINFO" "1" "2018" "JDK 13" "JDK Commands"
.TH "JINFO" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -29,7 +29,7 @@ jinfo \- generate Java configuration information for a specified Java
process
.SH SYNOPSIS
.PP
\f[B]Note:\f[R] This command is experimental\ and unsupported.
\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

6
src/jdk.jcmd/share/man/jmap.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,14 +21,14 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JMAP" "1" "2018" "JDK 13" "JDK Commands"
.TH "JMAP" "1" "2020" "JDK 14" "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.
\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

6
src/jdk.jcmd/share/man/jps.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,14 +21,14 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JPS" "1" "2018" "JDK 13" "JDK Commands"
.TH "JPS" "1" "2020" "JDK 14" "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.
\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

6
src/jdk.jcmd/share/man/jstack.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JSTACK" "1" "2018" "JDK 13" "JDK Commands"
.TH "JSTACK" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -29,7 +29,7 @@ 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.
\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

6
src/jdk.jcmd/share/man/jstat.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,14 +21,14 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JSTAT" "1" "2018" "JDK 13" "JDK Commands"
.TH "JSTAT" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
jstat \- monitor JVM statistics
.SH SYNOPSIS
.PP
\f[B]Note:\f[R] This command is experimental\ and unsupported.
\f[B]Note:\f[R] This command is experimental and unsupported.
.PP
\f[CB]jstat\f[R] \f[I]generalOptions\f[R]
.PP

4
src/jdk.jconsole/share/man/jconsole.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JCONSOLE" "1" "2018" "JDK 13" "JDK Commands"
.TH "JCONSOLE" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/jdk.jdeps/share/man/javap.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JAVAP" "1" "2018" "JDK 13" "JDK Commands"
.TH "JAVAP" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/jdk.jdeps/share/man/jdeprscan.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JDEPRSCAN" "1" "2018" "JDK 13" "JDK Commands"
.TH "JDEPRSCAN" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/jdk.jdeps/share/man/jdeps.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JDEPS" "1" "2018" "JDK 13" "JDK Commands"
.TH "JDEPS" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/jdk.jdi/share/man/jdb.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JDB" "1" "2018" "JDK 13" "JDK Commands"
.TH "JDB" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/jdk.jlink/share/man/jlink.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JLINK" "1" "2018" "JDK 13" "JDK Commands"
.TH "JLINK" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/jdk.jlink/share/man/jmod.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JMOD" "1" "2018" "JDK 13" "JDK Commands"
.TH "JMOD" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/jdk.jshell/share/man/jshell.1
View File

@ -8,7 +8,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -22,7 +22,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JSHELL" "1" "2018" "JDK 13" "JDK Commands"
.TH "JSHELL" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

6
src/jdk.jstatd/share/man/jstatd.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JSTATD" "1" "2018" "JDK 13" "JDK Commands"
.TH "JSTATD" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP
@ -29,7 +29,7 @@ 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.
\f[B]Note:\f[R] This command is experimental and unsupported.
.PP
\f[CB]jstatd\f[R] [\f[I]options\f[R]]
.TP

4
src/jdk.rmic/share/man/rmic.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "RMIC" "1" "2018" "JDK 13" "JDK Commands"
.TH "RMIC" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP

4
src/jdk.scripting.nashorn.shell/share/man/jjs.1
View File

@ -7,7 +7,7 @@
.\"
.\" 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
.\" 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).
.\"
@ -21,7 +21,7 @@
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JJS" "1" "2018" "JDK 13" "JDK Commands"
.TH "JJS" "1" "2020" "JDK 14" "JDK Commands"
.hy
.SH NAME
.PP