tldr/pages/common/tarsnap.md

35 lines
1.4 KiB
Markdown
Raw Normal View History

# tarsnap
> Manipulate remote Tarsnap encrypted backups.
> Note: you don't need to specify the key file and the cache directory if you configure them in `/usr/local/etc/tarsnap.conf` or `~/.tarsnaprc`.
> See also: `tarsnap-keygen`.
> More information: <https://www.tarsnap.com/man-tarsnap.1.html>.
- [c]reate a backup archive of one or more files or directories, specifying the cryptographic key and the cache directory:
`tarsnap -c --keyfile {{path/to/key_file}} --cachedir {{path/to/cache_directory}} -f {{archive_name}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`
- Display how much data would be uploaded:
`tarsnap -c --dry-run --print-stats --keyfile {{path/to/key_file}} --cachedir {{path/to/cache_directory}} -f {{archive_name}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`
- List stored archives:
`tarsnap --list-archives --keyfile {{path/to/key_file}}`
- [d]elete a specific archive:
`tarsnap -d --keyfile {{path/to/key_file}} --cachedir {{path/to/cache_directory}} -f {{archive_name}}`
- Lis[t] the contents of a specific archive in [v]erbose mode:
`tarsnap -tv --keyfile {{path/to/key_file}} -f {{archive_name}}`
- Restore one or more files or directories from a specific archive:
`tarsnap -x --keyfile {{path/to/key_file}} -f {{archive_name}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`
- Copy an archive:
`tarsnap -c --keyfile {{path/to/key_file}} -f {{new_archive_name}} @@{{source_archive_name}}`