tiwareep/project-1

project 1 for networked and distributed computing

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

README

Description: This file serves as a README and documentation for CP1 starter.

Authors: Athula Balachandran [email protected],

Wolf Richter [email protected]

Eugene Bagdasaryan [email protected]

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

[TOC-1] Table of Contents

    [TOC-1] Table of Contents
    [DES-2] Description of Files
    [RUN-3] How to Run

[DES-2] Description of Files

Here is a listing of all files associated with Recitation 1 and what their' purpose is:

                .../README                  - Current document 
                .../src/echo_client.c       - Simple echo network client
                .../src/echo_server.c       - Simple echo network server
                .../src/Makefile            - Contains rules for make
                .../src/cp1_checker.py      - Python test script for CP1

[RUN-3] How to Run

Building and executing the echo code should be very simple:

                cd src
                make
                ./echo_server
                ./echo_client localhost 9999

This should allow you to input characters on stdin which will be sent to the echo server. The echo server has a hard-coded serving port of 9999. Any input characters to stdin will be flushed to the server on return, and any bytes received from the server will appear on stdout.

In addition, a telnet client may also be used in a similar fashion for communicating with the server:

                cd src
                make
                ./echo_server
                telnet localhost 9999

The test Python script takes a series of arguments and can be run as:

                cd src
                make
                ./echo_server
                ./cp1_checker 127.0.0.1 9999 1000 10 2048 500

with arguments as such:

                <ip> <port> <# trials> <# writes and reads per trial> \
                <max # bytes to write at a time> <# connections>