Skip to content

Conversation

@cgwalters
Copy link
Contributor

This is a redo of containers/storage#1933 but this time Assisted-by: OpenCode (Opus 4.6). Main motivation is just helping people who need to look at this (e.g. debugging, forensics) without digging deep into source code, and obviously would be useful for PoC work like containers/composefs-rs#218

Add doc comments to the overlay, vfs, btrfs, and zfs storage driver
packages describing their implementation approach:

- overlay: Uses Linux OverlayFS with composefs option for integrity
- vfs: Copies directories, attempting reflinks first for efficiency
- btrfs: Uses native subvolumes and snapshots with qgroup quotas
- zfs: Uses datasets and clones with mountpoint=legacy

Assisted-by: OpenCode (Opus 4.5)
Signed-off-by: Colin Walters <walters@verbum.org>
Create dedicated documentation files for each storage driver:
- containers-storage-driver-overlay.md (includes zstd:chunked and composefs)
- containers-storage-driver-vfs.md
- containers-storage-driver-btrfs.md
- containers-storage-driver-zfs.md

The composefs and zstd:chunked documentation is consolidated into the
overlay driver doc since these are overlay-specific features.

Assisted-by: OpenCode (Opus 4.5)
Signed-off-by: Colin Walters <walters@verbum.org>
@github-actions github-actions bot added the storage Related to "storage" package label Feb 9, 2026
@packit-as-a-service
Copy link

Packit jobs failed. @containers/packit-build please check.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

storage Related to "storage" package

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant