Files
gcc-reflection/gcc/plugin.def
David Malcolm f68343c254 analyzer: replace PLUGIN_ANALYZER_INIT with a pub/sub channel
This patch eliminates the PLUGIN_ANALYZER_INIT event in favor of a new
analyzer_events_channel that can be subscribed to, and ports all the
in-tree analyzer plugins to using it.

The PLUGIN_* approach isn't typesafe, and the name suggests it's only
meant to be used for plugins, whereas the pub/sub approach is typesafe,
and treats the publish/subscribe network as orthogonal to whether the
code is built into the executable or is a plugin.

gcc/analyzer/ChangeLog:
	* common.h: Define INCLUDE_LIST.
	(class plugin_analyzer_init_iface): Replace with...
	(gcc::topics::analyzer_events::on_ana_init): ...this.
	(gcc::topics::analyzer_events::subscriber): New.
	* engine.cc: Include "context.h" and "channels.h".
	(class plugin_analyzer_init_impl): Replace with...
	(class impl_on_ana_init): ...this.  Fix some overlong lines.
	(impl_run_checkers): Port from PLUGIN_ANALYZER_INIT to using
	publish/subscribe framework.

gcc/ChangeLog:
	* channels.h (gcc::topics::analyzer_events::subscriber): New
	forward decl.
	(compiler_channels::analyzer_events_channel): New field.
	* doc/plugins.texi (PLUGIN_ANALYZER_INIT): Delete.
	* plugin.cc (register_callback): Delete PLUGIN_ANALYZER_INIT.
	(invoke_plugin_callbacks_full): Likewise.
	* plugin.def (PLUGIN_ANALYZER_INIT): Delete this event.

gcc/testsuite/ChangeLog:
	* gcc.dg/plugin/analyzer_cpython_plugin.cc: Port from
	PLUGIN_ANALYZER_INIT to subscribing to analyzer_events_channel.
	* gcc.dg/plugin/analyzer_gil_plugin.cc: Likewise.
	* gcc.dg/plugin/analyzer_kernel_plugin.cc: Likewise.
	* gcc.dg/plugin/analyzer_known_fns_plugin.cc: Likewise.

Signed-off-by: David Malcolm <dmalcolm@redhat.com>
2026-01-09 15:54:16 -05:00

109 lines
3.2 KiB
Modula-2

/* This file contains the definitions for plugin events in GCC.
Copyright (C) 2009-2026 Free Software Foundation, Inc.
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/>. */
/* Called before parsing the body of a function. */
DEFEVENT (PLUGIN_START_PARSE_FUNCTION)
/* After finishing parsing a function. */
DEFEVENT (PLUGIN_FINISH_PARSE_FUNCTION)
/* To hook into pass manager. */
DEFEVENT (PLUGIN_PASS_MANAGER_SETUP)
/* After finishing parsing a type. */
DEFEVENT (PLUGIN_FINISH_TYPE)
/* After finishing parsing a declaration. */
DEFEVENT (PLUGIN_FINISH_DECL)
/* Useful for summary processing. */
DEFEVENT (PLUGIN_FINISH_UNIT)
/* Allows to see low level AST in C and C++ frontends. */
DEFEVENT (PLUGIN_PRE_GENERICIZE)
/* Called before GCC exits. */
DEFEVENT (PLUGIN_FINISH)
/* Information about the plugin. */
DEFEVENT (PLUGIN_INFO)
/* Called at start of GCC Garbage Collection. */
DEFEVENT (PLUGIN_GGC_START)
/* Extend the GGC marking. */
DEFEVENT (PLUGIN_GGC_MARKING)
/* Called at end of GGC. */
DEFEVENT (PLUGIN_GGC_END)
/* Register an extra GGC root table. */
DEFEVENT (PLUGIN_REGISTER_GGC_ROOTS)
/* Called during attribute registration. */
DEFEVENT (PLUGIN_ATTRIBUTES)
/* Called before processing a translation unit. */
DEFEVENT (PLUGIN_START_UNIT)
/* Called during pragma registration. */
DEFEVENT (PLUGIN_PRAGMAS)
/* Called before first pass from all_passes. */
DEFEVENT (PLUGIN_ALL_PASSES_START)
/* Called after last pass from all_passes. */
DEFEVENT (PLUGIN_ALL_PASSES_END)
/* Called before first ipa pass. */
DEFEVENT (PLUGIN_ALL_IPA_PASSES_START)
/* Called after last ipa pass. */
DEFEVENT (PLUGIN_ALL_IPA_PASSES_END)
/* Allows to override pass gate decision for current_pass. */
DEFEVENT (PLUGIN_OVERRIDE_GATE)
/* Called before executing a pass. */
DEFEVENT (PLUGIN_PASS_EXECUTION)
/* Called before executing subpasses of a GIMPLE_PASS in
execute_ipa_pass_list. */
DEFEVENT (PLUGIN_EARLY_GIMPLE_PASSES_START)
/* Called after executing subpasses of a GIMPLE_PASS in
execute_ipa_pass_list. */
DEFEVENT (PLUGIN_EARLY_GIMPLE_PASSES_END)
/* Called when a pass is first instantiated. */
DEFEVENT (PLUGIN_NEW_PASS)
/* Called when a file is #include-d or given via the #line directive.
this could happen many times. The event data is the included file path,
as a const char* pointer. */
DEFEVENT (PLUGIN_INCLUDE_FILE)
/* When adding a new hard-coded plugin event, don't forget to edit in
file plugin.cc the functions register_callback and
invoke_plugin_callbacks_full accordingly! */
/* After the hard-coded events above, plugins can dynamically allocate events
at run time.
PLUGIN_EVENT_FIRST_DYNAMIC only appears as last enum element. */