Teapot

A lightweight, event-driven HTTP server written in C for Linux. Built as an educational project to explore high-performance network programming with non-blocking I/O and epoll.

Features

• Single-threaded event loop built on Linux epoll
• Non-blocking sockets with edge-triggered events
• Incremental HTTP/1.1 request parser
• Per-connection read and write buffers backed by a dynamic buffer
• Keep-alive connection handling
• Simple leveled logging module

Project Structure

src/
├── main.c               # Entry point
├── core/
│   ├── event.c          # Epoll-based event loop
│   ├── log.c            # Logging utilities
│   └── rb.c             # dynamic buffer
├── http/
│   ├── server.c         # Server setup and connection handling
│   └── sock.c           # Socket helpers
└── parser/
    └── http_parser.c    # HTTP request parser

Requirements

• Linux (epoll required)
• GCC
• Make

Building

make

Running

make run