1
0
mirror of https://github.com/RPCS3/llvm-mirror.git synced 2024-11-25 04:02:41 +01:00
llvm-mirror/lib/Support
Benjamin Kramer 49043825b4 raw_ostream: while it is generally desirable to do larger writes, it can lead to
inefficient file system buffering if the writes are not a multiple of the desired
buffer size. Avoid this by limiting the large write to a multiple of the buffer
size and copying the remainder into the buffer.

Thanks to Dan for pointing this out.

llvm-svn: 127026
2011-03-04 19:49:30 +00:00
..
Unix improve support for OpenBSD, patch by Amit Kulkarni! 2011-02-18 17:04:56 +00:00
Windows Windows/Windows.h: Redefine _WIN32_WINNT here. mingw-w64 tends to define it as 0x0502 in its headers. 2011-02-09 04:18:30 +00:00
Allocator.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
APFloat.cpp Enhance constant folding of bitcast operations on vectors of floats. 2011-02-17 21:22:27 +00:00
APInt.cpp The signed version of our "magic number" computation for the integer approximation 2011-02-21 00:22:02 +00:00
APSInt.cpp
Atomic.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
circular_raw_ostream.cpp
CMakeLists.txt Add ADT/IntEqClasses.h as a light-weight implementation of EquivalenceClasses.h. 2010-12-21 00:04:46 +00:00
CommandLine.cpp Support/CommandLine: Fix LookupNearestOption to also search extra option names. 2011-01-24 17:27:17 +00:00
ConstantRange.cpp PR5207: Change APInt methods trunc(), sext(), zext(), sextOrTrunc() and 2010-12-07 08:25:19 +00:00
COPYRIGHT.regex
CrashRecoveryContext.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
DAGDeltaAlgorithm.cpp
Debug.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
DeltaAlgorithm.cpp
Disassembler.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
Dwarf.cpp Provide tag strings for llvm specific tags. 2011-02-18 23:06:29 +00:00
DynamicLibrary.cpp Don't leak the mutex when loading dynamic libraries. 2010-12-07 07:56:20 +00:00
Errno.cpp lib/Support/Errno.cpp: Check strerror_s() with HAVE_DECL_STRERROR_S in config.h.*. 2011-02-09 04:18:48 +00:00
ErrorHandling.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
FileUtilities.cpp MemoryBuffer now return an error_code and returns a OwningPtr<MemoryBuffer> via an out parm. 2010-12-16 03:29:14 +00:00
FoldingSet.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
FormattedStream.cpp Add missing standard headers. Patch by Joerg Sonnenberger! 2010-12-19 20:43:38 +00:00
GraphWriter.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
Host.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
IncludeFile.cpp Now to chant the magical incantation that will exorcise the System library 2010-11-29 19:44:50 +00:00
IntEqClasses.cpp Use IntEqClasses to compute connected components of live intervals. 2010-12-21 00:48:17 +00:00
IntervalMap.cpp Add IntervalMap::iterator::set{Start,Stop,Value} methods that allow limited 2010-12-03 19:02:00 +00:00
IsInf.cpp
IsNAN.cpp
Makefile Merge System into Support. 2010-11-29 18:16:10 +00:00
ManagedStatic.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
Memory.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
MemoryBuffer.cpp Don't open the file again in the gold plugin. To be able to do this, update 2011-02-08 22:40:47 +00:00
MemoryObject.cpp
Mutex.cpp Check the errorcode. 2011-02-18 00:47:07 +00:00
Path.cpp Support/PathV2: Add identify_magic. 2011-01-15 20:39:36 +00:00
PathV2.cpp Implement a function from PathV2 whose definition is missing. 2011-02-15 17:51:19 +00:00
PluginLoader.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
PrettyStackTrace.cpp Change all self assignments X=X to (void)X, so that we can turn on a 2010-12-23 00:58:24 +00:00
Process.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
Program.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
raw_os_ostream.cpp
raw_ostream.cpp raw_ostream: while it is generally desirable to do larger writes, it can lead to 2011-03-04 19:49:30 +00:00
README.txt.system Merge System into Support. 2010-11-29 18:16:10 +00:00
regcclass.h
regcname.h
regcomp.c
regengine.inc
regerror.c
regex2.h
regex_impl.h
Regex.cpp
regexec.c lib/Support/regexec.c: Let Regex LLP64-aware. 2010-12-16 01:48:15 +00:00
regfree.c
regstrlcpy.c
regutils.h
RWMutex.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
SearchForAddressOfSpecialSymbol.cpp build: Go back to dropping __eprintf reference when building with Clang, see 2010-12-07 16:29:44 +00:00
Signals.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
SmallPtrSet.cpp
SmallVector.cpp
SourceMgr.cpp MemoryBuffer now return an error_code and returns a OwningPtr<MemoryBuffer> via an out parm. 2010-12-16 03:29:14 +00:00
Statistic.cpp Support: Add llvm::AreStatisticsEnabled(). 2011-02-26 23:17:12 +00:00
StringExtras.cpp
StringMap.cpp Change all self assignments X=X to (void)X, so that we can turn on a 2010-12-23 00:58:24 +00:00
StringPool.cpp
StringRef.cpp PR5207: Change APInt methods trunc(), sext(), zext(), sextOrTrunc() and 2010-12-07 08:25:19 +00:00
system_error.cpp Support/MemoryBuffer: Replace all uses of std::string *ErrMsg with error_code &ec. And fix clients. 2010-12-09 17:36:48 +00:00
SystemUtils.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
TargetRegistry.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
Threading.cpp Now to chant the magical incantation that will exorcise the System library 2010-11-29 19:44:50 +00:00
ThreadLocal.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
Timer.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
TimeValue.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
ToolOutputFile.cpp Merge System into Support. 2010-11-29 18:16:10 +00:00
Triple.cpp Triple::MinGW64 is deprecated and removed. We can use Triple::MinGW32 generally. 2011-02-17 12:24:17 +00:00
Twine.cpp Support/ADT/Twine: Make toNullTerminatedStringRef not rely on UB :(. 2010-12-03 05:42:25 +00:00
Valgrind.cpp Merge System into Support. 2010-11-29 18:16:10 +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