8255853: Update all nroff manpages for JDK 16 release

Reviewed-by: erikj
This commit is contained in:
Magnus Ihse Bursie 2020-11-03 22:12:56 +00:00
parent cdf9cd8afa
commit 622f72bc8b
28 changed files with 309 additions and 132 deletions

View file

@ -1,4 +1,3 @@
.\"t
.\" Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
@ -20,9 +19,10 @@
.\" or visit www.oracle.com if you need additional information or have any .\" or visit www.oracle.com if you need additional information or have any
.\" questions. .\" questions.
.\" .\"
.\"t
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JAVA" "1" "2020" "JDK 15" "JDK Commands" .TH "JAVA" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP
@ -181,7 +181,7 @@ 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 You\[aq]ll get an error message if you use a value of \f[I]N\f[R] that is
no longer supported. no longer supported.
The supported values of \f[I]N\f[R] are the current Java SE release The supported values of \f[I]N\f[R] are the current Java SE release
(\f[CB]15\f[R]) and a limited number of previous releases, detailed in the (\f[CB]16\f[R]) and a limited number of previous releases, detailed in the
command\-line help for \f[CB]javac\f[R], under the \f[CB]\-\-source\f[R] and command\-line help for \f[CB]javac\f[R], under the \f[CB]\-\-source\f[R] and
\f[CB]\-\-release\f[R] options. \f[CB]\-\-release\f[R] options.
.RE .RE
@ -4089,14 +4089,6 @@ This option was deprecated in JDK 8 and superseded by the
\f[CB]\-XX:MetaspaceSize\f[R] option. \f[CB]\-XX:MetaspaceSize\f[R] option.
.RS .RS
.RE .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 REMOVED JAVA OPTIONS .SH REMOVED JAVA OPTIONS
.PP .PP
These \f[CB]java\f[R] options have been removed in JDK 15 and using them These \f[CB]java\f[R] options have been removed in JDK 15 and using them
@ -4106,28 +4098,20 @@ results in an error of:
\f[CB]Unrecognized\ VM\ option\f[R] \f[I]option\-name\f[R] \f[CB]Unrecognized\ VM\ option\f[R] \f[I]option\-name\f[R]
.RE .RE
.TP .TP
.B \f[CB]\-XX:+FailOverToOldVerifier\f[R] .B \f[CB]\-XX:+UseParallelOldGC\f[R]
Enables automatic failover to the old verifier when the new type checker Enables the use of the parallel garbage collector for full GCs.
fails. By default, this option is disabled.
By default, this option is disabled and it\[aq]s ignored (that is, Enabling it automatically enables the \f[CB]\-XX:+UseParallelGC\f[R]
treated as disabled) for classes with a recent bytecode version. option.
You can enable it only for classes with older versions of the bytecode.
.RS
.RE
.TP
.B \f[CB]\-XX:+UseConcMarkSweepGC\f[R]
Enables the use of the CMS garbage collector for the old generation.
CMS is an alternative to the default garbage collector (G1), which also
focuses on meeting application latency requirements.
By default, this option is disabled and the collector is selected
automatically based on the configuration of the machine and type of the
JVM.
.RS .RS
.RE .RE
.PP .PP
For the lists and descriptions of options removed in previous releases For the lists and descriptions of options removed in previous releases
see the \f[I]Removed Java Options\f[R] section in: see the \f[I]Removed Java Options\f[R] section in:
.IP \[bu] 2 .IP \[bu] 2
\f[B]Java Platform, Standard Edition Tools Reference, Release 15\f[R]
[https://docs.oracle.com/en/java/javase/15/docs/specs/man/java.html]
.IP \[bu] 2
\f[B]Java Platform, Standard Edition Tools Reference, Release 14\f[R] \f[B]Java Platform, Standard Edition Tools Reference, Release 14\f[R]
[https://docs.oracle.com/en/java/javase/14/docs/specs/man/java.html] [https://docs.oracle.com/en/java/javase/14/docs/specs/man/java.html]
.IP \[bu] 2 .IP \[bu] 2

View file

@ -1,4 +1,3 @@
.\"t
.\" Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
@ -20,9 +19,10 @@
.\" or visit www.oracle.com if you need additional information or have any .\" or visit www.oracle.com if you need additional information or have any
.\" questions. .\" questions.
.\" .\"
.\"t
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "KEYTOOL" "1" "2020" "JDK 15" "JDK Commands" .TH "KEYTOOL" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP
@ -980,6 +980,28 @@ Sockets Layer (SSL) server host and port
.IP \[bu] 2 .IP \[bu] 2
{\f[CB]\-jarfile\f[R] \f[I]JAR_file\f[R]}: Signed \f[CB]\&.jar\f[R] file {\f[CB]\-jarfile\f[R] \f[I]JAR_file\f[R]}: Signed \f[CB]\&.jar\f[R] file
.IP \[bu] 2 .IP \[bu] 2
{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
.IP \[bu] 2
{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
.IP \[bu] 2
[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
.IP \[bu] 2
{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
.IP \[bu] 2
{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
.IP \[bu] 2
{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
an optional configure argument.
.IP \[bu] 2
{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
an optional configure argument.
.IP \[bu] 2
{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
.IP \[bu] 2
{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
.IP \[bu] 2
{\f[CB]\-v\f[R]}: Verbose output {\f[CB]\-v\f[R]}: Verbose output
.PP .PP
Use the \f[CB]\-printcert\f[R] command to read and print the certificate Use the \f[CB]\-printcert\f[R] command to read and print the certificate
@ -1012,7 +1034,11 @@ command line for proxy tunneling.
.PP .PP
\f[B]Note:\f[R] \f[B]Note:\f[R]
.PP .PP
This option can be used independently of a keystore. This command can be used independently of a keystore.
This command does not check for the weakness of a certificate\[aq]s
signature algorithm if it is a trusted certificate in the user keystore
(specified by \f[CB]\-keystore\f[R]) or in the \f[CB]cacerts\f[R] keystore
(if \f[CB]\-trustcacerts\f[R] is specified).
.RE .RE
.TP .TP
.B \f[CB]\-printcertreq\f[R] .B \f[CB]\-printcertreq\f[R]
@ -1038,6 +1064,28 @@ command:
.IP \[bu] 2 .IP \[bu] 2
{\f[CB]\-file\ crl\f[R]}: Input file name {\f[CB]\-file\ crl\f[R]}: Input file name
.IP \[bu] 2 .IP \[bu] 2
{\f[CB]\-keystore\f[R] \f[I]keystore\f[R]}: Keystore name
.IP \[bu] 2
{\f[CB]\-trustcacerts\f[R]}: Trust certificates from cacerts
.IP \[bu] 2
[\f[CB]\-storepass\f[R] \f[I]arg\f[R]]: Keystore password
.IP \[bu] 2
{\f[CB]\-storetype\f[R] \f[I]type\f[R]}: Keystore type
.IP \[bu] 2
{\f[CB]\-providername\f[R] \f[I]name\f[R]}: Provider name
.IP \[bu] 2
{\f[CB]\-addprovider\f[R] \f[I]name\f[R] [\f[CB]\-providerarg\f[R]
\f[I]arg\f[R]]}: Add security provider by name (such as SunPKCS11) with
an optional configure argument.
.IP \[bu] 2
{\f[CB]\-providerclass\f[R] \f[I]class\f[R] [\f[CB]\-providerarg\f[R]
\f[I]arg\f[R]]}: Add security provider by fully qualified class name with
an optional configure argument.
.IP \[bu] 2
{\f[CB]\-providerpath\f[R] \f[I]list\f[R]}: Provider classpath
.IP \[bu] 2
{\f[CB]\-protected\f[R]}: Password is provided through protected mechanism
.IP \[bu] 2
{\f[CB]\-v\f[R]}: Verbose output {\f[CB]\-v\f[R]}: Verbose output
.PP .PP
Use the \f[CB]\-printcrl\f[R] command to read the Certificate Revocation Use the \f[CB]\-printcrl\f[R] command to read the Certificate Revocation
@ -1048,7 +1096,11 @@ The CA generates the \f[CB]crl\f[R] file.
.PP .PP
\f[B]Note:\f[R] \f[B]Note:\f[R]
.PP .PP
This option can be used independently of a keystore. This command can be used independently of a keystore.
This command attempts to verify the CRL using a certificate from the
user keystore (specified by \f[CB]\-keystore\f[R]) or the \f[CB]cacerts\f[R]
keystore (if \f[CB]\-trustcacerts\f[R] is specified), and will print out a
warning if it cannot be verified.
.RE .RE
.SH COMMANDS FOR MANAGING THE KEYSTORE .SH COMMANDS FOR MANAGING THE KEYSTORE
.TP .TP
@ -1479,9 +1531,9 @@ The following examples show the defaults for various option values:
\-alias\ "mykey" \-alias\ "mykey"
\-keysize \-keysize
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA") \ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "RSA",\ "DSA",\ or\ "RSASSA\-PSS")
\ \ \ \ 2048\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "DSA")
\ \ \ \ 256\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EC") \ \ \ \ 256\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EC")
\ \ \ \ 255\ (when\ using\ \-genkeypair\ and\ \-keyalg\ is\ "EdDSA")
\ \ \ \ 56\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DES") \ \ \ \ 56\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DES")
\ \ \ \ 168\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DESede") \ \ \ \ 168\ (when\ using\ \-genseckey\ and\ \-keyalg\ is\ "DESede")
@ -1564,7 +1616,66 @@ T}@T{
T}@T{ T}@T{
SHA512withECDSA SHA512withECDSA
T} T}
T{
RSASSA\-PSS
T}@T{
<= 3072
T}@T{
RSASSA\-PSS (with SHA\-256)
T}
T{
T}@T{
<= 7680
T}@T{
RSASSA\-PSS (with SHA\-384)
T}
T{
T}@T{
> 7680
T}@T{
RSASSA\-PSS (with SHA\-512)
T}
T{
EdDSA
T}@T{
255
T}@T{
Ed25519
T}
T{
T}@T{
448
T}@T{
Ed448
T}
T{
Ed25519
T}@T{
255
T}@T{
Ed25519
T}
T{
Ed448
T}@T{
448
T}@T{
Ed448
T}
.TE .TE
.IP \[bu] 2
An RSASSA\-PSS signature algorithm uses a \f[CB]MessageDigest\f[R]
algorithm as its hash and MGF1 algorithms.
.IP \[bu] 2
EdDSA supports 2 key sizes: Ed25519 and Ed448.
When generating an EdDSA key pair using \f[CB]\-keyalg\ EdDSA\f[R], a user
can specify \f[CB]\-keysize\ 255\f[R] or \f[CB]\-keysize\ 448\f[R] to
generate Ed25519 or Ed448 key pairs.
When no \f[CB]\-keysize\f[R] is specified, an Ed25519 key pair is
generated.
A user can also directly specify \f[CB]\-keyalg\ Ed25519\f[R] or
\f[CB]\-keyalg\ Ed448\f[R] to generate a key pair with the expected key
size.
.PP .PP
\f[B]Note:\f[R] \f[B]Note:\f[R]
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "RMID" "1" "2020" "JDK 15" "JDK Commands" .TH "RMID" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 1997, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "RMIREGISTRY" "1" "2020" "JDK 15" "JDK Commands" .TH "RMIREGISTRY" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2006, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2006, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JRUNSCRIPT" "1" "2020" "JDK 15" "JDK Commands" .TH "JRUNSCRIPT" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JAVAC" "1" "2020" "JDK 15" "JDK Commands" .TH "JAVAC" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 1997, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "SERIALVER" "1" "2020" "JDK 15" "JDK Commands" .TH "SERIALVER" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JHSDB" "1" "2020" "JDK 15" "JDK Commands" .TH "JHSDB" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2018, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2018, 2019, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JPACKAGE" "1" "2019" "JDK 15" "JDK Commands" .TH "JPACKAGE" "1" "2019" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP
@ -152,10 +152,14 @@ and is absolute or relative to the current directory.
This option can be used multiple times. This option can be used multiple times.
.RE .RE
.TP .TP
.B \f[CB]\-\-bind\-services\f[R] .B \f[CB]\-\-jlink\-options\f[R] <jlink options>
Pass on \-\-bind\-services option to jlink (which will link in service A space separated list of options to pass to jlink
provider modules and their dependences).
.RS .RS
.PP
If not specified, defaults to "\-\-strip\-native\-commands
\-\-strip\-debug \-\-no\-man\-pages \-\-no\-header\-files"
.PP
This option can be used multiple times.
.RE .RE
.TP .TP
.B \f[CB]\-\-runtime\-image\f[R] <file paths> .B \f[CB]\-\-runtime\-image\f[R] <file paths>

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 1997, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JAR" "1" "2020" "JDK 15" "JDK Commands" .TH "JAR" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,3 @@
.\"t
.\" Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
@ -20,9 +19,10 @@
.\" or visit www.oracle.com if you need additional information or have any .\" or visit www.oracle.com if you need additional information or have any
.\" questions. .\" questions.
.\" .\"
.\"t
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JARSIGNER" "1" "2020" "JDK 15" "JDK Commands" .TH "JARSIGNER" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP
@ -290,18 +290,20 @@ implementation, then change the line to the following:
.SH SUPPORTED ALGORITHMS .SH SUPPORTED ALGORITHMS
.PP .PP
By default, the \f[CB]jarsigner\f[R] command signs a JAR file using one of By default, the \f[CB]jarsigner\f[R] command signs a JAR file using one of
the following algorithms files depending on the type and size of the the following algorithms and block file extensions depending on the type
private key: and size of the private key:
.PP .PP
.TS .TS
tab(@); tab(@);
l l l. l l l l.
T{ T{
keyalg keyalg
T}@T{ T}@T{
keysize keysize
T}@T{ T}@T{
default sigalg default sigalg
T}@T{
block file extension
T} T}
_ _
T{ T{
@ -310,6 +312,8 @@ T}@T{
any size any size
T}@T{ T}@T{
SHA256withDSA SHA256withDSA
T}@T{
\&.DSA
T} T}
T{ T{
RSA RSA
@ -317,18 +321,22 @@ T}@T{
<= 3072 <= 3072
T}@T{ T}@T{
SHA256withRSA SHA256withRSA
T}@T{
\&.RSA
T} T}
T{ T{
T}@T{ T}@T{
<= 7680 <= 7680
T}@T{ T}@T{
SHA384withRSA SHA384withRSA
T}@T{
T} T}
T{ T{
T}@T{ T}@T{
> 7680 > 7680
T}@T{ T}@T{
SHA512withRSA SHA512withRSA
T}@T{
T} T}
T{ T{
EC EC
@ -336,20 +344,70 @@ T}@T{
< 384 < 384
T}@T{ T}@T{
SHA256withECDSA SHA256withECDSA
T}@T{
\&.EC
T} T}
T{ T{
T}@T{ T}@T{
< 512 < 512
T}@T{ T}@T{
SHA384withECDSA SHA384withECDSA
T}@T{
T} T}
T{ T{
T}@T{ T}@T{
= 512 = 512
T}@T{ T}@T{
SHA512withECDSA SHA512withECDSA
T}@T{
T}
T{
RSASSA\-PSS
T}@T{
<= 3072
T}@T{
RSASSA\-PSS (with SHA\-256)
T}@T{
\&.RSA
T}
T{
T}@T{
<= 7680
T}@T{
RSASSA\-PSS (with SHA\-384)
T}@T{
T}
T{
T}@T{
> 7680
T}@T{
RSASSA\-PSS (with SHA\-512)
T}@T{
T}
T{
EdDSA
T}@T{
255
T}@T{
Ed25519
T}@T{
\&.EC
T}
T{
T}@T{
448
T}@T{
Ed448
T}@T{
T} T}
.TE .TE
.IP \[bu] 2
If an RSASSA\-PSS key is encoded with parameters, then jarsigner will
use the same parameters in the signature.
Otherwise, jarsigner will use parameters that are determined by the size
of the key as specified in the table above.
For example, an 3072\-bit RSASSA\-PSS key will use RSASSA\-PSS as the
signature algorithm and SHA\-256 as the hash and MGF1 algorithms.
.PP .PP
These default signature algorithms can be overridden by using the These default signature algorithms can be overridden by using the
\f[CB]\-sigalg\f[R] option. \f[CB]\-sigalg\f[R] option.
@ -393,12 +451,13 @@ A signature block file with a \f[CB]\&.DSA\f[R], \f[CB]\&.RSA\f[R], or
The base file names for these two files come from the value of the The base file names for these two files come from the value of the
\f[CB]\-sigfile\f[R] option. \f[CB]\-sigfile\f[R] option.
For example, when the option is \f[CB]\-sigfile\ MKSIGN\f[R], the files For example, when the option is \f[CB]\-sigfile\ MKSIGN\f[R], the files
are named \f[CB]MKSIGN.SF\f[R] and \f[CB]MKSIGN.DSA\f[R] are named \f[CB]MKSIGN.SF\f[R] and \f[CB]MKSIGN.RSA\f[R].
In this document, we assume the signer always uses an RSA key.
.PP .PP
If no \f[CB]\-sigfile\f[R] option appears on the command line, then the If no \f[CB]\-sigfile\f[R] option appears on the command line, then the
base file name for the \f[CB]\&.SF\f[R] and \f[CB]\&.DSA\f[R] files is the base file name for the \f[CB]\&.SF\f[R] and the signature block files is
first 8 characters of the alias name specified on the command line, all the first 8 characters of the alias name specified on the command line,
converted to uppercase. all converted to uppercase.
If the alias name has fewer than 8 characters, then the full alias name If the alias name has fewer than 8 characters, then the full alias name
is used. is used.
If the alias name contains any characters that aren\[aq]t allowed in a If the alias name contains any characters that aren\[aq]t allowed in a
@ -442,7 +501,8 @@ This file also contains, encoded inside it, the certificate or
certificate chain from the keystore that authenticates the public key certificate chain from the keystore that authenticates the public key
corresponding to the private key used for signing. corresponding to the private key used for signing.
The file has the extension \f[CB]\&.DSA\f[R], \f[CB]\&.RSA\f[R], or The file has the extension \f[CB]\&.DSA\f[R], \f[CB]\&.RSA\f[R], or
\f[CB]\&.EC\f[R], depending on the digest algorithm used. \f[CB]\&.EC\f[R], depending on the key algorithm used.
See the table in \f[B]Supported Algorithms\f[R].
.SH SIGNATURE TIME STAMP .SH SIGNATURE TIME STAMP
.PP .PP
The \f[CB]jarsigner\f[R] command used with the following options generates The \f[CB]jarsigner\f[R] command used with the following options generates
@ -468,9 +528,9 @@ Verify the signature of the \f[CB]\&.SF\f[R] file.
.RS 4 .RS 4
.PP .PP
The verification ensures that the signature stored in each signature The verification ensures that the signature stored in each signature
block (\f[CB]\&.DSA\f[R]) file was generated using the private key block file was generated using the private key corresponding to the
corresponding to the public key whose certificate (or certificate chain) public key whose certificate (or certificate chain) also appears in the
also appears in the \f[CB]\&.DSA\f[R] file. signature block file.
It also ensures that the signature is a valid signature of the It also ensures that the signature is a valid signature of the
corresponding signature (\f[CB]\&.SF\f[R]) file, and thus the corresponding signature (\f[CB]\&.SF\f[R]) file, and thus the
\f[CB]\&.SF\f[R] file wasn\[aq]t tampered with. \f[CB]\&.SF\f[R] file wasn\[aq]t tampered with.
@ -543,7 +603,7 @@ jarsigner\ myBundle.jar\ kevin
.fi .fi
.PP .PP
When a JAR file is signed multiple times, there are multiple When a JAR file is signed multiple times, there are multiple
\f[CB]\&.SF\f[R] and \f[CB]\&.DSA\f[R] files in the resulting JAR file, one \f[CB]\&.SF\f[R] and signature block files in the resulting JAR file, one
pair for each signature. pair for each signature.
In the previous example, the output JAR file includes files with the In the previous example, the output JAR file includes files with the
following names: following names:
@ -551,9 +611,9 @@ following names:
.nf .nf
\f[CB] \f[CB]
SUSAN.SF SUSAN.SF
SUSAN.DSA SUSAN.RSA
KEVIN.SF KEVIN.SF
KEVIN.DSA KEVIN.RSA
\f[R] \f[R]
.fi .fi
.SH OPTIONS FOR JARSIGNER .SH OPTIONS FOR JARSIGNER
@ -701,10 +761,10 @@ by \f[B]Internet RFC 1421 Certificate Encoding Standard\f[R]
.TP .TP
.B \f[CB]\-sigfile\f[R] \f[I]file\f[R] .B \f[CB]\-sigfile\f[R] \f[I]file\f[R]
Specifies the base file name to be used for the generated \f[CB]\&.SF\f[R] Specifies the base file name to be used for the generated \f[CB]\&.SF\f[R]
and \f[CB]\&.DSA\f[R] files. and signature block files.
For example, if file is \f[CB]DUKESIGN\f[R], then the generated For example, if file is \f[CB]DUKESIGN\f[R], then the generated
\f[CB]\&.SF\f[R] and \f[CB]\&.DSA\f[R] files are named \f[CB]DUKESIGN.SF\f[R] \f[CB]\&.SF\f[R] and signature block files are named \f[CB]DUKESIGN.SF\f[R]
and \f[CB]DUKESIGN.DSA\f[R], and placed in the \f[CB]META\-INF\f[R] and \f[CB]DUKESIGN.RSA\f[R], and placed in the \f[CB]META\-INF\f[R]
directory of the signed JAR file. directory of the signed JAR file.
.RS .RS
.PP .PP
@ -712,10 +772,10 @@ The characters in the file must come from the set
\f[CB]a\-zA\-Z0\-9_\-\f[R]. \f[CB]a\-zA\-Z0\-9_\-\f[R].
Only letters, numbers, underscore, and hyphen characters are allowed. Only letters, numbers, underscore, and hyphen characters are allowed.
All lowercase characters are converted to uppercase for the All lowercase characters are converted to uppercase for the
\f[CB]\&.SF\f[R] and \f[CB]\&.DSA\f[R] file names. \f[CB]\&.SF\f[R] and signature block file names.
.PP .PP
If no \f[CB]\-sigfile\f[R] option appears on the command line, then the If no \f[CB]\-sigfile\f[R] option appears on the command line, then the
base file name for the \f[CB]\&.SF\f[R] and \f[CB]\&.DSA\f[R] files is the base file name for the \f[CB]\&.SF\f[R] and signature block files is the
first 8 characters of the alias name specified on the command line, all first 8 characters of the alias name specified on the command line, all
converted to upper case. converted to upper case.
If the alias name has fewer than 8 characters, then the full alias name If the alias name has fewer than 8 characters, then the full alias name
@ -804,7 +864,7 @@ If the \f[CB]\-certs\f[R] option appears on the command line with the
\f[CB]\-verify\f[R] and \f[CB]\-verbose\f[R] options, then the output \f[CB]\-verify\f[R] and \f[CB]\-verbose\f[R] options, then the output
includes certificate information for each signer of the JAR file. includes certificate information for each signer of the JAR file.
This information includes the name of the type of certificate (stored in This information includes the name of the type of certificate (stored in
the \f[CB]\&.DSA\f[R] file) that certifies the signer\[aq]s public key, the signature block file) that certifies the signer\[aq]s public key,
and if the certificate is an X.509 certificate (an instance of the and if the certificate is an X.509 certificate (an instance of the
\f[CB]java.security.cert.X509Certificate\f[R]), then the distinguished \f[CB]java.security.cert.X509Certificate\f[R]), then the distinguished
name of the signer. name of the signer.
@ -885,11 +945,11 @@ Standard Algorithm Names.
.RE .RE
.TP .TP
.B \f[CB]\-internalsf\f[R] .B \f[CB]\-internalsf\f[R]
In the past, the \f[CB]\&.DSA\f[R] (signature block) file generated when a In the past, the signature block file generated when a JAR file was
JAR file was signed included a complete encoded copy of the signed included a complete encoded copy of the \f[CB]\&.SF\f[R] file
\f[CB]\&.SF\f[R] file (signature file) also generated. (signature file) also generated.
This behavior has been changed. This behavior has been changed.
To reduce the overall size of the output JAR file, the \f[CB]\&.DSA\f[R] To reduce the overall size of the output JAR file, the signature block
file by default doesn\[aq]t contain a copy of the \f[CB]\&.SF\f[R] file file by default doesn\[aq]t contain a copy of the \f[CB]\&.SF\f[R] file
anymore. anymore.
If \f[CB]\-internalsf\f[R] appears on the command line, then the old If \f[CB]\-internalsf\f[R] appears on the command line, then the old
@ -900,6 +960,15 @@ incurs higher overhead.
.RS .RS
.RE .RE
.TP .TP
.B \f[CB]\-directsign\f[R]
By default, jarsigner stores the hash of the \f[CB]\&.SF\f[R] file and
possibly other information in a SignerInfo signedAttributes field, and
then calculates the signature on this field.
If this option is set, no SignerInfo signedAttributes field is generated
and the signature is calculated on the \f[CB]\&.SF\f[R] file directly.
.RS
.RE
.TP
.B \f[CB]\-sectionsonly\f[R] .B \f[CB]\-sectionsonly\f[R]
If the \f[CB]\-sectionsonly\f[R] option appears on the command line, then If the \f[CB]\-sectionsonly\f[R] option appears on the command line, then
the \f[CB]\&.SF\f[R] file (signature file) generated when a JAR file is the \f[CB]\&.SF\f[R] file (signature file) generated when a JAR file is
@ -1213,6 +1282,15 @@ Informational warnings include those that aren\[aq]t errors but regarded
as bad practice. as bad practice.
They don\[aq]t have a code. They don\[aq]t have a code.
.TP .TP
.B extraAttributesDetected
The POSIX file permissions and/or symlink attributes are detected during
signing or verifying a JAR file.
The \f[CB]jarsigner\f[R] tool preserves these attributes in the newly
signed file but warns that these attributes are unsigned and not
protected by the signature.
.RS
.RE
.TP
.B hasExpiringCert .B hasExpiringCert
This JAR contains entries whose signer certificate expires within six This JAR contains entries whose signer certificate expires within six
months. months.
@ -1251,9 +1329,9 @@ JAR file \f[CB]sbundle.jar\f[R]:
.RE .RE
.PP .PP
There is no \f[CB]\-sigfile\f[R] specified in the previous command so the There is no \f[CB]\-sigfile\f[R] specified in the previous command so the
generated \f[CB]\&.SF\f[R] and \f[CB]\&.DSA\f[R] files to be placed in the generated \f[CB]\&.SF\f[R] and signature block files to be placed in the
signed JAR file have default names based on the alias name. signed JAR file have default names based on the alias name.
They are named \f[CB]JANE.SF\f[R] and \f[CB]JANE.DSA\f[R]. They are named \f[CB]JANE.SF\f[R] and \f[CB]JANE.RSA\f[R].
.PP .PP
If you want to be prompted for the store password and the private key If you want to be prompted for the store password and the private key
password, then you could shorten the previous command to the following: password, then you could shorten the previous command to the following:

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JAVADOC" "1" "2020" "JDK 15" "JDK Commands" .TH "JAVADOC" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JCMD" "1" "2020" "JDK 15" "JDK Commands" .TH "JCMD" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JINFO" "1" "2020" "JDK 15" "JDK Commands" .TH "JINFO" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JMAP" "1" "2020" "JDK 15" "JDK Commands" .TH "JMAP" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JPS" "1" "2020" "JDK 15" "JDK Commands" .TH "JPS" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JSTACK" "1" "2020" "JDK 15" "JDK Commands" .TH "JSTACK" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JSTAT" "1" "2020" "JDK 15" "JDK Commands" .TH "JSTAT" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP
@ -224,7 +224,7 @@ Class loader statistics.
.PP .PP
\f[CB]Unloaded\f[R]: Number of classes unloaded. \f[CB]Unloaded\f[R]: Number of classes unloaded.
.PP .PP
\f[CB]Bytes\f[R]: Number of KB loaded. \f[CB]Bytes\f[R]: Number of KB unloaded.
.PP .PP
\f[CB]Time\f[R]: Time spent performing class loading and unloading \f[CB]Time\f[R]: Time spent performing class loading and unloading
operations. operations.

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JCONSOLE" "1" "2020" "JDK 15" "JDK Commands" .TH "JCONSOLE" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JAVAP" "1" "2020" "JDK 15" "JDK Commands" .TH "JAVAP" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JDEPRSCAN" "1" "2020" "JDK 15" "JDK Commands" .TH "JDEPRSCAN" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JDEPS" "1" "2020" "JDK 15" "JDK Commands" .TH "JDEPS" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JDB" "1" "2020" "JDK 15" "JDK Commands" .TH "JDB" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2019, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JFR" "1" "2020" "JDK 15" "JDK Commands" .TH "JFR" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2017, 2019, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
.\" This code is free software; you can redistribute it and/or modify it .\" This code is free software; you can redistribute it and/or modify it
@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JLINK" "1" "2020" "JDK 15" "JDK Commands" .TH "JLINK" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JMOD" "1" "2020" "JDK 15" "JDK Commands" .TH "JMOD" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -1,4 +1,3 @@
.\"t
.\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved. .\" Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\" .\"
@ -20,9 +19,10 @@
.\" or visit www.oracle.com if you need additional information or have any .\" or visit www.oracle.com if you need additional information or have any
.\" questions. .\" questions.
.\" .\"
.\"t
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JSHELL" "1" "2020" "JDK 15" "JDK Commands" .TH "JSHELL" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP

View file

@ -21,7 +21,7 @@
.\" .\"
.\" Automatically generated by Pandoc 2.3.1 .\" Automatically generated by Pandoc 2.3.1
.\" .\"
.TH "JSTATD" "1" "2020" "JDK 15" "JDK Commands" .TH "JSTATD" "1" "2020" "JDK 16" "JDK Commands"
.hy .hy
.SH NAME .SH NAME
.PP .PP