https://github.com/sysprog21/cserv

An event-driven and non-blocking web server
https://github.com/sysprog21/cserv

Last synced: 6 months ago
JSON representation

An event-driven and non-blocking web server

• Host: GitHub
• URL: https://github.com/sysprog21/cserv
• Owner: sysprog21
• License: mit
• Created: 2021-05-25T01:15:15.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-08-01T03:38:03.000Z (over 2 years ago)
• Last Synced: 2025-05-08T23:54:28.932Z (6 months ago)
• Language: C
• Homepage:
• Size: 65.4 KB
• Stars: 82
• Watchers: 6
• Forks: 27
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 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](http://man7.org/linux/man-pages/man7/epoll.7.html).

## 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

```text

    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.

```shell

$ make

```

## Usage

Start the web server.

```shell

$ ./cserv start

````

Stop the web server.

```shell

$ ./cserv stop

```

Check the configurations.

```shell

$ ./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.