89 lines
2.5 KiB
Text
89 lines
2.5 KiB
Text
Sagi Dayan 2014
|
|
|
|
-----------------------------
|
|
OS course Ex1 - Home - cshell
|
|
-----------------------------
|
|
|
|
this project is a basic Terminal emulator written in C for OS course in JCE.
|
|
|
|
This Terminal will be able to run almost all programs in the PATH /bin/<bin name>
|
|
and will create a new process of that <bin name>.
|
|
|
|
the Prompt format:
|
|
<exit code> <userName>@<hostName>$
|
|
|
|
the exit code is the Return code from the last child process.
|
|
if 0 -> child ended successfully.
|
|
|
|
for more details see Q&A
|
|
|
|
sagi dayan (c) 2014.
|
|
|
|
------------
|
|
Build & Run & Exit
|
|
------------
|
|
To build cshell run in terminal: make
|
|
and run with the command: cshell
|
|
to quit run from cshell: exit
|
|
|
|
to clean the directory run: make clean
|
|
|
|
-------------------------
|
|
Design Decisions & Issues
|
|
-------------------------
|
|
the main idea is to be able to run & create processes via commands.
|
|
you can enter almost any basic command (and some more) that the binarys are in
|
|
PATH /bin/ .
|
|
|
|
Main issues:
|
|
* you cannot navigate to different directories.
|
|
* you cannot pipe command and arguments.
|
|
* every word will be treated as an argumant!
|
|
therefore you cannot write something like:
|
|
$ ls -a > "my text.txt"
|
|
cshell will see the arguments as:
|
|
# ls
|
|
# -a
|
|
# >
|
|
# "my
|
|
# text.text"
|
|
|
|
and that will throw you an error.
|
|
|
|
|
|
|
|
-------
|
|
Q&A
|
|
-------
|
|
Q: can i redirect output to a file?
|
|
A: yes you can. use the "redirect" char '>' and then the file name.
|
|
like so:
|
|
$ man ls > myFile.txt
|
|
Note: the content of the file Will be deleted, in othe words, it acts
|
|
exactly like '>' in the UNIX Shell. not '>>'.
|
|
Note2: the file name must be in one word. as you can see in Issues,
|
|
cshell dose not support an argument that is seperated with space or tab.
|
|
|
|
Q: what is that wired number before the prompt?
|
|
A: that wierd number is atually the return code of the last process that you ran.
|
|
the Unix defult return code of a succssesful end of process will be 0. otherwise,
|
|
in case fo an error or an exception, the code can be any number (code) that the
|
|
developer of that specific software maked down to exit at.
|
|
|
|
Q: why 255?
|
|
A: as i noticed, the defaul code of "exit(1)" is actually 256, but
|
|
in the exersize wanted to return 255 in case of an "unknown command" or default
|
|
exit(1).
|
|
|
|
Q: why cant i exit cshell with ctrl-c (^C)?
|
|
A: because that was also another task in this Ex.
|
|
only running childes will be killed, while the main process (cshell)
|
|
will stay running and kicking.
|
|
|
|
Q: So how to exit?
|
|
A: run 'exit'.
|
|
|
|
Q: Can i redirect stderr output to file?
|
|
A: No. the task was to implament only regular output.
|
|
|
|
|