https://github.com/i5-650/client-server
Client-server project for school
https://github.com/i5-650/client-server
c clang client-server school-assignment
Last synced: 2 months ago
JSON representation
Client-server project for school
- Host: GitHub
- URL: https://github.com/i5-650/client-server
- Owner: i5-650
- Created: 2022-10-24T06:30:01.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-31T23:33:20.000Z (8 months ago)
- Last Synced: 2025-01-05T16:09:49.891Z (4 months ago)
- Topics: c, clang, client-server, school-assignment
- Language: C
- Homepage:
- Size: 983 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# client-server
Client-server project for school. We recommand you to read the full README.md file before running or compiling the code.
## What's possible now ?
- Send a message to the server and receive it back
- Send your name or a choosen name to the server and receive it back
- Send an array of colors to the server and have it saved
- Send the informations about an image and save those informations on the server.
- Send multiple tags, up to 30, to the server and have them saved
- The server can handle multiple clients at the same time, up to 9 for now.
- Somes operations are possible such as: addition, substraction, division, multiplication, minimun, maximum, average and variance.
- The server handle client disconnections and disappearances.
- The clients handle interruptions, it means that if you `ctrl-c` on the client: it sends a message to the server to inform it that the client is disconnected and the server will handle it.
- Clients and Server communicate with JSON messages.
## The JSON messages
The JSON messages are following a specific format for not single textual informations.
```JSON
{
"code": "msg", // the code is always on exactly 3 characters without capital letters
"values": [3, 1, 2, 3] // the values are always in an array. The first value MUST be the number of values that will be sent. The only exception is the 'cal' code.
}
```
If the message is a single text information, the `value` array will only contain one value: the string sent/received.
### Examples
```JSON
{
"code": "okk",
"values": ["Something saying everything is okay"]
}
```
```JSON
{
"code": "err",
"values": ["Something saying everything what happened"]
}
```
```JSON
{
"code": "msg",
"values": ["Hello World"]
}
```
```JSON
{
"code": "nam",
"values": ["hostname"]
}
```
```JSON
{
"code": "col",
"values": [4, "0xffffff", "0xffffff", "0xffffff", "0xffffff"]
}
```
```JSON
{
"code": "anl",
"values": [4, "0xffffff", "0xffffff", "0xffffff", "0xffffff"]
}
```
```JSON
{
"code": "min",
"values": [4, 10, 11, 12, 13]
}
```
```JSON
{
"code": "max",
"values": [4, 10, 11, 12, 13]
}
```
```JSON
{
"code": "avg",
"values": [4, 10, 11, 12, 13]
}
```
```JSON
{
"code": "ect",
"values": [4, 10, 11, 12, 13]
}
```
```JSON
{
"code": "tag",
"values": [3, "tag1", "tag2", "tag3"]
}
```
### The exception
```JSON
{
"code": "CAL",
"values": ["+", 2.14, 3] // the first value is the operator. The second and third values are the numbers to operate on.
}
```
## Mac and Linux difference
If you are willing to run this code on MacOs, it will work fine. We encountered a problem using semaphores on Mac. Indeed, Mac doesn't support a non-deprecated version of posix semaphores. So we had to use an other version of it, specific to mac.
Do not worry, if you run this code on Linux it will use the posix semaphores.
## Compilation goals
There is 3 compilation goals:
- `make all`, `make`, `make -j`... That will compile the server and the client with debug options. If you just want to try the code, use this one.
- `make testes`: This goal will compile __every__ `.c` files and remove the main function from `client.c` and `serveur.c` to make the code testable. It will also compile the tests files. If you want to unitary test the code, use this one.
- `make release`: This goal will compile the server and the client without debug options. If you want to run the code on a server, use this one. There is no tests in this goal and flags to make the code faster.
## Running and usefull goals
- `make tests` will run the tests. If you want to run the tests, use this one.
- `make clean` will remove all the `.o`, `.out` and `.txt` files in the project.