BD-shell
BD-shell (a.k.a. bdsh) is a tiny Unix shell written in C. It’s a project required for the Operating System Course at my University.
It is written using a clean coding style, following xP coding standard philosophy.
Version 1.0 is the release that satisfies all the course requirements!
Features
Cool Features
- Lightweight
- Implements real Job Control
- Clear and understandable code, ideal for Academic (and personal) studies
- Makes use of various system calls, signals, signal handlers, user input handling, data structures implementation
- Free Software!
Cool Features NOT present (but may be in future)
- No command history present
- No command/filename auto completion
- No wildcars
- No command piping, just a single command can be launched at a time
- Put everything else here.
These are the requirements asked by the teaching professor. The complete project description page is located at http://www.inf.unibz.it/~david/os/project.html
The shell must be able to do the following:
The shell must be able to do the following:
- to read commands from standard input and execute them in a loop until a
built-in command exit is issued (we call these processes the foreground processes; there is always at most one of these at any particular time); - be able to redirect the standard input and output of commands by prefixing them with built-in commands in file and out file;
- be able to terminate (involuntarily) the foreground process when user presses ^C and return back to the mini-shell;
- be able to interrupt the foreground process temporarily, when user presses ^Z, returning to the mini-shell;
- be able to execute any number of processes in background (i.e., in parallel with the foreground process), including in particular, the ability to start another process while a process has been temporarily suspended;
- inform the user when the background process finishes or is
waiting for an input from the terminal; - be able to inform the user what commands are executing in the background by issuing the built-in command jobs, this should include information about the state of the process (i.e., suspended, background, waiting for input, etc.) and about what file(s) is the background process using for standard input and output);
- be able to terminate involuntarily a background processes by issuing the built-in command kill job-number.
- to be able to resume a process or to make a background process into the foreground process (i.e., the one that currently interacts with the terminal) by issuing the fg job-number command.
Download:
- 2008-09-14 – version 1.0.0.
- fixed synchronization bug in putJobBackground() that made not notify background processes requesting input (in some situations)
Known Bugs:
- Lots of! I consider bdsh-1.0.0 stable because it covers ALL requirements of the course and does them whell on various Unix systems. So it works, but commands like “in non_existent_file cat” won’t work and will crash it!
What will be next?
- I don’t know. I may consider a 1.0.1 release to fix future bugs. I may also think to add cool features to make the shell complete. I hope I will have the time for it. You can also do it by yourself and send me the code
- 2008-09-13 – version 1.0.0 Release Candidate 2.
Changes from beta 1 / release candidate 1- removed gcc O3 flag from makefile
- lots of bugs fixed in functions operating on the list of jobs
- improvements in launchJob() when dealing with background commands
- bug in putJobBackground() that made the shell crash has been fixed
- killJob() now sends a SIGKILL
- bugs fixed in signalHandler_child()
- Code formatted using astyle (linux style)
- A couple of variables renamed
- Various usleep() removed
Known Bugs:
- So many =) This is a shell made for Academic purposes, not for production use!
- 2008-07-30 – version 1.0.0 beta1.
Characteristics:- First beta release of the final version
- Every requirement has been covered
- Real Job-Control implemented
- About every function of bdsh.c has been rewritten
- New source directory layout, very clean
- Some documentation and makefile
- IMPORTANT! this has to be considered a bug hunting release! Please report me any bugs
- 2008-06-05 – version 0.7.1, corrects the linked list bug of version 0.7.0
- 2008-05-09 – version 0.7.0.
UPDATE 2008-06-05: there is a bug in the list handling, the shell crashes when using the standard input redirection. Please download version 0.7.1, which corrects the problem.
Characteristics:- Cleaner code!
- Lots of bugs fixed!
- reads commands from standard input and executes them in a loop until a built-in command exit is issued
- redirects STDIN and STDOUT of commands by prefixing them with built-in commands in file and out file
- terminates (involuntarily) the foreground process when user presses ^C and return back to the shell
- executes any number of processes in background (i.e., in parallel with the foreground process)
- informs the user when the background process finishes
- informs the user what commands are executing in the background by issuing the built-in command jobs
- terminates involuntarily a background processes by issuing the built-in command kill job-number.
- Due to a lots of compatibility issues with Gnu/Linux (the shell has been developed under Mac Os X), the final released has been delayed to mid-September. Sorry for this, I encountered so many problems the day before project presentation, that I decided to present it during the next exam session. I switched back to Gnu/Linux, too
-
Final release is scheduled on 2008-06-26, as the project deadline is 2008-06-25.The release will
satisfy all the requirements, and as addition:- Execution system totally rewritten (e.g. one single short function that handles everything)
- A Job Control will be implemented
- Processes in foreground will really be in foreground, there are a lot of things that we did not learn during the course, like tcsetpgrp()
- Some functions in utils.h will be deleted and optimized
- Cleaner and clearer code!
- 2008-04-21 – version 0.0.1
Characteristics:- Modular code, divided in 3 files: bdsh.c, utils.h, headers.h
- Clean user input from a char buffer to an array of strings
- Built-in commands: exit (exits from the shell), cd (changes directory), in <filename> command (redirects STDIN of command from <filename>), out <filename> command (redirects STDOUT of command to <filename>)
- Makes use of fork() to read commands from standard input and execute them
License:
BD-shell is released under The Gnu GPL version 3! This is different from the license of the contents of the blog
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.You should have received a copy of the GNU General Public License
along with this program. If not, see <http ://www.gnu.org/licenses/>>.
)
