Bug 1110 - The many variables affecting the rootfs size of the image need documenting
Summary: The many variables affecting the rootfs size of the image need documenting
Status: RESOLVED FIXED
Alias: None
Product: Quick Start
Classification: Documentation
Component: quick-start (show other bugs)
Version: unspecified
Hardware: x86 Multiple
: Medium normal
Target Milestone: 1.2
Assignee: Scott Rifenbark
QA Contact:
URL: ec6b9d77d10a95f0a2d460dca3cf8eab5dfbf0c0
Whiteboard: 05-jan-20012: Resolved/Fixed
Depends on:
Blocks:
 
Reported: 2011-05-26 13:48 UTC by Joshua Lock - Disabled
Modified: 2012-01-05 12:05 UTC (History)
4 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: ---

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Joshua Lock - Disabled 2011-05-26 13:48:45 UTC 
Each variable that the user can modify to affect the rootfs size and how they all interact should be documented so that one doesn't have to find and read code to work out how to set their images size.
Comment 1 Joshua Lock - Disabled 2011-05-26 14:13:03 UTC 
There is a thread on oe-core discussing this that will likely contain much of the required detail: http://lists.linuxtogo.org/pipermail/openembedded-core/2011-May/003030.html
Comment 2 Scott Rifenbark 2012-01-05 12:05:35 UTC 
I have added three new glossary entries to the glossary appendix: IMAGE_ROOTFS_SIZE, IMAGE_OVERHEAD_FACTOR, and IMAGE_ROOTFS_EXTRA_SPACE.  The descriptions are robust enough to stand on their own and allow a user to understand how the image size is computed as well as how to request extra free disk space or increase the percentage of overhead.  While these entries I feel satisfy this bug, I will later be adding in user information into the YP Development Manual that addresses image size in general.  I am not tying that to this bug though.

For the entries see commit ID ec6b9d77d10a95f0a2d460dca3cf8eab5dfbf0c0 at 
http://git.yoctoproject.org/cgit.cgi/yocto-docs/commit/?id=ec6b9d77d10a95f0a2d460dca3cf8eab5dfbf0c0