Simple Shell

Table of Contents

• Description
• Flowchart
• File Structure
• System and Library calls
• Installation
• Example of Use
• Authors

Description

This simple shell was created by Rob Farley and Shadi Shwiyat as a project for Holberton School of Computer Science. It is a simple UNIX command interpreter written in the C programming language. The program uses bash commands it retrieves from the command line interface (CLI) that are inputed by the user. The shell can be run in interactive and non interactive mode as shown below.

Flowchart

File Structure

This table give a brief description of the files used for the simple shell to work, click on the names to get the source code.

File	Content	Description
shell.h	Header of the project	Contains the structures, prototypes, macros and external variables of the project.
shell.c	int main.c;	Main loop, recieve input from the Command Line Interface parse and execute it.
tokenizers.c	char **hsh_tokenizer(); char **tokenizer_path();	Split the input string into a array of tokens. Split the environment variable PATH into an array of tokens.
validators.c	char *validate_input(); int validate_spaces();	Validate if PATH exists Validate spaces, tabs and line breaks.
exe_command.c	int hsh_execute(); int hsh_execute_builtins();	Fork process and replace the child with a new program. Choose from an array of builtin functions.
builtins.c	int hsh_cd(); int hsh_setenv(); int hsh_unsetenv(); int hsh_env(); int hsh_exit();	Change directory. Change or add and environment variable. Delete an environment variable from the environment. Print the environment variables list. Terminate the main loop and exit the shell.
the_helpers.c	char *str_concat(); void *_realloc();	Concatenate two strings. Reallocate a memory block.

System and Library calls

This table lists all the System calls 2 and Library calls 3 used in this project, you could read more by clicking on their respective manual pages.

Name	Manual page	Brief description
access	man 2 access	access() function checks whether the calling process can access the file pathname. If pathname is a symbolic link, it is dereferenced.
chdir	man 2 chdir	chdir() function changes the current working directory of the calling process to the directory specified in one of its parameters.
execve	man 2 execve	execve() function allows a process to execute another program.
exit	man 3 exit	exit() function causes normal process termination.
fork	man 2 fork	fork() function creates a new process by duplicating the calling process. The new process is referred to as the child process. The calling process is referred to as the parent process.
free	man 3 free	free() function frees the memory space from the heap, which must have been returned by a previous call to malloc(), calloc(), or realloc().
getcwd	man 3 getcwd	getcwd() function copies an absolute pathname of the current working directory.
getenv	man 3 getenv	getenv() function searches the environment list to find the requested environment variable.
getline	man 3 getline	getline() function reads an entire line from input, storing the address of the buffer containing the text into a pointer.
isatty	man 3 isatty	isatty() function tests whether a file descriptor refers to a terminal.
malloc	man 3 malloc	malloc() function dynamically allocates a single large block of memory with the specified size.
perror	man 3 perror	perror() function produces a message on standard error describing the last error encountered during a call to a system or library function.
waitpid	man 2 waitpid	waitpid() function suspends execution of the calling thread until a child specified by pid argument has changed state.
fprintf	man 3 fprintf	fprintf() function sends formatted output to a stream.
setenv	man 3 setenv	setenv() function adds a variable to the environment.
unsetenv	man 3 unsetenv	unsetenv() function deletes a variable from the environment.
write	man 2 write	write() function writes to a file descriptor.

Installation

First, clone this repository to your local machine:

$ git clone https://github.com/Shadi-Shwiyat/holbertonschool-simple_shell.git

Then, go to the repository folder:

$ cd holbertonschool-simple_shell

Compile it with the following command:

$ gcc -Wall -Werror -Wextra -pedantic *.c -o hsh

Now you can run the shell in interactive mode:

$ ./hsh

Or you can run it in non-interactive mode:

$ echo "ls -la" | ./hsh

Example of Use

Interactive mode:

$ ./hsh
#$ ls
AUTHORS              exe_command.c         hsh     shell.c         README.md     validators.c
builtins.c  the_helpers.c  shell.h  man_1_simple_shell  tokenizers.c
#$ pwd
/root/holbertonschool-simple_shell
#$ exit
$

