pub fn open_single_root(
path: PathBuf,
) -> Result<Arc<SharedRootHandle>, (u8, String)>Expand description
Open (or join) the shared root for an FS_SYNC_SINGLE sync of path
(a canonical FILE path from validate_single_root). The native watch
arms on the file’s PARENT directory, non-recursive — a watch on the
file itself would follow its inode and go silent after a delete or a
rename-over, exactly the transitions a single-file sync must deliver.
recursive/cross_filesystem/ignores do not apply (nothing is
enumerated — the client named the one file it wants), so every SINGLE
sync of one file shares a single normalized key.