releng-tool¶
releng-tool aims to provide a way for developers to tailor the building of multiple software components to help prepare packages for desired runtime environments (e.g. cross-platform portable packages, embedded targets, etc.). When building a package, assets may be located in multiple locations and may require various methods to extract, build and more. releng-tool allows developers to define a set of packages, specifying where resources should be fetched from, how packages should be extracted and the processes for patching, configuring, building and installing each package for a target sysroot.
The structure of a package depends on the specific project. The simplest type is a script-based package, where users can define custom scripts for various stages. A package does not need to handle every stage. Helper package types are available (e.g. autotools, Cargo, CMake, Make, Meson, various Python types, and SCons) for projects using common build systems.
While releng-tool assists in configuring and building projects, it does not aim to provide a perfect sandbox for the process. Users are responsible for defining the compilers/toolchains used and managing the interaction between the staging/target area and the host system.
- Anforderungen
- Installation
- Getting started
- User guides
- Arguments
- Global actions
- Package actions
- Option arguments
--assets-dir <dir>
--cache-dir <dir>
--config <file>
--debug
-D
,--development [<mode>]
--dl-dir <dir>
-F
,--force
-h
,--help
--images-dir <dir>
-j
,--jobs <jobs>
-L
,--local-sources [[<pkg>:]<dir>]
--nocolorout
--out-dir <dir>
--relaxed-args
--root-dir <dir>
--sbom-format <fmt>
--quirk <quirk-id>
-V
,--verbose
--version
--werror
,-Werror
- Configuration
- Environment variables
- Common
BUILD_DIR
CACHE_DIR
DL_DIR
HOST_BIN_DIR
HOST_DIR
HOST_INCLUDE_DIR
HOST_LIB_DIR
IMAGES_DIR
LICENSE_DIR
NJOBS
NJOBSCONF
OUTPUT_DIR
PKG_BUILD_BASE_DIR
PKG_BUILD_DIR
PKG_BUILD_OUTPUT_DIR
PKG_CACHE_DIR
PKG_CACHE_FILE
PKG_DEFDIR
PKG_DEVMODE
PKG_INTERNAL
PKG_LOCALSRCS
PKG_NAME
PKG_REVISION
PKG_SITE
PKG_VERSION
PREFIX
PREFIXED_HOST_DIR
PREFIXED_STAGING_DIR
PREFIXED_TARGET_DIR
RELENG_CLEAN
RELENG_DEBUG
RELENG_DEVMODE
RELENG_DISTCLEAN
RELENG_EXEC
RELENG_FORCE
RELENG_LOCALSRCS
RELENG_MRPROPER
RELENG_REBUILD
RELENG_RECONFIGURE
RELENG_REINSTALL
RELENG_SCRIPT
RELENG_SCRIPT_DIR
RELENG_TARGET_PKG
RELENG_VERBOSE
RELENG_VERSION
ROOT_DIR
STAGING_BIN_DIR
STAGING_DIR
STAGING_INCLUDE_DIR
STAGING_LIB_DIR
SYMBOLS_DIR
TARGET_BIN_DIR
TARGET_DIR
TARGET_INCLUDE_DIR
TARGET_LIB_DIR
- Package-specific variables
- Script-only variables
- Other variables
- Common
- Packages
- Overview
- Topics
- Common options
- Advanced options
LIBFOO_BUILD_SUBDIR
LIBFOO_DEVMODE_IGNORE_CACHE
LIBFOO_DEVMODE_REVISION
LIBFOO_EXTENSION
LIBFOO_EXTERNAL
LIBFOO_EXTOPT
LIBFOO_EXTRACT_TYPE
LIBFOO_FETCH_OPTS
LIBFOO_FIXED_JOBS
LIBFOO_GIT_CONFIG
LIBFOO_GIT_DEPTH
LIBFOO_GIT_REFSPECS
LIBFOO_GIT_SUBMODULES
LIBFOO_GIT_VERIFY_REVISION
LIBFOO_HOST_PROVIDES
LIBFOO_INTERNAL
LIBFOO_NO_EXTRACTION
LIBFOO_PATCH_SUBDIR
LIBFOO_PREFIX
LIBFOO_REMOTE_CONFIG
LIBFOO_REMOTE_SCRIPTS
LIBFOO_REVISION
LIBFOO_STRIP_COUNT
LIBFOO_VCS_TYPE
- System-specific options
- Bootstrapping
- Post-processing
- Site definitions
- Hash file
- ASCII armor
- Script package (default)
- Autotools package
- Cargo package
- CMake package
- Make package
- Meson package
- Python package
- SCons package
- Deprecated options
- Post-processing
- Script helpers
- Licenses
- Tips
- Advanced
- Patching
- Internal/external packages
- Development mode
- Local-sources mode
- Configuration overrides
- Quirks
- Command line quirks
- Configuration-driven quirks
- Available quirks
- releng.bzr.certifi
- releng.cmake.disable_direct_includes
- releng.cmake.disable_parallel_option
- releng.disable_local_site_warn
- releng.disable_prerequisites_check
- releng.disable_remote_configs
- releng.disable_remote_scripts
- releng.disable_spdx_check
- releng.git.no_depth
- releng.git.no_quick_fetch
- releng.git.replicate_cache
- releng.log.execute_args
- releng.log.execute_env
- releng.stats.no_pdf
- Extensions
- Arguments
- Beispiele
- Requesting help
- Leitfaden für Mitwirkende
- ANHANG A - Kurzreferenz