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 D519D386FC1F for ; Mon, 28 Jun 2021 17:35:46 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org D519D386FC1F Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.0.43/8.16.0.43) with SMTP id 15SHLtC2032092 for ; Mon, 28 Jun 2021 17:35:46 GMT Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by mx0b-00069f02.pphosted.com with ESMTP id 39f6pq9mkt-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 28 Jun 2021 17:35:45 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 15SHLaZk016978 for ; Mon, 28 Jun 2021 17:35:44 GMT Received: from nam10-bn7-obe.outbound.protection.outlook.com (mail-bn7nam10lp2101.outbound.protection.outlook.com [104.47.70.101]) by userp3030.oracle.com with ESMTP id 39dsbvtt8d-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 28 Jun 2021 17:35:44 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=IdAFLP/vKLFLo8D+ixjuwtC+Shrrib8OziK8fiX9mLmJHqrBvaEvw8mPC1vumNULclSC4cTDIJ3/3woQeMFTWvS6fAIHWzuczB5fZkGDSWxAvackOLkxtDWAXX6oNQ2hY7EM7CKXjHvHg/lMynDXm8fgEnnFovFwN0RBJIt5yfe4V1WdRFQKUG26MJasTkfe0XAQXOHFirdOev22L3Q+x7Bj0JtYdzY15BPAm/zaZxKXO47DbijzGTr+F9EeN62BaiabsuJBicSZSFafAq6QTzp+hg7Z5qY1Xgb+BBlr8Bs1Y6Ez0RGOTQS31qBJfDC97tSlsbukrvlYWElVpg/DNA== 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-SenderADCheck; bh=0zqf/fnXITxutX3/sQZWoiEOqGIt8zgSs37JDuxIzXk=; b=UPsQsHx177yRibB8QNuvkH92B4hS+QhIZOF9bf5vGzTM4Sdabx8VgTwinCPjxdYPSIuQLdmzKC1OqQqXLrxiVvvyG0vULW3gQn6zzjIk4uNETjkSvw1gFastEG1jK4bUKU7SfK/sXF2weJ5wz88tRGmRq9rIgT9t/2t9OwYmJHJXdf196oIEyDMYmXEDT/a3UjuwqRiQ3pWSiOqKgN4KYdrSdElqTyWTlvB9WsYZgh66GubPhP/PU33yWnZAtZY4xP4j3pSnFxe833ARtZkQfduf2xfnmkRFAS+bE8+4nye7lIQiexMPhAF6HbEfkd9W9bCdoUkXfxGeYGjNtnNywQ== 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 Received: from DM5PR10MB2041.namprd10.prod.outlook.com (2603:10b6:3:111::16) by DS7PR10MB5200.namprd10.prod.outlook.com (2603:10b6:5:3a6::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4264.18; Mon, 28 Jun 2021 17:35:42 +0000 Received: from DM5PR10MB2041.namprd10.prod.outlook.com ([fe80::3c15:20ad:f67a:eb04]) by DM5PR10MB2041.namprd10.prod.outlook.com ([fe80::3c15:20ad:f67a:eb04%12]) with mapi id 15.20.4264.026; Mon, 28 Jun 2021 17:35:42 +0000 From: "Jose E. Marchesi" To: gcc-patches@gcc.gnu.org Subject: [COMMITTED V10 5/7] CTF/BTF documentation Date: Mon, 28 Jun 2021 19:35:21 +0200 Message-Id: <20210628173523.29350-6-jose.marchesi@oracle.com> X-Mailer: git-send-email 2.25.0.2.g232378479e In-Reply-To: <20210628173523.29350-1-jose.marchesi@oracle.com> References: <20210628173523.29350-1-jose.marchesi@oracle.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [141.143.193.71] X-ClientProxiedBy: LO4P123CA0283.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:195::18) To DM5PR10MB2041.namprd10.prod.outlook.com (2603:10b6:3:111::16) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from termi.localdomain (141.143.193.71) by LO4P123CA0283.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:195::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4264.18 via Frontend Transport; Mon, 28 Jun 2021 17:35:41 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: a388d34e-f222-4776-6f4d-08d93a5b272b X-MS-TrafficTypeDiagnostic: DS7PR10MB5200: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: L7C8F3aeZ8TjeJS2YAq4cbTMsxjK6oYBfWXVj7DHIPwGwPlmkacHFBhQLZGLrMVifjSG3Gg8/hT8Rp1m2c+C2PIjDlhfbQea9yN+wQuncqqxgM6T6yzfgNGgPayxQeYRozgzVgx0QXvy3q6H7R6cnP3iVcYede3pMtnxFew3hmxwq64L235usyOQxgM+B3XLan6nBoZwQxGb8KmUDeqHJRBC9z9Wp0UF8rk0vrDEvZgqHaBpRU7E4gay9MGeXru49SOC57myMewA8PlKkl5dtnXAtsoRiUjWuxhHN3obJ9Na1ut3+pfvfZ1zz7B2LR/V/0xgfzkfVADIVDO9uWLJqo7Y2cMdrdb5t9eEqO3olPVTk96N0/VjGu9ZY1Mbv2y4d3xYkVJ058AbUNQrMi3lc6xpDPte5jMCUK7sS+kWuTauqWZjLj3IHyNy3n4noAcudYSQhruGxmbzFhJBqHdDNASKH+XKpA2TlzDrycqW5pYvBGS1tzZqYEyM5jbI2Dhs0IQxpqUzptWlxzb04QGsL63vgbnFx7l+UMrqD+IAUSVvLqC9lMOePMZsFWaw2My2RKVWrXX2iwBHj70qK8PDWN0wdy45FxtkjwNtP76j6rCCRHIi/vIkUd+MPU8lFaYYlT1NzcO5EVd0K8JFwO2qU0He1MkmeVve493zNHt17o/GNfnB0yiZb4GH8BdTLR4Zs1I5ZbEKRq6mfzcyF9o5yQ== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM5PR10MB2041.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(39860400002)(396003)(376002)(136003)(346002)(366004)(6916009)(83380400001)(2906002)(6512007)(478600001)(6486002)(16526019)(66476007)(1076003)(6666004)(316002)(6506007)(38350700002)(38100700002)(8936002)(5660300002)(2616005)(956004)(36756003)(186003)(8676002)(26005)(66556008)(66946007)(86362001)(52116002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?LxJlgCoBR6xKR6q5rV3VrUh/0kzpJ5wX0AsoQzdisBECNoqQCoYZi5Rxdp9y?= =?us-ascii?Q?5vZm2C/P2LrHUf+uMNguydNQhlu6nFEgYws0luWU5mXdyrFcZkYlrj8SwB4C?= =?us-ascii?Q?w/13kVvQwt7Y+6cLgjPwAMn2F/ZRoIWQ9oUacrhQeLHmIibvqHwNR2mwL2zm?= =?us-ascii?Q?Rqf+Qfw/5dAcjfTUPY33g9+88TKouJbUZYUPCg5Ue/vmQWGIxrQNIE9EivY+?= =?us-ascii?Q?wt+JgHuo1JGu9TNXB0aqeRb4INrZlDGa3o0HXb5j6HqR736iD6GswXb/8MqU?= =?us-ascii?Q?xN4bnmKfB/HCRn4NURTMYrQ2aS1HRtQ0TiN0uVpjC9vSXYz4MNwH6X2S0DC7?= =?us-ascii?Q?UQqKXzwW7ur/TltE3hBFzCdpbwhR7pfGAbUcou+vVR1rX0A9N1mFOTZV4J/N?= =?us-ascii?Q?n7zz8KU6eOx5H9gJqq0IaEzLqfRILJurx/1r6mXnc1JcHHCv5DUg2+j1D5q7?= =?us-ascii?Q?ElyCg4qRC7VT/PBl9XxZseS1Fj/zb86uV8aD9cwLoRT8CbalHDe5OL3/C91w?= =?us-ascii?Q?KIboM3iDpEP6YWpc5Ttsc2yvaKLl8X6XoXutn//FQLMOQABf0klBtxeScyzo?= =?us-ascii?Q?XEmYWYFjkil0w4b8YUOTkegPGJW/2Rxgnryz/aL8qOqjXT+q2mk1a2gULTCE?= =?us-ascii?Q?pmKtyMRSBoYwuBfTrixiGblOWwn+w/CWzLgs3wnqBukhUOjJ18n1ZNGYe9tI?= =?us-ascii?Q?ZurU22H45FZhiA3a66yTJAUgBeOMYnYmIJCxRCf6eIKRZqGmA5BL2nLDzp80?= =?us-ascii?Q?yBW9vg660Nr8e2VyhDJC7h6J4AVcJziu3DPO+FsgpGa5eJsCxnX7SwJVwuQb?= =?us-ascii?Q?qdw4Bx6lGtnxEWNa1WkqjcqmnEaUsqdZ2FhQ7PYWbqMw8vrk2WrYxAcn7/Ux?= =?us-ascii?Q?Q0hQn0fagZQIxtFmtI9m8PjHW+UBdJYHsb5VJGIMJPLphx+gsVVl6q/tQ3ss?= =?us-ascii?Q?iBos8BmyNRx/h8PprtmUlz/EBpKZ0vxGhZl/Y53kZ5H+YruoH13TxS6ugkiQ?= =?us-ascii?Q?ozrZfTj9iMIifDPoH3HUKE45uWEUJdmbJiHMMykD35VYI3Fs4Fh+aTQTC4ff?= =?us-ascii?Q?LFDswTh+Jq50AKPAewRkm4dhMfRfbVDNq6oUcnEYB7s50wIrA08dqRI7NkjY?= =?us-ascii?Q?oQfqAy9e5UizzCMWiRAznk3FV57/KJakkVlSRIRrZfP49HwbpSXSq6uy994A?= =?us-ascii?Q?0muVRqJAqmIZUoXN0F6oLVkQ7qzfMaA4Zq16kqweRfJ2eRoHWgCNRXCxDcvG?= =?us-ascii?Q?HQEyHptNjXknO5fpmQ+LGtdLQEszQuhi2A9GBfOqCim4peeo8bswJXSi3ryZ?= =?us-ascii?Q?krmaYVB59h+I5POGmJTRZurq?= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: a388d34e-f222-4776-6f4d-08d93a5b272b X-MS-Exchange-CrossTenant-AuthSource: DM5PR10MB2041.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Jun 2021 17:35:42.5557 (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: 3vWVP6WrvKIV7w1gEclBSoP3qhCxqySPeUfor9arNPGQdivKQgRIA91swW0HIdvkLqzU51B5AuPGMIL9UOpiQFaRd5+SctUjraH7dkYARFA= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR10MB5200 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=10029 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 spamscore=0 mlxlogscore=999 suspectscore=0 phishscore=0 bulkscore=0 adultscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104190000 definitions=main-2106280115 X-Proofpoint-GUID: HDb1Q4eiotVhY-8rtW5gQl5iLhgfpTHI X-Proofpoint-ORIG-GUID: HDb1Q4eiotVhY-8rtW5gQl5iLhgfpTHI X-Spam-Status: No, score=-11.9 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, MSGID_FROM_MTA_HEADER, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 28 Jun 2021 17:35:48 -0000 This commit documents the new command line options introduced by the CTF and BTF debug formats. 2021-06-28 Indu Bhagat * doc/invoke.texi: Document the CTF and BTF debug info options. --- gcc/doc/invoke.texi | 32 +++++++++++++++++++++++++++++++- 1 file changed, 31 insertions(+), 1 deletion(-) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index af2ce189fae..2dc6a2106d9 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -466,6 +466,7 @@ Objective-C and Objective-C++ Dialects}. @item Debugging Options @xref{Debugging Options,,Options for Debugging Your Program}. @gccoptlist{-g -g@var{level} -gdwarf -gdwarf-@var{version} @gol +-gbtf -gctf -gctf@var{level} @gol -ggdb -grecord-gcc-switches -gno-record-gcc-switches @gol -gstabs -gstabs+ -gstrict-dwarf -gno-strict-dwarf @gol -gas-loc-support -gno-as-loc-support @gol @@ -9647,7 +9648,9 @@ in the ``exploded graph'' and diagnostics associated with them. @cindex debugging information options To tell GCC to emit extra information for use by a debugger, in almost -all cases you need only to add @option{-g} to your other options. +all cases you need only to add @option{-g} to your other options. Some debug +formats can co-exist (like DWARF with CTF) when each of them is enabled +explicitly by adding the respective command line option to your other options. GCC allows you to use @option{-g} with @option{-O}. The shortcuts taken by optimized code may occasionally @@ -9708,6 +9711,33 @@ other DWARF-related options such as @option{-fno-dwarf2-cfi-asm}) retain a reference to DWARF Version 2 in their names, but apply to all currently-supported versions of DWARF. +@item -gbtf +@opindex gbtf +Request BTF debug information. BTF is the default debugging format for the +eBPF target. On other targets, like x86, BTF debug information can be +generated along with DWARF debug information when both of the debug formats are +enabled explicitly via their respective command line options. + +@item -gctf +@itemx -gctf@var{level} +@opindex gctf +Request CTF debug information and use level to specify how much CTF debug +information should be produced. If @option{-gctf} is specified +without a value for level, the default level of CTF debug information is 2. + +CTF debug information can be generated along with DWARF debug information when +both of the debug formats are enabled explicitly via their respective command +line options. + +Level 0 produces no CTF debug information at all. Thus, @option{-gctf0} +negates @option{-gctf}. + +Level 1 produces CTF information for tracebacks only. This includes callsite +information, but does not include type information. + +Level 2 produces type information for entities (functions, data objects etc.) +at file-scope or global-scope only. + @item -gstabs @opindex gstabs Produce debugging information in stabs format (if that is supported), -- 2.25.0.2.g232378479e