From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 4G2NBoYIQ2ibWQMAWB0awg (envelope-from ) for ; Fri, 06 Jun 2025 11:25:58 -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=UtV7JT3U; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 16AEB1E11C; Fri, 6 Jun 2025 11:25:58 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-6.8 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,RCVD_IN_SBL_CSS,RCVD_IN_VALIDITY_CERTIFIED, RCVD_IN_VALIDITY_RPBL,RCVD_IN_VALIDITY_SAFE autolearn=ham autolearn_force=no version=4.0.1 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 9F1B71E0C2 for ; Fri, 6 Jun 2025 11:25:57 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 4ACAF3857354 for ; Fri, 6 Jun 2025 15:25:57 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4ACAF3857354 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=UtV7JT3U 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 1F060385772F for ; Fri, 6 Jun 2025 15:24:41 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 1F060385772F Authentication-Results: sourceware.org; dmarc=pass (p=quarantine 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 1F060385772F 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=1749223481; cv=none; b=A9Bs+EqzuQqPv3Fc0PF7QrjeRC+98W04CgY8Se3q1/M/HcMdvYV7k2gGRFogcel1Ao51j804TGJBIsLlF+UwHEbOW7+L5v15ozuvcRZ+BWefmTuzuUok++K3MHIR9GO4efH5QM/hD+j+i4YmRCq9HOqfME0bHDVMHqHupBRn7OE= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1749223481; c=relaxed/simple; bh=3UlrSd58eq0Nv4lNlesa29oivSbMvPH26wpZaGHKPC4=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=nStxDYg8wBR+kgZ32qL/P2TQCTjfoNe02grDezHS+u5CzspFUBoiqY4ymRF+YcrXs8GEsqYba6Cr9t/BgUYQbWiZZpYXqpr+I17lkmW1vkhvzFG+UAdDNGstOB1Su/OyW5xDgi8eF2U5I4WvVXCzUaMjRsX6zuqLyGw9qYO3Ufw= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1F060385772F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1749223480; 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; bh=z1sgvp/adgQGrOZySIaYO5UPVGdfTBhYUwoUH8weB4I=; b=UtV7JT3UUWOYMQzBLKM3mkg4JjVrPxHDO99HtOCNlc9VMXfFQbA7mKfGIVC0IglTQyeVo3 prWmrNVn2thTQm9D/Cm/qtpenoygfz5BVhrbzU8yhN3ZKSVtVvVY/NQBDRrwKcSoT+NdQ+ gqwSZrDpoXkLBz8CUR6/LsSCGxRB818= 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-119-cM7oWIBfPw61JVvzyv4vPA-1; Fri, 06 Jun 2025 11:24:37 -0400 X-MC-Unique: cM7oWIBfPw61JVvzyv4vPA-1 X-Mimecast-MFC-AGG-ID: cM7oWIBfPw61JVvzyv4vPA_1749223477 Received: from mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.17]) (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 E72361956080; Fri, 6 Jun 2025 15:24:36 +0000 (UTC) Received: from fedora.redhat.com (unknown [10.96.134.98]) by mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 2EFDE195608F; Fri, 6 Jun 2025 15:24:34 +0000 (UTC) From: Guinevere Larsen To: gdb-patches@sourceware.org Cc: eliz@gnu.org, Guinevere Larsen Subject: [PATCH] gdb/doc: Explain linker namespaces Date: Fri, 6 Jun 2025 12:24:23 -0300 Message-ID: <20250606152423.567047-1-guinevere@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.17 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: 0Zj-80Ekye1YaCRTZ6uUws0rlaCBUuDT58Z5ter7vks_1749223477 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit content-type: text/plain; charset="US-ASCII"; x-default=true 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 Recent GDB commits added more features related to linker namespaces and documented them on the manual, but did not add a convenient way for a user to understand what they are. This commit adds a quick explanation of what they are. It also fixes the inconsistency of using "linker namespaces" and "linkage namespaces", by always using the first form to avoid user confusion. --- gdb/doc/gdb.texinfo | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 7d06e1f5fa4..60e853ffc50 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -13106,8 +13106,8 @@ environment variable. @vindex $_active_linker_namespaces@r{, convenience variable} @item $_active_linker_namespaces -Number of active linkage namespaces in the inferior. In systems with no -support for linkage namespaces, this variable will always be set to @samp{1}. +Number of active linker namespaces in the inferior. In systems with no +support for linker namespaces, this variable will always be set to @samp{1}. @vindex $_linker_namespace@r{, convenience variable} @item $_linker_namespace @@ -22242,11 +22242,18 @@ be determined then the address range for the @code{.text} section from the library will be listed. If the @code{.text} section cannot be found then no addresses will be listed. -On systems that support linkage namespaces, the output includes an +On systems that support linker namespaces, the output includes an additional column @code{NS} if the inferior has more than one active -namespace when the command is used. This column the linkage namespace +namespace when the command is used. This column the linker namespace that the shared library was loaded into. +@cindex Linker Namespaces +Linker namespaces are a feature of some standard libraries, that allow +shared objects to be loaded in isolated environment, eliminating the +possibility that those objects may cross-talk. Each set of isolated +shared objects is said to belong to a "namespace", and linker related +actions such as relocations do not cross namespace boundaries. + @kindex info dll @item info dll @var{regex} This is an alias of @code{info sharedlibrary}. base-commit: 96662aacaa0cf0a9766d874fc9577a5da417dbcc -- 2.49.0