restic: initial notes

src/SUMMARY.md

@@ -24,6 +24,7 @@
     - [dot](./tools/dot.md)
     - [ffmpeg](./tools/ffmpeg.md)
     - [gnuplot](./tools/gnuplot.md)
+    - [restic](./tools/restic.md)
 
 - [Resource analysis & monitor](./monitor/README.md)
     - [lsof](./monitor/lsof.md)

src/tools/README.md

@@ -9,3 +9,4 @@
 - [dot](./dot.md)
 - [ffmpeg](./ffmpeg.md)
 - [gnuplot](./gnuplot.md)
+- [restic](./restic.md)

src/tools/restic.md

@@ -0,0 +1,48 @@
+# restic(1)
+
+## Create new snapshot repository
+
+```bash
+# Create a local backup repository.
+restic -r <path> init
+
+# Create a backup repository on a remote host.
+restic -r sftp:user@host:<path> init
+```
+
+## Example: Restore file pattern from `latest` snapshot
+Restore files matching `<file_pattern>` from the `latest` snapshot (pseudo
+snapshot ID) into `<dest>`.
+```bash
+restic -r <repo> restore -i <file_pattern> --target <dest> latest
+```
+
+## Mount snapshots
+Mount snapshots as user filesystem (fuse) to given mount point.
+```bash
+restic -r <repo> mount <mntpoint>
+
+# Mounted snapshots can be limited by host.
+restic -r <repo> mount --host <host> <mntpoint>
+
+# Mounted snapshots can be limited by path (abs path).
+restic -r <repo> mount --path <abspath> <mntpoint>
+```
+
+## Repository maintenance
+Check the repository for errors and report them.
+```bash
+restic -r <repo> check
+```
+
+Check the repository for non-referenced data and remove it.
+```bash
+restic -r <repo> prune
+```
+
+## References
+- [`restic` read the docs][restic]
+- [sftp][restic-sftp]
+
+[restic]: https://restic.readthedocs.io/en/stable/index.html
+[restic-sftp]: https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#sftp