p4 status
Previews output of open files for add, delete, and/or edit in order to reconcile a workspace with changes made outside of Helix Server.
The p4 status command produces output in local
syntax. To see file names and paths in depot syntax, use the
-n option to p4
reconcile.
Syntax
p4 [g-opts] status [-c change] [-A | [-e -a -d] | [-s]] [-f -I -m] [file ...]
Description
When called without arguments, p4 status only
previews the results of the workspace reconciliation. To limit the scope
of p4 status to add, edit, or delete, use the
-a, -e, or -d options. You must
use either p4 status -A (or p4 reconcile) to
actually open the files in a changelist.
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:
- Files present in the depot, present in your have list
An internal list indicates which files and revisions the client workspace has sync'd from the depot. See 'p4 have' in Helix Core Command-Line (P4) Reference., but missing
from your workspace. By default, these files are then opened for
delete. - Files present in your workspace, but missing on the depot. By
default, these files are opened for
add. - 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.)
By default, p4 status displays opened files as well
as files that need to be reconciled. If you use the -A,
-e, -a, or -d options or client
applications earlier than 2015.1, opened files are not displayed.
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.
Reconcile and implicit p4 move affects p4 status
If you do a p4 reconcile and some of the files show up as potential "adds" while others show up as "deletes", Helix Server compares the new files and the missing files to see if any of them appear to be the same file. If so, Helix Server links them as if you had used p4 move to open them. The output of p4 reconcile and p4 status will include a "... moved from" line so that you can preview how Helix Server matched the files before you submit them. You can also use p4 resolved after opening the files.
Options
|
|
Display files to be opened for add. |
|
|
Add, edit, and delete files. Files in the client workspace not under Helix Server 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 |
|
|
The changelist containing the files whose status is sought. |
|
|
Display files to be opened for delete. |
|
|
Display files to be opened for edit. |
|
|
Display files to be added whose names contain special (wildcard)
characters. Files containing the special characters
|
|
|
Do not perform any ignore checking; ignore any settings
specified by |
|
|
Use in conjunction with the |
|
|
Generate summarized output for files to open for add. Using this option causes the command to preview files needing to be reconciled, but provides shorter output for files to be opened for add. Files in the current working directory are listed, but subdirectories containing files to be opened for add are listed rather than the individual files. This provides the shorter output. Note
This requires version 2015.1 or later of both server and client. |
|
|
See Global options. |
Usage Notes
| Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
|---|---|---|
|
No |
No |
|
Related Commands
|
To reconcile a workspace that has been modified outside Helix Server |
