thaloco/banger
1
Fork 0
Code Pull requests Releases Packages Activity Actions

docs: fix paths from local to system install

Browse source
This commit is contained in:
Thales Maciel 2026-04-30 10:49:10 -03:00
parent 93ba233a12
commit dea655ce95
No known key found for this signature in database
GPG key ID: 33112E6833C34679
2 changed files with 10 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

4
docs/oci-import-internals.md
View file

@ -11,7 +11,9 @@
- **`Pull`** wraps `go-containerregistry`'s `remote.Image` with the
`linux/amd64` platform pinned. Layer blobs cache under
`~/.cache/banger/oci/blobs/` and populate lazily during flatten.
`/var/cache/banger/oci/blobs/` (system install) or
`~/.cache/banger/oci/blobs/` (dev mode) and populate lazily during
flatten.
- **`Flatten`** replays layers oldest-first into a staging directory,
applies whiteouts, rejects unsafe paths plus filenames that banger's
debugfs ownership fixup cannot encode safely. Returns a `Metadata`

10
docs/oci-import.md
View file

@ -90,12 +90,16 @@ Unknown distros fall back to `ID_LIKE`, then error cleanly.
## Paths
Paths below assume the system install (`banger system install`). When
running `bangerd` directly without the helper, the same files live
under `~/.cache/banger/` and `~/.local/state/banger/` instead.
| What | Where |
|------|-------|
| Layer blob cache | `~/.cache/banger/oci/blobs/sha256/<hex>` |
| Staging dir | `~/.local/state/banger/images/<id>.staging/` |
| Layer blob cache | `/var/cache/banger/oci/blobs/sha256/<hex>` |
| Staging dir | `/var/lib/banger/images/<id>.staging/` |
| Extraction scratch | `$TMPDIR/banger-pull-<rand>/` |
| Published image | `~/.local/state/banger/images/<id>/rootfs.ext4` |
| Published image | `/var/lib/banger/images/<id>/rootfs.ext4` |
## Cache lifecycle