Archive obsolete revisions to an archive depot.
p4 [g-opts] archive [-h -n -p -q -t] -D depotfile[revRange] ...
Moves the specified revisions into a depot of type
archive.
When files are moved into an archive depot, their last action is changed
to archive. Commands that access file content (for example,
p4 sync, p4 diff, and so on) skip
archive revisions, but commands that do not require access
to file content (such as p4
filelog, for example) continue to report to metadata
concerning the archived revisions.
Set the server.locks.archive configurable to disable server
locks when running the p4 archive command.
Use p4 archive -p with caution. This is one of
only two commands in
Perforce
that actually removes file data. (The other command that removes file
data is p4
obliterate.)
|
|
Specify an archive depot to which files are to be archived. |
|
|
Do not archive head revisions. |
|
|
Do not archive revisions; report on which revisions would have been archived. |
|
|
Purge any archives of the specified files named in the archive
depot. (The action for affected revisions is set to
|
|
|
Quiet mode; suppress messages about skipped revisions. |
|
|
Archive text files (or other revisions stored in delta format,
such as files of type |
|
|
See Global Options. |
| Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
|---|---|---|
|
Yes |
Yes |
|
+F) or compressed
(+C) are archived. The files must be in a
local depot (not a remote or another
archive depot), and must neither be copied nor branched to
(or from) another revision.-t
option. Be aware that there may be a computational cost associated with
the manipulation of large numbers of RCS deltas.p4 archive -n for testing purposes
before mounting the filesystem associated with the archive depot.
Storage for the archive depot must be mounted before running this
command without the -n option.p4
archive implicitly targets revisions #1 through the
specified revision for archiving. To archive only a single revision
rev, use the form p4 archive
file#rev,rev.p4
print -A -o filenamemyFile to a file in
order to determine which archived revision(s) are desired before
(optionally) requesting that a
Perforce
Administrator use p4
restore to restore the file.|
|
Archive revisions 1, 2, and 3 of |
|
|
Archive revision 3 of |
|
|
Redirect the contents of myArchiveFile might be something like
|
|
To create a depot |
|
|
To restore files from an archive depot |
|
|
To obliterate files without archiving them |