8280949: Correct the references for the Java Security Standard Algorithm Names specification

Reviewed-by: mullan
This commit is contained in:
Xue-Lei Andrew Fan 2022-01-31 20:25:50 +00:00
parent 319b77492f
commit f991891b0b
6 changed files with 61 additions and 61 deletions

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2021, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2022, 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
@ -920,9 +920,9 @@ public abstract class SSLEngine {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher
* include other cipher suites that the provider supports. * suites that the provider supports.
* *
* @return an array of cipher suite names * @return an array of cipher suite names
* @see #getEnabledCipherSuites() * @see #getEnabledCipherSuites()
@ -946,9 +946,9 @@ public abstract class SSLEngine {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher
* include other cipher suites that the provider supports. * suites that the provider supports.
* *
* @return an array of cipher suite names * @return an array of cipher suite names
* @see #getSupportedCipherSuites() * @see #getSupportedCipherSuites()
@ -968,10 +968,10 @@ public abstract class SSLEngine {
* Note that the standard list of cipher suite names may be found in the * Note that the standard list of cipher suite names may be found in the
* <a href= * <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation. Providers * Algorithm Names Specification. Providers may support cipher suite
* may support cipher suite names not found in this list or might not * names not found in this list or might not use the recommended name
* use the recommended name for a certain cipher suite. * for a certain cipher suite.
* <P> * <P>
* See {@link #getEnabledCipherSuites()} for more information * See {@link #getEnabledCipherSuites()} for more information
* on why a specific cipher suite may never be used on a engine. * on why a specific cipher suite may never be used on a engine.

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2021, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2022, 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
@ -111,9 +111,9 @@ public class SSLParameters {
* {@code setCipherSuites(cipherSuites);}. Note that the * {@code setCipherSuites(cipherSuites);}. Note that the
* standard list of cipher suite names may be found in the <a href= * standard list of cipher suite names may be found in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation. Providers * Algorithm Names Specification. Providers may support cipher suite
* may support cipher suite names not found in this list. * names not found in this list.
* *
* @param cipherSuites the array of ciphersuites (or null) * @param cipherSuites the array of ciphersuites (or null)
*/ */
@ -131,9 +131,9 @@ public class SSLParameters {
* Note that the standard list of cipher suite names may be found in the * Note that the standard list of cipher suite names may be found in the
* <a href= * <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation. Providers * Algorithm Names Specification. Providers may support cipher suite
* may support cipher suite names not found in this list. * names not found in this list.
* *
* @param cipherSuites the array of ciphersuites (or null) * @param cipherSuites the array of ciphersuites (or null)
* @param protocols the array of protocols (or null) * @param protocols the array of protocols (or null)
@ -154,9 +154,9 @@ public class SSLParameters {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher suites
* include other cipher suites that the provider supports. * that the provider supports.
* *
* @return a copy of the array of ciphersuites or null if none * @return a copy of the array of ciphersuites or null if none
* have been set. * have been set.
@ -171,10 +171,10 @@ public class SSLParameters {
* @param cipherSuites the array of ciphersuites (or null). Note that the * @param cipherSuites the array of ciphersuites (or null). Note that the
* standard list of cipher suite names may be found in the <a href= * standard list of cipher suite names may be found in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation. Providers * Algorithm Names Specification. Providers may support cipher suite
* may support cipher suite names not found in this list or might not * names not found in this list or might not use the recommended name
* use the recommended name for a certain cipher suite. * for a certain cipher suite.
*/ */
public void setCipherSuites(String[] cipherSuites) { public void setCipherSuites(String[] cipherSuites) {
this.cipherSuites = clone(cipherSuites); this.cipherSuites = clone(cipherSuites);

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2021, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2022, 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
@ -197,9 +197,9 @@ public abstract class SSLServerSocket extends ServerSocket {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher
* include other cipher suites that the provider supports. * suites that the provider supports.
* *
* @return an array of cipher suites enabled * @return an array of cipher suites enabled
* @see #getSupportedCipherSuites() * @see #getSupportedCipherSuites()
@ -223,10 +223,10 @@ public abstract class SSLServerSocket extends ServerSocket {
* Note that the standard list of cipher suite names may be found in the * Note that the standard list of cipher suite names may be found in the
* <a href= * <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation. Providers * Algorithm Names Specification. Providers may support cipher suite
* may support cipher suite names not found in this list or might not * names not found in this list or might not use the recommended name
* use the recommended name for a certain cipher suite. * for a certain cipher suite.
* <P> * <P>
* <code>SSLSocket</code>s returned from <code>accept()</code> * <code>SSLSocket</code>s returned from <code>accept()</code>
* inherit this setting. * inherit this setting.
@ -253,9 +253,9 @@ public abstract class SSLServerSocket extends ServerSocket {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher
* include other cipher suites that the provider supports. * suites that the provider supports.
* *
* @return an array of cipher suite names * @return an array of cipher suite names
* @see #getEnabledCipherSuites() * @see #getEnabledCipherSuites()

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2022, 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
@ -87,9 +87,9 @@ public abstract class SSLServerSocketFactory extends ServerSocketFactory {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher
* include other cipher suites that the provider supports. * suites that the provider supports.
* *
* @see #getSupportedCipherSuites() * @see #getSupportedCipherSuites()
* @return array of the cipher suites enabled by default * @return array of the cipher suites enabled by default
@ -108,9 +108,9 @@ public abstract class SSLServerSocketFactory extends ServerSocketFactory {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher
* include other cipher suites that the provider supports. * suites that the provider supports.
* *
* @return an array of cipher suite names * @return an array of cipher suite names
* @see #getDefaultCipherSuites() * @see #getDefaultCipherSuites()

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2021, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2022, 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
@ -327,9 +327,9 @@ public abstract class SSLSocket extends Socket
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher
* include other cipher suites that the provider supports. * suites that the provider supports.
* *
* @return an array of cipher suite names * @return an array of cipher suite names
* @see #getEnabledCipherSuites() * @see #getEnabledCipherSuites()
@ -353,9 +353,9 @@ public abstract class SSLSocket extends Socket
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher
* include other cipher suites that the provider supports. * suites that the provider supports.
* *
* @return an array of cipher suite names * @return an array of cipher suite names
* @see #getSupportedCipherSuites() * @see #getSupportedCipherSuites()
@ -375,10 +375,10 @@ public abstract class SSLSocket extends Socket
* Note that the standard list of cipher suite names may be found in the * Note that the standard list of cipher suite names may be found in the
* <a href= * <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation. Providers * Algorithm Names Specification. Providers may support cipher suite
* may support cipher suite names not found in this list or might not * names not found in this list or might not use the recommended name
* use the recommended name for a certain cipher suite. * for a certain cipher suite.
* <P> * <P>
* See {@link #getEnabledCipherSuites()} for more information * See {@link #getEnabledCipherSuites()} for more information
* on why a specific ciphersuite may never be used on a connection. * on why a specific ciphersuite may never be used on a connection.

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2021, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2022, 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
@ -113,9 +113,9 @@ public abstract class SSLSocketFactory extends SocketFactory {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher suites
* include other cipher suites that the provider supports. * that the provider supports.
* *
* @see #getSupportedCipherSuites() * @see #getSupportedCipherSuites()
* @return array of the cipher suites enabled by default * @return array of the cipher suites enabled by default
@ -132,9 +132,9 @@ public abstract class SSLSocketFactory extends SocketFactory {
* The returned array includes cipher suites from the list of standard * The returned array includes cipher suites from the list of standard
* cipher suite names in the <a href= * cipher suite names in the <a href=
* "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names"> * "{@docRoot}/../specs/security/standard-names.html#jsse-cipher-suite-names">
* JSSE Cipher Suite Names</a> section of the Java Cryptography * JSSE Cipher Suite Names</a> section of the Java Security Standard
* Architecture Standard Algorithm Name Documentation, and may also * Algorithm Names Specification, and may also include other cipher suites
* include other cipher suites that the provider supports. * that the provider supports.
* *
* @see #getDefaultCipherSuites() * @see #getDefaultCipherSuites()
* @return an array of cipher suite names * @return an array of cipher suite names