max/nix-super
1
0
Fork 0
mirror of https://github.com/privatevoid-net/nix-super.git synced 2024-11-27 00:06:16 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Document remount-hook store parameter.

Browse source
This commit is contained in:
Ben Radford 2023-08-01 11:55:55 +01:00 committed by Ben Radford
parent c409a753db
commit c712369ec5
1 changed files with 8 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
src/libstore/local-overlay-store.hh
View file

@ -43,9 +43,15 @@ struct LocalOverlayStoreConfig : virtual LocalStoreConfig
const PathSetting remountHook{(StoreConfig*) this, "", "remount-hook",
R"(
Script or program to run when overlay filesystem needs remounting.
Script or other executable to run when overlay filesystem needs remounting.
TODO: Document this in more detail.
This is occasionally necessary when deleting a store path that exists in both upper and lower layers.
In such a situation, bypassing OverlayFS and deleting the path in the upper layer directly
is the only way to perform the deletion without creating a "whiteout".
However this causes the OverlayFS kernel data structures to get out-of-sync,
and can lead to 'stale file handle' errors; remounting solves the problem.
The store directory is passed as an argument to the invoked executable.
)"};
const std::string name() override { return "Experimental Local Overlay Store"; }