From: JF Ding Date: Wed, 8 Feb 2012 01:12:15 +0000 (+0800) Subject: new doc KNOWN-ISSUES to highlight syslinux issue X-Git-Tag: 0.6~17 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=3af86cea7c428f0f59e4cc639a3455812af2a702;p=tools%2Fmic.git new doc KNOWN-ISSUES to highlight syslinux issue and update README.rst with new section too --- diff --git a/KNOWN-ISSUES b/KNOWN-ISSUES new file mode 100644 index 0000000..1f58731 --- /dev/null +++ b/KNOWN-ISSUES @@ -0,0 +1,11 @@ +Known Issues +============ + +Bug of latest "syslinux" package +-------------------------------- +In some new Linux distributions, the "syslinux" package in their official +software repositories is the version 4.04. It will cause segment fault for +a fatal bug, and mic will failed with syslinux installation errors. + +The solution is to install the patched "syslinux" package in MeeGo or Tizen's +tools repos, until the official released one being fixed. diff --git a/README.rst b/README.rst index 0938e29..4bdab22 100644 --- a/README.rst +++ b/README.rst @@ -109,7 +109,8 @@ Ubuntu/Debian Installation > deb http://download.meego.com/live/devel:/tools:/building/_/ / > REPO -*Tips*: for Ubuntu 10.10, you should use xUbuntu_10.10 to replace _. +*Tips*: for Ubuntu 10.10, you need to use xUbuntu_10.10 to replace +_. 2. Update repolist: :: @@ -243,7 +244,9 @@ or :: $ sudo mic cr fs test.ks --outdir output -*Tips*: if you failed to create armv7* image, the reason may be qemu/qemu-arm on your host is lower than required, please update qemu/qemu-arm higher than 0.13.0. +*Tips*: if you failed to create armv7* image, the reason may be: qemu/qemu-arm +on your host is lower than required, please upgrade qemu/qemu-arm higher than +version 0.13.0. Running 'mic chroot' -------------------- @@ -287,10 +290,23 @@ of ks file, example as follows: :: Multiple running instances support ---------------------------------- -mic support running multi-instance, but cache dir can't be shared between instances, -so you should specify different cachedir for different instance using `--cachedir`. -Also outdir should be specified to a different directory for each instance using -`--outdir`, example as follows: :: +mic support running multi-instance, but cache dir can't be shared between +instances, so you should specify different cachedir for different instance +using `--cachedir`. Also outdir should be specified to a different directory +for each instance using `--outdir`, example as follows: :: mic cr fs netbook1.ks --cachedir=/var/tmp/cache/mic1 --outdir=out1 mic cr fs netbook2.ks --cachedir=/var/tmp/cache/mic2 --outdir=out2 + +Known Issues +============ + +Bug of latest "syslinux" package +-------------------------------- +In some new Linux distributions, the "syslinux" package in their official +software repositories is the version 4.04. It will cause segment fault for +a fatal bug, and mic will failed with syslinux installation errors. + +The solution is to install the patched "syslinux" package in MeeGo or Tizen's +tools repos, until the official released one being fixed. +