gccint: Plugins loading

1 
1 24.1 Loading Plugins
1 ====================
1 
1 Plugins are supported on platforms that support '-ldl -rdynamic' as well
1 as Windows/MinGW. They are loaded by the compiler using 'dlopen' or
1 equivalent and invoked at pre-determined locations in the compilation
1 process.
1 
1  Plugins are loaded with
1 
1  '-fplugin=/path/to/NAME.EXT' '-fplugin-arg-NAME-KEY1[=VALUE1]'
1 
1  Where NAME is the plugin name and EXT is the platform-specific dynamic
1 library extension.  It should be 'dll' on Windows/MinGW, 'dylib' on
1 Darwin/Mac OS X, and 'so' on all other platforms.  The plugin arguments
1 are parsed by GCC and passed to respective plugins as key-value pairs.
1 Multiple plugins can be invoked by specifying multiple '-fplugin'
1 arguments.
1 
1  A plugin can be simply given by its short name (no dots or slashes).
1 When simply passing '-fplugin=NAME', the plugin is loaded from the
1 'plugin' directory, so '-fplugin=NAME' is the same as '-fplugin=`gcc
1 -print-file-name=plugin`/NAME.EXT', using backquote shell syntax to
1 query the 'plugin' directory.
1