.TH DUB-DUSTMITE 1 "2018-12-21" "The D Language Foundation" "The D Language Foundation"
.SH NAME
dub \- Package and build management system for D
.SH SYNOPSIS
\fBdub dustmite\fR
<\fIdestination-path\fR>
\fIOPTIONS\&.\&.\&.\fR
[-- <\fIapplication arguments...\fR>]
.SH DESCRIPTION
This command uses the Dustmite utility to isolate the cause of build errors in a DUB project.



It will create a copy of all involved packages and run dustmite on this copy, leaving a reduced test case.



Determining the desired error condition is done by checking the compiler/linker status code, as well as their output (stdout and stderr combined). If --program-status or --program-regex is given and the generated binary is an executable, it will be executed and its output will also be incorporated into the final decision.
.SH OPTIONS
.IP --compiler-status=VALUE
The expected status code of the compiler run
.IP --compiler-regex=VALUE
A regular expression used to match against the compiler output
.IP --linker-status=VALUE
The expected status code of the linker run
.IP --linker-regex=VALUE
A regular expression used to match against the linker output
.IP --program-status=VALUE
The expected status code of the built executable
.IP --program-regex=VALUE
A regular expression used to match against the program output
.IP --test-package=VALUE
Perform a test run - usually only used internally
.IP --combined
Builds multiple packages with one compiler run
.IP -b, --build=VALUE
Specifies the type of build to perform. Note that setting the DFLAGS environment variable will override the build type with custom flags.
Possible names:
  debug (default), plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, unittest-cov, syntax and custom types
.IP -c, --config=VALUE
Builds the specified configuration. Configurations can be defined in dub.json
.IP --override-config=VALUE
Uses the specified configuration for a certain dependency. Can be specified multiple times.
Format: --override-config=<dependency>/<config>
.IP --compiler=VALUE
Specifies the compiler binary to use (can be a path).
Arbitrary pre- and suffixes to the identifiers below are recognized (e.g. ldc2 or dmd-2.063) and matched to the proper compiler type:
  dmd, gdc, ldc, gdmd, ldmd
.IP -a, --arch=VALUE
Force a different architecture (e.g. x86 or x86_64)
.IP -d, --debug=VALUE
Define the specified debug version identifier when building - can be used multiple times
.IP --nodeps
Do not resolve missing dependencies before building
.IP --build-mode=VALUE
Specifies the way the compiler and linker are invoked. Valid values:
  separate (default), allAtOnce, singleFile
.IP --single
Treats the package name as a filename. The file must contain a package recipe comment.
.IP --force-remove
Deprecated option that does nothing.
.SH FILES
\fIdub\&.sdl\fR, \fIdub\&.json\fR
.SH AUTHOR
Copyright (c) 1999-2018 by The D Language Foundation
.SH "ONLINE DOCUMENTATION"
.UR http://code.dlang.org/docs/commandline
.UE http://code.dlang.org/docs/commandline
.SH "SEE ALSO"
.BR dmd(1)
dub(1)