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 80C913858D28 for ; Mon, 11 Dec 2023 06:10:15 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 80C913858D28 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 80C913858D28 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=1702275017; cv=pass; b=r7tmwcIMg8YcHDJ27vzGMNmjlzAEOthyxAoD1D3vMvfK+zdvg3trFDYO/6Go6BdpNnCqEqWbA50Pr06dKeyvjugIsN9wLcDwNlnkVbyI+lVLBFikK1zXpYmpYR/4VlT9IhxD8wXgjmBhQxJlIO2EPQ0m9AAd+dmNPg8bXZISRYk= ARC-Message-Signature: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1702275017; c=relaxed/simple; bh=7lLtF7LjyrEdmVPrBfRKXV4mfpxt8ZvgrFJ1Gmq+QtU=; h=DKIM-Signature:DKIM-Signature:From:To:Subject:Date:Message-ID: MIME-Version; b=jDTkQN6t1XIzGHRR3WD6uA9Zm4JN39XogT4MQ9WbPJsNUK7vSQ1JZs3LBxixYrS/VLMl6eBLIlrC2CL18LErl7+SB2bfHOrAJNu4zph3ccuAB4tuLaF9nme7CwbbLCCxMs8nI5dxLBWgXVzwK4WdV0Di5VWa9O/BpLwY7koJRbA= ARC-Authentication-Results: i=2; server2.sourceware.org Received: from pps.filterd (m0246617.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 3BB27veZ010123 for ; Mon, 11 Dec 2023 06:10:14 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=LJgm13ruHbnlfkS3HtRD4wCIsQ6FoqT5rZwIHzZU1TY=; b=TByc5e/O6ZpX3fecsCkhTBetZ5cYynUqPs8t3JNMQ9+jVZAI8dNgNhcalEyu+FO8MOBn FnYApDFXbk5l/crEvskzXjHXc1u6lvqS/bfK7ccgPJ4KcWULXv/6q3VMdgO7j9Jwhtuc LKyZCzh0u33bop9hOteURLXmTR4JI2fQmrVuHvo2moVDdi8lLjwicuTcKwp4+7y5qDyH TFKe1vznBvn/OOg0lAQh2YJnZazPSK1XkdnLXLl+T9QdUdS586WxISVSTFWYx4TC9Tx+ cVY0yKOiZwBke9ADFKzQ1Cft16qaUZBvovqdGwi2pblxYtt/21EmEr4m625U8r8Hi7NS MA== Received: from phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta01.appoci.oracle.com [138.1.114.2]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3uvgsua4mh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 11 Dec 2023 06:10:14 +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 3BB3uPvq010690 for ; Mon, 11 Dec 2023 06:05:13 GMT Received: from nam10-mw2-obe.outbound.protection.outlook.com (mail-mw2nam10lp2101.outbound.protection.outlook.com [104.47.55.101]) by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3uvep4e7e1-3 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 11 Dec 2023 06:05:13 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Ee67LZClIfeHAw4uTutQUskVAUakDJRYR3kK6x+tc2Sn/7fw5vHJT6kRROYevRHBWFx4x+8NFdj65GJ1wn5If5pXPlb1y/orR0WtivG+IySqUlEz11TBYXYAr5klLkXq4pq/FDiKDzSzDtt57thSqptuy9nggj2xvwc44ofxBFfELvRvUWOsMxH+vXvpQrmp73mIr+hQIdEP1BIs/nFF9IQAonXWCpEK/ClJyt7HR7kr5KE4pb5S0JdiI1SLVAPfIKoYVNMl6II7tMOCncKNrNPdxKtdF2oXMUMe+btINKT9M0aJTkYLAlcT9io/Y24ZSQpwXugBuEMY5y3pm4aTjw== 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=LJgm13ruHbnlfkS3HtRD4wCIsQ6FoqT5rZwIHzZU1TY=; b=XZtIPDEadf7Bub8lptqRz5QufpbnALD+v4imdF7QH5P5GPwtcl8tooyqRD/vaHbwCoI+KCwhh1K64N2ML40VgIO0kipqev9DJ86nQQfadGFgihqVlUNeyeMtNeVDMWc/7RQX+v+XEVpd/D4e+CkrO11EGqbyp8Z2ohYv53JsmpGioaxhXy1DZmHpy6v2TTUzOHrVcu+ec32rtrXLbnC/5X+TMwrGuCSwn8e1nKRtMt1lybbu2BLJ2O0YAW+1AieMBdqu4v2ZR9OMP2MCpfSKsjR4fqK2zbWXkbgA+86ctHanc4nRo3TaoEcoIgphgo23txrW0FbR45U/wvj5n/L8wQ== 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=LJgm13ruHbnlfkS3HtRD4wCIsQ6FoqT5rZwIHzZU1TY=; b=e/HQ7jcSEeNSrSejm7t3+T96plEuBKZAcIBDaZmq4o9vtEOT4amTdoInW3gMRWr83eSt2ygaCL9z9IOUH3up9h/gNkWtauHIolY3xNJ/7HwwSgFJGjOqkNAwsHEc0wA6cnAqs7xzpzvHtyZi1hpI8zPxTwww7tCTm9i8IiAqESs= Received: from MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) by CO1PR10MB4610.namprd10.prod.outlook.com (2603:10b6:303:93::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7068.32; Mon, 11 Dec 2023 06:05:11 +0000 Received: from MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::88e2:4a2e:3111:e04]) by MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::88e2:4a2e:3111:e04%7]) with mapi id 15.20.7068.031; Mon, 11 Dec 2023 06:05:11 +0000 From: Indu Bhagat To: binutils@sourceware.org Cc: Indu Bhagat Subject: [PATCH,V3 10/13] gas: doc: update documentation for the new listing option Date: Sun, 10 Dec 2023 22:03:56 -0800 Message-ID: <20231211060359.3561062-11-indu.bhagat@oracle.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20231211060359.3561062-1-indu.bhagat@oracle.com> References: <20231211060359.3561062-1-indu.bhagat@oracle.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: MW4PR04CA0180.namprd04.prod.outlook.com (2603:10b6:303:85::35) To MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2158:EE_|CO1PR10MB4610:EE_ X-MS-Office365-Filtering-Correlation-Id: 2b7b2e93-6fd4-4505-21de-08dbfa0f22bc X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: pOG+RW/uCGmfBHQ5KbsLqay7grK0rRVziqR4ipj61o3dJVwj+Y2PeybznYndy1zRu/U10+qC3163SuRAswgjAInZ7tJY/n4pbFzmRa1PAuxEsceGG9hVqsYyw0kd1V8Zt1Ys6SPWDumbux1zPj0y9zhczrvhJytHxlp7yG4EP+cXV9Np2C6UTQWHaumiLIlz3LX8rKF5iO+xKG40mo5s7/mCvosiIpqidrs+r6JSHRJVM2t6aBCgj5+RpVYZEA/JxGKM8DJ84agi5m4Q89oFar3YIN5VGjm7zYrui3a5oFk0VIFIniVPNx00OF2HcQ7/EujzNZj6qpZNohZdnYXj9VW9F6CGU/4/CmnTD98JsqZo4BX6n8XcH03xrIVC9lXWIRv8V0zBgZJ/rfC9e0IgbXvHws0EdgGV1omj/s2BvtWDk13Zfn/s2+dw3NqLzsHMo7TIAWp3bGgohn8AZZ+3hX2aWuj8dODbUcfLjGB/qwfRROmG53YnNc2tQ/qNmW3PRnfB5zUc5FTSkY3rhuFhmMUbUG7iE5FkzGkl6KQ+SimLjsGZuFiyf0KKLjMULD/j 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)(396003)(366004)(136003)(346002)(39860400002)(376002)(230922051799003)(64100799003)(451199024)(1800799012)(186009)(41300700001)(38100700002)(2906002)(5660300002)(44832011)(316002)(4326008)(8676002)(8936002)(6916009)(66946007)(66476007)(66556008)(2616005)(86362001)(36756003)(83380400001)(6486002)(6666004)(478600001)(1076003)(107886003)(6512007)(6506007);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?4+L2/eZqQgfnVIddmGTseJTIJ1kQY0bc+deexY4LfVTl0hd+Dq9RcwEw3Vc+?= =?us-ascii?Q?jeQKnLiTFZ/LSzbTShMp4WjxrA3BwBXaL6QFgmqv/P/pmlxYViyggBS1KXLM?= =?us-ascii?Q?MuFCVnUN1Uw3K53POTgB6eVKO/sRG2dbu3+GpdW8pJyS3gy9O4hiJv5Ck3Ti?= =?us-ascii?Q?9a5ggFpA1gJMJ/tXkMsSMJBN0xq6xw7C3sb+5u2PB2o4RrUHtDis3jeilN4S?= =?us-ascii?Q?WOsUzX50is+e+PJQhQnukIKwA6R15gzt1G+74Rk7y+6Ng/fSBVFVg+WRJiPT?= =?us-ascii?Q?NkmMoOEu4IE26AQEcKHxtIonBie8Ze3UV4Dw3sY5iIiL5sABl7W9Yhf47ucV?= =?us-ascii?Q?6BRiiiPU2sh9815SjrjqhteKVgi/nG4XAIBLruTXF9EHPAnzOfxH4zMuZDVv?= =?us-ascii?Q?Q3quBJ3Xu7/uGNVKdWf4cPuwwtJIzylg1SirPNNDz7PoRJ+sTLpzUS7tgejV?= =?us-ascii?Q?3F5n776xdMkyRURk8JxxQgxIDjj9QOkB5a+GV0zY9u6H1Um0XJ/0uc7+gXjJ?= =?us-ascii?Q?VRGFeI8BFvDoUzuATRoacnYq8BTb4YdJti6KuBybtiN1P+tMzo+VyjWGTSFE?= =?us-ascii?Q?fEOFNkSWY+qZzz0ak93rBt4dHXXux4tdIieVf5beWVnuEo1gazRLnGkQP4MY?= =?us-ascii?Q?YJ4VCLSuf/0QBkrwSIoeAsQXKaELo7o+YDIp6Pi9xzBEl/qDEHnVIS9e0z62?= =?us-ascii?Q?YlvrGq/drioaGND0I8d7iRVUT+g8tTCpObHwsUHFYWdMY6ZAeMYuAXUtEHsJ?= =?us-ascii?Q?0HQnTa7uWm4WET/I8mzydjP20X2/46TRrnMbSA81woAYQzAkS88t8bUnMWNv?= =?us-ascii?Q?a94Rq8c6A12DksRuSxRZwIcX2uyNgNSZPZKWWQVZFqLAoL6msNI/1D7AlUic?= =?us-ascii?Q?hROWtjiQeXtNQnuqTDI9VvpCBQby1MGml5EcNLV624UYUYDAGEekRP4MbSr+?= =?us-ascii?Q?ISJRUSKBELMJfmMalm1apDxcP4GUOtomcK1dTAvqRsYN6E5BqCim7lQrn3R3?= =?us-ascii?Q?N2RcZZUN1QZhMrJIVMwgDrh+FZOOxi7bfqkBrDnO4UR7+Rm0YBa3IF/fx6ox?= =?us-ascii?Q?ih6qCv1rgEf0QLPFyrPG7nqYNG2ZmTreHOyE4N+Xvf8yoVbJzaqsDGb84U+M?= =?us-ascii?Q?eA6hd9CytST/y2sOL8jF51iaII7i22fdO8oLk11VQ0mAmPeApLeGmnw2j0io?= =?us-ascii?Q?UqFQqLN3uk9SQYHfUh7t6JzCIvN831Z4JJVTndlsQbCS7UGFaPGTlquwkuU5?= =?us-ascii?Q?etiM5v3LstnLq3Z6WVabWAS5v5kU2tBbHYjA+7a5aUOPVZm2ko++aC4/hPKW?= =?us-ascii?Q?01gFMG3sOCbca7VyP0Vtqb0gl1BLn9s54T3XsPq+vQ8w6klkS612jFx+bsUP?= =?us-ascii?Q?KBnKSE1zHgHTKzmCzkQrJIzrTfLjyqZPotpOb0lsuqVGlKBNV7DNskQNBg4W?= =?us-ascii?Q?5P8YEgE839uDxtfhFT/2MDe988gQonlsTLwkjMYLDMwgrADgS7lATldFXhQv?= =?us-ascii?Q?y0eypYExATLB2XR61ydRnLYwUfzXyBqyelVMu1o/0Q2Xsi1QPRjVrdHlTfWV?= =?us-ascii?Q?A4ga2EDYT3HHBl3eGC/y9f8ydS064WWufaIEac6JZaC4Ei4LFXiTug/es1nP?= =?us-ascii?Q?5ysrtBUTr7c7AYIGV2f8pww=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: dmRd/F5XQ8RpxhxXLh3S+W1iSxzAYjVUlcl4a2XT8PthPxT8zCJFB3WZbdMAxnhUUyuP6adaQu4qh2N6Ihuf1vZIqsYrkf7s7q1a2jJgD1orihnZpnfxxhwMRwHKXAPMvD88trxTCGo/RoZH1G6rDxNaedYSxpYXwayirL28UHaUicQyoCigC2Jh+0Id7NPPwBZeEVHFo6gzbpTDqB2aQXmig4mYNgCNxyrGE2YvXGywhGQtKLBBm1Jd7JxGGTqoPnnXAZFCtag5axw7rSmmeZendLqmqmQuNVENjN9TEFvvjSM1pNQDiaFotNhX649XWilNq/Kje6leR4EYYyjhicqTW2el11l9tyB23oPyAPIjlPKucAinPGkCtVcz99IOrX1LTLioMBSMBaYvG5smSJQrv1oK/TgTZLL/9TnF8lBpJOJinntTx7MymvO13lU3xbwsGo/P/FYTWFrNQOKa81p+u1jQSllGARBcK7nV3rs+oj9HmPGSxba4tNghkMFGf4AmAdTSA4bxW8oxl8sM7rS9Pe89wb2XgjdShY9shv/73RqquL1poIDYCce7IRSAn6Bx6seLkRXlkK82I1e3NnsqE2DhIi9tbeDHEyhpLpCAUp4Ij/yJ5IK7TeXJtLh8f9irJtGMu+4v7eII6xTdsUeAzNYS6xM3e7QABd9I1v6uHiRs76dL5WjIwQhUi8CTEbLXKm20po4Rz7X80fzvd1wCQIPIuFqvryRP43sD9bHTpOqt5qYqAIQPl5etT7FaPjmgPsPMFrWvRnm7NRN5CQ== X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 2b7b2e93-6fd4-4505-21de-08dbfa0f22bc X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2158.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Dec 2023 06:05:11.8092 (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: 3L4tObchvwCerM3fDrmQfJKgYhj/jk7XKWSBhlxfmxJ/zZ/3Y8ny8lTVuBriaEzBtF9ih9rpjaXxqXg2l5aJ7g== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO1PR10MB4610 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=2023-12-10_16,2023-12-07_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 malwarescore=0 mlxlogscore=909 adultscore=0 phishscore=0 suspectscore=0 mlxscore=0 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2311290000 definitions=main-2312110049 X-Proofpoint-ORIG-GUID: QPmDndoCccj7zYuM0AjhoFsKAf6SZbfU X-Proofpoint-GUID: QPmDndoCccj7zYuM0AjhoFsKAf6SZbfU 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: [No changes from 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 -- 2.41.0