first commit

README.md

@@ -0,0 +1,256 @@
+<h1 align="center">PIPEX</h1>
+
+<p align="center">
+  <a href="https://github.com/f-corvaro/PIPEX">
+	<img src="https://github.com/f-corvaro/PIPEX/blob/main/.extra/pipex.png" alt="PIPEX" width="300">
+  </a>
+</p>
+
+<p align="center">
+	<b><i>"Unleash the power of Unix pipelines and redirections with PIPEX - your gateway to system programming."</i></b><br>
+</p>
+<p align="center" style="text-decoration: none;">
+    <a href="https://github.com/f-corvaro/PIPEX/blob/main/.extra/en.subject.pdf"><img alt="subject" src="https://img.shields.io/badge/subject-PIPEX-yellow" /></a>
+    <a href="https://github.com/f-corvaro/PIPEX"><img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/f-corvaro/PIPEX?color=blueviolet" /></a>
+    <a href="https://github.com/f-corvaro/PIPEX"><img alt="Code language count" src="https://img.shields.io/github/languages/count/f-corvaro/PIPEX?color=yellow" /></a>
+    <a href="https://github.com/f-corvaro/PIPEX"><img alt="GitHub top language" src="https://img.shields.io/github/languages/top/f-corvaro/PIPEX?color=blueviolet" /></a>
+    <a href="https://github.com/f-corvaro/PIPEX"><img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/f-corvaro/PIPEX?color=yellow" /></a>
+</p>
+
+<h3 align="center">Index</h3>
+
+<p align="center">
+  <a href="#pipex">PIPEX</a><br>
+  <a href="#index">Index</a><br>
+  <a href="#about">About</a><br>
+  <a href="#folder-structure">Folder Structure</a><br>
+  <a href="#mandatory-part">Mandatory part</a><br>
+  <a href="#the-rules">The rules</a><br>
+  <a href="#bonus-part">Bonus Part</a><br>
+  <a href="#evaluation">Evaluation</a><br>
+  <a href="#correction-sheet">Correction sheet</a><br>
+  <a href="#support-me">Support Me</a><br>
+  <a href="#skills-developed">Skills developed</a><br>
+  <a href="#sources">Sources</a><br>
+  <a href="#license">License</a><br>
+  <a href="#author">Author</a>
+</p>
+<br>
+
+## Folder Structure
+
+<p align="justify">
+
+```
+```
+
+<br>
+
+## About
+
+<p align="justify">
+
+This project aims to create a program in C that mimics the Unix pipeline mechanism, specifically the `|` (pipe) operator. The pipe operator in Unix/Linux is used to chain multiple commands together, where the output of one command serves as input to the next.
+
+In the context of this project, you'll be expected to create a program that can take two commands as input, execute the first command, capture its output, and then provide that output as input to the second command.
+
+<p>
+<br>
+
+**Some rules to keep in mind:**
+
+<p align="justify">
+
+• Your project must be written in C (in accordance with the Norm).
+
+• Your functions should not quit unexpectedly (segmentation fault, bus error, double
+free, etc) apart from undefined behaviors.
+
+• All heap allocated memory space must be properly freed when necessary.
+
+• You must submit a Makefile which will compile your source files to the required output with the flags -Wall, -Wextra and -Werror, use cc, and your Makefile must not relink. And the Makefile must at least contain the rules ```$(NAME), all, clean, fclean and re (bonus if you want maximum score)```.
+
+• If your project allows you to use your libft, you must copy its sources and its
+associated Makefile in a libft folder with its associated Makefile. Your project’s
+Makefile must compile the library by using its Makefile, then compile the project.
+
+•Global variables are forbidden.
+
+<p>
+<br>
+
+### Mandatory part
+
+**Program name:**
+
+<p align="justify">
+
+```pipex``` Which has as arguments 4 elements:
+
+```file1 cmd1 cmd2 file2```
+
+• file1 and file2 -> file names.
+
+• cmd1 and cmd2 -> shell commands with their parameters.
+
+</p>
+<br>
+
+**Files to turn in:**
+
+<p align="justify">
+
+```Makefile, *.h, *.c```
+
+</p>
+<br>
+
+**External functs. allowed:**
+
+<p align="justify">
+
+Libft authorized, and:
+
+```
+1. open, close, read, write,
+malloc, free, perror,
+strerror, access, dup, dup2,
+execve, exit, fork, pipe,
+unlink, wait, waitpid
+
+1. ft_printf and any equivalent YOU coded
+```
+
+</p>
+<br>
+
+***Examples:***
+
+```shell
+$> < file1 cmd1 | cmd2 > file2
+```
+
+```shell
+$> ./pipex infile "ls -l" "wc -l" outfile
+```
+
+Should behave like: ```< infile ls -l | wc -l > outfile```
+
+```shell
+$> ./pipex infile "grep a1" "wc -w" outfile
+```
+
+Should behave like: ```< infile grep a1 | wc -w > outfile```
+
+<p>
+<br>
+
+## The rules
+
+<p align="justify">
+
+The program should handle the errors like the shell command.
+
+<br>
+
+## Bonus Part
+
+<p align="justify">
+
+The bonus part requires to handle multiple pipes, as this example:
+
+```shell
+$> ./pipex file1 cmd1 cmd2 cmd3 ... cmdn file2
+```
+
+Should behave like: ```< file1 cmd1 | cmd2 | cmd3 ... | cmdn > file2```
+
+
+Furthermore, the program needs to support ```«``` and ```»``` when the first parameter is ```"here_doc"```. An example is:
+
+```shell
+$> ./pipex here_doc LIMITER cmd cmd1 file
+```
+
+Should behave like: ```cmd << LIMITER | cmd1 >> file```
+<p>
+
+## Evaluation
+
+
+
+### Correction sheet
+
+<a href="https://github.com/f-corvaro/42.common_core/tree/main/02-pipex"><img width="650" src="https://github.com/f-corvaro/42.common_core/blob/main/02-pipex/.extra/.cs/pipex1.png">
+
+<a href="https://github.com/f-corvaro/42.common_core/tree/main/02-pipex"><img width="650" src="https://github.com/f-corvaro/42.common_core/blob/main/02-pipex/.extra/.cs/pipex2.png">
+
+<a href="https://github.com/f-corvaro/42.common_core/tree/main/02-pipex"><img width="650" src="https://github.com/f-corvaro/42.common_core/blob/main/02-pipex/.extra/.cs/pipex3.png">
+
+<a href="https://github.com/f-corvaro/42.common_core/tree/main/02-pipex"><img width="650" src="https://github.com/f-corvaro/42.common_core/blob/main/02-pipex/.extra/.cs/pipex4.png">
+
+<a href="https://github.com/f-corvaro/42.common_core/tree/main/02-pipex"><img width="650" src="https://github.com/f-corvaro/42.common_core/blob/main/02-pipex/.extra/.cs/pipex5.png">
+
+<a href="https://github.com/f-corvaro/42.common_core/tree/main/02-pipex"><img width="650" src="https://github.com/f-corvaro/42.common_core/blob/main/02-pipex/.extra/.cs/pipex6.png">
+
+</p>
+<br>
+
+## Support Me
+
+<p align="justify">
+Remember to ⭐ the repository.
+If you want to support me:</p>
+
+<p align="center">
+<a href="https://ko-fi.com/fcorvaro"><img width="180" img align="center" src="https://github.com/f-corvaro/42.common_core/blob/main/.extra/support-me-ko-fi.svg"><alt=""></a>
+<a href="https://github.com/sponsors/f-corvaro"><img width="180" img align="center" src="https://github.com/f-corvaro/42.common_core/blob/main/.extra/support-me-github.svg"><alt=""></a>
+
+<br>
+
+## Skills developed
+
+<p align="center">
+  <a href="https://skillicons.dev">
+    <img src="https://skillicons.dev/icons?i=git,c,vim,vscode" />
+  </a>
+</p><br>
+
+## Sources
+
+- [Visualization of a fork call in C](https://www.youtube.com/watch?v=QD9YKSg3wCc&list=PLK4FY1IoDcHG-jUt93Cl7n7XLQDZ0q7Tv).
+
+- [Calling fork multiple times](https://www.youtube.com/watch?v=94URLRsjqMQ&list=PLK4FY1IoDcHG-jUt93Cl7n7XLQDZ0q7Tv&index=2).
+
+- [Practical use case for fork and pipe in C](https://www.youtube.com/watch?v=6u_iPGVkfZ4&list=PLK4FY1IoDcHG-jUt93Cl7n7XLQDZ0q7Tv&index=4).
+
+- [Simulating the pipe "|" operator in C](https://www.youtube.com/watch?v=6xbLgZpOBi8&list=PLK4FY1IoDcHG-jUt93Cl7n7XLQDZ0q7Tv&index=5).
+
+- [Communicating between processes (using pipes) in C](https://www.youtube.com/watch?v=Mqb2dVRe0uo&list=PLK4FY1IoDcHG-jUt93Cl7n7XLQDZ0q7Tv&index=6).
+
+- [Introduction to FIFOs (aka named pipes) in C](https://www.youtube.com/watch?v=2hba3etpoJg&list=PLK4FY1IoDcHG-jUt93Cl7n7XLQDZ0q7Tv&index=7).
+
+- [8 Design Patterns EVERY Developer Should Know](https://www.youtube.com/watch?v=tAuRQs_d9F8&list=PLK4FY1IoDcHG-jUt93Cl7n7XLQDZ0q7Tv&index=8).
+
+- [fd, dup()/dup2() system call tutorial](https://www.youtube.com/watch?v=EqndHT606Tw&list=PLK4FY1IoDcHG-jUt93Cl7n7XLQDZ0q7Tv&index=9).
+
+- []().
+<br>
+
+## License
+<p align="center">
+<a href="https://choosealicense.com/licenses/mit/"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="MIT License"></a>
+<a href="https://opensource.org/licenses/"><img src="https://img.shields.io/badge/License-GPL%20v3-yellow.svg" alt="GPLv3 License"></a>
+<a href="http://www.gnu.org/licenses/agpl-3.0"><img src="https://img.shields.io/badge/license-AGPL-blue.svg" alt="AGPL License"></a>
+<br>
+
+## Author
+
+<p align="center"><a href="https://profile.intra.42.fr/users/fcorvaro"><img style="height:auto;" src="https://avatars.githubusercontent.com/u/102758065?v=4" width="100" height="100"alt=""></a>
+<p align="center">
+<a href="mailto:fcorvaro@student.42roma.it"><kbd>Email</kbd><alt=""></a>
+<a href="https://github.com/f-corvaro"><kbd>Github</kbd><alt=""></a>
+<a href="https://www.linkedin.com/in/f-corvaro/"><kbd>Linkedin</kbd><alt=""></a>
+<a href="https://42born2code.slack.com/team/U050L8XAFLK"><kbd>Slack</kbd><alt=""></a>
+
+<hr/>