Home

libonion is a lightweight library to help you create webservers in C programming language. These webservers may be a web application, a means of expanding your own application to give it web functionality or even a fully featured webserver.

The user can create new handlers that serve reading data from a file or creating them. However, there are many default handlers included to address the most frequently required needs.

The name libonion comes from the idea that the path transversal is being done using many layers of handlers: on one layer you set the auth control, on another you check the server hostname (so that you could have virtual hosts) and on yet another a regular expression sends you across to one or another path... Check on examples for how to do it.

Documentation

Full API is described at http://coralbits.com/staticc/libonion/html/index.html . On this wiki there are some recipes on how to use different parts of the API.

If you plan to learn on how to use libonion, first scan through this wiki not centering on the details but on general ideas, then go through the examples and when information on specific functions/structures is needed go to the API documentation.

Features

• Lightweight C library to add a webserver to an existing program, thought to be ABI compatible.
• Provides everything necessary to add full webserver functionality.
• ARM support
• SSL support via gnutls (http://www.gnu.org/software/gnutls/).
• I18N support
• Session support
• Pthread support
• PAM support
• Templating system based on Django's
• Keep-Alive via Content-Length and Chunk encoding.
• HTTP methods: GET, POST, file upload support
• Console, syslog or custom logging.
• IPv4 and IPv6 support.
• Compile Run Loop Development helper: acts like instantaneus apply of source code modification to your web server.

Current usage

libonion is currently being used on ARM projects and comes with several quite usefull example programs.

License

libonion is licensed under AGPLv3. This allows to use it on any AGPL project. If you need libonion for a project that does not fit this license, please check at http://www.coralbits.com, as a commercial license is also available.

Contact

Feel free to contact us at info@coralbits.com, or use the Issue tracker at github.