p4 print
Print the contents of a depot file revision.
Syntax
p4 print [-a -A -K -o localFile -q -m max --offset offset --size size -Q charset -B utf8bom -L line-ending] file[revRange] ...
p4 print -U unloadfile ... p4 print -T attribute [-a -q -o localFile] file ...
Description
The p4 print
command writes the contents of a depot
file to standard output. However, options permit printing only a portion of a file, printing multiple versions of a file, printing multiple files, or printing to an output file.
If a revision range is included, by default, only the highest revision in that range is printed. See Using revision ranges.
Multiple file patterns can be included. All files matching any of the patterns are printed.
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)
option.
By default, RCS keywords are expanded. To suppress keyword expansion,
use the -K
(keyword) option.
By default, the local depot is searched for the specified file. If you
specify the -U
option, the unload depot is searched
instead.
Options
|
For each file, print all revisions within a specified revision range, rather than only the highest revision in the range. |
|
Print files in archive depots. |
|
Suppress RCS keyword expansion. This replaced the |
-L
|
Allow the line ending of textual files to be explicitly specified as 'unix', 'win', or 'mac'. |
-Q
|
Allow the charset for unicode type files to be explicitly specified, overriding the connection's P4CHARSET but not overriding the charset of unicode files with versioned charsets. |
-B
|
Override the client-side filesys.utf8bom setting,
controlling the presence of the byte-order-mark in utf8 type files. |
|
Print only the first |
--offset bytesToSkip
|
(Optional) Skip the specified number of bytes and only print what follows. Can be used with --size . |
--size bytesToPrint
|
(Optional) Print the specified number of bytes from the offset. If --offset is not explicitly set, prints the specified number of bytes from the beginning of the file. |
|
Redirect output to the specified output file (localfile) on the local disk. This preserves the same file type, attributes, and/or permission bits as the original file (FileSpec) in the depot. Multiple files can be written by using wildcards in the localFile argument that match wildcards in the depot (FileSpec) argument. For example: To print the contents of a directory and directories under that directory, use the ... wildcard: p4 print -o c:/tmp/main-copy/... //depot/main/... To print all files that match readme.txt or readme.pdf, you might specify p4 print -o readme.* //depot/readme.* |
|
Suppress the one-line file header normally added by Helix Core Server. |
|
Look for the specified file or files in the unload depot. Data about an unloaded client, label, or task stream can be printed. |
-T
|
Print the value of the specified non-encoded attribute
of the specified file. This command, rather than p4 fstat -Oa , is appropriate for non-encoded binary attributes larger than 250 megabytes. The p4 fstat -Oa command might fail with
the Rpc buffer too big to send error if attributes exceed 250 megabytes. The p4 print command has no option to show the value of the attribute in hex. For that, use the p4 fstat -Oe command. |
|
See Global options. |
Usage notes
Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
---|---|---|
Yes |
Yes |
|
-
Because most terminals are unable to display UTF16 content, the default behavior of the
p4 print
command is to return UTF8 content. You can override this behavior by bypassing terminal output entirely and specifying an output file, for example:p4 print -q -o //depot/file
If your terminal supports UTF16 output, specify standard output as the output file:
p4 print -q -o - //depot/file
- p4 print's file arguments can take a revision
range. By default, only the highest revision matched by any particular
file is printed (that is, when no range is specified, the implied range
is
#1,#head
, and the highest revision is#head
). To print all files in a specified (or implied) range, use the-a
option. - The output of
p4 print
can be large when called with non-restrictive file arguments. For example,p4 print //depot/...
prints the contents of all files in the depot. However, the output can be subject to amaxresults
limitation that set inp4 group
. -
In many cases, redirecting
p4 print
's output to a file via your OS shell will suffice.The
-o
option is intended for users who require the automatic setting of file type and/or permission bits. This is useful for files such as symbolic links (stored as typesymlink
), automatically setting the execute bit on UNIX shell scripts stored as typetext+x
, and files of typeapple
.
Related commands
To compare the contents of two depot file revisions |
|
To compare the contents of an opened file in the client workspace to a depot file revision |