Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
dune-exec(1)			  Dune Manual			  dune-exec(1)

       dune-exec - Execute a command in	a similar environment as if
       installation was	performed.

       dune exec [OPTION]... PROG [ARGS]...

       dune exec -- COMMAND should behave in the same way as if	you do:

	 $ dune	install

       In particular if	you run	dune exec ocaml, you will have access to the
       libraries defined in the	workspace using	your usual directives
       (#require for instance)

       When a leading /	is present in the command (absolute path), then	the
       path is interpreted as an absolute path

       When a /	is present at any other	position (relative path), then the
       path is interpreted as relative to the build context + current working
       directory (or the value of --root when ran outside of the project root)

       --context=CONTEXT (absent=default)
	   Run the command in this build context.

       -f, --force
	   Force actions associated to aliases to be re-executed even if their
	   dependencies	haven't	changed.

       --help[=FMT] (default=auto)
	   Show	this help in format FMT. The value FMT must be one of `auto',
	   `pager', `groff' or `plain'.	With `auto', the format	is `pager` or
	   `plain' whenever the	TERM env var is	`dumb' or undefined.

	   don't rebuild target	before executing

	   Show	version	information.

       -w, --watch
	   Instead of terminating build	after completion, wait continuously
	   for file changes.

       These options are common	to all commands.

	   Always show the full	command	lines of programs executed by dune

	   Automatically promote files.	This is	similar	to running dune
	   promote after the build.

       --build-dir=FILE	(absent	DUNE_BUILD_DIR env)
	   Specified build directory. _build if	unspecified

	   Load	this configuration file	instead	of the default one.

	   Always print	exception backtraces.

	   In case of error, print the dependency path from the	targets	on the
	   command line	to the rule that failed.

	   Debug the findlib sub-system.

	   Set the default target that when none is specified to dune build.
	   It defaults to @@default.

	   Same	as --profile dev

	   Shell command to use	to diff	files. Use - to	disable	printing the

	   Control the display mode of Dune. See dune-config(5)	for more

	   Ignore rules	with (mode promote), except ones with (only ...)

       -j JOBS
	   Run no more than JOBS commands simultaneously.

	   Do not buffer the output of commands	executed by dune. By default
	   dune	buffers	the output of subcommands, in order to prevent
	   interleaving	when multiple commands are executed in parallel.
	   However, this can be	an issue when debugging	long running tests.
	   With	--no-buffer, commands have direct access to the	terminal. Note
	   that	as a result their output won't be captured in the log file.
	   You should use this option in conjunction with -j 1,	to avoid
	   interleaving. Additionally you should use --verbose as well,	to
	   make	sure that commands are printed before they are being executed.

	   Do not load the configuration file

	   Suppress "Entering directory" messages

	   Ignore stanzas referring to a package that is not in	PACKAGES.
	   PACKAGES is a comma-separated list of package names.	Note that this
	   has the same	effect as deleting the relevant	stanzas	from jbuild
	   files. It is	mostly meant for releases. During development, it is
	   likely that what you	want instead is	to build a particular
	   <package>.install target.

       -p PACKAGES, --for-release-of-packages=PACKAGES
	   Shorthand for --root	. --only-packages PACKAGE
	   --ignore-promoted-rules --no-config --profile release. You must use
	   this	option in your _package_.opam files, in	order to build only
	   what's necessary when your project contains multiple	packages as
	   well	as getting reproducible	builds.

       --profile=VAL (absent DUNE_PROFILE env)
	   Select the build profile, for instance dev or release. The default
	   is dev.

	   Use this directory as workspace root	instead	of guessing it.	Note
	   that	this option doesn't change the interpretation of targets given
	   on the command line.	It is only intended for	scripts.

       --store-orig-source-dir (absent DUNE_STORE_ORIG_SOURCE_DIR env)
	   Store original source location in dune-package metadata

	   Output trace	data in	catapult format	(compatible with

	   Same	as --display verbose

       --workspace=FILE	(absent	DUNE_WORKSPACE env)
	   Use this specific workspace file instead of looking it up.

       -x VAL
	   Cross-compile using this toolchain.

       Use `dune COMMAND --help' for help on a single command.

       These environment variables affect the execution	of exec:

	   Specified build directory. _build if	unspecified

	   Build profile. dev if unspecified or	release	if -p is set.

	   Store original source location in dune-package metadata

	   Use this specific workspace file instead of looking it up.

       Check bug reports at

Dune 11VERSION11						  dune-exec(1)


Want to link to this manual page? Use this URL:

home | help