From: Carlos O'Donell Date: Mon, 16 Oct 2017 18:43:28 +0000 (+0200) Subject: shlib-compat: Update documentation of the compat_symbol_reference macro X-Git-Tag: glibc-2.27~680 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3480ddc40b8f9a9fb277fe1883e359db3db0ab17;p=thirdparty%2Fglibc.git shlib-compat: Update documentation of the compat_symbol_reference macro --- diff --git a/ChangeLog b/ChangeLog index e45b749a40e..debac64d25a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2017-10-16 Carlos O'Donell + + * include/shlib-compat.h (compat_symbol_reference): Update + comment. + 2017-10-16 Joseph Myers * math/Makefile (test-types): Add diff --git a/include/shlib-compat.h b/include/shlib-compat.h index d872afcbab0..6f11be804a1 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) \