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:

where

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.

Usage Notes

Can File Arguments Use
Revision Specifier?

Can File Arguments Use
Revision Range?

Minimal Access Level Required

Yes

Yes

list

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)

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 2008.1 Command Reference
<< Previous Chapter
p4 filelog
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 fix
Please send comments and questions about this manual to [email protected].
Copyright 1999-2008 Perforce Software. All rights reserved.
Last updated: 07/08/08