From 986a03cc7f524e656c93532852df1a632b2203a6 Mon Sep 17 00:00:00 2001 From: "Crom (Thibaut CHARLES)" Date: Fri, 24 Jul 2015 13:25:00 +0200 Subject: [PATCH] Added troubleshooting --- 5-misc/deployssh.md | 3 --- 5-troubleshooting/boot.md | 13 +++++++++++++ 5-troubleshooting/recipes.md | 17 +++++++++++++++++ {5-misc => 6-misc}/buildproc.md | 0 6-misc/deployssh.md | 3 +++ {5-misc => 6-misc}/pkgmgr.md | 0 {5-misc => 6-misc}/rorootfs.md | 0 {5-misc => 6-misc}/toolchain.md | 0 {6-maintenance => 7-maintenance}/clean.md | 0 {6-maintenance => 7-maintenance}/update.md | 0 SUMMARY.md | 20 +++++++++++--------- 11 files changed, 44 insertions(+), 12 deletions(-) delete mode 100644 5-misc/deployssh.md create mode 100644 5-troubleshooting/boot.md create mode 100644 5-troubleshooting/recipes.md rename {5-misc => 6-misc}/buildproc.md (100%) create mode 100644 6-misc/deployssh.md rename {5-misc => 6-misc}/pkgmgr.md (100%) rename {5-misc => 6-misc}/rorootfs.md (100%) rename {5-misc => 6-misc}/toolchain.md (100%) rename {6-maintenance => 7-maintenance}/clean.md (100%) rename {6-maintenance => 7-maintenance}/update.md (100%) diff --git a/5-misc/deployssh.md b/5-misc/deployssh.md deleted file mode 100644 index f3af963..0000000 --- a/5-misc/deployssh.md +++ /dev/null @@ -1,3 +0,0 @@ -# Deploy a recipe to a target via ssh - -http://www.yoctoproject.org/docs/1.8/mega-manual/mega-manual.html#devtool-deploying-your-software-on-the-target-machine \ No newline at end of file diff --git a/5-troubleshooting/boot.md b/5-troubleshooting/boot.md new file mode 100644 index 0000000..a3d4f5c --- /dev/null +++ b/5-troubleshooting/boot.md @@ -0,0 +1,13 @@ +# Boot issues + +## Not bootable + +The flashed image must be built using [wic](../3-buildtest/wic.md). You should not flash images that are in `$POKY/build/tmp/deploy/images`. + +This can also be due to a mis configured bootloader. + + +## Nothing on screen (happens randomly) + +It is caused by the kernel boot command line options. +In the WKS file used to generate the final image, you must give the option `vga=current` (instead of `vga=0x318` or anything else). \ No newline at end of file diff --git a/5-troubleshooting/recipes.md b/5-troubleshooting/recipes.md new file mode 100644 index 0000000..725ac39 --- /dev/null +++ b/5-troubleshooting/recipes.md @@ -0,0 +1,17 @@ +# Recipes issues + +## Some files are not added to the image + +##### `do_install` +Be sure that the `do_install` task installs your files in `${D}` directory. + +##### `FILES_${PN}` +Installing files in `${D}` is not enough, you also need to add the files/directories that needs to be included in the image in the `FILES_${PN}` variable. + +##### Special files +Some files are not meant to be included in certain types of images. + +For example, `.so` libraries without specific versions are forbidden in the final system, as programs needs to be dynamically linked with the exact version of library they depend of. + +A workaraound for this is to define `SOLIBSDEV` to any extension, so `.so` files are not considered as dynamic libraries for this recipe. + diff --git a/5-misc/buildproc.md b/6-misc/buildproc.md similarity index 100% rename from 5-misc/buildproc.md rename to 6-misc/buildproc.md diff --git a/6-misc/deployssh.md b/6-misc/deployssh.md new file mode 100644 index 0000000..68c098b --- /dev/null +++ b/6-misc/deployssh.md @@ -0,0 +1,3 @@ +# Deploy a recipe to a target via ssh + +http://www.yoctoproject.org/docs/1.8/mega-manual/mega-manual.html#devtool-deploying-your-software-on-the-target-machine \ No newline at end of file diff --git a/5-misc/pkgmgr.md b/6-misc/pkgmgr.md similarity index 100% rename from 5-misc/pkgmgr.md rename to 6-misc/pkgmgr.md diff --git a/5-misc/rorootfs.md b/6-misc/rorootfs.md similarity index 100% rename from 5-misc/rorootfs.md rename to 6-misc/rorootfs.md diff --git a/5-misc/toolchain.md b/6-misc/toolchain.md similarity index 100% rename from 5-misc/toolchain.md rename to 6-misc/toolchain.md diff --git a/6-maintenance/clean.md b/7-maintenance/clean.md similarity index 100% rename from 6-maintenance/clean.md rename to 7-maintenance/clean.md diff --git a/6-maintenance/update.md b/7-maintenance/update.md similarity index 100% rename from 6-maintenance/update.md rename to 7-maintenance/update.md diff --git a/SUMMARY.md b/SUMMARY.md index c570687..62d58f4 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -31,12 +31,14 @@ * [Debugging Yocto builds](4-workflow/debug.md) * [Adding packages/recipes to image](4-workflow/addpkg.md) * [Creation of a distribution based on poky-tiny](4-workflow/distrocreate.md) - * [Misc](5-misc/buildproc.md) - * [Build process - Tasks](5-misc/buildproc.md) - * [Read-only root filesystem](5-misc/rorootfs.md) - * [Custom toolchain](5-misc/toolchain.md) - * [Deploy a recipe to a target via ssh](5-misc/deployssh.md) - * [Package Management (deb)](5-misc/pkgmgr.md) - * [Maintenance](6-maintenance/update.md) - * [Update Yocto](6-maintenance/update.md) - * [Cleaning](6-maintenance/clean.md) + * [Troubleshooting](5-troubleshooting/boot.md) + * [Boot](5-troubleshooting/boot.md) + * [Misc](6-misc/buildproc.md) + * [Build process - Tasks](6-misc/buildproc.md) + * [Read-only root filesystem](6-misc/rorootfs.md) + * [Custom toolchain](6-misc/toolchain.md) + * [Deploy a recipe to a target via ssh](6-misc/deployssh.md) + * [Package Management (deb)](6-misc/pkgmgr.md) + * [Maintenance](7-maintenance/update.md) + * [Update Yocto](7-maintenance/update.md) + * [Cleaning](7-maintenance/clean.md)