Displaying file status

To display information about single revisions of files, issue the p4 files command. This command displays the locations of the files in the depot, the actions (add, edit, delete, and so on) performed on those files at the specified revisions, the changelists in which the specified file revisions were submitted, and the files' types. The following example shows typical output of the p4 files command:

//depot/README#5 - edit change 6 (text)

The p4 files command requires one or more filespec arguments. Regardless of whether you use local, client, or depot syntax to specify the filespec arguments, the p4 file command displays results using depot syntax. If you omit the revision number, information for the head revision is displayed. The output of p4 files includes deleted revisions.

The following table lists some common uses of the p4 files command:

To display the status of Use this command

All files in the depot, regardless of your workspace view

For depots containing numerous files, you can maximize performance by avoiding commands that refer to the entire depot (//depot/...) when not required. For best performance, specify only the directories and files of interest.

p4 files //depot/...

The files currently synced to the specified client workspace.

p4 files @workspacename

The files mapped by your workspace view.

p4 files //workspacename/...

Specified files in the current working directory

p4 files filespec

A specified file revision

p4 files filespec#rev

Specified files at the time a changelist was submitted, regardless of whether the files were submitted in the changelist

p4 files filespec@changenum

Files tagged with a specified label

p4 files filespec@labelname