p4 status

Synopsis

Open files for add, delete, and/or edit in order to reconcile a workspace with changes made outside of Perforce.

Syntax


p4 [g-opts] status [ -e -a -d -f -I ]
p4 [g-opts] status -A [ -e -a -d -f -I ]

Description

The p4 status command finds unopened files in a client's workspace and detects the following three types of inconsistencies between your workspace and the depot:

  1. Files present in the depot, present in your have list, but missing from your workspace. By default, these files are then opened for delete.

  2. Files present in your workspace, but missing on the depot. By default, these files are opened for add.

  3. Files modified in your workspace that are not open for edit. By default, these files are opened for edit.

If the list of files to be opened includes both adds and deletes, the missing and added files are compared and converted to pairs of move/delete and move/add operations (as long as the files' sizes and contents are similar.)

To limit the scope of p4 status to add, edit, or delete, use the -a, -e, or -d options.

By default, p4 status does not check files and/or paths mentioned in the P4IGNORE file. Use the -I option to override this behavior and ignore the P4IGNORE file.

Options

-A

Add, edit, and delete files. Files in the client workspace not under Perforce control are opened for add. Changed files are opened for edit. Files in the user's have list that have been removed from the workspace are opened for delete.

p4 status -A is equivalent to p4 reconcile -ead.

-f

Add filenames that contain special (wildcard) characters. Files containing the special characters @, #, %, or * are reformatted to encode the characters using hex notation. After these files are added, you must refer to them using their reformatted filenames.

-I

Do not perform any ignore checking; ignore any settings specified by P4IGNORE.

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

open

  • The p4 status command produces output in local syntax. To see file names and paths in depot syntax, use p4 reconcile.

  • When called without arguments, p4 status only previews the results of the workspace reconciliation. You must use either p4 status -A (or some combination of the -e, -a, or -d options) to actually open the files in a changelist.

Related Commands

To reconcile a workspace that has been modified outside Perforce

p4 reconcile