README.patmos

                             COMPILER-RT FOR PATMOS


This is the compiler-rt library for Patmos, providing software routines for
soft-floats, conversions, division etc.

--------------------------------------------------------------------------------
1. Requirements

 - cmake 2.8 or higher

 - LLVM, Clang, and NewLib for Patmos (optional)
   https://github.com/t-crest/patmos-llvm
   https://github.com/t-crest/patmos-clang
   https://github.com/t-crest/patmos-newlib



--------------------------------------------------------------------------------
2. Configure and build

  mkdir build
  cd build
  cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/patmos-clang-toolchain.cmake \
           -DCMAKE_INSTALL_PREFIX=/path/to/newlib/prefix/ \
	   -DTRIPLE=patmos-unknown-unknown-elf
  make
  make install

The -DTRIPLE option is optional and defaults to patmos-unknown-unknown-elf.
'make install' puts the generated files next to the installed patmos-newlib
library files (which was configured with --prefix during newlib configuration)

You can disable the use of inline assembly code by setting

CFLAGS="-DCRT_NO_INLINE_ASM"

Additional search paths can be provided using -DCMAKE_PROGRAM_PATH=<path>
If you have an llvm installation apart from that with patmos,
also the option -DCMAKE_SYSTEM_IGNORE_PATH=<path> might be helpful
( e.g. -DCMAKE_SYSTEM_IGNORE_PATH=$(dirname $(which clang)) ).

Example:

  cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/patmos-clang-toolchain.cmake 
           -DCMAKE_PROGRAM_PATH=../../patmos-llvm/build/Debug+Asserts/bin 
	   -DCMAKE_INSTALL_PREFIX=../../patmos-llvm/build/Debug+Asserts/

--------------------------------------------------------------------------------
3. Use it


When patmos-clang invokes llvm-ld, it links compiler-rt automatically to your
application.


Have fun!