xfs/scrub/iscan.c

28  * Live File Scan
32  * less like a regular iwalk, except that when we're advancing the scan cursor,
36  * inode to scan, we must grab the AGI and hold it until we've updated the
37  * scan cursor.
39  * Callers are expected to use this code to scan all files in the filesystem to
40  * construct a new metadata index of some kind.  The scan races against other
43  * can be used in live update hook code to stop the scan and protect this data
56  * that the scan ignores that inode.
171 		 * and update the scan cursor.  in xchk_iscan_find_next()
190  * Advance both the scan and the visited cursors.
193  * the scan cursor can jump a long ways in a single iter() call.  There are no
195  * the same time so that the scan user can receive live updates for inodes that
246 /* Mark an inode scan finished before we actually scan anything. */
258  * Grab the AGI to advance the inode scan.  Returns 0 if *agi_bpp is now set,
259  * -ECANCELED if the live scan aborted, -EBUSY if the AGI could not be grabbed,
295  * scan forward, so set the iscan cursor to (ino - 1) so that our live update
300  * -ECANCELED if the live scan aborted, or the usual negative errno.
374  * Grabbing the inode failed, so we need to back up the scan and ask the caller
375  * to try to _advance the scan again.  Returns -EBUSY if we've run out of retry
411  * For an inode scan, we hold the AGI and want to try to grab a batch of
420  * Grab an inode as part of an inode scan.  While scanning this inode, the
564  * Advance the inode scan cursor to the next allocated inode and return up to
605  * Advance the inode scan cursor to the next allocated inode and return the
609  * -ECANCELED if the live scan aborted, -EBUSY if the incore inode could not be
613  * it may call this function again to continue the scan with the next allocated
660 /* Mark this inode scan finished and release resources. */
670 /* Pick an AG from which to start a scan. */
688  * Set ourselves up to start an inode scan.  If the @iget_timeout and
689  * @iget_retry_delay parameters are set, the scan will try to iget each inode
739  * this inode must be passed to the caller to maintain scan correctness.
758  * has visited this inode and the scan hasn't been aborted due to errors.
776 	/* Scan is finished, caller should receive all updates. */  in xchk_iscan_want_live_update()
784 	 * start of the scan range.  The caller should not receive any updates.  in xchk_iscan_want_live_update()