From 8c888d156c33a41c6eee01dc79b06c8b5ac7d21b Mon Sep 17 00:00:00 2001 From: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com> Date: Wed, 14 Feb 2024 17:25:31 -0300 Subject: [PATCH] tarsnap, tarsnap-keygen: add pages (#12219) Co-authored-by: K.B.Dharun Krishna Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com> Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> --- pages/common/tarsnap-keygen.md | 12 ++++++++++++ pages/common/tarsnap.md | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 46 insertions(+) create mode 100644 pages/common/tarsnap-keygen.md create mode 100644 pages/common/tarsnap.md diff --git a/pages/common/tarsnap-keygen.md b/pages/common/tarsnap-keygen.md new file mode 100644 index 0000000000..cc469b7f5c --- /dev/null +++ b/pages/common/tarsnap-keygen.md @@ -0,0 +1,12 @@ +# tarsnap-keygen + +> Generate a key file for use with Tarsnap, an online backup service. +> More information: . + +- Register a machine with the Tarsnap server: + +`sudo tarsnap-keygen --keyfile {{path/to/file.key}} --user {{user_email}} --machine {{machine_name}}` + +- Encrypt the key file (a passphrase will be requested twice): + +`sudo tarsnap-keygen --keyfile {{path/to/file.key}} --user {{user_email}} --machine {{machine_name}} --passphrased` diff --git a/pages/common/tarsnap.md b/pages/common/tarsnap.md new file mode 100644 index 0000000000..1c404e0a1f --- /dev/null +++ b/pages/common/tarsnap.md @@ -0,0 +1,34 @@ +# 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: . + +- [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}}`