p4 lock

Lock an opened file against other users submitting changes to the file.

Syntax

p4 [g-opts] lock [-c changelist] [file ...]
p4 [g-opts] lock -g -c changelist

Syntax conventions

Description

Locking files prevents other users from submitting changes to those files. If the files are already locked by another user, p4 lock fails. When the user who locked a particular file submits the file, the lock is released.

This command is normally called with a specific file argument. If no file argument is provided, all open files in the default changelist are locked.

See also the dm.open.show.globallocks configurable.

Options

-c changelist	Lock only files included in changelist changelist
-g	Lock files in a commit-edge architecture. Use the -g option to lock the files locally and globally. This option can only be used from an edge server, and it must be used with the -c changelist option. The lock is removed by the p4 unlock -g command or by any submit command for the specified changelist.
g-opts	See Global options.

Usage Notes

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

If the server configurable server.locks.global is set to 1, when p4 lock is issued on an edge server it takes global locks on the commit server by default.

Related Commands

To unlock locked files	p4 unlock
To display all your open, locked files (UNIX)	p4 opened | grep "*locked*"