From patchwork Tue Dec 10 01:54:07 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kevin Buettner X-Patchwork-Id: 102730 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 1F9093858428 for ; Tue, 10 Dec 2024 02:06:53 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1F9093858428 Authentication-Results: sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=E5GqVPH+ X-Original-To: gdb-patches@sourceware.org Delivered-To: gdb-patches@sourceware.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTP id 51DD03858432 for ; Tue, 10 Dec 2024 02:04:03 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 51DD03858432 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 51DD03858432 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=170.10.129.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1733796243; cv=none; b=Lm/O+QEeOsroc5jEC36tGoe4T/NfJVviyWt9SpCqKFZ38yjr3YIjnAd1oTNtpj8AKD3rDgJAB6j8Uuok6lkoEwphp6kfxYAPnkZ0R+8BCS3tgde/loUHhxMJ09S7qrIlcKArSQJKl6SL9/GUBqN/GYJ9g2FprM+PsDwJc7sersI= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1733796243; c=relaxed/simple; bh=g7XwP8bWUhFKEk5J+O6IJB6xyDprtqHQDeaCqkptOoA=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=gjEGeqMaw0SWZU72ac3cw3etcAbONwgM2FjCwVE6earEB020Cu31diRnoidUKgG8Ci5IYPVwW0r5wDj/+4OmKrVWBc3MvpNTx/BIzQkbb145j9oRvo5a9AMC3/Z/3/1J1Fv2vM358kFoN+43dRBwex88dvlq+879VYUbmav7UOM= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 51DD03858432 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1733796243; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=dLfr8AlBuRe9FSIomcHtAgRxqDQtCcmSG34HCAsGKL4=; b=E5GqVPH+AdYgn9tOvqjcd7CTSmwQl6babRRHe2csPsBEBy7/5gPQiItYqfxV6av1Wh+XMp 3Cvdu+3XM9qoSmaVIrNlNK4PnvnH2qsFUPoOdZCQmUBvgPEa8LwMo7xM9HPGH0X9lIG0Tw a8eIAnjKfLKVIEor34/IU/Wq4GE0GCo= Received: from mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-49-iQIYEUVMPJmvU_qGrY7wOg-1; Mon, 09 Dec 2024 21:04:01 -0500 X-MC-Unique: iQIYEUVMPJmvU_qGrY7wOg-1 X-Mimecast-MFC-AGG-ID: iQIYEUVMPJmvU_qGrY7wOg Received: from mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.15]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 1414A1955F29; Tue, 10 Dec 2024 02:04:01 +0000 (UTC) Received: from f41-1.lan (unknown [10.22.80.92]) by mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 6F4BD1956089; Tue, 10 Dec 2024 02:03:59 +0000 (UTC) From: Kevin Buettner To: gdb-patches@sourceware.org Cc: pedro@palves.net, Kevin Buettner Subject: [PATCH v5 4/4] Linux checkpoints: Update NEWS and gdb.texinfo regarding multiple inferiors Date: Mon, 9 Dec 2024 18:54:07 -0700 Message-ID: <20241210020313.584564-5-kevinb@redhat.com> In-Reply-To: <20241210020313.584564-1-kevinb@redhat.com> References: <20241210020313.584564-1-kevinb@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.15 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: 4glQrYC4A4LbKvg4ax04w_d29KmoLEUi5Skog9KqPME_1733796241 X-Mimecast-Originator: redhat.com content-type: text/plain; charset="US-ASCII"; x-default=true X-Spam-Status: No, score=-11.1 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, 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 X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces~patchwork=sourceware.org@sourceware.org --- gdb/NEWS | 2 ++ gdb/doc/gdb.texinfo | 20 +++++++++++++++++++- 2 files changed, 21 insertions(+), 1 deletion(-) Reviewed-By: Eli Zaretskii diff --git a/gdb/NEWS b/gdb/NEWS index 361d7726ba0..0c2d3637ce7 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -174,6 +174,8 @@ vFile:stat vFile:fstat but takes a filename rather than an open file descriptor. +* Linux checkpoint code has been updated to work with multiple inferiors. + *** Changes in GDB 15 * The MPX commands "show/set mpx bound" have been deprecated, as Intel diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 85ac3d9aab6..05a6acd95b2 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -4322,18 +4322,36 @@ listed: @table @code @item Checkpoint ID +@item Active state indicator @item Process ID @item Code Address @item Source line, or label @end table +Checkpoint IDs will be displayed as either a non-negative integer or +in the form @var{I}.@var{N}, where @var{I} is the inferior number, a +positive integer, as shown by the command @code{info inferiors}, and +@var{N}, a non-negative integer, is the checkpoint number for that +inferior. The single non-negative integer form is used when +there is only one inferior. The @var{I}.@var{N} form is used when +there are multiple inferiors. + +The active state indicator is a single letter, either @code{y} or +@code{n}, indicating yes or no. Only one checkpoint per inferior may +be active at once. The active checkpoint in the current inferior is +also shown by a @code{*} at the start of the line. Checkpoints whose +active state is @code{n} can be switched to using the @code{restart} +command or deleted using the @code{delete checkpoint} command. + @kindex restart @var{checkpoint-id} @item restart @var{checkpoint-id} Restore the program state that was saved as checkpoint number @var{checkpoint-id}. All program variables, registers, stack frames etc.@: will be returned to the values that they had when the checkpoint was saved. In essence, gdb will ``wind back the clock'' to the point -in time when the checkpoint was saved. +in time when the checkpoint was saved. The checkpoint number +@var{checkpoint-id} is specified in the same form as that output by the +@code{info checkpoints} command. Note that breakpoints, @value{GDBN} variables, command history etc. are not affected by restoring a checkpoint. In general, a checkpoint