makecfmaster - Master Applications

Syntax

makecfmaster [<command> [<option...>]]

makecfmaster archive -r <rpx-file>.rpx [-o <output-file-name>] [-w <work-directory>]
makecfmaster aoc <aoc-root-directory> <aoc-name>
makecfmaster patch [-p <most-recent-master-archive>.wumad] -r <rpx-file>.rpx [-o <output-file-name>] [-w <work-directory>] [-h]
makecfmaster installimage [-i <wumad-file>] [-o <output directory>] [-w <work-directory>] [-h]
makecfmaster disc [-i <wumad-file>] [-o <output-file>] [-w <work-directory>] [-h]

Options

The following table shows the possible commands.

archive Creates a master archive for an application.
patch Creates a patch.
aoc Creates downloadable (add-on) content.
disc Creates a master image (WUM).
installimage Creates an installation image for NAND.
help Displays help.

The following sections show the options that are available for each command.

makecfmaster archive

-r <rpx-file>.rpx Specifies the RPX file to use when creating the master archive.
-o <output-file-name> Specifies the name to use for the output master archive. If this option is omitted, the RPX filename is used.
-w <work-directory> Specifies the working directory to use for intermediate processing. If this option is omitted, a working directory is created in the current directory.
-u Adds a system update partition to the master archive.
-d Creates an install image after creating WUMAD files.
--zip Creates a ZIP archive of the install image after creating WUMAD files.
-h Displays help.

makecfmaster aoc

<aoc-root-directory> Specifies the root directory for downloadable content.
<aoc-name> Specifies the name of the downloadable content.
-h Displays help.

makecfmaster patch

-p <most-recent-master-archive> Specifies the master archive to base the patch on.
-r <rpx-file> Specifies the RPX file to use when creating the patch.
-o <output-file-name> Specifies the name to use for the output master archive. If this option is omitted, the following naming convention is used. patchYYMMDDhhmmss_<rpx-file>.wumad, where YYMMDDhhmmss is the current date and time.
-w <work-directory> Specifies the working directory to use for intermediate processing. If this option is omitted, a working directory is created in the current directory.
-d Creates an install image after creating WUMAD files.
--zip Creates a ZIP archive of the install image after creating WUMAD files.
-n Ignores the remaster version check process when creating patches. Do not specify this option in standard operations because it is reserved for special uses.
-e Expands the size of FST. Do not specify this option in standard operations because it is reserved for special uses.
-h Displays help.

makecfmaster installimage

-i <wumad-file> Specifies the WUMAD file to create an installation image for.
-o <output directory> Specifies the output directory for the installation image. If this option is omitted, $CAFE_ROOT/data/mlc/install is used by default.
-w <work-directory> Specifies the working directory to use for intermediate processing. If this option is omitted, a working directory is created in the current directory.
-h Displays help.

makecfmaster disc

-i <wumad-file> Specifies the WUMAD file to use when creating the master image (WUM file).
-o <output-file> Specifies the output directory for the master image. If this option is omitted, the file <wumad-file>.wum is used.
-w <work-directory> Specifies the working directory to use for intermediate processing. If this option is omitted, a working directory is created in the current directory.
-h Displays help.

Description

The makecfmaster command line tool is for mastering applications. As of the SDK 2.11.07, makecfmaster.sh and mastering-related features of cafex are no longer supported.

The makecfmaster tool supports the following features.

Requirements

Microsoft .NET

Microsoft .NET Framework 4.0 Client Profile is required to run makecfmaster.

Environment Variables

The following directories are set to their defaults based on CAFE_ROOT. No special action is required. In the development stage, change the following Windows environment variables to different directories as required from System Properties or in cafex_env.bat.

CAFE_CONTENT_DIR     %CAFE_ROOT%\data\disc\content
CAFE_SAVE_DIR        %CAFE_ROOT%\data\save
CAFE_SLC_DIR         %CAFE_ROOT%\data\slc
CAFE_MLC_DIR         %CAFE_ROOT%\data\mlc
CAFE_META_DIR        %CAFE_ROOT%\data\disc\meta
NOTE:
The tool fails to run when the following conditions apply to your environment variables.
  • CAFE_META_DIR includes a space.
  • CAFE_SLC_DIR is enclosed in quotation marks.

Command Migration Guide

The following table lists cafex commands and their corresponding makecfmaster commands.

cafex Command makecfmaster Command Command Description
cafex makemaster makecfmaster archive Creates a master archive.
cafex makemaster -p makecfmaster patch Creates a patch.
cafex makeaoc makecfmaster aoc Creates downloadable (add-on) content.
cafex makedisc makecfmaster disc Creates a master image.
cafex makedownload makecfmaster installimage Creates an installation image.

See Also

Master Applications Overview

Revision History

2015/05/14 Removed description of omitting -r option.
2014/09/25 Placed topic in canonical API format.
2014/07/08 Updated the overview: Mastering-related features of CafeX are no longer supported.
2014/05/20 Added a description of the -d and --zip options, and the list of commands.
2014/02/14 Initial version.


CONFIDENTIAL