Add debug method in pkcs11 ConfigurationException

Improve error reporting for SunPKCS11 provider initialization failures
due to possible configuration errors. Output error messages when
-Djava.security.debug=sunpkcs11 is used. Constructors are updated
to call the debug method with the error message.

Signed-off-by: Sarwat Shaheen <[email protected]>

Author: sarwat12

src/jdk.crypto.cryptoki/share/classes/sun/security/pkcs11/Config.java

@@ -25,7 +25,7 @@
 
 /*
  * ===========================================================================
- * (c) Copyright IBM Corp. 2023, 2023 All Rights Reserved
+ * (c) Copyright IBM Corp. 2023, 2025 All Rights Reserved
  * ===========================================================================
  */
 
@@ -37,6 +37,7 @@
 import java.nio.charset.StandardCharsets;
 import java.util.*;
 
+import sun.security.util.Debug;
 import sun.security.util.PropertyExpander;
 
 import sun.security.pkcs11.wrapper.*;
@@ -1084,11 +1085,23 @@ private void parseHandleStartupErrors(String keyword) throws IOException {
 class ConfigurationException extends IOException {
     @Serial
     private static final long serialVersionUID = 254492758807673194L;
+
+    private static final Debug configDebug = Debug.getInstance("sunpkcs11");
+
+    private static void debug(String msg) {
+         // If debugging is enabled, use the Debug class for additional sunpkcs11 logging.
+         if (configDebug != null) {
+             configDebug.println(msg);
+         }
+     }
+
     ConfigurationException(String msg) {
         super(msg);
+        debug(msg);
     }
 
     ConfigurationException(String msg, Throwable e) {
         super(msg, e);
+        debug(msg);
     }
 }