alphacentri/scoutfs-notify
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

README: correct notify ioctl to nr 26 on the v1.32 branch

Browse Source 
The v1.32 rebase moved SCOUTFS_IOC_READ_NOTIFY from nr 25 to nr 26
(upstream took nr 25 for SCOUTFS_IOC_INJECT_TOTL_DELTA) but the README
was never updated, so it documented an ioctl number this branch has
not used since the rebase.  Also drops the now-false claim that the
number is identical across every supported version, and adds the
missing v1.32 row to the branch table.

Patches are untouched; this is a docs-only fix.
This commit is contained in:
57_Wolve
2026-07-31 09:04:12 -05:00
parent b22524091e
commit d8a297a843
1 changed files with 7 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+7 -4
View File
@@ -10,7 +10,7 @@ currently-supported upstream scoutfs version.
Three patches against each supported scoutfs release:
1. **Kmod core** — a per-mount 64 KiB ring of 64-byte notification records and
a single-reader drain ioctl (`SCOUTFS_IOC_READ_NOTIFY`, nr 25). Emit is
a single-reader drain ioctl (`SCOUTFS_IOC_READ_NOTIFY`, nr 26). Emit is
non-blocking, drop-on-full; the monotonic `seq` field exposes drops to
consumers. Three percpu counters (`notify_emitted`,
`notify_dropped_ring_full`, `notify_reader_attached`). No mount option,
@@ -25,9 +25,11 @@ Three patches against each supported scoutfs release:
clients. Pure-stdlib Go; no external module dependencies. Shipped
with a systemd template unit `scoutfs-notifyd@<mountpoint>.service`.
The notify ABI (`SCOUTFS_IOC_READ_NOTIFY` nr 25, 64-byte event record) is
identical across all three supported scoutfs versions, so consumers and
the daemon do not need per-version branching in their own code.
The 64-byte event record layout is identical on every branch, so
consumers and the daemon do not need per-version branching in their own
code. The ioctl number is not: it is nr 25 on `v1.28`-`v1.30` and nr 26
on `v1.32`, because upstream v1.32 took nr 25 for
`SCOUTFS_IOC_INJECT_TOTL_DELTA`.
## Repository layout
@@ -40,6 +42,7 @@ NOT apply cross-version without rebasing.
| `v1.28` | `v1.28` | `v1.28-notify-1` |
| `v1.29` | `v1.29` | `v1.29-notify-1` |
| `main` / `v1.30` | `v1.30` | `v1.30-notify-1` |
| `v1.32` | `v1.32` | `v1.32-notify-1` |
`main` tracks the newest supported scoutfs version. When a new scoutfs
release ships, a new branch is created and the patches are rebased onto