ubi命令用法（linux）

- 日理万妓 2023-01-04 13:22 1642阅读 0赞

原文网址：[ubi命令用法（linux）\_IT利刃出鞘的博客-CSDN博客\_ubi命令][ubi_linux_IT_-CSDN_ubi]

# 简介 #

内核启动后，会自动创建/dev/ubi\_ctrl、/sys/class/misc/ubi\_ctrl、/sys/class/ubi/version。

本部分命令所在软件包：ubi-utils

# ubinfo #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 提供从系统中找到的UBI设备、UBI卷的相关信息 </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -d, --devn=&lt;UBI device number&gt; </td> 
 <td> UBI device number to get information about &nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -n, --vol_id=&lt;volume ID&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> ID of UBI volume to print information about &nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -N, --name=&lt;volume name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> name of UBI volume to print information about &nbsp; </td> 
 </tr> 
 <tr> 
 <td> -a, --all &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print information about all devices and volumes,or about all volumes if the UBI device was &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; specified &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -h, --help &nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print help message &nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -V, --version &nbsp; </td> 
 <td> print program version </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> ubinfo&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; - (no arguments) print general UBI information ubinfo -d 1&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; - print information about UBI device number 1 ubinfo /dev/ubi0 -a &nbsp;&nbsp;&nbsp;- print information about all volumes of UBI device /dev/ubi0 ubinfo /dev/ubi1_0 &nbsp;&nbsp;&nbsp;- print information about UBI volume /dev/ubi1_0 ubinfo -a&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;-&nbsp;print all information </td> 
 </tr> 
 </tbody> 
</table>

