extract materializes files from the selected snapshot into an external directory.
The output directory is required, must be empty or not exist, and must not be under the Rinne root.
Usage
rinne extract [--space <space>] [--parallel <N>] --output <dir> <selector>
rinne extract [--space <space>] [--parallel <N>] --output <dir> <selector> <path>...
rinne extract [--space <space>] [--parallel <N>] --output <dir> <selector> [--file <path>]... [--dir <path>]...
Options
--space <space>
Use the specified space instead of the current space.
-o, --output <dir>
Required target directory for extracted files. The short alias -o is also accepted. It must be empty or not exist, and it must not be under the Rinne root.
--parallel <N>
Override the max degree of parallelism for file-level extract.
--file <path>
Extract only the specified RelativePath value. Can be specified multiple times.
--dir <path>
Extract only entries under the specified directory prefix. Can be specified multiple times.
Examples
Extract the latest snapshot to a clean directory
rinne extract --output D:\restore-out '@0' Extract selected positional paths
rinne extract --output ./out '@0' Assets/a.bin Assets/b.bin Extract selected files with --file
rinne extract --output ./out '@0' --file Assets/a.bin --file src/main.cs Extract selected subtrees with --dir
rinne extract --output ./out '@0' --dir Assets/ --dir Packages/ Extract from another space
rinne extract --space main --output ./out '@0'
Notes
- When --file or --dir is used, do not mix them with positional <path> arguments.
- Paths must match the RelativePath values stored in manifest.db.