bst man page

bst — Build and manipulate BuildStream projects...

Synopsis

bst [Options] COMMAND [ARGS]...

Description

Build and manipulate BuildStream projects

Most of the main options override options in the user preferences configuration file.

Options

--version
-c, --config FILE

Configuration file to use

-C, --directory DIRECTORY

Project directory (default: current directory)

--on-error [continue|quit|terminate]

What to do when an error is encountered

--fetchers INTEGER

Maximum simultaneous download tasks

--builders INTEGER

Maximum simultaneous build tasks

--pushers INTEGER

Maximum simultaneous upload tasks

--max-jobs INTEGER

Number of parallel jobs allowed for a given build task

--network-retries INTEGER

Maximum retries for network tasks

--no-interactive

Force non interactive mode, otherwise this is automatically decided

--verbose / --no-verbose

Be extra verbose

--debug / --no-debug

Print debugging output

--error-lines INTEGER

Maximum number of lines to show from a task log

--message-lines INTEGER

Maximum number of lines to show in a detailed message

--log-file FILENAME

A file to store the main log (allows storing the main log while in interactive mode)

--colors / --no-colors

Force enable/disable ANSI color codes in output

--strict / --no-strict

Elements must be rebuilt when their dependencies have changed

-o, --option OPTION VALUE

Specify a project option

--default-mirror TEXT

The mirror to fetch from first, before attempting other mirrors

Commands

help
 Print usage information
 See bst-help(1) for full documentation on the help command.

init
 Initialize a new BuildStream project
 See bst-init(1) for full documentation on the init command.

build
 Build elements in a pipeline
 See bst-build(1) for full documentation on the build command.

fetch
 Fetch sources in a pipeline
 See bst-fetch(1) for full documentation on the fetch command.

track
 Track new source references
 See bst-track(1) for full documentation on the track command.

pull
 Pull a built artifact
 See bst-pull(1) for full documentation on the pull command.

push
 Push a built artifact
 See bst-push(1) for full documentation on the push command.

show
 Show elements in the pipeline
 See bst-show(1) for full documentation on the show command.

shell
 Shell into an element's sandbox environment
 See bst-shell(1) for full documentation on the shell command.

checkout
 Checkout a built artifact
 See bst-checkout(1) for full documentation on the checkout command.

workspace
 Manipulate developer workspaces
 See bst-workspace(1) for full documentation on the workspace command.

source-bundle
 Produce a build bundle to be manually executed
 See bst-source-bundle(1) for full documentation on the source-bundle command.

Info

14-Jul-2019 bst Manual