mtd/ubi/eba.c

9  * The UBI Eraseblock Association (EBA) sub-system.
11  * This sub-system is responsible for I/O to/from logical eraseblock.
17  * The EBA sub-system implements per-logical eraseblock locking. Before
18  * accessing a logical eraseblock it is locked for reading or writing. The
19  * per-logical eraseblock locking is implemented by means of the lock tree. The
25  * time a logical eraseblock is mapped to a physical eraseblock and it is
38  * @pnum: the physical eraseblock number attached to the LEB
97  * @lnum: logical eraseblock number
201  * @lnum: logical eraseblock number
204  * object if the logical eraseblock is locked and %NULL if it is not.
239  * @lnum: logical eraseblock number
241  * This function adds new entry for logical eraseblock (@vol_id, @lnum) to the
265 		 * This logical eraseblock is already locked. The newly  in ltree_add_entry()
308  * leb_read_lock - lock logical eraseblock for reading.
311  * @lnum: logical eraseblock number
313  * This function locks a logical eraseblock for reading. Returns zero in case
328  * leb_read_unlock - unlock logical eraseblock.
331  * @lnum: logical eraseblock number
350  * leb_write_lock - lock logical eraseblock for writing.
353  * @lnum: logical eraseblock number
355  * This function locks a logical eraseblock for writing. Returns zero in case
370  * leb_write_trylock - try to lock logical eraseblock for writing.
373  * @lnum: logical eraseblock number
375  * This function locks a logical eraseblock for writing if there is no
404  * leb_write_unlock - unlock logical eraseblock.
407  * @lnum: logical eraseblock number
428  * @lnum: logical eraseblock number
438  * ubi_eba_unmap_leb - un-map logical eraseblock.
441  * @lnum: logical eraseblock number
443  * This function un-maps logical eraseblock @lnum and schedules corresponding
444  * physical eraseblock for erasure. Returns zero in case of success and a
461 		/* This logical eraseblock is already unmapped */  in ubi_eba_unmap_leb()
481  * @lnum: logical eraseblock number
482  * @pnum: physical eraseblock number
577  * @lnum: logical eraseblock number
583  * If the logical eraseblock @lnum is unmapped, @buf is filled with 0xFF
585  * eraseblock data CRC checking.
613 		 * The logical eraseblock is not mapped, fill the whole buffer  in ubi_eba_read_leb()
734  * @lnum: logical eraseblock number
788  * @pnum: the physical eraseblock to recover
789  * @lnum: logical eraseblock number
797  * from the potentially bad physical eraseblock to a good physical eraseblock.
873 		 * Bad luck? This physical eraseblock is bad too? Crud. Let's  in try_recover_peb()
886  * @pnum: the physical eraseblock to recover
888  * @lnum: logical eraseblock number
894  * from the potentially bad physical eraseblock to a good physical eraseblock.
929  * @lnum: logical eraseblock number
936  * eraseblock @lnum of volume @vol to a new physical eraseblock. Returns zero
984 			ubi_warn(ubi, "failed to return physical eraseblock %d, error %d",  in try_write_vid_and_data()
990 			ubi_warn(ubi, "failed to return physical eraseblock %d, error %d",  in try_write_vid_and_data()
1002  * @lnum: logical eraseblock number
1004  * @offset: offset within the logical eraseblock where to write
1007  * This function writes data to logical eraseblock @lnum of a dynamic volume
1050 	 * The logical eraseblock is not mapped. We have to get a free physical  in ubi_eba_write_leb()
1051 	 * eraseblock and write the volume identifier header there first.  in ubi_eba_write_leb()
1075 		 * physical eraseblock, so just put it and request a new one.  in ubi_eba_write_leb()
1076 		 * We assume that if this physical eraseblock went bad, the  in ubi_eba_write_leb()
1098  * @lnum: logical eraseblock number
1103  * This function writes data to logical eraseblock @lnum of static volume
1105  * eraseblock in this static volume.
1107  * When writing to the last logical eraseblock, the @len argument doesn't have
1178  * ubi_eba_atomic_leb_change - change logical eraseblock atomically.
1181  * @lnum: logical eraseblock number
1185  * This function changes the contents of a logical eraseblock atomically. @buf
1186  * has to contain new logical eraseblock data, and @len - the length of the
1294  * ubi_eba_copy_leb - copy logical eraseblock.
1296  * @from: physical eraseblock number from where to copy
1297  * @to: physical eraseblock number where to copy
1300  * This function copies logical eraseblock from physical eraseblock @from to
1301  * physical eraseblock @to. The @vid_hdr buffer may be changed by this
1333 	 * this logical eraseblock belongs to might be being deleted. Since the  in ubi_eba_copy_leb()
1346 	 * We do not want anybody to write to this logical eraseblock while we  in ubi_eba_copy_leb()
1413 	 * It may turn out to be that the whole @from physical eraseblock  in ubi_eba_copy_leb()