Name

initexmf — MiKTeX configuration utility

Synopsis

initexmf [option...]

Description

initexmf is used to configure MiKTeX.

User mode vs. administrative mode

This utility can be run in two modes:

User mode (default)

MiKTeX operates on user-scoped configuration and data files.

Administrative mode

Only system-wide MiKTeX configuration and data files are modified, assuming that the MiKTeX setup is shared by all users. The utility must be run with administrator privileges.

By default, the utility runs in user mode. You can turn on administrative mode with the --admin option. For example, if you want to update the system-wide file name database, you invoke the utility as follows:

C:> initexmf --admin --update-fndb

Options

--admin

Run in administrative mode:

  • Operate on the system-wide MiKTeX configuration data store.

  • Install packages for all users.

Using this option requires a shared MiKTeX setup, i.e., MiKTeX must have been set up for all users. The program must be run with administrator privileges.

--disable-installer

Disable automatic installation of packages. Specifying this option overrules settings in the MiKTeX configuration data store.

--dump

Create all memory dump files.

--dump=name

Dump the specified memory dump file.

--edit-config-file=configfile

Open the specified config file in a text editor.

--enable-installer

Enable automatic installation of packages. Specifying this option overrules settings in the MiKTeX configuration data store.

--engine=engine

Engine to be used when generating format files.

--force

Force --mklinks to overwrite existing executables.

--list-formats

List all known formats.

--list-modes

List all known METAFONT modes.

--mklinks

Create an executable for each known format.

--mkmaps

Build the font map files.

--print-only

Print what would be done. Nothing is changed.

--quiet

Suppress screen output.

--register-root=dir

Register a TEXMF root directory.

--report

Write a MiKTeX configuration report.

--unregister-root=dir

Unregister a TEXMF root directory.

--update-fndb

Refresh the whole file name database.

--update-fndb=dir

Refresh the file name database for a specific TEXMF tree.

--user-roots=directories

Register user root directories.

--verbose

Print information on what is being done.

--version

Print the version number and exit.