RETAASPPC, RETABSPPC (immediate)

Return from subroutine, with enhanced pointer authentication return (immediate). This instruction authenticates the address that is held in LR, using SP as the first modifier, the specified immediate subtracted from PC as the second modifier, and the specified key, and branches to the authenticated address, with a hint that this instruction is a subroutine return.

Key A is used for RETAASPPC. Key B is used for RETABSPPC.

If the authentication passes, the PE continues execution at the target of the branch. For information on behavior if the authentication fails, see Faulting on pointer authentication.

The authenticated address is not written back to LR.

Integer
(FEAT_PAuth_LR)

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16	15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
0	1	0	1	0	1	0	1	0	0	x	imm16																1	1	1	1	1
								opc

RETAASPPC (opc == 000)

RETAASPPC <label>

RETABSPPC (opc == 001)

RETABSPPC <label>

if !IsFeatureImplemented(FEAT_PAuth_LR) then
    UNDEFINED;

boolean use_key_a = opc<0> == '0';
bits(64) offset = ZeroExtend(imm16:'00', 64);

Assembler Symbols

<label>

Is the program label whose address is to be calculated. Its negative offset from the address of this instruction, a multiple of 4 in the range -262140 to 0, is encoded as an unsigned value in the "imm16" field as <label>/4.

Operation

GCSInstruction inst_type;
bits(64) target = X[30, 64];

bits(64) modifier = SP[];
bits(64) modifier2 = PC64 - offset;

if use_key_a then
    target = AuthIA2(target, modifier, modifier2, TRUE);
else
    target = AuthIB2(target, modifier, modifier2, TRUE);

if IsFeatureImplemented(FEAT_GCS) && GCSPCREnabled(PSTATE.EL) then
    inst_type = if use_key_a then GCSInstType_PRETAA else GCSInstType_PRETAB;
    target = LoadCheckGCSRecord(target, inst_type);
    SetCurrentGCSPointer(GetCurrentGCSPointer() + 8);

// Value in BTypeNext will be used to set PSTATE.BTYPE
BTypeNext = '00';

BranchTo(target, BranchType_RET, FALSE);