QUICK_START.md - Examples

 1# Quick Start Guide - File Encryption Examples
 2
 3## Build & Run (빠른 시작)
 4
 5```bash
 6# 모든 프로그램 컴파일
 7make
 8
 9# 모든 테스트 실행
10make test
11
12# 정리
13make clean
14```
15
16## 개별 실행 예제
17
18### 1. XOR 데모 보기
19```bash
20gcc -Wall -Wextra -std=c11 simple_xor.c -o simple_xor
21./simple_xor
22```
23
24### 2. 파일 암호화 (기본 버전)
25```bash
26gcc -Wall -Wextra -std=c11 file_encrypt.c -o file_encrypt
27
28# 사용법
29./file_encrypt -e <입력> <출력> <키>    # 암호화
30./file_encrypt -d <입력> <출력> <키>    # 복호화
31
32# 예제
33echo "Secret data" > secret.txt
34./file_encrypt -e secret.txt secret.enc mypassword
35./file_encrypt -d secret.enc decrypted.txt mypassword
36cat decrypted.txt
37```
38
39### 3. 파일 암호화 v2 (헤더 + 검증)
40```bash
41gcc -Wall -Wextra -std=c11 file_encrypt_v2.c -o file_encrypt_v2
42
43# 사용법
44./file_encrypt_v2 encrypt <입력> <출력> <비밀번호>
45./file_encrypt_v2 decrypt <입력> <출력> <비밀번호>
46./file_encrypt_v2 info <암호화파일>
47
48# 예제
49echo "Top secret!" > data.txt
50./file_encrypt_v2 encrypt data.txt data.enc strongpass
51./file_encrypt_v2 info data.enc
52./file_encrypt_v2 decrypt data.enc restored.txt strongpass
53diff data.txt restored.txt  # 동일해야 함
54```
55
56## 주요 차이점
57
58| 기능 | file_encrypt | file_encrypt_v2 |
59|------|--------------|-----------------|
60| 인터페이스 | `-e` / `-d` 옵션 | `encrypt` / `decrypt` 명령 |
61| 파일 헤더 | ✗ | ✓ (XENC 매직 넘버) |
62| 키 검증 | ✗ | ✓ (해시 비교) |
63| 메타데이터 | ✗ | ✓ (원본 크기, 버전) |
64| 파일 정보 | ✗ | ✓ (`info` 명령) |
65| 진행률 표시 | ✗ | ✓ |
66
67## 학습 순서 추천
68
691. `simple_xor.c` - XOR 기본 원리 이해
702. `file_encrypt.c` - 파일 I/O 및 기본 구조
713. `file_encrypt_v2.c` - 헤더, 검증, 고급 기능
72
73## 보안 경고
74
75⚠️ **학습 전용 - 실제 보안 용도로 사용 금지**
76
77실제 암호화가 필요한 경우:
78- `openssl enc -aes-256-cbc -in file -out file.enc`
79- GPG (GNU Privacy Guard)
80- libsodium 라이브러리