Perforce 2009.2: Command Reference

p4 unshelve

Synopsis

Restore shelved files from a pending change into a workspace

Syntax

p4 unshelve -s changelist [-f] [-n] [-c changelist] [file ...]

Description

The p4 unshelve command retrieves files that are shelved in a pending changelist into a pending changelist on the invoking user's workspace. Access to shelved files from a pending changelist is controlled by the user's permissions on the files.

You can limit the files to be unshelved by specifying a file pattern.

Unshelving copies the shelved files into the user's workspace as they existed when they were shelved. (For example, a file open for edit when shelved will also be open for edit in the unshelving user's workspace.)

Options

-s changelist	Specify the pending changelist number that contains the originally-shelved files.
-c changelist	Specify a changelist number in the user's workspace into which the files are to be unshelved. By default, p4 unshelve retrieves files into the default changelist.
-f	Forcethe overwriting of writable (but unopened) files during the unshelve operation.
-n	Preview the results of the unshelve operation without actually restoring the files to your workspace.
g-opts	See the Global Options section.

Usage Notes

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

Related Commands

To store files from a pending changelist into the depot without submitting them.

p4 shelve