miscutils/nandwrite.c

   1 /*
   2  * nandwrite and nanddump ported to busybox from mtd-utils
   3  *
   4  * Author: Baruch Siach <baruch@tkos.co.il>, Orex Computed Radiography
   5  *
   6  * Licensed under GPLv2, see file LICENSE in this source tree.
   7  *
   8  * TODO: add support for large (>4GB) MTD devices
   9  */
  10 //config:config NANDWRITE
  11 //config:       bool "nandwrite (5.9 kb)"
  12 //config:       default y
  13 //config:       select PLATFORM_LINUX
  14 //config:       help
  15 //config:       Write to the specified MTD device, with bad blocks awareness
  16 //config:
  17 //config:config NANDDUMP
  18 //config:       bool "nanddump (6.3 kb)"
  19 //config:       default y
  20 //config:       select PLATFORM_LINUX
  21 //config:       help
  22 //config:       Dump the content of raw NAND chip
  23
  24 //applet:IF_NANDWRITE(APPLET(nandwrite, BB_DIR_USR_SBIN, BB_SUID_DROP))
  25 //applet:IF_NANDDUMP(APPLET_ODDNAME(nanddump, nandwrite, BB_DIR_USR_SBIN, BB_SUID_DROP, nanddump))
  26
  27 //kbuild:lib-$(CONFIG_NANDWRITE) += nandwrite.o
  28 //kbuild:lib-$(CONFIG_NANDDUMP) += nandwrite.o
  29
  30 //usage:#define nandwrite_trivial_usage
  31 //usage:        "[-np] [-s ADDR] MTD_DEVICE [FILE]"
  32 //usage:#define nandwrite_full_usage "\n\n"
  33 //usage:        "Write to MTD_DEVICE\n"
  34 //usage:     "\n        -n      Write without ecc"
  35 //usage:     "\n        -p      Pad to page size"
  36 //usage:     "\n        -s ADDR Start address"
  37
  38 //usage:#define nanddump_trivial_usage
  39 //usage:        "[-no]" IF_LONG_OPTS(" [--bb padbad|skipbad]") " [-s ADDR] [-l LEN] [-f FILE] MTD_DEVICE"
  40 //usage:#define nanddump_full_usage "\n\n"
  41 //usage:        "Dump MTD_DEVICE\n"
  42 //usage:     "\n        -n      Read without ecc"
  43 //usage:     "\n        -o      Dump oob data"
  44 //usage:     "\n        -s ADDR Start address"
  45 //usage:     "\n        -l LEN  Length"
  46 //usage:     "\n        -f FILE Dump to file ('-' for stdout)"
  47 //usage:     IF_LONG_OPTS(
  48 //usage:     "\n        --bb METHOD"
  49 //usage:     "\n                skipbad: skip bad blocks"
  50 //usage:     "\n                padbad: substitute bad blocks by 0xff (default)"
  51 //usage:     )
  52
  53 #include "libbb.h"
  54 #include <mtd/mtd-user.h>
  55
  56 #define IS_NANDDUMP  (ENABLE_NANDDUMP && (!ENABLE_NANDWRITE || (applet_name[4] == 'd')))
  57 #define IS_NANDWRITE (ENABLE_NANDWRITE && (!ENABLE_NANDDUMP || (applet_name[4] != 'd')))
  58
  59 #define OPT_p  (1 << 0) /* nandwrite only */
  60 #define OPT_o  (1 << 0) /* nanddump only */
  61 #define OPT_n  (1 << 1)
  62 #define OPT_s  (1 << 2)
  63 #define OPT_f  (1 << 3)
  64 #define OPT_l  (1 << 4)
  65 #define OPT_bb (1 << 5) /* must be the last one in the list */
  66
  67 #define BB_PADBAD (1 << 0)
  68 #define BB_SKIPBAD (1 << 1)
  69
  70 /* helper for writing out 0xff for bad blocks pad */
  71 static void dump_bad(struct mtd_info_user *meminfo, unsigned len, int oob)
  72 {
  73         unsigned char buf[meminfo->writesize];
  74         unsigned count;
  75
  76         /* round len to the next page only if len is not already on a page */
  77         len = ((len - 1) | (meminfo->writesize - 1)) + 1;
  78
  79         memset(buf, 0xff, sizeof(buf));
  80         for (count = 0; count < len; count += meminfo->writesize) {
  81                 xwrite(STDOUT_FILENO, buf, meminfo->writesize);
  82                 if (oob)
  83                         xwrite(STDOUT_FILENO, buf, meminfo->oobsize);
  84         }
  85 }
  86
  87 static unsigned next_good_eraseblock(int fd, struct mtd_info_user *meminfo,
  88                 unsigned block_offset)
  89 {
  90         while (1) {
  91                 loff_t offs;
  92
  93                 if (block_offset >= meminfo->size) {
  94                         if (IS_NANDWRITE)
  95                                 bb_error_msg_and_die("not enough space in MTD device");
  96                         return block_offset; /* let the caller exit */
  97                 }
  98                 offs = block_offset;
  99                 if (xioctl(fd, MEMGETBADBLOCK, &offs) == 0)
 100                         return block_offset;
 101                 /* ioctl returned 1 => "bad block" */
 102                 if (IS_NANDWRITE)
 103                         printf("Skipping bad block at 0x%08x\n", block_offset);
 104                 block_offset += meminfo->erasesize;
 105         }
 106 }
 107
 108 int nandwrite_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 109 int nandwrite_main(int argc UNUSED_PARAM, char **argv)
 110 {
 111         /* Buffer for OOB data */
 112         unsigned char *oobbuf;
 113         unsigned opts;
 114         unsigned bb_method = BB_SKIPBAD;
 115         int fd;
 116         ssize_t cnt;
 117         unsigned mtdoffset, meminfo_writesize, blockstart, limit;
 118         unsigned end_addr = ~0;
 119         struct mtd_info_user meminfo;
 120         struct mtd_oob_buf oob;
 121         unsigned char *filebuf;
 122         const char *opt_s = "0", *opt_f = "-", *opt_l, *opt_bb;
 123
 124         if (IS_NANDDUMP) {
 125                 opts = getopt32long(argv, "^" "ons:f:l:" "\0" "=1",
 126                                 "bb\0" Required_argument "\xff", /* no short equivalent */
 127                                 &opt_s, &opt_f, &opt_l, &opt_bb
 128                 );
 129         } else { /* nandwrite */
 130                 opts = getopt32(argv, "^" "pns:" "\0" "-1:?2", &opt_s);
 131         }
 132         argv += optind;
 133
 134         if (IS_NANDWRITE && argv[1])
 135                 opt_f = argv[1];
 136         if (!LONE_DASH(opt_f)) {
 137                 int tmp_fd = xopen(opt_f,
 138                         IS_NANDDUMP ? O_WRONLY | O_TRUNC | O_CREAT : O_RDONLY
 139                 );
 140                 xmove_fd(tmp_fd, IS_NANDDUMP ? STDOUT_FILENO : STDIN_FILENO);
 141         }
 142
 143         fd = xopen(argv[0], IS_NANDWRITE ? O_RDWR : O_RDONLY);
 144         xioctl(fd, MEMGETINFO, &meminfo);
 145
 146         if (opts & OPT_n)
 147                 xioctl(fd, MTDFILEMODE, (void *)MTD_FILE_MODE_RAW);
 148
 149         mtdoffset = xstrtou(opt_s, 0);
 150         if (IS_NANDDUMP && (opts & OPT_l)) {
 151                 unsigned length = xstrtou(opt_l, 0);
 152                 if (length < meminfo.size - mtdoffset)
 153                         end_addr = mtdoffset + length;
 154         }
 155         if (IS_NANDDUMP && (opts & OPT_bb)) {
 156                 if (strcmp("skipbad", opt_bb) == 0)
 157                         bb_method = BB_SKIPBAD;
 158                 else if (strcmp("padbad", opt_bb) == 0)
 159                         bb_method = BB_PADBAD;
 160                 else
 161                         bb_show_usage();
 162         }
 163
 164         /* Pull it into a CPU register (hopefully) - smaller code that way */
 165         meminfo_writesize = meminfo.writesize;
 166
 167         if (mtdoffset & (meminfo_writesize - 1))
 168                 bb_error_msg_and_die("start address is not page aligned");
 169
 170         filebuf = xmalloc(meminfo_writesize);
 171         oobbuf = xmalloc(meminfo.oobsize);
 172
 173         oob.start  = 0;
 174         oob.length = meminfo.oobsize;
 175         oob.ptr    = oobbuf;
 176
 177         blockstart = mtdoffset & ~(meminfo.erasesize - 1);
 178         if (blockstart != mtdoffset) {
 179                 unsigned tmp;
 180                 /* mtdoffset is in the middle of an erase block, verify that
 181                  * this block is OK. Advance mtdoffset only if this block is
 182                  * bad.
 183                  */
 184                 tmp = next_good_eraseblock(fd, &meminfo, blockstart);
 185                 if (tmp != blockstart) {
 186                         /* bad block(s), advance mtdoffset */
 187                         if (IS_NANDDUMP) {
 188                                 if (bb_method == BB_PADBAD) {
 189                                         int bad_len = MIN(tmp, end_addr) - mtdoffset;
 190                                         dump_bad(&meminfo, bad_len, opts & OPT_o);
 191                                 }
 192                                 /* with option skipbad, increase the total length */
 193                                 if (bb_method == BB_SKIPBAD) {
 194                                         end_addr += (tmp - blockstart);
 195                                 }
 196                         }
 197                         mtdoffset = tmp;
 198                 }
 199         }
 200
 201         cnt = -1;
 202         limit = MIN(meminfo.size, end_addr);
 203         while (mtdoffset < limit) {
 204                 int input_fd = IS_NANDWRITE ? STDIN_FILENO : fd;
 205                 int output_fd = IS_NANDWRITE ? fd : STDOUT_FILENO;
 206
 207                 blockstart = mtdoffset & ~(meminfo.erasesize - 1);
 208                 if (blockstart == mtdoffset) {
 209                         /* starting a new eraseblock */
 210                         mtdoffset = next_good_eraseblock(fd, &meminfo, blockstart);
 211                         if (IS_NANDWRITE)
 212                                 printf("Writing at 0x%08x\n", mtdoffset);
 213                         else if (mtdoffset > blockstart) {
 214                                 if (bb_method == BB_PADBAD) {
 215                                         /* dump FF padded bad block */
 216                                         int bad_len = MIN(mtdoffset, limit) - blockstart;
 217                                         dump_bad(&meminfo, bad_len, opts & OPT_o);
 218                                 } else if (bb_method == BB_SKIPBAD) {
 219                                         /* for skipbad, increase the length */
 220                                         if ((end_addr + mtdoffset - blockstart) > end_addr)
 221                                                 end_addr += (mtdoffset - blockstart);
 222                                         else
 223                                                 end_addr = ~0;
 224                                         limit = MIN(meminfo.size, end_addr);
 225                                 }
 226                         }
 227                         if (mtdoffset >= limit)
 228                                 break;
 229                 }
 230                 xlseek(fd, mtdoffset, SEEK_SET);
 231
 232                 /* get some more data from input */
 233                 cnt = full_read(input_fd, filebuf, meminfo_writesize);
 234                 if (cnt == 0) {
 235                         /* even with -p, we do not pad past the end of input
 236                          * (-p only zero-pads last incomplete page)
 237                          */
 238                         break;
 239                 }
 240                 if (cnt < meminfo_writesize) {
 241                         if (IS_NANDDUMP)
 242                                 bb_error_msg_and_die("short read");
 243                         if (!(opts & OPT_p))
 244                                 bb_error_msg_and_die("input size is not rounded up to page size, "
 245                                                 "use -p to zero pad");
 246                         /* zero pad to end of write block */
 247                         memset(filebuf + cnt, 0, meminfo_writesize - cnt);
 248                 }
 249                 xwrite(output_fd, filebuf, meminfo_writesize);
 250
 251                 if (IS_NANDDUMP && (opts & OPT_o)) {
 252                         /* Dump OOB data */
 253                         oob.start = mtdoffset;
 254                         xioctl(fd, MEMREADOOB, &oob);
 255                         xwrite(output_fd, oobbuf, meminfo.oobsize);
 256                 }
 257
 258                 mtdoffset += meminfo_writesize;
 259                 if (cnt < meminfo_writesize)
 260                         break;
 261         }
 262
 263         if (IS_NANDWRITE && cnt != 0) {
 264                 /* We filled entire MTD, but did we reach EOF on input? */
 265                 if (full_read(STDIN_FILENO, filebuf, meminfo_writesize) != 0) {
 266                         /* no */
 267                         bb_error_msg_and_die("not enough space in MTD device");
 268                 }
 269         }
 270
 271         if (ENABLE_FEATURE_CLEAN_UP) {
 272                 free(filebuf);
 273                 close(fd);
 274         }
 275
 276         return EXIT_SUCCESS;
 277 }