llvm/lib/Support
Nick Lewycky e7c1aef2b8 Move WEAK marking to the declaration.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@144603 91177308-0d34-0410-b5e6-96231b3b80d8
2011-11-15 01:23:22 +00:00
..
Unix rename getHostTriple into getDefaultTargetTriple 2011-11-01 21:32:20 +00:00
Windows Return only the least significant 8 bits of the exit status from 2011-11-06 16:45:46 +00:00
Allocator.cpp
APFloat.cpp Fix APFloat::getSmallestNormalized so the shift doesn't depend on undefined behavior. Patch from Ahmed Charles. 2011-10-12 21:56:19 +00:00
APInt.cpp Fix APInt::operator*= so that it computes the correct result for large integers where there is unsigned overflow. Fix APFloat::toString so that it doesn't depend on the incorrect behavior in common cases (and computes the correct result in some rare cases). Fixes PR11086. 2011-10-07 23:40:49 +00:00
APSInt.cpp
Atomic.cpp Rename LLVM_MULTITHREADED define and fix build without threads. 2011-09-19 20:43:23 +00:00
BlockFrequency.cpp BlockFrequency: Use a smarter overflow check. 2011-10-27 16:38:50 +00:00
BranchProbability.cpp Print branch probabilities as percentages. 2011-10-23 11:32:54 +00:00
circular_raw_ostream.cpp
CMakeLists.txt Add the DataExtractor utility class. 2011-09-13 19:42:16 +00:00
CommandLine.cpp rename getHostTriple into getDefaultTargetTriple 2011-11-01 21:32:20 +00:00
ConstantRange.cpp Change: 2011-09-21 03:09:09 +00:00
COPYRIGHT.regex
CrashRecoveryContext.cpp lib/Support/CrashRecoveryContext.cpp: Add Win32 support to CrashRecoveryContext. Thanks to Aaron Ballman! 2011-08-20 06:35:36 +00:00
DAGDeltaAlgorithm.cpp
DataExtractor.cpp Add the DataExtractor utility class. 2011-09-13 19:42:16 +00:00
Debug.cpp
DeltaAlgorithm.cpp
Disassembler.cpp Clean up a few references to System/. We still have docs/SystemLibrary.html 2011-10-11 20:02:52 +00:00
Dwarf.cpp Add some more DWARF extensions from: 2011-09-15 05:21:03 +00:00
DynamicLibrary.cpp Make DynamicLibrary thread-safe w/r/t call to dlerror() after dlopen(). PR10718 2011-08-22 19:01:52 +00:00
Errno.cpp
ErrorHandling.cpp
FileUtilities.cpp
FoldingSet.cpp
FormattedStream.cpp
GraphWriter.cpp
Host.cpp Intel family 6 model 44 is Gulftown/Westmere-EP and doesn't have AVX. 2011-08-25 18:05:56 +00:00
IncludeFile.cpp Clean up a few references to System/. We still have docs/SystemLibrary.html 2011-10-11 20:02:52 +00:00
IntEqClasses.cpp
IntervalMap.cpp
IsInf.cpp
IsNAN.cpp
LLVMBuild.txt build: Add initial cut at LLVMBuild.txt files. 2011-11-03 18:53:17 +00:00
Makefile
ManagedStatic.cpp Add support for tsan annotations (thread sanitizer, a valgrind-based tool). 2011-11-14 20:50:16 +00:00
Memory.cpp The Mips specific function for instruction cache invalidation cannot be 2011-10-10 18:41:02 +00:00
MemoryBuffer.cpp Remove unused include of sys/uio.h in MemoryBuffer.cpp. It was not correctly protected by ifdef either. 2011-10-20 21:57:46 +00:00
MemoryObject.cpp Report failure if there are less bytes than requested in a MemoryObject. 2011-08-27 07:45:46 +00:00
Mutex.cpp Clean up a few references to System/. We still have docs/SystemLibrary.html 2011-10-11 20:02:52 +00:00
Path.cpp Remove a couple unused methods. PR11201. 2011-11-01 05:11:01 +00:00
PathV2.cpp Fix a minor bug in fs::create_directories. Patch by Albert Wong. 2011-09-16 18:36:31 +00:00
PluginLoader.cpp
PrettyStackTrace.cpp Add more initializers to quiet a clang warning. 2011-10-05 05:00:26 +00:00
Process.cpp
Program.cpp
raw_os_ostream.cpp
raw_ostream.cpp Avoid undefined behavior in signed integer negation. Patch by Ahmed Charles. 2011-10-13 22:49:56 +00:00
README.txt.system
regcclass.h
regcname.h
regcomp.c
regengine.inc
regerror.c
regex2.h
regex_impl.h
Regex.cpp
regexec.c
regfree.c
regstrlcpy.c
regutils.h
RWMutex.cpp Clean up a few references to System/. We still have docs/SystemLibrary.html 2011-10-11 20:02:52 +00:00
SearchForAddressOfSpecialSymbol.cpp These symbols appear to be visible by SearchForAddressOfSymbol and no longer 2011-09-27 20:01:41 +00:00
Signals.cpp
SmallPtrSet.cpp
SmallVector.cpp
SourceMgr.cpp remove the dead 'ShowLine' argument from SMDiagnostic. 2011-10-16 05:47:55 +00:00
Statistic.cpp Let printf do the formatting instead aligning strings ourselves. 2011-10-16 16:30:34 +00:00
StringExtras.cpp
StringMap.cpp
StringPool.cpp
StringRef.cpp Fix a typo. 2011-11-06 20:36:50 +00:00
system_error.cpp
SystemUtils.cpp
TargetRegistry.cpp rename getHostTriple into getDefaultTargetTriple 2011-11-01 21:32:20 +00:00
Threading.cpp Rename LLVM_MULTITHREADED define and fix build without threads. 2011-09-19 20:43:23 +00:00
ThreadLocal.cpp Clean up a few references to System/. We still have docs/SystemLibrary.html 2011-10-11 20:02:52 +00:00
Timer.cpp Add more PRI.64 macros for MSVC and use them throughout the codebase. 2011-11-05 08:57:40 +00:00
TimeValue.cpp
ToolOutputFile.cpp
Triple.cpp Remove the Alpha backend. 2011-10-27 22:56:32 +00:00
Twine.cpp Add Twine support for characters, and switch twine to use a union internally 2011-07-24 20:44:30 +00:00
Valgrind.cpp Move WEAK marking to the declaration. 2011-11-15 01:23:22 +00:00

