README.md - Examples

  1# Mini Shell 예제
  2
  3간단한 명령어 쉘 구현 예제입니다.
  4
  5## 파일 구성
  6
  7| 파일 | 설명 |
  8|------|------|
  9| `minishell_v1.c` | 기본 쉘 구조 (명령어 파싱 및 실행) |
 10| `builtins.c` | 내장 명령어 구현 (cd, pwd, echo, help 등) |
 11| `redirect.c` | 입출력 리다이렉션 (>, >>, <) |
 12| `pipe.c` | 파이프 구현 (\|) |
 13| `minishell.c` | 완성된 미니 쉘 (모든 기능 통합) |
 14
 15## 컴파일 및 실행
 16
 17### 1. 기본 쉘 (minishell_v1)
 18
 19가장 간단한 쉘 구조입니다.
 20
 21```bash
 22gcc -o minishell_v1 minishell_v1.c -Wall
 23./minishell_v1
 24```
 25
 26**기능:**
 27- 외부 명령어 실행 (fork + exec)
 28- exit 명령어
 29
 30**예제:**
 31```bash
 32minish> ls -l
 33minish> pwd
 34minish> echo hello world
 35minish> exit
 36```
 37
 38### 2. 내장 명령어 테스트 (builtins)
 39
 40내장 명령어만 따로 테스트합니다.
 41
 42```bash
 43gcc -o builtins builtins.c -Wall -DTEST_BUILTINS
 44./builtins
 45```
 46
 47**기능:**
 48- cd (디렉토리 변경)
 49- pwd (현재 디렉토리)
 50- echo (텍스트 출력)
 51- export (환경변수 설정)
 52- env (환경변수 목록)
 53- help (도움말)
 54
 55**예제:**
 56```bash
 57builtin> pwd
 58builtin> cd /tmp
 59builtin> pwd
 60builtin> cd -
 61builtin> export MY_VAR=hello
 62builtin> echo $MY_VAR
 63builtin> exit
 64```
 65
 66### 3. 리다이렉션 테스트 (redirect)
 67
 68입출력 리다이렉션을 테스트합니다.
 69
 70```bash
 71gcc -o redirect redirect.c -Wall -DTEST_REDIRECT
 72./redirect
 73```
 74
 75**기능:**
 76- `>` : 출력을 파일로 (덮어쓰기)
 77- `>>` : 출력을 파일에 추가
 78- `<` : 파일에서 입력
 79
 80**예제:**
 81```bash
 82redirect> ls -l > files.txt
 83redirect> cat < files.txt
 84redirect> echo "추가 내용" >> files.txt
 85redirect> wc -l < files.txt
 86redirect> exit
 87```
 88
 89### 4. 파이프 테스트 (pipe)
 90
 91파이프 기능을 테스트합니다.
 92
 93```bash
 94gcc -o pipe pipe.c -Wall -DTEST_PIPE
 95./pipe
 96```
 97
 98**기능:**
 99- `|` : 명령어 출력을 다음 명령어 입력으로
100
101**예제:**
102```bash
103pipe> ls -l | grep ".c"
104pipe> cat /etc/passwd | wc -l
105pipe> ps aux | grep bash | head -5
106pipe> exit
107```
108
109### 5. 완성된 미니 쉘 (minishell)
110
111모든 기능이 통합된 완성본입니다.
112
113```bash
114gcc -o minishell minishell.c -Wall -Wextra
115./minishell
116```
117
118**기능:**
119- 내장 명령어 (cd, pwd, echo, export, unset, help, exit)
120- 입출력 리다이렉션 (>, >>, <)
121- 파이프 (|)
122- 환경변수 확장 ($VAR)
123- 시그널 처리 (Ctrl+C)
124- 컬러 프롬프트
125- 종료 코드 표시
126
127**예제:**
128```bash
129~ ❯ help
130~ ❯ pwd
131/Users/username
132~ ❯ cd /tmp
133/tmp ❯ ls -la
134/tmp ❯ echo $HOME
135/Users/username
136/tmp ❯ export MY_VAR=hello
137/tmp ❯ echo $MY_VAR
138hello
139/tmp ❯ ls -l | grep ".txt" | wc -l
140/tmp ❯ cat /etc/passwd | head -5 > first5.txt
141/tmp ❯ cat first5.txt
142/tmp ❯ cd -
143/Users/username
144~ ❯ exit
145```
146
147## Makefile 사용
148
149모든 파일을 한 번에 컴파일:
150
151```bash
152make all
153```
154
155개별 실행 파일 컴파일:
156
157```bash
158make minishell_v1
159make builtins
160make redirect
161make pipe
162make minishell
163```
164
165정리:
166
167```bash
168make clean
169```
170
171## 주요 시스템 콜
172
173| 함수 | 설명 |
174|------|------|
175| `fork()` | 프로세스 복제 |
176| `execvp()` | 프로그램 실행 |
177| `wait()` / `waitpid()` | 자식 프로세스 대기 |
178| `pipe()` | 파이프 생성 |
179| `dup2()` | 파일 디스크립터 복제 |
180| `open()` | 파일 열기 |
181| `chdir()` | 디렉토리 변경 |
182| `getcwd()` | 현재 디렉토리 얻기 |
183| `setenv()` / `getenv()` | 환경변수 설정/조회 |
184| `signal()` | 시그널 핸들러 등록 |
185
186## 학습 순서
187
1881. **minishell_v1.c** - 쉘의 기본 구조 이해
1892. **builtins.c** - 내장 명령어와 외부 명령어의 차이 이해
1903. **redirect.c** - 파일 디스크립터와 리다이렉션 이해
1914. **pipe.c** - 프로세스 간 통신 이해
1925. **minishell.c** - 모든 기능을 통합한 완성본
193
194## 추가 개선 아이디어
195
196- [ ] 히스토리 기능 (history 명령어)
197- [ ] 백그라운드 실행 (&)
198- [ ] 와일드카드 확장 (*)
199- [ ] 세미콜론 지원 (cmd1 ; cmd2)
200- [ ] 논리 연산자 (&& 와 ||)
201- [ ] 따옴표 처리 ("hello world")
202- [ ] 탭 자동완성 (readline 라이브러리)
203- [ ] 작업 제어 (jobs, fg, bg)
204
205## 참고 문서
206
207- `/opt/projects/01_Personal/03_Study/content/ko/C_Programming/12_Project_Mini_Shell.md`