Added troubleshooting

5-misc/deployssh.md

@@ -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

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).

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.
+

6-misc/deployssh.md

@@ -0,0 +1,3 @@
+# Deploy a recipe to a target via ssh
+
+<todo data-markdown>http://www.yoctoproject.org/docs/1.8/mega-manual/mega-manual.html#devtool-deploying-your-software-on-the-target-machine</todo>

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)
+	* [Troubleshooting](5-troubleshooting/boot.md)
-		* [Build process - Tasks](5-misc/buildproc.md)
+		* [Boot](5-troubleshooting/boot.md)
-		* [Read-only root filesystem](5-misc/rorootfs.md)
+	* [Misc](6-misc/buildproc.md)
-		* [Custom toolchain](5-misc/toolchain.md)
+		* [Build process - Tasks](6-misc/buildproc.md)
-		* [Deploy a recipe to a target via ssh](5-misc/deployssh.md)
+		* [Read-only root filesystem](6-misc/rorootfs.md)
-		* [Package Management (deb)](5-misc/pkgmgr.md)
+		* [Custom toolchain](6-misc/toolchain.md)
-	* [Maintenance](6-maintenance/update.md)
+		* [Deploy a recipe to a target via ssh](6-misc/deployssh.md)
-		* [Update Yocto](6-maintenance/update.md)
+		* [Package Management (deb)](6-misc/pkgmgr.md)
-		* [Cleaning](6-maintenance/clean.md)
+	* [Maintenance](7-maintenance/update.md)
+		* [Update Yocto](7-maintenance/update.md)
+		* [Cleaning](7-maintenance/clean.md)