F-15742: document that callback ByteBuffer arguments are only valid until the callback returns

src/java/com/wolfssl/WolfSSLByteBufferIORecvCallback.java

@@ -50,6 +50,10 @@ public interface WolfSSLByteBufferIORecvCallback {
      * be read from the transport layer. The callback should read data and
      * place the data into the buffer provided. The number of bytes read should
      * be returned. The callback should return an error code on error.
+     * <p>
+     * The <b>buf</b> ByteBuffer wraps native memory that is only valid
+     * until this method returns. Do not use it, or any duplicate or
+     * slice of it, after returning.
      *
      * @param ssl   the current SSL session object from which the callback was
      *              initiated.

src/java/com/wolfssl/WolfSSLByteBufferIOSendCallback.java

@@ -51,6 +51,10 @@ public interface WolfSSLByteBufferIOSendCallback {
      * The callback should send data from the provided ByteBuffer (buf) across
      * the transport layer. The number of bytes sent should be returned, or
      * a negative error code on error.
+     * <p>
+     * The <b>buf</b> ByteBuffer wraps native memory that is only valid
+     * until this method returns. Do not use it, or any duplicate or
+     * slice of it, after returning.
      *
      * @param ssl   the current SSL session object from which the callback was
      *              initiated.

src/java/com/wolfssl/WolfSSLDecryptVerifyCallback.java

@@ -42,6 +42,10 @@ public interface WolfSSLDecryptVerifyCallback {
      * Atomic record layer decrypt/verify callback method.
      * This method acts as the decrypt/verify callback to be used with
      * the wolfSSL atomic record layer processing.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl       the current SSL session object from which the
      *                  callback was initiated.

src/java/com/wolfssl/WolfSSLEccSharedSecretCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLEccSharedSecretCallback {
     /**
      * ECC shared secret callback method.
      * This method acts as ECC shared secret callback.
+     * <p>
+     * The <b>out</b> buffer, and <b>pubKeyDer</b> on the client side, wrap
+     * native memory that is only valid until this method returns. Do not
+     * use them, or any duplicate or slice of them, after returning.
      *
      * @param ssl         the current SSL session object from which the
      *                    callback was initiated.

src/java/com/wolfssl/WolfSSLEccSignCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLEccSignCallback {
     /**
      * ECC signing callback method.
      * This method acts as ECC signing callback.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl       the current SSL session object from which the
      *                  callback was initiated.

src/java/com/wolfssl/WolfSSLEccVerifyCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLEccVerifyCallback {
     /**
      * ECC verification callback method.
      * This method acts as ECC verification callback.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl       the current SSL session object from which the
      *                  callback was initiated.

src/java/com/wolfssl/WolfSSLMacEncryptCallback.java

@@ -42,6 +42,10 @@ public interface WolfSSLMacEncryptCallback {
      * Atomic record layer MAC Encrypt callback method.
      * This method acts as the Atomic User Record Processing Mac/Encrypt
      * callback to be used with the wolfSSL atomic record layer processing.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl           the current SSL session object from which the
      *                      callback was initiated.

src/java/com/wolfssl/WolfSSLRsaDecCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLRsaDecCallback {
     /**
      * RSA private decrypt callback method.
      * This method acts as RSA private decrypt callback.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl       the current SSL session object from which the
      *                  callback was initiated.

src/java/com/wolfssl/WolfSSLRsaEncCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLRsaEncCallback {
     /**
      * RSA public encrypt callback method.
      * This method acts as RSA public enrypt callback.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl       the current SSL session object from which the
      *                  callback was initiated.

src/java/com/wolfssl/WolfSSLRsaPssSignCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLRsaPssSignCallback {
     /**
      * RSA-PSS signing callback method.
      * This method acts as RSA-PSS signing callback.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl    the current SSL session object from which the callback was
      *               initiated.

src/java/com/wolfssl/WolfSSLRsaPssVerifyCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLRsaPssVerifyCallback {
     /**
      * RSA-PSS verification callback method.
      * This method acts as RSA-PSS verification callback.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl    the current SSL session object from which the callback
      *               was initiated.

src/java/com/wolfssl/WolfSSLRsaSignCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLRsaSignCallback {
     /**
      * RSA signing callback method.
      * This method acts as RSA signing callback.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl       the current SSL session object from which the
      *                  callback was initiated.

src/java/com/wolfssl/WolfSSLRsaVerifyCallback.java

@@ -40,6 +40,10 @@ public interface WolfSSLRsaVerifyCallback {
     /**
      * RSA verification callback method.
      * This method acts as RSA verification callback.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl       the current SSL session object from which the
      *                  callback was initiated.

src/java/com/wolfssl/WolfSSLVerifyDecryptCallback.java

@@ -43,6 +43,10 @@ public interface WolfSSLVerifyDecryptCallback {
      * Atomic record layer verify/decrypt callback method.
      * This method acts as the verify/decrypt callback to be used with
      * the wolfSSL atomic record layer processing.
+     * <p>
+     * ByteBuffer arguments wrap native memory that is only valid until
+     * this method returns. Do not use them, or any duplicate or slice of
+     * them, after returning.
      *
      * @param ssl       the current SSL session object from which the
      *                  callback was initiated.