xfs/scrub/tempfile.c

35  * Create a temporary file for reconstructing metadata, with the intention of
36  * atomically exchanging the temporary file's contents with the file that's
99 	/* We don't touch file data, so drop the realtime flags. */
104 	 * Mark our temporary file as private so that LSMs and the ACL code
106 	 * The file should never be exposed to userspace.
119 		 * target with meaningful content before swapping with the file
137 	 * Put our temp file on the unlinked list so it's purged automatically.
138 	 * All file-based metadata being reconstructed using this file must be
139 	 * atomically exchanged with the original file because the contents
189  * eligible file mode.
193  * tree.  If it turns out that we're actually scrubbing a file from the
194  * metadata directory tree, we have to subtract the temp file from the root
197  * actually get around to checking if the file mode is the right type for the
246  * Remove this temporary file from the metadata directory tree so that it can
294 /* Take IOLOCK_EXCL on the temporary file, maybe. */
308  * Take the temporary file's IOLOCK while holding a different inode's IOLOCK.
327 /* Release IOLOCK_EXCL on the temporary file. */
336 /* Prepare the temporary file for metadata updates by grabbing ILOCK_EXCL. */
345 /* Try to grab ILOCK_EXCL on the temporary file. */
358 /* Unlock ILOCK_EXCL on the temporary file after an update. */
368  * Begin the process of making changes to both the file being scrubbed and
369  * the temporary file by taking ILOCK_EXCL on both.
389 /* Release the temporary file. */
408  * Make sure that the given range of the data fork of the temporary file is
476  * Write data to each block of a file.  The given range of the tempfile's data
504 		/* Read block mapping for this file block. */
513 		/* Get the metadata buffer for this offset in the file. */
563  * Set the temporary file's size.  Caller must join the tempfile to the scrub
580  * Roll a repair transaction involving the temporary file.  Caller must join
581  * both the temporary file and the file being scrubbed to the transaction.
602  * committing the contents of a metadata file that we've rebuilt in the temp
603  * file.
653  * for exchanging the contents of a metadata file that we've rebuilt in the
654  * temp file.  Caller must hold IOLOCK_EXCL but not ILOCK_EXCL on both files.
668 	 * The exchmaps code only knows how to exchange file fork space
686 		 * The file being repaired is in local format, but the temp
687 		 * file has mapped extents.  To perform the exchange, the file
691 		 * exchanges is (worst case) the temporary file's extent count
701 		 * The temporary file is in local format, but the file being
703 		 * temp file must have its shortform data converted to an
706 		 * is (worst case) the extent count of the file being repaired
762 	 * Quota reservation for each file comes from two sources.  First, we
786  * Prepare an existing transaction for an atomic file contents exchange.
789  * structures in preparation for exchanging the contents of a metadata file
790  * that has been rebuilt in the temp file.  Next, it reserves space and quota
793  * The caller must hold ILOCK_EXCL of the scrub target file and the temporary
794  * file.  The caller must join both inodes to the transaction with no unlock
828  * Create a new transaction for a file contents exchange.
832  * metadata file that has been rebuilt in the temp file.  Next, it reserves
875  * Exchange file mappings (and hence file contents) between the file being
876  * repaired and the temporary file.  Returns with both inodes locked and joined
909  * Write local format data from one of the temporary file's forks into the same
910  * fork of file being repaired, and exchange the file sizes, if appropriate.
911  * Caller must ensure that the file being repaired has enough fork space to
958 /* Decide if a given XFS inode is a temporary file for a repair. */