Perforce 2002.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 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, 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.

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

Options

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.

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 2002.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-2002 Perforce Software. All rights reserved.
Last updated: 04/03/02