mirror/gcc
2
0
Fork 0
mirror of git://gcc.gnu.org/git/gcc.git synced 2025-03-19 03:40:26 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: update symver attribute description

Browse Source 
gcc/ChangeLog:

	* doc/extend.texi: Be more precise in documentation
	of symver attribute.
This commit is contained in:
Martin Liska 2021-04-12 13:42:33 +02:00
parent 7569ce583f
commit bb8f2c3230
1 changed files with 19 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
gcc/doc/extend.texi
View File

@ -3848,23 +3848,33 @@ foo_v1 (void)
Will produce a @code{.symver foo_v1, foo@@VERS_1} directive in the assembler
output.
One can also define multiple version for a given symbol.
One can also define multiple version for a given symbol
(starting from binutils 2.35).
@smallexample
__attribute__ ((__symver__ ("foo@@VERS_2"), __symver__ ("foo@@VERS_3")))
int symver_foo_v1 (void)
@{
@}
__attribute__ ((__symver__ ("bar@@VERS_2")))
__attribute__ ((__symver__ ("bar@@VERS_3")))
int symver_bar_v1 (void)
@{
@}
@end smallexample
This example creates an alias of @code{foo_v1} with symbol name
@code{symver_foo_v1} which will be version @code{VERS_2} of @code{foo}.
This example creates a symbol name @code{symver_foo_v1}
which will be version @code{VERS_2} and @code{VERS_3} of @code{foo}.
If you have an older release of binutils, then symbol alias needs to
be used:
@smallexample
__attribute__ ((__symver__ ("foo@@VERS_2")))
int foo_v1 (void)
{
return 0;
}
__attribute__ ((__symver__ ("foo@VERS_3")))
__attribute__ ((alias ("foo_v1")))
int symver_foo_v1 (void);
@end smallexample
Finally if the parameter is @code{"@var{name2}@@@@@var{nodename}"} then in
addition to creating a symbol version (as if