p4 reviews

List all the users who have subscribed to review particular files.

Syntax

p4 [g-opts] review [-c changelist] [-t countername]

Description

The p4 reviews command is intended for use in external programs that call Helix Server.

Users subscribe to review files by providing file patterns in the Reviews: field in their p4 user form.

p4 reviews -c change lists each user who has subscribed to review any files included in the submitted changelist change. The alternate form, (p4 reviews file ...), lists the users who have subscribed to review any files that match the file patterns provided as arguments. If you provide no arguments to p4 reviews, all users who have subscribed to review any files are listed.

Options

-C client	List all users who have subscribed to review any files opened in the specified workspace client.
-c change	List all users who have subscribed to review any files included in submitted changelist changelist.
g-opts	See Global options.

Usage Notes

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

• The syntax p4 reviews -c changelistfile... ignores the file arguments entirely.

• p4 reviews is an unusual command. It was created to support external daemons, but it does nothing without the Reviews: field of the p4 user form, which has a very specific meaning.

  It is possible to enter values in the Reviews: field that mean something originally unintended by Helix Server to create more generalized daemons. At Perforce, for example, we run a jobs daemon that sends email to any users who have subscribed to review jobs when a new job is submitted. Because there is nothing built into Helix Server that allows users to subscribe to review jobs, we co-opt a single line of the Reviews: field: Helix Server sends a job email to any users who have subscribed to review the non-existent path //depot/jobs/.

Related Commands

To subscribe to review files	p4 user
List all submitted changelists above a provided changelist number	p4 review
To set or read the value of a Helix Server counter	p4 counter
To read full information about a particular changelist	p4 describe