<div dir="ltr">Thanks!</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, May 28, 2014 at 4:09 PM, Greg Fitzgerald <span dir="ltr"><<a href="mailto:gregf@codeaurora.org" target="_blank">gregf@codeaurora.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Author: garious<br>
Date: Wed May 28 18:09:45 2014<br>
New Revision: 209778<br>
<br>
URL: <a href="http://llvm.org/viewvc/llvm-project?rev=209778&view=rev" target="_blank">http://llvm.org/viewvc/llvm-project?rev=209778&view=rev</a><br>
Log:<br>
Moved the builtins documentation to lib/builtins/<br>
<br>
And fixed typos in the ASan readme.<br>
<br>
Differential Revision: <a href="http://reviews.llvm.org/D3927" target="_blank">http://reviews.llvm.org/D3927</a><br>
<br>
Added:<br>
compiler-rt/trunk/lib/builtins/README.txt<br>
- copied, changed from r209773, compiler-rt/trunk/README.txt<br>
Modified:<br>
compiler-rt/trunk/README.txt<br>
compiler-rt/trunk/lib/asan/README.txt<br>
<br>
Modified: compiler-rt/trunk/README.txt<br>
URL: <a href="http://llvm.org/viewvc/llvm-project/compiler-rt/trunk/README.txt?rev=209778&r1=209777&r2=209778&view=diff" target="_blank">http://llvm.org/viewvc/llvm-project/compiler-rt/trunk/README.txt?rev=209778&r1=209777&r2=209778&view=diff</a><br>
==============================================================================<br>
--- compiler-rt/trunk/README.txt (original)<br>
+++ compiler-rt/trunk/README.txt Wed May 28 18:09:45 2014<br>
@@ -9,335 +9,3 @@ terms of the license agreement found in<br>
<br>
================================<br>
<br>
-This is a replacement library for libgcc. Each function is contained<br>
-in its own file. Each function has a corresponding unit test under<br>
-test/Unit.<br>
-<br>
-A rudimentary script to test each file is in the file called<br>
-test/Unit/test.<br>
-<br>
-Here is the specification for this library:<br>
-<br>
-<a href="http://gcc.gnu.org/onlinedocs/gccint/Libgcc.html#Libgcc" target="_blank">http://gcc.gnu.org/onlinedocs/gccint/Libgcc.html#Libgcc</a><br>
-<br>
-Here is a synopsis of the contents of this library:<br>
-<br>
-typedef int si_int;<br>
-typedef unsigned su_int;<br>
-<br>
-typedef long long di_int;<br>
-typedef unsigned long long du_int;<br>
-<br>
-// Integral bit manipulation<br>
-<br>
-di_int __ashldi3(di_int a, si_int b); // a << b<br>
-ti_int __ashlti3(ti_int a, si_int b); // a << b<br>
-<br>
-di_int __ashrdi3(di_int a, si_int b); // a >> b arithmetic (sign fill)<br>
-ti_int __ashrti3(ti_int a, si_int b); // a >> b arithmetic (sign fill)<br>
-di_int __lshrdi3(di_int a, si_int b); // a >> b logical (zero fill)<br>
-ti_int __lshrti3(ti_int a, si_int b); // a >> b logical (zero fill)<br>
-<br>
-si_int __clzsi2(si_int a); // count leading zeros<br>
-si_int __clzdi2(di_int a); // count leading zeros<br>
-si_int __clzti2(ti_int a); // count leading zeros<br>
-si_int __ctzsi2(si_int a); // count trailing zeros<br>
-si_int __ctzdi2(di_int a); // count trailing zeros<br>
-si_int __ctzti2(ti_int a); // count trailing zeros<br>
-<br>
-si_int __ffsdi2(di_int a); // find least significant 1 bit<br>
-si_int __ffsti2(ti_int a); // find least significant 1 bit<br>
-<br>
-si_int __paritysi2(si_int a); // bit parity<br>
-si_int __paritydi2(di_int a); // bit parity<br>
-si_int __parityti2(ti_int a); // bit parity<br>
-<br>
-si_int __popcountsi2(si_int a); // bit population<br>
-si_int __popcountdi2(di_int a); // bit population<br>
-si_int __popcountti2(ti_int a); // bit population<br>
-<br>
-uint32_t __bswapsi2(uint32_t a); // a byteswapped, arm only<br>
-uint64_t __bswapdi2(uint64_t a); // a byteswapped, arm only<br>
-<br>
-// Integral arithmetic<br>
-<br>
-di_int __negdi2 (di_int a); // -a<br>
-ti_int __negti2 (ti_int a); // -a<br>
-di_int __muldi3 (di_int a, di_int b); // a * b<br>
-ti_int __multi3 (ti_int a, ti_int b); // a * b<br>
-si_int __divsi3 (si_int a, si_int b); // a / b signed<br>
-di_int __divdi3 (di_int a, di_int b); // a / b signed<br>
-ti_int __divti3 (ti_int a, ti_int b); // a / b signed<br>
-su_int __udivsi3 (su_int n, su_int d); // a / b unsigned<br>
-du_int __udivdi3 (du_int a, du_int b); // a / b unsigned<br>
-tu_int __udivti3 (tu_int a, tu_int b); // a / b unsigned<br>
-si_int __modsi3 (si_int a, si_int b); // a % b signed<br>
-di_int __moddi3 (di_int a, di_int b); // a % b signed<br>
-ti_int __modti3 (ti_int a, ti_int b); // a % b signed<br>
-su_int __umodsi3 (su_int a, su_int b); // a % b unsigned<br>
-du_int __umoddi3 (du_int a, du_int b); // a % b unsigned<br>
-tu_int __umodti3 (tu_int a, tu_int b); // a % b unsigned<br>
-du_int __udivmoddi4(du_int a, du_int b, du_int* rem); // a / b, *rem = a % b unsigned<br>
-tu_int __udivmodti4(tu_int a, tu_int b, tu_int* rem); // a / b, *rem = a % b unsigned<br>
-su_int __udivmodsi4(su_int a, su_int b, su_int* rem); // a / b, *rem = a % b unsigned<br>
-si_int __divmodsi4(si_int a, si_int b, si_int* rem); // a / b, *rem = a % b signed<br>
-<br>
-<br>
-<br>
-// Integral arithmetic with trapping overflow<br>
-<br>
-si_int __absvsi2(si_int a); // abs(a)<br>
-di_int __absvdi2(di_int a); // abs(a)<br>
-ti_int __absvti2(ti_int a); // abs(a)<br>
-<br>
-si_int __negvsi2(si_int a); // -a<br>
-di_int __negvdi2(di_int a); // -a<br>
-ti_int __negvti2(ti_int a); // -a<br>
-<br>
-si_int __addvsi3(si_int a, si_int b); // a + b<br>
-di_int __addvdi3(di_int a, di_int b); // a + b<br>
-ti_int __addvti3(ti_int a, ti_int b); // a + b<br>
-<br>
-si_int __subvsi3(si_int a, si_int b); // a - b<br>
-di_int __subvdi3(di_int a, di_int b); // a - b<br>
-ti_int __subvti3(ti_int a, ti_int b); // a - b<br>
-<br>
-si_int __mulvsi3(si_int a, si_int b); // a * b<br>
-di_int __mulvdi3(di_int a, di_int b); // a * b<br>
-ti_int __mulvti3(ti_int a, ti_int b); // a * b<br>
-<br>
-<br>
-// Integral arithmetic which returns if overflow<br>
-<br>
-si_int __mulosi4(si_int a, si_int b, int* overflow); // a * b, overflow set to one if result not in signed range<br>
-di_int __mulodi4(di_int a, di_int b, int* overflow); // a * b, overflow set to one if result not in signed range<br>
-ti_int __muloti4(ti_int a, ti_int b, int* overflow); // a * b, overflow set to<br>
- one if result not in signed range<br>
-<br>
-<br>
-// Integral comparison: a < b -> 0<br>
-// a == b -> 1<br>
-// a > b -> 2<br>
-<br>
-si_int __cmpdi2 (di_int a, di_int b);<br>
-si_int __cmpti2 (ti_int a, ti_int b);<br>
-si_int __ucmpdi2(du_int a, du_int b);<br>
-si_int __ucmpti2(tu_int a, tu_int b);<br>
-<br>
-// Integral / floating point conversion<br>
-<br>
-di_int __fixsfdi( float a);<br>
-di_int __fixdfdi( double a);<br>
-di_int __fixxfdi(long double a);<br>
-<br>
-ti_int __fixsfti( float a);<br>
-ti_int __fixdfti( double a);<br>
-ti_int __fixxfti(long double a);<br>
-uint64_t __fixtfdi(long double input); // ppc only, doesn't match documentation<br>
-<br>
-su_int __fixunssfsi( float a);<br>
-su_int __fixunsdfsi( double a);<br>
-su_int __fixunsxfsi(long double a);<br>
-<br>
-du_int __fixunssfdi( float a);<br>
-du_int __fixunsdfdi( double a);<br>
-du_int __fixunsxfdi(long double a);<br>
-<br>
-tu_int __fixunssfti( float a);<br>
-tu_int __fixunsdfti( double a);<br>
-tu_int __fixunsxfti(long double a);<br>
-uint64_t __fixunstfdi(long double input); // ppc only<br>
-<br>
-float __floatdisf(di_int a);<br>
-double __floatdidf(di_int a);<br>
-long double __floatdixf(di_int a);<br>
-long double __floatditf(int64_t a); // ppc only<br>
-<br>
-float __floattisf(ti_int a);<br>
-double __floattidf(ti_int a);<br>
-long double __floattixf(ti_int a);<br>
-<br>
-float __floatundisf(du_int a);<br>
-double __floatundidf(du_int a);<br>
-long double __floatundixf(du_int a);<br>
-long double __floatunditf(uint64_t a); // ppc only<br>
-<br>
-float __floatuntisf(tu_int a);<br>
-double __floatuntidf(tu_int a);<br>
-long double __floatuntixf(tu_int a);<br>
-<br>
-// Floating point raised to integer power<br>
-<br>
-float __powisf2( float a, si_int b); // a ^ b<br>
-double __powidf2( double a, si_int b); // a ^ b<br>
-long double __powixf2(long double a, si_int b); // a ^ b<br>
-long double __powitf2(long double a, si_int b); // ppc only, a ^ b<br>
-<br>
-// Complex arithmetic<br>
-<br>
-// (a + ib) * (c + id)<br>
-<br>
- float _Complex __mulsc3( float a, float b, float c, float d);<br>
- double _Complex __muldc3(double a, double b, double c, double d);<br>
-long double _Complex __mulxc3(long double a, long double b,<br>
- long double c, long double d);<br>
-long double _Complex __multc3(long double a, long double b,<br>
- long double c, long double d); // ppc only<br>
-<br>
-// (a + ib) / (c + id)<br>
-<br>
- float _Complex __divsc3( float a, float b, float c, float d);<br>
- double _Complex __divdc3(double a, double b, double c, double d);<br>
-long double _Complex __divxc3(long double a, long double b,<br>
- long double c, long double d);<br>
-long double _Complex __divtc3(long double a, long double b,<br>
- long double c, long double d); // ppc only<br>
-<br>
-<br>
-// Runtime support<br>
-<br>
-// __clear_cache() is used to tell process that new instructions have been<br>
-// written to an address range. Necessary on processors that do not have<br>
-// a unified instruction and data cache.<br>
-void __clear_cache(void* start, void* end);<br>
-<br>
-// __enable_execute_stack() is used with nested functions when a trampoline<br>
-// function is written onto the stack and that page range needs to be made<br>
-// executable.<br>
-void __enable_execute_stack(void* addr);<br>
-<br>
-// __gcc_personality_v0() is normally only called by the system unwinder.<br>
-// C code (as opposed to C++) normally does not need a personality function<br>
-// because there are no catch clauses or destructors to be run. But there<br>
-// is a C language extension __attribute__((cleanup(func))) which marks local<br>
-// variables as needing the cleanup function "func" to be run when the<br>
-// variable goes out of scope. That includes when an exception is thrown,<br>
-// so a personality handler is needed.<br>
-_Unwind_Reason_Code __gcc_personality_v0(int version, _Unwind_Action actions,<br>
- uint64_t exceptionClass, struct _Unwind_Exception* exceptionObject,<br>
- _Unwind_Context_t context);<br>
-<br>
-// for use with some implementations of assert() in <assert.h><br>
-void __eprintf(const char* format, const char* assertion_expression,<br>
- const char* line, const char* file);<br>
-<br>
-<br>
-<br>
-// Power PC specific functions<br>
-<br>
-// There is no C interface to the saveFP/restFP functions. They are helper<br>
-// functions called by the prolog and epilog of functions that need to save<br>
-// a number of non-volatile float point registers.<br>
-saveFP<br>
-restFP<br>
-<br>
-// PowerPC has a standard template for trampoline functions. This function<br>
-// generates a custom trampoline function with the specific realFunc<br>
-// and localsPtr values.<br>
-void __trampoline_setup(uint32_t* trampOnStack, int trampSizeAllocated,<br>
- const void* realFunc, void* localsPtr);<br>
-<br>
-// adds two 128-bit double-double precision values ( x + y )<br>
-long double __gcc_qadd(long double x, long double y);<br>
-<br>
-// subtracts two 128-bit double-double precision values ( x - y )<br>
-long double __gcc_qsub(long double x, long double y);<br>
-<br>
-// multiples two 128-bit double-double precision values ( x * y )<br>
-long double __gcc_qmul(long double x, long double y);<br>
-<br>
-// divides two 128-bit double-double precision values ( x / y )<br>
-long double __gcc_qdiv(long double a, long double b);<br>
-<br>
-<br>
-// ARM specific functions<br>
-<br>
-// There is no C interface to the switch* functions. These helper functions<br>
-// are only needed by Thumb1 code for efficient switch table generation.<br>
-switch16<br>
-switch32<br>
-switch8<br>
-switchu8<br>
-<br>
-// There is no C interface to the *_vfp_d8_d15_regs functions. There are<br>
-// called in the prolog and epilog of Thumb1 functions. When the C++ ABI use<br>
-// SJLJ for exceptions, each function with a catch clause or destuctors needs<br>
-// to save and restore all registers in it prolog and epliog. But there is<br>
-// no way to access vector and high float registers from thumb1 code, so the<br>
-// compiler must add call outs to these helper functions in the prolog and<br>
-// epilog.<br>
-restore_vfp_d8_d15_regs<br>
-save_vfp_d8_d15_regs<br>
-<br>
-<br>
-// Note: long ago ARM processors did not have floating point hardware support.<br>
-// Floating point was done in software and floating point parameters were<br>
-// passed in integer registers. When hardware support was added for floating<br>
-// point, new *vfp functions were added to do the same operations but with<br>
-// floating point parameters in floating point registers.<br>
-<br>
-// Undocumented functions<br>
-<br>
-float __addsf3vfp(float a, float b); // Appears to return a + b<br>
-double __adddf3vfp(double a, double b); // Appears to return a + b<br>
-float __divsf3vfp(float a, float b); // Appears to return a / b<br>
-double __divdf3vfp(double a, double b); // Appears to return a / b<br>
-int __eqsf2vfp(float a, float b); // Appears to return one<br>
- // iff a == b and neither is NaN.<br>
-int __eqdf2vfp(double a, double b); // Appears to return one<br>
- // iff a == b and neither is NaN.<br>
-double __extendsfdf2vfp(float a); // Appears to convert from<br>
- // float to double.<br>
-int __fixdfsivfp(double a); // Appears to convert from<br>
- // double to int.<br>
-int __fixsfsivfp(float a); // Appears to convert from<br>
- // float to int.<br>
-unsigned int __fixunssfsivfp(float a); // Appears to convert from<br>
- // float to unsigned int.<br>
-unsigned int __fixunsdfsivfp(double a); // Appears to convert from<br>
- // double to unsigned int.<br>
-double __floatsidfvfp(int a); // Appears to convert from<br>
- // int to double.<br>
-float __floatsisfvfp(int a); // Appears to convert from<br>
- // int to float.<br>
-double __floatunssidfvfp(unsigned int a); // Appears to convert from<br>
- // unisgned int to double.<br>
-float __floatunssisfvfp(unsigned int a); // Appears to convert from<br>
- // unisgned int to float.<br>
-int __gedf2vfp(double a, double b); // Appears to return __gedf2<br>
- // (a >= b)<br>
-int __gesf2vfp(float a, float b); // Appears to return __gesf2<br>
- // (a >= b)<br>
-int __gtdf2vfp(double a, double b); // Appears to return __gtdf2<br>
- // (a > b)<br>
-int __gtsf2vfp(float a, float b); // Appears to return __gtsf2<br>
- // (a > b)<br>
-int __ledf2vfp(double a, double b); // Appears to return __ledf2<br>
- // (a <= b)<br>
-int __lesf2vfp(float a, float b); // Appears to return __lesf2<br>
- // (a <= b)<br>
-int __ltdf2vfp(double a, double b); // Appears to return __ltdf2<br>
- // (a < b)<br>
-int __ltsf2vfp(float a, float b); // Appears to return __ltsf2<br>
- // (a < b)<br>
-double __muldf3vfp(double a, double b); // Appears to return a * b<br>
-float __mulsf3vfp(float a, float b); // Appears to return a * b<br>
-int __nedf2vfp(double a, double b); // Appears to return __nedf2<br>
- // (a != b)<br>
-double __negdf2vfp(double a); // Appears to return -a<br>
-float __negsf2vfp(float a); // Appears to return -a<br>
-float __negsf2vfp(float a); // Appears to return -a<br>
-double __subdf3vfp(double a, double b); // Appears to return a - b<br>
-float __subsf3vfp(float a, float b); // Appears to return a - b<br>
-float __truncdfsf2vfp(double a); // Appears to convert from<br>
- // double to float.<br>
-int __unorddf2vfp(double a, double b); // Appears to return __unorddf2<br>
-int __unordsf2vfp(float a, float b); // Appears to return __unordsf2<br>
-<br>
-<br>
-Preconditions are listed for each function at the definition when there are any.<br>
-Any preconditions reflect the specification at<br>
-<a href="http://gcc.gnu.org/onlinedocs/gccint/Libgcc.html#Libgcc" target="_blank">http://gcc.gnu.org/onlinedocs/gccint/Libgcc.html#Libgcc</a>.<br>
-<br>
-Assumptions are listed in "int_lib.h", and in individual files. Where possible<br>
-assumptions are checked at compile time.<br>
<br>
Modified: compiler-rt/trunk/lib/asan/README.txt<br>
URL: <a href="http://llvm.org/viewvc/llvm-project/compiler-rt/trunk/lib/asan/README.txt?rev=209778&r1=209777&r2=209778&view=diff" target="_blank">http://llvm.org/viewvc/llvm-project/compiler-rt/trunk/lib/asan/README.txt?rev=209778&r1=209777&r2=209778&view=diff</a><br>
==============================================================================<br>
--- compiler-rt/trunk/lib/asan/README.txt (original)<br>
+++ compiler-rt/trunk/lib/asan/README.txt Wed May 28 18:09:45 2014<br>
@@ -1,16 +1,15 @@<br>
AddressSanitizer RT<br>
================================<br>
-This directory contains sources of the AddressSanitizer (asan) run-time library.<br>
+This directory contains sources of the AddressSanitizer (asan) runtime library.<br>
We are in the process of integrating AddressSanitizer with LLVM, stay tuned.<br>
<br>
-Directory structre:<br>
+Directory structure:<br>
README.txt : This file.<br>
Makefile.mk : File for make-based build.<br>
CMakeLists.txt : File for cmake-based build.<br>
-asan_*.{cc,h} : Sources of the asan run-time lirbary.<br>
+asan_*.{cc,h} : Sources of the asan runtime library.<br>
scripts/* : Helper scripts.<br>
tests/* : ASan unit tests.<br>
-lit_tests/* : ASan output tests.<br>
<br>
Also ASan runtime needs the following libraries:<br>
lib/interception/ : Machinery used to intercept function calls.<br>
<br>
Copied: compiler-rt/trunk/lib/builtins/README.txt (from r209773, compiler-rt/trunk/README.txt)<br>
URL: <a href="http://llvm.org/viewvc/llvm-project/compiler-rt/trunk/lib/builtins/README.txt?p2=compiler-rt/trunk/lib/builtins/README.txt&p1=compiler-rt/trunk/README.txt&r1=209773&r2=209778&rev=209778&view=diff" target="_blank">http://llvm.org/viewvc/llvm-project/compiler-rt/trunk/lib/builtins/README.txt?p2=compiler-rt/trunk/lib/builtins/README.txt&p1=compiler-rt/trunk/README.txt&r1=209773&r2=209778&rev=209778&view=diff</a><br>
==============================================================================<br>
(empty)<br>
<br>
<br>
_______________________________________________<br>
llvm-commits mailing list<br>
<a href="mailto:llvm-commits@cs.uiuc.edu">llvm-commits@cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div dir="ltr">Alexey Samsonov<br><a href="mailto:vonosmas@gmail.com" target="_blank">vonosmas@gmail.com</a></div>
</div>