$ ./hsh
#$ ls -la
total 72
drwxr-xr-x  3 root root   232 Aug  7 23:01 .
drwxr-xr-x 14 root root  4096 Aug  8 12:22 ..
-rw-r--r--  1 root root   216 Aug  7 19:00 AUTHORS
-rw-r--r--  1 root root  4215 Aug  7 23:00 builtins.c
-rw-r--r--  1 root root  2456 Aug  7 23:00 executors.c
drwxr-xr-x  8 root root   201 Aug  7 23:00 .git
-rw-r--r--  1 root root  1567 Aug  7 23:00 the_helpers.c
-rwxr-xr-x  1 root root 22744 Aug  7 23:01 hsh
-rw-r--r--  1 root root  1919 Aug  7 23:00 shell.h
-rw-r--r--  1 root root  1782 Aug  7 23:00 shell.c
-rw-r--r--  1 root root  3703 Aug  7 18:58 man_1_simple_shell
-rw-r--r--  1 root root    29 Aug  7 18:36 README.md
-rw-r--r--  1 root root  2517 Aug  7 23:00 tokenizers.c
-rw-r--r--  1 root root  1749 Aug  7 23:00 validators.c
#$ exit
$

Non-interactive mode:

$ echo "env" | ./hsh
HOSTNAME=380dba7ae1b2
LANGUAGE=en_US:en
PWD=/root/holbertonschool-simple_shell
TZ=America/Los_Angeles
HOME=/root
LANG=en_US.UTF-8
LS_COLORS=rs=0:di=01;34:ln=01;36:mh=00:pi=40;33:so=01;35:do=01;35:bd=40;33;01:cd=40;33;01:or=40;31;01:mi=00:su=37;41:sg=30;43:ca=30;41:tw=30;42:ow=34;42:st=37;44:ex=01;32:*.tar=01;31:*.tgz=01;31:*.arc=01;31:*.arj=01;31:*.taz=01;31:*.lha=01;31:*.lz4=01;31:*.lzh=01;31:*.lzma=01;31:*.tlz=01;31:*.txz=01;31:*.tzo=01;31:*.t7z=01;31:*.zip=01;31:*.z=01;31:*.dz=01;31:*.gz=01;31:*.lrz=01;31:*.lz=01;31:*.lzo=01;31:*.xz=01;31:*.zst=01;31:*.tzst=01;31:*.bz2=01;31:*.bz=01;31:*.tbz=01;31:*.tbz2=01;31:*.tz=01;31:*.deb=01;31:*.rpm=01;31:*.jar=01;31:*.war=01;31:*.ear=01;31:*.sar=01;31:*.rar=01;31:*.alz=01;31:*.ace=01;31:*.zoo=01;31:*.cpio=01;31:*.7z=01;31:*.rz=01;31:*.cab=01;31:*.wim=01;31:*.swm=01;31:*.dwm=01;31:*.esd=01;31:*.jpg=01;35:*.jpeg=01;35:*.mjpg=01;35:*.mjpeg=01;35:*.gif=01;35:*.bmp=01;35:*.pbm=01;35:*.pgm=01;35:*.ppm=01;35:*.tga=01;35:*.xbm=01;35:*.xpm=01;35:*.tif=01;35:*.tiff=01;35:*.png=01;35:*.svg=01;35:*.svgz=01;35:*.mng=01;35:*.pcx=01;35:*.mov=01;35:*.mpg=01;35:*.mpeg=01;35:*.m2v=01;35:*.mkv=01;35:*.webm=01;35:*.ogm=01;35:*.mp4=01;35:*.m4v=01;35:*.mp4v=01;35:*.vob=01;35:*.qt=01;35:*.nuv=01;35:*.wmv=01;35:*.asf=01;35:*.rm=01;35:*.rmvb=01;35:*.flc=01;35:*.avi=01;35:*.fli=01;35:*.flv=01;35:*.gl=01;35:*.dl=01;35:*.xcf=01;35:*.xwd=01;35:*.yuv=01;35:*.cgm=01;35:*.emf=01;35:*.ogv=01;35:*.ogx=01;35:*.aac=00;36:*.au=00;36:*.flac=00;36:*.m4a=00;36:*.mid=00;36:*.midi=00;36:*.mka=00;36:*.mp3=00;36:*.mpc=00;36:*.ogg=00;36:*.ra=00;36:*.wav=00;36:*.oga=00;36:*.opus=00;36:*.spx=00;36:*.xspf=00;36:
LESSCLOSE=/usr/bin/lesspipe %s %s
TERM=xterm
LESSOPEN=| /usr/bin/lesspipe %s
SHLVL=0
LC_ALL=en_US.UTF-8
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
OLDPWD=/
_=./hsh
$

Authors

Shadi Shwiyat	Robert Farley

Back to top