From patchwork Thu Oct 26 19:16:13 2023
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Patchwork-Submitter: Sam James
X-Patchwork-Id: 158659
Return-Path:
Delivered-To: ouuuleilei@gmail.com
Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp113445vqb;
Thu, 26 Oct 2023 12:18:42 -0700 (PDT)
X-Google-Smtp-Source:
AGHT+IENo01XR6aqi7+cgKMktR4pvLTOodf4mCkUNvcnU/vlI34zkcnId+3umy1JlsgOngatkW08
X-Received: by 2002:a05:622a:1a9b:b0:417:fd7e:2154 with SMTP id
s27-20020a05622a1a9b00b00417fd7e2154mr721828qtc.9.1698347922145;
Thu, 26 Oct 2023 12:18:42 -0700 (PDT)
ARC-Seal: i=2; a=rsa-sha256; t=1698347922; cv=pass;
d=google.com; s=arc-20160816;
b=kt1LkR44h36JH/4nWV74uMxWzL61tb3bIDrnyMMa79YXksyTqRY893zgnwl2GaXL4K
+rfrqMmBzCQ+4n53gPIINJfxqM6wbn/Fxl3I9K2PQ9SUx56rTsNOsYIHIdaHwVI/GZ80
2pPy9ukWOyTf+N4SYRB6JieWV/tVUTnCn6+gOHGmp5YNbk0qGYXvJvFlZG0k1BNbifTm
U0vKlfS1u4mMDXk4+PhOkZ3lzpIFrfwHclXduwFXCAua3kr21Jbt4nUdP2yDgmi5RKvQ
Xi9Cn+pDUystFkFnQ2lrzMa9UxR2Sxerjm/R5aGjEXx9mKCMQkIpr9AbAPn+v2Lu/n3N
Qnxw==
ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com;
s=arc-20160816;
h=errors-to:list-subscribe:list-help:list-post:list-archive
:list-unsubscribe:list-id:precedence:content-transfer-encoding
:mime-version:message-id:date:subject:cc:to:from:arc-filter
:dmarc-filter:delivered-to;
bh=cYc63ahNNQmPHUIHyvLZvC/cYYkgDdA7mTGVWkHUeLc=;
fh=9ya/ss8uDv5CYrs8BUDx/HO/WjjdxfKQY+clk3UB1mY=;
b=FSdzWJXoFH8bUoIn920CifaHSxMavqQlnE2z8LLowlo7LQ4oiX16EzqJulbuWARW/m
Nip6BN8V55yTfEBWwqtrMMNsO4oFTilQrcWuN2DYpPSIlejS80eG4KJf6KNq1UgFwYmT
8ay7KsfFZOH+YQcOA2UcC0ldqQXSw55NyAJ7L0Y9EXje/V5J1fs5PzNq5DIgmsRK/bdl
kvm2f2pWUTomcD9fMyaUm+MKKjEGUXqaPvzeRuz3oFcmPnqTMaLt21ppqcqwCB0wi4NV
H43sp8+Bn/mAC1JptwxFRXmLO41sD0hFrlirRw43wu3UTVpntqrh8J0F9/FqeT36oZ39
IP4w==
ARC-Authentication-Results: i=2; mx.google.com;
arc=pass (i=1);
spf=pass (google.com: domain of
gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates
2620:52:3:1:0:246e:9693:128c as permitted sender)
smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org";
dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=gentoo.org
Received: from server2.sourceware.org (server2.sourceware.org.
[2620:52:3:1:0:246e:9693:128c])
by mx.google.com with ESMTPS id
j15-20020a05622a038f00b0041cbf9f976esi3469qtx.753.2023.10.26.12.18.42
for
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Thu, 26 Oct 2023 12:18:42 -0700 (PDT)
Received-SPF: pass (google.com: domain of
gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates
2620:52:3:1:0:246e:9693:128c as permitted sender)
client-ip=2620:52:3:1:0:246e:9693:128c;
Authentication-Results: mx.google.com;
arc=pass (i=1);
spf=pass (google.com: domain of
gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates
2620:52:3:1:0:246e:9693:128c as permitted sender)
smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org";
dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=gentoo.org
Received: from server2.sourceware.org (localhost [IPv6:::1])
by sourceware.org (Postfix) with ESMTP id 8D31B3875460
for ; Thu, 26 Oct 2023 19:17:22 +0000 (GMT)
X-Original-To: gcc-patches@gcc.gnu.org
Delivered-To: gcc-patches@gcc.gnu.org
Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183])
by sourceware.org (Postfix) with ESMTP id 3443E3831E0F
for ; Thu, 26 Oct 2023 19:16:58 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 3443E3831E0F
Authentication-Results: sourceware.org;
dmarc=pass (p=none dis=none) header.from=gentoo.org
Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gentoo.org
ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 3443E3831E0F
Authentication-Results: server2.sourceware.org;
arc=none smtp.remote-ip=140.211.166.183
ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1698347820; cv=none;
b=vagxXe0Foj0JZ9lt+H2q2AKXpFkw19h4nx6esavTTw/rCad9SXNpNLCUSm4O900Fb5rF825f2G6N+ZczPf9Syzo5OQ5OIhNx/RNxSNyBMuzm7hWn/TzqrJSZP5s9eVL0tTMFgSNwJxpZVJicWQRZ9XUhPNGqotR2Y4AfZYWYTNc=
ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key;
t=1698347820; c=relaxed/simple;
bh=HgR3x5woe5SLzAxImqlOxLsQ+GpiIiVuHR4drIT3pUw=;
h=From:To:Subject:Date:Message-ID:MIME-Version;
b=hRYeAT56FLS2Y7WnnDi2tPstAGtgR2heD1ZJo8pvr6n369X5w5x8Orsux87nnVsm79kXDErYYv86egaTC0qDSpPpB9Mi3Q8YSlMoHevsSJBZiVGkKAOdzfEc836gik0n+Idu4yZUO4+LZYwTbjF1uFsR8qi2zHQo8+BiZJy9+2c=
ARC-Authentication-Results: i=1; server2.sourceware.org
From: Sam James
To: gcc-patches@gcc.gnu.org
Cc: gerald@pfeifer.com,
jwakely@redhat.com,
Sam James
Subject: [PATCH htdocs v2] bugs: Mention -D_GLIBCXX_ASSERTIONS and
-D_GLIBCXX_DEBUG
Date: Thu, 26 Oct 2023 20:16:13 +0100
Message-ID: <20231026191628.196706-1-sam@gentoo.org>
X-Mailer: git-send-email 2.42.0
MIME-Version: 1.0
X-Spam-Status: No, score=-9.9 required=5.0 tests=BAYES_00, GIT_PATCH_0,
JMQ_SPF_NEUTRAL, KAM_DMARC_STATUS, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL,
SPF_HELO_PASS, SPF_PASS, 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: 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+ouuuleilei=gmail.com@gcc.gnu.org
X-getmail-retrieved-from-mailbox: INBOX
X-GMAIL-THRID: 1780839001372292636
X-GMAIL-MSGID: 1780846870902112906
These options both enabled more checking within the C++ standard library
and can expose errors in submitted code.
-D_GLIBCXX_DEBUG is mentioned separately because while we want people to try it,
it's not always feasible because it requires the whole program and any used
libraries to also be built with it (as it breaks ABI).
Signed-off-by: Sam James
---
v2: Improve phrasing for the types of checks and be less scornful about ABI changes.
htdocs/bugs/index.html | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/htdocs/bugs/index.html b/htdocs/bugs/index.html
index da3d4c0d..162d846a 100644
--- a/htdocs/bugs/index.html
+++ b/htdocs/bugs/index.html
@@ -56,6 +56,13 @@ makes a difference, or if compiling with -fsanitize=undefined
produces any run-time errors, then your code is probably not correct.
+We also ask that for C++ code, users test their programs with
+-D_GLIBCXX_ASSERTIONS
. If you're able to rebuild the entire
+program (including any libraries it uses, because it changes ABI), please do try
+-D_GLIBCXX_DEBUG
which enables more thorough checking in parts of
+the C++ standard library. If either of these fail, this is a strong indicator
+of an error in your code.
+
Summarized bug reporting instructions
After this summary, you'll find detailed instructions that explain