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

p4 files

Synopsis

Provide information about files in the depot without accessing their contents

Syntax

p4 [g-opts] files file[rev]...

Description

This command lists each file that matches the file patterns provided as arguments. If a revision specifier is given, the files are described at the given revision. One file is listed per line; the format of each line is:

depot-file-location#revision-number - action change change# (file-type)

where

depot-file-location is the file's location relative to the top of the depot;
revision-number is the revision number of the head revision of that file;
action is the action taken at the head revision: add, edit, delete, branch, or integrate;
change# is the number of the changelist that this revision was submitted in; and
file-type is the Perforce file type of this file at the head revision.

Unlike most Perforce commands, p4 files will report on any file in the depot; it is not limited to only those files that are visible through the client view. Of course, if a file pattern on the command line is given in client syntax, only client files will be shown.

The specified revision can be a revision range; in this case, only those files that have revisions within the specified range will be listed, and the highest revision in that range is the listed revision.

Options


`g_opts`	See global options section.

Usage Notes


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

Since p4 file's output can be quite large when called with highly non-restrictive file arguments (e.g., p4 files //depot/... will print information about all the files in the depot), it may be subject to a maxresults limitation as set in p4 group.

Examples


`p4 files //depot/...`	Provides information about all the files in the depot.
`p4 files //clientname/...`	Provides information about depot files that are visible through the client view.
`p4 files @1998/12/10`	Provide information about the depot file revisions that existed on December 10, 1998.
`p4 files //depot/proj2/...@p2lab`	Display a list of files and revisions under the directory `//depot/proj2/...` that are included in label `p2lab`.

Related Commands


To list the revision history of files	`p4 filelog`
To see a list of all currently opened files	`p4 opened`
To see a list of the file revisions you've synced to	`p4 have`
To view the contents of depot files	`p4 print`

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