p4 move

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

Syntax

p4 [g-opts] move [-c change] [-f -n -k] [-t filetype] fromFileSpec toFileSpec
p4 [g-opts] move -r [-c change] [-n -k] fromFileSpec toFileSpec

Syntax conventions

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.

Note

The p4 move command should only be used for intra-branch file rename or move, that is, renaming a file within the same directory, or between directories within the same directory tree. To learn how to restructure the depot by moving an entire branch, see the Knowledge Base article, "Renaming Depot Directories".

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.
`-f`	Force a move to an existing target file. The file must be synced, but not opened. The originating source file will no longer be synced to the workspace. If you use `p4 move -f`, you will need to resolve the move before submitting the changelist.
`-k`	Performs the rename on the server without modifying files on the client workspace. However, a p4 sync is still required. Note Use with caution because an incorrect move can cause discrepancies between the state of the client workspace and the corresponding server metadata.
`-r`	Rename existing files without altering content or type to a new target. This option allows the user to move files from the depot to a different location without opening the files first. This option performs a strict rename only. Therefore the `-t` and `-f` flags are not allowed, source files must not be already opened, and the targets must not already exist.
`-n`	Preview the move that would be performed, without actually moving files.
`g-opts`	See Global options.

Usage Notes

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required	Command Alias
`fromFile`: Yes `toFile`: No	No	read access for fromFile write access for toFile	p4 rename

Files must be open for add or open for edit before they can be moved.
To move and resolve a file that is open for edit but has been renamed at the head revision, use the -f option to force the move.

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/main/directory1/... //depot/main/directory2/...`	Move open files from one directory to another within the same depot tree.
`p4 move //depotA/main/f2 //depotA/main/f2/f2`	Move or rename a file where either the target path is a substring of the source path, or the source path is a substring of the target path. In this example, the directory `f2` has the same name as the file `f2`.