8242477: (bf) MappedByteBuffer should clarify copying between overlapping mappings

[Brian Burkhalter]

To fix [1] this additional verbiage is proposed for the class specification of MappedByteBuffer:

@@ -58,6 +58,9 @@
  * avoid the manipulation of a mapped file by this program, or by a
  * concurrently running program, except to read or write the file's content.
  *
+ * <p> The result of a bulk copy between two {@code MappedByteBuffer}s is
+ * unspecified if they are mapped from overlapping regions of the same file.
+ *
  * <p> Mapped byte buffers otherwise behave no differently than ordinary direct
  * byte buffers. </p>

Please refer also to [2].

Thanks,

Brian

[1] https://bugs.openjdk.java.net/browse/JDK-8242477
[2] https://bugs.openjdk.java.net/browse/JDK-8242253
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/nio-dev/attachments/20200409/ae1f49da/attachment-0001.htm>