djanderson / toyproxy

A simple caching HTTP-only webproxy supporting HTTP/1.1.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Toyproxy - Simple HTTP Web Proxy Travis CI Build Status

A simple caching HTTP-only webproxy supporting HTTP/1.1. This project was written for ECEN 5273 - Network Systems at the University of Colorado - Boulder. This is a toy project and shouldn't be used for anything serious, but was the first C project I ever wrote that got big enough to where I needed unit tests to keep from getting overwhelmed.

Quickstart

$ mkdir build
$ cd build
$ cmake ../
$ make && make test
$ ./src/toyproxy 10000  # start on port 10000

Use --debug flag to enable debug output.

Implementation and file layout

Toyproxy is a multithreaded HTTP proxy that implements a subset of HTTP/1.1. It includes a custom written url parser and hashmap caching implementation with unit tests. Request and response parsing is also unit tested. It implements multiple simultaneous requests, user-definable cache timeout, page and hostname caching, and URL and IP blacklisting.

Directories:

  • src - The toyproxy source files
  • vendor - Files for Unity, a small C unit testing framework
  • tests - Unit tests for several of the fundamental data structures and parsing routines

Implementation Files:

  • toyproxy.c - "Configuration" defines (CACHE_ROOT, BLACKLIST_FILE, KEEPALIVE_TIMEOUT, ...), main function, proxy main loop, socket connection handling, etc
  • url.h - Url struct and related functions header
  • url.c - Url struct and related functions implementation
  • hashmap.h - Hashmap struct and related functions header
  • hashmap.c - Hashmap struct and related functions implementation
  • request.h - Request struct and related functions header
  • request.c - Request struct and related functions implementation
  • response.h - Response struct and related functions header
  • response.c - Response struct and related functions implementation
  • printl.h - Printk-like logging function header
  • printl.c - Printk-like logging function implementation
  • queue.h - Thread-safe FIFO queue header (not currently used)
  • queue.c - Thread-safe FIFO queue implementation (not currently used)

Licence

Copyright 2018 Douglas Anderson douglas.anderson-1@colorado.edu. Released under GPL 3.

About

A simple caching HTTP-only webproxy supporting HTTP/1.1.

License:GNU General Public License v3.0


Languages

Language:C 96.3%Language:CMake 2.1%Language:C++ 1.5%Language:Shell 0.1%