bbot-worker(1)

NAME
bbot-worker - build bot worker

SYNOPSIS

bbot-worker --help
bbot-worker --version
bbot-worker --bootstrap [options]
bbot-worker --startup [options]
bbot-worker [options] module... cfg-var...

DESCRIPTION

bbot-worker @@ TODO.

If the --bootstrap mode option is specified, then the worker performs the initial machine bootstrap and writes the bootstrap result manifest to stdout. If the --startup mode option is specified, then the worker performs the environment setup and then re-executes in the build mode. If neither of the mode options is specified, then the worker proceeds to performing the build task.

OPTIONS

--help
    Print usage information and exit.

--version
    Print version and exit.

--verbose level
    Set the diagnostics verbosity to level between 0 and 6 with level 1 being the default.

--bootstrap
    Perform the inital machine bootstrap insteading of building.

--startup
    Perform the environment setup and then re-execute for building.

--systemd-daemon
    Run as a simple systemd daemon.

--build dir
    The directory to perform the build in. If not specified, then the current working directory is used.

--environments dir
    The directory containing the environment setup executables. If not specified, then the user's home directory is used.

--env-script path
    The environment setup executable path. This option is normally passed by the worker running in the startup mode to the worker executed in the build mode.

--env-target target
    The environment setup executable target argument. This option is normally passed by the worker running in the startup mode to the worker executed in the build mode.

--tftp-host addr
    The TFTP host address and, optionally, port to use to download the build task and to upload the build result. By default the link-local address 196.254.111.222 with the standard TFTP port (69) is used.

EXIT STATUS

Non-zero exit status is returned in case of an error. In the build mode, exit code 2 is used to signal abnormal termination where the worker uploaded the result manifest itself.

BUGS
Send bug reports to the users@build2.org mailing list.

COPYRIGHT
Copyright (c) 2014-2026 the build2 authors (see the AUTHORS file). Permission is granted to copy, distribute and/or modify this document under the terms of the MIT License.