p4 remote
Synopsis
Create, modify or delete a remote specification.
Syntax
p4 [g-opts
] remote [-f] remoteID
p4 [g-opts
] remote -d [-f] remoteID
p4 [g-opts
] remote -o remoteID
P4 [g-opts
] remote -i [-f]
Description
A remote describes the shared server that your server cooperates with. The p4 remote command lets you configure your system such that you can use the fetch and push commands to copy work between your server and the shared server. A remote specification describes the high level configuration and usage of a remote. The p4 remote command allows you to create, modify or delete a remote specification.
Note
These remotes have nothing to do with the Perforce construct of remote depots.
The p4 remote command puts the remote specification
(spec) into a temporary file and invokes the editor
configured by the P4EDITOR
environment variable. Saving the
file creates or modifies the remote spec.
A remote spec contains the following fields:
-
RemoteID
: The identifier of the remote. -
Address
: TheP4PORT
that is used by the server. -
Owner
: The user who created this remote spec. Can be changed.The specified owner does not have to be a Perforce user. You might want to use an arbitrary name if the user does not yet exist, or if you have deleted the user and need a placeholder until you can assign the spec to a new user.
-
Update
: The date this remote spec was last modified. -
Access
: The last time this remote was used to fetch or push. -
Description
: A description of the remote spec (optional). -
Options
: Flags to change the remote spec behavior. The defaults are marked with*
.-
locked/*unlocked Permits only the owner to change the remote, and prevents the remote spec from being deleted.
-
compress/*nocompress Compresses data sent between the local and remote server to speed up slow connections.
-
-
LastFetch
: The last changelist that was fetched. -
LastPush
: The last changelist that was pushed. -
DepotMap
: Mapping between the local and remote files.
Options
With no options specified, p4 remote invokes your editor for the specified remote spec.
|
Deletes the named remote. |
|
Enables a user with admin privileges to delete the spec or set the last modified date. By default, specs can be deleted only by their owner. |
|
Causes a remote spec to be read from the standard input. The user's editor is not invoked. |
|
Writes the remote spec for the named remote to standard output. The user's editor is not invoked. |
Usage Notes
Can File Arguments Use Revision Specifier? |
Can File Arguments Use Revision Range? |
Minimal Access Level Required |
---|---|---|
N/A |
N/A |
|
Examples
p4 remote -i |
Read in a remote spec from standard input. |