== MaKL is a Prerequisite ==

LibU needs http://koanlogic.com/makl to configure and build.

The following commands should be sufficient to get MaKL installed on any Linux
flavour or Darwin/MacOSX:

$ wget http://koanlogic.com/download/makl/makl-${VERSION}.tar.gz
$ tar zxf makl-${VERSION}.tar.gz && cd makl-${VERSION}
$ sh configure.sh
$ su
Password: ****

make install

Should your platform be one of Solaris, OpenSolaris, FreeBSD, PC-BSD, OpenBSD,
NetBSD, DragonflyBSD, Minix or Windows (MinGW or Gygwin) take a look at the
INSTALL file in the top-level MaKL sources directory to track down specific
variations on the theme.

== Download ==

Once MaKL is there, you can start downloading the package (always check the
official http://koanlogic.com/libu page for the latest version and related
ChangeLog) and tailor it to your specific needs:

$ wget http://koanlogic.com/download/libu/libu-${VERSION}.tar.gz
$ tar zxf libu-${VERSION}.tar.gz && cd libu-${VERSION}

== Configure ==

E.g. should you need to change the default installation path (i.e. /usr/local),
use:

$ makl-conf --prefix=“/my/install/base/dir”

Debug symbols and warnings from the compiler can be switched on via
–enable_debug and --enable_warns (use --enable_icc_warns instead when
working with the Intel C compiler):

$ makl-conf --enable_debug --enable_warns

Code profiling using gprof(1) can be activated via --enable_profile, and,
more generally, any compiler flag can be passed to the build stage in the
following way:

$ makl-conf --extra-cflags=“-Wformat -Wno-format-extra-args -Wformat-security -Wformat-nonliteral -Wformat=2”

The --extra-xxx=“val” is indeed a powerful mechanism by which any Makefile
variable ‘XXX’ (uppercase!) can be given an additional value ‘val’: (ab)use
it to tweak LDFLAGS, SHLIB_LDFLAGS, etc. as needed. Anyway if in doubt,
or in search for exotic features, type makl-conf -h to display the complete
list of options: it’s likely that what you are trying to achieve is already
there.

By default LibU is compiled as static library, to also enable shared library
build, supply the --enable_shared flag.

== Pick Up What Needs to be Included ==

The default is to build all the modules, but you can disable the
inclusion of specific bits selectively using the following switches:
- --no_hmap: to disable the hmap module
- --no_config: to disable the config module
- --no_net: to disable the net module
- --no_env: to disable the env module
- --no_fs: to disable the fs module
- --no_pwd: to disable the pwd module
- --no_list: to disable the list module
- --no_array: to disable the array module
- --no_ringbuffer: to disable the rb module
- --no_pqueue: to disable the pq module
- --no_json: to disable the json module
- --no_bst: to disable the bst module

Also, some specific features regarding the networking code can be disabled
at configuration:
- --no_ipv6: to disable IPv6 protocol support
- --no_sctp: to disable SCTP protocol support
- --no_unixsock: to disable UNIX IPC support

If you need to enable compatibility with (some, not all) 1.X interfaces,
specify the --compat_1x command line switch.

== Build, Test and Install ==

When you are done with the configure step, you can build LibU bits and
optionally test them:

$ makl
$ makl -C test

And finally install it:

$ su
Password: ****

makl install

== Hello LibU ! ==

You now are ready to play with your first LibU program:

$ cat main.c
#include <u/libu.h>

int facility = LOG_LOCAL0;

int main (void)
{
u_con(“Hello LibU world !”);
return 0;
}

Write a Makefile like the following:

$ cat Makefile
include common.mk

PROG = hellolibu
SRCS = main.c

LDADD += /path/to/install/prefix/lib/libu.a
CFLAGS += -I/path/to/install/prefix/include

include prog.mk

Then type:

$ makl && ./hellolibu

and enjoy !