Catalog Manager Technical Reference (Standard 8)

7/8/2014

Review the use, syntax, location, options, and parameters for the Catalog Manager (Catman.exe) tool in Windows Embedded 8 Standard (Standard 8).

In Windows Embedded 8 Standard (Standard 8), the catalog is a collection of modules and Component Based Servicing Package (CBS Package). Catalog Manager (Catman.exe) is a command-line tool you can use to maintain your Standard 8 catalog.

The file Catman.exe can be run on Windows 7 Service Pack 1 (Windows 7 SP1), Windows 8, or Windows Embedded 8 Standard (Standard 8). Catman.exe can be used to perform the following functions:

  • Import a .wim file, module or CBS Package into a catalog.
    • A CBS Package typically exists as either a .CAB or .MSU file.
    • A module has an .EMD extension.
  • Rebuild a catalog index file.
    • Rebuilding the index file of a catalog can be useful in maintaining the catalog.
    • Rebuilding the index file of a catalog is also one way you can indirectly remove a module or a CBS Package from a catalog.

Important

/enumerate is not currently implemented.

Catman.exe will return an HRESULT code if an error occurs, otherwise the number of items imported will be returned.

Syntax

catman.exe
    [/quiet]
    [/import | /remove | /enumerate | /rebuildindex | /h | /?]
    /import
        {<source_file> | <source_directory>}
        <catalog_file>
        [/allowoverwrite]
        [/transaction]
    /rebuildindex
        <catalog_file>

Location

In a typical installation of Standard 8, Catman.exe can be found at the following location:

%PROGRAMFILES%\Windows Embedded 8 Standard\Toolset\Embedded Tools

Command-Line Options

Option

Description

/quiet

Suppresses console output.

/import

Adds a single file or all importable files under a specified directory to the catalog.

The /allowoverwrite option overwrites items if they already exist during import. If not used, items already present in the catalog are skipped.

The /transaction option prevents changes to the catalog if any items fail during import.

/remove

Removes a single module from the catalog.

/rebuildindex

Rebuilds the catalog index file. This is usually only required when an index is corrupt or missing.

/h | /?

Displays command-line help.

See Also

Other Resources

Tools Technical Reference