From patchwork Wed Jan 3 07:15:23 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Indu Bhagat X-Patchwork-Id: 83206 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 E299E3857B94 for ; Wed, 3 Jan 2024 07:18:27 +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 3FAC938582AF for ; Wed, 3 Jan 2024 07:15:59 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 3FAC938582AF 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 3FAC938582AF 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=1704266160; cv=pass; b=G2LUbwyBm8PCO9wLznCvrtoexh2dQRHhAGYiXSMC074V7MYMvAM0ZMRdC33SJ9Xm+OjWHL/aNIdo6Vshwgd1+gLuZufghD2ykWIk5afZJxsoKSvNpBgbMJyAJuGYIVB3/oaN/8vZ9OUJuEPnssx0cTabjmtH9Ni/vOl7ILUlmrU= ARC-Message-Signature: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1704266160; c=relaxed/simple; bh=gdS1qPsOc8W+TwdtbriCpLK3WcC7Sv/Ifw4VTxi/wKE=; h=DKIM-Signature:DKIM-Signature:From:To:Subject:Date:Message-ID: MIME-Version; b=ueRmzvDuoj26SZEqrTEBZOmYiFq+i66RsIbivl33aB1550XT2XJ6+rq8NvSLi520nRnzDR8cs96l6T+CWzJ82VA5cRrKoMhTkisPzRZYSz2bm+Jhq77vGcm9FnTMXW2oUe8CRlu0iaZHeaUP50QDbkFklB4uWcCDn7d4kW5lcdA= ARC-Authentication-Results: i=2; server2.sourceware.org Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 4030humR019987 for ; Wed, 3 Jan 2024 07:15:58 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=XnpP2dcsbgPRJYq8NUxEbp1xXS1lloj4SAFsmfJsA18=; b=arJCPMHDILv3GWDGwhGrEbwO4uizIt94GV19ML/f3fVDeLxHtptKHiV6Lv6AGa3VfuvH x2ej00i5fXpmmoviC1GOhMKpWeoTvFRhgIQiDZWFeYXZELdBOKOaF/vvF5aP8qRix8Ch aTFv0RUX4mwFLOMW58uTngGfbDO2gpKZWWe+dbk2GhQPkZzhq326ZTjLCyO8RPzH282O ZUhxs5HEmaXMC9QwDfgO7Y4/ICETymuhkyZbNSKncA5CiPe8O4rdO4yTFS4hP9D/Oc4k 2PcLKcpCd2tktumtbJchEa9brjJHunCcLhrYZgvdHNnUhsTyQJMgq6DNDDqR7grLLU0l Aw== Received: from phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta01.appoci.oracle.com [138.1.114.2]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3vaa03veq7-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 03 Jan 2024 07:15:58 +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 4036W3sD001706 for ; Wed, 3 Jan 2024 07:15:57 GMT Received: from nam02-sn1-obe.outbound.protection.outlook.com (mail-sn1nam02lp2040.outbound.protection.outlook.com [104.47.57.40]) by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3va9n8pdyx-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 03 Jan 2024 07:15:57 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=bAzCBL2+uqb7sAB8h73HdqwrvAfWsRKwJ0vUcLKkxbo1QNvMkjNfgkCWsvwp9n0QmVTTTll6U1l7GI6pKR1NyoTRkHUQOELjukbRdZOVFwUNOVgtMET45ZiZgBz0NaUPbmfXkd2C8if01xCqaw2YDrct002Ging4Z4/XsTnXBtqQfkN8Rtwzs+l3CgfLD8A8VvxnZEtOU8zg/g0mT03pQoQVlbtB5Vav/BFwsKRrbV4qSR6eMnFG0ghL0gqPBAB38IDah+yhdkWNefSMImr/uyF6ZtmMejCxBc2dC6on3eGXwIMXBdq8fOxygPW4ysQz8e6ll6yWZIbxu+Kkk+dY0A== 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=XnpP2dcsbgPRJYq8NUxEbp1xXS1lloj4SAFsmfJsA18=; b=Q71ztxJBR5uNnX251ejIEaYsgWxJYZFgYkB0fkhTVhv5BzpDrA3KMUraWLWurahTzFM8M0C2B0JkTS07abs5tmCGG9wVuMb+qschaujzNuY3NbvoI5yIHex8wgTwp2JplxBYWmnc9OXVrfMlZj50hmyy9H8c4nrfumBZaaBMq7OZmJ0LvrSzuSO6EeCi1OJtRZ5PijAE4DuLuG5edgu0BdDhyFAI5gfyMsfhuVgfu0bmbPX/TTSoC5L2+qusRa94rq+6oXSL+iaSR7u1ZYzkslyeL0pf1nby8Liu+43kyfsY9717+c+1lCFG0CaLyGSzepu2TX32RPJg2f5C5jbNbA== 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=XnpP2dcsbgPRJYq8NUxEbp1xXS1lloj4SAFsmfJsA18=; b=h8wUCsJCrKqAD7XHpc8shPlsd98kSUHZ6ewHMIbDA5VC9g3VOjqn21VbdZdj9cz1qlvohdUzhQxbWnD39XXetrh/HwiCvXDLPnu3VV5Hzs6WQsQaqORlEdnZpYOY/Cq0Sguy3OX7LUvVYwBGcuX9pLp2Ie/wm+SoBnL3VrkYKW8= Received: from MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) by CY8PR10MB6777.namprd10.prod.outlook.com (2603:10b6:930:98::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7135.25; Wed, 3 Jan 2024 07:15:55 +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.013; Wed, 3 Jan 2024 07:15:55 +0000 From: Indu Bhagat To: binutils@sourceware.org Cc: Indu Bhagat Subject: [PATCH, V4 11/14] gas: doc: update documentation for the new listing option Date: Tue, 2 Jan 2024 23:15:23 -0800 Message-ID: <20240103071526.3846985-12-indu.bhagat@oracle.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20240103071526.3846985-1-indu.bhagat@oracle.com> References: <20240103071526.3846985-1-indu.bhagat@oracle.com> X-ClientProxiedBy: MW2PR16CA0048.namprd16.prod.outlook.com (2603:10b6:907:1::25) To MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2158:EE_|CY8PR10MB6777:EE_ X-MS-Office365-Filtering-Correlation-Id: 730e807b-63f8-49f2-9b5c-08dc0c2bd38e X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 2U6F3owuAh0xwJWbLL6jI/DvzzrL+ogTTwN9scBsEidXXbtI3ukOfNgEShsA2iU6BuVcSL2UUaPx6TjYUpxZ7n8TP58O9tIb21TFI58O0w8xNNBrb5kf1Cdj6+CPQcsIoSBIsWOGs0EMXzxlTlhTfKeqdaotKRXJjRLxqM1brBHWPK+jjfHSpZ+LsNWDPgtfRevLfqHCoN7SioCCnl+mRsQCQOpWtTW7CHHcrbYqWofecqiEQ6qZ/gOuxkX8/lBFoYEm5zy1y1/mNQRfH9hESLwbSXTWvKoOlKdt0Z3EYTpr6ZQmochEv4qOw8BvEbJSNcJZO2VY84hpL5zvEBM0CHIMfz+Q1MtGRIaRcKTuAkYS0Dkuwcy0FhfrmvbiqU/7FzznOnKRCHw1ZoUPSbcH0InA/Ddm0t7Y4MFm5vo1mf/IHWir+0uM97ToYJwHk/5l6yVBnpYWTFj8QVOllT25Y2InCr+KNTK7XFcjrJ0xfb2lyTdMSXUoP/+6pkUllg2yqijn9U0Mf9aKZynCgNdIsj/CuMxusUVv//tOvBpciGq9rhqTUkwbtHG8ggT+COPL 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)(346002)(396003)(136003)(39860400002)(376002)(230922051799003)(1800799012)(186009)(451199024)(64100799003)(38100700002)(36756003)(86362001)(107886003)(1076003)(2616005)(6506007)(6512007)(6666004)(4326008)(478600001)(6486002)(8936002)(8676002)(316002)(66476007)(83380400001)(66556008)(66946007)(6916009)(41300700001)(2906002)(44832011)(5660300002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: GTi4c1+teDWZ0sMuxHYFiMkwldtFH+hS/ddUqr1QpEhYYQGldx6781XIewKusWOX5OlheUpxnbhAcyte4IM2bvMB4EAUqwO1RBRV2GP7AOIq2vdAE+w+0FrQY15whQA8sONBwOvesl8KImrQ9GJvlWNUbDi0Ol8WFZw1itn0COX+QBu7FCaLwgzygOVSObwt2u6S1KeY7z38MGFfjG25a4Fu4kpkPcr99q7L0mWuB3Zm5f8shSzi5+OoageYsYu6kyC4ZST/Pf71KGIFZJ5OKFc7pCmfjboCVCWsp/Q3hILrpXcDkO6PAuC9tRYVnb/mBAl/tNZ/3svxS5l9TVaI92jMlAjLl3JnvGVMJsjyOoc/pD+iofrN6RqLzkxA7jgNhhwglE+uTfncTf1rhSYpqx+I9EnOovKKfykNYHqj006cirEja/EkrKEL7tV76gepxguFnRLI6ogpnTl+rfJHF9pNPI52rk7amCQKQxNXaeQahD5ngPXZhbKQxFXU/se5cnuqM+/GtHWZONSxj4/bvLsKffKLfDtZ1ssIXa5eth0bmsr/4Szi3zSoaUUwabM+7JlUaZaoJB+XR83lIKdly/c8uY/oPcf+6txPOAfnGNbUfNxe05q02LODoihNLbhGzBfNXjI3SnAYC+aPN83pYseBlLM43slASBQGP21xpDl7LVBMgWBd5ntUubndK2jaatenCctWLefUnFy7Ms2Xy5Vp+eG84XkKrsBgqK9IKJ4pKxBUo1pSkSeSUTCp/aXkUsaa8/Zk1bCa2iwY7YQDCkWeaSyjs+4UfitpBUiBmXTHaytufuQmQBBa/T5kir7P9YgHIj+dPX8T0ImvKvRWW6maVJeaYxrI9zaFb0X/3mLfEc3G3CXcu6H9+7l8O7w7ZkLFuTE/yQrM8EHmCL20iwyLMREqllifJRe0WX1g8U7AtIdB+XCvGo6nsiXN2FAWHrU+zqADFwtnLqwzQFFp1Pkyx7ZAbWhroOMd9m6X7TzKL1u4dJVhodbYs3m5fSXH4tjaHxwlCUgHdKPLU2MWLeW7IE8L4OvqpsRJufPC5ZMfCW5e2ievLArDX1TSwtdDVtadwmCaAvJSjxkcz/4fwsr5sssrVZy/WkOIV4IjNo2ZHY0sxZ5X6hi8oOYKLXw7aH9FkRS5T7KUuSJrz2LCBTEYKRc4pioiWeQpsO00gZdgVpaHpQnFvwPv+v/swBqHYOuoTA+zDmV+Pe28tyuADqa6xiQeeLdw7UPY0mnPiX73yvJF3sugZEUColrzJVk4OGFuCE3jFHe5/Q5rVcu0ndBRG6X1ZHHKe+AG1U5MMUKXyee8zuzEwFyDmw29xlh8MoBMIJpoNmyBQkYqOWW1qWg49vTefXWFe69Im2KMaujip7iEQvOu/cGYtXZhzJetf9q51rYt/tyogR0szdURi4pGaHK5m6xZFoO2hnoJqfO232rWGuzT5IW+Rl87kVv7wa6Uiucla2ylRgF9SHtYahDfpmMWI8GBKYTpaj7YgSRIVymGfVVKaUuudxEF/5zrP8pDRR4l4jrps9A6XCv4sPWDCg37X+dq3MTLt0BTixZBGFOB7bcBVRvaABxSg5oWsPmUUIH4pFVX5VUgqzlda2EL9N5+lG+uW0OIphC5xT8= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: Vg4wE6hpbu1C7hVe9PVAB5oTO+SFFfsQHnVGWJcmpFujPdLDKmO462UlPNUBmPqkwmZTblFVgImvmdLArC5nNujA9Mx6DUq7Kz03wfyNT2Mughp3yCP8/a2iyPuzGXw6RZZ5qefnHxQsAl814Eo4bjHNUlcmPEsoyk41BGPy6aY1qDfctOUN8XpWg/1aFN4mHhO4fM1w5mufq8ZMEg7ctbuiZ0ESqr0TlJ2i+/rn5s+QjuMqw4/PVns7GN34RY98eDidA340Tu2uD4I8rdLXK71tq9mjXt4DThoBA3SESQ0wHgMFmbg4KZkIs+S43vOPY1VNzQjez55elbMcuhaj9ZGKWlNBoaNuKkENg4pihAdbayeb7v9x4aj7QaMHT4n7cJOt2exMlNlfUyeEvk0xt3aDksBsiQDilFo9ak9f3/4yxS8blxcCBGfoQx98vRN77wlu4vQawT6u4JwELfI2xzP0UXzFg4pbUMj86CPhBgxuLti3SYsd+E2TFW05ae4nTLKSAFNMmbzGXaVM0df+rL3YHvZfnUTemO9VE3d7QxoyqlMzsr42/j5TeUuYorqm+HtFxkpQgDmNRIWn3CqpUv+TULHGeU/p1YVhpq7n1wM= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 730e807b-63f8-49f2-9b5c-08dc0c2bd38e X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2158.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Jan 2024 07:15:55.3113 (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: pC21gtkR91Y0cIGS7HgsaQrMQxq6SheOgFQE2pRxj3WcuwXRczn7AAR5ceuzssTyc0qJWDb9ar2MUP6kRwFWnw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY8PR10MB6777 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-03_02,2024-01-02_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 mlxscore=0 bulkscore=0 phishscore=0 suspectscore=0 spamscore=0 adultscore=0 mlxlogscore=906 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2311290000 definitions=main-2401030059 X-Proofpoint-ORIG-GUID: Q9fcozkIzZobTZYbcG1yyvGBtPTKEyR6 X-Proofpoint-GUID: Q9fcozkIzZobTZYbcG1yyvGBtPTKEyR6 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 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