Home | History | Annotate | Download | only in ubi
      1 // SPDX-License-Identifier: GPL-2.0+
      2 /*
      3  * Copyright (c) 2012 Linutronix GmbH
      4  * Copyright (c) 2014 sigma star gmbh
      5  * Author: Richard Weinberger <richard (at) nod.at>
      6  *
      7  */
      8 
      9 /**
     10  * update_fastmap_work_fn - calls ubi_update_fastmap from a work queue
     11  * @wrk: the work description object
     12  */
     13 #ifndef __UBOOT__
     14 static void update_fastmap_work_fn(struct work_struct *wrk)
     15 #else
     16 void update_fastmap_work_fn(struct ubi_device *ubi)
     17 #endif
     18 {
     19 #ifndef __UBOOT__
     20 	struct ubi_device *ubi = container_of(wrk, struct ubi_device, fm_work);
     21 #endif
     22 
     23 	ubi_update_fastmap(ubi);
     24 	spin_lock(&ubi->wl_lock);
     25 	ubi->fm_work_scheduled = 0;
     26 	spin_unlock(&ubi->wl_lock);
     27 }
     28 
     29 /**
     30  * find_anchor_wl_entry - find wear-leveling entry to used as anchor PEB.
     31  * @root: the RB-tree where to look for
     32  */
     33 static struct ubi_wl_entry *find_anchor_wl_entry(struct rb_root *root)
     34 {
     35 	struct rb_node *p;
     36 	struct ubi_wl_entry *e, *victim = NULL;
     37 	int max_ec = UBI_MAX_ERASECOUNTER;
     38 
     39 	ubi_rb_for_each_entry(p, e, root, u.rb) {
     40 		if (e->pnum < UBI_FM_MAX_START && e->ec < max_ec) {
     41 			victim = e;
     42 			max_ec = e->ec;
     43 		}
     44 	}
     45 
     46 	return victim;
     47 }
     48 
     49 /**
     50  * return_unused_pool_pebs - returns unused PEB to the free tree.
     51  * @ubi: UBI device description object
     52  * @pool: fastmap pool description object
     53  */
     54 static void return_unused_pool_pebs(struct ubi_device *ubi,
     55 				    struct ubi_fm_pool *pool)
     56 {
     57 	int i;
     58 	struct ubi_wl_entry *e;
     59 
     60 	for (i = pool->used; i < pool->size; i++) {
     61 		e = ubi->lookuptbl[pool->pebs[i]];
     62 		wl_tree_add(e, &ubi->free);
     63 		ubi->free_count++;
     64 	}
     65 }
     66 
     67 static int anchor_pebs_avalible(struct rb_root *root)
     68 {
     69 	struct rb_node *p;
     70 	struct ubi_wl_entry *e;
     71 
     72 	ubi_rb_for_each_entry(p, e, root, u.rb)
     73 		if (e->pnum < UBI_FM_MAX_START)
     74 			return 1;
     75 
     76 	return 0;
     77 }
     78 
     79 /**
     80  * ubi_wl_get_fm_peb - find a physical erase block with a given maximal number.
     81  * @ubi: UBI device description object
     82  * @anchor: This PEB will be used as anchor PEB by fastmap
     83  *
     84  * The function returns a physical erase block with a given maximal number
     85  * and removes it from the wl subsystem.
     86  * Must be called with wl_lock held!
     87  */
     88 struct ubi_wl_entry *ubi_wl_get_fm_peb(struct ubi_device *ubi, int anchor)
     89 {
     90 	struct ubi_wl_entry *e = NULL;
     91 
     92 	if (!ubi->free.rb_node || (ubi->free_count - ubi->beb_rsvd_pebs < 1))
     93 		goto out;
     94 
     95 	if (anchor)
     96 		e = find_anchor_wl_entry(&ubi->free);
     97 	else
     98 		e = find_mean_wl_entry(ubi, &ubi->free);
     99 
    100 	if (!e)
    101 		goto out;
    102 
    103 	self_check_in_wl_tree(ubi, e, &ubi->free);
    104 
    105 	/* remove it from the free list,
    106 	 * the wl subsystem does no longer know this erase block */
    107 	rb_erase(&e->u.rb, &ubi->free);
    108 	ubi->free_count--;
    109 out:
    110 	return e;
    111 }
    112 
    113 /**
    114  * ubi_refill_pools - refills all fastmap PEB pools.
    115  * @ubi: UBI device description object
    116  */
    117 void ubi_refill_pools(struct ubi_device *ubi)
    118 {
    119 	struct ubi_fm_pool *wl_pool = &ubi->fm_wl_pool;
    120 	struct ubi_fm_pool *pool = &ubi->fm_pool;
    121 	struct ubi_wl_entry *e;
    122 	int enough;
    123 
    124 	spin_lock(&ubi->wl_lock);
    125 
    126 	return_unused_pool_pebs(ubi, wl_pool);
    127 	return_unused_pool_pebs(ubi, pool);
    128 
    129 	wl_pool->size = 0;
    130 	pool->size = 0;
    131 
    132 	for (;;) {
    133 		enough = 0;
    134 		if (pool->size < pool->max_size) {
    135 			if (!ubi->free.rb_node)
    136 				break;
    137 
    138 			e = wl_get_wle(ubi);
    139 			if (!e)
    140 				break;
    141 
    142 			pool->pebs[pool->size] = e->pnum;
    143 			pool->size++;
    144 		} else
    145 			enough++;
    146 
    147 		if (wl_pool->size < wl_pool->max_size) {
    148 			if (!ubi->free.rb_node ||
    149 			   (ubi->free_count - ubi->beb_rsvd_pebs < 5))
    150 				break;
    151 
    152 			e = find_wl_entry(ubi, &ubi->free, WL_FREE_MAX_DIFF);
    153 			self_check_in_wl_tree(ubi, e, &ubi->free);
    154 			rb_erase(&e->u.rb, &ubi->free);
    155 			ubi->free_count--;
    156 
    157 			wl_pool->pebs[wl_pool->size] = e->pnum;
    158 			wl_pool->size++;
    159 		} else
    160 			enough++;
    161 
    162 		if (enough == 2)
    163 			break;
    164 	}
    165 
    166 	wl_pool->used = 0;
    167 	pool->used = 0;
    168 
    169 	spin_unlock(&ubi->wl_lock);
    170 }
    171 
    172 /**
    173  * produce_free_peb - produce a free physical eraseblock.
    174  * @ubi: UBI device description object
    175  *
    176  * This function tries to make a free PEB by means of synchronous execution of
    177  * pending works. This may be needed if, for example the background thread is
    178  * disabled. Returns zero in case of success and a negative error code in case
    179  * of failure.
    180  */
    181 static int produce_free_peb(struct ubi_device *ubi)
    182 {
    183 	int err;
    184 
    185 	while (!ubi->free.rb_node && ubi->works_count) {
    186 		dbg_wl("do one work synchronously");
    187 		err = do_work(ubi);
    188 
    189 		if (err)
    190 			return err;
    191 	}
    192 
    193 	return 0;
    194 }
    195 
    196 /**
    197  * ubi_wl_get_peb - get a physical eraseblock.
    198  * @ubi: UBI device description object
    199  *
    200  * This function returns a physical eraseblock in case of success and a
    201  * negative error code in case of failure.
    202  * Returns with ubi->fm_eba_sem held in read mode!
    203  */
    204 int ubi_wl_get_peb(struct ubi_device *ubi)
    205 {
    206 	int ret, retried = 0;
    207 	struct ubi_fm_pool *pool = &ubi->fm_pool;
    208 	struct ubi_fm_pool *wl_pool = &ubi->fm_wl_pool;
    209 
    210 again:
    211 	down_read(&ubi->fm_eba_sem);
    212 	spin_lock(&ubi->wl_lock);
    213 
    214 	/* We check here also for the WL pool because at this point we can
    215 	 * refill the WL pool synchronous. */
    216 	if (pool->used == pool->size || wl_pool->used == wl_pool->size) {
    217 		spin_unlock(&ubi->wl_lock);
    218 		up_read(&ubi->fm_eba_sem);
    219 		ret = ubi_update_fastmap(ubi);
    220 		if (ret) {
    221 			ubi_msg(ubi, "Unable to write a new fastmap: %i", ret);
    222 			down_read(&ubi->fm_eba_sem);
    223 			return -ENOSPC;
    224 		}
    225 		down_read(&ubi->fm_eba_sem);
    226 		spin_lock(&ubi->wl_lock);
    227 	}
    228 
    229 	if (pool->used == pool->size) {
    230 		spin_unlock(&ubi->wl_lock);
    231 		if (retried) {
    232 			ubi_err(ubi, "Unable to get a free PEB from user WL pool");
    233 			ret = -ENOSPC;
    234 			goto out;
    235 		}
    236 		retried = 1;
    237 		up_read(&ubi->fm_eba_sem);
    238 		ret = produce_free_peb(ubi);
    239 		if (ret < 0) {
    240 			down_read(&ubi->fm_eba_sem);
    241 			goto out;
    242 		}
    243 		goto again;
    244 	}
    245 
    246 	ubi_assert(pool->used < pool->size);
    247 	ret = pool->pebs[pool->used++];
    248 	prot_queue_add(ubi, ubi->lookuptbl[ret]);
    249 	spin_unlock(&ubi->wl_lock);
    250 out:
    251 	return ret;
    252 }
    253 
    254 /* get_peb_for_wl - returns a PEB to be used internally by the WL sub-system.
    255  *
    256  * @ubi: UBI device description object
    257  */
    258 static struct ubi_wl_entry *get_peb_for_wl(struct ubi_device *ubi)
    259 {
    260 	struct ubi_fm_pool *pool = &ubi->fm_wl_pool;
    261 	int pnum;
    262 
    263 	if (pool->used == pool->size) {
    264 #ifndef __UBOOT__
    265 		/* We cannot update the fastmap here because this
    266 		 * function is called in atomic context.
    267 		 * Let's fail here and refill/update it as soon as possible. */
    268 		if (!ubi->fm_work_scheduled) {
    269 			ubi->fm_work_scheduled = 1;
    270 			schedule_work(&ubi->fm_work);
    271 		}
    272 		return NULL;
    273 #else
    274 		/*
    275 		 * No work queues in U-Boot, we must do this immediately
    276 		 */
    277 		update_fastmap_work_fn(ubi);
    278 #endif
    279 	}
    280 
    281 	pnum = pool->pebs[pool->used++];
    282 	return ubi->lookuptbl[pnum];
    283 }
    284 
    285 /**
    286  * ubi_ensure_anchor_pebs - schedule wear-leveling to produce an anchor PEB.
    287  * @ubi: UBI device description object
    288  */
    289 int ubi_ensure_anchor_pebs(struct ubi_device *ubi)
    290 {
    291 	struct ubi_work *wrk;
    292 
    293 	spin_lock(&ubi->wl_lock);
    294 	if (ubi->wl_scheduled) {
    295 		spin_unlock(&ubi->wl_lock);
    296 		return 0;
    297 	}
    298 	ubi->wl_scheduled = 1;
    299 	spin_unlock(&ubi->wl_lock);
    300 
    301 	wrk = kmalloc(sizeof(struct ubi_work), GFP_NOFS);
    302 	if (!wrk) {
    303 		spin_lock(&ubi->wl_lock);
    304 		ubi->wl_scheduled = 0;
    305 		spin_unlock(&ubi->wl_lock);
    306 		return -ENOMEM;
    307 	}
    308 
    309 	wrk->anchor = 1;
    310 	wrk->func = &wear_leveling_worker;
    311 	schedule_ubi_work(ubi, wrk);
    312 	return 0;
    313 }
    314 
    315 /**
    316  * ubi_wl_put_fm_peb - returns a PEB used in a fastmap to the wear-leveling
    317  * sub-system.
    318  * see: ubi_wl_put_peb()
    319  *
    320  * @ubi: UBI device description object
    321  * @fm_e: physical eraseblock to return
    322  * @lnum: the last used logical eraseblock number for the PEB
    323  * @torture: if this physical eraseblock has to be tortured
    324  */
    325 int ubi_wl_put_fm_peb(struct ubi_device *ubi, struct ubi_wl_entry *fm_e,
    326 		      int lnum, int torture)
    327 {
    328 	struct ubi_wl_entry *e;
    329 	int vol_id, pnum = fm_e->pnum;
    330 
    331 	dbg_wl("PEB %d", pnum);
    332 
    333 	ubi_assert(pnum >= 0);
    334 	ubi_assert(pnum < ubi->peb_count);
    335 
    336 	spin_lock(&ubi->wl_lock);
    337 	e = ubi->lookuptbl[pnum];
    338 
    339 	/* This can happen if we recovered from a fastmap the very
    340 	 * first time and writing now a new one. In this case the wl system
    341 	 * has never seen any PEB used by the original fastmap.
    342 	 */
    343 	if (!e) {
    344 		e = fm_e;
    345 		ubi_assert(e->ec >= 0);
    346 		ubi->lookuptbl[pnum] = e;
    347 	}
    348 
    349 	spin_unlock(&ubi->wl_lock);
    350 
    351 	vol_id = lnum ? UBI_FM_DATA_VOLUME_ID : UBI_FM_SB_VOLUME_ID;
    352 	return schedule_erase(ubi, e, vol_id, lnum, torture);
    353 }
    354 
    355 /**
    356  * ubi_is_erase_work - checks whether a work is erase work.
    357  * @wrk: The work object to be checked
    358  */
    359 int ubi_is_erase_work(struct ubi_work *wrk)
    360 {
    361 	return wrk->func == erase_worker;
    362 }
    363 
    364 static void ubi_fastmap_close(struct ubi_device *ubi)
    365 {
    366 	int i;
    367 
    368 	return_unused_pool_pebs(ubi, &ubi->fm_pool);
    369 	return_unused_pool_pebs(ubi, &ubi->fm_wl_pool);
    370 
    371 	if (ubi->fm) {
    372 		for (i = 0; i < ubi->fm->used_blocks; i++)
    373 			kfree(ubi->fm->e[i]);
    374 	}
    375 	kfree(ubi->fm);
    376 }
    377 
    378 /**
    379  * may_reserve_for_fm - tests whether a PEB shall be reserved for fastmap.
    380  * See find_mean_wl_entry()
    381  *
    382  * @ubi: UBI device description object
    383  * @e: physical eraseblock to return
    384  * @root: RB tree to test against.
    385  */
    386 static struct ubi_wl_entry *may_reserve_for_fm(struct ubi_device *ubi,
    387 					   struct ubi_wl_entry *e,
    388 					   struct rb_root *root) {
    389 	if (e && !ubi->fm_disabled && !ubi->fm &&
    390 	    e->pnum < UBI_FM_MAX_START)
    391 		e = rb_entry(rb_next(root->rb_node),
    392 			     struct ubi_wl_entry, u.rb);
    393 
    394 	return e;
    395 }
    396