From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by sourceware.org (Postfix) with ESMTPS id 3621F385C6DA for ; Mon, 30 Oct 2023 16:52:29 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 3621F385C6DA 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 3621F385C6DA Authentication-Results: server2.sourceware.org; arc=pass smtp.remote-ip=205.220.165.32 ARC-Seal: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1698684751; cv=pass; b=CMociPP8EyCxiciISC5EY8l2EGJ4jAEdGl2QDmeiM11JlhTiw/T/4Ww9yncyDMWYBJsvZz5MsgJehFsSzXiNHhfbbaVmEGcsy1JL+26qPA0oEx6G+lN2tfvL822wTe2Spg/1OGuVzq+c+yTc6j1QrW3x557McLXck5r1agKbsVY= ARC-Message-Signature: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1698684751; c=relaxed/simple; bh=WHyEYsmF23t3UY2IYpBAqn2XCW9Xb12FixPw7Fv4Kes=; h=DKIM-Signature:DKIM-Signature:From:To:Subject:Date:Message-ID: MIME-Version; b=ajBghRbgNK2sZPzkCy60iWJb2fhMiCJcteLDezyI9aa0NzhOG4Dc48k1oYc76kSH3lCfGAud5Ve90+UxiBKzG5GbGpcNVWla4F0dzB3vzAAkepBO/XsCV0Brob29mqeWMaIhgE9b1shovzc52SrjBf7G9sbP+2ttUz0kngOzHWc= ARC-Authentication-Results: i=2; server2.sourceware.org Received: from pps.filterd (m0333521.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39UDh09B012062 for ; Mon, 30 Oct 2023 16:52:28 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-03-30; bh=iyPs7cGx+3yC2qlXbpOIPaubESDAQoZuk0aATXrEGjg=; b=FTDVGa8SYHb4ht2aODU8vXMOu8/LS0+/o0ewDL14FoclALo+YtPFUiBZ0lrRv+9Va/YX GPv24skQaP+DMmSdCsd/9hmDptHit8J5+7q/r23yzgUc9WKXzcoejSt2Y2EEibqCy+3w OfGqhjMHgEN3K3zqCV5ytSCPz/voFR1RN6sfmcjK25YO9nuVnRD52Q08v3sv98QTMt72 6GmmTaoYSlOSWRxXuEnJ15Y2SVM08qXOGZCPm85xnY8Ay46aBjZissLz6WMJ87ENhUWr w35bZ08YbvQMdrqJypyWJU3ds6wT7v6/37I97eYkBteglYkqObhKhDU9sSIZX+8qQPlu IQ== Received: from phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta02.appoci.oracle.com [147.154.114.232]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3u0s7bu8wk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 30 Oct 2023 16:52:28 +0000 Received: from pps.filterd (phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39UFYW8D020060 for ; Mon, 30 Oct 2023 16:52:27 GMT Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2169.outbound.protection.outlook.com [104.47.55.169]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3u0rr4k8c6-2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 30 Oct 2023 16:52:27 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=kAdWIUvbLa3E72mF7Zvo1qJGddg91nVzN1jlTS+dplCai7bHcbwc/7u6RKzIEjCVYejG31FGxNcFdcyCKDnGKY4jaOhg7AXf+a3bF0e9tnu3z23MjT8quFACiy5n5yRjdQ5MBmD3Q+hOKthlHRaGgh6KQuLu68NTcat6yltEkXTB9+9fVXqOP7gZb9+YE9lc/AvbAyln9aNZB1K3afwSxgicrvq8t+HRKi6Y8+HyRjUP8aAp7YibkjVJ5MYGMFM6POPE8dBf2/zeSZ+73yoge2uK6LuhkjhIDvstNNmVE0BItYESasvyvoO3x8BssNcqm9PreR7F5XQAAyilAyVSqw== 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=iyPs7cGx+3yC2qlXbpOIPaubESDAQoZuk0aATXrEGjg=; b=IeJzu2zOuprYFjgKuUfaC5WgYhDhl56iNqd2gz9ZCKnqRz7kiETotOA2sGUYPrSAl1V5h9IzbZO3fgAM4D6GYZqu4PPCjF9YUmVbqBQo13LSZUQ2X//rJYPsePVLWtwjASXWKZ/V/pz9T/BBpSepEPI1V0apECTIi3hEwc8iah+er3pLL7X/7TmxjkVTWc93h379RSfnipOkXlazR5ByyHpG2Brfq0BuxpSqLXHuW4ySC2JSXJTlhLjGkNud9OrezPZlVDw1kn4CQx20sBG4skYAMMT5Of1rkvogt9m2a+H9IK8nGqEPBxtqb0t+8Ui742n1uaZFCOyxRQhP1uyflA== 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=iyPs7cGx+3yC2qlXbpOIPaubESDAQoZuk0aATXrEGjg=; b=svh5QU7Gyy7vcAHLzFWOvo22iuWtH2FuppygM10rU0c0f0excf3RA7s7YFnOROkHt3wRDFHG6gE2txL/9xAbw8+R33yNhMgcvZ2xAZSyCaU5zMhBTKjmLnxSzIbSeqJH5jvekOjSDxUndKCvPtEGU3jcmjEY0hZ/DHE8cN9CTmI= Received: from MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) by DM4PR10MB6253.namprd10.prod.outlook.com (2603:10b6:8:b7::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6907.33; Mon, 30 Oct 2023 16:52:24 +0000 Received: from MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::7f02:c28d:9802:20fd]) by MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::7f02:c28d:9802:20fd%3]) with mapi id 15.20.6933.019; Mon, 30 Oct 2023 16:52:24 +0000 From: Indu Bhagat To: binutils@sourceware.org Cc: Indu Bhagat Subject: [PATCH, V2 08/10] gas: doc: update documentation for the new listing option Date: Mon, 30 Oct 2023 09:51:35 -0700 Message-ID: <20231030165137.2570939-9-indu.bhagat@oracle.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20231030165137.2570939-1-indu.bhagat@oracle.com> References: <20231030165137.2570939-1-indu.bhagat@oracle.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: MW4PR03CA0175.namprd03.prod.outlook.com (2603:10b6:303:8d::30) To MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2158:EE_|DM4PR10MB6253:EE_ X-MS-Office365-Filtering-Correlation-Id: 973f27eb-f9f5-413c-8709-08dbd9689784 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: pC5iOc4RbKJnLk8a/90tftadIZtqoyHJVPvAoMxZSndehS6IgJw7r5L2V/01iwm9VUkEG+JLkuZzRpAyDPywqv9E4x17RIuvibVvJP2Il2k9BscA/P5dC3Ge8x75Dn+SkJjXA7bc1JUVdED8pYItlQoKw44TrTCkKTMTLAwA29Qrha2Tu8hxl9rPenIxQA7d9uZ66oqW77SjPVgfwVsCylFaYDBGzXB/i++cFH/tRWjS+M5xnU491VNkutRhFDSuSVjR7Lduo20uUMwwSY9nt4Z1cP2SKXhGgvndN2cb/fqhuw6LQNkNFpGQeKFf47BaqtaTRA9rtkZeovNWbZiPWBPwqEZ3iTZaCeBQYkXiIEWSJVV7pnpqchaTqvQ+Q/CKfAQBOAbW+zGACJEKzWD5U9nTWmGrH82UTSWUUCUty9XjHNsFW/HcJ3zn+NzE2kklPMNrG7fETD7pB3LxJX2fetTNx101vRE+qVm3xZ/uetutXM1Ct7ahkZDiq5ww6CMYlgyEj6Ra2O6qBq4Te5zV6Tg5L5f43Bb/2cKJY50dU0uf6QM3UxMv0HKe7Ak9HYiO 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)(346002)(376002)(39860400002)(396003)(366004)(136003)(230922051799003)(1800799009)(186009)(64100799003)(451199024)(6666004)(36756003)(2616005)(6512007)(6506007)(66556008)(316002)(6486002)(66476007)(478600001)(66946007)(107886003)(1076003)(83380400001)(38100700002)(86362001)(8936002)(41300700001)(2906002)(4326008)(8676002)(6916009)(44832011)(5660300002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?CR6QBbCHhVruTzHbMKp6BW/2dS5LOJfo8RF9cG8nV1LXMipwQMDwsqCHCovP?= =?us-ascii?Q?Uqi8b3673E+6ZxcROLJ4bJED67L33dg7xEFnvnSlmKsv7r/dm30kJY0uiKNn?= =?us-ascii?Q?8yp2GlBz2/OvWjCcvDZWf5pT2xh50wWclqrqDpKfL5TFkX6kyOG3LD5IkICh?= =?us-ascii?Q?1CCAGTxDOogxLCNr5NOAWRNeFzF8FZBp/tfRdsxzuXpC/AmypvphqWIVY8Qo?= =?us-ascii?Q?4/PRvqtdqSr75NvHXPl6U8G/uaSY6z0azZTB3eFnGJLYdGKdM8OXfp6/eiqc?= =?us-ascii?Q?FX6GWTKfz4i4Ny89nxg7p4oqJJhlC2F1ivxBzvFF3vs7sgoY8vyZmeAIaS9f?= =?us-ascii?Q?oB8PXjSnrU8lZ/OP/lCMiG0h7MMTgawupJSpVQr/yofgbP6DoUFXTrXSdU9w?= =?us-ascii?Q?+EsW/uc9yuVITTDQ06vgI7X+Gh+6KGag9mggbFDIZTbS2AYysM3DEbQ6eVUU?= =?us-ascii?Q?jzL9AHNdEyYanrcHPNMXliVz9ERGdJ3XMy+N0XE6NwrYSh//TxNZ0G4pgmAp?= =?us-ascii?Q?9zrShc+2uoNc7C311FM4HKZFPIU4sovHkWl/fhsd9IiRW6dI4/GYdvtY6uL8?= =?us-ascii?Q?jCABrKuIL18yn0Yid+V9KvhNe9NmxTH9EhljF05e/YUkq3iwWILWeIINocFM?= =?us-ascii?Q?to/q6OlG8GwVOhbAF154wVJCR2ZFzm0Aet3doO3P42F0UFkxUeSl+A0S484l?= =?us-ascii?Q?XLQnI++9LH+XYjXljqFRWaw8hSN2q0nG98XdqPQlCKB5EWwkQWtqBrAtPKFc?= =?us-ascii?Q?sMUxcNtwB0kFvwehj/2Wc1bYVUw3MEHwOVAw92b+kEKTeRdJy5sS58k7bFUH?= =?us-ascii?Q?jmzwkGKyDvljj+oVkmz2UJDkqzOuqcHLjvVxDdF46yBvued+CXLuZNf2EiF6?= =?us-ascii?Q?qjWOnnIdMkHC5k9MTKlh2xF4X4Py5dI7k666eIYH4dJ0YXzdD95O2TMN2Hsx?= =?us-ascii?Q?I1H7OH10qdFu+lB3/vsGejt9hEvACBUwmhGEeXgN1zqek3BEoiJLoagvtgWW?= =?us-ascii?Q?qzYWWuaC538KCghpCCQ2wphgi8UM0FYrb99usMAMX3w/PUv1EtoG4UOdmb29?= =?us-ascii?Q?UZ7lWLl6xIz60q0A/cHgbxid9LCFyK6xXU0Qfi9fdyZzbw5ySplDVnNpNrmZ?= =?us-ascii?Q?OzjWzEu+uzaKoqeUONnys5M2zNC5OVwAwk7sgYuMW3aLamH47LsoNyaRk/7e?= =?us-ascii?Q?gTGCS5IU93Is+LwluDuSsbkil62NeGpjdTXN1cnFI+zelqx/BiKwSo7y33Ow?= =?us-ascii?Q?GVWy/zrjx5/xIrv94cvaiv1xnCYlvgrIxtFMdqE1nP8HedemGXobQ2OUzJ4P?= =?us-ascii?Q?NA44AfJKHCN7hheuwixrYnEje4YNC0TWHqhMxGbhhWb1oxLJ/jxxwH3qpyL/?= =?us-ascii?Q?rCGULSYkBUAanG/y43ejsjnLnV2AZzQtU6QtwDc0q+jxlRJcxhFUIylRLMlB?= =?us-ascii?Q?Alt+sMWznY9g5PmDznFyo/ut+pOkAQvhWkF5WC+Yeo+nw/mBGodzsNIRwPee?= =?us-ascii?Q?zgNXLWhUUnbVzoZmJZBViyizyBEmZMz/Z7l3xABiDT9zu26l6LfseH6HiGFn?= =?us-ascii?Q?YNDbv3/ML0T1uA3qr0sJr77E/Bd33zTSjRJjc7DWvmUvwBPIxpRkkNX0+UeG?= =?us-ascii?Q?U6fXijY9Fx5erMGuXM2LO30=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: y8NclUcHUH91+uQwl8Q4e8eS4312xqw076FOaU1l07ysS9GRoVHDG+0lMGms+IlhwgGjePHxkuapqcS0MC4jnQDXGZD/1tsbY2L1hOpu0wS7+O1QQeB3w5yqLck/I+0q8Lsw5k9HJW+lYOWLUvR0OUHmpGgLxweLMXXh1/pVRD4H46ZbHB4+8fekTVdg7LIAiUu4yfBh3IGaEQLvsC+8R4JWgv30B7J2C5ihF5cIMzsmHi1P4FnLj2e8mSixSDhGoYM370002846gfICQulti6uH/Rc7fc9L85mjLz5OG5SxPln8zrqPP4EgBvrix6zCICLAFWIKHFL/V1ITZCj5kUeSOLvzJ/9n+eQgqAsr0w3ZGVOHKxlbhHvmJgRTcyu0zMjfW5GZViyNxxnRv9xrBjfhx2VFjJeIFqwMHpmD8pw0J8tiUjKHpnn+bvg4gRl/fPZP61BewHXgiRThMx+X/nkXIU9rfxiGXIZ4CttftjVb6qhTf4C27sRcG+gBiS0ySPVM6F4AEMg5ixS+N4rYgowHgFbAA9TH4e4XHImH69uB+/s25ekSaXi29AHtupGHCj6C8BjF/qG89hsWgMl1li2keOXmT2O7ih7uk3vQpssN5CYtyJhtf5vZuYvpjktC88zXeX9aUvMiRloah/s7DvkCb4SpkLQbx03zBL23iYrtAbahoq/TtApLOcEYHpDl5pA7qg0H+ZkokSNcJIWUvXcRuh3a+eL1aJCRBgIxFcwCm+SfUp5tYGKEd0t/OPTSss8HeOvGcLgxMa/dAYdtlA== X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 973f27eb-f9f5-413c-8709-08dbd9689784 X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2158.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Oct 2023 16:52:24.7149 (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: pZ9osxtbtTLQjIRvsQdea0mntySCVsEQxPx/jcT1GG3KvJbj9oTOJQ5LvydmgKT9UCgLg0kWODL477CCbX3zOA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR10MB6253 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-30_10,2023-10-27_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 suspectscore=0 mlxscore=0 spamscore=0 phishscore=0 adultscore=0 mlxlogscore=830 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310300131 X-Proofpoint-GUID: JPx-RXy4FaHEpCpiVwMINcTEqajoJpNI X-Proofpoint-ORIG-GUID: JPx-RXy4FaHEpCpiVwMINcTEqajoJpNI X-Spam-Status: No, score=-13.2 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_H5,RCVD_IN_MSPIKE_WL,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: [New patch in the current patch set] 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 cfc1078c36b..6e0fa618712 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 @@ -2415,7 +2418,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 @@ -2442,7 +2445,7 @@ assembler.) @end menu @node a -@section Enable Listings: @option{-a[cdghlns]} +@section Enable Listings: @option{-a[cdghilns]} @kindex -a @kindex -ac @@ -2450,6 +2453,7 @@ assembler.) @kindex -ag @kindex -ah @kindex -al +@kindex -ali @kindex -an @kindex -as @cindex listings, enabling @@ -2459,7 +2463,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 -- 2.41.0