Go to file
Joris Vink e95d9cc88e Bump HTTP_MAX_QUERY_ARGS to 20. 2015-07-31 15:29:16 +02:00
conf Add task_threads configuration option. 2015-06-04 10:29:22 +02:00
examples Update message framework with src/dst for workers. 2015-07-06 21:08:36 +02:00
includes Bump HTTP_MAX_QUERY_ARGS to 20. 2015-07-31 15:29:16 +02:00
src Always correctly add websocket frame length. 2015-07-16 06:55:44 +02:00
.gitignore Ignore DSYM on osx 2014-04-12 18:49:32 +02:00
.travis.yml travis 2015-05-13 09:40:52 +02:00
LICENSE Bump copyright to 2015 2015-04-07 13:08:26 +02:00
Makefile Don't link object files if not needed 2015-07-25 19:10:48 +02:00
README.md Call it NOTLS instead. 2015-05-25 09:42:34 -04:00

README.md

About

Build Status

Kore (https://kore.io) is an easy to use web application framework for writing scalable web APIs in C. Its main goals are security, scalability and allowing rapid development and deployment of such APIs.

Because of this Kore is an ideal candidate for building robust, scalable and secure web things.

Features

  • Supports SNI
  • Supports SPDY/3.1
  • Supports HTTP/1.1
  • Websocket support
  • Lightweight background tasks
  • Built-in parameter validation
  • Only HTTPS connections allowed
  • Multiple modules can be loaded at once
  • Built-in asynchronous PostgreSQL support
  • Default sane TLS ciphersuites (PFS in all major browsers)
  • Load your web application as a precompiled dynamic library
  • Modules can be reloaded on-the-fly, even while serving content
  • Event driven (epoll/kqueue) architecture with per CPU core workers

License

  • Kore is licensed under the ISC license

Platforms supported

  • Linux
  • OpenBSD
  • FreeBSD
  • OSX

See https://kore.io/doc/#requirements for more information.

Latest release

Old releases

Building Kore

Requirements

  • libz
  • openssl >= 1.0.1i

Requirements for background tasks (optional)

  • pthreads

Requirements for pgsql (optional)

  • libpq

Normal compilation and installation:

# git clone https://github.com/jorisvink/kore.git
# cd kore
# make
# make install

If you would like to build a specific flavor, you can enable those by setting a shell environment variable before running make.

  • TASKS=1 (compiles in task support)
  • PGSQL=1 (compiles in pgsql support)
  • DEBUG=1 (enables use of -d for debug)
  • NOTLS=1 (compiles Kore without OpenSSL)
  • KORE_PEDANTIC_MALLOC=1 (zero all allocated memory)

Example libraries

You can find example libraries under examples/.

The examples contain a README file with instructions on how to build or use them.

I apologize for unclear examples or documentation, I am working on improving those.

Bugs, contributions and more

If you run into any bugs, have suggestions or patches please contact me at joris@coders.se.

More information can be found on https://kore.io/