1dune-external-lib-deps(1) Dune Manual dune-external-lib-deps(1)
2
6 dune-external-lib-deps - Print out external libraries needed to build
7 the given targets.
8
10 dune external-lib-deps [OPTION]... TARGET...
11
13 Print out the external libraries needed to build the given targets.
14 The output of dune external-lib-deps @install should be included in
16 what is written in your <package>.opam file.
17
19 --build-info
20 Show build information.
21 -f, --force
23 Force actions associated to aliases to be re-executed even if their
24 dependencies haven't changed.
25 --help[=FMT] (default=auto)
27 Show this help in format FMT. The value FMT must be one of `auto',
28 `pager', `groff' or `plain'. With `auto', the format is `pager` or
29 `plain' whenever the TERM env var is `dumb' or undefined.
30 --missing
32 Only print out missing dependencies
33 --sandbox=VAL (absent DUNE_SANDBOX env)
35 Sandboxing mode to use by default. Some actions require a certain
36 sandboxing mode, so they will ignore this setting. The allowed
37 values are: none, symlink, copy.
38 --sexp
40 Produce a s-expression output
41 --unstable-by-dir
43 Print dependencies per directory (this feature is currently
44 unstable)
45 --version
47 Show version information.
48 -w, --watch
50 Instead of terminating build after completion, wait continuously
51 for file changes.
52
54 These options are common to all commands.
55 --always-show-command-line
57 Always show the full command lines of programs executed by dune
58 --auto-promote
60 Automatically promote files. This is similar to running dune
61 promote after the build.
62 --build-dir=FILE (absent DUNE_BUILD_DIR env)
64 Specified build directory. _build if unspecified
65 --cache=VAL (absent DUNE_CACHE env)
67 Activate binary cache (either `disabled' or `enabled'). Default is
68 `disabled'.
69 --cache-check-probability=VAL (absent=0. or
71 DUNE_CACHE_CHECK_PROBABILITY env)
72 Probability cached rules are rerun to check for reproducibility
73 --cache-duplication=VAL (absent DUNE_CACHE_DUPLICATION env)
75 Binary cache duplication mode
76 --cache-transport=VAL (absent DUNE_CACHE_TRANSPORT env)
78 Binary cache protocol
79 --config-file=FILE
81 Load this configuration file instead of the default one.
82 --debug-backtraces
84 Always print exception backtraces.
85 --debug-dependency-path
87 In case of error, print the dependency path from the targets on the
88 command line to the rule that failed.
89 --debug-findlib
91 Debug the findlib sub-system.
92 --default-target=TARGET (absent=@@default)
94 Set the default target that when none is specified to dune build.
95 --diff-command=VAL
97 Shell command to use to diff files. Use - to disable printing the
98 diff.
99 --disable-promotion (absent DUNE_DISABLE_PROMOTION env)
101 Disable all promotion rules
102 --display=MODE
104 Control the display mode of Dune. See dune-config(5) for more
105 details.
106 --ignore-promoted-rules
108 Ignore rules with (mode promote), except ones with (only ...). The
109 variable %{ignoring_promoted_rules} in dune files reflects whether
110 this option was passed or not.
111 -j JOBS
113 Run no more than JOBS commands simultaneously.
114 --no-buffer
116 Do not buffer the output of commands executed by dune. By default
117 dune buffers the output of subcommands, in order to prevent
118 interleaving when multiple commands are executed in parallel.
119 However, this can be an issue when debugging long running tests.
120 With --no-buffer, commands have direct access to the terminal. Note
121 that as a result their output won't be captured in the log file.
122 You should use this option in conjunction with -j 1, to avoid
123 interleaving. Additionally you should use --verbose as well, to
124 make sure that commands are printed before they are being executed.
125 --no-config
127 Do not load the configuration file
128 --no-print-directory
130 Suppress "Entering directory" messages
131 --only-packages=PACKAGES
133 Ignore stanzas referring to a package that is not in PACKAGES.
134 PACKAGES is a comma-separated list of package names. Note that this
135 has the same effect as deleting the relevant stanzas from dune
136 files. It is mostly meant for releases. During development, it is
137 likely that what you want instead is to build a particular
138 <package>.install target.
139 -p PACKAGES, --for-release-of-packages=PACKAGES
141 Shorthand for --release --only-packages PACKAGE. You must use this
142 option in your <package>.opam files, in order to build only what's
143 necessary when your project contains multiple packages as well as
144 getting reproducible builds.
145 --profile=VAL (absent DUNE_PROFILE env)
147 Select the build profile, for instance dev or release. The default
148 is dev.
149 --promote-install-files
151 Promote the generated <package>.install files to the source tree
152 --release
154 Put dune into a reproducible release mode. This is in fact a
155 shorthand for --root . --ignore-promoted-rules --no-config
156 --profile release --always-show-command-line
157 --promote-install-files --default-target @install. You should use
158 this option for release builds. For instance, you must use this
159 option in your <package>.opam files. Except if you already use -p,
160 as -p implies this option.
161 --root=DIR
163 Use this directory as workspace root instead of guessing it. Note
164 that this option doesn't change the interpretation of targets given
165 on the command line. It is only intended for scripts.
166 --store-orig-source-dir (absent DUNE_STORE_ORIG_SOURCE_DIR env)
168 Store original source location in dune-package metadata
169 --terminal-persistence=MODE
171 Changes how the log of build results are displayed to the console
172 between rebuilds while in --watch mode.
173 --trace-file=FILE
175 Output trace data in catapult format (compatible with
176 chrome://tracing)
177 --verbose
179 Same as --display verbose
180 --workspace=FILE (absent DUNE_WORKSPACE env)
182 Use this specific workspace file instead of looking it up.
183 -x VAL
185 Cross-compile using this toolchain.
186
188 Use `dune COMMAND --help' for help on a single command.
189
191 These environment variables affect the execution of external-lib-deps:
192 DUNE_BUILD_DIR
194 Specified build directory. _build if unspecified
195 DUNE_CACHE
197 Activate binary cache (either `disabled' or `enabled'). Default is
198 `disabled'.
199 DUNE_CACHE_CHECK_PROBABILITY
201 Probability cached rules are rerun to check for reproducibility
202 DUNE_CACHE_DUPLICATION
204 Binary cache duplication mode
205 DUNE_CACHE_TRANSPORT
207 Binary cache protocol
208 DUNE_DISABLE_PROMOTION
210 Disable all promotion rules
211 DUNE_PROFILE
213 Build profile. dev if unspecified or release if -p is set.
214 DUNE_SANDBOX
216 Sandboxing mode to use by default. (see --sandbox)
217 DUNE_STORE_ORIG_SOURCE_DIR
219 Store original source location in dune-package metadata
220 DUNE_WORKSPACE
222 Use this specific workspace file instead of looking it up.
223
225 Check bug reports at https://github.com/ocaml/dune/issues
226Dune n/a dune-external-lib-deps(1)