11.3. Control Options

These options change some aspect of how abuild starts or runs.

--ant

Terminate argument parsing and pass all remaining arguments (up to --make) to ant.

-C start-directory

Change directories to the given directory before building.

-e | --emacs

Tell ant to run in emacs mode by passing the -e flag to it and also setting the property abuild.private.emacs-mode. Ant targets can use this information to pass to programs whose output may need to be dependent upon whether or not emacs mode is in effect.

--find-conf

Locates the first directory at or above the current directory that contains an Abuild.conf file, and changes directories to that location before building.

--full-integrity

Performs abuild's integrity checks for all items in the local tree, externals, and backing areas. Ordinarily, abuild performs its integrity check only for items that are being built in the current build. The --full-integrity flag would generally be useful only for people who are maintaining backing areas that are used by other people. For detailed information about abuild's integrity checks, please see Section 10.4, “Integrity Checks”.

-jn| --jobs=n

Build up to n build items in parallel by invoking up to n simultaneous instances of the backend. Does not cause the backend to run multiple jobs in parallel. See also --make-jobs.

-k | --keep-going

Don't stop the build after the first failed build item, but instead continue building additional build items that don't depend on any failed items. Also tells backend to continue after its first failure. Even with -k, abuild will never try to build an item if any of its dependencies failed. This behavior may be changed by also specifying --no-dep-failures.

--make

Terminate argument parsing and pass all remaining arguments (up to --ant) to make.

--make-jobs[=n]

Allow make to run up to n jobs in parallel. Omit n to allow make to run as many jobs as it wants. Be aware that if this option is used in combination with --jobs, the total number of threads could potentially be the product of the two numerical arguments.

--monitored

Run in monitored mode. For details, see Chapter 28, Monitored Mode.

-n | --just-print | --dry-run | --recon

For make-based builds only: have make print what it would do without actually doing it.

--no-abuild-logger

Do not tell ant to use the custom AbuildLogger as its logger. AbuildLogger is aware of the possibility of nested ant targets and also properly suppresses output of empty ant targets. As of ant version 1.7, the DefaultLogger and NoBannerLogger loggers produce misleading output when there are nested ant targets.

--no-dep-failures

Must be combined with -k. By default, abuild does not attempt to build any items whose dependencies have failed even if -k is specified. When the --no-dep-failures option is specified along with -k, abuild will attempt to build items even if one or more of their dependencies have failed. Using -k and --no-dep-failures together enables abuild to attempt to build everything that the backends will allow. Note that cascading errors (i.e., errors resulting from earlier errors) are likely when this option is used.

--platform-selector selector | -p selector

Specify a platform selector for object code platforms. This argument may be repeated any number of times. Later instances supersede earlier ones when they specify selection criteria for the same platform type. When two selectors refer to different platform types, both selectors are used. Platform selectors may also be given in the ABUILD_PLATFORM_SELECTION environment variable. For details on platform selectors, see Section 21.1, “Platform Selection”.

--silent

Suppress most non-error output. Also tells make and ant to generate less output.

--verbose

Generate more verbose output. Also tells make and ant to generate more output.