If you’re venturing into systems programming or want to strengthen your understanding of process management, building a simple shell in C is an excellent project. Not only does it deepen your grasp of operating system concepts, but it’s also a practical way to learn about process execution, input\/output redirection, and more. In this article, we’ll walk through the steps to create a basic shell from scratch.<\/p>\n
A shell is a command-line interface that allows users to interact with the operating system. It interprets commands, manages processes, and provides an environment for running programs. In UNIX-like systems, the shell is an essential part of user experience, enabling task automation through scripts and command execution.<\/p>\n
Before we jump into the code, it’s important to understand some basic concepts:<\/p>\n
To start building our shell, ensure you have the necessary tools installed. You\u2019ll need:<\/p>\n
Once your environment is set up, create a new directory for your shell project:<\/p>\n
\nmkdir simple_shell\ncd simple_shell\n<\/pre>\nThe Basic Structure of a Shell<\/h2>\n
We will start with a basic structure in C. Create a file named simple_shell.c<\/strong>:<\/p>\n
\n#include <stdio.h>\n#include <stdlib.h>\n#include <unistd.h>\n#include <string.h>\n\n#define MAX_INPUT_SIZE 1024\n\nint main() {\n char input[MAX_INPUT_SIZE];\n\n while (1) {\n printf(\"simple_shell> \"); \/\/ Display a prompt\n fgets(input, MAX_INPUT_SIZE, stdin); \/\/ Get user input\n printf(\"You entered: %s\", input); \/\/ Echo the input\n }\n return 0;\n}\n<\/pre>\nHere\u2019s a breakdown of what\u2019s happening:<\/p>\n
\n
- We include the necessary header files for input\/output, memory management, process control, and string handling.<\/li>\n
- We define a constant MAX_INPUT_SIZE<\/strong> to limit user input length.<\/li>\n
- Inside the main loop, we prompt the user for input, read the input, and then echo it back.<\/li>\n<\/ul>\n
Compiling and Running Your Shell<\/h2>\n
To compile your code, execute:<\/p>\n
\ngcc -o simple_shell simple_shell.c\n<\/pre>\nRun your shell with:<\/p>\n
\n.\/simple_shell\n<\/pre>\nAt this point, you should see a prompt that waits for user input. When you enter a command, it echoes it back to you.<\/p>\n
Executing Commands<\/h2>\n
The next step is to allow the shell to execute user commands. Modify your code to include the ability to fork a process and execute commands using execvp<\/strong>:<\/p>\n
\n#include <stdio.h>\n#include <stdlib.h>\n#include <unistd.h>\n#include <string.h>\n\n#define MAX_INPUT_SIZE 1024\n#define MAX_ARG_SIZE 100\n\nint main() {\n char input[MAX_INPUT_SIZE];\n char *args[MAX_ARG_SIZE];\n\n while (1) {\n printf(\"simple_shell> \");\n fgets(input, MAX_INPUT_SIZE, stdin);\n input[strcspn(input, \"n\")] = 0; \/\/ Remove newline character\n\n \/\/ Tokenize input\n char *token = strtok(input, \" \");\n int i = 0;\n while (token != NULL) {\n args[i++] = token;\n token = strtok(NULL, \" \");\n }\n args[i] = NULL; \/\/ Terminate the array with NULL\n\n if (fork() == 0) {\n execvp(args[0], args); \/\/ Execute the command\n perror(\"execvp failed\"); \/\/ Error handling\n exit(EXIT_FAILURE);\n }\n else {\n wait(NULL); \/\/ Parent waits for the child process to complete\n }\n }\n return 0;\n}\n<\/pre>\n### Explanation of the Changes Made:<\/p>\n
\n
- We added an args<\/strong> array that holds the command and its arguments after tokenization.<\/li>\n
- We use strtok<\/strong> to split the input string into tokens based on spaces.<\/li>\n
- When forking, the child process uses execvp<\/strong> to execute the command entered by the user.<\/li>\n
- If the execvp<\/strong> call fails, an error message is printed.<\/li>\n
- The parent process calls wait<\/strong> to ensure it waits for the child to finish before prompting for input again.<\/li>\n<\/ul>\n
Adding Built-in Commands<\/h2>\n
It’s typical for shells to support built-in commands like exit<\/strong>. Let\u2019s enhance our shell to handle such commands:<\/p>\n
\n#include <stdio.h>\n#include <stdlib.h>\n#include <unistd.h>\n#include <string.h>\n\n#define MAX_INPUT_SIZE 1024\n#define MAX_ARG_SIZE 100\n\nvoid execute_command(char *input) {\n char *args[MAX_ARG_SIZE];\n char *token = strtok(input, \" \");\n int i = 0;\n\n while (token != NULL) {\n args[i++] = token;\n token = strtok(NULL, \" \");\n }\n args[i] = NULL;\n\n if (strcmp(args[0], \"exit\") == 0) {\n exit(0); \/\/ Exit the shell\n }\n\n if (fork() == 0) {\n execvp(args[0], args);\n perror(\"execvp failed\");\n exit(EXIT_FAILURE);\n } else {\n wait(NULL);\n }\n}\n\nint main() {\n char input[MAX_INPUT_SIZE];\n\n while (1) {\n printf(\"simple_shell> \");\n fgets(input, MAX_INPUT_SIZE, stdin);\n input[strcspn(input, \"n\")] = 0; \/\/ Remove the newline character\n execute_command(input); \/\/ Execute the command\n }\n return 0;\n}\n<\/pre>\n### Key Changes:<\/p>\n
\n
- We introduced a function execute_command<\/strong> to handle command execution.<\/li>\n
- The built-in exit<\/strong> command checks if the user wants to terminate the shell, providing a clean way to exit.<\/li>\n
- Functionality is modularized for better readability and maintainability.<\/li>\n<\/ul>\n
Implementing Input\/Output Redirection<\/h2>\n
A well-rounded shell should also handle input and output redirection (using ). We can extend our shell to support these features.\u201d Here\u2019s how:<\/p>\n
\n#include <stdio.h>\n#include <stdlib.h>\n#include <unistd.h>\n#include <string.h>\n#include <fcntl.h>\n\n#define MAX_INPUT_SIZE 1024\n#define MAX_ARG_SIZE 100\n\nvoid execute_command(char *input) {\n char *args[MAX_ARG_SIZE];\n char *token = strtok(input, \" \");\n int i = 0;\n int input_redirect = 0;\n int output_redirect = 0;\n char *input_file = NULL;\n char *output_file = NULL;\n\n while (token != NULL) {\n if (strcmp(token, \"<\") == 0) {\n input_redirect = 1;\n token = strtok(NULL, \" \");\n input_file = token;\n } else if (strcmp(token, \">\") == 0) {\n output_redirect = 1;\n token = strtok(NULL, \" \");\n output_file = token;\n } else {\n args[i++] = token;\n }\n token = strtok(NULL, \" \");\n }\n args[i] = NULL;\n\n if (strcmp(args[0], \"exit\") == 0) {\n exit(0);\n }\n\n if (fork() == 0) {\n \/\/ Handle output redirection\n if (output_redirect) {\n int fd = open(output_file, O_WRONLY | O_CREAT | O_TRUNC, 0644);\n dup2(fd, 1); \/\/ Redirect stdout to file\n close(fd);\n }\n\n \/\/ Handle input redirection\n if (input_redirect) {\n int fd = open(input_file, O_RDONLY);\n dup2(fd, 0); \/\/ Redirect stdin to file\n close(fd);\n }\n\n execvp(args[0], args);\n perror(\"execvp failed\");\n exit(EXIT_FAILURE);\n } else {\n wait(NULL);\n }\n} \n\nint main() {\n char input[MAX_INPUT_SIZE];\n\n while (1) {\n printf(\"simple_shell> \");\n fgets(input, MAX_INPUT_SIZE, stdin);\n input[strcspn(input, \"n\")] = 0;\n execute_command(input);\n }\n return 0;\n}\n<\/pre>\n### Enhancements for Redirection:<\/p>\n
\n
- We integrated checks for input<\/strong> and output<\/strong> redirection using .<\/li>\n
- By opening the specified file and redirecting the relevant file descriptor (stdin or stdout), we allow our shell to work with files seamlessly.<\/li>\n
- This change allows commands like cat < input.txt<\/strong> or echo Hello > output.txt<\/strong> to function in our shell.<\/li>\n<\/ul>\n
Conclusion<\/h2>\n
Congratulations! You’ve built a simple, yet fully functional command-line shell in C. This project not only allows you to grasp concepts such as process management, command execution, and redirection, but it also sets the foundation for exploring more complex shell functionalities.<\/p>\n
As you become more comfortable, consider adding features like handling pipes, supporting environment variables, or even building your own scripting language. The possibilities are endless, and each feature will deepen your understanding of system programming.<\/p>\n
Resources for Further Learning<\/h2>\n
\n
- Linux Manual Page: fork()<\/a><\/li>\n
- Linux Manual Page: exec()<\/a><\/li>\n
- GNU C Library: exec Functions<\/a><\/li>\n<\/ul>\n
By taking the time to build your shell, you’re engaging with fundamental computing concepts that will serve you well as you advance in your software development career.<\/p>\n","protected":false},"excerpt":{"rendered":"
Building a Simple Shell in C: A Step-by-Step Guide If you’re venturing into systems programming or want to strengthen your understanding of process management, building a simple shell in C is an excellent project. Not only does it deepen your grasp of operating system concepts, but it’s also a practical way to learn about process<\/p>\n","protected":false},"author":133,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[1153],"tags":[1232,1231,1233],"class_list":["post-8750","post","type-post","status-publish","format-standard","category-capstone-projects-further-reading","tag-c","tag-shell","tag-unix"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/posts\/8750","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/users\/133"}],"replies":[{"embeddable":true,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/comments?post=8750"}],"version-history":[{"count":1,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/posts\/8750\/revisions"}],"predecessor-version":[{"id":8780,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/posts\/8750\/revisions\/8780"}],"wp:attachment":[{"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/media?parent=8750"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/categories?post=8750"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/tags?post=8750"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}