Serves html with html templates over HTTP/1.1.
Find a file
Stephen Seo 30e0753ba8
All checks were successful
Run Unit Tests / build-and-run-unit-tests (push) Successful in 7s
CI: Run unit tests on Release build as well
2024-09-11 13:20:21 +09:00
.forgejo/workflows CI: Run unit tests on Release build as well 2024-09-11 13:20:21 +09:00
example_config Add support for different error responses 2024-09-06 15:55:21 +09:00
src Cleanup: removed unused pointer in internal struct 2024-09-10 21:44:10 +09:00
third_party Update third-party submodule SimpleArchiver 2024-09-11 12:49:01 +09:00
.gitignore Add CMakeLists.txt, update .gitignore 2024-09-06 13:24:28 +09:00
.gitmodules Add third_party SimpleArchiver (data structures) 2024-08-30 11:58:11 +09:00
CMakeLists.txt Revert "Update CMakeLists.txt" 2024-09-11 13:03:15 +09:00
LICENSE Add the ISC LICENSE 2024-08-29 16:09:19 +09:00
Makefile Update Makefile 2024-09-11 13:11:55 +09:00
README.md Update README.md 2024-09-10 14:00:57 +09:00

C Simple HTTP

A simple HTTP/1.1 server written in C.

Usage

Usage:
  -p <port> | --port <port>
  --config=<config_file>
  --disable-peer-addr-print
  --req-header-to-print=<header> (can be used multiple times)
    For example: --req-header-to-print=User-Agent
    Note that this option is case-insensitive
  --enable-reload-config-on-change

Before Compiling

Make sure that the git submodule(s) are loaded:

git submodule update --init --recursive --depth=1 --no-single-branch

Without this, the project will fail to build.

Example

# Build the project.
make c_simple_http

# Alternatively, build with cmake.
cmake -S . -B buildDebug && make -C buildDebug

# Run it with the example config.
# Note that the example config was designed such that it must be referred
# to from its parent directory.
./c_simple_http --config=example_config/example.config
# If built with cmake:
./buildDebug/c_simple_http --config=example_config/example.config

# If port is not specified, the server picks a random port.
# This program should print which TCP port it is listening on.
# Sometimes the program will fail to rebind to the same port due to how TCP
# works. Either wait some time or choose a different port.

# Access the website.
# This assumes the server is hosted on port 3000.
curl localhost:3000

Other Notes

The config file can be reloaded if the program receives the SIGUSR1 signal.
The --enable-reload-config-on-change option automatically reloads the config file if the config file has changed.