# ubiformat #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 格式化MTD设备，擦除Flash，保存擦除计数，写入UBI镜像到Flash; flash_erase命令有类似的效果。 详细操作： 1.从/sys/class/mtd/mtdN下的节点中读数据 2.&nbsp;确保节点没有attach 3. 扫描所有块： &nbsp; &nbsp; 检查坏块、读出EC header、检查是否为ubi块、记录擦除次数 4.擦除对应分区的所有块，并且写入所有块的EC&nbsp;header 5.写布局卷（layout volume） &nbsp; &nbsp;&nbsp;创建空的volume table（除了mtd的crc外，其他全是0） &nbsp; &nbsp; 设置第0块和第1块的EC header和VID header写到其对应位置（EC header在第0页， VID header在第1页） &nbsp; &nbsp; 把创建的空的vtbl（volume table）写到第0块和第1块的data_offset处。（data_offset 是EC header的成员） EC header是在一个擦除块的开头，而VID header的位置有几个情况：&nbsp; 若是nor flash有1字节操作单元，通常VID header的位置在偏移64字节处 若nand不支持sub-pages，那么VID header在下一个nand page处 若nand支持sub-pages，那么VID header就在下一个sub-pages处 我们这里是使用4KB的pagesize，所以在0x1000的偏移处。 </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> ubiformat &lt;MTD device node file name&gt; [-s &lt;bytes&gt;] [-O &lt;offs&gt;] [-n] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Q &lt;num&gt;] [-f &lt;file&gt;] [-S &lt;bytes&gt;] [-e &lt;value&gt;] [-x &lt;num&gt;] [-y] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;[-q] [-v]&nbsp;[-h] [--sub-page-size=&lt;bytes&gt;]&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;[--vid-hdr-offset=&lt;offs&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;[--no-volume-table][--flash-image=&lt;file&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;[--image-size=&lt;bytes&gt;]&nbsp;[--erase-counter=&lt;value&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[--image-seq=&lt;num&gt;] [--ubi-ver=&lt;num&gt;] [--yes] [--quiet] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; [--verbose] [--help] [--version] </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -s, --sub-page-size=&lt;bytes&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> minimum input/output unit used for UBI&nbsp;headers, e.g. sub-page size in case of NAND&nbsp;flash (equivalent to the minimum input/output unit size by default) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -O, --vid-hdr-offset=&lt;offs&gt; </td> 
 <td> offset if the VID header from start of the physical eraseblock (default is the next minimum I/O unit or sub-page after the EC&nbsp;header)&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -n, --no-volume-table &nbsp;&nbsp;&nbsp; </td> 
 <td> only erase all eraseblock and preserve erase&nbsp;counters, do not write empty volume table </td> 
 </tr> 
 <tr> 
 <td> -f, --flash-image=&lt;file&gt; &nbsp;&nbsp;&nbsp; </td> 
 <td> flash image file, or '-' for stdin &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -S, --image-size=&lt;bytes&gt;&nbsp;&nbsp; </td> 
 <td> bytes in input, if not reading from file &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -e, --erase-counter=&lt;value&gt;&nbsp; </td> 
 <td> use &lt;value&gt; as the erase counter value for all&nbsp;eraseblocks &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -x, --ubi-ver=&lt;num&gt;&nbsp;&nbsp; </td> 
 <td> UBI version number to put to EC headers (default is 1) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -Q, --image-seq=&lt;num&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> 32-bit UBI image sequence number to use &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (by default a random number is picked) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -y, --yes &nbsp;&nbsp;&nbsp; </td> 
 <td> assume the answer is "yes" for all question this program would otherwise ask &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -q, --quiet &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> suppress progress percentage information &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -v, --verbose &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> be verbose &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -h, -?, --help </td> 
 <td> print help message &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -V, --version </td> 
 <td> print program version &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> ubiformat /dev/mtd0 -y&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; - format MTD device number 0 and do&nbsp;not ask questions. ubiformat /dev/mtd0 -q -e 0 &nbsp;&nbsp;- format MTD device number 0, be quiet and force erase counter value 0. ubiformat /dev/mtd8 -s 2048 -O 2048 ubiformat: mtd8 (nand), size 41943040 bytes (40.0 MiB), 320 eraseblocks of 131072 bytes (128.0 KiB), min. I/O size 2048 bytes libscan: scanning eraseblock 319 -- 100 % complete ubiformat: 320 eraseblocks have valid erase counter, mean value is 17 ubiformat: formatting eraseblock 319 -- 100 % complete &nbsp; nanddump -p -c -s 0 -l 4096 /dev/mtd8 ECC failed: 0 ECC corrected: 0 Number of bad blocks: 0 Number of bbt blocks: 0 Block size 131072, page size 2048, OOB size 128 Dumping data starting at 0x00000000 and ending at 0x00002000... 0x00000000: 55 42 49 23 01 00 00 00 00 00 00 00 00 00 00 06&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; |UBI#............| 0x00000010: 00 00 10 00 00 00 20 00 45 b7 30 77 00 00 00 00&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; |...... .E.0w....| 0x00000020: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; |................| 0x00000030: 00 00 00 00 00 00 00 00 00 00 00 00 6d 77 90 bc&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; |............mw..| 0x00000040: ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; &nbsp;|................| 0x00000050: ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; &nbsp;|................| ................... &nbsp; &nbsp; &nbsp; &nbsp;all 0xff &nbsp; &nbsp; &nbsp; &nbsp;....................&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;|................| 0x000007f0: ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff&nbsp; &nbsp; &nbsp; |................| 0x00000800: 55 42 49 21 01 01 00 05 7f ff &nbsp; ef ff &nbsp; 00 00 00 00&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;|UBI!............| 0x00000810: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; |................| 0x00000820: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; |................| 0x00000830: 00 00 00 00 00 00 00 00 00 00 00 00 b8 25 64 a8&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; |.............%d.| 0x00000840: ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; &nbsp;|................| ................... &nbsp; &nbsp; &nbsp; &nbsp;all 0xff &nbsp; &nbsp; &nbsp; &nbsp;....................&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;|................| 0x00000fe0: ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; &nbsp;|................| 0x00000ff0:&nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; ff &nbsp; &nbsp;|................| &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