Design Of lib/System
====================

The software in this directory is designed to completely shield LLVM from any
and all operating system specific functionality. It is not intended to be a
complete operating system wrapper (such as ACE), but only to provide the
functionality necessary to support LLVM.

The software located here, of necessity, has very specific and stringent design
rules. Violation of these rules means that cracks in the shield could form and
the primary goal of the library is defeated. By consistently using this library,
LLVM becomes more easily ported to new platforms since the only thing requiring
porting is this library.

Complete documentation for the library can be found in the file:
  llvm/docs/SystemLibrary.html
or at this URL:
  http://llvm.org/docs/SystemLibrary.html

While we recommend that you read the more detailed documentation, for the
impatient, here's a high level summary of the library's requirements.

 1. No system header files are to be exposed through the interface.
 2. Std C++ and Std C header files are okay to be exposed through the interface.
 3. No exposed system-specific functions.
 4. No exposed system-specific data.
 5. Data in lib/System classes must use only simple C++ intrinsic types.
 6. Errors are handled by returning "true" and setting an optional std::string
 7. Library must not throw any exceptions, period.
 8. Interface functions must not have throw() specifications.
 9. No duplicate function impementations are permitted within an operating
    system class.

To accomplish these requirements, the library has numerous design criteria that
must be satisfied. Here's a high level summary of the library's design criteria:

 1. No unused functionality (only what LLVM needs)
 2. High-Level Interfaces
 3. Use Opaque Classes
 4. Common Implementations
 5. Multiple Implementations
 6. Minimize Memory Allocation
 7. No Virtual Methods