OpenLibm/README-OpenLibm.md

39 lines
1.7 KiB
Markdown
Raw Permalink Normal View History

2015-02-01 14:36:16 +01:00
# OpenLibm
2012-08-19 08:22:43 +02:00
[![Travis](https://travis-ci.org/JuliaMath/openlibm.svg?branch=master)](https://travis-ci.org/JuliaMath/openlibm)
[![AppVeyor](https://ci.appveyor.com/api/projects/status/sia04r4089rr19uc/branch/master?svg=true)](https://ci.appveyor.com/project/ararslan/openlibm-19152/branch/master)
2019-08-11 14:47:20 +02:00
[OpenLibm](https://openlibm.org/) is an effort to have a high quality, portable, standalone
C mathematical library ([`libm`](http://en.wikipedia.org/wiki/libm)).
It can be used standalone in applications and programming language
2014-12-04 20:14:29 +01:00
implementations.
2011-12-31 08:18:43 +01:00
The project was born out of a need to have a good `libm` for the
[Julia programming language](http://www.julialang.org) that worked
consistently across compilers and operating systems, and in 32-bit and
64-bit environments.
2012-01-06 05:35:01 +01:00
2015-02-01 14:36:16 +01:00
## Platform support
2012-07-03 17:30:34 +02:00
OpenLibm builds on Linux, macOS, Windows, FreeBSD, OpenBSD, NetBSD, and
2018-06-19 00:13:49 +02:00
DragonFly BSD. It builds with both GCC and clang. Although largely
tested and widely used on the x86 and x86-64 architectures, OpenLibm
also supports arm, aarch64, ppc64le, mips, wasm32, and s390(x).
2012-07-03 17:30:34 +02:00
2015-02-01 14:36:16 +01:00
## Build instructions
2014-06-12 09:22:21 +02:00
1. Use GNU Make to build OpenLibm. This is `make` on most systems, but `gmake` on BSDs.
2015-02-01 14:38:33 +01:00
2. Use `make USEGCC=1` to build with GCC. This is the default on
2014-12-04 20:14:29 +01:00
Linux and Windows.
3. Use `make USECLANG=1` to build with clang. This is the default on OS X, FreeBSD,
and OpenBSD.
2019-04-15 00:11:03 +02:00
4. Use `make ARCH=wasm32` to build the wasm32 library with clang. Requires clang-8.
5. Architectures are auto-detected. Use `make ARCH=i386` to force a
2016-03-03 10:23:33 +01:00
build for i386. Other supported architectures are i486, i586, and
i686. GCC 4.8 is the minimum requirement for correct codegen on
older 32-bit architectures.
## Acknowledgements
PowerPC support for openlibm was graciously sponsored by IBM.