linux/drivers/mtd/nftlmount.c
<<
>>
Prefs
   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 */
  38static 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
 160The new DiskOnChip driver scans the MediaHeader itself, and presents a virtual
 161erasesize based on UnitSizeFactor.  So the erasesize we read from the mtd
 162device 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
 232The 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
 264static 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 */
 275static 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
 306out:
 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 */
 318int 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;
 369fail:
 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. */
 385static 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 */
 439static 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 */
 471static 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. */
 504static 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 */
 565static 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
 578int 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