ELKLib

DESCRIPTION

ELKlib is an embeddable library that provides C/C++ support oriented to kernel level development. ELKlib mimics GNU libc and the Standard Template Library.
The library is under heavy development and is not yet usable, from the user point of view.

Features

The library provides the following features:

C Support: The usual functions and macros available from libc are available
C++ Support: STL-like iterators, algorithms, vectors, lists and strings
BFD support (through libiberty): C++ Symbols demangling

Ports

The only available port is for the x86 architecture

USAGE

Installation

ELKlib uses the autoconf/automake facilities. The simplest way to install the package in your system is:

cd to the directory containing the package's source code and type ./configure to configure the package for your system.Running configure might take a while. While running, it prints some messages telling which features it is checking for
Type make to compile the package
Optionally, type make check to run any self-tests that come with the package
Type make install to install the programs and any data files and documentation

Use ./configure --help to get a brief help of all configuration tweaks available.

You can remove the program binaries and object files from the source code directory by typing make clean. To also remove the files that configure created (so you can compile the package for a different architecture), type make distclean.

You can also type make uninstall to remove the installed files.

Note that the --prefix option allows installation using different paths than the default ones, this option enables sandbox installations.

Use

To easily detect the presence of elklib in a host system, the following scripts come handy:

elklib-config

It should be used to list the available ports in the host machine

     Usage: elklib-config [OPTIONS]

     OPTIONS:
          [-h|--help]
	  [--version]
	  [--target-cpus]

elklib-config-<target-cpu>

It should be used to query a port for compilation or linking related flags

     Usage: elklib-config-<target-cpu> [OPTIONS]

     OPTIONS:
          [-h|--help]
	  [--version]
	  [--static-libs]
	  [--cppflags]
	  [--cflags]
	  [--cxxcppflags]
	  [--cxxflags]
	  [--ldflags]

COPYING

ELKlib is licensed under the GNU General Public License, version 2

MAINTAINERS

Francesco Salvestrini <salvestrini AT gmail DOT com>

AUTHORS

Francesco Salvestrini <salvestrini AT gmail DOT com>

RELEASES

Sorry, no public release available at the moment.

MAILING LISTS

ELKlib has a single moderated mailing list, with an archive. In order to post a message to the mailing list you must be subscribed. Please consult the ELKlib mailing list page for more information on subscribing to the mailing list.

REPORT A BUG

If you think you have found a bug in ELKlib then please send as complete a report as possible to <elklib AT nongnu DOT org>. An easy way to collect all the required information, such as platform and compiler, is to include in your report the config.log file available at the end of the configuration procedure.

If you have a patch for a bug in Hybrid that hasn't yet been fixed in the latest repository sources, please be so kind to create it using the repository sources, not the release sources.

DEVELOPMENT

Browsing sources

You can browse the Git repository of this project with your web browser. This gives you a good picture of the current status of the source files. You may also view the complete histories of any file in the repository as well as differences among two versions.

Getting a copy of the Git Repository

Anonymous checkout: git clone git://git.savannah.nongnu.org/elklib.git

Contribute

If you have time and programming skills, you can help us by developing missing features, regression tests or bug-fixing the present codebase. Subscribe to the mailing list, drop us a mail and start coding. Send your code to the mailing list under the form of patches for the current revision system.

If you have time but no programming skills, you can help with documentation, packaging, tests before releases etc ...