From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id yB/QCzx3e2atDQ4AWB0awg (envelope-from ) for ; Tue, 25 Jun 2024 22:04:44 -0400 Authentication-Results: simark.ca; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=EbxGt8Zl; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 2A3571E0C1; Tue, 25 Jun 2024 22:04:44 -0400 (EDT) Received: from server2.sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 154C71E092 for ; Tue, 25 Jun 2024 22:04:42 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 3D0BE3870C3E for ; Wed, 26 Jun 2024 02:04:41 +0000 (GMT) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id D40203870C1D for ; Wed, 26 Jun 2024 02:02:26 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org D40203870C1D 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 D40203870C1D 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=1719367351; cv=none; b=g++iaPk8d/rmenqZ7BUd03ry/abcTwC9TKnZZ2ib0pyAdwDHMkbXLOi82RvGA/VsGH0goKzKprdM2iT0s+EF0tsPeH2RjTkGAXGsDZ+N4IlJGo9MCoKXrWt/mngwa1xw5mOiUgC1LWvIZ8aLEz6RS2eywVPJ5uG+JWaq2XItSPo= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1719367351; c=relaxed/simple; bh=O2Lqa2OAB3Q69HhuRrGXsz4zh3U6Z937Bu6eVwyZld4=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=nwPOQWe2y0uols1g4Pr3UH6p/0QkXM6sxfYYk8VkOIqwDsBkR4QB9Cb4rKB6RKMRNMlTMexcLMVQGgDzrj9/37Ov7HQWW/smA8DiPp1f6iKdw0CIVKm5Qau0efs+8rOMPb353sSI2FmiioIApl2sMW9MBbOZplzaVmdX/BMb73Q= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1719367346; 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=/29uknCNTmGfnILQuI5r1kXCvM21qp+ES8bRhKDvFCs=; b=EbxGt8ZlhqjT3kqmWQiEBoW9CdJZCB4CryG3638RuSoYoEBTxiXIGAGtQkCb/K3SUAnOVd bSth+CR6pUWtq2iuM0u9/daLoYbO50NotUk6+AJ5FY5oLWOQ2CstP6N9pJAK0/TgdcwuRw 1hYkFSPX8RgrIzDphA5ybfBDYBCSwDw= Received: from mx-prod-mc-05.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-389-10eiHBBnMNOC-0utTxVkrQ-1; Tue, 25 Jun 2024 22:02:23 -0400 X-MC-Unique: 10eiHBBnMNOC-0utTxVkrQ-1 Received: from mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.40]) (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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 2904F1955F03; Wed, 26 Jun 2024 02:02:22 +0000 (UTC) Received: from f40-1.lan (unknown [10.22.16.241]) by mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 19E081956087; Wed, 26 Jun 2024 02:02:20 +0000 (UTC) From: Kevin Buettner To: gdb-patches@sourceware.org Cc: Pedro Alves , Kevin Buettner Subject: [PATCH v4 4/4] Linux checkpoints: Update NEWS and gdb.texinfo regarding multiple inferiors Date: Tue, 25 Jun 2024 18:55:55 -0700 Message-ID: <20240626020148.68109-5-kevinb@redhat.com> In-Reply-To: <20240626020148.68109-1-kevinb@redhat.com> References: <20240626020148.68109-1-kevinb@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.40 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="US-ASCII"; x-default=true X-Spam-Status: No, score=-9.5 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_H4, RCVD_IN_MSPIKE_WL, RCVD_IN_SBL_CSS, 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+public-inbox=simark.ca@sourceware.org --- gdb/NEWS | 2 ++ gdb/doc/gdb.texinfo | 23 ++++++++++++++++++++++- 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/gdb/NEWS b/gdb/NEWS index 47677cb773a..380a204e5a2 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -13,6 +13,8 @@ This may cause breakage when using an incompatible libc, like uclibc or newlib, or an older glibc. +* 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 86cd420832a..01d90ec0934 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -4316,18 +4316,39 @@ listed: @table @code @item Checkpoint ID +@item Status @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 +checkpoint(s) have been placed for a single inferior. The +@var{I}.@var{N} form is used when checkpoints have been created for +multiple inferiors. + +Status information consists of the letters @code{A} and @code{R}. +@code{A} indicates an active processes in the checkpoint list; this is +one which @value{GDBN} is currently debugging. @code{R} indicates a +running process; this status letter can only appear when @value{GDBN} +is running in non-stop mode. If neither @code{A} or @code{R} are present, +this indicates a checkpoint which 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 -- 2.45.2