zfs
Copy-on-write pooled storage filesystem.
Implements filesystem.Filesystem. No cgo, no root.
Status
| Read | Write | Format | Label | Symlinks | On-disk format |
|---|---|---|---|---|---|
| ✅ | ✅ | ✅ | — | ✅ | Single pool, single-vdev writer (test-oriented subset); multi-vdev/RAID-Z read via OpenFromDevices |
Supported
- Read/write basic file I/O on a ZPL dataset
- Create pool image (
Format) - Directories, rename
- Pool info (
Info) - Grow / Shrink / Resize, including
ShrinkWithMode(Rebuild / InPlace / Auto) - Snapshots (
Snapshot,OpenSnapshot,DestroySnapshot) and clones (Clone,Origin) - Transparent decompress on read (lz4 / gzip / zstd / lzjb / zle)
- Native encryption read (
OpenFromDeviceDatasetWithKey, AES-CCM/GCM) - Symlinks and hardlinks; chmod/chown/chtimes (type-assert the optional interfaces)
- Multi-vdev (mirror / RAID-Z) pools opened read via
OpenFromDevices
Not implemented
- The writer only targets a single dataset in a single-vdev pool (the reader navigates nested datasets and multi-vdev/RAID-Z pools)
- The writer does not compress or encrypt data blocks it produces
- Snapshots/clones are eager block copies, not O(1) copy-on-write; no ACLs
- A missing RAID-Z data leg is not yet reconstructed from parity
Install
go get github.com/go-filesystems/zfs
- Source: https://github.com/go-filesystems/zfs
- API reference: https://pkg.go.dev/github.com/go-filesystems/zfs
Note
See the module's README for full, up-to-date details.