Skip to content

Commit b3ff5cb

Browse files
authored
Revise technical details and add DirectStorage note (#4)
Updated section headers and added a note about DirectStorage compatibility.
1 parent 62ea51c commit b3ff5cb

1 file changed

Lines changed: 2 additions & 1 deletion

File tree

readme.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Alternatively, if you need python support, use [libbbf-python](https://github.co
4646

4747
BBF is designed as a Footer-indexed binary format. This allows for rapid append-only creation and immediate random access to any page without scanning the entire file.
4848

49-
### Zero-Copy Architecture
49+
### MMAP Compatibility
5050
The `bbfmux` reference implementation utilizes **Memory Mapping (mmap/MapViewOfFile)**. Instead of reading file data into intermediate buffers, the tool maps the container directly into the process address space. This allows the CPU to access image data at the speed of your NVMe drive's hardware limit.
5151

5252
### High-Speed Parallel Verification
@@ -55,6 +55,7 @@ Integrity checks utilize **Parallel XXH3**. On multi-core systems, the verifier
5555
### 4KB Alignment
5656
Every asset in a BBF file starts on a **4096-byte boundary**. This alignment is critical for modern hardware, allowing for DirectStorage transfers directly from disk to GPU memory, bypassing CPU bottlenecks entirely.
5757

58+
Note: DirectStorage isn't avaliable for images yet (as far as I know), but I've made sure to accomodate such a thing in the future with this format.
5859

5960
### Binary Layout
6061
1. **Header (13 bytes)**: Magic `BBF1`, versioning, and initial padding.

0 commit comments

Comments
 (0)