Compare commits
39 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 864c0356da | |||
| 35175790e2 | |||
| 04ea4fb848 | |||
| 5c61ba7ea8 | |||
| a45b304d22 | |||
| 403d013224 | |||
| 82533d96e4 | |||
| 5b619384a1 | |||
| 12b9884572 | |||
| 83b60b5cc2 | |||
| 2d6546ab83 | |||
| c255185084 | |||
| 24800d69d5 | |||
| 7e50727163 | |||
| f118c23c60 | |||
| b149175f24 | |||
| 206e8042d8 | |||
| 2a5249d93c | |||
| 0e02eaee53 | |||
| e32eb8b2b1 | |||
| 0aecae0c5e | |||
| fa90e0eafd | |||
| 2a10d974b2 | |||
| 7e04896394 | |||
| 0cdf6e7804 | |||
| 268758a21b | |||
| 85ef39d283 | |||
| 2c864f1feb | |||
| ae0afcfffd | |||
| e45aa04b05 | |||
| 8e1fcdb108 | |||
| 29f4a67c1c | |||
| 146da4e883 | |||
| 3152a7777f | |||
| 68a2a0c252 | |||
| bb17b0a7be | |||
| 487432c399 | |||
| f521349cc0 | |||
| 4b822962bb |
7
.clinerules/workspace_rules.md
Normal file
7
.clinerules/workspace_rules.md
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
|
||||||
|
When building, use build.sh, not make.
|
||||||
|
|
||||||
|
Use it as follows: build.sh -m "useful comment on changes being made"
|
||||||
|
|
||||||
|
When making TUI menus, try to use the first leter of the command and the key to press to execute that command. For example, if the command is "Open file" try to use a keypress of "o" upper or lower case to signal to open the file. Use this instead of number keyed menus when possible. In the command, the letter should be underlined that signifies the command.
|
||||||
|
|
||||||
7
.gitignore
vendored
7
.gitignore
vendored
@@ -1,2 +1,9 @@
|
|||||||
|
otp
|
||||||
pads/
|
pads/
|
||||||
Gemini.md
|
Gemini.md
|
||||||
|
TropicOfCancer-HenryMiller.txt
|
||||||
|
|
||||||
|
# Auto-generated version files
|
||||||
|
src/version.h
|
||||||
|
src/version.c
|
||||||
|
VERSION
|
||||||
|
|||||||
14
Makefile
14
Makefile
@@ -1,14 +1,22 @@
|
|||||||
CC = gcc
|
CC = gcc
|
||||||
CFLAGS = -Wall -Wextra -std=c99
|
CFLAGS = -Wall -Wextra -std=c99
|
||||||
LIBS = -lssl -lcrypto
|
LIBS =
|
||||||
|
LIBS_STATIC = -static
|
||||||
TARGET = otp
|
TARGET = otp
|
||||||
SOURCE = otp.c
|
SOURCE = otp.c
|
||||||
|
VERSION_SOURCE = src/version.c
|
||||||
|
|
||||||
|
# Default build target
|
||||||
$(TARGET): $(SOURCE)
|
$(TARGET): $(SOURCE)
|
||||||
$(CC) $(CFLAGS) -o $(TARGET) $(SOURCE) $(LIBS)
|
$(CC) $(CFLAGS) -o $(TARGET) $(SOURCE) $(VERSION_SOURCE) $(LIBS)
|
||||||
|
|
||||||
|
# Static linking target
|
||||||
|
static: $(SOURCE)
|
||||||
|
$(CC) $(CFLAGS) -o $(TARGET) $(SOURCE) $(VERSION_SOURCE) $(LIBS_STATIC)
|
||||||
|
|
||||||
clean:
|
clean:
|
||||||
rm -f $(TARGET) *.pad *.state
|
rm -f $(TARGET) *.pad *.state
|
||||||
|
rm -f src/version.h src/version.c VERSION
|
||||||
|
|
||||||
install:
|
install:
|
||||||
sudo cp $(TARGET) /usr/local/bin/
|
sudo cp $(TARGET) /usr/local/bin/
|
||||||
@@ -16,4 +24,4 @@ install:
|
|||||||
uninstall:
|
uninstall:
|
||||||
sudo rm -f /usr/local/bin/$(TARGET)
|
sudo rm -f /usr/local/bin/$(TARGET)
|
||||||
|
|
||||||
.PHONY: clean install uninstall
|
.PHONY: clean install uninstall static
|
||||||
|
|||||||
440
README.md
440
README.md
@@ -1,273 +1,281 @@
|
|||||||
# OTP Cipher v2.0 - Enhanced One Time Pad Implementation
|
# OTP Cipher - One Time Pad Implementation
|
||||||
|
|
||||||
A comprehensive and user-friendly One Time Pad (OTP) cryptographic system implemented in C for Linux, supporting massive pad sizes up to 10TB+ with both interactive and command-line interfaces.
|
A secure one-time pad (OTP) cipher implementation in C with automatic versioning system.
|
||||||
|
|
||||||
## New in Version 2.0 🚀
|
|
||||||
|
|
||||||
- **Interactive Menu System** - User-friendly menu-driven interface
|
|
||||||
- **Smart Size Parsing** - Supports K/KB/M/MB/G/GB/T/TB units
|
|
||||||
- **Partial Hash Matching** - Use hash prefixes or pad numbers for selection
|
|
||||||
- **Progress Indicators** - Real-time progress for large pad generation
|
|
||||||
- **10TB+ Support** - Generate massive pads for external drives
|
|
||||||
- **Enhanced Pad Management** - List, info, and usage statistics
|
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
- **Cryptographically secure** random pad generation using `/dev/urandom`
|
- **Perfect Security**: Implements true one-time pad encryption with information-theoretic security
|
||||||
- **ASCII armor format** similar to PGP for encrypted messages
|
- **Text & File Encryption**: Supports both inline text and file encryption
|
||||||
- **Integrity verification** using SHA-256 hashing of pad files
|
- **Multiple Output Formats**: Binary (.otp) and ASCII armored (.otp.asc) file formats
|
||||||
- **State management** to prevent pad reuse
|
- **Keyboard Entropy**: Optional keyboard entropy collection for enhanced randomness
|
||||||
- **Interactive text encryption/decryption**
|
- **Short Command Flags**: Convenient single-character flags for all operations
|
||||||
- **Hash-based file naming** for content verification
|
- **Automatic Versioning**: Built-in semantic versioning with automatic patch increment
|
||||||
- **Read-only pad protection** prevents accidental corruption
|
- **Multiple Build Options**: Standard and static linking builds
|
||||||
|
- **Cross-Platform**: Works on Linux and other UNIX-like systems
|
||||||
|
|
||||||
## Dependencies
|
## Version Information
|
||||||
|
|
||||||
- OpenSSL development libraries (`libssl-dev` on Ubuntu/Debian)
|
This project uses an automatic versioning system that:
|
||||||
- GCC compiler
|
- Automatically increments the patch version on each build
|
||||||
|
- Embeds build timestamp, git commit hash, and branch information
|
||||||
|
- Creates git tags for version tracking
|
||||||
|
- Generates version header files with detailed build metadata
|
||||||
|
|
||||||
### Install dependencies on Ubuntu/Debian:
|
Current version can be viewed with: `./otp --help` or by running the interactive mode.
|
||||||
```bash
|
|
||||||
sudo apt update
|
|
||||||
sudo apt install libssl-dev build-essential
|
|
||||||
```
|
|
||||||
|
|
||||||
## Building
|
## Building
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
- GCC compiler
|
||||||
|
- Git (for version tracking)
|
||||||
|
- Make
|
||||||
|
|
||||||
|
**Note: OpenSSL is no longer required! This implementation is now completely self-contained.**
|
||||||
|
|
||||||
|
### Build Commands
|
||||||
|
|
||||||
|
Use the included build script for automatic versioning:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
make
|
# Standard build (default)
|
||||||
|
./build.sh build
|
||||||
|
|
||||||
|
# Static linking build
|
||||||
|
./build.sh static
|
||||||
|
|
||||||
|
# Clean build artifacts
|
||||||
|
./build.sh clean
|
||||||
|
|
||||||
|
# Generate version files only
|
||||||
|
./build.sh version
|
||||||
|
|
||||||
|
# Install to system
|
||||||
|
./build.sh install
|
||||||
|
|
||||||
|
# Remove from system
|
||||||
|
./build.sh uninstall
|
||||||
|
|
||||||
|
# Show usage
|
||||||
|
./build.sh help
|
||||||
```
|
```
|
||||||
|
|
||||||
This will create the `otp` executable.
|
### Traditional Make
|
||||||
|
|
||||||
## Usage Modes
|
You can also use make directly (without automatic versioning):
|
||||||
|
|
||||||
### Interactive Mode (Recommended)
|
```bash
|
||||||
|
make # Standard build
|
||||||
|
make static # Static linking
|
||||||
|
make clean # Clean artifacts
|
||||||
|
make install # Install to /usr/local/bin/
|
||||||
|
make uninstall # Remove from system
|
||||||
|
```
|
||||||
|
|
||||||
Simply run the program without arguments:
|
## Usage
|
||||||
|
|
||||||
|
### Interactive Mode
|
||||||
```bash
|
```bash
|
||||||
./otp
|
./otp
|
||||||
```
|
```
|
||||||
|
|
||||||
This launches a menu-driven interface:
|
|
||||||
```
|
|
||||||
=== OTP Cipher Interactive Mode ===
|
|
||||||
Version: OTP-CIPHER 2.0
|
|
||||||
|
|
||||||
=== Main Menu ===
|
|
||||||
1. Generate new pad
|
|
||||||
2. Encrypt message
|
|
||||||
3. Decrypt message
|
|
||||||
4. List available pads
|
|
||||||
5. Show pad information
|
|
||||||
6. Exit
|
|
||||||
```
|
|
||||||
|
|
||||||
### Command Line Mode
|
### Command Line Mode
|
||||||
|
|
||||||
For automation and scripting:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./otp generate <size> # Generate new pad
|
# Generate a new pad
|
||||||
./otp encrypt <pad_hash_prefix> # Encrypt text
|
|
||||||
./otp decrypt <pad_hash_prefix> # Decrypt message
|
|
||||||
./otp list # List available pads
|
|
||||||
```
|
|
||||||
|
|
||||||
## Smart Size Parsing
|
|
||||||
|
|
||||||
The system intelligently parses size specifications:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./otp generate 1024 # 1024 bytes
|
|
||||||
./otp generate 5MB # 5 megabytes
|
|
||||||
./otp generate 2GB # 2 gigabytes
|
|
||||||
./otp generate 10TB # 10 terabytes
|
|
||||||
./otp generate 1.5GB # 1.5 gigabytes (decimal supported)
|
|
||||||
```
|
|
||||||
|
|
||||||
**Supported units:** K, KB, M, MB, G, GB, T, TB (case insensitive)
|
|
||||||
|
|
||||||
## Pad Selection
|
|
||||||
|
|
||||||
Multiple convenient ways to select pads:
|
|
||||||
|
|
||||||
1. **Full hash**: `./otp encrypt a1b2c3d4e5f6789012345678901234567890abcdef...`
|
|
||||||
2. **Hash prefix**: `./otp encrypt a1b2c3d4`
|
|
||||||
3. **Pad number**: `./otp encrypt 1` (from list output)
|
|
||||||
|
|
||||||
## Example Workflows
|
|
||||||
|
|
||||||
### Basic Usage
|
|
||||||
```bash
|
|
||||||
# Generate a 1GB pad
|
|
||||||
./otp generate 1GB
|
./otp generate 1GB
|
||||||
Generated pad: a1b2c3d4e5f6789...123456.pad (1.00 GB)
|
|
||||||
Pad hash: a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456
|
# Encrypt text (interactive input)
|
||||||
|
./otp encrypt <pad_hash_or_prefix>
|
||||||
|
|
||||||
|
# Decrypt message (interactive input)
|
||||||
|
./otp decrypt <pad_hash_or_prefix>
|
||||||
|
|
||||||
# List available pads
|
# List available pads
|
||||||
./otp list
|
./otp list
|
||||||
Available pads:
|
|
||||||
No. Hash (first 16 chars) Size Used
|
|
||||||
--- ------------------- ---------- ----------
|
|
||||||
1 a1b2c3d4e5f67890 1.00GB 0.0MB
|
|
||||||
|
|
||||||
# Encrypt using hash prefix
|
|
||||||
./otp encrypt a1b2
|
|
||||||
Enter text to encrypt: Secret message
|
|
||||||
-----BEGIN OTP MESSAGE-----
|
|
||||||
Version: OTP-CIPHER 2.0
|
|
||||||
Pad-Hash: a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456
|
|
||||||
Pad-Offset: 0
|
|
||||||
|
|
||||||
U2VjcmV0IG1lc3NhZ2U=
|
|
||||||
-----END OTP MESSAGE-----
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Large Scale Usage
|
## Version System Details
|
||||||
|
|
||||||
|
### Automatic Version Increment
|
||||||
|
Every build automatically increments the patch version:
|
||||||
|
- v0.1.0 → v0.1.1 → v0.1.2, etc.
|
||||||
|
- Creates git tags for each version
|
||||||
|
- Embeds detailed build information
|
||||||
|
|
||||||
|
### Manual Version Control
|
||||||
|
For major/minor releases, create tags manually:
|
||||||
```bash
|
```bash
|
||||||
# Generate a 5TB pad for external drive
|
# Feature release (minor bump)
|
||||||
./otp generate 5TB
|
git tag v0.2.0 # Next build: v0.2.1
|
||||||
Progress: 100.0% (85.2 MB/s, ETA: 0s)
|
|
||||||
Generated pad: f9e8d7c6b5a4932...654321.pad (5.00 TB)
|
|
||||||
|
|
||||||
# Use pad number for quick selection
|
# Breaking change (major bump)
|
||||||
./otp encrypt 1
|
git tag v1.0.0 # Next build: v1.0.1
|
||||||
Enter text to encrypt: Classified information
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Interactive Mode Workflow
|
### Version Information Available
|
||||||
```bash
|
- Version number (major.minor.patch)
|
||||||
./otp
|
- Git commit hash and branch
|
||||||
# Select option 1 to generate
|
- Build date and time
|
||||||
# Enter size: 10GB
|
- Full version display with metadata
|
||||||
# Select option 2 to encrypt
|
|
||||||
# Choose pad from list
|
### Generated Files
|
||||||
# Enter your message
|
The build system automatically generates:
|
||||||
```
|
- `src/version.h` - Version constants and macros
|
||||||
|
- `src/version.c` - Version API functions
|
||||||
|
- `VERSION` - Plain text version number
|
||||||
|
|
||||||
|
These files are excluded from git (.gitignore) and regenerated on each build.
|
||||||
|
|
||||||
## Security Features
|
## Security Features
|
||||||
|
|
||||||
### Perfect Forward Secrecy
|
- Uses `/dev/urandom` for cryptographically secure random number generation
|
||||||
Each message uses a unique portion of the pad that is never reused, ensuring perfect forward secrecy.
|
- Optional keyboard entropy mixing using simple XOR operations
|
||||||
|
- Custom 256-bit XOR checksum for pad identification (encrypted with pad data)
|
||||||
### Content-Based Integrity
|
- Read-only pad files to prevent accidental modification
|
||||||
- **SHA-256 file naming**: Pad files named by their hash ensure content verification
|
- State tracking to prevent pad reuse
|
||||||
- **Integrity checking**: Embedded hashes detect pad corruption/tampering
|
- **Zero external crypto dependencies** - completely self-contained implementation
|
||||||
- **Read-only protection**: Pad files automatically set to read-only after creation
|
|
||||||
|
|
||||||
### ASCII Armor Format
|
|
||||||
Messages use a PGP-like ASCII armor format:
|
|
||||||
```
|
|
||||||
-----BEGIN OTP MESSAGE-----
|
|
||||||
Version: OTP-CIPHER 2.0
|
|
||||||
Pad-Hash: a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456
|
|
||||||
Pad-Offset: 0
|
|
||||||
|
|
||||||
U2VjcmV0IG1lc3NhZ2U=
|
|
||||||
-----END OTP MESSAGE-----
|
|
||||||
```
|
|
||||||
|
|
||||||
### State Management
|
|
||||||
- **Automatic tracking**: Prevents pad reuse through state files
|
|
||||||
- **Portable state**: State stored separately from immutable pad data
|
|
||||||
- **Usage statistics**: Track pad consumption and remaining capacity
|
|
||||||
|
|
||||||
## File Structure
|
## File Structure
|
||||||
|
|
||||||
**Source Files:**
|
|
||||||
- `otp.c` - Complete implementation (850+ lines)
|
|
||||||
- `Makefile` - Build configuration
|
|
||||||
- `README.md` - This documentation
|
|
||||||
|
|
||||||
**Generated Files:**
|
|
||||||
- `otp` - Compiled executable
|
|
||||||
- `<hash>.pad` - Pad files (read-only, hash-named)
|
|
||||||
- `<hash>.state` - State files (writable, tracks usage)
|
|
||||||
|
|
||||||
## Advanced Features
|
|
||||||
|
|
||||||
### Progress Indicators
|
|
||||||
For large pads, see real-time generation progress:
|
|
||||||
```
|
```
|
||||||
Generating pad...
|
otp/
|
||||||
Progress: 45.2% (78.5 MB/s, ETA: 125s)
|
├── build.sh # Build script with automatic versioning
|
||||||
|
├── Makefile # Traditional make build system
|
||||||
|
├── otp.c # Main source code
|
||||||
|
├── README.md # This file
|
||||||
|
├── .gitignore # Git ignore rules
|
||||||
|
├── src/ # Generated version files (auto-created)
|
||||||
|
│ ├── version.h # Version header (generated)
|
||||||
|
│ └── version.c # Version implementation (generated)
|
||||||
|
├── pads/ # OTP pad storage directory (created at runtime)
|
||||||
|
└── VERSION # Plain text version (generated)
|
||||||
```
|
```
|
||||||
|
|
||||||
### Pad Information
|
## File Formats
|
||||||
Detailed statistics for each pad:
|
|
||||||
|
### .otp File Format (Binary)
|
||||||
|
|
||||||
|
Binary encrypted files use a structured header format:
|
||||||
|
|
||||||
|
```
|
||||||
|
Offset | Size | Field | Description
|
||||||
|
-------|------|-------------------|----------------------------------
|
||||||
|
0 | 4 | Magic | "OTP\0" - File type identifier
|
||||||
|
4 | 2 | Version | Format version (currently 1)
|
||||||
|
6 | 32 | Pad Checksum | Binary pad checksum (32 bytes)
|
||||||
|
38 | 8 | Pad Offset | Offset in pad file (uint64_t)
|
||||||
|
46 | 4 | File Mode | Original file permissions (uint32_t)
|
||||||
|
50 | 8 | File Size | Original file size (uint64_t)
|
||||||
|
58 | var | Encrypted Data | XOR-encrypted file contents
|
||||||
|
```
|
||||||
|
|
||||||
|
### .otp.asc File Format (ASCII Armored)
|
||||||
|
|
||||||
|
ASCII armored files use the same format as encrypted text messages:
|
||||||
|
|
||||||
|
```
|
||||||
|
-----BEGIN OTP MESSAGE-----
|
||||||
|
Version: v0.2.15
|
||||||
|
Pad-ChkSum: <64-character-hex-checksum>
|
||||||
|
Pad-Offset: <decimal-offset-value>
|
||||||
|
|
||||||
|
<base64-encoded-encrypted-data>
|
||||||
|
-----END OTP MESSAGE-----
|
||||||
|
```
|
||||||
|
|
||||||
|
**Note:** ASCII armored files do not preserve original file permissions metadata.
|
||||||
|
|
||||||
|
## Usage Examples
|
||||||
|
|
||||||
|
### Short Command Flags
|
||||||
```bash
|
```bash
|
||||||
./otp list
|
# Quick commands using short flags
|
||||||
No. Hash (first 16 chars) Size Used
|
./otp -g 1GB # Generate 1GB pad
|
||||||
--- ------------------- ---------- ----------
|
./otp -l # List available pads
|
||||||
1 a1b2c3d4e5f67890 5.00TB 2.1GB
|
./otp -e 1a2b "Hello world" # Encrypt text inline
|
||||||
2 f9e8d7c6b5a49321 1.00GB 0.5GB
|
./otp -d "-----BEGIN OTP..." # Decrypt message inline
|
||||||
|
|
||||||
|
# File operations
|
||||||
|
./otp -f document.pdf 1a2b # Encrypt file (binary)
|
||||||
|
./otp -f document.pdf 1a2b -a # Encrypt file (ASCII)
|
||||||
|
./otp -f document.pdf 1a2b -o secret.otp # Custom output name
|
||||||
```
|
```
|
||||||
|
|
||||||
### Multiple Pad Management
|
### Text Encryption
|
||||||
- List all available pads
|
|
||||||
- Show detailed information per pad
|
|
||||||
- Track usage across multiple pads
|
|
||||||
- Quick selection by number or prefix
|
|
||||||
|
|
||||||
## Performance
|
|
||||||
|
|
||||||
### Size Limits
|
|
||||||
- **Theoretical maximum**: 18 exabytes (uint64_t limit)
|
|
||||||
- **Practical maximum**: Limited by available disk space
|
|
||||||
- **Tested up to**: 10TB+ on modern systems
|
|
||||||
- **Generation speed**: ~80-120 MB/s (system dependent)
|
|
||||||
|
|
||||||
### Memory Efficiency
|
|
||||||
- **Streaming operation**: Constant memory usage regardless of pad size
|
|
||||||
- **64KB buffers**: Efficient I/O without excessive memory consumption
|
|
||||||
- **Large file support**: Handles multi-terabyte pads efficiently
|
|
||||||
|
|
||||||
## Security Notes
|
|
||||||
|
|
||||||
⚠️ **Critical Security Requirements:**
|
|
||||||
|
|
||||||
1. **Never reuse pad data** - Automatic prevention through state tracking
|
|
||||||
2. **Secure pad distribution** - Use secure channels for pad sharing
|
|
||||||
3. **Physical security** - Protect pad files like encryption keys
|
|
||||||
4. **Verify integrity** - Always check pad hash verification during decryption
|
|
||||||
5. **Secure systems** - Generate pads on trusted systems with good entropy
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
### Local Installation
|
|
||||||
```bash
|
```bash
|
||||||
make install # Install to /usr/local/bin
|
# Interactive text encryption
|
||||||
make uninstall # Remove from system
|
./otp encrypt 1a2b3c
|
||||||
|
Enter text to encrypt: This is my secret message
|
||||||
|
# Outputs ASCII armored message
|
||||||
|
|
||||||
|
# Inline text encryption
|
||||||
|
./otp -e 1a2b3c "This is my secret message"
|
||||||
|
# Outputs ASCII armored message immediately
|
||||||
```
|
```
|
||||||
|
|
||||||
### Clean Up
|
### File Encryption
|
||||||
```bash
|
```bash
|
||||||
make clean # Remove compiled files and generated pads
|
# Binary format (preserves metadata)
|
||||||
|
./otp -f sensitive.doc a1b2c3
|
||||||
|
|
||||||
|
# ASCII armored format (text-safe)
|
||||||
|
./otp -f sensitive.doc a1b2c3 -a
|
||||||
|
|
||||||
|
# Custom output filename
|
||||||
|
./otp -f sensitive.doc a1b2c3 -o encrypted_document.otp
|
||||||
```
|
```
|
||||||
|
|
||||||
## Technical Specifications
|
### Decryption
|
||||||
|
```bash
|
||||||
|
# Auto-detect format and pad from message/file
|
||||||
|
./otp -d encrypted.otp.asc
|
||||||
|
./otp -d "-----BEGIN OTP MESSAGE-----..."
|
||||||
|
|
||||||
- **Entropy source**: `/dev/urandom` (cryptographically secure)
|
# Interactive mode
|
||||||
- **Hash algorithm**: SHA-256 for integrity verification
|
./otp decrypt
|
||||||
- **Encoding**: Base64 for ciphertext representation
|
# Prompts for encrypted message input
|
||||||
- **File format**: ASCII armor with embedded metadata
|
```
|
||||||
- **Architecture**: Single C file, ~850 lines
|
|
||||||
- **Dependencies**: OpenSSL libcrypto
|
|
||||||
- **Platform**: Linux (easily portable)
|
|
||||||
|
|
||||||
## Theory
|
### Build and Version Tracking
|
||||||
|
```bash
|
||||||
|
$ ./build.sh build
|
||||||
|
[INFO] Incrementing version...
|
||||||
|
[INFO] Current version: v0.2.14
|
||||||
|
[INFO] New version: v0.2.15
|
||||||
|
[SUCCESS] Created new version tag: v0.2.15
|
||||||
|
[SUCCESS] Build completed successfully
|
||||||
|
|
||||||
A One Time Pad is theoretically unbreakable when implemented correctly with:
|
$ ./otp --help
|
||||||
- **Perfect randomness**: Cryptographically secure entropy
|
OTP Cipher - One Time Pad Implementation v0.2.15
|
||||||
- **Key length**: Equal to or greater than message length
|
Built on 2025-08-10 at 14:07:58 from commit ae0afcf on branch master
|
||||||
- **Single use**: Each pad portion used exactly once
|
```
|
||||||
- **Secure distribution**: Pads shared through secure channels
|
|
||||||
|
|
||||||
This implementation satisfies all requirements for perfect cryptographic security while providing modern usability features for practical deployment.
|
### Advanced Features
|
||||||
|
```bash
|
||||||
|
# Generate pad with keyboard entropy
|
||||||
|
./otp generate 5GB
|
||||||
|
# Follow prompts for keyboard entropy collection
|
||||||
|
|
||||||
## Version History
|
# Check pad usage
|
||||||
|
./otp -l
|
||||||
|
Available pads:
|
||||||
|
No. ChkSum (first 16 chars) Size Used % Used
|
||||||
|
--- ------------------- ---------- ---------- ------
|
||||||
|
1 97d9d82b5414a943 1.00GB 156B 0.0%
|
||||||
|
2 0c8e19fde996e683 1000B 248B 24.8%
|
||||||
|
|
||||||
- **v2.0**: Interactive mode, smart parsing, 10TB+ support, enhanced UX
|
# Show detailed pad information
|
||||||
- **v1.0**: Basic command-line implementation with hash-based naming
|
./otp
|
||||||
|
# Select "S" for show pad info, enter checksum or prefix
|
||||||
|
```
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project includes automatic versioning system based on the Generic Automatic Version Increment System.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
When contributing:
|
||||||
|
1. The version will automatically increment on builds
|
||||||
|
2. For major features, consider manually creating minor version tags
|
||||||
|
3. Generated version files (`src/version.*`, `VERSION`) should not be committed
|
||||||
|
|||||||
293
build.sh
Executable file
293
build.sh
Executable file
@@ -0,0 +1,293 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
set -e
|
||||||
|
|
||||||
|
# Colors for output
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
BLUE='\033[0;34m'
|
||||||
|
NC='\033[0m'
|
||||||
|
|
||||||
|
print_status() { echo -e "${BLUE}[INFO]${NC} $1"; }
|
||||||
|
print_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
|
||||||
|
print_warning() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
|
||||||
|
print_error() { echo -e "${RED}[ERROR]${NC} $1"; }
|
||||||
|
|
||||||
|
# Global variable for commit message
|
||||||
|
COMMIT_MESSAGE=""
|
||||||
|
|
||||||
|
# Parse command line arguments for -m flag
|
||||||
|
while [[ $# -gt 0 ]]; do
|
||||||
|
case $1 in
|
||||||
|
-m|--message)
|
||||||
|
COMMIT_MESSAGE="$2"
|
||||||
|
shift 2
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
# Keep other arguments for main logic
|
||||||
|
break
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
# Function to automatically increment version
|
||||||
|
increment_version() {
|
||||||
|
print_status "Incrementing version..."
|
||||||
|
|
||||||
|
# Check if we're in a git repository
|
||||||
|
if ! git rev-parse --git-dir > /dev/null 2>&1; then
|
||||||
|
print_warning "Not in a git repository - skipping version increment"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Get the highest version tag (not chronologically latest)
|
||||||
|
LATEST_TAG=$(git tag -l 'v*.*.*' | sort -V | tail -n 1 || echo "v0.1.0")
|
||||||
|
if [[ -z "$LATEST_TAG" ]]; then
|
||||||
|
LATEST_TAG="v0.1.0"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Extract version components (remove 'v' prefix)
|
||||||
|
VERSION=${LATEST_TAG#v}
|
||||||
|
|
||||||
|
# Parse major.minor.patch using regex
|
||||||
|
if [[ $VERSION =~ ^([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
|
||||||
|
MAJOR=${BASH_REMATCH[1]}
|
||||||
|
MINOR=${BASH_REMATCH[2]}
|
||||||
|
PATCH=${BASH_REMATCH[3]}
|
||||||
|
else
|
||||||
|
print_error "Invalid version format in tag: $LATEST_TAG"
|
||||||
|
print_error "Expected format: v0.1.0"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Increment patch version
|
||||||
|
NEW_PATCH=$((PATCH + 1))
|
||||||
|
NEW_VERSION="v${MAJOR}.${MINOR}.${NEW_PATCH}"
|
||||||
|
|
||||||
|
print_status "Current version: $LATEST_TAG"
|
||||||
|
print_status "New version: $NEW_VERSION"
|
||||||
|
|
||||||
|
# Stage all changes
|
||||||
|
if git add . 2>/dev/null; then
|
||||||
|
print_success "Staged all changes"
|
||||||
|
else
|
||||||
|
print_warning "Failed to stage changes (maybe not a git repository)"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Handle commit message - use global variable if set, otherwise prompt
|
||||||
|
if [[ -z "$COMMIT_MESSAGE" ]]; then
|
||||||
|
echo ""
|
||||||
|
print_status "Please enter a meaningful commit message for version $NEW_VERSION:"
|
||||||
|
echo -n "> "
|
||||||
|
read -r COMMIT_MESSAGE
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check if user provided a message
|
||||||
|
if [[ -z "$COMMIT_MESSAGE" ]]; then
|
||||||
|
print_warning "No commit message provided. Using default message."
|
||||||
|
COMMIT_MESSAGE="Automatic version increment"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Commit changes with user-provided message
|
||||||
|
if git commit -m "Version $NEW_VERSION - $COMMIT_MESSAGE" 2>/dev/null; then
|
||||||
|
print_success "Committed changes for version $NEW_VERSION"
|
||||||
|
else
|
||||||
|
print_warning "Failed to commit changes (maybe no changes to commit or not a git repository)"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Create new git tag
|
||||||
|
if git tag "$NEW_VERSION" 2>/dev/null; then
|
||||||
|
print_success "Created new version tag: $NEW_VERSION"
|
||||||
|
|
||||||
|
# Push changes and tags to remote repository
|
||||||
|
if git push ssh://ubuntu@laantungir.net:/home/ubuntu/git_repos/otp 2>/dev/null; then
|
||||||
|
print_success "Pushed changes to remote repository"
|
||||||
|
else
|
||||||
|
print_warning "Failed to push changes to remote repository"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if git push ssh://ubuntu@laantungir.net:/home/ubuntu/git_repos/otp --tags 2>/dev/null; then
|
||||||
|
print_success "Pushed tags to remote repository"
|
||||||
|
else
|
||||||
|
print_warning "Failed to push tags to remote repository"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
print_warning "Tag $NEW_VERSION already exists - using existing version"
|
||||||
|
NEW_VERSION=$LATEST_TAG
|
||||||
|
# Re-extract version components for existing tag
|
||||||
|
VERSION=${NEW_VERSION#v}
|
||||||
|
if [[ $VERSION =~ ^([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
|
||||||
|
MAJOR=${BASH_REMATCH[1]}
|
||||||
|
MINOR=${BASH_REMATCH[2]}
|
||||||
|
NEW_PATCH=${BASH_REMATCH[3]}
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Update VERSION file for compatibility
|
||||||
|
echo "${NEW_VERSION#v}" > VERSION
|
||||||
|
print_success "Updated VERSION file to ${NEW_VERSION#v}"
|
||||||
|
|
||||||
|
# Generate version.h header file
|
||||||
|
mkdir -p src
|
||||||
|
cat > src/version.h << EOF
|
||||||
|
/*
|
||||||
|
* Auto-Generated Version Header
|
||||||
|
* DO NOT EDIT THIS FILE MANUALLY - Generated by build script
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef VERSION_H
|
||||||
|
#define VERSION_H
|
||||||
|
|
||||||
|
#define VERSION_MAJOR ${MAJOR}
|
||||||
|
#define VERSION_MINOR ${MINOR}
|
||||||
|
#define VERSION_PATCH ${NEW_PATCH}
|
||||||
|
#define VERSION_STRING "${MAJOR}.${MINOR}.${NEW_PATCH}"
|
||||||
|
#define VERSION_TAG "${NEW_VERSION}"
|
||||||
|
|
||||||
|
/* Build information */
|
||||||
|
#define BUILD_DATE "$(date +%Y-%m-%d)"
|
||||||
|
#define BUILD_TIME "$(date +%H:%M:%S)"
|
||||||
|
#define BUILD_TIMESTAMP "$(date '+%Y-%m-%d %H:%M:%S')"
|
||||||
|
|
||||||
|
/* Git information */
|
||||||
|
#define GIT_HASH "$(git rev-parse --short HEAD 2>/dev/null || echo 'unknown')"
|
||||||
|
#define GIT_BRANCH "$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo 'unknown')"
|
||||||
|
|
||||||
|
/* Display versions */
|
||||||
|
#define VERSION_DISPLAY "${NEW_VERSION}"
|
||||||
|
#define VERSION_FULL_DISPLAY "${NEW_VERSION} ($(date '+%Y-%m-%d %H:%M:%S'), $(git rev-parse --short HEAD 2>/dev/null || echo 'unknown'))"
|
||||||
|
|
||||||
|
/* Version API functions */
|
||||||
|
const char* get_version(void);
|
||||||
|
const char* get_version_full(void);
|
||||||
|
const char* get_build_info(void);
|
||||||
|
|
||||||
|
#endif /* VERSION_H */
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# Generate version.c implementation file
|
||||||
|
cat > src/version.c << EOF
|
||||||
|
/*
|
||||||
|
* Auto-Generated Version Implementation
|
||||||
|
* DO NOT EDIT THIS FILE MANUALLY - Generated by build script
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include "version.h"
|
||||||
|
|
||||||
|
const char* get_version(void) {
|
||||||
|
return VERSION_TAG;
|
||||||
|
}
|
||||||
|
|
||||||
|
const char* get_version_full(void) {
|
||||||
|
return VERSION_FULL_DISPLAY;
|
||||||
|
}
|
||||||
|
|
||||||
|
const char* get_build_info(void) {
|
||||||
|
return "Built on " BUILD_DATE " at " BUILD_TIME " from commit " GIT_HASH " on branch " GIT_BRANCH;
|
||||||
|
}
|
||||||
|
EOF
|
||||||
|
|
||||||
|
print_success "Generated version header files"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Build functions
|
||||||
|
build_project() {
|
||||||
|
print_status "Cleaning previous build..."
|
||||||
|
make clean
|
||||||
|
increment_version
|
||||||
|
print_status "Building OTP project..."
|
||||||
|
make
|
||||||
|
if [ $? -eq 0 ]; then
|
||||||
|
print_success "Build completed successfully"
|
||||||
|
else
|
||||||
|
print_error "Build failed"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
build_static() {
|
||||||
|
print_status "Cleaning previous build..."
|
||||||
|
make clean
|
||||||
|
increment_version
|
||||||
|
print_status "Building OTP project with static linking..."
|
||||||
|
make static
|
||||||
|
if [ $? -eq 0 ]; then
|
||||||
|
print_success "Static build completed successfully"
|
||||||
|
else
|
||||||
|
print_error "Static build failed"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
clean_project() {
|
||||||
|
print_status "Cleaning build artifacts..."
|
||||||
|
make clean
|
||||||
|
rm -f VERSION src/version.h src/version.c
|
||||||
|
print_success "Clean completed"
|
||||||
|
}
|
||||||
|
|
||||||
|
install_project() {
|
||||||
|
print_status "Installing OTP project..."
|
||||||
|
make install
|
||||||
|
if [ $? -eq 0 ]; then
|
||||||
|
print_success "Installation completed"
|
||||||
|
else
|
||||||
|
print_error "Installation failed"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
uninstall_project() {
|
||||||
|
print_status "Uninstalling OTP project..."
|
||||||
|
make uninstall
|
||||||
|
if [ $? -eq 0 ]; then
|
||||||
|
print_success "Uninstallation completed"
|
||||||
|
else
|
||||||
|
print_error "Uninstallation failed"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Main script logic
|
||||||
|
case "${1:-build}" in
|
||||||
|
build)
|
||||||
|
build_project
|
||||||
|
;;
|
||||||
|
static)
|
||||||
|
build_static
|
||||||
|
;;
|
||||||
|
clean)
|
||||||
|
clean_project
|
||||||
|
;;
|
||||||
|
install)
|
||||||
|
install_project
|
||||||
|
;;
|
||||||
|
uninstall)
|
||||||
|
uninstall_project
|
||||||
|
;;
|
||||||
|
version)
|
||||||
|
increment_version
|
||||||
|
print_status "Version information generated"
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "OTP Cipher Build Script"
|
||||||
|
echo "Usage: $0 [-m \"commit message\"] {build|static|clean|install|uninstall|version}"
|
||||||
|
echo ""
|
||||||
|
echo "Options:"
|
||||||
|
echo " -m, --message \"text\" - Specify commit message (skips interactive prompt)"
|
||||||
|
echo ""
|
||||||
|
echo "Commands:"
|
||||||
|
echo " build - Build project with automatic version increment (default)"
|
||||||
|
echo " static - Build with static linking"
|
||||||
|
echo " clean - Clean build artifacts and generated files"
|
||||||
|
echo " install - Install to system (requires build first)"
|
||||||
|
echo " uninstall - Remove from system"
|
||||||
|
echo " version - Generate version files only"
|
||||||
|
echo ""
|
||||||
|
echo "Examples:"
|
||||||
|
echo " $0 build"
|
||||||
|
echo " $0 -m \"Fixed checksum parsing bug\" build"
|
||||||
|
echo " $0 --message \"Added new feature\" static"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
1
debug.c
Normal file
1
debug.c
Normal file
@@ -0,0 +1 @@
|
|||||||
|
int main() { printf("Testing direct filename: %d\n", strncmp("97d9d82b5414a9439102f3811fb90ab1d6368a00d33229a18b306476f9d04f82.pad", "97", 2)); return 0; }
|
||||||
1
decrypted.bin
Normal file
1
decrypted.bin
Normal file
@@ -0,0 +1 @@
|
|||||||
|
Test file content for decryption
|
||||||
BIN
files/out2.otp
Normal file
BIN
files/out2.otp
Normal file
Binary file not shown.
BIN
files/output.otp
Normal file
BIN
files/output.otp
Normal file
Binary file not shown.
1
files/test_decrypt.txt
Normal file
1
files/test_decrypt.txt
Normal file
@@ -0,0 +1 @@
|
|||||||
|
Test file content for decryption
|
||||||
BIN
files/test_decrypt.txt.otp
Normal file
BIN
files/test_decrypt.txt.otp
Normal file
Binary file not shown.
1
files/test_file.txt
Normal file
1
files/test_file.txt
Normal file
@@ -0,0 +1 @@
|
|||||||
|
Hello, this is a test file for encryption!
|
||||||
7
files/test_file.txt.otp.asc
Normal file
7
files/test_file.txt.otp.asc
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
-----BEGIN OTP MESSAGE-----
|
||||||
|
Version: v0.2.29
|
||||||
|
Pad-ChkSum: d0d4a489354348b08d8c7b324814d8c50010042e9da47f2c973f32a16a09101b
|
||||||
|
Pad-Offset: 57
|
||||||
|
|
||||||
|
05S8GfS0tFfczNMUz0xrieFGoPSREM4uo5QhFGoBCcOzjfTXTDMt3hRtAQ==
|
||||||
|
-----END OTP MESSAGE-----
|
||||||
BIN
files/test_files_dir.txt.otp
Normal file
BIN
files/test_files_dir.txt.otp
Normal file
Binary file not shown.
1
files/test_input.txt
Normal file
1
files/test_input.txt
Normal file
@@ -0,0 +1 @@
|
|||||||
|
This is a test file for encryption.
|
||||||
8898
files/toc.txt
Executable file
8898
files/toc.txt
Executable file
File diff suppressed because it is too large
Load Diff
BIN
files/toc.txt.otp
Normal file
BIN
files/toc.txt.otp
Normal file
Binary file not shown.
8
otp.code-workspace
Normal file
8
otp.code-workspace
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
{
|
||||||
|
"folders": [
|
||||||
|
{
|
||||||
|
"path": "."
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"settings": {}
|
||||||
|
}
|
||||||
1
test_files_dir.txt
Normal file
1
test_files_dir.txt
Normal file
@@ -0,0 +1 @@
|
|||||||
|
Testing updated files directory functionality
|
||||||
1
test_new.txt
Normal file
1
test_new.txt
Normal file
@@ -0,0 +1 @@
|
|||||||
|
Testing files directory functionality
|
||||||
BIN
test_new.txt.otp
Normal file
BIN
test_new.txt.otp
Normal file
Binary file not shown.
Reference in New Issue
Block a user