webosce · pull · Nov 10, 2023 · Nov 10, 2023 · Nov 10, 2023 · Nov 10, 2023
diff --git a/.gitignore b/.gitignore
@@ -23,13 +23,16 @@
 /BUILD-ARTIFACTS/
 /Makefile
 TAGS
+/bitbake-cookerdaemon.log
 /bitbake.lock
 /mcf.status
 /oe-init-build-env
 /conf/
 __pycache__/
 tmp/
 patches/
+/oe-logging.json
+/ccache_stats.json
 
 # Artifacts from generating build_changes.log
 build_changes.log

diff --git a/README.md b/README.md
@@ -1,101 +1,65 @@
-build-webos
-===========
+# build-webos
 
-Summary
--------
-Build webOS OSE (Open Source Edition) images
+This repository contains the top level code that aggregates the various [OpenEmbedded](http://openembedded.org) layers into a whole from which [webOS Open Source Edition (OSE)](https://www.webosose.org/) images can be built.
 
-Description
------------
-This repository contains the top level code that aggregates the various [OpenEmbedded](http://openembedded.org) layers into a whole from which webOS OSE images can be built.
+## Prerequisites
 
-Cloning
-=======
-Set up build-webos by cloning its Git repository:
+Before you begin, make sure that you prepare the target device and systems that meet the [System Requirements](https://www.webosose.org/docs/guides/setup/system-requirements/).
 
-     git clone https://github.com/webosose/build-webos.git
+## How to Build a webOS OSE Image
 
-Note: If you populate it by downloading an archive (zip or tar.gz file), then you will get the following error when you run mcf:
+To build a webOS OSE image, refer to [Building webOS OSE](https://www.webosose.org/docs/guides/setup/building-webos-ose/)
 
-     fatal: Not a git repository (or any parent up to mount parent).
-     Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYTEM not set).
+If you are already familiar with building webOS OSE, check the following quick summary:
 
+``` bash
+# Download this repository
+$ git clone https://github.com/webosose/build-webos.git
+$ cd build-webos
+$ git checkout -t origin/<branch of the latest webOS OSE version>
 
-Prerequisites
-=============
-Before you can build, you will need some tools.  If you try to build without them, bitbake will fail a sanity check and tell you what's missing, but not really how to get the missing pieces. On Ubuntu, you can force all of the missing pieces to be installed by entering:
+# Install and configure the build
+$ sudo scripts/prerequisites.sh
+$ ./mcf -p 0 -b 0 raspberrypi4-64
 
-    $ cd build-webos
-    $ sudo scripts/prerequisites.sh
+# Start to build
+$ source oe-init-build-env
+$ bitbake webos-image
+```
 
-Also, the bitbake sanity check will issue a warning if you're not running under Ubuntu 14.04 64bit LTS.
+> **Note**: See also [Flashing webOS OSE](https://www.webosose.org/docs/guides/setup/flashing-webos-ose/).
 
+## Copyright and License Information
 
-Building
-========
-To configure the build for the raspberrypi3 or qemux86 and to fetch the sources:
-
-    For raspberrypi3
-    $ ./mcf -p 0 -b 0 raspberrypi3
-
-    For qemux86
-    $ ./mcf -p 0 -b 0 qemux86
-
-The `-p 0` and `-b 0` options set the make and bitbake parallelism values to the number of CPU cores found on your computer.
-
-To kick off a full build of webOS OSE, make sure you have at least 100GB of disk space available and enter the following:
-
-    $ make webos-image
-
-This may take in the neighborhood of two hours on a multi-core workstation with a fast disk subsystem and lots of memory, or many more hours on a laptop with less memory and slower disks or in a VM.
-
-
-Images
-======
-The following images can be built:
-
-- `webos-image`: The production webOS OSE image.
-- `webos-image-devel`: Adds various development tools to `webos-image`, including gdb and strace. See `packagegroup-core-tools-debug` and `packagegroup-core-tools-profile` in `oe-core` and `packagegroup-webos-test` in `meta-webos` for the complete list.
-
-
-Cleaning
-========
-To blow away the build artifacts and prepare to do clean build, you can remove the build directory and recreate it by typing:
-
-    $ rm -rf BUILD
-    $ ./mcf.status
-
-What this retains are the caches of downloaded source (under `./downloads`) and shared state (under `./sstate-cache`). These caches will save you a tremendous amount of time during development as they facilitate incremental builds, but can cause seemingly inexplicable behavior when corrupted. If you experience strangeness, use the command presented below to remove the shared state of suspicious components. In extreme cases, you may need to remove the entire shared state cache. See [here](https://www.yoctoproject.org/docs/current/ref-manual/ref-manual.html#shared-state-cache) for more information on it.
-
-
-Building Individual Components
-==============================
-To build an individual component, enter:
-
-    $ make <component-name>
+Unless otherwise specified, all content, including all source code files and documentation files in this repository are:
 
-To clean a component's build artifacts under BUILD, enter:
+Copyright (c) 2008-2024 LG Electronics, Inc.
 
-    $ make clean-<component-name>
+All content, including all source code files and documentation files in this repository except otherwise noted are: Licensed under the Apache License, Version 2.0 (the "License"); you may not use this content except in compliance with the License. You may obtain a copy of the License at
 
-To remove the shared state for a component as well as its build artifacts to ensure it gets rebuilt afresh from its source, enter:
+http://www.apache.org/licenses/LICENSE-2.0
 
-    $ make cleanall-<component-name>
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
 
-Adding new layers
-=================
-The script automates the process of adding new OE layers to the build environment.  The information required for integrate new layer are; layer name, OE priority, repository, identification in the form branch, commit or tag ids. It is also possible to reference a layer from local storage area.  The details are documented in weboslayers.py.
+SPDX-License-Identifier: Apache-2.0
 
-Copyright and License Information
-=================================
-Unless otherwise specified, all content, including all source code files and documentation files in this repository are:
+## How to Download Source Codes and Licenses
 
-Copyright (c) 2008-2018 LG Electronics, Inc.
+If you *ONLY* want to check the source codes and those license information, enter the following commands:
 
-All content, including all source code files and documentation files in this repository except otherwise noted are: Licensed under the Apache License, Version 2.0 (the "License"); you may not use this content except in compliance with the License. You may obtain a copy of the License at
+``` bash
+# Download this repository
+$ git clone https://github.com/webosose/build-webos.git
+$ cd build-webos
+$ git checkout -t origin/<branch of the latest webOS OSE version>
 
-http://www.apache.org/licenses/LICENSE-2.0
+# Install and configure the build
+$ sudo scripts/prerequisites.sh
+$ ./mcf -p 0 -b 0 raspberrypi4-64
 
-Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+# Download source codes and licenses
+$ source oe-init-build-env
+$ bitbake --runall=patch webos-image
+```
 
-SPDX-License-Identifier: Apache-2.0
+You can check the source codes and licenses under the `BUILD/work` directory.
diff --git a/build-templates/local-conf.in b/build-templates/local-conf.in
@@ -1,7 +1,7 @@
 # DO NOT MODIFY!  This script is generated by configure. Changes made
 # here will be lost.  Source for this file is in local-conf.in.
 
-# Copyright (c) 2008-2017 LG Electronics, Inc.
+# Copyright (c) 2008-2021 LG Electronics, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -153,7 +153,7 @@ PACKAGE_CLASSES ?= "package_ipk"
 # Supported values are i686 and x86_64
 #
 # Using ??= so that it can be overridden in webos-local.conf without having to
-# resort to using _forcevariable.
+# resort to using :forcevariable.
 SDKMACHINE ??= "${BUILD_ARCH}"
 
 #
@@ -184,12 +184,9 @@ EXTRA_IMAGE_FEATURES ?= ""
 # are:
 #   - 'buildhistory' collect statistics from build artifacts
 #   - 'buildstats' collect build statistics
-#   - 'image-mklibs' to reduce shared library files size for an image
 #   - 'image-prelink' in order to prelink the filesystem image
 #   - 'image-swab' to perform host system intrusion detection
-# NOTE: if listing mklibs & prelink both, then make sure mklibs is before prelink
-# NOTE: mklibs also needs to be explicitly enabled for a given image, see local.conf.extended
-USER_CLASSES ?= "@buildhistory_class@ buildstats image-mklibs"
+USER_CLASSES ?= "@buildhistory_class@ buildstats"
 
 BUILDHISTORY_DIR ?= "${TOPDIR}/buildhistory"
 BUILDHISTORY_COMMIT ?= "@buildhistory_enabled@"
@@ -268,7 +265,7 @@ BB_GENERATE_MIRROR_TARBALLS := "@generatemirrortarballs@"
 # CONF_VERSION is increased each time build/conf/ changes incompatibly and is used to
 # track the version of this file when it was generated. This can safely be ignored if
 # this doesn't mean anything to you.
-CONF_VERSION = "1"
+CONF_VERSION = "2"
 
 # local.conf.sample.extended starts here.
 # BBMASK is a regular expression that can be used to tell BitBake to ignore
@@ -357,15 +354,6 @@ CONF_VERSION = "1"
 # the toolchain you want to use is included in an appropriate layer
 # TCMODE = "external-eabi"
 
-# mklibs library size optimization is more useful to smaller images,
-# and less useful for bigger images. Also mklibs library optimization
-# can break the ABI compatibility, so should not be applied to the
-# images which are to be extended or upgraded later.
-#This enabled mklibs library size optimization just for the specified image.
-#MKLIBS_OPTIMIZED_IMAGES ?= "core-image-minimal"
-#This enable mklibs library size optimization will be for all the images.
-#MKLIBS_OPTIMIZED_IMAGES ?= "all"
-
 # Uncomment this if your host distribution provides the help2man tool.
 #ASSUME_PROVIDED += "help2man-native"
 
@@ -412,14 +400,14 @@ CONF_VERSION = "1"
 # product. If shipped as part of an image these packages may have
 # implications so they are disabled by default.  To enable them,
 # un-comment the below as appropriate.
-#LICENSE_FLAGS_WHITELIST = "commercial_gst-fluendo-mp3 \
-#                           commercial_gst-openmax \
-#                           commercial_gst-plugins-ugly \
-#                           commercial_lame \
-#                           commercial_libmad \
-#                           commercial_libomxil \
-#                           commercial_mpeg2dec \
-#                           commercial_qmmp"
+#LICENSE_FLAGS_ACCEPTED = "commercial_gst-fluendo-mp3 \
+#                          commercial_gst-openmax \
+#                          commercial_gst-plugins-ugly \
+#                          commercial_lame \
+#                          commercial_libmad \
+#                          commercial_libomxil \
+#                          commercial_mpeg2dec \
+#                          commercial_qmmp"
 
 
 #
@@ -433,7 +421,7 @@ CONF_VERSION = "1"
 # "action,directory,minimum_space,minimum_free_inode"
 #
 # The "action" must be set and should be one of:
-# ABORT: Immediately abort
+# HALT: Immediately halt
 # STOPTASKS: The new tasks can't be executed any more, will stop the build
 #           when the running tasks have been done.
 # WARN: show warnings (see BB_DISKMON_WARNINTERVAL for more information)

diff --git a/build-templates/oe-init-build-env.in b/build-templates/oe-init-build-env.in
@@ -36,7 +36,7 @@ fi
 
 # used in runqemu bitbake wrapper for pseudodone location
 export BUILDDIR="${TOPDIR}/BUILD"
-export BB_ENV_EXTRAWHITE="MACHINE DISTRO TCMODE TCLIBC http_proxy ftp_proxy https_proxy all_proxy ALL_PROXY no_proxy SSH_AGENT_PID SSH_AUTH_SOCK BB_SRCREV_POLICY SDKMACHINE BB_NUMBER_THREADS PARALLEL_MAKE GIT_PROXY_COMMAND GIT_PROXY_IGNORE SOCKS5_PASSWD SOCKS5_USER WEBOS_DISTRO_BUILD_ID PSEUDO_DISABLED PSEUDO_BUILD"
+export BB_ENV_PASSTHROUGH_ADDITIONS="MACHINE DISTRO TCMODE TCLIBC http_proxy ftp_proxy https_proxy all_proxy ALL_PROXY no_proxy SSH_AGENT_PID SSH_AUTH_SOCK BB_SRCREV_POLICY SDKMACHINE BB_NUMBER_THREADS PARALLEL_MAKE GIT_PROXY_COMMAND GIT_PROXY_IGNORE SOCKS5_PASSWD SOCKS5_USER WEBOS_DISTRO_BUILD_ID PSEUDO_DISABLED PSEUDO_BUILD"
 
 [ -z "${MACHINES}" ] && MACHINES="@machines@"
 [ -z "${MACHINE}" ] && MACHINE="@machine@"