From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by sourceware.org (Postfix) with ESMTPS id 26FD43858C52 for ; Thu, 19 Jan 2023 09:00:27 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 26FD43858C52 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=intel.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=intel.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1674118827; x=1705654827; h=from:to:subject:date:message-id:references:in-reply-to: mime-version:content-transfer-encoding; bh=pgmRLEd2ELyAfVAuvaxunzHfrekHZePyswjbk+ujroo=; b=KMNGhaiwEnJpDkcp3MGsqkPt6ikvbd2vIcIf+O+N82lTIy62mSoivz2p ayt34IuQqlBEOSHO7agBSjEoo2Ea9sN9EaiViq46JcCivTm+JvqkYnW0B Abwl03I2Tbq8X0i1xZ020fuchpuAopHDhKfva+FmnMR+7HqQtHnobKtVR DG4eRaSVmXsRW4INnpDg5GwlogBYDge9qj8xhd9fR3T7dfh0YnUNR0NoB 9qjV5TvXSkV/jn7KDOL52DyvGvd9D+MFI7Kmz9TN4Wp+PFcgMpTfCIK0C Cz4D3ve/d+2BqhHdw2hSk2oix8YjTsO3ktakeE9pxtuVccUgF3a9toj2N g==; X-IronPort-AV: E=McAfee;i="6500,9779,10594"; a="323919532" X-IronPort-AV: E=Sophos;i="5.97,228,1669104000"; d="scan'208";a="323919532" Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 19 Jan 2023 01:00:15 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10594"; a="748835793" X-IronPort-AV: E=Sophos;i="5.97,228,1669104000"; d="scan'208";a="748835793" Received: from orsmsx602.amr.corp.intel.com ([10.22.229.15]) by FMSMGA003.fm.intel.com with ESMTP; 19 Jan 2023 01:00:14 -0800 Received: from orsmsx610.amr.corp.intel.com (10.22.229.23) by ORSMSX602.amr.corp.intel.com (10.22.229.15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16; Thu, 19 Jan 2023 01:00:14 -0800 Received: from orsmsx610.amr.corp.intel.com (10.22.229.23) by ORSMSX610.amr.corp.intel.com (10.22.229.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16; Thu, 19 Jan 2023 01:00:13 -0800 Received: from ORSEDG601.ED.cps.intel.com (10.7.248.6) by orsmsx610.amr.corp.intel.com (10.22.229.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16 via Frontend Transport; Thu, 19 Jan 2023 01:00:13 -0800 Received: from NAM12-BN8-obe.outbound.protection.outlook.com (104.47.55.170) by edgegateway.intel.com (134.134.137.102) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.16; Thu, 19 Jan 2023 01:00:13 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=DS/A4Oz8ujwPHnMDzYpx/YJKLul16kKOn8dWapIXTNDIk7Hg8D5e1TuRzvZnGfumq9PpSCG2RMY0TsN2ggx2NynDK9yC7jGWszUlSPnziKIVLLqgcV7TqNh3evZlJDUESwa/64q1WZSCQD+D4H+wdg/mwo+AX0Qj9c6zXfUhLYSJteO9wzeNwtORwaXWJVOn5dqlrOMB/5MzYrpcmuQ0DYRxMmuRoPZvPELzvy37k7TjUHt/HvgFmwq65samBRDd4WkG0CpBoFBY2xUkJp81x6K+S90PtkfOOTgKKgl1HBtrztosbXFgPu1jqsaDGghhzFYRVGR0pqLp22oTwf1S0Q== 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=aTq7WhPZZFsSndF3Os2Sj3NgXMlHK0ll0JHzxPSStks=; b=ZLWrvkScP0L9uQDI4mYimZdlTo9WmrGy0QJBMjrJpSY2kipRsdkOxNdrlncChAW44fHX8zE2s0tvHhlE0d0dFnYLU226ZpqmENoIrC9PYp6ClNQU1sysw5zRdRr/IFxWqSLogSBXBlYmTSOeBpkNkhZy5Hif7ZLQXya1yTSJpZL06sUC/O+BjIccQlSDjoYOJ+Arb0agvb3zifu/MCfGhTsoWTKC6yFObEUW3CzCisf0P6ed8ywq5e/DhhVAwAIPDL1FRIBm1Uss4PVIMAeDfo8H1I4wm0yNxI+mbnGXghCMudBwRdT5iED8GLzQtXsuqk2TuAgXujcfRoetUfLfPg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Received: from DM4PR11MB7303.namprd11.prod.outlook.com (2603:10b6:8:108::21) by SN7PR11MB6994.namprd11.prod.outlook.com (2603:10b6:806:2ad::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6002.24; Thu, 19 Jan 2023 09:00:11 +0000 Received: from DM4PR11MB7303.namprd11.prod.outlook.com ([fe80::d2a1:8dd2:854f:d5df]) by DM4PR11MB7303.namprd11.prod.outlook.com ([fe80::d2a1:8dd2:854f:d5df%8]) with mapi id 15.20.5986.023; Thu, 19 Jan 2023 09:00:11 +0000 From: "Aktemur, Tankut Baris" To: Andrew Burgess , "gdb-patches@sourceware.org" Subject: RE: [PATCHv2 01/13] gdb/doc: extended documentation for inferior function calls Thread-Topic: [PATCHv2 01/13] gdb/doc: extended documentation for inferior function calls Thread-Index: AQHZK1iLUwjYLoYQqUuSFQsVTzJ2C66lcR3Q Date: Thu, 19 Jan 2023 09:00:11 +0000 Message-ID: References: In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DM4PR11MB7303:EE_|SN7PR11MB6994:EE_ x-ms-office365-filtering-correlation-id: cc7f5a1b-7a1c-4939-525a-08daf9fb929a x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: v3BOrUteLB7f4MuSM/bj2btByyj1hoL7uQAUroQ+W6gOMnBHG4uuknGwsk+1vyZewOv2c7Mp2rDjhjSCVm5IsjB5wTiFfeWdOIwzy2XrAeXfqs46aSKHXUZG3/yBDZmMTAbnYWWUxDx61bJ/oqULlNIqDkhX/JZ5vkUoZdZ1frCAG2HxHF571K4h5ZyTzS8XiwbfrC2DF7+UyL3ncHuwIwFXNmDCa5ZNQXMQcQkgdGoCFXkWvJp92dZ2xBILKpNmf/5FmJvSBlQlLM9FzXIStekievcWioqp6QwKY5Sc+AXAzHL+RCOpEO/ZcnXWnYPTYmCkLufTwmL8M6iQvhXXA9UlLy+AK95lz4tXOckVae1ev2mfv74nblCTJuVcUJkjMCLXzC3KwNAzQN/sOmV8FqxGrYVfz9UPt4PM9kUgNwsxt/7+IYG0VunT4dszQU65v6KJ5Au4hC7xrgsLlhkRnZTRagKvoM/RO0HutBXlCIQRKOcw48DSY8Gm/QkEVcItSdx7S9GffV/UX/Qr+IDghX0jFCqmWgHyi3G2o99wPlVnDgiZ/GdY5J4qX+GZG3vSc/0QrP1+mxbw/flgF80PocEb4zgxCL/8DITiY9G7xUf6F0KotH0ptwNNEpV2PIX+76D8k8h2fcSbW26eS9y7v6vJHzL69sDnQ4qBrsRRSbLueTtB4ukahxMLBNLStp12TzPEQAVLmH+exKJHo+fkhA== x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM4PR11MB7303.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(376002)(136003)(346002)(366004)(39860400002)(396003)(451199015)(82960400001)(76116006)(64756008)(316002)(122000001)(38100700002)(33656002)(66476007)(8936002)(2906002)(5660300002)(55016003)(66946007)(52536014)(66556008)(66446008)(41300700001)(8676002)(26005)(186003)(9686003)(83380400001)(53546011)(7696005)(71200400001)(110136005)(478600001)(86362001)(6506007)(38070700005);DIR:OUT;SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?Ly1E+jqfqfUgejhCmUoa/AWMS1Mt2pmDSeESiH5CVF/tl22F5z5qXJzckUND?= =?us-ascii?Q?2rgxGOB4b93NH39hvGShnWbwYG2nV9Iz/hd48P2+LB+n6xWSMPsxbn/C8GbV?= =?us-ascii?Q?QDg6LaDLMRwLlSSLVpPQFPTQ7j036zzRs9rociOJY+uTHcikgFiT/5dOuVcI?= =?us-ascii?Q?/UfkV6U84g47s7Lb2sch7UDHMQ4My2fITm3N2CVSpjNbmbv9H91FvhPKckUN?= =?us-ascii?Q?4PrH4Ku6Otbp3IkjLIFTtZACL3x8LnokITcYpktGiBLuPww2K00iuHryLzjV?= =?us-ascii?Q?akbzW2KwMbUs+Imm3zrWvSLiVQwA682oT5vy31Te2xR1InEHHqP5+vgwxOpA?= =?us-ascii?Q?mnj2ncb/m97koSFKZpUilo8HDfm+4siFmhSgZM5B9acd8aBXqsKOFJcZvdPM?= =?us-ascii?Q?PbSHj3XKWLmosaIATIWbnEGwHBspKGo6bp20omwvzG4Y6bmODUEbfCqsIvIC?= =?us-ascii?Q?l5swsT8dVgDlFLHtGnHsqmElSVRp/pKzUrUmwZ4X+Fr3uGjFsPhmmD5eS6Xj?= =?us-ascii?Q?WoKzH48TWJrG4FuU35iMKSX5XeIvFTeEJls+8boKzLA/6qdXyl06Buw6ai8L?= =?us-ascii?Q?f237bNQ0bj6leewA3YWyn5lGHw+gBc9PMxZ5zGOF8IQz2wKdPtuIJti0UXW1?= =?us-ascii?Q?fdl4AhtiO/cQUFW5T8wFHwenJdHHBkfUsYISYjplhIYPm4n+ipOSnrS4Ozmd?= =?us-ascii?Q?Z4EGjOr/9bgSpv1/7wzy0eDVPBMaZ5wDFjvSI40CUDwnPo2DwNXWowGyDDjp?= =?us-ascii?Q?KdZVqeAaPZB3u5ualm9v5LiE5PD5+virusATmmwzTAeIxo1TESKLA/e5TCf8?= =?us-ascii?Q?+z9Fbyp6nLeCcZh0jZq8PlR2d8pOK4+Qub7CNkOdzEtlfSsgwpLH2YUpWlm4?= =?us-ascii?Q?Oipi8DHFlBh3xY5ft3WJ1pOmJZQEItWM3QHvPfb7+8cAQ0m5i5CUcNu5aRK5?= =?us-ascii?Q?6vg2EOlC2RArn2pPRzLLr8RWQg09XfhavFiXNVDIsCKPeUxQv2wDzfTABvdO?= =?us-ascii?Q?rAvmFi4qLYhzqsWt07Cby7Cbau2E2UlLe5KiFxJVARFrkSqeWGVN5ZXDvfC/?= =?us-ascii?Q?sYKTc22YCSdNIHQ2hNyGqn62zggBoRwIzSRE6qmQTHEvPutPu/ePzn0IBb1J?= =?us-ascii?Q?IQh8W11NUPM7GdIEv16WT30YaEh5HLkhbFI4Rv0Of5SQuzpd1wK8qZiin3DN?= =?us-ascii?Q?TS5ANxPC0b2EWcPpI2KM0c0HeO/cl3vueLJs6KKl2gapVXnbHn0rA4kUqDH2?= =?us-ascii?Q?SuDZEbHzZRqyuV8cuyufUKgBhY1UQSFAzpLcMcAbO8kK8eQjsrE3Q/9VxGzM?= =?us-ascii?Q?Mj2Q2M0/XQdVctj7FHX/+Hmv9tmqQA6kH4l3ZjM4z5PIw+Wk66nAjsbAc4cF?= =?us-ascii?Q?vqMItKDIruZn5U9Fbtu9MdClu4p62yzQuCGZYSQtvmx9JROBiAkJL8QJysER?= =?us-ascii?Q?88omeAcZ4cT79XU8A5kjyLdq8c02TD1gx5Uc1Nb1tikzEBYsd0aGpE4+mPrP?= =?us-ascii?Q?zkAfUosexDJGtlFMtZce/BleoFhLfshmfg0uIVTnR3s1F4jgYqNg4NKTeCVP?= =?us-ascii?Q?6Kwnh3Zhwbl7HqtxNcUFgK5PeoQkU6a+qrF/71rY1bA76UXN+2Sae65QNuzK?= =?us-ascii?Q?Ag=3D=3D?= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DM4PR11MB7303.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: cc7f5a1b-7a1c-4939-525a-08daf9fb929a X-MS-Exchange-CrossTenant-originalarrivaltime: 19 Jan 2023 09:00:11.7572 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: pQMVmum8n1PQQxaGcGVRKaO05JJvv3BL5yz20cguw6umAjmjKpEZNi/dAYF5r4g4KqazDYBFRMoUtlgSbMsmICUJwLRnUycX1PVpA09Zctc= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN7PR11MB6994 X-OriginatorOrg: intel.com Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-11.8 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,GIT_PATCH_0,SPF_HELO_NONE,SPF_NONE,TXREP 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: On Wednesday, January 18, 2023 5:18 PM, Andrew Burgess wrote: > I noticed that the documentation for inferior function calls doesn't > say much about what happens if/when an inferior function call is > interrupted, i.e. it doesn't describe what the dummy frame looks like > on the stack, or how GDB behaves when the inferior is continued and > reaches the dummy frame. > = > This commit aims to add some of this missing information. > --- > gdb/doc/gdb.texinfo | 30 ++++++++++++++++++++++++++++++ > 1 file changed, 30 insertions(+) > = > diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo > index 9c0018ea5c1..e05813ff502 100644 > --- a/gdb/doc/gdb.texinfo > +++ b/gdb/doc/gdb.texinfo > @@ -20731,6 +20731,36 @@ > = > @end table > = > +When calling a function within a program, it is possible that the > +program could enter a state from which the called function may never > +return. If this happens then it is possible to interrupt the function > +call by typing the interrupt character (often @kbd{Ctrl-c}). It may help, as a reminder to the reader, to additionally state that = the called function may hit a breakpoint. That's another interesting (and arguably common) reason for why an infcall could stop. Thanks -Baris Intel Deutschland GmbH Registered Address: Am Campeon 10, 85579 Neubiberg, Germany Tel: +49 89 99 8853-0, www.intel.de Managing Directors: Christin Eisenschmid, Sharon Heck, Tiffany Doon Silva = Chairperson of the Supervisory Board: Nicole Lau Registered Office: Munich Commercial Register: Amtsgericht Muenchen HRB 186928