CNT 4704: Computer Communication Networks

Fall 2009

Home                      Lecture notes                        Assignment

Programming Assignment 1: TCP Client and Server implementation

(Due: Oct. 6th via webcourse)

In this programming assignment, you will implement a client process on Olympus.cc.ucf.edu server  and a server process on olympus.eecs.ucf.edu server to communicate with each other. The client and server will accomplish some very simple application-layer functions similar to HTTP. If you never log in to Olympus.eecs.ucf.edu, your account should has the usual NID as your username and default password (Pyymmdd) with your birth year, month and day.

Your client operates by sending TRANSLATE, GET, STORE, and EXIT commands to the server. You should create a single client that is able to send any of the four commands above.  If the client sends an invalid command, the server should respond by sending back a message "400 Command not valid."

When you submit this assignment to me, please submit the following (put in a .zip file):

• A brief report: write a brief description of your program codes, then copy the screen output of your client screen and server screen to the report.
• Client source code and server source code.
• Submit the executable client code and server code, too. The programs should be compiled and has been tested by you on each of the olympus machine. I will download and run your code on those two olympus machine by myself! Be sure to tell me which one is running on which olympus machine.
  

In the following, I will explain the details of commands that you need to implement.

Initially, when the server accepts the connection from a client, the server should display "server: got connection from client x.x.x.x" where x.x.x.x is the IP address of the client. It should also reply client with the message "Server is ready..." and be displayed at the client side.

TRANSLATE

This command requires the server process to translate the ASCII text sent from the client process to be in all upper-letter text and return back to the client process. The ASCII text sent from the client is ended with "." in the last line (similar as in the SMTP protocol). The server should reply "200 OK" and then return back the upper-letter text to the client. A client-server interaction looks like (shown at the client side):

c: TRANSLATE
s: 200 OK
c: Hello.
c: Nice to meet you!
c: .
s: HELLO.
s: NICE TO MEET YOU!

At the server side, the server process should display "x.x.x.x sends TRANSLATE" when receiving this command. For all other commands, the server should also do this kind of display.

GET

This command asks the server to return back the text string saved in the buffer of the server process. When your server receives a GET command from a client, it should return the string "200 OK" (terminated with a newline), followed by the text. A client-server interaction with this command thus looks like (suppose the server's buffer contains a text "I don't think we're in Kansas anymore."):

c: GET
s: 200 OK
   I don't think we're in Kansas anymore.
 

STORE

This command asks the server to store the text string that input from the client. When the server receives the STORE command from a client, it should return the acknowledgement "200 OK" (terminated with a newline) and then wait for client's input. The client input text is ended by "." after the last line of text (the saved string should not contain this ending line of ".").  After saving the text, the server should return back the code "200 OK".

A client-server interaction with this command thus looks like:

c: STORE
s: 200 OK
c: One small step for man, one giant leap for mankind
c: Read my lips, no new taxes
c: .
s: 200 OK

EXIT

This command close the client program and inform the server to close, too. After receiving this command, the server should respond the acknowledgement "200 OK" to the client, display the "x.x.x.x sends EXIT", then close itself.

A client-server interaction thus looks like:

c: EXIT
s: 200 OK
 
 
Programming in C

For a detailed tutorial of C socket programming, see http://beej.us/guide/bgnet/. 

Programming notes

Here are a few tips to help you with the assignment:

• On olympus.cc.ucf.edu, use this command line to compile your program to generate the executable file (suppose your server code is named as "server.c"):

        gcc -o server server.c -lxnet
        On the other hand, you do not need to use the option "-lxnet" when compiling on olympus.eecs.ucf.edu  server.

• You must chose a server port number great that 1023 (to be safe, choose a server port number larger than 5000). If you choose a port that is using currently by another user's server program, you have to choose another port.
• I suggest that everyone begin by writing a simple client and server programs that can setup connection with each other, then add the code of those commands.  Finally, write a concurrent server, if you want to do the extra credit portion of the assignment.
• In writing your code, make sure to check for an error return from your system calls or method invocations, and display an appropriate message. This will help you to know which part of your code has error (putting "printf()" after many API functions is a good practice for debugging!!)
• Make sure you close every socket that you use in your program. If you abort your program, the socket may still hang around and the next time you try and bind a new socket to the port ID you previously used (but never closed), you may get an error "Address already in use". If this happens, you have to wait a minute or so to let the hanging socket time out, or use a different port number. 
• Be aware that port ID's, when bound to sockets, are system-wide values and thus other students may be using the  port number you are trying to use.

For extra credit, rewrite your server to be a concurrent server - a server that waits on the welcoming socket and then creates a new thread or process to handle the incoming request (the fork() system call). With this concurrent server, you can open and close your client code as many times as you want.