Skip to content

Latest commit

 

History

History
119 lines (71 loc) · 2.85 KB

README.md

File metadata and controls

119 lines (71 loc) · 2.85 KB
Raw

Simple Shell Project

This project is a simple UNIX command line interpreter, often referred to as a "shell." It provides basic functionality for users to interact with their system through a command-line interface. This README file will guide you through the features and usage of this simple shell.

Table of Contents

Features

1. Command Execution

  • Display a prompt and wait for the user to type a command. A command line always ends with a new line.
  • The prompt is displayed again each time a command has been executed.

2. Command Parsing

  • The shell can parse command lines with arguments.

3. Command Execution Errors

  • If an executable cannot be found, it prints an error message and displays the prompt again.

4. Handling Errors

  • The shell handles various errors gracefully and provides informative error messages to the user.

5. End of File Handling

  • Handles the "end of file" condition (Ctrl+D) to exit the shell.

6. PATH Environment Variable

  • Handles commands that are part of the PATH environment variable, allowing users to execute common system commands.

7. Built-in Commands

  • Supports built-in commands such as exit and env.

8. Comment Handling

  • Ignores comments in the command line (lines starting with #), making it easy to add comments to scripts.

Getting Started

To get started with this simple shell, follow these steps:

  1. Clone the project repository to your local machine:

    git clone https://github.com/your-username/simple-shell.git

  2. Change your current directory to the project folder:

    cd simple-shell

  3. Compile the shell:

    gcc main.c -o hsh

  4. Run the shell:

    ./hsh

Usage

Once the shell is running, you can enter commands and interact with your system using the simple shell. Here are some examples:

  • Execute a system command:

    ls -l

  • Run a built-in command:

    exit

  • Use comments in your script:

    echo "Hello, world!" # This is a comment

Built-in Commands

The simple shell supports the following built-in commands:

  • exit: Exit the shell.
  • env: Display the current environment variables.

To use a built-in command, simply enter the command at the shell prompt.

Error Handling

The shell provides detailed error messages for various situations, including:

  • Command not found.
  • Invalid input.
  • File or directory not found.

The error messages are designed to help you understand and resolve issues with your commands.

Enjoy using the Simple Shell! If you have any questions or encounter issues, please feel free to reach out for assistance.