# ubiattach #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 链接MTD设备（MTD设备描述原始Flash设备）到UBI并且创建相应的UBI设备。 attach通过ioctl系统调用，执行内核的UBI_IOCATT操作，内核中执行attach的主要函数是ubi_attach_mtd_dev。 详细操作： 1.获取mtd设备信息 2.读取每个块的header信息，包括EC header和VID header，检查一些参数 3.ubi_wl_init 4.ubi_eba_init 5.&nbsp;创建一个ubi设备（struct ubi_device），设备节点为/dev/ubiN 6.创建磨损均衡线程 会创建/dev/ubiN节点 以及 /sys/class/ubi/ubiN目录 /sys/class/ubi/ubiN/下有以下文件，可以直接cat avail_eraseblocks &nbsp;eraseblock_size &nbsp; &nbsp;mtd_num &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;subsystem bad_peb_count &nbsp; &nbsp; &nbsp;max_ec &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; power &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;total_eraseblocks bgt_enabled &nbsp; &nbsp; &nbsp; &nbsp;max_vol_count &nbsp; &nbsp; &nbsp;reserved_for_bad &nbsp; uevent dev &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;min_io_size &nbsp; &nbsp; &nbsp; &nbsp;ro_mode &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;volumes_count </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> ubiattach [&lt;UBI control device node file name&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-m &lt;MTD device number&gt;] &nbsp; &nbsp; &nbsp; &nbsp; [-d &lt;UBI device number&gt;] &nbsp; &nbsp; &nbsp; &nbsp; [-p &lt;path to device&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[--mtdn=&lt;MTD device number&gt;] &nbsp; &nbsp; &nbsp; &nbsp; [--devn=&lt;UBI device number&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[--dev-path=&lt;path to device&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[--max-beb-per1024=&lt;maximum bad block number per 1024 blocks&gt;] UBI control device defaults to /dev/ubi_ctrl if not supplied. </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -d, --devn=&lt;number&gt; &nbsp;&nbsp; </td> 
 <td> the number to assign to the newly created UBI device (assigned automatically if this is not specified) &nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -p, --dev-path=&lt;path&gt; </td> 
 <td> path to MTD device node to attach </td> 
 </tr> 
 <tr> 
 <td> -m, --mtdn=&lt;number&gt; 此选项是必须的&nbsp;&nbsp;&nbsp; </td> 
 <td> MTD device number to attach (alternative method, e.g &nbsp;if the character device node does not exist) 。 &nbsp;&nbsp;&nbsp; 注意：是从0开始的。&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -O, --vid-hdr-offset &nbsp; </td> 
 <td> VID header offset (do not specify this unless you really know what you are doing, the default should be optimal) &nbsp; </td> 
 </tr> 
 <tr> 
 <td> -b, --max-beb-per1024 </td> 
 <td> maximum expected bad block number per 1024 eraseblock. &nbsp;&nbsp; The default value is correct for most NAND devices. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Allowed range is 0-768, 0 means the default kernel value. </td> 
 </tr> 
 <tr> 
 <td> -h, --help &nbsp;&nbsp;&nbsp; </td> 
 <td> print help message &nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -V, --version </td> 
 <td> print program version </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> ubiattach -p /dev/mtd0 - attach /dev/mtd0 to UBI&nbsp; &nbsp; &nbsp; //等价于&nbsp;&nbsp;ubiattach -m 0 ubiattach -m 0&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; - attach MTD device 0 (mtd0) to UBI ubiattach -m 0 -d 3&nbsp; &nbsp; &nbsp; - attach MTD device 0 (mtd0) to UBI and create UBI device number 3 (ubi3) ubiattach -m 1 -b 25&nbsp; &nbsp; &nbsp;- attach /dev/mtd1 to UBI and reserve &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;25*C/1024 eraseblocks for bad block handling, where C is the flash &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;is total flash chip eraseblocks count, that is flash chip size in &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; eraseblocks (including bad eraseblocks). E.g., if the flash chip &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;has 4096 PEBs, 100 will be reserved. 实例： ubiattach -m 8 -d 1 执行结果： [ &nbsp;366.634630] ubi1: attaching mtd8 [ &nbsp;369.956645] ubi1: scanning is finished [ &nbsp;370.071529] ubi1: attached mtd8 (name "app0", size 40 MiB) [ &nbsp;370.080197] ubi1: PEB size: 131072 bytes (128 KiB), LEB size: 126976 bytes [ &nbsp;370.090677] ubi1: min./max. I/O unit sizes: 2048/2048, sub-page size 2048 [ &nbsp;370.100384] ubi1: VID header offset: 2048 (aligned 2048), data offset: 4096 [ &nbsp;370.110694] ubi1: good PEBs: 320, bad PEBs: 0, corrupted PEBs: 0 [ &nbsp;370.119283] ubi1: user volume: 0, internal volumes: 1, max. volumes count: 128 [ &nbsp;370.129493] ubi1: max/mean erase counter: 15/13, WL threshold: 4096, image sequence number: 668018020 [ &nbsp;370.142359] ubi1: available PEBs: 296, total reserved PEBs: 24, PEBs reserved for bad PEB handling: 20 [ &nbsp;370.155725] ubi1: background thread "ubi_bgt1d" started, PID 279 UBI device number 1, total 320 LEBs (40632320 bytes, 38.8 MiB), available 296 LEBs (37584896 bytes, 35.8 MiB), LEB size 126976 bytes (124.0 KiB) flash physical eraseblock size：从flash芯片手册中可以得到FLASH物理擦除块大小，或cat /proc/mtd sub-page size：&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;通过flash手册获得 logical eraseblock size：&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 对于没有子页的NAND FLASH来说：等于peb（物理擦除块大小） &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;对于有子页的NAND FLASH来说，等于“物理擦除块大小-1页的大小” </td> 
 </tr> 
 </tbody> 
