https://github.com/joannakonte/multithreaded-network-server
🗳️ A multithreaded server and client system for managing a voting process with thread synchronization and concurrent client handling.
https://github.com/joannakonte/multithreaded-network-server
bash-script multithreading mutexes sockets
Last synced: 10 months ago
JSON representation
🗳️ A multithreaded server and client system for managing a voting process with thread synchronization and concurrent client handling.
- Host: GitHub
- URL: https://github.com/joannakonte/multithreaded-network-server
- Owner: joannakonte
- License: bsd-2-clause
- Created: 2024-11-12T22:39:47.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-20T02:46:31.000Z (about 1 year ago)
- Last Synced: 2025-01-31T01:35:07.114Z (12 months ago)
- Topics: bash-script, multithreading, mutexes, sockets
- Language: C
- Homepage:
- Size: 45.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Multithreaded-Network-Server
### Server
This program implements a multithreaded TCP server for managing a simple voting system. It uses a fixed-capacity buffer as a queue to temporarily store client connections, following a first-in, first-out (FIFO) structure. The master thread adds connections to the rear, while worker threads retrieve them from the front. Synchronization is achieved using with mutexes for locking shared resources and condition variables for signaling when the buffer is full or empty. When a SIGINT signal is received, the server writes sorted voting statistics to a file and terminates safely.
### Batch Client
This multi-threaded client program reads votes from an input file and sends them to a server via independent threads. Each thread establishes a TCP connection, sends the voter's details, and receives confirmation. The ThreadData structure stores relevant information, and threads operate independently, ensuring efficient processing and proper memory deallocation. The program exits after handling all votes.
---
### Usage of Server and Client
Use the `Makefile` to compile, run and clean up the project using the following commands:
```bash
$ make # Compile the 'poller' and 'pollSwayer' executables.
$ make run_poller # Execute the 'poller' program with predefined arguments.
$ make run_swayer # Execute the 'pollSwayer' program with predefined arguments.
$ make clean # Remove object files, executables, and additional files from the directory.
```
### Arguments
**Poller (Server)**
The `poller` server program requires the following arguments:
```bash
./poller [portnum] [numWorkerThreads] [bufferSize] [poll-log] [poll-stats]
```
- **portnum:** Port number the server will use to listen for connections.
- **numWorkerThreads:** Number of worker threads to handle client connections concurrently.
- **bufferSize:** Size of the buffer used to store incoming connections temporarily.
- **poll-log**: File name where the server logs client voting activity.
- **poll-stats:** File name where the server writes sorted voting statistics upon termination.
**PollSwayer (Client)**
The `pollSwayer` client program requires the following arguments:
```bash
./pollSwayer [serverName] [portNum] [input_file]
```
- **serverName:** Hostname of the machine running the poller server.
- **portNum:** Port number the server is listening on (must match the poller server’s port).
- **input_file:** File containing voter information to send to the server.
⚠️ Please note that this project has been tested and validated on Linux systems.
_________________
## Bash Scripts
This project also includes three bash scripts for debugging purposes:
1. **Create Input:**
This bash script generates an `inputFile.txt` containing randomly generated first names, last names, and party affiliations. It takes two arguments: a file with party names and the number of lines to generate. The script validates the input, ensuring the correct number of arguments, the existence and readability of the parties file, a positive integer for the number of lines, and a non-empty parties file. The names generated are random strings (3-12 characters), and parties are randomly selected from the file. A confirmation message is displayed upon successful completion.
2. **Tally Votes:**
This bash script processes an input file to count votes for each party. It validates the file's existence and readability, sorts its contents, removes duplicates, and ensures each individual’s vote is counted only once. The results are written to a specified output file, with party names listed alphabetically alongside their vote counts. A confirmation message is displayed upon successful completion.
3. **Process Log File:**
This bash script processes the file generated by the `poller.c` server, ensuring it exists and is readable. It sorts the file, removes duplicate lines, and counts votes for each party, ensuring only the first vote from each individual is considered. The results are written to a specified output file, with party names listed alphabetically alongside their vote counts. A confirmation message is displayed upon successful completion.
---
### Usage of Bash Scripts
1. Before running one of the bash scripts, make it executable:
```bash
chmod +x name_of_bash.sh
```
Replace `name_of_bash` with the name of the script you want to run.
2. Run the scripts:
**Create Input File:**
```bash
./create_input.sh path_to_parties_file numLines
```
- Replace `path_to_parties_file` with the path to the file containing party names.
- Replace `numLines` with the number of voters (lines) to generate.
**Tally Votes:**
```bash
./tallyVotes.sh output_file
```
- Replace `output_file` with the name of the file where voting results will be saved.
**Process Log File:**
```bash
./processLogFile.sh output_file
```
- Replace `output_file` with the name of the file where the processed log results will be saved.
_________________