Perforce 2002.2 Command Reference
<< Previous Chapter
p4 flush
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 group

p4 fstat


Synopsis

Dump file info in format suitable for parsing by scripts.

Syntax

p4 [g-opts] fstat [ -c changelist# ] [ -C -l -H -P -s -W] file[rev]...

Description

The p4 fstat command dumps information about each file, with each item of information on a separate line.

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

otherLock

set if another user has the file locked, otherwise blank

1 or blank

ourLock

set if the current user has the file locked, otherwise blank

1 or blank

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


Perforce 2002.2 Command Reference
<< Previous Chapter
p4 flush
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 group
Please send comments and questions about this manual to [email protected].
Copyright 1999-2003 Perforce Software. All rights reserved.
Last updated: 02/25/03