p4 clone

Synopsis

Clone a new local Perforce server from a remote server.

Syntax

p4 [-u user] [-d dir] [-c client] clone [-m depth] [-v] -p port -r remote
p4 [-u user] [-d dir] [-c client] clone [-m depth] [-v] -p port -f filespec

Description

When you clone from a remote server, you copy the portion of its contents that you want to work with into your local server.

Options

-c client

Specifies the client name. If not specified, defaults to the name established with the p4 init command.

-d directory

Specifies the directory in which the new Perforce server is initialized. If not specified, defaults to the current directory.

-f filespec

Specifies a filespec in the remote server to use as the path to clone. Perforce uses this path to determine the stream setup in the local server. The Helix Versioning Engine also uses this file specification to determine the stream setup in the personal server. Specifying the filespec also creates a default remote spec called origin.

The -f preceding the filespec is optional. You can simply issue the command p4 clone //file/path.

-m depth

Specifies the maximum number of revisions of each file to clone; a shallow clone.

-p port

Specifies the address (P4PORT) of the remote server you wish to clone from.

This flag is optional. If not specified,p4 clone uses the remote server specified by the P4PORT environment variable.

-r remotespec

Specifies the remote spec call remotespec installed on the remote server to use as a template for the clone and stream setup.

-u username

Specifies the Perforce user.

-v

Enables verbose mode.

Usage Notes

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

N/A

N/A

read on the remote server.

Examples

p4 -u bruno -d Ace clone -p perforce:1666 -f //depot/main/...

As user bruno, clone the server perforce:1666, retrieving only the files and history from the remote server path //depot/main/....

Related Commands

To to initialize a Perforce server

p4 init