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 EA6DE385DC06 for ; Mon, 15 Jan 2024 12:08:50 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org EA6DE385DC06 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 EA6DE385DC06 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=1705320532; cv=pass; b=QVsGnARnKjkj131Q8rfxtGuoMD5gT4JNPPvcwXfbm7UdWXX9x0iubonXcTswpNWG6+qjoB3P0KcLv5YGDcWNqMY3GzEzQDHzRVekvz0uGuzAPGu/ekMYPfmPj25k2Osj3rJxkL3i/aC6IoE2cYrS0harHV4rSrjtFtbjYnkxP3I= ARC-Message-Signature: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1705320532; c=relaxed/simple; bh=MrkY3TU061IXpGUTJvKYeI23QM/nrsywWn/uJ2PSY9M=; h=DKIM-Signature:DKIM-Signature:From:To:Subject:Date:Message-ID: MIME-Version; b=O1xDjmcYSmbRV2YaBT+QxeFS15HQGrbKMYK9CqNEtXTaEGTq8JmXZgtvbVmSnl3QDOsTTZWFLAlDN6dLFcCCdHRMBEOj725Vl81ReCyzkScuWv8B8TlCz2fK4ff370c24ufN2bqqwZUj/Wafm27D+1TZAdeLcFFxYWcYzO5rJXs= 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 40F9Dr00005596 for ; Mon, 15 Jan 2024 12:08:50 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=8F70X9Jgusa+6bnrF6fDKc0RO+IzZnaigSOG4eOhjKQ=; b=Jq/Cq48+Sv8QwBEVuhcm4t58600r24qVh7EJfhhSaoHg1E8EgNL21fs8sOomcbptO1Gk h1nwiKiQkqlr1NxaXxsORg3e7gL7KFUbibxuHg49skVDU8c4pMcJlujdtziRH7CieePO pFYxBx19LwRbDQN2dPMRPKMmIGiXMQZjBaPhv56f3zlP2zk3vIdzTBAz5NoWWJGyeeOe f/T/gNmsce+d0sDe9K/swJt7btaG0D22zK2RmbHI0Kjvh8lnPjwnAPK+MEjjsKKBc10k VK9fLD2vSoNbzv0U/GW1u8uqtXWwbPcU5YjidOMESApPowe9t9drh1fohVZRfE7Cl/Ax VQ== Received: from iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta03.appoci.oracle.com [130.35.103.27]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3vkqcdt1v2-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 15 Jan 2024 12:08:50 +0000 Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 40FBZRTK023165 for ; Mon, 15 Jan 2024 12:08:49 GMT Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2101.outbound.protection.outlook.com [104.47.58.101]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3vkgy5x32j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 15 Jan 2024 12:08:49 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=IqS0T0ng21o1WYpC/fjSNJQXzjTJmq59R3uD1gAh32Xdd06Ud3y1CPDoHoXf3kZfW0ZlbGdSBQVnhNYLARu4h9nchcHIr2qyr/qhu/HCfkoKbIWbhPDM/DA+k3Ymq8LHnYCPEapNUUc16qfcC43nrR2R/xmpmVJNxDsvuBitl00JQ3U9Fd1SB6zcB/0ExcAheGw3yf/u0+zkz+DQqVMyPu4fq16E2Hc0FMU5kODzzu4XK6AO4LxRycgg1jjLoTTLRNEZkbh1cTexgJWWh4w8q8ZvBjTOTAwxnplVEHP2k00wmGjGra3ZMf74rJ296BweRdPaWMxNOW5UvqcN6QNzJA== 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=8F70X9Jgusa+6bnrF6fDKc0RO+IzZnaigSOG4eOhjKQ=; b=QOH86+8a6/TXigWi27bk+biaoA4O11DZz5R1mp87IwKtdXZT06ASPuMCMOOniT0GbFuSCQbivWmL/cIzd36a7BHEoEFxploc+SoUMF5jbipX55oLRSXK8ItyX41sXjQWv5Fx86l1YBF9UuwAcfpJ8I55jH/1WUrQEQ75RlDE5w33rLeP06FJLwrxMqyatdYcS7QVJvw2T45YgAwPHhNxsvfFwnAFOdYMqow/wMQdO25659+xkanbuU/XvBJty5WyavmwlmBlHT8qqUxQy3+b7LkKR9+Hyr/dEZ15Gu3wwR44AtzQ1bibC0v0GKH8isAd5pheIXPdtUucgNkk9mSzZw== 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=8F70X9Jgusa+6bnrF6fDKc0RO+IzZnaigSOG4eOhjKQ=; b=FH7ULuRmAqkkDDenKpmyPcFDpCUaZ0slrImPuGtj7wL7KTOKuP4kd3woUloMvH1x6izIbh1KCfI3c6VNX1jLkStvDDbhZFWDD4Rn/X327Kt5wLINE8eeuU9aGaUd//ecEja35eA6yrqjR6PUUjC0wdc4xGKhMFKWQBtcPUeryAo= Received: from MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) by SA3PR10MB7094.namprd10.prod.outlook.com (2603:10b6:806:31b::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7181.23; Mon, 15 Jan 2024 12:08:47 +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.7181.026; Mon, 15 Jan 2024 12:08:47 +0000 From: Indu Bhagat To: binutils@sourceware.org Cc: Indu Bhagat Subject: [COMMITTED 12/15] gas: doc: update documentation for the new listing option Date: Mon, 15 Jan 2024 04:07:26 -0800 Message-ID: <20240115120729.29771-13-indu.bhagat@oracle.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20240115120729.29771-1-indu.bhagat@oracle.com> References: <20240115120729.29771-1-indu.bhagat@oracle.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: MW4PR04CA0056.namprd04.prod.outlook.com (2603:10b6:303:6a::31) To MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2158:EE_|SA3PR10MB7094:EE_ X-MS-Office365-Filtering-Correlation-Id: 08c3ca61-572e-4128-db1b-08dc15c2ba1a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: kP6g8qRfCBqH5SVzFhZ/fsft6OuExt+jz8zevIiAbg1u3DADnDlv0202dcfGg1ibh8/T7QlHKpFahmPVtbIR1Hm5oC07BygMV6voWajUyWu8Xk0pDf0v9AJiu5AwE4f+FYJgE2N/JFfRpG8us/EZvJOCI2My1SABHbdzcTWeh/V8PNnprwLH320lmhT3UZTrr133WlvSS4ee43QNFDgUJZxZaWQr3uwqUimb5RNRNx3yEnn1JVeHhmC3n7+9j7vWxLrcZB8/AmjZ6kcuw7zyFWmhFFDZeg4cQxhxW7xTpFLD8x/Wb5nkdDi1wxFLCGwUyrBRZbi6sMmHUApuFKBtpJCBHBVP4MMz4RQt/FusnDl2stNslz5dgejIelyI9wfTNgc7aOsC1W6KTq3/lekpM+5+bfo/VbKIjkx0KMrxLZNDJYOIqgCrgOc3JSL38DRcHSTIWu7IwUDFvyWFJ7soDGXm/D9Jh66Qi3Gajns60piE/QzZ6ISckIItL3VQptU+gPefsAoBSpdHaQkAHg35jksiCVatGFAR59fRk/AgZzWdDqeW/t1l2PHqPtR82a8D 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)(376002)(366004)(39860400002)(136003)(396003)(346002)(230922051799003)(1800799012)(186009)(451199024)(64100799003)(8936002)(5660300002)(44832011)(2906002)(6512007)(38100700002)(316002)(4326008)(8676002)(86362001)(66556008)(66476007)(66946007)(6916009)(6506007)(478600001)(6486002)(6666004)(36756003)(1076003)(2616005)(83380400001)(41300700001)(107886003);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?ntTioCn3/K34k079NFLklyW38k5kao+hbQckVAwF+m5d01g/U0/iLXKJKOah?= =?us-ascii?Q?U/FFupE14n7Kqf8WAXAlJQAQiHhe6v9ZW1MNM2Q+gOj0z0fEHj3Zme8qi758?= =?us-ascii?Q?Nxy80oABAMif/X+kOUvTQfVsYDsMJNqG7CBkTjyREkxYs0r4c+JjobFh+/Rs?= =?us-ascii?Q?Yrb7tniFznom9m1NRxuDvldE3ao6Su6wTkZzYlAP6SIituTWlEN6EJy/i220?= =?us-ascii?Q?y6YPlpoDGddQnIgjk4SJkh1ASmhiX4akH90moIJb4Kz4TlA9GS5HcdUiGTpY?= =?us-ascii?Q?22A5uCrcQH+nkfaEWN06pvC6L7nehl3IQssCN5CwS+xRpB/g7TDJA6f3pN26?= =?us-ascii?Q?oXvYYejrlr3sikcU7PN455esuGPL99ERkCC5z/dSgZ1WX9H2uV6yTmKkqQ06?= =?us-ascii?Q?ju5xtFkJ5XNqZ8/vQCSRpiR8K/HniJDW2u6VH+WyOTQ/JAs7bHR6E7zgCp69?= =?us-ascii?Q?EEo+p3s/nBYPDjt+ySFVp3orMZs3YLii9rW+xCiR7pAcspBwD9PM9cLh2t/Z?= =?us-ascii?Q?5Mixxd0TfG+ob0etJpj4du3p92LBUlCqqcCMfREhh1p8TcAWg2Ni9TlF3i9h?= =?us-ascii?Q?wRVJ2iX08ISITfnjs53goK9G3+wDeKmOzMTKwVMwVUirBXERCidI4NIRm5zm?= =?us-ascii?Q?gzEqrGpwEZjvXizwmSqH+qMWaliq+kqNYyJaSreOeJVzME+3jCkdcFOCIEvW?= =?us-ascii?Q?dYBsI/2uhcntfSNZxKadw8G3GYPRIFBLLuUGGvRv3McX7y9TAf3xZg0gtrV1?= =?us-ascii?Q?wSzbxjkfnOhjVmpvBYg0ngh1zuqnNUCPxUPOlTZ73PHVPRpoZ6BunWIjyC5e?= =?us-ascii?Q?rHYLpHzAvOAeLHWlic9jlVrPafp030WK7uR41hLsaGrknDYSgzxtq9CY0pqt?= =?us-ascii?Q?MnVRgxhdzFFPAmuEZFpy0xVtbsTjxhLRPnE8gTGBD+UcjcDSx/kJbsDrBmMV?= =?us-ascii?Q?RsepiAiiQ9P7YPBatNvYqHLVt9B+4k129U/pd3bGWzsS3/4UBxfVbn5IRhIr?= =?us-ascii?Q?8bRyiXX2OXSVRZ5IKl4rpv+q1xoMPJtBOv369mslSjuq5wum4z/UDikRXG08?= =?us-ascii?Q?fo9r4RzrjdnupD75GuuRD9ObqPi5tjssr01jUy/xoGXEPJqRHlSu+U8fRj7v?= =?us-ascii?Q?iKkZCwxaZu9SlcKRqKlseIVwusY799HuKBr2M1G8krMTGUOMp7+LQ5oGpEGr?= =?us-ascii?Q?a5KT9oaVJsde4IXU5mEwU5n29gOD8F1sxIM9mC7dgd6fowUujDh4Ixvl1gWo?= =?us-ascii?Q?LhsmkfYXULneRaGjT+TOoXtkj01WWlCx7L3DCg+2no8hK1RPQz8SIndpgu3B?= =?us-ascii?Q?3mHBtu/Gve43r27xueqDzMfsSPSVXPgaD/e3qem5mpYbTJte3Y4U1Pg0qyHr?= =?us-ascii?Q?9NyX85Kr9VwQ0zvhoKV6JetMC5eUQwvCYzJz9S+AKHyOCJ+tvZYq+LDpDXT9?= =?us-ascii?Q?skWV89r/mxjtvfiVPWrhrmF7NZ2HhtONLSNt9u15LlqVLl8XZA4bCjFYmG1K?= =?us-ascii?Q?hfvweTUxXD6shi77aqqtotscvQK6xnDG5CpKYr7XWfRVJgc18mh6p9DNABXu?= =?us-ascii?Q?Z3b2D0dWBjUVO1HBCMYucarUCJTaGmCrGifXkX7/CmwdexzINMuEyLqs0tN3?= =?us-ascii?Q?e8KkM29Fh53Hrwvn5qqI4R0=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: pw+zT51TJ1oyNut1tN50MDQW54QaEmRGdgxQSkdlRTuf40iFNi1DDkbBRwrUkuoFzoRe5qYhLnWdqOrIFmGuGx2VtSq/UaB5zJV845knUwCkx2JfzMDYczJlaR+IvxaWqTFtvZ7roDoirubaTX64NkaajTfIRxIKbH89Jkf3vTYDO4wCxPWv5eZ3w6WLe0jZAxiPwso6e5Or6ZRnzsXFPFJcvaCrzEcp5FQCs8VekU+r0TXVSBs+2VW/pnnHfGdSIL1HJqbZLG2GfMuJp33+LoNS0GBzVxOkUPdusyyJgt8uCphi/bEsyCM0qnOETozSb4AYkjfZM6E0wuXfVBRyruLjL5drvTkpwZjWUBOYJB7UJG99iwuxRXZVLwIexSV72ZQSCn44Bow6TVlnJIcwBZOFd3xaWflMh6TBlpzsHyHPilge+Z2tCSWLSBxFudoOzSvLlW7h8Phyls/kBGuVCi+Itq/6QDQn0lNK8//wqhyfwdOXnM1WcWryVz6edpSGSHoBMv5mwTVHpfEFxTfDZmO2rrps2ox3r+KhzILiZkMXCRgMF/olXrEjWFNWcQ8YP8I7h2u7xJLlkBzXZadhs5BLGAlifYVd9Uu6G6bTUCY= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 08c3ca61-572e-4128-db1b-08dc15c2ba1a X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2158.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Jan 2024 12:08:47.1490 (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: hQzfmhX5l8irgQq7RTcMtvZAB7MqRMGlL3VdQx7r0j2qdsGdTfrqhXPxOHobdEK5VGkTJmNBEm5EIWTNFuSLIw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA3PR10MB7094 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-15_06,2024-01-15_03,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 bulkscore=0 suspectscore=0 phishscore=0 spamscore=0 adultscore=0 mlxlogscore=910 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2311290000 definitions=main-2401150087 X-Proofpoint-GUID: U0Qgf1GvbSHXGgp7VuYUxeVSHzw2APHj X-Proofpoint-ORIG-GUID: U0Qgf1GvbSHXGgp7VuYUxeVSHzw2APHj 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,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 List-Id: 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 -- 2.41.0