p4 unzip

Synopsis

Import files from a p4 zip package file.

Syntax

p4 [g-opts] unzip -i zipfile [-Ox] [-f -n -A -I -v --enable-dvcs-triggers]

Description

Imports the following into the specified zip file:

  • the specified set of files
  • the changelists that submitted those files
  • the files' attributes
  • any fixes association with the changelists
  • all integration records that describe integrations to the files being unzipped

The value of the rpl.checksum.change configurable determines the level of verification performed for the p4 unzip command. See “Configurables”.

Triggering when unzipping

The following push trigger types may be invoked during the execution of the p4 unzip command:

  • The push-submit trigger can customize processing during the phase of the p4 unzip command when metadata has been transferred but files have not yet been transferred.
  • The push-content trigger can customize processing during that phase of the p4 unzip command when files have been transferred but their contents have not yet been committed.
  • The push-commit trigger can do any clean up work or other post processing after changes have been committed by the p4 unzip command.

You must use the --enable-dvcs-triggers option to enable push triggers for the p4 unzip command.

For more information, see the section "Triggering on pushes and fetches" in the scripting chapter of Helix Versioning Engine Administrator Guide: Fundamentals.

Options

-A

Include the archive content of the new revisions.

--enable-dvcs-triggers

Enable any push triggers when the specified file is processed. Push triggers are disabled by default for the p4 unzip command.

For more information about these kinds of triggers, see the chapter "Scripting Perforce: Scripts and Daemons" in Helix Versioning Engine Administrator Guide: Fundamentals.

-f

Bypasses the correctness checks.

-i zipfile

Specifies the zip file name.

-I

Excludes integration records for the new revisions.

-n

Performs all the correctness checks, but does not push any files or changelists to the remote server.

-Oc

When set, the p4 unzip command outputs information about every changelist.

The -v option must be set for this to take effect.

-Of

When set, the p4 unzip command outputs information about every file in every changelist.

The -v option must be set for this to take effect.

-Oi

When set, the p4 unzip command outputs information about every integration in every file in every changelist.

The -v option must be set for this to take effect.

-v

Specifies verbose mode, which provides diagnostics for debugging. You must opt in to verbose mode.

With verbose mode turned on, you can refine and control the precise level of verbosity. Specifically, you can indicate whether you want information about:

  • every changelist unzipped
  • every file in every changelist unzipped
  • every integration of every file in every changelist unzipped

You can specify any combinations of these options, but must always include the -O.

The default is to display information about every changelist.

g-opts

See “Global Options”.

Usage Notes

Can File Arguments Use Revision Specifier? Can File Arguments Use Revision Range? Minimal Access Level Required

N/A

N/A

admin

Examples

p4 unzip -i foo

Imports the contents of the zip package named foo.

Related Commands

Package a set of files and their history for use by p4 unzip

p4 zip