From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by sourceware.org (Postfix) with ESMTPS id 361E43858CDA for ; Thu, 19 Jan 2023 21:47:39 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 361E43858CDA Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=oracle.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=oracle.com Received: from pps.filterd (m0333520.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 30JLT9f7020902 for ; Thu, 19 Jan 2023 21:47:37 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : content-transfer-encoding : content-type : mime-version; s=corp-2022-7-12; bh=tPrtQXLmzJ2c8dwyEp9VO749Imc61QiTzLgSOOH9exo=; b=c3SrJD1XjfK29LVVJNCBxtKm4kHUeSebM7tBQN5zAMMtYvgU4XezFM1XOCVhPE3jD7n6 Sxk3e3uYzqn6Mct4eNGXKvQTVOjKi0NRTblEc0Lh6uTOmj2eO5LDOgB3/Pam8AsavGdh 65z2smWOtRuSN0Q194M2PyvzT53xlV8XO9C9RbZf1FYI3V8yYUmale3c7RwmuOgWSu1d FGEiakA/pIe2XoImdCC5R6pLO5x0m1Sx9++SDFL9pOpMBFTLWofMfxSEumuvuAo2sVl/ UPMaeRHFPNs0a28ayeuRAVRQuyre7acM95PBlA52YUcO3BvUL59WgzCPrf3DkLmK1+tI dA== Received: from phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta02.appoci.oracle.com [147.154.114.232]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3n3medkfuw-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 19 Jan 2023 21:47:36 +0000 Received: from pps.filterd (phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 30JLA7tC000901 for ; Thu, 19 Jan 2023 21:47:35 GMT Received: from nam02-sn1-obe.outbound.protection.outlook.com (mail-sn1nam02lp2048.outbound.protection.outlook.com [104.47.57.48]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3n74d1t150-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 19 Jan 2023 21:47:35 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=oHuC3/EO0RmvV4NL//2uQmoyGiyjz4RKUUdjm9yLYtxnF+C+R1bbgOOWCSlaINb9YWzsg2XBJqpVqJO26+/olx0cH0DKxOYyDfiiCobjvsCCzRhp98GiYiS4fNTwZNayfBe0CZiaOj4HCUuu1FYm3z8emdxdLM88qcJYoq6PtUzjGpqReacfp9S5To5N2oe8WsAomN+QMWoZFfpZCLOrnsyQccmIco/Yl3zQAMVVCgpa7/YJTvTT7llnmotU0p2dPt2bEYmR+GcTBE4nloVF12cjfSBxgE+CRLGEiQ4NiiZFxs218f2wcxr+IE99UWCIheTX69peGQGUkJ28ZsVfpA== 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=tPrtQXLmzJ2c8dwyEp9VO749Imc61QiTzLgSOOH9exo=; b=NOgjTlHSI6cSY4RmfoCSIyZdun0/T8duxfkMjC5/d0mxnTn9By4E4jGmnFB4rTvP5Ch6987iAXkev1JLbQ5nf2UQSka3T9ZbK37RHn1Vorf183Wfl04LQxXvndzHAsi0ALdaYs5FLJl6AAls+ovpP9JghIZWTLG5/DDTed4AT1r4EohDMvHMvmjIcaI5lD7JpnL3fveShJAG+yUblgI9kWTY72jMRC9tUubNjtUAW8Xu6kzQQ9G+jCMr6BfCjDvR+0oj2HBvLN9NN4RVuV1c18tJ8mZVVMOfvKiL+W6W23+QscZzfngu/qaoAIx86Wh9yQoAju+0JZsXGsbrQaijew== 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 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=tPrtQXLmzJ2c8dwyEp9VO749Imc61QiTzLgSOOH9exo=; b=z0LkYugf6sMER/MRAo3ZogXYle0QjX9k9Ld5gTXO7O4OI8iob81gqZNVXOmy0JBkIEOFoWTE2tk64eaDy2IFMgiMRYZZanYmBmCfO18WOOs3UoIflJxyddCyak+Gcvpzm9j9fZzH8HQfdJueKrYmv2GFJEFGQ33Nz1SKdXbMUxQ= Received: from MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) by IA0PR10MB6843.namprd10.prod.outlook.com (2603:10b6:208:435::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6002.12; Thu, 19 Jan 2023 21:47:33 +0000 Received: from MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::14e6:a522:273f:db57]) by MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::14e6:a522:273f:db57%7]) with mapi id 15.20.6002.012; Thu, 19 Jan 2023 21:47:33 +0000 From: Indu Bhagat To: binutils@sourceware.org Cc: Indu Bhagat Subject: [PATCH] doc: sframe: fix some warnings Date: Thu, 19 Jan 2023 13:47:28 -0800 Message-Id: <20230119214728.3208371-1-indu.bhagat@oracle.com> X-Mailer: git-send-email 2.39.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: MW4PR04CA0174.namprd04.prod.outlook.com (2603:10b6:303:85::29) To MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2158:EE_|IA0PR10MB6843:EE_ X-MS-Office365-Filtering-Correlation-Id: 893c55d4-bdd2-4f42-f0c8-08dafa66c583 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 9Dp3nApLFWK9uVYZVnDoQGjz/D0AeEkZWDPH34Bj6FqdqMfuSsrziA1gHRNh5bZoa5mMQBaW+jlorNAoP3wwId7UAFUhDflCxcQOLS9fNwJZQn1wsjcBf/5mZaJoRTZYtM6X7FIjsFnq/ajmRVk88r//nt+MujpP0PyFYrXs2zEFmWxIJGZ1aMEpG+L1TQba8hFIe8p+5bGBgvZbTEyI4VpmacEekRRKX52C7aV58XrXfYLMDgb84llkqjltLlH7IhJnirKp/MLktWiGjaDbPmS9TFGuOxHu0pNZQ6uh2aYP6ujcf/xzur9sUlj/orlcvmX3Bu4qXOzjgbO+lIP+wJW8KTk9+TuFNDdRMaarb5K6c5BP2FS06UsWDSBrxEZ+cVng2fZZlUipIQs7Kj5tvnSHNmttMJuJcnqw4sIG6O9tM/mDP/EvhWNHPfkmrdXCz/uzQxjccUr9UrHhWceh5k162uhkzTQr96PC5dt5RsR1ZAuAZ8Si4DqKitYZhilTfKhlu4WxEQR9+S9FT+Y6l7K5HzWvkX3444vkGsBQ3NXvqkijbSz62wk1XiD5cTmr/q5YYzg5fzD3cRmyynDn9aeZHBOCfmx49CrNyU9eOa/a5tBoSW4TTZDwpSynoDloEB4Dtp1j4P5vufOJE5vPsw== 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)(136003)(39860400002)(366004)(376002)(346002)(396003)(451199015)(36756003)(316002)(6486002)(83380400001)(478600001)(86362001)(6916009)(66556008)(66946007)(5660300002)(41300700001)(8676002)(2906002)(44832011)(4326008)(66476007)(6666004)(107886003)(8936002)(2616005)(1076003)(6506007)(6512007)(186003)(38100700002)(26005);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?0LDzTLukm/Eu0zovQQP+l6xVVPkECHFYSRWLaRDOdlJ40IsRtbCIQmMhWfnp?= =?us-ascii?Q?zQ2y7A48FeAL4K6vlk4daXBH6fIAg+/KSjuu8BagA8pt4fJa808UsD1xYEi5?= =?us-ascii?Q?K33JIOYX/DrxoC2iyGhDtTpQhUI2xIvI0IbkWBd9bPO50puRaxt8SCQLK4pB?= =?us-ascii?Q?uIgbkaf+ZZNgM9XTZr+HgrJxlItkoy/O+pOfj02Pq3LoXsRi1FpRS2kkSSyB?= =?us-ascii?Q?Hpa14PdqOhjf8tR0Jc55dd8UTMyJWs9tq9g4QC35C4QMT94tINWC4YUxVUaZ?= =?us-ascii?Q?9L9Q0FZx6U44+1+14LuZJmjgLJRNh0iHGYwVk2zuBezgJOgVCstgUjij2Zpg?= =?us-ascii?Q?jPW23R+bKVdbov4agXZ6iHrVpduAVRgf2p0yyOtwNTfTwvn/budud9jkn8Qj?= =?us-ascii?Q?XiF8q6W1rHstI9naDSmtgJGbtOFyyhBwM3rRfl+6N7SPX0uM3E0taaI/YjQ8?= =?us-ascii?Q?lS0v6oxrWwGYsDZTo4c/ZAidweG5UFBfKrNSQM9MBZxjd0kTqgofJUJWAuXZ?= =?us-ascii?Q?aY8V3wYNIs/INlQWYRcKuF55hWeC3cSV0L+2CwzTFHw7yeVgkFz+oiWEBIK+?= =?us-ascii?Q?cZ57ky9WVuPgbrvP/SM9f9ROYhkcC/Wxo86fdpG8eWh1Ujqls4djai+ZwZxs?= =?us-ascii?Q?WK9v1udsSDIUyPVyG/Y73KJYUOyToVS7V7OVcGMP9O0lLbVhdsK4aeA0x8Cc?= =?us-ascii?Q?SKEMeLGYsnIrrAsRamV0LGG9TwBRgfJGUcI6zDdP5dcTB/77PdEDF2tOOzVJ?= =?us-ascii?Q?HeOOo9a3ukaW49P3orsw5/56varEO3XqlwY10ZR5v6MwlOEooHH8Dtj8sCEO?= =?us-ascii?Q?ExiJS9S7H+yuW5KxwNfosXVQNspeSlQaZcZGFjboAy/VoKghFGR7VaUg9y4a?= =?us-ascii?Q?wyRsAJrHhEsigb/Lqv/b/yo6daz9VOy1GuZkiArSrXQ2f2CXHaqZfTMqcopc?= =?us-ascii?Q?XHNRhf70PC/L7F9qb/eMxgYAuVFMNbfOctp4Adt4FwC5S1xykvZoyYEJt9yL?= =?us-ascii?Q?JN5hEe9tM+kOS0i3mDtgn1XhWl5cyixMW26b9Rdxuub2oRP/Ju5y+sAXFhvZ?= =?us-ascii?Q?uIBEcSC64BiA7ZPWp8zWnbSznc5haRJjiUATLtDvzSAqew5etoISKu7Cy2ks?= =?us-ascii?Q?DwPepucHgGWORfopJEfZO5Jy5dU5fT6hdnbVxNM0DteSeeCHDR31aJs/b8gV?= =?us-ascii?Q?k2EW4cUEJfspvTyDlrmv6xmrqrPN+9GmIU/VsjqXSNWjFI+O9E3ZeszUvPjZ?= =?us-ascii?Q?ZDns5lYzIJV0IKhrKxc3lP0RUmM6iZN25xk2l8gib0+3ChphOwJSbdTeyzZN?= =?us-ascii?Q?if6qjDMiLLks2wuNVQuQsO2sBCxyq6kgBn/S2MHNfRe6LlKS6iwb7Hv9jp6O?= =?us-ascii?Q?wGAuZXKgYJDnK6Zc9MXXSGx0pbX6oamq6uXlVvis6xL35SPdrLQ0oJgkdB0I?= =?us-ascii?Q?q/hJ1uDNHrg6TfSsVVVs9yPKQawkr/EzvjDGLTW9U6oqAh+6ojqWIMusuUZr?= =?us-ascii?Q?qqwcrgEDasB94wMjCk0bXQakswls7KX9khZlwA6/ctT400S3msGOZWH+PCwW?= =?us-ascii?Q?WbOBaCE1MD+82AqcK0xkMV+sdS4F9/JDT6JKJPHp8QZiIL9LkjiCyN87wPBF?= =?us-ascii?Q?Ug=3D=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: bn+shQiCMSpRFpPsnWy3HGxF1hrkaTUt1yoGTt5tnuaxNqLiQr1cVh/gyIt1W7CoEdMwWnKxU6I8gPUM8AuL0dHUaQCTdxQJayegPaSdBNMn24UrYEf+lM+PDUeEes8iKuWEpGAR447CHZstPjUXRcEXjXNY/jC4Ocf410dA4ot3bhVrPjr1aTQxVTZvcU5vmiiIFwq238OfgWl9CXWt4Pii74G2MRSg9GkxFEqid4tGt9mhCBrOeBN4DYXcE4oopLfY/BVui8s5OqE+/0sVo9JSXW67oOMWSI02y5jedgSODVMjg5Pmo0uHHnNaTMxCaVNK8WrMLTKSuS3LzJWD88cRtcWrBz+uaqHCTyvsitqYIeBFhmmf4jT3l3kzBoOhkGMWSFw2wOKXsnYwRP2Uw9LNISS1WdLcWAwMb7t7UTCnUkBFJRuBK2dF02S4CsvjeE3vfzPZcpxNWLUDH2p53bbSgipXz/V+uMY0vo1uDzIEFKG4McJ53nDGVv8JFZkyjiSkR2iVPZ6JHsg7CMq49I8iJhTWrnneMVErV/HkZRPRomW4EufrMDZuRtpuFtLybReVZUNTVJAcJMj8u/lAZCIDWqsGMOgcRyaFrjHdQhiD3/St4DXtxroi2aUEtqEF/ooTm311arOKnqiGxubAb+GtyJP+C3U7Qw3kwmt2HhCvLWfcqsefhf/LbYIDgICsotkze8AcZUSh0rFPwC3I6a8McRHVFOmnBj1KNuRvaowRToMwGe1x8BGlCBeo1IY8 X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 893c55d4-bdd2-4f42-f0c8-08dafa66c583 X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2158.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Jan 2023 21:47:33.5900 (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: wqRGKAbkXPjuVwzfxgt4RwMQGTWgLtS4FmTSQ4MUwy3oKVfiLRrKfcTkVC5BYnEsoo893TDweA0Sz5p+TwlJ+Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA0PR10MB6843 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.930,Hydra:6.0.562,FMLib:17.11.122.1 definitions=2023-01-19_14,2023-01-19_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 phishscore=0 spamscore=0 mlxlogscore=999 bulkscore=0 malwarescore=0 adultscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2301190183 X-Proofpoint-ORIG-GUID: 9sjR7tANSwGmr93Bx4H69C8W5-ZQwbp0 X-Proofpoint-GUID: 9sjR7tANSwGmr93Bx4H69C8W5-ZQwbp0 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 List-Id: 'make pdf' in libsframe shows some warnings, some of which (especially the Overfull warnings) are causing undesirable effects on the rendered output. Few examples of the warnings: Underfull \hbox (badness 10000) in paragraph at lines 406--407 @texttt pauth_ Underfull \hbox (badness 10000) in paragraph at lines 407--410 @textrm Specify which key is used for signing the return ... Overfull \hbox (2.0987pt too wide) in paragraph at lines 412--413 @texttt fdetype[]| ... Overfull \hbox (28.87212pt too wide) in paragraph at lines 446--447 @textrm SFRAME[]FDE[]TYPE[]PCMASK| ... This patch adjusts column widths of the affected cells to fix a subset of these warnings. For the rest of the warnings, use explicit newline command to fix them. libsframe/ * doc/sframe-spec.texi: Fix various underfull and overfull warnings. --- libsframe/doc/sframe-spec.texi | 26 +++++++++++++++++--------- 1 file changed, 17 insertions(+), 9 deletions(-) diff --git a/libsframe/doc/sframe-spec.texi b/libsframe/doc/sframe-spec.texi index 7b647c1a98f..175c622f85d 100644 --- a/libsframe/doc/sframe-spec.texi +++ b/libsframe/doc/sframe-spec.texi @@ -243,7 +243,7 @@ must be the end of the auxilliary SFrame header, if the latter is present. Tieing it all together: -@multitable {Offset} {@code{int8_t sfh_cfa_fixed_fp_offset}} {The ABI/arch identifier. See above} +@multitable {Offset} {@code{int8_t sfh_cfa_fixed_fp_offset}} {The number of SFrame FREs in the section.} @headitem Offset @tab Name @tab Description @item 0x00 @tab @code{sframe_preamble sfh_preamble} @@ -396,7 +396,7 @@ used for the function. 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).} +@multitable {Bit offset} {@code{pauth_key}} {Specify which key is used for signing the return addresses} @headitem Bit offset @tab Name @tab Description @item 7--6 @tab @code{unused} @@ -405,12 +405,16 @@ The info word is a bitfield split into three parts. From MSB to LSB: @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 +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}. +@tab Specify the SFrame FDE type. Two possible values: @* +SFRAME_FDE_TYPE_PCMASK (1), or @* +SFRAME_FDE_TYPE_PCINC (0). @* +@xref{The SFrame FDE types}. @item 0--3 @tab @code{fretype} @@ -437,14 +441,16 @@ useful for the cases where a small pattern of instructions in a program stub is used repeatedly for a specific functionality. Typical usecases are pltN entries and trampolines. -@multitable {Name of SFrame FDE type} {Value} {Unwinders perform a (PC >= FRE_START_ADDR)} +@multitable {SFRAME_FDE_TYPE_PCMASK} {Value} {Unwinders perform a Unwinders perform a} @headitem Name of SFrame FDE type @tab Value @tab Description @item SFRAME_FDE_TYPE_PCINC -@tab 0 @tab Unwinders perform a (PC >= FRE_START_ADDR) to look up a matching FRE. +@tab 0 @tab Unwinders perform a @* +(PC >= FRE_START_ADDR) to look up a matching FRE. @item SFRAME_FDE_TYPE_PCMASK -@tab 1 @tab Unwinders perform a (PC & FRE_START_ADDR_AS_MASK >= FRE_START_ADDR_AS_MASK) +@tab 1 @tab Unwinders perform a @* +(PC & FRE_START_ADDR_AS_MASK >= FRE_START_ADDR_AS_MASK) to look up a matching FRE. @end multitable @@ -577,8 +583,10 @@ The SFrame FRE info word is a bitfield split into four parts. From MSB to LSB: @item 5-6 @tab @code{fre_offset_size} -@tab Size of stack offsets in bytes. Valid values are SFRAME_FRE_OFFSET_1B, -SFRAME_FRE_OFFSET_2B, and SFRAME_FRE_OFFSET_4B. +@tab Size of stack offsets in bytes. Valid values are: @* +SFRAME_FRE_OFFSET_1B, @* +SFRAME_FRE_OFFSET_2B, and @* +SFRAME_FRE_OFFSET_4B. @item 1-4 @tab @code{fre_offset_count} -- 2.39.0