NAME

       opam-upgrade - Upgrade the installed package to latest version.

SYNOPSIS

       opam upgrade [OPTION]... [PACKAGES]...

DESCRIPTION

       This command upgrades the installed packages to their latest available versions. More
       precisely, this command calls the dependency solver to find a consistent state where most
       of the installed packages are upgraded to their latest versions.

ARGUMENTS

       PACKAGES
           List of package names.

OPTIONS

       -b, --keep-build-dir
           Keep the build directory. This is equivalent to setting $OPAMKEEPBUILDIR to a
           non-empty string.

       --cudf=FILENAME
           Save the CUDF request sent to the solver to FILENAME-<n>.cudf.

       -d, --build-doc
           Build the package documentation. This is equivalent to setting $OPAMBUILDDOC to a
           non-empty string.

       --dry-run
           Simply call the solver without actually performing any build/install operations.

       -e TAGS, --external=TAGS
           Display the external packages associated to the given tags.

       --fake
           WARNING: This option is for testing purposes only! Using this option without care is
           the best way to corrupt your current compiler environment. When using this option OPAM
           will run a dry-run of the solver and then fake the build and install commands.

       -j JOBS, --jobs=JOBS
           Set the maximal number of concurrent jobs to use. You can also set it using the
           OPAMJOBS environment variable.

       --json=FILENAME
           Save the result output of an OPAM run in a computer-readable file

       -m MAKE, --make=MAKE
           Use MAKE as the default 'make' command.

       --no-checksums
           Do not verify the checksum of downloaded archives.This is equivalent to setting
           $OPAMNOCHECKSUMS to a non-empty string.

       -t, --build-test
           Build and run the package unit-tests. This is equivalent to setting $OPAMBUILDTEST to
           a non-empty string.

COMMON OPTIONS

       These options are common to all commands.

       --color=WHEN (absent=auto)
           Colorize the output. WHEN must be `always', `never' or `auto'.

       --compat-mode-1.0
           Compatibility mode with OPAM 1.0

       --debug
           Print debug message on stdout. This is equivalent to setting $OPAMDEBUG to a non-empty
           value.

       --git-version
           Print the git version if it exists and exit.

       --help[=FMT] (default=pager)
           Show this help in format FMT (pager, plain or groff).

       --no-aspcud
           Do not use the external aspcud solver, even if available.

       --no-base-packages
           Do not install base packages (useful for testing purposes). This is equivalent to
           setting $OPAMNOBASEPACKAGES to a non-empty string.

       -q, --quiet
           Be quiet when installing a new compiler.

       -r ROOT, --root=ROOT (absent=~/.opam)
           Use ROOT as the current root path. This is equivalent to setting $OPAMROOT to ROOT.

       --strict
           Fail whenever an error is found in a package definition or a configuration file. The
           default is to continue silently if possible.

       --switch=SWITCH
           Use SWITCH as the current compiler switch. This is equivalent to setting $OPAMSWITCH
           to SWITCH.

       -v, --verbose
           Be more verbose. This is equivalent to setting $OPAMVERBOSE to a non-empty value.

       --version
           Show version information.

       -y, --yes
           Disable interactive mode and answer yes to all questions that would otherwise be asked
           to the user. This is equivalent to setting $OPAMYES to a non-empty string.

ENVIRONMENT VARIABLES

       opam makes use of environment variables listed here.

       OPAMCOLOR, when set to always or never, sets a default value for the --color option

       OPAMCURL can be used to define an alternative for the 'curl' command-line utility to
       download files

FURTHER DOCUMENTATION

       See https://opam.ocaml.org.

AUTHORS

       Thomas Gazagnaire <thomas@gazagnaire.org>
       Anil Madhavapeddy <anil@recoil.org>
       Fabrice Le Fessant <Fabrice.Le_fessant@inria.fr>
       Frederic Tuong <tuong@users.gforge.inria.fr>
       Louis Gesbert <louis.gesbert@ocamlpro.com>
       Vincent Bernardoff <vb@luminar.eu.org>
       Guillem Rieu <guillem.rieu@ocamlpro.com>

BUGS

       Check bug reports at https://github.com/OCamlPro/opam/issues.