OpenE2K/gcc
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

extend.texi (__sync Builtins): Simplify some text.

Browse Source 
* doc/extend.texi (__sync Builtins): Simplify some text.  Update
	details about the implementation.  Make clear preference for
	__atomic builtins.  Reduce possibility of future change.

From-SVN: r222120
This commit is contained in:
Matthew Wahab 2015-04-15 08:35:53 +00:00 committed by Matthew Wahab
parent eea6e98958
commit a1e2583920
2 changed files with 18 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
gcc/ChangeLog
View File

@ -1,3 +1,9 @@
2015-04-14 Matthew Wahab <matthew.wahab@arm.com>
* doc/extend.texi (__sync Builtins): Simplify some text. Update
details about the implementation. Make clear preference for
__atomic builtins. Reduce possibility of future change.
2015-04-15 Nick Clifton <nickc@redhat.com> 2015-04-15 Nick Clifton <nickc@redhat.com>
* config/rx/rx.opt (mallow-string-insns): New option. * config/rx/rx.opt (mallow-string-insns): New option.

21
gcc/doc/extend.texi
View File

@ -8213,15 +8213,19 @@ identifier, or a sequence of member accesses and array references.
The following built-in functions The following built-in functions
are intended to be compatible with those described are intended to be compatible with those described
in the @cite{Intel Itanium Processor-specific Application Binary Interface}, in the @cite{Intel Itanium Processor-specific Application Binary Interface},
section 7.4. As such, they depart from the normal GCC practice of using section 7.4. As such, they depart from normal GCC practice by not using
the @samp{__builtin_} prefix, and further that they are overloaded such that the @samp{__builtin_} prefix and also by being overloaded so that they
they work on multiple types. work on multiple types.
The definition given in the Intel documentation allows only for the use of The definition given in the Intel documentation allows only for the use of
the types @code{int}, @code{long}, @code{long long} as well as their unsigned the types @code{int}, @code{long}, @code{long long} or their unsigned
counterparts. GCC allows any integral scalar or pointer type that is counterparts. GCC allows any integral scalar or pointer type that is
1, 2, 4 or 8 bytes in length. 1, 2, 4 or 8 bytes in length.
These functions are implemented in terms of the @samp{__atomic}
builtins (@pxref{__atomic Builtins}). They should not be used for new
code which should use the @samp{__atomic} builtins instead.
Not all operations are supported by all target processors. If a particular Not all operations are supported by all target processors. If a particular
operation cannot be implemented on the target processor, a warning is operation cannot be implemented on the target processor, a warning is
generated and a call to an external function is generated. The external generated and a call to an external function is generated. The external
@ -8243,11 +8247,10 @@ after the operation.
All of the routines are described in the Intel documentation to take All of the routines are described in the Intel documentation to take
``an optional list of variables protected by the memory barrier''. It's ``an optional list of variables protected by the memory barrier''. It's
not clear what is meant by that; it could mean that @emph{only} the not clear what is meant by that; it could mean that @emph{only} the
following variables are protected, or it could mean that these variables listed variables are protected, or it could mean a list of additional
should in addition be protected. At present GCC ignores this list and variables to be protected. The list is ignored by GCC which treats it as
protects all variables that are globally accessible. If in the future empty. GCC interprets an empty list as meaning that all globally
we make some use of this list, an empty list will continue to mean all accessible variables should be protected.
globally accessible variables.
@table @code @table @code
@item @var{type} __sync_fetch_and_add (@var{type} *ptr, @var{type} value, ...) @item @var{type} __sync_fetch_and_add (@var{type} *ptr, @var{type} value, ...)