|
Synopsis
Add or delete users from a group; set the maxresults value for the members of that group.
Syntax
p4 [g-opts] group groupname
p4 [g-opts] group -d groupname
p4 [g-opts] group -o groupname
p4 [g-opts] group -i
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, and
- 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
Field Name
|
Type
|
Description
|
|---|
|
Group:
|
Read-only
|
The name of the group, as entered on the command line.
|
|
Maxresults:
|
Writable
|
The maximum number of results that members of this group can access from the server from a single command. The default value is unlimited. See the Usage Notes below for more details.
|
|
Users:
|
Writable,
multi-line
|
The Perforce usernames of the group members.
|
|
Subgroups:
|
Writable,
multi-line
|
Names of other Perforce groups.
To add all users in a previously defined group to the group you're presently working with, include the group name in the Subgroups: field of the p4 group form. Note that user and group names occupy separate namespaces, and thus, groups and users can have the same names.
Every member of any previously defined group you list in the Subgroups: field will be a member of the group you're now defining.
|
Options
|
-d groupname
|
Delete group groupname. The members of the group are affected only if their access level or maxresults value changes as a result of the group's deletion.
|
|
-i
|
Read the form from standard input without invoking the user's editor. The new group specification replaces the previous one.
|
|
-o
|
Write the form to standard output without invoking the user's editor.
|
|
g_opts
|
See the Global Options section.
|
Usage Notes
Can File Arguments Use
Revision Specifier?
|
Can File Arguments Use
Revision Range?
|
Minimal Access Level Required
|
|---|
|
N/A
|
N/A
|
super
|
- 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 returns to the client by setting the maxresults value for groups of users. If the maxresults value is violated, the server request fails and the user is 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 of which the user is a member (ignoring any maxresults still at the default value of unlimited). 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 more restrictive file pattern on the command line.
|
|
p4 filelog
|
file revisions
|
Use a more restrictive file pattern on the command line.
|
|
p4 files
|
files
|
Use a more restrictive file pattern on the command line.
|
|
p4 fixes
|
fixes
|
The -c changenum or -j jobname flags restricts this command appropriately.
|
|
p4 fixes files
|
files
|
Use a more restrictive file pattern on the command line.
|
|
p4 integrate
|
files
|
Use a more restrictive file pattern on the command line.
|
|
p4 integrated
|
file revisions
|
Use a more restrictive file pattern on the command line.
|
|
p4 jobs
|
jobs
|
The -e jobquery flag restricts 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 a more restrictive file pattern and the -a flag to build the label's file set in pieces.
|
|
p4 print
|
files
|
Use a more restrictive file pattern on the command line.
|
|
p4 sync
|
files, as mapped through client view
|
Use a more restrictive file pattern on the command line.
|
Related Commands
|