From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from aserp2120.oracle.com (aserp2120.oracle.com [141.146.126.78]) by sourceware.org (Postfix) with ESMTPS id 581453959C32 for ; Tue, 9 Mar 2021 10:04:25 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 581453959C32 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 1299scPI021254 for ; Tue, 9 Mar 2021 10:04:24 GMT Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by aserp2120.oracle.com with ESMTP id 3741pmeqt0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 09 Mar 2021 10:04:24 +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 1299pOvO185154 for ; Tue, 9 Mar 2021 10:04:24 GMT Received: from nam12-dm6-obe.outbound.protection.outlook.com (mail-dm6nam12lp2176.outbound.protection.outlook.com [104.47.59.176]) by userp3030.oracle.com with ESMTP id 374knwkxyc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 09 Mar 2021 10:04:23 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Lx0r9k7HxkmjN4cDWh4Fr3wVpEhQom5/Iwj0CUdSMj8XTtYOnzhqORS5N6uKkfNUA9AhyvStKUrjNQu/tW5V7EmQEeOqW8iX6rAN8zKS6tmOGmC64OiDpRpkUokqpGMCViAlcQPluS7nJwbjrs4NaSDdLeDUHS/2lNClnDhbQNMqKgZozitTs+2pzBQpLT6AtB4bk/jnp3GXjfKlDqOdf5JjG/p2cDe5nPmjDhVIy4fm51ZOQzzzPVqLnS6N8qNJ4z6W6fprWqGdaVd3lGy4itLjmpjN81l9+UildLL/n/dDPlz+nNW6U+2YHNLkHIhEWQlYEANH7H8Mg6DwiPXsew== 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=KhxGuGfeYaaU2V1YNkABbyVbH/T2WPHWGLODhwXoFDOUJ2rsZNKSaD1kEWulDfTjsFarvA4XsbTMz1P8Ush8qamkuDQYPm0OI8DVlmL8hC7/S9dIkPNed9JI376YeLqB5C8X4d6cvEP5fnhl1LEEsJEMIFP2W9LxbAaNI4Y1KzA0yp7qSmtmBk4A+ymqjiKaIS07kick6CsEuB2VeBl38oOh63GO8leyoUew52qvj6fSsc0i45UOnIuAqsBa9PdCuIMMBgpJzjJd9dWCKA1BwzWFm+q7StKPLOgA0x0zrugApMpsSHm1UhoxG3yOT0fViNpk8eHhjdf3qb98apYBfg== 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 DM5PR10MB1675.namprd10.prod.outlook.com (2603:10b6:4:e::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3890.28; Tue, 9 Mar 2021 10:04:22 +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.3912.027; Tue, 9 Mar 2021 10:04:22 +0000 From: "Jose E. Marchesi" To: gcc-patches@gcc.gnu.org Subject: [PATCH V4 4/5] CTF/BTF documentation Date: Tue, 9 Mar 2021 11:04:01 +0100 Message-Id: <20210309100402.16632-5-jose.marchesi@oracle.com> X-Mailer: git-send-email 2.25.0.2.g232378479e In-Reply-To: <20210309100402.16632-1-jose.marchesi@oracle.com> References: <20210309100402.16632-1-jose.marchesi@oracle.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [141.143.193.72] X-ClientProxiedBy: LO2P265CA0242.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:8a::14) 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.72) by LO2P265CA0242.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:8a::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3912.17 via Frontend Transport; Tue, 9 Mar 2021 10:04:21 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 14e3b900-d8c9-473a-cfd6-08d8e2e2b615 X-MS-TrafficTypeDiagnostic: DM5PR10MB1675: 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: A+kSYwOjDsxvCTLaIhKzlBt5MWhl7Wt5pySoo6WwYSGWxgUG0VlBAotMI5QLhNzcWSM456PGO3P1qy2Rc7xP6tHuKayG7853JxnSI/pxzNBQCtlQvy8M83/e/mkJKuDUdHTaDgYOuXZ8iRnZ7aTB6KQCu0U4ull9FMs8P4bs3FAiz4EUcGddP9g5n6gYPGEhtT5ohZfy/E9/vFyD4XmZ5L3ESNRndN/TfP/ol21UIbLFwDBuyOBrSJyCG1uLBjqlckiGPBvH9ld774w77cVN9DAvLbKLmdvymfxlE3ral2ycp9aAClKRINu7BdKGhOGC3CqWmjGspL4VR3de22S9SP++SiXsoKQGRp5LgtgL6QY3wPjT6w6jRamMHOMgEfPz2fgrxVtbIceIzu5WjCWcFz9dFocUjLQDc9ZBRmnkoNjraCAQhfoxcrnWoCckrGc3U5cZMKR8YGwoCTUsyMNh02xAL/6knUXtTuy4fOlWc0ckkRRLXq/3m4MiuiucwvwXQstT+EJoZpLaJHeJUpPArg== 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:(376002)(136003)(396003)(366004)(346002)(39860400002)(26005)(5660300002)(316002)(6666004)(86362001)(1076003)(8676002)(478600001)(83380400001)(16526019)(186003)(956004)(2616005)(2906002)(8936002)(6486002)(6916009)(6506007)(36756003)(66946007)(66556008)(66476007)(6512007)(52116002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: =?us-ascii?Q?fNqbXy4gayZY3h2hhUYgpMrVCj1hfoE5PM6SoIpxaG8dF8/e48/4HbhBu2NQ?= =?us-ascii?Q?tOkjQGZYof1CgxV6zFPqF1iFk6uaAqaJ99RULw9GVGuJtTWnazbq1e3Gfcks?= =?us-ascii?Q?z8m32EcQp1atwcvTsgiAESCDux+QPEgaKW3tYLH87kxV1v3YNv+mP4QONFH2?= =?us-ascii?Q?DhXIXWUcmUhlB5f3O7UTdQGbNYZ6MUUa/e/gGysBayhaTc2/J/k1xOCSfylX?= =?us-ascii?Q?4xfVX9htQDjBsJUOpi84CuQ3Mh8FgvOeCm5SPVNK8IjeWUnksJRtO2iSzSbN?= =?us-ascii?Q?iQV0AsEItC7cbgMgff/kC0ggka9F0OAbrQe4IuuIg8Nc3jH5OiUa0gLKUU7N?= =?us-ascii?Q?9b3I7xMMBvJDGwxjqBDZnFBmffz8G8ljEzmD9lqSA9OHoUUMAXYkNjjc3CPS?= =?us-ascii?Q?StomfBCJmbymnZlxo6sbJ4DIzWvdyU7E8KdwXXKtDQWg6CCY6bZrr9Afr3FG?= =?us-ascii?Q?e0FuRrTfLmgtLW+QGAeWsRT/7LzsMIw0yUKbmkoMHv0GzPqtDMW+kHIRs0ja?= =?us-ascii?Q?k9HJikmf7i80GRA2brUuFIRob2GkNx0InpSpp0X1zGpXz+IlxyylSQEZ5mYY?= =?us-ascii?Q?KPKGkYD2YllcTYedO9DguyxUlBpJr3ok52jHiZjmaMpDcbMoiDZH8MaFVK5W?= =?us-ascii?Q?Fq8EgUi8+aftkFG01tOqBmDa/KhHmaVz2HS2JkaIm5T137QQ42ndHThb4H6N?= =?us-ascii?Q?Yhf4L150i7tV1+0d+AQbwAgTwFlZkM8aedsBtJpdc2FrNiJFoECHaXvu3bbW?= =?us-ascii?Q?9asQ8jz4obcP1erO72zyOo2qqogs2beP2FYtfQ73EFDDuq4dPz8O59UeotVQ?= =?us-ascii?Q?hd/AgfmIHMufXnGTSlH+CHGalPGaVaNxO4Vw6x7/8SZ5HPtc87+0zpxUf+M0?= =?us-ascii?Q?LjcdKXllWqP6nTpBAHkwstkv+mY1D+Zci46SJzczrMThgS85ASs+BUGFTNmT?= =?us-ascii?Q?JrNcVtGRqB3/mgpcdGdRIhWDHiKSLkh42so+BLD+IVyz7pixha69UK8z4Qxg?= =?us-ascii?Q?/F4fd5CrGoG+OVkxPyZRu/piqx2vOQNt+DQWXIHvOU7+pxvouRHr/WxQWy21?= =?us-ascii?Q?mreitSiesRZ4s0iaWc6hiJhWsEYNWlrwEI/SRhSrSJzfqyAnyfDeSnGOEqcw?= =?us-ascii?Q?m5JDMtcG2ggoL1NO23IPHrUv5GOMp53tRuKagtFxmfWIuUdUvY6fadvNWKSW?= =?us-ascii?Q?Fhcn0nwT0Kab/IBAfRN5WTD0zQU9Jrz4EiiH3K6dx1FST0WLdl7BR6gRAeOC?= =?us-ascii?Q?mknH/BGS/uvqUdO8KuuxJcF3fLV4hOL781w7jf3VjvKKP+QFTQmh9HEVAurz?= =?us-ascii?Q?pnnoUFSuoBJRCZqSWfwkU1FQ?= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 14e3b900-d8c9-473a-cfd6-08d8e2e2b615 X-MS-Exchange-CrossTenant-AuthSource: DM5PR10MB2041.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Mar 2021 10:04:22.0463 (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: IhhrfegaVkGJUjXvyliEC/+YOKkffDDwaENq+RL7FdIn/ukLA6gE2dI/oDR1UDnSlfeM+ZLAnCChyavYptGYk5fmPF1OGrXiWgHfjga3AVA= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR10MB1675 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9917 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 suspectscore=0 adultscore=0 phishscore=0 malwarescore=0 mlxscore=0 bulkscore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2103090048 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9917 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 bulkscore=0 mlxlogscore=999 adultscore=0 impostorscore=0 suspectscore=0 clxscore=1015 malwarescore=0 priorityscore=1501 phishscore=0 spamscore=0 lowpriorityscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2103090048 X-Spam-Status: No, score=-11.8 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: Tue, 09 Mar 2021 10:04:26 -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