109 lines
6.9 KiB
HTML
109 lines
6.9 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title></title>
|
|
<link href="/css/style.css" rel="stylesheet">
|
|
<link href="/css/tailwind.css" rel="stylesheet">
|
|
</head>
|
|
<body>
|
|
<div class="flex flex-col w-full">
|
|
<header class="flex flex-col h-48 w-screen text-[#FFF6DA]" style="background-color: rgb(169, 74, 74);">
|
|
<h1 class="p-8 grow place-content-center text-center text-5xl">My Personal Website</h1>
|
|
<div class="w-screen flex p-1 justify-center px-30 gap-4" style="background-color: #889E73">
|
|
<a class="p-4 hover:bg-[#aa9E73ff] rounded-md" href="/">Home</a>
|
|
<a class="p-4 hover:bg-[#aa9E73ff] rounded-md" href="/html/minishell.html">Minishell</a>
|
|
<a class="p-4 hover:bg-[#aa9E73ff] rounded-md" href="/html/minirt.html">MiniRT</a>
|
|
<a class="p-4 hover:bg-[#aa9E73ff] rounded-md" href="/html/emiku.html">emiku</a>
|
|
</div>
|
|
</header>
|
|
<div class="flex flex-col gap-y-6 bg-neutral-200/70 w-[60%] ml-[10%] mr-auto px-16 py-8">
|
|
<h2 class="text-4xl font-bold text-gray-800">The Shell</h2>
|
|
<div class="space-y-2">
|
|
<p class="leading-relaxed text-gray-700 max-w-prose">
|
|
The minishell project is part of the common core curriculum at ecole42 and
|
|
is seen as a milestone and one of the biggest jumps in complexity on the way to completing the cursus.
|
|
</p>
|
|
<p class="leading-relaxed text-gray-700 max-w-prose">
|
|
The rules are simple: Create a program that will replicate basic shell behaviour like typically found on posix systems.
|
|
</p>
|
|
<p class="leading-relaxed text-gray-700 mb-4 max-w-prose">
|
|
Some of the requirements are:
|
|
</p>
|
|
<ul class="list-disc list-inside space-y-2 text-gray-700 ml-4">
|
|
<li>Command line parsing</li>
|
|
<li>I/O loop to accept continuous commands</li>
|
|
<li>Command execution</li>
|
|
<li>File Descriptor redirection</li>
|
|
<li>Pipe Operators</li>
|
|
<li>Heredoc</li>
|
|
<li>Logical AND ( && )</li>
|
|
<li>Logical OR ( || )</li>
|
|
<li>and more...</li>
|
|
</ul>
|
|
<p class="leading-relaxed text-gray-700 mb-4 max-w-prose">
|
|
The program has to be written in C, we are working on GNU/Linux machines.
|
|
</p>
|
|
<p class="leading-relaxed text-gray-700 mb-4 max-w-prose">
|
|
We are also required to follow a very strict norm on which you can read more
|
|
<a class="underline text-blue-700 hover:text-blue-900" href="/assets/42-norm.pdf">here</a>.
|
|
</p>
|
|
<p class="leading-relaxed text-gray-700 mb-4 max-w-prose">
|
|
What makes the 42 projects stand out in my opinon is that the tools we use are very restricted, essentially only allowing
|
|
syscalls to interface with the kernel, some utility functions and memory functions, and in this case we were allowed to use
|
|
printf, which is normally forbidden.
|
|
This means that all utilty has to be implemented by hand, and all relevant code will be written by the projects authors.
|
|
</p>
|
|
<p class="leading-relaxed text-gray-700 mb-4 max-w-prose">
|
|
We also could use the readline function used in bash to handle the input of the user.<br>
|
|
Since memory leaks of any kind are considered an unrecoverable mistake when validating a project, and the readline function would
|
|
inevitably leak memory, those leaks were explicitly tolerated by the projects requirements.
|
|
</p>
|
|
<p class="leading-relaxed text-gray-700 mb-4 max-w-prose">
|
|
But, out of cursiousity, we decided to recreate the readline function, removing the dependecy and leaks from our project,
|
|
and learing a lot on the way.<br>
|
|
In my opinion, this is arguably the most interesting part of our implementation, and I very much enjoyed it!
|
|
</p>
|
|
<p class="leading-relaxed text-gray-700 mb-4 max-w-prose">
|
|
This project was a team effort, and big thanks go out to my team partner<br>and good friend,
|
|
<a class="underline text-blue-700 hover:text-blue-900" href="https://github.com/zekmaro">Andrej Arama</a>!
|
|
</p>
|
|
|
|
<p class="leading-relaxed text-gray-700 mb-4 max-w-prose">
|
|
The source code for the project can be seen on my
|
|
<a class="underline text-blue-700 hover:text-blue-900" href="https://git.victorvobis.org/minishell">git server</a> and
|
|
I have also provided a live version of the shell found below.
|
|
</p>
|
|
<div id="shell-container" class="flex max-w-[800px] min-h-[600px] bg-gray-800 justify-center place-items-center">
|
|
<button id="shell-start-button" class="flex p-4 bg-neutral-100/50 place-items-center rounded-md">
|
|
Start Shell
|
|
</button>
|
|
</div>
|
|
</div>
|
|
<div class="flex justify-between">
|
|
<p class="leading-relaxed text-gray-700 mb-4">
|
|
After trying out the shell, feel free to check out my other projects!
|
|
</p>
|
|
<a class="underline text-blue-700 hover:text-blue-900" href="/html/minirt.html">Next Project...</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<script>
|
|
const config = {
|
|
BASE_URL: 'http://localhost:5080/',
|
|
};
|
|
const shell_button = document.getElementById('shell-start-button');
|
|
shell_button.addEventListener('click', function() {
|
|
const shell_container = document.getElementById('shell-container');
|
|
const shell_frame = document.createElement('iframe');
|
|
shell_frame.height = '600';
|
|
shell_frame.width = '800';
|
|
shell_frame.src = config.BASE_URL + 'minishell/vnc';
|
|
shell_container.appendChild(shell_frame);
|
|
shell_button.style = 'display: none';
|
|
});
|
|
</script>
|
|
</body>
|
|
</html>
|