Perforce Command Reference: [Index] [Prev] [Next]

p4 opened

Synopsis

List files that are open in pending changelists

Syntax

p4 [g-opts] opened [-a] [-c changelist#] [file ...]

Description

p4 opened is used to list files that are currently open via p4 add, p4 edit, p4 delete, or p4 integrate. By default, all open files in the current client workspace are listed. Command line arguments can be used to list only those files in a particular pending changelist, or to show open files in all pending changelists.

If file specifications are provided as arguments to p4 opened, only those files that match the file specifications are included in the report.

The information displayed for each opened file includes the file's name, its location in the depot, the revision number that the file was last synced to, the number of the changelist under which the file was opened, the operation it is opened for (add, edit, delete, or integrate), and the type of the file. The output for each file has this appearance:

//depot/proj1/README#3 - delete change 5 (ktext)

Options


`-a`	List opened files in any client workspace
`-c`	List the files in pending changelist changelist#. To list files in the default changelist, use `p4 opened -c default`.
`g-opts`	See global options section.

Usage Notes


Can File Arg Use Revision Specifier?	Can File Arg Use Revision Range?	Minimal Access Level Required
No	No	`list`

Perforce does not prevent users from opening already-open files; its default scheme is to allow multiple users to edit the file simultaneously, and then resolve file conflicts with p4 resolve. To determine whether or not another user already has a particular file opened, use p4 opened -a file.

Examples


`p4 opened -c 35 //depot/foo/...`	List all files in pending changelist 35 that lie under the depot's `foo` subdirectory.
`p4 opened -a -c default`	List all opened files in the default changelists for all clients.

Related Commands


To open a file in a client workspace and list it in a changelist	`p4 add p4 edit p4 delete p4 integrate`
To move a file from one changelist to another	`p4 reopen`
To remove a file from all changelists, reverting it to its previous state	`p4 revert`
To create a new, numbered changelist	`p4 change`
To view a list of changelists that meet particular criteria	`p4 changes`

Perforce Command Reference: [Index] [Prev] [Next]