The following options can be used in LE 10.x+ to customise the build experience:
Name | Values | Default | Description |
|
|
| Maximum number of packages to build concurrently. On an 8-core system, |
|
|
| If |
|
|
| Determine under what circumstances package logs are written to |
|
|
| Adds |
|
|
| Control whether build system output is colored or not. |
|
|
| If |
|
|
| Output additional job state information to |
|
|
| Output real-time load, memory and in-progress job information to |
|
|
| Output detailed debug information to |
|
|
| If |
|
|
| When |
|
|
| System load information is captured at regular intervals in |
|
|
| Remove source code directories during the build once the source code directory is not required. |
Options can be specified on the command line, or added to persistent "options" files located under the root folder of the buildsystem, e.g. ~/LibreELEC.tv/.libreelec/options
or the users home folder, e.g. ~/.libreelec/options
- if both files exist, home folder options trump root folder options. The following gives a fairly clean and comprehensive output while still allowing command-line overrides:
LOGCOMBINE=${LOGCOMBINE:-never}MTPROGRESS=${MTPROGRESS:-yes}MTIMMEDIATE=${MTIMMEDIATE:-no}
If you are bulding and sharing images via the LibreELEC forums it is good to include a custom "builder" name with your images. This allows the team to count the number of active installs using your images (we can share this info on request). Builder name also populates into /etc/os-release
and logfiles, which helps forum staff supporting users differentiate between official releases and community created images. It is also possible to set custom versioning. e.g.
PROJECT=Generic ARCH=x86_64 BUILDER_NAME=yourname BUILDER_VERSION=123 make image
It is also possible to set persistent BUILDER_NAME
and BUILDER_VERSION
in "options" files.
The build-system automatically strips debug symbols from most packages. To disable this and include debug symbols and common debugging packagess in the image, enable DEBUG
, e.g.
PROJECT=Generic ARCH=x86_64 DEBUG=yes make image
To also include valgrind:
PROJECT=Generic ARCH=x86_64 DEBUG=yes VALGRIND=yes make image
Note: The resulting image will be considerably larger than normal. The default boot partition is 512MB, but debug images may exceed this and require a 1GB partition.