Perforce 2009.2: Command Reference

p4 move

Synopsis

Move (rename) a file from one location to another.

Syntax

p4 [g-opts] move [-c change] [-k] [-n] [-t filetype] fromFile toFile

Description

The p4 move command takes a file already opened for edit or add and moves it to the destination provided.

An open file can be moved many times before it is submitted; moving a file back to its original location undoes the pending move, leaving it open for edit. Using p4 revert on a moved file both undoes the move and reverts the unsubmitted content.

Options

-c change	If a changelist number is provided, the files are opened in the numbered pending changelist.
-t filetype	If a filetype is specified, the file is reopened as the new filetype.
-k	Keep existing workspace files by bypassing the renaming in the client workspace. Use p4 move -k only in the context of reconciling work performed while disconnected from the Perforce Server.
-n	Preview the move that would be performed, without actually moving files.
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
fromFile: Yes toFile: No	No	read access for fromFile write access for toFile

•	Files must be open for add or open for edit before they can be moved.

Examples

p4 move file1.c file2.c	Assuming that file1.c is open for add or edit, move file1.c to file2.c.
p4 move //depot/d1/... //depot/d2/...	Moving open files from directory d1 to directory d2.