Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fumiama/simple-http-server
A variant of Tinyhttpd.
https://github.com/fumiama/simple-http-server
cgi http http-server http1-0 httpd tinyhttp tinyhttpd
Last synced: 16 days ago
JSON representation
A variant of Tinyhttpd.
- Host: GitHub
- URL: https://github.com/fumiama/simple-http-server
- Owner: fumiama
- License: mit
- Created: 2021-06-07T06:04:46.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-02T15:03:30.000Z (6 months ago)
- Last Synced: 2024-06-02T16:54:45.439Z (6 months ago)
- Topics: cgi, http, http-server, http1-0, httpd, tinyhttp, tinyhttpd
- Language: C
- Homepage:
- Size: 190 KB
- Stars: 9
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
simple-http-server
A variant of Tinyhttpd.
> Created November 1999 by J. David Blackstone.
>
> Optimized June 2021 by Fumiama(源文雨)
## Protocol
A necessary subset of `HTTP 1.0` with following options of request header being supported.
### From client
- Content-Length
### From server
- Content-Length
- Content-Type (only support text/plain image/x-icon text/css text/html)
- Server
### Code
- 200 OK
- 400 BAD REQUEST
- 403 Forbidden
- 404 NOT FOUND
- 500 Internal Server Error
- 501 Method Not Implemented
## Features
1. Serve files
2. CGI
3. Listen on `ipv6`
4. Listen on unix socket
5. Multi-thread
## Compile
```bash
git clone https://github.com/fumiama/simple-http-server.git
cd simple-http-server
mkdir build
cd build
cmake ..
make
make install
```
## Command line usage
```bash
simple-http-server [-d] [-h] [-n host.name.com:port] [-p ] [-q 16] [-r ] [-u ]
```
- **-d**: run as daemon.
- **-h**: display this help.
- **-n**: check hostname and port.
- **-p**: if not set, we will choose a random port.
- **-q**: listen queue length (defalut is 16).
- **-r**: http root dir.
- **-u**: run as this uid.
## CGI usage
When you put an executable file into the web path, the server will call `execl` to run it while passing 3 parameters as below
```c
argv[0] = path; //Path of the executable file
argv[1] = method; //request method (GET/POST)
argv[2] = query_string; //the query string, like "a=1&b=2&c=3"
```
The server will read a `4 bytes` unsigned integer from pipe, indicating the `length` of the remaining content. Then it will send `length` bytes of data to the client directly with nothing being decorated, which means that you need to assemble the HTTP header by yourself.
Here is a CGI example [CMoe-Counter](https://github.com/fumiama/CMoe-Counter)
And its realization is here:
## Appendix
### 4096 Threads Pressure Test Video
https://user-images.githubusercontent.com/41315874/223675866-3536d0ba-3400-46f4-9431-795f133cb94b.mp4