smol_http

A simple http server supporting GET requests. Written in less than 400 lines of C.
Log | Files | Refs | README | LICENSE

README (1119B)

      1 smol_http
      2 =========
      3 A simple http server supporting GET requests. Written in less than 400 lines of
      4 C.
      5 
      6 Usage
      7 -----
      8 
      9 Clone this repository and compile the software.
     10 
     11 	git clone https://github.com/0xc1f1/smol_http
     12 	cd smol_http
     13 	make
     14 	make install # This will install smol_http to /usr/bin
     15 
     16 The applications default values can be configured via changing the values in
     17 the config.h file and recompiling the application.
     18 
     19 It is also possible to change values using the command line arguments
     20 
     21 	-p port
     22 
     23 	-d root directory
     24 
     25 Security
     26 --------
     27 
     28 The application is a seteuid binary and must not be ran as root but instead
     29 should be ran as a low privilege user that the application will later drop
     30 privileges to.
     31 
     32 smol_http uses unveil and pledge to limit its privileges. Pledge and unveil are
     33 enabled should it be compiled on a OpenBSD or SerenityOS machine.
     34 
     35 Attribution
     36 -----------
     37 
     38 Attribution is under no circumstance required. Read LICENSE for more
     39 information. But if you use this project I would not mind attribution and/or
     40 you sending me a mail at anton@kling.gg just so that I can see people are using
     41 my project(s).