46  * 1. Preserve (Normal Operation): A userspace agent preserves files one by one
52  *    It iterates through all preserved files, calls their respective .freeze()
65  *    re-create the 'struct file', and returns a new FD. Files can be
69  *    luo_file_finish() is called. It iterates through all files, invokes their
79  *    all preserved files, ensuring all allocated resources are cleaned up and
89  *    all files within that session, including those that were not yet
116 /* 2 4K pages, give space for 128 files per file_set */
143  *                 file_set's list of preserved files.
174 	if (file_set->files)  in luo_alloc_files_mem()
184 	file_set->files = mem;  in luo_alloc_files_mem()
191 	/* If file_set has files, no need to free preservation memory */  in luo_free_files_mem()
195 	if (!file_set->files)  in luo_free_files_mem()
198 	kho_unpreserve_free(file_set->files);  in luo_free_files_mem()
199 	file_set->files = NULL;  in luo_free_files_mem()
230  * 2. Ensures the file_set's memory for files serialization is allocated
323  * luo_file_unpreserve_files - Unpreserves all files from a file_set.
324  * @file_set: The files to be cleaned up.
337  * After all individual files are unpreserved, it frees the contiguous memory
422 	memset(file_set->files, 0, LUO_FILE_PGCNT << PAGE_SHIFT);  in __luo_file_unfreeze()
426  * luo_file_freeze - Freezes all preserved files and serializes their metadata.
427  * @file_set:     The file_set whose files are to be frozen.
432  * final preparation and serialization of all preserved files in the file_set.
445  *    (file_set->files) that will be handed over to the next kernel via KHO.
450  * immediately called to invoke the .unfreeze() op on all files that were
461 	struct luo_file_ser *file_ser = file_set->files;  in luo_file_freeze()
490 	if (file_set->files)  in luo_file_freeze()
491 		file_set_ser->files = virt_to_phys(file_set->files);  in luo_file_freeze()
502  * luo_file_unfreeze - Unfreezes all files in a file_set and clear serialization
503  * @file_set:     The file_set whose files are to be unfrozen.
506  * This function rolls back the state of all files in a file_set after the
511  * signals the helper to iterate through all files in the file_set and call
536  * files for an entry matching the provided @token.
635  * luo_file_finish - Completes the lifecycle for all files in a file_set.
639  * the new kernel. It should be called after all necessary files have been
642  * The function iterates through all tracked files. For each file, it performs
655  * After successfully finishing all individual files, it frees the
695 	if (file_set->files) {  in luo_file_finish()
696 		kho_restore_free(file_set->files);  in luo_file_finish()
697 		file_set->files = NULL;  in luo_file_finish()
704  * luo_file_deserialize - Reconstructs the list of preserved files in the new kernel.
734 	if (!file_set_ser->files) {  in luo_file_deserialize()
740 	file_set->files = phys_to_virt(file_set_ser->files);  in luo_file_deserialize()
746 	 * we intentionally skip cleanup of files that were already restored.  in luo_file_deserialize()
750 	 * files, hardware state) is error-prone and provides little value, as  in luo_file_deserialize()
757 	file_ser = file_set->files;  in luo_file_deserialize()