Proxy

Proxy Lab #

Contents #

  • Files downloaded from CS:APP website as proxylab-handout.tar, and listed below in the original README contents

Lab Assignment Write-Up #

csapp.cs.cmu.edu/3e/proxylab.pdf.

This write-up is pretty helpful for even those doing self-study. Read through it to learn how to approach this lab’s problem.

Original README.md #

This section is copied from csapp.cs.cmu.edu/3e/README-proxylab. It was modified only to conform to standard Markdown formatting.

It is not particularly useful for people doing self-study, but is reproduced here anyway.

#####################################################################

CS:APP Proxy Lab #

Directions to Instructors #

#

Copyright (c) 2004-2016, R. Bryant and D. O’Hallaron, All rights reserved. #

######################################################################

1. Overview #

In this lab, students build a simple concurrent caching Web proxy that accepts HTTP 1.0 requests from clients, forwards them to end servers, and then sends the replies back to the clients. The proxy caches objects returned by the end servers, and attempts to satisfy requests from clients from the cache before forwarding the requests to the end servers.

2. Files #

  • Makefile Builds the entire lab
  • README This file
  • proxylab-handout/ Handout directory that goes to the students. Regenerated from src/
  • src/ Source code for the solution and the driver
  • writeup/ Latex lab writeup
  • grade/ Grading directory where instructors/TAs run the autograder

3. Building the Lab #

Step 1: Modify the Latex writeup in writeup to reflect the handout and handin instructions for your site.

Step 2: Type “make clean; make” to format the writeup in writeup/proxylab.pdf and to build the proxylab-handout.tar file.

Step 3: Distribute proxylab.pdf and proxylab-handout.tar to the students.

4. Grading the Lab #

Autograding scripts are available in the grade/ directory. See grade/README for details.

When we offer this lab at CMU, we do some additional manual grading:

  • Manually test on four real sites (see writeup/proxylab.tex for details)
  • Manually grade for Style
  • Manually check for errors that the autograder doesn’t check for, such as race conditions on shared data structures.

5. Solutions #

The reference solution is in ./src/proxy.[ch] and ./src/cache.[ch]