p4 fstat

Synopsis

Syntax

Description

The output is best used within a Perforce API application where the items can be accessed as variables, but is also suitable for parsing by scripts from the client command output.

Form Fields

Field Name	Description	Example
depotFile	depot path to file	//depot/src/file.c
clientFile	local path to file (in local syntax by default, or in Perforce syntax with the -P option)	/staff/userid/src/file.c (or //workspace/src/file.c in Perforce syntax)
haveRev	revision last synced to client, if on client	1, 2, 3... n
headAction	action taken at head revision, if in depot	one of add, edit, delete, branch, or integrate
headChange	head revision changelist number, if in depot	1, 2, 3... n
headRev	head revision number, if in depot	1, 2, 3... n
headTime	Head revision modification time, if in depot. Time is measured in seconds since 00:00:00 UTC, January 1, 1970	919283152 is a date in early 1999
headType	head revision type, if in depot	text, binary, text+k, etc. (see the chapter on File Types.)
action	open action, if opened on your client	one of add, edit, delete, branch, or integrate
change	open changelist number, if opened on your client	1, 2, 3... n
unresolved	the number, if any, of unresolved integration records	1, 2, 3... n
unresolvedotherOpen	number of other users who have the file open, blank if no other users have the file open	1, 2, 3... n, followed by n records listing the users (0 through n-1): ... otherOpen 3 ...... otherOpen0 user1@cws1 ...... otherOpen1 user2@cws2 ...... otherOpen2 user3@cws3
ourLock	set to null if the current user has the file locked, otherwise unset	unset or null
otherLock	set to null if another user has the file locked, otherwise unset	unset or null
otherLockn	for each user with the file locked, the client and user holding the lock	user123@workstation9
otherOpen	the number of other users who have the file open	1, 2, 3... n, preceded by n records listing the users (0 through n-1) with otherOpenn, otherActionn, and otherLockn fields as applicable.
otherOpenn	for each user with the file open, the client and user with the open file	user123@workstation9
otherActionn	for each user with the file open, the action taken	one of add, edit, delete, branch, or integrate
fileSize	file length in bytes (requires -l option, may be expensive to compute)	63488

Options

-c changelist#	Displays only files affected since the given changelist number. This option is much faster than using a revision range on the affected files.
-C	Limits output to files mapped into the current workspace.
-l	Include a fileSize field displaying the length of the file. Note that this field may be expensive to compute, particularly for text files with many revisions.
-H	Limits output to files on your have list; that is, files synced in the current workspace.
-P	Display the clientFile in Perforce syntax, as opposed to local syntax.
-s	Shortens output by excluding client-related data (for instance, the clientFile field).
-W	Limit output to files opened in the current workspace.
g-opts	See the Global Options section. The -s global option (which prefixes each line of output with a tag describing the type of output as error, warning, info, text, or exit) can be particularly useful when used with p4 fstat.

Usage Notes

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
Yes	Yes	list

Examples

p4 fstat file.c	Displays information on file.c
p4 fstat -c 20 *.c	Displays information on all .c files affected since checking-in of files under changelist 20.
p4 fstat -s file.c	No client information lines (i.e. clientFile) will be displayed

Related Commands

To read additional information about each file	p4 files
To display file information including change descriptions	p4 filelog