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