diff --git a/snapraid.1 b/snapraid.1 index 5e145348..c8b19a27 100644 --- a/snapraid.1 +++ b/snapraid.1 @@ -259,31 +259,7 @@ When this command completes, your data is SAFE. .PP At this point you can start using your array as you like, and periodically update the parity information running the \(a"sync\(a" command. -.SS Checking & Fixing -To check the integrity of your data you can use the \(a"check\(a" command: -.PP -.RS 4 -snapraid check -.PD 0 -.PP -.PD -.RE -.PP -If will read all your data, to check if it\(cqs correct. -.PP -If an error is found, you can use the \(a"fix\(a" command to fix it. -.PP -.RS 4 -snapraid fix -.PD 0 -.PP -.PD -.RE -.PP -Note that the fix command will revert your data at the state of the -last \(a"sync\(a" command executed. It works like a snapshot was taken -in \(a"sync\(a". -.SS Recovering and Undeleting +.SS Restoring and Undeleting In recovering SnapRAID is more like a backup program than a RAID system, and it can be used to restore or undelete only a single file or directory to its previous state using the \-f, \-\-filter option : @@ -323,6 +299,9 @@ snapraid fix \-m .PP .PD .RE +.PP +If instead you have lost an entire disk and you want to recover it, +please see the \(cqRecovering\(cq chapter. .SS Scrubbing To periodically check the data and parity for errors, you can run the \(a"scrub\(a" command. @@ -334,8 +313,8 @@ snapraid scrub .PD .RE .PP -This command is similar at \(a"check\(a" but verifies only the oldest data -in your array. Every run of the command checks about 12% of the array, +This command verifies only the oldest data in your array. +Every run of the command checks about 12% of the array, but nothing newer than 10 days. You can use the \-p, \-\-percentage option to specify a different amount, and the \-o, \-\-older\-than option to specify a different age in days. @@ -1234,7 +1213,7 @@ snapraid sync .PD .RE .PP -If everything was recovered, this command is immediate. +If everything is recovered, this command is immediate. .SH CONTENT SnapRAID stores the list and checksums of your files in the content file. .PP diff --git a/snapraid.d b/snapraid.d index 0e48540d..c9dd1e15 100644 --- a/snapraid.d +++ b/snapraid.d @@ -146,22 +146,7 @@ Getting Started At this point you can start using your array as you like, and periodically update the parity information running the "sync" command. - Checking & Fixing - To check the integrity of your data you can use the "check" command: - - :snapraid check - - If will read all your data, to check if it's correct. - - If an error is found, you can use the "fix" command to fix it. - - :snapraid fix - - Note that the fix command will revert your data at the state of the - last "sync" command executed. It works like a snapshot was taken - in "sync". - - Recovering and Undeleting + Restoring and Undeleting In recovering SnapRAID is more like a backup program than a RAID system, and it can be used to restore or undelete only a single file or directory to its previous state using the -f, --filter option : @@ -182,14 +167,17 @@ Getting Started :snapraid fix -m + If instead you have lost an entire disk and you want to recover it, + please see the 'Recovering' chapter. + Scrubbing To periodically check the data and parity for errors, you can run the "scrub" command. :snapraid scrub - This command is similar at "check" but verifies only the oldest data - in your array. Every run of the command checks about 12% of the array, + This command verifies only the oldest data in your array. + Every run of the command checks about 12% of the array, but nothing newer than 10 days. You can use the -p, --percentage option to specify a different amount, and the -o, --older-than option to specify a different age in days. @@ -887,7 +875,7 @@ Recovering :snapraid sync - If everything was recovered, this command is immediate. + If everything is recovered, this command is immediate. Content SnapRAID stores the list and checksums of your files in the content file. diff --git a/snapraid.txt b/snapraid.txt index 45d2a0ab..d2076c75 100644 --- a/snapraid.txt +++ b/snapraid.txt @@ -159,25 +159,8 @@ When this command completes, your data is SAFE. At this point you can start using your array as you like, and periodically update the parity information running the "sync" command. -4.1 Checking & Fixing ---------------------- - -To check the integrity of your data you can use the "check" command: - - snapraid check - -If will read all your data, to check if it's correct. - -If an error is found, you can use the "fix" command to fix it. - - snapraid fix - -Note that the fix command will revert your data at the state of the -last "sync" command executed. It works like a snapshot was taken -in "sync". - -4.2 Recovering and Undeleting ------------------------------ +4.1 Restoring and Undeleting +---------------------------- In recovering SnapRAID is more like a backup program than a RAID system, and it can be used to restore or undelete only a single file or directory @@ -199,7 +182,10 @@ Or to recover all the deleted files in all the drives with: snapraid fix -m -4.3 Scrubbing +If instead you have lost an entire disk and you want to recover it, +please see the 'Recovering' chapter. + +4.2 Scrubbing ------------- To periodically check the data and parity for errors, you can @@ -207,8 +193,8 @@ run the "scrub" command. snapraid scrub -This command is similar at "check" but verifies only the oldest data -in your array. Every run of the command checks about 12% of the array, +This command verifies only the oldest data in your array. +Every run of the command checks about 12% of the array, but nothing newer than 10 days. You can use the -p, --percentage option to specify a different amount, and the -o, --older-than option to specify a different age in days. @@ -231,7 +217,7 @@ if really fixed. You can use -p 0 to scrub only blocks marked as bad. snapraid -p 0 scrub -4.4 Pooling +4.3 Pooling ----------- To have all the files in your array shown in the same directory tree, @@ -969,7 +955,7 @@ Run the "sync" command to resynchronize the array with the new disk. snapraid sync -If everything was recovered, this command is immediate. +If everything is recovered, this command is immediate. 10 CONTENT