Programming Assignment 1: Shell

Description In this assignment you will write your own shell program, Mav shell (msh), similar to bourne shell (bash), c-shell (csh), or korn shell (ksh). It will accept commands, fork a child process and execute those commands. The shell, like csh or bash, will run and accept commands until the user exits the shell. Your file must be named msh.c

Requirement 1: Your program will print out a prompt of msh> when it is ready to accept input. It must read a line of input and, if the command given is a supported shell command, it shall execute the command and display the output of the command.

Requirement 2: If the command is not supported your shell shall print the invalid command followed by : Command not found.

Requirement 3: If the command option is an invalid option then your shell shall print the command followed by : invalid option -- and the option that was invalid as well as a prompt to try help. exec() output this automatically make sure you pass it on to your user.

Requirement 4: After each command completes, your program shall print the msh> prompt and accept another line of input.

Requirement 5: Your shell will exit with status zero if the command is quit or exit.

Requirement 6: If the user types a blank line, your shell will, quietly and with no other output, print another prompt and accept a new line of input.

Requirement 7: Your shell shall support suspending the process with ctrl-z

Requirement 8: Your shell shall background a suspended process with bg

Requirement 9: Your version of Mav shell shall support up to 10 command line parameters in addition to the command.

Requirement 10: Your shell shall support and execute any command entered. Any command in /bin, /usr/bin/, /usr/local/bin/ and the current working directory is to be considered valid for testing. Your shell shall search in the following PATH order: 1. Current working directory, 2. /usr/local/bin 3. /usr/bin 4. /bin Parameters may also be combined. For example, ps may be executed as: ps aef or ps a e -f

Requirement 11: Mav shell shall be implemented using fork(), wait() and one of the exec family of functions. Your Mav shell shall not use system(). Use of system() will result in a grade of 0.

Requirement 12: Typing ctrl-c or ctrl-z shall not stop or kill your shell. ctrl-z shall suspend the currently running process. ctrl-c shall stop the currently running process.

Requirement 13: Your shell shall support the cd command to change directories. Your shell must handle cd ..

Requirement 14: Your shell shall support the listpids command to list the PIDs of the last 15 processes spawned by your shell. If there have been less than 15 processes spawned then it shall print only those process PIDs

Requirement 15: Your shell shall support the history command which will list the last 15 commands entered by the user. Typing !n, where n is a number between 1 and 15 will result in your shell re-running the nth command. If the nth command does not exist then your shell will state Command not in history.. The output shall be a list of numbers 1 through n and their commands, each on a separate line, single spaced

Requirement 16: Your source file shall be named msh.c. The source files must be ASCII text files. No binary submissions will be accepted.

Requirement 17: Tabs or spaces shall be used to indent the code. Your code must use one or the other. All indentation must be consistent.

Requirement 18: No line of code shall exceed 100 characters.

Requirement 19: Each source code file shall have the following header filled out:

Requirement 20: All code must be well commented. This means descriptive comments that tell the intent of the code, not just what the code is executing.

Requirement 21: Keep your curly brace placement consistent. If you place curly braces on a new line , always place curly braces on a new end. Dont mix end line brace placement with new line brace placement.

Requirement 22: Each function should have a header that describes its name, any parameters expected, any return values, as well as a description of what the function does. For example Requirement 23: Remove all extraneous debug output before submission. The only output shall be the output of the commands entered or the shell prompt.

Requirement 24: Your code shall compile cleanly on omega.uta.edu with no warnings using: gcc -Wall msh.c -o msh