From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id q7isNoEGUGjUnRAAWB0awg (envelope-from ) for ; Mon, 16 Jun 2025 07:56:49 -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=iMg3kM7j; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id CF2F01E102; Mon, 16 Jun 2025 07:56:49 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-10.1 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_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 61DE51E089 for ; Mon, 16 Jun 2025 07:56:46 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 7A747390D8EE for ; Mon, 16 Jun 2025 11:56:45 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 7A747390D8EE 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=iMg3kM7j 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 6E847390D8E8 for ; Mon, 16 Jun 2025 11:55:41 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 6E847390D8E8 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 6E847390D8E8 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=1750074941; cv=none; b=NcPITD3HBhfNz/VotAk0MlKZL1XUjcTZaz9AJYTOECTEPMI9yJ3/JI9hAGni8lvLgiJt8jKNdC4T/o+X35Hbke7kN8u9SGnIWBuwgCxgT7ygzeSViQWP65dlhnNH9uYvjPClwmZ5TWvhWAKOdOX2DZdKyjiy6TajrCUEMjn/bcE= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1750074941; c=relaxed/simple; bh=kmzezaVopA9UOFyaQ9mxTyAkDhRscnmcK96kxUBvD1k=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=eoj6GU3DyYvp9UVTHRIB5IFDvtEDVAExC/PLITwaZJ0lZWniUMtZfLwzSwy0aHHxjwKezoKDyIoqjnZcR4wrsOWXjYMqZvnGNcdLUIuEYGUI26iEhmvgsaN9G/61syNf8HES5yNDOMTdZr2etta3Tlo+FmjQEbL5yXf6QjpcUQw= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6E847390D8E8 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1750074941; 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=J5BhXeDLpCdyY0wkw+EDUe6yfSh794M51BaEKcr9oHI=; b=iMg3kM7juK63YPxzRYW5lfwa1lYk16xSnaIiBDtA16ZwcHhZcFlNSQtcaz5z6utnyd5She GpSyrQ8sbuX7fcGkWgqnWjClQfPUfdSnjcDcKCyY6Fd0zKFIsn4bzmGpIn6VrOefGoaTf1 ph09U96xtVqvrpyRXKUTf4z0dlQEby0= Received: from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-615-qCfsVnnUNZK3MYXiNSeXGw-1; Mon, 16 Jun 2025 07:55:39 -0400 X-MC-Unique: qCfsVnnUNZK3MYXiNSeXGw-1 X-Mimecast-MFC-AGG-ID: qCfsVnnUNZK3MYXiNSeXGw_1750074939 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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id EF0061800343 for ; Mon, 16 Jun 2025 11:55:38 +0000 (UTC) Received: from fedora.redhat.com (unknown [10.96.134.45]) by mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 86F531956095; Mon, 16 Jun 2025 11:55:37 +0000 (UTC) From: Guinevere Larsen To: gdb-patches@sourceware.org Cc: Guinevere Larsen Subject: [PATCH v3] gdb/doc: Explain linker namespaces Date: Mon, 16 Jun 2025 08:55:21 -0300 Message-ID: <20250616115521.12950-1-guinevere@redhat.com> In-Reply-To: <20250606194533.727963-1-guinevere@redhat.com> References: <20250606194533.727963-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: EQrTLOS4zMzJczv7va4LNVkQ68fVw4tVRjU3adFffIk_1750074939 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 | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 4d3a2d0bd5e..57eb3695e57 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -13106,15 +13106,15 @@ 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 (@pxref{Files}). 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 -The namespace which contains the current location in the inferior. This -returns @value{GDBN}'s internal numbering for the namespace. In systems with no -support for linker namespaces, this variable will always be set to -@samp{0}. +The namespace which contains the current location in the inferior. This returns +@value{GDBN}'s internal numbering for the namespace. In systems with no support +for linker namespaces, this variable will always be set to @samp{0}. @end table @@ -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: 8b9c9b26e18a63aae5b7fcac6b68cede5b61aaf3 -- 2.49.0