p4 unlock
Synopsis
Release the lock on a file.
Syntax
p4 [g-opts
] unlock [-c change
| -s shelvedchange
| -x] [-f] [file
…]
p4 [g-opts
] -c client unlock [-f ] -r
Description
The p4 unlock command includes two syntax variants:
-
The first syntax variant releases locks that were created explicitly using the p4 lock command or implicitly during the course of a submit operation or other operations that require file locking.
If the file is open in a pending changelist other than
default
, you must use the-c
option to specify the pending changelist. If no changelist is specified, p4 unlock unlocks files in the default changelist.If no file name is given, all files in the designated changelist are unlocked.
-
The second syntax variant allows you to unlock files that were left locked due to a failed p4 push command.
If a p4 push command from a remote server to this server fails, files can be left locked on this server, preventing other users from submitting changes that affect these files. In this case, the user who issued the p4 push command can use the
-r
option of the p4 push command (and specify the name of the client that was used on that remote server) to unlock the files on this server. An administrator can run p4 unlock -f -r as well. For example:p4 -p central -c myworkspace unlock -r
By default, files can be unlocked only by the changelist owner who must
also be the user who has the files locked. However, administrators may
use the -f
option to forcibly unlock a file opened by
another user.
Options
|
Unlock files in pending changelist
|
|
Superuser or administrator force option; allows unlocking of files opened by other users. |
|
Unlock the files associated with the specified client that were locked due to a failed p4 push command. |
|
If a file is locked in a pending shelved changelist, unlock it
and keep it within the |
|
In distributed environments, unlock files that have the
|
|
See “Global Options”. |
Usage Notes
Can File Arguments Use Revision Specifier? |
Can File Arguments Use Revision Range? |
Minimal Access Level Required |
---|---|---|
No |
No |
|