commit:     426ec51a2e5b6f8706b357493fa47d628055b3a5
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Fri Aug 15 22:08:57 2025 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Fri Aug 15 22:27:20 2025 +0000
URL:        https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=426ec51a

sys-devel/gcc: improve USE=systemtap description

See https://sourceware.org/gdb/wiki/LinkerInterface and
https://sourceware.org/gdb/wiki/DistroAdvice#sys.2Fsdt.h_probes.

gdb makes use of the interface provided/gated by USE=systemtap and it
isn't systemtap-specific at all other than using its headers/macros.

Signed-off-by: Sam James <sam <AT> gentoo.org>

 sys-devel/gcc/metadata.xml | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/sys-devel/gcc/metadata.xml b/sys-devel/gcc/metadata.xml
index 142253a37e48..c2a4c832cf06 100644
--- a/sys-devel/gcc/metadata.xml
+++ b/sys-devel/gcc/metadata.xml
@@ -110,7 +110,15 @@
                        to find runtime problems in applications.
                </flag>
                <flag name="ssp">Build packages with stack smashing protection 
on by default</flag>
-               <flag name="systemtap">enable systemtap static probe 
points</flag>
+               <flag name="systemtap">
+                       Enable enhanced debugging hooks/interface via SystemTap 
static probe points
+                       in libgcc and libstdc++.
+
+                       Note that this isn't exclusive to SystemTap, despite 
the name. This provides
+                       an interface which <pkg>dev-debug/gdb</pkg> optionally 
uses, see
+                       https://sourceware.org/gdb/wiki/LinkerInterface and
+                       
https://sourceware.org/gdb/wiki/DistroAdvice#sys.2Fsdt.h_probes.
+               </flag>
                <flag name="vtv">
                        Build support for virtual table verification (a C++ 
hardening feature).
 

Reply via email to