diff options
| author | George Melikov <[email protected]> | 2021-08-06 00:30:28 +0300 |
|---|---|---|
| committer | Tony Hutter <[email protected]> | 2021-09-14 14:29:46 -0700 |
| commit | c07ed695778b8593fbda88a0343fe831465ab91e (patch) | |
| tree | 1845169d57e420be86f4d961e393f9bb5e680eab /man | |
| parent | ddb732e2c8aacc62615887af13795fad0fa01943 (diff) | |
Man zpool-scrub.8: describe sequential scrub
Describe sequential scrub and add examples of scrub status.
Reviewed-by: Richard Laager <[email protected]>
Reviewed-by: Brian Behlendorf <[email protected]>
Reviewed-by: Tony Nguyen <[email protected]>
Signed-off-by: George Melikov <[email protected]>
Closes #12429
Diffstat (limited to 'man')
| -rw-r--r-- | man/man8/zpool-scrub.8 | 29 |
1 files changed, 27 insertions, 2 deletions
diff --git a/man/man8/zpool-scrub.8 b/man/man8/zpool-scrub.8 index 10375b639..768f71539 100644 --- a/man/man8/zpool-scrub.8 +++ b/man/man8/zpool-scrub.8 @@ -22,11 +22,11 @@ .\" Copyright (c) 2012, 2018 by Delphix. All rights reserved. .\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved. .\" Copyright (c) 2017 Datto Inc. -.\" Copyright (c) 2018 George Melikov. All Rights Reserved. +.\" Copyright (c) 2018, 2021 George Melikov. All Rights Reserved. .\" Copyright 2017 Nexenta Systems, Inc. .\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. .\" -.Dd May 27, 2021 +.Dd July 25, 2021 .Dt ZPOOL-SCRUB 8 .Os . @@ -64,6 +64,11 @@ faults or disk failure. .Pp Because scrubbing and resilvering are I/O-intensive operations, ZFS only allows one at a time. +.Pp +A scrub is split into two parts: metadata scanning and block scrubbing. +The metadata scanning sorts blocks into large sequential ranges which can then +be read much more efficiently from disk when issuing the scrub I/O. +.Pp If a scrub is paused, the .Nm zpool Cm scrub resumes it. @@ -91,6 +96,26 @@ again. .It Fl w Wait until scrub has completed before returning. .El +.Sh EXAMPLES +.Bl -tag -width "Exam" +.It Sy Example 1 : Status of pool with ongoing scrub: +Output: +.Bd -literal -compact -offset Ds +.No # Nm zpool Cm status + ... + scan: scrub in progress since Sun Jul 25 16:07:49 2021 + 403M scanned at 100M/s, 68.4M issued at 10.0M/s, 405M total + 0B repaired, 16.91% done, 00:00:04 to go + ... +.Ed +Where: +.Bl -dash -offset indent +.It +Metadata which references 403M of file data has been +scanned at 100M/s, and 68.4M of that file data has been +scrubbed sequentially at 10.0M/s. +.El +.El . .Sh SEE ALSO .Xr zpool-iostat 8 , |