https://github.com/ygor-sena/42cursus-minitalk
The sixth project of 42's curriculum asks students to code a small data exchange program using UNIX signals.
https://github.com/ygor-sena/42cursus-minitalk
42 42cursus 42minitalk 42saopaulo 42school 42sp ansi-c c ecole42 signal-processing
Last synced: 13 days ago
JSON representation
The sixth project of 42's curriculum asks students to code a small data exchange program using UNIX signals.
- Host: GitHub
- URL: https://github.com/ygor-sena/42cursus-minitalk
- Owner: ygor-sena
- License: gpl-3.0
- Created: 2022-09-08T19:21:37.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-04T16:41:42.000Z (over 1 year ago)
- Last Synced: 2025-09-24T04:35:36.794Z (23 days ago)
- Topics: 42, 42cursus, 42minitalk, 42saopaulo, 42school, 42sp, ansi-c, c, ecole42, signal-processing
- Language: C
- Homepage:
- Size: 65.4 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## 📣 Introduction
The purpose of this project is to code a small data exchange program using UNIX signals. Therefore, the communication program between a `client` and a `server` has to be done using **only** UNIX signals. Thus, it was allowed to use only two signals: `SIGUSR1` and `SIGUSR2`.
The `server` should be able to receive strings from several clients in a row without needing to restart. For the bonus project, the `server` also acknowlegdes every message received by sending back a signal to the `client` and supports Unicode characters.
## ⚒️ How to compile and run the project
#### 1) Copy this repository to your local workstation
```html
git clone git@github.com:ygor-sena/42cursus-minitalk.git
```
#### 2) Compile the project with Makefile
```html
make
```
#### 3) Open two instances of the command terminal and, in one of them, launch the `server` program
```html
./server
```
It will print something to the standard output, such as:
```html
Server PID is: 1084.
```
If you want to run the program looking for memory leaks, just start it as follows:
```html
valgrind --leak-check=full --show-leak-kinds=all ./server
```
#### 4) In the other terminal, launch the `client` program
It must receive the following three arguments: the executable program, the server PID and the text to be sent. For example:
```html
./client 1024 "This is an amazing but not so long sentence, minitalk!"
```
#### 5) Usage example
After completing the four steps above, the `server` will receive and print the message from `client`. After the message has been fully printed, the `server` will send a message back to the `client` signaling that data has been successfully received. The `client` will then show the following information:
```html
1084 server PID: data received.
```
To send another message to the `server`, the `client` program must be executed once again.
## 📖 References
- About Unicode characters:
- [The Absolute Minimum Every Software Developer Absolutely, Positively Must Know About Unicode and Character Sets (No Excuses!)](https://www.joelonsoftware.com/2003/10/08/the-absolute-minimum-every-software-developer-absolutely-positively-must-know-about-unicode-and-character-sets-no-excuses/) by Joel Spolsky.
- [Unicode in C and C++: What You Can Do About It Today](https://www.cprogramming.com/tutorial/unicode.html) by Jeff Bezanson.
- [Unicode character table](https://unicode-table.com/en/) searcher to easily get Unicode characters.
- About signals:
- [Introduction To Unix Signals Programming](https://www.cs.kent.edu/~ruttan/sysprog/lectures/signals.html) by [Kent State University](https://www.kent.edu/cs).
- [signal handler sa_sigaction arguments](https://stackoverflow.com/questions/12587621/signal-handler-sa-sigaction-arguments) by StackOverflow.
- [How can I translate from Decimal to binary and send it with sigusr 1-2?](https://stackoverflow.com/c/42network/questions/1919/1920#1920) by 42 Network StackOverflow.
- About bit shift manipulation (**this video is amazing!**):
- [Bit Manipulation](https://www.youtube.com/watch?v=7jkIUgLC29I) by [Make School](https://www.youtube.com/@MakeSchoolCS).
- BRYANT, Randal; O'HALLARON, David. _Computer Systems: a programmer's perspective_. 3rd edition, 2016.
- Source code of the book examples: https://csapp.cs.cmu.edu/3e/code.html