From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from aserp2130.oracle.com (aserp2130.oracle.com [141.146.126.79]) by sourceware.org (Postfix) with ESMTPS id 81CAC3896C0B for ; Mon, 1 Mar 2021 10:47:55 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 81CAC3896C0B Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 121AixjC165306 for ; Mon, 1 Mar 2021 10:47:54 GMT Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by aserp2130.oracle.com with ESMTP id 36ybkb3f6r-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 01 Mar 2021 10:47:53 +0000 Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 121Aitxl145860 for ; Mon, 1 Mar 2021 10:47:53 GMT Received: from nam10-bn7-obe.outbound.protection.outlook.com (mail-bn7nam10lp2105.outbound.protection.outlook.com [104.47.70.105]) by aserp3030.oracle.com with ESMTP id 36yynmjn05-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 01 Mar 2021 10:47:53 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=fOq8JBBm3GLSMlfsE5StEd3lr68T4o4t91uLDvVGjOUNlKeYMEbM46MOChMoQVhXjHExX7ntnpr5DHMSbgLy4zc4u70LK8cJio6ZjYdZqrTKD86YaDY+M4NgmDtGtqIWjewRldtGVi0zVW7VvGL3HslDHb5d1tKZTKuF3n+Ps3CSor0NM4zuJfzerfSB7slOJKFPTLf8OSvmjKe5q6mld5YIEvv2eRceQhpIZ+gO1cHCrVMEB+xLDtx+cz8ESeT+SgeEJNiTwyNpkDuwgFYYPIh2CLM05ZEJM1r/sLKqYOPokXsIRsw3bpigWiX/3s35JX9lY8Z/4e21lHWGMvl83A== 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=2RErQmUpnQcPlodnFChvUzftdxpTxWxEEL1AJ+5P1yc=; b=FLJTcaOf2c86pi+klSRphoFF4ZdH9/43xKJ7dnewuszppmStBZeD7P4t008UAgaFrKfIxjWGhii3h8fmnv23qxMwrFXb8/gUzl+6VAIwK0zhsjX3iGS9+PUahVskVb+fYCJ6rquIv3gZZy6G2Ri+IeKcvlj+SznFfsG/SEK/5Sb++1FH7fP7aTaT/gcuNogCPS3GNv60275NaV9i0bmAQqBAibRNHz7aTxAI3YrpQ39mlFZ/RSjwdfRKKlG+c40OAzjLDZfnEWCJ1uU6P+h4h+DtGhSYkzANbbRCr9mqeKBVv+fheY/q21mPTL5O1B/82HMDrxxpcYfM9smIHhVztQ== 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 DM5PR10MB1276.namprd10.prod.outlook.com (2603:10b6:4:10::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3890.22; Mon, 1 Mar 2021 10:47:51 +0000 Received: from DM5PR10MB2041.namprd10.prod.outlook.com ([fe80::35f2:ac4c:f8c0:ee4]) by DM5PR10MB2041.namprd10.prod.outlook.com ([fe80::35f2:ac4c:f8c0:ee4%7]) with mapi id 15.20.3890.028; Mon, 1 Mar 2021 10:47:51 +0000 From: "Jose E. Marchesi" To: gcc-patches@gcc.gnu.org Subject: [PATCH V3 4/5] CTF/BTF documentation Date: Mon, 1 Mar 2021 11:47:14 +0100 Message-Id: <20210301104715.20323-5-jose.marchesi@oracle.com> X-Mailer: git-send-email 2.25.0.2.g232378479e In-Reply-To: <20210301104715.20323-1-jose.marchesi@oracle.com> References: <20210301104715.20323-1-jose.marchesi@oracle.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [141.143.193.68] X-ClientProxiedBy: LO2P265CA0067.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:60::31) 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.68) by LO2P265CA0067.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:60::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3890.28 via Frontend Transport; Mon, 1 Mar 2021 10:47:51 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 6af7c517-5dbf-4558-3916-08d8dc9f765a X-MS-TrafficTypeDiagnostic: DM5PR10MB1276: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:2089; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: lOdNb6YefkdWf9WObKA7dzz1gh/M8wzJIRkn6ieAcopnoWKp6KdMOY4z0JH6XciBH+UrJ/oyw7eJyveBYsIom2hcrFagQQRzdkSMMczZ/cViI4sMp2ndPD9xjNdW3LeIeaL1SVkXun1lwmPs0OxyJ95GqpSQQtXfl6LDLwc87LvUY9W9uQLjtaOJZKrvMswHk38qkkjfJ64TrIbYtbVT2ItoX6HEA8nBGLO2lSoOQfxa27/7EQ7hrcrHsZbH94EQ+qwzdS/0yOMI/TxzYwiKPn9hnoMxaEeQ3OGDsoek171HE/uI5qBKDnhWR+tLYE5Cjos5relTQy5ErOxrwmPsPpdJSeXW/QUyi1QCKRzpuV+XDn1f0wcqXVhsryVWfBg6+E6oNHhZdd1dSkZWy56pjFclL4t49Z/mZuEqs1pbHqqmeghUPGb21wJkMm0BhHUmqycG8ZPL9SadvyQjXDHOlHNzYE+T1vn0OJXfAhpe/zt4Z0PEKaX2YaedBlE8L5pqTJDCh3ZCd8vWxprZKtQ3KQ== 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:(366004)(346002)(376002)(136003)(39860400002)(396003)(8936002)(66946007)(6666004)(66476007)(956004)(2616005)(66556008)(186003)(26005)(5660300002)(6916009)(16526019)(8676002)(6512007)(86362001)(1076003)(478600001)(83380400001)(316002)(2906002)(52116002)(36756003)(6486002)(6506007); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: =?us-ascii?Q?M8xbB3NObf33Vn3kk/S9FJIwSTHjUoJRO2frAXgRZXRRuV224i6JKnwp4FM8?= =?us-ascii?Q?DHn1Q8wrdyc/e+SVwcFx295CymWF5ZJCnY3sIQWcyfptEsJf4Z6Gx3pEk76c?= =?us-ascii?Q?A3TXKjXMpbpUW1awzbkt97OfpV/5NaHGFPlP2ti3GugnzPLfZw8emkJkD3rk?= =?us-ascii?Q?RS3thz+pN94Lag4Cgiaj5pQ9MFZqHqM3tK4A9vErPiyvU3Q3bzwLIdJKrqej?= =?us-ascii?Q?k3GupuzIaaHxmjoyxENhzZ6OPtMtZMv3CWORnqNq3NLwmsuEooa3lhYW73A/?= =?us-ascii?Q?VwhJgmLbqkCJLKUTEiXfoO40Ip01HSfgwh378MW5jdqwxJZNqbFWTaJKjMQ1?= =?us-ascii?Q?zt4KBbuTB6wCpGumtESo7U3d2IWqK7HA4rFE0SQHHbTz6nufkdd70bpUa3ss?= =?us-ascii?Q?OxQvGF70KqPaemHpGStbNkOKJqfTPZkVKiNriBVQ4c2+A/sRK+31j5Vm1svN?= =?us-ascii?Q?z7vZu5v4M7C/+ICelMMMEjrAp3SBPrXIo7rA9hAEIBtq6XojV2PKglh7ytsa?= =?us-ascii?Q?MgGSMS0Vd5ndFZWPtSVGXi+p/jJ1rE6jxci3ER8UbzmlcfZrmqJy63eqBFCz?= =?us-ascii?Q?JdYjfrKbELQMrwSz1lSBB55L29Zh0v6i+KrYog5WD6WxpHgtjczbBGJ/PCL/?= =?us-ascii?Q?/FvE+ekn6bMIXl/vcG17pyZUbEXIstSxM6dlsL6kG9On6/pJT8rDjY1bCUTF?= =?us-ascii?Q?atnJZ6nuFuLF9RgBD0sgHtpHJfkmakoUaw9lbEgJR0SSxmy92+XipFwl93fk?= =?us-ascii?Q?SvfM7i7OPHpcylGGUqd/nFefgothPk0QzxGjLh6WSi4oZCSLc9EKbCHOdq3i?= =?us-ascii?Q?iEzB/OuQNfgJN8Zm3GlaToU24P1H5iwiNmOnI8sKhXcI014YntRtz34yYuoy?= =?us-ascii?Q?C4V9FzU3/GnvkCzP06uJTeiOv5efVI5Vmu/jli6Vn4I3NVq1O7WZD6LwmYfd?= =?us-ascii?Q?K31wdUBDWhhH5wzXoEMuwBBX5JxgCzCZM0kimb2XZqLwOutNo9PCR73XVw4p?= =?us-ascii?Q?HP27qFXaB0aCwR6zNK1CqKJU4NGA+XGWCNvotUyjTiMpEDUZEUEjH2SXwQxU?= =?us-ascii?Q?N4MFnlASI1oylliimoFcyY9b3JmQoIChwGhmOLS1bK7qhkHLTobuDwPCGNpQ?= =?us-ascii?Q?ysRo2Bdj7BFqrFyq7A2cxFTMgJldAMzTUk7R/WSIlIuuvLhdtyGFj7EgdLKQ?= =?us-ascii?Q?UTEiUVbNTsmm3FFGZUC9PUCbv5V8IremJd4dVWS2Ytss97GjGYALuxFoUFKW?= =?us-ascii?Q?+3kB4Cho2t75MJSVBrjT65Gw6QI7M1fgUHidPB3YNC3vOmTeN41CmHJ9OMrh?= =?us-ascii?Q?Ueu2uUSTEKMhJ0bAo9zBI+cZ?= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6af7c517-5dbf-4558-3916-08d8dc9f765a X-MS-Exchange-CrossTenant-AuthSource: DM5PR10MB2041.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Mar 2021 10:47:51.8579 (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: ajocwxBau3UjFzmu/D+alQOWy7ZaONdYRv3WY+cky5wIUSEpJ1qT73c7ERIdQL/STFnc2AmT5Onuin3tpHiXA+5PzBCw5IjvR/SeHAQDhO0= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR10MB1276 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9909 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 mlxscore=0 spamscore=0 bulkscore=0 suspectscore=0 mlxlogscore=999 phishscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2103010090 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9909 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 impostorscore=0 suspectscore=0 phishscore=0 bulkscore=0 mlxscore=0 lowpriorityscore=0 clxscore=1015 mlxlogscore=999 adultscore=0 malwarescore=0 priorityscore=1501 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2103010090 X-Spam-Status: No, score=-12.3 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_MSPIKE_H2, SPF_HELO_PASS, 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, 01 Mar 2021 10:47:57 -0000 This commit documents the new command line options introduced by the CTF and BTF debug formats. 2021-02-18 Indu Bhagat * doc/invoke.texi: Document the CTF and BTF debug info options. --- gcc/doc/invoke.texi | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 4bd4f390ded..9bed12b4fd6 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -461,6 +461,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 @@ -9657,6 +9658,25 @@ 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. + +@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 -gctf is specified without a value for +level, the default level of CTF debug information is 2. + +Level 0 produces no CTF debug information at all. Thus, -gctf0 negates -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