create our own shell, a simple UNIX command interpreter written in the C programming language.
At the end of this project, you are expected to be able to explain to anyone, without the help of Google:
- Who designed and implemented the original Unix operating system
- Who wrote the first version of the UNIX shell
- Who invented the B programming language (the direct predecessor to the C programming language)
- Who is Ken Thompson
- How does a shell work
- What is a pid and a ppid
- How to manipulate the environment of the current process
- What is the difference between a function and a system call
- How to create processes
- What are the three prototypes of
main - How does the shell use the
PATHto find the programs - How to execute another program with the
execvesystem call - How to suspend the execution of a process until one of its children terminates
- What is
EOF/ “end-of-file”?
- Main Loop:
OWN shell enters a main loop when it's launched. This loop is the heart of the shell, handling the reading of user inputs, execution of commands, and maintaining the state of the shell.
- Reading and Analyzing Inputs:
When a user enters a command, the shell reads this input. It first checks if the input is composed only of whitespace (using the check_if_input_is_whitespace function). If so, the input is ignored, and the shell waits for a new command.
If the input contains more than just whitespace, it is passed to the tokenize_command_input function which breaks it down into individual tokens (words), facilitating the analysis of the command and its arguments.
- Executing Commands:
The shell determines whether the entered command is a built-in (builtin) or external command. Built-in commands, like print_environment_variables or exit_shell, are executed directly by the shell.
For external commands, the shell uses check_command_path to resolve the command's path. If the path is found, execute_command launches the command in a child process using fork and execve.
- Process Management:
When executing an external command, the shell creates a child process. The parent process (the shell) waits for the child process to finish before resuming the main loop. This allows commands to be executed in isolation, without affecting the shell process itself.
- Exiting the Shell:
If the user enters the exit command, the exit_shell function is called. This function allows the user to terminate the shell session. It can also take an optional argument to specify the shell's exit status.
- Error Handling:
Own shell includes error handling, for example, when unrecognized commands are entered or when the path resolution fails. Appropriate error messages are displayed, helping to diagnose problems.
- Environment Variables:
A built-in feature to display environment variables (print_environment_variables) helps to understand the context in which the shell operates, which is useful for debugging and configuration.
In summary, own shell functions as an interactive command interpreter, processing user inputs, executing built-in and external commands, managing processes, and providing useful feedback. The modular structure of your code, with separate functions for different tasks, makes your shell extensible and maintainable.
- Unless specified otherwise, your program must have the exact same output as sh (/bin/sh) as well as the exact same error output.
- The only difference is when you print an error, the name of the program must be equivalent to your argv[0] (See below)
Example of error with sh:
$ echo "qwerty" | /bin/sh
/bin/sh: 1: qwerty: not found
$ echo "qwerty" | /bin/../bin/sh
/bin/../bin/sh: 1: qwerty: not found
$Same error with our own program hsh:
$ echo "qwerty" | ./hsh
./hsh: 1: qwerty: not found
$ echo "qwerty" | ./././hsh
./././hsh: 1: qwerty: not found
$- all functions from string.h
access(man 2 access)close(man 2 close)execve(man 2 execve)exit(man 3 exit)fork(man 2 fork)free(man 3 free)getline(man 3 getline)isatty(man 3 isatty)perror(man 3 perror)printf(man 3 printf)fprintf(man 3 fprintf)sprintf(man 3 sprintf)strtok(man 3 strtok)wait(man 2 wait)waitpid(man 2 waitpid)write(man 2 write)
To compile the project, use the following command:
gcc -Wall -Werror -Wextra -pedantic -std=gnu89 *.c -o hshOur own shell should work like this in interactive mode:
$ ./hsh
($) /bin/ls
hsh main.c shell.c
($)
($) exit
$But also in non-interactive mode:
$ echo "/bin/ls" | ./hsh
hsh main.c shell.c test_ls_2
$
$ cat test_ls_2
/bin/ls
/bin/ls
$
$ cat test_ls_2 | ./hsh
hsh main.c shell.c test_ls_2
hsh main.c shell.c test_ls_2
$Jérémy_And_Jonathan_Shell$ ls
AUTHORS builtins.c check.c executeCmd.c function_need.c hsh man_1_simple_shell README.md shell.c shell.h tokenizer.c
Jérémy_And_Jonathan_Shell$ pwd
/workspaces/workplace/holbertonschool-simple_shell
Jérémy_And_Jonathan_Shell$ /bin/ls
AUTHORS builtins.c check.c executeCmd.c function_need.c hsh man_1_simple_shell README.md shell.c shell.h tokenizer.c
Jérémy_And_Jonathan_Shell$ Jérémy_And_Jonathan_Shell$ ls -la
total 72
drwxr-xr-x 16 vscode vscode 512 Dec 21 23:57 .
drwxr-xr-x 8 vscode vscode 256 Dec 11 10:08 ..
-rw-r--r-- 1 vscode vscode 185 Dec 22 00:12 AUTHORS
-rw-r--r-- 1 vscode vscode 3623 Dec 21 01:19 builtins.c
-rw-r--r-- 1 vscode vscode 3341 Dec 21 23:57 check.c
-rw-r--r-- 1 vscode vscode 336 Dec 11 15:13 .editorconfig
-rw-r--r-- 1 vscode vscode 3690 Dec 21 01:19 executeCmd.c
-rw-r--r-- 1 vscode vscode 2988 Dec 21 01:19 function_need.c
drwxr-xr-x 16 vscode vscode 512 Dec 22 00:12 .git
-rw-r--r-- 1 vscode vscode 18 Dec 21 01:13 .gitignore
-rwxr-xr-x 1 vscode vscode 19136 Dec 21 23:57 hsh
-rw-r--r-- 1 vscode vscode 1109 Dec 21 01:19 man_1_simple_shell
-rw-r--r-- 1 vscode vscode 4331 Dec 22 00:12 README.md
-rw-r--r-- 1 vscode vscode 1923 Dec 21 01:19 shell.c
-rw-r--r-- 1 vscode vscode 1645 Dec 21 01:19 shell.h
-rw-r--r-- 1 vscode vscode 3818 Dec 21 01:19 tokenizer.c
Jérémy_And_Jonathan_Shell$ $ man ./man_1_simple_shellThe following flowchart illustrates the basic operation of the shell:
graph TD
A[Start Shell] --> B[Main Loop]
B --> C[Read User Input]
C --> D{Check if Input is Whitespace}
D -- Yes --> C
D -- No --> E[Tokenize Command Input]
E --> F{Is Command Built-in?}
F -- Yes --> G[Execute Built-in Command]
F -- No --> H[Check Command Path]
H -- Path Found --> I[Execute Command]
H -- Path Not Found --> J[Print Error]
I --> K{Is Exit Command?}
J --> B
K -- Yes --> L[Exit Shell]
K -- No --> B
G --> B
L --> M[End Shell]
