Perforce 2006.1 Command Reference
<< Previous Chapter
p4 resolved
Table of Contents
Perforce on the Web
Next Chapter >>
p4 review

p4 revert


Discard changes made to open files.


p4 [g-opts] revert [ -a -n -k -c changelist# ] file...


Use p4 revert to discard changes made to open files, reverting them to the revisions last p4 synced from the depot. This command also removes the reverted files from the pending changelists with which they're associated.

When you revert files you opened with p4 delete, the files are reinstated in the client workspace. When you revert files that have been opened by p4 add, Perforce leaves the client workspace files intact. When you revert files you've opened with p4 integrate, Perforce removes the files from the client workspace.



Revert only those files that haven't changed (in terms of content or filetype) since they were opened.

The only files reverted are those whose client revisions are:

  • open for edit but have unchanged content and unchanged filetype; or
  • open for integrate via p4 integrate and have not yet been resolved with p4 resolve.


List the files that would be reverted without actually performing the revert.

This lets you make sure the revert does what you think it does before actually reverting the files.


Keep workspace files; the file(s) are removed from any changelists, and the server records the files as being no longer open, but the file(s) are unchanged in the client workspace.

-c changelist#

Reverts only those files in the specified changelist.


See the Global Options section.

Usage Notes

Can File Arguments Use
Revision Specifier?

Can File Arguments Use
Revision Range?

Minimal Access Level Required




You don't need to specify a file argument when using the -a flag.


p4 revert //...

Revert every file you have open, in every one of your pending changelists, to its pre-opened state.

p4 revert -c default //...

Revert every file open in the default changelist to its pre-opened state.

p4 revert -n *.txt

Preview a reversion of all open .txt files in the current directory, but don't actually perform the revert.

p4 revert -c 31 *.txt

Revert all .txt files in the current directory that were open in changelist 31.

p4 revert -a

Revert all unchanged files. This command is often used before submitting a changelist.

Related Commands

To open a file for add

p4 add

To open a file for deletion

p4 delete

To copy all open files to the depot

p4 submit

To read files from the depot into the client workspace

p4 sync

To list all opened files

p4 opened

To forcibly bring the client workspace in sync with the files that Perforce thinks you have, overwriting any unopened, writable files in the process.

p4 sync -f

Perforce 2006.1 Command Reference
<< Previous Chapter
p4 resolved
Table of Contents
Perforce on the Web
Next Chapter >>
p4 review
Please send comments and questions about this manual to [email protected].
Copyright 1999-2006 Perforce Software. All rights reserved.
Last updated: 06/23/06