</table>

# ubidetach #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> ubiattach相反的操作，将MTD设备从UBI设备上去链接。 注意，在使用此命令之前，先要umount掉。 </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> ubidetach [&lt;UBI control device node file name&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-d &lt;UBI device number&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-m &lt;MTD device number&gt;] &nbsp; &nbsp; &nbsp; &nbsp; [-p &lt;path to device&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[--devn=&lt;UBI device number&gt;] &nbsp; &nbsp; &nbsp; &nbsp; [--mtdn=&lt;MTD device number&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[--dev-path=&lt;path to device&gt;] UBI control device defaults to /dev/ubi_ctrl if not supplied. </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -d, --devn=&lt;number&gt; &nbsp;&nbsp; </td> 
 <td> the number to assign to the newly created UBI device (assigned automatically if this is not specified) &nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -p, --dev-path=&lt;path&gt; </td> 
 <td> path to MTD device node to attach </td> 
 </tr> 
 <tr> 
 <td> -m, --mtdn=&lt;number&gt; &nbsp;&nbsp; </td> 
 <td> MTD device number to attach (alternative method, e.g &nbsp; if the character device node does not exist) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 注意：是从0开始的。&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -O, --vid-hdr-offset &nbsp; </td> 
 <td> VID header offset (do not specify this unless you really know what you are doing, the default should be optimal) &nbsp; </td> 
 </tr> 
 <tr> 
 <td> -b, --max-beb-per1024 </td> 
 <td> maximum expected bad block number per 1024 eraseblock. &nbsp;&nbsp; The default value is correct for most NAND devices. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Allowed range is 0-768, 0 means the default kernel value. </td> 
 </tr> 
 <tr> 
 <td> -h, --help &nbsp;&nbsp;&nbsp; </td> 
 <td> print help message &nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -V, --version </td> 
 <td> print program version </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> ubidetach -p /dev/mtd0 - detach MTD device /dev/mtd0 ubidetach -d 2&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; - delete UBI device 2 (ubi2) ubidetach -m 0&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;- detach MTD device 0 (mtd0) </td> 
 </tr> 
 </tbody> 
</table>

