p4 files

Perforce 2008.1 Command Reference


<< Previous Chapter p4 filelog	Table of Contents Index Perforce on the Web	Next Chapter >> p4 fix

p4 files

Synopsis

Provide information about files in the depot without accessing their contents.

Syntax

p4 [g-opts] files [-a] file[revRange]...

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, and the format of each line is:

depot-file-location#rev - action change change# (filetype)

where

depot-file-location is the file's location relative to the top of the depot
rev 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
filetype is the Perforce file type of this file at the head revision.

Unlike most Perforce commands, p4 files reports 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 are shown.

Options

`-a`

For each file, list all revisions within a specified revision range, rather than only the highest revision in the range.

`g-opts`

See the Global Options section.

`-a`	For each file, list all revisions within a specified revision range, rather than only the highest revision in the range.
`g-opts`	See the Global Options section.

Usage Notes

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

Yes

Yes

`list`

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

The specified revision can be a revision range; in this case, only those files with revisions within the specified range are listed, and by default, only the highest revision in that range is listed. (To display information for all files within a revision range, use p4 files -a.)
Since the output of p4 files can be quite large when called with highly non-restrictive file arguments (for example, p4 files //depot/... prints 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 files in the depot.

`p4 files //clientname/...`

Provides information about all depot files visible through the client view.

`p4 files @2000/12/10`

Provides information about all depot file revisions that existed on December 10, 2000.

`p4 files @2001/03/31:08:00,@2001/03/31:17:00`

Lists all files and revisions changed during business hours on March 31, 2001.

`p4 files //depot/proj2/...@p2lab`

Lists files and revisions under the directory `//depot/proj2/...` that are included in label `p2lab`.

`p4 files //depot/file.c`

Show information on the head revision of `//depot/file.c`. (that is, the highest revision in the implied range of `#1,#head`)

`p4 files -a //depot/file.c`

Show information on every revision of `//depot/file.c` (that is, all revisions in the implied range of `#1,#head`)

`p4 files //depot/...`	Provides information about all files in the depot.
`p4 files //clientname/...`	Provides information about all depot files visible through the client view.
`p4 files @2000/12/10`	Provides information about all depot file revisions that existed on December 10, 2000.
`p4 files @2001/03/31:08:00,@2001/03/31:17:00`	Lists all files and revisions changed during business hours on March 31, 2001.
`p4 files //depot/proj2/...@p2lab`	Lists files and revisions under the directory `//depot/proj2/...` that are included in label `p2lab`.
`p4 files //depot/file.c`	Show information on the head revision of `//depot/file.c`. (that is, the highest revision in the implied range of `#1,#head`)
`p4 files -a //depot/file.c`	Show information on every revision of `//depot/file.c` (that is, all revisions in the implied range of `#1,#head`)

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`

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 2008.1 Command Reference


<< Previous Chapter p4 filelog	Table of Contents Index Perforce on the Web	Next Chapter >> p4 fix

p4 files

Synopsis

Syntax

Description

Options -a For each file, list all revisions within a specified revision range, rather than only the highest revision in the range. g-opts See the Global Options section.

Usage Notes Can File Arguments Use Revision Specifier? Can File Arguments Use Revision Range? Minimal Access Level Required Yes Yes list

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

Options

`-a`

For each file, list all revisions within a specified revision range, rather than only the highest revision in the range.

`g-opts`

See the Global Options section.

Usage Notes

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

Yes

Yes

`list`

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`