dunecontrol - Online in the Cloud

PROGRAM:

NAME

dunecontrol - Control program for the Dune build system

SYNOPSIS

dunecontrol [OPTIONS] COMMANDS [COMMAND-OPTIONS]

DESCRIPTION

dunecontrol is the control program for the build system of the Dune libraries.

The Dune libraries form a set of modules. Each can be built independently using either
the AutoTools or cmake. Additionally, though, there are dependencies between modules,
which are expected to form a directed acyclic graph. These dependencies are set in a file
called dune.module contained in the main directory of a Dune module.

The dunecontrol program helps to build sets of inter-dependent modules. It allows one to
construct the entire dependency graph and obtain information about it. Then it allows one
to give various build-related commands for all modules. These are executed in the order
mandated by the dependency graph.

COMMANDS

Colon-separated list of commands. Available commands are:

help

Shows a help message and exits

print

Print the list of modules sorted after their dependencies

info

Same as `print', but including whether it is a dependency or suggestion

printdeps

Print recursive dependencies of a module

vcsetup

Setup version control repository (Git etc.) or working copy (SVN)

update

Update all modules from the repository

autogen

Run the autogen.sh script for each module. Does nothing, if CMake is activated

configure

Run configure or cmake for each module

make

Run make for each module

all

Run the 'autogen', 'configure' and 'make' commands for each module

exec

Execute an arbitrary command in each module source directory

bexec

Execute an arbitrary command in each module build directory

status

Show version control status for all modules

svn

Run svn command for each svn managed module

git

Run git command for each git managed module

export

Run eval `dunecontrol export` to save the list of dune.module files to the
DUNE_CONTROL_PATH variable

OPTIONS

-h, --help

Show this help

--debug

Run with debugging output enabled

--use-cmake

Use cmake instead of the AutoTools for building individual modules

--no-cmake

Use the AutoTools instead of cmake for building individual modules

--module=mod

Apply the actions on module mod and all modules it depends on

--only=mod

Only apply the actions on module mod , but not the modules it depends on

--current

Only apply the actions on the current module, the one whose source tree we are in

--current-dep

Apply the actions on the current module, and all modules it depends on

--resume

Resume a previous run (only consider the modules not built successfully on the
previous run)

--skipfirst

Skip the first module (use with --resume)

--opts=file

Load default options from file (see dune-common/doc/example.opts)

--builddir=name

Make out-of-source builds in a subdir name. This directory is created inside each
module.

--[COMMAND]-opts=opts

Set options for COMMAND (this is mainly useful for the 'all' COMMAND)

ENVIRONMENT VARIABLES

dunecontrol looks for Dune modules in all directories given in the DUNE_CONTROL_PATH
variable, and additionally recursively in all subdirectories of those directories. The
default for the case that DUNE_CONTROL_PATH is empty is the current directory, plus a
system-wide installation in /usr.

Use dunecontrol online using onworks.net services