mirror of
https://sourceware.org/git/glibc.git
synced 2024-11-25 22:40:05 +00:00
5500cdba40
Sun RPC was removed from glibc. This includes rpcgen program, librpcsvc, and Sun RPC headers. Also test for bug #20790 was removed (test for rpcgen). Backward compatibility for old programs is kept only for architectures and ABIs that have been added in or before version 2.28. libtirpc is mature enough, librpcsvc and rpcgen are provided in rpcsvc-proto project. NOTE: libnsl code depends on Sun RPC (installed libnsl headers use installed Sun RPC headers), thus --enable-obsolete-rpc was a dependency for --enable-obsolete-nsl (removed in a previous commit). The arc ABI list file has to be updated because the port was added with the sunrpc symbols Tested-by: Carlos O'Donell <carlos@redhat.com> Reviewed-by: Carlos O'Donell <carlos@redhat.com>
145 lines
6.4 KiB
C
145 lines
6.4 KiB
C
/* Macros for managing ABI-compatibility definitions using ELF symbol versions.
|
|
Copyright (C) 2000-2020 Free Software Foundation, Inc.
|
|
This file is part of the GNU C Library.
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
The GNU C Library 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
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with the GNU C Library; if not, see
|
|
<https://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef _SHLIB_COMPAT_H
|
|
#define _SHLIB_COMPAT_H 1
|
|
|
|
# include <abi-versions.h>
|
|
|
|
#ifdef SHARED
|
|
|
|
/* The file abi-versions.h (generated by scripts/abi-versions.awk) defines
|
|
symbols like `ABI_libm_GLIBC_2_0' for each version set in the source
|
|
code for each library. For a version set that is subsumed by a later
|
|
version set, the definition gives the subsuming set, i.e. if GLIBC_2_0
|
|
is subsumed by GLIBC_2_1, then ABI_libm_GLIBC_2_0 == ABI_libm_GLIBC_2_1.
|
|
Each version set that is to be distinctly defined in the output has an
|
|
unique positive integer value, increasing with newer versions. Thus,
|
|
evaluating two ABI_* symbols reduces to integer values that differ only
|
|
when the two version sets named are in fact two different ABIs we are
|
|
supporting. If these do not differ, then there is no need to compile in
|
|
extra code to support this version set where it has been superseded by a
|
|
newer version. The compatibility code should be conditionalized with
|
|
e.g. `#if SHLIB_COMPAT (libm, GLIBC_2_0, GLIBC_2_2)' for code introduced
|
|
in the GLIBC_2.0 version and obsoleted in the GLIBC_2.2 version. */
|
|
|
|
# define SHLIB_COMPAT(lib, introduced, obsoleted) \
|
|
_SHLIB_COMPAT (lib, introduced, obsoleted)
|
|
# define _SHLIB_COMPAT(lib, introduced, obsoleted) \
|
|
(IS_IN (lib) \
|
|
&& (!(ABI_##lib##_##obsoleted - 0) \
|
|
|| ((ABI_##lib##_##introduced - 0) < (ABI_##lib##_##obsoleted - 0))))
|
|
|
|
/* That header also defines symbols like `VERSION_libm_GLIBC_2_1' to
|
|
the version set name to use for e.g. symbols first introduced into
|
|
libm in the GLIBC_2.1 version. Definitions of symbols with explicit
|
|
versions should look like:
|
|
versioned_symbol (libm, new_foo, foo, GLIBC_2_1);
|
|
This will define the symbol `foo' with the appropriate default version,
|
|
i.e. either GLIBC_2.1 or the "earliest version" specified in
|
|
shlib-versions if that is newer. */
|
|
|
|
# define versioned_symbol(lib, local, symbol, version) \
|
|
versioned_symbol_1 (lib, local, symbol, version)
|
|
# define versioned_symbol_1(lib, local, symbol, version) \
|
|
versioned_symbol_2 (local, symbol, VERSION_##lib##_##version)
|
|
# define versioned_symbol_2(local, symbol, name) \
|
|
default_symbol_version (local, symbol, name)
|
|
|
|
# define compat_symbol(lib, local, symbol, version) \
|
|
compat_symbol_reference (lib, local, symbol, version)
|
|
|
|
/* This is similar to compat_symbol, but allows versioning the same symbol
|
|
to multiple version without having multiple symbol definitions. For
|
|
instance:
|
|
|
|
#if (SHLIB_COMPAT (libpthread, GLIBC_2_1_2, GLIBC_2_2))
|
|
compat_symbol_unique (libc, old_foo, GLIBC_2_1_2)
|
|
#endif
|
|
|
|
#if (SHLIB_COMPAT (libpthread, GLIBC_2_2_6, GLIBC_2_3))
|
|
compat_symbol_unique (libc, old_foo, GLIBC_2_2_6)
|
|
#endif
|
|
|
|
Internally it creates a unique strong alias to the input symbol and
|
|
creates one compat_symbol on the alias. Using the above example,
|
|
it is similar to:
|
|
|
|
#if (SHLIB_COMPAT (libpthread, GLIBC_2_1_2, GLIBC_2_2))
|
|
strong_alias (old_foo, old_foo__COUNTER__)
|
|
compat_symbol (libc, old_foo__COUNTER__, foo, GLIBC_2_2)
|
|
#endif.
|
|
|
|
With __COUNTER__ being a monotonic number generated by the compiler. */
|
|
|
|
# define __compat_symbol_unique_concat(x, y) x ## y
|
|
# define _compat_symbol_unique_concat(x, y) \
|
|
__compat_symbol_unique_concat (x, y)
|
|
# define _compat_symbol_unique_alias(name) \
|
|
_compat_symbol_unique_concat (name, __COUNTER__)
|
|
# define _compat_symbol_unique(lib, orig_name, name, version) \
|
|
strong_alias (orig_name, name) \
|
|
compat_symbol (lib, name, orig_name, version)
|
|
# define compat_symbol_unique(lib, name, version) \
|
|
_compat_symbol_unique (lib, name, _compat_symbol_unique_alias (name), \
|
|
version)
|
|
|
|
#else
|
|
|
|
/* Not compiling ELF shared libraries at all, so never any old versions. */
|
|
# define SHLIB_COMPAT(lib, introduced, obsoleted) 0
|
|
|
|
/* No versions to worry about, just make this the global definition. */
|
|
# define versioned_symbol(lib, local, symbol, version) \
|
|
weak_alias (local, symbol)
|
|
|
|
/* This should not appear outside `#if SHLIB_COMPAT (...)'. */
|
|
# define compat_symbol(lib, local, symbol, version) ...
|
|
# define compat_symbol_unique(lib, name, version) ...
|
|
|
|
#endif
|
|
|
|
/* 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) \
|
|
compat_symbol_reference_2 (local, symbol, VERSION_##lib##_##version)
|
|
#define compat_symbol_reference_2(local, symbol, name) \
|
|
symbol_version_reference (local, symbol, name)
|
|
|
|
/* Export the symbol only for shared-library compatibility. */
|
|
#define libc_sunrpc_symbol(name, aliasname, version) \
|
|
compat_symbol (libc, name, aliasname, version);
|
|
|
|
/* The TEST_COMPAT macro acts just like the SHLIB_COMPAT macro except
|
|
that it does not check IS_IN. It is used by tests that are testing
|
|
functionality that is only available in specific GLIBC versions. */
|
|
|
|
# define TEST_COMPAT(lib, introduced, obsoleted) \
|
|
_TEST_COMPAT (lib, introduced, obsoleted)
|
|
# define _TEST_COMPAT(lib, introduced, obsoleted) \
|
|
(!(ABI_##lib##_##obsoleted - 0) \
|
|
|| ((ABI_##lib##_##introduced - 0) < (ABI_##lib##_##obsoleted - 0)))
|
|
|
|
#endif /* shlib-compat.h */
|