RCWCLRP, RCWCLRPA, RCWCLRPAL, RCWCLRPL

Read check write atomic bit clear on quadword in memory

This instruction atomically loads a 128-bit quadword from memory, performs a bitwise AND with the complement of the value held in a pair of registers on it, and conditionally stores the result back to memory. Storing of the result back to memory is conditional on RCW Checks. The value initially loaded from memory is returned in the same pair of registers. This instruction updates the condition flags based on the result of the update of memory.

  • RCWCLRPA and RCWCLRPAL load from memory with acquire semantics.
  • RCWCLRPL and RCWCLRPAL store to memory with release semantics.
  • RCWCLRP has neither acquire nor release semantics.
  • This instruction is for performing atomic updates of translation table entries and not for general use.

    Encoding: Integer

    Variants: FEAT_D128 && FEAT_THE (FEAT_D128 && FEAT_THE)

    313029282726252423222120191817161514131211109876543210
    000110011100100
    SARRt2o3opcRnRt

    RCWCLRP (A == 0 && R == 0)

    RCWCLRP <Xt1>, <Xt2>, [<Xn|SP>]

    RCWCLRPA (A == 1 && R == 0)

    RCWCLRPA <Xt1>, <Xt2>, [<Xn|SP>]

    RCWCLRPAL (A == 1 && R == 1)

    RCWCLRPAL <Xt1>, <Xt2>, [<Xn|SP>]

    RCWCLRPL (A == 0 && R == 1)

    RCWCLRPL <Xt1>, <Xt2>, [<Xn|SP>]

    Decoding algorithm

    if !IsFeatureImplemented(FEAT_D128) || !IsFeatureImplemented(FEAT_THE) then
        EndOfDecode(Decode_UNDEF);
    if Rt  == '11111' then EndOfDecode(Decode_UNDEF);
    if Rt2 == '11111' then EndOfDecode(Decode_UNDEF);
    constant integer t = UInt(Rt);
    constant integer t2 = UInt(Rt2);
    constant integer n = UInt(Rn);
    constant boolean soft = FALSE;
    
    constant boolean acquire = A == '1';
    constant boolean release = R == '1';
    constant boolean tagchecked = n != 31;
    
    boolean rt_unknown = FALSE;
    
    if t == t2 then
        constant Constraint c = ConstrainUnpredictable(Unpredictable_LSE128OVERLAP);
        assert c IN {Constraint_UNKNOWN, Constraint_UNDEF, Constraint_NOP};
        case c of
            when Constraint_UNKNOWN rt_unknown = TRUE;    // result is UNKNOWN
            when Constraint_UNDEF   EndOfDecode(Decode_UNDEF);
            when Constraint_NOP     EndOfDecode(Decode_NOP);

    Operation

    if !IsD128Enabled(PSTATE.EL) then UNDEFINED;
    bits(64) address;
    bits(64) value1;
    bits(64) value2;
    bits(128) newdata;
    bits(128) readdata;
    bits(4) nzcv;
    
    constant AccessDescriptor accdesc = CreateAccDescRCW(MemAtomicOp_BIC, soft, acquire, release,
                                                         tagchecked);
    
    if n == 31 then
        CheckSPAlignment();
        address = SP[64];
    else
        address = X[n, 64];
    
    value1 = X[t, 64];
    value2 = X[t2, 64];
    
    newdata = if BigEndian(accdesc.acctype) then value1:value2 else value2:value1;
    
    constant bits(128) compdata = bits(128) UNKNOWN;    // Irrelevant when not executing CAS
    (nzcv, readdata) = MemAtomicRCW(address, compdata, newdata, accdesc);
    
    PSTATE. = nzcv;
    if rt_unknown then
        readdata = bits(128) UNKNOWN;
    
    if BigEndian(accdesc.acctype) then
        X[t, 64] = readdata<127:64>;
        X[t2, 64] = readdata<63:0>;
    else
        X[t, 64] = readdata<63:0>;
        X[t2, 64] = readdata<127:64>;

    Explanations

    <Xt1>: Is the 64-bit name of the first general-purpose register to be transferred, encoded in the "Rt" field.
    <Xt2>: Is the 64-bit name of the second general-purpose register to be transferred, encoded in the "Rt2" field.
    <Xn|SP>: Is the 64-bit name of the general-purpose base register or stack pointer, encoded in the "Rn" field.