xref: /openbmc/linux/drivers/mtd/nftlmount.c (revision 9fb29c73)
1 /*
2  * NFTL mount code with extensive checks
3  *
4  * Author: Fabrice Bellard (fabrice.bellard@netgem.com)
5  * Copyright © 2000 Netgem S.A.
6  * Copyright © 1999-2010 David Woodhouse <dwmw2@infradead.org>
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
21  */
22 
23 #include <linux/kernel.h>
24 #include <asm/errno.h>
25 #include <linux/delay.h>
26 #include <linux/slab.h>
27 #include <linux/mtd/mtd.h>
28 #include <linux/mtd/rawnand.h>
29 #include <linux/mtd/nftl.h>
30 
31 #define SECTORSIZE 512
32 
33 /* find_boot_record: Find the NFTL Media Header and its Spare copy which contains the
34  *	various device information of the NFTL partition and Bad Unit Table. Update
35  *	the ReplUnitTable[] table according to the Bad Unit Table. ReplUnitTable[]
36  *	is used for management of Erase Unit in other routines in nftl.c and nftlmount.c
37  */
38 static int find_boot_record(struct NFTLrecord *nftl)
39 {
40 	struct nftl_uci1 h1;
41 	unsigned int block, boot_record_count = 0;
42 	size_t retlen;
43 	u8 buf[SECTORSIZE];
44 	struct NFTLMediaHeader *mh = &nftl->MediaHdr;
45 	struct mtd_info *mtd = nftl->mbd.mtd;
46 	unsigned int i;
47 
48         /* Assume logical EraseSize == physical erasesize for starting the scan.
49 	   We'll sort it out later if we find a MediaHeader which says otherwise */
50 	/* Actually, we won't.  The new DiskOnChip driver has already scanned
51 	   the MediaHeader and adjusted the virtual erasesize it presents in
52 	   the mtd device accordingly.  We could even get rid of
53 	   nftl->EraseSize if there were any point in doing so. */
54 	nftl->EraseSize = nftl->mbd.mtd->erasesize;
55         nftl->nb_blocks = (u32)nftl->mbd.mtd->size / nftl->EraseSize;
56 
57 	nftl->MediaUnit = BLOCK_NIL;
58 	nftl->SpareMediaUnit = BLOCK_NIL;
59 
60 	/* search for a valid boot record */
61 	for (block = 0; block < nftl->nb_blocks; block++) {
62 		int ret;
63 
64 		/* Check for ANAND header first. Then can whinge if it's found but later
65 		   checks fail */
66 		ret = mtd_read(mtd, block * nftl->EraseSize, SECTORSIZE,
67 			       &retlen, buf);
68 		/* We ignore ret in case the ECC of the MediaHeader is invalid
69 		   (which is apparently acceptable) */
70 		if (retlen != SECTORSIZE) {
71 			static int warncount = 5;
72 
73 			if (warncount) {
74 				printk(KERN_WARNING "Block read at 0x%x of mtd%d failed: %d\n",
75 				       block * nftl->EraseSize, nftl->mbd.mtd->index, ret);
76 				if (!--warncount)
77 					printk(KERN_WARNING "Further failures for this block will not be printed\n");
78 			}
79 			continue;
80 		}
81 
82 		if (retlen < 6 || memcmp(buf, "ANAND", 6)) {
83 			/* ANAND\0 not found. Continue */
84 #if 0
85 			printk(KERN_DEBUG "ANAND header not found at 0x%x in mtd%d\n",
86 			       block * nftl->EraseSize, nftl->mbd.mtd->index);
87 #endif
88 			continue;
89 		}
90 
91 		/* To be safer with BIOS, also use erase mark as discriminant */
92 		ret = nftl_read_oob(mtd, block * nftl->EraseSize +
93 					 SECTORSIZE + 8, 8, &retlen,
94 					 (char *)&h1);
95 		if (ret < 0) {
96 			printk(KERN_WARNING "ANAND header found at 0x%x in mtd%d, but OOB data read failed (err %d)\n",
97 			       block * nftl->EraseSize, nftl->mbd.mtd->index, ret);
98 			continue;
99 		}
100 
101 #if 0 /* Some people seem to have devices without ECC or erase marks
102 	 on the Media Header blocks. There are enough other sanity
103 	 checks in here that we can probably do without it.
104       */
105 		if (le16_to_cpu(h1.EraseMark | h1.EraseMark1) != ERASE_MARK) {
106 			printk(KERN_NOTICE "ANAND header found at 0x%x in mtd%d, but erase mark not present (0x%04x,0x%04x instead)\n",
107 			       block * nftl->EraseSize, nftl->mbd.mtd->index,
108 			       le16_to_cpu(h1.EraseMark), le16_to_cpu(h1.EraseMark1));
109 			continue;
110 		}
111 
112 		/* Finally reread to check ECC */
113 		ret = mtd->read(mtd, block * nftl->EraseSize, SECTORSIZE,
114 				&retlen, buf);
115 		if (ret < 0) {
116 			printk(KERN_NOTICE "ANAND header found at 0x%x in mtd%d, but ECC read failed (err %d)\n",
117 			       block * nftl->EraseSize, nftl->mbd.mtd->index, ret);
118 			continue;
119 		}
120 
121 		/* Paranoia. Check the ANAND header is still there after the ECC read */
122 		if (memcmp(buf, "ANAND", 6)) {
123 			printk(KERN_NOTICE "ANAND header found at 0x%x in mtd%d, but went away on reread!\n",
124 			       block * nftl->EraseSize, nftl->mbd.mtd->index);
125 			printk(KERN_NOTICE "New data are: %6ph\n", buf);
126 			continue;
127 		}
128 #endif
129 		/* OK, we like it. */
130 
131 		if (boot_record_count) {
132 			/* We've already processed one. So we just check if
133 			   this one is the same as the first one we found */
134 			if (memcmp(mh, buf, sizeof(struct NFTLMediaHeader))) {
135 				printk(KERN_NOTICE "NFTL Media Headers at 0x%x and 0x%x disagree.\n",
136 				       nftl->MediaUnit * nftl->EraseSize, block * nftl->EraseSize);
137 				/* if (debug) Print both side by side */
138 				if (boot_record_count < 2) {
139 					/* We haven't yet seen two real ones */
140 					return -1;
141 				}
142 				continue;
143 			}
144 			if (boot_record_count == 1)
145 				nftl->SpareMediaUnit = block;
146 
147 			/* Mark this boot record (NFTL MediaHeader) block as reserved */
148 			nftl->ReplUnitTable[block] = BLOCK_RESERVED;
149 
150 
151 			boot_record_count++;
152 			continue;
153 		}
154 
155 		/* This is the first we've seen. Copy the media header structure into place */
156 		memcpy(mh, buf, sizeof(struct NFTLMediaHeader));
157 
158 		/* Do some sanity checks on it */
159 #if 0
160 The new DiskOnChip driver scans the MediaHeader itself, and presents a virtual
161 erasesize based on UnitSizeFactor.  So the erasesize we read from the mtd
162 device is already correct.
163 		if (mh->UnitSizeFactor == 0) {
164 			printk(KERN_NOTICE "NFTL: UnitSizeFactor 0x00 detected. This violates the spec but we think we know what it means...\n");
165 		} else if (mh->UnitSizeFactor < 0xfc) {
166 			printk(KERN_NOTICE "Sorry, we don't support UnitSizeFactor 0x%02x\n",
167 			       mh->UnitSizeFactor);
168 			return -1;
169 		} else if (mh->UnitSizeFactor != 0xff) {
170 			printk(KERN_NOTICE "WARNING: Support for NFTL with UnitSizeFactor 0x%02x is experimental\n",
171 			       mh->UnitSizeFactor);
172 			nftl->EraseSize = nftl->mbd.mtd->erasesize << (0xff - mh->UnitSizeFactor);
173 			nftl->nb_blocks = (u32)nftl->mbd.mtd->size / nftl->EraseSize;
174 		}
175 #endif
176 		nftl->nb_boot_blocks = le16_to_cpu(mh->FirstPhysicalEUN);
177 		if ((nftl->nb_boot_blocks + 2) >= nftl->nb_blocks) {
178 			printk(KERN_NOTICE "NFTL Media Header sanity check failed:\n");
179 			printk(KERN_NOTICE "nb_boot_blocks (%d) + 2 > nb_blocks (%d)\n",
180 			       nftl->nb_boot_blocks, nftl->nb_blocks);
181 			return -1;
182 		}
183 
184 		nftl->numvunits = le32_to_cpu(mh->FormattedSize) / nftl->EraseSize;
185 		if (nftl->numvunits > (nftl->nb_blocks - nftl->nb_boot_blocks - 2)) {
186 			printk(KERN_NOTICE "NFTL Media Header sanity check failed:\n");
187 			printk(KERN_NOTICE "numvunits (%d) > nb_blocks (%d) - nb_boot_blocks(%d) - 2\n",
188 			       nftl->numvunits, nftl->nb_blocks, nftl->nb_boot_blocks);
189 			return -1;
190 		}
191 
192 		nftl->mbd.size  = nftl->numvunits * (nftl->EraseSize / SECTORSIZE);
193 
194 		/* If we're not using the last sectors in the device for some reason,
195 		   reduce nb_blocks accordingly so we forget they're there */
196 		nftl->nb_blocks = le16_to_cpu(mh->NumEraseUnits) + le16_to_cpu(mh->FirstPhysicalEUN);
197 
198 		/* XXX: will be suppressed */
199 		nftl->lastEUN = nftl->nb_blocks - 1;
200 
201 		/* memory alloc */
202 		nftl->EUNtable = kmalloc_array(nftl->nb_blocks, sizeof(u16),
203 					       GFP_KERNEL);
204 		if (!nftl->EUNtable) {
205 			printk(KERN_NOTICE "NFTL: allocation of EUNtable failed\n");
206 			return -ENOMEM;
207 		}
208 
209 		nftl->ReplUnitTable = kmalloc_array(nftl->nb_blocks,
210 						    sizeof(u16),
211 						    GFP_KERNEL);
212 		if (!nftl->ReplUnitTable) {
213 			kfree(nftl->EUNtable);
214 			printk(KERN_NOTICE "NFTL: allocation of ReplUnitTable failed\n");
215 			return -ENOMEM;
216 		}
217 
218 		/* mark the bios blocks (blocks before NFTL MediaHeader) as reserved */
219 		for (i = 0; i < nftl->nb_boot_blocks; i++)
220 			nftl->ReplUnitTable[i] = BLOCK_RESERVED;
221 		/* mark all remaining blocks as potentially containing data */
222 		for (; i < nftl->nb_blocks; i++) {
223 			nftl->ReplUnitTable[i] = BLOCK_NOTEXPLORED;
224 		}
225 
226 		/* Mark this boot record (NFTL MediaHeader) block as reserved */
227 		nftl->ReplUnitTable[block] = BLOCK_RESERVED;
228 
229 		/* read the Bad Erase Unit Table and modify ReplUnitTable[] accordingly */
230 		for (i = 0; i < nftl->nb_blocks; i++) {
231 #if 0
232 The new DiskOnChip driver already scanned the bad block table.  Just query it.
233 			if ((i & (SECTORSIZE - 1)) == 0) {
234 				/* read one sector for every SECTORSIZE of blocks */
235 				ret = mtd->read(nftl->mbd.mtd,
236 						block * nftl->EraseSize + i +
237 						SECTORSIZE, SECTORSIZE,
238 						&retlen, buf);
239 				if (ret < 0) {
240 					printk(KERN_NOTICE "Read of bad sector table failed (err %d)\n",
241 					       ret);
242 					kfree(nftl->ReplUnitTable);
243 					kfree(nftl->EUNtable);
244 					return -1;
245 				}
246 			}
247 			/* mark the Bad Erase Unit as RESERVED in ReplUnitTable */
248 			if (buf[i & (SECTORSIZE - 1)] != 0xff)
249 				nftl->ReplUnitTable[i] = BLOCK_RESERVED;
250 #endif
251 			if (mtd_block_isbad(nftl->mbd.mtd,
252 					    i * nftl->EraseSize))
253 				nftl->ReplUnitTable[i] = BLOCK_RESERVED;
254 		}
255 
256 		nftl->MediaUnit = block;
257 		boot_record_count++;
258 
259 	} /* foreach (block) */
260 
261 	return boot_record_count?0:-1;
262 }
263 
264 static int memcmpb(void *a, int c, int n)
265 {
266 	int i;
267 	for (i = 0; i < n; i++) {
268 		if (c != ((unsigned char *)a)[i])
269 			return 1;
270 	}
271 	return 0;
272 }
273 
274 /* check_free_sector: check if a free sector is actually FREE, i.e. All 0xff in data and oob area */
275 static int check_free_sectors(struct NFTLrecord *nftl, unsigned int address, int len,
276 			      int check_oob)
277 {
278 	struct mtd_info *mtd = nftl->mbd.mtd;
279 	size_t retlen;
280 	int i, ret;
281 	u8 *buf;
282 
283 	buf = kmalloc(SECTORSIZE + mtd->oobsize, GFP_KERNEL);
284 	if (!buf)
285 		return -1;
286 
287 	ret = -1;
288 	for (i = 0; i < len; i += SECTORSIZE) {
289 		if (mtd_read(mtd, address, SECTORSIZE, &retlen, buf))
290 			goto out;
291 		if (memcmpb(buf, 0xff, SECTORSIZE) != 0)
292 			goto out;
293 
294 		if (check_oob) {
295 			if(nftl_read_oob(mtd, address, mtd->oobsize,
296 					 &retlen, &buf[SECTORSIZE]) < 0)
297 				goto out;
298 			if (memcmpb(buf + SECTORSIZE, 0xff, mtd->oobsize) != 0)
299 				goto out;
300 		}
301 		address += SECTORSIZE;
302 	}
303 
304 	ret = 0;
305 
306 out:
307 	kfree(buf);
308 	return ret;
309 }
310 
311 /* NFTL_format: format a Erase Unit by erasing ALL Erase Zones in the Erase Unit and
312  *              Update NFTL metadata. Each erase operation is checked with check_free_sectors
313  *
314  * Return: 0 when succeed, -1 on error.
315  *
316  *  ToDo: 1. Is it necessary to check_free_sector after erasing ??
317  */
318 int NFTL_formatblock(struct NFTLrecord *nftl, int block)
319 {
320 	size_t retlen;
321 	unsigned int nb_erases, erase_mark;
322 	struct nftl_uci1 uci;
323 	struct erase_info *instr = &nftl->instr;
324 	struct mtd_info *mtd = nftl->mbd.mtd;
325 
326 	/* Read the Unit Control Information #1 for Wear-Leveling */
327 	if (nftl_read_oob(mtd, block * nftl->EraseSize + SECTORSIZE + 8,
328 			  8, &retlen, (char *)&uci) < 0)
329 		goto default_uci1;
330 
331 	erase_mark = le16_to_cpu ((uci.EraseMark | uci.EraseMark1));
332 	if (erase_mark != ERASE_MARK) {
333 	default_uci1:
334 		uci.EraseMark = cpu_to_le16(ERASE_MARK);
335 		uci.EraseMark1 = cpu_to_le16(ERASE_MARK);
336 		uci.WearInfo = cpu_to_le32(0);
337 	}
338 
339 	memset(instr, 0, sizeof(struct erase_info));
340 
341 	/* XXX: use async erase interface, XXX: test return code */
342 	instr->addr = block * nftl->EraseSize;
343 	instr->len = nftl->EraseSize;
344 	if (mtd_erase(mtd, instr)) {
345 		printk("Error while formatting block %d\n", block);
346 		goto fail;
347 	}
348 
349 	/* increase and write Wear-Leveling info */
350 	nb_erases = le32_to_cpu(uci.WearInfo);
351 	nb_erases++;
352 
353 	/* wrap (almost impossible with current flash) or free block */
354 	if (nb_erases == 0)
355 		nb_erases = 1;
356 
357 	/* check the "freeness" of Erase Unit before updating metadata
358 	 * FixMe:  is this check really necessary ? since we have check the
359 	 *         return code after the erase operation.
360 	 */
361 	if (check_free_sectors(nftl, instr->addr, nftl->EraseSize, 1) != 0)
362 		goto fail;
363 
364 	uci.WearInfo = le32_to_cpu(nb_erases);
365 	if (nftl_write_oob(mtd, block * nftl->EraseSize + SECTORSIZE +
366 			   8, 8, &retlen, (char *)&uci) < 0)
367 		goto fail;
368 	return 0;
369 fail:
370 	/* could not format, update the bad block table (caller is responsible
371 	   for setting the ReplUnitTable to BLOCK_RESERVED on failure) */
372 	mtd_block_markbad(nftl->mbd.mtd, instr->addr);
373 	return -1;
374 }
375 
376 /* check_sectors_in_chain: Check that each sector of a Virtual Unit Chain is correct.
377  *	Mark as 'IGNORE' each incorrect sector. This check is only done if the chain
378  *	was being folded when NFTL was interrupted.
379  *
380  *	The check_free_sectors in this function is necessary. There is a possible
381  *	situation that after writing the Data area, the Block Control Information is
382  *	not updated according (due to power failure or something) which leaves the block
383  *	in an inconsistent state. So we have to check if a block is really FREE in this
384  *	case. */
385 static void check_sectors_in_chain(struct NFTLrecord *nftl, unsigned int first_block)
386 {
387 	struct mtd_info *mtd = nftl->mbd.mtd;
388 	unsigned int block, i, status;
389 	struct nftl_bci bci;
390 	int sectors_per_block;
391 	size_t retlen;
392 
393 	sectors_per_block = nftl->EraseSize / SECTORSIZE;
394 	block = first_block;
395 	for (;;) {
396 		for (i = 0; i < sectors_per_block; i++) {
397 			if (nftl_read_oob(mtd,
398 					  block * nftl->EraseSize + i * SECTORSIZE,
399 					  8, &retlen, (char *)&bci) < 0)
400 				status = SECTOR_IGNORE;
401 			else
402 				status = bci.Status | bci.Status1;
403 
404 			switch(status) {
405 			case SECTOR_FREE:
406 				/* verify that the sector is really free. If not, mark
407 				   as ignore */
408 				if (memcmpb(&bci, 0xff, 8) != 0 ||
409 				    check_free_sectors(nftl, block * nftl->EraseSize + i * SECTORSIZE,
410 						       SECTORSIZE, 0) != 0) {
411 					printk("Incorrect free sector %d in block %d: "
412 					       "marking it as ignored\n",
413 					       i, block);
414 
415 					/* sector not free actually : mark it as SECTOR_IGNORE  */
416 					bci.Status = SECTOR_IGNORE;
417 					bci.Status1 = SECTOR_IGNORE;
418 					nftl_write_oob(mtd, block *
419 						       nftl->EraseSize +
420 						       i * SECTORSIZE, 8,
421 						       &retlen, (char *)&bci);
422 				}
423 				break;
424 			default:
425 				break;
426 			}
427 		}
428 
429 		/* proceed to next Erase Unit on the chain */
430 		block = nftl->ReplUnitTable[block];
431 		if (!(block == BLOCK_NIL || block < nftl->nb_blocks))
432 			printk("incorrect ReplUnitTable[] : %d\n", block);
433 		if (block == BLOCK_NIL || block >= nftl->nb_blocks)
434 			break;
435 	}
436 }
437 
438 /* calc_chain_length: Walk through a Virtual Unit Chain and estimate chain length */
439 static int calc_chain_length(struct NFTLrecord *nftl, unsigned int first_block)
440 {
441 	unsigned int length = 0, block = first_block;
442 
443 	for (;;) {
444 		length++;
445 		/* avoid infinite loops, although this is guaranteed not to
446 		   happen because of the previous checks */
447 		if (length >= nftl->nb_blocks) {
448 			printk("nftl: length too long %d !\n", length);
449 			break;
450 		}
451 
452 		block = nftl->ReplUnitTable[block];
453 		if (!(block == BLOCK_NIL || block < nftl->nb_blocks))
454 			printk("incorrect ReplUnitTable[] : %d\n", block);
455 		if (block == BLOCK_NIL || block >= nftl->nb_blocks)
456 			break;
457 	}
458 	return length;
459 }
460 
461 /* format_chain: Format an invalid Virtual Unit chain. It frees all the Erase Units in a
462  *	Virtual Unit Chain, i.e. all the units are disconnected.
463  *
464  *	It is not strictly correct to begin from the first block of the chain because
465  *	if we stop the code, we may see again a valid chain if there was a first_block
466  *	flag in a block inside it. But is it really a problem ?
467  *
468  * FixMe: Figure out what the last statement means. What if power failure when we are
469  *	in the for (;;) loop formatting blocks ??
470  */
471 static void format_chain(struct NFTLrecord *nftl, unsigned int first_block)
472 {
473 	unsigned int block = first_block, block1;
474 
475 	printk("Formatting chain at block %d\n", first_block);
476 
477 	for (;;) {
478 		block1 = nftl->ReplUnitTable[block];
479 
480 		printk("Formatting block %d\n", block);
481 		if (NFTL_formatblock(nftl, block) < 0) {
482 			/* cannot format !!!! Mark it as Bad Unit */
483 			nftl->ReplUnitTable[block] = BLOCK_RESERVED;
484 		} else {
485 			nftl->ReplUnitTable[block] = BLOCK_FREE;
486 		}
487 
488 		/* goto next block on the chain */
489 		block = block1;
490 
491 		if (!(block == BLOCK_NIL || block < nftl->nb_blocks))
492 			printk("incorrect ReplUnitTable[] : %d\n", block);
493 		if (block == BLOCK_NIL || block >= nftl->nb_blocks)
494 			break;
495 	}
496 }
497 
498 /* check_and_mark_free_block: Verify that a block is free in the NFTL sense (valid erase mark) or
499  *	totally free (only 0xff).
500  *
501  * Definition: Free Erase Unit -- A properly erased/formatted Free Erase Unit should have meet the
502  *	following criteria:
503  *	1. */
504 static int check_and_mark_free_block(struct NFTLrecord *nftl, int block)
505 {
506 	struct mtd_info *mtd = nftl->mbd.mtd;
507 	struct nftl_uci1 h1;
508 	unsigned int erase_mark;
509 	size_t retlen;
510 
511 	/* check erase mark. */
512 	if (nftl_read_oob(mtd, block * nftl->EraseSize + SECTORSIZE + 8, 8,
513 			  &retlen, (char *)&h1) < 0)
514 		return -1;
515 
516 	erase_mark = le16_to_cpu ((h1.EraseMark | h1.EraseMark1));
517 	if (erase_mark != ERASE_MARK) {
518 		/* if no erase mark, the block must be totally free. This is
519 		   possible in two cases : empty filesystem or interrupted erase (very unlikely) */
520 		if (check_free_sectors (nftl, block * nftl->EraseSize, nftl->EraseSize, 1) != 0)
521 			return -1;
522 
523 		/* free block : write erase mark */
524 		h1.EraseMark = cpu_to_le16(ERASE_MARK);
525 		h1.EraseMark1 = cpu_to_le16(ERASE_MARK);
526 		h1.WearInfo = cpu_to_le32(0);
527 		if (nftl_write_oob(mtd,
528 				   block * nftl->EraseSize + SECTORSIZE + 8, 8,
529 				   &retlen, (char *)&h1) < 0)
530 			return -1;
531 	} else {
532 #if 0
533 		/* if erase mark present, need to skip it when doing check */
534 		for (i = 0; i < nftl->EraseSize; i += SECTORSIZE) {
535 			/* check free sector */
536 			if (check_free_sectors (nftl, block * nftl->EraseSize + i,
537 						SECTORSIZE, 0) != 0)
538 				return -1;
539 
540 			if (nftl_read_oob(mtd, block * nftl->EraseSize + i,
541 					  16, &retlen, buf) < 0)
542 				return -1;
543 			if (i == SECTORSIZE) {
544 				/* skip erase mark */
545 				if (memcmpb(buf, 0xff, 8))
546 					return -1;
547 			} else {
548 				if (memcmpb(buf, 0xff, 16))
549 					return -1;
550 			}
551 		}
552 #endif
553 	}
554 
555 	return 0;
556 }
557 
558 /* get_fold_mark: Read fold mark from Unit Control Information #2, we use FOLD_MARK_IN_PROGRESS
559  *	to indicate that we are in the progression of a Virtual Unit Chain folding. If the UCI #2
560  *	is FOLD_MARK_IN_PROGRESS when mounting the NFTL, the (previous) folding process is interrupted
561  *	for some reason. A clean up/check of the VUC is necessary in this case.
562  *
563  * WARNING: return 0 if read error
564  */
565 static int get_fold_mark(struct NFTLrecord *nftl, unsigned int block)
566 {
567 	struct mtd_info *mtd = nftl->mbd.mtd;
568 	struct nftl_uci2 uci;
569 	size_t retlen;
570 
571 	if (nftl_read_oob(mtd, block * nftl->EraseSize + 2 * SECTORSIZE + 8,
572 			  8, &retlen, (char *)&uci) < 0)
573 		return 0;
574 
575 	return le16_to_cpu((uci.FoldMark | uci.FoldMark1));
576 }
577 
578 int NFTL_mount(struct NFTLrecord *s)
579 {
580 	int i;
581 	unsigned int first_logical_block, logical_block, rep_block, erase_mark;
582 	unsigned int block, first_block, is_first_block;
583 	int chain_length, do_format_chain;
584 	struct nftl_uci0 h0;
585 	struct nftl_uci1 h1;
586 	struct mtd_info *mtd = s->mbd.mtd;
587 	size_t retlen;
588 
589 	/* search for NFTL MediaHeader and Spare NFTL Media Header */
590 	if (find_boot_record(s) < 0) {
591 		printk("Could not find valid boot record\n");
592 		return -1;
593 	}
594 
595 	/* init the logical to physical table */
596 	for (i = 0; i < s->nb_blocks; i++) {
597 		s->EUNtable[i] = BLOCK_NIL;
598 	}
599 
600 	/* first pass : explore each block chain */
601 	first_logical_block = 0;
602 	for (first_block = 0; first_block < s->nb_blocks; first_block++) {
603 		/* if the block was not already explored, we can look at it */
604 		if (s->ReplUnitTable[first_block] == BLOCK_NOTEXPLORED) {
605 			block = first_block;
606 			chain_length = 0;
607 			do_format_chain = 0;
608 
609 			for (;;) {
610 				/* read the block header. If error, we format the chain */
611 				if (nftl_read_oob(mtd,
612 						  block * s->EraseSize + 8, 8,
613 						  &retlen, (char *)&h0) < 0 ||
614 				    nftl_read_oob(mtd,
615 						  block * s->EraseSize +
616 						  SECTORSIZE + 8, 8,
617 						  &retlen, (char *)&h1) < 0) {
618 					s->ReplUnitTable[block] = BLOCK_NIL;
619 					do_format_chain = 1;
620 					break;
621 				}
622 
623 				logical_block = le16_to_cpu ((h0.VirtUnitNum | h0.SpareVirtUnitNum));
624 				rep_block = le16_to_cpu ((h0.ReplUnitNum | h0.SpareReplUnitNum));
625 				erase_mark = le16_to_cpu ((h1.EraseMark | h1.EraseMark1));
626 
627 				is_first_block = !(logical_block >> 15);
628 				logical_block = logical_block & 0x7fff;
629 
630 				/* invalid/free block test */
631 				if (erase_mark != ERASE_MARK || logical_block >= s->nb_blocks) {
632 					if (chain_length == 0) {
633 						/* if not currently in a chain, we can handle it safely */
634 						if (check_and_mark_free_block(s, block) < 0) {
635 							/* not really free: format it */
636 							printk("Formatting block %d\n", block);
637 							if (NFTL_formatblock(s, block) < 0) {
638 								/* could not format: reserve the block */
639 								s->ReplUnitTable[block] = BLOCK_RESERVED;
640 							} else {
641 								s->ReplUnitTable[block] = BLOCK_FREE;
642 							}
643 						} else {
644 							/* free block: mark it */
645 							s->ReplUnitTable[block] = BLOCK_FREE;
646 						}
647 						/* directly examine the next block. */
648 						goto examine_ReplUnitTable;
649 					} else {
650 						/* the block was in a chain : this is bad. We
651 						   must format all the chain */
652 						printk("Block %d: free but referenced in chain %d\n",
653 						       block, first_block);
654 						s->ReplUnitTable[block] = BLOCK_NIL;
655 						do_format_chain = 1;
656 						break;
657 					}
658 				}
659 
660 				/* we accept only first blocks here */
661 				if (chain_length == 0) {
662 					/* this block is not the first block in chain :
663 					   ignore it, it will be included in a chain
664 					   later, or marked as not explored */
665 					if (!is_first_block)
666 						goto examine_ReplUnitTable;
667 					first_logical_block = logical_block;
668 				} else {
669 					if (logical_block != first_logical_block) {
670 						printk("Block %d: incorrect logical block: %d expected: %d\n",
671 						       block, logical_block, first_logical_block);
672 						/* the chain is incorrect : we must format it,
673 						   but we need to read it completely */
674 						do_format_chain = 1;
675 					}
676 					if (is_first_block) {
677 						/* we accept that a block is marked as first
678 						   block while being last block in a chain
679 						   only if the chain is being folded */
680 						if (get_fold_mark(s, block) != FOLD_MARK_IN_PROGRESS ||
681 						    rep_block != 0xffff) {
682 							printk("Block %d: incorrectly marked as first block in chain\n",
683 							       block);
684 							/* the chain is incorrect : we must format it,
685 							   but we need to read it completely */
686 							do_format_chain = 1;
687 						} else {
688 							printk("Block %d: folding in progress - ignoring first block flag\n",
689 							       block);
690 						}
691 					}
692 				}
693 				chain_length++;
694 				if (rep_block == 0xffff) {
695 					/* no more blocks after */
696 					s->ReplUnitTable[block] = BLOCK_NIL;
697 					break;
698 				} else if (rep_block >= s->nb_blocks) {
699 					printk("Block %d: referencing invalid block %d\n",
700 					       block, rep_block);
701 					do_format_chain = 1;
702 					s->ReplUnitTable[block] = BLOCK_NIL;
703 					break;
704 				} else if (s->ReplUnitTable[rep_block] != BLOCK_NOTEXPLORED) {
705 					/* same problem as previous 'is_first_block' test:
706 					   we accept that the last block of a chain has
707 					   the first_block flag set if folding is in
708 					   progress. We handle here the case where the
709 					   last block appeared first */
710 					if (s->ReplUnitTable[rep_block] == BLOCK_NIL &&
711 					    s->EUNtable[first_logical_block] == rep_block &&
712 					    get_fold_mark(s, first_block) == FOLD_MARK_IN_PROGRESS) {
713 						/* EUNtable[] will be set after */
714 						printk("Block %d: folding in progress - ignoring first block flag\n",
715 						       rep_block);
716 						s->ReplUnitTable[block] = rep_block;
717 						s->EUNtable[first_logical_block] = BLOCK_NIL;
718 					} else {
719 						printk("Block %d: referencing block %d already in another chain\n",
720 						       block, rep_block);
721 						/* XXX: should handle correctly fold in progress chains */
722 						do_format_chain = 1;
723 						s->ReplUnitTable[block] = BLOCK_NIL;
724 					}
725 					break;
726 				} else {
727 					/* this is OK */
728 					s->ReplUnitTable[block] = rep_block;
729 					block = rep_block;
730 				}
731 			}
732 
733 			/* the chain was completely explored. Now we can decide
734 			   what to do with it */
735 			if (do_format_chain) {
736 				/* invalid chain : format it */
737 				format_chain(s, first_block);
738 			} else {
739 				unsigned int first_block1, chain_to_format, chain_length1;
740 				int fold_mark;
741 
742 				/* valid chain : get foldmark */
743 				fold_mark = get_fold_mark(s, first_block);
744 				if (fold_mark == 0) {
745 					/* cannot get foldmark : format the chain */
746 					printk("Could read foldmark at block %d\n", first_block);
747 					format_chain(s, first_block);
748 				} else {
749 					if (fold_mark == FOLD_MARK_IN_PROGRESS)
750 						check_sectors_in_chain(s, first_block);
751 
752 					/* now handle the case where we find two chains at the
753 					   same virtual address : we select the longer one,
754 					   because the shorter one is the one which was being
755 					   folded if the folding was not done in place */
756 					first_block1 = s->EUNtable[first_logical_block];
757 					if (first_block1 != BLOCK_NIL) {
758 						/* XXX: what to do if same length ? */
759 						chain_length1 = calc_chain_length(s, first_block1);
760 						printk("Two chains at blocks %d (len=%d) and %d (len=%d)\n",
761 						       first_block1, chain_length1, first_block, chain_length);
762 
763 						if (chain_length >= chain_length1) {
764 							chain_to_format = first_block1;
765 							s->EUNtable[first_logical_block] = first_block;
766 						} else {
767 							chain_to_format = first_block;
768 						}
769 						format_chain(s, chain_to_format);
770 					} else {
771 						s->EUNtable[first_logical_block] = first_block;
772 					}
773 				}
774 			}
775 		}
776 	examine_ReplUnitTable:;
777 	}
778 
779 	/* second pass to format unreferenced blocks  and init free block count */
780 	s->numfreeEUNs = 0;
781 	s->LastFreeEUN = le16_to_cpu(s->MediaHdr.FirstPhysicalEUN);
782 
783 	for (block = 0; block < s->nb_blocks; block++) {
784 		if (s->ReplUnitTable[block] == BLOCK_NOTEXPLORED) {
785 			printk("Unreferenced block %d, formatting it\n", block);
786 			if (NFTL_formatblock(s, block) < 0)
787 				s->ReplUnitTable[block] = BLOCK_RESERVED;
788 			else
789 				s->ReplUnitTable[block] = BLOCK_FREE;
790 		}
791 		if (s->ReplUnitTable[block] == BLOCK_FREE) {
792 			s->numfreeEUNs++;
793 			s->LastFreeEUN = block;
794 		}
795 	}
796 
797 	return 0;
798 }
799