From c8b7c5ab1e2d7e2019ec8ffcb968610412ec495a Mon Sep 17 00:00:00 2001 From: Michael Opdenacker Date: Thu, 16 Mar 2023 18:34:53 +0100 Subject: manuals: update disk space requirements Tests made on Poky master on March 16, 2023. Add a "Free Disk Space" section to the "System Requirements" document. (From yocto-docs rev: 285ba689ce3ab7b7fdb4bb0d0284e2a52ad62c7f) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/brief-yoctoprojectqs/index.rst | 4 +++- documentation/poky.yaml.in | 2 ++ documentation/ref-manual/system-requirements.rst | 11 +++++++++++ 3 files changed, 16 insertions(+), 1 deletion(-) diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst index 7b8baf233a..07e95ee85c 100644 --- a/documentation/brief-yoctoprojectqs/index.rst +++ b/documentation/brief-yoctoprojectqs/index.rst @@ -40,7 +40,9 @@ Compatible Linux Distribution Make sure your :term:`Build Host` meets the following requirements: -- 50 Gbytes of free disk space +- At least &MIN_DISK_SPACE; Gbytes of free disk space, though + much more will help to run multiple builds and increase + performance by reusing build artifacts. - Runs a supported Linux distribution (i.e. recent releases of Fedora, openSUSE, CentOS, Debian, or Ubuntu). For a list of Linux diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in index 30e1050824..7810b8d2a5 100644 --- a/documentation/poky.yaml.in +++ b/documentation/poky.yaml.in @@ -41,3 +41,5 @@ MIN_TAR_VERSION : "1.28" MIN_GIT_VERSION : "1.8.3.1" MIN_GCC_VERSION : "7.5" MIN_MAKE_VERSION : "4.0" +# Disk space (Gbytes) needed to generate qemux86-64 core-image-sato on Ubuntu 22.04 (x86-64), rounded up from 87 +MIN_DISK_SPACE : "90" diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index 0fbe3f12c8..bf50fc510a 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst @@ -31,6 +31,17 @@ and conceptual information in the :doc:`/overview-manual/index`. .. _detailed-supported-distros: +Minimum Free Disk Space +======================= + +To build an image such as ``core-image-sato`` for the ``qemux86-64`` machine, +you need a system with at least &MIN_DISK_SPACE; Gbytes of free disk space. +However, much more disk space will be necessary to build more complex images, +to run multiple builds and to cache build artifacts, improving build efficiency. + +If you have a shortage of disk space, see the ":doc:`/dev-manual/disk-space`" +section of the Development Tasks Manual. + Supported Linux Distributions ============================= -- cgit v1.2.3-54-g00ecf