Perforce 2004.2 Command Reference
<< Previous Chapter
p4 passwd
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 protect

p4 print

Synopsis

Print the contents of a depot file revision.

Syntax

p4 [g-opts] print [ -a ] [ -o outfile ] [ -q ] file[revRange] ...

Description

The p4 print command writes the contents of a depot file to standard output. A revision range can be included; in this case, only the files with revisions in the specified range are printed, and by default, only the highest revision in that range is listed. (To output each file at every revision within a specified revision range, use p4 print -a.)

Any file in the depot can be printed, subject to permission limitations as granted by p4 protect. If the file argument does not map through the client view, you must provide it in depot syntax.

By default, the file is written with a header that describes the location of the file in the depot, the revision number of the printed file, and the number of the changelist that the revision was submitted under. To suppress the header, use the -q (quiet) flag.

Multiple file patterns can be included; all files matching any of the patterns are printed.

Options

-a

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

-q

Suppress the one-line file header normally added by Perforce.

-o outfile

Redirect output to the specified output file on the local disk, preserving the same file type, attributes, and/or permission bits as the original file in the depot.

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

read

The -o option is intended for users who require the automatic setting of file type and/or permission bits. This is handy for files such as UNIX symbolic links (stored as type symlink), files of type apple, automatically setting the execute bit on UNIX shell scripts stored as type text+x, and so on.

Related Commands

To compare the contents of two depot file revisions

p4 diff2

To compare the contents of an opened file in the client workspace to a depot file revision

p4 diff


Perforce 2004.2 Command Reference
<< Previous Chapter
p4 passwd
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 protect
Please send comments and questions about this manual to [email protected].
Copyright 1999-2004 Perforce Software. All rights reserved.
Last updated: 08/19/04