|
@@ -22,13 +22,13 @@ Examples
|
|
|
::
|
|
|
|
|
|
# Local repository
|
|
|
- $ borg init /data/mybackuprepo.borg
|
|
|
+ $ borg init /mnt/backup
|
|
|
|
|
|
# Remote repository
|
|
|
- $ borg init user@hostname:mybackuprepo.borg
|
|
|
+ $ borg init user@hostname:backup
|
|
|
|
|
|
# Encrypted remote repository
|
|
|
- $ borg init --encryption=passphrase user@hostname:mybackuprepo.borg
|
|
|
+ $ borg init --encryption=passphrase user@hostname:backup
|
|
|
|
|
|
|
|
|
.. include:: usage/create.rst.inc
|
|
@@ -38,17 +38,17 @@ Examples
|
|
|
::
|
|
|
|
|
|
# Backup ~/Documents into an archive named "my-documents"
|
|
|
- $ borg create /data/myrepo.borg::my-documents ~/Documents
|
|
|
+ $ borg create /mnt/backup::my-documents ~/Documents
|
|
|
|
|
|
# Backup ~/Documents and ~/src but exclude pyc files
|
|
|
- $ borg create /data/myrepo.borg::my-files \
|
|
|
- ~/Documents \
|
|
|
- ~/src \
|
|
|
+ $ borg create /mnt/backup::my-files \
|
|
|
+ ~/Documents \
|
|
|
+ ~/src \
|
|
|
--exclude '*.pyc'
|
|
|
|
|
|
# Backup the root filesystem into an archive named "root-YYYY-MM-DD"
|
|
|
NAME="root-`date +%Y-%m-%d`"
|
|
|
- $ borg create /data/myrepo.borg::$NAME / --do-not-cross-mountpoints
|
|
|
+ $ borg create /mnt/backup::$NAME / --do-not-cross-mountpoints
|
|
|
|
|
|
|
|
|
.. include:: usage/extract.rst.inc
|
|
@@ -58,16 +58,16 @@ Examples
|
|
|
::
|
|
|
|
|
|
# Extract entire archive
|
|
|
- $ borg extract /data/myrepo::my-files
|
|
|
+ $ borg extract /mnt/backup::my-files
|
|
|
|
|
|
# Extract entire archive and list files while processing
|
|
|
- $ borg extract -v /data/myrepo::my-files
|
|
|
+ $ borg extract -v /mnt/backup::my-files
|
|
|
|
|
|
# Extract the "src" directory
|
|
|
- $ borg extract /data/myrepo::my-files home/USERNAME/src
|
|
|
+ $ borg extract /mnt/backup::my-files home/USERNAME/src
|
|
|
|
|
|
# Extract the "src" directory but exclude object files
|
|
|
- $ borg extract /data/myrepo::my-files home/USERNAME/src --exclude '*.o'
|
|
|
+ $ borg extract /mnt/backup::my-files home/USERNAME/src --exclude '*.o'
|
|
|
|
|
|
.. include:: usage/check.rst.inc
|
|
|
|
|
@@ -79,14 +79,14 @@ Examples
|
|
|
~~~~~~~~
|
|
|
::
|
|
|
|
|
|
- $ borg list /data/myrepo
|
|
|
+ $ borg list /mnt/backup
|
|
|
my-files Thu Aug 1 23:33:22 2013
|
|
|
my-documents Thu Aug 1 23:35:43 2013
|
|
|
root-2013-08-01 Thu Aug 1 23:43:55 2013
|
|
|
root-2013-08-02 Fri Aug 2 15:18:17 2013
|
|
|
...
|
|
|
|
|
|
- $ borg list /data/myrepo::root-2013-08-02
|
|
|
+ $ borg list /mnt/backup::root-2013-08-02
|
|
|
drwxr-xr-x root root 0 Jun 05 12:06 .
|
|
|
lrwxrwxrwx root root 0 May 31 20:40 bin -> usr/bin
|
|
|
drwxr-xr-x root root 0 Aug 01 22:08 etc
|
|
@@ -102,18 +102,18 @@ Examples
|
|
|
::
|
|
|
|
|
|
# Keep 7 end of day and 4 additional end of week archives:
|
|
|
- $ borg prune /data/myrepo --keep-daily=7 --keep-weekly=4
|
|
|
+ $ borg prune /mnt/backup --keep-daily=7 --keep-weekly=4
|
|
|
|
|
|
# Same as above but only apply to archive names starting with "foo":
|
|
|
- $ borg prune /data/myrepo --keep-daily=7 --keep-weekly=4 --prefix=foo
|
|
|
+ $ borg prune /mnt/backup --keep-daily=7 --keep-weekly=4 --prefix=foo
|
|
|
|
|
|
# Keep 7 end of day, 4 additional end of week archives,
|
|
|
# and an end of month archive for every month:
|
|
|
- $ borg prune /data/myrepo --keep-daily=7 --keep-weekly=4 --monthly=-1
|
|
|
+ $ borg prune /mnt/backup --keep-daily=7 --keep-weekly=4 --monthly=-1
|
|
|
|
|
|
# Keep all backups in the last 10 days, 4 additional end of week archives,
|
|
|
# and an end of month archive for every month:
|
|
|
- $ borg prune /data/myrepo --keep-within=10d --keep-weekly=4 --monthly=-1
|
|
|
+ $ borg prune /mnt/backup --keep-within=10d --keep-weekly=4 --monthly=-1
|
|
|
|
|
|
|
|
|
.. include:: usage/info.rst.inc
|
|
@@ -122,13 +122,13 @@ Examples
|
|
|
~~~~~~~~
|
|
|
::
|
|
|
|
|
|
- $ borg info /data/myrepo::root-2013-08-02
|
|
|
+ $ borg info /mnt/backup::root-2013-08-02
|
|
|
Name: root-2013-08-02
|
|
|
Fingerprint: bc3902e2c79b6d25f5d769b335c5c49331e6537f324d8d3badcb9a0917536dbb
|
|
|
Hostname: myhostname
|
|
|
Username: root
|
|
|
Time: Fri Aug 2 15:18:17 2013
|
|
|
- Command line: /usr/bin/borg create --stats /data/myrepo::root-2013-08-02 / --do-not-cross-mountpoints
|
|
|
+ Command line: /usr/bin/borg create --stats /mnt/backup::root-2013-08-02 / --do-not-cross-mountpoints
|
|
|
Number of files: 147429
|
|
|
Original size: 5344169493 (4.98 GB)
|
|
|
Compressed size: 1748189642 (1.63 GB)
|
|
@@ -141,7 +141,7 @@ Examples
|
|
|
~~~~~~~~
|
|
|
::
|
|
|
|
|
|
- $ borg mount /data/myrepo::root-2013-08-02 /tmp/mymountpoint
|
|
|
+ $ borg mount /mnt/backup::root-2013-08-02 /tmp/mymountpoint
|
|
|
$ ls /tmp/mymountpoint
|
|
|
bin boot etc lib lib64 mnt opt root sbin srv usr var
|
|
|
$ fusermount -u /tmp/mymountpoint
|
|
@@ -154,16 +154,17 @@ Examples
|
|
|
::
|
|
|
|
|
|
# Create a key file protected repository
|
|
|
- $ borg init --encryption=keyfile /tmp/encrypted-repo
|
|
|
- Initializing repository at "/tmp/encrypted-repo"
|
|
|
+ $ borg init --encryption=keyfile /mnt/backup
|
|
|
+ Initializing repository at "/mnt/backup"
|
|
|
Enter passphrase (empty for no passphrase):
|
|
|
Enter same passphrase again:
|
|
|
- Key file "/home/USER/.borg/keys/tmp_encrypted_repo" created.
|
|
|
+ Key file "/home/USER/.borg/keys/mnt_backup" created.
|
|
|
Keep this file safe. Your data will be inaccessible without it.
|
|
|
|
|
|
# Change key file passphrase
|
|
|
- $ borg change-passphrase /tmp/encrypted-repo
|
|
|
- Enter passphrase for key file /home/USER/.borg/keys/tmp_encrypted_repo:
|
|
|
+ $ borg change-passphrase /mnt/backup
|
|
|
+ Enter passphrase for key file /home/USER/.borg/keys/mnt_backup:
|
|
|
New passphrase:
|
|
|
Enter same passphrase again:
|
|
|
- Key file "/home/USER/.borg/keys/tmp_encrypted_repo" updated
|
|
|
+ Key file "/home/USER/.borg/keys/mnt_backup" updated
|
|
|
+
|