Documentation
README
Mirage Filesystem
Use the Mirage tools for virtual paths. Host filesystem tools cannot access those paths unless the user separately configured a FUSE mount.
Workflow
- Use the Mirage
ls,grep, orexecute_commandtool to discover mounted data. - Use the Mirage
readtool before modifying an existing file. - Use
editfor an existing file andwriteonly for a new file. - If an edit reports that the file changed since it was read, read the file again, reconsider the edit against the new content, and retry.
- Use
execute_commandfor pipelines and structured-file commands that need Mirage shell semantics.
Do not fall back to a host filesystem tool when a Mirage tool fails on a virtual path. Report the Mirage error or fix the Mirage configuration.