README.md
1DeforaOS libSystem
2==================
3
4About libSystem
5---------------
6
7libSystem is the most essential library within DeforaOS, with the aim to become
8a complete C runtime (thus obsoleting the libc and replacing its API).
9Regardless of its progress in this regard, libSystem is intended to be portable
10and work on any system, using any POSIX-compliant runtime as fallback if
11available.
12
13
14Compiling libSystem
15-------------------
16
17With GCC, this should be enough:
18
19 $ make
20
21To install libSystem in a dedicated directory, like `/path/to/libSystem`:
22
23 $ make PREFIX="/path/to/libSystem" install
24
25
26Platform-specific notes
27-----------------------
28
29On some GNU/Linux distributions, it may be necessary to link libSystem to libdl
30explicitly:
31
32 $ make LDFLAGS="-ldl"
33
34
35Generating Makefiles
36--------------------
37
38Alternatively, it is possible to re-generate the Makefiles for the current
39platform with `configure(1)` from the DeforaOS configure project, found at
40<http://www.defora.org/os/project/16/configure>. The procedure is then as
41follows:
42
43 $ configure
44 $ make
45
46Please refer to the documentation of DeforaOS configure for further
47instructions.
48
49A default set of Makefiles is provided with this project in order to avoid a
50circular dependency, as DeforaOS configure depends on libSystem itself. The
51Makefiles provided target the NetBSD Operating System <http://www.netbsd.org/>
52by default.
53
54
55Python bindings
56---------------
57
58Part of libSystem's API can also be accessed from within the Python programming
59language. This binding is not compiled or installed by default though. After
60installing libSystem as documented above, the Python interface can be built and
61installed as follows:
62
63 $ (cd src/python && make install)
64
65Likewise, an alternate installation directory may be specified:
66
67 $ (cd src/python && make PREFIX="/path/to/libSystem" install)
68
69Makefiles can be re-generated for the bindings as well:
70
71 $ configure src/python
72