summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/faq.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/faq.xml')
-rw-r--r--documentation/ref-manual/faq.xml38
1 files changed, 29 insertions, 9 deletions
diff --git a/documentation/ref-manual/faq.xml b/documentation/ref-manual/faq.xml
index 4e9db7d592..a6a4ab8d04 100644
--- a/documentation/ref-manual/faq.xml
+++ b/documentation/ref-manual/faq.xml
@@ -453,15 +453,35 @@
453 </question> 453 </question>
454 <answer> 454 <answer>
455 <para> 455 <para>
456 Images are created to be 1.2 times the size of the populated root filesystem. 456 By default, the OpenEmbedded build system creates images
457 To modify this ratio so that there is more free space available, you need to 457 that are 1.3 times the size of the populated root filesystem.
458 set the configuration value <filename>IMAGE_OVERHEAD_FACTOR</filename>. 458 To affect the image size, you need to set various
459 For example, setting <filename>IMAGE_OVERHEAD_FACTOR</filename> to 1.5 sets 459 configurations:
460 the image size ratio to one and a half times the size of the populated 460 <itemizedlist>
461 root filesystem. 461 <listitem><para><emphasis>Image Size:</emphasis>
462 <literallayout class='monospaced'> 462 The OpenEmbedded build system uses the
463 IMAGE_OVERHEAD_FACTOR = "1.5" 463 <link linkend='var-IMAGE_ROOTFS_SIZE'><filename>IMAGE_ROOTFS_SIZE</filename></link>
464 </literallayout> 464 variable to define the size of the image in Kbytes.
465 The build system determines the size by taking into
466 account the initial root filesystem size before any
467 modifications such as requested size for the image and
468 any requested additional free disk space to be
469 added to the image.</para></listitem>
470 <listitem><para><emphasis>Overhead:</emphasis>
471 Use the
472 <link linkend='var-IMAGE_OVERHEAD_FACTOR'><filename>IMAGE_OVERHEAD_FACTOR</filename></link>
473 variable to define the multiplier that the build system
474 applies to the initial image size, which is 1.3 by
475 default.</para></listitem>
476 <listitem><para><emphasis>Additional Free Space:</emphasis>
477 Use the
478 <link linkend='var-IMAGE_ROOTFS_EXTRA_SPACE'><filename>IMAGE_ROOTFS_EXTRA_SPACE</filename></link>
479 variable to add additional free space to the image.
480 The build system adds this space to the image after
481 it determines its
482 <filename>IMAGE_ROOTFS_SIZE</filename>.
483 </para></listitem>
484 </itemizedlist>
465 </para> 485 </para>
466 </answer> 486 </answer>
467 </qandaentry> 487 </qandaentry>