Partager via


packageutil.exe

PackageUtil is used to retrieve the signing key information for a package file and to compare a base package file with an updated package file.

PackageUtil provides the following subcommands and functions:

Command

Description

packageutil license Retrieves information about the signing key used on the specified package
packageutil compare Compares two packages created by MakePkg.exe: a base package file and an updated package file
packageutil info Provides information about a package, including the version number, ContentID, ProductID, GameOS version, and Encryption Key IDs
packageutil chunkinfo Provides information about the chunks in a package, including the ID, chunk size, and specifiers
osinfoProvides information about a particular title's OS, including the GUID, edition number, and four-part version number

packageutil license

Retrieves information about the signing encryption key used on the specified package. The license command causes packageutil to output one of the following values:

  • Submission signed (/l) - only for submission to Partner Center
  • Test signed - (/lt) - sideload enabled; insecurely encrypted

Note

Currently, packageutil license will return /lk signed packages as /l signed.

packageutil license <packagefile> [<ekbfile>] [/?]

Option

Description

<packagefile> Specifies the package file to be examined.
<ekbfile> Optionally verifies that an EKB file is the correct EKB file associated with the package file. When you're submitting your package for certification, this test can be used to ensure you're providing the correct EKB file for the package being certified. If you specify an EKB file, packageutil will display "Matched Package and EKB" or "ERROR: Mismatched Package and EKB" in addition to the signing key information. The EKB file contains the encryption key material and is created along with the encrypted package when a package is being built with [makepkg /l or makepkg /1k](makepkg.md). If using makepkg /lk, do not attempt to use the CEKB or LEKB in this parameter.
/? Displays help text.

packageutil compare

PackageUtil compares two packages created by makepkg.exe: a base package file and an updated package file. Packages must be created by using the same ContentID, and both must be created with the /LK (recommended) encryption option, or the default encryption mode of makepkg.exe. Don't supply the /L command-line switch, as the results will not be accurate.

PackageUtil produces a report that includes a list of data that will be downloaded in order to update from the basepackagefile to the updatedpackagefile. The report uses the same algorithm that a retail console will use to perform the update. The report will list the percent of each file that will be downloaded and within each file the exact ranges of data that will be downloaded.

Finally, PackageUtil provides an estimate of the size of the download that will be performed when the console is updated from the base package to the update package. If the package uses Intelligent Delivery then this estimate is produced for a variety of scenarios of device type and language combinations.

packageutil compare <basepackagefile> <updatedpackagefile> [/?]

Option

Description

<basepackagefile> Specifies the base package file for the comparison
<updatedpackagefile> Specifies the updated package file for the comparison
/? Displays help text

packageutil info

Provides information about a package, including the version number, ContentID, ProductID, GameOS version, and Encryption Key IDs.

packageutil info <packagefile>

Option

Description

<packagefile> Specifies the package file to be examined

packageutil chunkinfo

Provides information about the chunks in a package, including the ID, chunk size, and specifiers.

packageutil chunkinfo <packagefile>

Option

Description

<packagefile> Specifies the package file to be examined

packageutil osinfo

Provides information about a particular title's OS, including the GUID, edition number, and four-part version number.

packageutil osinfo

See also

Deployment package schema

Make package resource index (makepri.exe)