- A POSIX-compliant C development environment
- GNU make version 3.81 or later
- skalibs version 2.14.1.1: http://skarnet.org/software/skalibs/
- execline version 2.9.4.0: http://skarnet.org/software/execline/
- s6 version 2.12.0.3: http://skarnet.org/software/s6/
- oblibs version 0.3.0.1: https://git.obarun.org/Obarun/oblibs/
- lowdown version 0.6.4 or later for man and html pages: https://kristaps.bsd.lv/lowdown/
- linux-api-headers 5.8 or later: https://www.gnu.org/software/libc (only for linux system)
This software will install on any operating system that implements POSIX.1-2008, available at opengroup.
./configure && make && sudo make install will work for most users.
It will install the static libraries in /usr/lib/66, the shared libraries in /lib.
Please note that static libraries in /usr/lib/66 will not be found by a default linker invocation: you need -L/usr/lib/66. Other obarun software automatically handles that case if the default configuration is used, but if you change the configuration, remember to use the appropriate --with-lib configure option.
You can strip the libraries of their extra symbols via make strip before the make install phase. It will shave a few bytes off them.
Note: the man and html documentation pages will always be generated if lowdown is installed on your system. However, if you don't ask to build the documentation the final DESTDIR directory will do not contains any documentation at all.
You can customize the installation process via flags given to configure. See ./configure --help for a list of all available configure options.
Controlling a build process via environment variables is a big and dangerous hammer. You should try and pass flags to configure instead; nevertheless, a few standard environment variables are recognized.
If the CC environment variable is set, its value will override compiler detection by configure. The --host=HOST option will still add a HOST- prefix to the value of CC.
The values of CFLAGS, CPPFLAGS and LDFLAGS will be appended to the default flags set by configure. To override those defaults instead of appending to them, use the CPPFLAGS, CFLAGS and LDFLAGS make variables instead of environment variables.
You can invoke make with a few variables for more configuration.
CC, CFLAGS, CPPFLAGS, LDFLAGS, LDLIBS, AR, RANLIB, STRIP, INSTALL and CROSS_COMPILE can all be overridden on the make command line. This is an even bigger hammer than running ./configure with environment variables, so it is advised to only do this when it is the only way of obtaining the behaviour you want.
DESTDIR can be given on the make install command line in order to install to a staging directory.
By default, binaries are linked against static versions of all the libraries they depend on, except for the libc. You can enforce linking against the static libc with --enable-static-libc.
(If you are using a GNU/Linux system, be aware that the GNU libc behaves badly with static linking and produces huge executables, which is why it is not the default. Other libcs are better suited to static linking, for instance musl
skarnet.org packages centralize all the difficulty of cross-compilation in one place: skalibs. Once you have cross-compiled skalibs, the rest is easy.
- Use the --host=HOST option to configure, HOST being the triplet for your target.
- Make sure your cross-toolchain binaries (i.e. prefixed with HOST-) are accessible via your PATH environment variable.
- Make sure to use the correct version of skalibs for your target, and the correct sysdeps directory, making use of the --with-include, --with-lib, --with-dynlib and --with-sysdeps options as necessary.
obarun.org packages do not support out-of-tree builds. They are small, so it does not cost much to duplicate the entire source tree if parallel builds are needed.