# ubimkvol #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 从UBI设备上创建UBI卷。 详细操作： 1.检查各种参数名称等等 2.注册字符设备 3.修改volume table记录 &nbsp; &nbsp; &nbsp; &nbsp; 其实ubiattach要分两种情况：mtd设备已经有制作卷了，或者是没有制作卷。判断依据就是VIDheader里面的卷ID。 &nbsp; &nbsp; &nbsp; &nbsp; 如果是没有制作的，需要进行卷制作，也就是ubimkvlo。一个ubi设备可以有很多个volume，最多几个呢？要看volume table能有几个records。一个blocksize的大小能容纳多少volume table record就有多少个卷。&nbsp; </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> ubimkvol &lt;UBI device node file name&gt; &nbsp; &nbsp; &nbsp; &nbsp; [-h] [-a &lt;alignment&gt;] [-n &lt;volume ID&gt;] [-N &lt;name&gt;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-s &lt;bytes&gt;] [-S &lt;LEBs&gt;] [-t &lt;static|dynamic&gt;] [-V] [-m] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[--alignment=&lt;alignment&gt;][--vol_id=&lt;volume&nbsp;ID&gt;] &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;[--name=&lt;name&gt;]&nbsp;[--size=&lt;bytes&gt;] [--lebs=&lt;LEBs&gt;] &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;[--type=&lt;static|dynamic&gt;] [--help] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[--version] [--maxavsize] </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -a, --alignment=&lt;alignment&gt; &nbsp; </td> 
 <td> volume alignment (default is 1) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -n, --vol_id=&lt;volume ID&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> UBI volume ID, if not specified, the volume ID &nbsp;&nbsp;&nbsp;&nbsp; will be assigned automatically &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -N, --name=&lt;name&gt;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </td> 
 <td> volume name &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -s, --size=&lt;bytes&gt;&nbsp;&nbsp; </td> 
 <td> volume size volume size in bytes, kilobytes (KiB) or megabytes (MiB)&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -S, --lebs=&lt;LEBs count&gt;&nbsp; </td> 
 <td> alternative way to give volume size in logical &nbsp;eraseblocks&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -m, --maxavsize &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> set volume size to maximum available size &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -t, --type=&lt;static|dynamic&gt; &nbsp; </td> 
 <td> volume type (dynamic, static), default is dynamic &nbsp; </td> 
 </tr> 
 <tr> 
 <td> -h, -?, --help &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print help message &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -V, --version &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print program version &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> ubimkvol /dev/ubi0 -s 20MiB -N config_data&nbsp; &nbsp; &nbsp; - create a 20 Megabytes volume&nbsp;named "config_data" on UBI device /dev/ubi0. ubimkvol /dev/ubi1 -N app_pri -m Set volume size to 37584896 Volume ID 0, size 296 LEBs (37584896 bytes, 35.8 MiB), LEB size 126976 bytes (124.0 KiB), dynamic, name "app_pri", alignment 1 </td> 
 </tr> 
 </tbody> 
</table>

# ubirmvol #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 从UBI设备上删除UBI卷 </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> &nbsp;ubirmvol &lt;UBI device node file name&gt; [-n &lt;volume id&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;[--vol_id=&lt;volume id&gt;] [-N &lt;volume name&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;[--name=&lt;volume name&gt;] [-h] [--help] </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -a, --alignment=&lt;alignment&gt; </td> 
 <td> volume alignment (default is 1) </td> 
 </tr> 
 <tr> 
 <td> -m, --maxavsize </td> 
 <td> set volume size to maximum available size </td> 
 </tr> 
 <tr> 
 <td> -n, --vol_id=&lt;volume id&gt; </td> 
 <td> volume ID to remove &nbsp; </td> 
 </tr> 
 <tr> 
 <td> -N, --name=&lt;volume name&gt; </td> 
 <td> volume name to remove </td> 
 </tr> 
 <tr> 
 <td> -h, -?, --help &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print help message &nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -s, --size=&lt;bytes&gt; </td> 
 <td> volume size volume size in bytes, kilobytes (KiB)&nbsp;or megabytes (MiB) </td> 
 </tr> 
 <tr> 
 <td> -S, --lebs=&lt;LEBs count&gt; </td> 
 <td> alternative way to give volume size in logical&nbsp;eraseblocks </td> 
 </tr> 
 <tr> 
 <td> -t, --type=&lt;static|dynamic&gt; </td> 
 <td> volume type (dynamic, static), default is dynamic </td> 
 </tr> 
 <tr> 
 <td> -h, -?, --help </td> 
 <td> print help message </td> 
 </tr> 
 <tr> 
 <td> -V, --version &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print program version </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> ubirmvol /dev/ubi0 -n 1&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; - remove UBI volume 1 from UBI device corresponding to /dev/ubi0 ubirmvol /dev/ubi0 -N my_vol&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- remove UBI named "my_vol" from UBI device corresponding to&nbsp; &nbsp; /dev/ubi0 </td> 
 </tr> 
 </tbody> 
