1OPAM ADMIN-ADD-HASHES(1) Opam admin Manual OPAM ADMIN-ADD-HASHES(1)
2
6 opam admin-add-hashes - Add archive hashes to an opam repository.
7
9 opam admin add-hashes [OPTION]... HASH_ALGO...
10
12 This command scans through package definitions, and add hashes as
13 requested (fetching the archives if required). A cache is generated in
14 /builddir/.cache/opam-hash-cache for subsequent runs.
15
17 HASH_ALGO (required)
18 The hash, or hashes to be added
19
21 --replace
22 Replace the existing hashes rather than adding to them
23
25 These options are common to all commands.
26 --best-effort
28 Don't fail if all requested packages can't be installed: try to
29 install as many as possible. Note that not all external solvers may
30 support this option (recent versions of aspcud or mccs should).
31 This is equivalent to setting $OPAMBESTEFFORT environment variable.
32 --color=WHEN
34 Colorize the output. WHEN must be one of `always', `never' or
35 `auto'.
36 --criteria=CRITERIA
38 Specify user preferences for dependency solving for this run.
39 Overrides both $OPAMCRITERIA and $OPAMUPGRADECRITERIA. For details
40 on the supported language, and the external solvers available, see
41 http://opam.ocaml.org/doc/External_solvers.html. A general guide to
42 using solver preferences can be found at
43 http://www.dicosmo.org/Articles/usercriteria.pdf.
44 --cudf=FILENAME
46 Debug option: Save the CUDF requests sent to the solver to
47 FILENAME-<n>.cudf.
48 --debug
50 Print debug message to stderr. This is equivalent to setting
51 $OPAMDEBUG to "true".
52 --debug-level=LEVEL
54 Like --debug, but allows specifying the debug level (--debug sets
55 it to 1). Equivalent to setting $OPAMDEBUG to a positive integer.
56 --git-version
58 Print the git version of opam, if set (i.e. you are using a
59 development version), and exit.
60 --help[=FMT] (default=auto)
62 Show this help in format FMT. The value FMT must be one of `auto',
63 `pager', `groff' or `plain'. With `auto', the format is `pager` or
64 `plain' whenever the TERM env var is `dumb' or undefined.
65 --ignore-pin-depends
67 Ignore extra pins required by packages that get pinned, either
68 manually through opam pin or through opam install DIR. This is
69 equivalent to setting IGNOREPINDEPENDS=true.
70 --json=FILENAME
72 Save the results of the opam run in a computer-readable file. If
73 the filename contains the character `%', it will be replaced by an
74 index that doesn't overwrite an existing file. Similar to setting
75 the $OPAMJSON variable.
76 --no-aspcud
78 Deprecated.
79 --no-auto-upgrade
81 When configuring or updating a repository that is written for an
82 earlier opam version (1.2), opam internally converts it to the
83 current format. This disables this behaviour. Note that
84 repositories should define their format version in a 'repo' file at
85 their root, or they will be assumed to be in the older format. It
86 is, in any case, preferable to upgrade the repositories manually
87 using opam admin upgrade [--mirror URL] when possible.
88 -q, --quiet
90 Disables --verbose.
91 --root=ROOT
93 Use ROOT as the current root path. This is equivalent to setting
94 $OPAMROOT to ROOT.
95 --safe, --readonly
97 Make sure nothing will be automatically updated or rewritten.
98 Useful for calling from completion scripts, for example. Will fail
99 whenever such an operation is needed ; also avoids waiting for
100 locks, skips interactive questions and overrides the $OPAMDEBUG
101 variable. This is equivalent to set environment variable $OPAMSAFE.
102 --solver=CMD
104 Specify the CUDF solver to use for resolving package installation
105 problems. This is either a predefined solver (this version of opam
106 supports builtin-mccs+lp(), builtin-mccs+glpk, aspcud, mccs,
107 aspcud-old, packup), or a custom command that should contain the
108 variables %{input}%, %{output}%, %{criteria}%, and optionally
109 %{timeout}%. This is equivalent to setting $OPAMEXTERNALSOLVER.
110 --strict
112 Fail whenever an error is found in a package definition or a
113 configuration file. The default is to continue silently if
114 possible.
115 --switch=SWITCH
117 Use SWITCH as the current compiler switch. This is equivalent to
118 setting $OPAMSWITCH to SWITCH.
119 --use-internal-solver
121 Disable any external solver, and use the built-in one (this
122 requires that opam has been compiled with a built-in solver). This
123 is equivalent to setting $OPAMNOASPCUD or $OPAMUSEINTERNALSOLVER.
124 -v, --verbose
126 Be more verbose. One -v shows all package commands, repeat to also
127 display commands called internally (e.g. tar, curl, patch etc.)
128 Repeating n times is equivalent to setting $OPAMVERBOSE to "n".
129 --version
131 Show version information.
132 -w, --working-dir
134 Whenever updating packages that are bound to a local,
135 version-controlled directory, update to the current working state
136 of their source instead of the last committed state, or the ref
137 they are pointing to. This only affects packages explicitly listed
138 on the command-line.It can also be set with $OPAMWORKINGDIR.
139 -y, --yes
141 Answer yes to all yes/no questions without prompting. This is
142 equivalent to setting $OPAMYES to "true".
143
145 Opam makes use of the environment variables listed here. Boolean
146 variables should be set to "0", "no", "false" or the empty string to
147 disable, "1", "yes" or "true" to enable.
148 OPAMALLPARENS surround all filters with parenthesis
150 OPAMAUTOREMOVE see remove option `--auto-remove`
152 OPAMBESTEFFORT see option `--best-effort`
154 OPAMBESTEFFORTPREFIXCRITERIA sets the string that must be prepended to
156 the criteria when the `--best-effort` option is set, and is expected to
157 maximise the `opam-query` property in the solution
158 OPAMCOLOR, when set to always or never, sets a default value for the
160 --color option.
161 OPAMCRITERIA specifies user preferences for dependency solving. The
163 default value depends on the solver version, use `config report` to
164 know the current setting. See also option --criteria
165 OPAMCUDFFILE file save the cudf graph to file-actions-explicit.dot
167 OPAMCURL can be used to select a given 'curl' program. See OPAMFETCH
169 for more options.
170 OPAMDEBUG see options `--debug' and `--debug-level'.
172 OPAMDOWNLOADJOBS sets the maximum number of simultaneous downloads.
174 OPAMDRYRUN see option `--dry-run`
176 OPAMEDITOR sets the editor to use for opam file editing, overrides
178 $EDITOR and $VISUAL
179 OPAMERRLOGLEN sets the number of log lines printed when a sub-process
181 fails. 0 to print all.
182 OPAMEXTERNALSOLVER see option `--solver'.
184 OPAMFAKE see option `--fake`
186 OPAMFETCH specifies how to download files: either `wget', `curl' or a
188 custom command where variables %{url}%, %{out}%, %{retry}%,
189 %{compress}% and %{checksum}% will be replaced. Overrides the
190 'download-command' value from the main config file.
191 OPAMFIXUPCRITERIA same as OPAMUPGRADECRITERIA, but specific to fixup
193 OPAMIGNORECONSTRAINTS see install option `--ignore-constraints-on`
195 OPAMIGNOREPINDEPENDS see option `--ignore-pin-depends`
197 OPAMJOBS sets the maximum number of parallel workers to run.
199 OPAMJSON log json output to the given file (use character `%' to index
201 the files)
202 OPAMLOCKED see install option `--locked`
204 OPAMLOGS logdir sets log directory, default is a temporary directory in
206 /tmp
207 OPAMMAKECMD set the system make command to use
209 OPAMNOAUTOUPGRADE disables automatic internal upgrade of repositories
211 in an earlier format to the current one, on 'update' or 'init'.
212 OPAMKEEPLOGS tells opam to not remove some temporary command logs and
214 some backups. This skips some finalisers and may also help to get more
215 reliable backtraces
216 OPAMLOCKRETRIES sets the number of tries after which opam gives up
218 acquiring its lock and fails. <= 0 means infinite wait.
219 OPAMMERGEOUT merge process outputs, stderr on stdout
221 OPAMNO answer no to any question asked.
223 OPAMNOASPCUD Deprecated.
225 OPAMNOCHECKSUMS enables option --no-checksums when available.
227 OPAMNOSELFUPGRADE see option `--no-self-upgrade'.
229 OPAMPINKINDAUTO sets whether version control systems should be detected
231 when pinning to a local path. Enabled by default since 1.3.0.
232 OPAMPRECISETRACKING fine grain tracking of directories
234 OPAMREQUIRECHECKSUMS Enables option `--require-checksums' when
236 available (e.g. for `opam install`).
237 OPAMRETRES sets the number of tries before failing downloads.
239 OPAMROOT see option `--root'. This is automatically set by `opam env
241 --root=DIR --set-root'.
242 OPAMROOTISOK don't complain when running as root.
244 OPAMSAFE see option `--safe'
246 OPAMSHOW see option `--show`
248 OPAMSKIPUPDATE see option `--skip-updates`
250 OPAMSKIPVERSIONCHECKS bypasses some version checks. Unsafe, for
252 compatibility testing only.
253 OPAMSOLVERTIMEOUT change the time allowance of the solver. Default is
255 60.0, set to 0 for unlimited. Note that all solvers may not support
256 this option.
257 OPAMSTATUSLINE display a dynamic status line showing what's currently
259 going on on the terminal. (one of one of `always', `never' or `auto')
260 OPAMSTATS display stats at the end of command
262 OPAMSTRICT fail on inconsistencies (file reading, switch import, etc.)
264 OPAMSWITCH see option `--switch'. Automatically set by `opam env
266 --switch=SWITCH --set-switch'.
267 OPAMUNLOCKBASE see install option `--unlock-base`
269 OPAMUPGRADECRITERIA specifies user preferences for dependency solving
271 when performing an upgrade. Overrides OPAMCRITERIA in upgrades if both
272 are set. See also option --criteria
273 OPAMUSEINTERNALSOLVER see option `--use-internal-solver'.
275 OPAMUSEOPENSSL force openssl use for hash computing
277 OPAMUTF8 use UTF8 characters in output (one of one of `always', `never'
279 or `auto'). By default `auto', which is determined from the locale).
280 OPAMUTF8MSGS use extended UTF8 characters (camels) in opam messages.
282 Implies OPAMUTF8. This is set by default on OSX only.
283 OPAMVALIDATIONHOOK hook if set, uses the `%{hook%}` command to validate
285 an opam repository update
286 OPAMVAR_var overrides the contents of the variable var when
288 substituting `%{var}%` strings in `opam` files.
289 OPAMVAR_package_var overrides the contents of the variable package:var
291 when substituting `%{package:var}%` strings in `opam` files.
292 OPAMVERBOSE see option `--verbose'.
294 OPAMWORKINGDIR see option `--working-dir`
296 OPAMYES see option `--yes'.
298
300 As an exception to the following, the `exec' command returns 127 if the
301 command was not found or couldn't be executed, and the command's exit
302 value otherwise.
303 0 Success, or true for boolean queries.
305 1 False. Returned when a boolean return value is expected, e.g. when
307 running with --check, or for queries like opam lint.
308 2 Bad command-line arguments, or command-line arguments pointing to
310 an invalid context (e.g. file not following the expected format).
311 5 Not found. You requested something (package, version, repository,
313 etc.) that couldn't be found.
314 10 Aborted. The operation required confirmation, which wasn't given.
316 15 Could not acquire the locks required for the operation.
318 20 There is no solution to the user request. This can be caused by
320 asking to install two incompatible packages, for example.
321 30 Error in package definition, or other metadata files. Using
323 --strict raises this error more often.
324 31 Package script error. Some package operations were unsuccessful.
326 This may be an error in the packages or an incompatibility with
327 your system. This can be a partial error.
328 40 Sync error. Could not fetch some remotes from the network. This can
330 be a partial error.
331 50 Configuration error. Opam or system configuration doesn't allow
333 operation, and needs fixing.
334 60 Solver failure. The solver failed to return a sound answer. It can
336 be due to a broken external solver, or an error in solver
337 configuration.
338 99 Internal error. Something went wrong, likely due to a bug in opam
340 itself.
341 130 User interrupt. SIGINT was received, generally due to the user
343 pressing Ctrl-C.
344
346 See https://opam.ocaml.org/doc.
347
349 Vincent Bernardoff <vb@luminar.eu.org>
350 Raja Boujbel <raja.boujbel@ocamlpro.com>
351 Roberto Di Cosmo <roberto@dicosmo.org>
352 Thomas Gazagnaire <thomas@gazagnaire.org>
353 Louis Gesbert <louis.gesbert@ocamlpro.com>
354 Fabrice Le Fessant <Fabrice.Le_fessant@inria.fr>
355 Anil Madhavapeddy <anil@recoil.org>
356 Guillem Rieu <guillem.rieu@ocamlpro.com>
357 Ralf Treinen <ralf.treinen@pps.jussieu.fr>
358 Frederic Tuong <tuong@users.gforge.inria.fr>
359
361 Check bug reports at https://github.com/ocaml/opam/issues.
362Opam admin 2.0.6 OPAM ADMIN-ADD-HASHES(1)