aboutsummaryrefslogtreecommitdiff
path: root/gcc/diagnostics/selftest-paths.h
diff options
context:
space:
mode:
Diffstat (limited to 'gcc/diagnostics/selftest-paths.h')
-rw-r--r--gcc/diagnostics/selftest-paths.h169
1 files changed, 169 insertions, 0 deletions
diff --git a/gcc/diagnostics/selftest-paths.h b/gcc/diagnostics/selftest-paths.h
new file mode 100644
index 0000000..fe628f6
--- /dev/null
+++ b/gcc/diagnostics/selftest-paths.h
@@ -0,0 +1,169 @@
+/* Concrete classes for selftests involving diagnostic paths.
+ Copyright (C) 2019-2025 Free Software Foundation, Inc.
+ Contributed by David Malcolm <dmalcolm@redhat.com>
+
+This file is part of GCC.
+
+GCC is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free
+Software Foundation; either version 3, or (at your option) any later
+version.
+
+GCC is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+for more details.
+
+You should have received a copy of the GNU General Public License
+along with GCC; see the file COPYING3. If not see
+<http://www.gnu.org/licenses/>. */
+
+#ifndef GCC_DIAGNOSTICS_SELFTEST_PATHS_H
+#define GCC_DIAGNOSTICS_SELFTEST_PATHS_H
+
+#include "diagnostics/paths.h"
+#include "diagnostics/selftest-logical-locations.h"
+
+/* The selftest code should entirely disappear in a production
+ configuration, hence we guard all of it with #if CHECKING_P. */
+
+#if CHECKING_P
+
+namespace diagnostics {
+namespace paths {
+namespace selftest {
+
+/* Concrete subclasses of the abstract base classes
+ declared in diagnostic-path.h for use in selftests.
+
+ This code should have no dependency on "tree". */
+
+/* An implementation of diagnostics::paths::event. */
+
+class test_event : public event
+{
+ public:
+ using logical_location = logical_locations::key;
+ using thread_id_t = paths::thread_id_t;
+
+ test_event (location_t loc,
+ logical_location logical_loc,
+ int depth,
+ const char *desc,
+ thread_id_t thread_id = 0);
+ ~test_event ();
+
+ location_t get_location () const final override { return m_loc; }
+ int get_stack_depth () const final override { return m_depth; }
+ void print_desc (pretty_printer &pp) const final override
+ {
+ pp_string (&pp, m_desc);
+ }
+ logical_location get_logical_location () const final override
+ {
+ return m_logical_loc;
+ }
+ meaning get_meaning () const final override
+ {
+ return meaning ();
+ }
+ bool connect_to_next_event_p () const final override
+ {
+ return m_connected_to_next_event;
+ }
+ thread_id_t get_thread_id () const final override
+ {
+ return m_thread_id;
+ }
+
+ void connect_to_next_event ()
+ {
+ m_connected_to_next_event = true;
+ }
+
+ private:
+ location_t m_loc;
+ logical_location m_logical_loc;
+ int m_depth;
+ char *m_desc; // has been formatted; doesn't get i18n-ed
+ bool m_connected_to_next_event;
+ thread_id_t m_thread_id;
+};
+
+/* A simple implementation of diagnostics::paths::thread. */
+
+class test_thread : public thread
+{
+public:
+ test_thread (const char *name) : m_name (name) {}
+ label_text get_name (bool) const final override
+ {
+ return label_text::borrow (m_name);
+ }
+
+private:
+ const char *m_name; // has been i18n-ed and formatted
+};
+
+/* A concrete subclass of diagnostics::paths::path for implementing selftests
+ - a vector of test_event instances
+ - adds member functions for adding test event
+ - does no translation of its events
+ - has no dependency on "tree". */
+
+class test_path : public path
+{
+ public:
+ test_path (logical_locations::selftest::test_manager &logical_loc_mgr,
+ pretty_printer *event_pp);
+
+ unsigned num_events () const final override;
+ const event & get_event (int idx) const final override;
+ unsigned num_threads () const final override;
+ const thread &
+ get_thread (thread_id_t) const final override;
+ bool
+ same_function_p (int event_idx_a,
+ int event_idx_b) const final override;
+
+ thread_id_t add_thread (const char *name);
+
+ event_id_t add_event (location_t loc, const char *funcname, int depth,
+ const char *fmt, ...)
+ ATTRIBUTE_GCC_DIAG(5,6);
+ event_id_t
+ add_thread_event (thread_id_t thread_id,
+ location_t loc, const char *funcname, int depth,
+ const char *fmt, ...)
+ ATTRIBUTE_GCC_DIAG(6,7);
+
+ void connect_to_next_event ();
+
+ void add_entry (const char *callee_name, int stack_depth,
+ thread_id_t thread_id = 0);
+ void add_return (const char *caller_name, int stack_depth,
+ thread_id_t thread_id = 0);
+ void add_call (const char *caller_name,
+ int caller_stack_depth,
+ const char *callee_name,
+ thread_id_t thread_id = 0);
+
+ private:
+ logical_locations::key
+ logical_location_from_funcname (const char *funcname);
+
+ logical_locations::selftest::test_manager &m_test_logical_loc_mgr;
+ auto_delete_vec<test_thread> m_threads;
+ auto_delete_vec<test_event> m_events;
+
+ /* (for use by add_event). */
+ pretty_printer *m_event_pp;
+};
+
+} // namespace diagnostics::paths::selftest
+} // namespace diagnostics::paths
+} // namespace diagnostics
+
+#endif /* #if CHECKING_P */
+
+#endif /* ! GCC_DIAGNOSTICS_SELFTEST_PATHS_H */