CSP2308 Assignment 2
Background:
This is where we separate our program into a client and a server. In Assignment 1 we focused on basic input / output with arrays. Assignment 2 will add network communications (sockets), more robust programming, processes / threads and adding the ability to handle multiple remote clients.
This version of the chat server will run a client and as server. The client will locally, receive requests from the keyboard (console) and either fulfil them locally or, if appropriate, send them to the server. The server will receive data and either act on it or relay this information to all connected clients.
NOTE: Design means Pseudocode, Flowcharts, Functional Decomposition, etc. This is NOT how prettily your code is structured or laid out! Your design will be assessed with how well your design relates to your code and how well both relate to the assignment requirements.
Objectives:
Design and Implement a program that does the following:
The Client:
• Loads and uses mychatclient.conf to set internal variables as mentioned below. o If mychatclient.conf doesn't exist, your program should create it with an appropriate message and code. o If mychatclient.conf isn't readable, your program should terminate gracefully with an appropriate message and code. This is different from the file not existing.
• Once the configuration is loaded, the client should connect to the server. o The client should ask for connection information (e.g.: IP Address of sever) if not provided in the configuration file. o If the client cannot connect to the server, your program should handle this neatly and allow for some recourse.
(ie: retry, change connection details and try again, exit the program, etc) o Once connected, the client should send all relevant connection information that the server requires (ie: username, etc) and should receive all relevant information (ie: servername, etc).
• Takes input from the keyboard. o Input should be buffer-overflow protected o If the input does NOT begin with a / then your client should send this to the server.
o If the input DOES begin with a / then your client should interpret this as a command
? If the command is intended for the client, the client should act on it. The MINIMUM commands should be:
• /name should allow the user to change the displayed username
• /reload should reload the configuration file and reset your program parameters based on what it reads from the configuration file.
• /status should show current details including but not limited to: o Connection details o Current user name o Current server name o Name of the current log file o Any other details you think are useful
• /quit should allow the user to quit. This will require sending a /quit command to the server, having the server close the connection and then allow the client to shutdown gracefully.
? If the command is intended for the server, the client should send it to the server intact.
• /name should allow the user to update the username on the server (There is a client and server portion to this command.)
• /quit should allow the user to quit. This will require sending a command to the server, having the server close the connection
• /servername should allow the user to change the server name • Receives network data and outputs to the screen o All message data from the server should be printed
o Status output should be printed with a different identifier. ie: #
School of Science http://www.ecu.edu.au/schools/science/
The Server:
• Loads and uses mychatserver.conf to set internal variables as mentioned below. o If mychatserver.conf doesn't exist, your program should create it and log an appropriate message and code.
o If mychatserver.conf isn't readable, your program should terminate gracefully while printing AND logging an appropriate message and code. This is different from the file not existing.
• Once the configuration is loaded, the server should begin listening for connections on the defined port (configuration file).
• Accepts network connections and input from clients. o Create a LISTEN socket on 0.0.0.0 (all interfaces) OR on an interface defined in your configuration file o If the input has a header type of 0x1 then you should send this to all connected clients. o If the input has a header type of 0x2 then you should interpret this as a command. The MINIMUM commands should be:
? /name should allow the user to update the displayed username ? /servername should allow the user to change the server name ? /quit should allow the user to close the connection.
• Sends output to the clients o All chat output should be formatted to be preceded with the server and user name (ie: Server1 : Brett ) o Status output should be printed with a different identifier. ie: #
• Your server should have a logging facility. This should be a separate process. o You should check to see if the log file exists.
? If it does, open it and begin logging important messages
? If it does not, create it and begin logging important messages
o Logging will require inter-process communication.
• If the SIGQUIT (3) or SIGTERM (15) signals are received, your program should: o Signal any children still active to terminate
? If the children do not respond in a timely manner, your program should KILL (9) them
o Log an appropriate message to the log file o Close all open files
• If the SIGHUP (1) signal is received (you will have to trap this signal) then o Record the request in the log file o open your programs configuration file o read in the configuration file
o reset your programs parameters based on the configuration you read in o open your log file
o record the final status of the SIGHUP process
o All current socket connections will need to be migrated over to any new network settings
Cryptography:
All network transmissions should be encrypted. This means once you are ready to transmit application data, you will need to call an encryption function before sending it to the other end. This also means that when you receive data, you will need to decrypt the data once you receive it. You will also need to be able to verify that decrypted data has been properly decrypted before use.
For those doing the unit CSI2108 Cryptographic Concepts and wishing to combine your assessment into one work, you will be required to write your own crypto library which will be assessed in that unit.
For those not doing CSI2108 or not wishing to combine your assessments into one working whole, I will be providing you with a binary library and header file so you can link this into your application. It will be a binary library so you will not be able to see the any code, the most you will be able to see is the function headers in the provided header file.
A word of warning:
This assessment is large enough, complicated enough and involves concepts advanced enough that you can easily lose your way.
The standard student approach of “I’ll write the design after I’ve finished the program” will cost you precious time. The design in this assessment is not just another grading point (though there are marks assigned to design to encourage you to do this activity). Design, in this project, serves the purpose it does in all large projects. That is as a means to clarify your logic and act as a roadmap in a complex environment. In short, it is a tool to keep you on track and simplify your task. Ignore your design, or treat is as a trivial task at your peril.
School of Science http://www.ecu.edu.au/schools/science/
Using make to manage (at minimum) these files:
Client:
mychatclient.c
This should contain the main logic of your code
myinput.c
This file could handle all input including safely checking if the input is valid, checks against exploits such as buffer overflows.
myoutput.c
This file could handle all output including all formatting and other output related processing.
mychatclient.conf
This file should be a configuration file that you can use to set the behaviour of your main program.
This should at minimum have Username, Logfile name, , Default IP Address for the server to use if unspecified.
Server:
mychatserver.c
This should contain the main logic of your code
mylogger.c
This file should contain any functions that handle logging operations
network.c
This file could handle all network code.
myoutput.c
This file could handle all output including all formatting and other output related processing.
mychatserver.conf
This file should be a configuration file that you can use to set the behaviour of your main program. This should at minimum have Servername, Logfile name, Default server IP Address to connect to.
Feel free to use other files to break up the structure of your program.
Marking Guide
Design 10
Implementation
Use of make and multiple files
Use of configuration files
Correct and appropriate use of sockets
File Functions (file exists/readable, open, read, etc)
Data Protocol implemented correctly
Signals implemented and handled appropriately
Crypto is present and functional 2
2
5
5
2
2
2
Implementation Sub-total 20
Program compiles and runs 10
Extra cool features (additional features)! (Extra Marks) 10
Total (cannot exceed) 40
If you manage this, CONGRATULATIONS! You have made your own (basic) chat system!
School of Science http://www.ecu.edu.au/schools/science/
GET ANSWERS / LIVE CHAT