Perforce 2000.2 Command Reference (2000.2.cr.1)
<< Previous Chapter
p4 lock
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 opened

p4 obliterate


Synopsis

Removes files and their history from the depot

Syntax

p4 [g-opts] obliterate [-y] file ...

Warning

The p4 delete command marks the latest revision as deleted, but leaves the file information intact in the depot. As such, recovery from the server data is always possible. In contrast, p4 obliterate deletes the file data itself, precluding any possibility of recovery.

Use p4 obliterate with caution. This is the only command in Perforce that actually removes file data.

Description

p4 obliterate can be used by Perforce superusers to permanently remove files from the depot. All information about the files is wiped out, including the files' revisions, the files' metadata, and any records in any labels or client workspace records that refer directly to those files. Once p4 obliterate completes, it appears to the server as if the affected file(s) had never existed. Files in the client workspace will not be touched, but will no longer be recognized as being under Perforce source control.

p4 obliterate requires at least one file pattern as an argument. To actually perform the obliteration, the -y flag is required; without it, p4 obliterate merely tells you what it would do without actually performing the obliteration.

The -z flag is used with branches; after branching a file from one area of the depot into another. When a branch is made, a "lazy copy" is performed - the file itself isn't copied; only a record of the branch is made. If you want to "obliterate" the lazy copy performed by the branch, thereby creating an extra copy of the file in the depot, use p4 obliterate -z on it. Note that this typically increases disk space usage.

Options

-y filespec

Perform the obliterate operation. Without this flag, p4 obliterate merely reports what it would do.

-z filespec

Undo "lazy copies" only; remove no files nor metadata. This option is most commonly used when working with branches in order to ensure that no other files in the database refer to the named files.

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

No

No

super

Related Commands

To mark a file deleted at its head revision but leave it in the depot

p4 delete


Perforce 2000.2 Command Reference (2000.2.cr.1)
<< Previous Chapter
p4 lock
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 opened
Please send comments and questions about this manual to [email protected].
Copyright 1997, 2000 Perforce Software. All rights reserved.
Last updated: 12/21/00