https://github.com/brenns10/lsh

Simple shell implementation. Tutorial here ->
https://github.com/brenns10/lsh

c shell tutorial

Last synced: 4 days ago
JSON representation

Simple shell implementation. Tutorial here ->

• Host: GitHub
• URL: https://github.com/brenns10/lsh
• Owner: brenns10
• License: unlicense
• Created: 2015-01-09T04:20:10.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2022-08-02T06:53:23.000Z (over 2 years ago)
• Last Synced: 2025-01-02T08:57:56.459Z (7 days ago)
• Topics: c, shell, tutorial
• Language: C
• Homepage: http://brennan.io/2015/01/16/write-a-shell-in-c/
• Size: 15.6 KB
• Stars: 1,514
• Watchers: 47
• Forks: 343
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• StarryDivineSky - brenns10/lsh

README

        
LSH

===

LSH is a simple implementation of a shell in C, and it is the subject of a

tutorial on [my website][1].  It demonstrates the basics of how a shell works.

That is: read, parse, fork, exec, and wait.  Since its purpose is demonstration

(not feature completeness or even fitness for casual use), it has many

limitations, including:

* Commands must be on a single line.

* Arguments must be separated by whitespace.

* No quoting arguments or escaping whitespace.

* No piping or redirection.

* Only builtins are: `cd`, `help`, `exit`.

Running

-------

Use `gcc -o lsh src/main.c` to compile, and then `./lsh` to run. If you would

like to use the standard-library based implementation of `lsh_read_line()`, then

you can do: `gcc -DLSH_USE_STD_GETLINE -o lsh src/main.c`.

Contributing

------------

Since this is the subject of a tutorial, I'm not looking to extend it with

additional features at this time.  So I won't be accepting any pull requests

that aren't related to bug fixes (and I'm sure there are still bugs in the

code!).

However, that doesn't mean that you shouldn't play with the code, make changes,

and explore new features!  That's the whole point of this project!  It's just

that other people are doing the same thing, and this project is merely a

starting point for your own exploration.

On that note, I would be just tickled if you dropped me a line (see my website

for contact info) to show me the cool new features you've added!

License

-------

This code is in the public domain (see [UNLICENSE](UNLICENSE) for more details).

This means you can use, modify, and distribute it without any restriction.  I

appreciate, but don't require, acknowledgement in derivative works.

[1]: http://brennan.io/2015/01/16/write-a-shell-in-c/