From patchwork Fri Feb 16 10:48:38 2024
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Patchwork-Submitter: Jonathan Wakely
X-Patchwork-Id: 85874
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 43A8F38582A9
for ; Fri, 16 Feb 2024 10:50:46 +0000 (GMT)
X-Original-To: gcc-patches@gcc.gnu.org
Delivered-To: gcc-patches@gcc.gnu.org
Received: from us-smtp-delivery-124.mimecast.com
(us-smtp-delivery-124.mimecast.com [170.10.133.124])
by sourceware.org (Postfix) with ESMTPS id D4BF33858285
for ; Fri, 16 Feb 2024 10:48:46 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org D4BF33858285
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 D4BF33858285
Authentication-Results: server2.sourceware.org;
arc=none smtp.remote-ip=170.10.133.124
ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1708080528; cv=none;
b=E914rmaOYMgw50WfK+np+b4RN8VuomQoxfEm9axUPOalbaKMvU/MMedLuA2jB52I4LTYuTMpEOBy7X+0ThUtFHjhe/tV2fn3T0PK8/c+EjkDKjwwKdUDtrAn1jmKiKbdXY4Ta2HO7RZRPH2VyLAYAMhfbNSS3SVVRk2Be4VUy+w=
ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key;
t=1708080528; c=relaxed/simple;
bh=qhPCTCDxYO7LPCSTWVXblAbO3lMgt8gcKM0vD9oWASw=;
h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version;
b=VTiieixhwqHZauHM1ebF8GzwFragseG6RXfevxjKgZbrhPWjx7gA9VA6hCJrKLSrOdgAXW3Ry+xEhLF26JLrYl0xbQEizML9ffTKV38MaOTEkxw2+FW9oVe6dbkvDzpPMV2M8LZuLUQGyIK3IZoo/rERIfaJqN8d2scz9S8Js98=
ARC-Authentication-Results: i=1; server2.sourceware.org
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;
s=mimecast20190719; t=1708080526;
h=from:from:reply-to:subject:subject:date:date:message-id:message-id:
to:to:cc:mime-version:mime-version:content-type:content-type:
content-transfer-encoding:content-transfer-encoding;
bh=1wHe84bwsJvg9obIq88pjA3kzF/5PSUpViF9sV8b94A=;
b=GhVS/wora+vZQKm1sdkw87zC5PP7HIiB3ojhmMm4qJBVB63Z8TeNFuC7u/3o6fT1ZczG23
7urkAdq6BqrFbXBDJbBrxnNM4PUUtuu/hJtmA7CJH3JkEB1VK44IifX+osWWX3GKeKJK/i
bUJ+3EkvFaUDm+exgeoHLg3ArC2CY9w=
Received: from mimecast-mx02.redhat.com (mx-ext.redhat.com [66.187.233.73])
by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,
cipher=TLS_AES_256_GCM_SHA384) id us-mta-512-2zE24vjEOrq4oOaDs68grg-1; Fri,
16 Feb 2024 05:48:44 -0500
X-MC-Unique: 2zE24vjEOrq4oOaDs68grg-1
Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com
[10.11.54.5])
(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 mimecast-mx02.redhat.com (Postfix) with ESMTPS id 7A3D33C000BC;
Fri, 16 Feb 2024 10:48:44 +0000 (UTC)
Received: from localhost (unknown [10.42.28.206])
by smtp.corp.redhat.com (Postfix) with ESMTP id 480D68CED;
Fri, 16 Feb 2024 10:48:44 +0000 (UTC)
From: Jonathan Wakely
To: libstdc++@gcc.gnu.org,
gcc-patches@gcc.gnu.org
Subject: [committed] libstdc++: Improve docs for debug mode backtraces
Date: Fri, 16 Feb 2024 10:48:38 +0000
Message-ID: <20240216104843.147957-1-jwakely@redhat.com>
MIME-Version: 1.0
X-Scanned-By: MIMEDefang 3.4.1 on 10.11.54.5
X-Mimecast-Spam-Score: 0
X-Mimecast-Originator: redhat.com
X-Spam-Status: No, score=-12.3 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, SPF_HELO_NONE,
SPF_NONE, TXREP,
T_SCC_BODY_TEXT_LINE 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: gcc-patches@gcc.gnu.org
X-Mailman-Version: 2.1.30
Precedence: list
List-Id: Gcc-patches mailing list
List-Unsubscribe: ,
List-Archive:
List-Post:
List-Help:
List-Subscribe: ,
Errors-To: gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org
Pushed to trunk.
-- >8 --
The configure option is no longer necessary.
libstdc++-v3/ChangeLog:
* doc/xml/manual/debug_mode.xml: Update docs for backtraces.
* doc/html/manual/debug_mode_using.html: Regenerate.
---
libstdc++-v3/doc/html/manual/debug_mode_using.html | 9 ++++-----
libstdc++-v3/doc/xml/manual/debug_mode.xml | 9 ++++-----
2 files changed, 8 insertions(+), 10 deletions(-)
diff --git a/libstdc++-v3/doc/html/manual/debug_mode_using.html b/libstdc++-v3/doc/html/manual/debug_mode_using.html
index e26d06c9179..70d6692f514 100644
--- a/libstdc++-v3/doc/html/manual/debug_mode_using.html
+++ b/libstdc++-v3/doc/html/manual/debug_mode_using.html
@@ -10,11 +10,10 @@
78 characters. The environment variable
GLIBCXX_DEBUG_MESSAGE_LENGTH can be used to request a
different length.
Note that libstdc++ is able to produce backtraces on error.
- It requires that you configure libstdc++ build with
- --enable-libstdcxx-backtrace=yes.
- Use -D_GLIBCXX_DEBUG_BACKTRACE to activate it.
- You'll then have to link with libstdc++_libbacktrace static library
- (-lstdc++_libbacktrace) to build your application.
Using a Specific Debug Container
When it is not feasible to recompile your entire application, or
+ To enable these, compile with -D_GLIBCXX_DEBUG_BACKTRACE
+ and then link with -lstdc++exp.
+ These backtraces are not supported on all platforms.
+
Using a Specific Debug Container
When it is not feasible to recompile your entire application, or
only specific containers need checking, debugging containers are
available as GNU extensions. These debugging containers are
functionally equivalent to the standard drop-in containers used in
diff --git a/libstdc++-v3/doc/xml/manual/debug_mode.xml b/libstdc++-v3/doc/xml/manual/debug_mode.xml
index ac15ef6f6d0..a12158fa03e 100644
--- a/libstdc++-v3/doc/xml/manual/debug_mode.xml
+++ b/libstdc++-v3/doc/xml/manual/debug_mode.xml
@@ -162,11 +162,10 @@ which always works correctly.
different length.
Note that libstdc++ is able to produce backtraces on error.
- It requires that you configure libstdc++ build with
- .
- Use -D_GLIBCXX_DEBUG_BACKTRACE to activate it.
- You'll then have to link against libstdc++exp static library
- () to build your application.
+ To enable these, compile with -D_GLIBCXX_DEBUG_BACKTRACE
+ and then link with .
+ These backtraces are not supported on all platforms.
+
Using a Specific Debug Container