Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8153875

Add api notes to access mode methods stating compatible memory ordering effects with C++ atomics

    Details

    • Type: Enhancement
    • Status: Open
    • Priority: P4
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: tbd
    • Component/s: core-libs
    • Labels:

      Description

      Certain access mode methods have api notes stating compatible memory ordering effects with C++ atomics.

      Similar api notes can be added to other access mode methods:

      On Fri, Apr 8, 2016 at 7:40 AM, Aleksey Shipilev
      <aleksey.shipilev@oracle.com> wrote:
      On 04/08/2016 03:51 PM, Paul Sandoz wrote:
      http://cr.openjdk.java.net/~psandoz/jdk9/JDK-8151198-VH-factory-exceptions/webrev/
      <http://cr.openjdk.java.net/~psandoz/jdk9/JDK-8151198-VH-factory-exceptions/webrev/>

      I agree with updates.

      But have more comments on C/C++ @apiNote-s. Would you like to address
      them in follow-ups? Notably, getVolatile may be also marked analogous to
      memory_order_seq_cst, and get/setOpaque may be marked analogous to C/C++
      "volatile"-s. And CAS/CAE memory semantics can also be spelled out in
      terms of std::memory_order.

        Attachments

          Activity

            People

            • Assignee:
              mchung Mandy Chung
              Reporter:
              psandoz Paul Sandoz
            • Votes:
              1 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated: