$24
Assignment 1 - Introduction to Socket Programming Solution
1 Purpose
To gain experience with basic socket programming, sending and receiving TCP and UDP packets.
2 Problem
Implement a simple message board server and client. The message server will store all client messages, and, upon request send those messages to a client. First, the server and client will negotiate, using TCP, a port over which all other communications will take place. Then, the server will send all of its stored messages, over UDP, to the client who will display them. Next, the client will send its own message (think of it as a reply) to the server---who will add this message to its list of stored messages.
2.1 Specifications
Client-server communication should happen as follows:
Server and client negotiate, over TCP, a communications port.
The client creates a TCP socket and connects to the server.
The client sends a message to the server containing a numerical code (req_code).
The server receives the message from the client and verifies that the req_code is valid.
if the req_code is invalid, the server should reply to the client “0”, and the client should terminate with an error “Invalid req_code.”
The server sends the client a message with a port number, which will be used for communication.
Retrieving the stored messages from the server.
The client sends a message “GET”, over UDP, to the server. i. Note that this message should not be displayed.
The server should then send all stored messages over UDP to the client.
When there are no more messages, the server sends “NO MSG.”, over UDP, to the client.
The client will display each message on its own line.
Adding a message to the server.
The client sends its text message, over UDP, to the server.
The server stores this message as:
[CLIENTPORT]: <msg
Where CLIENTPORT is the port used by the client to send the message.
If the client sends the message “TERMINATE”, the server shuts down.
The client waits for keyboard input before exiting.
2.2 Message Server
Implement a program, named server, which will be the message server. The server requires a single parameter, req_code, which is used to validate clients attempting to connect. When the server starts, it must print out the negotiation port number, <n_port, in the following format:
SERVER_PORT=<n_port
For example, if the negotiation port of the server is 65535, then the server should print:
SERVER_PORT=65535
The server must accept multiple, concurrent connections. It must also store all of the messages received from every client. Each client message should be stored in the following format:
[CLIENT_PORT]: <msg
The server should send these messages to a client if the client sends the message “GET”. If there are no stored messages, or, after all message have been sent, the server sends “NO MSG.” to the client. The server should terminate if any client sends “TERMINATE” as a <msg.
2.3 Client
Implement a program, client, which will send and receive messages from the message server.
There are four parameters: <server_address, <n_port, <req_code, and <msg in that order.
client <server_address <n_port <req_code <msg
<server_address is the address of the server, <n_port is the negotiation port selected by the server and described above, <req_code is the validation code, and <msg is the message to send to the server.
The client should receive messages from the server after sending the “GET” command and then print the received messages, one per line. Afterward, the client should send <msg to the server and shutdown. If <msg == TERMINATE, the server should shut down.
2.4 Example Execution
Two shell scripts named server.shand client.share provided. Modify them according to your choice of programming language. You should execute these scripts which will then call your client and server programs.
Server
./server.sh <req_code
Client
./client.sh <server address <n_port <req_code ‘Hello!’
Below is the output for a three client example (done in Java). Note that only the client is shown.
Hints
You can use the Java sample code provided in the Module 2 slides (pages 92-112).
Use ports greater than 1024, since [0,1023] are reserved.
If you are experiencing difficulties establishing a connection, check for firewalls---the port may be blocked, etc.
The server must be running before starting the client.
If server and clients are running on the same system, 127.0.0.1 or localhost may be used as the address.
You may use guides, books, etc., so long as you cite your sources appropriately.
You may NOT work in groups or share your code.
If your code is not readable or documented, you WILL lose marks.
4 Hand-in Instructions
Submit all your files in a single compressed file (.zip, .tar, etc.) using LEARN, in the dedicated
Dropbox. You must hand in the following files/documents:
all source code files
Makefile (your code must compile and link by typing makeor gmake)
README file containing compile and runtime instructions
Modified server/client.sh scripts
Your implementation will be tested on the undergrad environment machines. Please compile and test your code on these machines prior to submission.
4.1 Late Policy
10% penalty for each day (24hrs) late up to a maximum of 3 days. Submissions will not be accepted beyond 3 late days.
5 Evaluation
Client and server compile and run.
Server and one client on same machine. Incorrect <req_code.
Server and one client.
Client 1 Message: ‘TERMINATE’
Server: shuts down/terminates.
Server and one client on the same machine.
Client 1 Message: ‘Hello!’
Server and two clients on the same machine. Second client is started after the first client shuts down.
Client 1 Message: ‘Hello!’
Client 2 Message: ‘TERMINATE’
Server: shuts down/terminates.
Server and two clients on the same machine. Clients alive at the same time.
Client 1 Message: ‘Hello!’
Client 2 Message: ‘TERMINATE’
Server: shuts down/terminates.
Server and one client on different machines.
Client 1 Message: ‘TERMINATE’
Server: shuts down/terminates.
Server and two clients on different machines. Second client is started after the first client shuts down.
Client 1 Message: ‘Hello!’
Client 2 Message: ‘TERMINATE’
Server: shuts down/terminates.
Server and two clients on different machines. Clients alive at the same time.
Client 1 Message: ‘Hello!’
Client 2 Message: ‘TERMINATE’
Server: shuts down/terminates.
Server and four clients on different machines. Clients alive at the same time.
Client 1 Message: ‘Hello!’
Client 2 Message: ‘How are you?’
Client 3 Message: ‘Thank Mr. Goose.’
Client 4 Message: ‘TERMINATE’
Server: shuts down/terminates.
Code style/documentation
Total (out of 10):
Expected Output
If there are no messages stored on the server:
NO MSG.
If there are messages stored on the server (messages can be in any order, except for NO MSG.):
[some port]: message
…
NO MSG.
The client sending ‘TERMINATE’will be started after all other clients.
Comments:
