Forráskód Böngészése

docs: add example how to restore a raw device

also: do not use /dev/sda in case someone stupidly tries out the examples.
/dev/sdx should be safe for people who do not understand what they do.
Thomas Waldmann 9 éve
szülő
commit
347778b749
1 módosított fájl, 4 hozzáadás és 1 törlés
  1. 4 1
      docs/usage.rst

+ 4 - 1
docs/usage.rst

@@ -260,7 +260,7 @@ Examples
     $ borg create --chunker-params 10,23,16,4095 /mnt/backup::small /smallstuff
     $ borg create --chunker-params 10,23,16,4095 /mnt/backup::small /smallstuff
 
 
     # Backup a raw device (must not be active/in use/mounted at that time)
     # Backup a raw device (must not be active/in use/mounted at that time)
-    $ dd if=/dev/sda bs=10M | borg create /mnt/backup::my-sda -
+    $ dd if=/dev/sdx bs=10M | borg create /mnt/backup::my-sdx -
 
 
     # No compression (default)
     # No compression (default)
     $ borg create /mnt/backup::repo ~
     $ borg create /mnt/backup::repo ~
@@ -292,6 +292,9 @@ Examples
     # Extract the "src" directory but exclude object files
     # Extract the "src" directory but exclude object files
     $ borg extract /mnt/backup::my-files home/USERNAME/src --exclude '*.o'
     $ borg extract /mnt/backup::my-files home/USERNAME/src --exclude '*.o'
 
 
+    # Restore a raw device (must not be active/in use/mounted at that time)
+    $ borg extract --stdout /mnt/backup::my-sdx | dd of=/dev/sdx bs=10M
+
 Note: currently, extract always writes into the current working directory ("."),
 Note: currently, extract always writes into the current working directory ("."),
       so make sure you ``cd`` to the right place before calling ``borg extract``.
       so make sure you ``cd`` to the right place before calling ``borg extract``.