a1batross
/
kore
forked from mirrors/kore
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
1,144 Commits 5 Branches 0 Tags 4.4 MiB
C 98.6%
Makefile 1%
Shell 0.4%
Go to file
Joris Vink b3a48f3c15 Let http_request_limit matter. 
Before http_request_limit just constrained the number of HTTP
requests we'd deal with in a single http_process_requests() call.

But it should really mean how many maximum HTTP requests are allowed
to be alive in the worker process before we start sending 503s back.

While here, drop the lock timeout for a worker to 100ms down from 500ms
and do not allow a worker to grab the accept lock if their HTTP request
queue is full.

This makes things much more pleasant memory wise as the http_request_pool
won't just grow over time.
 		2018-02-13 11:56:51 +01:00
conf Allow param blocks to be marked as "querystring" 2018-01-16 18:47:50 +01:00
examples 2018 2018-01-20 22:51:06 +01:00
includes Let http_request_limit matter. 2018-02-13 11:56:51 +01:00
kodev no need for -rdynamic in kodev. 2017-02-22 13:01:53 -08:00
src Let http_request_limit matter. 2018-02-13 11:56:51 +01:00
.gitignore Ignored .lvimrc and prior vim stale files if there 2016-07-09 12:27:01 +02:00
.travis.yml Updated .travis.yml to use new container-based infrastructure. 2015-10-18 14:26:44 +02:00
LICENSE update copyright year 2017-01-18 10:27:40 +01:00
Makefile make sure FEATURES_INC hits kore.features. 2017-08-30 12:03:58 +02:00
README.md reword 2018-02-05 15:21:28 +00: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 HTTP/1.1
  • Websocket support
  • Privseps by default
  • TLS enabled by default
  • Lightweight background tasks
  • Built-in parameter validation
  • Built-in asynchronous PostgreSQL support
  • Optional support for page handlers in Python
  • Private keys isolated in separate process (RSA and ECDSA)
  • Default sane TLS ciphersuites (PFS in all major browsers)
  • Modules can be reloaded on-the-fly, even while serving content
  • Event driven (epoll/kqueue) architecture with per CPU worker processes
  • Build your web application as a precompiled dynamic library or single binary

License

  • Kore is licensed under the ISC license

Documentation

Read the documentation

Platforms supported

  • Linux
  • OpenBSD
  • FreeBSD
  • OSX

Building Kore

Grab the latest release tarball or clone the repository.

Requirements

  • openssl (1.0.2k or 1.1.0e) (note: this requirement drops away when building with NOTLS=1 NOHTTP=1) (note: libressl should work as a replacement)

Requirements for background tasks (optional)

  • pthreads

Requirements for pgsql (optional)

  • libpq

Requirements for python (optional)

  • Python 3.6+

Normal compilation and installation:

$ 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 TLS)
  • NOHTTP=1 (compiles Kore without HTTP support)
  • NOOPT=1 (disable compiler optimizations)
  • JSONRPC=1 (compiles in JSONRPC support)
  • PYTHON=1 (compiles in the Python support)

Note that certain build flavors cannot be mixed together and you will just be met with compilation errors.

Example applications

You can find example applications under examples/.

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

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/