This is an automated email from the ASF dual-hosted git repository.

markt pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tomcat.git


The following commit(s) were added to refs/heads/main by this push:
     new 8a298c8574 Document the hack we are using to pass Tomcat specific 
settings.
8a298c8574 is described below

commit 8a298c8574453c369ef474e4d49cd89727b0fa30
Author: Mark Thomas <[email protected]>
AuthorDate: Mon Feb 2 16:03:24 2026 +0000

    Document the hack we are using to pass Tomcat specific settings.
---
 java/org/apache/tomcat/jni/SSLConf.java | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/java/org/apache/tomcat/jni/SSLConf.java 
b/java/org/apache/tomcat/jni/SSLConf.java
index 0ba3f18195..c474afe825 100644
--- a/java/org/apache/tomcat/jni/SSLConf.java
+++ b/java/org/apache/tomcat/jni/SSLConf.java
@@ -53,7 +53,11 @@ public final class SSLConf {
     public static native void free(long cctx);
 
     /**
-     * Check a command with an SSL_CONF context.
+     * Optionally used to check a command with an SSL_CONF context.
+     * <p>
+     * This call is also used to pass Tomcat specific settings to Tomcat 
Native. It must be called for for each Tomcat
+     * specific setting (e.g. {@link 
org.apache.tomcat.util.net.openssl.OpenSSLConfCmd#NO_OCSP_CHECK}) before {@link
+     * #assign(long, long)} is called.
      *
      * @param cctx  SSL_CONF context to use.
      * @param name  command name.
@@ -71,6 +75,10 @@ public final class SSLConf {
     /**
      * Assign an SSL context to an SSL_CONF context. All following calls to 
{@link #apply(long, String, String)} will be
      * applied to this SSL context.
+     * <p>
+     * For Tomcat specific settings this call applies previous settings set 
via calls to {@link
+     * #check(long, String, String)}. Further calls to {@link #check(long, 
String, String)} after a call to this method
+     * will have no effect.
      *
      * @param cctx SSL_CONF context to use.
      * @param ctx  SSL context to assign to the given SSL_CONF context.
@@ -82,6 +90,8 @@ public final class SSLConf {
 
     /**
      * Apply a command to an SSL_CONF context.
+     * <p>
+     * This call has no effect for Tomcat specific settings.
      *
      * @param cctx  SSL_CONF context to use.
      * @param name  command name.
@@ -97,6 +107,8 @@ public final class SSLConf {
 
     /**
      * Finish commands for an SSL_CONF context.
+     * <p>
+     * This call has no effect for Tomcat specific settings.
      *
      * @param cctx SSL_CONF context to use.
      *


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to