Go to file

Pierre Pronchery 5f83e7d2fe Add a comment about a potential year 2038 bug		2018-01-18 04:09:49 +01:00
data	Re-generate the Makefiles	2017-12-28 01:39:01 +01:00
doc	Re-generate the documentation	2017-12-28 01:42:12 +01:00
include	Re-generate the Makefiles	2017-12-28 01:39:01 +01:00
src	Add a comment about a potential year 2038 bug	2018-01-18 04:09:49 +01:00
tests	Register the new test for FIXME	2017-12-28 01:45:30 +01:00
tools	Re-generate the Makefiles	2017-12-28 01:39:01 +01:00
.gitignore	Add a few .gitignore files	2015-05-21 01:55:58 +02:00
config.h	Re-generate the Makefiles	2016-08-02 19:53:35 +02:00
config.sh	Re-generate the Makefiles	2016-08-02 19:53:35 +02:00
COPYING	Switched the license to the GPL LGPL version 3	2012-11-03 00:28:23 +01:00
Makefile	Re-generate the Makefiles	2017-12-28 01:45:06 +01:00
project.conf	About to release DeforaOS libSystem 0.3.1	2016-08-02 19:53:15 +02:00
README.md	Use HTTPS by default	2018-01-01 19:08:07 +01:00

README.md

DeforaOS libSystem

About libSystem

libSystem is the most essential library within DeforaOS, with the aim to become a complete C runtime (thus obsoleting the libc and replacing its API). Regardless of its progress in this regard, libSystem is intended to be portable and work on any system, using any POSIX-compliant runtime as fallback if available.

Compiling libSystem

With GCC, this should be enough:

$ make

To install libSystem in a dedicated directory, like /path/to/libSystem:

$ make PREFIX="/path/to/libSystem" install

Generating Makefiles

Alternatively, it is possible to re-generate the Makefiles for the current platform with configure(1) from the DeforaOS configure project, found at https://www.defora.org/os/project/16/configure. The procedure is then as follows:

$ configure
$ make

Please refer to the documentation of DeforaOS configure for further instructions.

A default set of Makefiles is provided with this project in order to avoid a circular dependency, as DeforaOS configure depends on libSystem itself. The Makefiles provided target the NetBSD Operating System https://www.netbsd.org/ by default.

Python bindings

Part of libSystem's API can also be accessed from within the Python programming language. This binding is not compiled or installed by default though. After installing libSystem as documented above, the Python interface can be built and installed as follows:

$ (cd src/python && make install)

Likewise, an alternate installation directory may be specified:

$ (cd src/python && make PREFIX="/path/to/libSystem" install)

Makefiles can be re-generated for the bindings as well:

$ configure src/python