<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
                   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % entities.ent SYSTEM "entities.ent">
%entities.ent;
]>

<refentry id="mpm">

<?dbhh topicname="MIKTEXHELP_MPMCON" topicid="0"?>

<refmeta>
<refentrytitle>mpm</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">&PACKAGE_NAME;</refmiscinfo>
<refmiscinfo class="version">&miktexrev;</refmiscinfo>
<refmiscinfo class="manual">User Commands</refmiscinfo>
</refmeta>

<refnamediv>
<refname>mpm</refname>
<refpurpose>&MiKTeX; package manager</refpurpose>
</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>
&mpm;
<arg choice="opt" rep="repeat"><replaceable>option</replaceable></arg>
</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<para>&MPM; starts in windowed mode, if you do not specify any
command-line options.</para>

</refsect1>

<refsect1>
<title>User mode vs. administrator mode</title>

<para>This utility can be run in two modes:</para>

<variablelist>
<varlistentry>
<term>User mode (default)</term>
<listitem>
<para>&MPM; operates on the user installation directory (usually
&userinstalldir;).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Administrator mode</term>
<listitem>
<para>&MPM; operates on the system-wide installation directory
(usually &commoninstalldir;), assuming that the &MiKTeX; setup is
shared by all users.  &MPM; must be run with administrator
privileges.</para>
</listitem>
</varlistentry>
</variablelist>

<para>By default, &MPM; runs in user mode.  You can turn on
administrator mode with the <option>--admin</option> option.  For
example, if you want to install a package for all users, you invoke
&MPM; as follows:</para>

<screen><prompt>&prompt;</prompt><userinput>mpm --admin --install=a0poster</userinput></screen>
</refsect1>


<refsect1>

<title>Options</title>

<variablelist>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/admin.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/help.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/hhelp.xml" />
<varlistentry>
<term><option>--import=<replaceable>package</replaceable></option></term>
<listitem>
<indexterm>
<primary>--import=package</primary>
</indexterm>
<para>Import the specified package from another &MiKTeX; installation.
The root directory must be specified via
<option>--repository=<replaceable>dir</replaceable></option>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--import-all</option></term>
<listitem>
<indexterm>
<primary>--import-all</primary>
</indexterm>
<para>Import all packages from another &MiKTeX; installation.  The
root directory must be specified via
<option>--repository=<replaceable>dir</replaceable></option>.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>--pick-repository-url</option></term>
<listitem><para>Pick up a suitable &URL; from the package repository
list and print it.</para></listitem>
</varlistentry>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/quiet.xml" />
<varlistentry>
<term><option>--repository=<replaceable>location</replaceable></option></term>
<listitem><para>Use the specified location as the package repository.
The location can be either a fully qualified path name (a local
package repository) or an &URL; (a remote package repository).</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--repository-release-state=<replaceable>state</replaceable></option></term>
<listitem><para>Select the release state of the remote package
repository.  The release state is relevant for finding appropriate
package repositories. The release state must be one
of <option>stable</option> or <option>next</option>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--set-repository=<replaceable>location</replaceable></option></term>
<listitem>
<indexterm>
<primary>--set-repository=location</primary>
</indexterm>
<para>Store the location of the default package repository in the
&MiKTeX; configuration data store.  The location can be either a fully
qualified path name (a local package repository) or an &URL; (a remote
package repository).</para></listitem>
</varlistentry>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/trace.xml" />
<varlistentry>
<term><option>--verbose</option></term>
<indexterm>
<primary>--verbose</primary>
</indexterm>
<listitem><para>Turn on verbose output mode.</para></listitem>
</varlistentry>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../Options/version.xml" />
</variablelist>

</refsect1>

<refsect1>

<title>Environment</title>

<variablelist>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../EnvVars/MIKTEX_REPOSITORY.xml" />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../EnvVars/MIKTEX_TRACE.xml" />

<varlistentry><term><envar>http_proxy</envar></term>
<listitem><para>The proxy server to be used for
&HTTP;.</para></listitem>
</varlistentry>

<varlistentry><term><envar>FTP_PROXY</envar></term>
<listitem><para>The proxy server to be used for &FTP;.</para></listitem>
</varlistentry>

<varlistentry><term><envar>ALL_PROXY</envar></term>
<listitem><para>The proxy server to be used, if no protocol-specific proxy is
set.</para></listitem>
</varlistentry>

<varlistentry><term><envar>NO_PROXY</envar></term>
<listitem><para>Comma-separated list of host names that should not go
through any proxy.</para></listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title>See also</title>

<simplelist type="inline">
<member><citerefentry><refentrytitle>miktex</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
</simplelist>

</refsect1>

</refentry>
