How luthfihakim2004/leichfs works
leichfs is a Linux FUSE filesystem that transparently stores files encrypted with per-file AES-256-GCM keys. Users initialize a backing directory or change its passphrase, then mount it; FUSE operations dispatch to filesystem handlers that serve plaintext reads and writes while maintaining encrypted backing files. The README also documents partial and full backup, enabled by independently encrypted files and a config-held wrapped master key. Edges reflect the shown entry-point calls, indexed imports, and excerpts; unsampled callback details are not inferred.
Main entry points: dispatch.cpp FUSE dispatch · main.cpp CLI entry · init.cpp Init and passphrase · io.cpp Encrypted file I/O
Components 17
CLI and FUSE
- CLI entry
src/main.cpp - FUSE dispatch
lib/leichfs/dispatch.cpp
Keys and Encryption
- Init and passphrase
lib/leichfs/init.cpp - Crypto primitives
lib/enc/crypto.cpp - File headers
lib/enc/header.cpp - Wrapped-key config
lib/leichfs/init.cpp
Filesystem Operations
- Encrypted file I/O
lib/fs/io.cpp - Metadata operations
lib/fs/meta.cpp - Directory operations
lib/fs/dir.cpp - Extended attributes
lib/fs/xattr.cpp - Lifecycle operations
lib/fs/lc.cpp - Backup capability
README.md
Filesystem State
- Filesystem context
include/fs/core.hpp - Secure filesystem helpers
lib/util.cpp
Other components
- User
- FUSE runtime
- Backing directory
Connections 23
- User → CLI entry: runs commands
src/main.cpp - CLI entry → Init and passphrase: initializes or rewraps
src/main.cpp - CLI entry → Secure filesystem helpers: loads key
src/main.cpp - CLI entry → FUSE dispatch: starts FUSE
src/main.cpp - CLI entry → Filesystem context: creates context
src/main.cpp - FUSE runtime → FUSE dispatch: invokes callbacks
- FUSE dispatch → Encrypted file I/O: routes I/O
lib/leichfs/dispatch.cpp - FUSE dispatch → Metadata operations: routes metadata
lib/leichfs/dispatch.cpp - FUSE dispatch → Directory operations: routes directories
lib/leichfs/dispatch.cpp - FUSE dispatch → Extended attributes: routes attributes
lib/leichfs/dispatch.cpp - FUSE dispatch → Lifecycle operations: routes lifecycle
lib/leichfs/dispatch.cpp - Encrypted file I/O → Secure filesystem helpers: uses chunk helpers
lib/fs/io.cpp - Encrypted file I/O → Crypto primitives: encrypts and decrypts
lib/fs/io.cpp - Encrypted file I/O → File headers: reads and writes
- Metadata operations → Secure filesystem helpers: uses filesystem helpers
lib/fs/meta.cpp - Metadata operations → Crypto primitives: uses crypto
lib/fs/meta.cpp - Init and passphrase → Crypto primitives: wraps master key
lib/leichfs/init.cpp - Init and passphrase → Secure filesystem helpers: uses key utilities
lib/leichfs/init.cpp - Init and passphrase → Wrapped-key config: reads and writes
lib/leichfs/init.cpp - Secure filesystem helpers → Backing directory: reads and writes files
- Encrypted file I/O → Backing directory: stores ciphertext
- Init and passphrase → Backing directory: stores config
lib/leichfs/init.cpp - Backup capability → Backing directory: backs up files
README.md