JCE-Projects/cshell
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Update and rename README.txt to README.md

Browse source
This commit is contained in:
Sagi Dayan 2014-04-28 12:31:12 +03:00
parent fb87c77928
commit ce3d2b7a8f
1 changed files with 31 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

51
README.txt → README.md
View file

@ -1,17 +1,16 @@
Sagi Dayan 2014 ###Sagi Dayan 2014
-----------------------------
OS course Ex1 - Home - cshell - LINUX/UNIX
-----------------------------
this project is a basic Terminal emulator written in C for OS course in JCE. # OS course Ex1 - Home - cshell - LINUX/UNIX
## 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> 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>. and will create a new process of that <bin name>.
the Prompt format: the Prompt format:
```
<exit code> <userName>@<hostName>$ <exit code> <userName>@<hostName>$
```
the exit code is the Return code from the last child process. the exit code is the Return code from the last child process.
if 0 -> child ended successfully. if 0 -> child ended successfully.
@ -19,23 +18,33 @@ for more details see Q&A
sagi dayan (c) 2014. 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 # 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
-------------------------
Design Decisions & Issues
-------------------------
the main idea is to be able to run & create processes via commands. 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 you can enter almost any basic command (and some more) that the binarys are in
PATH /bin/ . PATH /bin/ .
Main issues: ### Main issues:
* you cannot navigate to different directories. * you cannot navigate to different directories.
* you cannot pipe command and arguments. * you cannot pipe command and arguments.
* every word will be treated as an argumant! * every word will be treated as an argumant!
@ -52,13 +61,15 @@ Main issues:
-------
Q&A # Q&A
-------
Q: can i redirect output to a file? Q: can i redirect output to a file?
A: yes you can. use the "redirect" char '>' and then the file name. A: yes you can. use the "redirect" char '>' and then the file name.
like so: like so:
```shell
$ man ls > myFile.txt $ man ls > myFile.txt
```
Note: the content of the file Will be deleted, in othe words, it acts Note: the content of the file Will be deleted, in othe words, it acts
exactly like '>' in the UNIX Shell. not '>>'. exactly like '>' in the UNIX Shell. not '>>'.
Note2: the file name must be in one word. as you can see in Issues, Note2: the file name must be in one word. as you can see in Issues,