Provide information about files in the depot without accessing their contents.
p4 [g-opts] files [-a -A -e] [-i][-m max] file[revRange]...
p4 [g-opts] files -U unloadfile...
The output is different for files in depots of type
graph
. See the final example in the section
Examples.
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 changelist (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
, move/add
, move/delete
,
integrate
, import
, purge
, or
archive
,changelist
is the number of the changelist in
which the revision was submitted, andfiletype
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. If a file pattern on the command line is given in client syntax,
only files in the client workspace are shown.
|
For each file, list all revisions within a specified revision range, rather than only the highest revision in the range. |
|
Limit output to files in archive depots. |
|
Exclude deleted, purged, or archived files; the files that remain are those available for syncing or integration. |
|
Ignore the case of the file argument when listing files in a case sensitive server. |
|
Limit output to the first |
|
List only files in the unload depot. See |
|
See Global Options. |
Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
---|---|---|
Yes |
Yes |
|
p4 files -a
.)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
.
|
Provides information about all files in the depot. |
|
Provides information about all depot files visible through the client view. |
|
Provides information about all depot file revisions that existed on March 10, 2011. |
|
Lists all files and revisions changed during business hours on March 31, 2011. |
|
Lists files and revisions under the directory |
|
Show information on the head revision of
|
|
Show information on every revision of
|
|
If an administrator has used |
|
The depot for //depot/projectA/README.md#1 - add change 6 (text) //depot/projectA/src/feature.cc#1 - add change 6 (text) //depot/projectA/src/main.cc#1 - add change 6 (text) //repo/projectB/Hero/IgnoreSubviewModPreprocessor.swift //repo/projectB/Hero/MatchPreprocessor.swift //repo/projectB/README.md |
To list the revision history of files |
|
To see a list of all currently opened files |
|
To see a list of the file revisions you’ve synced to |
|
To view the contents of depot files |