From patchwork Wed Dec 14 20:07:56 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Indu Bhagat X-Patchwork-Id: 33337 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:e747:0:0:0:0:0 with SMTP id c7csp442633wrn; Wed, 14 Dec 2022 12:10:49 -0800 (PST) X-Google-Smtp-Source: AA0mqf43z54bJFbc7R3fS+6PMWL3QtZ9m2gt4yr5BrDpdNpFLKdMRsLUyen9keb1r6hOfIDIFfa4 X-Received: by 2002:aa7:c844:0:b0:461:9faf:6895 with SMTP id g4-20020aa7c844000000b004619faf6895mr21687155edt.16.1671048649255; Wed, 14 Dec 2022 12:10:49 -0800 (PST) Received: from sourceware.org (server2.sourceware.org. [2620:52:3:1:0:246e:9693:128c]) by mx.google.com with ESMTPS id bf8-20020a0564021a4800b0046bf4a2db94si11450924edb.491.2022.12.14.12.10.49 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 14 Dec 2022 12:10:49 -0800 (PST) Received-SPF: pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) client-ip=2620:52:3:1:0:246e:9693:128c; Authentication-Results: mx.google.com; dkim=pass header.i=@sourceware.org header.s=default header.b=G5JN04Yc; arc=fail (signature failed); spf=pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="binutils-bounces+ouuuleilei=gmail.com@sourceware.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 705C33883F1A for ; Wed, 14 Dec 2022 20:09:58 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 705C33883F1A DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1671048598; bh=icg92sipevVbqg/tNKmQWHNzU65E5TCYEuZDifMDW9I=; h=To:Cc:Subject:Date:In-Reply-To:References:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From:Reply-To:From; b=G5JN04Yc6Xwf1nByrMY+Dmgq6v6OVATioY6IObVY6lqDF2Ud8AFG7dXwvBkACO3ur ldoo1K2VxE+G4o0glF06QEtbVVbYGen/tJpv3N5HWmcjnNPQj+iWOjcY7dWJY2/7zV gJjUZqdH8+GLwPAEr1AksYLrQxwKa2RypSJwPe3o= X-Original-To: binutils@sourceware.org Delivered-To: binutils@sourceware.org Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by sourceware.org (Postfix) with ESMTPS id 912CB38493E5 for ; Wed, 14 Dec 2022 20:08:27 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 912CB38493E5 Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 2BEHFgLx020097 for ; Wed, 14 Dec 2022 20:08:26 GMT Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta02.appoci.oracle.com [147.154.18.20]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3meyewu9a4-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 14 Dec 2022 20:08:26 +0000 Received: from pps.filterd (iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 2BEJft8b007107 for ; Wed, 14 Dec 2022 20:08:25 GMT Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2175.outbound.protection.outlook.com [104.47.57.175]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3meyeqc3kg-2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 14 Dec 2022 20:08:25 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=F121Igo/BYBFSNBL9xmgyr0IiWYBl6l696MCzeDOHzsmLqNOAKBmeKYqPNVkGOKVMplnMV7kqmhdQm+9X3h7pCnuQy3+F6WI1h/nrmEfGdTBss1K0KypdUBvURjcbMdTEFKuzSxbdVeU+/MJPPo8WR+KEUaQj/dQzoJCsIPIHxDr94yJwOoT/AU/LU/e9YeBhkIWXp0+nix62T9iawqC+GoWgudrGWTD4gqRJTZWbwfXV8poqFqr3tSNfQ+KyrkeIuL2wfK6jYfQFLJVElGQIWye3rJay6vDkSnUUpvuiVMEImxDVzil6DHLtViXpftSAtZiS6sE7jK9JD09BqnPxw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=icg92sipevVbqg/tNKmQWHNzU65E5TCYEuZDifMDW9I=; b=gMx09grHcHUiyykmAenILSVgkxnJfZjZIfKJb2mJYz0x74kvOu+AEMe8tjmq7UaIsh/QqZLDlH53O/zFLc5tnrbdwc/UEVe0vUzW+Jg5dCjrBT06e7UaLKl7BXEB7rLfcNv2H8PjJLm4l5n9jqKMjfyun5nR0B+oTYFGeVhYQpvvnU1t+GTqlUo2Ywv9phs1sokLLHyS4Fofk1Cvv95UcveTHvlHI2ks47rzaxxPEic/ri5VEn1csqeNWnpugH93w+7g8IRLrZYCd/sLggnis8R+C+CCUcbn0TBVl+RWrqBIB2Xk6UwHtH1rLlhCH6W+TUFxFGSskZbW97Znzr1DJw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none Received: from MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) by SJ1PR10MB6002.namprd10.prod.outlook.com (2603:10b6:a03:45f::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.19; Wed, 14 Dec 2022 20:08:20 +0000 Received: from MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::ee70:1952:4416:1bdc]) by MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::ee70:1952:4416:1bdc%5]) with mapi id 15.20.5880.019; Wed, 14 Dec 2022 20:08:20 +0000 To: binutils@sourceware.org Cc: Indu Bhagat Subject: [PATCH 5/5] [5/5] sframe: doc: update documentation for pauth key in SFrame FDE Date: Wed, 14 Dec 2022 12:07:56 -0800 Message-Id: <20221214200756.1234528-6-indu.bhagat@oracle.com> X-Mailer: git-send-email 2.37.2 In-Reply-To: <20221214200756.1234528-1-indu.bhagat@oracle.com> References: <20221214200756.1234528-1-indu.bhagat@oracle.com> X-ClientProxiedBy: MWH0EPF00056D0F.namprd21.prod.outlook.com (2603:10b6:30f:fff2:0:1:0:11) To MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2158:EE_|SJ1PR10MB6002:EE_ X-MS-Office365-Filtering-Correlation-Id: df95be32-0a83-4d99-1ff2-08dade0ef287 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: AkDy9vGuY5imH7U+/OT+rTNbDK95+SwRYBKVu3raHCgNPYorA8AneWN5+T+5T9v0Shwgq44yB3AEWFbrlFS5pR2ceqdgJfRVBehgfHvzB3RCKpv5Mr+Xr4Z27oZGMCEpaDaeCEZ1SWCxXB94av7L7DJVH1DMujrfekCpdYPMIFycKSBPwURaARsL9440ZhfboFhs7suEsIBSewUSLvHe6QR6TYdeGALcqQhhwavOmAYXCdCMj7mv4EI4EzGipL0pdNBG6xI943snkIodlnoQocJxjRQO7c+kDd6WCHPSdRQuKa5g1OxUnafaHYGWROOInyQTpwg4BCbf308b7m0YMO4WjC2CP/18H84AaoNFiqKkpfC+yJB13q7b9wem8qR9Uk2jjpWNZtswPsqPQR9VY+VK83a1kT1nNN9sNbPF+zSY1HuDPEjpoEJrqB1pdBfplSkZQd+Ak0vNUf1lGM70NI+G8t3I+VtTo5q2SxiNYWLD4B5jpC+fUIvoKMYYgCrq++ZKtzKs7f/8STEMmIyv8zdKtTeUxlAWeP1l1MMPcMQ6jIdsBmpTr0Cq6oOaDjZwpgEtQ24eEm4TZN4b/E/IADKP3cAYJFC1I/f8KSy2Y/+2BUqTb5WtU8HRZ/3NZf0mojSwLhT87XOOmkCITWjO1Q== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MWHPR1001MB2158.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230022)(396003)(366004)(346002)(376002)(136003)(39860400002)(451199015)(8936002)(41300700001)(4326008)(5660300002)(44832011)(4744005)(66556008)(66476007)(66946007)(8676002)(2906002)(6506007)(36756003)(478600001)(6916009)(316002)(1076003)(2616005)(107886003)(86362001)(186003)(6512007)(6486002)(6666004)(38100700002)(83380400001); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: rjTmo692CCaZwIJ07ey2Zue9tNudCn7EenZVkEWDHZwXpdQP0v7iiulkEvNHDjdE6dj8SxeUQHuP6WQLdhgqeWmL+3wWj9wS/U8mrBEhH4QVlge9iOh1alYgEr0+5Q+nnPcSNDqIYvhTX06naXDA3cXA0gdyR0DRl97/ogZRfL766aje/mCnrfENj179fM/SYpJ2QJSxyYLUVFD2thDScgIK9HsVXF415Boe+NKFnasNM2TCMlTcVbLGbS/QVqVBr/tK7gnuA9suBopzE41HLKRFOFTx94c1rgApWPoX5LbQjKyF3HYm8AkaA51f8g/rgMo2amtX0Rpgk5qRotrjGeqJoC68issAGrSzprcT9VOGGmacPfHgXnvke9xXr6F6LpuWoT4/fyRq+BxR8cFev7HPu4e+7q5KvQ0ji2dMmHI1usrENdmvf52cl/Sf5o87ls5udpbv3HZIOTl0j4tbYdj+Whv/beT9+ht6TyW+gh36ZHwSE4+yJ8GoD9c9q0pbahYUL0BIArmvjImiz/wt8sHZZa1hfxUD3NyGnnT85RIKCXzTKS+1u/azbXw/zVsyX6HWqp3lS/z8h+SrmlRp2B/hS3tLPIW5aIZMFG1WVJ85Lj2x5hymgpxDxMsPTtdwXs4VKNd+w2kpSSc7SBdaUIK0jDhc7oIK6jEZ1S8HaE9vmoCJ4GiNRNwxA4WxyhvBOW3e7rmtSoncpd2W+PhQ/oZnJJuRjGU/rh7H52Orr67vCYSf5OjAOFeqqgkFDFbft2zljm0pc5wWd3dxOrFI6890P2rK5cfS0a59Zp2aurRQx2lU9Z/kVYI0lpUtVmPow4/joNqOgymop7MeFExxUvfdvZwJ9N+cNyrGs2tFg7JABMRQNK+Ps8S5eJ5OmXPvbNmNDXhtdgwK6pyxEe7dLYrIa2g+dIbe1m0payJJ2hpzAWxs3soq/5kJ2qW5se4rX1MTEW6uIGrKgMYTU11tGXS5PjWzXcEFpglOAASd28nkJ5hAf2ye1sIIwGeuJMhGpWPKOm5ifNkScuo3h1ULi+iyIwasqFtxtsvZHvYbS84+/EQF/Xm8lRxpl5+ViaDLK5GKwZhirM+/siyymIDJAGoXHtyboivLhLHxVTRX5Zr7tvgdEbEp6ZYz7bRywNKZAym3+bsGaTIKH5IJVJebg/yD3V44+2OrKL9SqPV4YRCegSPix8YOYqpex7ATP1ZwDonUyLrFwjwjkmTWIpdKDHO/KOB+eB5gq9MXl0GA1K/qpuGZbYID8uKXY3Nv9lPfhBDqxgAWKrxlQ/jqTtuElRv6I07+6w1VkCb/X4tTFJ+EGXgGKuMmjXAMf4+bTxLuet6gXkXbywIczZ/nTjfLhGDI0vwM0FUtlt6CE1MImlwAiHPwkCZ1nOx1y4CFhyz8kYRJuFoWm2bItWpnyvIeVwea7RISyKYCtgBMdCpjcDCOFI/j/2+0VVcIw18a7UL6LBAlUNZ9PXgiwI/J6ACerksbZsMcNwK3PebE/biGOmL2deMMqb14Xd9aGsv3grsI8vF73l9fJVN2B0XKXB5dWUc8RM9K1AwKgawG6BBLN57/cF27+0TBpusFZPe4MmQuzpfWONBzNKK5nlP09Xhs/jDr1Mb1y6SDZKJKy8WBQqs= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: df95be32-0a83-4d99-1ff2-08dade0ef287 X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2158.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Dec 2022 20:08:20.8071 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: G2QgP0t9WIzLHdA5+18LK6IGKzdlUqL+f49vVhtSSZvOkuEA57gc2G8uiQxv6jh1XleMB6j2T7Cepg44C0uK+A== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ1PR10MB6002 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.923,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-12-14_11,2022-12-14_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 phishscore=0 bulkscore=0 suspectscore=0 mlxscore=0 mlxlogscore=999 spamscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2212140164 X-Proofpoint-GUID: mqZcvOwbTGM7yWGxpZhApvve8BQFNFx0 X-Proofpoint-ORIG-GUID: mqZcvOwbTGM7yWGxpZhApvve8BQFNFx0 X-Spam-Status: No, score=-13.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: binutils@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Indu Bhagat via Binutils From: Indu Bhagat Reply-To: Indu Bhagat Errors-To: binutils-bounces+ouuuleilei=gmail.com@sourceware.org Sender: "Binutils" X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1752221508839059766?= X-GMAIL-MSGID: =?utf-8?q?1752221508839059766?= ChangeLog: * libsframe/doc/sframe-spec.texi --- libsframe/doc/sframe-spec.texi | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/libsframe/doc/sframe-spec.texi b/libsframe/doc/sframe-spec.texi index fa66d801dd3..345b8f93036 100644 --- a/libsframe/doc/sframe-spec.texi +++ b/libsframe/doc/sframe-spec.texi @@ -398,10 +398,16 @@ The info word is a bitfield split into three parts. From MSB to LSB: @multitable {Bit offset} {@code{isroot}} {Length of variable-length data for this type (some kinds only).} @headitem Bit offset @tab Name @tab Description -@item 7--5 +@item 7--6 @tab @code{unused} @tab Unused bits. +@item 5 +@tab @code{pauth_key} +@tab Specify which key is used for signing the return addresses in the SFrame +FDE. Two possible values: SFRAME_AARCH64_PAUTH_KEY_A (0) or +SFRAME_AARCH64_PAUTH_KEY_B (1). + @item 4 @tab @code{fdetype} @tab SFRAME_FDE_TYPE_PCMASK (1) or SFRAME_FDE_TYPE_PCINC (0). @xref{The SFrame FDE types}.