.\" Pipe this output to groff -man -Tutf8 | less
.\"
.TH "OPAM-REMOTE" 1 "" "Opam 1.2.2" "Opam Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH NAME
.P
opam\-remote \- An alias for \fBrepository\fR.
.SH SYNOPSIS
.P
\fBopam remote\fR [\fIOPTION\fR]... [\fICOMMAND\fR] [\fIARG\fR]...
.SH DESCRIPTION
.P
\fBopam remote\fR is an alias for \fBopam repository\fR.
.P
See \fBopam repository \-\-help\fR for details.
.SH COMMON OPTIONS
.TP 4
\fB\-\-color\fR=\fIWHEN\fR (absent=auto)
Colorize the output. \fIWHEN\fR must be one of `always', `never' or `auto'.
.TP 4
\fB\-\-criteria\fR=\fICRITERIA\fR
Specify user \fIpreferences\fR for dependency solving for this run. Overrides both \fB$OPAMCRITERIA\fR and \fB$OPAMUPGRADECRITERIA\fR. For details on the supported language, and the external solvers available, see \fI http://opam.ocaml.org/doc/Specifying_Solver_Preferences.html\fR. A general guide to using solver preferences can be found at \fI http://www.dicosmo.org/Articles/usercriteria.pdf\fR. The default value is \-count(down),\-count(removed),\-notuptodate(solution),\-sum(solution,version\-lag),\-count(new) for upgrades, and \-count(removed),\-notuptodate(request),\-sum(request,version\-lag),\-count(down),\-notuptodate(changed),\-count(changed),\-notuptodate(solution),\-sum(solution,version\-lag) otherwise.
.TP 4
\fB\-\-cudf\fR=\fIFILENAME\fR
Debug option: Save the CUDF requests sent to the solver to \fIFILENAME\fR\-<n>.cudf.
.TP 4
\fB\-\-debug\fR
Print debug message to stderr. This is equivalent to setting \fB$OPAMDEBUG\fR to "true".
.TP 4
\fB\-\-debug\-level\fR=\fILEVEL\fR
Like `\-\-debug', but allows specifying the debug level (`\-\-debug' sets it to 1). Equivalent to setting \fB$OPAMDEBUG\fR to a positive integer.
.TP 4
\fB\-\-git\-version\fR
Print the git version if it exists and exit.
.TP 4
\fB\-\-no\-base\-packages\fR
Do not install base packages (useful for testing purposes). This is equivalent to setting \fB$OPAMNOBASEPACKAGES\fR to a non\-empty string.
.TP 4
\fB\-\-no\-self\-upgrade\fR
OPAM will replace itself with a newer binary found at \fBOPAMROOT/opam\fR if present. This disables this behaviour.
.TP 4
\fB\-q\fR, \fB\-\-quiet\fR
Be quiet when installing a new compiler.
.TP 4
\fB\-\-root\fR=\fIROOT\fR (absent=~/.opam)
Use \fIROOT\fR as the current root path. This is equivalent to setting \fB$OPAMROOT\fR to \fIROOT\fR.
.TP 4
\fB\-\-safe\fR
Make sure nothing will be automatically updated or rewritten. Useful for calling from completion scripts, for example. Will fail whenever such an operation is needed ; also avoids waiting for locks, skips interactive questions and overrides the OPAMDEBUG variable.
.TP 4
\fB\-\-solver\fR=\fICMD\fR
Specify the name of the external dependency \fIsolver\fR. The default value is aspcud. Either 'aspcud', 'packup' or a custom command that may contain the variables %{input}%, %{output}% and %{criteria}%
.TP 4
\fB\-\-strict\fR
Fail whenever an error is found in a package definition or a configuration file. The default is to continue silently if possible.
.TP 4
\fB\-\-switch\fR=\fISWITCH\fR
Use \fISWITCH\fR as the current compiler switch. This is equivalent to setting \fB$OPAMSWITCH\fR to \fISWITCH\fR.
.TP 4
\fB\-\-use\-internal\-solver\fR, \fB\-\-no\-aspcud\fR
Force use of internal heuristics, even if an external solver is available.
.TP 4
\fB\-v\fR, \fB\-\-verbose\fR
Be more verbose, show package sub\-commands and their output. Repeat to see more. Repeating \fIn\fR times is equivalent to setting \fB$OPAMVERBOSE\fR to "\fIn\fR".
.TP 4
\fB\-y\fR, \fB\-\-yes\fR
Disable interactive mode and answer yes to all questions that would otherwise be asked to the user. This is equivalent to setting \fB$OPAMYES\fR to "true".
.SH OPTIONS
.TP 4
\fB\-\-help\fR[=\fIFMT\fR] (default=pager)
Show this help in format \fIFMT\fR (pager, plain or groff).
.TP 4
\fB\-k\fR \fIKIND\fR, \fB\-\-kind\fR=\fIKIND\fR
Specify the kind of the repository to be used (one of `http', `local', `git', `darcs' or `hg').
.TP 4
\fB\-p\fR \fIINT\fR, \fB\-\-priority\fR=\fIINT\fR
Set the repository priority (bigger is better)
.TP 4
\fB\-s\fR, \fB\-\-short\fR
Output raw lists of names, one per line, skipping any details.
.TP 4
\fB\-\-version\fR
Show version information.