/unix-shell

A basic unix shell built in C language.

Primary LanguageCMIT LicenseMIT

Unix SHELL

Table of Contents:

About

A basic unix shell built in C language.

Files and Directories

Folders & Files Description
.github Contains files related to github
shell Contains the source code of the shell
shell/__tests__ Contains unittests
shell/builtin Contains files and code related to the shell builtin commands
shell/command_handler Contains files and code related to handling builtin commands and system commands
shell/config Contains files and code related to general configuration of the shell (colors, ...)
shell/parser Contains files and code related to parsing the commands entered by the user
shell/prompt Contains files and code related to the shell command prompt
shell/util Contains some useful helper functions
shell/Makefile Special file used for compilation
shell/shell.c Contains main() function

Get Started

Please Follow the following instructions to run the shell successfully

  • Clone the repo
git clone https://github.com/bennaaym/unix-shell.git
  • Be sure that you're inside unix-shell directory, you can run pwd to check the current working directory
/unix-shell$
  • Change the current directory to shell/
/unix-shell$ cd shell

/unix-shell/shell$
  • Be sure that make is already setup on your unix OS, otherwise run the following command
sudo apt-get install make
  • Run make command to compile the code
/unix-shell/shell$ make
  • Now run the shell
/unix-shell/shell$ ./shell

Congratulation now you can start testing our shell

Built-in Commands

  • Builtin commands are handled directly by the shell process.
  • Builtin commands don't cause the creation of a new child process.
Command Description
cd Changes the current working directory
showpid Prints out the PIDs of the last 10 processes created by the running shell process
exit Causes normal process termination

External Commands

  • For each external command a new process is created by the running shell process

  • The execution of the external commands is mainly based on using fork() and execvp , and to prevent defunct processes (zombie processes) waitpid() was used.

Contributing

To contribute to this open-source project, follow these steps:

  1. Fork the repository.

  2. Create a branch: git checkout -b <branch_name>.

    branch_name = your_username/name

    e.g:
username : bennaaym 
name : new_feature 
branch = bennaaym/new_feature 
```

  3. Make your changes and commit them: git commit -m '<commit_message>'.

  4. Push to your branch: git push origin <project_name>/<location>.

  5. Create a pull request.

Team

Group 21


Aymen Bennabi

Fatih Aytar

Hajer Gafsi

License

MIT License

Distributed under the MIT License. See LICENSE for more information.

Ressources