Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ZPOOL-SCRUB(8)		  BSD System Manager's Manual		ZPOOL-SCRUB(8)

     zpool-scrub -- Begin a scrub or resume a paused scrub of a	ZFS storage

     zpool scrub [-s | -p] [-w]	pool...

     zpool scrub [-s | -p] [-w]	pool...
	     Begins a scrub or resumes a paused	scrub.	The scrub examines all
	     data in the specified pools to verify that	it checksums cor-
	     rectly.  For replicated (mirror, raidz, or	draid) devices,	ZFS
	     automatically repairs any damage discovered during	the scrub.
	     The zpool status command reports the progress of the scrub	and
	     summarizes	the results of the scrub upon completion.

	     Scrubbing and resilvering are very	similar	operations.  The dif-
	     ference is	that resilvering only examines data that ZFS knows to
	     be	out of date (for example, when attaching a new device to a
	     mirror or replacing an existing device), whereas scrubbing	exam-
	     ines all data to discover silent errors due to hardware faults or
	     disk failure.

	     Because scrubbing and resilvering are I/O-intensive operations,
	     ZFS only allows one at a time.  If	a scrub	is paused, the zpool
	     scrub resumes it.	If a resilver is in progress, ZFS does not al-
	     low a scrub to be started until the resilver completes.

	     Note that,	due to changes in pool data on a live system, it is
	     possible for scrubs to progress slightly beyond 100% completion.
	     During this period, no completion time estimate will be provided.

	     -s	     Stop scrubbing.

	     -p	     Pause scrubbing.  Scrub pause state and progress are pe-
		     riodically	synced to disk.	 If the	system is restarted or
		     pool is exported during a paused scrub, even after	im-
		     port, scrub will remain paused until it is	resumed.  Once
		     resumed the scrub will pick up from the place where it
		     was last checkpointed to disk.  To	resume a paused	scrub
		     issue zpool scrub again.

	     -w	     Wait until	scrub has completed before returning.

     zpool-iostat(8), zpool-resilver(8), zpool-status(8)

BSD				August 9, 2019				   BSD


Want to link to this manual page? Use this URL:

home | help