From patchwork Thu Jan 11 07:48:17 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Indu Bhagat X-Patchwork-Id: 83841 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 8877F38618AF for ; Thu, 11 Jan 2024 07:52:51 +0000 (GMT) X-Original-To: binutils@sourceware.org Delivered-To: binutils@sourceware.org Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by sourceware.org (Postfix) with ESMTPS id 857FC3857C7D for ; Thu, 11 Jan 2024 07:49:39 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 857FC3857C7D Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=oracle.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=oracle.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 857FC3857C7D Authentication-Results: server2.sourceware.org; arc=pass smtp.remote-ip=205.220.177.32 ARC-Seal: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1704959381; cv=pass; b=dtsEfKHyD6AyZsQB/bhZbjpYpKGaVzvRq645ekra0/JoXA5qfIZDn8a94/0xotKiVGZDAQcWTC+sut+3OzJEbIrchFR9Q/l8JuC+bRmkG39HUiXD/fxGDd8s5YX0FpuCWtmwGz3eZPw3ULHjUsC2ArMNNl77aTEl3klvtRdojWM= ARC-Message-Signature: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1704959381; c=relaxed/simple; bh=xJz2qE5AUafUHfGfvXoXdmyFhwAm0RLBFBzcWFhNh7A=; h=DKIM-Signature:DKIM-Signature:From:To:Subject:Date:Message-ID: MIME-Version; b=FIDdl375DGE2OzaYVtLRTnZucA+Al/8708XV9aKxHsHf6yLkXwy+ZW5l/tUi5zCAwnGdYOj1yioL/4HZdyxvopoDrqjfWbZ4DL7ZlrbOt4tZEund3u6bEFgcrg4joWXREAM2BZjDBRguDpYzKD0RrG3RLQHrcIctfrARmoBEUKA= ARC-Authentication-Results: i=2; server2.sourceware.org Received: from pps.filterd (m0246630.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 40B7i8KZ007767 for ; Thu, 11 Jan 2024 07:49:38 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : content-transfer-encoding : content-type : mime-version; s=corp-2023-11-20; bh=cxtOQvieLCslueyLFfq0TM6STtRqiHz8ishGDrOHTa4=; b=KChlfivqA2JeGoeX1hLomA5sYD3XDjrz1ttPjDoqrvRBaXBXPaRLSYBozg4YppJYjZza HTurn5DD/wvppvx/CejRNB1XaUTZTZqm4SdPDbEH5clhcSJOz1C+ALtk1l30vhM7fhci KpEtV3raOZ0KQx1DSaVti3DWpgjlV9Tell7PGlSAN4ABae9RUbxMzjLJ8k1PXo0aIpB7 UV/XPM1RKH7XvaGRNJxIXASmDwApqQcvroHxMlWkOvrB7UAtR6G2y/L9KZ88Uehn1Q5C Ee5feet3xEJO9OEbKqs6WzpMCvf36lJeCDsLszo/pSwvBZ43QOwxPQ7CJLJ08bJb7uR3 Zw== Received: from phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta01.appoci.oracle.com [138.1.114.2]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3vjbc2r1vf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 11 Jan 2024 07:49:38 +0000 Received: from pps.filterd (phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 40B7Idsq030062 for ; Thu, 11 Jan 2024 07:49:37 GMT Received: from nam11-co1-obe.outbound.protection.outlook.com (mail-co1nam11lp2169.outbound.protection.outlook.com [104.47.56.169]) by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3vfutprsns-2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 11 Jan 2024 07:49:37 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=JZdH/wst5mts70Iu6Z7B+ZBBbkW0XvMxXWLuf2rHTcrAJlESR32KlFa10N8awjbNg7e4S2qQ06daNEcF+MmE562tknsYICNDnYWNSJssAgt/nBFyJjPqjohlHCDiUYY1D3hOg9ZMtfnwFs8+tWL1Yx2YEvNv1lAAc+A5avVNVpMD3NKOIk+xIhT+1XtCnsP3dXTcEANQyck30L7AfjSYMnJhOmXdNrWPTw6HclyVqngPBbf60mcLYyDSdzxzlnoSKZGQTbl7g2kUkODI4WNw1wR0VujaMbWX+zNT7W3DMgLASOW/FTEXuRzKsaPs6D+tjCrui9XrKFfbuKuGZ4WD7w== 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=cxtOQvieLCslueyLFfq0TM6STtRqiHz8ishGDrOHTa4=; b=KsPzm3nQLxcvSjmnaTUdjNrFZMx9GqwoyIsMiGeLcf/S2MvYxaWH7hAdU2jCSrlFs5MALy2davyhiBGMz+ZFsz1UxG7Qvr1jztzuOuGMXKC+5xTh1R/Ws2T5wbXs8nAljFTrKV4WeWKpNX2pAt670WmP5Pm/aH5PsITH3JnhNUIda8vauurZSCY5166ze9DQr9VTdF2PAClSjTXmmWeDUwSY2Kpfi5QWTPLHGmprrUhdItBdhOc6Z0giiThN2NvwoMJgyDFM+s5oOluSn1gE5DAHs5yCJd6V4fXehWK5MOulynJGopfTnS4wisYyV3M9doX3En2EK60wv6udRk59EQ== 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=cxtOQvieLCslueyLFfq0TM6STtRqiHz8ishGDrOHTa4=; b=YnPQITijZMUEdyxjnQKIGPgf8AAfwxX/p1wr2c9w8/4gvOICygDxw/xmyk5GREMC1sSraniEbONeAEOQ5yIHh+9Jz3i2u1jTZr7kocGNz+9R5NybMq8lz8vp0TkVMoqxyc1aCLfiZaag9k8EmJBGlNYIEAojyj6x4LRoxQR9VXI= Received: from MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) by CY5PR10MB6045.namprd10.prod.outlook.com (2603:10b6:930:3e::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7181.18; Thu, 11 Jan 2024 07:49:36 +0000 Received: from MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::fde7:fb92:8ea1:a5ac]) by MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::fde7:fb92:8ea1:a5ac%4]) with mapi id 15.20.7159.020; Thu, 11 Jan 2024 07:49:36 +0000 From: Indu Bhagat To: binutils@sourceware.org Cc: Indu Bhagat Subject: [PATCH, V5 13/16] gas: doc: update documentation for the new listing option Date: Wed, 10 Jan 2024 23:48:17 -0800 Message-ID: <20240111074820.2677826-14-indu.bhagat@oracle.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20240111074820.2677826-1-indu.bhagat@oracle.com> References: <20240111074820.2677826-1-indu.bhagat@oracle.com> X-ClientProxiedBy: MW4PR04CA0223.namprd04.prod.outlook.com (2603:10b6:303:87::18) To MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2158:EE_|CY5PR10MB6045:EE_ X-MS-Office365-Filtering-Correlation-Id: 791e5fbc-ef17-443a-65ee-08dc1279db1b X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: AZSpbZxbifTIM0SBwmbRoPdpKfHnRN6/OKphRFEMPh/WO9zdo/zI1IaBGE4Mnmy0BrWzckpFg0JpQ+8lVdNVY9VNerDabyV1wLAMGgeN8BXFCFpsk/5C6dqmxNW9R4fjajk6oqAlpPUTKDHS/3EWU86TFY3rWgssUaEJgmR82chynQ4Qiy922/joqV5Fpw19OiGUrUQ7aWXLG+PLVq7WPM/bhTpU5L9o0HEadsq7sftuw+DDCvnnAHFWreL2CC/lLsk5xxvfXJCtkms45aKxitrYVOjgusN1Q0PRSKEz7Xvp+z3F9/IVCuJ2g5u6sIAAdO9hVgU0QAq4ytDKIfETgWPhzCfdb5DmyhnsaHm4kOK+K6prLqOhkXi5wecdalam1ZTiH3BwCMnZgTkb2vqQVQ619GwHOH6P89toCdfHwQN/8AnV8zjOA1NFSuy5axB1C/0sEXIHJBlQ2/Pj8ZxrTwaK+IK4hYlPIrXSx5tGAgB3OfK8DJBcB37kYL62gfOHp8ggB1GZzkyNFX0Hf8KJ938pbLGfVkcqCuFDWp7CB/ZZ3EHSnaJNk9sQPdRJZuc8 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:(13230031)(366004)(396003)(346002)(39860400002)(376002)(136003)(230922051799003)(186009)(64100799003)(451199024)(1800799012)(478600001)(6506007)(6512007)(107886003)(1076003)(2616005)(38100700002)(86362001)(6666004)(36756003)(41300700001)(2906002)(44832011)(4326008)(83380400001)(5660300002)(66946007)(8936002)(6486002)(66556008)(8676002)(6916009)(66476007)(316002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: cVYHYS7/yicHILcNo2fIB+c+yyIxJqiOxnztvzkgmRblsmvMPNZN+fgx3mqf/pyQRn6SYJ7XMnILmPD81LQNhrAlCSiMlKj6VO3hmjsLt8zhrnPPXRgIDc8LCShBvh2XsDCWMWDnjC2jfAbcVNpI1fImyBY9Nngo+Ql89N4pvFT0gVa5JajBoqtQ8kNlJuV3sgsd6/NBeEyhyXM3+T3yR7qMv/w8by5GtP3M8c4TJCoLi6z6j/ZNV5keDpMUh/R9Fdsd47xOl22xc9vqLe9lWpLI5O6thJlj4LFgWibq5X/NNwNfO7WrFp7go7g9rkdAWqKP8UY3LuFe6Kxz3719/fyqeX0YA19DU5Ml7wPl6DvF0FlZfvFF/OdjtknU80SUPot2oN4pPfLnBB4PJoxmRFY17nk5dMxETVAmp2Jh/ll5q/H8cYtLwpOTPA9D9De3R8ZKyIxUxOTxKUIYV9NRm/3hNvuberOPEbtW5iZEJRd2mnJ69wziO+O/S2aymQwNKEGI3gAcRkCVgzzWx2eud+mr040M6ma7AqyiIxXkZABXiYV82umLCtFkxzadq2CTYN+hU7PX0BgoKp1+LSLNpply3q/sPBhbNM8YlfYz0NUXNe13DtteANXkv8S4rqZtEHembb9QyPl82XBhHmrSXQXUAyospekJJIWjU966pSL5Yoj8643NA6hdXoF6BTJrTfulpnhbJufnDU2/U5NY3ToNf/6K/XtmnKsq5fqeASWU+IikPdpZHSt9Dfs02205y8JI/g785WiE31HLLiCXLCaLxY0ui34BEnsT3PpiT+pE6U3ZH8PUMExxcroJl1xdq1L4+P8w/kfdqL468kgvtdvRi1Sr4h8d4aFIau5uqYmD9y8wQQ/Ie6xgbs28hreiOMg1ic+e0Cpg8jal5O2kzRVLqryu183DCuinC8CELVzLoZgIWJfLx5sEEjGPeom4cWevB+N+sofZbMrqt2nxXOEtN9dEFpP+Q+3e/SYf28UlchPndf7LCGNUMdQeERDn2Etv+E3TYmzdd1CVQ24G8dC+KzazAayRntaRWw4BPpMrVP6bmgr+Q49ZD6OyqUarLecDc7WGi3sC/d5TIUM9CETBvmrz/Tchfd+b55lacqNqzJ6XPzBan4vxS+Wk8o+4n5d7eG8ggvYTGBNcHFjuIDAoEQLjCOff2eDbNJWEr8ftNV1L656gaGEBeFSSRtFGOaTOacNxIki++FnwEmK1t3Wc8NeRU9DKwfyXLT6zx1KQ6a/AIn6afuh6tjH+0xH5F+VdDWPZND1mQCuMpwUX8+DrmSKPWNdFzsGWEocmeh9trLcwkOARq9tfHw790zdpdPxc+cQjMj/uONZxElXqet0MHz8Xv1AEIukSyKpMI7xhHcveLhx2sR6k5I2fnHXiQvxIRHKa8SmU8aE6Bu0WLE/dSVbqv7L8PXbQnRqTCE2Qsy3rtmSlEBdqMXVAu3G/st+wheIQ2aXbBWqJ7hDdFrPbkpNv5dNjWtn8JtHdnoiqdgaOVvbnzn10OA+vZFH5GCgKDKUA8VSNRrmZZvmUyDJc+ovUC/1cqxG5BdU1o0fbrvYMEYRBFQEXj8rtdnx+HVXVdwj4NCUOKudoMx1FcxlgcXxAlFIb1TFbCD2treE= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: QswjgoVYblZdp5UfjtT7A2NkmtF1Fkz0oQ66zDv/2yVsXfNKcvdU1oLjnpcj+0P3nnEE3Eq3pz/oIwZyjC2v7idr5YBZHmbVIq9i1Oodt2mBAvV7CffPKXgzyLCZaiZhBe/F0Vw82SHZzI6sFtwuevcMz8nih8goYIx1laNdXyjNnQHetfqaqDiRvm4ggbe7sagI4C+03D21D8XHu8R+uH6FLvPkCQqyglX9Ns37gmIad3nNSWWjTty4xQIGsXfcwkH+2xXdeID/rhD82S41G0V4TFG48HipwjmrliUXdrnWvYQsp1EnskewTcJkJ4odUkNTN5mFuYLetEO88d9yB6GtUSXTuH6nXEHwY583HR8U5QFAd/VMqdGC08qJQhYJo6rZqcJIUAZC3u+bOtfWNwYHY33bPHW3wz3rCag8xs6k30HAhMtvHg18ol1doHzngmSDIC0hffVoIdLRBxpQKdEDwSv+NdmR7lzXVhS+LQgi/gIgL1XKEhzczkZ6oRlJHDM41prRmbhVciANRgKS606Bp/3TD0xT3O/JP2y3Iw80uyGT78vx2Ojpr587kcMv3BGcdQJ8D8bbK/bbVoG4szp8HaqgGqXuA0Uf87lZTDU= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 791e5fbc-ef17-443a-65ee-08dc1279db1b X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2158.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Jan 2024 07:49:35.9841 (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: nPIgIHjNefW/og0HGNFQYlP5C4+x0dggr9Art2fnOCds8ISRNqSGVH2wXYeO4XkIzVo7iNoM0FFj8tTfmqObCQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY5PR10MB6045 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.997,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2024-01-11_03,2024-01-10_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 bulkscore=0 adultscore=0 phishscore=0 malwarescore=0 mlxlogscore=889 suspectscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2311290000 definitions=main-2401110062 X-Proofpoint-GUID: h_RjYSMs7UsdRYkHN38zQT5C6VYD9_DA X-Proofpoint-ORIG-GUID: h_RjYSMs7UsdRYkHN38zQT5C6VYD9_DA X-Spam-Status: No, score=-12.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H5, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE 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.30 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: binutils-bounces+patchwork=sourceware.org@sourceware.org [No changes since V2] Add a new listing option, -i, to emit ginsn in the listing output. We may also emit other SCFI information if necessary in the future. ginsn are most useful when seen alongside the assembly instructions. Hence, they are emitted when the user includes the assembly instructions in the listing output, i.e., "-ali=FILE". gas/doc/: * as.texi: Add documentation for the new listing option, -i. --- gas/doc/as.texi | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/gas/doc/as.texi b/gas/doc/as.texi index 370f40fcbae..50c05436141 100644 --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -226,7 +226,7 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. @c to be limited to one line for the header. @smallexample @c man begin SYNOPSIS -@value{AS} [@b{-a}[@b{cdghlns}][=@var{file}]] +@value{AS} [@b{-a}[@b{cdghilns}][=@var{file}]] [@b{--alternate}] [@b{--compress-debug-sections}] [@b{--nocompress-debug-sections}] [@b{-D}] @@ -673,7 +673,7 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. @table @gcctabopt @include at-file.texi -@item -a[cdghlmns] +@item -a[cdghilmns] Turn on listings, in any of a variety of ways: @table @gcctabopt @@ -692,6 +692,9 @@ include high-level source @item -al include assembly +@item -ali +include assembly with ginsn + @item -am include macro expansions @@ -2418,7 +2421,7 @@ assembler.) @c man end @menu -* a:: -a[cdghlns] enable listings +* a:: -a[cdghilns] enable listings * alternate:: --alternate enable alternate macro syntax * D:: -D for compatibility and debugging * f:: -f to work faster @@ -2445,7 +2448,7 @@ assembler.) @end menu @node a -@section Enable Listings: @option{-a[cdghlns]} +@section Enable Listings: @option{-a[cdghilns]} @kindex -a @kindex -ac @@ -2453,6 +2456,7 @@ assembler.) @kindex -ag @kindex -ah @kindex -al +@kindex -ali @kindex -an @kindex -as @cindex listings, enabling @@ -2462,7 +2466,9 @@ These options enable listing output from the assembler. By itself, @samp{-a} requests high-level, assembly, and symbols listing. You can use other letters to select specific options for the list: @samp{-ah} requests a high-level language listing, -@samp{-al} requests an output-program assembly listing, and +@samp{-al} requests an output-program assembly listing, +@samp{-ali} requests an output-program assembly listing along with the +associated ginsn, and @samp{-as} requests a symbol table listing. High-level listings require that a compiler debugging option like @samp{-g} be used, and that assembly listings (@samp{-al}) be requested