</table>

# ubinize #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 制作UBI镜像 </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> ubinize [-o filename] [-p &lt;bytes&gt;] [-m &lt;bytes&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;[-s &lt;bytes&gt;] &nbsp;[-O &lt;num&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; [-e &lt;num&gt;] [-x &lt;num&gt;] [-Q &lt;num&gt;] [-v] [-h] [-V] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; [--output=&lt;filename&gt;] [--peb-size=&lt;bytes&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; [--min-io-size=&lt;bytes&gt;] [--sub-page-size=&lt;bytes&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; [--vid-hdr-offset=&lt;num&gt;]&nbsp;[--erase-counter=&lt;num&gt;] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; [--ubi-ver=&lt;num&gt;] [--image-seq=&lt;num&gt;] [--verbose] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; [--help] [--version] &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ini-file </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -o, --output=&lt;file name&gt; &nbsp;&nbsp; </td> 
 <td> output file name &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -p, --peb-size=&lt;bytes&gt; &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> size of the physical eraseblock of the flash this UBI image is created for in bytes,&nbsp; &nbsp;kilobytes (KiB), or megabytes (MiB)&nbsp;(mandatory parameter)&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -m, --min-io-size=&lt;bytes&gt; </td> 
 <td> minimum input/output unit size of the flash&nbsp;in bytes&nbsp; &nbsp; &nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -s, --sub-page-size=&lt;bytes&gt; </td> 
 <td> minimum input/output unit used for UBI&nbsp;headers, e.g. sub-page size in case of NAND flash (equivalent to the minimum input/output unit size by default)&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -O, --vid-hdr-offset=&lt;num&gt; </td> 
 <td> offset if the VID header from start of the physical eraseblock (default is the next&nbsp; minimum I/O unit or sub-page after the EC header)&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -e, --erase-counter=&lt;num&gt; </td> 
 <td> the erase counter value to put to EC headers (default is 0) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -x, --ubi-ver=&lt;num&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> UBI version number to put to EC headers (default is 1) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -Q, --image-seq=&lt;num&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> 32-bit UBI image sequence number to use &nbsp;(by default a random number is picked)&nbsp; &nbsp; </td> 
 </tr> 
 <tr> 
 <td> -v, --verbose &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> be verbose &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -h, --help &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print help message &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -V, --version &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print program version &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> ubinize -o ubi.img -p 16KiB -m 512 -s 256 cfg.ini - create UBI image&nbsp;'ubi.img' as described by configuration file 'cfg.ini' </td> 
 </tr> 
 </tbody> 
</table>

# ubiblock #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 管理UBI卷上的block（创建/删除） </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> ubiblock [-c,-r] &lt;UBI volume node file name&gt; </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -c, --create </td> 
 <td> create block on top of a volume </td> 
 </tr> 
 <tr> 
 <td> -r, --remove </td> 
 <td> remove block from volume &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -h, --help &nbsp;&nbsp; </td> 
 <td> print help message &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -V, --version </td> 
 <td> print program version &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> ubiblock --create /dev/ubi0_0 </td> 
 </tr> 
 </tbody> 
</table>

# ubirename #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 更改ubi某个olume的名字，或者完成两个volume的互换 </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> ubirename &lt;UBI device node file name&gt; [&lt;old name&gt; &lt;new name&gt;|...] </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 1. 将ubi2上名字为my_vol_a的volume名字改为my_vol_newname &nbsp; &nbsp; &nbsp; ubirename /dev/ubi2&nbsp;my_vol_a my_vol_newname 2. 将ubi2上名字为my_vol_b和my_vol_c的两个volume互换, &nbsp; &nbsp; &nbsp; &nbsp;ubirename&nbsp;/dev/ubi2 my_vol_b my_vol_c my_vol_c my_vol_b 3. 把volume A的名字改为B，把volume C的名字改为D &nbsp; &nbsp; &nbsp; &nbsp;ubirename/dev/ubi0 A B C D </td> 
 </tr> 
 </tbody> 
