p4 group

Synopsis

Add or delete users from a group; set the maxresults value for the members of that group.

Syntax

Description

A group is a list of Perforce users. Groups have two purposes:

• They can be used within p4 protect to set access levels for multiple users;
• They control the maximum amount of data that can be accessed from the server by particular users within a single command.

To delete a group, use p4 group -d groupname, or call p4 group groupname and remove all the users from the resulting form.

Form Fields

Options

Usage Notes

• As the number of files in the depot grows, certain commands can significantly slow down the server if called with no parameters, or if called with non-restrictive arguments. For example, p4 print //depot/... will print the contents of every file in the depot on the user's screen.

The Perforce superuser can limit the amount of data that the server is allowed to return to the client by setting the maxresults value for groups of users. If the maxresults value is violated, the server request will fail and the user will be asked to limit his query.

If a user belongs to multiple groups, the server computes her maxresults value to be the maximum of the maxresults for all the groups the user is in. If a particular user is not in any groups, her maxresults value is unlimited.

The speed of most server hardware should make it unnecessary to ever set a maxresults value below 10,000.

The commands that are affected by the maxresults value are:

Command	Counted Entity	How Affected Users can Reduce Command Output
p4 changes	changes	Using p4 changes -m numchanges.
p4 changes files	file revisions	Use a more restrictive file pattern on the command line.
p4 diff2	files	Use a restrictive file pattern on the command line.
p4 filelog	file revisions	Use a restrictive file pattern on the command line.
p4 files	files	Use a restrictive file pattern on the command line.
p4 fixes	fixes	The -c changenum or -j jobname flags will restrict this command appropriately
p4 fixes files	files	Use a more restrictive file pattern on the command line.
p4 integrate	files	Use a restrictive file pattern on the command line.
p4 integrated	file revisions	Use a restrictive file pattern on the command line.
p4 jobs	jobs	The -e jobquery flag will restrict the output to those jobs that meet particular criteria.
p4 jobs files	file revisions	Use a more restrictive file pattern on the command line.
p4 labelsync	files	Use restrictive file patterns and the -a flag to build the label's file set in pieces.
p4 print	files	Use a restrictive file pattern on the command line.
p4 sync	files, as mapped through client view	Use a restrictive file pattern on the command line.

Related Commands