From c21c1455fdfc6e87d75941f48841c72903e1e0f4 Mon Sep 17 00:00:00 2001 From: Paul Smith Date: Tue, 14 May 2013 22:53:42 -0400 Subject: Add requirement for plugin_is_GPL_compatible symbol in loaded objects. --- doc/make.texi | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'doc') diff --git a/doc/make.texi b/doc/make.texi index e3e5135..d1ceefb 100644 --- a/doc/make.texi +++ b/doc/make.texi @@ -11058,6 +11058,24 @@ functions may make use of the @code{gmk_expand} and @code{gmk_eval} routines to perform their tasks, then optionally return a string as the result of the function expansion. +@subsubheading Loaded Object Licensing +@cindex loaded object licensing +@cindex plugin_is_GPL_compatible + +Every dynamic extension should define the global symbol +@code{plugin_is_GPL_compatible} to assert that it has been licensed +under a GPL-compatible license. If this symbol does not exist, +@code{make} emits a fatal error and exits when it tries to load your +extension. + +The declared type of the symbol should be @code{int}. It does not need +to be in any allocated section, though. The code merely asserts that +the symbol exists in the global scope. Something like this is enough: + +@example +int plugin_is_GPL_compatible; +@end example + @subsubheading Data Structures @table @code @@ -11185,6 +11203,8 @@ function in a file @file{mk_temp.c}: #include +int plugin_is_GPL_compatible; + char * gen_tmpfile(const char *nm, int argc, char **argv) @{ -- cgit v1.2.3