cserv

cserv is an event-driven and non-blocking web server. It ideally has one worker process per cpu or processor core, and each one is capable of handling thousands of incoming network connections per worker. There is no need to create new threads or processes for each connection.

I/O multiplexing is achieved using epoll.

Features

Single-threaded, non-blocking I/O based on event-driven model
Multi-core support with processor affinity
Implement load balancing among processes
Hook and optimize blocking socket system calls
Facilitate coroutines for fast task switching
Efficient timeout handling
Builtin memcache service

High-level Design

Process Model

    master process <-----> worker processes

                    +--- non-blocking, event-driven processing engine ---+
                    |                                                    |
    TCP traffic --> | HTTP state machine <-+--> static content           |
                    |                      |                             |
                    |                      +--> cache                    |
                    |                      |                             |
                    |                      \--> logger                   |
                    +----------------------------------------------------+

Build from Source

At the moment, cserv supports Linux based systems with epoll system call. Building cserv is straightforward.

$ make

Usage

Start the web server.

$ ./cserv start

Stop the web server.

$ ./cserv stop

Check the configurations.

$ ./cserv conf

By default the server accepts connections on port 8081, if you want to assign other port for the server, modify file conf/cserv.conf and restart the server.

License

cserv is released under the MIT License. Use of this source code is governed by a MIT License that can be found in the LICENSE file.

idoleat / cserv