From patchwork Thu Oct 26 17:12:51 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sam James X-Patchwork-Id: 158623 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp34686vqb; Thu, 26 Oct 2023 10:13:37 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEINNqMCaXl0Ck3in394lYM8U1WfsyD5JYUlEhY18wH/gs1AzvFz+XxrIBUa5pO/vu9/BCD X-Received: by 2002:a05:620a:444c:b0:76f:1272:2aa8 with SMTP id w12-20020a05620a444c00b0076f12722aa8mr24325062qkp.6.1698340417522; Thu, 26 Oct 2023 10:13:37 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1698340417; cv=pass; d=google.com; s=arc-20160816; b=n4wPjN1yD8tuh/Cu5iOOHAZhdwcyF5A4vZhLdukOgnPb0gUdrtNbUTmHf04/ieYXyj a2nU9UJDLt0F2/UA2rvGK6hClwOaD9PuMGX9fBMHXdQfHO5p1b+IzYidLqKgwFplM3iQ uNIfyMq+ZHtKtiE9HguhQrENK4WdZgJv4EiehRS/ZQL+02wqI6BkWt4SBpBxVX0gABML iEEtt20v+/ollEmSC6yLebWcySlJvGFapHh/WbiBMFTUEsTmIiSm5H1kRrDkg0as12Lb 8ntfe7tHaG9TkyRzrml2ZGZc+na7hFDEFp/qYMR+satJRrISDMx3pGayWyAQilpnx6pb MyYw== 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=lRqBXcm2nRQRd32pXknu0MAxf1Rbg1z/rvZtfB8BaHI=; fh=9ya/ss8uDv5CYrs8BUDx/HO/WjjdxfKQY+clk3UB1mY=; b=Uuyo0v+xcyAwv7G+zF8zRgZ0fQ09oR9WRq6zFBcKpun1s4UhkiJbd4cQk4arSs7umW A/rlgFGlVQbOZCBIJgMW9mcooQ0LJA1t8ci7ZB8fU2/NJfhwsGjdF+l6avjDxmyqcrhL RmBlpO1J8W+A3ULMsEmfNt0/418HKMPdfLUQAU71hawRFNxas7QvbJ+E1EPXS931lXd7 FViTVO7xF9fXYuk9WWBdYJIzqavR1IxcwU3ZbntpCdJZmlb3Tmr9Lu6/lqJ9oOB7PO/k IyFop5sgk/NkTtbWsMIrTMacdmY5DOpxymnnWnAg6Fc45lTA0N+noN8EO9fopjRsKEbF eWyw== 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 s7-20020a05620a254700b007757029f0a2si9694479qko.705.2023.10.26.10.13.37 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 26 Oct 2023 10:13:37 -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 6BF7F3853514 for ; Thu, 26 Oct 2023 17:13:35 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) by sourceware.org (Postfix) with ESMTP id 3F67B3857342 for ; Thu, 26 Oct 2023 17:13:09 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 3F67B3857342 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 3F67B3857342 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2001:470:ea4a:1:5054:ff:fec7:86e4 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1698340390; cv=none; b=nEpEaTtfND1/rZPUpMLhIXNHppjQ8GqgaEugYj1OzPYLstDWL2uQ63Pn1gcGDuxlJlrpiec/SCijSenwlHbSp/UTdTyPXYjtQ7MAnzOF6NDdAnA1JZP+ff1jHzuk0APpY/3KCDFt8C6lI8tk8+IPHdAX6Idjn79hf3jbmLCWI+Q= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1698340390; c=relaxed/simple; bh=XvAfK4bK0WJwdFot7jKcLPxMgd5JBgvazZSa2m7f4H0=; h=From:To:Subject:Date:Message-ID:MIME-Version; b=P3KmIOsj+mC0d9Qic1/vMJPfW68cXacrBh/6mduo4cdFwh1RmunSwMQamo/tljN8xaR2sW2qXjyn8zVVVPMG8cthveU8gqtoidQxC4nJWTVE/riAUKLeP2+26pJtDsjJm8533c7N2rJxAiyEXlV+NaJZ9VcNb1VjUZBDAmd8CHM= 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] bugs: Mention -D_GLIBCXX_ASSERTIONS and -D_GLIBCXX_DEBUG Date: Thu, 26 Oct 2023 18:12:51 +0100 Message-ID: <20231026171256.4139997-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, 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: 1780839001372292636 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 --- htdocs/bugs/index.html | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/htdocs/bugs/index.html b/htdocs/bugs/index.html index da3d4c0d..a5a38f42 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 breaks ABI), please do try +-D_GLIBCXX_DEBUG which enables thorough checking throughout +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