</table>

# ubiupdatevol #

<table> 
 <tbody> 
 <tr> 
 <td> 作用 </td> 
 <td> 向UBI volume里边写数据 </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> ubiupdatevol &lt;UBI volume node file name&gt; [-t] [-s &lt;size&gt;] [-h] [-V] [--truncate] [--size=&lt;size&gt;] [--help] [--version] &lt;image file&gt; </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 参数 </td> 
 </tr> 
 <tr> 
 <td> -t, --truncate &nbsp;&nbsp;&nbsp; </td> 
 <td> truncate volume (wipe it out) &nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -s, --size=&lt;bytes&gt; </td> 
 <td> bytes to read from input &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> --skip=&lt;bytes&gt; </td> 
 <td> leading bytes to skip from input </td> 
 </tr> 
 <tr> 
 <td> -h, --help &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print help message &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td> -V, --version &nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td> print program version &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 1. write file "fs.img" to UBI volume /dev/ubi0_1 &nbsp; &nbsp; &nbsp;ubiupdatevol /dev/ubi0_1 fs.img 2. wipe out UBI volume /dev/ubi0_1 &nbsp; &nbsp; &nbsp;ubiupdatevol /dev/ubi0_1 -t </td> 
 </tr> 
 </tbody> 
</table>

# 操作示例 #

## 第一次操作 ##

ubiformat /dev/mtd8 -s 0x800 -O 0x800  
ubiattach -m 8 -d 1 /dev/ubi\_ctrl //会出现/dev/ubi1节点  
ubimkvol /dev/ubi1 -N app\_pri -m //会出现/dev/ubi1\_0节点  
mount -t ubifs /dev/ubi1\_0 /mnt

//注意：ubiattach 生成/dev/ubiM和ubimkvol生成/dev/ubiM\_N需要时间，要等待其生成节点之后再mount  
示例等待命令（shell）：  
/usr/sbin/ubiattach -m 8 -d 1 /dev/ubi\_ctrl  
if \[ $? == 0 \]; then  
loop=0  
while \[ "$((loop++))" -lt "6" \]  
do  
echo "waiting for /dev/ubi1."  
if \[ -e /dev/mtd1 \]; then  
echo "/dev/ubi1 appear"  
break  
fi  
/bin/sleep 1  
done  
else  
echo "ubiattach -m 8 -d 1failed!"  
exit 1  
fi

## 非第一次操作 ##

// umount /dav  
// ubidetach /dev/ubi\_ctrl -d 1  
ubiattach -m 8 -d 1 /dev/ubi\_ctrl //会出现/dev/ubi1节点  
mount -t ubifs /dev/ubi1\_0 /mnt

mount打印：

\# mount -t ubifs /dev/ubi1\_0 /mnt/  
\[ 52.943452\] UBIFS (ubi1:0): background thread "ubifs\_bgt1\_0" started, PID 274  
\[ 53.387663\] UBIFS (ubi1:0): recovery needed  
\[ 54.160605\] UBIFS (ubi1:0): recovery completed  
\[ 54.169441\] UBIFS (ubi1:0): UBIFS: mounted UBI device 1, volume 0, name "app\_pri"  
\[ 54.181077\] UBIFS (ubi1:0): LEB size: 126976 bytes (124 KiB), min./max. I/O unit sizes: 2048 bytes/2048 bytes  
\[ 54.195172\] UBIFS (ubi1:0): FS size: 36315136 bytes (34 MiB, 286 LEBs), journal size 1777664 bytes (1 MiB, 14 LEBs)  
\[ 54.209642\] UBIFS (ubi1:0): reserved for root: 1715252 bytes (1675 KiB)  
\[ 54.219050\] UBIFS (ubi1:0): media format: w4/r0 (latest is w4/r0), UUID 0C991C90-92CF-4740-A810-7114851BC829, small LPT model

--------------------

[ubi_linux_IT_-CSDN_ubi]: https://knife.blog.csdn.net/article/details/112425042