summaryrefslogtreecommitdiff
path: root/include
diff options
context:
space:
mode:
Diffstat (limited to 'include')
-rw-r--r--include/shlib-compat.h8
1 files changed, 6 insertions, 2 deletions
diff --git a/include/shlib-compat.h b/include/shlib-compat.h
index d872afcbab..6f11be804a 100644
--- a/include/shlib-compat.h
+++ b/include/shlib-compat.h
@@ -78,8 +78,12 @@
#endif
-/* Use compat_symbol_reference for a reference to a specific version
- of a symbol. Use compat_symbol to define such a symbol. */
+/* Use compat_symbol_reference for a reference *or* definition of a
+ specific version of a symbol. Definitions are primarily used to
+ ensure tests reference the exact compat symbol required, or define an
+ interposing symbol of the right version e.g. __malloc_initialize_hook
+ in mcheck-init.c. Use compat_symbol to define such a symbol within
+ the shared libraries that are built for users. */
#define compat_symbol_reference(lib, local, symbol, version) \
compat_symbol_reference_1 (lib, local, symbol, version)
#define compat_symbol_reference_1(lib, local, symbol, version) \