It is a team project that is a part of ecole 42 course. This project is about implementing
your very own shell (yes, like a custom bash or zsh, but a simple one). The project consists of parsing input;
managing input and output files with redirections; working with unix processes; working with file
descriptors; using pipelines for the processes to communicate; managing environment variables;
storing all the commands in history; managing signalls such as SIGKILL, SIGINT, etc; creating
builtin implementation for such commands as cd, pwd, export, env, exit, echo and unset;
finally, executing parsed commands.
The program launches a custom shell that waits for the input of a command and executes.
minishell repeats this behaviour in a loop until stopped. So as to handle errors that may arise
during the execution of commands, a child-process is created for the execution of each command
using fork(). Every command is executed inside of a child-process, while the only parent-process
waits for the child to either complete its task, or finish with an error id.
This project is written by me and taisiabarteneva.
- Install
readlinelibrary for your cpu architecture by downloading source files or by using brew.
brew install readline
- Clone the repository.
- Change the following lines in the Makefile to wherever your readline library is.
RL_LIB = /opt/homebrew/opt/readline/lib
RL_INC = /opt/homebrew/opt/readline/include
- Compile the program using Makefile.
- Launch the program.
The Makefile rules are as follows:
| Rule | Despription |
|---|---|
| ALL | Compiles the program using GCC. |
| BONUS | Compiles the program the same way 'ALL' does. |
| CLEAN | Removes object files leaving only the executable present. |
| FCLEAN | Removes both the executable and object files. |
| RE | Recompiles the program using CLEAN and ALL Makefile rules |
The program works with all of the redirection modes.
| Mode | Despription |
|---|---|
| << | Read from standard input until LIMITER. If here_doc keywoard is used for the input_file. |
| < | Read from an input file. |
| > | Erase the file's content and write to an output file. |
| >> | Append to an output file. |
-
minishellis able to parse input with both single quotes' 'and double quotes" ". All of the possible combinations of them are handled by the program. -
The program doen't interpret unclosed quotes or special characters such as
\(backslash),;(semicolon),&&and||(with parenthesis for priorities.). Parsing error is thrown if a quote is not closed or if a special character is read. -
The program has a working history of commands.
-
The program supports pipes
|. Every command insideminishellis executed in a child process with the parent process overseeing the execution. The output of each command in the pipeline is connected to the input of the next command via a pipe. -
Internally,
minishellstores a clone of environment variables. Therefore, all the environment variables ($ followed by a sequence of characters which should expand to their values) are handled by the program. Setting, changing or deleting environment variables insideminishelldoesn't affect those of your terminal's shell. -
$?expands to the exit status of the most recently executed foreground pipeline. -
Wildcards in the current working directory
*are also supported. -
The program handles signals such as
ctrl-C,ctrl-Dandctrl-\which behave like in bash.
minishell has several built-in executables:
| Function | Description |
|---|---|
echo with option -n |
displays a line of text/string in standard output. -n flag does it with a newline. |
cd with a relative or an absolute path |
changes the current directory. |
pwd with no options |
prints working directory. |
export with no options |
sets or amends an environment variable. |
unset with no options |
unsets an environment variable. |
env with no options or arguments |
lists all the current environment variables. |
exit with no options |
exits minishell. |
Other commands are executed using execve with their appropriate path.
In case there is no such command, an error is displayed in the terminal.