rux run
Purpose
Build and execute a runnable target
Synopsis
rux run [options] [-- args...]
Behavior
Builds an Executable package, then runs it. SharedLibrary, StaticLibrary, and SourceLibrary packages cannot run. --define overrides compile-time configuration and --release selects the release profile. Only arguments after -- are passed to the child program.
Arguments
This command accepts no operands.
Options
| Option | Description |
|---|---|
--define <name[=value]> | Set or override a config compile-time value |
--release | Build with release profile |
Global options may appear before or after the command. See Global options.
Output and exit status
Compiler progress and diagnostics use the usual streams. After a successful build, the command returns the child program's exit code.
Success exits 0, invalid command-line usage exits 2, and compiler, validation, filesystem, network, or generation failures exit 1 unless stated otherwise above.
Examples
rux run
rux run --release
rux run -- --port 8080
Environment variables
SOURCE_DATE_EPOCH fixes compiler timestamps for reproducible builds.
The global color environment behavior is described under Global options.